@superbee/core 0.2.0-pre.3 → 0.2.0-pre.31

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/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.3",
+  "version": "0.2.0-pre.31",
   "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",
@@ -15,6 +15,10 @@
     "./dist/bundle.js"
   ],
   "exports": {
+    "./governed-body-write": {
+      "types": "./dist/governed-body-write.d.ts",
+      "default": "./dist/governed-body-write.js"
+    },
     "./view-admission": {
       "types": "./dist/view-admission.d.ts",
       "default": "./dist/view-admission.js"
@@ -43,6 +47,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"
@@ -51,6 +79,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"
@@ -71,6 +111,10 @@
       "types": "./dist/publication-filesystem.d.ts",
       "default": "./dist/publication-filesystem.js"
     },
+    "./query-order": {
+      "types": "./dist/query-order.d.ts",
+      "default": "./dist/query-order.js"
+    },
     "./query-filter": {
       "types": "./dist/query-filter.d.ts",
       "default": "./dist/query-filter.js"
@@ -87,6 +131,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"
@@ -107,6 +163,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"
@@ -114,6 +174,50 @@
     "./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"
+    },
+    "./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"
     }
   },
   "files": [
@@ -131,6 +235,7 @@
     "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"
   },