@interop/did-method-peer 0.0.0-stage → 0.1.0

package/dist/codec.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The `@interop/did-method-peer/codec` subpath: the pure numalgo 4 codec and
+ * nothing from the driver, so a DIDComm library that only needs encode/decode
+ * never loads `DidPeerDriver`, `@interop/bnid` or a key suite.
+ */
+export { decode, encodeLongForm, encodeShortForm, isDidPeer4, isLongForm, isShortForm, longToShort, resolveLongForm, resolveShortForm, LONG_FORM_PATTERN, MAX_LONG_FORM_LENGTH, SHORT_FORM_PATTERN } from './numalgo4.js';
+export type { InputDocument } from './types.js';
+//# sourceMappingURL=codec.d.ts.map

package/dist/codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../src/codec.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,MAAM,EACN,cAAc,EACd,eAAe,EACf,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,eAAe,CAAA;AACtB,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA"}

package/dist/codec.js

@@ -0,0 +1,7 @@
+/**
+ * The `@interop/did-method-peer/codec` subpath: the pure numalgo 4 codec and
+ * nothing from the driver, so a DIDComm library that only needs encode/decode
+ * never loads `DidPeerDriver`, `@interop/bnid` or a key suite.
+ */
+export { decode, encodeLongForm, encodeShortForm, isDidPeer4, isLongForm, isShortForm, longToShort, resolveLongForm, resolveShortForm, LONG_FORM_PATTERN, MAX_LONG_FORM_LENGTH, SHORT_FORM_PATTERN } from './numalgo4.js';
+//# sourceMappingURL=codec.js.map

package/dist/codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.js","sourceRoot":"","sources":["../src/codec.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,MAAM,EACN,cAAc,EACd,eAAe,EACf,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,eAAe,CAAA"}

package/dist/constants.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Shared constants for the did:peer numalgo 4 codec and driver: the DID Core
+ * context URL, the did:peer prefixes, the two multicodec/multihash headers the
+ * codec needs (inlined as byte constants so no varint library is required),
+ * the long form length limit, and the default verification relationships for
+ * a generated verification key.
+ */
+export declare const DID_CONTEXT_URL = "https://www.w3.org/ns/did/v1";
+export declare const DID_PEER_PREFIX = "did:peer:";
+export declare const NUMALGO_4_PREFIX = "did:peer:4";
+/**
+ * Multicodec `json` code (0x0200) as its two-byte unsigned varint.
+ */
+export declare const MULTICODEC_JSON_HEADER: Uint8Array<ArrayBuffer>;
+/**
+ * Multihash header for sha2-256: code 0x12, digest length 0x20 (32 bytes).
+ */
+export declare const MULTIHASH_SHA2_256_HEADER: Uint8Array<ArrayBuffer>;
+export declare const MULTIBASE_BASE58BTC_PREFIX = "z";
+/**
+ * Longest long form `decode` accepts, in characters. A long form carries an
+ * attacker-chosen document, and base58-decoding plus parsing a multi-megabyte
+ * string would block the event loop, so anything longer is rejected before
+ * hashing. 4096 characters is roughly four times the largest published vector
+ * and matches the longest base58 string `@scure/base` will decode, so the
+ * length check, not the base58 decoder, is what rejects an oversized long form.
+ */
+export declare const MAX_LONG_FORM_LENGTH = 4096;
+/**
+ * The verification relationships a generated verification key is wired into
+ * when no explicit `purposes` are given for it (the same four as
+ * `@interop/did-method-key` and `@interop/did-web-resolver`).
+ */
+export declare const DEFAULT_PURPOSES: string[];
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,eAAe,iCAAiC,CAAA;AAE7D,eAAO,MAAM,eAAe,cAAc,CAAA;AAC1C,eAAO,MAAM,gBAAgB,eAAe,CAAA;AAE5C;;GAEG;AACH,eAAO,MAAM,sBAAsB,yBAA+B,CAAA;AAElE;;GAEG;AACH,eAAO,MAAM,yBAAyB,yBAA+B,CAAA;AAErE,eAAO,MAAM,0BAA0B,MAAM,CAAA;AAE7C;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,OAAO,CAAA;AAExC;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,UAK5B,CAAA"}

