@x12i/catalox 5.2.0 → 5.9.7

package/packages/engine/dist/catalox/firestore-gcs-transfer.d.ts

@@ -0,0 +1,28 @@
+import { type CollectionReference, type Firestore } from "firebase-admin/firestore";
+import { Storage } from "@google-cloud/storage";
+import { Readable } from "node:stream";
+import type { ExportAllFirestoreCollectionsToGcsInput, ExportAllFirestoreCollectionsToGcsResult, ExportFirestoreCollectionToGcsInput, ExportFirestoreCollectionToGcsResult, RestoreAllFirestoreCollectionsFromGcsInput, RestoreAllFirestoreCollectionsFromGcsResult, RestoreFirestoreCollectionFromGcsInput, RestoreFirestoreCollectionFromGcsResult } from "@x12i/catalox-contracts/gcs-firestore-transfer.js";
+import { collectionRefFromSlashPath } from "../firebase/firestore-collection-path.js";
+/** Default manifest object name under `gcsPrefix` for export-all / restore-all / compare-manifest. */
+export declare const CATALOX_FIRESTORE_GCS_MANIFEST = "catalox-firestore-export-manifest.json";
+type GcsRuntimeInput = {
+    storage?: Storage;
+};
+export declare function normalizeGcsPrefix(prefix?: string): string;
+/** Map `apps` or `a/b/c` → safe single-segment base for object names. */
+export declare function firestoreCollectionPathToObjectBase(collectionPath: string): string;
+export declare function ndjsonObjectPath(params: {
+    gcsPrefix: string;
+    collectionPath: string;
+    objectNamePostfix?: string;
+}): string;
+/** @deprecated Use the same implementation as {@link collectionRefFromSlashPath} (re-exported for compatibility). */
+export declare const collectionRefFromPath: typeof collectionRefFromSlashPath;
+export declare function exportFirestoreCollectionToGcs(input: ExportFirestoreCollectionToGcsInput & GcsRuntimeInput): Promise<ExportFirestoreCollectionToGcsResult>;
+export declare function exportAllFirestoreCollectionsToGcs(input: ExportAllFirestoreCollectionsToGcsInput & GcsRuntimeInput): Promise<ExportAllFirestoreCollectionsToGcsResult>;
+/** Import NDJSON lines `{ id, data }` (same shape as export-gcs) into a Firestore collection. */
+export declare function restoreFirestoreNdjsonStreamToCollection(fs: Firestore, col: CollectionReference, stream: Readable): Promise<number>;
+export declare function restoreFirestoreCollectionFromGcs(input: RestoreFirestoreCollectionFromGcsInput & GcsRuntimeInput): Promise<RestoreFirestoreCollectionFromGcsResult>;
+export declare function restoreAllFirestoreCollectionsFromGcsManifest(input: RestoreAllFirestoreCollectionsFromGcsInput & GcsRuntimeInput): Promise<RestoreAllFirestoreCollectionsFromGcsResult>;
+export {};
+//# sourceMappingURL=firestore-gcs-transfer.d.ts.map

package/packages/engine/dist/catalox/firestore-gcs-transfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firestore-gcs-transfer.d.ts","sourceRoot":"","sources":["../../src/catalox/firestore-gcs-transfer.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,SAAS,EAEf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,OAAO,EAA0B,MAAM,uBAAuB,CAAC;AAExE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,KAAK,EACV,uCAAuC,EACvC,wCAAwC,EACxC,mCAAmC,EACnC,oCAAoC,EAGpC,0CAA0C,EAC1C,2CAA2C,EAC3C,sCAAsC,EACtC,uCAAuC,EACxC,MAAM,mDAAmD,CAAC;AAE3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AAEtF,sGAAsG;AACtG,eAAO,MAAM,8BAA8B,2CAA2C,CAAC;AAEvF,KAAK,eAAe,GAAG;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE7C,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAI1D;AAED,yEAAyE;AACzE,wBAAgB,mCAAmC,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAMlF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,GAAG,MAAM,CAIT;AAOD,qHAAqH;AACrH,eAAO,MAAM,qBAAqB,mCAA6B,CAAC;AAyEhE,wBAAsB,8BAA8B,CAClD,KAAK,EAAE,mCAAmC,GAAG,eAAe,GAC3D,OAAO,CAAC,oCAAoC,CAAC,CAwB/C;AAED,wBAAsB,kCAAkC,CACtD,KAAK,EAAE,uCAAuC,GAAG,eAAe,GAC/D,OAAO,CAAC,wCAAwC,CAAC,CA0DnD;AAED,iGAAiG;AACjG,wBAAsB,wCAAwC,CAC5D,EAAE,EAAE,SAAS,EACb,GAAG,EAAE,mBAAmB,EACxB,MAAM,EAAE,QAAQ,GACf,OAAO,CAAC,MAAM,CAAC,CAwBjB;AAED,wBAAsB,iCAAiC,CACrD,KAAK,EAAE,sCAAsC,GAAG,eAAe,GAC9D,OAAO,CAAC,uCAAuC,CAAC,CA6ClD;AAED,wBAAsB,6CAA6C,CACjE,KAAK,EAAE,0CAA0C,GAAG,eAAe,GAClE,OAAO,CAAC,2CAA2C,CAAC,CA2DtD"}

package/packages/engine/dist/catalox/firestore-gcs-transfer.js.map

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

package/packages/engine/dist/catalox/identity.d.ts

@@ -0,0 +1,7 @@
+import type { CatalogIdentityDescriptor } from "@x12i/catalox-contracts/descriptors.js";
+export type ResolveCatalogItemIdInput = {
+    identity: CatalogIdentityDescriptor;
+    data: Record<string, unknown>;
+};
+export declare function resolveCatalogItemId(input: ResolveCatalogItemIdInput): string;
+//# sourceMappingURL=identity.d.ts.map

