@interop/did-cli 0.13.0 → 0.14.0

package/dist/commands/did/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/commands/did/service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,2BAA2B,CAAA;AAoBlC;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,GAAG,EACH,EAAE,EACH,EAAE;IACD,GAAG,EAAE,MAAM,CAAA;IACX,EAAE,EAAE,MAAM,CAAA;CACX,GAAG,MAAM,CAQT;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,GAAG,EACH,EAAE,EACF,IAAI,EACJ,QAAQ,EACR,YAAY,EACb,EAAE;IACD,GAAG,EAAE,MAAM,CAAA;IACX,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,GAAG,eAAe,CAsBlB;AA4BD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,EAC9B,OAAO,EACP,KAAK,EACL,GAAG,EACJ,EAAE;IACD,OAAO,EAAE,eAAe,EAAE,CAAA;IAC1B,KAAK,EAAE,eAAe,CAAA;IACtB,GAAG,EAAE,MAAM,CAAA;CACZ,GAAG,eAAe,EAAE,CAKpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACP,EAAE,EACF,GAAG,EACJ,EAAE;IACD,OAAO,EAAE,eAAe,EAAE,CAAA;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;CACZ,GAAG,eAAe,EAAE,CAMpB;AAiMD;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CAAC,EAC1C,GAAG,EACH,SAAS,EACT,GAAG,EACH,UAAU,EACX,EAAE;IACD,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,GAAG,EAAE,MAAM,KAAK,eAAe,EAAE,CAAA;IACzE,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBlB"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/commands/did/service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,2BAA2B,CAAA;AAqBlC;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,GAAG,EACH,EAAE,EACH,EAAE;IACD,GAAG,EAAE,MAAM,CAAA;IACX,EAAE,EAAE,MAAM,CAAA;CACX,GAAG,MAAM,CAQT;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,YAAY,EACb,EAAE;IACD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,GAAG,eAAe,CAAC,iBAAiB,CAAC,CAerC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,GAAG,EACH,EAAE,EACF,IAAI,EACJ,QAAQ,EACR,YAAY,EACb,EAAE;IACD,GAAG,EAAE,MAAM,CAAA;IACX,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,GAAG,eAAe,CAMlB;AA4BD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,EAC9B,OAAO,EACP,KAAK,EACL,GAAG,EACJ,EAAE;IACD,OAAO,EAAE,eAAe,EAAE,CAAA;IAC1B,KAAK,EAAE,eAAe,CAAA;IACtB,GAAG,EAAE,MAAM,CAAA;CACZ,GAAG,eAAe,EAAE,CAKpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACP,EAAE,EACF,GAAG,EACJ,EAAE;IACD,OAAO,EAAE,eAAe,EAAE,CAAA;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;CACZ,GAAG,eAAe,EAAE,CAMpB;AAgMD;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CAAC,EAC1C,GAAG,EACH,SAAS,EACT,GAAG,EACH,UAAU,EACX,EAAE;IACD,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,GAAG,EAAE,MAAM,KAAK,eAAe,EAAE,CAAA;IACzE,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBlB"}

package/dist/commands/did/service.js

@@ -1,16 +1,7 @@
-/**
- * Service-entry management for did:web and did:webvh DIDs. Builds and edits the
- * `service` array (add/remove by id, with id normalization) and routes a
- * service-array transform to the right per-method runner: did:web is a direct
- * document edit, did:webvh appends a sparse log entry (advancing the
- * pre-rotation ratchet when one is armed). The webvh log machinery is reused
- * from `./webvh-update.js`.
- */
-import { updateDID } from '@interop/did-method-webvh';
-import { loadDidDocument, saveDidLog, saveToDids } from '../../storage.js';
+import { loadDidDocument, saveToDids } from '../../storage.js';
 import { resolveDidRef } from '../../meta.js';
 import { generateStagedKey } from '../../keys/webvh-update.js';
