@x12i/catalox 2.3.0 → 2.5.0

package/dist/src/contracts/gcs-firestore-compare.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gcs-firestore-compare.js.map

package/dist/src/contracts/gcs-firestore-compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcs-firestore-compare.js","sourceRoot":"","sources":["../../../src/contracts/gcs-firestore-compare.ts"],"names":[],"mappings":""}

package/dist/src/contracts/gcs-firestore-transfer.d.ts

@@ -0,0 +1,94 @@
+import type { Firestore } from "firebase-admin/firestore";
+export type FirestoreGcsTransferBase = {
+    bucket: string;
+    /** Object key prefix (e.g. `exports/2026-04-18/`). Trailing slash optional. */
+    gcsPrefix?: string;
+    /**
+     * Suffix inserted before `.ndjson` in object names, e.g. `_v1` → `apps_v1.ndjson`.
+     * Omit or use empty string for names like `apps.ndjson`.
+     */
+    objectNamePostfix?: string;
+};
+export type ExportFirestoreCollectionToGcsInput = FirestoreGcsTransferBase & {
+    firestore: Firestore;
+    /** Odd-length slash path: top-level `apps` or nested `catalogData/myId/items`. */
+    collectionPath: string;
+};
+export type ExportFirestoreCollectionToGcsResult = {
+    ok: boolean;
+    bucket: string;
+    objectPath: string;
+    documentCount: number;
+    issues: FirestoreGcsTransferIssue[];
+};
+export type ExportAllFirestoreCollectionsToGcsInput = FirestoreGcsTransferBase & {
+    firestore: Firestore;
+    /**
+     * When false (default), only **root** collections are exported.
+     * When true, walks every document and enqueues **subcollections** (can be slow and costly).
+     */
+    recursive?: boolean;
+};
+export type ExportAllFirestoreCollectionsToGcsResult = {
+    ok: boolean;
+    bucket: string;
+    manifestObjectPath: string;
+    entries: Array<{
+        firestorePath: string;
+        objectPath: string;
+        documentCount: number;
+    }>;
+    issues: FirestoreGcsTransferIssue[];
+};
+export type RestoreFirestoreCollectionFromGcsInput = FirestoreGcsTransferBase & {
+    firestore: Firestore;
+    /** NDJSON object path **within the bucket** (may include `gcsPrefix`). */
+    objectPath: string;
+    /** Target collection path (same rules as export `collectionPath`). */
+    collectionPath: string;
+    /** When true, deletes all documents in the destination collection before import. */
+    replaceDestinationCollection?: boolean;
+};
+export type RestoreFirestoreCollectionFromGcsResult = {
+    ok: boolean;
+    bucket: string;
+    objectPath: string;
+    collectionPath: string;
+    documentsWritten: number;
+    issues: FirestoreGcsTransferIssue[];
+};
+export type RestoreAllFirestoreCollectionsFromGcsInput = FirestoreGcsTransferBase & {
+    firestore: Firestore;
+    /** Manifest object path within bucket (default if omitted: `{gcsPrefix}catalox-firestore-export-manifest.json`). */
+    manifestObjectPath?: string;
+    replaceDestinationCollection?: boolean;
+};
+export type RestoreAllFirestoreCollectionsFromGcsResult = {
+    ok: boolean;
+    bucket: string;
+    manifestObjectPath: string;
+    restored: Array<{
+        firestorePath: string;
+        objectPath: string;
+        documentsWritten: number;
+    }>;
+    issues: FirestoreGcsTransferIssue[];
+};
+export type FirestoreGcsExportManifestV1 = {
+    catalog: "catalox-firestore-gcs-export";
+    version: 1;
+    exportedAt: string;
+    gcsPrefix: string;
+    objectNamePostfix: string;
+    entries: Array<{
+        firestorePath: string;
+        objectPath: string;
+        documentCount: number;
+    }>;
+};
+export type FirestoreGcsTransferIssue = {
+    code: string;
+    message: string;
+    detail?: Record<string, unknown>;
+};
+//# sourceMappingURL=gcs-firestore-transfer.d.ts.map

package/dist/src/contracts/gcs-firestore-transfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcs-firestore-transfer.d.ts","sourceRoot":"","sources":["../../../src/contracts/gcs-firestore-transfer.ts"],"names":[],"mappings":"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"}