package/dist/constants.js

@@ -0,0 +1,40 @@
+/**
+ * Shared constants for the did:peer numalgo 4 codec and driver: the DID Core
+ * context URL, the did:peer prefixes, the two multicodec/multihash headers the
+ * codec needs (inlined as byte constants so no varint library is required),
+ * the long form length limit, and the default verification relationships for
+ * a generated verification key.
+ */
+export const DID_CONTEXT_URL = 'https://www.w3.org/ns/did/v1';
+export const DID_PEER_PREFIX = 'did:peer:';
+export const NUMALGO_4_PREFIX = 'did:peer:4';
+/**
+ * Multicodec `json` code (0x0200) as its two-byte unsigned varint.
+ */
+export const MULTICODEC_JSON_HEADER = new Uint8Array([0x80, 0x04]);
+/**
+ * Multihash header for sha2-256: code 0x12, digest length 0x20 (32 bytes).
+ */
+export const MULTIHASH_SHA2_256_HEADER = new Uint8Array([0x12, 0x20]);
+export const MULTIBASE_BASE58BTC_PREFIX = 'z';
+/**
+ * Longest long form `decode` accepts, in characters. A long form carries an
+ * attacker-chosen document, and base58-decoding plus parsing a multi-megabyte
+ * string would block the event loop, so anything longer is rejected before
+ * hashing. 4096 characters is roughly four times the largest published vector
+ * and matches the longest base58 string `@scure/base` will decode, so the
+ * length check, not the base58 decoder, is what rejects an oversized long form.
+ */
+export const MAX_LONG_FORM_LENGTH = 4096;
+/**
+ * The verification relationships a generated verification key is wired into
+ * when no explicit `purposes` are given for it (the same four as
+ * `@interop/did-method-key` and `@interop/did-web-resolver`).
+ */
+export const DEFAULT_PURPOSES = [
+    'authentication',
+    'assertionMethod',
+    'capabilityDelegation',
+    'capabilityInvocation'
+];
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,8BAA8B,CAAA;AAE7D,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAA;AAC1C,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAAA;AAE5C;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;AAElE;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;AAErE,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAA;AAE7C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAA;AAExC;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,gBAAgB;IAChB,iBAAiB;IACjB,sBAAsB;IACtB,sBAAsB;CACvB,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/*!
+ * Copyright (c) 2026 Interop Alliance. All rights reserved.
+ */
+export { driver, DidPeerDriver } from './DidPeerDriver.js';
+export { decode, encodeLongForm, encodeShortForm, isDidPeer4, isLongForm, isShortForm, longToShort, resolveLongForm, resolveShortForm, LONG_FORM_PATTERN, MAX_LONG_FORM_LENGTH, SHORT_FORM_PATTERN } from './numalgo4.js';
+export { validateInputDocument } from './inputDocument.js';
+export type { DidPeerDriverOptions, FromMultibase, InputDocument, KeyPairClass, LongFormStore } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,EACL,MAAM,EACN,cAAc,EACd,eAAe,EACf,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,YAAY,EACV,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,YAAY,EACZ,aAAa,EACd,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,7 @@
+/*!
+ * Copyright (c) 2026 Interop Alliance. All rights reserved.
+ */
+export { driver, DidPeerDriver } from './DidPeerDriver.js';
+export { decode, encodeLongForm, encodeShortForm, isDidPeer4, isLongForm, isShortForm, longToShort, resolveLongForm, resolveShortForm, LONG_FORM_PATTERN, MAX_LONG_FORM_LENGTH, SHORT_FORM_PATTERN } from './numalgo4.js';
+export { validateInputDocument } from './inputDocument.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,EACL,MAAM,EACN,cAAc,EACd,eAAe,EACf,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/inputDocument.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Input document helpers: the superficial validation applied on every
+ * `generate()` path (never on resolution), and the builder that exports a live
+ * key pair into an owner-controlled, relative-id verification method and wires
+ * it into the requested relationships.
+ */
+import type { AbstractKeyPair, IVerificationMethodEntry } from '@interop/data-integrity-core';
+import type { InputDocument } from './types.js';
+/**
+ * Validates an input document before encoding. Deliberately superficial, as
+ * the Python reference's `validate_input_document`: the document must be a
+ * non-empty plain object without a root `id`; `alsoKnownAs`, if present, and
+ * each of `verificationMethod`, the five relationships and `service`, if
+ * present, must be arrays; every object entry in those arrays must have a
+ * relative string `id` (`#fragment`) and a `type`; and resource ids must be
+ * unique across all of them. String entries are references and are not
+ * checked. Key material is not validated.
+ *
+ * @param options {object}
+ * @param options.inputDocument {InputDocument}
+ *
+ * @throws {TypeError} Naming the failing path, e.g.
+ *   `authentication[1]: resource id must be relative`.
+ */
+export declare function validateInputDocument({ inputDocument }: {
+    inputDocument: InputDocument;
+}): void;
+/**
+ * Exports a live key pair's public node and adds it to an input document as
+ * an owner-controlled verification method. The node's `@context` moves into
+ * the document's `@context` (de-duplicated); its `id` becomes the relative
+ * `#${fragment}`; `controller` and the absolute id a live pair carries are
+ * stripped, since the owner DID does not exist until the hash is computed. The
+ * node is listed under `verificationMethod` and referenced by id from each
+ * purpose.
+ *
+ * @param options {object}
+ * @param options.inputDocument {InputDocument} - Document to mutate.
+ * @param options.keyPair {AbstractKeyPair} - A live key pair (with `export()`).
+ * @param [options.fragment] {string} - Defaults to the pair's `fingerprint()`.
+ * @param [options.purposes] {string[]} - Verification relationships to wire.
+ *
+ * @returns {Promise<{inputDocument: InputDocument, fragment: string}>}
+ */
+export declare function addVerificationMethod({ inputDocument, keyPair, fragment, purposes }: {
+    inputDocument: InputDocument;
+    keyPair: AbstractKeyPair;
+    fragment?: string;
+    purposes?: string[];
+}): Promise<{
+    inputDocument: InputDocument;
+    fragment: string;
+}>;
+/**
+ * Adds a third-party-controlled method to an input document, placed verbatim:
+ * a string is a reference appended to each purpose; an object (carrying its
+ * own `id`, `type`, `controller` and key material) is listed under
+ * `verificationMethod` and referenced from each purpose. No live pair is bound
+ * for it.
+ *
+ * @param options {object}
+ * @param options.inputDocument {InputDocument} - Document to mutate.
+ * @param options.entry {IVerificationMethodEntry}
+ * @param options.purposes {string[]}
+ */
+export declare function addThirdPartyMethod({ inputDocument, entry, purposes }: {
+    inputDocument: InputDocument;
+    entry: IVerificationMethodEntry;
+    purposes: string[];
+}): void;
+//# sourceMappingURL=inputDocument.d.ts.map

