@x12i/catalox 1.1.0

package/dist/src/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/src/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/src/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/src/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/src/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/src/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/src/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/src/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":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAItD,MAAM,OAAO,eAAe;IACG;IAA7B,YAA6B,KAAqB;QAArB,UAAK,GAAL,KAAK,CAAgB;IAAG,CAAC;IAE9C,UAAU,CAAC,SAAoB,EAAE,MAAc;QACrD,OAAO,IAAI,CAAC,KAAK;aACd,UAAU,CAAC,aAAa,CAAC;aACzB,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;IAED,KAAK,CAAC,MAAM,CAAC,SAAoB,EAAE,MAAc;QAC/C,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,WAAW,CACf,SAAoB,EACpB,OAAoC;QAEpC,MAAM,SAAS,GAAG,GAAG,CAAC,CAAC,kCAAkC;QACzD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC;YACnD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC;YAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YAC3C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;gBACtB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACtE,CAAC;YACD,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CACR,SAAoB,EACpB,OAKC;QAED,IAAI,CAAC,GAA4B,IAAI,CAAC,KAAK;aACxC,UAAU,CAAC,aAAa,CAAC;aACzB,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;aACtB,UAAU,CAAC,OAAO,CAAC,CAAC;QAEvB,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC;QACzC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9C,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACvC,CAAC;QAED,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;QACjC,KAAK,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5C,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,GAAG,CAAC;QAEpC,gFAAgF;QAChF,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAA+B,CAAC,CAAC;IACnG,CAAC;CACF"}

package/dist/src/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/src/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/src/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/src/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/src/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/src/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/src/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/src/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/src/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/src/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/src/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/src/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/src/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/src/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/src/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/src/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/src/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/src/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/src/mapping/helper-gap-report.js

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

package/dist/src/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/src/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/src/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/src/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/src/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/src/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/src/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/src/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/src/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/validation/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/src/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/validation/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC"}

package/dist/src/validation/index.js

@@ -0,0 +1,3 @@
+// Validation utilities will live here.
+export {};
+//# sourceMappingURL=index.js.map

package/dist/src/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/validation/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,OAAO,EAAE,CAAC"}

package/dist/test/integration/firestore.emulator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=firestore.emulator.test.d.ts.map

package/dist/test/integration/firestore.emulator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firestore.emulator.test.d.ts","sourceRoot":"","sources":["../../../test/integration/firestore.emulator.test.ts"],"names":[],"mappings":""}

package/dist/test/integration/firestore.emulator.test.js

