@dotrino/identity 0.99.0 → 0.101.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotrino/identity",
-  "version": "0.99.0",
+  "version": "0.101.0",
   "description": "Identidad y rating de usuarios compartidos entre apps de Dotrino (vault iframe + postMessage)",
   "type": "module",
   "main": "src/index.js",

package/src/node.js

@@ -149,6 +149,8 @@ export class Identity {
   sealMasterKey () { return this._core?.sealMasterKey?.() }
   /** Vuelve a cargar el par tras abrir el candado, sin reabrir la identidad. */
   reloadMasterKey () { return this._core?.reloadMasterKey?.() }
+  /** Ver `core.js`: al abrir, los aparatos muertos salen del acta en una sola. */
+  pruneExpiredDevices (now) { return this._core?.pruneExpiredDevices?.(now) }
 
   _h (method, params = {}) {
     if (!this._core) throw new Error('Identity not ready — call ready()/connect() first')

package/vault/core.js

@@ -18,7 +18,7 @@
  * vault, compartida por todos los runtimes.
  */
 
-import { signDelegationWith } from './capabilities.js'
+import { signDelegationWith, LEGACY_CERTS_UNTIL } from './capabilities.js'
 import * as Acta from './acta.js'
 import * as Content from './content.js'
 import { assertionBody, cleanScopes, claimsAllowed, ASSERTION_DEFAULT_TTL_MS, ASSERTION_MAX_TTL_MS } from './assertion.js'
@@ -1007,6 +1007,62 @@ export async function createIdentityCore ({ kv: hostKv, peers, makeSync = null,
     return { gen, sinLlave }
   }
 
+  /**
+   * LOS APARATOS MUERTOS SALEN DEL ACTA al abrir la bóveda (dueño, 2026-09-22: *«si se abre
+   * el vault y hay un aparato expirado debe quitarlo del acta en una nueva acta»*).
+   *
+   * Muerto es un aparato cuyo papel no tiene vuelta atrás: todos los certificados que ESTA
+   * bóveda le dio son del modelo viejo (sin `seq`) y ya no valen — vencidos, o pasado
+   * `LEGACY_CERTS_UNTIL`, que los retira a todos. Renovar tampoco lo salva: la renovación
+   * viaja firmada con ese mismo papel, y la bóveda lo rechaza (`unauthorized: expired`).
+   * Hasta ahora se quedaban en el acta para siempre, como miembros que nadie podía usar.
+   *
+   * Lo que NO se toca, porque no hay datos para juzgarlo:
+   *   · un miembro sin certificados de esta bóveda (se los pudo dar otra);
+   *   · un papel viejo sin `exp` antes del corte;
+   *   · esta misma llave.
+   *
+   * Todo sale en UNA acta: las bajas y la clave de contenido nueva van en el mismo sello,
+   * así que la bajada de `seq` es una y no una por aparato. Solo con la maestra en memoria:
+   * cerrada no firma nada (`CLAUDE.md`, «la maestra tiene dos trabajos»), y cambiar el acta
+   * al abrir es justo uno de ellos.
+   */
+  async function pruneExpiredDevices (now = Date.now()) {
+    if (!keypair?.privateKey) return { removed: [], seq: null }
+    const acta = loadActa()
+    if (!acta) return { removed: [], seq: null }
+    const store = loadDelegations(); const rev = loadRevocations()
+    const porSub = new Map()
+    for (const d of Object.values(store)) {
+      if (!d?.sub || d.revokedAt || rev[d.nonce]) continue
+      if (!porSub.has(d.sub)) porSub.set(d.sub, [])
+      porSub.get(d.sub).push(d)
+    }
+    const muerto = (d) => typeof d.seq !== 'number' &&
+      (now > LEGACY_CERTS_UNTIL || (typeof d.exp === 'number' && now > d.exp))
+    const muertos = [...porSub]
+      .filter(([sub, ds]) => sub !== publickeyJwkStr && ds.every(muerto))
+      .map(([sub, ds]) => ({ pub: sub, label: ds[0]?.label || '' }))
+    if (!muertos.length) return { removed: [], seq: acta.seq }
+
+    const fuera = new Set(muertos.map((m) => m.pub))
+    const miembros = (acta.members || []).filter((m) => fuera.has(m.pub)).map((m) => m.pub)
+    let seq = acta.seq
+    if (miembros.length) {
+      // La clave de contenido rota en la misma acta: quien sale no se lleva lo que venga.
+      const quedan = acta.members.filter((m) => !fuera.has(m.pub))
+      const gen = ((acta.keyring || []).at(-1)?.gen || 0) + 1
+      const { generation } = await Content.makeGeneration({ members: quedan, gen })
+      const sealed = await sealChanges([
+        ...miembros.map((pub) => ({ op: 'remove', pub })),
+        { op: 'keyring', generation },
+      ])
+      seq = sealed.seq
+    }
+    for (const { pub } of muertos) revokePriorCertsFor(pub, null)
+    return { removed: muertos, seq }
+  }
+
   // ----- ENTRAR CON USUARIO Y CONTRASEÑA (`temporary-access.md` §3.4) -----
   //
   // Lo que llega de `@dotrino/vault/login-client` es un APARATO entero: sus dos llaves
@@ -1310,7 +1366,13 @@ export async function createIdentityCore ({ kv: hostKv, peers, makeSync = null,
       // él se va la última razón por la que la maestra tenía que estar disponible sin nadie
       // delante. Renovar pasa a ocurrir justo cuando ya hay una selladora abierta, porque
       // cambiar el acta ES tenerla abierta.
-      if (!certDesfasadoDelActa()) return
+      // Y LA MIGRACIÓN: un papel del modelo viejo (sin `seq`) que todavía vale se cambia por
+      // uno nuevo. Sin esto moría en su fecha aunque el aparato se usara a diario, y ya no
+      // tenía arreglo — el teléfono que aprueba se quedó así el 2026-09-22. Caduca sola: a
+      // partir de `LEGACY_CERTS_UNTIL` no queda ningún papel viejo que valga.
+      const legadoVivo = typeof v.cert.seq !== 'number' && typeof v.cert.exp === 'number' &&
+        now < v.cert.exp && now < LEGACY_CERTS_UNTIL
+      if (!legadoVivo && !certDesfasadoDelActa()) return
       if (now - renewLastTry < RENEW_RETRY_MS) return
       renovarCert().catch(() => {}) // best-effort: el cert vigente sigue sirviendo mientras tanto
     } catch (_) {}
@@ -1847,6 +1909,9 @@ export async function createIdentityCore ({ kv: hostKv, peers, makeSync = null,
       kv.removeItem('dotrino.identity.pwd.tries')
       try { sessionKv?.setItem(_scoped(PWD_SESSION), proof) } catch (_) {}
       locked = false
+      // Abrir es cuando se limpia el acta de aparatos muertos. Por detrás: abrir no puede
+      // esperar a sellar, y si falla se dice, no se calla.
+      pruneExpiredDevices().catch((e) => console.warn('[identity] could not remove expired devices:', e.message))
       return { ok: true, locked: false }
     },
     // Poner/cambiar contraseña (requiere estar desbloqueado; cambiar exige la actual vía unlock previo).
@@ -2206,7 +2271,7 @@ export async function createIdentityCore ({ kv: hostKv, peers, makeSync = null,
     // `issued` = lo que HOY sirve para entrar. Antes devolvía el almacén entero, revocados
     // incluidos (revocar solo estampa `revokedAt`), así que la consola seguía pintando como
     // activo un cert ya retirado: pulsabas «quitar» y la fila no se movía. Los caducados ya
-    // los poda `loadDelegations`. El histórico retirado va aparte, en `revokedCerts`.
+    // los quita del acta `pruneExpiredDevices` al abrir la bóveda. El histórico retirado va aparte, en `revokedCerts`.
     async listDelegations () {
       const store = loadDelegations(); const rev = loadRevocations()
       const all = Object.values(store).sort((a, b) => (b.iat || 0) - (a.iat || 0))
@@ -3404,6 +3469,8 @@ export async function createIdentityCore ({ kv: hostKv, peers, makeSync = null,
     get masterLocked () { return !keypair?.privateKey },
     /** Echa el candado a la maestra que ya existía (al abrir el perfil). Idempotente. */
     sealMasterKey,
+    /** Quita del acta, en una sola, los aparatos cuyo papel ya no tiene vuelta atrás. */
+    pruneExpiredDevices,
     /** Recarga el par tras abrir el candado, sin reabrir la identidad entera. */
     async reloadMasterKey () {
       keypair = await loadOrCreateKeypair()

package/vault/vault.js

@@ -405,7 +405,7 @@ import { pubkeyId } from './capabilities.js'
      * la bóveda guarda un paquete que no puede abrir. Es el mismo camino que `logins add`
      * del binario, con la misma pieza compartida.
      */
-    selfVaultLoginAdd: async ({ user, password, label = '', scope = null, unattended = false } = {}) => {
+    selfVaultLoginAdd: async ({ user, password, label = '', caps } = {}) => {
       const d = pidaDaemon()
       const { client: opaque } = await import('@dotrino/opaque')
       const { makeDeviceKey, makeDeviceEncKey } = await import('@dotrino/identity/capabilities')
@@ -422,7 +422,8 @@ import { pubkeyId } from './capabilities.js'
       const blob = await sealDeviceKeys(fin.exportKey, { sign: device.privateJwk, enc: enc.encPrivateJwk })
       const r = await d.loginRegisterFinish({
         user, upload: fin.upload, pub: device.publickey, encPub: enc.encPublickey,
-        label: nombre, blob, ...(Array.isArray(scope) && scope.length ? { scope } : {}), unattended: !!unattended
+        // Los PERMISOS del acta, cualquiera de ellos: los traduce a scopes el pilar del vault.
+        label: nombre, blob, ...(caps ? { caps } : {})
       })
       return { ...r, address: loginAddress(user, await accountFingerprint(selfIdentity)) }
     },

package/vault/vendor/vault/VERSION.txt

@@ -1,4 +1,4 @@
-Copia vendorizada de @dotrino/vault@0.68.0 (dotrino-vault/lib/src/{index,enroll,protocol,passwordLogins,loginClient,b64}.js).
+Copia vendorizada de @dotrino/vault@0.71.0 (dotrino-vault/lib/src/{index,enroll,protocol,passwordLogins,loginClient,b64}.js).
 NO se edita a mano: la escribe `node vendor.mjs` y la vigila test/vendor-up-to-date.test.mjs.
 index.js importa ./enroll.js y ./protocol.js (relativos, van en esta misma copia),
 @dotrino/identity/{capabilities,acta} (= ../../{capabilities,acta}.js) y

package/vault/vendor/vault/loginClient.js

@@ -34,7 +34,7 @@
  * Si algo de eso falla, se PARA con un `code` propio. No hay repliegue: entrar «a medias»
  * en una cuenta es peor que no entrar.
  */
-import { client as opaque } from '@dotrino/opaque'
+import { client as opaquePorDefecto } from '@dotrino/opaque'
 import { pubkeyId, verifyDeviceSig, signWithDevice } from '@dotrino/identity/capabilities'
 import { checkVaultReply } from '@dotrino/identity/acta'
 import { MSG } from './protocol.js'
@@ -82,11 +82,16 @@ const parseJson = (s) => { try { return JSON.parse(s) } catch (_) { return null
  * @param {string} opts.password
  * @param {string} [opts.label]    de dónde se entra («el cyber de la esquina»): es lo que
  *   el dueño va a leer en su consola para decidir si cerrarlo.
+ * @param {object} [opts.opaque]   el OPAQUE a usar. Por defecto el de casa, que va en este
+ *   mismo hilo. Se inyecta porque en una EXTENSIÓN el WASM vive en una página sandbox, al
+ *   otro lado de un `postMessage`, y entonces sus métodos devuelven promesas — igual que en
+ *   `createLoginDesk`, y por el mismo motivo. Aquí se espera siempre: esperar a algo que no
+ *   es una promesa no cuesta nada, y dos firmas serían dos clientes.
  * @returns {Promise<{user:string,address:string,code:string,sid:string,cert:object,
  *   iss:string,acta:object,vaultToken:string,publickey:string,encPublickey:(string|null),
  *   keys:{sign:object,enc:(object|null)}}>}
  */
-export async function loginWithPassword ({ transport, address, password, label = '', timeoutMs = REPLY_TIMEOUT_MS } = {}) {
+export async function loginWithPassword ({ transport, address, password, label = '', timeoutMs = REPLY_TIMEOUT_MS, opaque = opaquePorDefecto } = {}) {
   if (!transport || typeof transport.on !== 'function' || typeof transport.send !== 'function') {
     throw err('no-transport', 'loginWithPassword: a connected transport is required')
   }
@@ -104,7 +109,7 @@ export async function loginWithPassword ({ transport, address, password, label =
   let ultimo = null
   for (const token of tokens) {
     try {
-      return await unIntento({ transport, token, user, code, dir, password, label, timeoutMs })
+      return await unIntento({ transport, token, user, code, dir, password, label, timeoutMs, opaque })
     } catch (e) {
       // Se para: son cosas del que entra, y probar con otra bóveda no las arregla.
       if (e?.code === 'login-failed' || e?.code === 'too-many-tries' || e?.code === 'wrong-account' ||
@@ -115,15 +120,15 @@ export async function loginWithPassword ({ transport, address, password, label =
   throw ultimo || err('no-vault', 'none of the vaults on that address could let you in')
 }
 
-async function unIntento ({ transport, token, user, code, dir, password, label, timeoutMs }) {
-  const start = opaque.loginStart({ password })
+async function unIntento ({ transport, token, user, code, dir, password, label, timeoutMs, opaque }) {
+  const start = await opaque.loginStart({ password })
   transport.send(token, { type: MSG.LOGIN_START, user, request: start.request })
   const r1 = await waitFor(transport, token, (p) => p.type === MSG.LOGIN_RESPONSE || p.type === MSG.ERROR, timeoutMs)
   if (r1.type === MSG.ERROR) throw deVuelta(r1)
 
   let fin
   try {
-    fin = opaque.loginFinish({ state: start.state, response: r1.response, password })
+    fin = await opaque.loginFinish({ state: start.state, response: r1.response, password })
   } catch (_) {
     // OPAQUE comprueba a las dos partes: aquí se sabe que el otro lado NO conoce el
     // registro de este usuario. Contraseña equivocada, usuario que no existe o una bóveda
@@ -198,11 +203,26 @@ function deVuelta (p) {
  * quedarse bloqueado esperándola. La sesión sigue abierta allí hasta que se cierre desde la
  * consola, y eso ya está dicho en el diseño (§3.2).
  */
-export async function closeLogin ({ transport, token, user, sid, publickey, privateJwk, privateKey, timeoutMs = REPLY_TIMEOUT_MS } = {}) {
+export async function closeLogin ({ transport, token, user, sid, publickey, privateJwk, privateKey, sign, timeoutMs = REPLY_TIMEOUT_MS } = {}) {
   if (!transport || typeof transport.send !== 'function') throw err('no-transport', 'closeLogin: transport required')
   if (!token || !user || !sid || !publickey) throw err('bad-input', 'closeLogin: token, user, sid and publickey are required')
   const data = { op: 'login.close', publickey, user, sid, ts: Date.now() }
-  const { signature } = await signWithDevice({ privateJwk, privateKey, publickey, data })
+  // CON LA LLAVE O CON QUIEN LA TIENE. `sign(data)` es lo normal en el ecosistema —el
+  // transporte se identifica con `identity.signData` y no con una llave suelta— y aquí hace
+  // falta de verdad: en una extensión la llave vive en el service worker y quien tiene el
+  // socket es la página, así que o se firma a distancia o la llave privada tendría que
+  // cruzar para nada. Sin ninguna de las dos no se firma, y salir no se puede fingir.
+  //
+  // Se comprueba ANTES de firmar: sin nada con qué hacerlo, WebCrypto revienta con un error
+  // suyo que no dice qué falta («code: 0»), y el de arriba es el que se puede buscar.
+  if (typeof sign !== 'function' && !privateJwk && !privateKey) {
+    throw err('no-signature', 'closeLogin: give it the device key (privateJwk/privateKey) or a sign(data)')
+  }
+  const firmado = typeof sign === 'function'
+    ? await sign(data)
+    : await signWithDevice({ privateJwk, privateKey, publickey, data })
+  const signature = typeof firmado === 'string' ? firmado : firmado?.signature
+  if (typeof signature !== 'string') throw err('no-signature', 'closeLogin: sign(data) returned no signature')
   transport.send(token, { type: MSG.LOGIN_CLOSE, data, signature })
   try {
     const r = await waitFor(transport, token, (p) => p.type === MSG.LOGIN_CLOSED || p.type === MSG.ERROR, timeoutMs)

package/vault/vendor/vault/passwordLogins.js

@@ -26,8 +26,8 @@
  */
 import { server as opaquePorDefecto, suiteId as suitePorDefecto } from '@dotrino/opaque'
 import { pubkeyId } from '@dotrino/identity/capabilities'
-import { deviceIdOf, scopeToCaps, scopeToCn } from './enroll.js'
-import { SCOPE } from './protocol.js'
+import { DEVICE_CAPS, capScope } from '@dotrino/identity/acta'
+import { deviceIdOf } from './enroll.js'
 import { bytesToB64url, b64urlToBytes } from './b64.js'
 
 /** Un usuario es la parte de antes de la `@` en `nombre@AB12-CD34-EF56`. */
@@ -445,24 +445,35 @@ export function createLoginDesk ({ load, save, now = () => Date.now(), opaque =
  * @param {object} opts
  *   `identity` la identidad que firma (`signDelegation`, `admitMember`)
  *   `logins`   el escritorio de `createLoginDesk`
- *   `scope`    permisos del aparato; por defecto firmar, leer y guardar
- *   `unattended` si además puede trabajar sin que nadie apruebe
+ *   `caps`     los PERMISOS del acta que lleva el aparato, cualquiera de `DEVICE_CAPS`;
+ *              por defecto firmar, leer y guardar
  */
 export async function registerLogin ({
   identity, logins, user, upload, pub, encPub = null, label = '', blob,
-  scope, unattended = false, replace = false
+  caps = ['sign', 'read', 'store'], scope, replace = false
 } = {}) {
   if (replace) {
     await logins.registerFinish({ user, upload, blob, replace: true })
     return { ok: true, user, replaced: true }
   }
-  // PERMISOS, no tipos: los del scope, más `unattended` si quien lo crea lo eligió
-  // (temporary-access.md §3.1). `passwords` no entra todavía — hasta que existan las
-  // contraseñas selladas, este aparato se llevaría TODAS (sealed-passwords.md).
-  const scopes = Array.isArray(scope) && scope.length ? scope : [SCOPE.SIGN, SCOPE.READ, SCOPE.STORE]
-  if (scopes.includes(SCOPE.PASSWORDS)) {
-    throw Object.assign(new Error('a password login cannot take `contrasenas` yet: the sealed passwords come first'), { code: 'passwords-not-yet' })
+  // CUALQUIER PERMISO, y todos por el mismo camino (dueño, 2026-09-21: «al crear debe
+  // poder asignársele cualquier permiso»; regla dura «simplificar los procesos»). Antes
+  // llegaban como scopes del certificado con `unattended` aparte, `passwords` se rechazaba
+  // con `passwords-not-yet` y `passkeys` —que no tiene scope— no se podía asignar.
+  //
+  // `scope` ya no se acepta, y se dice: ignorarlo daría al aparato los permisos por defecto
+  // en vez de los que se eligieron, y nadie lo notaría.
+  if (scope !== undefined) {
+    throw Object.assign(new Error('registerLogin takes `caps` (account record permissions), not `scope`'), { code: 'use-caps' })
   }
+  const pedidos = [...new Set(Array.isArray(caps) ? caps : [])]
+  const raros = pedidos.filter((c) => !DEVICE_CAPS.includes(c))
+  if (!pedidos.length || raros.length) {
+    throw Object.assign(new Error(`not device permissions: ${raros.join(', ') || '(none)'} — expected any of ${DEVICE_CAPS.join(', ')}`), { code: 'bad-caps' })
+  }
+  // El certificado lleva el scope de los permisos que lo tienen; los demás (`unattended`,
+  // `passkeys`) viven solo en el acta, que es quien decide.
+  const scopes = pedidos.map((c) => capScope(c)).filter(Boolean)
   if (typeof identity?.admitMember !== 'function') {
     throw Object.assign(new Error('this vault cannot add devices to the account record: no login was created'), { code: 'admit-unavailable' })
   }
@@ -470,11 +481,9 @@ export async function registerLogin ({
   await logins.registerFinish({ user, upload, pub, encPub, deviceId, label, blob })
   try {
     const { cert } = await identity.signDelegation(pub, scopes, { label: label || `login:${user}` })
-    const cn = scopeToCn(scopes)
-    const caps = [...new Set([...scopeToCaps(scopes), ...(unattended ? ['unattended'] : [])])]
-    await identity.admitMember({ pub, encPub, label: label || `login:${user}`, cn, caps, cert })
+    await identity.admitMember({ pub, encPub, label: label || `login:${user}`, cn: null, caps: pedidos, cert })
     logins.setCert({ user, cert, iss: identity.me?.publickey || null })
-    return { ok: true, user, deviceId, cert, caps }
+    return { ok: true, user, deviceId, cert, caps: pedidos }
   } catch (e) {
     // NADA DE MEDIAS ALTAS: si no entra en el acta, no queda un usuario que pueda entrar a
     // una cuenta que no lo reconoce. Se deshace y se dice.