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

package/dist/source-harness/peer.js

@@ -0,0 +1,106 @@
+export class ScriptedPeer {
+    /** Every request that reached the provider, in order. */
+    received = [];
+    handler;
+    onHang;
+    constructor(handler, options = {}) {
+        this.handler = handler;
+        this.onHang = options.onHang;
+    }
+    answer(request) {
+        const copy = { url: request.url, method: request.method, headers: { ...request.headers }, ...(request.body !== undefined ? { body: request.body } : {}) };
+        this.received.push(copy);
+        const response = this.handler(copy);
+        if ("hang" in response)
+            this.onHang?.();
+        return response;
+    }
+    /** Requests received for one hostname. */
+    to(hostname) {
+        return this.received.filter((request) => new URL(request.url).hostname === hostname);
+    }
+}
+const normalized = (url) => {
+    try {
+        const parsed = new URL(url);
+        parsed.hash = "";
+        return parsed.href;
+    }
+    catch {
+        return url;
+    }
+};
+/** A peer answering from exchanges, each used once, matched on method and URL in order. */
+export class ExchangePeer extends ScriptedPeer {
+    /** Requests no exchange matched (answered 404); robots.txt is answered 404 without being listed. */
+    unscripted;
+    pending;
+    constructor(exchanges, options = {}) {
+        const pending = [...exchanges];
+        const unscripted = [];
+        super((request) => {
+            const url = normalized(request.url);
+            const index = pending.findIndex((exchange) => (exchange.request.method ?? "GET") === request.method && normalized(exchange.request.url) === url);
+            if (index === -1) {
+                if (new URL(url).pathname !== "/robots.txt")
+                    unscripted.push(`${request.method} ${url}`);
+                return { status: 404, body: "" };
+            }
+            return pending.splice(index, 1)[0].response;
+        }, options);
+        this.pending = pending;
+        this.unscripted = unscripted;
+    }
+    /** Exchanges no request used. */
+    unused() {
+        return [...this.pending];
+    }
+}
+const utf8Bytes = (text) => new TextEncoder().encode(text).length;
+const abortedError = () => Object.assign(new Error("request aborted"), { name: "AbortError" });
+/**
+ * A transport over a scripted peer. It adds `credential` only when the engine marks the request
+ * as toward a credential host and the URL itself is https on the default port with a host exactly
+ * one of the credential's hosts. It returns redirects unfollowed, refuses a body over `maxBytes`
+ * and rejects when the request's signal aborts.
+ */
+export function peerTransport(peer, options = {}) {
+    const credential = options.credential;
+    return {
+        async request(input) {
+            if (input.signal?.aborted)
+                throw abortedError();
+            const url = new URL(input.url);
+            const headers = {};
+            for (const [name, value] of Object.entries(input.headers))
+                headers[name.toLowerCase()] = value;
+            const toCredentialHost = url.protocol === "https:" && url.port === "" && url.username === "" && credential?.hosts.includes(url.hostname) === true;
+            if (credential && input.credentialHost === true && toCredentialHost)
+                headers[credential.header.toLowerCase()] = credential.value;
+            const response = peer.answer({ url: url.href, method: input.method, headers, ...(input.body !== undefined ? { body: input.body } : {}) });
+            if ("fail" in response)
+                throw new Error("connection failed");
+            if ("hang" in response) {
+                const signal = input.signal;
+                if (!signal)
+                    throw abortedError();
+                await new Promise((resolve) => {
+                    if (signal.aborted)
+                        resolve();
+                    else
+                        signal.addEventListener("abort", () => resolve(), { once: true });
+                });
+                throw abortedError();
+            }
+            const body = response.body ?? "";
+            const bytes = utf8Bytes(body);
+            if (bytes > input.maxBytes)
+                return { ok: false, refused: "too_large" };
+            const lower = {};
+            for (const [name, value] of Object.entries(response.headers ?? {}))
+                lower[name.toLowerCase()] = value;
+            return { ok: true, status: response.status, headers: lower, body, bytes };
+        },
+    };
+}
+//# sourceMappingURL=peer.js.map

package/dist/source-harness/peer.js.map

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

package/dist/source-profiles/index.d.ts