package/dist/src/contracts/gcs-firestore-transfer.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gcs-firestore-transfer.js.map

package/dist/src/contracts/gcs-firestore-transfer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcs-firestore-transfer.js","sourceRoot":"","sources":["../../../src/contracts/gcs-firestore-transfer.ts"],"names":[],"mappings":""}

package/dist/src/contracts/index.d.ts

@@ -2,6 +2,7 @@ export type { AppId, StoreId, CatalogId, BindingId, AdapterId, MappingId, ItemId
 export type { CatalogSourceMode, CatalogMappedSourceType, CatalogDefinition, CatalogQueryOptions, CatalogListResult, } from "./catalogs.js";
 export type { AppRecord } from "./apps.js";
 export type { CatalogRecord, NativeCatalogConfig } from "./catalogs.js";
+export { compactCatalogFilter } from "./catalogs.js";
 export type { CatalogBindingRecord, BindCatalogInput } from "./bindings.js";
 export type { MongoDatabaseResolution, MongoCatalogAdapterConfig, ApiCatalogAdapterConfig, } from "./adapters.js";
 export type { CatalogFieldMappingSpec, MappingExecutionOptions, MappingExecutionResult, CatalogMappingIssue, CatalogMappingRecord, } from "./mappings.js";
@@ -29,5 +30,10 @@ export type { StoreRecord, StoreAppBindingRecord } from "./stores.js";
 export type { ExportInventoryInput, ExportInventoryData } from "./inventory-export.js";
 export type { InventoryReportInput, InventoryReportData } from "./inventory-report.js";
 export type { CatalogSnapshotRunRecord } from "./snapshots.js";
+export type { BackupMode, BackupDataInput, BackupDataResult, BackupDataIssue, } from "./backup.js";
+export type { RestoreFirestoreBackupSource, RestoreFirestoreBackupInput, RestoreFirestoreBackupResult, RestoreFirestoreBackupIssue, UndoFirestoreRestoreInput, UndoFirestoreRestoreResult, UndoFirestoreRestoreIssue, } from "./restore.js";
+export type { FirestoreGcsTransferBase, ExportFirestoreCollectionToGcsInput, ExportFirestoreCollectionToGcsResult, ExportAllFirestoreCollectionsToGcsInput, ExportAllFirestoreCollectionsToGcsResult, RestoreFirestoreCollectionFromGcsInput, RestoreFirestoreCollectionFromGcsResult, RestoreAllFirestoreCollectionsFromGcsInput, RestoreAllFirestoreCollectionsFromGcsResult, FirestoreGcsExportManifestV1, FirestoreGcsTransferIssue, } from "./gcs-firestore-transfer.js";
+export type { CompareFirestoreCollectionWithGcsInput, CompareFirestoreCollectionWithGcsResult, CompareAllFirestoreCollectionsWithGcsManifestInput, CompareAllFirestoreCollectionsWithGcsResult, CompareIdBuckets, CompareChangedSample, } from "./gcs-firestore-compare.js";
+export type { CatalogDataIndexRecord, CatalogDataLeafIndex } from "./catalog-data-index.js";
 export { CataloxError, CatalogManagerError, CatalogNotFoundError, CatalogAccessDeniedError, CatalogBindingError, CatalogValidationError, CatalogAdapterError, CatalogSyncError, AppNotFoundError, AppPrivilegeError, } from "./errors.js";
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/src/contracts/index.js

@@ -1,3 +1,4 @@
+export { compactCatalogFilter } from "./catalogs.js";
 export { resolveCustomRendererEntry } from "./custom-renderer-resolve.js";
 export { CataloxError, CatalogManagerError, CatalogNotFoundError, CatalogAccessDeniedError, CatalogBindingError, CatalogValidationError, CatalogAdapterError, CatalogSyncError, AppNotFoundError, AppPrivilegeError, } from "./errors.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/contracts/index.ts"],"names":[],"mappings":"AAwGA,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAgD1E,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/contracts/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AA6FrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AA0F1E,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,aAAa,CAAC"}

package/dist/src/contracts/restore.d.ts

