@x12i/catalox 5.2.0 → 5.9.7

package/packages/engine/dist/jsx/index.d.ts

@@ -0,0 +1,70 @@
+import type { CatalogItemRenderMap, CatalogListRenderMap } from "@x12i/catalox-contracts/render-map.js";
+import type { CatalogRendererMode, CatalogRendererRole, CatalogRendererSyntax } from "@x12i/catalox-contracts/renderer-snippets.js";
+export type TranspileRendererSourceToModuleSourceInput = {
+    rendererSource: string;
+    /**
+     * Declares how to interpret `rendererSource`.
+     * Only `jsx` and `tsx` can be transpiled to an ESM module.
+     */
+    syntax?: CatalogRendererSyntax;
+    /**
+     * Optional label used in sourcemaps and diagnostics.
+     */
+    sourceFileName?: string;
+};
+export declare function transpileRendererSourceToModuleSource(input: TranspileRendererSourceToModuleSourceInput): Promise<string>;
+export type TypecheckRendererSnippetIoInput = {
+    rendererSource: string;
+    syntax?: CatalogRendererSyntax;
+    role: CatalogRendererRole;
+    mode?: CatalogRendererMode;
+    /**
+     * If true, any inability to typecheck (e.g. missing typescript) becomes an error.
+     */
+    strict?: boolean;
+};
+export type TypecheckRendererSnippetIoError = {
+    file: string;
+    message: string;
+    line?: number;
+    column?: number;
+};
+export type TypecheckRendererSnippetIoResult = {
+    isValid: boolean;
+    errors: TypecheckRendererSnippetIoError[];
+    /**
+     * Present when typecheck couldn't be performed (and strict=false).
+     */
+    skipped?: {
+        reason: string;
+    };
+};
+export declare function typecheckRendererSnippetIo(input: TypecheckRendererSnippetIoInput): Promise<TypecheckRendererSnippetIoResult>;
+export type UnsafeCreateRendererFunctionInput = {
+    transpiledModuleSource: string;
+};
+/**
+ * UNSAFE: Evaluates code. Only call with trusted snippets.
+ *
+ * Loads a transpiled ESM module source via a data URL and returns its default export.
+ */
+export declare function unsafeCreateRendererFunction<T = unknown>(input: UnsafeCreateRendererFunctionInput): Promise<T>;
+export type RenderToHtmlInput = {
+    renderer: unknown;
+    /**
+     * If renderer is a component, it will be called with these props.
+     * If renderer is a function expecting a map, pass `{ map }` and use a wrapper.
+     */
+    props: Record<string, unknown>;
+};
+/**
+ * Best-effort HTML rendering. If React is not installed, returns a string error.
+ * If the renderer returns a string, it is returned as-is.
+ */
+export declare function renderRendererToHtml(input: RenderToHtmlInput): Promise<string>;
+export type CatalogRendererIo = {
+    map: CatalogListRenderMap | CatalogItemRenderMap;
+    role: CatalogRendererRole;
+    mode?: CatalogRendererMode;
+};
+//# sourceMappingURL=index.d.ts.map

package/packages/engine/dist/jsx/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jsx/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AACxG,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,8CAA8C,CAAC;AAEpI,MAAM,MAAM,0CAA0C,GAAG;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,wBAAsB,qCAAqC,CACzD,KAAK,EAAE,0CAA0C,GAChD,OAAO,CAAC,MAAM,CAAC,CAejB;AAED,MAAM,MAAM,+BAA+B,GAAG;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,+BAA+B,EAAE,CAAC;IAC1C;;OAEG;IACH,OAAO,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9B,CAAC;AAOF,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,+BAA+B,GACrC,OAAO,CAAC,gCAAgC,CAAC,CAoI3C;AAED,MAAM,MAAM,iCAAiC,GAAG;IAC9C,sBAAsB,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,4BAA4B,CAAC,CAAC,GAAG,OAAO,EAC5D,KAAK,EAAE,iCAAiC,GACvC,OAAO,CAAC,CAAC,CAAC,CAIZ;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBpF;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,EAAE,oBAAoB,GAAG,oBAAoB,CAAC;IACjD,IAAI,EAAE,mBAAmB,CAAC;IAC1B,IAAI,CAAC,EAAE,mBAAmB,CAAC;CAC5B,CAAC"}