package/packages/engine/dist/catalox/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/catalox/identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AAExF,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,EAAE,yBAAyB,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,MAAM,CAsB7E"}

package/packages/engine/dist/catalox/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/catalox/identity.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,oBAAoB,CAAC,KAAgC;IACnE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IACjC,IAAI,QAAQ,CAAC,cAAc,KAAK,WAAW,EAAE,CAAC;QAC5C,kFAAkF;QAClF,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,QAAQ,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QAC1C,IAAI,CAAC,QAAQ,CAAC,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QACrF,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QAC9E,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,eAAe,IAAI,EAAE,CAAC;IAC9C,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IACpF,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC7B,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,EAAE,CAAC,CAAC;QACrF,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/catalox/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,wBAAwB,EACxB,4BAA4B,EAC5B,oCAAoC,EACpC,KAAK,cAAc,EACnB,kBAAkB,EAClB,gCAAgC,EAChC,6BAA6B,EAC7B,kBAAkB,EAClB,iCAAiC,EACjC,kCAAkC,EAClC,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,uBAAuB,EACvB,2CAA2C,EAC3C,KAAK,oBAAoB,EACzB,KAAK,qCAAqC,GAC3C,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,gCAAgC,EAChC,4BAA4B,EAC5B,KAAK,2BAA2B,GACjC,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,iDAAiD,EACjD,4CAA4C,GAC7C,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,8BAA8B,EAC9B,kCAAkC,EAClC,iCAAiC,EACjC,6CAA6C,EAC7C,wCAAwC,EACxC,8BAA8B,EAC9B,kBAAkB,EAClB,mCAAmC,EACnC,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,uCAAuC,EACvC,6CAA6C,EAC7C,mBAAmB,EACnB,eAAe,GAChB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,oCAAoC,EACpC,2BAA2B,EAC3B,KAAK,gCAAgC,GACtC,MAAM,wCAAwC,CAAC;AAChD,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,OAAO,EACL,+BAA+B,EAC/B,iCAAiC,EACjC,uBAAuB,EACvB,sBAAsB,EACtB,6BAA6B,EAC7B,KAAK,iBAAiB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,yBAAyB,GAC/B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,gBAAgB,EAChB,KAAK,oBAAoB,GAC1B,MAAM,wBAAwB,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/catalox/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,aAAa,EAA6B,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,wBAAwB,EACxB,4BAA4B,EAC5B,oCAAoC,EAEpC,kBAAkB,EAClB,gCAAgC,EAChC,6BAA6B,EAC7B,kBAAkB,EAClB,iCAAiC,EACjC,kCAAkC,EAClC,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,uBAAuB,EACvB,2CAA2C,GAG5C,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,gCAAgC,EAChC,4BAA4B,GAE7B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,iDAAiD,EACjD,4CAA4C,GAC7C,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,8BAA8B,EAC9B,kCAAkC,EAClC,iCAAiC,EACjC,6CAA6C,EAC7C,wCAAwC,EACxC,8BAA8B,EAC9B,kBAAkB,EAClB,mCAAmC,EACnC,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,uCAAuC,EACvC,6CAA6C,EAC7C,mBAAmB,EACnB,eAAe,GAChB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,oCAAoC,EACpC,2BAA2B,GAE5B,MAAM,wCAAwC,CAAC;AAChD,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,OAAO,EACL,+BAA+B,EAC/B,iCAAiC,EACjC,uBAAuB,EACvB,sBAAsB,EACtB,6BAA6B,GAE9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,GAErB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,gBAAgB,GAEjB,MAAM,wBAAwB,CAAC"}

package/packages/engine/dist/catalox/item-scope-match.d.ts

@@ -0,0 +1,39 @@
+import type { CatalogItemScope } from "@x12i/catalox-contracts/items.js";
+/**
+ * Merge token scope (authorization boundary) with fetch scope (request narrowing).
+ * Fetch never expands beyond token; shared dimensions are intersected.
+ */
+export declare function mergeEffectiveScope(tokenScope: CatalogItemScope | undefined, fetchScope: CatalogItemScope | undefined, opts?: {
+    unrestricted?: boolean;
+}): {
+    effectiveScope: CatalogItemScope;
+    scopedAccessAllowed: boolean;
+};
+export declare function itemMatchesEffectiveScope(itemScope: CatalogItemScope, effectiveScope: CatalogItemScope): boolean;
+export type CatalogScopeFetchMode = {
+    includeGeneric: boolean;
+    genericOnly: boolean;
+    scopedOnly: boolean;
+};
+export declare function resolveCatalogScopeFetchMode(options?: {
+    includeGeneric?: boolean;
+    scopedOnly?: boolean;
+    genericOnly?: boolean;
+}): CatalogScopeFetchMode;
+export declare function shouldIncludeItemInList(params: {
+    itemScope: CatalogItemScope;
+    effectiveScope: CatalogItemScope;
+    scopedAccessAllowed: boolean;
+    fetchMode: CatalogScopeFetchMode;
+}): boolean;
+/** Build token scope from context.scope only (not singular legacy coords). */
+export declare function tokenScopeFromContext(context: {
+    scope?: CatalogItemScope;
+    superAdmin?: boolean;
+    unrestrictedScope?: boolean;
+}): CatalogItemScope;
+export declare function isUnrestrictedScopeContext(context: {
+    superAdmin?: boolean;
+    unrestrictedScope?: boolean;
+}): boolean;
+//# sourceMappingURL=item-scope-match.d.ts.map

