@plane31/blind-relay 0.0.0-stage → 0.1.1

package/dist/store.d.ts

@@ -0,0 +1,357 @@
+/**
+ * Durable state (protocol section 11): the store interface the profile implements, the secret
+ * store, the logical tables, and an in-memory implementation with the same transaction semantics
+ * for Node tests.
+ *
+ * Rules the interface carries: one writer across every execution context; a transaction is
+ * atomic; the callback finishes synchronously, so the lock is never held across a suspension
+ * of the caller; the callback may initiate a transport send before commit through `tx.handoff`,
+ * and must not await it inside; a writer that cannot acquire the lock gets `LOCKED`.
+ */
+import type { RecordKind } from "./codec.js";
+export interface SecretStore {
+    get(name: SecretName): Promise<Uint8Array | undefined>;
+    set(name: SecretName, value: Uint8Array): Promise<void>;
+    delete(name: SecretName): Promise<void>;
+}
+export type SecretName = "accountSeed" | "deviceSeed" | "recoveryKey" | "storageKey" | "instanceId" | "pendingReset";
+export type StoreState = "INITIALIZING" | "ACTIVE" | "ACTIVATION_PENDING" | "RETIRED";
+export interface MetaRow {
+    schema: 1;
+    /** Set once the history index holds every history row; a store from before the index is backfilled on open. */
+    historyIndex?: 1;
+    /** Set once the newest slots are built from history; a store from before the slot table is rebuilt on open. */
+    newest?: 1;
+    instanceId: string;
+    accountName: string;
+    identityId: string;
+    certificateHash: string;
+    state: StoreState;
+}
+export interface SelfRow {
+    generation: string;
+    deviceId: string;
+    certificate: string;
+    certificateHash: string;
+    streamId: string;
+}
+export interface PinRow {
+    accountName: string;
+    accountKey: string;
+    identityId: string;
+    generation: string;
+    certificateHash: string;
+    certificate: string;
+    deviceId: string;
+    signingKey: string;
+    boxKey: string;
+    streamId: string;
+    deviceIds: string[];
+}
+export interface CertificateRow {
+    identityId: string;
+    certificateHash: string;
+    signingKey: string;
+    boxKey: string;
+    streamId: string;
+    generation: string;
+    wire: string;
+    current: boolean;
+}
+export interface QuarantineRow {
+    accountName: string;
+    certificate: string;
+    reason: string;
+    at: string;
+}
+export interface CircleRow {
+    circleId: string;
+    ownerIdentityId: string;
+    revision: string;
+    bodyHash: string | undefined;
+    snapshot: string | undefined;
+    members: string[];
+    enabled: boolean;
+    status: "requested" | "member" | "left" | "quarantined" | "closed";
+    verifiedAt: string;
+    /** An owner's successor snapshot awaiting host confirmation (T8). */
+    pending?: {
+        snapshot: string;
+        revision: string;
+        close?: boolean;
+    } | undefined;
+}
+export interface RevisionRow {
+    desiredRevision: string;
+    seenSnapshots: Record<string, string>;
+    seenCertificates: Record<string, string>;
+    paused: "rotation" | "metadata" | "limit" | "sync" | undefined;
+}
+export interface VaultRow {
+    revision: string;
+    hash: string;
+    wire: string;
+    /** Prepared but not yet confirmed by the host. */
+    pending: boolean;
+    /** The circle rows changed since this vault was derived from them; set in the same transaction. */
+    dirty: boolean;
+}
+export type EpochStatus = "prepared" | "committed" | "active" | "obsolete" | "retired";
+export interface EpochRow {
+    epoch: number;
+    status: EpochStatus;
+    manifest: string;
+    manifestHash: string;
+    wraps: Record<string, string>;
+    epochKey: string;
+    capturedRevision: string;
+    audienceKey: string;
+    createdAt: string;
+    nextCounter: number;
+    lastSentAt: string | undefined;
+}
+export interface StreamRow {
+    highestCommittedEpoch: number;
+    activeEpoch: number | undefined;
+    pendingEpoch: number | undefined;
+}
+export type OutboxStatus = "queued" | "inflight" | "accepted" | "cancelled" | "unknown";
+export interface OutboxRow {
+    recordId: string;
+    wire: string;
+    epoch: number;
+    counter: number;
+    kind: RecordKind;
+    sentAt: string;
+    desiredRevision: string;
+    status: OutboxStatus;
+    attempts: number;
+    reason: string | undefined;
+}
+export interface HistoryRow {
+    recordId: string;
+    authorIdentityId: string;
+    streamId: string;
+    generation: string;
+    epoch: number;
+    counter: number;
+    kind: RecordKind;
+    sentAt: string;
+    receivedAt: string;
+    plaintext: string;
+    superseded: boolean;
+    own: boolean;
+    /** Body hash of the wire, for duplicate and equivocation detection. */
+    bodyHash?: string;
+    /** The envelope's event time, when the sender gave one. */
+    eventTime?: string;
+}
+/**
+ * The newest record per author and kind (for kinds declared `newest`), keyed `<author>:<kind>`.
+ * The order fields decide replacement; the payload is dropped at expiry while the row keeps its
+ * order, so an older record replayed later cannot become current.
+ */
+export interface NewestRow {
+    recordId: string;
+    bodyHash: string;
+    generation: string;
+    epoch: number;
+    counter: number;
+    sentAt: string;
+    receivedAt: string;
+    /** The event time the slot was ordered by, never later than `sentAt`. */
+    eventTime: string;
+    /** Hex, possibly empty; `null` once expired. */
+    payload: string | null;
+}
+export interface ReaderEpochRow {
+    streamId: string;
+    epoch: number;
+    epochKey: string;
+    manifestHash: string;
+    authorCertificateHash: string;
+    superseded: boolean;
+}
+export interface SubscriptionRow {
+    streamId: string;
+    authorIdentityId: string;
+    /** Local scan position: the last sequence examined. */
+    scanPos: string;
+    /** The eligible acknowledged prefix. */
+    ackPrefix: string;
+    /** The last cursor the relay confirmed. */
+    committedCursor: string;
+    /** A send in flight for this stream. */
+    ackInFlight: boolean;
+}
+export interface UnresolvedRow {
+    streamId: string;
+    deliverySeq: string;
+    reason: "KEY_PENDING";
+    epoch: number;
+    recordedAt: string;
+}
+export interface ActivationRow {
+    certificate: string;
+    vault: string;
+    vaultRevision: string;
+    expectedCertificateHash: string;
+    expectedVaultRevision: string;
+    expectedVaultHash: string;
+}
+export interface ResetListRow {
+    wire: string;
+    version: string;
+    hash: string;
+    checkedAt: string;
+}
+export interface ResetReceiptRow {
+    accountName: string;
+    oldIdentityId: string;
+    newIdentityId: string;
+    receiptHash: string;
+}
+export interface ClockRow {
+    highWater: string;
+}
+/** A last-resort reset prepared and persisted before it is sent, so a lost response can be resumed. */
+export interface PendingResetRow {
+    resetId: string;
+    oldIdentityId: string;
+    certificate: string;
+    vault: string;
+    vaultHash: string;
+}
+/**
+ * One entry of the history index. Two keys point at every history row: `t:<kind>:<tuple>` for the
+ * timeline and `a:<author>:<kind>:<tuple>` for one author, where the tuple is the zero-padded
+ * `sentAt`, epoch and counter followed by the record id, so keys sort by time and never collide.
+ */
+export interface HistoryIndexRow {
+    recordId: string;
+}
+/** A caller's idempotency key and the record it produced, kept for the delivery window. */
+export interface EnqueueKeyRow {
+    recordId: string;
+    epoch: number;
+    counter: number;
+    sentAt: string;
+}
+export interface Tables {
+    meta: MetaRow;
+    self: SelfRow;
+    pins: PinRow;
+    certificates: CertificateRow;
+    quarantine: QuarantineRow;
+    circles: CircleRow;
+    revision: RevisionRow;
+    vault: VaultRow;
+    epochs: EpochRow;
+    stream: StreamRow;
+    outbox: OutboxRow;
+    history: HistoryRow;
+    historyIndex: HistoryIndexRow;
+    enqueueKeys: EnqueueKeyRow;
+    newest: NewestRow;
+    readerEpochs: ReaderEpochRow;
+    subscriptions: SubscriptionRow;
+    unresolved: UnresolvedRow;
+    activation: ActivationRow;
+    resetList: ResetListRow;
+    resetReceipts: ResetReceiptRow;
+    retiredIdentities: {
+        identityId: string;
+    };
+    clock: ClockRow;
+    pendingReset: PendingResetRow;
+}
+export type TableName = keyof Tables;
+/** Bounds for `Tx.range`: every given bound applies; an absent one is open. */
+export interface KeyRange {
+    readonly prefix?: string;
+    /** Inclusive lower bound. */
+    readonly gte?: string;
+    /** Exclusive lower bound. */
+    readonly gt?: string;
+    /** Exclusive upper bound. */
+    readonly lt?: string;
+    /** Inclusive upper bound. */
+    readonly lte?: string;
+    /** Descending key order when true. */
+    readonly reverse?: boolean;
+    readonly limit?: number;
+}
+/** Whether a key satisfies the bounds of a range (not its limit or order); shared by the stores. */
+export declare function inKeyRange(key: string, q: KeyRange): boolean;
+export interface Tx {
+    get<T extends TableName>(table: T, key: string): Tables[T] | undefined;
+    put<T extends TableName>(table: T, key: string, row: Tables[T]): void;
+    delete<T extends TableName>(table: T, key: string): void;
+    list<T extends TableName>(table: T, prefix?: string): readonly [string, Tables[T]][];
+    /**
+     * A bounded slice of a table in key order: the rows under `prefix` whose keys fall inside the
+     * bounds, ascending or descending, at most `limit` of them. The store serves it without reading
+     * the rest of the table.
+     */
+    range<T extends TableName>(table: T, q: KeyRange): readonly [string, Tables[T]][];
+    count(table: TableName): number;
+    /**
+     * Initiate a network operation inside this transaction (T6h). The call starts now, before
+     * commit; the returned promise is awaited by the caller after the transaction returns.
+     */
+    handoff<R>(start: () => Promise<R>): Promise<R>;
+}
+export interface Store {
+    /**
+     * BEGIN IMMEDIATE semantics: exclusive, atomic, serialised across every context. The callback
+     * runs to completion synchronously between begin and commit; a callback that returns a promise
+     * is refused with `STORAGE_FAILURE` and nothing is written. The one asynchronous thing a
+     * callback may do is start a network operation through `tx.handoff`.
+     */
+    transaction<R>(fn: (tx: Tx) => R): Promise<R>;
+    /** A consistent read without taking the writer lock. */
+    read<R>(fn: (tx: Omit<Tx, "put" | "delete" | "handoff">) => R): Promise<R>;
+}
+/**
+ * Run a transaction callback and refuse one that returns a promise. Shared by every `Store`
+ * implementation so the refusal is the same error everywhere.
+ */
+export declare function invokeSync<R>(fn: (tx: Tx) => R, tx: Tx): R;
+type TableMap = Map<TableName, Map<string, unknown>>;
+/** Crash injection for tests: throw at a chosen point. */
+export interface MemoryStoreOptions {
+    /** Called just before a transaction commits; throwing simulates a crash before durability. */
+    beforeCommit?: (count: number) => void;
+}
+interface Shared {
+    tables: TableMap;
+    chain: Promise<void>;
+    held: boolean;
+    commits: number;
+}
+export declare class MemoryStore implements Store {
+    private readonly options;
+    private readonly shared;
+    /** Every handoff started inside a committed transaction, for tests that wait for the network. */
+    readonly handoffs: Promise<unknown>[];
+    constructor(options?: MemoryStoreOptions, shared?: Shared);
+    transaction<R>(fn: (tx: Tx) => R): Promise<R>;
+    read<R>(fn: (tx: Omit<Tx, "put" | "delete" | "handoff">) => R): Promise<R>;
+    /** One writer at a time across every handle on the same tables, like SQLite's file lock. */
+    private acquire;
+    /** A second handle on the same tables and lock, as another execution context would have. */
+    fork(): MemoryStore;
+    get isHeld(): boolean;
+    get commitCount(): number;
+    snapshot(): Record<string, Record<string, unknown>>;
+}
+export declare class MemorySecretStore implements SecretStore {
+    private readonly items;
+    /** Test hook: throw on the next write to simulate a crash between the two stores. */
+    failNextWrite: boolean;
+    get(name: SecretName): Promise<Uint8Array | undefined>;
+    set(name: SecretName, value: Uint8Array): Promise<void>;
+    delete(name: SecretName): Promise<void>;
+}
+export {};
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

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