package/packages/engine/dist/jsx/index.js

@@ -0,0 +1,178 @@
+import { transform } from "esbuild";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+export async function transpileRendererSourceToModuleSource(input) {
+    const syntax = input.syntax ?? "tsx";
+    if (syntax === "html") {
+        throw new Error("Cannot transpile html rendererSource to a module. Use syntax: 'jsx' or 'tsx'.");
+    }
+    const sourceFileName = input.sourceFileName ?? (syntax === "jsx" ? "snippet.jsx" : "snippet.tsx");
+    const result = await transform(input.rendererSource, {
+        loader: syntax === "jsx" ? "jsx" : "tsx",
+        format: "esm",
+        target: "es2022",
+        sourcemap: "inline",
+        sourcefile: sourceFileName,
+    });
+    return result.code;
+}
+function toPos(ts, sf, start) {
+    const pos = sf.getLineAndCharacterOfPosition(start);
+    return { line: pos.line + 1, column: pos.character + 1 };
+}
+export async function typecheckRendererSnippetIo(input) {
+    const syntax = input.syntax ?? "tsx";
+    if (syntax === "html") {
+        return { isValid: true, errors: [], skipped: { reason: "html_rendererSource" } };
+    }
+    let ts;
+    try {
+        ts = await import("typescript");
+    }
+    catch (e) {
+        if (input.strict) {
+            return {
+                isValid: false,
+                errors: [{ file: "runtime", message: `typescript is required for typecheckRendererSnippetIo: ${String(e?.message ?? e)}` }],
+            };
+        }
+        return { isValid: true, errors: [], skipped: { reason: "typescript_not_installed" } };
+    }
+    const role = input.role;
+    const engineSrcDir = dirname(fileURLToPath(import.meta.url)).replace(/\\/g, "/");
+    const virtualDir = `${engineSrcDir}/__virtual__`;
+    const snippetFile = `${virtualDir}/snippet.tsx`;
+    const checkFile = `${virtualDir}/check.ts`;
+    const jsxTypesFile = `${virtualDir}/jsx.d.ts`;
+    const renderMapFile = join(engineSrcDir, "../../../contracts/src/render-map.ts").replace(/\\/g, "/");
+    const norm = (p) => p.replace(/\\/g, "/");
+    const jsxTypes = `
+declare namespace JSX {
+  interface IntrinsicElements {
+    [elemName: string]: any;
+  }
+}
+`;
+    const checkSource = `
+import Renderer from "./snippet";
+import type { CatalogListRenderMap, CatalogItemRenderMap } from "@x12i/catalox-contracts/render-map.js";
+
+type ListComponent = (props: { map: CatalogListRenderMap } & Record<string, unknown>) => unknown;
+type ListFn = (map: CatalogListRenderMap) => unknown;
+type ItemComponent = (props: { map: CatalogItemRenderMap } & Record<string, unknown>) => unknown;
+type ItemFn = (map: CatalogItemRenderMap) => unknown;
+
+type Valid =
+  ${role === "item"
+        ? "typeof Renderer extends ItemComponent ? true : typeof Renderer extends ItemFn ? true : false"
+        : role === "list" || role === "grid"
+            ? "typeof Renderer extends ListComponent ? true : typeof Renderer extends ListFn ? true : false"
+            : "true"};
+
+type AssertTrue<T extends true> = T;
+const __assert: AssertTrue<Valid> = true;
+void __assert;
+`;
+    const files = new Map([
+        [norm(snippetFile), input.rendererSource],
+        [norm(checkFile), checkSource],
+        [norm(jsxTypesFile), jsxTypes],
+    ]);
+    const compilerOptions = {
+        strict: true,
+        noEmit: true,
+        module: ts.ModuleKind.ESNext,
+        moduleResolution: ts.ModuleResolutionKind.Bundler,
+        target: ts.ScriptTarget.ES2022,
+        // Preserve JSX so we don't require react/jsx-runtime types at typecheck time.
+        jsx: ts.JsxEmit.Preserve,
+        allowJs: true,
+        checkJs: false,
+        skipLibCheck: true,
+        types: [],
+    };
+    const defaultHost = ts.createCompilerHost(compilerOptions, true);
+    const host = {
+        ...defaultHost,
+        fileExists: (fileName) => files.has(norm(fileName)) || defaultHost.fileExists(fileName),
+        readFile: (fileName) => files.get(norm(fileName)) ?? defaultHost.readFile(fileName),
+        getSourceFile: (fileName, languageVersion) => {
+            const text = files.get(norm(fileName));
+            if (text != null)
+                return ts.createSourceFile(fileName, text, languageVersion, true);
+            return defaultHost.getSourceFile(fileName, languageVersion);
+        },
+        getCurrentDirectory: () => virtualDir,
+        getCanonicalFileName: (f) => f,
+        useCaseSensitiveFileNames: () => true,
+        getNewLine: () => "\n",
+        resolveModuleNames: (moduleNames, containingFile) => {
+            return moduleNames.map((m) => {
+                if (m === "./snippet" || m === "./snippet.tsx" || m === "./snippet.ts") {
+                    return { resolvedFileName: snippetFile, extension: ts.Extension.Tsx };
+                }
+                if (m === "../contracts/render-map.js" ||
+                    m === "../contracts/render-map.ts" ||
+                    m === "@x12i/catalox-contracts/render-map.js") {
+                    return { resolvedFileName: renderMapFile, extension: ts.Extension.Ts };
+                }
+                // Fall back to default resolver (best-effort).
+                const res = ts.resolveModuleName(m, containingFile, compilerOptions, defaultHost);
+                return res.resolvedModule;
+            });
+        },
+    };
+    // Keep snippets self-contained. If module resolution tries to reach into the real FS,
+    // we allow it (best-effort), but most stored snippets should not rely on imports.
+    const program = ts.createProgram([checkFile, snippetFile, jsxTypesFile], compilerOptions, host);
+    const diagnostics = ts.getPreEmitDiagnostics(program);
+    const errors = diagnostics
+        .filter((d) => d.category === ts.DiagnosticCategory.Error)
+        .map((d) => {
+        const file = d.file?.fileName ?? "unknown";
+        const message = ts.flattenDiagnosticMessageText(d.messageText, "\n");
+        if (d.file && typeof d.start === "number") {
+            const p = toPos(ts, d.file, d.start);
+            return { file, message, line: p.line, column: p.column };
+        }
+        return { file, message };
+    });
+    return { isValid: errors.length === 0, errors };
+}
+/**
+ * UNSAFE: Evaluates code. Only call with trusted snippets.
+ *
+ * Loads a transpiled ESM module source via a data URL and returns its default export.
+ */
+export async function unsafeCreateRendererFunction(input) {
+    const encoded = encodeURIComponent(input.transpiledModuleSource);
+    const mod = await import(`data:text/javascript;charset=utf-8,${encoded}`);
+    return mod?.default;
+}
+/**
+ * Best-effort HTML rendering. If React is not installed, returns a string error.
+ * If the renderer returns a string, it is returned as-is.
+ */
+export async function renderRendererToHtml(input) {
+    const renderer = input.renderer;
+    const out = typeof renderer === "function" ? renderer(input.props) : renderer;
+    if (typeof out === "string")
+        return out;
+    let React;
+    let ReactDomServer;
+    try {
+        React = await import("react");
+        ReactDomServer = await import("react-dom/server");
+    }
+    catch (e) {
+        return `renderRendererToHtml requires react + react-dom/server: ${String(e?.message ?? e)}`;
+    }
+    if (out && typeof out === "object") {
+        // Assume it's a React element
+        return ReactDomServer.renderToStaticMarkup(out);
+    }
+    // As a fallback, treat renderer as a component and render it.
+    const el = React.createElement(renderer, input.props);
+    return ReactDomServer.renderToStaticMarkup(el);
+}
+//# sourceMappingURL=index.js.map