package/packages/engine/dist/catalox/item-scope-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-scope-match.d.ts","sourceRoot":"","sources":["../../src/catalox/item-scope-match.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAgBzE;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,gBAAgB,GAAG,SAAS,EACxC,UAAU,EAAE,gBAAgB,GAAG,SAAS,EACxC,IAAI,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAChC;IAAE,cAAc,EAAE,gBAAgB,CAAC;IAAC,mBAAmB,EAAE,OAAO,CAAA;CAAE,CAmDpE;AAED,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,gBAAgB,EAC3B,cAAc,EAAE,gBAAgB,GAC/B,OAAO,CAaT;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,wBAAgB,4BAA4B,CAAC,OAAO,CAAC,EAAE;IACrD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GAAG,qBAAqB,CAKxB;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,SAAS,EAAE,gBAAgB,CAAC;IAC5B,cAAc,EAAE,gBAAgB,CAAC;IACjC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,SAAS,EAAE,qBAAqB,CAAC;CAClC,GAAG,OAAO,CAcV;AAED,8EAA8E;AAC9E,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,GAAG,gBAAgB,CAEnB;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,GAAG,OAAO,CAEV"}

package/packages/engine/dist/catalox/item-scope-match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-scope-match.js","sourceRoot":"","sources":["../../src/catalox/item-scope-match.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErE,SAAS,eAAe,CAAC,CAAW,EAAE,CAAW;IAC/C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;IACvB,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,cAAc,CAAC,GAAG,MAA0B;IACnD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,UAAwC,EACxC,UAAwC,EACxC,IAAiC;IAEjC,MAAM,KAAK,GAAG,kBAAkB,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,kBAAkB,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;IAEjD,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,cAAc,GAAqB,EAAE,CAAC;QAC5C,KAAK,MAAM,GAAG,IAAI,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;YAC/C,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;YACrB,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;YACrB,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;gBAC3B,MAAM,KAAK,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACpC,IAAI,KAAK,CAAC,MAAM;oBAAE,cAAc,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;;oBACzC,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;YAChC,CAAC;iBAAM,IAAI,CAAC,EAAE,MAAM;gBAAE,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;iBACzC,IAAI,CAAC,EAAE,MAAM;gBAAE,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC;IACvD,CAAC;IAED,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAEzC,IAAI,UAAU,IAAI,UAAU,EAAE,CAAC;QAC7B,OAAO,EAAE,cAAc,EAAE,EAAE,EAAE,mBAAmB,EAAE,KAAK,EAAE,CAAC;IAC5D,CAAC;IAED,IAAI,UAAU,IAAI,CAAC,UAAU,EAAE,CAAC;QAC9B,OAAO,EAAE,cAAc,EAAE,EAAE,EAAE,mBAAmB,EAAE,KAAK,EAAE,CAAC;IAC5D,CAAC;IAED,MAAM,cAAc,GAAqB,EAAE,GAAG,KAAK,EAAE,CAAC;IACtD,KAAK,MAAM,GAAG,IAAI,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;QAC/C,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACrB,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACpC,cAAc,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC9B,CAAC;aAAM,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;YACrB,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;aAAM,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;YACrB,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;IACvF,IAAI,oBAAoB,EAAE,CAAC;QACzB,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,KAAK,EAAE,CAAC;IACxD,CAAC;IAED,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,SAA2B,EAC3B,cAAgC;IAEhC,MAAM,IAAI,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,kBAAkB,CAAC,cAAc,CAAC,CAAC;IAC/C,IAAI,cAAc,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IACtD,IAAI,cAAc,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAEvC,KAAK,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACzD,IAAI,CAAC,SAAS,EAAE,MAAM;YAAE,SAAS;QACjC,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QACnC,IAAI,CAAC,UAAU,EAAE,MAAM;YAAE,OAAO,KAAK,CAAC;QACtC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IACnE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAQD,MAAM,UAAU,4BAA4B,CAAC,OAI5C;IACC,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAClD,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,KAAK,IAAI,IAAI,OAAO,EAAE,cAAc,KAAK,KAAK,CAAC;IACrF,MAAM,cAAc,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,cAAc,KAAK,KAAK,CAAC;IACpG,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAKvC;IACC,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,mBAAmB,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAC7E,MAAM,IAAI,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAErC,IAAI,SAAS,CAAC,WAAW;QAAE,OAAO,OAAO,CAAC;IAE1C,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,SAAS,CAAC,cAAc,CAAC;IAClC,CAAC;IAED,IAAI,CAAC,mBAAmB;QAAE,OAAO,KAAK,CAAC;IAEvC,OAAO,yBAAyB,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;AACzD,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,qBAAqB,CAAC,OAIrC;IACC,OAAO,kBAAkB,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,OAG1C;IACC,OAAO,OAAO,CAAC,UAAU,KAAK,IAAI,IAAI,OAAO,CAAC,iBAAiB,KAAK,IAAI,CAAC;AAC3E,CAAC"}

package/packages/engine/dist/catalox/item-scope.d.ts