package/dist/store.js

@@ -0,0 +1,192 @@
+import { KavachError } from "./errors.js";
+/** Whether a key satisfies the bounds of a range (not its limit or order); shared by the stores. */
+export function inKeyRange(key, q) {
+    if (q.prefix !== undefined && !key.startsWith(q.prefix))
+        return false;
+    if (q.gte !== undefined && key < q.gte)
+        return false;
+    if (q.gt !== undefined && key <= q.gt)
+        return false;
+    if (q.lt !== undefined && key >= q.lt)
+        return false;
+    if (q.lte !== undefined && key > q.lte)
+        return false;
+    return true;
+}
+// In-memory implementation -----------------------------------------------------------------------
+/**
+ * Run a transaction callback and refuse one that returns a promise. Shared by every `Store`
+ * implementation so the refusal is the same error everywhere.
+ */
+export function invokeSync(fn, tx) {
+    const result = fn(tx);
+    if (isThenable(result))
+        throw new KavachError("STORAGE_FAILURE", "store", "transaction callbacks are synchronous");
+    return result;
+}
+function isThenable(value) {
+    return (typeof value === "object" || typeof value === "function") && value !== null && typeof value.then === "function";
+}
+function cloneRow(row) {
+    return JSON.parse(JSON.stringify(row));
+}
+class MemoryTx {
+    base;
+    readOnly;
+    journal = new Map();
+    handoffs = [];
+    constructor(base, readOnly) {
+        this.base = base;
+        this.readOnly = readOnly;
+    }
+    tableJournal(table) {
+        let j = this.journal.get(table);
+        if (!j) {
+            j = new Map();
+            this.journal.set(table, j);
+        }
+        return j;
+    }
+    get(table, key) {
+        const j = this.journal.get(table);
+        if (j && j.has(key)) {
+            const v = j.get(key);
+            return v === null ? undefined : cloneRow(v);
+        }
+        const v = this.base.get(table)?.get(key);
+        return v === undefined ? undefined : cloneRow(v);
+    }
+    put(table, key, row) {
+        if (this.readOnly)
+            throw new KavachError("STORAGE_FAILURE", "store", "write in a read transaction");
+        this.tableJournal(table).set(key, cloneRow(row));
+    }
+    delete(table, key) {
+        if (this.readOnly)
+            throw new KavachError("STORAGE_FAILURE", "store", "write in a read transaction");
+        this.tableJournal(table).set(key, null);
+    }
+    list(table, prefix = "") {
+        const merged = new Map(this.base.get(table) ?? []);
+        for (const [k, v] of this.journal.get(table) ?? []) {
+            if (v === null)
+                merged.delete(k);
+            else
+                merged.set(k, v);
+        }
+        return [...merged.entries()]
+            .filter(([k]) => k.startsWith(prefix))
+            .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
+            .map(([k, v]) => [k, cloneRow(v)]);
+    }
+    range(table, q) {
+        const rows = this.list(table, q.prefix).filter(([k]) => inKeyRange(k, q));
+        if (q.reverse)
+            rows.reverse();
+        return q.limit === undefined ? rows : rows.slice(0, Math.max(0, q.limit));
+    }
+    count(table) {
+        return this.list(table).length;
+    }
+    handoff(start) {
+        if (this.readOnly)
+            throw new KavachError("STORAGE_FAILURE", "store", "handoff in a read transaction");
+        const p = start();
+        this.handoffs.push(p.catch(() => undefined));
+        return p;
+    }
+    commitInto(base) {
+        for (const [table, j] of this.journal) {
+            let t = base.get(table);
+            if (!t) {
+                t = new Map();
+                base.set(table, t);
+            }
+            for (const [k, v] of j) {
+                if (v === null)
+                    t.delete(k);
+                else
+                    t.set(k, v);
+            }
+        }
+    }
+}
+export class MemoryStore {
+    options;
+    shared;
+    /** Every handoff started inside a committed transaction, for tests that wait for the network. */
+    handoffs = [];
+    constructor(options = {}, shared) {
+        this.options = options;
+        this.shared = shared ?? { tables: new Map(), chain: Promise.resolve(), held: false, commits: 0 };
+    }
+    async transaction(fn) {
+        const release = await this.acquire();
+        try {
+            const tx = new MemoryTx(this.shared.tables, false);
+            const result = invokeSync(fn, tx);
+            this.options.beforeCommit?.(this.shared.commits + 1);
+            tx.commitInto(this.shared.tables);
+            this.shared.commits++;
+            this.handoffs.push(...tx.handoffs);
+            return result;
+        }
+        finally {
+            release();
+        }
+    }
+    async read(fn) {
+        return fn(new MemoryTx(this.shared.tables, true));
+    }
+    /** One writer at a time across every handle on the same tables, like SQLite's file lock. */
+    acquire() {
+        const previous = this.shared.chain;
+        let release = () => undefined;
+        this.shared.chain = new Promise((resolve) => {
+            release = () => {
+                this.shared.held = false;
+                resolve();
+            };
+        });
+        return previous.then(() => {
+            this.shared.held = true;
+            return release;
+        });
+    }
+    /** A second handle on the same tables and lock, as another execution context would have. */
+    fork() {
+        return new MemoryStore(this.options, this.shared);
+    }
+    get isHeld() {
+        return this.shared.held;
+    }
+    get commitCount() {
+        return this.shared.commits;
+    }
+    snapshot() {
+        const out = {};
+        for (const [t, m] of this.shared.tables)
+            out[t] = Object.fromEntries([...m.entries()].map(([k, v]) => [k, cloneRow(v)]));
+        return out;
+    }
+}
+export class MemorySecretStore {
+    items = new Map();
+    /** Test hook: throw on the next write to simulate a crash between the two stores. */
+    failNextWrite = false;
+    async get(name) {
+        const v = this.items.get(name);
+        return v ? Uint8Array.from(v) : undefined;
+    }
+    async set(name, value) {
+        if (this.failNextWrite) {
+            this.failNextWrite = false;
+            throw new KavachError("STORAGE_FAILURE", "secretStore", "simulated crash");
+        }
+        this.items.set(name, Uint8Array.from(value));
+    }
+    async delete(name) {
+        this.items.delete(name);
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/testing/clock.d.ts

@@ -0,0 +1,14 @@
+import type { RetentionPolicy } from "../policy.js";
+/**
+ * A retention policy for tests. Three kinds: 0 is kept a day in history with a newest slot
+ * (a position); 1 is kept thirty days in history with no slot, every one news (an event); 2 is a
+ * one-day slot only, latest wins while queued (a state).
+ */
+export declare const testPolicy: RetentionPolicy;
+/** A controllable clock. */
+export declare class TestClock {
+    t: bigint;
+    now: () => bigint;
+    advance(ms: bigint): void;
+}
+//# sourceMappingURL=clock.d.ts.map

package/dist/testing/clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../../src/testing/clock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,eAYxB,CAAC;AAEF,4BAA4B;AAC5B,qBAAa,SAAS;IACpB,CAAC,SAAsB;IACvB,GAAG,QAAO,MAAM,CAAW;IAC3B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAG1B"}

package/dist/testing/clock.js

@@ -0,0 +1,27 @@
+/**
+ * A retention policy for tests. Three kinds: 0 is kept a day in history with a newest slot
+ * (a position); 1 is kept thirty days in history with no slot, every one news (an event); 2 is a
+ * one-day slot only, latest wins while queued (a state).
+ */
+export const testPolicy = {
+    version: 1,
+    deliveryWindowMs: 86400000n,
+    appendRetryWindowMs: 604800000n,
+    hygieneRotationMs: 2592000000n,
+    maxOutboxRecords: 2000,
+    maxOutboxBytes: 4 << 20,
+    kinds: [
+        { kind: 0, retentionMs: 86400000n, queue: "keepAll", history: true, newest: true, headerClass: 0 },
+        { kind: 1, retentionMs: 2592000000n, queue: "keepAll", history: true, newest: false, headerClass: 1 },
+        { kind: 2, retentionMs: 86400000n, queue: "latestWins", history: false, newest: true, headerClass: 2 }
+    ]
+};
+/** A controllable clock. */
+export class TestClock {
+    t = 1700000000000n;
+    now = () => this.t;
+    advance(ms) {
+        this.t += ms;
+    }
+}
+//# sourceMappingURL=clock.js.map

package/dist/testing/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.js","sourceRoot":"","sources":["../../src/testing/clock.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAoB;IACzC,OAAO,EAAE,CAAC;IACV,gBAAgB,EAAE,SAAW;IAC7B,mBAAmB,EAAE,UAAY;IACjC,iBAAiB,EAAE,WAAc;IACjC,gBAAgB,EAAE,IAAI;IACtB,cAAc,EAAE,CAAC,IAAI,EAAE;IACvB,KAAK,EAAE;QACL,EAAE,IAAI,EAAE,CAAC,EAAE,WAAW,EAAE,SAAW,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE;QACpG,EAAE,IAAI,EAAE,CAAC,EAAE,WAAW,EAAE,WAAc,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,EAAE;QACxG,EAAE,IAAI,EAAE,CAAC,EAAE,WAAW,EAAE,SAAW,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE;KACzG;CACF,CAAC;AAEF,4BAA4B;AAC5B,MAAM,OAAO,SAAS;IACpB,CAAC,GAAG,cAAkB,CAAC;IACvB,GAAG,GAAG,GAAW,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3B,OAAO,CAAC,EAAU;QAChB,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IACf,CAAC;CACF"}