@interop/did-cli 0.9.0 → 0.10.1

package/dist/commands/did/manage.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Resolve a DID to its DID document, or a DID URL to its verification method,
+ * via the security document loader, and print the result.
+ *
+ * @param options {object}
+ * @param options.didOrKeyId {string}   The DID or DID URL to resolve.
+ * @returns {Promise<number>}   The process exit code.
+ */
+export declare function runGet(options: {
+    didOrKeyId: string;
+}): Promise<number>;
+/**
+ * Show a locally stored DID document (no secret key material), or its metadata
+ * with `--meta`, by DID or handle. For did:webvh the document is resolved from
+ * its history log rather than the stored snapshot.
+ *
+ * @param options {object}
+ * @param options.didRef {string}   The DID or metadata handle.
+ * @param [options.meta] {boolean}   Show the metadata instead of the document.
+ * @param [options.json] {boolean}   With --meta, output the metadata as JSON.
+ * @returns {Promise<number>}   The process exit code.
+ */
+export declare function runShow(options: {
+    didRef: string;
+    meta?: boolean;
+    json?: boolean;
+}): Promise<number>;
+/**
+ * List locally stored DIDs with their metadata: one DID per line with
+ * `--plain`, a JSON array with `--json`, otherwise a column-aligned table.
+ *
+ * @param options {object}
+ * @param [options.json] {boolean}   Output a JSON array of objects.
+ * @param [options.plain] {boolean}   Output one DID per line, sorted.
+ * @returns {Promise<number>}   The process exit code.
+ */
+export declare function runList(options: {
+    json?: boolean;
+    plain?: boolean;
+}): Promise<number>;
+/**
+ * Show or edit the metadata of a locally stored DID (by DID or handle). With no
+ * edits, prints the current metadata; otherwise applies the handle/description
+ * changes and saves the sidecar.
+ *
+ * @param options {object}
+ * @param options.didRef {string}   The DID or metadata handle.
+ * @param [options.handle] {string}   Set the handle (empty string clears it).
+ * @param [options.description] {string}   Set the description (empty clears it).
+ * @returns {Promise<number>}   The process exit code.
+ */
+export declare function runMeta(options: {
+    didRef: string;
+    handle?: string;
+    description?: string;
+}): Promise<number>;
+/**
+ * Remove a locally stored DID document, its keys file, and its metadata
+ * sidecar (by DID or handle), scrubbing the cached key-to-DID associations.
+ *
+ * @param options {object}
+ * @param options.didRef {string}   The DID or metadata handle.
+ * @returns {Promise<number>}   The process exit code.
+ */
+export declare function runRemove(options: {
+    didRef: string;
+}): Promise<number>;
+//# sourceMappingURL=manage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manage.d.ts","sourceRoot":"","sources":["../../../src/commands/did/manage.ts"],"names":[],"mappings":"AAuBA;;;;;;;GAOG;AACH,wBAAsB,MAAM,CAAC,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAe7E;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE;IACrC,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,CAiHlB;AAED;;;;;;;;GAQG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE;IACrC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkDlB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE;IACrC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuClB;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkC5E"}

package/dist/commands/did/manage.js