@@ -0,0 +1,36 @@
+import type { CatalogItemScope } from "@x12i/catalox-contracts/items.js";
+/** True when scope has no dimensions (generic / catalog-wide item). */
+export declare function isGenericScope(scope: CatalogItemScope | undefined | null): boolean;
+/** Detect legacy native scope shapes (v1 kind / v2 scoped). */
+export declare function isLegacyScopeShape(raw: unknown): boolean;
+/**
+ * Normalize persisted or write input to canonical flexible scope.
+ * Rejects legacy shapes at runtime (post-migration contract).
+ */
+export declare function normalizeItemScope(raw: unknown, opts?: {
+    allowLegacy?: boolean;
+}): CatalogItemScope;
+export declare function parseWriteScopeInput(raw: unknown): CatalogItemScope | undefined;
+/** Firestore document ids cannot contain `/`. */
+export declare function itemIdNeedsEncodedStorageDocId(itemId: string): boolean;
+/** Stable Firestore document id for a logical catalog item id. */
+export declare function storageDocIdForItem(itemId: string): string;
+/** Resolve logical itemId from a Firestore storage document id. */
+export declare function logicalItemIdFromStorageDocId(docId: string): string;
+export declare function storageDocIdForNativeRecord(record: {
+    itemId: string;
+}): string;
+/** Mirror non-empty scope dimensions under indexed.scope.<dimension> for queries. */
+export declare function indexedScopeFields(scope: CatalogItemScope): Record<string, unknown>;
+/** Sync optional metadata display copies from canonical scope (not used for visibility). */
+export declare function metadataFromScope(scope: CatalogItemScope): {
+    domainIds: string[];
+    agentIds: string[];
+};
+export declare function scopeFromRecordField(scope: unknown): CatalogItemScope;
+export declare function assertWriteScopeAllowed(context: {
+    superAdmin?: boolean;
+    unrestrictedScope?: boolean;
+    scope?: CatalogItemScope;
+}, itemScope: CatalogItemScope): void;
+//# sourceMappingURL=item-scope.d.ts.map

package/packages/engine/dist/catalox/item-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-scope.d.ts","sourceRoot":"","sources":["../../src/catalox/item-scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAIzE,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAGlF;AAED,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAOxD;AAQD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,gBAAgB,CAuBnG;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAG/E;AAaD,iDAAiD;AACjD,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAGtE;AAED,kEAAkE;AAClE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAI1D;AAED,mEAAmE;AACnE,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAInE;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE9E;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOnF;AAED,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAKtG;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAErE;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,gBAAgB,CAAA;CAAE,EACxF,SAAS,EAAE,gBAAgB,GAC1B,IAAI,CAmBN"}

package/packages/engine/dist/catalox/item-scope.js

@@ -0,0 +1,137 @@
+import { CatalogValidationError } from "@x12i/catalox-contracts/errors.js";
+import { convertLegacyScopeToFlexible } from "./scope-legacy-convert.js";
+/** True when scope has no dimensions (generic / catalog-wide item). */
+export function isGenericScope(scope) {
+    if (!scope || typeof scope !== "object")
+        return true;
+    return Object.keys(scope).length === 0;
+}
+/** Detect legacy native scope shapes (v1 kind / v2 scoped). */
+export function isLegacyScopeShape(raw) {
+    if (raw == null || typeof raw !== "object")
+        return false;
+    const o = raw;
+    if ("kind" in o)
+        return true;
+    if ("tenant" in o || "agent" in o)
+        return true;
+    if (o.scopeLayer != null)
+        return true;
+    return false;
+}
+function normalizeStringArray(raw) {
+    if (!Array.isArray(raw))
+        return undefined;
+    const out = raw.filter((x) => typeof x === "string" && x.trim() !== "").map((s) => s.trim());
+    return out.length ? [...new Set(out)] : undefined;
+}
+/**
+ * Normalize persisted or write input to canonical flexible scope.
+ * Rejects legacy shapes at runtime (post-migration contract).
+ */
+export function normalizeItemScope(raw, opts) {
+    if (raw == null)
+        return {};
+    if (typeof raw !== "object" || Array.isArray(raw)) {
+        throw new CatalogValidationError({ reason: "invalid_scope_shape", message: "scope must be an object" });
+    }
+    if (isLegacyScopeShape(raw)) {
+        if (!opts?.allowLegacy) {
+            throw new CatalogValidationError({
+                reason: "invalid_scope_shape",
+                message: "legacy scope shape is not supported; run migrate-native-item-scope",
+            });
+        }
+        return convertLegacyScopeToFlexible(raw);
+    }
+    const o = raw;
+    const out = {};
+    for (const [key, val] of Object.entries(o)) {
+        if (key === "kind" || key === "tenant" || key === "agent" || key.startsWith("scope"))
+            continue;
+        const arr = normalizeStringArray(val);
+        if (arr?.length)
+            out[key] = arr;
+    }
+    return out;
+}
+export function parseWriteScopeInput(raw) {
+    if (raw == null)
+        return undefined;
+    return normalizeItemScope(raw);
+}
+const ID_ENC = "id~";
+const LEGACY_MODEL_DOC = "cx~m~";
+function b64u(s) {
+    return Buffer.from(s, "utf8").toString("base64url");
+}
+function b64uDec(s) {
+    return Buffer.from(s, "base64url").toString("utf8");
+}
+/** Firestore document ids cannot contain `/`. */
+export function itemIdNeedsEncodedStorageDocId(itemId) {
+    const s = String(itemId);
+    return s.includes("/") || s.includes("\0") || s === "." || s === "..";
+}
+/** Stable Firestore document id for a logical catalog item id. */
+export function storageDocIdForItem(itemId) {
+    const s = String(itemId);
+    if (!itemIdNeedsEncodedStorageDocId(s))
+        return s;
+    return `${ID_ENC}${b64u(s)}`;
+}
+/** Resolve logical itemId from a Firestore storage document id. */
+export function logicalItemIdFromStorageDocId(docId) {
+    if (docId.startsWith(ID_ENC))
+        return b64uDec(docId.slice(ID_ENC.length));
+    if (docId.startsWith(LEGACY_MODEL_DOC))
+        return b64uDec(docId.slice(LEGACY_MODEL_DOC.length));
+    return docId;
+}
+export function storageDocIdForNativeRecord(record) {
+    return storageDocIdForItem(String(record.itemId));
+}
+/** Mirror non-empty scope dimensions under indexed.scope.<dimension> for queries. */
+export function indexedScopeFields(scope) {
+    const out = { scopeGeneric: isGenericScope(scope) };
+    if (isGenericScope(scope))
+        return out;
+    for (const [dim, vals] of Object.entries(scope)) {
+        if (vals?.length)
+            out[`scope.${dim}`] = vals;
+    }
+    return out;
+}
+/** Sync optional metadata display copies from canonical scope (not used for visibility). */
+export function metadataFromScope(scope) {
+    return {
+        domainIds: scope.domains ?? [],
+        agentIds: scope.agents ?? [],
+    };
+}
+export function scopeFromRecordField(scope) {
+    return normalizeItemScope(scope);
+}
+export function assertWriteScopeAllowed(context, itemScope) {
+    if (isGenericScope(itemScope))
+        return;
+    if (context.superAdmin || context.unrestrictedScope)
+        return;
+    const token = normalizeItemScope(context.scope ?? {});
+    if (isGenericScope(token)) {
+        throw new CatalogValidationError({
+            reason: "scope_write_denied",
+            message: "non-generic item scope requires token scope, superAdmin, or unrestrictedScope",
+        });
+    }
+    for (const [dim, vals] of Object.entries(itemScope)) {
+        const allowed = token[dim] ?? [];
+        if (!vals.every((v) => allowed.includes(v))) {
+            throw new CatalogValidationError({
+                reason: "scope_write_denied",
+                message: `item scope dimension ${dim} exceeds token allowance`,
+            });
+        }
+    }
+}
+//# sourceMappingURL=item-scope.js.map

