@innovatorstack/harness 0.0.0-stage → 0.1.0

package/dist/queries/predicates.js

@@ -0,0 +1,62 @@
+import { like } from "./like.js";
+import { queryDepthMax, queryNodesMax, queryTextMax, queryValuesMax } from "./types.js";
+import { valueKey } from "./values.js";
+export function comparison(field, operator, value) {
+    validateValue(field, value);
+    return { kind: "compare", field, operator, value };
+}
+export function setPredicate(field, values, negate = false) {
+    if (values.length > queryValuesMax) {
+        throw new TypeError("Query set exceeds its value limit.");
+    }
+    for (const value of values) {
+        validateValue(field, value);
+    }
+    return { kind: "set", field, values, negate };
+}
+export function likePredicate(field, pattern, negate = false) {
+    if (!["text", "identifier"].includes(field.kind)) {
+        throw new TypeError("LIKE requires a text or item-ID property.");
+    }
+    like("", pattern);
+    return { kind: "like", field, pattern, negate };
+}
+export function validatePredicate(root) {
+    const pending = [{ node: root, depth: 0 }];
+    let visited = 0;
+    let values = 0;
+    while (pending.length > 0) {
+        const frame = pending.pop();
+        if (!frame) {
+            throw new Error("A query frame must exist while validation is pending.");
+        }
+        visited += 1;
+        if (visited > queryNodesMax || frame.depth > queryDepthMax) {
+            throw new TypeError("Query exceeds its predicate or nesting limit.");
+        }
+        if (frame.node.kind === "not") {
+            pending.push({ node: frame.node.term, depth: frame.depth + 1 });
+        }
+        else if (frame.node.kind === "and" || frame.node.kind === "or") {
+            for (const node of frame.node.terms) {
+                pending.push({ node, depth: frame.depth + 1 });
+            }
+        }
+        else if (frame.node.kind === "set") {
+            values += frame.node.values.length;
+        }
+        else if (frame.node.kind !== "constant" && frame.node.kind !== "null") {
+            values += 1;
+        }
+        if (values > queryValuesMax) {
+            throw new TypeError("Query exceeds its parameter limit.");
+        }
+    }
+}
+function validateValue(field, value) {
+    if (typeof value === "string" && value.length > queryTextMax) {
+        throw new TypeError("Query values exceed their text limit.");
+    }
+    valueKey(field.kind, value);
+}
+//# sourceMappingURL=predicates.js.map

package/dist/queries/predicates.js.map

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

package/dist/queries/types.d.ts

@@ -0,0 +1,65 @@
+import type { StorageValue, StoredItem } from "../storage/types.js";
+export declare enum Comparison {
+    Equal = "eq",
+    NotEqual = "ne",
+    Greater = "gt",
+    GreaterOrEqual = "ge",
+    Less = "lt",
+    LessOrEqual = "le"
+}
+export type ValueKind = "text" | "identifier" | "number" | "decimal" | "date";
+export interface ReferencePath {
+    readonly property: string;
+    readonly target: string;
+}
+export interface QueryField {
+    readonly name: string;
+    readonly column: string;
+    readonly kind: ValueKind;
+    readonly path: readonly ReferencePath[];
+}
+export type Predicate = {
+    readonly kind: "constant";
+    readonly value: boolean;
+} | {
+    readonly kind: "compare";
+    readonly field: QueryField;
+    readonly operator: Comparison;
+    readonly value: StorageValue;
+} | {
+    readonly kind: "null";
+    readonly field: QueryField;
+    readonly negate: boolean;
+} | {
+    readonly kind: "set";
+    readonly field: QueryField;
+    readonly values: readonly StorageValue[];
+    readonly negate: boolean;
+} | {
+    readonly kind: "like";
+    readonly field: QueryField;
+    readonly pattern: string;
+    readonly negate: boolean;
+} | {
+    readonly kind: "and";
+    readonly terms: readonly Predicate[];
+} | {
+    readonly kind: "or";
+    readonly terms: readonly Predicate[];
+} | {
+    readonly kind: "not";
+    readonly term: Predicate;
+};
+export interface QueryOrder {
+    readonly field: QueryField;
+    readonly descending: boolean;
+}
+/** Internal optimization; custom storage uses the same final predicate evaluator. */
+export type SelectQuery = (type: string, predicate: Predicate, spend: (units: number) => void) => readonly StoredItem[];
+export declare const selectQuery: unique symbol;
+export declare const queryNodesMax = 512;
+export declare const queryDepthMax = 64;
+export declare const queryValuesMax = 10000;
+export declare const queryTextMax: number;
+export declare function conjunction(terms: readonly Predicate[]): Predicate;
+//# sourceMappingURL=types.d.ts.map

