@x12i/memorix-retrieval 1.1.0

package/dist/retrieval/resolve-filters.js.map

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

package/dist/retrieval/resolve-pagination-driver.d.ts

@@ -0,0 +1,6 @@
+import type { MemorixEntityDescriptor, MemorixListDescriptor } from "../descriptors/descriptor-types.js";
+import type { ResolvedSort } from "./resolve-sort.js";
+export declare function resolvePaginationDriver(list: MemorixListDescriptor, sort: ResolvedSort | undefined): string;
+export declare function resolveCanonicalContentType(entity: MemorixEntityDescriptor, clientCanonical?: string): string;
+export declare function assertContentTypeExists(entity: MemorixEntityDescriptor, contentType: string): void;
+//# sourceMappingURL=resolve-pagination-driver.d.ts.map

package/dist/retrieval/resolve-pagination-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-pagination-driver.d.ts","sourceRoot":"","sources":["../../src/retrieval/resolve-pagination-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,qBAAqB,EAC3B,IAAI,EAAE,YAAY,GAAG,SAAS,GAC7B,MAAM,CASR;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,uBAAuB,EAC/B,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,CAMR;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,uBAAuB,EAC/B,WAAW,EAAE,MAAM,GAClB,IAAI,CAON"}

package/dist/retrieval/resolve-pagination-driver.js

@@ -0,0 +1,22 @@
+import { throwRetrievalError } from "../errors/errors.js";
+export function resolvePaginationDriver(list, sort) {
+    const leading = list.leadingContentType;
+    if (!sort || sort.contentType === leading) {
+        return leading;
+    }
+    if (list.allowSortDrivenLeadingOverride) {
+        return sort.contentType;
+    }
+    return leading;
+}
+export function resolveCanonicalContentType(entity, clientCanonical) {
+    return (entity.defaults.canonicalContentType ??
+        clientCanonical ??
+        "snapshots");
+}
+export function assertContentTypeExists(entity, contentType) {
+    if (!entity.contentTypes[contentType]) {
+        throwRetrievalError("UNKNOWN_CONTENT_TYPE", `Unknown content type "${contentType}" on entity "${entity.id}"`);
+    }
+}
+//# sourceMappingURL=resolve-pagination-driver.js.map

package/dist/retrieval/resolve-pagination-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-pagination-driver.js","sourceRoot":"","sources":["../../src/retrieval/resolve-pagination-driver.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG1D,MAAM,UAAU,uBAAuB,CACrC,IAA2B,EAC3B,IAA8B;IAE9B,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC;IACxC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,KAAK,OAAO,EAAE,CAAC;QAC1C,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,IAAI,CAAC,8BAA8B,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,MAA+B,EAC/B,eAAwB;IAExB,OAAO,CACL,MAAM,CAAC,QAAQ,CAAC,oBAAoB;QACpC,eAAe;QACf,WAAW,CACZ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,MAA+B,EAC/B,WAAmB;IAEnB,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,CAAC;QACtC,mBAAmB,CACjB,sBAAsB,EACtB,yBAAyB,WAAW,gBAAgB,MAAM,CAAC,EAAE,GAAG,CACjE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/retrieval/resolve-property-source.d.ts

@@ -0,0 +1,10 @@
+import type { MemorixEntityDescriptor } from "../descriptors/descriptor-types.js";
+export type ResolvedPropertySource = {
+    contentType: string;
+    path: string;
+    fullPath: string;
+    dataRoot: string;
+};
+export declare function resolveMemorixPropertySource(entity: MemorixEntityDescriptor, propertyName: string): ResolvedPropertySource;
+export declare function readPropertyValue(recordsByContentType: Record<string, Record<string, unknown>[]>, entity: MemorixEntityDescriptor, propertyName: string): unknown;
+//# sourceMappingURL=resolve-property-source.d.ts.map