@@ -0,0 +1,31 @@
+/** Credential-free declarative profiles. All requests go through the source engine's transport. */
+import { nextLinkTarget } from "./link-header.js";
+import type { ConnectorSource } from "../connectors.js";
+import type { SourceProfile } from "../source-engine/types.js";
+import { unsupportedContent } from "../source-engine/index.js";
+export interface RestJsonCursor {
+    token?: string;
+    url?: string;
+    page?: number;
+    offset?: number;
+    watermark?: string;
+    /** The watermark at the beginning of a pass; stable while that pass pages. */
+    since?: string;
+}
+export declare const restJsonProfile: SourceProfile<ConnectorSource, RestJsonCursor>;
+/** Contract-1 composition helpers for explicitly trusted standalone source plugins. */
+export declare const SOURCE_PLUGIN_CORE_VERSION = "0.2.0-pre.40";
+export interface SourcePluginHelpers {
+    readonly restJsonProfile: typeof restJsonProfile;
+    readonly nextLinkTarget: typeof nextLinkTarget;
+    readonly unsupportedContent: typeof unsupportedContent;
+}
+export { nextLinkTarget };
+export declare const SOURCE_PROFILES: readonly Readonly<{
+    id: string;
+    version: number;
+    kind: "generic" | "extension";
+}>[];
+/** Inert lookup. Extensions are explicit caller imports, never discovered or executed here. */
+export declare function getSourceProfile(id: string): SourceProfile<ConnectorSource, RestJsonCursor> | undefined;
+//# sourceMappingURL=index.d.ts.map

package/dist/source-profiles/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/source-profiles/index.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAuCD,eAAO,MAAM,eAAe,EAAE,aAAa,CAAC,eAAe,EAAE,cAAc,CAuGzE,CAAC;AAEH,uFAAuF;AACvF,eAAO,MAAM,0BAA0B,iBAAiB,CAAC;AAEzD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,eAAe,EAAE,OAAO,eAAe,CAAC;IACjD,QAAQ,CAAC,cAAc,EAAE,OAAO,cAAc,CAAC;IAC/C,QAAQ,CAAC,kBAAkB,EAAE,OAAO,kBAAkB,CAAC;CACxD;AACD,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B,eAAO,MAAM,eAAe;;;;IAAiI,CAAC;AAC9J,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,CAAC,eAAe,EAAE,cAAc,CAAC,GAAG,SAAS,CAEvG"}

package/dist/source-profiles/index.js

