@x12i/catalox 4.2.1 → 5.0.0

package/dist/src/catalox/item-scope-match.js

@@ -0,0 +1,114 @@
+import { isGenericScope, normalizeItemScope } from "./item-scope.js";
+function intersectArrays(a, b) {
+    const set = new Set(b);
+    return a.filter((x) => set.has(x));
+}
+function unionScopeKeys(...scopes) {
+    const keys = new Set();
+    for (const s of scopes) {
+        for (const k of Object.keys(s))
+            keys.add(k);
+    }
+    return [...keys];
+}
+/**
+ * Merge token scope (authorization boundary) with fetch scope (request narrowing).
+ * Fetch never expands beyond token; shared dimensions are intersected.
+ */
+export function mergeEffectiveScope(tokenScope, fetchScope, opts) {
+    const token = normalizeItemScope(tokenScope ?? {});
+    const fetch = normalizeItemScope(fetchScope ?? {});
+    const unrestricted = opts?.unrestricted === true;
+    if (unrestricted) {
+        const effectiveScope = {};
+        for (const dim of unionScopeKeys(token, fetch)) {
+            const t = token[dim];
+            const f = fetch[dim];
+            if (t?.length && f?.length) {
+                const inter = intersectArrays(t, f);
+                if (inter.length)
+                    effectiveScope[dim] = inter;
+                else
+                    effectiveScope[dim] = [];
+            }
+            else if (f?.length)
+                effectiveScope[dim] = f;
+            else if (t?.length)
+                effectiveScope[dim] = t;
+        }
+        return { effectiveScope, scopedAccessAllowed: true };
+    }
+    const tokenEmpty = isGenericScope(token);
+    const fetchEmpty = isGenericScope(fetch);
+    if (tokenEmpty && fetchEmpty) {
+        return { effectiveScope: {}, scopedAccessAllowed: false };
+    }
+    if (tokenEmpty && !fetchEmpty) {
+        return { effectiveScope: {}, scopedAccessAllowed: false };
+    }
+    const effectiveScope = { ...token };
+    for (const dim of unionScopeKeys(token, fetch)) {
+        const t = token[dim];
+        const f = fetch[dim];
+        if (t?.length && f?.length) {
+            const inter = intersectArrays(t, f);
+            effectiveScope[dim] = inter;
+        }
+        else if (f?.length) {
+            effectiveScope[dim] = f;
+        }
+        else if (t?.length) {
+            effectiveScope[dim] = t;
+        }
+    }
+    const hasEmptyIntersection = Object.values(effectiveScope).some((v) => v.length === 0);
+    if (hasEmptyIntersection) {
+        return { effectiveScope, scopedAccessAllowed: false };
+    }
+    return { effectiveScope, scopedAccessAllowed: true };
+}
+export function itemMatchesEffectiveScope(itemScope, effectiveScope) {
+    const item = normalizeItemScope(itemScope);
+    const eff = normalizeItemScope(effectiveScope);
+    if (isGenericScope(eff))
+        return !isGenericScope(item);
+    if (isGenericScope(item))
+        return false;
+    for (const [dimension, requested] of Object.entries(eff)) {
+        if (!requested?.length)
+            continue;
+        const itemValues = item[dimension];
+        if (!itemValues?.length)
+            return false;
+        if (!requested.some((v) => itemValues.includes(v)))
+            return false;
+    }
+    return true;
+}
+export function resolveCatalogScopeFetchMode(options) {
+    const genericOnly = options?.genericOnly === true;
+    const scopedOnly = options?.scopedOnly === true || options?.includeGeneric === false;
+    const includeGeneric = genericOnly ? false : scopedOnly ? false : options?.includeGeneric !== false;
+    return { includeGeneric, genericOnly, scopedOnly };
+}
+export function shouldIncludeItemInList(params) {
+    const { itemScope, effectiveScope, scopedAccessAllowed, fetchMode } = params;
+    const item = normalizeItemScope(itemScope);
+    const generic = isGenericScope(item);
+    if (fetchMode.genericOnly)
+        return generic;
+    if (generic) {
+        return fetchMode.includeGeneric;
+    }
+    if (!scopedAccessAllowed)
+        return false;
+    return itemMatchesEffectiveScope(item, effectiveScope);
+}
+/** Build token scope from context.scope only (not singular legacy coords). */
+export function tokenScopeFromContext(context) {
+    return normalizeItemScope(context.scope ?? {});
+}
+export function isUnrestrictedScopeContext(context) {
+    return context.superAdmin === true || context.unrestrictedScope === true;
+}
+//# sourceMappingURL=item-scope-match.js.map