package/dist/retrieval/resolve-property-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-property-source.d.ts","sourceRoot":"","sources":["../../src/retrieval/resolve-property-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EAExB,MAAM,oCAAoC,CAAC;AAI5C,MAAM,MAAM,sBAAsB,GAAG;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,uBAAuB,EAC/B,YAAY,EAAE,MAAM,GACnB,sBAAsB,CASxB;AAsBD,wBAAgB,iBAAiB,CAC/B,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,EAC/D,MAAM,EAAE,uBAAuB,EAC/B,YAAY,EAAE,MAAM,GACnB,OAAO,CAWT"}

package/dist/retrieval/resolve-property-source.js

@@ -0,0 +1,48 @@
+import { throwRetrievalError } from "../errors/errors.js";
+import { getByPath, resolveDataRoot } from "../data/path.js";
+export function resolveMemorixPropertySource(entity, propertyName) {
+    const prop = entity.properties[propertyName];
+    if (!prop) {
+        throwRetrievalError("UNKNOWN_PROPERTY", `Unknown property "${propertyName}" on entity "${entity.id}"`);
+    }
+    return resolvePropertySourceFromDescriptor(entity, prop);
+}
+function resolvePropertySourceFromDescriptor(entity, prop) {
+    const ct = entity.contentTypes[prop.source.contentType];
+    if (!ct) {
+        throwRetrievalError("UNKNOWN_CONTENT_TYPE", `Property source content type "${prop.source.contentType}" not found`);
+    }
+    const dataRoot = ct.dataRoot ?? entity.defaults.dataRoot ?? "data";
+    return {
+        contentType: prop.source.contentType,
+        path: prop.source.path,
+        fullPath: prop.source.path,
+        dataRoot,
+    };
+}
+export function readPropertyValue(recordsByContentType, entity, propertyName) {
+    const prop = entity.properties[propertyName];
+    if (!prop)
+        return undefined;
+    const records = recordsByContentType[prop.source.contentType];
+    if (!records?.length)
+        return undefined;
+    const record = records[0];
+    const ct = entity.contentTypes[prop.source.contentType];
+    const dataRoot = ct?.dataRoot ?? entity.defaults.dataRoot ?? "data";
+    const root = resolveDataRoot(dataRoot, record);
+    const relativePath = stripDataRootPrefix(prop.source.path, dataRoot);
+    return getByPath(root, relativePath);
+}
+function stripDataRootPrefix(path, dataRoot) {
+    if (dataRoot === "." || !dataRoot)
+        return path;
+    const prefix = `${dataRoot}.`;
+    if (path.startsWith(prefix)) {
+        return path.slice(prefix.length);
+    }
+    if (path === dataRoot)
+        return "";
+    return path;
+}
+//# sourceMappingURL=resolve-property-source.js.map

package/dist/retrieval/resolve-property-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-property-source.js","sourceRoot":"","sources":["../../src/retrieval/resolve-property-source.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAS7D,MAAM,UAAU,4BAA4B,CAC1C,MAA+B,EAC/B,YAAoB;IAEpB,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAC7C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,mBAAmB,CACjB,kBAAkB,EAClB,qBAAqB,YAAY,gBAAgB,MAAM,CAAC,EAAE,GAAG,CAC9D,CAAC;IACJ,CAAC;IACD,OAAO,mCAAmC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,mCAAmC,CAC1C,MAA+B,EAC/B,IAA+B;IAE/B,MAAM,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACxD,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,mBAAmB,CACjB,sBAAsB,EACtB,iCAAiC,IAAI,CAAC,MAAM,CAAC,WAAW,aAAa,CACtE,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,IAAI,MAAM,CAAC;IACnE,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;QACpC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;QACtB,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;QAC1B,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,oBAA+D,EAC/D,MAA+B,EAC/B,YAAoB;IAEpB,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAC7C,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,MAAM,OAAO,GAAG,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC9D,IAAI,CAAC,OAAO,EAAE,MAAM;QAAE,OAAO,SAAS,CAAC;IACvC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;IAC3B,MAAM,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,EAAE,EAAE,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,IAAI,MAAM,CAAC;IACpE,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/C,MAAM,YAAY,GAAG,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACrE,OAAO,SAAS,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY,EAAE,QAAgB;IACzD,IAAI,QAAQ,KAAK,GAAG,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC/C,MAAM,MAAM,GAAG,GAAG,QAAQ,GAAG,CAAC;IAC9B,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACjC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/retrieval/resolve-sort.d.ts

