@x12i/catalox 1.1.0

package/dist/firebase/descriptor-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor-store.js","sourceRoot":"","sources":["../../src/firebase/descriptor-store.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,OAAO,eAAe;IACG;IAA7B,YAA6B,KAAqB;QAArB,UAAK,GAAL,KAAK,CAAgB;IAAG,CAAC;IAE9C,MAAM,CAAC,SAAoB;QACjC,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,SAAoB;QAC5B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAE,IAAI,CAAC,IAAI,EAA8B,CAAC,CAAC,CAAC,IAAI,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAA+B;QAC1C,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC;CACF"}

package/dist/firebase/firestore-store.d.ts

@@ -0,0 +1,14 @@
+import type { App } from "firebase-admin/app";
+import type { Firestore } from "firebase-admin/firestore";
+export type FirestoreStoreOptions = {
+    firestore: Firestore;
+    app?: App;
+};
+export declare class FirestoreStore {
+    readonly firestore: Firestore;
+    readonly app: App | undefined;
+    constructor(options: FirestoreStoreOptions);
+    collection(path: string): FirebaseFirestore.CollectionReference<FirebaseFirestore.DocumentData, FirebaseFirestore.DocumentData>;
+    doc(path: string): FirebaseFirestore.DocumentReference<FirebaseFirestore.DocumentData, FirebaseFirestore.DocumentData>;
+}
+//# sourceMappingURL=firestore-store.d.ts.map

package/dist/firebase/firestore-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firestore-store.d.ts","sourceRoot":"","sources":["../../src/firebase/firestore-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,SAAS,CAAC;IACrB,GAAG,CAAC,EAAE,GAAG,CAAC;CACX,CAAC;AAEF,qBAAa,cAAc;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,SAAS,CAAC;gBAElB,OAAO,EAAE,qBAAqB;IAK1C,UAAU,CAAC,IAAI,EAAE,MAAM;IAIvB,GAAG,CAAC,IAAI,EAAE,MAAM;CAGjB"}

package/dist/firebase/firestore-store.js

@@ -0,0 +1,15 @@
+export class FirestoreStore {
+    firestore;
+    app;
+    constructor(options) {
+        this.firestore = options.firestore;
+        this.app = options.app;
+    }
+    collection(path) {
+        return this.firestore.collection(path);
+    }
+    doc(path) {
+        return this.firestore.doc(path);
+    }
+}
+//# sourceMappingURL=firestore-store.js.map

package/dist/firebase/firestore-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"firestore-store.js","sourceRoot":"","sources":["../../src/firebase/firestore-store.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,cAAc;IAChB,SAAS,CAAY;IACrB,GAAG,CAAkB;IAE9B,YAAY,OAA8B;QACxC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACzB,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;CACF"}

package/dist/firebase/index.d.ts

@@ -0,0 +1,12 @@
+export * from "./firestore-store.js";
+export * from "./app-store.js";
+export * from "./catalog-store.js";
+export * from "./binding-store.js";
+export * from "./definition-store.js";
+export * from "./mapping-store.js";
+export * from "./adapter-store.js";
+export * from "./descriptor-store.js";
+export * from "./reference-store.js";
+export * from "./native-item-store.js";
+export * from "./snapshot-store.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/firebase/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/firebase/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC"}

package/dist/firebase/index.js

@@ -0,0 +1,12 @@
+export * from "./firestore-store.js";
+export * from "./app-store.js";
+export * from "./catalog-store.js";
+export * from "./binding-store.js";
+export * from "./definition-store.js";
+export * from "./mapping-store.js";
+export * from "./adapter-store.js";
+export * from "./descriptor-store.js";
+export * from "./reference-store.js";
+export * from "./native-item-store.js";
+export * from "./snapshot-store.js";
+//# sourceMappingURL=index.js.map

package/dist/firebase/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/firebase/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC"}

package/dist/firebase/mapping-store.d.ts