package/dist/src/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":"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"}

package/dist/src/catalox/item-scope.d.ts

@@ -0,0 +1,36 @@
+import type { CatalogItemScope } from "../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/dist/src/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,uBAAuB,CAAC;AAI9D,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/dist/src/catalox/item-scope.js

@@ -0,0 +1,137 @@
+import { CatalogValidationError } from "../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/dist/src/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/dist/src/catalox/native-catalog-merge.d.ts

@@ -1,12 +1,10 @@
 import type { CatalogIdentityDescriptor } from "../contracts/descriptors.js";
-import type { CatalogFetchScope } from "../contracts/catalogs.js";
+import type { CatalogItemScope } from "../contracts/items.js";
 import type { NativeCatalogItemRecord, UnifiedCatalogItem } from "../contracts/items.js";
-export declare function toUnifiedNativeItem(r: NativeCatalogItemRecord, appId: string, includeStoredScope: boolean): UnifiedCatalogItem;
-/**
- * Filters physical rows for a tenant fetch (globals always kept).
- */
-export declare function filterPhysicalForTenantFetch(records: NativeCatalogItemRecord[], fetch: CatalogFetchScope): NativeCatalogItemRecord[];
-/** For updates/deletes: choose the most specific physical row matching optional tenant fetch, else global. */
-export declare function pickWinningPhysicalRow(rows: NativeCatalogItemRecord[], fetch?: CatalogFetchScope): NativeCatalogItemRecord | null;
-export declare function mergeNativePhysicalRows(records: NativeCatalogItemRecord[], identity: CatalogIdentityDescriptor, appId: string, superAdminList: boolean): UnifiedCatalogItem[];
+export declare function toUnifiedNativeItem(r: NativeCatalogItemRecord, appId: string, includeScopeInResponse: boolean): 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): 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/dist/src/catalox/native-catalog-merge.d.ts.map

