dotrino-content 0.3.7 → 0.3.9

package/bin/cli.js

@@ -100,8 +100,9 @@ if (cmd === 'enroll') {
         console.log('  (el código NO viaja por la red: lo tipeas tú)')
       }
     })
-    const days = Math.round((res.cert.exp - Date.now()) / 86400000)
-    console.log(`\nlisto: node enlazado. Certificado válido ${days} días (se renueva solo).`)
+    // El papel ya no vence por tiempo: vale mientras el acta lo diga, y se rehace solo
+    // cuando cambias permisos. Decir «válido N días» era describir un reloj que ya no existe.
+    console.log(`\nlisto: node enlazado. El permiso vale mientras lo diga tu bóveda; si se lo quitas, deja de valer en el acto.`)
     console.log(`identidad en ${serviceDir()}  ·  enlace en ${linkDir()}`)
     console.log(`\nahora carga su configuración en la bóveda (namespace «${NS}»):`)
     console.log('  dotrino-vault secret set content CONTENT_STORAGE=local --public')

package/lib/ref.js

@@ -31,8 +31,8 @@ export const isValidCid = (cid) => typeof cid === 'string' && CID_RE.test(cid)
  * @returns {string} `<owner>/<cid>` o `<owner>/<cid>/<llave>`
  */
 export function buildRef ({ owner, cid, key = null }) {
-  if (!owner) throw new Error('buildRef: falta owner')
-  if (!isValidCid(cid)) throw new Error(`buildRef: cid inválido: ${cid}`)
+  if (!owner) throw new Error('buildRef: owner is required')
+  if (!isValidCid(cid)) throw new Error(`buildRef: invalid cid: ${cid}`)
   return key ? `${owner}/${cid}/${key}` : `${owner}/${cid}`
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dotrino-content",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "description": "Nodo de contenido del ecosistema Dotrino: guarda los bytes del usuario direccionados por su hash (cid), en su propia maquina y, si el dueno quiere, respaldados en su propio bucket (R2, Backblaze, Hetzner, Storj o S3). Lo publico sale por URL directa; lo privado, cifrado y solo por la red Dotrino.",
   "type": "module",
   "bin": {
@@ -23,9 +23,9 @@
     "typescript": "5.9.3"
   },
   "dependencies": {
-    "@dotrino/identity": "0.57.0",
-    "@dotrino/remote-agent": "0.5.1",
-    "@dotrino/vault": "0.30.0"
+    "@dotrino/identity": "0.74.0",
+    "@dotrino/remote-agent": "0.6.2",
+    "@dotrino/vault": "0.44.0"
   },
   "keywords": [
     "dotrino",

package/src/agent.js

@@ -53,10 +53,10 @@ export const isLinked = (dir = linkDir()) => {
 export async function startContentAgent ({
   node, dir = linkDir(), proxyUrl, version = null, client, quiet = false, onRevoked, announce = true
 } = {}) {
-  if (!node) throw new Error('startContentAgent: falta node')
+  if (!node) throw new Error('startContentAgent: node is required')
   const link = loadLink(dir)
   if (!link?.iss) {
-    throw new Error('este node no está enlazado a un vault. Ejecuta primero: dotrino-content enroll <código>')
+    throw new Error('this node is not linked to a vault. Run first: dotrino-content enroll <code>')
   }
 
   // El node representa a la maestra que lo certificó: su huella es el `ownerId`.

package/src/announce.js

@@ -51,8 +51,8 @@ export const REPUBLISH_MS = 4 * 60 * 1000
  * @returns {{ channels: () => string[], close: () => void }}
  */
 export function startAnnounce ({ client, owner, quiet = false, intervalMs = REPUBLISH_MS }) {
-  if (!client) throw new Error('startAnnounce: falta client')
-  if (!owner) throw new Error('startAnnounce: falta owner')
+  if (!client) throw new Error('startAnnounce: client is required')
+  if (!owner) throw new Error('startAnnounce: owner is required')
 
   let stopped = false
   let current = []
@@ -73,7 +73,7 @@ export function startAnnounce ({ client, owner, quiet = false, intervalMs = REPU
         await client.publish(name, { app: 'content', owner })
         done.push(name)
       } catch (e) {
-        if (!quiet) console.error(`[content] no me pude anunciar en ${name}: ${e.message}`)
+        if (!quiet) console.error(`[content] could not announce on ${name}: ${e.message}`)
       }
     }
     // Se avisa cuando CAMBIA en cuántos proxios está anunciado, no solo la primera vez.
@@ -82,7 +82,7 @@ export function startAnnounce ({ client, owner, quiet = false, intervalMs = REPU
     // estuviera en los dos. Leyendo ese log parecía una federación rota que no lo estaba.
     const changed = done.length !== current.length
     current = done
-    if (changed && !quiet) console.log(`[content] anunciado como node de ${owner.slice(0, 16)} en ${done.length} proxio(s) · token ${client.token}`)
+    if (changed && !quiet) console.log(`[content] announced as node for ${owner.slice(0, 16)} on ${done.length} proxio(s) · token ${client.token}`)
   }
 
   publishAll()
@@ -120,7 +120,7 @@ export function startAnnounce ({ client, owner, quiet = false, intervalMs = REPU
  * @returns {Promise<string[]>} tokens (direcciones en el proxy)
  */
 export async function findNodes ({ client, owner }) {
-  if (!client || !owner) throw new Error('findNodes: faltan client u owner')
+  if (!client || !owner) throw new Error('findNodes: client and owner are required')
   const known = Array.isArray(client.knownNodes) && client.knownNodes.length
     ? client.knownNodes
     : (client.node ? [client.node] : [])

package/src/blobstore-s3.js

@@ -33,7 +33,7 @@ const IMMUTABLE = 'public, max-age=31536000, immutable'
 
 /** Del `cid` a la clave del objeto. Sin prefijos: el bucket ya separa público de privado. */
 const keyOf = (cid) => {
-  if (!isValidCid(cid)) throw new Error(`cid inválido: ${cid}`)
+  if (!isValidCid(cid)) throw new Error(`invalid cid: ${cid}`)
   return cid
 }
 
@@ -46,7 +46,7 @@ export class S3BlobStore {
    * @param {(m:string)=>void} [o.log]
    */
   constructor ({ root, priv, pub = null, log = () => {} }) {
-    if (!priv) throw new Error('S3BlobStore: falta el bucket privado')
+    if (!priv) throw new Error('S3BlobStore: the private bucket is missing')
     this.cache = new BlobStore(root)
     this.priv = priv
     this.pub = pub
@@ -63,7 +63,7 @@ export class S3BlobStore {
   /** El bucket que le toca a un blob según su ACL. */
   bucketFor (isPublic) {
     if (!isPublic) return this.priv
-    if (!this.pub) throw new Error('este node no tiene bucket público (CONTENT_S3_BUCKET_PUBLIC)')
+    if (!this.pub) throw new Error('this node has no public bucket (CONTENT_S3_BUCKET_PUBLIC)')
     return this.pub
   }
 

package/src/blobstore.js

@@ -44,7 +44,7 @@ export class BlobStore {
 
   /** Path en disco de un cid (no comprueba existencia). */
   pathFor (cid) {
-    if (!isValidCid(cid)) throw new Error(`cid inválido: ${cid}`)
+    if (!isValidCid(cid)) throw new Error(`invalid cid: ${cid}`)
     const hex = cid.slice('sha256-'.length)
     return path.join(this.blobsDir, hex.slice(0, 2), hex.slice(2, 4), cid)
   }
@@ -73,7 +73,7 @@ export class BlobStore {
       transform (chunk, _enc, cb) {
         size += chunk.length
         if (opts.maxBytes && size > opts.maxBytes) {
-          cb(Object.assign(new Error('blob demasiado grande'), { code: 'ETOOBIG' }))
+          cb(Object.assign(new Error('blob too large'), { code: 'ETOOBIG' }))
           return
         }
         hash.update(chunk)

package/src/node.js

@@ -22,7 +22,7 @@ export class ContentNode {
    *   store: almacén ya montado (`storage.js`); por defecto, disco
    */
   constructor (opts) {
-    if (!opts?.dir) throw new Error('falta opts.dir')
+    if (!opts?.dir) throw new Error('opts.dir is required')
     this.dir = opts.dir
     this.maxBytes = opts.maxBytes || 0
     this.maxBlobBytes = opts.maxBlobBytes || 0
@@ -61,7 +61,7 @@ export class ContentNode {
       const over = (this.index.cachedBytes() + size) - this.maxBytes
       if (over > 0 && this.gc({ needBytes: over }).freed < over) {
         await this.store.remove(cid)
-        throw Object.assign(new Error('cuota de disco excedida'), { code: 'ENOSPC' })
+        throw Object.assign(new Error('disk quota exceeded'), { code: 'ENOSPC' })
       }
     }
     this.index.upsert({ cid, size, mime, owner: this.owner, enc, acl, ttl, meta })
@@ -120,7 +120,7 @@ export class ContentNode {
     const p = (prev ? prev.catch(() => {}) : Promise.resolve())
       .then(() => this.store.upload(cid, meta))
       .then(() => { this.index.setRemote(cid, true) })
-      .catch((e) => { this.log(`[almacén] no se pudo subir ${cid.slice(0, 14)}…: ${e.message}`) })
+      .catch((e) => { this.log(`[storage] could not upload ${cid.slice(0, 14)}…: ${e.message}`) })
       .finally(() => this._uploading.delete(cid))
     this._uploading.set(cid, p)
     return p

package/src/ops.js

@@ -47,11 +47,24 @@ const fail = (rid, code, error) => ({ rid, ok: false, code, error })
  * llegue: ni campos de más ni textos sin fin.
  * @returns {{name?:string,title?:string,description?:string}|null}
  */
+/** Cuántos enlaces lleva una tarjeta, y cuánto puede medir cada uno. */
+const MAX_LINKS = 4
+const MAX_LINK_LEN = 300
+
 function cleanMeta (src) {
   if (!src || typeof src !== 'object') return null
   const out = Object.fromEntries(['name', 'title', 'description']
     .map((k) => [k, typeof src[k] === 'string' ? src[k].trim().slice(0, 300) : null])
     .filter(([, v]) => v))
+  // Los ENLACES del contenido (en un eco, la fuente de la que habla). Solo http(s)
+  // y contados: `meta` lo escribe quien publica y la tarjeta lo pinta como `href`,
+  // así que aquí se filtra en vez de creerse.
+  const links = (Array.isArray(src.links) ? src.links : [])
+    .filter((u) => typeof u === 'string')
+    .map((u) => u.trim())
+    .filter((u) => /^https?:\/\//i.test(u) && u.length <= MAX_LINK_LEN)
+    .slice(0, MAX_LINKS)
+  if (links.length) out.links = links
   return Object.keys(out).length ? out : null
 }
 

package/src/s3.js

@@ -142,7 +142,7 @@ export class S3Bucket {
    */
   constructor ({ endpoint, bucket, accessKeyId, secretAccessKey, region = 'auto', fetch: f = fetch }) {
     if (!endpoint || !bucket || !accessKeyId || !secretAccessKey) {
-      throw new Error('S3Bucket: faltan endpoint, bucket o credenciales')
+      throw new Error('S3Bucket: missing endpoint, bucket or credentials')
     }
     this.base = `${String(endpoint).replace(/\/+$/, '')}/${bucket}`
     this.bucket = bucket
@@ -198,7 +198,7 @@ export class S3Bucket {
    * @param {{ sha256?: string, size?: number, contentType?: string, cacheControl?: string }} [o]
    */
   async put (key, body, { sha256 = '', size = 0, contentType = '', cacheControl = '' } = {}) {
-    if (!sha256) throw new Error('S3Bucket.put: hace falta el sha256 del contenido')
+    if (!sha256) throw new Error('S3Bucket.put: the sha256 of the content is required')
     /** @type {Record<string,string>} */
     const headers = {}
     if (contentType) headers['content-type'] = contentType

package/src/server.js

@@ -49,8 +49,8 @@ export function createServer (node) {
       await route(node, req, res)
     } catch (err) {
       if (res.headersSent) { res.destroy(); return }
-      if (err.code === 'ETOOBIG') return json(res, 413, { error: 'blob demasiado grande' })
-      if (err.code === 'ENOSPC') return json(res, 507, { error: 'cuota de disco excedida' })
+      if (err.code === 'ETOOBIG') return json(res, 413, { error: 'blob too large' })
+      if (err.code === 'ENOSPC') return json(res, 507, { error: 'disk quota exceeded' })
       json(res, 500, { error: err.message })
     }
   })
@@ -71,16 +71,16 @@ async function route (node, req, res) {
   }
 
   if (top === 'c' && cid) {
-    if (!isValidCid(cid)) return json(res, 400, { error: 'cid inválido' })
+    if (!isValidCid(cid)) return json(res, 400, { error: 'invalid cid' })
     const meta = node.stat(cid)
-    if (!meta) return json(res, 404, { error: 'no existe' })
+    if (!meta) return json(res, 404, { error: 'not found' })
 
     if (req.method === 'DELETE') {
       await node.remove(cid)
       return json(res, 200, { ok: true })
     }
     if (req.method !== 'GET' && req.method !== 'HEAD') {
-      return json(res, 405, { error: 'método no permitido' })
+      return json(res, 405, { error: 'method not allowed' })
     }
 
     const headers = {
@@ -115,9 +115,9 @@ async function route (node, req, res) {
   if (req.method === 'GET' && top === 'stats') return json(res, 200, node.stats())
 
   if (req.method === 'POST' && (top === 'pin' || top === 'unpin') && cid) {
-    if (!isValidCid(cid)) return json(res, 400, { error: 'cid inválido' })
+    if (!isValidCid(cid)) return json(res, 400, { error: 'invalid cid' })
     const ok = node.pin(cid, top === 'pin')
-    return ok ? json(res, 200, { ok: true }) : json(res, 404, { error: 'no existe' })
+    return ok ? json(res, 200, { ok: true }) : json(res, 404, { error: 'not found' })
   }
 
   // PUBLICAR / despublicar. Existía solo por el plano de control, y eso dejaba sin poder
@@ -127,16 +127,16 @@ async function route (node, req, res) {
   // Con bucket detrás, marcar público MUEVE los bytes al bucket público, que es otro
   // (§15.1): por eso pasa por `node.setAcl` y no por el índice a secas.
   if (req.method === 'POST' && (top === 'public' || top === 'private') && cid) {
-    if (!isValidCid(cid)) return json(res, 400, { error: 'cid inválido' })
+    if (!isValidCid(cid)) return json(res, 400, { error: 'invalid cid' })
     const meta = node.stat(cid)
-    if (!meta) return json(res, 404, { error: 'no existe' })
+    if (!meta) return json(res, 404, { error: 'not found' })
     // Un blob CIFRADO no puede ser público, y se rechaza aquí además de en el índice:
     // es la misma frontera del §7.2, y una frontera que solo se comprueba en un sitio
     // acaba teniendo un camino que no pasa por ese sitio.
-    if (top === 'public' && meta.enc) return json(res, 400, { error: 'un blob cifrado no puede ser público' })
+    if (top === 'public' && meta.enc) return json(res, 400, { error: 'an encrypted blob cannot be public' })
     const ok = node.setAcl(cid, top === 'public' ? 'public' : null)
-    return ok ? json(res, 200, { ok: true, acl: top === 'public' ? 'public' : null }) : json(res, 404, { error: 'no existe' })
+    return ok ? json(res, 200, { ok: true, acl: top === 'public' ? 'public' : null }) : json(res, 404, { error: 'not found' })
   }
 
-  json(res, 404, { error: 'ruta desconocida' })
+  json(res, 404, { error: 'unknown route' })
 }

package/src/storage.js

@@ -83,7 +83,7 @@ export async function checkBuckets (cfg, { priv, pub }, f = fetch) {
 
   // 1. El mismo bucket para las dos cosas: lo privado acabaría en el que tiene dominio.
   if (cfg.pub && cfg.pub === cfg.priv) {
-    fatal.push('el bucket privado y el público son el mismo: lo cifrado acabaría en el que tiene dominio')
+    fatal.push('the private and public buckets are the same: encrypted blobs would land in the one with a domain')
   }
 
   // 2. El privado NO puede responder sin credenciales. Se pide un objeto que no existe:
@@ -98,7 +98,7 @@ export async function checkBuckets (cfg, { priv, pub }, f = fetch) {
   try {
     const r = await f(priv.urlFor('sha256-' + '0'.repeat(64)), { method: 'GET' })
     if (r.status === 404 || r.ok) {
-      fatal.push(`el bucket privado «${cfg.priv}» responde sin credenciales (HTTP ${r.status}): está abierto al mundo`)
+      fatal.push(`the private bucket "${cfg.priv}" answers without credentials (HTTP ${r.status}): it is open to the world`)
     }
   } catch (e) {
     warn.push(`no se pudo comprobar si el bucket privado está cerrado: ${e.message}`)
@@ -143,12 +143,12 @@ export async function openStore ({ dir, env = process.env, log = () => {}, check
   if (cfg.kind === 'local') return { store: await new BlobStore(dir).init(), cfg }
 
   if (!cfg.provider) {
-    log(`[almacén] CONTENT_STORAGE=«${cfg.kind}» no es un proveedor conocido (${Object.keys(PROVIDERS).join(', ')}); sigo en local`)
+    log(`[storage] CONTENT_STORAGE="${cfg.kind}" is not a known provider (${Object.keys(PROVIDERS).join(', ')}); staying on LOCAL`)
     return { store: await new BlobStore(dir).init(), cfg }
   }
   if (cfg.missing.length) {
-    log(`[almacén] ${cfg.kind} pedido pero faltan variables: ${cfg.missing.join(', ')}`)
-    log('[almacén] sigo en LOCAL: un almacén a medio configurar es peor que ninguno')
+    log(`[storage] ${cfg.kind} requested but these variables are missing: ${cfg.missing.join(', ')}`)
+    log('[storage] staying on LOCAL: a half-configured store is worse than none')
     return { store: await new BlobStore(dir).init(), cfg }
   }
 
@@ -160,15 +160,15 @@ export async function openStore ({ dir, env = process.env, log = () => {}, check
 
   if (check) {
     const { ok, fatal, warn } = await checkBuckets(cfg, { priv, pub }, f)
-    for (const w of warn) log(`[almacén] ⚠ ${w}`)
+    for (const w of warn) log(`[storage] ⚠ ${w}`)
     if (!ok) {
-      for (const e of fatal) log(`[almacén] ✖ ${e}`)
-      log('[almacén] sigo en LOCAL hasta que eso se arregle')
+      for (const e of fatal) log(`[storage] ✖ ${e}`)
+      log('[storage] staying on LOCAL until that is fixed')
       return { store: await new BlobStore(dir).init(), cfg }
     }
   }
 
-  log(`[almacén] ${cfg.kind}: privado «${cfg.priv}»${cfg.pub ? `, público «${cfg.pub}» en ${cfg.baseUrl}` : ' (sin bucket público: lo público viaja por la red)'}`)
+  log(`[storage] ${cfg.kind}: private "${cfg.priv}"${cfg.pub ? `, public "${cfg.pub}" at ${cfg.baseUrl}` : ' (no public bucket: public reads go over the network)'}`)
   return { store: await new S3BlobStore({ root: dir, priv, pub, log }).init(), cfg }
 }
 

package/src/vaultEnv.js

@@ -95,7 +95,7 @@ export function startVaultConfig ({ dir = serviceDir(), onSecrets, log = console
   let expired = false
   const deadline = setTimeout(() => {
     expired = true
-    log(`[vault] la bóveda no contestó en ${Math.round(firstWaitMs / 1000)}s: arranco con lo local y me reinicio cuando llegue`)
+    log(`[vault] no answer in ${Math.round(firstWaitMs / 1000)}s: starting with the local config and restarting when it arrives`)
     arrive(null)
   }, firstWaitMs)
   deadline.unref?.()
@@ -106,13 +106,13 @@ export function startVaultConfig ({ dir = serviceDir(), onSecrets, log = console
     const secrets = await waitForSecrets({
       dir,
       ns: NS,
-      onRetry: (e, delay) => log(`[vault] sin configuración todavía (${e.message}); reintento en ${Math.round(delay / 1000)}s`)
+      onRetry: (e, delay) => log(`[vault] no config yet (${e.message}); retrying in ${Math.round(delay / 1000)}s`)
     })
     if (stopped) return
 
     const { injected, overridden } = applyEnv(secrets)
-    log(`[vault] ${injected.length} valor(es) del vault aplicados al entorno`)
-    if (overridden.length) log(`[vault] pisaron el entorno de esta máquina: ${overridden.join(', ')}`)
+    log(`[vault] applied ${injected.length} value(s) from the vault to the environment`)
+    if (overridden.length) log(`[vault] these overrode the machine environment: ${overridden.join(', ')}`)
     clearTimeout(deadline)
     arrive(secrets)
     onSecrets?.(secrets)
@@ -124,7 +124,7 @@ export function startVaultConfig ({ dir = serviceDir(), onSecrets, log = console
     // configuración correcta puesta en el entorno y sin usarla. Se sale, y el
     // supervisor lo levanta ya con todo.
     if (expired) {
-      log('[vault] llegó la configuración después de arrancar: me reinicio para tomarla')
+      log('[vault] config arrived after startup: restarting to pick it up')
       setTimeout(() => process.exit(0), 300)
       return
     }
@@ -139,13 +139,13 @@ export function startVaultConfig ({ dir = serviceDir(), onSecrets, log = console
       ...(onChange
         ? {
             onUpdate: ({ reason }) => {
-              log(`[vault] ${reason === 'revoked' ? 'este aparato fue revocado' : 'llegó configuración nueva'}`)
+              log(`[vault] ${reason === 'revoked' ? 'this device was revoked' : 'new config arrived'}`)
               onChange()
             }
           }
         : {})
     })
-  })().catch((e) => { log(`[vault] no se pudo leer la configuración: ${e.message}`); clearTimeout(deadline); arrive(null) })
+  })().catch((e) => { log(`[vault] could not read the config: ${e.message}`); clearTimeout(deadline); arrive(null) })
 
   return {
     enabled: true,