@@ -0,0 +1,287 @@
+import { listDids, loadDidDocument, loadDidMeta, methodOf, removeDidFiles, saveDidMeta } from '../../storage.js';
+import { removeKeyDidAssociation, resolveDidRef } from '../../meta.js';
+import { renderTable } from '../../table.js';
+import { documentLoader } from '../../documentLoader.js';
+import { applyMetaEdits } from '../collection-command.js';
+import { resolveStoredWebvh } from './webvh-update.js';
+/**
+ * Resolve a DID to its DID document, or a DID URL to its verification method,
+ * via the security document loader, and print the result.
+ *
+ * @param options {object}
+ * @param options.didOrKeyId {string}   The DID or DID URL to resolve.
+ * @returns {Promise<number>}   The process exit code.
+ */
+export async function runGet(options) {
+    const { didOrKeyId } = options;
+    let document;
+    try {
+        ;
+        ({ document } = (await documentLoader(didOrKeyId)));
+    }
+    catch (err) {
+        console.error(`Could not resolve "${didOrKeyId}": ${err.message}`);
+        return 1;
+    }
+    console.log(JSON.stringify(document, null, 2));
+    return 0;
+}
+/**
+ * Show a locally stored DID document (no secret key material), or its metadata
+ * with `--meta`, by DID or handle. For did:webvh the document is resolved from
+ * its history log rather than the stored snapshot.
+ *
+ * @param options {object}
+ * @param options.didRef {string}   The DID or metadata handle.
+ * @param [options.meta] {boolean}   Show the metadata instead of the document.
+ * @param [options.json] {boolean}   With --meta, output the metadata as JSON.
+ * @returns {Promise<number>}   The process exit code.
+ */
+export async function runShow(options) {
+    const { didRef } = options;
+    let did;
+    try {
+        did = await resolveDidRef({ ref: didRef });
+    }
+    catch (err) {
+        console.error(err.message);
+        return 1;
+    }
+    const targetDid = did ?? didRef;
+    // For did:webvh the history log is the source of truth, so resolve the
+    // current document (and its accumulated parameters) from it rather than
+    // trusting the stored snapshot. A DID with no stored log falls through
+    // to the stored document below.
+    let webvhMeta;
+    let resolvedDoc;
+    if (targetDid.startsWith('did:webvh:')) {
+        let resolved;
+        try {
+            resolved = await resolveStoredWebvh(targetDid);
+        }
+        catch (err) {
+            console.error(`Could not resolve the DID log for ${targetDid}: ` +
+                err.message);
+            return 1;
+        }
+        if (resolved) {
+            resolvedDoc = resolved.doc;
+            webvhMeta = resolved.meta;
+        }
+    }
+    let didDocument;
+    if (resolvedDoc) {
+        didDocument = resolvedDoc;
+    }
+    else {
+        try {
+            didDocument = await loadDidDocument(targetDid);
+        }
+        catch {
+            console.error(`No locally stored DID found for ${didRef}`);
+            return 1;
+        }
+    }
+    if (options.meta) {
+        const docDid = didDocument.id;
+        const meta = await loadDidMeta({ did: docDid });
+        const keyCount = Array.isArray(didDocument.verificationMethod)
+            ? didDocument.verificationMethod.length
+            : 0;
+        // Parameters resolved from the did:webvh log (absent for other
+        // methods, and for a webvh DID with no stored log).
+        const witnessCount = webvhMeta?.witness?.witnesses?.length ?? 0;
+        const watcherCount = webvhMeta?.watchers?.length ?? 0;
+        if (options.json) {
+            const output = {
+                did: docDid,
+                method: methodOf(docDid),
+                ...(meta?.created && { created: meta.created }),
+                ...(meta?.handle && { handle: meta.handle }),
+                ...(meta?.description && { description: meta.description }),
+                keys: keyCount,
+                ...(webvhMeta && {
+                    versionId: webvhMeta.versionId,
+                    updated: webvhMeta.updated,
+                    portable: webvhMeta.portable,
+                    prerotation: webvhMeta.prerotation,
+                    deactivated: webvhMeta.deactivated,
+                    updateKeys: webvhMeta.updateKeys.length,
+                    witnesses: witnessCount,
+                    watchers: watcherCount
+                })
+            };
+            console.log(JSON.stringify(output, null, 2));
+            return 0;
+        }
+        const rows = [
+            ['DID', docDid],
+            ['Method', methodOf(docDid)],
+            ['Handle', meta?.handle ?? ''],
+            ['Created', meta?.created ?? ''],
+            ['Description', meta?.description ?? ''],
+            ['Keys', String(keyCount)]
+        ];
+        if (webvhMeta) {
+            rows.push(['Version', webvhMeta.versionId], ['Updated', webvhMeta.updated], ['Portable', webvhMeta.portable ? 'yes' : 'no'], ['Prerotation', webvhMeta.prerotation ? 'yes' : 'no'], ['Deactivated', webvhMeta.deactivated ? 'yes' : 'no'], ['Update keys', String(webvhMeta.updateKeys.length)], ['Witnesses', String(witnessCount)], ['Watchers', String(watcherCount)]);
+        }
+        console.log(renderTable({
+            columns: [{ header: 'FIELD' }, { header: 'VALUE' }],
+            rows
+        }));
+        return 0;
+    }
+    // The DID document holds no secret material -- signing keys live in the
+    // separate `<did>.keys.json` file -- so it is safe to print as-is.
+    console.log(JSON.stringify(didDocument, null, 2));
+    return 0;
+}
+/**
+ * List locally stored DIDs with their metadata: one DID per line with
+ * `--plain`, a JSON array with `--json`, otherwise a column-aligned table.
+ *
+ * @param options {object}
+ * @param [options.json] {boolean}   Output a JSON array of objects.
+ * @param [options.plain] {boolean}   Output one DID per line, sorted.
+ * @returns {Promise<number>}   The process exit code.
+ */
+export async function runList(options) {
+    const dids = await listDids();
+    if (options.plain) {
+        for (const did of dids) {
+            console.log(did);
+        }
+        return 0;
+    }
+    const entries = [];
+    for (const did of dids) {
+        const meta = await loadDidMeta({ did });
+        entries.push({ did, method: methodOf(did), ...meta });
+    }
+    if (options.json) {
+        const output = entries.map(entry => ({
+            did: entry.did,
+            method: entry.method,
+            ...(entry.created && { created: entry.created }),
+            ...(entry.handle && { handle: entry.handle }),
+            ...(entry.description && { description: entry.description })
+        }));
+        console.log(JSON.stringify(output, null, 2));
+        return 0;
+    }
+    if (entries.length === 0) {
+        return 0;
+    }
+    const rows = entries.map(entry => [
+        entry.handle ?? '',
+        entry.method,
+        entry.created?.slice(0, 10) ?? '',
+        entry.did,
+        entry.description ?? ''
+    ]);
+    console.log(renderTable({
+        columns: [
+            { header: 'HANDLE', maxWidth: 16 },
+            { header: 'METHOD' },
+            { header: 'CREATED' },
+            { header: 'DID', maxWidth: 44 },
+            { header: 'DESCRIPTION', maxWidth: 40 }
+        ],
+        rows
+    }));
+    return 0;
+}
+/**
+ * Show or edit the metadata of a locally stored DID (by DID or handle). With no
+ * edits, prints the current metadata; otherwise applies the handle/description
+ * changes and saves the sidecar.
+ *
+ * @param options {object}
+ * @param options.didRef {string}   The DID or metadata handle.
+ * @param [options.handle] {string}   Set the handle (empty string clears it).
+ * @param [options.description] {string}   Set the description (empty clears it).
+ * @returns {Promise<number>}   The process exit code.
+ */
+export async function runMeta(options) {
+    const { didRef } = options;
+    let did;
+    try {
+        did = await resolveDidRef({ ref: didRef });
+    }
+    catch (err) {
+        console.error(err.message);
+        return 1;
+    }
+    if (did) {
+        // Refuse to create metadata for DIDs that are not saved locally.
+        try {
+            await loadDidDocument(did);
+        }
+        catch {
+            did = undefined;
+        }
+    }
+    if (!did) {
+        console.error(`No locally stored DID found for ${didRef}`);
+        return 1;
+    }
+    const existing = await loadDidMeta({ did });
+    const hasEdits = options.handle !== undefined || options.description !== undefined;
+    if (!hasEdits) {
+        console.log(JSON.stringify(existing ?? {}, null, 2));
+        return 0;
+    }
+    const meta = { ...(existing ?? {}) };
+    applyMetaEdits(meta, {
+        handle: options.handle,
+        description: options.description
+    });
+    const filePath = await saveDidMeta({ did, meta });
+    console.error(`Metadata saved to ${filePath}`);
+    console.log(JSON.stringify(meta, null, 2));
+    return 0;
+}
+/**
+ * Remove a locally stored DID document, its keys file, and its metadata
+ * sidecar (by DID or handle), scrubbing the cached key-to-DID associations.
+ *
+ * @param options {object}
+ * @param options.didRef {string}   The DID or metadata handle.
+ * @returns {Promise<number>}   The process exit code.
+ */
+export async function runRemove(options) {
+    const { didRef } = options;
+    let did;
+    try {
+        did = await resolveDidRef({ ref: didRef });
+    }
+    catch (err) {
+        console.error(err.message);
+        return 1;
+    }
+    let didDocument;
+    try {
+        didDocument = await loadDidDocument(did ?? didRef);
+    }
+    catch {
+        console.error(`No locally stored DID found for ${didRef}`);
+        return 1;
+    }
+    const docDid = did ?? didRef;
+    // Scrub the cached key-to-DID associations of any matching wallet keys
+    // before the DID document (the source of truth) is deleted.
+    for (const method of didDocument.verificationMethod ?? []) {
+        if (method.publicKeyMultibase) {
+            await removeKeyDidAssociation({
+                publicKeyMultibase: method.publicKeyMultibase,
+                did: docDid
+            });
+        }
+    }
+    const removed = await removeDidFiles({ did: docDid });
+    for (const filePath of removed) {
+        console.error(`Removed ${filePath}`);
+    }
+    return 0;
+}
+//# sourceMappingURL=manage.js.map

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

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

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