-import { confirmAction, loadActiveSigner, loadStoredUpdateKeys, makeWebvhEntrySigner, persistUpdateKeysSidecar, resolveWebvhForUpdate, revealStagedSigner } from './webvh-update.js';
+import { appendWebvhEntry, confirmAction, loadActiveSigner, loadStoredUpdateKeys, makeWebvhEntrySigner, persistWebvhUpdate, resolveWebvhForUpdate, revealStagedSigner } from './webvh-update.js';
 /**
  * Expand a service id to a full DID URL. A bare fragment (`files`) or a
  * leading-`#` fragment (`#files`) is resolved against the DID; a value that is
@@ -32,42 +23,52 @@ export function normalizeServiceId({ did, id }) {
     return `${did}#${id}`;
 }
 /**
- * Build a service-endpoint entry from add-service options. Exactly one of
- * `endpoint` (one or more endpoint values -- a single value stays a string,
- * several become an array) or `endpointJson` (a raw JSON value) supplies the
- * serviceEndpoint; a single `type` likewise stays a string.
+ * Build (and validate) the serviceEndpoint value from add-service options.
+ * Exactly one of `endpoint` (one or more endpoint values -- a single value
+ * stays a string, several become an array) or `endpointJson` (a raw JSON
+ * value) must supply it. Needs no DID, so the CLI layer calls it up front to
+ * reject bad arguments before any (expensive) log resolution.
  *
  * @param options {object}
- * @param options.did {string}
- * @param options.id {string}
- * @param options.type {string[]}
  * @param [options.endpoint] {string[]}
  * @param [options.endpointJson] {string}
- * @returns {ServiceEndpoint}
+ * @returns {ServiceEndpoint['serviceEndpoint']}
  */