package/packages/engine/dist/catalox/item-scope.js.map

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

package/packages/engine/dist/catalox/json-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-io.d.ts","sourceRoot":"","sources":["../../src/catalox/json-io.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAEtD;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,UAAO,GAAG,MAAM,CAE5D"}

package/packages/engine/dist/catalox/json-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-io.js","sourceRoot":"","sources":["../../src/catalox/json-io.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAc,IAAY;IACjD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAAc,EAAE,MAAM,GAAG,IAAI;IAClD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACrD,CAAC"}

package/packages/engine/dist/catalox/native-catalog-layout-diagnostics.d.ts

@@ -0,0 +1,29 @@
+import type { CatalogId } from "@x12i/catalox-contracts/ids.js";
+import { type BackupDataDeps } from "./backup-data.js";
+export type NativeCatalogLayoutDiagnosticRow = {
+    catalogId: string;
+    /** Documents under `catalogData/{catalogId}/items` (legacy). */
+    legacyItemCount: number;
+    /** Documents under top-level `catalogData-{catalogId}-items` (flat). */
+    flatItemCount: number;
+    /** What `NativeItemStore` / backup would use today. */
+    resolverLayout: "flat" | "legacy";
+    /** True when legacy still holds rows; flat migration (or delete-legacy) is what removes this from being authoritative. */
+    legacyHasRows: boolean;
+    /** True when legacy has rows and flat is empty — run `migrateNativeCatalogLayout` to create flat rows. */
+    needsLegacyToFlatMigration: boolean;
+};
+/**
+ * Inspect native storage paths for every discovered catalog (same discovery rules as backup/migrate).
+ * Use this when the Firebase console still shows **`catalogData/{catalogId}/items`** (legacy) and you expect **`catalogData-{catalogId}-items`** at the root.
+ */
+export declare function reportNativeCatalogLayoutDiagnostics(deps: BackupDataDeps, opts?: {
+    catalogIds?: CatalogId[];
+    appId?: string;
+}): Promise<NativeCatalogLayoutDiagnosticRow[]>;
+/** Human-readable live paths for one catalog (for CLI / operators). */
+export declare function nativeCatalogFirestorePaths(catalogId: string): {
+    legacyItemsPath: string;
+    flatItemsCollectionId: string;
+};
+//# sourceMappingURL=native-catalog-layout-diagnostics.d.ts.map

package/packages/engine/dist/catalox/native-catalog-layout-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-catalog-layout-diagnostics.d.ts","sourceRoot":"","sources":["../../src/catalox/native-catalog-layout-diagnostics.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAEhE,OAAO,EAA4B,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAsBjF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,eAAe,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,aAAa,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC;IAClC,0HAA0H;IAC1H,aAAa,EAAE,OAAO,CAAC;IACvB,0GAA0G;IAC1G,0BAA0B,EAAE,OAAO,CAAC;CACrC,CAAC;AAEF;;;GAGG;AACH,wBAAsB,oCAAoC,CACxD,IAAI,EAAE,cAAc,EACpB,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAClD,OAAO,CAAC,gCAAgC,EAAE,CAAC,CAyB7C;AAED,uEAAuE;AACvE,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG;IAC9D,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,MAAM,CAAC;CAC/B,CAKA"}

package/packages/engine/dist/catalox/native-catalog-layout-diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-catalog-layout-diagnostics.js","sourceRoot":"","sources":["../../src/catalox/native-catalog-layout-diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAkB,MAAM,0BAA0B,CAAC;AAIrE,OAAO,EAAE,wBAAwB,EAAuB,MAAM,kBAAkB,CAAC;AACjF,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,EAC9B,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,mCAAmC,CAAC;AAE3C,KAAK,UAAU,SAAS,CAAC,GAA0C;IACjE,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,IAAyD,CAAC;IAC9D,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACvD,IAAI,IAAI;YAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,KAAK;YAAE,MAAM;QACtB,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC;QACf,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAgBD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oCAAoC,CACxD,IAAoB,EACpB,IAAmD;IAEnD,MAAM,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC;IACzC,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;IAClD,MAAM,GAAG,GAAG,MAAM,wBAAwB,CAAC,EAAE,EAAE,WAA8B,EAAE;QAC7E,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,GAAG,CAAC,IAAI,EAAE,KAAK,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3E,CAAC,CAAC;IAEH,MAAM,IAAI,GAAuC,EAAE,CAAC;IACpD,KAAK,MAAM,SAAS,IAAI,GAAG,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,8BAA8B,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,4BAA4B,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QACzD,MAAM,CAAC,eAAe,EAAE,aAAa,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9F,MAAM,cAAc,GAAG,MAAM,wBAAwB,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QACrE,IAAI,CAAC,IAAI,CAAC;YACR,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC;YAC5B,eAAe;YACf,aAAa;YACb,cAAc;YACd,aAAa,EAAE,eAAe,GAAG,CAAC;YAClC,0BAA0B,EAAE,eAAe,GAAG,CAAC,IAAI,aAAa,KAAK,CAAC;SACvE,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,2BAA2B,CAAC,SAAiB;IAI3D,OAAO;QACL,eAAe,EAAE,eAAe,SAAS,QAAQ;QACjD,qBAAqB,EAAE,uBAAuB,CAAC,SAAS,CAAC;KAC1D,CAAC;AACJ,CAAC"}