@@ -0,0 +1,11 @@
+import type { CatalogMappingRecord } from "../contracts/mappings.js";
+import type { MappingId } from "../contracts/ids.js";
+import { FirestoreStore } from "./firestore-store.js";
+export declare class MappingStore {
+    private readonly store;
+    constructor(store: FirestoreStore);
+    private docRef;
+    get(mappingId: MappingId): Promise<CatalogMappingRecord | null>;
+    upsert(record: CatalogMappingRecord): Promise<void>;
+}
+//# sourceMappingURL=mapping-store.d.ts.map

package/dist/firebase/mapping-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping-store.d.ts","sourceRoot":"","sources":["../../src/firebase/mapping-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,cAAc;IAElD,OAAO,CAAC,MAAM;IAIR,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAK/D,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;CAG1D"}

package/dist/firebase/mapping-store.js

@@ -0,0 +1,18 @@
+import { FirestoreStore } from "./firestore-store.js";
+export class MappingStore {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    docRef(mappingId) {
+        return this.store.collection("catalogMappings").doc(mappingId);
+    }
+    async get(mappingId) {
+        const snap = await this.docRef(mappingId).get();
+        return snap.exists ? snap.data() : null;
+    }
+    async upsert(record) {
+        await this.docRef(record.mappingId).set(record, { merge: true });
+    }
+}
+//# sourceMappingURL=mapping-store.js.map

package/dist/firebase/mapping-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping-store.js","sourceRoot":"","sources":["../../src/firebase/mapping-store.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,KAAqB;QAArB,UAAK,GAAL,KAAK,CAAgB;IAAG,CAAC;IAE9C,MAAM,CAAC,SAAoB;QACjC,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,SAAoB;QAC5B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAE,IAAI,CAAC,IAAI,EAA2B,CAAC,CAAC,CAAC,IAAI,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAA4B;QACvC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC;CACF"}

package/dist/firebase/native-item-store.d.ts

@@ -0,0 +1,20 @@
+import type { CatalogId, ItemId } from "../contracts/ids.js";
+import type { NativeCatalogItemRecord } from "../contracts/items.js";
+import { FirestoreStore } from "./firestore-store.js";
+export type NativeCatalogStoredRecord = NativeCatalogItemRecord;
+export declare class NativeItemStore {
+    private readonly store;
+    constructor(store: FirestoreStore);
+    private itemDocRef;
+    get(catalogId: CatalogId, itemId: ItemId): Promise<NativeCatalogStoredRecord | null>;
+    upsert(catalogId: CatalogId, record: NativeCatalogStoredRecord): Promise<void>;
+    delete(catalogId: CatalogId, itemId: ItemId): Promise<void>;
+    batchUpsert(catalogId: CatalogId, records: NativeCatalogStoredRecord[]): Promise<void>;
+    list(catalogId: CatalogId, options?: {
+        limit?: number;
+        offset?: number;
+        filterEq?: Record<string, unknown>;
+        sort?: Record<string, 1 | -1>;
+    }): Promise<NativeCatalogStoredRecord[]>;
+}
+//# sourceMappingURL=native-item-store.d.ts.map

package/dist/firebase/native-item-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-item-store.d.ts","sourceRoot":"","sources":["../../src/firebase/native-item-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,MAAM,yBAAyB,GAAG,uBAAuB,CAAC;AAEhE,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,cAAc;IAElD,OAAO,CAAC,UAAU;IAQZ,GAAG,CACP,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC;IAKtC,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9E,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D,WAAW,CACf,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,yBAAyB,EAAE,GACnC,OAAO,CAAC,IAAI,CAAC;IAYV,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,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;KAC/B,GACA,OAAO,CAAC,yBAAyB,EAAE,CAAC;CAuBxC"}

package/dist/firebase/native-item-store.js