@@ -0,0 +1,122 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import path from "node:path";
+import { loadDotenv } from "nx-config2";
+import { initializeApp, cert, getApps, deleteApp } from "firebase-admin/app";
+import { getFirestore } from "firebase-admin/firestore";
+import { FirestoreStore, AppStore, CatalogStore, BindingStore, DefinitionStore, MappingStore, DescriptorStore, ReferenceStore, NativeItemStore, SnapshotStore, AdapterStore, AuthorizationService, Catalox, } from "../../src/index.js";
+loadDotenv(path.resolve(process.cwd(), ".env"));
+function requireEnv(name) {
+    const v = process.env[name];
+    if (!v)
+        throw new Error(`Missing required env: ${name}`);
+    return v;
+}
+function requireLiveTestsEnabled() {
+    if (process.env.FIRESTORE_LIVE_TESTS !== "1") {
+        throw new Error("Live tests disabled. Set FIRESTORE_LIVE_TESTS=1 to run integration tests against a real Firestore project.");
+    }
+}
+test("Firestore live integration: discovery + native upsert/list + descriptor", async () => {
+    requireLiveTestsEnabled();
+    const serviceAccountPath = requireEnv("FIREBASE_SERVICE_ACCOUNT_PATH");
+    const projectId = requireEnv("FIREBASE_PROJECT_ID");
+    const appName = `catalox-test-${Date.now()}`;
+    const app = initializeApp({ credential: cert(serviceAccountPath), projectId }, appName);
+    const firestore = getFirestore(app);
+    const store = new FirestoreStore({ firestore, app });
+    const apps = new AppStore(store);
+    const catalogs = new CatalogStore(store);
+    const bindings = new BindingStore(store);
+    const definitions = new DefinitionStore(store);
+    const mappings = new MappingStore(store);
+    const descriptors = new DescriptorStore(store);
+    const references = new ReferenceStore(store);
+    const nativeItems = new NativeItemStore(store);
+    const snapshots = new SnapshotStore(store);
+    const adapters = new AdapterStore(store);
+    const authz = new AuthorizationService(bindings);
+    const catalox = new Catalox({
+        apps,
+        catalogs,
+        bindings,
+        definitions,
+        mappings,
+        descriptors,
+        references,
+        nativeItems,
+        snapshots,
+        adapters,
+        authz,
+    });
+    const runId = `${Date.now()}`;
+    const appId = `catalox_live_${runId}`;
+    const catalogId = `signals_${runId}`;
+    const ctx = { appId };
+    await apps.upsert({
+        appId,
+        name: "App A",
+        status: "active",
+        createdAt: new Date().toISOString(),
+        updatedAt: new Date().toISOString(),
+    });
+    await catalox.createCatalog(ctx, {
+        catalogId,
+        name: "Signals",
+        sourceMode: "native",
+        native: { type: "native", firestoreCollectionPath: `catalogData/${catalogId}/items` },
+    });
+    await catalox.bindCatalogToApp(ctx, {
+        appId,
+        catalogId,
+        access: { canRead: true, canWrite: true, canAdmin: true },
+    });
+    const discovered = await catalox.listAppCatalogs(ctx, { appId });
+    assert.equal(discovered.length, 1);
+    assert.equal(discovered[0]?.catalogId, catalogId);
+    const descriptor = await catalox.getCatalogDescriptor(ctx, catalogId);
+    assert.ok(descriptor);
+    assert.equal(descriptor?.catalogId, catalogId);
+    // Patch descriptor to define natural composite identity for this catalog.
+    await descriptors.upsert({
+        catalogId,
+        descriptorVersion: "2",
+        descriptor: {
+            ...descriptor,
+            identity: {
+                itemIdStrategy: "composite",
+                compositeFields: ["categoryId", "code"],
+                titleField: "title",
+            },
+        },
+        createdAt: new Date().toISOString(),
+        updatedAt: new Date().toISOString(),
+    });
+    await catalox.upsertNativeCatalogItem(ctx, catalogId, {
+        categoryId: "core",
+        code: "S1",
+        title: "Example",
+        indexed: { categoryId: "core", code: "S1" },
+    });
+    const listed = await catalox.listCatalogItems(ctx, catalogId, {
+        filter: { categoryId: "core" },
+    });
+    assert.equal(listed.items.length, 1);
+    assert.equal(listed.items[0]?.itemId, "core:S1");
+    const got = await catalox.getCatalogItem(ctx, catalogId, "core:S1");
+    assert.ok(got);
+    assert.equal(got?.title, "Example");
+    // Best-effort cleanup: delete the docs created by this test only.
+    await firestore.collection("apps").doc(appId).delete().catch(() => { });
+    await firestore.collection("catalogs").doc(catalogId).delete().catch(() => { });
+    await firestore.collection("catalogBindings").doc(`${appId}:${catalogId}`).delete().catch(() => { });
+    await firestore.collection("catalogDefinitions").doc(catalogId).delete().catch(() => { });
+    await firestore.collection("catalogDescriptors").doc(catalogId).delete().catch(() => { });
+    // Cleanup app instance.
+    await deleteApp(app);
+    for (const a of getApps()) {
+        if (a.name === appName)
+            await deleteApp(a);
+    }
+});
+//# sourceMappingURL=firestore.emulator.test.js.map

package/dist/test/integration/firestore.emulator.test.js.map

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

package/dist/test/unit/identity.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=identity.test.d.ts.map

package/dist/test/unit/identity.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.test.d.ts","sourceRoot":"","sources":["../../../test/unit/identity.test.ts"],"names":[],"mappings":""}