@superbee/core 0.2.0-pre.4 → 0.2.0-pre.40

package/dist/uncertain-write.js

@@ -15,12 +15,36 @@
  * `sleep` used for the submission deadline and the delay between lookups; there is no
  * injectable clock, and a transport's own latency is real.
  */
-/** Refusal codes that mean the caller's authorization is gone rather than the content wrong. */
-export const AUTHORIZATION_REFUSAL_CODES = new Set(["AUTH_REQUIRED", "FORBIDDEN", "UNAUTHORIZED", "PERMISSION_DENIED"]);
+/** The one {@link LookupPending} answer. */
+export const LOOKUP_PENDING = Object.freeze({ kind: "pending" });
+/**
+ * Refusal codes that pause shared operations rather than say the content is wrong: the caller's
+ * authorization is gone, or a hosted sync quota (`REQUEST_CAPACITY_*`, one per scope the host
+ * names) is spent. Nothing is lost; the refused intents are requeued when the store resumes.
+ */
+export const AUTHORIZATION_REFUSAL_CODES = new Set([
+    "AUTH_REQUIRED",
+    "FORBIDDEN",
+    "UNAUTHORIZED",
+    "PERMISSION_DENIED",
+    "REQUEST_CAPACITY_PRINCIPAL",
+    "REQUEST_CAPACITY_BUNDLE",
+]);
 /** True when a refusal reports lost permission, which pauses further shared operations. */
 export function isAuthorizationRefusal(outcome) {
     return outcome.kind === "refused" && AUTHORIZATION_REFUSAL_CODES.has(outcome.code);
 }