@@ -0,0 +1,55 @@
+import { FirestoreStore } from "./firestore-store.js";
+export class NativeItemStore {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    itemDocRef(catalogId, itemId) {
+        return this.store
+            .collection("catalogData")
+            .doc(String(catalogId))
+            .collection("items")
+            .doc(String(itemId));
+    }
+    async get(catalogId, itemId) {
+        const snap = await this.itemDocRef(catalogId, itemId).get();
+        return snap.exists ? snap.data() : null;
+    }
+    async upsert(catalogId, record) {
+        await this.itemDocRef(catalogId, record.itemId).set(record, { merge: true });
+    }
+    async delete(catalogId, itemId) {
+        await this.itemDocRef(catalogId, itemId).delete();
+    }
+    async batchUpsert(catalogId, records) {
+        const chunkSize = 450; // keep below Firestore 500 writes
+        for (let i = 0; i < records.length; i += chunkSize) {
+            const chunk = records.slice(i, i + chunkSize);
+            const batch = this.store.firestore.batch();
+            for (const r of chunk) {
+                batch.set(this.itemDocRef(catalogId, r.itemId), r, { merge: true });
+            }
+            await batch.commit();
+        }
+    }
+    async list(catalogId, options) {
+        let q = this.store
+            .collection("catalogData")
+            .doc(String(catalogId))
+            .collection("items");
+        const filterEq = options?.filterEq ?? {};
+        for (const [k, v] of Object.entries(filterEq)) {
+            q = q.where(`indexed.${k}`, "==", v);
+        }
+        const sort = options?.sort ?? {};
+        for (const [k, dir] of Object.entries(sort)) {
+            q = q.orderBy(`indexed.${k}`, dir === -1 ? "desc" : "asc");
+        }
+        const offset = options?.offset ?? 0;
+        const limit = options?.limit ?? 100;
+        // Firestore doesn't support skip/offset directly; emulate by reading + slicing.
+        const snap = await q.limit(offset + limit).get();
+        return snap.docs.slice(offset, offset + limit).map((d) => d.data());
+    }
+}
+//# sourceMappingURL=native-item-store.js.map

package/dist/firebase/native-item-store.js.map

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

package/dist/firebase/reference-store.d.ts

@@ -0,0 +1,17 @@
+import type { CatalogItemReference } from "../contracts/references.js";
+import type { CatalogId, ItemId } from "../contracts/ids.js";
+import { FirestoreStore } from "./firestore-store.js";
+export type CatalogReferenceRecord = CatalogItemReference & {
+    referenceId: string;
+    createdAt: string;
+    updatedAt: string;
+};
+export declare class ReferenceStore {
+    private readonly store;
+    constructor(store: FirestoreStore);
+    private collectionRef;
+    listByCatalog(catalogId: CatalogId): Promise<CatalogReferenceRecord[]>;
+    listByItem(catalogId: CatalogId, itemId: ItemId): Promise<CatalogReferenceRecord[]>;
+    upsert(record: CatalogReferenceRecord): Promise<void>;
+}
+//# sourceMappingURL=reference-store.d.ts.map

package/dist/firebase/reference-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-store.d.ts","sourceRoot":"","sources":["../../src/firebase/reference-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,MAAM,sBAAsB,GAAG,oBAAoB,GAAG;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,cAAc;IAElD,OAAO,CAAC,aAAa;IAIf,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAOtE,UAAU,CACd,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAQ9B,MAAM,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;CAG5D"}

package/dist/firebase/reference-store.js

@@ -0,0 +1,27 @@
+import { FirestoreStore } from "./firestore-store.js";
+export class ReferenceStore {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    collectionRef() {
+        return this.store.collection("catalogReferences");
+    }
+    async listByCatalog(catalogId) {
+        const snap = await this.collectionRef()
+            .where("fromCatalogId", "==", catalogId)
+            .get();
+        return snap.docs.map((d) => d.data());
+    }
+    async listByItem(catalogId, itemId) {
+        const snap = await this.collectionRef()
+            .where("fromCatalogId", "==", catalogId)
+            .where("fromItemId", "==", itemId)
+            .get();
+        return snap.docs.map((d) => d.data());
+    }
+    async upsert(record) {
+        await this.collectionRef().doc(record.referenceId).set(record, { merge: true });
+    }
+}
+//# sourceMappingURL=reference-store.js.map