@@ -0,0 +1,206 @@
+/** Credential-free declarative profiles. All requests go through the source engine's transport. */
+import { nextLinkTarget } from "./link-header.js";
+import { validateConnectorRequest, readSourcePath, renderRequestValue } from "../connectors.js";
+import { unsupportedContent } from "../source-engine/index.js";
+const object = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
+const scalar = (v) => v === null || typeof v === "string" || typeof v === "boolean" || typeof v === "number" && Number.isFinite(v);
+function put(record, path, value) {
+    const names = path.split(".");
+    let next = record;
+    for (const name of names.slice(0, -1)) {
+        if (!object(next[name]))
+            next[name] = {};
+        next = next[name];
+    }
+    next[names[names.length - 1]] = value;
+}
+function transform(value, type) {
+    if (value === undefined || value === null || type === undefined)
+        return value;
+    if (!scalar(value))
+        unsupportedContent("transform requires a scalar");
+    switch (type) {
+        case "text": return String(value);
+        case "integer": {
+            if (typeof value === "boolean" || !/^-?\d+$/.test(String(value)) || !Number.isSafeInteger(Number(value)))
+                unsupportedContent("invalid integer");
+            return Number(value);
+        }
+        case "date":
+        case "epoch-date": {
+            const ms = type === "epoch-date" ? Number(value) * 1000 : Date.parse(String(value));
+            if (!Number.isFinite(ms))
+                unsupportedContent("invalid date");
+            try {
+                return new Date(ms).toISOString();
+            }
+            catch {
+                unsupportedContent("invalid date");
+            }
+        }
+        case "url": {
+            try {
+                const url = new URL(String(value));
+                if (url.protocol !== "https:" && url.protocol !== "http:" || url.username || url.password)
+                    unsupportedContent("invalid URL");
+                return url.href;
+            }
+            catch {
+                unsupportedContent("invalid URL");
+            }
+        }
+        default: unsupportedContent("unknown transform");
+    }
+}
+export const restJsonProfile = Object.freeze({
+    id: "rest-json",
+    version: 1,
+    kind: "generic",
+    validateSpec(value) {
+        if (!object(value) || !object(value.identity) || typeof value.identity.resource !== "string" || !object(value.request))
+            return { ok: false, errors: [{ path: "/request", message: "rest-json requires a source with identity and request" }] };
+        const source = value;
+        const errors = validateConnectorRequest(source);
+        if (source.request?.graphql)
+            errors.push({ path: "/request/graphql", message: "use graphql-cursor for GraphQL" });
+        return errors.length ? { ok: false, errors } : { ok: true, spec: JSON.parse(JSON.stringify(source)) };
+    },
+    hostsFor: (source) => [source.request.host],
+    async observe(ctx) {
+        const { spec, bound, transport, resumed, mode } = ctx;
+        const r = spec.request;
+        const paging = r.paging;
+        const previous = ctx.cursor;
+        const validCursor = (value) => value === null || object(value) && Object.entries(value).every(([key, v]) => ["token", "url", "watermark", "since"].includes(key) ? typeof v === "string" : ["page", "offset"].includes(key) && typeof v === "number");
+        if (!validCursor(previous))
+            unsupportedContent("invalid cursor");
+        const numeric = paging?.kind === "page-number" || paging?.kind === "offset";
+        const start = mode === "complete" && previous === null;
+        const page = numeric && resumed ? 1 : previous?.page ?? 1;
+        const offset = numeric && resumed ? 0 : previous?.offset ?? 0;
+        if (!Number.isSafeInteger(page) || page < 1 || !Number.isSafeInteger(offset) || offset < 0)
+            unsupportedContent("invalid numeric cursor");
+        let since = previous?.since;
+        if (since === undefined && previous?.watermark && r.watermark && !start) {
+            const ms = Date.parse(previous.watermark) - r.watermark.overlap_seconds * 1000;
+            if (!Number.isFinite(ms))
+                unsupportedContent("invalid watermark");
+            since = new Date(ms).toISOString();
+        }
+        const dynamic = { cursor: previous?.token ?? "", page: String(paging?.kind === "offset" ? offset : page), watermark: since ?? "" };
+        const render = (v) => renderRequestValue(v, bound.parameters, dynamic);
+        const path = r.path.replace(/\{([A-Za-z][A-Za-z0-9_]*)\}/g, (_, name) => {
+            const value = bound.parameters[name] ?? dynamic[name];
+            if (value === undefined || value === "." || value === "..")
+                unsupportedContent("missing request binding");
+            return encodeURIComponent(value);
+        });
+        const target = new URL(`https://${r.host}${path}`);
+        for (const [name, value] of Object.entries(r.query ?? {})) {
+            if (value === "{cursor}" && !previous?.token || value === "{watermark}" && !since)
+                continue;
+            target.searchParams.set(name, String(render(value)));
+        }
+        if (paging?.size_param && paging.size)
+            target.searchParams.set(paging.size_param, String(paging.size));
+        if (paging?.kind === "page-number")
+            target.searchParams.set(paging.page_param, String(page));
+        if (paging?.kind === "offset")
+            target.searchParams.set(paging.offset_param, String(offset));
+        if (r.watermark && since)
+            target.searchParams.set(r.watermark.param, since);
+        const headers = Object.fromEntries(Object.entries(r.headers ?? { accept: "application/json" }).map(([k, v]) => [k, String(render(v))]));
+        if (ctx.validators && mode === "incremental")
+            for (const [k, v] of Object.entries(ctx.validators))
+                headers[k] = v;
+        const body = r.body ? JSON.stringify(Object.fromEntries(Object.entries(r.body).map(([k, v]) => [k, render(v)]))) : undefined;
+        // Provider URLs are never rendered as templates. The engine checks the provider's listed paging forms.
+        const response = await transport.request({ url: numeric && resumed ? target.href : previous?.url ?? target.href, method: r.method, headers, ...(body !== undefined ? { body } : {}) });
+        if (response.status === 304)
+            return { records: [], nextCursor: previous, more: false, complete: false };
+        let parsed;
+        try {
+            parsed = JSON.parse(response.body);
+        }
+        catch {
+            unsupportedContent("invalid_json");
+        }
+        const items = readSourcePath(parsed, r.items);
+        if (!Array.isArray(items) || !items.every(object))
+            unsupportedContent("items must be an array of records");
+        let watermark = previous?.watermark;
+        let skipped = 0;
+        const records = [];
+        for (const item of items) {
+            if (r.watermark) {
+                const value = readSourcePath(item, r.watermark.field);
+                if (typeof value !== "string" || !Number.isFinite(Date.parse(value)))
+                    unsupportedContent("invalid record watermark");
+                if (!watermark || Date.parse(value) > Date.parse(watermark))
+                    watermark = new Date(value).toISOString();
+            }
+            if (r.skip?.some(rule => readSourcePath(item, rule.path) !== undefined)) {
+                skipped++;
+                continue;
+            }
+            const normalized = JSON.parse(JSON.stringify(item));
+            for (const [name, field] of Object.entries(r.fields ?? {})) {
+                const value = Object.hasOwn(field, "const") ? field.const : transform(readSourcePath(item, field.from), field.type);
+                if (value !== undefined)
+                    put(normalized, name, value);
+            }
+            records.push(normalized);
+        }
+        let token;
+        let url;
+        let more = false;
+        if (paging?.kind === "link-header") {
+            url = nextLinkTarget(response.headers.link ?? "", response.url);
+            more = url !== undefined;
+        }
+        else if (paging?.kind === "cursor") {
+            const next = readSourcePath(parsed, paging.next_path ?? paging.cursor_path);
+            if (next !== undefined && next !== null && next !== "") {
+                if (typeof next !== "string")
+                    unsupportedContent("cursor must be a string");
+                if (paging.next_path) {
+                    try {
+                        url = new URL(next, response.url).href;
+                    }
+                    catch {
+                        unsupportedContent("invalid next URL");
+                    }
+                }
+                else
+                    token = next;
+                more = true;
+            }
+        }
+        else if (numeric)
+            more = items.length >= paging.size;
+        const nextCursor = {
+            ...(token !== undefined ? { token } : {}), ...(url !== undefined ? { url } : {}),
+            ...(numeric && more ? paging.kind === "page-number" ? { page: page + 1 } : { offset: offset + paging.size } : {}),
+            ...(watermark ? { watermark } : {}), ...(more ? { since: since ?? "" } : {}),
+        };
+        const declaredComplete = r.complete === "always" || object(r.complete) && readSourcePath(parsed, r.complete.when_path) === r.complete.equals;
+        const validators = {};
+        if (response.headers.etag)
+            validators["if-none-match"] = response.headers.etag;
+        if (response.headers["last-modified"])
+            validators["if-modified-since"] = response.headers["last-modified"];
+        return { records, nextCursor: Object.keys(nextCursor).length ? nextCursor : null, more, complete: !more && declaredComplete && !resumed,
+            ...(skipped ? { diagnostics: [{ code: "records_skipped", message: "records skipped by declared presence rule", count: skipped }] } : {}),
+            ...(Object.keys(validators).length ? { validators } : {}),
+        };
+    },
+});
+/** Contract-1 composition helpers for explicitly trusted standalone source plugins. */
+export const SOURCE_PLUGIN_CORE_VERSION = "0.2.0-pre.40";
+export { nextLinkTarget };
+export const SOURCE_PROFILES = Object.freeze([restJsonProfile].map(profile => Object.freeze({ id: profile.id, version: profile.version, kind: profile.kind })));
+/** Inert lookup. Extensions are explicit caller imports, never discovered or executed here. */
+export function getSourceProfile(id) {
+    return id === restJsonProfile.id ? restJsonProfile : undefined;
+}
+//# sourceMappingURL=index.js.map