package/dist/queries/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/queries/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEpE,oBAAY,UAAU;IAClB,KAAK,OAAO;IACZ,QAAQ,OAAO;IACf,OAAO,OAAO;IACd,cAAc,OAAO;IACrB,IAAI,OAAO;IACX,WAAW,OAAO;CACrB;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAE9E,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,CAAC;CAC3C;AAED,MAAM,MAAM,SAAS,GACf;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACtD;IACI,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAChC,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC/E;IACI,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC5B,GACD;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC5B,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAA;CAAE,GAC9D;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAA;CAAE,GAC7D;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAEzD,MAAM,WAAW,UAAU;IACvB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAChC;AAED,qFAAqF;AACrF,MAAM,MAAM,WAAW,GAAG,CACtB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,KAC7B,SAAS,UAAU,EAAE,CAAC;AAE3B,eAAO,MAAM,WAAW,eAAsC,CAAC;AAE/D,eAAO,MAAM,aAAa,MAAM,CAAC;AACjC,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,cAAc,QAAS,CAAC;AACrC,eAAO,MAAM,YAAY,QAAY,CAAC;AAEtC,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,CAYlE"}

package/dist/queries/types.js

@@ -0,0 +1,25 @@
+export var Comparison;
+(function (Comparison) {
+    Comparison["Equal"] = "eq";
+    Comparison["NotEqual"] = "ne";
+    Comparison["Greater"] = "gt";
+    Comparison["GreaterOrEqual"] = "ge";
+    Comparison["Less"] = "lt";
+    Comparison["LessOrEqual"] = "le";
+})(Comparison || (Comparison = {}));
+export const selectQuery = Symbol("Harness storage selection");
+export const queryNodesMax = 512;
+export const queryDepthMax = 64;
+export const queryValuesMax = 10_000;
+export const queryTextMax = 64 * 1024;
+export function conjunction(terms) {
+    if (terms.length === 0) {
+        return { kind: "constant", value: true };
+    }
+    const only = terms[0];
+    if (terms.length === 1 && only) {
+        return only;
+    }
+    return { kind: "and", terms };
+}
+//# sourceMappingURL=types.js.map

package/dist/queries/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/queries/types.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,UAOX;AAPD,WAAY,UAAU;IAClB,0BAAY,CAAA;IACZ,6BAAe,CAAA;IACf,4BAAc,CAAA;IACd,mCAAqB,CAAA;IACrB,yBAAW,CAAA;IACX,gCAAkB,CAAA;AACtB,CAAC,EAPW,UAAU,KAAV,UAAU,QAOrB;AAqDD,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,2BAA2B,CAAC,CAAC;AAE/D,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AACjC,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAChC,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC;AACrC,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,GAAG,IAAI,CAAC;AAEtC,MAAM,UAAU,WAAW,CAAC,KAA2B;IACnD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC7C,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAEtB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAClC,CAAC"}

package/dist/queries/values.d.ts

@@ -0,0 +1,5 @@
+import type { StorageValue } from "../storage/types.js";
+import type { ValueKind } from "./types.js";
+export declare function valueKey(kind: ValueKind, value: StorageValue): StorageValue;
+export declare function compareValues(kind: ValueKind, left: StorageValue, right: StorageValue): number | null;
+//# sourceMappingURL=values.d.ts.map

