@dotrino/identity 0.54.2 → 0.56.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotrino/identity",
-  "version": "0.54.2",
+  "version": "0.56.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

@@ -177,6 +177,10 @@ export class Identity {
    * este puente es en-proceso: al navegador no se le puede pasar una función, y tampoco
    * la necesita — no sella secretos de nadie.
    */
+  /** Abre un sobre sellado A ESTE aparato (envoltura + sobre). Ver `core.js`. */
+  openSealedValue (wrap, envelope) { return this._h('openSealedValue', { wrap, envelope }) }
+  /** Re-envuelve para otro miembro una llave que este aparato ya puede abrir. */
+  rewrapFor (wrap, encPub) { return this._h('rewrapFor', { wrap, encPub }) }
   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') }

package/vault/core.js

@@ -1649,6 +1649,47 @@ export async function createIdentityCore ({ kv: rawKv, peers, makeSync = null, k
       return Content.encryptWithCek({ cek: mine.cek, gen: mine.gen, plaintext: String(plaintext) })
     },
 
+    /**
+     * Abre un sobre SELLADO A ESTE APARATO: primero la envoltura de la llave —con la
+     * privada de cifrado de este dispositivo, que nunca sale de aquí— y con ella el sobre.
+     *
+     * Es lo que deja a un aparato de administración VER un secreto de la bóveda **sin
+     * teclear ninguna contraseña** (§8.2 de `dotrino-vault/docs/secretos-sellados.md`):
+     * la capacidad de leer deja de ser una frase que se escribe en cualquier parte y pasa
+     * a ser una llave que no se mueve del aparato.
+     *
+     * Distinto de `openContent`, que usa el llavero del PERFIL (el contenido del usuario);
+     * aquí la envoltura viene suelta, del llavero de un cajón de secretos.
+     */
+    async openSealedValue ({ wrap, envelope } = {}) {
+      if (!wrap || !envelope) throw new Error('openSealedValue: missing the wrap or the envelope')
+      const cek = await Content.openWrap({ wrap, myEncPrivateKey: encKeypair.privateKey })
+      return Content.decryptWithCek({ cek, envelope })
+    },
+
+    /**
+     * RE-ENVUELVE para otro miembro una llave que este aparato ya puede abrir.
+     *
+     * Es lo que permite completar a un aparato que entró tarde **sin la frase del
+     * perfil y sin que la bóveda tenga que abrir nada**: quien administra ya tiene su
+     * envoltura de ese cajón —por eso puede pulsar «Ver»—, así que abre la llave con la
+     * suya, que no sale de este dispositivo, y la vuelve a envolver para la pública del
+     * recién llegado.
+     *
+     * No regala nada: quien hace esto ya podía leer ese cajón, y a quien se lo entrega
+     * es a alguien que el ACTA —firmada por la maestra— ya reconoce como miembro. La
+     * autorización es el acta; esto solo es el sobre.
+     *
+     * @param {{ wrap: any, encPub: string }} o `wrap`: mi envoltura · `encPub`: la
+     *   pública de cifrado del miembro al que hay que envolvérsela.
+     * @returns {Promise<any>} la envoltura nueva, para que la bóveda la guarde.
+     */
+    async rewrapFor ({ wrap, encPub } = {}) {
+      if (!wrap || !encPub) throw new Error('rewrapFor: missing the wrap or the recipient key')
+      const cek = await Content.openWrap({ wrap, myEncPrivateKey: encKeypair.privateKey })
+      return Content.wrapForMember({ cek, memberEncPub: encPub })
+    },
+
     /** Abre un sobre de contenido con el llavero del perfil (todas las generaciones). */
     async openContent ({ envelope } = {}) {
       return Content.decryptWithKeyring({