@x12i/catalox 2.7.0 → 3.1.1

package/dist/test/unit/native-catalog-merge.test.js

@@ -0,0 +1,33 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { mergeNativePhysicalRows, pickWinningPhysicalRow } from "../../src/catalox/native-catalog-merge.js";
+const compositeIdentity = {
+    itemIdStrategy: "composite",
+    compositeFields: ["categoryId", "code"],
+};
+function row(scope, data, itemId = "core:S1") {
+    return {
+        itemId,
+        catalogId: "c1",
+        data,
+        createdAt: "2020-01-01T00:00:00.000Z",
+        updatedAt: "2020-01-02T00:00:00.000Z",
+        ...(scope != null ? { scope } : {}),
+        indexed: { scopeLayer: "global" },
+    };
+}
+test("mergeNativePhysicalRows overlays user over global by composite identity", () => {
+    const g = row({ kind: "global" }, { categoryId: "core", code: "S1", title: "Global" });
+    const u = row({ kind: "user", accountId: "a1", userId: "u1" }, { categoryId: "core", code: "S1", title: "User" }, "core:S1");
+    u.indexed = { scopeLayer: "user", scopeAccountId: "a1", scopeUserId: "u1" };
+    const merged = mergeNativePhysicalRows([g, u], compositeIdentity, "app1", false);
+    assert.equal(merged.length, 1);
+    assert.equal(merged[0].data.title, "User");
+});
+test("pickWinningPhysicalRow prefers user scoped row", () => {
+    const g = row({ kind: "global" }, { x: 1 });
+    const u = row({ kind: "user", accountId: "a1", userId: "u1" }, { x: 2 });
+    const w = pickWinningPhysicalRow([g, u], { accountId: "a1", userId: "u1" });
+    assert.equal(w?.scope?.kind, "user");
+});
+//# sourceMappingURL=native-catalog-merge.test.js.map

package/dist/test/unit/native-catalog-merge.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-catalog-merge.test.js","sourceRoot":"","sources":["../../../test/unit/native-catalog-merge.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAExC,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAI5G,MAAM,iBAAiB,GAA8B;IACnD,cAAc,EAAE,WAAW;IAC3B,eAAe,EAAE,CAAC,YAAY,EAAE,MAAM,CAAC;CACxC,CAAC;AAEF,SAAS,GAAG,CACV,KAAuC,EACvC,IAA6B,EAC7B,MAAM,GAAG,SAAS;IAElB,OAAO;QACL,MAAM;QACN,SAAS,EAAE,IAAI;QACf,IAAI;QACJ,SAAS,EAAE,0BAA0B;QACrC,SAAS,EAAE,0BAA0B;QACrC,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE;KAClC,CAAC;AACJ,CAAC;AAED,IAAI,CAAC,yEAAyE,EAAE,GAAG,EAAE;IACnF,MAAM,CAAC,GAAG,GAAG,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IACvF,MAAM,CAAC,GAAG,GAAG,CACX,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAC/C,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EACjD,SAAS,CACV,CAAC;IACF,CAAC,CAAC,OAAO,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC5E,MAAM,MAAM,GAAG,uBAAuB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,iBAAiB,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACjF,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC/B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAC9C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,gDAAgD,EAAE,GAAG,EAAE;IAC1D,MAAM,CAAC,GAAG,GAAG,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAC5C,MAAM,CAAC,GAAG,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACzE,MAAM,CAAC,GAAG,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5E,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC,CAAC,CAAC"}

package/dist/test/unit/native-scope.test.d.ts

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

package/dist/test/unit/native-scope.test.d.ts.map

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

package/dist/test/unit/native-scope.test.js

