diff --git a/apps/cli/lib/commands/account.js b/apps/cli/lib/commands/account.js index 14986c855..e6fa67e53 100644 --- a/apps/cli/lib/commands/account.js +++ b/apps/cli/lib/commands/account.js @@ -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 } }, diff --git a/apps/cli/scripts/hosted-lab.js b/apps/cli/scripts/hosted-lab.js index 7ccc8c2d9..817e18f22 100644 --- a/apps/cli/scripts/hosted-lab.js +++ b/apps/cli/scripts/hosted-lab.js @@ -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:, 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. @@ -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' @@ -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 = [] @@ -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 } @@ -480,6 +490,9 @@ 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. @@ -487,10 +500,28 @@ async function main () { 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, diff --git a/apps/cli/test/hosted-lab.test.js b/apps/cli/test/hosted-lab.test.js index 153c89b5a..2d60b9b8e 100644 --- a/apps/cli/test/hosted-lab.test.js +++ b/apps/cli/test/hosted-lab.test.js @@ -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], @@ -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') @@ -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() diff --git a/docs/development.md b/docs/development.md index 1da8bfa54..c9f97dfbc 100644 --- a/docs/development.md +++ b/docs/development.md @@ -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:`, 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:`, 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 diff --git a/docs/verification/chore-lab-paginas.md b/docs/verification/chore-lab-paginas.md new file mode 100644 index 000000000..7269ab4a7 --- /dev/null +++ b/docs/verification/chore-lab-paginas.md @@ -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.