Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions apps/cli/lib/commands/account.js
Original file line number Diff line number Diff line change
Expand Up @@ -1507,6 +1507,10 @@ async function releasePhone (dataDir, member, key, { open = openPhoneStore } = {

module.exports = {
closeOrphanPages,
// The hosted lab (scripts/hosted-lab.js) opens the page clients the same way.
openPageClients,
pageClientsOf,
closePageClients,
commands: {
account: { summary: 'serviço de contas', run }
},
Expand Down
43 changes: 37 additions & 6 deletions apps/cli/scripts/hosted-lab.js
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,10 @@
// /account/phone/policy answers { required: true }), no age check (GET
// /account/age/policy answers { required: false }), an issuer certified by
// the lab association, the terms store on and GIF search through the stub of
// ./gif-stub.js (a loopback provider of one-color GIFs, no key). Passkey,
// terms and the account flow are the real ones.
// ./gif-stub.js (a loopback provider of one-color GIFs, no key), and Páginas
// on (GET /account/pages/policy answers { available: true }) under a
// VARANDA_PAGE_KEYS drawn at random each run and held only in this process.
// Passkey, terms, pages and the account flow are the real ones.
// One origin, http://localhost:<port>, carries what Caddy carries in a
// deployment: /varanda.json, /seeder, /media/*, /index/*, /account/*, /p/*, and
// everything else goes to the Expo web dev server or to an exported dist.
Expand Down Expand Up @@ -150,6 +152,9 @@ function routeOf (pathname) {
if (pathname === '/varanda.json') return 'config'
if (pathname === '/seeder') return 'seeder'
if (pathname.startsWith('/media/') || pathname.startsWith('/index/')) return 'seeder'
// Chat attachments (blob chunks) and the Feira's public listing pages, as
// deploy/seeder/Caddyfile routes them to the seeder.
if (pathname.startsWith('/blob/') || pathname.startsWith('/f/')) return 'seeder'
if (pathname.startsWith('/p/')) return 'seeder'
if (pathname === '/account' || pathname.startsWith('/account/')) return 'account'
return 'ui'
Expand Down Expand Up @@ -389,16 +394,21 @@ async function main () {
const { saveKeyPairFile } = require('@varanda/core/lib/cert')
const { Seeder } = require('@varanda/core/lib/seeder')
const { startSeedWs } = require('../lib/seed-ws')
const { createPostageFile } = require('../lib/dm-postage-file')
const { createPostageFile, createBlobPostageFile } = require('../lib/dm-postage-file')
const { createAccountServer, loadIssuer, KEY_FILE, CERT_FILE } = require('../lib/account/server')
const { openAccountStore } = require('../lib/account/store')
const { openTermsStore } = require('../lib/account/terms-store')
const { openModerationStore } = require('../lib/account/moderation-store')
const { openPasskeyStore } = require('../lib/account/passkey-store')
const { openRecoveryStore } = require('../lib/account/recovery-store')
const nodeCrypto = require('node:crypto')
const { createPhoneStub } = require('./phone-stub')
const { createGifStub } = require('./gif-stub')
const { openPhoneStore } = require('../lib/account/phone-store')
const { openPageKeys } = require('../lib/account/page-keys')
const { createPagesWriter } = require('../lib/account/pages-writer')
const { openPagesStore } = require('../lib/account/pages-store')
const { openPageClients, pageClientsOf, closePageClients } = require('../lib/commands/account')

const root = fs.mkdtempSync(path.join(os.tmpdir(), 'varanda-lab-'))
const cleanups = []
Expand Down Expand Up @@ -450,7 +460,7 @@ async function main () {
dataDir: seedDir,
bootstrap,
host: '127.0.0.1',
dm: { postage: createPostageFile(seedDir), onDrop: () => {} }
dm: { postage: createPostageFile(seedDir), blobPostage: createBlobPostageFile(seedDir), onDrop: () => {} }
})
const origin = labOrigin(opts.port)
const wsOpts = { host: '127.0.0.1', port: 0, seeder }
Expand Down Expand Up @@ -480,17 +490,38 @@ async function main () {
// passkey created in the lab browser is enrolled right after the link,
// so Excluir conta there runs with the server-side check.
const passkeys = openPasskeyStore(accountDir)
// Recovery entries (recovery.json): a code made in Ajustes › Passkeys e
// recuperação opens the same account on a second lab browser.
const recovery = openRecoveryStore(accountDir)
// Ages stay null, so the base age gate lets a send through. The store
// key is random and stays in this process. The banner prints the
// sandbox code, never the key.
const phoneClient = createPhoneStub()
const phones = openPhoneStore(accountDir, { key: nodeCrypto.randomBytes(32) })
const gifStub = await createGifStub()
cleanups.push(() => gifStub.close())
const account = createAccountServer({ association, origin, store, issuer, terms, moderation, passkeys, didit: null, ages: null, phoneClient, phones, gif: gifStub.config, gifTransport: gifStub.transport })
// Páginas on a throwaway key: random per run, kept only in this object
// (never in process.env, never printed), so its sealed key file dies
// with the lab directory. The page writer reaches the lab seeder's
// WebSocket as VARANDA_SEEDER_WS does in a deployment.
const pagesEnv = {
VARANDA_PAGE_KEYS: nodeCrypto.randomBytes(32).toString('hex'),
VARANDA_SEEDER_WS: 'ws://127.0.0.1:' + ws.port
}
const pageLog = (e) => {
if (e && e.event === 'paginas' && typeof e.reason === 'string') log('páginas: ' + e.reason)
}
const pageKeys = openPageKeys({ dir: accountDir, env: pagesEnv, log: pageLog })
const pagesWriter = createPagesWriter({ dir: accountDir, keys: pageKeys, association, seederWs: pagesEnv.VARANDA_SEEDER_WS, log: pageLog })
cleanups.push(() => pagesWriter.close())
const pagesStore = openPagesStore(accountDir)
const pageClients = openPageClients({ dataDir: accountDir, env: pagesEnv, association, seederWs: pagesEnv.VARANDA_SEEDER_WS, moderation, keys: pageKeys, writer: pagesWriter, pagesStore, guard: () => true, log: pageLog })
cleanups.push(() => closePageClients(pageClients))
const pages = { keys: pageKeys, writer: pagesWriter, pagesStore, dir: accountDir, ...pageClientsOf(pageClients) }
const account = createAccountServer({ association, origin, store, issuer, terms, moderation, passkeys, recovery, didit: null, ages: null, phoneClient, phones, gif: gifStub.config, gifTransport: gifStub.transport, pages })
const accountListener = await account.listen({ host: '127.0.0.1', port: 0 })
cleanups.push(() => accountListener.close())
log('serviço de conta no ar (cadastro por celular com SMS simulado, busca de GIF simulada)')
log('serviço de conta no ar (cadastro por celular com SMS simulado, busca de GIF simulada, Páginas com chave descartável)')

const proxy = await startLabProxy({
host: opts.host,
Expand Down
20 changes: 20 additions & 0 deletions apps/cli/test/hosted-lab.test.js
Original file line number Diff line number Diff line change
Expand Up @@ -66,6 +66,8 @@ test('the lab origin maps the five routes and the UI fallback', async (t) => {
const cases = [
['/media/' + 'cd'.repeat(32) + '/' + 'ef'.repeat(32) + '/1/1', 'seeder', seederPort],
['/index/counts/x', 'seeder', seederPort],
['/blob/' + 'ab'.repeat(32) + '/0', 'seeder', seederPort],
['/f/' + 'ab'.repeat(32) + '/1', 'seeder', seederPort],
['/account/age/policy', 'account', accountPort],
['/account/phone/policy', 'account', accountPort],
['/account/start', 'account', accountPort],
Expand Down Expand Up @@ -217,6 +219,10 @@ test('routeOf', (t) => {
t.is(routeOf('/account/x'), 'account')
t.is(routeOf('/x'), 'ui')
t.is(routeOf('/p/policy'), 'seeder')
t.is(routeOf('/blob/' + 'a'.repeat(64) + '/0'), 'seeder', 'chat attachments come from the seeder')
t.is(routeOf('/blobx'), 'ui')
t.is(routeOf('/f/' + 'a'.repeat(64) + '/1/capa'), 'seeder', 'the Feira listing pages come from the seeder')
t.is(routeOf('/feira'), 'ui')
t.is(routeOf('/p/' + 'a'.repeat(64) + '/1'), 'seeder')
t.is(routeOf('/p'), 'ui')
t.is(routeOf('/px'), 'ui')
Expand Down Expand Up @@ -341,6 +347,20 @@ test('the running lab requires a phone check and finishes sign-up without an age
t.alike(await policy.json(), { required: true })
t.alike(await (await fetch(base + '/account/age/policy')).json(), { required: false })
t.alike(await (await fetch(base + '/account/gif/policy')).json(), { enabled: true }, 'GIF search is on, through the stub provider')
const pagesPolicy = await (await fetch(base + '/account/pages/policy')).json()
t.is(pagesPolicy.available, true, 'Páginas are on, under the throwaway key')
t.ok(Number.isInteger(pagesPolicy.maxOwned) && Number.isInteger(pagesPolicy.maxAdmins), 'with the page limits')
// The seeder's blob route answers (a chunk it does not hold is its 404),
// not the app's index.html: chat photos and voice notes can travel.
const blobRes = await fetch(base + '/blob/' + 'a'.repeat(64) + '/0')
t.is(blobRes.status, 404, 'an unknown chat attachment chunk is not found')
t.is(await blobRes.text(), 'não encontrado\n', 'by the seeder itself')
// Recovery entries are kept (recovery.json): an unknown lookup is the
// route's own miss, not 503 'indisponivel', so a recovery code made in the
// lab opens the account on a second browser.
const recoveryMiss = await postJson(base + '/account/recovery/fetch', origin, { lookupId: 'b'.repeat(64) })
t.is(recoveryMiss.status, 404, 'an unknown recovery entry is not found')
t.alike(recoveryMiss.body, { error: 'nao-encontrado', recovery: true }, 'by the recovery store itself')

const config = await (await fetch(base + '/varanda.json')).json()
const kp = crypto.keyPair()
Expand Down
5 changes: 4 additions & 1 deletion docs/development.md
Original file line number Diff line number Diff line change
Expand Up @@ -228,7 +228,10 @@ O que ele sobe, no mesmo processo:
- uma rede DHT de teste presa a loopback, ou a que `VARANDA_BOOTSTRAP` aponta (precisa ser loopback, por exemplo a de `apps/cli/scripts/local-dht.js`);
- uma associação e um semeador certificado, com a entrada WebSocket, como `seed --ws-port`;
- o serviço de conta, com a loja de termos ligada, verificação de celular com SMS simulado, sem verificação de idade (`GET /account/age/policy` responde `{ required: false }`) e com a busca de GIF ligada num provedor simulado (`apps/cli/scripts/gif-stub.js`: qualquer busca traz as mesmas imagens de uma cor só, sem chave nem rede externa);
- um só endereço, `http://localhost:<porta>`, que reúne `/varanda.json`, `/seeder`, `/media/*`, `/index/*`, `/account/*` e `/p/*`; o resto vai para o servidor do Expo ou para o `dist` exportado.
- as Páginas ligadas (`GET /account/pages/policy` responde `{ available: true }`), com um `VARANDA_PAGE_KEYS` sorteado a cada execução, guardado só na memória do processo e nunca impresso: as Páginas e as Conversas delas somem com os dados do laboratório;
- fotos e mensagens de voz nas Conversas: o semeador guarda os pedaços cifrados e o selo deles, como numa instalação;
- os códigos de recuperação (`recovery.json`): um código criado em Ajustes › Passkeys e recuperação abre a mesma conta num segundo perfil do Chrome, que vira um segundo aparelho da pessoa (Entrar › Outras formas de entrar › Entrar com código de recuperação, depois uma passkey nova);
- um só endereço, `http://localhost:<porta>`, que reúne `/varanda.json`, `/seeder`, `/media/*`, `/index/*`, `/account/*`, `/blob/*`, `/f/*` e `/p/*`; o resto vai para o servidor do Expo ou para o `dist` exportado.

### SMS simulado

Expand Down
36 changes: 36 additions & 0 deletions docs/verification/chore-lab-paginas.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
# Páginas no laboratório hospedado (branch chore/lab-paginas)

Parte da #352. Só ferramenta de desenvolvimento: muda `apps/cli/scripts/hosted-lab.js`, exporta de `apps/cli/lib/commands/account.js` as funções que abrem os clientes de Páginas (o laboratório os abre como o serviço) e atualiza `docs/development.md`. Nada muda no serviço de produção, no app, no protocolo, no RPC ou nos Termos.

- **Páginas ligadas.** `GET /account/pages/policy` responde `{ available: true }`. O `VARANDA_PAGE_KEYS` é sorteado a cada execução, fica só na memória do processo e nunca é impresso; as Páginas somem com os dados do laboratório (Ctrl-C).
- **Fotos e voz nas Conversas.** O semeador do laboratório ganha `blobPostage` (o pool de pedaços cifrados e o selo deles), e o laboratório manda `/blob/*` e `/f/*` ao semeador, como `varanda seed` e o `deploy/seeder/Caddyfile`. Sem isso, a primeira foto falhava com "Sem conexão agora".
- **Códigos de recuperação.** O serviço de conta do laboratório abre a loja `recovery.json`. Um código criado em Ajustes › Passkeys e recuperação abre a mesma conta num segundo perfil do Chrome, que vira o segundo aparelho da pessoa. Antes, a tela respondia "serviço indisponível".

Como verificar, a partir da raiz:

- `node apps/cli/test/hosted-lab.test.js`: o teste do laboratório no ar confere `/account/pages/policy`, o caminho `/blob/` até o semeador e `/account/recovery/fetch` com uma entrada desconhecida, que responde 404 `{ error: 'nao-encontrado', recovery: true }` da própria loja. Sem a loja, as duas asserções de recuperação falham; com ela, o arquivo passa inteiro. `routeOf` cobre `/blob/` e `/f/`.
- `npm run lint`, `npm test -- --affected=origin/main` e `npm run demo`.

## Caminhadas na web feitas com este laboratório (2026-11-17)

Decisão do Rodrigo (17/11): as caminhadas de Páginas vão na web, no laboratório, com Chrome headless, um processo por pessoa e passkey virtual com PRF, 412x915. Android e iOS continuam devidos (build de preview do EAS). Interface: export web de `075476f`. A = Ana (dona), B = Bia (admin), C = Caio, D = Davi. As capturas ficam fora do git, em `~/Workspace/evidencias/chore-lab-paginas/`.

- [x] #669, marcas de Página na busca: a linha de "Padaria" diz "Página"; aberta, mostra "Página" e "Anúncios" desde o primeiro quadro, nunca o perfil de pessoa. Uma pessoa não tem a marca.
- [x] #690, Avisos vazios da Página: "Nenhum aviso da página ainda. Quando alguém seguir a página, comentar, citar, mencionar o @nome dela, curtir ou republicar uma publicação dela, aparece aqui."
- [x] §148, Conversas da Página: o pedido de C chega aos Pedidos dos dois admins; B aceita e responde; C vê a resposta como "Padaria do Lab", nunca como "Bia Admin"; o aparelho da dona arquiva o aceite e a resposta. Depois de remover um admin, ele não envia mais (aviso de chave diferente) e não recebe o que chega depois; guarda o histórico que já tinha.
- [x] #704, mídia numa conversa da Página: num pedido, foto e voz esperam um toque; a foto abre e a voz toca; depois de aceitar, as fotos carregam sozinhas.
- [x] #697, encaminhar como Página: texto encaminhado; foto com legenda leva só a legenda, com o aviso da folha; foto sozinha não oferece "Encaminhar"; C vê "Encaminhada".
- [x] Troca de chave vista por quem fica: um admin que fica guarda a chave nova sem passo seu; depois que a dona remove outro admin, os que estão nas Conversas da Página veem "A chave publicada da página não é a deste aparelho" antes de qualquer envio, e "ler a chave de novo" tira o aviso.
- [x] #708, mudar a chave com Conversas ativas: as conversas da chave antiga ficam no chip "Chave antiga", só para ler, sem campo de envio, com "Copiar" como única ação; foto abre e voz toca; o chip continua depois de reabrir Páginas; quem segue vê "mudou de chave" e já segue a chave nova; uma mensagem para a chave nova chega aos dois admins.
- [x] Encerrar com Conversas ativas: no aparelho da dona a caixa some das Conversas.
- [x] Segundo aparelho por código de recuperação: B cria o código; o segundo perfil entra com ele, cria uma passkey nova, lista a Página e abre as Conversas dela sem "Ativar"; uma mensagem de C chega a ele em cerca de 1 min.
- [x] Admin removido, no segundo aparelho: ao abrir Páginas, a Página some.
- [ ] §149, grupo privado como Página: parou antes de entrar. A Página abre o "Geral" pela busca, mas "Entrar como a página" responde "Serviço indisponível": o serviço recusa `fora-da-comunidade` (a Página ainda não está na comunidade), o app não tem texto para isso e, ao contrário da pessoa, não abre a comunidade antes. Correção num PR seguinte da #352.
- [ ] Miniatura de anúncio numa conversa da Página: a Feira fica fechada no laboratório (coberto por `page-dm-media-e2e.test.js`).
- [ ] Encaminhar só para conversas da Página e "Carregar mais": pediriam conversas pessoais e mais de quatro páginas de lista (coberto por `forwardSheet.test.js`).

Achados para um PR seguinte da #352 (vistos em todas as rodadas):

- O cartão do topo das Conversas da Página mostra "ocupado" e "tentar de novo" cru quando as vagas de leitura estão ocupadas.
- Nomes: em Ajustes da página, cada aparelho só nomeia a própria linha, as outras dizem "sem nome", e a confirmação diz "Remover sem nome da administração da página?" (a dona removeu o admin errado numa rodada). A Página perde o nome ("Sem @nome ainda.") depois de remover um admin; linhas sem nome em Páginas logo depois de criar ou aceitar; "Pessoa" nas linhas de pedido; a confirmação de encerrar não cita o @nome.
- Depois de encerrar a Página, ou de perder o papel nela, o aparelho continua agindo como ela até recarregar.