@superbee/core 0.1.6 → 0.2.0-pre.10

package/dist/bundle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../src/bundle.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAKtC,OAAO,KAAK,EACV,OAAO,EACP,MAAM,EACN,SAAS,EACT,aAAa,EACb,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,IAAI,EACJ,WAAW,EACX,WAAW,EACX,cAAc,EACd,UAAU,EACV,cAAc,EACd,OAAO,EACP,WAAW,EACX,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEzE,gEAAgE;AAChE,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAEzD;AAED,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAEtF;AAED,eAAO,MAAM,gCAAgC,yBAA0B,CAAC;AACxE,eAAO,MAAM,6BAA6B,QAAQ,CAAC;AAEnD,wBAAgB,0BAA0B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CASrE;AAED,qDAAqD;AACrD,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB/F;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,WAAW,EAChB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAE7B;AAED,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,WAAW,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAE7B;AAED,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,WAAW,EAChB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,WAAW,CAAC,CAEtB;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAEzF;AAED,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAEjF;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAE/E;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAEvF;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAExG;AAED,wBAAsB,KAAK,CACzB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,WAAgB,EACxB,OAAO,GAAE,MAAM,CAAC,YAAiB,GAChC,OAAO,CAAC,WAAW,EAAE,CAAC,CAExB;AAED,eAAO,MAAM,IAAI,cAAQ,CAAC;AAE1B,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,WAAgB,EACxB,OAAO,GAAE,MAAM,CAAC,YAAiB,GAChC,OAAO,CAAC,UAAU,EAAE,CAAC,CAEvB;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,EAAE,CAEpE;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,UAAe,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAEzF;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAElF;AAED,wBAAsB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAE3F;AAED,wBAAsB,SAAS,CAC7B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,UAAU,EACjB,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,OAAO,CAAC,CAElB;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAE/E;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAEnF;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAExG"}
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../src/bundle.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAMrE,OAAO,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EACL,UAAU,EACV,SAAS,EACT,UAAU,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,SAAS,EACT,IAAI,EACJ,SAAS,EACT,UAAU,EACV,KAAK,EACL,UAAU,EACV,UAAU,EACV,QAAQ,EACR,oBAAoB,EACpB,OAAO,EACP,gBAAgB,EAChB,SAAS,EACT,QAAQ,EACR,iBAAiB,EACjB,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC;AAIzB,eAAO,MAAM,gCAAgC,yBAA0B,CAAC;AACxE,eAAO,MAAM,6BAA6B,QAAQ,CAAC;AAEnD,wBAAgB,0BAA0B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CASrE;AAED,qDAAqD;AACrD,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,EAAE,iBAAiB,GAAE,wBAA6B,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBjJ"}

package/dist/bundle.js

@@ -1,24 +1,22 @@
 /**
- * Legacy bundle-shaped core API.
+ * Legacy bundle-shaped core API, Node entry.
  *
- * Portable semantics live in `engine.ts` and receive a backend explicitly. This adapter preserves
- * the historical `{ root, backend? }` signatures and filesystem fallback used by Node consumers.
+ * Portable semantics live in `engine.ts` and receive a backend explicitly; the bundle-shaped
+ * `{ root, backend? }` wrappers live in `bundle-ops.ts` so they bundle for the browser. This
+ * module owns what only a Node host can: the filesystem default for a bare `{ root }` and
+ * on-disk bundle initialization. Loading it installs that default, which is why `index.ts`
+ * imports it and why the package manifest marks it side-effectful.
  */
 import path from "node:path";
 import { FilesystemBackend } from "./backend.js";
-import * as engine from "./engine.js";
+import { setDefaultBackendFactory } from "./bundle-ops.js";
 import { InvalidInputError } from "./errors.js";
 import { stringifyWithData } from "./frontmatter.js";
 import { GENERATED_INDEX_MARKER } from "./index-marker.js";
 import { VersionConflict } from "./versioning.js";
 export { matchesFilter } from "./query-filter.js";