@@ -0,0 +1,44 @@
+import type { AppId, CatalogId } from "./ids.js";
+export type RestoreFirestoreBackupSource = {
+    kind: "latest";
+} | {
+    kind: "versioned";
+    versionTimestamp: string;
+};
+export type RestoreFirestoreBackupInput = {
+    /** Which backup mirror set to read from (same database, Firebase mode only). */
+    source: RestoreFirestoreBackupSource;
+    includeSnapshots?: boolean;
+    catalogIds?: CatalogId[];
+    appId?: AppId;
+    /** Optional fixed id for pre-restore / manifest (tests); otherwise a new filesystem-safe timestamp is generated. */
+    restoreSessionId?: string;
+};
+export type RestoreFirestoreBackupIssue = {
+    code: string;
+    message: string;
+    detail?: Record<string, unknown>;
+};
+export type RestoreFirestoreBackupResult = {
+    ok: boolean;
+    /** Prefix used for `restoreSessionId__preRestore-*` collections and the manifest document id. */
+    restoreSessionId: string;
+    counts: Record<string, number>;
+    issues: RestoreFirestoreBackupIssue[];
+    /** Native layout per catalog immediately before restore (used by undo). */
+    nativeItemSourceLayoutByCatalogId: Record<string, "flat" | "legacy">;
+};
+export type UndoFirestoreRestoreInput = {
+    restoreSessionId: string;
+};
+export type UndoFirestoreRestoreIssue = {
+    code: string;
+    message: string;
+    detail?: Record<string, unknown>;
+};
+export type UndoFirestoreRestoreResult = {
+    ok: boolean;
+    counts: Record<string, number>;
+    issues: UndoFirestoreRestoreIssue[];
+};
+//# sourceMappingURL=restore.d.ts.map

package/dist/src/contracts/restore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../../../src/contracts/restore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEjD,MAAM,MAAM,4BAA4B,GACpC;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpD,MAAM,MAAM,2BAA2B,GAAG;IACxC,gFAAgF;IAChF,MAAM,EAAE,4BAA4B,CAAC;IACrC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,oHAAoH;IACpH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,EAAE,EAAE,OAAO,CAAC;IACZ,iGAAiG;IACjG,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,MAAM,EAAE,2BAA2B,EAAE,CAAC;IACtC,2EAA2E;IAC3E,iCAAiC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;CACtE,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,MAAM,EAAE,yBAAyB,EAAE,CAAC;CACrC,CAAC"}

package/dist/src/contracts/restore.js

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

package/dist/src/contracts/restore.js.map

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

package/dist/src/firebase/catalog-data-index-store.d.ts

@@ -0,0 +1,14 @@
+import type { CatalogId } from "../contracts/ids.js";
+import type { CatalogDataIndexRecord } from "../contracts/catalog-data-index.js";
+import { FirestoreStore } from "./firestore-store.js";
+export declare class CatalogDataIndexStore {
+    private readonly store;
+    constructor(store: FirestoreStore);
+    private docRef;
+    get(catalogId: CatalogId): Promise<CatalogDataIndexRecord | null>;
+    upsert(record: CatalogDataIndexRecord): Promise<void>;
+    merge(catalogId: CatalogId, patch: Partial<CatalogDataIndexRecord>): Promise<void>;
+    /** Seed index doc for a native catalog (no item payloads). */
+    seedNativeCatalog(catalogId: CatalogId, nowIso: string): Promise<void>;
+}
+//# sourceMappingURL=catalog-data-index-store.d.ts.map

package/dist/src/firebase/catalog-data-index-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-data-index-store.d.ts","sourceRoot":"","sources":["../../../src/firebase/catalog-data-index-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,qBAAa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,cAAc;IAElD,OAAO,CAAC,MAAM;IAIR,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAKjE,MAAM,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD,KAAK,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxF,8DAA8D;IACxD,iBAAiB,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAW7E"}

package/dist/src/firebase/catalog-data-index-store.js