package/packages/engine/dist/catalox/native-catalog-merge.d.ts

@@ -0,0 +1,10 @@
+import type { CatalogIdentityDescriptor } from "@x12i/catalox-contracts/descriptors.js";
+import type { CatalogItemScope } from "@x12i/catalox-contracts/items.js";
+import type { NativeCatalogItemRecord, UnifiedCatalogItem } from "@x12i/catalox-contracts/items.js";
+export declare function toUnifiedNativeItem(r: NativeCatalogItemRecord, appId: string, includeScopeInResponse: boolean, sourceType?: UnifiedCatalogItem["sourceType"]): UnifiedCatalogItem;
+/** One physical row per logical itemId after flexible scope migration. */
+export declare function mergeNativePhysicalRows(records: NativeCatalogItemRecord[], _identity: CatalogIdentityDescriptor, appId: string, includeScopeInResponse: boolean, _superListAll?: boolean, sourceType?: UnifiedCatalogItem["sourceType"]): UnifiedCatalogItem[];
+export declare function pickWinningPhysicalRow(rows: NativeCatalogItemRecord[]): NativeCatalogItemRecord | null;
+export declare function recordItemScope(r: NativeCatalogItemRecord): CatalogItemScope;
+export declare function isGenericPhysicalRow(r: NativeCatalogItemRecord): boolean;
+//# sourceMappingURL=native-catalog-merge.d.ts.map

package/packages/engine/dist/catalox/native-catalog-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-catalog-merge.d.ts","sourceRoot":"","sources":["../../src/catalox/native-catalog-merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAGpG,wBAAgB,mBAAmB,CACjC,CAAC,EAAE,uBAAuB,EAC1B,KAAK,EAAE,MAAM,EACb,sBAAsB,EAAE,OAAO,EAC/B,UAAU,GAAE,kBAAkB,CAAC,YAAY,CAAc,GACxD,kBAAkB,CAkBpB;AAED,0EAA0E;AAC1E,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,uBAAuB,EAAE,EAClC,SAAS,EAAE,yBAAyB,EACpC,KAAK,EAAE,MAAM,EACb,sBAAsB,EAAE,OAAO,EAC/B,aAAa,CAAC,EAAE,OAAO,EACvB,UAAU,GAAE,kBAAkB,CAAC,YAAY,CAAc,GACxD,kBAAkB,EAAE,CAOtB;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,uBAAuB,EAAE,GAAG,uBAAuB,GAAG,IAAI,CAEtG;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,uBAAuB,GAAG,gBAAgB,CAE5E;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAExE"}

package/packages/engine/dist/catalox/native-catalog-merge.js

@@ -0,0 +1,40 @@
+import { isGenericScope, metadataFromScope, scopeFromRecordField } from "./item-scope.js";
+export function toUnifiedNativeItem(r, appId, includeScopeInResponse, sourceType = "firebase") {
+    const itemScope = scopeFromRecordField(r.scope);
+    const metaDisplay = metadataFromScope(itemScope);
+    const meta = {
+        ...(r.metadata && typeof r.metadata === "object" ? r.metadata : {}),
+        domainIds: metaDisplay.domainIds,
+        agentIds: metaDisplay.agentIds,
+    };
+    return {
+        itemId: r.itemId,
+        catalogId: r.catalogId,
+        appId,
+        sourceMode: "native",
+        sourceType: sourceType ?? "firebase",
+        data: r.data,
+        ...(includeScopeInResponse ? { scope: itemScope } : {}),
+        metadata: meta,
+    };
+}
+/** One physical row per logical itemId after flexible scope migration. */
+export function mergeNativePhysicalRows(records, _identity, appId, includeScopeInResponse, _superListAll, sourceType = "firebase") {
+    const byItem = new Map();
+    for (const r of records) {
+        const id = String(r.itemId);
+        if (!byItem.has(id))
+            byItem.set(id, r);
+    }
+    return [...byItem.values()].map((r) => toUnifiedNativeItem(r, appId, includeScopeInResponse, sourceType));
+}
+export function pickWinningPhysicalRow(rows) {
+    return rows[0] ?? null;
+}
+export function recordItemScope(r) {
+    return scopeFromRecordField(r.scope);
+}
+export function isGenericPhysicalRow(r) {
+    return isGenericScope(scopeFromRecordField(r.scope));
+}
+//# sourceMappingURL=native-catalog-merge.js.map

