@superbee/server 0.1.6 → 0.2.0-pre.10

package/dist/index.d.ts

@@ -8,6 +8,9 @@
  * @packageDocumentation
  */
 export { createRouter, createRouterForBackend } from "./legacy-router.js";
+export type { LegacyRouterOptions } from "./legacy-router.js";
+export { MemoryOperationOutcomeStore } from "./operation-outcomes.js";
+export type { MemoryOperationOutcomeStoreOptions, OperationClaim, OperationOutcomeStore, RecordedOperation, RecordedOutcome, RecordedResponse, } from "./operation-outcomes.js";
 export { WIRE_ENDPOINTS } from "./router.js";
 export { RequestBodyTooLargeError, serve, requestFromIncomingMessage, writeResponseToServerResponse, } from "./serve.js";
 export type { RequestAdapterOptions, ServeOptions, ServerHandle, } from "./serve.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACL,wBAAwB,EACxB,KAAK,EACL,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,qBAAqB,EACrB,YAAY,EACZ,YAAY,GACb,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACtE,YAAY,EACV,kCAAkC,EAClC,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACL,wBAAwB,EACxB,KAAK,EACL,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,qBAAqB,EACrB,YAAY,EACZ,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -8,6 +8,7 @@
  * @packageDocumentation
  */
 export { createRouter, createRouterForBackend } from "./legacy-router.js";
+export { MemoryOperationOutcomeStore } from "./operation-outcomes.js";
 export { WIRE_ENDPOINTS } from "./router.js";
 export { RequestBodyTooLargeError, serve, requestFromIncomingMessage, writeResponseToServerResponse, } from "./serve.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACL,wBAAwB,EACxB,KAAK,EACL,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAStE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACL,wBAAwB,EACxB,KAAK,EACL,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,YAAY,CAAC"}

package/dist/legacy-router.d.ts

@@ -1,7 +1,16 @@
 /** Node-specific compatibility adapter for the historical single-backend package root. */
 import { type Bundle, type StorageBackend } from "@superbee/core";
+import { type OperationOutcomeStore } from "./operation-outcomes.js";
+export interface LegacyRouterOptions {
+    /**
+     * The store behind identified document writes. Omitted, the reference router gets a fresh
+     * in-memory store so identity works out of the box; `null` builds a router without one, which
+     * refuses identity and reports `operations: false`.
+     */
+    outcomes?: OperationOutcomeStore | null;
+}
 /** Historical explicit-backend entry point retained at the Node package root. */
-export declare function createRouterForBackend(backend: StorageBackend): (request: Request) => Promise<Response>;
+export declare function createRouterForBackend(backend: StorageBackend, options?: LegacyRouterOptions): (request: Request) => Promise<Response>;
 /** Historical Bundle entry point retained at the Node package root, including `/bundles/default`. */
-export declare function createRouter(bundle: Bundle): (request: Request) => Promise<Response>;
+export declare function createRouter(bundle: Bundle, options?: LegacyRouterOptions): (request: Request) => Promise<Response>;
 //# sourceMappingURL=legacy-router.d.ts.map