@@ -0,0 +1,14 @@
+import type { MemorixRetrievalClient } from "../client/types.js";
+import type { MemorixEntityDescriptor, MemorixListDescriptor } from "../descriptors/descriptor-types.js";
+export type ResolvedSort = {
+    property: string;
+    direction: "asc" | "desc";
+    contentType: string;
+    mongoPath: string;
+    mongoSort: Record<string, 1 | -1>;
+};
+export declare function resolveMemorixSort(entity: MemorixEntityDescriptor, list: MemorixListDescriptor, sort: {
+    property: string;
+    direction: "asc" | "desc";
+} | undefined, _client: MemorixRetrievalClient): ResolvedSort;
+//# sourceMappingURL=resolve-sort.d.ts.map

package/dist/retrieval/resolve-sort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-sort.d.ts","sourceRoot":"","sources":["../../src/retrieval/resolve-sort.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,oCAAoC,CAAC;AAI5C,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACnC,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,uBAAuB,EAC/B,IAAI,EAAE,qBAAqB,EAC3B,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;CAAE,GAAG,SAAS,EACjE,OAAO,EAAE,sBAAsB,GAC9B,YAAY,CAqCd"}

package/dist/retrieval/resolve-sort.js

@@ -0,0 +1,28 @@
+import { throwRetrievalError } from "../errors/errors.js";
+import { resolveMemorixPropertySource } from "./resolve-property-source.js";
+export function resolveMemorixSort(entity, list, sort, _client) {
+    const resolved = sort ?? list.defaultSort;
+    if (!resolved) {
+        throwRetrievalError("SORT_REQUIRED", "No sort specified and list has no defaultSort");
+    }
+    if (list.allowedSorts?.length && !list.allowedSorts.includes(resolved.property)) {
+        throwRetrievalError("SORT_PROPERTY_NOT_ALLOWED", `Sort property "${resolved.property}" is not allowed`);
+    }
+    const prop = entity.properties[resolved.property];
+    if (!prop) {
+        throwRetrievalError("SORT_PROPERTY_NOT_ALLOWED", `Unknown sort property: ${resolved.property}`);
+    }
+    if (!prop.sortable) {
+        throwRetrievalError("SORT_PROPERTY_NOT_ALLOWED", `Property "${resolved.property}" is not sortable`);
+    }
+    const source = resolveMemorixPropertySource(entity, resolved.property);
+    const dir = resolved.direction === "desc" ? -1 : 1;
+    return {
+        property: resolved.property,
+        direction: resolved.direction,
+        contentType: source.contentType,
+        mongoPath: source.fullPath,
+        mongoSort: { [source.fullPath]: dir },
+    };
+}
+//# sourceMappingURL=resolve-sort.js.map