package/packages/engine/dist/catalox/native-catalog-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-catalog-merge.js","sourceRoot":"","sources":["../../src/catalox/native-catalog-merge.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE1F,MAAM,UAAU,mBAAmB,CACjC,CAA0B,EAC1B,KAAa,EACb,sBAA+B,EAC/B,aAA+C,UAAU;IAEzD,MAAM,SAAS,GAAG,oBAAoB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACjD,MAAM,IAAI,GAA4B;QACpC,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,SAAS,EAAE,WAAW,CAAC,SAAS;QAChC,QAAQ,EAAE,WAAW,CAAC,QAAQ;KAC/B,CAAC;IACF,OAAO;QACL,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,KAAK;QACL,UAAU,EAAE,QAAQ;QACpB,UAAU,EAAE,UAAU,IAAI,UAAU;QACpC,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,GAAG,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,QAAQ,EAAE,IAAI;KACf,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,uBAAuB,CACrC,OAAkC,EAClC,SAAoC,EACpC,KAAa,EACb,sBAA+B,EAC/B,aAAuB,EACvB,aAA+C,UAAU;IAEzD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAmC,CAAC;IAC1D,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,UAAU,CAAC,CAAC,CAAC;AAC5G,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAA+B;IACpE,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,CAA0B;IACxD,OAAO,oBAAoB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,CAA0B;IAC7D,OAAO,cAAc,CAAC,oBAAoB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AACvD,CAAC"}

package/packages/engine/dist/catalox/native-item-resolve.d.ts

@@ -0,0 +1,28 @@
+import type { CatalogId, ItemId } from "@x12i/catalox-contracts/ids.js";
+import type { NativeCatalogItemRecord } from "@x12i/catalox-contracts/items.js";
+import type { NativeItemStore } from "../firebase/native-item-store.js";
+type NativeItemLookup = Pick<NativeItemStore, "findByLogicalItemId" | "get">;
+/**
+ * Resolve physical native rows for a logical item id.
+ * Uses indexed `itemId` query, then encoded storage doc id (`id~…`), then legacy raw doc id when path-safe.
+ */
+export declare function resolveNativeRowsByLogicalItemId(nativeItems: NativeItemLookup, catalogId: CatalogId, logicalItemId: ItemId): Promise<NativeCatalogItemRecord[]>;
+export type NativeListFilterPlan = {
+    filterEq: Record<string, unknown>;
+    filterArrayContains: Record<string, string>;
+};
+/** Split list filters into equality vs array-contains based on descriptor field shape. */
+export declare function planNativeListFilters(descriptor: {
+    queryableFields?: Array<{
+        key: string;
+        multiValue?: boolean;
+        type?: string;
+    }>;
+    smartProperties?: Array<{
+        key: string;
+        multiValue?: boolean;
+        indexed?: boolean;
+    }>;
+}, filter: Record<string, unknown> | undefined): NativeListFilterPlan;
+export {};
+//# sourceMappingURL=native-item-resolve.d.ts.map

package/packages/engine/dist/catalox/native-item-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-item-resolve.d.ts","sourceRoot":"","sources":["../../src/catalox/native-item-resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAGxE,KAAK,gBAAgB,GAAG,IAAI,CAAC,eAAe,EAAE,qBAAqB,GAAG,KAAK,CAAC,CAAC;AAE7E;;;GAGG;AACH,wBAAsB,gCAAgC,CACpD,WAAW,EAAE,gBAAgB,EAC7B,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAcpC;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C,CAAC;AAEF,0FAA0F;AAC1F,wBAAgB,qBAAqB,CACnC,UAAU,EAAE;IAAE,eAAe,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,eAAe,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CAAE,EAChL,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC1C,oBAAoB,CAyBtB"}

package/packages/engine/dist/catalox/native-item-resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-item-resolve.js","sourceRoot":"","sources":["../../src/catalox/native-item-resolve.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,8BAA8B,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAItF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gCAAgC,CACpD,WAA6B,EAC7B,SAAoB,EACpB,aAAqB;IAErB,MAAM,EAAE,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,mBAAmB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IAC7E,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAE7B,MAAM,YAAY,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,mBAAmB,CAAC,EAAE,CAAW,CAAC,CAAC;IACzF,IAAI,YAAY;QAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAExC,IAAI,CAAC,8BAA8B,CAAC,EAAE,CAAC,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QAC/D,IAAI,MAAM;YAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAOD,0FAA0F;AAC1F,MAAM,UAAU,qBAAqB,CACnC,UAAgL,EAChL,MAA2C;IAE3C,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAC7C,MAAM,mBAAmB,GAA2B,EAAE,CAAC;IACvD,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC;QAC3C,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAC3C,CAAC;IAED,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC5C,KAAK,MAAM,CAAC,IAAI,UAAU,CAAC,eAAe,IAAI,EAAE,EAAE,CAAC;QACjD,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO;YAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACvE,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,UAAU,CAAC,eAAe,IAAI,EAAE,EAAE,CAAC;QAClD,IAAI,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,UAAU,KAAK,KAAK;YAAE,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAC3E,CAAC;IAED,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE;YAAE,SAAS;QACpC,IAAI,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7B,mBAAmB,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,CAAC;AAC3C,CAAC"}

package/packages/engine/dist/catalox/record-history-field.d.ts

@@ -0,0 +1,23 @@
+import type { NativeCatalogItemRecord } from "@x12i/catalox-contracts/items.js";
+import type { CatalogItemHistoryEventV1, CatalogItemHistoryOp } from "@x12i/catalox-contracts/record-history.js";
+export type NormalizedRecordFieldPath = {
+    /** Path from `NativeCatalogItemRecord` root, e.g. `data.instructions`. */
+    recordPath: string;
+    /** How `restoreCatalogItemFieldFromHistory` applies the value. */
+    restoreVia: "data" | "indexed" | "unsupported";
+    /** Segments relative to `data` or `indexed` for patch building. */
+    patchRelativePath?: string;
+};
+/** Normalize a user field path. Bare names like `instructions` resolve under `data`. */
+export declare function normalizeRecordFieldPath(fieldPath: string): NormalizedRecordFieldPath;
+export declare function readRecordFieldPath(record: NativeCatalogItemRecord | null | undefined, recordPath: string): unknown;
+/** Deep-set `value` at `relativePath` inside a shallow-cloned object tree. */
+export declare function setAtRelativePath(base: Record<string, unknown>, relativePath: string, value: unknown): Record<string, unknown>;
+export declare function fieldValuesEqual(before: unknown, after: unknown): boolean;
+export declare function extractFieldChange(payload: CatalogItemHistoryEventV1, recordPath: string): {
+    beforeValue: unknown;
+    afterValue: unknown;
+    changed: boolean;
+};
+export declare function isItemFieldHistoryOp(op: CatalogItemHistoryOp): boolean;
+//# sourceMappingURL=record-history-field.d.ts.map