-/** Resolve the backend a legacy bundle operation should use. */
-export function backendFor(bundle) {
-    return bundle.backend ?? new FilesystemBackend(bundle.root);
-}
-export async function readBundleOkfVersion(bundle) {
-    return engine.readBundleOkfVersion(backendFor(bundle));
-}
+export { backendFor, backlinks, deleteBlob, deleteDoc, docVersions, existsBlob, existsDoc, list, listBlobs, parseLinks, query, queryEdges, queryHeads, readBlob, readBundleOkfVersion, readDoc, readDocVersioned, writeBlob, writeDoc, writeDocVersioned, writeDocVersionedForEdition, } from "./bundle-ops.js";
+setDefaultBackendFactory((root) => new FilesystemBackend(root));
 export const SUPPORTED_OKF_AUTHORING_VERSIONS = ["0.1", "0.2"];
 export const DEFAULT_OKF_AUTHORING_VERSION = "0.2";
 export function resolveOkfAuthoringVersion(requested) {
@@ -30,10 +28,10 @@ export function resolveOkfAuthoringVersion(requested) {
     return version;
 }
 /** Initialize or open a filesystem-backed bundle. */
-export async function initBundle(root, options = {}) {
+export async function initBundle(root, options = {}, filesystemOptions = {}) {
     const okfVersion = resolveOkfAuthoringVersion(options.okfVersion);
     const resolved = path.resolve(root);
-    const backend = new FilesystemBackend(resolved);
+    const backend = new FilesystemBackend(resolved, filesystemOptions);
     if (options.expectNew || (await backend.readReserved("", "index.md")) === null) {
         const name = path.basename(resolved);
         const body = `${GENERATED_INDEX_MARKER}\n# ${name}\n\nAn Open Knowledge Format bundle.\n`;
@@ -47,61 +45,6 @@ export async function initBundle(root, options = {}) {
                 throw err;
         }
     }
-    return { root: resolved };
-}
-export async function writeDocVersioned(bundle, doc, options) {
-    return engine.writeDocVersioned(backendFor(bundle), doc, options);
-}
-export async function writeDocVersionedForEdition(bundle, doc, okfVersion, options) {
-    return engine.writeDocVersionedForEdition(backendFor(bundle), doc, okfVersion, options);
-}
-export async function writeDoc(bundle, doc, options) {
-    return engine.writeDoc(backendFor(bundle), doc, options);
-}
-export async function readDocVersioned(bundle, id) {
-    return engine.readDocVersioned(backendFor(bundle), id);
-}
-export async function readDoc(bundle, id) {
-    return engine.readDoc(backendFor(bundle), id);
-}
-export async function existsDoc(bundle, id) {
-    return engine.existsDoc(backendFor(bundle), id);
-}
-export async function docVersions(bundle, id) {
-    return engine.docVersions(backendFor(bundle), id);
-}
-export async function deleteDoc(bundle, id, options) {
-    return engine.deleteDoc(backendFor(bundle), id, options);
-}
-export async function query(bundle, filter = {}, options = {}) {
-    return engine.query(backendFor(bundle), filter, options);
-}
-export const list = query;
-export async function queryHeads(bundle, filter = {}, options = {}) {
-    return engine.queryHeads(backendFor(bundle), filter, options);
-}
-export function parseLinks(_bundle, doc) {
-    return engine.parseLinks(doc);
-}
-export async function queryEdges(bundle, filter = {}) {
-    return engine.queryEdges(backendFor(bundle), filter);
-}
-export async function backlinks(bundle, target) {
-    return engine.backlinks(backendFor(bundle), target);
-}
-export async function readBlob(bundle, key) {
-    return engine.readBlob(backendFor(bundle), key);
-}
-export async function writeBlob(bundle, key, bytes, contentType, options) {
-    return engine.writeBlob(backendFor(bundle), key, bytes, contentType, options);
-}
-export async function existsBlob(bundle, key) {
-    return engine.existsBlob(backendFor(bundle), key);
-}
-export async function listBlobs(bundle, prefix) {
-    return engine.listBlobs(backendFor(bundle), prefix);
-}
-export async function deleteBlob(bundle, key, options) {
-    return engine.deleteBlob(backendFor(bundle), key, options);
+    return { root: resolved, backend };
 }
 //# sourceMappingURL=bundle.js.map

package/dist/bundle.js.map

@@ -1 +1 @@
-{"version":3,"file":"bundle.js","sourceRoot":"","sources":["../src/bundle.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bundle.js","sourceRoot":"","sources":["../src/bundle.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGlD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EACL,UAAU,EACV,SAAS,EACT,UAAU,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,SAAS,EACT,IAAI,EACJ,SAAS,EACT,UAAU,EACV,KAAK,EACL,UAAU,EACV,UAAU,EACV,QAAQ,EACR,oBAAoB,EACpB,OAAO,EACP,gBAAgB,EAChB,SAAS,EACT,QAAQ,EACR,iBAAiB,EACjB,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC;AAEzB,wBAAwB,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;AAEhE,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAU,CAAC;AACxE,MAAM,CAAC,MAAM,6BAA6B,GAAG,KAAK,CAAC;AAEnD,MAAM,UAAU,0BAA0B,CAAC,SAAkB;IAC3D,MAAM,OAAO,GAAG,SAAS,IAAI,6BAA6B,CAAC;IAC3D,IAAI,CAAE,gCAAsD,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/E,MAAM,IAAI,iBAAiB,CACzB,sCAAsC,OAAO,4BAA4B,gCAAgC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI;YACzH,oEAAoE,CACvE,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,qDAAqD;AACrD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,UAA6B,EAAE,EAAE,oBAA8C,EAAE;IAC9H,MAAM,UAAU,GAAG,0BAA0B,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IACnE,IAAI,OAAO,CAAC,SAAS,IAAI,CAAC,MAAM,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC/E,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,GAAG,sBAAsB,OAAO,IAAI,wCAAwC,CAAC;QAC1F,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,aAAa,CAAC,EAAE,EAAE,UAAU,EAAE,iBAAiB,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,IAAI,CAAC,EAAE;gBAChG,eAAe,EAAE,IAAI;aACtB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,YAAY,eAAe,CAAC;gBAAE,MAAM,GAAG,CAAC;QACxE,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AACrC,CAAC"}

package/dist/document-codec.d.ts

@@ -5,8 +5,13 @@
  */
 export { parseMarkdown, stringifyDoc, stringifyWithData, normalizeDocumentBodyForStorage, MalformedDocumentError, } from "./frontmatter.js";
 export { resolveContentType } from "./content-type.js";
+export { captureRemoteFrontmatter, RemoteDocumentValueError } from "./remote-document-codec.js";
 export type { Frontmatter, OkfDocument, Version } from "./types.js";
 import type { Version } from "./types.js";
-/** SHA-256 version of exact bytes, including binary data, using Web Crypto. */
+/**
+ * SHA-256 version of exact bytes, including binary data. Minted by the same pure
+ * implementation as every other version token, so one digest owner serves Node and
+ * browser runtimes; the async signature is kept for the codec's existing callers.
+ */
 export declare function versionFromBytes(bytes: Uint8Array): Promise<Version>;
 //# sourceMappingURL=document-codec.d.ts.map

package/dist/document-codec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document-codec.d.ts","sourceRoot":"","sources":["../src/document-codec.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,+BAA+B,EAC/B,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,+EAA+E;AAC/E,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAI1E"}
+{"version":3,"file":"document-codec.d.ts","sourceRoot":"","sources":["../src/document-codec.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,+BAA+B,EAC/B,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAChG,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAGpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAE1E"}

package/dist/document-codec.js

@@ -5,10 +5,14 @@
  */
 export { parseMarkdown, stringifyDoc, stringifyWithData, normalizeDocumentBodyForStorage, MalformedDocumentError, } from "./frontmatter.js";
 export { resolveContentType } from "./content-type.js";
-/** SHA-256 version of exact bytes, including binary data, using Web Crypto. */
+export { captureRemoteFrontmatter, RemoteDocumentValueError } from "./remote-document-codec.js";
+import { sha256HexOfBytes } from "./sha256.js";
+/**
+ * SHA-256 version of exact bytes, including binary data. Minted by the same pure
+ * implementation as every other version token, so one digest owner serves Node and
+ * browser runtimes; the async signature is kept for the codec's existing callers.
+ */
 export async function versionFromBytes(bytes) {
-    const digest = await globalThis.crypto.subtle.digest("SHA-256", new Uint8Array(bytes).buffer);
-    const hex = Array.from(new Uint8Array(digest), (byte) => byte.toString(16).padStart(2, "0")).join("");
-    return `sha256:${hex}`;
+    return `sha256:${sha256HexOfBytes(bytes)}`;
 }
 //# sourceMappingURL=document-codec.js.map

package/dist/document-codec.js.map

@@ -1 +1 @@
-{"version":3,"file":"document-codec.js","sourceRoot":"","sources":["../src/document-codec.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,+BAA+B,EAC/B,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAKvD,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAiB;IACtD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC;IAC9F,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtG,OAAO,UAAU,GAAG,EAAE,CAAC;AACzB,CAAC"}
+{"version":3,"file":"document-codec.js","sourceRoot":"","sources":["../src/document-codec.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,+BAA+B,EAC/B,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAGhG,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAiB;IACtD,OAAO,UAAU,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;AAC7C,CAAC"}

package/dist/document-field-actions.d.ts

@@ -0,0 +1,107 @@
+import { InvalidInputError } from "./errors.js";
+import { type KindRegistry } from "./kinds.js";
+import type { Frontmatter, OkfDocument } from "./types.js";
+import type { DocumentMutationCandidate } from "./document-mutation.js";
+export type SourceEntry = {
+    resource: string;
+    id?: string;
+    [property: string]: unknown;
+};
+export type SourceSelector = {
+    id: string;
+    resource?: never;
+} | {
+    resource: string;
+    id?: never;
+};
+export interface SourceCandidateIdentity {
+    id?: string;
+    resource?: string;
+    title?: string;
+}
+export interface FieldActionErrorDetails {
+    reason: "ambiguous-source" | "source-has-id" | "source-not-found" | "source-id-conflict" | "invalid-source-id" | "unsupported-set-field";
+    field: string;
+    supportedFields?: string[];
+    selector?: SourceSelector;
+    recommendedSelector?: SourceSelector;
+    candidates?: SourceCandidateIdentity[];
+    total?: number;
+}
+/** Adapters can render corrective commands without parsing prose or repeating selection. */
+export declare class FieldActionError extends InvalidInputError {
+    readonly details: FieldActionErrorDetails;
+    constructor(message: string, details: FieldActionErrorDetails);
+}
+export type FieldAction = {
+    action: "set";
+    field: string;
+    value: unknown;
+} | {
+    action: "add";
+    field: "tags";
+    value: string;
+} | {
+    action: "add";
+    field: "sources";
+    value: SourceEntry;
+} | {
+    action: "remove";
+    field: "tags";
+    value: string;
+} | {
+    action: "remove";
+    field: "sources";
+    selector: SourceSelector;
+} | {
+    action: "edit";
+    field: "sources";
+    selector: SourceSelector;
+    patch: Record<string, unknown>;
+}
+/**
+ * Select the one entry whose (`resource`, `id`) pair equals the value's, by the shared
+ * `sources[]` identity rule, and merge the value's properties into it; append the value when
+ * no entry carries the pair. The ID must be nonempty because an upsert may mint it, and it
+ * may not already name an entry under another resource.
+ */
+ | {
+    action: "upsert";
+    field: "sources";
+    value: SourceEntry & {
+        id: string;
+    };
+} | {
+    action: "replace-all";
+    field: "tags";
+    value: string[];
+} | {
+    action: "replace-all";
+    field: "sources";
+    value: SourceEntry[];
+};
+export interface FieldActionScope {
+    field: string;
+    action: FieldAction["action"];
+    outcome: "added" | "removed" | "edited" | "unchanged" | "replaced";
+    selector?: SourceSelector;
+    affectedSourceIds?: string[];
+}
+export interface FieldActionContext {
+    registry: KindRegistry;
+    okfVersion: "0.1" | "0.2";
+    now?: () => string;
+}
+export interface PreparedDocumentFieldAction {
+    candidate: DocumentMutationCandidate;
+    scope: FieldActionScope;
+    storageField: string;
+}
+export declare function isStandardDocumentSetField(field: string, okfVersion: "0.1" | "0.2"): boolean;
+export declare function containsCollection(value: unknown): boolean;
+export declare function assertNonCollectionAssignment(field: string, previous: unknown, value: unknown): void;
+export declare function assertOrdinaryPatch(existing: Frontmatter, proposed: Frontmatter): void;
+/** Semantic legacy assignments retain input intent, including explicitly equal assignments. */
+export declare function prepareDocumentAssignments(existing: OkfDocument, assignments: Record<string, unknown>): DocumentMutationCandidate;
+export declare function prepareDocumentFieldAction(existing: OkfDocument, action: FieldAction, context: FieldActionContext): PreparedDocumentFieldAction;
+//# sourceMappingURL=document-field-actions.d.ts.map

package/dist/document-field-actions.d.ts.map

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

package/dist/document-field-actions.js

@@ -0,0 +1,302 @@
+/** Explicit frontmatter intent. Collection construction is owned here, before CAS metadata. */
+import { isManagedDocumentMetadataField } from "./managed-document-metadata.js";
+import { InvalidInputError } from "./errors.js";
+import { okfValuesEqual } from "./okf-authored-values.js";
+import { kindInputFieldNames, resolveKindFieldCoordinate } from "./kinds.js";
+import { matchesSourceIdentity } from "./query-filter.js";
+/** Adapters can render corrective commands without parsing prose or repeating selection. */
+export class FieldActionError extends InvalidInputError {
+    details;
+    constructor(message, details) {
+        super(message);
+        this.name = "FieldActionError";
+        this.details = details;
+    }
+}
+const standard = new Set(["title", "description", "type", "resource"]);
+const v02 = new Set(["status", "stale_after", "usage_window"]);
+export function isStandardDocumentSetField(field, okfVersion) {
+    return standard.has(field) || (okfVersion === "0.2" && v02.has(field));
+}
+function record(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function has(object, key) { return Object.prototype.hasOwnProperty.call(object, key); }
+function sourceCandidates(rows) {
+    return {
+        total: rows.length,
+        candidates: rows.slice(0, 5).map(row => {
+            const identity = {};
+            for (const key of ["id", "resource", "title"]) {
+                if (record(row) && has(row, key) && typeof row[key] === "string")
+                    identity[key] = row[key];
+            }
+            return identity;
+        }),
+    };
+}
+export function containsCollection(value) {
+    return Array.isArray(value) || (record(value) && Object.values(value).some(containsCollection));
+}
+export function assertNonCollectionAssignment(field, previous, value) {
+    if (containsCollection(previous) || containsCollection(value)) {
+        const correction = field === "tags" || field === "sources"
+            ? `Use an explicit ${field} add/remove/replace-all collection action.`
+            : "Use complete-document replacement: pull --doc-key <id>.md --out <file>, edit that file, then promote <file> --doc-key <id>.md --expected-version <version-from-pull>.";
+        throw new InvalidInputError(`Cannot assign '${field}': the old or new subtree contains a list. ${correction}`);
+    }
+}
+export function assertOrdinaryPatch(existing, proposed) {
+    for (const field of new Set([...Object.keys(existing), ...Object.keys(proposed)])) {
+        if (!okfValuesEqual(existing[field], proposed[field]))
+            assertNonCollectionAssignment(field, existing[field], proposed[field]);
+    }
+}
+function assertAssignmentName(field) {
+    if (isManagedDocumentMetadataField(field))
+        throw new InvalidInputError(`'${field}' is managed metadata and cannot be assigned by a field action.`);
+    if (field === "tags" || field === "sources")
+        throw new InvalidInputError(`'${field}' requires an explicit collection add/remove/replace-all action.`);
+}
+/** Semantic legacy assignments retain input intent, including explicitly equal assignments. */
+export function prepareDocumentAssignments(existing, assignments) {
+    if (!record(assignments))
+        throw new InvalidInputError("assignments must be a mapping");
+    for (const [field, value] of Object.entries(assignments)) {
+        assertAssignmentName(field);
+        assertNonCollectionAssignment(field, existing.frontmatter[field], value);
+    }
+    return { frontmatter: { ...existing.frontmatter, ...structuredClone(assignments) }, body: existing.body };
+}
+function sourceRow(value) {
+    if (!record(value) || typeof value.resource !== "string" || value.resource.trim() === "")
+        throw new InvalidInputError("A source entry requires a nonempty resource string.");
+    if (has(value, "id") && typeof value.id !== "string")
+        throw new InvalidInputError("A supplied source ID must be a string.");
+}
+function selectorIndex(rows, selector, edit) {
+    if (!record(selector) || Object.keys(selector).length !== 1 || !(has(selector, "id") || has(selector, "resource")))
+        throw new InvalidInputError("Select one source by exactly one id or resource.");
+    const key = has(selector, "id") ? "id" : "resource";
+    const value = selector[key];
+    // An imported empty ID is still an existing ID; it may be selected exactly but is never minted.
+    if (typeof value !== "string" || (key === "resource" && value.trim() === ""))
+        throw new InvalidInputError(`Source ${key} selector must be a string.`);
+    const matches = rows.flatMap((row, index) => record(row) && has(row, key) && row[key] === value ? [index] : []);
+    if (matches.length > 1)
+        throw new FieldActionError(`Source selector is ambiguous (${matches.length} matches); inspect sources and use a unique ID or version-guarded replace-all.`, {
+            reason: "ambiguous-source", field: "sources", selector: structuredClone(selector), ...sourceCandidates(matches.map(index => rows[index])),
+        });
+    if (matches.length === 0) {
+        if (edit)
+            throw new FieldActionError(`Source ${key} '${value}' was not found.`, {
+                reason: "source-not-found", field: "sources", selector: structuredClone(selector), ...sourceCandidates([]),
+            });
+        return -1;
+    }
+    const index = matches[0];
+    if (key === "resource" && has(rows[index], "id")) {
+        const id = rows[index].id;
+        if (typeof id !== "string")
+            throw new FieldActionError("This source has a malformed ID; repair it with version-guarded replace-all.", {
+                reason: "invalid-source-id", field: "sources", selector: structuredClone(selector), ...sourceCandidates([rows[index]]),
+            });
+        throw new FieldActionError(`This resource has source ID '${id}'; select it with --id.`, {
+            reason: "source-has-id", field: "sources", selector: structuredClone(selector), recommendedSelector: { id }, ...sourceCandidates([rows[index]]),
+        });
+    }
+    return index;
+}
+export function prepareDocumentFieldAction(existing, action, context) {
+    if (!record(action) || typeof action.field !== "string")
+        throw new InvalidInputError("A field action requires a field name.");
+    if (action.action === "set")
+        assertAssignmentName(action.field);
+    const keys = action.action === "edit" ? ["action", "field", "selector", "patch"]
+        : action.action === "remove" && action.field === "sources" ? ["action", "field", "selector"]
+            : ["action", "field", "value"];
+    if (Object.keys(action).some(key => !keys.includes(key)) || keys.some(key => !has(action, key)))
+        throw new InvalidInputError("Field action has missing or incompatible input properties.");
+    if ("value" in action && action.value === undefined)
+        throw new InvalidInputError("A field action value must be supplied; removing a field is not supported.");
+    let storageField = action.field;
+    let candidate = { frontmatter: structuredClone(existing.frontmatter), body: existing.body };
+    const scope = { field: action.field, action: action.action, outcome: "unchanged" };
+    if (action.action === "set") {
+        const kind = context.registry.kinds.get(String(existing.frontmatter.type));
+        const coordinate = kind && resolveKindFieldCoordinate(context.okfVersion, kind, action.field);
+        if (context.okfVersion === "0.1" && (action.field === "stale_after" || action.field === "usage_window"))
+            throw new InvalidInputError(`'${action.field}' requires OKF v0.2.`);
+        if (!isStandardDocumentSetField(action.field, context.okfVersion) && !coordinate) {
+            const supportedFields = [...new Set([
+                    ...standard,
+                    ...(context.okfVersion === "0.2" ? v02 : []),
+                    ...(kind ? kindInputFieldNames(context.okfVersion, kind) : []),
+                ])].filter(field => {
+                if (isManagedDocumentMetadataField(field) || field === "tags" || field === "sources")
+                    return false;
+                if (context.okfVersion === "0.1" && (field === "stale_after" || field === "usage_window"))
+                    return false;
+                const storage = kind && resolveKindFieldCoordinate(context.okfVersion, kind, field);
+                return !containsCollection(existing.frontmatter[storage?.storageField ?? field]);
+            }).sort();
+            throw new FieldActionError(`Unsupported set field '${action.field}'; supported fields: ${supportedFields.join(", ")}.`, {
+                reason: "unsupported-set-field", field: action.field, supportedFields,
+            });
+        }
+        storageField = coordinate?.storageField ?? action.field;
+        candidate = prepareDocumentAssignments(existing, { [storageField]: action.value });
+        if (!okfValuesEqual(existing.frontmatter[storageField], action.value))
+            scope.outcome = "edited";
+        if (scope.outcome !== "unchanged" && context.okfVersion === "0.1")
+            candidate.frontmatter.timestamp = (context.now ?? (() => new Date().toISOString()))();
+        return { candidate, scope, storageField };
+    }
+    if (action.field !== "tags" && action.field !== "sources")
+        throw new InvalidInputError("Collection actions support only tags and sources.");
+    if (!["add", "remove", "edit", "replace-all", "upsert"].includes(action.action))
+        throw new InvalidInputError("Unknown field action.");
+    if (action.field === "sources" && context.okfVersion !== "0.2")
+        throw new InvalidInputError("sources actions require OKF v0.2.");
+    const previous = existing.frontmatter[action.field];
+    let rows;
+    if (action.action === "replace-all") {
+        if (!Array.isArray(action.value))
+            throw new InvalidInputError("replace-all requires a complete list (including [] to empty it).");
+        // Authored-value validation owns row compatibility; replacement permits deliberate duplicates.
+        rows = structuredClone(action.value);
+        if (action.field === "tags" && rows.some(value => typeof value !== "string"))
+            throw new InvalidInputError("tags must be a list of strings.");
+        scope.outcome = okfValuesEqual(previous, rows) ? "unchanged" : "replaced";
+    }
+    else {
+        if (previous !== undefined && !Array.isArray(previous))
+            throw new InvalidInputError(`'${action.field}' is not a list; repair it with version-guarded replace-all.`);
+        rows = structuredClone(previous ?? []);
+        if (action.field === "tags") {
+            if (["edit", "upsert"].includes(action.action))
+                throw new InvalidInputError(`tags supports add/remove/replace-all, not ${action.action}.`);
+            if (typeof action.value !== "string")
+                throw new InvalidInputError("A tag must be a string.");
+            if (action.action === "add" && !rows.includes(action.value)) {
+                rows.push(action.value);
+                scope.outcome = "added";
+            }
+            if (action.action === "remove" && rows.includes(action.value)) {
+                rows = rows.filter(row => row !== action.value);
+                scope.outcome = "removed";
+            }
+        }
+        else if (action.action === "upsert") {
+            sourceRow(action.value);
+            const value = action.value;
+            if (typeof value.id !== "string" || value.id.trim() === "")
+                throw new InvalidInputError("A source upsert requires a nonempty id.");
+            for (const [property, entry] of Object.entries(value)) {
+                if (entry === undefined)
+                    throw new InvalidInputError("Source upsert properties must have values.");
+                if (containsCollection(entry))
+                    throw new InvalidInputError(`Cannot assign source property '${property}': the new subtree contains a list. Use sources replace-all with an observed version.`);
+            }
+            const identity = { resource: value.resource, id: value.id };
+            const matches = rows.flatMap((row, index) => matchesSourceIdentity(row, identity) ? [index] : []);
+            if (matches.length > 1)
+                throw new FieldActionError(`Source identity is ambiguous (${matches.length} matches); repair duplicates with version-guarded replace-all.`, {
+                    reason: "ambiguous-source", field: "sources", selector: { id: value.id }, ...sourceCandidates(matches.map(index => rows[index])),
+                });
+            scope.affectedSourceIds = [value.id];
+            if (matches.length === 1) {
+                const old = rows[matches[0]];
+                for (const property of Object.keys(value)) {
+                    if (containsCollection(old[property]))
+                        throw new InvalidInputError(`Cannot assign source property '${property}': the old subtree contains a list. Use sources replace-all with an observed version.`);
+                }
+                const next = { ...old, ...structuredClone(value) };
+                if (!okfValuesEqual(old, next)) {
+                    rows[matches[0]] = next;
+                    scope.outcome = "edited";
+                }
+            }
+            else {
+                const sameId = rows.filter(row => record(row) && row.id === value.id);
+                if (sameId.length > 0)
+                    throw new FieldActionError(`Source ID '${value.id}' already names an entry under another resource; a document-local ID is never minted twice.`, {
+                        reason: "source-id-conflict", field: "sources", selector: { id: value.id }, recommendedSelector: { id: value.id }, ...sourceCandidates(sameId),
+                    });
+                rows.push(structuredClone(value));
+                scope.outcome = "added";
+            }
+        }
+        else if (action.action === "add") {
+            sourceRow(action.value);
+            if (has(action.value, "id")) {
+                const matches = rows.filter(row => record(row) && row.id === action.value.id);
+                if (matches.length > 1)
+                    throw new FieldActionError("Source ID is ambiguous; repair duplicate IDs with replace-all.", {
+                        reason: "ambiguous-source", field: "sources", selector: { id: action.value.id }, ...sourceCandidates(matches),
+                    });
+                if (matches.length === 1 && !okfValuesEqual(matches[0], action.value))
+                    throw new FieldActionError("Source ID conflicts with an existing entry; use edit with its observed version.", {
+                        reason: "source-id-conflict", field: "sources", selector: { id: action.value.id }, recommendedSelector: { id: action.value.id }, ...sourceCandidates(matches),
+                    });
+            }
+            if (!rows.some(row => okfValuesEqual(row, action.value))) {
+                rows.push(structuredClone(action.value));
+                scope.outcome = "added";
+            }
+            if (action.value.id !== undefined)
+                scope.affectedSourceIds = [action.value.id];
+        }
+        else {
+            const index = selectorIndex(rows, action.selector, action.action === "edit");
+            scope.selector = structuredClone(action.selector);
+            if (index >= 0) {
+                const old = rows[index];
+                if (typeof old.id === "string")
+                    scope.affectedSourceIds = [old.id];
+                if (action.action === "remove") {
+                    rows.splice(index, 1);
+                    scope.outcome = "removed";
+                }
+                else {
+                    if (!record(action.patch))
+                        throw new InvalidInputError("A source edit requires a property mapping.");
+                    for (const [property, value] of Object.entries(action.patch)) {
+                        if (value === undefined)
+                            throw new InvalidInputError("Source edit properties must have values.");
+                        if (containsCollection(old[property]) || containsCollection(value))
+                            throw new InvalidInputError(`Cannot assign source property '${property}': the old or new subtree contains a list. Use sources replace-all with an observed version.`);
+                    }
+                    if (has(action.patch, "id")) {
+                        if (has(old, "id")) {
+                            if (action.patch.id !== old.id)
+                                throw new InvalidInputError("An existing source ID cannot change or be removed; use replace-all.");
+                        }
+                        else {
+                            if (typeof action.patch.id !== "string" || action.patch.id.trim() === "")
+                                throw new InvalidInputError("The first source ID must be a nonempty string.");
+                            if (rows.some((row, i) => i !== index && record(row) && row.id === action.patch.id))
+                                throw new InvalidInputError("The first source ID collides with an existing ID.");
+                            scope.affectedSourceIds = [action.patch.id];
+                        }
+                    }
+                    const next = { ...old, ...structuredClone(action.patch) };
+                    if (!okfValuesEqual(old, next)) {
+                        rows[index] = next;
+                        scope.outcome = "edited";
+                    }
+                }
+            }
+        }
+    }
+    // A missing collection removed from remains missing: a membership no-op writes no normalization.
+    if (scope.outcome !== "unchanged")
+        candidate.frontmatter[action.field] = rows;
+    if (action.field === "sources" && action.action === "replace-all") {
+        scope.affectedSourceIds = [...new Set([...(Array.isArray(previous) ? previous : []), ...rows].flatMap(row => record(row) && typeof row.id === "string" ? [row.id] : []))];
+    }
+    if (scope.outcome !== "unchanged" && context.okfVersion === "0.1")
+        candidate.frontmatter.timestamp = (context.now ?? (() => new Date().toISOString()))();
+    return { candidate, scope, storageField };
+}
+//# sourceMappingURL=document-field-actions.js.map