-export function buildServiceEntry({ did, id, type, endpoint, endpointJson }) {
+export function buildServiceEndpoint({ endpoint, endpointJson }) {
     const hasEndpoint = Boolean(endpoint?.length);
     const hasEndpointJson = Boolean(endpointJson);
     // True when both are supplied or neither is -- i.e. not exactly one.
     if (hasEndpoint === hasEndpointJson) {
         throw new Error('Provide exactly one of --endpoint or --endpoint-json.');
     }
-    let serviceEndpoint;
     if (endpointJson) {
         try {
-            serviceEndpoint = JSON.parse(endpointJson);
+            return JSON.parse(endpointJson);
         }
         catch {
             throw new Error('--endpoint-json must be valid JSON.');
         }
     }
-    else {
-        serviceEndpoint = endpoint.length === 1 ? endpoint[0] : endpoint;
-    }
+    return endpoint.length === 1 ? endpoint[0] : endpoint;
+}
+/**
+ * Build a service-endpoint entry from add-service options (see
+ * `buildServiceEndpoint` for the serviceEndpoint rules); a single `type`
+ * stays a string.
+ *
+ * @param options {object}
+ * @param options.did {string}
+ * @param options.id {string}
+ * @param options.type {string[]}
+ * @param [options.endpoint] {string[]}
+ * @param [options.endpointJson] {string}
+ * @returns {ServiceEndpoint}
+ */
+export function buildServiceEntry({ did, id, type, endpoint, endpointJson }) {
     return {
         id: normalizeServiceId({ did, id }),
         type: type.length === 1 ? type[0] : type,
-        serviceEndpoint
+        serviceEndpoint: buildServiceEndpoint({ endpoint, endpointJson })
     };
 }
 /**
@@ -200,7 +201,14 @@ async function runWebvhServiceUpdate({ targetDid, transform, yes, keepOldKey })
         console.error(err.message);
         return 1;
     }
-    const stored = await loadStoredUpdateKeys(targetDid);
+    let stored;
+    try {
+        stored = await loadStoredUpdateKeys(targetDid);
+    }
+    catch (err) {
+        console.error(err.message);
+        return 1;
+    }
     // Choose the signer and key parameters. A sparse update normally omits
     // updateKeys/nextKeyHashes so the keys carry forward untouched; a
     // pre-rotation DID instead must reveal its staged key (which signs) and stage
@@ -245,13 +253,14 @@ async function runWebvhServiceUpdate({ targetDid, transform, yes, keepOldKey })
     });
     if (!confirmed) {
         console.error('Aborted.');
-        return 0;
+        return 1;
     }
     const signer = makeWebvhEntrySigner(signerKeyPair);
     let result;
     try {
-        result = await updateDID({
+        result = await appendWebvhEntry({
             log,
+            meta,
             signer,
             services,
             ...(updateKeys ? { updateKeys } : {}),
@@ -262,23 +271,15 @@ async function runWebvhServiceUpdate({ targetDid, transform, yes, keepOldKey })
         console.error(`Service update failed: ${err.message}`);
         return 1;
     }
-    const logPath = await saveDidLog({ did: result.did, log: result.log });
-    const docPath = await saveToDids({
-        method: 'webvh',
-        did: result.did,
-        data: result.doc
+    // The advanced ratchet is persisted only on the pre-rotation path; an
+    // ordinary service update leaves the update-keys sidecar untouched.
+    const { logPath, docPath, updateKeysPath } = await persistWebvhUpdate({
+        result,
+        sidecar: meta.prerotation && newActive
+            ? { newActive, newStaged, retiredActive, stored, keepOldKey }
+            : undefined
     });
-    // Persist the advanced ratchet only on the pre-rotation path; an ordinary
-    // service update leaves the update-keys sidecar untouched.
-    if (meta.prerotation && newActive) {
-        const updateKeysPath = await persistUpdateKeysSidecar({
-            did: result.did,
-            newActive,
-            newStaged,
-            retiredActive,
-            stored,
-            keepOldKey
-        });
+    if (updateKeysPath !== undefined) {
         console.error(`Update keys saved to ${updateKeysPath}`);
         console.error('Pre-rotation: the update key was advanced as part of this change.');
     }

package/dist/commands/did/service.js.map

@@ -1 +1 @@
-{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../src/commands/did/service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../src/commands/did/service.ts"],"names":[],"mappings":"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"}

package/dist/commands/did/webvh-update.d.ts

@@ -1,4 +1,4 @@
-import { resolveDIDFromLog, type DIDLog } from '@interop/did-method-webvh';
+import { resolveDIDFromLog, updateDID, type DIDLog } from '@interop/did-method-webvh';
 import { Ed25519VerificationKey } from '@interop/ed25519-verification-key';
 import { type WebvhUpdateKey, type WebvhUpdateKeys } from '../../storage.js';
 /**
@@ -11,8 +11,10 @@ import { type WebvhUpdateKey, type WebvhUpdateKeys } from '../../storage.js';
 export declare function parseDidLog(logText: string): DIDLog;
 /**
  * Ask the user to confirm a hard-to-undo action. Returns true immediately when
- * `--yes` was passed or when stdin is not an interactive TTY (so scripts and
- * tests are not blocked); otherwise prompts and requires an explicit `y`.
+ * `--yes` was passed. When stdin is not an interactive TTY the question cannot
+ * be asked, so the action is refused (with a hint to pass `--yes`) rather than
+ * silently confirmed -- a script or cron job must opt in explicitly. Otherwise
+ * prompts and requires an explicit `y`.
  *
  * @param options {object}
  * @param options.message {string}
@@ -70,7 +72,12 @@ export declare function loadStoredUpdateKeys(did: string): Promise<WebvhUpdateKe
 /**
  * Pre-rotation reveal: validate and load the staged (pre-committed) update key
  * that must sign this entry, returning the signer key pair plus the records
- * that make it the new active key and retire the current one.
+ * that make it the new active key and retire the current one. As a recovery
+ * path, when the staged record does not match the log's commitment but the
+ * sidecar's `active` record does (an earlier rotation wrote the sidecar and
+ * was then interrupted before the log write), the active record is revealed
+ * instead; `retiredActive` is undefined in that case, since the active record
+ * is not superseded.
  *
  * @param options {object}
  * @param options.stored {WebvhUpdateKeys | undefined} the update-keys sidecar.
@@ -89,11 +96,15 @@ export declare function revealStagedSigner({ stored, meta, targetDid, action }:
 }): Promise<{
     signerKeyPair: Ed25519VerificationKey;
     newActive: WebvhUpdateKey;
-    retiredActive: WebvhUpdateKey;
+    retiredActive?: WebvhUpdateKey;
 }>;
 /**
  * Ordinary (non-pre-rotation) signer: the current active update key signs.
- * Returns the signer key pair and the active record it was loaded from.
+ * Returns the signer key pair and the active record it was loaded from. When
+ * the `active` record does not match the log's updateKeys, the staged and
+ * retired records are searched as a recovery path: an interrupted rotation
+ * can leave the sidecar one step ahead of (or behind) the log, and the secret
+ * authorized by the log may then live in one of those records.
  *
  * @param options {object}
  * @param options.stored {WebvhUpdateKeys | undefined} the update-keys sidecar.
@@ -101,8 +112,7 @@ export declare function revealStagedSigner({ stored, meta, targetDid, action }:
  * @param options.targetDid {string}
  * @param options.action {string} verb used in error messages.
  * @returns {Promise<{ signerKeyPair, activeRecord }>}
- * @throws {Error} if the active secret is missing or no longer matches the
- *   log's updateKeys.
+ * @throws {Error} if no stored secret matches the log's updateKeys.
  */
 export declare function loadActiveSigner({ stored, meta, targetDid, action }: {
     stored: WebvhUpdateKeys | undefined;
@@ -116,10 +126,63 @@ export declare function loadActiveSigner({ stored, meta, targetDid, action }: {
 /**
  * Build the entry signer for a did:webvh update from an update key pair.
  *
- * @param keyPair {Ed25519VerificationKey} mutated: its `id` is set in place.
+ * @param keyPair {Ed25519VerificationKey}
  * @returns the signer to pass to `updateDID`.
  */
 export declare function makeWebvhEntrySigner(keyPair: Ed25519VerificationKey): import("@interop/did-method-webvh").Signer<import("@interop/did-method-webvh").SignableDocument>;
+/**
+ * Append a signed entry to a did:webvh history log via the library's
+ * `updateDID`, passing the already-resolved `meta` as `priorMeta` to skip its
+ * internal re-resolution (a full re-verification of every log entry). The
+ * library trusts `priorMeta` blindly, so it must describe this exact log's
+ * head; that pairing is asserted here (an O(1) check) before signing, so a
+ * future edit that reloads or truncates the log cannot sign a forked entry.
+ *
+ * @param options {object}
+ * @param options.meta {Awaited<ReturnType<typeof resolveDIDFromLog>>['meta']}
+ *   the metadata resolved from this same log (e.g. by
+ *   `resolveWebvhForUpdate`).
+ * @param options.log {DIDLog}
+ * @param options.signer the entry signer (see `makeWebvhEntrySigner`).
+ * @returns {Promise<Awaited<ReturnType<typeof updateDID>>>}
+ * @throws {Error} if `meta` does not match the log head.
+ */
+export declare function appendWebvhEntry({ meta, ...update }: Omit<Parameters<typeof updateDID>[0], 'priorMeta'> & {
+    meta: Awaited<ReturnType<typeof resolveDIDFromLog>>['meta'];
+}): Promise<Awaited<ReturnType<typeof updateDID>>>;
+/**
+ * Persist the artifacts of a signed did:webvh update in a crash-safe order:
+ * the update-keys sidecar first -- retaining the superseded secret regardless
+ * of `keepOldKey`, so that every key authorized by either the old or the new
+ * log head has its secret on disk -- then the log and document, then the
+ * sidecar again in its final shape when the retained secret should be
+ * dropped. An interruption at any point leaves a state the signer loaders
+ * (`loadActiveSigner`, `revealStagedSigner`) can recover from; the reverse
+ * order could commit a log whose only authorized secret was never persisted.
+ *
+ * @param options {object}
+ * @param options.result {Awaited<ReturnType<typeof updateDID>>}
+ * @param [options.sidecar] {object} update-keys sidecar changes, if any:
+ *   the `persistUpdateKeysSidecar` arguments minus `did`.
+ * @returns {Promise<{ logPath, docPath, updateKeysPath }>} the saved paths;
+ *   `updateKeysPath` is undefined when no sidecar change was requested.
+ */
+export declare function persistWebvhUpdate({ result, sidecar }: {
+    result: Awaited<ReturnType<typeof updateDID>>;
+    sidecar?: {
+        newActive: WebvhUpdateKey;
+        newStaged?: WebvhUpdateKey & {
+            nextKeyHash: string;
+        };
+        retiredActive?: WebvhUpdateKey;
+        stored?: WebvhUpdateKeys;
+        keepOldKey?: boolean;
+    };
+}): Promise<{
+    logPath: string;
+    docPath: string;
+    updateKeysPath?: string;
+}>;
 /**
  * Write the update-keys sidecar: the active key, the staged next key (or
  * none), and any retired secrets. At creation there is no prior sidecar; after

package/dist/commands/did/webvh-update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webvh-update.d.ts","sourceRoot":"","sources":["../../../src/commands/did/webvh-update.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"webvh-update.d.ts","sourceRoot":"","sources":["../../../src/commands/did/webvh-update.ts"],"names":[],"mappings":"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"}