@mdbase-dev/sdk 0.0.0-stage → 0.1.0-beta.149

package/dist/thin-client.js

@@ -0,0 +1,42 @@
+/**
+ * @mdbase-dev/sdk/thin-client: the replica thin client for consumers that bring
+ * their own connection, such as an Obsidian-plugin-style integration: codec,
+ * client, records, files, presence, Noise and relay transports, keys, status and
+ * collection availability. It is held to the thin-client size ceiling
+ * (scripts/size.mjs) and never bundles manifest validation.
+ *
+ * The root entry re-exports all of this and adds the application entry
+ * (`MdbaseConnect`), people, timers, notifications, holds, `describeError`,
+ * `WasmRuntime` and `inProcessConnector`.
+ */
+export * from "./cbor.js";
+export { SchemaError } from "./codec.js";
+export * from "./errors.js";
+export * as wire from "./wire.js";
+export { DESCRIBE_TYPING_MAX_PATHS, DESCRIBE_TYPING_MAX_TYPES, TEMPORAL_HINTS } from "./wire.js";
+export { connect, LiveQuery, MdbaseClient, Write } from "./client.js";
+export { readMany, queryPages, resolveRecordLinks, READ_MANY_MAX_REFS, READ_MANY_MAX_CONCURRENCY } from "./read-helpers.js";
+export { createViewSource, updateViewSource, readViewSourceRecord } from "./view-sources.js";
+export { FilesApi, MAX_CONVENIENCE_BYTES } from "./files.js";
+export { fileGrant } from "./files.js";
+export { PresenceApi } from "./presence.js";
+export { Session, API_VERSIONS } from "./session.js";
+export { framedPort, portPair, RecordReader } from "./transport/port.js";
+export { diffEdits, revisionOf, toPlain, toValue, uuidv7, valueEquals } from "./values.js";
+export { relayConnector } from "./transport/relay.js";
+export { duplexCarrier, nextRelayConnector, orderTargets } from "./transport/next-relay.js";
+export { noiseConnector, noiseChannel, streamCarrier, webSocketCarrier, SESSION_LIFETIME_MS, } from "./transport/noise-session.js";
+export { clientPrologue, generateKeyPair, IkInitiator, IkResponder, keyPairFromSecret, NoiseError, staticKeyOf, } from "./transport/noise.js";
+export { localLinkConnector, localLinkFirstPayload } from "./transport/local-link.js";
+export { indexedDbKeyStorage, loadOrCreateClientKey, memoryKeyStorage } from "./keys.js";
+export { ACCOUNT_KEY_STATES, DEVICE_KINDS, formatSas, approvalReadiness } from "./private.js";
+export { isConfirmed, summarizeStatus } from "./status.js";
+export { memoryWriteLedgerStore } from "./write-ledger.js";
+export { pipeCloseError, relayPipeCarrier } from "./transport/relay-pipe.js";
+export { controlRouteResolver, routeFromControl } from "./transport/control-route.js";
+// The account-key (AK1) surface lives at `@mdbase-dev/sdk/account`: it carries Argon2id,
+// Ed25519 and the strength meter, which the thin client does not need.
+export { COLLECTION_UNAVAILABLE_REASONS, collectionUnavailableError, isCollectionUnavailableReason, parseCollectionAvailability, } from "./collection-availability.js";
+// Grants for Private collections (OAuth PKCE + a client Noise key) live at
+// `@mdbase-dev/sdk/app-grant`, kept out of this entry.
+//# sourceMappingURL=thin-client.js.map

package/dist/thin-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thin-client.js","sourceRoot":"","sources":["../src/thin-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC,cAAc,aAAa,CAAC;AAC5B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AA+CjG,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAmBtE,OAAO,EAAC,QAAQ,EAAE,UAAU,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,yBAAyB,EAAC,MAAM,mBAAmB,CAAC;AAE1H,OAAO,EAAC,gBAAgB,EAAE,gBAAgB,EAAE,oBAAoB,EAAC,MAAM,mBAAmB,CAAC;AAI3F,OAAO,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAE7D,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAO5C,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEzE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE3F,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAK5F,OAAO,EACL,cAAc,EACd,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AAStC,OAAO,EACL,cAAc,EACd,eAAe,EACf,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGtF,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAEzF,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAE9F,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7E,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEtF,yFAAyF;AACzF,uEAAuE;AACvE,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,6BAA6B,EAC7B,2BAA2B,GAG5B,MAAM,8BAA8B,CAAC;AACtC,2EAA2E;AAC3E,uDAAuD"}

