DateKeys-App/CHANGELOG.md

Changelog

Cambios notables de la librería TypeScript y de la página. El proyecto usa versionado semántico; mientras sea 0.x, no hay promesa de estabilidad. La sección «Versiones» del README explica qué cubre cada número.

0.2.0 — sin publicar

Fase 3: la escritura de cápsulas de formato 2, según PLAN_fase3_escritura.md (v3, en ../docs). Hecha, pasos 0 a 7; la versión sigue sin publicar hasta que el autor la cierre.

Después del paso 7: ayuda de age y el texto en claro a la vista

• /inspect muestra el principio del texto en claro de cualquier cápsula que se abre, no solo de los fixtures, si es texto: UTF-8 imprimible, hasta 100 000 caracteres de sus primeros 128 KiB. Se ve también un texto escrito en Windows, con CR LF o BOM; la descarga conserva los bytes exactos. opener.ts da esos primeros bytes (PREVIEW_BYTES), y opening.ts decide qué se muestra (plaintextPreview).
• Ayuda de las claves de age. En /create, un bloque plegable explica qué es un destinatario age1… y cómo se consigue con age-keygen. En /inspect, el campo de identidades dice qué pegar: la línea AGE-SECRET-KEY-1… del fichero de age-keygen, o el fichero entero.

Pasos 6 y 7: la página /create

• El autor confirma las decisiones de la página con cada recomendación: time_only por defecto, la zona del dispositivo con un selector, los avisos de §53 y §50 desde 365 días, un aviso de protocolo preliminar y los nombres capsula-<apertura en UTC>.
• /create cifra un fichero propio en un .dkc de formato 2 y, si se pide, en una .dkk portable, en el navegador y sin red. Antes de cifrar muestra el instante efectivo, la ronda, la dk1_, el tamaño exacto del .dkc y lo que deja ver hasta la fecha. El .dkc va a un fichero temporal de OPFS, o a memoria hasta 64 MiB, y la escritura se puede cancelar. La .dkk vive solo en memoria, y la página avisa si se sale sin descargarla. El resultado lleva el informe de los pasos 1 a 8 de lo escrito.
• lengths.ts: sealedControlLength sale de writer.ts, y capsuleLength da el tamaño del .dkc antes de escribirlo; el bucle de propiedades lo comprueba en cada cápsula. datekey.ts: LONG_HORIZON_SECONDS e isLongHorizon.
• localtime.ts, create-input.ts y creator.ts, al 100 %. /inspect limpia también la zona de crear. check-build.mjs comprueba la carga bajo demanda de las dos páginas que la tienen.
• Comprobado en el navegador: una cápsula creada para dentro de cuatro minutos se abrió después en /inspect con el release pegado y con datekeys decrypt de Go, con el mismo contenido.
• Una revisión adversarial encontró un fallo mayor y ocho menores, todos corregidos. El mayor: la .dkk que es la única credencial se podía borrar sin confirmación. Ahora la página la pide al olvidarla y al crear otra cápsula. Entre los menores: la zona desconocida del dispositivo pasa a UTC; el reloj de la página se lee cada segundo; hay un mensaje propio para un reloj anterior a Quicknet; lo escrito no se ofrece si los pasos 1 a 8 lo rechazan; y el foco va a «Cancelar» durante la escritura. localtime.test.ts compara la conversión con una búsqueda exhaustiva alrededor de todos los cambios de hora de 2030.

Paso 5: interoperabilidad con Go a nivel de cápsula

• interop.test.ts y testing/capsule-vectors.json: Go abre con capsule.Open las trece cápsulas de muestra que escribe encrypt, con cada credencial, y reencodifica sus objetos a los mismos bytes. Cubren las dos políticas y las dos reglas, de 0 a 16 credenciales, los bordes de trozo y las extensiones.
• Go rechaza cuatro mezclas de dos cápsulas con el mismo código y paso que open, codifica igual 500 entradas aleatorias de los codificadores, y da los mismos textos que esta librería con 22 recipients y 21 opciones inválidas.
• Lo generan scripts/capsule-ts-samples.mjs y scripts/capsule-go-verdicts.go, y se congela; el test comprueba en cada ejecución los veredictos de Go y que open da lo mismo sobre los bytes congelados.

Pasos 3 y 4: el writer

• encrypt.ts y writer.ts: encrypt(src, opts) escribe un .dkc de formato 2 y, si se pide, una .dkk portable, como capsule.Encrypt: L conocida de antemano, relleno reforzado por defecto, de 1 a 16 credenciales con señuelos en un orden uniforme, SEALED_CONTROL_LEN con la fórmula del §62.1 y las autocomprobaciones de la regla 11 y dos más. Streaming desde Uint8Array, Blob o ReadableStream, hacia memoria o hacia un WritableStream que solo se cierra con la cápsula completa y comprobada.
• Reproduce byte a byte las secciones deterministas de los siete fixtures de formato 2 de Go, y todo lo que escribe se abre con open.
• Tests de streaming, de errores internos con age-encryption sustituido y un bucle de propiedades (50 semillas en cada ejecución; 500 pasaron a mano).

Paso 2: piezas de apoyo