package/dist/firebase/reference-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-store.js","sourceRoot":"","sources":["../../src/firebase/reference-store.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAQtD,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,KAAqB;QAArB,UAAK,GAAL,KAAK,CAAgB;IAAG,CAAC;IAE9C,aAAa;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,SAAoB;QACtC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE;aACpC,KAAK,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC;aACvC,GAAG,EAAE,CAAC;QACT,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAA4B,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,UAAU,CACd,SAAoB,EACpB,MAAc;QAEd,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE;aACpC,KAAK,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC;aACvC,KAAK,CAAC,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC;aACjC,GAAG,EAAE,CAAC;QACT,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAA4B,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAA8B;QACzC,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClF,CAAC;CACF"}

package/dist/firebase/snapshot-store.d.ts

@@ -0,0 +1,11 @@
+import type { CatalogId, ItemId } from "../contracts/ids.js";
+import type { SnapshotCatalogItemRecord } from "../contracts/items.js";
+import { FirestoreStore } from "./firestore-store.js";
+export declare class SnapshotStore {
+    private readonly store;
+    constructor(store: FirestoreStore);
+    private itemDocRef;
+    get(catalogId: CatalogId, itemId: ItemId): Promise<SnapshotCatalogItemRecord | null>;
+    upsert(catalogId: CatalogId, record: SnapshotCatalogItemRecord): Promise<void>;
+}
+//# sourceMappingURL=snapshot-store.d.ts.map

package/dist/firebase/snapshot-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-store.d.ts","sourceRoot":"","sources":["../../src/firebase/snapshot-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,cAAc;IAElD,OAAO,CAAC,UAAU;IAQZ,GAAG,CACP,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC;IAKtC,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;CAGrF"}

package/dist/firebase/snapshot-store.js

@@ -0,0 +1,22 @@
+import { FirestoreStore } from "./firestore-store.js";
+export class SnapshotStore {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    itemDocRef(catalogId, itemId) {
+        return this.store
+            .collection("catalogSnapshots")
+            .doc(String(catalogId))
+            .collection("items")
+            .doc(String(itemId));
+    }
+    async get(catalogId, itemId) {
+        const snap = await this.itemDocRef(catalogId, itemId).get();
+        return snap.exists ? snap.data() : null;
+    }
+    async upsert(catalogId, record) {
+        await this.itemDocRef(catalogId, record.itemId).set(record, { merge: true });
+    }
+}
+//# sourceMappingURL=snapshot-store.js.map

package/dist/firebase/snapshot-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-store.js","sourceRoot":"","sources":["../../src/firebase/snapshot-store.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,KAAqB;QAArB,UAAK,GAAL,KAAK,CAAgB;IAAG,CAAC;IAE9C,UAAU,CAAC,SAAoB,EAAE,MAAc;QACrD,OAAO,IAAI,CAAC,KAAK;aACd,UAAU,CAAC,kBAAkB,CAAC;aAC9B,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;aACtB,UAAU,CAAC,OAAO,CAAC;aACnB,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,GAAG,CACP,SAAoB,EACpB,MAAc;QAEd,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC;QAC5D,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAE,IAAI,CAAC,IAAI,EAAgC,CAAC,CAAC,CAAC,IAAI,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAAoB,EAAE,MAAiC;QAClE,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/E,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from "./contracts/index.js";
+export * from "./catalox/index.js";
+export * from "./firebase/index.js";
+export * from "./adapters/mongo/index.js";
+export * from "./adapters/api/index.js";
+export * from "./mapping/index.js";
+export * from "./bindings/index.js";
+export * from "./validation/index.js";
+export * from "./errors/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export * from "./contracts/index.js";
+export * from "./catalox/index.js";
+export * from "./firebase/index.js";
+export * from "./adapters/mongo/index.js";
+export * from "./adapters/api/index.js";
+export * from "./mapping/index.js";
+export * from "./bindings/index.js";
+export * from "./validation/index.js";
+export * from "./errors/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC"}

package/dist/mapping/execute-mapping.d.ts