package/packages/engine/dist/jsx/index.js.map

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

package/packages/engine/dist/local/in-memory-native-item-store.d.ts

@@ -0,0 +1,29 @@
+import type { CatalogId, ItemId } from "@x12i/catalox-contracts/ids.js";
+import type { NativeCatalogItemRecord } from "@x12i/catalox-contracts/items.js";
+export type InMemoryNativeItemStoreOptions = {
+    access: "read-only" | "read-write";
+};
+export declare class InMemoryNativeItemStore {
+    private readonly options;
+    private readonly byCatalog;
+    constructor(initialItems: NativeCatalogItemRecord[], options: InMemoryNativeItemStoreOptions);
+    private catalogMap;
+    private putRecord;
+    private assertWritable;
+    get(catalogId: CatalogId, storageDocId: ItemId): Promise<NativeCatalogItemRecord | null>;
+    findByLogicalItemId(catalogId: CatalogId, logicalItemId: ItemId): Promise<NativeCatalogItemRecord[]>;
+    list(catalogId: CatalogId, options?: {
+        limit?: number;
+        offset?: number;
+        filterEq?: Record<string, unknown>;
+        filterArrayContains?: Record<string, string>;
+        sort?: Record<string, 1 | -1>;
+    }): Promise<NativeCatalogItemRecord[]>;
+    upsert(catalogId: CatalogId, record: NativeCatalogItemRecord): Promise<void>;
+    replace(catalogId: CatalogId, record: NativeCatalogItemRecord): Promise<void>;
+    delete(catalogId: CatalogId, storageDocId: ItemId): Promise<void>;
+    batchUpsert(catalogId: CatalogId, records: NativeCatalogItemRecord[]): Promise<void>;
+    batchReplace(catalogId: CatalogId, records: NativeCatalogItemRecord[]): Promise<void>;
+    invalidateLayoutCache(_catalogId?: CatalogId): void;
+}
+//# sourceMappingURL=in-memory-native-item-store.d.ts.map