@@ -0,0 +1,33 @@
+import { FirestoreStore } from "./firestore-store.js";
+export class CatalogDataIndexStore {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    docRef(catalogId) {
+        return this.store.collection("catalogData").doc(String(catalogId));
+    }
+    async get(catalogId) {
+        const snap = await this.docRef(catalogId).get();
+        return snap.exists ? snap.data() : null;
+    }
+    async upsert(record) {
+        await this.docRef(record.catalogId).set(record, { merge: true });
+    }
+    async merge(catalogId, patch) {
+        await this.docRef(catalogId).set(patch, { merge: true });
+    }
+    /** Seed index doc for a native catalog (no item payloads). */
+    async seedNativeCatalog(catalogId, nowIso) {
+        const existing = await this.get(catalogId);
+        await this.upsert({
+            catalogId,
+            schemaVersion: "1",
+            leaves: { ...(existing?.leaves ?? {}), items: { kind: "primary" } },
+            ...(existing?.metadata != null ? { metadata: existing.metadata } : {}),
+            createdAt: existing?.createdAt ?? nowIso,
+            updatedAt: nowIso,
+        });
+    }
+}
+//# sourceMappingURL=catalog-data-index-store.js.map

package/dist/src/firebase/catalog-data-index-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-data-index-store.js","sourceRoot":"","sources":["../../../src/firebase/catalog-data-index-store.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,OAAO,qBAAqB;IACH;IAA7B,YAA6B,KAAqB;QAArB,UAAK,GAAL,KAAK,CAAgB;IAAG,CAAC;IAE9C,MAAM,CAAC,SAAoB;QACjC,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;IACrE,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,EAA6B,CAAC,CAAC,CAAC,IAAI,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAA8B;QACzC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,SAAoB,EAAE,KAAsC;QACtE,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,KAA+B,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,8DAA8D;IAC9D,KAAK,CAAC,iBAAiB,CAAC,SAAoB,EAAE,MAAc;QAC1D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3C,MAAM,IAAI,CAAC,MAAM,CAAC;YAChB,SAAS;YACT,aAAa,EAAE,GAAG;YAClB,MAAM,EAAE,EAAE,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;YACnE,GAAG,CAAC,QAAQ,EAAE,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,SAAS,EAAE,QAAQ,EAAE,SAAS,IAAI,MAAM;YACxC,SAAS,EAAE,MAAM;SAClB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/src/firebase/catalog-data-paths.d.ts

@@ -0,0 +1,14 @@
+import type { Firestore } from "firebase-admin/firestore";
+import type { CatalogId } from "../contracts/ids.js";
+/** Primary native item rows: top-level collection `catalogData-{catalogId}-items`. */
+export declare function nativeItemsCollectionId(catalogId: CatalogId): string;
+export type NativeItemsLayout = "legacy" | "flat";
+/**
+ * Prefer the flat layout when it already has data (post-migration).
+ * Otherwise use legacy `catalogData/{catalogId}/items` when it has data.
+ * If both are empty, default to flat for new writes.
+ */
+export declare function resolveNativeItemsLayout(firestore: Firestore, catalogId: CatalogId): Promise<NativeItemsLayout>;
+export declare function legacyNativeItemsCollectionRef(firestore: Firestore, catalogId: CatalogId): FirebaseFirestore.CollectionReference<FirebaseFirestore.DocumentData, FirebaseFirestore.DocumentData>;
+export declare function flatNativeItemsCollectionRef(firestore: Firestore, catalogId: CatalogId): FirebaseFirestore.CollectionReference<FirebaseFirestore.DocumentData, FirebaseFirestore.DocumentData>;
+//# sourceMappingURL=catalog-data-paths.d.ts.map

package/dist/src/firebase/catalog-data-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-data-paths.d.ts","sourceRoot":"","sources":["../../../src/firebase/catalog-data-paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,sFAAsF;AACtF,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAIpE;AAED,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,MAAM,CAAC;AAElD;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAW5B;AAED,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,yGAExF;AAED,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,yGAEtF"}

package/dist/src/firebase/catalog-data-paths.js