@@ -0,0 +1,29 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { assertSuperAdminForNonGlobalScope, decodeNativeItemStorageDocId, encodeNativeItemStorageDocId, physicalRowMatchesFetchScope, } from "../../src/catalox/native-scope.js";
+import { CatalogAccessDeniedError } from "../../src/contracts/errors.js";
+test("encode/decode roundtrip for account scope", () => {
+    const logical = "core:S1";
+    const scope = { kind: "account", accountId: "acc1" };
+    const id = encodeNativeItemStorageDocId(logical, scope);
+    const dec = decodeNativeItemStorageDocId(id);
+    assert.ok(dec);
+    assert.equal(dec.logicalItemId, logical);
+    assert.deepEqual(dec.scope, scope);
+});
+test("global scope uses logical id as storage doc id", () => {
+    const id = encodeNativeItemStorageDocId("x:y", { kind: "global" });
+    assert.equal(id, "x:y");
+    assert.deepEqual(decodeNativeItemStorageDocId("x:y"), { logicalItemId: "x:y", scope: { kind: "global" } });
+});
+test("physicalRowMatchesFetchScope for account audience", () => {
+    const row = { kind: "account", accountId: "a1", agentIds: ["ag1"] };
+    assert.equal(physicalRowMatchesFetchScope(row, { accountId: "a1", agentId: "ag1" }), true);
+    assert.equal(physicalRowMatchesFetchScope(row, { accountId: "a1" }), false);
+});
+test("assertSuperAdminForNonGlobalScope throws without superAdmin", () => {
+    assert.throws(() => assertSuperAdminForNonGlobalScope(false, { kind: "account", accountId: "x" }), (e) => e instanceof CatalogAccessDeniedError);
+    assert.doesNotThrow(() => assertSuperAdminForNonGlobalScope(true, { kind: "account", accountId: "x" }));
+    assert.doesNotThrow(() => assertSuperAdminForNonGlobalScope(false, { kind: "global" }));
+});
+//# sourceMappingURL=native-scope.test.js.map

package/dist/test/unit/native-scope.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-scope.test.js","sourceRoot":"","sources":["../../../test/unit/native-scope.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAExC,OAAO,EACL,iCAAiC,EACjC,4BAA4B,EAC5B,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,IAAI,CAAC,2CAA2C,EAAE,GAAG,EAAE;IACrD,MAAM,OAAO,GAAG,SAAS,CAAC;IAC1B,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,SAAkB,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAC9D,MAAM,EAAE,GAAG,4BAA4B,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACxD,MAAM,GAAG,GAAG,4BAA4B,CAAC,EAAE,CAAC,CAAC;IAC7C,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACf,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACzC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACrC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,gDAAgD,EAAE,GAAG,EAAE;IAC1D,MAAM,EAAE,GAAG,4BAA4B,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IACnE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACxB,MAAM,CAAC,SAAS,CAAC,4BAA4B,CAAC,KAAK,CAAC,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC7G,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,mDAAmD,EAAE,GAAG,EAAE;IAC7D,MAAM,GAAG,GAAG,EAAE,IAAI,EAAE,SAAkB,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;IAC7E,MAAM,CAAC,KAAK,CAAC,4BAA4B,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;IAC3F,MAAM,CAAC,KAAK,CAAC,4BAA4B,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;AAC9E,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,6DAA6D,EAAE,GAAG,EAAE;IACvE,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CAAC,iCAAiC,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,EACnF,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,wBAAwB,CAC7C,CAAC;IACF,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,iCAAiC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IACxG,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,iCAAiC,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;AAC1F,CAAC,CAAC,CAAC"}

package/dist/test/unit/record-history-path.test.d.ts

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

package/dist/test/unit/record-history-path.test.d.ts.map

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

package/dist/test/unit/record-history-path.test.js

