@dotrino/vault 0.12.0 → 0.13.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotrino/vault",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Usa ESTE dispositivo (navegador) como bóveda/CA del ecosistema Dotrino: atiende enrolamientos por el proxy y firma certificados de delegación a tus máquinas. Incluye el cliente de SERVICIO (Node): un proyecto se enrola una vez y jala sus credenciales del vault en vez del .env (`import '@dotrino/vault/config'`).",
   "type": "module",
   "main": "src/index.js",
@@ -43,7 +43,7 @@
   ],
   "peerDependencies": {
     "@dotrino/identity": ">=0.30.0",
-    "@dotrino/proxy-client": ">=0.6.0"
+    "@dotrino/proxy-client": ">=0.9.0"
   },
   "license": "MIT",
   "repository": {

package/src/enroll.js

@@ -146,14 +146,20 @@ export function createEnrollDesk ({
    *                       aviso. Es ORIENTATIVO (un nombre que puso su dueño); la
    *                       identidad de verdad de la cuenta es `iss`.
    */
-  function startPairing ({ scope = defaultScope, ttlMs = defaultTtlMs, label = '', mode = 'join', account = '' } = {}) {
+  async function startPairing ({ scope = defaultScope, ttlMs = defaultTtlMs, label = '', mode = 'join', account = '' } = {}) {
     pending.clear() // uno a la vez: una sesión nueva supersede a la anterior
     const acct = String(account || '').slice(0, 40)
-    // INVITACIÓN CORTA: si sabemos nuestra dirección en el proxy, el QR lleva solo
-    // eso y el nonce de la sesión (13 bytes). La llave, el proxy y el nombre de la
-    // cuenta los pide el aparato por la red presentando el `sn`. El nonce hace de
-    // identificador de sesión: no hace falta un token de emparejamiento aparte.
-    const conn = typeof connToken === 'function' ? connToken() : connToken
+    // INVITACIÓN CORTA: si sabemos cómo alcanzarnos, el QR lleva solo eso y el
+    // nonce de la sesión. La llave, el proxy y el nombre de la cuenta los pide el
+    // aparato por la red presentando el `sn`. El nonce hace de identificador de
+    // sesión: no hace falta un token de emparejamiento aparte.
+    //
+    // `conn` es una CITA del proxio (6 caracteres, un solo uso, caduca en
+    // minutos), no la dirección de la conexión: esa pasó a ser una instancia de
+    // 24 caracteres, que ni entra cómoda en un QR ni tiene por qué quedar impresa
+    // en algo que circula. Por eso se pide una nueva por emparejamiento, y por
+    // eso esto es asíncrono.
+    const conn = typeof connToken === 'function' ? await connToken() : connToken
     if (conn) {
       const sn = randToken(8)
       pending.set(sn, { token: sn, exp: Date.now() + PAIRING_TTL_MS, scope, ttlMs, label, sn, mode, account: acct, state: 'AWAITING_ENROLL' })

package/src/invite.js

@@ -56,9 +56,12 @@ export const FMT_COMPACT = 'c'
  * que es lo único que de verdad decide. Esconderla no aportaba nada —una pública es
  * pública— y ocupaba 44 de los ~100 caracteres.
  *
- * `token` aquí NO es el de la sesión de emparejamiento: es el **token de conexión**
- * que el proxy le da a la bóveda (4 caracteres), o sea su dirección. Con eso el
- * aparato le habla directo, punto a punto, sin resolver nada.
+ * Lo que lleva NO es la dirección de la bóveda: es una **cita del proxy** —un código
+ * de 6 caracteres, de un solo uso y con minutos de vida, cuyos 2 primeros dicen qué
+ * proxio la emitió—. El aparato la CANJEA (`redeemPairingCode`) y obtiene la dirección
+ * real de la conexión, que hoy son 24 caracteres para poder rutearse entre proxios y no
+ * cabría cómoda en un QR. Además, una cita caduca y se quema: no deja una dirección
+ * permanente impresa en algo que circula.
  */
 export const FMT_SHORT = 't'
 
@@ -293,7 +296,10 @@ function compactDecode (text) {
  * Le pasa a cualquiera con proxy propio (y lo cazó el E2E de secretos, que levanta
  * uno local).
  */
-const CONN_TOKEN_LEN = 4
+// La CITA del proxio: 2 caracteres de prefijo de nodo + 4 = 6. Antes eran 4 (la
+// dirección de la conexión). Cambió porque la dirección pasó a ser una instancia
+// de 24 caracteres, y lo que se imprime en un QR ahora es una cita de un solo uso.
+const CONN_TOKEN_LEN = 6
 
 function shortEncode (qr) {
   if (!qr || qr.v !== 2) return null

package/src/service.js

@@ -77,6 +77,25 @@ async function verificarHola (p, sn) {
   return b
 }
 
+/**
+ * Canjea la cita del QR y devuelve la instancia a la que apunta.
+ *
+ * Una cita se quema al usarse y caduca en minutos, así que un error acá casi
+ * siempre significa lo mismo para quien lo lee: el código ya se usó o venció, y
+ * hay que pedir otro en la bóveda. Se dice así, no con el error crudo.
+ */
+async function resolverCita (client, code) {
+  if (!code) throw new Error('la invitación no trae código de emparejamiento')
+  if (typeof client.redeemPairingCode !== 'function') {
+    throw new Error('el proxio no soporta códigos de emparejamiento (actualizá @dotrino/proxy-client)')
+  }
+  const r = await client.redeemPairingCode(code)
+  if (!r?.ok || !r.instance) {
+    throw new Error(`ese código no sirve: ${r?.error || 'no válido'}. Pedí uno nuevo en la bóveda.`)
+  }
+  return r.instance
+}
+
 async function freshClient (proxyUrl, connectTimeoutMs = 20000) {
   installNodeGlobals()
   const { WebSocketProxyClient } = await import('@dotrino/proxy-client')
@@ -157,6 +176,11 @@ export async function enrollService ({ qr, ns, dir, label, onCode, approveTimeou
   const client = await freshClient(qr.proxy || 'wss://proxy.dotrino.com')
   // QR CORTO: se le pregunta a la bóveda quién es, punto a punto, presentando el `sn`.
   if (!qr.iss) {
+    // `qr.conn` es una CITA (código de 6 caracteres, un solo uso): hay que
+    // canjearla para saber a qué conexión apunta. El canje lo resuelve el proxio
+    // que la emitió —lo dice el prefijo del propio código—, así que funciona
+    // aunque la bóveda esté en otro proxio de la malla.
+    const destino = await resolverCita(client, qr.conn)
     const hola = await new Promise((resolve, reject) => {
       const off = client.on('message', (_f, p) => {
         if (p?.type === MSG.HELLO_OK) { fin(); verificarHola(p, qr.sn).then(resolve, reject) }
@@ -164,7 +188,7 @@ export async function enrollService ({ qr, ns, dir, label, onCode, approveTimeou
       })
       const t = setTimeout(() => { fin(); reject(new Error('la bóveda no contestó: ese código pudo caducar')) }, 15000)
       const fin = () => { off(); clearTimeout(t) }
-      try { client.send(qr.conn, { type: MSG.HELLO, sn: qr.sn }) } catch (e) { fin(); reject(e) }
+      try { client.send(destino, { type: MSG.HELLO, sn: qr.sn }) } catch (e) { fin(); reject(e) }
     })
     qr = { ...qr, iss: hola.iss, proxy: hola.proxy || qr.proxy }
   }