@x12i/memorix-retrieval 1.1.0

package/dist/tests/fixtures.js

@@ -0,0 +1,137 @@
+export const assetsEntity = {
+    id: "assets",
+    entityName: "assets",
+    target: "entity",
+    collectionPrefix: "assets",
+    identity: {
+        allowedIdFields: ["entityId", "eventId"],
+        requiredExactlyOne: true,
+        defaultIdField: "entityId",
+    },
+    defaults: {
+        canonicalContentType: "snapshots",
+        dataRoot: "data",
+        effectiveDatePath: "modifiedAt",
+        fallbackEffectiveDatePaths: ["capturedAt", "snapshot.capturedAt"],
+    },
+    contentDefaults: {
+        format: "markdown",
+        storage: {
+            provider: "gcs",
+            bucket: "memorix-content",
+            prefix: "assets",
+        },
+        maxBytes: 5242880,
+        encoding: "utf8",
+    },
+    contentTypes: {
+        snapshots: {
+            postfix: "snapshots",
+            collection: "assets-snapshots",
+            dataRoot: "data",
+            isCanonical: true,
+        },
+        analysis: {
+            postfix: "analysis",
+            collection: "assets-analysis",
+            dataRoot: "data",
+            isCanonical: false,
+        },
+    },
+    properties: {
+        ipAddress: {
+            label: "IP Address",
+            source: { contentType: "snapshots", path: "data.ip_address" },
+            humanReadable: true,
+            sortable: true,
+            filterable: true,
+            list: true,
+            item: true,
+            valueType: "string",
+        },
+        hostName: {
+            label: "Host Name",
+            source: { contentType: "snapshots", path: "data.xdr.host_name" },
+            humanReadable: true,
+            sortable: true,
+            filterable: true,
+            list: true,
+            item: true,
+            valueType: "string",
+        },
+        investigationReport: {
+            label: "Investigation Report",
+            source: { contentType: "analysis", path: "data.investigationReport" },
+            humanReadable: true,
+            list: true,
+            item: true,
+            valueType: "content",
+            content: {
+                enabled: true,
+                objectType: "memorix-content-object",
+                format: "markdown",
+                listBehavior: {
+                    returnPreview: true,
+                    returnMetadata: true,
+                    returnContentKey: false,
+                    fetchContent: false,
+                },
+                itemBehavior: {
+                    returnPreview: true,
+                    returnMetadata: true,
+                    returnContentKey: false,
+                    fetchContentWhenRequested: true,
+                },
+            },
+        },
+    },
+};
+export const assetsMainList = {
+    id: "assets-main-list",
+    entity: "assets",
+    title: "Assets",
+    leadingContentType: "snapshots",
+    pagination: { enabled: true, defaultLimit: 50, maxLimit: 200 },
+    fields: ["ipAddress", "hostName", "investigationReport"],
+    extensions: [
+        {
+            contentType: "analysis",
+            mode: "extendFields",
+            join: { by: "entityId" },
+            multiMatch: { strategy: "last", effectiveDatePath: "modifiedAt" },
+            onMissing: { includeRow: true },
+        },
+    ],
+    allowedSorts: ["ipAddress", "hostName"],
+    defaultSort: { property: "ipAddress", direction: "asc" },
+    allowSortDrivenLeadingOverride: false,
+};
+export const assetDetailItem = {
+    id: "asset-detail-item",
+    entity: "assets",
+    title: "Asset Detail",
+    identity: { idField: "entityId" },
+    contentTypes: [
+        {
+            contentType: "snapshots",
+            required: true,
+            multiMatch: { strategy: "last", effectiveDatePath: "modifiedAt" },
+        },
+        {
+            contentType: "analysis",
+            required: false,
+            multiMatch: { strategy: "last", effectiveDatePath: "modifiedAt" },
+        },
+    ],
+    sections: [
+        { id: "summary", title: "Summary", fields: ["ipAddress", "hostName"] },
+        { id: "reports", title: "Reports", fields: ["investigationReport"] },
+    ],
+    content: {
+        allowed: true,
+        defaultIncludeFullContent: false,
+        allowedFields: ["investigationReport"],
+        maxBytes: 5242880,
+    },
+};
+//# sourceMappingURL=fixtures.js.map

package/dist/tests/fixtures.js.map

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

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

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

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

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

package/dist/tests/identity.test.js