package/dist/queries/values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../src/queries/values.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,GAAG,YAAY,CAoC3E;AAED,wBAAgB,aAAa,CACzB,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,YAAY,GACpB,MAAM,GAAG,IAAI,CAyBf"}

package/dist/queries/values.js

@@ -0,0 +1,77 @@
+import { dateKey } from "./date.js";
+import { compareDecimals, decimalKey } from "./decimal.js";
+export function valueKey(kind, value) {
+    if (value === null) {
+        return null;
+    }
+    if (kind === "number") {
+        const result = Number(value);
+        if (String(value).trim() === "" || !Number.isFinite(result)) {
+            throw new TypeError("Numeric predicates require finite numeric values.");
+        }
+        return result;
+    }
+    const text = String(value);
+    switch (kind) {
+        case "decimal": {
+            return decimalKey(text);
+        }
+        case "date": {
+            return dateKey(text);
+        }
+        case "identifier": {
+            return text.toLowerCase();
+        }
+        case "text": {
+            return text;
+        }
+        default: {
+            const unexpected = kind;
+            throw new TypeError(`Unknown query value kind '${String(unexpected)}'.`);
+        }
+    }
+}
+export function compareValues(kind, left, right) {
+    const a = valueKey(kind, left);
+    const b = valueKey(kind, right);
+    if (a === null || b === null) {
+        return null;
+    }
+    if (a === b) {
+        return 0;
+    }
+    if (kind === "decimal") {
+        return compareDecimals(String(a), String(b));
+    }
+    if (kind === "date") {
+        return BigInt(a) < BigInt(b) ? -1 : 1;
+    }
+    if (typeof a === "number" && typeof b === "number") {
+        return a < b ? -1 : 1;
+    }
+    return compareText(String(a), String(b));
+}
+function compareText(left, right) {
+    const a = left[Symbol.iterator]();
+    const b = right[Symbol.iterator]();
+    while (true) {
+        const first = a.next();
+        const second = b.next();
+        if (first.done || second.done) {
+            if (first.done && second.done) {
+                return 0;
+            }
+            return first.done ? -1 : 1;
+        }
+        const firstCode = first.value.codePointAt(0);
+        const secondCode = second.value.codePointAt(0);
+        if (firstCode === undefined || secondCode === undefined) {
+            throw new Error("String iteration must yield one Unicode code point.");
+        }
+        const difference = firstCode - secondCode;
+        if (difference !== 0) {
+            return Math.sign(difference);
+        }
+    }
+}
+//# sourceMappingURL=values.js.map

package/dist/queries/values.js.map

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

package/dist/storage/documents.d.ts

@@ -0,0 +1,5 @@
+import type { HarnessStorage, PackageDocument } from "./types.js";
+export declare const selectDocument: unique symbol;
+/** Native adapters can select one source document without loading the complete package export. */
+export declare function findDocument(storage: HarnessStorage, path: string): PackageDocument | undefined;
+//# sourceMappingURL=documents.d.ts.map

package/dist/storage/documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/storage/documents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElE,eAAO,MAAM,cAAc,eAA2B,CAAC;AAUvD,kGAAkG;AAClG,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAM/F"}

package/dist/storage/documents.js

@@ -0,0 +1,12 @@
+export const selectDocument = Symbol("selectDocument");
+function hasDocumentLookup(storage) {
+    return selectDocument in storage && typeof storage[selectDocument] === "function";
+}
+/** Native adapters can select one source document without loading the complete package export. */
+export function findDocument(storage, path) {
+    if (hasDocumentLookup(storage)) {
+        return storage[selectDocument](path);
+    }
+    return storage.listDocuments().find((document) => document.path === path);
+}
+//# sourceMappingURL=documents.js.map

package/dist/storage/documents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.js","sourceRoot":"","sources":["../../src/storage/documents.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAMvD,SAAS,iBAAiB,CAAC,OAAuB;IAC9C,OAAO,cAAc,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,cAAc,CAAC,KAAK,UAAU,CAAC;AACtF,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,YAAY,CAAC,OAAuB,EAAE,IAAY;IAC9D,IAAI,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,OAAO,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC9E,CAAC"}

