@x12i/catalox 5.1.3 → 5.2.0

package/dist/src/local/snapshot.js

@@ -0,0 +1,192 @@
+import { readFileSync, existsSync, statSync } from "node:fs";
+import path from "node:path";
+import { LocalStoreSnapshotError } from "./local-store-error.js";
+export const FUNCX_CATALOG_LOCAL_SCHEMA_V1 = "funcx.catalog.local.v1";
+function isRecord(v) {
+    return v != null && typeof v === "object" && !Array.isArray(v);
+}
+function resolveSnapshotFilePath(options) {
+    if (options.snapshotPath?.trim()) {
+        const p = path.resolve(options.snapshotPath.trim());
+        if (!existsSync(p)) {
+            throw new LocalStoreSnapshotError(`Snapshot file not found: ${p}`, { path: p });
+        }
+        return p;
+    }
+    const root = path.resolve(options.root.trim());
+    if (!existsSync(root)) {
+        throw new LocalStoreSnapshotError(`Local store root not found: ${root}`, { path: root });
+    }
+    const stat = statSync(root);
+    if (stat.isFile())
+        return root;
+    if (!stat.isDirectory()) {
+        throw new LocalStoreSnapshotError(`Local store root must be a file or directory: ${root}`, { path: root });
+    }
+    const candidates = ["catalog.local.json", "snapshot.json", "catalog.json"];
+    for (const name of candidates) {
+        const candidate = path.join(root, name);
+        if (existsSync(candidate) && statSync(candidate).isFile())
+            return candidate;
+    }
+    throw new LocalStoreSnapshotError(`No snapshot JSON found in directory ${root}. Expected one of: ${candidates.join(", ")}`, { path: root, candidates });
+}
+function parseSnapshotJson(raw, filePath) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (e) {
+        throw new LocalStoreSnapshotError(`Invalid JSON in snapshot: ${filePath}`, {
+            path: filePath,
+            parseError: String(e?.message ?? e),
+        });
+    }
+    if (!isRecord(parsed)) {
+        throw new LocalStoreSnapshotError(`Snapshot root must be a JSON object: ${filePath}`, { path: filePath });
+    }
+    if (parsed.schemaVersion !== FUNCX_CATALOG_LOCAL_SCHEMA_V1) {
+        throw new LocalStoreSnapshotError(`Unsupported snapshot schemaVersion "${String(parsed.schemaVersion)}". Expected "${FUNCX_CATALOG_LOCAL_SCHEMA_V1}".`, { path: filePath, schemaVersion: parsed.schemaVersion, expected: FUNCX_CATALOG_LOCAL_SCHEMA_V1 });
+    }
+    const appId = String(parsed.appId ?? "").trim();
+    const catalogId = String(parsed.catalogId ?? "").trim();
+    if (!appId || !catalogId) {
+        throw new LocalStoreSnapshotError(`Snapshot must include appId and catalogId: ${filePath}`, {
+            path: filePath,
+            appId,
+            catalogId,
+        });
+    }
+    if (!Array.isArray(parsed.items)) {
+        throw new LocalStoreSnapshotError(`Snapshot items must be an array: ${filePath}`, { path: filePath });
+    }
+    return parsed;
+}
+function normalizeSnapshotItem(raw, catalogId, index) {
+    if (!isRecord(raw)) {
+        throw new LocalStoreSnapshotError(`Snapshot item at index ${index} must be an object`, { index });
+    }
+    // Unified row shape: { data, indexed?, metadata?, scope? }
+    if (isRecord(raw.data) && raw.itemId == null) {
+        const data = raw.data;
+        const itemId = String(data.itemId ?? "").trim();
+        if (!itemId) {
+            throw new LocalStoreSnapshotError(`Snapshot item at index ${index} is missing data.itemId`, { index });
+        }
+        const record = {
+            itemId,
+            catalogId,
+            data,
+            metadata: isRecord(raw.metadata) ? raw.metadata : {},
+        };
+        if (raw.scope != null && isRecord(raw.scope)) {
+            record.scope = raw.scope;
+        }
+        if (raw.indexed != null && isRecord(raw.indexed)) {
+            record.indexed = raw.indexed;
+        }
+        return record;
+    }
+    const itemId = String(raw.itemId ?? "").trim();
+    if (!itemId) {
+        throw new LocalStoreSnapshotError(`Snapshot item at index ${index} is missing itemId`, { index });
+    }
+    const data = isRecord(raw.data) ? raw.data : raw;
+    const record = {
+        itemId,
+        catalogId: String(raw.catalogId ?? catalogId),
+        data,
+        metadata: isRecord(raw.metadata) ? raw.metadata : {},
+    };
+    if (raw.scope != null && isRecord(raw.scope)) {
+        record.scope = raw.scope;
+    }
+    if (raw.indexed != null && isRecord(raw.indexed)) {
+        record.indexed = raw.indexed;
+    }
+    return record;
+}
+function defaultCatalogRecord(catalogId) {
+    const now = new Date(0).toISOString();
+    return {
+        catalogId,
+        name: catalogId,
+        catalogType: catalogId,
+        sourceMode: "native",
+        catalogItems: { providerType: "internal", metadata: {} },
+        metadata: { status: "active", createdAt: now, lastUpdate: now },
+    };
+}
+function defaultDescriptorRecord(catalogId) {
+    const now = new Date(0).toISOString();
+    return {
+        catalogId,
+        descriptorVersion: "1",
+        descriptor: {
+            catalogId,
+            label: catalogId,
+            sourceMode: "native",
+            status: "active",
+            capabilities: {
+                canList: true,
+                canGet: true,
+                canCreate: false,
+                canEdit: false,
+                canDelete: false,
+                canExport: true,
+            },
+            queryableFields: [
+                { key: "functionId", label: "Function", type: "string", indexed: true, filterable: true },
+            ],
+            identity: { itemIdStrategy: "natural", itemIdField: "itemId", titleField: "title" },
+        },
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+function defaultBindingRecord(appId, catalogId) {
+    const now = new Date(0).toISOString();
+    return {
+        bindingId: `${appId}:${catalogId}`,
+        appId,
+        catalogId,
+        access: { canRead: true, canWrite: false, canAdmin: false },
+        status: "active",
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+export function loadLocalSnapshot(options) {
+    const filePath = resolveSnapshotFilePath(options);
+    const raw = readFileSync(filePath, "utf8");
+    const snapshot = parseSnapshotJson(raw, filePath);
+    const prebuilt = options.prebuiltCatalog !== false;
+    const catalog = snapshot.catalog ??
+        (prebuilt ? defaultCatalogRecord(snapshot.catalogId) : undefined);
+    const descriptor = snapshot.descriptor ??
+        (prebuilt ? defaultDescriptorRecord(snapshot.catalogId) : undefined);
+    const binding = snapshot.binding ??
+        (prebuilt ? defaultBindingRecord(snapshot.appId, snapshot.catalogId) : undefined);
+    if (!catalog) {
+        throw new LocalStoreSnapshotError(`Snapshot is missing catalog record: ${filePath}`, { path: filePath });
+    }
+    if (!descriptor) {
+        throw new LocalStoreSnapshotError(`Snapshot is missing descriptor record: ${filePath}`, { path: filePath });
+    }
+    if (!binding) {
+        throw new LocalStoreSnapshotError(`Snapshot is missing binding record: ${filePath}`, { path: filePath });
+    }
+    if (catalog.catalogId !== snapshot.catalogId) {
+        throw new LocalStoreSnapshotError(`Catalog id mismatch: snapshot.catalogId="${snapshot.catalogId}" but catalog.catalogId="${catalog.catalogId}"`, { path: filePath, snapshotCatalogId: snapshot.catalogId, catalogCatalogId: catalog.catalogId });
+    }
+    const items = snapshot.items.map((row, i) => normalizeSnapshotItem(row, snapshot.catalogId, i));
+    return {
+        appId: snapshot.appId,
+        catalogId: snapshot.catalogId,
+        catalog,
+        descriptor,
+        binding,
+        items,
+    };
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/src/local/snapshot.js.map

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

package/dist/src/local/stub-deps.d.ts

@@ -0,0 +1,65 @@
+/** Minimal no-op stores for Catalox deps not used on the local read path. */
+export declare function createLocalStubDeps(): {
+    apps: {
+        get: () => Promise<null>;
+        upsert: () => Promise<never>;
+    };
+    definitions: {
+        get: () => Promise<null>;
+        upsert: () => Promise<never>;
+    };
+    mappings: {
+        get: () => Promise<null>;
+        upsert: () => Promise<never>;
+        listAll: () => Promise<any[]>;
+    };
+    references: {
+        listByCatalog: () => Promise<any[]>;
+        listByToCatalog: () => Promise<any[]>;
+        listReferencingCatalog: () => Promise<any[]>;
+        listByItem: () => Promise<any[]>;
+        listToItem: () => Promise<any[]>;
+        delete: () => Promise<never>;
+        upsert: () => Promise<never>;
+    };
+    snapshots: {
+        get: () => Promise<null>;
+        upsert: () => Promise<never>;
+        listByCatalog: () => Promise<any[]>;
+    };
+    adapters: {
+        get: () => Promise<null>;
+        upsert: () => Promise<never>;
+        listAll: () => Promise<any[]>;
+    };
+    catalogDataIndex: {
+        get: () => Promise<null>;
+        upsert: () => Promise<never>;
+    };
+    storeAppBindings: {
+        get: () => Promise<null>;
+        upsert: () => Promise<never>;
+        listByStore: () => Promise<any[]>;
+    };
+    identityBindings: {
+        get: () => Promise<null>;
+        upsert: () => Promise<never>;
+        listByCatalog: () => Promise<any[]>;
+        listByIdentity: () => Promise<any[]>;
+    };
+    catalogTypes: {
+        resolveForContext: () => Promise<null>;
+        upsert: () => Promise<never>;
+    };
+    domains: {
+        get: () => Promise<null>;
+        upsert: () => Promise<never>;
+        listAll: () => Promise<any[]>;
+    };
+    agents: {
+        get: () => Promise<null>;
+        upsert: () => Promise<never>;
+        listAll: () => Promise<any[]>;
+    };
+};
+//# sourceMappingURL=stub-deps.d.ts.map

package/dist/src/local/stub-deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub-deps.d.ts","sourceRoot":"","sources":["../../../src/local/stub-deps.ts"],"names":[],"mappings":"AAQA,6EAA6E;AAC7E,wBAAgB,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgClC"}

package/dist/src/local/stub-deps.js

@@ -0,0 +1,40 @@
+import { LocalStoreReadOnlyError } from "./local-store-error.js";
+function readOnly(method) {
+    return async () => {
+        throw new LocalStoreReadOnlyError(method);
+    };
+}
+/** Minimal no-op stores for Catalox deps not used on the local read path. */
+export function createLocalStubDeps() {
+    const emptyList = async () => [];
+    const emptyNull = async () => null;
+    const noop = async () => { };
+    return {
+        apps: { get: emptyNull, upsert: readOnly("upsert app") },
+        definitions: { get: emptyNull, upsert: readOnly("upsert definition") },
+        mappings: { get: emptyNull, upsert: readOnly("upsert mapping"), listAll: emptyList },
+        references: {
+            listByCatalog: emptyList,
+            listByToCatalog: emptyList,
+            listReferencingCatalog: emptyList,
+            listByItem: emptyList,
+            listToItem: emptyList,
+            delete: readOnly("delete reference"),
+            upsert: readOnly("upsert reference"),
+        },
+        snapshots: { get: emptyNull, upsert: readOnly("upsert snapshot"), listByCatalog: emptyList },
+        adapters: { get: emptyNull, upsert: readOnly("upsert adapter"), listAll: emptyList },
+        catalogDataIndex: { get: emptyNull, upsert: readOnly("upsert catalog data index") },
+        storeAppBindings: { get: emptyNull, upsert: readOnly("upsert store app binding"), listByStore: emptyList },
+        identityBindings: {
+            get: emptyNull,
+            upsert: readOnly("upsert identity binding"),
+            listByCatalog: emptyList,
+            listByIdentity: emptyList,
+        },
+        catalogTypes: { resolveForContext: emptyNull, upsert: readOnly("upsert catalog type") },
+        domains: { get: emptyNull, upsert: readOnly("upsert domain"), listAll: emptyList },
+        agents: { get: emptyNull, upsert: readOnly("upsert agent"), listAll: emptyList },
+    };
+}
+//# sourceMappingURL=stub-deps.js.map

package/dist/src/local/stub-deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub-deps.js","sourceRoot":"","sources":["../../../src/local/stub-deps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,SAAS,QAAQ,CAAC,MAAc;IAC9B,OAAO,KAAK,IAAI,EAAE;QAChB,MAAM,IAAI,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,mBAAmB;IACjC,MAAM,SAAS,GAAG,KAAK,IAAI,EAAE,CAAC,EAAW,CAAC;IAC1C,MAAM,SAAS,GAAG,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC;IACnC,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC;IAE5B,OAAO;QACL,IAAI,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE;QACxD,WAAW,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,mBAAmB,CAAC,EAAE;QACtE,QAAQ,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE;QACpF,UAAU,EAAE;YACV,aAAa,EAAE,SAAS;YACxB,eAAe,EAAE,SAAS;YAC1B,sBAAsB,EAAE,SAAS;YACjC,UAAU,EAAE,SAAS;YACrB,UAAU,EAAE,SAAS;YACrB,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC;YACpC,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC;SACrC;QACD,SAAS,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,aAAa,EAAE,SAAS,EAAE;QAC5F,QAAQ,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE;QACpF,gBAAgB,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,2BAA2B,CAAC,EAAE;QACnF,gBAAgB,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,0BAA0B,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE;QAC1G,gBAAgB,EAAE;YAChB,GAAG,EAAE,SAAS;YACd,MAAM,EAAE,QAAQ,CAAC,yBAAyB,CAAC;YAC3C,aAAa,EAAE,SAAS;YACxB,cAAc,EAAE,SAAS;SAC1B;QACD,YAAY,EAAE,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC,EAAE;QACvF,OAAO,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE;QAClF,MAAM,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE;KACjF,CAAC;AACJ,CAAC"}

package/dist/src/local/unavailable-firestore-store.d.ts

@@ -0,0 +1,13 @@
+import type { Firestore } from "firebase-admin/firestore";
+import { FirestoreStore } from "../firebase/firestore-store.js";
+/**
+ * Placeholder {@link FirestoreStore} for local read-only mode.
+ * Operator features that touch Firestore fail fast with a clear error.
+ */
+export declare class UnavailableFirestoreStore {
+    readonly firestore: Firestore;
+    collection(_path: string): void;
+    doc(_path: string): void;
+}
+export declare function asFirestoreStore(store: UnavailableFirestoreStore): FirestoreStore;
+//# sourceMappingURL=unavailable-firestore-store.d.ts.map

package/dist/src/local/unavailable-firestore-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unavailable-firestore-store.d.ts","sourceRoot":"","sources":["../../../src/local/unavailable-firestore-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAOhE;;;GAGG;AACH,qBAAa,yBAAyB;IACpC,QAAQ,CAAC,SAAS,YAIf;IAEH,UAAU,CAAC,KAAK,EAAE,MAAM;IAIxB,GAAG,CAAC,KAAK,EAAE,MAAM;CAGlB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,yBAAyB,GAAG,cAAc,CAEjF"}

package/dist/src/local/unavailable-firestore-store.js

@@ -0,0 +1,26 @@
+import { FirestoreStore } from "../firebase/firestore-store.js";
+import { LocalStoreOperatorUnavailableError } from "./local-store-error.js";
+function unavailable(feature) {
+    throw new LocalStoreOperatorUnavailableError(feature);
+}
+/**
+ * Placeholder {@link FirestoreStore} for local read-only mode.
+ * Operator features that touch Firestore fail fast with a clear error.
+ */
+export class UnavailableFirestoreStore {
+    firestore = new Proxy({}, {
+        get(_target, prop) {
+            unavailable(`firestore.${String(prop)}`);
+        },
+    });
+    collection(_path) {
+        unavailable("firestore.collection");
+    }
+    doc(_path) {
+        unavailable("firestore.doc");
+    }
+}
+export function asFirestoreStore(store) {
+    return store;
+}
+//# sourceMappingURL=unavailable-firestore-store.js.map

package/dist/src/local/unavailable-firestore-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unavailable-firestore-store.js","sourceRoot":"","sources":["../../../src/local/unavailable-firestore-store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,kCAAkC,EAAE,MAAM,wBAAwB,CAAC;AAE5E,SAAS,WAAW,CAAC,OAAe;IAClC,MAAM,IAAI,kCAAkC,CAAC,OAAO,CAAC,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,yBAAyB;IAC3B,SAAS,GAAG,IAAI,KAAK,CAAC,EAAe,EAAE;QAC9C,GAAG,CAAC,OAAO,EAAE,IAAI;YACf,WAAW,CAAC,aAAa,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC,CAAC;IAEH,UAAU,CAAC,KAAa;QACtB,WAAW,CAAC,sBAAsB,CAAC,CAAC;IACtC,CAAC;IAED,GAAG,CAAC,KAAa;QACf,WAAW,CAAC,eAAe,CAAC,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAgC;IAC/D,OAAO,KAAkC,CAAC;AAC5C,CAAC"}

package/dist/src/local/wire-local-catalox.d.ts

@@ -0,0 +1,10 @@
+import { Catalox } from "../catalox/catalox.js";
+import type { StackLoggingOptions } from "@x12i/logxer";
+import type { LocalFileStore } from "./local-file-store.js";
+export type CataloxLocalRuntimeConfig = {
+    store: LocalFileStore;
+    logging?: StackLoggingOptions;
+};
+/** Wire a {@link Catalox} instance from a loaded {@link LocalFileStore} (no Firebase). */
+export declare function wireCataloxFromLocalStore(config: CataloxLocalRuntimeConfig): Catalox;
+//# sourceMappingURL=wire-local-catalox.d.ts.map

package/dist/src/local/wire-local-catalox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire-local-catalox.d.ts","sourceRoot":"","sources":["../../../src/local/wire-local-catalox.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGhD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAI5D,MAAM,MAAM,yBAAyB,GAAG;IACtC,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B,CAAC;AAEF,0FAA0F;AAC1F,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CA8BpF"}

package/dist/src/local/wire-local-catalox.js

@@ -0,0 +1,37 @@
+import { AuthorizationService } from "../catalox/authorization.js";
+import { Catalox } from "../catalox/catalox.js";
+import { createBundledPayloadSchemaRegistry } from "../validation/payload-schema-registry.js";
+import { applyCataloxStackLogging } from "../logging.js";
+import { createLocalStubDeps } from "./stub-deps.js";
+import { asFirestoreStore, UnavailableFirestoreStore } from "./unavailable-firestore-store.js";
+/** Wire a {@link Catalox} instance from a loaded {@link LocalFileStore} (no Firebase). */
+export function wireCataloxFromLocalStore(config) {
+    applyCataloxStackLogging(config.logging);
+    const store = config.store;
+    const stubs = createLocalStubDeps();
+    const authz = new AuthorizationService(store.bindings);
+    const payloadSchemas = createBundledPayloadSchemaRegistry();
+    const firestoreStore = asFirestoreStore(new UnavailableFirestoreStore());
+    return new Catalox({
+        apps: stubs.apps,
+        catalogs: store.catalogs,
+        bindings: store.bindings,
+        storeAppBindings: stubs.storeAppBindings,
+        identityBindings: stubs.identityBindings,
+        catalogTypes: stubs.catalogTypes,
+        domains: stubs.domains,
+        agents: stubs.agents,
+        definitions: stubs.definitions,
+        mappings: stubs.mappings,
+        descriptors: store.descriptors,
+        references: stubs.references,
+        nativeItems: store.nativeItems,
+        snapshots: stubs.snapshots,
+        adapters: stubs.adapters,
+        firestoreStore,
+        catalogDataIndex: stubs.catalogDataIndex,
+        authz,
+        payloadSchemas,
+    });
+}
+//# sourceMappingURL=wire-local-catalox.js.map

package/dist/src/local/wire-local-catalox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire-local-catalox.js","sourceRoot":"","sources":["../../../src/local/wire-local-catalox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,kCAAkC,EAAE,MAAM,0CAA0C,CAAC;AAC9F,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAGzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAO/F,0FAA0F;AAC1F,MAAM,UAAU,yBAAyB,CAAC,MAAiC;IACzE,wBAAwB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEzC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3B,MAAM,KAAK,GAAG,mBAAmB,EAAE,CAAC;IACpC,MAAM,KAAK,GAAG,IAAI,oBAAoB,CAAC,KAAK,CAAC,QAAe,CAAC,CAAC;IAC9D,MAAM,cAAc,GAAG,kCAAkC,EAAE,CAAC;IAC5D,MAAM,cAAc,GAAG,gBAAgB,CAAC,IAAI,yBAAyB,EAAE,CAAC,CAAC;IAEzE,OAAO,IAAI,OAAO,CAAC;QACjB,IAAI,EAAE,KAAK,CAAC,IAAW;QACvB,QAAQ,EAAE,KAAK,CAAC,QAAe;QAC/B,QAAQ,EAAE,KAAK,CAAC,QAAe;QAC/B,gBAAgB,EAAE,KAAK,CAAC,gBAAuB;QAC/C,gBAAgB,EAAE,KAAK,CAAC,gBAAuB;QAC/C,YAAY,EAAE,KAAK,CAAC,YAAmB;QACvC,OAAO,EAAE,KAAK,CAAC,OAAc;QAC7B,MAAM,EAAE,KAAK,CAAC,MAAa;QAC3B,WAAW,EAAE,KAAK,CAAC,WAAkB;QACrC,QAAQ,EAAE,KAAK,CAAC,QAAe;QAC/B,WAAW,EAAE,KAAK,CAAC,WAAkB;QACrC,UAAU,EAAE,KAAK,CAAC,UAAiB;QACnC,WAAW,EAAE,KAAK,CAAC,WAAkB;QACrC,SAAS,EAAE,KAAK,CAAC,SAAgB;QACjC,QAAQ,EAAE,KAAK,CAAC,QAAe;QAC/B,cAAc;QACd,gBAAgB,EAAE,KAAK,CAAC,gBAAuB;QAC/C,KAAK;QACL,cAAc;KACf,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x12i/catalox",
-  "version": "5.1.3",
+  "version": "5.2.0",
   "description": "Platform infrastructure for reusable, interoperable catalogs across apps and data sources.",
   "license": "MIT",
   "private": false,