@@ -0,0 +1,24 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { buildRecordHistoryGcsRelativePath, fingerprintNativeRecord } from "../../src/catalox/record-history.js";
+test("buildRecordHistoryGcsRelativePath encodes date segments and op", () => {
+    const rel = buildRecordHistoryGcsRelativePath({
+        catalogId: "signals",
+        op: "update",
+        itemId: "a:b",
+        ts: "2026-04-19T12:00:00.000Z",
+    });
+    assert.match(rel, /^records\/signals\/2026\/04\/19\//);
+    assert.match(rel, /__update__[a-f0-9]{16}\.ndjson$/);
+});
+test("fingerprintNativeRecord is stable for same record", () => {
+    const rec = {
+        itemId: "x",
+        catalogId: "c",
+        data: { n: 1 },
+        createdAt: "t0",
+        updatedAt: "t1",
+    };
+    assert.equal(fingerprintNativeRecord(rec), fingerprintNativeRecord({ ...rec }));
+});
+//# sourceMappingURL=record-history-path.test.js.map

package/dist/test/unit/record-history-path.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-history-path.test.js","sourceRoot":"","sources":["../../../test/unit/record-history-path.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAExC,OAAO,EAAE,iCAAiC,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAEjH,IAAI,CAAC,gEAAgE,EAAE,GAAG,EAAE;IAC1E,MAAM,GAAG,GAAG,iCAAiC,CAAC;QAC5C,SAAS,EAAE,SAAS;QACpB,EAAE,EAAE,QAAQ;QACZ,MAAM,EAAE,KAAK;QACb,EAAE,EAAE,0BAA0B;KAC/B,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,mCAAmC,CAAC,CAAC;IACvD,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,iCAAiC,CAAC,CAAC;AACvD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,mDAAmD,EAAE,GAAG,EAAE;IAC7D,MAAM,GAAG,GAAG;QACV,MAAM,EAAE,GAAG;QACX,SAAS,EAAE,GAAG;QACd,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;QACd,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,IAAI;KAChB,CAAC;IACF,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,GAAG,CAAC,EAAE,uBAAuB,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;AAClF,CAAC,CAAC,CAAC"}

package/firestore.indexes.json

@@ -0,0 +1,39 @@
+{
+  "indexes": [
+    {
+      "collectionGroup": "catalogItemHistory",
+      "queryScope": "COLLECTION",
+      "fields": [
+        { "fieldPath": "catalogId", "order": "ASCENDING" },
+        { "fieldPath": "ts", "order": "DESCENDING" }
+      ]
+    },
+    {
+      "collectionGroup": "catalogItemHistory",
+      "queryScope": "COLLECTION",
+      "fields": [
+        { "fieldPath": "catalogId", "order": "ASCENDING" },
+        { "fieldPath": "itemId", "order": "ASCENDING" },
+        { "fieldPath": "ts", "order": "DESCENDING" }
+      ]
+    },
+    {
+      "collectionGroup": "catalogItemHistory",
+      "queryScope": "COLLECTION",
+      "fields": [
+        { "fieldPath": "catalogId", "order": "ASCENDING" },
+        { "fieldPath": "op", "order": "ASCENDING" },
+        { "fieldPath": "ts", "order": "DESCENDING" }
+      ]
+    },
+    {
+      "collectionGroup": "catalogItemHistory",
+      "queryScope": "COLLECTION",
+      "fields": [
+        { "fieldPath": "catalogId", "order": "ASCENDING" },
+        { "fieldPath": "ts", "order": "ASCENDING" }
+      ]
+    }
+  ],
+  "fieldOverrides": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x12i/catalox",
-  "version": "2.7.0",
+  "version": "3.1.1",
   "description": "Catalox: Firebase-native catalog metadata + unification package.",
   "license": "MIT",
   "private": false,
@@ -22,19 +22,36 @@
   ],
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    },
+    "./embedder": {
+      "types": "./dist/src/embedder.d.ts",
+      "default": "./dist/src/embedder.js"
+    },
+    "./operator": {
+      "types": "./dist/src/operator.d.ts",
+      "default": "./dist/src/operator.js"
+    },
+    "./mapping": {
+      "types": "./dist/src/mapping/index.d.ts",
+      "default": "./dist/src/mapping/index.js"
+    },
+    "./firebase": {
+      "types": "./dist/src/firebase/index.d.ts",
+      "default": "./dist/src/firebase/index.js"
     }
   },
   "bin": {
     "catalox": "./dist/src/cli/index.js"
   },
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
   "files": [
     "dist",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "firestore.indexes.json"
   ],
   "scripts": {
     "cli": "node dist/src/cli/index.js",