package/dist/retrieval/resolve-sort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-sort.js","sourceRoot":"","sources":["../../src/retrieval/resolve-sort.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAU5E,MAAM,UAAU,kBAAkB,CAChC,MAA+B,EAC/B,IAA2B,EAC3B,IAAiE,EACjE,OAA+B;IAE/B,MAAM,QAAQ,GAAG,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC;IAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,mBAAmB,CAAC,eAAe,EAAE,+CAA+C,CAAC,CAAC;IACxF,CAAC;IAED,IAAI,IAAI,CAAC,YAAY,EAAE,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChF,mBAAmB,CACjB,2BAA2B,EAC3B,kBAAkB,QAAQ,CAAC,QAAQ,kBAAkB,CACtD,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAClD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,mBAAmB,CACjB,2BAA2B,EAC3B,0BAA0B,QAAQ,CAAC,QAAQ,EAAE,CAC9C,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnB,mBAAmB,CACjB,2BAA2B,EAC3B,aAAa,QAAQ,CAAC,QAAQ,mBAAmB,CAClD,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,4BAA4B,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACvE,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEnD,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,SAAS,EAAE,MAAM,CAAC,QAAQ;QAC1B,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE;KACtC,CAAC;AACJ,CAAC"}

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

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

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

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

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

@@ -0,0 +1,44 @@
+import { describe, expect, it } from "vitest";
+import { createMemorixRetrieval } from "../client/create-client.js";
+import { resolveMemorixCollectionName } from "../data/collection-name.js";
+import { resolveMemorixDbNameForEntity } from "../mongo/resolve-db.js";
+import { assetsEntity } from "./fixtures.js";
+describe("memorix database conventions", () => {
+    it("resolves entity database from env", () => {
+        const client = createMemorixRetrieval({
+            catalox: { getCatalogItem: async () => ({ outcome: "not_found" }) },
+            xronox: { read: async () => [] },
+            processEnv: { MEMORIX_ENTITIES_DB: "tenant-entities" },
+        });
+        expect(resolveMemorixDbNameForEntity(assetsEntity, client)).toBe("tenant-entities");
+    });
+    it("uses env collection override when descriptor omits collection", () => {
+        const entity = {
+            ...assetsEntity,
+            contentTypes: {
+                snapshots: {
+                    postfix: "snapshots",
+                    dataRoot: "data",
+                    isCanonical: true,
+                },
+            },
+        };
+        expect(resolveMemorixCollectionName(entity, "snapshots", {
+            MEMORIX_ENTITIES_COLLECTION_ASSETS: "assets",
+        })).toBe("assets");
+    });
+    it("prefers explicit descriptor collection over env override", () => {
+        expect(resolveMemorixCollectionName(assetsEntity, "snapshots", {
+            MEMORIX_ENTITIES_COLLECTION_ASSETS: "assets",
+        })).toBe("assets-snapshots");
+    });
+    it("routes vulnerabilities to event xronox role", async () => {
+        const { resolveMemorixXronoxRole, DEFAULT_MEMORIX_XRONOX_ROLES } = await import("../data/memorix-read.js");
+        const client = createMemorixRetrieval({
+            catalox: { getCatalogItem: async () => ({ outcome: "not_found" }) },
+            xronox: { read: async () => [] },
+        });
+        expect(resolveMemorixXronoxRole({ ...assetsEntity, id: "vulnerabilities", target: "event" }, client)).toBe(DEFAULT_MEMORIX_XRONOX_ROLES.event);
+    });
+});
+//# sourceMappingURL=collection-env.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collection-env.test.js","sourceRoot":"","sources":["../../src/tests/collection-env.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,MAAM,GAAG,sBAAsB,CAAC;YACpC,OAAO,EAAE,EAAE,cAAc,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE;YACnE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE,EAAE;YAChC,UAAU,EAAE,EAAE,mBAAmB,EAAE,iBAAiB,EAAE;SACvD,CAAC,CAAC;QAEH,MAAM,CAAC,6BAA6B,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAC9D,iBAAiB,CAClB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,MAAM,GAAG;YACb,GAAG,YAAY;YACf,YAAY,EAAE;gBACZ,SAAS,EAAE;oBACT,OAAO,EAAE,WAAW;oBACpB,QAAQ,EAAE,MAAM;oBAChB,WAAW,EAAE,IAAI;iBAClB;aACF;SACF,CAAC;QAEF,MAAM,CACJ,4BAA4B,CAAC,MAAM,EAAE,WAAW,EAAE;YAChD,kCAAkC,EAAE,QAAQ;SAC7C,CAAC,CACH,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,CACJ,4BAA4B,CAAC,YAAY,EAAE,WAAW,EAAE;YACtD,kCAAkC,EAAE,QAAQ;SAC7C,CAAC,CACH,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,EAAE,wBAAwB,EAAE,4BAA4B,EAAE,GAAG,MAAM,MAAM,CAC7E,yBAAyB,CAC1B,CAAC;QACF,MAAM,MAAM,GAAG,sBAAsB,CAAC;YACpC,OAAO,EAAE,EAAE,cAAc,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE;YACnE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE,EAAE;SACjC,CAAC,CAAC;QACH,MAAM,CACJ,wBAAwB,CACtB,EAAE,GAAG,YAAY,EAAE,EAAE,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO,EAAE,EAC3D,MAAM,CACP,CACF,CAAC,IAAI,CAAC,4BAA4B,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tests/content-object.test.d.ts

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