@@ -1 +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,6BAA6B,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAiCzF,wBAAgB,mBAAmB,CACjC,CAAC,EAAE,uBAAuB,EAC1B,KAAK,EAAE,MAAM,EACb,kBAAkB,EAAE,OAAO,GAC1B,kBAAkB,CAgBpB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,uBAAuB,EAAE,EAClC,KAAK,EAAE,iBAAiB,GACvB,uBAAuB,EAAE,CAM3B;AAED,8GAA8G;AAC9G,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,uBAAuB,EAAE,EAC/B,KAAK,CAAC,EAAE,iBAAiB,GACxB,uBAAuB,GAAG,IAAI,CAoBhC;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,uBAAuB,EAAE,EAClC,QAAQ,EAAE,yBAAyB,EACnC,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,OAAO,GACtB,kBAAkB,EAAE,CAmDtB"}
+{"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,6BAA6B,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAGzF,wBAAgB,mBAAmB,CACjC,CAAC,EAAE,uBAAuB,EAC1B,KAAK,EAAE,MAAM,EACb,sBAAsB,EAAE,OAAO,GAC9B,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,GACtB,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/dist/src/catalox/native-catalog-merge.js

@@ -1,33 +1,11 @@
-import { isGlobalPhysicalRow, mergeIdentityKey, normalizeStoredScope, physicalRowMatchesFetchScope, resolveMergeIdentityMode, scopeFromRecordField, shallowMergeData, } from "./native-scope.js";
-function layerRank(scope) {
-    const s = normalizeStoredScope(scope);
-    if (s.kind === "global")
-        return 0;
-    if (s.kind === "scoped") {
-        const t = s.tenant;
-        const a = s.agent;
-        const count = Number(Boolean(t?.accountId)) +
-            Number(Boolean(t?.groupId)) +
-            Number(Boolean(t?.userId)) +
-            Number(Boolean(t?.channelId)) +
-            Number(Boolean(t?.visitorId)) +
-            Number(Boolean(a?.domainId)) +
-            Number(Boolean(a?.agentId));
-        // scoped rows are more specific than legacy account, but order within scoped is by specificity.
-        return 10 + count;
-    }
-    if (s.kind === "account")
-        return 1;
-    if (s.kind === "agent")
-        return 2;
-    return 3;
-}
-export function toUnifiedNativeItem(r, appId, includeStoredScope) {
+import { isGenericScope, metadataFromScope, scopeFromRecordField } from "./item-scope.js";
+export function toUnifiedNativeItem(r, appId, includeScopeInResponse) {
+    const itemScope = scopeFromRecordField(r.scope);
+    const metaDisplay = metadataFromScope(itemScope);
     const meta = {
         ...(r.metadata && typeof r.metadata === "object" ? r.metadata : {}),
-        ...(includeStoredScope ? { scope: r.scope ?? { kind: "global" } } : {}),
-        ...(r.metadata?.domainIds == null ? { domainIds: [] } : {}),
-        ...(r.metadata?.agentIds == null ? { agentIds: [] } : {}),
+        domainIds: metaDisplay.domainIds,
+        agentIds: metaDisplay.agentIds,
     };
     return {
         itemId: r.itemId,
@@ -36,88 +14,27 @@ export function toUnifiedNativeItem(r, appId, includeStoredScope) {
         sourceMode: "native",
         sourceType: "firebase",
         data: r.data,
+        ...(includeScopeInResponse ? { scope: itemScope } : {}),
         metadata: meta,
     };
 }
-/**
- * Filters physical rows for a tenant fetch (globals always kept).
- */
-export function filterPhysicalForTenantFetch(records, fetch) {
-    return records.filter((r) => {
-        const sc = scopeFromRecordField(r.scope);
-        if (normalizeStoredScope(sc).kind === "global")
-            return true;
-        return physicalRowMatchesFetchScope(sc, fetch);
-    });
-}
-/** For updates/deletes: choose the most specific physical row matching optional tenant fetch, else global. */
-export function pickWinningPhysicalRow(rows, fetch) {
-    if (!rows.length)
-        return null;
-    const hasScope = Boolean(fetch?.accountId) ||
-        Boolean(fetch?.groupId) ||
-        Boolean(fetch?.userId) ||
-        Boolean(fetch?.channelId) ||
-        Boolean(fetch?.visitorId) ||
-        Boolean(fetch?.domainId) ||
-        Boolean(fetch?.agentId);
-    if (!hasScope) {
-        const g = rows.filter((r) => isGlobalPhysicalRow(r));
-        return g[0] ?? rows[0] ?? null;
+/** One physical row per logical itemId after flexible scope migration. */
+export function mergeNativePhysicalRows(records, _identity, appId, includeScopeInResponse, _superListAll) {
+    const byItem = new Map();
+    for (const r of records) {
+        const id = String(r.itemId);
+        if (!byItem.has(id))
+            byItem.set(id, r);
     }
-    const matched = filterPhysicalForTenantFetch(rows, fetch);
-    if (!matched.length)
-        return null;
-    const sorted = [...matched].sort((a, b) => layerRank(scopeFromRecordField(a.scope)) - layerRank(scopeFromRecordField(b.scope)));
-    return sorted[sorted.length - 1] ?? null;
+    return [...byItem.values()].map((r) => toUnifiedNativeItem(r, appId, includeScopeInResponse));
 }
-export function mergeNativePhysicalRows(records, identity, appId, superAdminList) {
-    if (superAdminList) {
-        return records.map((r) => toUnifiedNativeItem(r, appId, true));
-    }
-    const mode = resolveMergeIdentityMode(identity);
-    const sorted = [...records].sort((a, b) => layerRank(scopeFromRecordField(a.scope)) - layerRank(scopeFromRecordField(b.scope)));
-    if (mode === "none") {
-        return sorted.map((r) => toUnifiedNativeItem(r, appId, false));
-    }
-    const groups = new Map();
-    for (const r of sorted) {
-        const key = mergeIdentityKey(identity, r.data, r.indexed) ??
-            `${r.itemId}@${JSON.stringify(normalizeStoredScope(scopeFromRecordField(r.scope)))}`;
-        const g = groups.get(key);
-        if (g)
-            g.push(r);
-        else
-            groups.set(key, [r]);
-    }
-    const out = [];
-    for (const group of groups.values()) {
-        let data = {};
-        let itemId = group[0].itemId;
-        let catalogId = group[0].catalogId;
-        let createdAt = String(group[0].metadata?.createdAt ?? "");
-        let lastUpdate = String(group[0].metadata?.lastUpdate ?? "");
-        for (const r of group) {
-            data = shallowMergeData(data, r.data);
-            const rc = String(r.metadata?.createdAt ?? "");
-            const ru = String(r.metadata?.lastUpdate ?? "");
-            if (ru && (!lastUpdate || ru > lastUpdate))
-                lastUpdate = ru;
-            if (rc && (!createdAt || rc < createdAt))
-                createdAt = rc;
-            itemId = r.itemId;
-            catalogId = r.catalogId;
-        }
-        out.push({
-            itemId,
-            catalogId,
-            appId,
-            sourceMode: "native",
-            sourceType: "firebase",
-            data,
-            metadata: { createdAt, lastUpdate },
-        });
-    }
-    return out;
+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/dist/src/catalox/native-catalog-merge.js.map

@@ -1 +1 @@
-{"version":3,"file":"native-catalog-merge.js","sourceRoot":"","sources":["../../../src/catalox/native-catalog-merge.ts"],"names":[],"mappings":"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"}
+{"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;IAE/B,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;QACtB,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;IAEvB,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,CAAC,CAAC,CAAC;AAChG,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/dist/src/catalox/scope-legacy-convert.d.ts

@@ -0,0 +1,19 @@
+import type { CatalogItemScope } from "../contracts/items.js";
+/** Decode legacy `cx~` storage document ids (migration only). */
+export declare function decodeNativeItemStorageDocId(docId: string): {
+    logicalItemId: string;
+    legacyScope: unknown;
+} | null;
+/**
+ * Convert legacy stored scope + metadata tags to flexible scope (migration / allowLegacy reads).
+ */
+export declare function convertLegacyScopeToFlexible(scope: unknown, metadata?: Record<string, unknown>): CatalogItemScope;
+export type ScopeMappingFile = Record<string, {
+    domains?: string[];
+    agents?: string[];
+}>;
+export declare function applyAgentScopeMapping(scope: CatalogItemScope, accountId: string, agentId: string, mapping?: ScopeMappingFile): CatalogItemScope;
+/** Stable fingerprint for migration payload equivalence checks. */
+export declare function payloadFingerprint(data: Record<string, unknown>): string;
+export declare function unionFlexibleScopes(scopes: CatalogItemScope[]): CatalogItemScope;
+//# sourceMappingURL=scope-legacy-convert.d.ts.map

package/dist/src/catalox/scope-legacy-convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-legacy-convert.d.ts","sourceRoot":"","sources":["../../../src/catalox/scope-legacy-convert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAS9D,iEAAiE;AACjE,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,MAAM,GACZ;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CA4CxD;AAiBD;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,EACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,gBAAgB,CAgElB;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC;AAEzF,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,gBAAgB,EACvB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,gBAAgB,GACzB,gBAAgB,CASlB;AAED,mEAAmE;AACnE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAExE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,CAQhF"}