package/dist/storage/metadata-epoch.d.ts

@@ -0,0 +1,6 @@
+import type { HarnessStorage } from "./types.js";
+/** Only storage with fully owned metadata writes may opt into derived catalog reuse. */
+export declare function trackMetadata(storage: HarnessStorage): void;
+export declare function changeMetadata(storage: HarnessStorage): void;
+export declare function metadataEpoch(storage: HarnessStorage): number | undefined;
+//# sourceMappingURL=metadata-epoch.d.ts.map

package/dist/storage/metadata-epoch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-epoch.d.ts","sourceRoot":"","sources":["../../src/storage/metadata-epoch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAE3D;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAM5D;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAEzE"}

package/dist/storage/metadata-epoch.js

@@ -0,0 +1,15 @@
+const epochs = new WeakMap();
+/** Only storage with fully owned metadata writes may opt into derived catalog reuse. */
+export function trackMetadata(storage) {
+    epochs.set(storage, 0);
+}
+export function changeMetadata(storage) {
+    const current = epochs.get(storage);
+    if (current !== undefined) {
+        epochs.set(storage, current + 1);
+    }
+}
+export function metadataEpoch(storage) {
+    return epochs.get(storage);
+}
+//# sourceMappingURL=metadata-epoch.js.map

package/dist/storage/metadata-epoch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-epoch.js","sourceRoot":"","sources":["../../src/storage/metadata-epoch.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAAG,IAAI,OAAO,EAA0B,CAAC;AAErD,wFAAwF;AACxF,MAAM,UAAU,aAAa,CAAC,OAAuB;IACjD,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAuB;IAClD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAEpC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;IACrC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAuB;IACjD,OAAO,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC"}

package/dist/storage/package-transaction.d.ts

@@ -0,0 +1,5 @@
+import type { HarnessStorage } from "./types.js";
+export declare const packageTransaction: unique symbol;
+/** An adapter can share one synchronous write boundary across a complete package import. */
+export declare function withPackageTransaction<Result>(storage: HarnessStorage, write: () => Result): Result;
+//# sourceMappingURL=package-transaction.d.ts.map

package/dist/storage/package-transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-transaction.d.ts","sourceRoot":"","sources":["../../src/storage/package-transaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,kBAAkB,eAA+B,CAAC;AAY/D,4FAA4F;AAC5F,wBAAgB,sBAAsB,CAAC,MAAM,EACzC,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,MAAM,MAAM,GACpB,MAAM,CAMR"}

package/dist/storage/package-transaction.js

@@ -0,0 +1,12 @@
+export const packageTransaction = Symbol("packageTransaction");
+function hasPackageTransaction(storage) {
+    return packageTransaction in storage && typeof storage[packageTransaction] === "function";
+}
+/** An adapter can share one synchronous write boundary across a complete package import. */
+export function withPackageTransaction(storage, write) {
+    if (hasPackageTransaction(storage)) {
+        return storage[packageTransaction](write);
+    }
+    return write();
+}
+//# sourceMappingURL=package-transaction.js.map

package/dist/storage/package-transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-transaction.js","sourceRoot":"","sources":["../../src/storage/package-transaction.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAM/D,SAAS,qBAAqB,CAC1B,OAAuB;IAEvB,OAAO,kBAAkB,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,kBAAkB,CAAC,KAAK,UAAU,CAAC;AAC9F,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,sBAAsB,CAClC,OAAuB,EACvB,KAAmB;IAEnB,IAAI,qBAAqB,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,OAAO,OAAO,CAAC,kBAAkB,CAAC,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,KAAK,EAAE,CAAC;AACnB,CAAC"}

package/dist/storage/properties.d.ts

@@ -0,0 +1,4 @@
+import type { ItemTypeDefinition, PropertyDefinition } from "./types.js";
+/** Only validated immutable definitions can retain an index across calls. */
+export declare function propertyFor(definition: ItemTypeDefinition, name: string): PropertyDefinition | undefined;
+//# sourceMappingURL=properties.d.ts.map