package/dist/tests/content-object.test.d.ts.map

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

package/dist/tests/content-object.test.js

@@ -0,0 +1,39 @@
+import { describe, expect, it, vi } from "vitest";
+import { createMemorixRetrieval } from "../client/create-client.js";
+import { fetchMemorixContentObject } from "../content/fetch-content-object.js";
+import { mapContentFetchError } from "../content/map-content-errors.js";
+import { resolveMemorixContentObject } from "../content/memorix-content-object.js";
+import { assetsEntity } from "./fixtures.js";
+describe("content object", () => {
+    it("parses valid content object", () => {
+        const r = resolveMemorixContentObject({
+            contentKey: "docs/report.md",
+            preview: "Hi",
+            metadata: { words: 10 },
+        });
+        expect(r.ok).toBe(true);
+        if (r.ok)
+            expect(r.object.contentKey).toBe("docs/report.md");
+    });
+    it("maps not found errors", () => {
+        const issue = mapContentFetchError(Object.assign(new Error("missing"), { name: "GcsNotFoundError" }));
+        expect(issue.code).toBe("CONTENT_NOT_FOUND");
+    });
+    it("fetches content via gcs reader", async () => {
+        const client = createMemorixRetrieval({
+            catalox: { getCatalogItem: async () => ({ outcome: "not_found" }) },
+            xronox: { read: async () => [] },
+            contentReaders: {
+                gcs: {
+                    readObjectBuffer: vi.fn().mockResolvedValue(Buffer.from("# Hi")),
+                },
+            },
+        });
+        const prop = assetsEntity.properties.investigationReport.content;
+        const result = await fetchMemorixContentObject(client, assetsEntity, prop, { contentKey: "reports/x.md" });
+        expect(result.ok).toBe(true);
+        if (result.ok)
+            expect(result.content).toBe("# Hi");
+    });
+});
+//# sourceMappingURL=content-object.test.js.map

package/dist/tests/content-object.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-object.test.js","sourceRoot":"","sources":["../../src/tests/content-object.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,GAAG,2BAA2B,CAAC;YACpC,UAAU,EAAE,gBAAgB;YAC5B,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;SACxB,CAAC,CAAC;QACH,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,CAAC,EAAE;YAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,KAAK,GAAG,oBAAoB,CAChC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAClE,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,MAAM,GAAG,sBAAsB,CAAC;YACpC,OAAO,EAAE,EAAE,cAAc,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE;YACnE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE,EAAE;YAChC,cAAc,EAAE;gBACd,GAAG,EAAE;oBACH,gBAAgB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;iBACxD;aACX;SACF,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,YAAY,CAAC,UAAU,CAAC,mBAAmB,CAAC,OAAQ,CAAC;QAClE,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAC5C,MAAM,EACN,YAAY,EACZ,IAAI,EACJ,EAAE,UAAU,EAAE,cAAc,EAAE,CAC/B,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,MAAM,CAAC,EAAE;YAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tests/descriptor-validation.test.d.ts

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