package/dist/timers.d.ts

@@ -0,0 +1,158 @@
+/** Backend-independent, content-free Connect control-plane timers. */
+export interface DesiredTimer {
+    id: string;
+    fireAt: string;
+}
+export interface Timer extends DesiredTimer {
+    criterionId: string;
+    generation: number;
+    status: "scheduled" | "firing" | "fired" | "cancelled";
+    createdAt: string;
+    updatedAt: string;
+    firedAt: string | null;
+}
+export interface TimerRequestOptions {
+    signal?: AbortSignal;
+}
+export interface TimerReconcileInput {
+    namespace: string;
+    criterionId: string;
+    timers: readonly DesiredTimer[];
+}
+export interface TimerList {
+    namespace: string;
+    timers: Timer[];
+    intentRevision?: number;
+}
+/** Caller persists this original identity and desired snapshot BEFORE dispatch. */
+export interface TimerOperationIdentity {
+    namespace: string;
+    operationId: string;
+    expectedRevision: number;
+}
+export interface TimerRecoverableReconcileInput extends TimerReconcileInput, TimerOperationIdentity {
+}
+export interface TimerOperationReceipt extends TimerOperationIdentity {
+    protocolVersion: 1;
+    committedRevision: number;
+    result: TimerReconciliation;
+}
+export type TimerOperationLookup = {
+    outcome: "committed";
+    receipt: TimerOperationReceipt;
+} | {
+    outcome: "unknown";
+    namespace: string;
+    operationId: string;
+};
+export interface TimerReconciliation extends TimerList {
+    cancelledIds: string[];
+}
+export interface TimerCancellation {
+    namespace: string;
+    id: string;
+    cancelled: boolean;
+}
+export interface TimerChannelRegistration {
+    channelId: string;
+    installationId: string;
+    criteria: string[];
+}
+export interface WebPushChannelOptions extends TimerRequestOptions {
+    /** Defaults to `navigator.serviceWorker.ready`. */
+    serviceWorker?: ServiceWorkerRegistration;
+    /** Manifest criterion ids. Defaults to every timer criterion the app declares. */
+    criteria?: string[];
+    installationId?: string;
+}
+export interface FcmChannelOptions extends TimerRequestOptions {
+    /** Native FCM registration token; never logged or retained by this class. */
+    token: string;
+    /** Manifest criterion ids. Defaults to every timer criterion the app declares. */
+    criteria?: string[];
+    installationId?: string;
+}
+/** Port-side channel options: the facade has resolved every default. */
+export type ResolvedWebPushChannelOptions = WebPushChannelOptions & {
+    serviceWorker: ServiceWorkerRegistration;
+};
+export interface TimersApiDefaults {
+    /** The app's declared timer criteria, used when a registration names none. */
+    criteria?: readonly string[];
+}
+/**
+ * A narrow original-app-consent port, supplied by the Connect client or owned
+ * native Worker. Its owner authenticates fixed timer/channel routes, enforces grant lifetime and
+ * bounds response bodies. No bearer, signer, arbitrary URL or request callback.
+ * Writes MUST NOT retry after ambiguous admission. This is not a replica port.
+ */
+export interface AppTimersPort {
+    list(namespace: string, options: TimerRequestOptions): Promise<unknown>;
+    put(namespace: string, id: string, body: {
+        criterion_id: string;
+        fire_at: string;
+    }, options: TimerRequestOptions): Promise<unknown>;
+    cancel(namespace: string, id: string, generation: number | undefined, options: TimerRequestOptions): Promise<unknown>;
+    reconcile(namespace: string, body: {
+        criterion_id: string;
+        timers: {
+            id: string;
+            fire_at: string;
+        }[];
+    }, options: TimerRequestOptions): Promise<unknown>;
+    /** Optional original-operation profile; old ports must refuse, never emulate. */
+    reconcileWithReceipt?(namespace: string, body: {
+        criterion_id: string;
+        timers: {
+            id: string;
+            fire_at: string;
+        }[];
+        recovery: {
+            protocol_version: 1;
+            operation_id: string;
+            expected_revision: number;
+        };
+    }, options: TimerRequestOptions): Promise<unknown>;
+    lookupOperation?(namespace: string, operationId: string, options: TimerRequestOptions): Promise<unknown>;
+    registerWebPush(options: ResolvedWebPushChannelOptions): Promise<TimerChannelRegistration>;
+    unregisterWebPush(serviceWorker: ServiceWorkerRegistration | undefined, options: TimerRequestOptions): Promise<void>;
+    registerFcm(options: FcmChannelOptions): Promise<TimerChannelRegistration & {
+        transport: "fcm";
+    }>;
+    unregisterFcm(options: TimerRequestOptions): Promise<void>;
+    /** Close an owned retained-grant port; never remove persistent channels. */
+    close?(): void;
+}
+/** Opaque timer HTTP API. Works without opening a data-replica/Noise session. */
+export declare class TimersApi {
+    private readonly port;
+    private readonly lifetime;
+    private readonly criteria;
+    constructor(port: AppTimersPort, defaults?: TimersApiDefaults);
+    /** Stops this facade; an uncertain write is never replayed or reported cancelled. */
+    close(): void;
+    private run;
+    list(namespaceId: string, options?: TimerRequestOptions): Promise<TimerList>;
+    put(input: {
+        namespace: string;
+        criterionId: string;
+        timer: DesiredTimer;
+    }, options?: TimerRequestOptions): Promise<Timer>;
+    cancel(input: {
+        namespace: string;
+        id: string;
+        generation?: number;
+    }, options?: TimerRequestOptions): Promise<TimerCancellation>;
+    reconcile(input: TimerReconcileInput, options?: TimerRequestOptions): Promise<TimerReconciliation>;
+    /** No ID generation, journal, automatic replay or consent adoption. */
+    reconcileWithReceipt(input: TimerRecoverableReconcileInput, options?: TimerRequestOptions): Promise<TimerOperationReceipt>;
+    /** Read-only original receipt lookup. Missing is UNKNOWN, never proof of no effect. */
+    lookupOperation(input: TimerOperationIdentity, options?: TimerRequestOptions): Promise<TimerOperationLookup>;
+    /** Subscribe this browser for the app's notifications. Both options are optional. */
+    registerWebPush(options?: WebPushChannelOptions): Promise<TimerChannelRegistration>;
+    unregisterWebPush(serviceWorker?: ServiceWorkerRegistration, options?: TimerRequestOptions): Promise<void>;
+    registerFcm(options: FcmChannelOptions): Promise<TimerChannelRegistration & {
+        transport: "fcm";
+    }>;
+    unregisterFcm(options?: TimerRequestOptions): Promise<void>;
+}