@@ -0,0 +1,31 @@
+/** Primary native item rows: top-level collection `catalogData-{catalogId}-items`. */
+export function nativeItemsCollectionId(catalogId) {
+    const id = String(catalogId).trim();
+    if (!id)
+        throw new Error("nativeItemsCollectionId: empty catalogId");
+    return `catalogData-${id}-items`;
+}
+/**
+ * Prefer the flat layout when it already has data (post-migration).
+ * Otherwise use legacy `catalogData/{catalogId}/items` when it has data.
+ * If both are empty, default to flat for new writes.
+ */
+export async function resolveNativeItemsLayout(firestore, catalogId) {
+    const cid = String(catalogId);
+    const flat = firestore.collection(nativeItemsCollectionId(cid));
+    const flatSnap = await flat.limit(1).get();
+    if (!flatSnap.empty)
+        return "flat";
+    const legacy = firestore.collection("catalogData").doc(cid).collection("items");
+    const legSnap = await legacy.limit(1).get();
+    if (!legSnap.empty)
+        return "legacy";
+    return "flat";
+}
+export function legacyNativeItemsCollectionRef(firestore, catalogId) {
+    return firestore.collection("catalogData").doc(String(catalogId)).collection("items");
+}
+export function flatNativeItemsCollectionRef(firestore, catalogId) {
+    return firestore.collection(nativeItemsCollectionId(catalogId));
+}
+//# sourceMappingURL=catalog-data-paths.js.map

package/dist/src/firebase/catalog-data-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-data-paths.js","sourceRoot":"","sources":["../../../src/firebase/catalog-data-paths.ts"],"names":[],"mappings":"AAGA,sFAAsF;AACtF,MAAM,UAAU,uBAAuB,CAAC,SAAoB;IAC1D,MAAM,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IACrE,OAAO,eAAe,EAAE,QAAQ,CAAC;AACnC,CAAC;AAID;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,SAAoB,EACpB,SAAoB;IAEpB,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IAC3C,IAAI,CAAC,QAAQ,CAAC,KAAK;QAAE,OAAO,MAAM,CAAC;IAEnC,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAChF,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IAC5C,IAAI,CAAC,OAAO,CAAC,KAAK;QAAE,OAAO,QAAQ,CAAC;IAEpC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,SAAoB,EAAE,SAAoB;IACvF,OAAO,SAAS,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,SAAoB,EAAE,SAAoB;IACrF,OAAO,SAAS,CAAC,UAAU,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC,CAAC;AAClE,CAAC"}

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

@@ -1,4 +1,6 @@
 export * from "./firestore-store.js";
+export * from "./catalog-data-paths.js";
+export * from "./catalog-data-index-store.js";
 export * from "./app-store.js";
 export * from "./catalog-store.js";
 export * from "./binding-store.js";

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

@@ -1 +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,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/firebase/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,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,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC"}

package/dist/src/firebase/index.js

@@ -1,4 +1,6 @@
 export * from "./firestore-store.js";
+export * from "./catalog-data-paths.js";
+export * from "./catalog-data-index-store.js";
 export * from "./app-store.js";
 export * from "./catalog-store.js";
 export * from "./binding-store.js";

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

@@ -1 +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,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/firebase/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,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,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC"}

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