@@ -0,0 +1,8 @@
+import type { CatalogFieldMappingSpec, MappingExecutionOptions, MappingExecutionResult } from "../contracts/mappings.js";
+type HelpersObjectMapper = {
+    deepGet?: (obj: unknown, path: string) => unknown;
+    deepSet?: (obj: unknown, path: string, value: unknown) => void;
+};
+export declare function executeMapping<T = Record<string, unknown>>(source: Record<string, unknown>, mapping: CatalogFieldMappingSpec[], options?: MappingExecutionOptions, helpers?: HelpersObjectMapper): MappingExecutionResult<T>;
+export {};
+//# sourceMappingURL=execute-mapping.d.ts.map

package/dist/mapping/execute-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-mapping.d.ts","sourceRoot":"","sources":["../../src/mapping/execute-mapping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EAEvB,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAElC,KAAK,mBAAmB,GAAG;IACzB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAClD,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAChE,CAAC;AAkBF,wBAAgB,cAAc,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,uBAAuB,EAAE,EAClC,OAAO,CAAC,EAAE,uBAAuB,EACjC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,sBAAsB,CAAC,CAAC,CAAC,CAmE3B"}

package/dist/mapping/execute-mapping.js

@@ -0,0 +1,78 @@
+function parseStringSpec(spec) {
+    const parts = spec.split("->").map((s) => s.trim());
+    if (parts.length !== 2)
+        return null;
+    const [from, to] = parts;
+    if (!from || !to)
+        return null;
+    return { from, to };
+}
+function applyTemplate(template, source, deepGet) {
+    return template.replace(/\{([^}]+)\}/g, (_m, rawPath) => {
+        const path = String(rawPath).trim();
+        const v = deepGet ? deepGet(source, path) : source?.[path];
+        return v == null ? "" : String(v);
+    });
+}
+export function executeMapping(source, mapping, options, helpers) {
+    const issues = [];
+    const out = options?.preserveUnknownFields ? { ...source } : {};
+    const deepGet = helpers?.deepGet;
+    const deepSet = helpers?.deepSet;
+    const setValue = (path, value) => {
+        if (deepSet) {
+            deepSet(out, path, value);
+            return;
+        }
+        // Fallback: shallow set if no deepSet available.
+        out[path] = value;
+    };
+    const getValue = (path) => {
+        if (deepGet)
+            return deepGet(source, path);
+        return source?.[path];
+    };
+    for (const entry of mapping) {
+        if (typeof entry === "string") {
+            const parsed = parseStringSpec(entry);
+            if (!parsed) {
+                issues.push({
+                    code: "mapping.invalid_string",
+                    message: `Invalid mapping string: "${entry}"`,
+                    severity: "error",
+                });
+                continue;
+            }
+            const v = getValue(parsed.from);
+            if (v === undefined && options?.ignoreUndefined)
+                continue;
+            if (v === null && options?.ignoreNull)
+                continue;
+            setValue(parsed.to, v);
+            continue;
+        }
+        const value = entry.template != null
+            ? applyTemplate(entry.template, source, deepGet)
+            : entry.from
+                ? getValue(entry.from)
+                : undefined;
+        const resolved = value === undefined ? entry.defaultValue : value;
+        if (resolved === undefined && options?.ignoreUndefined)
+            continue;
+        if (resolved === null && options?.ignoreNull)
+            continue;
+        if (entry.required && (resolved === undefined || resolved === null || resolved === "")) {
+            const baseIssue = {
+                code: "mapping.required_missing",
+                message: `Required field missing for target "${entry.to}".`,
+                severity: "error",
+                targetPath: entry.to,
+            };
+            issues.push(entry.from ? { ...baseIssue, sourcePath: entry.from } : baseIssue);
+            continue;
+        }
+        setValue(entry.to, resolved);
+    }
+    return issues.length ? { data: out, issues } : { data: out };
+}
+//# sourceMappingURL=execute-mapping.js.map

package/dist/mapping/execute-mapping.js.map

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