package/dist/timers.js

@@ -0,0 +1,258 @@
+import { isMdbaseError, mdbaseError } from "./errors.js";
+const NS = /^[A-Za-z0-9._-]{1,64}$/;
+const ID = /^[A-Za-z0-9._:-]{1,128}$/;
+const UUID7 = /^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
+const INSTANT = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2}(\.\d+)?)?(Z|[+-]\d{2}:\d{2})$/i;
+const MAX_TIMERS = 10_000;
+const invalid = () => mdbaseError("invalid_request", "Invalid opaque timer request.");
+const badResponse = () => mdbaseError("internal", "Invalid control-plane timer response.", "invalid_timer_response");
+function instant(value) {
+    return typeof value === "string" && INSTANT.test(value) && Number.isFinite(Date.parse(value));
+}
+function namespace(value) { if (typeof value !== "string" || !NS.test(value))
+    throw invalid(); }
+function id(value) { if (typeof value !== "string" || !ID.test(value))
+    throw invalid(); }
+function criterion(value) { if (typeof value !== "string" || !value.length || value.length > 100)
+    throw invalid(); }
+function desired(value) {
+    if (!value || Object.keys(value).some(k => k !== "id" && k !== "fireAt"))
+        throw invalid();
+    id(value.id);
+    if (!instant(value.fireAt))
+        throw invalid();
+    return { id: value.id, fire_at: new Date(value.fireAt).toISOString() };
+}
+function object(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw badResponse();
+    return value;
+}
+function timer(value) {
+    const r = object(value);
+    if (typeof r.id !== "string" || !ID.test(r.id) || typeof r.criterion_id !== "string"
+        || !r.criterion_id.length || r.criterion_id.length > 100 || !instant(r.fire_at)
+        || !Number.isSafeInteger(r.generation) || r.generation < 1
+        || !["scheduled", "firing", "fired", "cancelled"].includes(r.status)
+        || !instant(r.created_at) || !instant(r.updated_at)
+        || (r.fired_at !== null && !instant(r.fired_at)))
+        throw badResponse();
+    // Do not forward server-side optional `data` or arbitrary response properties.
+    return { id: r.id, criterionId: r.criterion_id, fireAt: r.fire_at,
+        generation: r.generation, status: r.status,
+        createdAt: r.created_at, updatedAt: r.updated_at, firedAt: r.fired_at };
+}
+function list(value, expected) {
+    const r = object(value);
+    if (r.namespace !== expected || !Array.isArray(r.timers) || r.timers.length > MAX_TIMERS)
+        throw badResponse();
+    const timers = r.timers.map(timer);
+    if (new Set(timers.map(t => t.id)).size !== timers.length)
+        throw badResponse();
+    if (r.intent_revision !== undefined && (!Number.isSafeInteger(r.intent_revision) || r.intent_revision < 0))
+        throw badResponse();
+    return { namespace: expected, timers, ...(r.intent_revision === undefined ? {} : { intentRevision: r.intent_revision }) };
+}
+function operationIdentity(input) {
+    const { namespace: ns, operationId, expectedRevision } = input;
+    namespace(ns);
+    if (typeof operationId !== "string" || !UUID7.test(operationId) || !Number.isSafeInteger(expectedRevision)
+        || expectedRevision < 0 || expectedRevision === Number.MAX_SAFE_INTEGER)
+        throw invalid();
+    return { namespace: ns, operationId, expectedRevision };
+}
+function reconciliation(value, ns) {
+    const raw = object(value), result = list(raw, ns);
+    if (!Array.isArray(raw.cancelled_ids) || raw.cancelled_ids.length > MAX_TIMERS
+        || raw.cancelled_ids.some(v => typeof v !== "string" || !ID.test(v))
+        || new Set(raw.cancelled_ids).size !== raw.cancelled_ids.length)
+        throw badResponse();
+    return { ...result, cancelledIds: [...raw.cancelled_ids] };
+}
+function receipt(value, identity) {
+    const r = object(value);
+    if (r.protocol_version !== 1 || r.namespace !== identity.namespace || r.operation_id !== identity.operationId
+        || r.expected_revision !== identity.expectedRevision || r.committed_revision !== identity.expectedRevision + 1
+        || Object.keys(r).some(k => !["protocol_version", "namespace", "operation_id", "expected_revision", "committed_revision", "result"].includes(k)))
+        throw badResponse();
+    const rawResult = object(r.result);
+    if (Object.keys(rawResult).some(k => !["namespace", "timers", "cancelled_ids"].includes(k)))
+        throw badResponse();
+    const result = reconciliation(rawResult, identity.namespace);
+    const fields = ["id", "criterion_id", "fire_at", "generation", "status", "created_at", "updated_at", "fired_at"];
+    for (const raw of rawResult.timers)
+        if (Object.keys(object(raw)).some(k => !fields.includes(k)))
+            throw badResponse();
+    if (result.cancelledIds.some(id => result.timers.some(t => t.id === id)))
+        throw badResponse();
+    return { protocolVersion: 1, ...identity, committedRevision: r.committed_revision, result };
+}
+async function readyServiceWorker(signal) {
+    const container = globalThis.navigator?.serviceWorker;
+    if (!container)
+        throw mdbaseError("invalid_request", "Web Push needs a service worker.", "timer_push_platform");
+    // `ready` never rejects: it waits until a service worker is active.
+    return await new Promise((resolve, reject) => {
+        const abort = () => reject(mdbaseError("cancelled", "Timer request cancelled before dispatch."));
+        if (signal?.aborted)
+            return abort();
+        signal?.addEventListener("abort", abort, { once: true });
+        container.ready.then(resolve, reject).finally(() => signal?.removeEventListener("abort", abort));
+    });
+}
+/** Opaque timer HTTP API. Works without opening a data-replica/Noise session. */
+export class TimersApi {
+    port;
+    lifetime = new AbortController();
+    criteria;
+    constructor(port, defaults = {}) {
+        this.port = port;
+        this.criteria = defaults.criteria?.length ? [...defaults.criteria] : undefined;
+    }
+    /** Stops this facade; an uncertain write is never replayed or reported cancelled. */
+    close() {
+        if (this.lifetime.signal.aborted)
+            return;
+        this.lifetime.abort();
+        this.port.close?.();
+    }
+    async run(options, write, f) {
+        const signal = options.signal ? AbortSignal.any([this.lifetime.signal, options.signal]) : this.lifetime.signal;
+        if (signal.aborted)
+            throw mdbaseError("cancelled", "Timer request cancelled before dispatch.");
+        let result;
+        try {
+            result = await f({ signal });
+        }
+        catch (error) {
+            // Connect's narrow HTTP port reports uncertain admission in its structured
+            // problem. Do not leak a foreign error class into mutation outcome handling.
+            const outcome = error && typeof error === "object"
+                ? error.problem?.operation_outcome
+                : undefined;
+            if (write && outcome === "unknown") {
+                throw mdbaseError("outcome_unknown", "Timer or channel write outcome is unknown.");
+            }
+            if (write && isMdbaseError(error, "internal") && error.reason === "invalid_timer_response") {
+                throw mdbaseError("outcome_unknown", "Timer write returned an invalid response.");
+            }
+            throw error;
+        }
+        if (signal.aborted)
+            throw mdbaseError(write ? "outcome_unknown" : "cancelled", "Timer request ended before its response was observed.");
+        return result;
+    }
+    list(namespaceId, options = {}) {
+        namespace(namespaceId);
+        return this.run(options, false, async (o) => list(await this.port.list(namespaceId, o), namespaceId));
+    }
+    put(input, options = {}) {
+        namespace(input.namespace);
+        criterion(input.criterionId);
+        const d = desired(input.timer);
+        const ns = input.namespace, c = input.criterionId;
+        return this.run(options, true, async (o) => {
+            const r = timer(await this.port.put(ns, d.id, { criterion_id: c, fire_at: d.fire_at }, o));
+            if (r.id !== d.id || r.criterionId !== c || Date.parse(r.fireAt) !== Date.parse(d.fire_at))
+                throw badResponse();
+            // An identical PUT may return fired: it must not be treated as re-armed.
+            return r;
+        });
+    }
+    cancel(input, options = {}) {
+        namespace(input.namespace);
+        id(input.id);
+        if (input.generation !== undefined && (!Number.isSafeInteger(input.generation) || input.generation < 1))
+            throw invalid();
+        const { namespace: ns, id: timerId, generation } = input;
+        return this.run(options, true, async (o) => {
+            const r = object(await this.port.cancel(ns, timerId, generation, o));
+            if (r.namespace !== ns || r.id !== timerId || typeof r.cancelled !== "boolean")
+                throw badResponse();
+            return { namespace: ns, id: timerId, cancelled: r.cancelled };
+        });
+    }
+    reconcile(input, options = {}) {
+        namespace(input.namespace);
+        criterion(input.criterionId);
+        if (!Array.isArray(input.timers) || input.timers.length > MAX_TIMERS)
+            throw invalid();
+        const timers = input.timers.map(desired);
+        const expected = new Map(timers.map(t => [t.id, t.fire_at]));
+        if (expected.size !== timers.length)
+            throw invalid();
+        const ns = input.namespace, c = input.criterionId;
+        return this.run(options, true, async (o) => {
+            const raw = object(await this.port.reconcile(ns, { criterion_id: c, timers }, o));
+            const result = list(raw, ns);
+            if (result.timers.length !== timers.length || result.timers.some(t => !expected.has(t.id)
+                || t.criterionId !== c || Date.parse(t.fireAt) !== Date.parse(expected.get(t.id)))
+                || !Array.isArray(raw.cancelled_ids) || raw.cancelled_ids.length > MAX_TIMERS
+                || raw.cancelled_ids.some(v => typeof v !== "string" || !ID.test(v) || expected.has(v))
+                || new Set(raw.cancelled_ids).size !== raw.cancelled_ids.length)
+                throw badResponse();
+            return { ...result, cancelledIds: raw.cancelled_ids };
+        });
+    }
+    /** No ID generation, journal, automatic replay or consent adoption. */
+    reconcileWithReceipt(input, options = {}) {
+        const identity = operationIdentity(input), c = input.criterionId;
+        criterion(c);
+        if (!Array.isArray(input.timers) || input.timers.length > MAX_TIMERS)
+            throw invalid();
+        const timers = input.timers.map(desired), expected = new Map(timers.map(t => [t.id, t.fire_at]));
+        if (expected.size !== timers.length)
+            throw invalid();
+        const method = this.port.reconcileWithReceipt;
+        if (!method)
+            throw mdbaseError("upgrade_required", "Timer port does not support original-operation recovery.", "timer_operation_recovery_unavailable");
+        const recovery = { protocol_version: 1, operation_id: identity.operationId, expected_revision: identity.expectedRevision };
+        return this.run(options, true, async (o) => {
+            const result = receipt(await method.call(this.port, identity.namespace, { criterion_id: c, timers, recovery }, o), identity);
+            if (result.result.timers.length !== timers.length || result.result.timers.some(t => t.criterionId !== c
+                || !expected.has(t.id) || Date.parse(t.fireAt) !== Date.parse(expected.get(t.id))))
+                throw badResponse();
+            return result;
+        });
+    }
+    /** Read-only original receipt lookup. Missing is UNKNOWN, never proof of no effect. */
+    lookupOperation(input, options = {}) {
+        const identity = operationIdentity(input), method = this.port.lookupOperation;
+        if (!method)
+            throw mdbaseError("upgrade_required", "Timer port does not support original-operation recovery.", "timer_operation_recovery_unavailable");
+        // This is a read-only HTTP lookup, but all failures leave the ORIGINAL
+        // mutation unresolved; never expose a lookup-attempt failure as no effect.
+        return this.run(options, true, async (o) => {
+            const raw = object(await method.call(this.port, identity.namespace, identity.operationId, o));
+            if (raw.outcome === "committed" && Object.keys(raw).length === 2)
+                return { outcome: "committed", receipt: receipt(raw.receipt, identity) };
+            if (raw.outcome === "unknown" && raw.namespace === identity.namespace && raw.operation_id === identity.operationId
+                && Object.keys(raw).length === 3)
+                return { outcome: "unknown", namespace: identity.namespace, operationId: identity.operationId };
+            throw badResponse();
+        }).catch(() => {
+            // Include run's pre-dispatch abort/closed checks: a failed lookup attempt
+            // never classifies the ORIGINAL mutation as cancelled or not sent.
+            throw mdbaseError("outcome_unknown", "Original timer operation could not be recovered.");
+        });
+    }
+    /** Subscribe this browser for the app's notifications. Both options are optional. */
+    registerWebPush(options = {}) {
+        const criteria = options.criteria ?? this.criteria;
+        return this.run(options, true, async (o) => {
+            const serviceWorker = options.serviceWorker ?? await readyServiceWorker(o.signal);
+            return this.port.registerWebPush({ ...options, ...(criteria ? { criteria: [...criteria] } : {}), serviceWorker, ...o });
+        });
+    }
+    unregisterWebPush(serviceWorker, options = {}) {
+        return this.run(options, true, o => this.port.unregisterWebPush(serviceWorker, o));
+    }
+    registerFcm(options) {
+        const criteria = options.criteria ?? this.criteria;
+        return this.run(options, true, o => this.port.registerFcm({ ...options, ...(criteria ? { criteria: [...criteria] } : {}), ...o }));
+    }
+    unregisterFcm(options = {}) {
+        return this.run(options, true, o => this.port.unregisterFcm(o));
+    }
+}
+//# sourceMappingURL=timers.js.map