• recipient.ts: recipients age1… como age 1.3.2, las reglas de §37 con los textos de agewrap.CheckX25519Recipient y la lista de recipients de una persona, con errores por número de línea. Sin noble.
• random.ts: el índice sin sesgo y la permutación de Fisher–Yates del orden de los 16 huecos, con la prueba de uniformidad de Go.
• agefile.ts: los ficheros age enteros que antes eran privados de la apertura, para compartirlos con el writer.
• x25519.ts: newX25519Identity y x25519PublicKey, con los vectores de RFC 7748. digest.ts: sha256Hasher. datekey.ts: compareInstants, que usa open.ts, e isInstant.
• tempfile.ts: la zona de la apertura y la de crear (OPEN_AREA, CREATE_AREA), con su limpieza por separado.
• Guardas: solo agefile.ts, open.ts, tlock.ts, writer.ts y los tests importan age-encryption; solo encrypt.ts y testing/ importan writer.ts; index.ts no reexporta la apertura ni el writer.

0.1.0 — 29 de septiembre de 2026

Implementa la especificación DateKeys 0.9 (tag spec-v0.9 de datekeys-go) para el perfil Quicknet, y pasa todos los vectores y fixtures compartidos de datekeys-go en 7e2d83c. Hasta el 29-09-2026 implementaba la 0.8.2 (9ac9cd9).

Especificación 0.9: el formato 2

• El prelude lee el formato de la cápsula, 1 o 2 (Prelude.format); otro VERSION es ERR_UNSUPPORTED_VERSION en el paso 2. DKC_FRAMING_VERSION desaparece: FORMAT_1, FORMAT_2 e isFormat.
• CONTROL_CBOR se lee y se escribe para un formato, decodeControl(b, format) y encodeControl(c, format): su versión de schema es la del formato, y en el formato 2 lleva payload_length (8 bytes, hasta L_MAX) y padding (claves 6 y 7).
• padding.ts: las reglas bloque256 y reforzado de §29.1, exactas hasta L_MAX = 2⁵³ − 2⁴⁶, y la longitud de PAYLOAD_AGE.
• open: exactamente 16 stanzas en INNER_ACCESS_AGE del formato 2 (paso 12, ACCESS_SLOTS), P en el paso 16, y en el 17 un texto en claro de P bytes con ceros tras el contenido, del que solo se entregan los L primeros bytes, nunca el relleno. El paso 17 se registra también cuando se supera, y el 18 da los bytes de contenido, como la referencia. Opened da format, payloadLength y, en el formato 2, padding y paddedLength.
• La vista JSON de inspect lleva format, como datekeys inspect -json.
• La página muestra el formato de la cápsula, avisa cuando es el 1, que no oculta el número de credenciales ni la longitud exacta del contenido, y al abrir una del formato 2 da la regla de relleno y P.
• testdata sincronizado con spec-v0.9: doce fixtures, siete de ellos del formato 2, padding.json, 125 casos de mutación y 4 380 del diferencial. ibe-vectors.json añade los siete fixtures nuevos.

Hecho

• Codec CBOR del perfil de §58 con los textos de error de la referencia Go.
• Schemas del Provider Profile, PUBLIC_HEADER, CONTROL_CBOR y .dkk.
• Tramas DKC1 y DKK1, cabeceras age y DateKey (dk1_).
• Extensiones, con los objetos y arrays de su registro.
• La inspección de los pasos 1 a 8 de §63.
• La página estática /inspect, sin red. Tras cada compilación se comprueban su política de seguridad y los paquetes de su bundle.
• Fase 2:
  • dependencias de ejecución (age-encryption 0.3.1, @noble/curves y @noble/hashes 2.4.0) con sus guardas;
  • el IBE de tlock (ibe.ts) y la verificación local de releases (release.ts), contrastados con la referencia Go;
  • la apertura, pasos 9 a 18 de §63 (open.ts), con el texto en claro en memoria. Las identidades estrictas de agewrap se apoyan en x25519.ts, que abre cada stanza X25519 por separado, y en bech32.ts. Los 65 casos del corpus de mutaciones pasan por open con el código y el paso de Go, y los cinco fixtures oficiales se abren a su texto en claro;
  • @noble/ciphers 2.4.0 como dependencia directa, aprobada el 28-09-2026: la copia que ya trae age-encryption;
  • la apertura en streaming. La entrada puede ser un Blob, del que se lee solo el prefijo de los pasos 1 a 8 (prefix.ts, antes en la página) y se descifra PAYLOAD_AGE en streaming. La salida puede ser un WritableStream, que se cierra solo tras el paso 18 y se aborta ante cualquier fallo. En el navegador, con un fichero OPFS, un fallo de STREAM deja intacto su contenido anterior.
  • el cifrado del stanza tlock (encryptOnG2RFC9380) y el Recipient de OUTER_TIME_AGE (tlock.ts). Con sigma fijo, el cifrado reproduce byte a byte los vectores de Go. Además Go abre lo que cifra esta librería: el cuerpo IBE con tlock.TimeUnlock y el fichero age con agewrap.NewTimeIdentity;
  • la acción "abrir" de /inspect (paso 8), cuyo código, con noble y age-encryption, se carga bajo demanda:
    • el release lo pega quien abre (la respuesta de drand o la firma sola), o sale del registro de un fixture. La página nunca lo pide a la red y solo lee su ronda y su firma;
    • las credenciales de time_and_key son una .dkk o identidades AGE-SECRET-KEY-1…;
    • el texto en claro de un fichero propio va a un fichero temporal de OPFS que solo se confirma tras el paso 18. Se ofrece para descargar y se borra al pedirlo, con otra cápsula, al salir o en la visita siguiente;
    • readAccessKey en prefix.ts.
• VERSION y SPEC_VERSION, también en el pie de la página.
• licenses.txt en el sitio, con los avisos de tlock-js y age y los de cada paquete del bundle.