+/**
+ * True when a resend's refusal cannot settle an identity whose earlier delivery is unclear. An
+ * authorization refusal never can: access lost now says nothing about a delivery authorized
+ * earlier. Once a lookup answered {@link LookupPending}, an earlier delivery is known to be held,
+ * so no refusal the transport marks as attempt-only (`executed`) can either. Without that
+ * answer, a marked refusal of the same bytes (a schema `400`, the mass-delete hold) settles, as
+ * it would refuse a delayed first delivery too.
+ */
+function refusalLeavesUnknown(outcome, held) {
+    return outcome.kind === "refused" && (isAuthorizationRefusal(outcome) || (held && outcome.executed !== undefined));
+}
 /** The journal state an outcome settles an intent into. */
 export function stateForOutcome(outcome) {
     switch (outcome.kind) {
@@ -30,6 +54,8 @@ export function stateForOutcome(outcome) {
             return "conflict";
         case "refused":
             return "refused";
+        case "not-executed":
+            return "pending";
         case "unknown":
             return "unknown";
     }
@@ -77,10 +103,12 @@ const UNKNOWN = { kind: "unknown" };
  * at that version. This is the wire's post-expiry compare-and-swap property: a committed write
  * whose acknowledgement was lost and whose recorded outcome expired from the authority's
  * retention window is resubmitted with its original `base`, which no longer matches, and the
- * authority answers a conflict against the version the client itself committed. The mapping
- * depends only on the outcome and the intent, so the primitive owns it and every consumer
- * settles such a write as acknowledged rather than presenting it as a concurrent edit. Every
- * other conflict, including one against an absent head (`actual: null`), is returned unchanged.
+ * authority answers a conflict against the version the client itself committed. If the head
+ * has meanwhile returned to `base` exactly, the premise matches and the resubmission is applied
+ * again instead (see {@link performUncertainWrite}). The mapping depends only on the outcome and
+ * the intent, so the primitive owns it and every consumer settles such a write as acknowledged
+ * rather than presenting it as a concurrent edit. Every other conflict, including one against
+ * an absent head (`actual: null`), is returned unchanged.
  */
 export function settleAgainstIntent(outcome, intent) {
     if (outcome.kind === "conflict" && outcome.actual !== null && outcome.actual === intent.local) {
@@ -107,56 +135,76 @@ async function submitOnce(transport, intent, deadlineMs, sleep) {
     controller.abort();
     return UNKNOWN;
 }
-/**
- * Deliver `intent` and settle it against the authority's recorded outcome.
- *
- * Flow: when the intent has never been submitted, submit it; when it has (`attempts > 0`), or
- * when a submission's outcome is unknown, look the request identity up. A positive lookup
- * settles the intent. A `null` lookup proves the authority never recorded the request, so a
- * resubmission with the same `requestId` is the first delivery and is allowed, up to
- * `maxSubmissions`. A lookup that fails leaves the outcome unknown and the intent for a later
- * call.
- *
- * No resubmission happens without a `null` lookup because a blind retry after an unknown
- * outcome is unsound: on an authority without request identity the retry applies the write
- * twice, and even on one with it the retry can only ever learn what the lookup already knew.
- * The lookup is what turns "unknown" into a fact before any second delivery.
- *
- * By default every outcome passes through {@link settleAgainstIntent}, so a conflict naming the
- * intent's own version is committed. `recorded-only` preserves the recorded outcome instead.
- */
 export async function performUncertainWrite(transport, intent, options = {}) {
+    const explicitStart = "start" in options;
+    if (explicitStart) {
+        if (options.settlement !== "recorded-only" || (options.start !== "submit-claimed" && options.start !== "lookup") ||
+            !Number.isSafeInteger(intent.attempts) || intent.attempts < 0 ||
+            !["pending", "in_flight", "acknowledged", "conflict", "refused", "unknown"].includes(intent.state) ||
+            (options.start === "submit-claimed" && (intent.state !== "in_flight" || intent.attempts < 1)))
+            throw new Error("Invalid recorded-only delivery start or durable claim.");
+        if (intent.notAppliedThrough !== undefined && (!Number.isSafeInteger(intent.notAppliedThrough) || intent.notAppliedThrough < 0 || intent.notAppliedThrough > intent.attempts || options.start === "submit-claimed" && intent.notAppliedThrough !== intent.attempts - 1))
+            throw new Error("Invalid recorded-only non-execution prefix or durable claim.");
+        // Capture the descriptor before the first asynchronous boundary. Additional prepared data
+        // belongs to the typed caller; the primitive neither fabricates nor interprets its fields.
+        intent = { ...intent };
+        options = { ...options };
+    }
     if (options.settlement !== undefined && options.settlement !== "exact-content" && options.settlement !== "recorded-only") {
         throw new Error("Unknown uncertain-write settlement mode.");
     }
     const sleep = options.sleep ?? defaultSleep;
     const maxLookups = Math.max(1, options.maxLookups ?? 3);
-    const maxSubmissions = Math.max(1, options.maxSubmissions ?? 2);
+    const maxSubmissions = explicitStart ? 1 : Math.max(1, options.maxSubmissions ?? 2);
     const lookupDelayMs = options.lookupDelayMs ?? 250;
+    const { signal } = options;
+    // Whether a submission of this identity may still be held by the authority unanswered.
+    let unclear = options.earlierDeliveryUnclear === true && intent.attempts > 0;
+    // Whether any lookup in this call answered pending: a delivery of this identity was held, so
+    // a later absent answer in the same call does not undo it.
+    let held = false;
     let attempts = intent.attempts;
     let submissions = 0;
     let lookups = 0;
     const finish = (raw) => {
+        // Only the compatibility overload admits exact-content settlement and it requires the
+        // original full OperationIntent/Outcome contract. Explicit starts never use those fields.
         const outcome = options.settlement === "recorded-only" ? raw : settleAgainstIntent(raw, intent);
         return { intent: { ...intent, attempts, state: stateForOutcome(outcome) }, outcome, lookups };
     };
     // A previously submitted intent starts at the lookup, never at a submission.
-    let needSubmission = attempts === 0;
+    let needSubmission = explicitStart ? options.start === "submit-claimed" : attempts === 0;
     for (;;) {
         if (needSubmission) {
-            if (submissions >= maxSubmissions)
+            if (submissions >= maxSubmissions || ((explicitStart || submissions > 0) && signal?.aborted))
                 return finish(UNKNOWN);
             submissions += 1;
-            attempts += 1;
+            if (!explicitStart)
+                attempts += 1;
             const outcome = await submitOnce(transport, { ...intent, attempts, state: "in_flight" }, options.deadlineMs, sleep);
+            if (outcome.kind === "not-executed") {
+                if (!explicitStart || intent.notAppliedThrough === undefined || intent.notAppliedThrough !== attempts - 1 || outcome.attempts !== attempts || signal?.aborted)
+                    return finish(UNKNOWN);
+                return finish(outcome);
+            }
+            // A resend refused before it reached execution (no credential, access withdrawn, a spent
+            // quota, a gateway's schema check) is evidence about that resend only: an earlier, unclear delivery may still be held
+            // by the authority and commit, so the identity stays unknown and the intent is kept.
+            if (unclear && refusalLeavesUnknown(outcome, held))
+                return finish(explicitStart ? UNKNOWN : { kind: "unknown", refusal: { code: outcome.code, message: outcome.message } });
             if (outcome.kind !== "unknown")
                 return finish(outcome);
+            unclear = true;
         }
         needSubmission = false;
         let recorded;
         for (let round = 0; round < maxLookups; round++) {
+            if (signal?.aborted)
+                break;
             if (round > 0)
-                await sleep(lookupDelayMs);
+                await sleep(lookupDelayMs, signal);
+            if (signal?.aborted)
+                break;
             lookups += 1;
             try {
                 recorded = await transport.lookup(intent.requestId);
@@ -169,8 +217,16 @@ export async function performUncertainWrite(transport, intent, options = {}) {
         }
         if (recorded === undefined)
             return finish(UNKNOWN);
+        if (recorded !== null && recorded.kind === "pending") {
+            // Held unanswered: a delivery of this identity was admitted and may still commit.
+            unclear = true;
+            held = true;
+            recorded = null;
+        }
         if (recorded !== null)
-            return finish(recorded);
+            return finish(recorded.kind === "not-executed" ? UNKNOWN : recorded);
+        if (explicitStart)
+            return finish(UNKNOWN);
         needSubmission = true;
     }
 }

package/dist/uncertain-write.js.map

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

package/dist/versioning.d.ts

@@ -4,10 +4,15 @@
  * These make the seam's "hardest case" (content-addressed versions, compare-and-swap
  * writes, actor attribution) implementable uniformly across adapters:
  *   - {@link contentVersion} defines the opaque {@link Version} token as a SHA-256 over
- *     the canonically serialized document, so identical content yields the same token
- *     REGARDLESS of backend. The filesystem adapter hashes the on-disk bytes; the
- *     in-memory adapter hashes the same serialization — an engine-written document
- *     therefore carries the same version token in either store.
+ *     the canonically serialized document. A version token is a property of a backend,
+ *     not of the content: the filesystem adapter hashes the on-disk bytes exactly as
+ *     written, so a hand-authored file keeps its bytes and its token; the in-memory and
+ *     wire adapters hash a re-serialization, which folds long strings, expands flow
+ *     sequences and normalizes timestamps, so content Superbee did not author may carry a
+ *     different token there. An engine-written document carries the same token in either
+ *     store, because the engine wrote the canonical bytes. Bytes are the promise that
+ *     travels between backends (decision of 2026-09-17, "bytes win"); no promise rests on
+ *     cross-backend token equality.
  *   - {@link blobVersion} is the SAME idea for opaque blob bytes, but hashes the raw
  *     `Uint8Array` directly with no string/UTF-8 step — a doc-shaped hash would corrupt
  *     binary content, so blobs get their own primitive rather than reusing `contentVersion`

package/dist/versioning.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"versioning.d.ts","sourceRoot":"","sources":["../src/versioning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE7F,sFAAsF;AACtF,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAExD;AAED,gGAAgG;AAChG,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAGrC"}
+{"version":3,"file":"versioning.d.ts","sourceRoot":"","sources":["../src/versioning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE7F,sFAAsF;AACtF,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAExD;AAED,gGAAgG;AAChG,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAGrC"}

package/dist/versioning.js

@@ -4,10 +4,15 @@
  * These make the seam's "hardest case" (content-addressed versions, compare-and-swap
  * writes, actor attribution) implementable uniformly across adapters:
  *   - {@link contentVersion} defines the opaque {@link Version} token as a SHA-256 over
- *     the canonically serialized document, so identical content yields the same token
- *     REGARDLESS of backend. The filesystem adapter hashes the on-disk bytes; the
- *     in-memory adapter hashes the same serialization — an engine-written document
- *     therefore carries the same version token in either store.
+ *     the canonically serialized document. A version token is a property of a backend,
+ *     not of the content: the filesystem adapter hashes the on-disk bytes exactly as
+ *     written, so a hand-authored file keeps its bytes and its token; the in-memory and
+ *     wire adapters hash a re-serialization, which folds long strings, expands flow
+ *     sequences and normalizes timestamps, so content Superbee did not author may carry a
+ *     different token there. An engine-written document carries the same token in either
+ *     store, because the engine wrote the canonical bytes. Bytes are the promise that
+ *     travels between backends (decision of 2026-09-17, "bytes win"); no promise rests on
+ *     cross-backend token equality.
  *   - {@link blobVersion} is the SAME idea for opaque blob bytes, but hashes the raw
  *     `Uint8Array` directly with no string/UTF-8 step — a doc-shaped hash would corrupt
  *     binary content, so blobs get their own primitive rather than reusing `contentVersion`

package/dist/versioning.js.map

@@ -1 +1 @@
-{"version":3,"file":"versioning.js","sourceRoot":"","sources":["../src/versioning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGhE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE7F,sFAAsF;AACtF,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,GAAgB;IAC7C,OAAO,UAAU,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;AAC9E,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,UAAU,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;AACpC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,KAAiB;IAC3C,OAAO,UAAU,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,GAAG,GAAG,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IACrE,OAAO,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC;AACvF,CAAC"}
+{"version":3,"file":"versioning.js","sourceRoot":"","sources":["../src/versioning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGhE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE7F,sFAAsF;AACtF,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,GAAgB;IAC7C,OAAO,UAAU,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;AAC9E,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,UAAU,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;AACpC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,KAAiB;IAC3C,OAAO,UAAU,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,GAAG,GAAG,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IACrE,OAAO,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC;AACvF,CAAC"}

package/dist/view-launch-contract.d.ts

@@ -0,0 +1,14 @@
+/** In-process continuity only: an attempt grants no View, session or execution authority. */
+export interface ViewLaunchAttempt {
+    readonly generation: number;
+    readonly selectionKey: string;
+}
+export interface ViewLaunchFence {
+    begin(selectionKey: string): ViewLaunchAttempt;
+    current(): ViewLaunchAttempt | null;
+    isCurrent(attempt: ViewLaunchAttempt): boolean;
+    retire(attempt: ViewLaunchAttempt): boolean;
+}
+export type ViewLaunchFailureReason = "context-required" | "expired" | "changed" | "denied" | "unavailable" | "delivery-failed";
+export declare function createViewLaunchFence(): ViewLaunchFence;
+//# sourceMappingURL=view-launch-contract.d.ts.map

package/dist/view-launch-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-launch-contract.d.ts","sourceRoot":"","sources":["../src/view-launch-contract.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,iBAAiB,CAAC;IAC/C,OAAO,IAAI,iBAAiB,GAAG,IAAI,CAAC;IACpC,SAAS,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC;IAC/C,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC;CAC7C;AAED,MAAM,MAAM,uBAAuB,GAC/B,kBAAkB,GAAG,SAAS,GAAG,SAAS,GAC1C,QAAQ,GAAG,aAAa,GAAG,iBAAiB,CAAC;AAEjD,wBAAgB,qBAAqB,IAAI,eAAe,CAmBvD"}

package/dist/view-launch-contract.js

@@ -0,0 +1,23 @@
+export function createViewLaunchFence() {
+    let generation = 0;
+    let current = null;
+    return {
+        begin(selectionKey) {
+            // Exhaustion invalidates the old attempt rather than reusing an imprecise generation.
+            current = null;
+            if (generation === Number.MAX_SAFE_INTEGER)
+                throw new RangeError("View launch generation exhausted");
+            current = Object.freeze({ generation: ++generation, selectionKey });
+            return current;
+        },
+        current: () => current,
+        isCurrent: attempt => current !== null && current === attempt,
+        retire(attempt) {
+            if (current === null || current !== attempt)
+                return false;
+            current = null;
+            return true;
+        },
+    };
+}
+//# sourceMappingURL=view-launch-contract.js.map

package/dist/view-launch-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-launch-contract.js","sourceRoot":"","sources":["../src/view-launch-contract.ts"],"names":[],"mappings":"AAiBA,MAAM,UAAU,qBAAqB;IACnC,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,OAAO,GAA6B,IAAI,CAAC;IAC7C,OAAO;QACL,KAAK,CAAC,YAAY;YAChB,sFAAsF;YACtF,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,UAAU,KAAK,MAAM,CAAC,gBAAgB;gBAAE,MAAM,IAAI,UAAU,CAAC,kCAAkC,CAAC,CAAC;YACrG,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC,CAAC;YACpE,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO;QACtB,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,OAAO;QAC7D,MAAM,CAAC,OAAO;YACZ,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,OAAO;gBAAE,OAAO,KAAK,CAAC;YAC1D,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/write-identity.d.ts

@@ -0,0 +1,5 @@
+/** Lexical write identity rules, independent of transport and payload families. */
+export declare function isWriteRequestId(value: string): boolean;
+export declare function isWriteBinding(value: string): boolean;
+export declare function isAgentLabelVia(value: unknown): value is string;
+//# sourceMappingURL=write-identity.d.ts.map

package/dist/write-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-identity.d.ts","sourceRoot":"","sources":["../src/write-identity.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEvD;AACD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAgD;AACtG,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE/D"}

package/dist/write-identity.js

@@ -0,0 +1,9 @@
+/** Lexical write identity rules, independent of transport and payload families. */
+export function isWriteRequestId(value) {
+    return /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/.test(value);
+}
+export function isWriteBinding(value) { return /^sha256:[a-f0-9]{64}$/.test(value); }
+export function isAgentLabelVia(value) {
+    return typeof value === "string" && /^[a-z0-9._-]{1,32}$/.test(value) && !value.startsWith("superbee");
+}
+//# sourceMappingURL=write-identity.js.map

package/dist/write-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-identity.js","sourceRoot":"","sources":["../src/write-identity.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,uEAAuE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC7F,CAAC;AACD,MAAM,UAAU,cAAc,CAAC,KAAa,IAAa,OAAO,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACtG,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AACzG,CAAC"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@superbee/core",
-  "version": "0.2.0-pre.4",
+  "version": "0.2.0-pre.40",
   "type": "module",
-  "description": "OKF store engine — bundle I/O, cross-links, derived backlinks, freshness, and versioned writes.",
+  "description": "OKF store engine \u2014 bundle I/O, cross-links, derived backlinks, freshness, and versioned writes.",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -27,6 +27,22 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
+    "./kinds-load": {
+      "types": "./dist/kinds-load.d.ts",
+      "default": "./dist/kinds-load.js"
+    },
+    "./document-field-actions": {
+      "types": "./dist/document-field-actions.d.ts",
+      "default": "./dist/document-field-actions.js"
+    },
+    "./okf-actor": {
+      "types": "./dist/okf-actor.d.ts",
+      "default": "./dist/okf-actor.js"
+    },
+    "./okf-authoring": {
+      "types": "./dist/okf-authoring.d.ts",
+      "default": "./dist/okf-authoring.js"
+    },
     "./bundle-ops": {
       "types": "./dist/bundle-ops.d.ts",
       "default": "./dist/bundle-ops.js"
@@ -47,6 +63,30 @@
       "types": "./dist/recipes.d.ts",
       "default": "./dist/recipes.js"
     },
+    "./connectors": {
+      "types": "./dist/connectors.d.ts",
+      "default": "./dist/connectors.js"
+    },
+    "./source-engine": {
+      "types": "./dist/source-engine/index.d.ts",
+      "default": "./dist/source-engine/index.js"
+    },
+    "./source-harness": {
+      "types": "./dist/source-harness/index.d.ts",
+      "default": "./dist/source-harness/index.js"
+    },
+    "./recipe-lifecycle": {
+      "types": "./dist/recipe-lifecycle/index.d.ts",
+      "default": "./dist/recipe-lifecycle/index.js"
+    },
+    "./record-overlay": {
+      "types": "./dist/record-overlay/index.d.ts",
+      "default": "./dist/record-overlay/index.js"
+    },
+    "./bundle-health": {
+      "types": "./dist/bundle-health/index.d.ts",
+      "default": "./dist/bundle-health/index.js"
+    },
     "./kinds": {
       "types": "./dist/kinds.d.ts",
       "default": "./dist/kinds.js"
@@ -55,6 +95,18 @@
       "types": "./dist/links.d.ts",
       "default": "./dist/links.js"
     },
+    "./qualified-links": {
+      "types": "./dist/qualified-links.d.ts",
+      "default": "./dist/qualified-links.js"
+    },
+    "./dependencies": {
+      "types": "./dist/dependencies.d.ts",
+      "default": "./dist/dependencies.js"
+    },
+    "./cross-bundle": {
+      "types": "./dist/cross-bundle.d.ts",
+      "default": "./dist/cross-bundle.js"
+    },
     "./meaningful-change-time": {
       "types": "./dist/meaningful-change-time.d.ts",
       "default": "./dist/meaningful-change-time.js"
@@ -75,6 +127,22 @@
       "types": "./dist/publication-filesystem.d.ts",
       "default": "./dist/publication-filesystem.js"
     },
+    "./query-order": {
+      "types": "./dist/query-order.d.ts",
+      "default": "./dist/query-order.js"
+    },
+    "./path-fold": {
+      "types": "./dist/path-fold.d.ts",
+      "default": "./dist/path-fold.js"
+    },
+    "./code-unit-order": {
+      "types": "./dist/code-unit-order.d.ts",
+      "default": "./dist/code-unit-order.js"
+    },
+    "./string-identity-agreement": {
+      "types": "./dist/string-identity-agreement.d.ts",
+      "default": "./dist/string-identity-agreement.js"
+    },
     "./query-filter": {
       "types": "./dist/query-filter.d.ts",
       "default": "./dist/query-filter.js"
@@ -91,6 +159,18 @@
       "types": "./dist/remote-operations.d.ts",
       "default": "./dist/remote-operations.js"
     },
+    "./hosted-transport": {
+      "types": "./dist/hosted-transport/index.d.ts",
+      "default": "./dist/hosted-transport/index.js"
+    },
+    "./hosted-client": {
+      "types": "./dist/hosted-client/index.d.ts",
+      "default": "./dist/hosted-client/index.js"
+    },
+    "./hosted-client/node": {
+      "types": "./dist/hosted-client/node.d.ts",
+      "default": "./dist/hosted-client/node.js"
+    },
     "./storage": {
       "types": "./dist/storage.d.ts",
       "default": "./dist/storage.js"
@@ -111,6 +191,10 @@
       "types": "./dist/journaled-backend.d.ts",
       "default": "./dist/journaled-backend.js"
     },
+    "./file-journaled-backend": {
+      "types": "./dist/file-journaled-backend.d.ts",
+      "default": "./dist/file-journaled-backend.js"
+    },
     "./uncertain-write": {
       "types": "./dist/uncertain-write.d.ts",
       "default": "./dist/uncertain-write.js"
@@ -118,6 +202,58 @@
     "./platform": {
       "types": "./dist/platform.d.ts",
       "default": "./dist/platform.js"
+    },
+    "./filesystem": {
+      "types": "./dist/filesystem.d.ts",
+      "default": "./dist/filesystem.js"
+    },
+    "./filesystem-push-role": {
+      "types": "./dist/filesystem-push-role.d.ts",
+      "default": "./dist/filesystem-push-role.js"
+    },
+    "./view-launch-contract": {
+      "types": "./dist/view-launch-contract.d.ts",
+      "default": "./dist/view-launch-contract.js"
+    },
+    "./artifact-contract": {
+      "types": "./dist/artifact-contract.d.ts",
+      "default": "./dist/artifact-contract.js"
+    },
+    "./site-capabilities": {
+      "types": "./dist/site-capabilities.d.ts",
+      "default": "./dist/site-capabilities.js"
+    },
+    "./portable-export": {
+      "types": "./dist/portable-export.d.ts",
+      "default": "./dist/portable-export.js"
+    },
+    "./search": {
+      "types": "./dist/search/index.d.ts",
+      "default": "./dist/search/index.js"
+    },
+    "./builtin-recipes": {
+      "types": "./dist/builtin-recipes.d.ts",
+      "default": "./dist/builtin-recipes.js"
+    },
+    "./kind-authoring": {
+      "types": "./dist/kind-authoring.d.ts",
+      "default": "./dist/kind-authoring.js"
+    },
+    "./source-profiles": {
+      "types": "./dist/source-profiles/index.d.ts",
+      "default": "./dist/source-profiles/index.js"
+    },
+    "./domain-model": {
+      "types": "./dist/domain-model.d.ts",
+      "default": "./dist/domain-model.js"
+    },
+    "./recipe-set-preflight": {
+      "types": "./dist/recipe-set-preflight.d.ts",
+      "default": "./dist/recipe-set-preflight.js"
+    },
+    "./kind-changes": {
+      "types": "./dist/kind-changes.d.ts",
+      "default": "./dist/kind-changes.js"
     }
   },
   "files": [
@@ -131,10 +267,11 @@
     "build": "tsc",
     "typecheck": "tsc --noEmit",
     "test": "node --test --import ./test/ts-loader.mjs ./test/*.test.ts",
-    "mutation": "stryker run",
+    "mutation": "node --test --import ./test/ts-loader.mjs ./test/source-egress.test.ts && stryker run",
     "prepublishOnly": "node -e \"console.error('@superbee/core is released by .github/workflows/release-libraries.yml; do not run npm publish here'); process.exit(1)\""
   },
   "dependencies": {
+    "graphql": "17.0.2",
     "gray-matter": "^4.0.3",
     "js-yaml": "^3.15.2"
   },