package/packages/engine/dist/local/in-memory-native-item-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-native-item-store.d.ts","sourceRoot":"","sources":["../../src/local/in-memory-native-item-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAIhF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,MAAM,EAAE,WAAW,GAAG,YAAY,CAAC;CACpC,CAAC;AA6CF,qBAAa,uBAAuB;IAKhC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8D;gBAGtF,YAAY,EAAE,uBAAuB,EAAE,EACtB,OAAO,EAAE,8BAA8B;IAO1D,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,cAAc;IAMhB,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAIxF,mBAAmB,CAAC,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAKpG,IAAI,CACR,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7C,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;KAC/B,GACA,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAe/B,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5E,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7E,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjE,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,uBAAuB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAOpF,YAAY,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,uBAAuB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3F,qBAAqB,CAAC,UAAU,CAAC,EAAE,SAAS,GAAG,IAAI;CAGpD"}

package/packages/engine/dist/local/in-memory-native-item-store.js

@@ -0,0 +1,117 @@
+import { storageDocIdForNativeRecord } from "../catalox/item-scope.js";
+import { LocalStoreReadOnlyError } from "./local-store-error.js";
+function indexedValue(record, key) {
+    return record.indexed?.[key];
+}
+function matchesFilterEq(record, filterEq) {
+    for (const [k, v] of Object.entries(filterEq)) {
+        if (indexedValue(record, k) !== v)
+            return false;
+    }
+    return true;
+}
+function matchesFilterArrayContains(record, filterArrayContains) {
+    for (const [k, v] of Object.entries(filterArrayContains)) {
+        const raw = indexedValue(record, k);
+        if (!Array.isArray(raw) || !raw.includes(v))
+            return false;
+    }
+    return true;
+}
+function sortRecords(records, sort) {
+    const keys = Object.keys(sort);
+    if (!keys.length)
+        return records;
+    return [...records].sort((a, b) => {
+        for (const key of keys) {
+            const dir = sort[key] ?? 1;
+            const av = indexedValue(a, key);
+            const bv = indexedValue(b, key);
+            if (av === bv)
+                continue;
+            if (av == null)
+                return dir === 1 ? -1 : 1;
+            if (bv == null)
+                return dir === 1 ? 1 : -1;
+            if (av < bv)
+                return dir === 1 ? -1 : 1;
+            if (av > bv)
+                return dir === 1 ? 1 : -1;
+        }
+        return 0;
+    });
+}
+export class InMemoryNativeItemStore {
+    options;
+    byCatalog = new Map();
+    constructor(initialItems, options) {
+        this.options = options;
+        for (const record of initialItems) {
+            this.putRecord(record);
+        }
+    }
+    catalogMap(catalogId) {
+        const key = String(catalogId);
+        let map = this.byCatalog.get(key);
+        if (!map) {
+            map = new Map();
+            this.byCatalog.set(key, map);
+        }
+        return map;
+    }
+    putRecord(record) {
+        const docId = storageDocIdForNativeRecord(record);
+        this.catalogMap(record.catalogId).set(String(docId), record);
+    }
+    assertWritable(operation) {
+        if (this.options.access === "read-only") {
+            throw new LocalStoreReadOnlyError(operation);
+        }
+    }
+    async get(catalogId, storageDocId) {
+        return this.catalogMap(catalogId).get(String(storageDocId)) ?? null;
+    }
+    async findByLogicalItemId(catalogId, logicalItemId) {
+        const id = String(logicalItemId);
+        return [...this.catalogMap(catalogId).values()].filter((r) => String(r.itemId) === id);
+    }
+    async list(catalogId, options) {
+        const filterEq = options?.filterEq ?? {};
+        const filterArrayContains = options?.filterArrayContains ?? {};
+        const sort = options?.sort ?? {};
+        const offset = options?.offset ?? 0;
+        const limit = options?.limit ?? 100;
+        let records = [...this.catalogMap(catalogId).values()];
+        records = records.filter((r) => matchesFilterEq(r, filterEq) && matchesFilterArrayContains(r, filterArrayContains));
+        records = sortRecords(records, sort);
+        return records.slice(offset, offset + limit);
+    }
+    async upsert(catalogId, record) {
+        this.assertWritable("upsert native catalog item");
+        this.putRecord({ ...record, catalogId });
+    }
+    async replace(catalogId, record) {
+        this.assertWritable("replace native catalog item");
+        this.putRecord({ ...record, catalogId });
+    }
+    async delete(catalogId, storageDocId) {
+        this.assertWritable("delete native catalog item");
+        this.catalogMap(catalogId).delete(String(storageDocId));
+    }
+    async batchUpsert(catalogId, records) {
+        this.assertWritable("batch upsert native catalog items");
+        for (const record of records) {
+            this.putRecord({ ...record, catalogId });
+        }
+    }
+    async batchReplace(catalogId, records) {
+        this.assertWritable("batch replace native catalog items");
+        for (const record of records) {
+            this.putRecord({ ...record, catalogId });
+        }
+    }
+    invalidateLayoutCache(_catalogId) {
+        // No-op for in-memory store.
+    }
+}
+//# sourceMappingURL=in-memory-native-item-store.js.map