@@ -4,12 +4,22 @@ import { FirestoreStore } from "./firestore-store.js";
 export type NativeCatalogStoredRecord = NativeCatalogItemRecord;
 export declare class NativeItemStore {
     private readonly store;
+    private layoutCache;
     constructor(store: FirestoreStore);
-    private itemDocRef;
+    private layoutPromise;
+    /** Invalidate cached layout for a catalog (e.g. after migration). */
+    invalidateLayoutCache(catalogId?: CatalogId): void;
+    private itemsCollectionRef;
     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>;
+    private executeListQuery;
+    /**
+     * Lists native rows. If the process cached a legacy vs flat layout choice and data moved
+     * (for example after a console migration), the first unconstrained empty page triggers a
+     * one-time re-resolve and a second query.
+     */
     list(catalogId: CatalogId, options?: {
         limit?: number;
         offset?: number;

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

@@ -1 +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"}
+{"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;AAOtD,MAAM,MAAM,yBAAyB,GAAG,uBAAuB,CAAC;AAEhE,qBAAa,eAAe;IAGd,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFlC,OAAO,CAAC,WAAW,CAAmF;gBAEzE,KAAK,EAAE,cAAc;IAElD,OAAO,CAAC,aAAa;IAUrB,qEAAqE;IACrE,qBAAqB,CAAC,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI;YAKpC,kBAAkB;IAO1B,GAAG,CACP,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC;IAMtC,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9E,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3D,WAAW,CACf,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,yBAAyB,EAAE,GACnC,OAAO,CAAC,IAAI,CAAC;YAaF,gBAAgB;IA6B9B;;;;OAIG;IACG,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;CAcxC"}

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

@@ -1,42 +1,61 @@
 import { FirestoreStore } from "./firestore-store.js";
+import { flatNativeItemsCollectionRef, legacyNativeItemsCollectionRef, resolveNativeItemsLayout, } from "./catalog-data-paths.js";
 export class NativeItemStore {
     store;
+    layoutCache = new Map();
     constructor(store) {
         this.store = store;
     }
-    itemDocRef(catalogId, itemId) {
-        return this.store
-            .collection("catalogData")
-            .doc(String(catalogId))
-            .collection("items")
-            .doc(String(itemId));
+    layoutPromise(catalogId) {
+        const key = String(catalogId);
+        let p = this.layoutCache.get(key);
+        if (!p) {
+            p = resolveNativeItemsLayout(this.store.firestore, catalogId);
+            this.layoutCache.set(key, p);
+        }
+        return p;
+    }
+    /** Invalidate cached layout for a catalog (e.g. after migration). */
+    invalidateLayoutCache(catalogId) {
+        if (catalogId == null)
+            this.layoutCache.clear();
+        else
+            this.layoutCache.delete(String(catalogId));
+    }
+    async itemsCollectionRef(catalogId) {
+        const layout = await this.layoutPromise(catalogId);
+        return layout === "legacy"
+            ? legacyNativeItemsCollectionRef(this.store.firestore, catalogId)
+            : flatNativeItemsCollectionRef(this.store.firestore, catalogId);
     }
     async get(catalogId, itemId) {
-        const snap = await this.itemDocRef(catalogId, itemId).get();
+        const col = await this.itemsCollectionRef(catalogId);
+        const snap = await col.doc(String(itemId)).get();
         return snap.exists ? snap.data() : null;
     }
     async upsert(catalogId, record) {
-        await this.itemDocRef(catalogId, record.itemId).set(record, { merge: true });
+        const col = await this.itemsCollectionRef(catalogId);
+        await col.doc(String(record.itemId)).set(record, { merge: true });
     }
     async delete(catalogId, itemId) {
-        await this.itemDocRef(catalogId, itemId).delete();
+        const col = await this.itemsCollectionRef(catalogId);
+        await col.doc(String(itemId)).delete();
     }
     async batchUpsert(catalogId, records) {
+        const col = await this.itemsCollectionRef(catalogId);
         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 });
+                batch.set(col.doc(String(r.itemId)), r, { merge: true });
             }
             await batch.commit();
         }
     }
-    async list(catalogId, options) {
-        let q = this.store
-            .collection("catalogData")
-            .doc(String(catalogId))
-            .collection("items");
+    async executeListQuery(catalogId, options) {
+        const col = await this.itemsCollectionRef(catalogId);
+        let q = col;
         const filterEq = options?.filterEq ?? {};
         for (const [k, v] of Object.entries(filterEq)) {
             q = q.where(`indexed.${k}`, "==", v);
@@ -47,9 +66,25 @@ export class NativeItemStore {
         }
         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());
     }
+    /**
+     * Lists native rows. If the process cached a legacy vs flat layout choice and data moved
+     * (for example after a console migration), the first unconstrained empty page triggers a
+     * one-time re-resolve and a second query.
+     */
+    async list(catalogId, options) {
+        const offset = options?.offset ?? 0;
+        const filterEq = options?.filterEq ?? {};
+        const sort = options?.sort ?? {};
+        const unconstrained = Object.keys(filterEq).length === 0 && Object.keys(sort).length === 0;
+        let records = await this.executeListQuery(catalogId, options);
+        if (records.length === 0 && offset === 0 && unconstrained) {
+            this.invalidateLayoutCache(catalogId);
+            records = await this.executeListQuery(catalogId, options);
+        }
+        return records;
+    }
 }
 //# sourceMappingURL=native-item-store.js.map

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

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

package/dist/src/migrations/index.d.ts

@@ -1,2 +1,3 @@
 export { buildRendererSnippetDocId } from "./renderer-metadata.js";
+export { migrateNativeCatalogLayout, fixNativeCatalogDataMetadata, type MigrateNativeCatalogLayoutInput, type MigrateNativeCatalogLayoutResult, type MigrateNativeCatalogLayoutIssue, } from "./migrate-native-catalog-layout.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/migrations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/migrations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,EAC5B,KAAK,+BAA+B,EACpC,KAAK,gCAAgC,EACrC,KAAK,+BAA+B,GACrC,MAAM,oCAAoC,CAAC"}