package/dist/timers.js.map

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

package/dist/transport/bases-rpc.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Bounded original-session native Bases READ FIFO. No retry or session switch.
+ * Cancelled in-flight work keeps its slot until the original response/close;
+ * abandoned replies are wiped, not published or reused by the next request.
+ */
+import type { CborValue } from "../cbor.js";
+type Method = "app_bases_execute_v1" | "app_bases_list_views_v1" | "app_bases_read_view_source_v1";
+export declare class NativeBasesReads {
+    private readonly request;
+    private tail;
+    private occupied;
+    constructor(request: (method: Method, bytes: Uint8Array) => Promise<CborValue>);
+    read(method: Method, bytes: Uint8Array, maxReply: number, signal?: AbortSignal): Promise<Uint8Array>;
+}
+export {};

package/dist/transport/bases-rpc.js

@@ -0,0 +1,61 @@
+import { mdbaseError } from "../errors.js";
+export class NativeBasesReads {
+    request;
+    tail = Promise.resolve();
+    occupied = 0;
+    constructor(request) {
+        this.request = request;
+    }
+    read(method, bytes, maxReply, signal) {
+        if (signal?.aborted)
+            return Promise.reject(mdbaseError("cancelled", "Bases READ cancelled"));
+        if (this.occupied >= 33)
+            return Promise.reject(mdbaseError("unavailable", "Bases read queue is full", "bases_read_backpressure"));
+        const owned = bytes.slice();
+        this.occupied++;
+        let resolve, reject;
+        let settled = false;
+        const result = new Promise((yes, no) => { resolve = yes; reject = no; });
+        const abort = () => {
+            if (settled)
+                return;
+            settled = true;
+            owned.fill(0);
+            reject(mdbaseError("cancelled", "Bases READ cancelled"));
+        };
+        signal?.addEventListener("abort", abort, { once: true });
+        const run = async () => {
+            try {
+                if (settled)
+                    return;
+                const reply = await this.request(method, owned);
+                if (!(reply instanceof Uint8Array) || !reply.length || reply.length > maxReply) {
+                    if (reply instanceof Uint8Array)
+                        reply.fill(0);
+                    throw mdbaseError("internal", "native Bases response bytes exceed bound");
+                }
+                if (settled || signal?.aborted) {
+                    reply.fill(0);
+                    abort();
+                    return;
+                }
+                settled = true;
+                resolve(reply);
+            }
+            catch (error) {
+                if (!settled) {
+                    settled = true;
+                    reject(error);
+                }
+            }
+            finally {
+                owned.fill(0);
+                signal?.removeEventListener("abort", abort);
+                this.occupied--;
+            }
+        };
+        this.tail = this.tail.then(run, run);
+        return result;
+    }
+}
+//# sourceMappingURL=bases-rpc.js.map