package/packages/engine/dist/local/in-memory-native-item-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-native-item-store.js","sourceRoot":"","sources":["../../src/local/in-memory-native-item-store.ts"],"names":[],"mappings":"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"}

package/packages/engine/dist/local/in-memory-stores.d.ts

@@ -0,0 +1,35 @@
+import type { AppId, BindingId, CatalogId } from "@x12i/catalox-contracts/ids.js";
+import type { CatalogBindingRecord } from "@x12i/catalox-contracts/bindings.js";
+import type { CatalogRecord } from "@x12i/catalox-contracts/catalogs.js";
+import type { CatalogDescriptorRecord } from "@x12i/catalox-contracts/descriptors.js";
+export declare class InMemoryCatalogStore {
+    private readonly access;
+    private readonly records;
+    constructor(initial?: CatalogRecord[], access?: "read-only" | "read-write");
+    private assertWritable;
+    get(catalogId: CatalogId): Promise<CatalogRecord | null>;
+    upsert(record: CatalogRecord): Promise<void>;
+    listAll(): Promise<CatalogRecord[]>;
+    delete(catalogId: CatalogId): Promise<void>;
+}
+export declare class InMemoryDescriptorStore {
+    private readonly access;
+    private readonly records;
+    constructor(initial?: CatalogDescriptorRecord[], access?: "read-only" | "read-write");
+    private assertWritable;
+    get(catalogId: CatalogId): Promise<CatalogDescriptorRecord | null>;
+    upsert(record: CatalogDescriptorRecord): Promise<void>;
+}
+export declare class InMemoryBindingStore {
+    private readonly access;
+    private readonly records;
+    constructor(initial?: CatalogBindingRecord[], access?: "read-only" | "read-write");
+    private assertWritable;
+    get(bindingId: BindingId): Promise<CatalogBindingRecord | null>;
+    findByAppCatalog(appId: AppId, catalogId: CatalogId): Promise<CatalogBindingRecord | null>;
+    listByApp(appId: AppId): Promise<CatalogBindingRecord[]>;
+    listByCatalog(catalogId: CatalogId): Promise<CatalogBindingRecord[]>;
+    delete(bindingId: BindingId): Promise<void>;
+    upsert(record: CatalogBindingRecord): Promise<void>;
+}
+//# sourceMappingURL=in-memory-stores.d.ts.map