@@ -0,0 +1,32 @@
+import { describe, expect, it } from "vitest";
+import { assertRequestIdentity, validateMemorixIdentity, } from "../data/identity.js";
+import { MemorixRetrievalError } from "../errors/errors.js";
+describe("identity", () => {
+    it("accepts entityId only", () => {
+        const r = validateMemorixIdentity({ entityId: "a1" });
+        expect(r.ok).toBe(true);
+        if (r.ok)
+            expect(r.identity.entityId).toBe("a1");
+    });
+    it("accepts eventId only", () => {
+        const r = validateMemorixIdentity({ eventId: "e1" });
+        expect(r.ok).toBe(true);
+        if (r.ok)
+            expect(r.identity.eventId).toBe("e1");
+    });
+    it("rejects both ids", () => {
+        const r = validateMemorixIdentity({ entityId: "a", eventId: "e" });
+        expect(r.ok).toBe(false);
+        if (!r.ok)
+            expect(r.issue.code).toBe("INVALID_IDENTITY");
+    });
+    it("rejects neither id", () => {
+        const r = validateMemorixIdentity({ foo: "bar" });
+        expect(r.ok).toBe(false);
+    });
+    it("assertRequestIdentity throws on invalid request", () => {
+        expect(() => assertRequestIdentity("a", "e")).toThrow(MemorixRetrievalError);
+        expect(() => assertRequestIdentity()).toThrow(MemorixRetrievalError);
+    });
+});
+//# sourceMappingURL=identity.test.js.map

package/dist/tests/identity.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.test.js","sourceRoot":"","sources":["../../src/tests/identity.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,CAAC,GAAG,uBAAuB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,CAAC,EAAE;YAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,GAAG,uBAAuB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,CAAC,EAAE;YAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAC1B,MAAM,CAAC,GAAG,uBAAuB,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;QACnE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,CAAC,CAAC,CAAC,EAAE;YAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAC5B,MAAM,CAAC,GAAG,uBAAuB,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;QAClD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,GAAG,EAAE,CAAC,qBAAqB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;QAC7E,MAAM,CAAC,GAAG,EAAE,CAAC,qBAAqB,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tests/multi-match.test.d.ts

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

package/dist/tests/multi-match.test.d.ts.map

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

package/dist/tests/multi-match.test.js

@@ -0,0 +1,31 @@
+import { describe, expect, it } from "vitest";
+import { applyMultiMatch } from "../data/multi-match.js";
+import { assetsEntity } from "./fixtures.js";
+describe("multi-match", () => {
+    const records = [
+        { entityId: "1", modifiedAt: "2026-01-01T00:00:00Z" },
+        { entityId: "1", modifiedAt: "2026-03-01T00:00:00Z" },
+        { entityId: "1", modifiedAt: "2026-02-01T00:00:00Z" },
+    ];
+    it("picks last by effective date", () => {
+        const r = applyMultiMatch(records, { strategy: "last" }, assetsEntity);
+        expect(r.ok).toBe(true);
+        if (r.ok) {
+            expect(r.records).toHaveLength(1);
+            expect(r.records[0].modifiedAt).toBe("2026-03-01T00:00:00Z");
+        }
+    });
+    it("returns all for strategy all", () => {
+        const r = applyMultiMatch(records, { strategy: "all" }, assetsEntity);
+        expect(r.ok).toBe(true);
+        if (r.ok)
+            expect(r.records).toHaveLength(3);
+    });
+    it("errors on multiple when strategy error", () => {
+        const r = applyMultiMatch(records, { strategy: "error" }, assetsEntity);
+        expect(r.ok).toBe(false);
+        if (!r.ok)
+            expect(r.issue.code).toBe("MULTI_MATCH_ERROR");
+    });
+});
+//# sourceMappingURL=multi-match.test.js.map

package/dist/tests/multi-match.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-match.test.js","sourceRoot":"","sources":["../../src/tests/multi-match.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,MAAM,OAAO,GAAG;QACd,EAAE,QAAQ,EAAE,GAAG,EAAE,UAAU,EAAE,sBAAsB,EAAE;QACrD,EAAE,QAAQ,EAAE,GAAG,EAAE,UAAU,EAAE,sBAAsB,EAAE;QACrD,EAAE,QAAQ,EAAE,GAAG,EAAE,UAAU,EAAE,sBAAsB,EAAE;KACtD,CAAC;IAEF,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,GAAG,eAAe,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC;QACvE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC;YACT,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAClC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAChE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,GAAG,eAAe,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,YAAY,CAAC,CAAC;QACtE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,CAAC,EAAE;YAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,GAAG,eAAe,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;QACxE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,CAAC,CAAC,CAAC,EAAE;YAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tests/read-collection.test.d.ts

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