package/dist/src/migrations/index.js

@@ -1,2 +1,3 @@
 export { buildRendererSnippetDocId } from "./renderer-metadata.js";
+export { migrateNativeCatalogLayout, fixNativeCatalogDataMetadata, } from "./migrate-native-catalog-layout.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/migrations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/migrations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,GAI7B,MAAM,oCAAoC,CAAC"}

package/dist/src/migrations/migrate-native-catalog-layout.d.ts

@@ -0,0 +1,51 @@
+import type { CatalogId } from "../contracts/ids.js";
+import { CatalogStore } from "../firebase/catalog-store.js";
+import { BindingStore } from "../firebase/binding-store.js";
+import { DefinitionStore } from "../firebase/definition-store.js";
+import { FirestoreStore } from "../firebase/firestore-store.js";
+import { NativeItemStore } from "../firebase/native-item-store.js";
+import { CatalogDataIndexStore } from "../firebase/catalog-data-index-store.js";
+export type MigrateNativeCatalogLayoutInput = {
+    dryRun?: boolean;
+    verifyOnly?: boolean;
+    overwrite?: boolean;
+    deleteLegacy?: boolean;
+    iHaveBackups?: boolean;
+    continueOnError?: boolean;
+    catalogIds?: CatalogId[];
+    appId?: string;
+    /** Write local NDJSON lines under this directory (created if missing). */
+    exportFilesDir?: string;
+};
+export type MigrateNativeCatalogLayoutIssue = {
+    catalogId: string;
+    code: string;
+    message: string;
+};
+export type MigrateNativeCatalogLayoutResult = {
+    ok: boolean;
+    migratedCatalogs: string[];
+    docsCopied: number;
+    legacyDeleted: number;
+    issues: MigrateNativeCatalogLayoutIssue[];
+};
+/**
+ * After native item rows **already** live under flat `catalogData-{catalogId}-items`, align
+ * `catalogDefinitions` storage hints and seed `catalogData/{catalogId}` index metadata.
+ * Does **not** copy legacy `catalogData/{catalogId}/items` → flat; that is `migrateNativeCatalogLayout`.
+ * Used by the tail of native layout migration and by Firebase restore (which writes items to flat first).
+ */
+export declare function fixNativeCatalogDataMetadata(deps: {
+    definitions: DefinitionStore;
+    catalogDataIndex: CatalogDataIndexStore;
+    nativeItems: NativeItemStore;
+}, catalogIds: CatalogId[], nowIso: string): Promise<void>;
+export declare function migrateNativeCatalogLayout(deps: {
+    firestoreStore: FirestoreStore;
+    catalogs: CatalogStore;
+    bindings: BindingStore;
+    nativeItems: NativeItemStore;
+    catalogDataIndex: CatalogDataIndexStore;
+    definitions: DefinitionStore;
+}, input: MigrateNativeCatalogLayoutInput): Promise<MigrateNativeCatalogLayoutResult>;
+//# sourceMappingURL=migrate-native-catalog-layout.d.ts.map

package/dist/src/migrations/migrate-native-catalog-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-native-catalog-layout.d.ts","sourceRoot":"","sources":["../../../src/migrations/migrate-native-catalog-layout.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGrD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAOhF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,EAAE,EAAE,OAAO,CAAC;IACZ,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,+BAA+B,EAAE,CAAC;CAC3C,CAAC;AAoCF;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE;IACJ,WAAW,EAAE,eAAe,CAAC;IAC7B,gBAAgB,EAAE,qBAAqB,CAAC;IACxC,WAAW,EAAE,eAAe,CAAC;CAC9B,EACD,UAAU,EAAE,SAAS,EAAE,EACvB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE;IACJ,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,WAAW,EAAE,eAAe,CAAC;IAC7B,gBAAgB,EAAE,qBAAqB,CAAC;IACxC,WAAW,EAAE,eAAe,CAAC;CAC9B,EACD,KAAK,EAAE,+BAA+B,GACrC,OAAO,CAAC,gCAAgC,CAAC,CA4K3C"}