package/packages/engine/dist/local/in-memory-stores.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-stores.d.ts","sourceRoot":"","sources":["../../src/local/in-memory-stores.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAClF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAGtF,qBAAa,oBAAoB;IAGQ,OAAO,CAAC,QAAQ,CAAC,MAAM;IAF9D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;gBAEhD,OAAO,CAAC,EAAE,aAAa,EAAE,EAAmB,MAAM,GAAE,WAAW,GAAG,YAA0B;IAMxG,OAAO,CAAC,cAAc;IAIhB,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAIxD,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5C,OAAO,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAInC,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;CAIlD;AAED,qBAAa,uBAAuB;IAGe,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFxE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8C;gBAE1D,OAAO,CAAC,EAAE,uBAAuB,EAAE,EAAmB,MAAM,GAAE,WAAW,GAAG,YAA0B;IAMlH,OAAO,CAAC,cAAc;IAIhB,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAIlE,MAAM,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;CAI7D;AAED,qBAAa,oBAAoB;IAGe,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFrE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2C;gBAEvD,OAAO,CAAC,EAAE,oBAAoB,EAAE,EAAmB,MAAM,GAAE,WAAW,GAAG,YAA0B;IAM/G,OAAO,CAAC,cAAc;IAIhB,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAI/D,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAO1F,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAIxD,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAIpE,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3C,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;CAI1D"}

package/packages/engine/dist/local/in-memory-stores.js.map

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

package/packages/engine/dist/local/index.d.ts

@@ -0,0 +1,4 @@
+export { LocalFileStore, type LocalStoreOptions, CATALOX_CATALOG_LOCAL_SCHEMA_V1, type CataloxCatalogLocalSnapshotV1, } from "./local-file-store.js";
+export { LocalStoreError, LocalStoreSnapshotError, LocalStoreReadOnlyError, LocalStoreOperatorUnavailableError, } from "./local-store-error.js";
+export { loadLocalSnapshot, type LoadedLocalSnapshot } from "./snapshot.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/engine/dist/local/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/local/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,KAAK,iBAAiB,EACtB,+BAA+B,EAC/B,KAAK,6BAA6B,GACnC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,kCAAkC,GACnC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC"}