package/dist/legacy-router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"legacy-router.d.ts","sourceRoot":"","sources":["../src/legacy-router.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAE1F,OAAO,EAGL,KAAK,MAAM,EACX,KAAK,cAAc,EAEpB,MAAM,gBAAgB,CAAC;AAiDxB,iFAAiF;AACjF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAEvG;AAED,qGAAqG;AACrG,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAEpF"}
+{"version":3,"file":"legacy-router.d.ts","sourceRoot":"","sources":["../src/legacy-router.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAE1F,OAAO,EAEL,KAAK,MAAM,EACX,KAAK,cAAc,EAEpB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EAA+B,KAAK,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAQlG,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACzC;AA4CD,iFAAiF;AACjF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,GAAE,mBAAwB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAE1I;AAED,qGAAqG;AACrG,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAEvH"}

package/dist/legacy-router.js

@@ -1,5 +1,7 @@
 /** Node-specific compatibility adapter for the historical single-backend package root. */
-import { FilesystemBackend, MemoryBackend, } from "@superbee/core";
+import { MemoryBackend, } from "@superbee/core";
+import { backendFor } from "@superbee/core/bundle-ops";
+import { MemoryOperationOutcomeStore } from "./operation-outcomes.js";
 import { createRouter as createWorkerRouter, } from "./router.js";
 const LEGACY_INTERNAL_BUNDLE_ID = "bnd_00000000000000000000000000000000";
 function capabilitiesForBackend(backend) {
@@ -30,19 +32,21 @@ function canonicalizeLegacyBundleRoute(request) {
     url.pathname = `/v0/bundles/${LEGACY_INTERNAL_BUNDLE_ID}/${match[2]}`;
     return new Request(url, request);
 }
-function buildLegacyRouter(backend) {
+function buildLegacyRouter(backend, options) {
+    const outcomes = options.outcomes === undefined ? new MemoryOperationOutcomeStore() : options.outcomes;
     const workerRouter = createWorkerRouter({
         capabilities: capabilitiesForBackend(backend),
+        ...(outcomes === null ? {} : { outcomes }),
         resolveContext: (request) => ({ backend, attribution: legacyAttribution(request) }),
     });
     return (request) => workerRouter(canonicalizeLegacyBundleRoute(request));
 }
 /** Historical explicit-backend entry point retained at the Node package root. */
-export function createRouterForBackend(backend) {
-    return buildLegacyRouter(backend);
+export function createRouterForBackend(backend, options = {}) {
+    return buildLegacyRouter(backend, options);
 }
 /** Historical Bundle entry point retained at the Node package root, including `/bundles/default`. */
-export function createRouter(bundle) {
-    return buildLegacyRouter(bundle.backend ?? new FilesystemBackend(bundle.root));
+export function createRouter(bundle, options = {}) {
+    return buildLegacyRouter(backendFor(bundle), options);
 }
 //# sourceMappingURL=legacy-router.js.map

package/dist/legacy-router.js.map

@@ -1 +1 @@
-{"version":3,"file":"legacy-router.js","sourceRoot":"","sources":["../src/legacy-router.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAE1F,OAAO,EACL,iBAAiB,EACjB,aAAa,GAId,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,YAAY,IAAI,kBAAkB,GAEnC,MAAM,aAAa,CAAC;AAErB,MAAM,yBAAyB,GAAG,sCAAsC,CAAC;AAEzE,SAAS,sBAAsB,CAAC,OAAuB;IACrD,OAAO,CACL,OAAO,CAAC,YAAY,EAAE,EAAE,IAAI;QAC1B,YAAY,EAAE,OAAO,YAAY,aAAa;QAC9C,KAAK,EAAE,IAAI;QACX,WAAW,EAAE,IAAI;QACjB,SAAS,EAAE,KAAK;KACjB,CACF,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAgB;IACzC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;IACrD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;IACrD,OAAO;QACL,KAAK,EAAE,KAAK,IAAI,SAAS;QACzB,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,6BAA6B,CAAC,OAAgB;IACrD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,gCAAgC,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClE,IAAI,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC;IAC3B,GAAG,CAAC,QAAQ,GAAG,eAAe,yBAAyB,IAAI,KAAK,CAAC,CAAC,CAAE,EAAE,CAAC;IACvE,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAuB;IAChD,MAAM,YAAY,GAAG,kBAAkB,CAAC;QACtC,YAAY,EAAE,sBAAsB,CAAC,OAAO,CAAC;QAC7C,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC;KACpF,CAAC,CAAC;IACH,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,6BAA6B,CAAC,OAAO,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,sBAAsB,CAAC,OAAuB;IAC5D,OAAO,iBAAiB,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,iBAAiB,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AACjF,CAAC"}
+{"version":3,"file":"legacy-router.js","sourceRoot":"","sources":["../src/legacy-router.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAE1F,OAAO,EACL,aAAa,GAId,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD,OAAO,EAAE,2BAA2B,EAA8B,MAAM,yBAAyB,CAAC;AAClG,OAAO,EACL,YAAY,IAAI,kBAAkB,GAEnC,MAAM,aAAa,CAAC;AAErB,MAAM,yBAAyB,GAAG,sCAAsC,CAAC;AAWzE,SAAS,sBAAsB,CAAC,OAAuB;IACrD,OAAO,CACL,OAAO,CAAC,YAAY,EAAE,EAAE,IAAI;QAC1B,YAAY,EAAE,OAAO,YAAY,aAAa;QAC9C,KAAK,EAAE,IAAI;QACX,WAAW,EAAE,IAAI;QACjB,SAAS,EAAE,KAAK;KACjB,CACF,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAgB;IACzC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;IACrD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;IACrD,OAAO;QACL,KAAK,EAAE,KAAK,IAAI,SAAS;QACzB,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,6BAA6B,CAAC,OAAgB;IACrD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,gCAAgC,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClE,IAAI,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC;IAC3B,GAAG,CAAC,QAAQ,GAAG,eAAe,yBAAyB,IAAI,KAAK,CAAC,CAAC,CAAE,EAAE,CAAC;IACvE,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAuB,EAAE,OAA4B;IAC9E,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,2BAA2B,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACvG,MAAM,YAAY,GAAG,kBAAkB,CAAC;QACtC,YAAY,EAAE,sBAAsB,CAAC,OAAO,CAAC;QAC7C,GAAG,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;QAC1C,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC;KACpF,CAAC,CAAC;IACH,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,6BAA6B,CAAC,OAAO,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,sBAAsB,CAAC,OAAuB,EAAE,UAA+B,EAAE;IAC/F,OAAO,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,UAA+B,EAAE;IAC5E,OAAO,iBAAiB,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC"}

package/dist/operation-outcomes.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Recorded outcomes of identified writes: the store behind the wire's `Idempotency-Key` header
+ * and `GET /operations/{key}` route (`docs/WIRE-PROTOCOL.md`, "Identified writes").
+ *
+ * A key is claimed before its write is applied. The claim answers in one of three ways: the
+ * key already has a recorded operation, so the caller replays it; another application of the
+ * same key is in progress, so the caller waits for it; or the key is now the caller's, who
+ * either records the response it produced or releases the claim when the application threw
+ * before any response existed. Recording binds the outcome to the method and document id it
+ * was produced for, so a resubmission under the same key that names a different operation can
+ * be refused instead of replayed.
+ *
+ * Keys are scoped: the reference router scopes by canonical bundle id, so two bundles cannot
+ * share or collide on a key. The memory store keeps each record for a retention window and
+ * forgets it lazily on access, pruning on every record so the map stays bounded by what was
+ * written inside one window. The module imports no Node builtin: the Worker-safe router
+ * subpath consumes it unchanged.
+ */
+import type { Outcome } from "@superbee/core/storage";
+/** The outcome kinds an authority can record; `unknown` is the client's word, never the store's. */
+export type RecordedOutcome = Exclude<Outcome, {
+    kind: "unknown";
+}>;
+/** The parts of a response that replay verbatim to a duplicate submission. */
+export interface RecordedResponse {
+    status: number;
+    headers: Array<[string, string]>;
+    body: string;
+}
+/** One identified write the authority applied, as recorded under its key. */
+export interface RecordedOperation {
+    /** The HTTP method the outcome was recorded for. */
+    method: string;
+    /** The decoded document id the outcome was recorded for. */
+    id: string;
+    response: RecordedResponse;
+    outcome: RecordedOutcome;
+    /** Milliseconds since the epoch on the store's clock; retention counts from here. */
+    recordedAt: number;
+}
+/** What a caller learns when it claims a key. */
+export type OperationClaim = {
+    kind: "recorded";
+    operation: RecordedOperation;
+} | {
+    kind: "in_progress";
+    /** Resolves with the record once the other application records, or `null` if it released instead. */
+    settled: Promise<RecordedOperation | null>;
+} | {
+    kind: "claimed";
+    /**
+     * Record the application's response under the key. The router awaits completion before
+     * returning it, and does not release the claim if recording fails after application.
+     * Durable stores must reconcile a possibly committed mutation before allowing reapplication.
+     */
+    record(operation: Omit<RecordedOperation, "recordedAt">): RecordedOperation | Promise<RecordedOperation>;
+    /**
+     * Settle an application failure before the router returns it. A durable store must check
+     * for a committed mutation before making the key available for a fresh application.
+     */
+    release(): void | Promise<void>;
+};
+export interface OperationOutcomeStore {
+    /** Claim `key` within `scope` ahead of applying the write it identifies. */
+    claim(scope: string, key: string): Promise<OperationClaim>;
+    /** The record under `key` within `scope`, or `null` when nothing is recorded (never, or no longer). */
+    lookup(scope: string, key: string): Promise<RecordedOperation | null>;
+}
+export interface MemoryOperationOutcomeStoreOptions {
+    /** How long a record stays answerable after it is recorded. Default 24 hours. */
+    retentionMs?: number;
+    /** The clock retention is measured on; injectable so a test can expire records deterministically. */
+    now?: () => number;
+}
+/** The reference store: one map per process, bounded by the retention window. */
+export declare class MemoryOperationOutcomeStore implements OperationOutcomeStore {
+    private readonly recorded;
+    private readonly inProgress;
+    private readonly retentionMs;
+    private readonly now;
+    constructor(options?: MemoryOperationOutcomeStoreOptions);
+    /** Records currently held, expired ones included until they are next touched. */
+    get size(): number;
+    claim(scope: string, key: string): Promise<OperationClaim>;
+    lookup(scope: string, key: string): Promise<RecordedOperation | null>;
+    /** The record at `slot` if it is inside the window; an expired record is dropped on the way. */
+    private live;
+    private expired;
+    /**
+     * Drop expired records from the front of the map. Records are inserted in clock order (a
+     * record always lands as a fresh key, since `live` removes an expired one before a new claim
+     * can be handed out), so the scan stops at the first live record and each record is visited
+     * once over its life. A clock that moves backwards can leave an expired record behind a live
+     * one; `live` still drops it on its next touch, so correctness never depends on this scan.
+     */
+    private prune;
+}
+//# sourceMappingURL=operation-outcomes.d.ts.map

package/dist/operation-outcomes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-outcomes.d.ts","sourceRoot":"","sources":["../src/operation-outcomes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD,oGAAoG;AACpG,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC;AAEpE,8EAA8E;AAC9E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,6EAA6E;AAC7E,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,eAAe,CAAC;IACzB,qFAAqF;IACrF,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,iDAAiD;AACjD,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,iBAAiB,CAAA;CAAE,GAClD;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,qGAAqG;IACrG,OAAO,EAAE,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;CAC5C,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB;;;;OAIG;IACH,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC,GAAG,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACzG;;;OAGG;IACH,OAAO,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC,CAAC;AAEN,MAAM,WAAW,qBAAqB;IACpC,4EAA4E;IAC5E,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3D,uGAAuG;IACvG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,kCAAkC;IACjD,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qGAAqG;IACrG,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AASD,iFAAiF;AACjF,qBAAa,2BAA4B,YAAW,qBAAqB;IACvE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IACjE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiC;IAC5D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAEvB,OAAO,GAAE,kCAAuC;IAK5D,iFAAiF;IACjF,IAAI,IAAI,IAAI,MAAM,CAEjB;IAEK,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAgD1D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAI3E,gGAAgG;IAChG,OAAO,CAAC,IAAI;IAUZ,OAAO,CAAC,OAAO;IAIf;;;;;;OAMG;IACH,OAAO,CAAC,KAAK;CAMd"}

package/dist/operation-outcomes.js

@@ -0,0 +1,122 @@
+/**
+ * Recorded outcomes of identified writes: the store behind the wire's `Idempotency-Key` header
+ * and `GET /operations/{key}` route (`docs/WIRE-PROTOCOL.md`, "Identified writes").
+ *
+ * A key is claimed before its write is applied. The claim answers in one of three ways: the
+ * key already has a recorded operation, so the caller replays it; another application of the
+ * same key is in progress, so the caller waits for it; or the key is now the caller's, who
+ * either records the response it produced or releases the claim when the application threw
+ * before any response existed. Recording binds the outcome to the method and document id it
+ * was produced for, so a resubmission under the same key that names a different operation can
+ * be refused instead of replayed.
+ *
+ * Keys are scoped: the reference router scopes by canonical bundle id, so two bundles cannot
+ * share or collide on a key. The memory store keeps each record for a retention window and
+ * forgets it lazily on access, pruning on every record so the map stays bounded by what was
+ * written inside one window. The module imports no Node builtin: the Worker-safe router
+ * subpath consumes it unchanged.
+ */
+const DEFAULT_RETENTION_MS = 24 * 60 * 60 * 1000;
+/** The reference store: one map per process, bounded by the retention window. */
+export class MemoryOperationOutcomeStore {
+    recorded = new Map();
+    inProgress = new Map();
+    retentionMs;
+    now;
+    constructor(options = {}) {
+        this.retentionMs = options.retentionMs ?? DEFAULT_RETENTION_MS;
+        this.now = options.now ?? (() => Date.now());
+    }
+    /** Records currently held, expired ones included until they are next touched. */
+    get size() {
+        return this.recorded.size;
+    }
+    async claim(scope, key) {
+        // No await precedes the map reads and writes below, so a claim is atomic against every
+        // other claim in this process: two concurrent submissions cannot both be handed the key.
+        const slot = slotKey(scope, key);
+        const existing = this.live(slot);
+        if (existing)
+            return { kind: "recorded", operation: existing };
+        const running = this.inProgress.get(slot);
+        if (running)
+            return { kind: "in_progress", settled: running.settled };
+        let resolve;
+        const settled = new Promise((done) => {
+            resolve = done;
+        });
+        const entry = { settled, resolve };
+        this.inProgress.set(slot, entry);
+        let open = true;
+        const assertOpen = () => {
+            if (!open)
+                throw new Error(`operation outcome for '${key}' was already recorded or released`);
+        };
+        const finish = (value) => {
+            assertOpen();
+            open = false;
+            if (this.inProgress.get(slot) === entry)
+                this.inProgress.delete(slot);
+            entry.resolve(value);
+        };
+        return {
+            kind: "claimed",
+            record: (operation) => {
+                // A settled claim is refused before any map is touched, so a second record cannot land
+                // a row the caller was told was rejected. The clock is injected, so it can throw; a
+                // record that never lands still gives the key back, or every waiter on this claim would
+                // hang and the key would stay unusable until the process restarts.
+                assertOpen();
+                try {
+                    const record = { ...operation, recordedAt: this.now() };
+                    this.prune();
+                    this.recorded.set(slot, record);
+                    finish(record);
+                    return record;
+                }
+                catch (err) {
+                    if (open)
+                        finish(null);
+                    throw err;
+                }
+            },
+            release: () => finish(null),
+        };
+    }
+    async lookup(scope, key) {
+        return this.live(slotKey(scope, key));
+    }
+    /** The record at `slot` if it is inside the window; an expired record is dropped on the way. */
+    live(slot) {
+        const record = this.recorded.get(slot);
+        if (!record)
+            return null;
+        if (this.expired(record)) {
+            this.recorded.delete(slot);
+            return null;
+        }
+        return record;
+    }
+    expired(record) {
+        return this.now() - record.recordedAt >= this.retentionMs;
+    }
+    /**
+     * Drop expired records from the front of the map. Records are inserted in clock order (a
+     * record always lands as a fresh key, since `live` removes an expired one before a new claim
+     * can be handed out), so the scan stops at the first live record and each record is visited
+     * once over its life. A clock that moves backwards can leave an expired record behind a live
+     * one; `live` still drops it on its next touch, so correctness never depends on this scan.
+     */
+    prune() {
+        for (const [slot, record] of this.recorded) {
+            if (!this.expired(record))
+                break;
+            this.recorded.delete(slot);
+        }
+    }
+}
+/** Scope and key joined on a separator no key can contain (keys are printable ASCII, so no NUL). */
+function slotKey(scope, key) {
+    return `${scope}\u0000${key}`;
+}
+//# sourceMappingURL=operation-outcomes.js.map

package/dist/operation-outcomes.js.map

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

package/dist/router.d.ts

@@ -17,6 +17,7 @@
  * endpoint set and any recorded deviations from the draft.
  */
 import { type BlobKey, type ConceptId, type ReservedFilename, type StorageBackend, type StorageCapabilities } from "@superbee/core/storage";
+import type { OperationOutcomeStore } from "./operation-outcomes.js";
 /** Canonical remote bundle id: 16 random bytes rendered as lowercase hexadecimal. */
 export type BundleId = `bnd_${string}`;
 /** Access needed before a registered endpoint may dispatch. */
@@ -44,6 +45,18 @@ export declare const WIRE_ENDPOINTS: readonly [{
     readonly method: "POST";
     readonly path: "/v0/bundles/{bundle}/docs:read-many";
     readonly accessClass: "read";
+}, {
+    readonly id: "docs-heads";
+    readonly resource: "docs-heads";
+    readonly method: "GET";
+    readonly path: "/v0/bundles/{bundle}/heads";
+    readonly accessClass: "read";
+}, {
+    readonly id: "docs-snapshot";
+    readonly resource: "docs-snapshot";
+    readonly method: "GET";
+    readonly path: "/v0/bundles/{bundle}/snapshot";
+    readonly accessClass: "read";
 }, {
     readonly id: "doc-read";
     readonly resource: "doc";
@@ -116,6 +129,12 @@ export declare const WIRE_ENDPOINTS: readonly [{
     readonly method: "DELETE";
     readonly path: "/v0/bundles/{bundle}/blobs/{key...}";
     readonly accessClass: "write";
+}, {
+    readonly id: "operation-lookup";
+    readonly resource: "operation";
+    readonly method: "GET";
+    readonly path: "/v0/bundles/{bundle}/operations/{key}";
+    readonly accessClass: "write";
 }];
 export type WireEndpointId = (typeof WIRE_ENDPOINTS)[number]["id"];
 export type ResolvedWireResource = {
@@ -124,6 +143,10 @@ export type ResolvedWireResource = {
     kind: "docs";
 } | {
     kind: "docs-read-many";
+} | {
+    kind: "docs-heads";
+} | {
+    kind: "docs-snapshot";
 } | {
     kind: "doc";
     id: ConceptId;
@@ -139,6 +162,9 @@ export type ResolvedWireResource = {
 } | {
     kind: "blob";
     key: BlobKey;
+} | {
+    kind: "operation";
+    key: string;
 };
 interface ResolvedWireRouteBase {
     endpointId: WireEndpointId;
@@ -174,6 +200,12 @@ export interface TrustedRouterContext {
 }
 export interface RouterOptions {
     capabilities: StorageCapabilities;
+    /**
+     * Where identified document writes record their outcomes, scoped by canonical bundle id.
+     * Without one the router refuses every request that carries `Idempotency-Key` and the lookup
+     * route with `400 USAGE`, and `GET /v0/capabilities` reports `operations: false`.
+     */
+    outcomes?: OperationOutcomeStore;
     resolveContext(request: Request, route: ResolvedBundleWireRoute): TrustedRouterContext | Response | Promise<TrustedRouterContext | Response>;
 }
 /** Typed resolution failure retained as a stable host-side rejection seam. */

package/dist/router.d.ts.map

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