@interop/wallet-core 0.94.0 → 0.96.0

package/dist/keys/clientLabels.js

@@ -1,96 +0,0 @@
-/*!
- * Copyright (c) 2026 Interop Alliance. All rights reserved.
- */
-/**
- * Enrolled-client display labels: the `key-map/client-labels.json` record, a
- * plain-JSON map from a client's signing-key multibase to the human-chosen
- * label a "your wallets" surface shows. The did:webvh document is the roster
- * of record and deliberately carries key material only, so labels live
- * beside the account's other key-map resources instead -- private,
- * capability-gated, and shared by every enrolled client (each wallet app
- * reads and writes the same record).
- *
- * The record is display metadata with no authority: a missing or malformed
- * record degrades to unlabeled rows, an entry whose key the document no
- * longer lists is simply never shown, and writes are last-write-wins (a lost
- * race costs at most a label). I/O runs through the two-method
- * {@link ClientLabelsStore} seam a wallet app satisfies with its own
- * remote-store class.
- */
-/**
- * Reads the labels record, degrading to an empty record when it is missing
- * or malformed (labels are display metadata; a broken record must never
- * block a listing).
- *
- * @param options {object}
- * @param options.store {ClientLabelsStore}
- * @returns {Promise<ClientLabelsRecord>}
- */
-export async function readClientLabels({ store }) {
-    let body;
-    try {
-        body = await store.get();
-    }
-    catch {
-        return { version: 1, labels: {} };
-    }
-    if (body === null || typeof body !== 'object') {
-        return { version: 1, labels: {} };
-    }
-    const { version, labels } = body;
-    if (version !== 1 || labels === null || typeof labels !== 'object') {
-        return { version: 1, labels: {} };
-    }
-    const parsed = {};
-    for (const [key, value] of Object.entries(labels)) {
-        if (typeof value === 'string') {
-            parsed[key] = value;
-        }
-    }
-    return { version: 1, labels: parsed };
-}
-/**
- * Sets (or renames) one client's label, read-modify-write over the stored
- * record. A blank label removes the entry instead of storing whitespace.
- *
- * @param options {object}
- * @param options.store {ClientLabelsStore}
- * @param options.signingKeyMultibase {string}
- * @param options.label {string}
- * @returns {Promise<ClientLabelsRecord>}   the record as written
- */
-export async function setClientLabel({ store, signingKeyMultibase, label }) {
-    const trimmed = label.trim();
-    if (!trimmed) {
-        return removeClientLabel({ store, signingKeyMultibase });
-    }
-    const record = await readClientLabels({ store });
-    const updated = {
-        version: 1,
-        labels: { ...record.labels, [signingKeyMultibase]: trimmed }
-    };
-    await store.put({ content: updated });
-    return updated;
-}
-/**
- * Drops one client's label (revocation hygiene -- the label of a
- * disconnected client points at nothing). A record without the entry is a
- * no-op that writes nothing.
- *
- * @param options {object}
- * @param options.store {ClientLabelsStore}
- * @param options.signingKeyMultibase {string}
- * @returns {Promise<ClientLabelsRecord>}   the record as stored
- */
-export async function removeClientLabel({ store, signingKeyMultibase }) {
-    const record = await readClientLabels({ store });
-    if (!(signingKeyMultibase in record.labels)) {
-        return record;
-    }
-    const labels = { ...record.labels };
-    delete labels[signingKeyMultibase];
-    const updated = { version: 1, labels };
-    await store.put({ content: updated });
-    return updated;
-}
-//# sourceMappingURL=clientLabels.js.map