package/dist/tests/descriptor-validation.test.d.ts.map

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

package/dist/tests/descriptor-validation.test.js

@@ -0,0 +1,25 @@
+import { describe, expect, it } from "vitest";
+import { assertListFieldsHumanReadable, validateMemorixEntityDescriptor, } from "../descriptors/validate-descriptor.js";
+import { MemorixRetrievalError } from "../errors/errors.js";
+import { assetsEntity, assetsMainList } from "./fixtures.js";
+describe("descriptor validation", () => {
+    it("validates assets entity fixture", () => {
+        const d = validateMemorixEntityDescriptor(assetsEntity);
+        expect(d.id).toBe("assets");
+    });
+    it("rejects non-human-readable list fields", () => {
+        const badList = {
+            ...assetsMainList,
+            fields: ["ipAddress", "hostName"],
+        };
+        const entity = {
+            ...assetsEntity,
+            properties: {
+                ...assetsEntity.properties,
+                hostName: { ...assetsEntity.properties.hostName, humanReadable: false },
+            },
+        };
+        expect(() => assertListFieldsHumanReadable(badList, entity)).toThrow(MemorixRetrievalError);
+    });
+});
+//# sourceMappingURL=descriptor-validation.test.js.map

package/dist/tests/descriptor-validation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor-validation.test.js","sourceRoot":"","sources":["../../src/tests/descriptor-validation.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,6BAA6B,EAC7B,+BAA+B,GAChC,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE7D,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,GAAG,+BAA+B,CACvC,YAAkD,CACnD,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,OAAO,GAAG;YACd,GAAG,cAAc;YACjB,MAAM,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC;SAClC,CAAC;QACF,MAAM,MAAM,GAAG;YACb,GAAG,YAAY;YACf,UAAU,EAAE;gBACV,GAAG,YAAY,CAAC,UAAU;gBAC1B,QAAQ,EAAE,EAAE,GAAG,YAAY,CAAC,UAAU,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE;aACxE;SACF,CAAC;QACF,MAAM,CAAC,GAAG,EAAE,CACV,6BAA6B,CAAC,OAAO,EAAE,MAAM,CAAC,CAC/C,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

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

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

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

package/dist/tests/env.test.js

@@ -0,0 +1,17 @@
+import { describe, expect, it } from "vitest";
+import { resolveMemorixDbName } from "../mongo/env.js";
+describe("resolveMemorixDbName", () => {
+    it("defaults entity target to memorix-entities", () => {
+        expect(resolveMemorixDbName("entity", {})).toBe("memorix-entities");
+    });
+    it("defaults event target to memorix-events", () => {
+        expect(resolveMemorixDbName("event", {})).toBe("memorix-events");
+    });
+    it("respects MEMORIX_ENTITIES_DB", () => {
+        expect(resolveMemorixDbName("entity", { MEMORIX_ENTITIES_DB: "custom-entities" })).toBe("custom-entities");
+    });
+    it("respects MEMORIX_EVENTS_DB", () => {
+        expect(resolveMemorixDbName("event", { MEMORIX_EVENTS_DB: "custom-events" })).toBe("custom-events");
+    });
+});
+//# sourceMappingURL=env.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"env.test.js","sourceRoot":"","sources":["../../src/tests/env.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,oBAAoB,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,oBAAoB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CACJ,oBAAoB,CAAC,QAAQ,EAAE,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,CAAC,CAC3E,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CACJ,oBAAoB,CAAC,OAAO,EAAE,EAAE,iBAAiB,EAAE,eAAe,EAAE,CAAC,CACtE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tests/fetch-item.test.d.ts

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

package/dist/tests/fetch-item.test.d.ts.map

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

package/dist/tests/fetch-item.test.js