package/dist/storage/properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"properties.d.ts","sourceRoot":"","sources":["../../src/storage/properties.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIzE,6EAA6E;AAC7E,wBAAgB,WAAW,CACvB,UAAU,EAAE,kBAAkB,EAC9B,IAAI,EAAE,MAAM,GACb,kBAAkB,GAAG,SAAS,CAqBhC"}

package/dist/storage/properties.js

@@ -0,0 +1,21 @@
+import { isFrozenData } from "../core/data.js";
+const propertiesByType = new WeakMap();
+/** Only validated immutable definitions can retain an index across calls. */
+export function propertyFor(definition, name) {
+    if (!isFrozenData(definition)) {
+        return definition.properties.find((property) => property.name === name);
+    }
+    let indexed = propertiesByType.get(definition);
+    if (!indexed) {
+        const properties = new Map();
+        for (const property of definition.properties) {
+            if (!properties.has(property.name)) {
+                properties.set(property.name, property);
+            }
+        }
+        indexed = properties;
+        propertiesByType.set(definition, indexed);
+    }
+    return indexed.get(name);
+}
+//# sourceMappingURL=properties.js.map

package/dist/storage/properties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"properties.js","sourceRoot":"","sources":["../../src/storage/properties.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,MAAM,gBAAgB,GAAG,IAAI,OAAO,EAA+D,CAAC;AAEpG,6EAA6E;AAC7E,MAAM,UAAU,WAAW,CACvB,UAA8B,EAC9B,IAAY;IAEZ,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAE/C,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,MAAM,UAAU,GAAG,IAAI,GAAG,EAA8B,CAAC;QAEzD,KAAK,MAAM,QAAQ,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;YAC3C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC5C,CAAC;QACL,CAAC;QAED,OAAO,GAAG,UAAU,CAAC;QACrB,gBAAgB,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/dist/storage/sqlite/catalog.d.ts

@@ -0,0 +1,19 @@
+import type { CatalogEntry } from "../types.js";
+export interface CatalogRow {
+    readonly id: string;
+    readonly type: string;
+    readonly properties: string;
+    readonly attributes: string;
+    readonly source: string;
+}
+/** Cache decoded rows privately; every reader still receives detached records. */
+export declare class CatalogEntries {
+    private readonly entries;
+    private readonly selections;
+    private epoch;
+    select(type: string | undefined, epoch: number | undefined, read: () => readonly CatalogRow[]): readonly CatalogEntry[];
+    read(row: CatalogRow, epoch: number | undefined): CatalogEntry;
+    clear(): void;
+    private refresh;
+}
+//# sourceMappingURL=catalog.d.ts.map

package/dist/storage/sqlite/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/storage/sqlite/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,MAAM,WAAW,UAAU;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CAC3B;AAID,kFAAkF;AAClF,qBAAa,cAAc;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+D;IACvF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwD;IACnF,OAAO,CAAC,KAAK,CAAqB;IAElC,MAAM,CACF,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,IAAI,EAAE,MAAM,SAAS,UAAU,EAAE,GAClC,SAAS,YAAY,EAAE,CAiBzB;IAED,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAiC7D;IAED,KAAK,IAAI,IAAI,CAGZ;IAED,OAAO,CAAC,OAAO;CAMlB"}

package/dist/storage/sqlite/catalog.js

@@ -0,0 +1,62 @@
+import { decodeAttributes, decodeProperties, decodeSource } from "./metadata.js";
+const selectionsMax = 64;
+/** Cache decoded rows privately; every reader still receives detached records. */
+export class CatalogEntries {
+    entries = new Map();
+    selections = new Map();
+    epoch;
+    select(type, epoch, read) {
+        this.refresh(epoch);
+        let rows = this.selections.get(type);
+        if (!rows) {
+            rows = read();
+            if (epoch !== undefined) {
+                if (this.selections.size >= selectionsMax) {
+                    this.selections.clear();
+                }
+                this.selections.set(type, rows);
+            }
+        }
+        return rows.map((row) => this.read(row, epoch));
+    }
+    read(row, epoch) {
+        this.refresh(epoch);
+        const key = JSON.stringify([row.type, row.id]);
+        let cached = this.entries.get(key);
+        if (!cached ||
+            cached.row.properties !== row.properties ||
+            cached.row.attributes !== row.attributes ||
+            cached.row.source !== row.source) {
+            cached = {
+                row,
+                entry: {
+                    type: row.type,
+                    id: row.id,
+                    properties: decodeProperties(row.properties),
+                    attributes: decodeAttributes(row.attributes),
+                    source: decodeSource(row.source),
+                },
+            };
+            if (epoch !== undefined) {
+                this.entries.set(key, cached);
+            }
+        }
+        return {
+            ...cached.entry,
+            properties: { ...cached.entry.properties },
+            attributes: { ...cached.entry.attributes },
+            source: { ...cached.entry.source },
+        };
+    }
+    clear() {
+        this.entries.clear();
+        this.selections.clear();
+    }
+    refresh(epoch) {
+        if (epoch === undefined || this.epoch !== epoch) {
+            this.clear();
+            this.epoch = epoch;
+        }
+    }
+}
+//# sourceMappingURL=catalog.js.map

package/dist/storage/sqlite/catalog.js.map

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

package/dist/storage/sqlite/connections.d.ts

@@ -0,0 +1,5 @@
+import type { Database } from "bun:sqlite";
+/** Retain clean native connections, never a disposed world's storage wrapper or callbacks. */
+export declare function takeConnection(image: Uint8Array): Database | undefined;
+export declare function retainConnection(image: Uint8Array, connection: Database): boolean;
+//# sourceMappingURL=connections.d.ts.map

package/dist/storage/sqlite/connections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connections.d.ts","sourceRoot":"","sources":["../../../src/storage/sqlite/connections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAO3C,8FAA8F;AAC9F,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,CAStE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,GAAG,OAAO,CAqBjF"}

package/dist/storage/sqlite/connections.js

@@ -0,0 +1,36 @@
+const connectionsMax = 4;
+const connectionBytesMax = 64 * 1024 * 1024;
+const connections = new Map();
+let bytes = 0;
+/** Retain clean native connections, never a disposed world's storage wrapper or callbacks. */
+export function takeConnection(image) {
+    const connection = connections.get(image);
+    if (connection) {
+        connections.delete(image);
+        bytes -= image.byteLength;
+    }
+    return connection;
+}
+export function retainConnection(image, connection) {
+    if (image.byteLength > connectionBytesMax) {
+        return false;
+    }
+    takeConnection(image)?.close();
+    while (connections.size >= connectionsMax || bytes + image.byteLength > connectionBytesMax) {
+        const oldest = connections.keys().next().value;
+        if (oldest === undefined) {
+            throw new Error("Connection eviction requires an existing idle database.");
+        }
+        takeConnection(oldest)?.close();
+    }
+    connections.set(image, connection);
+    bytes += image.byteLength;
+    return true;
+}
+process.once("exit", () => {
+    for (const connection of connections.values()) {
+        connection.close();
+    }
+    connections.clear();
+});
+//# sourceMappingURL=connections.js.map

package/dist/storage/sqlite/connections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connections.js","sourceRoot":"","sources":["../../../src/storage/sqlite/connections.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc,GAAG,CAAC,CAAC;AACzB,MAAM,kBAAkB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAC5C,MAAM,WAAW,GAAG,IAAI,GAAG,EAAwB,CAAC;AACpD,IAAI,KAAK,GAAG,CAAC,CAAC;AAEd,8FAA8F;AAC9F,MAAM,UAAU,cAAc,CAAC,KAAiB;IAC5C,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAE1C,IAAI,UAAU,EAAE,CAAC;QACb,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1B,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC;IAC9B,CAAC;IAED,OAAO,UAAU,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAiB,EAAE,UAAoB;IACpE,IAAI,KAAK,CAAC,UAAU,GAAG,kBAAkB,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,cAAc,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC;IAE/B,OAAO,WAAW,CAAC,IAAI,IAAI,cAAc,IAAI,KAAK,GAAG,KAAK,CAAC,UAAU,GAAG,kBAAkB,EAAE,CAAC;QACzF,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;QAE/C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC/E,CAAC;QAED,cAAc,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACpC,CAAC;IAED,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACnC,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC;IAE1B,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;IACtB,KAAK,MAAM,UAAU,IAAI,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;QAC5C,UAAU,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,WAAW,CAAC,KAAK,EAAE,CAAC;AACxB,CAAC,CAAC,CAAC"}

package/dist/storage/sqlite/errors.d.ts

@@ -0,0 +1,7 @@
+export type StorageErrorCode = "STORAGE_CLOSED" | "INVALID_SCHEMA" | "INCOMPATIBLE_SCHEMA" | "UNKNOWN_ITEM_TYPE" | "INVALID_ITEM" | "ITEM_EXISTS" | "ITEM_NOT_FOUND" | "TRANSACTION_STATE" | "INVALID_SNAPSHOT" | "CORRUPT_STORAGE";
+export declare class StorageError extends Error {
+    readonly code: StorageErrorCode;
+    readonly name = "StorageError";
+    constructor(code: StorageErrorCode, message: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/storage/sqlite/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/storage/sqlite/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GACtB,gBAAgB,GAChB,gBAAgB,GAChB,qBAAqB,GACrB,mBAAmB,GACnB,cAAc,GACd,aAAa,GACb,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,iBAAiB,CAAC;AAExB,qBAAa,YAAa,SAAQ,KAAK;IAI/B,QAAQ,CAAC,IAAI,EAAE,gBAAgB;IAHnC,SAAkB,IAAI,kBAAkB;IAExC,YACa,IAAI,EAAE,gBAAgB,EAC/B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY,EAGzB;CACJ"}

package/dist/storage/sqlite/errors.js

@@ -0,0 +1,9 @@
+export class StorageError extends Error {
+    code;
+    name = "StorageError";
+    constructor(code, message, options) {
+        super(message, options);
+        this.code = code;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/storage/sqlite/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/storage/sqlite/errors.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,YAAa,SAAQ,KAAK;IAItB,IAAI;IAHC,IAAI,GAAG,cAAc,CAAC;IAExC,YACa,IAAsB,EAC/B,OAAe,EACf,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;oBAJf,IAAI;IAKjB,CAAC;CACJ"}

package/dist/storage/sqlite/index.d.ts

@@ -0,0 +1,5 @@
+export { StorageError } from "./errors.js";
+export type { StorageErrorCode } from "./errors.js";
+export { SqliteStorage } from "./storage.js";
+export type { CatalogEntry, HarnessStorage, ItemTypeDefinition, PackageDocument, PropertyDefinition, StorageValue, StoredItem, TransactionBoundary, } from "../types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/sqlite/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/sqlite/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EACR,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,UAAU,EACV,mBAAmB,GACtB,MAAM,aAAa,CAAC"}

package/dist/storage/sqlite/index.js

@@ -0,0 +1,3 @@
+export { StorageError } from "./errors.js";
+export { SqliteStorage } from "./storage.js";
+//# sourceMappingURL=index.js.map

package/dist/storage/sqlite/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/storage/sqlite/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/storage/sqlite/metadata.d.ts

@@ -0,0 +1,8 @@
+import type { SourceLocation } from "../../diagnostics/source-location.js";
+import type { ItemTypeDefinition, StorageValue } from "../types.js";
+export declare function decodeDefinition(text: string): ItemTypeDefinition;
+export declare function decodeProperties(text: string): Record<string, StorageValue>;
+export declare function decodeAttributes(text: string): Record<string, string>;
+export declare function decodeSource(text: string): SourceLocation;
+export declare function decodePresentProperties(text: string): readonly string[];
+//# sourceMappingURL=metadata.d.ts.map

package/dist/storage/sqlite/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../src/storage/sqlite/metadata.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,KAAK,EAAE,kBAAkB,EAAsB,YAAY,EAAE,MAAM,aAAa,CAAC;AAuExF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAsCjE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAgC3E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqBrE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAQzD;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAkCvE"}