package/packages/engine/dist/catalox/record-history-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-history-field.d.ts","sourceRoot":"","sources":["../../src/catalox/record-history-field.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,KAAK,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAgBjH,MAAM,MAAM,yBAAyB,GAAG;IACtC,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,CAAC;IAC/C,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAIF,wFAAwF;AACxF,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,yBAAyB,CAyBrF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CASnH;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,OAAO,GACb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAazB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAEzE;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,EAClC,UAAU,EAAE,MAAM,GACjB;IAAE,WAAW,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAQjE;AAID,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,oBAAoB,GAAG,OAAO,CAEtE"}

package/packages/engine/dist/catalox/record-history-field.js.map

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

package/packages/engine/dist/catalox/record-history.d.ts

@@ -0,0 +1,53 @@
+import type { CatalogId } from "@x12i/catalox-contracts/ids.js";
+import type { NativeCatalogItemRecord } from "@x12i/catalox-contracts/items.js";
+import type { CatalogItemHistoryEventV1, CatalogItemHistoryIndexRecord, CatalogItemHistoryOp } from "@x12i/catalox-contracts/record-history.js";
+import type { CataloxContext } from "@x12i/catalox-contracts/context.js";
+import { CatalogItemHistoryStore } from "../firebase/catalog-item-history-store.js";
+import { type CataloxHelpersGcsClient } from "./backup-data.js";
+export type RecordHistoryDeps = {
+    store: CatalogItemHistoryStore;
+    gcsBucket: string;
+    /** Prefix without leading slash; no trailing slash (helpers client normalizes). */
+    gcsBasePrefix: string;
+    failClosed: boolean;
+};
+export declare function normalizeRecordHistoryGcsPrefix(raw: string | undefined): string;
+export declare function fingerprintNativeRecord(rec: NativeCatalogItemRecord | null | undefined): string | undefined;
+/** Relative object path under the record-history prefix. */
+export declare function buildRecordHistoryGcsRelativePath(params: {
+    catalogId: CatalogId;
+    op: CatalogItemHistoryOp;
+    itemId: string;
+    ts: string;
+}): string;
+export declare function buildRecordHistoryGcsClient(deps: RecordHistoryDeps): CataloxHelpersGcsClient;
+export type EmitRecordHistoryParams = {
+    catalogId: CatalogId;
+    itemId: string;
+    storageDocId?: string;
+    op: CatalogItemHistoryOp;
+    before?: NativeCatalogItemRecord | null;
+    after?: NativeCatalogItemRecord | null;
+    manifest?: Record<string, unknown>;
+};
+export type EmitRecordHistoryResult = {
+    ok: true;
+    eventId: string;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function emitRecordHistoryEvent(deps: RecordHistoryDeps, context: CataloxContext, params: EmitRecordHistoryParams): Promise<EmitRecordHistoryResult>;
+export declare function readRecordHistoryEventPayload(deps: RecordHistoryDeps, indexRow: CatalogItemHistoryIndexRecord): Promise<CatalogItemHistoryEventV1>;
+export declare function emitRecordHistoryEventWithCustomPath(deps: RecordHistoryDeps, context: CataloxContext, params: {
+    gcsRelativePath: string;
+    catalogId: CatalogId;
+    itemId: string;
+    storageDocId?: string;
+    op: CatalogItemHistoryOp;
+    before?: NativeCatalogItemRecord | null;
+    after?: NativeCatalogItemRecord | null;
+    manifest?: Record<string, unknown>;
+}): Promise<EmitRecordHistoryResult>;
+export declare function recordHistoryKeyForNativeRow(_catalogId: CatalogId, rec: NativeCatalogItemRecord): string;
+//# sourceMappingURL=record-history.d.ts.map

package/packages/engine/dist/catalox/record-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-history.d.ts","sourceRoot":"","sources":["../../src/catalox/record-history.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,KAAK,EACV,yBAAyB,EACzB,6BAA6B,EAC7B,oBAAoB,EACrB,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AAEpF,OAAO,EAAiC,KAAK,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AA8B/F,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,uBAAuB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI/E;AAgBD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,uBAAuB,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAG3G;AAMD,4DAA4D;AAC5D,wBAAgB,iCAAiC,CAAC,MAAM,EAAE;IACxD,SAAS,EAAE,SAAS,CAAC;IACrB,EAAE,EAAE,oBAAoB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;CACZ,GAAG,MAAM,CAQT;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,iBAAiB,GAAG,uBAAuB,CAE5F;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,oBAAoB,CAAC;IACzB,MAAM,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACxC,KAAK,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnG,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,uBAAuB,CAAC,CAuDlC;AAED,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,iBAAiB,EACvB,QAAQ,EAAE,6BAA6B,GACtC,OAAO,CAAC,yBAAyB,CAAC,CAMpC;AAED,wBAAsB,oCAAoC,CACxD,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE;IACN,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,oBAAoB,CAAC;IACzB,MAAM,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACxC,KAAK,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GACA,OAAO,CAAC,uBAAuB,CAAC,CA4ClC;AAED,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,EAAE,uBAAuB,GAAG,MAAM,CAExG"}