package/dist/mapping/helper-gap-report.d.ts

@@ -0,0 +1,7 @@
+export type HelperGapReport = {
+    area: "mapping" | "api" | "http" | "firebase";
+    title: string;
+    reason: string;
+    requestedEnhancement: string;
+};
+//# sourceMappingURL=helper-gap-report.d.ts.map

package/dist/mapping/helper-gap-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper-gap-report.d.ts","sourceRoot":"","sources":["../../src/mapping/helper-gap-report.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB,EAAE,MAAM,CAAC;CAC9B,CAAC"}

package/dist/mapping/helper-gap-report.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=helper-gap-report.js.map

package/dist/mapping/helper-gap-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper-gap-report.js","sourceRoot":"","sources":["../../src/mapping/helper-gap-report.ts"],"names":[],"mappings":""}

package/dist/mapping/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./execute-mapping.js";
+export * from "./validate-mapping.js";
+export * from "./helper-gap-report.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/mapping/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mapping/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC"}

package/dist/mapping/index.js

@@ -0,0 +1,4 @@
+export * from "./execute-mapping.js";
+export * from "./validate-mapping.js";
+export * from "./helper-gap-report.js";
+//# sourceMappingURL=index.js.map

package/dist/mapping/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mapping/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC"}

package/dist/mapping/validate-mapping.d.ts

@@ -0,0 +1,3 @@
+import type { CatalogFieldMappingSpec, CatalogMappingIssue } from "../contracts/mappings.js";
+export declare function validateMappingSpec(mapping: CatalogFieldMappingSpec[]): CatalogMappingIssue[];
+//# sourceMappingURL=validate-mapping.d.ts.map

package/dist/mapping/validate-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-mapping.d.ts","sourceRoot":"","sources":["../../src/mapping/validate-mapping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAElC,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,uBAAuB,EAAE,GACjC,mBAAmB,EAAE,CAkCvB"}

package/dist/mapping/validate-mapping.js