@@ -0,0 +1,86 @@
+import { describe, expect, it, vi } from "vitest";
+import { createMemorixRetrieval } from "../client/create-client.js";
+import { MEMORIX_ENTITY_DESCRIPTORS_CATALOG, MEMORIX_ITEM_DESCRIPTORS_CATALOG, } from "../descriptors/catalog-ids.js";
+import { fetchMemorixItem } from "../retrieval/fetch-item.js";
+import { MemorixRetrievalError } from "../errors/errors.js";
+import { assetDetailItem, assetsEntity } from "./fixtures.js";
+function mockCatalox() {
+    return {
+        getCatalogItem: vi.fn(async (_ctx, catalogId, itemId) => {
+            if (catalogId === MEMORIX_ITEM_DESCRIPTORS_CATALOG &&
+                itemId === "asset-detail-item") {
+                return { outcome: "found", item: { data: assetDetailItem } };
+            }
+            if (catalogId === MEMORIX_ENTITY_DESCRIPTORS_CATALOG &&
+                itemId === "assets") {
+                return { outcome: "found", item: { data: assetsEntity } };
+            }
+            return { outcome: "not_found" };
+        }),
+    };
+}
+describe("fetchMemorixItem", () => {
+    it("builds sections and fetches full content when requested", async () => {
+        const xronoxRead = vi.fn(async (params) => {
+            if (params.source === "assets-snapshots") {
+                return [
+                    {
+                        entityId: "10.0.0.1",
+                        modifiedAt: "2026-01-01",
+                        data: { ip_address: "10.0.0.1", xdr: { host_name: "host-a" } },
+                    },
+                ];
+            }
+            if (params.source === "assets-analysis") {
+                return [
+                    {
+                        entityId: "10.0.0.1",
+                        modifiedAt: "2026-02-01",
+                        data: {
+                            investigationReport: {
+                                contentKey: "reports/x.md",
+                                preview: "Preview",
+                                metadata: { words: 2 },
+                            },
+                        },
+                    },
+                ];
+            }
+            return [];
+        });
+        const readObjectBuffer = vi
+            .fn()
+            .mockResolvedValue(Buffer.from("# Full report"));
+        const client = createMemorixRetrieval({
+            catalox: mockCatalox(),
+            xronox: { read: xronoxRead, readArray: xronoxRead },
+            contentReaders: {
+                gcs: { readObjectBuffer },
+            },
+        });
+        const res = await fetchMemorixItem(client, {
+            itemDescriptorId: "asset-detail-item",
+            entityId: "10.0.0.1",
+            content: { include: true, fields: ["investigationReport"] },
+        });
+        expect(res.entityId).toBe("10.0.0.1");
+        const reports = res.sections.find((s) => s.id === "reports");
+        expect(reports?.fields.investigationReport).toMatchObject({
+            preview: "Preview",
+            content: "# Full report",
+        });
+        expect(readObjectBuffer).toHaveBeenCalled();
+    });
+    it("rejects both entityId and eventId", async () => {
+        const client = createMemorixRetrieval({
+            catalox: mockCatalox(),
+            xronox: { read: async () => [] },
+        });
+        await expect(fetchMemorixItem(client, {
+            itemDescriptorId: "asset-detail-item",
+            entityId: "a",
+            eventId: "e",
+        })).rejects.toThrow(MemorixRetrievalError);
+    });
+});
+//# sourceMappingURL=fetch-item.test.js.map

package/dist/tests/fetch-item.test.js.map

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

package/dist/tests/fetch-list.test.d.ts

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

package/dist/tests/fetch-list.test.d.ts.map

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

package/dist/tests/fetch-list.test.js