package/dist/inputDocument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputDocument.d.ts","sourceRoot":"","sources":["../src/inputDocument.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EACV,eAAe,EACf,wBAAwB,EACzB,MAAM,8BAA8B,CAAA;AAGrC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAQ/C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,aAAa,EACd,EAAE;IACD,aAAa,EAAE,aAAa,CAAA;CAC7B,GAAG,IAAI,CAmDP;AA2ED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,qBAAqB,CAAC,EAC1C,aAAa,EACb,OAAO,EACP,QAAQ,EACR,QAAa,EACd,EAAE;IACD,aAAa,EAAE,aAAa,CAAA;IAC5B,OAAO,EAAE,eAAe,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB,GAAG,OAAO,CAAC;IAAE,aAAa,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA0B9D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,aAAa,EACb,KAAK,EACL,QAAQ,EACT,EAAE;IACD,aAAa,EAAE,aAAa,CAAA;IAC5B,KAAK,EAAE,wBAAwB,CAAA;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB,GAAG,IAAI,CAkBP"}

package/dist/inputDocument.js

@@ -0,0 +1,192 @@
+import { VERIFICATION_RELATIONSHIPS, deepClone } from '@interop/did-io';
+import { RESOURCE_PROPERTIES, isPlainObject } from './resources.js';
+/**
+ * A relative fragment reference: `#` followed by a non-empty fragment that
+ * contains no further `#`.
+ */
+const RELATIVE_ID_PATTERN = /^#[^#]+$/;
+/**
+ * Validates an input document before encoding. Deliberately superficial, as
+ * the Python reference's `validate_input_document`: the document must be a
+ * non-empty plain object without a root `id`; `alsoKnownAs`, if present, and
+ * each of `verificationMethod`, the five relationships and `service`, if
+ * present, must be arrays; every object entry in those arrays must have a
+ * relative string `id` (`#fragment`) and a `type`; and resource ids must be
+ * unique across all of them. String entries are references and are not
+ * checked. Key material is not validated.
+ *
+ * @param options {object}
+ * @param options.inputDocument {InputDocument}
+ *
+ * @throws {TypeError} Naming the failing path, e.g.
+ *   `authentication[1]: resource id must be relative`.
+ */
+export function validateInputDocument({ inputDocument }) {
+    if (!isPlainObject(inputDocument) ||
+        Object.keys(inputDocument).length === 0) {
+        throw new TypeError('inputDocument: must be a non-empty object.');
+    }
+    if (Object.hasOwn(inputDocument, 'id')) {
+        throw new TypeError('inputDocument: must not have a root "id".');
+    }
+    if (Object.hasOwn(inputDocument, 'alsoKnownAs') &&
+        !Array.isArray(inputDocument.alsoKnownAs)) {
+        throw new TypeError('alsoKnownAs: must be an array.');
+    }
+    const seen = new Map();
+    for (const property of RESOURCE_PROPERTIES) {
+        if (!Object.hasOwn(inputDocument, property)) {
+            continue;
+        }
+        const entries = inputDocument[property];
+        if (!Array.isArray(entries)) {
+            throw new TypeError(`${property}: must be an array.`);
+        }
+        entries.forEach((entry, index) => {
+            if (typeof entry === 'string') {
+                return;
+            }
+            const path = `${property}[${index}]`;
+            if (!isPlainObject(entry)) {
+                throw new TypeError(`${path}: resource must be an object.`);
+            }
+            if (typeof entry.id !== 'string') {
+                throw new TypeError(`${path}: resource id must be a string.`);
+            }
+            if (!RELATIVE_ID_PATTERN.test(entry.id)) {
+                throw new TypeError(`${path}: resource id must be relative.`);
+            }
+            if (typeof entry.type !== 'string' || entry.type.length === 0) {
+                throw new TypeError(`${path}: resource must have a type.`);
+            }
+            const previous = seen.get(entry.id);
+            if (previous !== undefined) {
+                throw new TypeError(`${path}: duplicate resource id "${entry.id}" (also at ${previous}).`);
+            }
+            seen.set(entry.id, path);
+        });
+    }
+}
+/**
+ * Adds one or more contexts to an input document's `@context`, de-duplicating.
+ */
+function addContext({ inputDocument, context }) {
+    const existing = inputDocument['@context'];
+    let contexts;
+    if (Array.isArray(existing)) {
+        contexts = existing;
+    }
+    else if (existing === undefined) {
+        contexts = [];
+    }
+    else {
+        contexts = [existing];
+    }
+    for (const ctx of Array.isArray(context) ? context : [context]) {
+        if (!contexts.includes(ctx)) {
+            contexts.push(ctx);
+        }
+    }
+    inputDocument['@context'] = contexts;
+}
+function assertPurposes(purposes) {
+    for (const purpose of purposes) {
+        if (!VERIFICATION_RELATIONSHIPS.has(purpose)) {
+            throw new Error(`Unsupported key purpose: "${purpose}".`);
+        }
+    }
+}
+function pushTo({ inputDocument, property, value }) {
+    const existing = inputDocument[property];
+    if (existing === undefined) {
+        inputDocument[property] = [value];
+    }
+    else if (Array.isArray(existing)) {
+        existing.push(value);
+    }
+    else {
+        throw new TypeError(`${property}: must be an array.`);
+    }
+}
+/**
+ * Lists a method node under `verificationMethod` and references its id from
+ * each purpose.
+ */
+function placeMethod({ inputDocument, node, purposes }) {
+    pushTo({ inputDocument, property: 'verificationMethod', value: node });
+    for (const purpose of purposes) {
+        pushTo({ inputDocument, property: purpose, value: node.id });
+    }
+}
+/**
+ * Exports a live key pair's public node and adds it to an input document as
+ * an owner-controlled verification method. The node's `@context` moves into
+ * the document's `@context` (de-duplicated); its `id` becomes the relative
+ * `#${fragment}`; `controller` and the absolute id a live pair carries are
+ * stripped, since the owner DID does not exist until the hash is computed. The
+ * node is listed under `verificationMethod` and referenced by id from each
+ * purpose.
+ *
+ * @param options {object}
+ * @param options.inputDocument {InputDocument} - Document to mutate.
+ * @param options.keyPair {AbstractKeyPair} - A live key pair (with `export()`).
+ * @param [options.fragment] {string} - Defaults to the pair's `fingerprint()`.
+ * @param [options.purposes] {string[]} - Verification relationships to wire.
+ *
+ * @returns {Promise<{inputDocument: InputDocument, fragment: string}>}
+ */
+export async function addVerificationMethod({ inputDocument, keyPair, fragment, purposes = [] }) {
+    if (typeof keyPair?.export !== 'function') {
+        throw new TypeError('"keyPair" must be a live key pair with "export()".');
+    }
+    assertPurposes(purposes);
+    if (fragment === undefined) {
+        if (typeof keyPair.fingerprint !== 'function') {
+            throw new TypeError('Cannot determine a default fragment; provide a "fragment".');
+        }
+        fragment = keyPair.fingerprint();
+    }
+    const node = (await keyPair.export({
+        publicKey: true,
+        includeContext: true
+    }));
+    const context = node['@context'];
+    delete node['@context'];
+    delete node.controller;
+    node.id = `#${fragment}`;
+    if (context !== undefined) {
+        addContext({ inputDocument, context });
+    }
+    placeMethod({ inputDocument, node, purposes });
+    return { inputDocument, fragment };
+}
+/**
+ * Adds a third-party-controlled method to an input document, placed verbatim:
+ * a string is a reference appended to each purpose; an object (carrying its
+ * own `id`, `type`, `controller` and key material) is listed under
+ * `verificationMethod` and referenced from each purpose. No live pair is bound
+ * for it.
+ *
+ * @param options {object}
+ * @param options.inputDocument {InputDocument} - Document to mutate.
+ * @param options.entry {IVerificationMethodEntry}
+ * @param options.purposes {string[]}
+ */
+export function addThirdPartyMethod({ inputDocument, entry, purposes }) {
+    assertPurposes(purposes);
+    if (typeof entry === 'string') {
+        for (const purpose of purposes) {
+            pushTo({ inputDocument, property: purpose, value: entry });
+        }
+        return;
+    }
+    if (!isPlainObject(entry) || typeof entry.id !== 'string') {
+        throw new TypeError('A "verificationMethods" entry must be a key pair entry, a DID URL string, or a verification method object with a string "id".');
+    }
+    placeMethod({
+        inputDocument,
+        node: deepClone(entry),
+        purposes
+    });
+}
+//# sourceMappingURL=inputDocument.js.map