package/dist/source-profiles/index.js.map

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

package/dist/source-profiles/link-header.d.ts

@@ -0,0 +1,6 @@
+/**
+ * RFC 8288 sections 3 and 3.3, with quoted-pairs from RFC 7230 section 3.2.6.
+ * Malformed or unsupported input refuses the page, rather than establishing terminal completeness.
+ */
+export declare function nextLinkTarget(header: string, base: string): string | undefined;
+//# sourceMappingURL=link-header.d.ts.map

package/dist/source-profiles/link-header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-header.d.ts","sourceRoot":"","sources":["../../src/source-profiles/link-header.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA0F/E"}

package/dist/source-profiles/link-header.js

@@ -0,0 +1,131 @@
+/** Bounded Link-field parsing for paging; parameter values never become parameter syntax. */
+import { unsupportedContent } from "../source-engine/index.js";
+const TOKEN_CHAR = /^[!#$%&'*+.^_`|~0-9A-Za-z-]$/;
+const MAX_HEADER = 65_536;
+const MAX_LINKS = 128;
+const MAX_PARAMETERS = 64;
+/**
+ * RFC 8288 sections 3 and 3.3, with quoted-pairs from RFC 7230 section 3.2.6.
+ * Malformed or unsupported input refuses the page, rather than establishing terminal completeness.
+ */
+export function nextLinkTarget(header, base) {
+    if (header.length > MAX_HEADER)
+        unsupportedContent("Link header exceeds parser bound");
+    let at = 0;
+    let links = 0;
+    let next;
+    const malformed = () => unsupportedContent("malformed Link header");
+    const whitespace = () => { while (header[at] === " " || header[at] === "\t")
+        at++; };
+    const token = () => {
+        const begin = at;
+        while (at < header.length && TOKEN_CHAR.test(header[at]))
+            at++;
+        if (at === begin)
+            malformed();
+        return header.slice(begin, at);
+    };
+    const quoted = () => {
+        at++; // opening DQUOTE
+        let value = "";
+        while (at < header.length) {
+            let ch = header[at++];
+            if (ch === '"')
+                return value;
+            if (ch === "\\") {
+                if (at === header.length)
+                    malformed();
+                ch = header[at++];
+            }
+            const code = ch.charCodeAt(0);
+            if (code !== 9 && (code < 32 || code === 127 || code > 255))
+                malformed();
+            value += ch;
+        }
+        return malformed();
+    };
+    whitespace();
+    while (at < header.length) {
+        if (++links > MAX_LINKS)
+            unsupportedContent("too many Link targets");
+        if (header[at++] !== "<")
+            malformed();
+        const begin = at;
+        while (at < header.length && header[at] !== ">") {
+            const ch = header[at++];
+            const code = ch.charCodeAt(0);
+            if (code <= 32 || code >= 127 || ch === "<" || ch === '"' || ch === "\\")
+                malformed();
+        }
+        if (header[at] !== ">")
+            malformed();
+        const target = header.slice(begin, at++);
+        let relation;
+        let anchor;
+        let parameters = 0;
+        whitespace();
+        while (header[at] === ";") {
+            if (++parameters > MAX_PARAMETERS)
+                unsupportedContent("too many Link parameters");
+            at++;
+            whitespace();
+            const name = token().toLowerCase();
+            whitespace();
+            let value;
+            if (header[at] === "=") {
+                at++;
+                whitespace();
+                value = header[at] === '"' ? quoted() : token();
+                whitespace();
+            }
+            if (name === "rel" && relation === undefined) {
+                if (value === undefined || value === "")
+                    malformed();
+                relation = value;
+            }
+            if (name === "anchor" && anchor === undefined) {
+                if (value === undefined)
+                    malformed();
+                anchor = value;
+            }
+            if (at < header.length && header[at] !== ";" && header[at] !== ",")
+                malformed();
+        }
+        if (relation === undefined)
+            return malformed();
+        let resolved;
+        try {
+            resolved = new URL(target, base).href;
+            if (anchor !== undefined && new URL(anchor, base).href !== new URL(base).href)
+                unsupportedContent("Link context override is unsupported");
+        }
+        catch {
+            return unsupportedContent("invalid Link target or context");
+        }
+        const relations = relation.toLowerCase().split(/[ \t]+/);
+        for (const name of relations) {
+            if (/^[a-z][a-z0-9.-]*$/.test(name))
+                continue;
+            try {
+                new URL(name);
+            }
+            catch {
+                malformed();
+            }
+        }
+        if (relations.includes("next")) {
+            if (next !== undefined)
+                unsupportedContent("multiple next links");
+            next = resolved;
+        }
+        if (at === header.length)
+            break;
+        if (header[at++] !== ",")
+            malformed();
+        whitespace();
+        if (at === header.length)
+            malformed();
+    }
+    return next;
+}
+//# sourceMappingURL=link-header.js.map

package/dist/source-profiles/link-header.js.map

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

package/dist/storage.d.ts

@@ -1,13 +1,20 @@
 /** Runtime-neutral storage contract for Worker, browser, and custom backend consumers. */
 export type { BlobKey, ConceptId, DeleteOptions, Frontmatter, HeadResult, OkfDocument, QueryFilter, ReadBlobResult, ReadResult, ReservedFilename, ReservedReadResult, StorageBackend, StorageCapabilities, Version, VersionInfo, WriteOptions, } from "./types.js";
 export { InvalidInputError } from "./errors.js";
+export { compareCodeUnits } from "./code-unit-order.js";
 export { MalformedDocumentError } from "./frontmatter-contract.js";
-export { RESERVED_FILENAMES, assertSafeBlobKey, assertSafeConceptId, assertSafeReservedDir, assertSafeReservedFilename, compareStorageKeys, conceptIdFromPath, isReservedFile, pathFromConceptId, toPosix, } from "./paths.js";
+export { RESERVED_FILENAMES, assertSafeBlobKey, assertSafeConceptId, assertSafeReservedDir, assertSafeReservedFilename, compareStorageKeys, conceptIdFromPath, isReservedFile, nonCanonicalDocumentId, pathFromConceptId, toPosix, } from "./paths.js";
+export type { NonCanonicalDocumentId } from "./paths.js";
 export { VersionConflict, isContentVersion, stripETagWrapper } from "./version-transport.js";
 export { IntentHoldConflict, IntentStateConflict } from "./journaled-backend.js";
-export type { IntentPatch, IntentRecord, JournaledBackend, JournaledDeleteOptions, JournaledDeleteResult, JournaledReadResult, JournaledWriteOptions, MetaRecord, NewIntentRecord, } from "./journaled-backend.js";
+export type { IntentPatch, IntentRecord, JournaledBackend, JournaledDeleteOptions, JournaledDeleteResult, JournaledHead, JournaledHeadsOptions, JournaledReadResult, JournaledWriteOptions, MetaRecord, NewIntentRecord, } from "./journaled-backend.js";
 export { isRequestIdentity } from "./uncertain-write.js";
 export type { Outcome } from "./uncertain-write.js";
 export { headsDigest, isHeadsDigest, sortHeads } from "./heads-digest.js";
 export type { DocumentHead } from "./heads-digest.js";
+export * from "./blob-journal.js";
+export { captureBlobHead, isBlobContentType } from "./blob-contract.js";
+export type { BlobHead } from "./blob-contract.js";
+export { INVENTORY_GUARD_DOMAIN, InventoryGuardConflict, InventoryGuardUnsupported, inventoryGuardFor } from "./inventory-guard.js";
+export type { InventoryEntry, InventoryGuard, InventoryGuardTarget, InventoryGuardRequest, InventoryGuardResult } from "./inventory-guard.js";
 //# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAE1F,YAAY,EACV,OAAO,EACP,SAAS,EACT,aAAa,EACb,WAAW,EACX,UAAU,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,OAAO,EACP,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,EAC1B,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,OAAO,GACR,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG7F,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACjF,YAAY,EACV,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,UAAU,EACV,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAGpD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC1E,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAE1F,YAAY,EACV,OAAO,EACP,SAAS,EACT,aAAa,EACb,WAAW,EACX,UAAU,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,OAAO,EACP,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,EAC1B,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,iBAAiB,EACjB,OAAO,GACR,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG7F,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACjF,YAAY,EACV,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACrB,aAAa,EACb,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,UAAU,EACV,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAGpD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC1E,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,cAAc,mBAAmB,CAAC;AAElC,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACxE,YAAY,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACpI,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/storage.js

@@ -1,7 +1,8 @@
 /** Runtime-neutral storage contract for Worker, browser, and custom backend consumers. */
 export { InvalidInputError } from "./errors.js";
+export { compareCodeUnits } from "./code-unit-order.js";
 export { MalformedDocumentError } from "./frontmatter-contract.js";
-export { RESERVED_FILENAMES, assertSafeBlobKey, assertSafeConceptId, assertSafeReservedDir, assertSafeReservedFilename, compareStorageKeys, conceptIdFromPath, isReservedFile, pathFromConceptId, toPosix, } from "./paths.js";
+export { RESERVED_FILENAMES, assertSafeBlobKey, assertSafeConceptId, assertSafeReservedDir, assertSafeReservedFilename, compareStorageKeys, conceptIdFromPath, isReservedFile, nonCanonicalDocumentId, pathFromConceptId, toPosix, } from "./paths.js";
 export { VersionConflict, isContentVersion, stripETagWrapper } from "./version-transport.js";
 // The journaled-backend seam: what an adapter adds to `StorageBackend` to host a browser-local
 // working copy's intent journal. Runtime-neutral, like the seam it extends.
@@ -12,4 +13,8 @@ export { isRequestIdentity } from "./uncertain-write.js";
 // The heads digest a wire authority and a working copy both mint over every document id and
 // version, so a client can learn in one round trip whether anything changed.
 export { headsDigest, isHeadsDigest, sortHeads } from "./heads-digest.js";
+// Optional file-only frozen ordinary-file journal; no broader backend requirement.
+export * from "./blob-journal.js";
+export { captureBlobHead, isBlobContentType } from "./blob-contract.js";
+export { INVENTORY_GUARD_DOMAIN, InventoryGuardConflict, InventoryGuardUnsupported, inventoryGuardFor } from "./inventory-guard.js";
 //# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAqB1F,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,EAC1B,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,OAAO,GACR,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC7F,+FAA+F;AAC/F,4EAA4E;AAC5E,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAYjF,kGAAkG;AAClG,yFAAyF;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,4FAA4F;AAC5F,6EAA6E;AAC7E,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAqB1F,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,EAC1B,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,iBAAiB,EACjB,OAAO,GACR,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC7F,+FAA+F;AAC/F,4EAA4E;AAC5E,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAcjF,kGAAkG;AAClG,yFAAyF;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,4FAA4F;AAC5F,6EAA6E;AAC7E,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG1E,mFAAmF;AACnF,cAAc,mBAAmB,CAAC;AAElC,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGxE,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/string-identity-agreement.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Agreement rows for the two string identity primitives core owns: {@link foldPath}
+ * (`path-fold.ts`) and {@link compareCodeUnits} (`code-unit-order.ts`). Every expected value was
+ * written from the definitions, not captured from running the code, so a host that imports or
+ * copies these rows checks its own implementation against the definition, not against core.
+ *
+ * Shipped as a data-only module (no imports) under `@superbee/core/string-identity-agreement`, so a
+ * host test can import the rows directly, and a host that cannot depend on core can copy the file
+ * and compare its bytes. Strings use `\u` escapes so no editor or checkout can renormalize them.
+ */
+export interface PathFoldRow {
+    /** What the row exercises. */
+    readonly note: string;
+    readonly input: string;
+    /** `input` under NFC, lower, upper, lower, NFC. */
+    readonly fold: string;
+}
+export declare const PATH_FOLD_ROWS: readonly PathFoldRow[];
+/**
+ * Pairs the fold treats as one file (same fold) or as two. The fold is deliberately wider than any
+ * one disk: it also joins pairs some filesystems keep apart (NTFS holds `ß` and `ss` as two names),
+ * so a refusal under it means "may merge somewhere", not "merges everywhere".
+ */
+export interface PathCollisionRow {
+    readonly a: string;
+    readonly b: string;
+    readonly collide: boolean;
+}
+export declare const PATH_COLLISION_ROWS: readonly PathCollisionRow[];
+/**
+ * Strings in UTF-16 code unit order. The emoji (lead surrogate U+D83D) sorts before U+E000, which
+ * code point order and `localeCompare` would both place differently.
+ */
+export declare const CODE_UNIT_ORDER: readonly string[];
+//# sourceMappingURL=string-identity-agreement.d.ts.map

package/dist/string-identity-agreement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-identity-agreement.d.ts","sourceRoot":"","sources":["../src/string-identity-agreement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,cAAc,EAAE,SAAS,WAAW,EA0B/C,CAAC;AAEH;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,eAAO,MAAM,mBAAmB,EAAE,SAAS,gBAAgB,EAWzD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAiB3C,CAAC"}