package/dist/keys/clientLabels.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"clientLabels.js","sourceRoot":"","sources":["../../src/keys/clientLabels.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;;;;;;;GAeG;AA0BH;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,EACrC,KAAK,EAGN;IACC,IAAI,IAAa,CAAA;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,CAAA;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;IACnC,CAAC;IACD,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;IACnC,CAAC;IACD,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAA+C,CAAA;IAC3E,IAAI,OAAO,KAAK,CAAC,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACnE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;IACnC,CAAC;IACD,MAAM,MAAM,GAA2B,EAAE,CAAA;IACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QACrB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;AACvC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,EACnC,KAAK,EACL,mBAAmB,EACnB,KAAK,EAKN;IACC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,iBAAiB,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAA;IAC1D,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;IAChD,MAAM,OAAO,GAAuB;QAClC,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,mBAAmB,CAAC,EAAE,OAAO,EAAE;KAC7D,CAAA;IACD,MAAM,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;IACrC,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,EACtC,KAAK,EACL,mBAAmB,EAIpB;IACC,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;IAChD,IAAI,CAAC,CAAC,mBAAmB,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,OAAO,MAAM,CAAA;IACf,CAAC;IACD,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,CAAA;IACnC,OAAO,MAAM,CAAC,mBAAmB,CAAC,CAAA;IAClC,MAAM,OAAO,GAAuB,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1D,MAAM,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;IACrC,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/keys/wasLabelsStore.d.ts

@@ -1,33 +0,0 @@
-/*!
- * Copyright (c) 2026 Interop Alliance. All rights reserved.
- */
-/**
- * The WAS-backed adapter for the enrolled-client display labels
- * (`key-map/client-labels.json`): the {@link ClientLabelsStore} seam the label
- * helpers read and write through, over the same private, plaintext `key-map`
- * collection the wrap-set roster lives in. Every wallet app on the account
- * shares this one implementation, so they share one record.
- */
-import type { IZcap } from '@interop/data-integrity-core';
-import type { WasClient } from '@interop/was-client';
-import type { ClientLabelsStore } from './clientLabels.js';
-/**
- * Builds the labels store over `key-map/client-labels.json` in a data Space.
- *
- * @param options {object}
- * @param options.was {WasClient}   the account's storage client, signing as an
- *   enrolled client or, under a delegated capability, as the annex
- *   verification method
- * @param options.spaceId {string}   the data Space id
- * @param [options.capability] {IZcap}   an invocation capability the read and
- *   the write both ride (a delegated Space-subtree zcap -- a transient
- *   session's generation delegation); absent, both invoke the root capability
- *   as before
- * @returns {ClientLabelsStore}
- */
-export declare function wasClientLabelsStore({ was, spaceId, capability }: {
-    was: WasClient;
-    spaceId: string;
-    capability?: IZcap;
-}): ClientLabelsStore;
-//# sourceMappingURL=wasLabelsStore.d.ts.map

package/dist/keys/wasLabelsStore.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wasLabelsStore.d.ts","sourceRoot":"","sources":["../../src/keys/wasLabelsStore.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAA;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAMpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAE1D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,GAAG,EACH,OAAO,EACP,UAAU,EACX,EAAE;IACD,GAAG,EAAE,SAAS,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,KAAK,CAAA;CACnB,GAAG,iBAAiB,CAiBpB"}

package/dist/keys/wasLabelsStore.js

@@ -1,35 +0,0 @@
-import { CLIENT_LABELS_RESOURCE, KEY_MAP_COLLECTION } from '../space/collections.js';
-import { plaintextCollection } from '../space/plaintextCollection.js';
-/**
- * Builds the labels store over `key-map/client-labels.json` in a data Space.
- *
- * @param options {object}
- * @param options.was {WasClient}   the account's storage client, signing as an
- *   enrolled client or, under a delegated capability, as the annex
- *   verification method
- * @param options.spaceId {string}   the data Space id
- * @param [options.capability] {IZcap}   an invocation capability the read and
- *   the write both ride (a delegated Space-subtree zcap -- a transient
- *   session's generation delegation); absent, both invoke the root capability
- *   as before
- * @returns {ClientLabelsStore}
- */
-export function wasClientLabelsStore({ was, spaceId, capability }) {
-    const resource = plaintextCollection({
-        was,
-        spaceId,
-        collectionId: KEY_MAP_COLLECTION.id,
-        capability
-    }).resource(CLIENT_LABELS_RESOURCE);
-    return {
-        async get() {
-            const result = await resource.get();
-            return result === null ? undefined : result;
-        },
-        async put({ content }) {
-            const body = new TextEncoder().encode(JSON.stringify(content));
-            await resource.put(body, { contentType: 'application/json' });
-        }
-    };
-}
-//# sourceMappingURL=wasLabelsStore.js.map

package/dist/keys/wasLabelsStore.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"wasLabelsStore.js","sourceRoot":"","sources":["../../src/keys/wasLabelsStore.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AAGrE;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oBAAoB,CAAC,EACnC,GAAG,EACH,OAAO,EACP,UAAU,EAKX;IACC,MAAM,QAAQ,GAAG,mBAAmB,CAAC;QACnC,GAAG;QACH,OAAO;QACP,YAAY,EAAE,kBAAkB,CAAC,EAAE;QACnC,UAAU;KACX,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAA;IACnC,OAAO;QACL,KAAK,CAAC,GAAG;YACP,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,CAAA;YACnC,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAA;QAC7C,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,EAAuB;YACxC,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAA;YAC9D,MAAM,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC,CAAA;QAC/D,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/writers/entry.d.ts

@@ -1,95 +0,0 @@
-/**
- * The version-1 roster entry. A type alias rather than an interface, so it
- * is assignable to was-client's `JsonObject`.
- */
-export type RegisteredWriterEntry = {
-    version: 1;
-    /**
-     * The writer's `writerId`, verbatim. The resource id is a hash of it, so a
-     * reader takes the id from here.
-     */
-    writerId: string;
-    /**
-     * An enrolled wallet client's own signing-key multibase, the key the
-     * client-labels record and `listAccountClients` rows are keyed by. Absent
-     * for a non-wallet writer.
-     */
-    signingKeyMultibase?: string;
-    /**
-     * A coarse platform self-description, or the user's rename of it.
-     */
-    label: string;
-    /**
-     * ISO 8601 UTC timestamp of the writer's latest liveness touch.
-     */
-    lastSeen: string;
-    /**
-     * `false` once a sweep found `lastSeen` past the inactivity TTL. The writer's
-     * next touch sets it back to `true`.
-     */
-    active: boolean;
-};
-/**
- * The expiry and liveness policy of the roster. Every replica that sweeps
- * must use the same values, or two sweepers disagree about which entries are
- * orphans.
- */
-export interface RegisteredWriterPolicy {
-    /**
-     * How long an entry may go untouched before a sweep marks it inactive.
-     */
-    inactiveAfterMs: number;
-    /**
-     * The entry count past which a sweep (or an enrollment) deletes the
-     * oldest-`lastSeen` entries.
-     */
-    maxEntries: number;
-    /**
-     * The least time between two liveness touches by the same writer.
-     */
-    touchIntervalMs: number;
-}
-/**
- * The default policy: inactive after 90 days, at most 64 entries, touched at
- * most once a day. A wallet that overrides any of these passes the same
- * override on every replica.
- */
-export declare const REGISTERED_WRITER_POLICY: RegisteredWriterPolicy;
-/**
- * The domain label of the resource id hash.
- */
-export declare const REGISTERED_WRITER_ID_LABEL = "registered-writers/v1";
-/**
- * The resource id of one writer's entry under one account: the first 16
- * bytes of `sha256(utf8('registered-writers/v1|' + accountDid + '|' +
- * writerId))`, formatted as an EDV document id.
- *
- * The id is deterministic, so a registration and a touch are idempotent
- * upserts. It hides the `writerId` from the storage host and does not link
- * one `writerId` across accounts.
- *
- * @param options {object}
- * @param options.accountDid {string}   the account whose Space holds the roster
- * @param options.writerId {string}
- * @returns {string}
- */
-export declare function registeredWriterResourceId({ accountDid, writerId }: {
-    accountDid: string;
-    writerId: string;
-}): string;
-/**
- * Resolves a partial policy override against the defaults.
- *
- * @param [policy] {Partial<RegisteredWriterPolicy>}
- * @returns {RegisteredWriterPolicy}
- */
-export declare function registeredWriterPolicy(policy?: Partial<RegisteredWriterPolicy>): RegisteredWriterPolicy;
-/**
- * Reads a stored body as a roster entry, or `undefined` when it is not one.
- * A malformed entry is skipped by every reader, and never repaired.
- *
- * @param body {unknown}
- * @returns {RegisteredWriterEntry | undefined}
- */
-export declare function parseRegisteredWriterEntry(body: unknown): RegisteredWriterEntry | undefined;
-//# sourceMappingURL=entry.d.ts.map

package/dist/writers/entry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../src/writers/entry.ts"],"names":[],"mappings":"AAgBA;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,CAAC,CAAA;IACV;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAA;CAChB,CAAA;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,eAAe,EAAE,MAAM,CAAA;IACvB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAA;CACxB;AAID;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,sBAItC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B,0BAA0B,CAAA;AAEjE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CAAC,EACzC,UAAU,EACV,QAAQ,EACT,EAAE;IACD,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;CACjB,GAAG,MAAM,CAKT;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACvC,sBAAsB,CAExB;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,OAAO,GACZ,qBAAqB,GAAG,SAAS,CA2BnC"}

package/dist/writers/entry.js

@@ -1,90 +0,0 @@
-/*!
- * Copyright (c) 2026 Interop Alliance. All rights reserved.
- */
-/**
- * The writer roster's entry: its version-1 shape, the shape check every
- * reader runs, the resource id an entry lives at, and the expiry policy both
- * wallets sweep under.
- *
- * An entry is advisory display data. Its writer asserts every field about
- * itself, and nothing checks them beyond shape. `signingKeyMultibase` links a
- * wallet writer to its enrolled client only when the verified did:webvh
- * document lists that key, and no field is an input to any authorization.
- */
-import { sha256 } from '@noble/hashes/sha2.js';
-import { edvIdFromBytes } from '@interop/was-client/edv/cipher';
-const DAY_MS = 24 * 60 * 60 * 1000;
-/**
- * The default policy: inactive after 90 days, at most 64 entries, touched at
- * most once a day. A wallet that overrides any of these passes the same
- * override on every replica.
- */
-export const REGISTERED_WRITER_POLICY = {
-    inactiveAfterMs: 90 * DAY_MS,
-    maxEntries: 64,
-    touchIntervalMs: DAY_MS
-};
-/**
- * The domain label of the resource id hash.
- */
-export const REGISTERED_WRITER_ID_LABEL = 'registered-writers/v1';
-/**
- * The resource id of one writer's entry under one account: the first 16
- * bytes of `sha256(utf8('registered-writers/v1|' + accountDid + '|' +
- * writerId))`, formatted as an EDV document id.
- *
- * The id is deterministic, so a registration and a touch are idempotent
- * upserts. It hides the `writerId` from the storage host and does not link
- * one `writerId` across accounts.
- *
- * @param options {object}
- * @param options.accountDid {string}   the account whose Space holds the roster
- * @param options.writerId {string}
- * @returns {string}
- */
-export function registeredWriterResourceId({ accountDid, writerId }) {
-    const input = new TextEncoder().encode(`${REGISTERED_WRITER_ID_LABEL}|${accountDid}|${writerId}`);
-    return edvIdFromBytes(sha256(input).subarray(0, 16));
-}
-/**
- * Resolves a partial policy override against the defaults.
- *
- * @param [policy] {Partial<RegisteredWriterPolicy>}
- * @returns {RegisteredWriterPolicy}
- */
-export function registeredWriterPolicy(policy) {
-    return { ...REGISTERED_WRITER_POLICY, ...policy };
-}
-/**
- * Reads a stored body as a roster entry, or `undefined` when it is not one.
- * A malformed entry is skipped by every reader, and never repaired.
- *
- * @param body {unknown}
- * @returns {RegisteredWriterEntry | undefined}
- */
-export function parseRegisteredWriterEntry(body) {
-    if (body === null || typeof body !== 'object') {
-        return undefined;
-    }
-    const { version, writerId, signingKeyMultibase, label, lastSeen, active } = body;
-    if (version !== 1 ||
-        typeof writerId !== 'string' ||
-        writerId === '' ||
-        typeof label !== 'string' ||
-        typeof lastSeen !== 'string' ||
-        Number.isNaN(Date.parse(lastSeen)) ||
-        typeof active !== 'boolean' ||
-        (signingKeyMultibase !== undefined &&
-            typeof signingKeyMultibase !== 'string')) {
-        return undefined;
-    }
-    return {
-        version: 1,
-        writerId,
-        ...(signingKeyMultibase !== undefined && { signingKeyMultibase }),
-        label,
-        lastSeen,
-        active
-    };
-}
-//# sourceMappingURL=entry.js.map

package/dist/writers/entry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../src/writers/entry.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;GASG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAuD/D,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AAElC;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAA2B;IAC9D,eAAe,EAAE,EAAE,GAAG,MAAM;IAC5B,UAAU,EAAE,EAAE;IACd,eAAe,EAAE,MAAM;CACxB,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,uBAAuB,CAAA;AAEjE;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,0BAA0B,CAAC,EACzC,UAAU,EACV,QAAQ,EAIT;IACC,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CACpC,GAAG,0BAA0B,IAAI,UAAU,IAAI,QAAQ,EAAE,CAC1D,CAAA;IACD,OAAO,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;AACtD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAwC;IAExC,OAAO,EAAE,GAAG,wBAAwB,EAAE,GAAG,MAAM,EAAE,CAAA;AACnD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CACxC,IAAa;IAEb,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9C,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,GACvE,IAA+B,CAAA;IACjC,IACE,OAAO,KAAK,CAAC;QACb,OAAO,QAAQ,KAAK,QAAQ;QAC5B,QAAQ,KAAK,EAAE;QACf,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,QAAQ,KAAK,QAAQ;QAC5B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAClC,OAAO,MAAM,KAAK,SAAS;QAC3B,CAAC,mBAAmB,KAAK,SAAS;YAChC,OAAO,mBAAmB,KAAK,QAAQ,CAAC,EAC1C,CAAC;QACD,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,OAAO;QACL,OAAO,EAAE,CAAC;QACV,QAAQ;QACR,GAAG,CAAC,mBAAmB,KAAK,SAAS,IAAI,EAAE,mBAAmB,EAAE,CAAC;QACjE,KAAK;QACL,QAAQ;QACR,MAAM;KACP,CAAA;AACH,CAAC"}

package/dist/writers/index.d.ts

@@ -1,17 +0,0 @@
-/*!
- * Copyright (c) 2026 Interop Alliance. All rights reserved.
- */
-/**
- * The writer roster: the `registered-writers` collection's entry shape, its
- * resource id, the storage seam and WAS adapter, lazy registration with the
- * throttled liveness touch, the sweep-on-read with two-phase expiry, and the
- * join a history view resolves a revision's `writerId` through. Every field
- * is advisory display data, and none is an input to any decision.
- */
-export { REGISTERED_WRITER_ID_LABEL, REGISTERED_WRITER_POLICY, parseRegisteredWriterEntry, registeredWriterPolicy, registeredWriterResourceId } from './entry.js';
-export type { RegisteredWriterEntry, RegisteredWriterPolicy } from './entry.js';
-export { wasRegisteredWritersStore } from './store.js';
-export type { RegisteredWritersStore, StoredRegisteredWriter } from './store.js';
-export { registerWriterOnSecondSession, renameRegisteredWriter, resolveRegisteredWriter, sweepRegisteredWriters } from './roster.js';
-export type { RegisteredWritersSweep, ResolvedWriter, WriterRegistrationOutcome, WriterFirstSeenRecord, WriterFirstSeenStore } from './roster.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/writers/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/writers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;GAMG;AACH,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,EAC3B,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAC/E,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAA;AACtD,YAAY,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAChF,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,aAAa,CAAA;AACpB,YAAY,EACV,sBAAsB,EACtB,cAAc,EACd,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,aAAa,CAAA"}

package/dist/writers/index.js

@@ -1,14 +0,0 @@
-/*!
- * Copyright (c) 2026 Interop Alliance. All rights reserved.
- */
-/**
- * The writer roster: the `registered-writers` collection's entry shape, its
- * resource id, the storage seam and WAS adapter, lazy registration with the
- * throttled liveness touch, the sweep-on-read with two-phase expiry, and the
- * join a history view resolves a revision's `writerId` through. Every field
- * is advisory display data, and none is an input to any decision.
- */
-export { REGISTERED_WRITER_ID_LABEL, REGISTERED_WRITER_POLICY, parseRegisteredWriterEntry, registeredWriterPolicy, registeredWriterResourceId } from './entry.js';
-export { wasRegisteredWritersStore } from './store.js';
-export { registerWriterOnSecondSession, renameRegisteredWriter, resolveRegisteredWriter, sweepRegisteredWriters } from './roster.js';
-//# sourceMappingURL=index.js.map

package/dist/writers/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/writers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;GAMG;AACH,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,EAC3B,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAA;AAEtD,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,aAAa,CAAA"}

package/dist/writers/roster.d.ts

@@ -1,152 +0,0 @@
-import type { RegisteredWriterEntry, RegisteredWriterPolicy } from './entry.js';
-import type { RegisteredWritersStore } from './store.js';
-/**
- * The writer first-seen record, kept client-local: the account and
- * `writerId` this client's writer first appeared under, and when it last
- * touched its roster entry. One slot, so a writer that moves to another
- * account starts over.
- */
-export interface WriterFirstSeenRecord {
-    accountDid: string;
-    writerId: string;
-    /**
-     * ISO 8601 UTC start of the session the record was written in.
-     */
-    firstSessionAt: string;
-    /**
-     * ISO 8601 UTC time of the latest successful registration or touch.
-     */
-    lastTouchedAt?: string;
-}
-/**
- * The client-local seam for the writer first-seen record. Where it lives is
- * the wallet's choice. A forget of this client's local state clears it along with
- * the `writerId`.
- */
-export interface WriterFirstSeenStore {
-    get(): Promise<unknown>;
-    put(record: WriterFirstSeenRecord): Promise<void>;
-}
-/**
- * What {@link registerWriterOnSecondSession} did.
- *
- * - `deferred` -- the writer has not yet been encountered in a second session
- *   under this account; the first-seen record is (re)written and the roster
- *   is untouched.
- * - `fresh` -- the latest touch is within the touch interval; no I/O.
- * - `registered` -- a new entry was written (or a malformed one replaced).
- * - `touched` -- the existing entry's `lastSeen` was advanced.
- * - `raced` -- every attempt lost a conditional write; the next call retries.
- */
-export type WriterRegistrationOutcome = 'deferred' | 'fresh' | 'registered' | 'touched' | 'raced';
-/**
- * Registers this client's writer in the roster once it is encountered in a
- * second session under the account, and touches its `lastSeen` at most once
- * per touch interval after that. Call it on the wallet's connect or sync path;
- * calls within the interval cost no I/O.
- *
- * A new entry takes `label`. A touch keeps the stored label, so a rename
- * stands, and refreshes `signingKeyMultibase` when one is given. Registering
- * a new entry first makes room under the entry cap, deleting the
- * oldest-`lastSeen` entries.
- *
- * @param options {object}
- * @param options.store {RegisteredWritersStore}
- * @param options.local {WriterFirstSeenStore}
- * @param options.accountDid {string}   the account whose Space holds the roster
- * @param options.writerId {string}   this client's writer
- * @param options.label {string}   the coarse platform self-description a new
- *   entry takes
- * @param options.sessionStartedAt {Date}   when the current session began; a
- *   first-seen record written at or after it is this session's own
- * @param [options.signingKeyMultibase] {string}   an enrolled wallet client's
- *   own signing-key multibase
- * @param [options.now] {Date}
- * @param [options.policy] {Partial<RegisteredWriterPolicy>}
- * @returns {Promise<WriterRegistrationOutcome>}
- */
-export declare function registerWriterOnSecondSession({ store, local, accountDid, writerId, label, sessionStartedAt, signingKeyMultibase, now, policy }: {
-    store: RegisteredWritersStore;
-    local: WriterFirstSeenStore;
-    accountDid: string;
-    writerId: string;
-    label: string;
-    sessionStartedAt: Date;
-    signingKeyMultibase?: string;
-    now?: Date;
-    policy?: Partial<RegisteredWriterPolicy>;
-}): Promise<WriterRegistrationOutcome>;
-/**
- * Renames this client's writer. The rename lands only on a registered entry;
- * before registration there is nothing to rename, and the call returns
- * `false`.
- *
- * @param options {object}
- * @param options.store {RegisteredWritersStore}
- * @param options.accountDid {string}
- * @param options.writerId {string}
- * @param options.label {string}   the new label; blank is refused
- * @returns {Promise<boolean>}   whether an entry was renamed
- */
-export declare function renameRegisteredWriter({ store, accountDid, writerId, label }: {
-    store: RegisteredWritersStore;
-    accountDid: string;
-    writerId: string;
-    label: string;
-}): Promise<boolean>;
-/**
- * The outcome of a sweep: the entries left standing, and what it changed.
- */
-export interface RegisteredWritersSweep {
-    entries: RegisteredWriterEntry[];
-    markedInactive: string[];
-    deleted: string[];
-}
-/**
- * Reads the roster and sweeps it: the sweep-on-read every history view runs.
- * Safe to run from any replica, and concurrently.
- *
- * @param options {object}
- * @param options.store {RegisteredWritersStore}
- * @param options.accountDid {string}   the account whose Space holds the roster
- * @param [options.now] {Date}
- * @param [options.policy] {Partial<RegisteredWriterPolicy>}
- * @returns {Promise<RegisteredWritersSweep>}
- */
-export declare function sweepRegisteredWriters({ store, accountDid, now, policy }: {
-    store: RegisteredWritersStore;
-    accountDid: string;
-    now?: Date;
-    policy?: Partial<RegisteredWriterPolicy>;
-}): Promise<RegisteredWritersSweep>;
-/**
- * How a history view renders one revision's writer. `undefined` from
- * {@link resolveRegisteredWriter} means no entry: the view renders its
- * fallback label ("another session").
- */
-export interface ResolvedWriter {
-    label: string;
-    active: boolean;
-    /**
-     * Present only when the entry's `signingKeyMultibase` is an enrolled
-     * client's key in the verified account document. The view may then link
-     * the revision to that client's row. Absent, the label stands unlinked.
-     */
-    clientSigningKeyMultibase?: string;
-}
-/**
- * Resolves a revision's `writerId` against the swept roster.
- *
- * @param options {object}
- * @param options.writerId {string}
- * @param options.entries {RegisteredWriterEntry[]}   a sweep's `entries`
- * @param options.enrolledSigningKeys {ReadonlySet<string>}   the signing-key
- *   multibases of the enrolled clients in the verified account document
- * @returns {ResolvedWriter | undefined}
- */
-export declare function resolveRegisteredWriter({ writerId, entries, enrolledSigningKeys }: {
-    writerId: string;
-    entries: RegisteredWriterEntry[];
-    enrolledSigningKeys: ReadonlySet<string>;
-}): ResolvedWriter | undefined;
-//# sourceMappingURL=roster.d.ts.map

package/dist/writers/roster.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"roster.d.ts","sourceRoot":"","sources":["../../src/writers/roster.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAC/E,OAAO,KAAK,EAAE,sBAAsB,EAA0B,MAAM,YAAY,CAAA;AAEhF;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAA;IACtB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IACvB,GAAG,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAClD;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,yBAAyB,GACnC,UAAU,GAAG,OAAO,GAAG,YAAY,GAAG,SAAS,GAAG,OAAO,CAAA;AAyI3D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,6BAA6B,CAAC,EAClD,KAAK,EACL,KAAK,EACL,UAAU,EACV,QAAQ,EACR,KAAK,EACL,gBAAgB,EAChB,mBAAmB,EACnB,GAAgB,EAChB,MAAM,EACP,EAAE;IACD,KAAK,EAAE,sBAAsB,CAAA;IAC7B,KAAK,EAAE,oBAAoB,CAAA;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,gBAAgB,EAAE,IAAI,CAAA;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,GAAG,CAAC,EAAE,IAAI,CAAA;IACV,MAAM,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAA;CACzC,GAAG,OAAO,CAAC,yBAAyB,CAAC,CA0ErC;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,sBAAsB,CAAC,EAC3C,KAAK,EACL,UAAU,EACV,QAAQ,EACR,KAAK,EACN,EAAE;IACD,KAAK,EAAE,sBAAsB,CAAA;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;CACd,GAAG,OAAO,CAAC,OAAO,CAAC,CAoBnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,qBAAqB,EAAE,CAAA;IAChC,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAiGD;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAAC,EAC3C,KAAK,EACL,UAAU,EACV,GAAgB,EAChB,MAAM,EACP,EAAE;IACD,KAAK,EAAE,sBAAsB,CAAA;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,GAAG,CAAC,EAAE,IAAI,CAAA;IACV,MAAM,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAA;CACzC,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAUlC;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,OAAO,CAAA;IACf;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAA;CACnC;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,QAAQ,EACR,OAAO,EACP,mBAAmB,EACpB,EAAE;IACD,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,qBAAqB,EAAE,CAAA;IAChC,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CACzC,GAAG,cAAc,GAAG,SAAS,CAa7B"}