package/dist/inputDocument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputDocument.js","sourceRoot":"","sources":["../src/inputDocument.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,0BAA0B,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AACvE,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAGnE;;;GAGG;AACH,MAAM,mBAAmB,GAAG,UAAU,CAAA;AAEtC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,qBAAqB,CAAC,EACpC,aAAa,EAGd;IACC,IACE,CAAC,aAAa,CAAC,aAAa,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,KAAK,CAAC,EACvC,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,4CAA4C,CAAC,CAAA;IACnE,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,SAAS,CAAC,2CAA2C,CAAC,CAAA;IAClE,CAAC;IACD,IACE,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,aAAa,CAAC;QAC3C,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,EACzC,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,gCAAgC,CAAC,CAAA;IACvD,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAA;IACtC,KAAK,MAAM,QAAQ,IAAI,mBAAmB,EAAE,CAAC;QAC3C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC5C,SAAQ;QACV,CAAC;QACD,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAA;QACvC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,SAAS,CAAC,GAAG,QAAQ,qBAAqB,CAAC,CAAA;QACvD,CAAC;QACD,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,OAAM;YACR,CAAC;YACD,MAAM,IAAI,GAAG,GAAG,QAAQ,IAAI,KAAK,GAAG,CAAA;YACpC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,+BAA+B,CAAC,CAAA;YAC7D,CAAC;YACD,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;gBACjC,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,iCAAiC,CAAC,CAAA;YAC/D,CAAC;YACD,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;gBACxC,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,iCAAiC,CAAC,CAAA;YAC/D,CAAC;YACD,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9D,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,8BAA8B,CAAC,CAAA;YAC5D,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YACnC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,MAAM,IAAI,SAAS,CACjB,GAAG,IAAI,4BAA4B,KAAK,CAAC,EAAE,cAAc,QAAQ,IAAI,CACtE,CAAA;YACH,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;QAC1B,CAAC,CAAC,CAAA;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CAAC,EAClB,aAAa,EACb,OAAO,EAIR;IACC,MAAM,QAAQ,GAAG,aAAa,CAAC,UAAU,CAAC,CAAA;IAC1C,IAAI,QAAmB,CAAA;IACvB,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,QAAQ,GAAG,QAAQ,CAAA;IACrB,CAAC;SAAM,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAClC,QAAQ,GAAG,EAAE,CAAA;IACf,CAAC;SAAM,CAAC;QACN,QAAQ,GAAG,CAAC,QAAQ,CAAC,CAAA;IACvB,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/D,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACpB,CAAC;IACH,CAAC;IACD,aAAa,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAA;AACtC,CAAC;AAED,SAAS,cAAc,CAAC,QAAkB;IACxC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC,0BAA0B,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,6BAA6B,OAAO,IAAI,CAAC,CAAA;QAC3D,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,EACd,aAAa,EACb,QAAQ,EACR,KAAK,EAKN;IACC,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAA;IACxC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACnC,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACtB,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,SAAS,CAAC,GAAG,QAAQ,qBAAqB,CAAC,CAAA;IACvD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,EACnB,aAAa,EACb,IAAI,EACJ,QAAQ,EAKT;IACC,MAAM,CAAC,EAAE,aAAa,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACtE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,CAAC,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;IAC9D,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,EAC1C,aAAa,EACb,OAAO,EACP,QAAQ,EACR,QAAQ,GAAG,EAAE,EAMd;IACC,IAAI,OAAO,OAAO,EAAE,MAAM,KAAK,UAAU,EAAE,CAAC;QAC1C,MAAM,IAAI,SAAS,CAAC,oDAAoD,CAAC,CAAA;IAC3E,CAAC;IACD,cAAc,CAAC,QAAQ,CAAC,CAAA;IACxB,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;YAC9C,MAAM,IAAI,SAAS,CACjB,4DAA4D,CAC7D,CAAA;QACH,CAAC;QACD,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,CAAA;IAClC,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC;QACjC,SAAS,EAAE,IAAI;QACf,cAAc,EAAE,IAAI;KACX,CAAC,CAA4B,CAAA;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,CAAA;IAChC,OAAO,IAAI,CAAC,UAAU,CAAC,CAAA;IACvB,OAAO,IAAI,CAAC,UAAU,CAAA;IACtB,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,EAAE,CAAA;IACxB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,UAAU,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAA;IACxC,CAAC;IACD,WAAW,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAA;IAC9C,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAA;AACpC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAClC,aAAa,EACb,KAAK,EACL,QAAQ,EAKT;IACC,cAAc,CAAC,QAAQ,CAAC,CAAA;IACxB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,CAAC,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;QAC5D,CAAC;QACD,OAAM;IACR,CAAC;IACD,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC1D,MAAM,IAAI,SAAS,CACjB,+HAA+H,CAChI,CAAA;IACH,CAAC;IACD,WAAW,CAAC;QACV,aAAa;QACb,IAAI,EAAE,SAAS,CAAC,KAAK,CAA4B;QACjD,QAAQ;KACT,CAAC,CAAA;AACJ,CAAC"}