@@ -0,0 +1,85 @@
+import { describe, expect, it, vi } from "vitest";
+import { createMemorixRetrieval } from "../client/create-client.js";
+import { MEMORIX_ENTITY_DESCRIPTORS_CATALOG, MEMORIX_LIST_DESCRIPTORS_CATALOG, } from "../descriptors/catalog-ids.js";
+import { fetchMemorixList } from "../retrieval/fetch-list.js";
+import { MemorixRetrievalError } from "../errors/errors.js";
+import { assetsEntity, assetsMainList } from "./fixtures.js";
+function mockCatalox() {
+    return {
+        getCatalogItem: vi.fn(async (_ctx, catalogId, itemId) => {
+            if (catalogId === MEMORIX_LIST_DESCRIPTORS_CATALOG &&
+                itemId === "assets-main-list") {
+                return { outcome: "found", item: { data: assetsMainList } };
+            }
+            if (catalogId === MEMORIX_ENTITY_DESCRIPTORS_CATALOG &&
+                itemId === "assets") {
+                return { outcome: "found", item: { data: assetsEntity } };
+            }
+            return { outcome: "not_found" };
+        }),
+    };
+}
+describe("fetchMemorixList", () => {
+    it("fetches paginated list from leading content type", async () => {
+        const xronoxRead = vi.fn(async (params) => {
+            expect(params.role).toBe("operational");
+            if (params.source === "assets-snapshots") {
+                return [
+                    {
+                        entityId: "10.0.0.1",
+                        modifiedAt: "2026-01-01",
+                        data: { ip_address: "10.0.0.1", xdr: { host_name: "host-a" } },
+                    },
+                ];
+            }
+            if (params.source === "assets-analysis") {
+                return [
+                    {
+                        entityId: "10.0.0.1",
+                        modifiedAt: "2026-02-01",
+                        data: {
+                            investigationReport: {
+                                contentKey: "r.md",
+                                preview: "Preview text",
+                                metadata: { words: 5 },
+                            },
+                        },
+                    },
+                ];
+            }
+            return [];
+        });
+        const client = createMemorixRetrieval({
+            catalox: mockCatalox(),
+            xronox: { read: xronoxRead, readArray: xronoxRead },
+        });
+        const res = await fetchMemorixList(client, {
+            listId: "assets-main-list",
+            page: { limit: 10, offset: 0 },
+        });
+        expect(res.listId).toBe("assets-main-list");
+        expect(res.rows).toHaveLength(1);
+        expect(res.rows[0].entityId).toBe("10.0.0.1");
+        expect(res.rows[0].ipAddress).toBe("10.0.0.1");
+        expect(res.rows[0].investigationReport).toEqual({
+            preview: "Preview text",
+            metadata: { words: 5 },
+        });
+        expect(res.rows[0]).not.toHaveProperty("content");
+    });
+    it("rejects disallowed sort property", async () => {
+        const client = createMemorixRetrieval({
+            catalox: mockCatalox(),
+            xronox: { read: async () => [] },
+        });
+        await expect(fetchMemorixList(client, {
+            listId: "assets-main-list",
+            sort: { property: "investigationReport", direction: "asc" },
+        })).rejects.toThrow(MemorixRetrievalError);
+    });
+    it("resolves collection name assets-snapshots", async () => {
+        const { resolveMemorixCollectionName } = await import("../data/collection-name.js");
+        expect(resolveMemorixCollectionName(assetsEntity, "snapshots")).toBe("assets-snapshots");
+    });
+});
+//# sourceMappingURL=fetch-list.test.js.map

package/dist/tests/fetch-list.test.js.map

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

package/dist/tests/fixtures.d.ts

@@ -0,0 +1,5 @@
+import type { MemorixEntityDescriptor, MemorixItemDescriptor, MemorixListDescriptor } from "../descriptors/descriptor-types.js";
+export declare const assetsEntity: MemorixEntityDescriptor;
+export declare const assetsMainList: MemorixListDescriptor;
+export declare const assetDetailItem: MemorixItemDescriptor;
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/tests/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/tests/fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,oCAAoC,CAAC;AAE5C,eAAO,MAAM,YAAY,EAAE,uBAuF1B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,qBAmB5B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,qBA2B7B,CAAC"}