@@ -0,0 +1,32 @@
+export function validateMappingSpec(mapping) {
+    const issues = [];
+    for (const entry of mapping) {
+        if (typeof entry === "string") {
+            const parts = entry.split("->").map((s) => s.trim());
+            if (parts.length !== 2 || !parts[0] || !parts[1]) {
+                issues.push({
+                    code: "mapping.invalid_string",
+                    message: `Invalid mapping string: "${entry}"`,
+                    severity: "error",
+                });
+            }
+            continue;
+        }
+        if (!entry.to || typeof entry.to !== "string") {
+            issues.push({
+                code: "mapping.missing_to",
+                message: "Mapping entry missing required 'to' field.",
+                severity: "error",
+            });
+        }
+        if (!entry.from && !entry.template) {
+            issues.push({
+                code: "mapping.missing_from_or_template",
+                message: "Mapping entry must have either 'from' or 'template'.",
+                severity: "error",
+            });
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=validate-mapping.js.map

package/dist/mapping/validate-mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-mapping.js","sourceRoot":"","sources":["../../src/mapping/validate-mapping.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,mBAAmB,CACjC,OAAkC;IAElC,MAAM,MAAM,GAA0B,EAAE,CAAC;IAEzC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACrD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjD,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,wBAAwB;oBAC9B,OAAO,EAAE,4BAA4B,KAAK,GAAG;oBAC7C,QAAQ,EAAE,OAAO;iBAClB,CAAC,CAAC;YACL,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC9C,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,oBAAoB;gBAC1B,OAAO,EAAE,4CAA4C;gBACrD,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnC,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,kCAAkC;gBACxC,OAAO,EAAE,sDAAsD;gBAC/D,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/adapters/api/api-adapter.d.ts

@@ -0,0 +1,22 @@
+import type { ApiCatalogAdapterConfig } from "../../contracts/adapters.js";
+import type { CatalogQueryOptions } from "../../contracts/catalogs.js";
+import type { CataloxContext } from "../../contracts/context.js";
+import type { CatalogId } from "../../contracts/ids.js";
+import type { UnifiedCatalogItem } from "../../contracts/items.js";
+import type { CatalogFieldMappingSpec, MappingExecutionOptions } from "../../contracts/mappings.js";
+export type ApiAdapterRuntime = {
+    fetchImpl?: typeof fetch;
+};
+export declare class ApiCatalogAdapter {
+    private readonly runtime;
+    constructor(runtime?: ApiAdapterRuntime);
+    listItems(context: CataloxContext, catalogId: CatalogId, config: ApiCatalogAdapterConfig, mapping: {
+        responseMapping: CatalogFieldMappingSpec[];
+        options?: MappingExecutionOptions;
+    }, options?: CatalogQueryOptions): Promise<{
+        items: UnifiedCatalogItem[];
+        nextCursor?: string;
+        issues?: import("../../contracts/mappings.js").CatalogMappingIssue[];
+    }>;
+}
+//# sourceMappingURL=api-adapter.d.ts.map

package/dist/src/adapters/api/api-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-adapter.d.ts","sourceRoot":"","sources":["../../../../src/adapters/api/api-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAGpG,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,CAAC;AAYF,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,GAAE,iBAAsB;IAEtD,SAAS,CACb,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,uBAAuB,EAC/B,OAAO,EAAE;QAAE,eAAe,EAAE,uBAAuB,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,uBAAuB,CAAA;KAAE,EAC1F,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC;QAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,6BAA6B,EAAE,mBAAmB,EAAE,CAAA;KAAE,CAAC;CAgDvI"}

package/dist/src/adapters/api/api-adapter.js

@@ -0,0 +1,60 @@
+import { executeMapping } from "../../mapping/execute-mapping.js";
+function deepGetFallback(obj, path) {
+    const parts = path.split(".").map((p) => p.trim()).filter(Boolean);
+    let cur = obj;
+    for (const p of parts) {
+        if (cur == null)
+            return undefined;
+        cur = cur[p];
+    }
+    return cur;
+}
+export class ApiCatalogAdapter {
+    runtime;
+    constructor(runtime = {}) {
+        this.runtime = runtime;
+    }
+    async listItems(context, catalogId, config, mapping, options) {
+        const fetchImpl = this.runtime.fetchImpl ?? fetch;
+        if (!config.endpoint)
+            throw new Error("API adapter missing endpoint.");
+        const url = new URL(config.endpoint);
+        if (options?.limit != null)
+            url.searchParams.set("limit", String(options.limit));
+        if (options?.offset != null)
+            url.searchParams.set("offset", String(options.offset));
+        const res = await fetchImpl(url.toString(), { method: config.method ?? "GET" });
+        if (!res.ok)
+            throw new Error(`API request failed: ${res.status}`);
+        const body = (await res.json());
+        const itemsPath = config.pagination?.itemsPath;
+        const rawItems = itemsPath ? deepGetFallback(body, itemsPath) : body;
+        const arr = Array.isArray(rawItems) ? rawItems : [];
+        const out = [];
+        const issues = [];
+        for (const row of arr) {
+            const source = row;
+            const mapped = executeMapping(source, mapping.responseMapping, mapping.options);
+            if (mapped.issues)
+                issues.push(...mapped.issues);
+            const itemId = config.itemIdSourcePath ? deepGetFallback(source, config.itemIdSourcePath) : undefined;
+            out.push({
+                itemId: itemId != null ? String(itemId) : JSON.stringify(source),
+                catalogId,
+                appId: context.appId,
+                sourceMode: "mapped",
+                sourceType: "api",
+                sourceRef: { endpoint: config.endpoint },
+                data: mapped.data,
+            });
+        }
+        const nextCursorPath = config.pagination?.nextCursorPath;
+        const nextCursor = nextCursorPath ? deepGetFallback(body, nextCursorPath) : undefined;
+        return {
+            items: out,
+            ...(typeof nextCursor === "string" ? { nextCursor } : {}),
+            ...(issues.length ? { issues } : {}),
+        };
+    }
+}
+//# sourceMappingURL=api-adapter.js.map