@@ -0,0 +1,93 @@
+/**
+ * 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 { type ServiceEndpoint } from '@interop/did-method-webvh';
+/**
+ * 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
+ * already a full DID URL, or any absolute URI carrying a fragment, is returned
+ * unchanged.
+ *
+ * @param options {object}
+ * @param options.did {string}
+ * @param options.id {string}
+ * @returns {string}
+ */
+export declare function normalizeServiceId({ did, id }: {
+    did: string;
+    id: string;
+}): string;
+/**
+ * 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.
+ *
+ * @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 declare function buildServiceEntry({ did, id, type, endpoint, endpointJson }: {
+    did: string;
+    id: string;
+    type: string[];
+    endpoint?: string[];
+    endpointJson?: string;
+}): ServiceEndpoint;
+/**
+ * Append a service entry to the current array, rejecting a duplicate id.
+ *
+ * @param options {object}
+ * @param options.current {ServiceEndpoint[]}
+ * @param options.entry {ServiceEndpoint} its `id` is already normalized.
+ * @param options.did {string}
+ * @returns {ServiceEndpoint[]}
+ */
+export declare function addServiceEntry({ current, entry, did }: {
+    current: ServiceEndpoint[];
+    entry: ServiceEndpoint;
+    did: string;
+}): ServiceEndpoint[];
+/**
+ * Remove the service entry with the given (normalized) id, rejecting a missing
+ * id.
+ *
+ * @param options {object}
+ * @param options.current {ServiceEndpoint[]}
+ * @param options.id {string} the normalized id to remove.
+ * @param options.did {string}
+ * @returns {ServiceEndpoint[]}
+ */
+export declare function removeServiceEntry({ current, id, did }: {
+    current: ServiceEndpoint[];
+    id: string;
+    did: string;
+}): ServiceEndpoint[];
+/**
+ * Resolve a DID reference, then route a service-array transform to the right
+ * per-method runner and return its exit code. did:web is a direct document
+ * edit; did:webvh appends a log entry.
+ *
+ * @param options {object}
+ * @param options.ref {string} a DID or a local metadata handle.
+ * @param options.transform {(current: ServiceEndpoint[], did: string) => ServiceEndpoint[]}
+ * @param [options.yes] {boolean} skip the did:webvh confirmation prompt.
+ * @param [options.keepOldKey] {boolean} did:webvh pre-rotation path only.
+ * @returns {Promise<number>} the process exit code
+ */
+export declare function dispatchServiceUpdate({ ref, transform, yes, keepOldKey }: {
+    ref: string;
+    transform: (current: ServiceEndpoint[], did: string) => ServiceEndpoint[];
+    yes?: boolean;
+    keepOldKey?: boolean;
+}): Promise<number>;
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +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;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;;;;;;;;;;;;;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;AAkMD;;;;;;;;;;;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"}