package/packages/engine/dist/local/index.js

@@ -0,0 +1,4 @@
+export { LocalFileStore, CATALOX_CATALOG_LOCAL_SCHEMA_V1, } from "./local-file-store.js";
+export { LocalStoreError, LocalStoreSnapshotError, LocalStoreReadOnlyError, LocalStoreOperatorUnavailableError, } from "./local-store-error.js";
+export { loadLocalSnapshot } from "./snapshot.js";
+//# sourceMappingURL=index.js.map

package/packages/engine/dist/local/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/local/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAEd,+BAA+B,GAEhC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,kCAAkC,GACnC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAA4B,MAAM,eAAe,CAAC"}

package/packages/engine/dist/local/local-file-store.d.ts

@@ -0,0 +1,19 @@
+import type { LoadedLocalSnapshot, LocalStoreOptions } from "./snapshot.js";
+import { InMemoryNativeItemStore } from "./in-memory-native-item-store.js";
+import { InMemoryBindingStore, InMemoryCatalogStore, InMemoryDescriptorStore } from "./in-memory-stores.js";
+export type { LocalStoreOptions } from "./snapshot.js";
+export { CATALOX_CATALOG_LOCAL_SCHEMA_V1, type CataloxCatalogLocalSnapshotV1 } from "./snapshot.js";
+/**
+ * File-backed read-optimized Catalox store for offline embedders.
+ * Loads a normalized snapshot from disk and serves catalog reads from memory.
+ */
+export declare class LocalFileStore {
+    readonly access: "read-only" | "read-write";
+    readonly snapshot: LoadedLocalSnapshot;
+    readonly nativeItems: InMemoryNativeItemStore;
+    readonly catalogs: InMemoryCatalogStore;
+    readonly descriptors: InMemoryDescriptorStore;
+    readonly bindings: InMemoryBindingStore;
+    constructor(options: LocalStoreOptions);
+}
+//# sourceMappingURL=local-file-store.d.ts.map

package/packages/engine/dist/local/local-file-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-file-store.d.ts","sourceRoot":"","sources":["../../src/local/local-file-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,+BAA+B,EAAE,KAAK,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAEpG;;;GAGG;AACH,qBAAa,cAAc;IACzB,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,YAAY,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,uBAAuB,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,uBAAuB,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;gBAE5B,OAAO,EAAE,iBAAiB;CAQvC"}

package/packages/engine/dist/local/local-file-store.js

@@ -0,0 +1,25 @@
+import { loadLocalSnapshot } from "./snapshot.js";
+import { InMemoryNativeItemStore } from "./in-memory-native-item-store.js";
+import { InMemoryBindingStore, InMemoryCatalogStore, InMemoryDescriptorStore, } from "./in-memory-stores.js";
+export { CATALOX_CATALOG_LOCAL_SCHEMA_V1 } from "./snapshot.js";
+/**
+ * File-backed read-optimized Catalox store for offline embedders.
+ * Loads a normalized snapshot from disk and serves catalog reads from memory.
+ */
+export class LocalFileStore {
+    access;
+    snapshot;
+    nativeItems;
+    catalogs;
+    descriptors;
+    bindings;
+    constructor(options) {
+        this.access = options.access ?? "read-only";
+        this.snapshot = loadLocalSnapshot(options);
+        this.nativeItems = new InMemoryNativeItemStore(this.snapshot.items, { access: this.access });
+        this.catalogs = new InMemoryCatalogStore([this.snapshot.catalog], this.access);
+        this.descriptors = new InMemoryDescriptorStore([this.snapshot.descriptor], this.access);
+        this.bindings = new InMemoryBindingStore([this.snapshot.binding], this.access);
+    }
+}
+//# sourceMappingURL=local-file-store.js.map