package/dist/transport/bases-rpc.js.map

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

package/dist/transport/control-route.d.ts

@@ -0,0 +1,34 @@
+import { type CollectionAvailability } from "../collection-availability.js";
+import type { RelayRoute } from "./relay.js";
+export interface ControlRouteTarget {
+    kind: string;
+    device: string;
+    noise_pk: string;
+    url: string;
+    relay_collection?: string;
+}
+export interface ControlRouteResponse {
+    collection: string;
+    grant: string;
+    targets: ControlRouteTarget[];
+    availability?: CollectionAvailability;
+    reason?: string;
+}
+/**
+ * The first usable target, or `null` when there is none (the SDK then reports
+ * `unavailable` / `no_device_online`; `no_device_registered` is kept as the reason).
+ * Relay targets (with `relay_collection`) use the relay Noise pipe and need the
+ * access token; others are direct WebSockets (the hosted replica).
+ */
+export declare function routeFromControl(res: ControlRouteResponse, accessToken: string): RelayRoute | null;
+export interface ControlRouteOptions {
+    /** Connect's HTTPS origin, e.g. `https://connect.mdbase.dev`. */
+    server: string;
+    /** The collection ID the app holds a grant for. */
+    collection: string;
+    /** The app's current access token (refreshed by the caller). */
+    accessToken: () => Promise<string> | string;
+    fetch?: typeof fetch;
+}
+/** A `resolveRoute` for `relayConnector`, backed by the control plane. */
+export declare function controlRouteResolver(o: ControlRouteOptions): () => Promise<RelayRoute | null>;