package/dist/numalgo4.d.ts

@@ -0,0 +1,137 @@
+import { DIDResolutionError, type IDIDDocument, type IDIDResolutionErrorCode } from '@interop/data-integrity-core';
+import type { InputDocument } from './types.js';
+export { MAX_LONG_FORM_LENGTH } from './constants.js';
+/**
+ * Matches a long form: a fixed `zQm` prefix (every hash is a base58btc
+ * sha2-256 multihash), 44 more base58 characters, then the encoded document,
+ * at least 6 base58 characters (what `{}` encodes to). Bitcoin alphabet.
+ */
+export declare const LONG_FORM_PATTERN: RegExp;
+/**
+ * Matches a short form: `did:peer:4` followed by the 46-character hash.
+ */
+export declare const SHORT_FORM_PATTERN: RegExp;
+/**
+ * Builds a `DIDResolutionError` with the spec problem details for its code.
+ * The codec and the driver throw this directly (no private error class), so
+ * `CachedResolver.resolveDID()` produces the right envelope without a
+ * translation layer.
+ *
+ * @param options {object}
+ * @param options.code {IDIDResolutionErrorCode}
+ * @param options.message {string}
+ * @param [options.cause] {unknown}
+ *
+ * @returns {DIDResolutionError}
+ */
+export declare function resolutionError({ code, message, cause }: {
+    code: IDIDResolutionErrorCode;
+    message: string;
+    cause?: unknown;
+}): DIDResolutionError;
+/**
+ * Encodes an input document into its long form. Does not validate; validation
+ * is the driver's job at `generate()` time.
+ *
+ * @param options {object}
+ * @param options.inputDocument {InputDocument}
+ *
+ * @returns {string} The long form `did:peer:4{hash}:{encoded document}`.
+ */
+export declare function encodeLongForm({ inputDocument }: {
+    inputDocument: InputDocument;
+}): string;
+/**
+ * Encodes an input document into its short form. Does not validate.
+ *
+ * @param options {object}
+ * @param options.inputDocument {InputDocument}
+ *
+ * @returns {string} The short form `did:peer:4{hash}`.
+ */
+export declare function encodeShortForm({ inputDocument }: {
+    inputDocument: InputDocument;
+}): string;
+/**
+ * Whether a string starts with the numalgo 4 prefix `did:peer:4`.
+ *
+ * @param did {string}
+ *
+ * @returns {boolean}
+ */
+export declare function isDidPeer4(did: string): boolean;
+/**
+ * Whether a string matches the long form grammar. Does not verify the hash.
+ *
+ * @param did {string}
+ *
+ * @returns {boolean}
+ */
+export declare function isLongForm(did: string): boolean;
+/**
+ * Whether a string matches the short form grammar.
+ *
+ * @param did {string}
+ *
+ * @returns {boolean}
+ */
+export declare function isShortForm(did: string): boolean;
+/**
+ * Returns the short form of a long form by string surgery (regex guarded). It
+ * does not verify the hash; callers that need that call `decode` first.
+ *
+ * @param options {object}
+ * @param options.did {string} - A long form.
+ *
+ * @throws {DIDResolutionError} `invalidDid` if `did` is not a long form.
+ *
+ * @returns {string} The short form.
+ */
+export declare function longToShort({ did }: {
+    did: string;
+}): string;
+/**
+ * Decodes a long form into its input document, verifying the hash over the
+ * encoded document string exactly as present in the DID. Rejects anything that
+ * is not a numalgo 4 long form, a long form over `MAX_LONG_FORM_LENGTH`, a
+ * hash mismatch, a bad multicodec prefix, invalid UTF-8 or JSON, and a payload
+ * that is not a plain object. Returns a freshly parsed document on every call.
+ *
+ * @param options {object}
+ * @param options.did {string} - A long form.
+ *
+ * @throws {TypeError} If `did` is not a string.
+ * @throws {DIDResolutionError} With code `invalidDid` for every other failure.
+ *
+ * @returns {InputDocument} The input document, relative references intact.
+ */
+export declare function decode({ did }: {
+    did: string;
+}): InputDocument;
+/**
+ * Resolves a long form to its DID document: `decode` (regex, length and hash
+ * checks) followed by contextualization with the long form as `id` and the
+ * short form appended to `alsoKnownAs`. References stay relative.
+ *
+ * @param options {object}
+ * @param options.did {string} - A long form.
+ *
+ * @returns {IDIDDocument}
+ */
+export declare function resolveLongForm({ did }: {
+    did: string;
+}): IDIDDocument;
+/**
+ * Resolves a short form from its long form: decodes the long form (so the
+ * regex and hash checks run), then contextualizes with the short form as `id`
+ * and the long form appended to `alsoKnownAs`. References stay relative.
+ *
+ * @param options {object}
+ * @param options.longFormDid {string} - The long form previously seen.
+ *
+ * @returns {IDIDDocument}
+ */
+export declare function resolveShortForm({ longFormDid }: {
+    longFormDid: string;
+}): IDIDDocument;
+//# sourceMappingURL=numalgo4.d.ts.map

package/dist/numalgo4.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numalgo4.d.ts","sourceRoot":"","sources":["../src/numalgo4.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAC7B,MAAM,8BAA8B,CAAA;AAUrC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAErD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QACuC,CAAA;AAErE;;GAEG;AACH,eAAO,MAAM,kBAAkB,QAA4C,CAAA;AAyB3E;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,EAC9B,IAAI,EACJ,OAAO,EACP,KAAK,EACN,EAAE;IACD,IAAI,EAAE,uBAAuB,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,GAAG,kBAAkB,CAOrB;AAuCD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,EAC7B,aAAa,EACd,EAAE;IACD,aAAa,EAAE,aAAa,CAAA;CAC7B,GAAG,MAAM,CAIT;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,EAC9B,aAAa,EACd,EAAE;IACD,aAAa,EAAE,aAAa,CAAA;CAC7B,GAAG,MAAM,CAET;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,EAAE,GAAG,EAAE,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAK5D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,CAAC,EAAE,GAAG,EAAE,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CAwD9D;AAoDD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,EAAE,GAAG,EAAE,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,CAOtE;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,WAAW,EACZ,EAAE;IACD,WAAW,EAAE,MAAM,CAAA;CACpB,GAAG,YAAY,CAOf"}