package/packages/engine/dist/local/local-file-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-file-store.js","sourceRoot":"","sources":["../../src/local/local-file-store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,+BAA+B,EAAsC,MAAM,eAAe,CAAC;AAEpG;;;GAGG;AACH,MAAM,OAAO,cAAc;IAChB,MAAM,CAA6B;IACnC,QAAQ,CAAsB;IAC9B,WAAW,CAA0B;IACrC,QAAQ,CAAuB;IAC/B,WAAW,CAA0B;IACrC,QAAQ,CAAuB;IAExC,YAAY,OAA0B;QACpC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,WAAW,CAAC;QAC5C,IAAI,CAAC,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,WAAW,GAAG,IAAI,uBAAuB,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7F,IAAI,CAAC,QAAQ,GAAG,IAAI,oBAAoB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/E,IAAI,CAAC,WAAW,GAAG,IAAI,uBAAuB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACxF,IAAI,CAAC,QAAQ,GAAG,IAAI,oBAAoB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACjF,CAAC;CACF"}

package/packages/engine/dist/local/local-store-error.d.ts

@@ -0,0 +1,14 @@
+import { CataloxError } from "@x12i/catalox-contracts/errors.js";
+export declare class LocalStoreError extends CataloxError {
+    constructor(code: string, message: string, details?: Record<string, unknown>);
+}
+export declare class LocalStoreSnapshotError extends LocalStoreError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export declare class LocalStoreReadOnlyError extends LocalStoreError {
+    constructor(operation: string, details?: Record<string, unknown>);
+}
+export declare class LocalStoreOperatorUnavailableError extends LocalStoreError {
+    constructor(feature: string, details?: Record<string, unknown>);
+}
+//# sourceMappingURL=local-store-error.d.ts.map

package/packages/engine/dist/local/local-store-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-store-error.d.ts","sourceRoot":"","sources":["../../src/local/local-store-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEjE,qBAAa,eAAgB,SAAQ,YAAY;gBACnC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAG7E;AAED,qBAAa,uBAAwB,SAAQ,eAAe;gBAC9C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAG/D;AAED,qBAAa,uBAAwB,SAAQ,eAAe;gBAC9C,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOjE;AAED,qBAAa,kCAAmC,SAAQ,eAAe;gBACzD,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAO/D"}

package/packages/engine/dist/local/local-store-error.js

@@ -0,0 +1,22 @@
+import { CataloxError } from "@x12i/catalox-contracts/errors.js";
+export class LocalStoreError extends CataloxError {
+    constructor(code, message, details) {
+        super(code, message, details);
+    }
+}
+export class LocalStoreSnapshotError extends LocalStoreError {
+    constructor(message, details) {
+        super("local.snapshot_error", message, details);
+    }
+}
+export class LocalStoreReadOnlyError extends LocalStoreError {
+    constructor(operation, details) {
+        super("local.read_only", `Local file store is read-only; cannot ${operation}.`, { operation, ...details });
+    }
+}
+export class LocalStoreOperatorUnavailableError extends LocalStoreError {
+    constructor(feature, details) {
+        super("local.operator_unavailable", `Firestore operator feature "${feature}" is not available in local file store mode.`, { feature, ...details });
+    }
+}
+//# sourceMappingURL=local-store-error.js.map

package/packages/engine/dist/local/local-store-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-store-error.js","sourceRoot":"","sources":["../../src/local/local-store-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEjE,MAAM,OAAO,eAAgB,SAAQ,YAAY;IAC/C,YAAY,IAAY,EAAE,OAAe,EAAE,OAAiC;QAC1E,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,eAAe;IAC1D,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,sBAAsB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,eAAe;IAC1D,YAAY,SAAiB,EAAE,OAAiC;QAC9D,KAAK,CACH,iBAAiB,EACjB,yCAAyC,SAAS,GAAG,EACrD,EAAE,SAAS,EAAE,GAAG,OAAO,EAAE,CAC1B,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,kCAAmC,SAAQ,eAAe;IACrE,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CACH,4BAA4B,EAC5B,+BAA+B,OAAO,8CAA8C,EACpF,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CACxB,CAAC;IACJ,CAAC;CACF"}