package/dist/tests/read-collection.test.d.ts.map

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

package/dist/tests/read-collection.test.js

@@ -0,0 +1,19 @@
+import { describe, expect, it } from "vitest";
+import { sanitizeProjectionPaths } from "../mongo/read-collection.js";
+describe("sanitizeProjectionPaths", () => {
+    it("removes parent paths when descendants are included", () => {
+        expect(sanitizeProjectionPaths([
+            "entityId",
+            "data",
+            "data.ip_address",
+            "data.xdr.host_name",
+        ])).toEqual(["entityId", "data.ip_address", "data.xdr.host_name"]);
+    });
+    it("keeps parent path when no descendants are included", () => {
+        expect(sanitizeProjectionPaths(["entityId", "data"])).toEqual([
+            "entityId",
+            "data",
+        ]);
+    });
+});
+//# sourceMappingURL=read-collection.test.js.map

package/dist/tests/read-collection.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-collection.test.js","sourceRoot":"","sources":["../../src/tests/read-collection.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,CACJ,uBAAuB,CAAC;YACtB,UAAU;YACV,MAAM;YACN,iBAAiB;YACjB,oBAAoB;SACrB,CAAC,CACH,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,iBAAiB,EAAE,oBAAoB,CAAC,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,CAAC,uBAAuB,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YAC5D,UAAU;YACV,MAAM;SACP,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tests/relations.test.d.ts

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

package/dist/tests/relations.test.d.ts.map

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

package/dist/tests/relations.test.js

@@ -0,0 +1,77 @@
+import { describe, expect, it, vi } from "vitest";
+import { createMemorixRetrieval } from "../client/create-client.js";
+import { MEMORIX_ENTITY_DESCRIPTORS_CATALOG } from "../descriptors/catalog-ids.js";
+import { fetchRelationsForItem } from "../relations/resolve-relations.js";
+import { assetsEntity } from "./fixtures.js";
+const entityWithRelation = {
+    ...assetsEntity,
+    relations: {
+        owner: {
+            targetEntity: "users",
+            type: "manyToOne",
+            source: { contentType: "snapshots", path: "data.ownerId" },
+            target: { contentType: "snapshots", path: "entityId" },
+            targetFields: ["data.displayName"],
+        },
+    },
+};
+describe("relations", () => {
+    it("fetches related records by descriptor join", async () => {
+        const getCatalogItem = vi.fn(async (_ctx, catalogId, itemId) => {
+            if (catalogId === MEMORIX_ENTITY_DESCRIPTORS_CATALOG && itemId === "users") {
+                return {
+                    outcome: "found",
+                    item: {
+                        data: {
+                            ...entityWithRelation,
+                            id: "users",
+                            entityName: "users",
+                            collectionPrefix: "users",
+                            contentTypes: {
+                                snapshots: {
+                                    postfix: "snapshots",
+                                    collection: "users-snapshots",
+                                    dataRoot: "data",
+                                },
+                            },
+                            properties: {},
+                        },
+                    },
+                };
+            }
+            if (itemId === "assets") {
+                return { outcome: "found", item: { data: entityWithRelation } };
+            }
+            return { outcome: "not_found" };
+        });
+        const xronoxRead = vi.fn(async (params) => {
+            if (params.source === "users-snapshots") {
+                return [{ entityId: "user-1", data: { displayName: "Alice" } }];
+            }
+            return [];
+        });
+        const client = createMemorixRetrieval({
+            catalox: { getCatalogItem },
+            xronox: { read: xronoxRead, readArray: xronoxRead },
+        });
+        const recordsByContentType = {
+            snapshots: [
+                {
+                    entityId: "10.0.0.1",
+                    data: { ownerId: "user-1", ip_address: "10.0.0.1" },
+                },
+            ],
+        };
+        const issues = [];
+        const relations = await fetchRelationsForItem(client, entityWithRelation, {
+            id: "asset-detail-item",
+            entity: "assets",
+            identity: { idField: "entityId" },
+            contentTypes: [],
+            sections: [],
+            includeRelations: [{ relation: "owner" }],
+        }, recordsByContentType, ["owner"], issues);
+        expect(relations.owner).toEqual({ "data.displayName": "Alice" });
+    });
+});
+//# sourceMappingURL=relations.test.js.map

package/dist/tests/relations.test.js.map

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