@dotrino/identity 0.54.0 → 0.54.2

package/package.json

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

package/src/node.js

@@ -170,6 +170,18 @@ export class Identity {
   // Acta de perfil (qué llaves son del perfil y qué puede cada una; ver acta-de-perfil.md)
   profileActa () { return this._h('profileActa') }
   profileMembers () { return this._h('profileMembers') }
+  /**
+   * Quien SELLA SOBRES (la bóveda) registra aquí cómo estrenar su llave de sellado: se
+   * llama al sellar cada acta, porque esa llave rota con el acta (§8.9 de
+   * `dotrino-vault/docs/secretos-sellados.md`). Va por aquí y no por el iframe porque
+   * este puente es en-proceso: al navegador no se le puede pasar una función, y tampoco
+   * la necesita — no sella secretos de nadie.
+   */
+  setSealKeyProvider (provider) { return this._h('setSealKeyProvider', { provider }) }
+  /** Estrena la llave de sellado en un acta nueva, sin tocar a ningún miembro. */
+  rotateSealKey () { return this._h('rotateSealKey') }
+  /** Con qué llave se comprueban los sobres que se firmaron con el acta `seq`. */
+  sealKeyAt (seq) { return this._h('sealKeyAt', { seq }) }
   myMembership () { return this._h('myMembership') }
   /**
    * La CADENA de actas desde `sinceSeq` (para que un dispositivo que estuvo apagado

package/vault/acta.js

@@ -253,8 +253,11 @@ export async function applyChanges (acta, changes, { by, now = Date.now(), sealP
   if (!by) throw new Error('applyChanges: missing `by` (who seals)')
   if (by !== acta.sealer) throw new Error('only the master can change the record; this device is not the master')
 
-  const list = Array.isArray(changes) ? changes : [changes]
-  if (list.length === 0) throw new Error('applyChanges: no hay cambios')
+  const list = (Array.isArray(changes) ? changes : [changes]).filter(Boolean)
+  // Estrenar la llave de sellado ES un cambio del acta, aunque no toque a ningún miembro:
+  // rota con el acta (§8.9) y el acta es lo que le da autoridad. Por eso una lista vacía
+  // se acepta si viene con llave nueva, y solo entonces.
+  if (list.length === 0 && !sealPub) throw new Error('applyChanges: no hay cambios')
 
   const next = {
     ...acta,

package/vault/core.js

@@ -1470,12 +1470,24 @@ export async function createIdentityCore ({ kv: rawKv, peers, makeSync = null, k
      * Es opt-in a propósito: una identidad de navegador no sella nada, y un acta sin llave
      * de sellado es perfectamente válida.
      */
-    setSealKeyProvider (fn) {
-      sealKeyProvider = typeof fn === 'function' ? fn : null
+    setSealKeyProvider ({ provider } = {}) {
+      sealKeyProvider = typeof provider === 'function' ? provider : null
+      return { ok: true, set: !!sealKeyProvider }
+    },
+
+    /**
+     * Estrena la llave de sellado sin tocar a nadie más: pide una al proveedor y la nombra
+     * en un acta nueva. Es lo que hace la bóveda al arrancar si el acta no tiene llave, o
+     * si la que nombra no es suya (el disco se restauró, otro master la puso…).
+     */
+    async rotateSealKey () {
+      if (!sealKeyProvider) throw new Error('this identity does not seal envelopes')
+      const acta = await sealChanges([])
+      return { ok: true, seq: acta.seq, sealPub: acta.sealPub }
     },
 
     /** La llave con la que se firmaron los sobres de un acta dada. Para VERIFICARLOS. */
-    sealKeyAt (seq) {
+    sealKeyAt ({ seq } = {}) {
       return Acta.sealKeyAt(loadActa(), seq)
     },