@x12i/memorix-retrieval 1.1.0

package/dist/relations/resolve-relations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-relations.js","sourceRoot":"","sources":["../../src/relations/resolve-relations.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAA8B,EAC9B,MAA+B,EAC/B,IAA2B,EAC3B,oBAA+D,EAC/D,gBAA0B,EAC1B,MAA+B;IAE/B,MAAM,SAAS,GAA4B,EAAE,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,CAAC,IAAI,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAC1D,CAAC;IAEF,KAAK,MAAM,YAAY,IAAI,gBAAgB,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC1C,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC,YAAY,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ,IAAI,CAAC,OAAO;YAAE,SAAS;QAEpC,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAClC,MAAM,EACN,MAAM,EACN,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,oBAAoB,EACpB,MAAM,CACP,CAAC;QACF,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,SAAS,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAA+B,EAC/B,OAAgC,EAChC,KAA4B,EAC5B,KAAgC,EAChC,iBAA2B,EAC3B,OAAgC;IAEhC,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/retrieval/batch-fetch.d.ts

@@ -0,0 +1,11 @@
+import type { MemorixRetrievalClient } from "../client/types.js";
+import type { MemorixEntityDescriptor } from "../descriptors/descriptor-types.js";
+import type { MemorixContentExtensionDescriptor } from "../descriptors/descriptor-types.js";
+import type { MemorixRetrievalIssue } from "../errors/issues.js";
+export declare function batchFetchByIds(client: MemorixRetrievalClient, entity: MemorixEntityDescriptor, contentType: string, idField: "entityId" | "eventId", ids: string[], projectionPaths?: string[]): Promise<Record<string, unknown>[]>;
+export declare function groupRecordsById(records: Record<string, unknown>[], idField: "entityId" | "eventId"): Map<string, Record<string, unknown>[]>;
+export declare function fetchExtensionForRow(client: MemorixRetrievalClient, entity: MemorixEntityDescriptor, extension: MemorixContentExtensionDescriptor, idField: "entityId" | "eventId", idValue: string, fieldNames: string[], issues: MemorixRetrievalIssue[]): Promise<Record<string, Record<string, unknown>[]> | null>;
+export declare function mergeRecordsByContentType(target: Record<string, Record<string, unknown>[]>, source: Record<string, Record<string, unknown>[]>): void;
+export declare function extensionMissingDefault(extension: MemorixContentExtensionDescriptor): boolean;
+export declare function addExtensionMissingIssue(issues: MemorixRetrievalIssue[], extension: MemorixContentExtensionDescriptor, idField: "entityId" | "eventId", idValue: string): void;
+//# sourceMappingURL=batch-fetch.d.ts.map

package/dist/retrieval/batch-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-fetch.d.ts","sourceRoot":"","sources":["../../src/retrieval/batch-fetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAQlF,OAAO,KAAK,EACV,iCAAiC,EAElC,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAIjE,wBAAsB,eAAe,CACnC,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE,uBAAuB,EAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,UAAU,GAAG,SAAS,EAC/B,GAAG,EAAE,MAAM,EAAE,EACb,eAAe,CAAC,EAAE,MAAM,EAAE,GACzB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAepC;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAClC,OAAO,EAAE,UAAU,GAAG,SAAS,GAC9B,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAUxC;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE,uBAAuB,EAC/B,SAAS,EAAE,iCAAiC,EAC5C,OAAO,EAAE,UAAU,GAAG,SAAS,EAC/B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAAE,EACpB,MAAM,EAAE,qBAAqB,EAAE,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CA6C3D;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,EACjD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,GAChD,IAAI,CAIN;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,iCAAiC,GAC3C,OAAO,CAET;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,qBAAqB,EAAE,EAC/B,SAAS,EAAE,iCAAiC,EAC5C,OAAO,EAAE,UAAU,GAAG,SAAS,EAC/B,OAAO,EAAE,MAAM,GACd,IAAI,CASN"}

package/dist/retrieval/batch-fetch.js

@@ -0,0 +1,80 @@
+import { resolveMemorixCollectionName } from "../data/collection-name.js";
+import { buildIdFilter } from "../data/identity.js";
+import { applyMultiMatch, defaultExtensionMultiMatch, } from "../data/multi-match.js";
+import { memorixRead } from "../data/memorix-read.js";
+import { createIssue } from "../errors/issues.js";
+import { collectProjectionPaths } from "./resolve-fields.js";
+export async function batchFetchByIds(client, entity, contentType, idField, ids, projectionPaths) {
+    if (ids.length === 0)
+        return [];
+    const collection = resolveMemorixCollectionName(entity, contentType, client.processEnv);
+    const project = projectionPaths ?? ["entityId", "eventId"];
+    return memorixRead(client, {
+        entity,
+        source: collection,
+        query: buildIdFilter(idField, ids),
+        project,
+        limit: ids.length * 10,
+    });
+}
+export function groupRecordsById(records, idField) {
+    const map = new Map();
+    for (const record of records) {
+        const id = record[idField];
+        if (typeof id !== "string")
+            continue;
+        const existing = map.get(id) ?? [];
+        existing.push(record);
+        map.set(id, existing);
+    }
+    return map;
+}
+export async function fetchExtensionForRow(client, entity, extension, idField, idValue, fieldNames, issues) {
+    const paths = collectProjectionPaths(entity, fieldNames);
+    const records = await batchFetchByIds(client, entity, extension.contentType, idField, [idValue], paths);
+    const rule = extension.multiMatch ?? defaultExtensionMultiMatch(extension.mode);
+    const matched = applyMultiMatch(records, rule, entity, client, {
+        path: extension.contentType,
+    });
+    if (!matched.ok) {
+        issues.push(matched.issue);
+        return null;
+    }
+    if (matched.records.length === 0) {
+        const includeRow = extension.onMissing?.includeRow ?? extension.mode === "array";
+        if (!includeRow) {
+            return null;
+        }
+        if (extension.mode === "array") {
+            const arrayProp = extension.arrayProperty ?? extension.contentType;
+            return {
+                [extension.contentType]: [],
+                ...(arrayProp !== extension.contentType
+                    ? { [arrayProp]: [] }
+                    : {}),
+            };
+        }
+        return { [extension.contentType]: [] };
+    }
+    if (extension.mode === "array") {
+        return { [extension.contentType]: matched.records };
+    }
+    return { [extension.contentType]: matched.records };
+}
+export function mergeRecordsByContentType(target, source) {
+    for (const [key, records] of Object.entries(source)) {
+        target[key] = records;
+    }
+}
+export function extensionMissingDefault(extension) {
+    return extension.onMissing?.includeRow ?? extension.mode === "array";
+}
+export function addExtensionMissingIssue(issues, extension, idField, idValue) {
+    issues.push(createIssue({
+        code: "EXTENSION_MISSING",
+        message: `Extension content type "${extension.contentType}" missing`,
+        severity: "warning",
+        [idField]: idValue,
+    }));
+}
+//# sourceMappingURL=batch-fetch.js.map

package/dist/retrieval/batch-fetch.js.map

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

package/dist/retrieval/compose-item.d.ts

@@ -0,0 +1,11 @@
+import type { MemorixEntityDescriptor, MemorixItemDescriptor } from "../descriptors/descriptor-types.js";
+import type { MemorixRetrievalIssue } from "../errors/issues.js";
+export declare function composeMemorixItemSections(entity: MemorixEntityDescriptor, item: MemorixItemDescriptor, recordsByContentType: Record<string, Record<string, unknown>[]>, issues: MemorixRetrievalIssue[], options?: {
+    fetchContent?: boolean;
+    fullContentByField?: Record<string, string>;
+}): Array<{
+    id: string;
+    title: string;
+    fields: Record<string, unknown>;
+}>;
+//# sourceMappingURL=compose-item.d.ts.map

package/dist/retrieval/compose-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-item.d.ts","sourceRoot":"","sources":["../../src/retrieval/compose-item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAGjE,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,uBAAuB,EAC/B,IAAI,EAAE,qBAAqB,EAC3B,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,EAC/D,MAAM,EAAE,qBAAqB,EAAE,EAC/B,OAAO,CAAC,EAAE;IACR,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C,GACA,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CAqBvE"}

package/dist/retrieval/compose-item.js

@@ -0,0 +1,18 @@
+import { resolveFieldValueForItem } from "./resolve-fields.js";
+export function composeMemorixItemSections(entity, item, recordsByContentType, issues, options) {
+    return item.sections.map((section) => {
+        const fields = {};
+        for (const fieldName of section.fields) {
+            fields[fieldName] = resolveFieldValueForItem(entity, recordsByContentType, fieldName, issues, {
+                fetchContent: options?.fetchContent,
+                fullContentByField: options?.fullContentByField,
+            });
+        }
+        return {
+            id: section.id,
+            title: section.title,
+            fields,
+        };
+    });
+}
+//# sourceMappingURL=compose-item.js.map

package/dist/retrieval/compose-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-item.js","sourceRoot":"","sources":["../../src/retrieval/compose-item.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,MAAM,UAAU,0BAA0B,CACxC,MAA+B,EAC/B,IAA2B,EAC3B,oBAA+D,EAC/D,MAA+B,EAC/B,OAGC;IAED,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACnC,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACvC,MAAM,CAAC,SAAS,CAAC,GAAG,wBAAwB,CAC1C,MAAM,EACN,oBAAoB,EACpB,SAAS,EACT,MAAM,EACN;gBACE,YAAY,EAAE,OAAO,EAAE,YAAY;gBACnC,kBAAkB,EAAE,OAAO,EAAE,kBAAkB;aAChD,CACF,CAAC;QACJ,CAAC;QACD,OAAO;YACL,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM;SACP,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/retrieval/compose-row.d.ts

@@ -0,0 +1,4 @@
+import type { MemorixEntityDescriptor, MemorixListDescriptor } from "../descriptors/descriptor-types.js";
+import type { MemorixRetrievalIssue } from "../errors/issues.js";
+export declare function composeMemorixRow(entity: MemorixEntityDescriptor, list: MemorixListDescriptor, recordsByContentType: Record<string, Record<string, unknown>[]>, driverRecord: Record<string, unknown>, issues: MemorixRetrievalIssue[]): Record<string, unknown> | null;
+//# sourceMappingURL=compose-row.d.ts.map

package/dist/retrieval/compose-row.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-row.d.ts","sourceRoot":"","sources":["../../src/retrieval/compose-row.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAIjE,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,uBAAuB,EAC/B,IAAI,EAAE,qBAAqB,EAC3B,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,EAC/D,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,MAAM,EAAE,qBAAqB,EAAE,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAkBhC"}

package/dist/retrieval/compose-row.js

@@ -0,0 +1,14 @@
+import { getIdentityFromRecord } from "../data/identity.js";
+import { resolveFieldValueForList } from "./resolve-fields.js";
+export function composeMemorixRow(entity, list, recordsByContentType, driverRecord, issues) {
+    const identity = getIdentityFromRecord(driverRecord);
+    const row = {};
+    if (identity) {
+        row[identity.field] = identity.value;
+    }
+    for (const field of list.fields) {
+        row[field] = resolveFieldValueForList(entity, recordsByContentType, field, issues);
+    }
+    return row;
+}
+//# sourceMappingURL=compose-row.js.map

package/dist/retrieval/compose-row.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-row.js","sourceRoot":"","sources":["../../src/retrieval/compose-row.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,MAAM,UAAU,iBAAiB,CAC/B,MAA+B,EAC/B,IAA2B,EAC3B,oBAA+D,EAC/D,YAAqC,EACrC,MAA+B;IAE/B,MAAM,QAAQ,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC;IACrD,MAAM,GAAG,GAA4B,EAAE,CAAC;IAExC,IAAI,QAAQ,EAAE,CAAC;QACb,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC;IACvC,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChC,GAAG,CAAC,KAAK,CAAC,GAAG,wBAAwB,CACnC,MAAM,EACN,oBAAoB,EACpB,KAAK,EACL,MAAM,CACP,CAAC;IACJ,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/retrieval/fetch-item.d.ts

@@ -0,0 +1,3 @@
+import type { FetchMemorixItemRequest, FetchMemorixItemResponse, MemorixRetrievalClient } from "../client/types.js";
+export declare function fetchMemorixItem(client: MemorixRetrievalClient, request: FetchMemorixItemRequest): Promise<FetchMemorixItemResponse>;
+//# sourceMappingURL=fetch-item.d.ts.map

package/dist/retrieval/fetch-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-item.d.ts","sourceRoot":"","sources":["../../src/retrieval/fetch-item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAgB5B,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,wBAAwB,CAAC,CAsInC"}

package/dist/retrieval/fetch-item.js

@@ -0,0 +1,107 @@
+import { assertRequestIdentity } from "../data/identity.js";
+import { applyMultiMatch } from "../data/multi-match.js";
+import { batchFetchByIds } from "./batch-fetch.js";
+import { fetchMemorixContentObject } from "../content/fetch-content-object.js";
+import { resolveMemorixContentObject, } from "../content/memorix-content-object.js";
+import { loadMemorixEntityDescriptor } from "../descriptors/load-entity-descriptor.js";
+import { loadMemorixItemDescriptor } from "../descriptors/load-item-descriptor.js";
+import { throwRetrievalError } from "../errors/errors.js";
+import { readPropertyValue } from "./resolve-property-source.js";
+import { composeMemorixItemSections } from "./compose-item.js";
+import { fetchRelationsForItem } from "../relations/resolve-relations.js";
+export async function fetchMemorixItem(client, request) {
+    const item = await loadMemorixItemDescriptor(client, request.itemDescriptorId);
+    const entity = await loadMemorixEntityDescriptor(client, item.entity);
+    const { field: idField, value: idValue } = assertRequestIdentity(request.entityId, request.eventId);
+    if (item.identity.idField !== idField) {
+        throwRetrievalError("INVALID_REQUEST", `Item descriptor expects ${item.identity.idField}, got ${idField}`);
+    }
+    const issues = [];
+    const recordsByContentType = {};
+    for (const ctSpec of item.contentTypes) {
+        const records = await batchFetchByIds(client, entity, ctSpec.contentType, idField, [idValue]);
+        const rule = ctSpec.multiMatch ?? { strategy: "last" };
+        const matched = applyMultiMatch(records, rule, entity, client, {
+            path: ctSpec.contentType,
+        });
+        if (!matched.ok) {
+            issues.push(matched.issue);
+            if (ctSpec.required) {
+                return buildItemResponse(item, entity, idField, idValue, [], issues);
+            }
+            continue;
+        }
+        if (matched.records.length === 0) {
+            if (ctSpec.required) {
+                issues.push({
+                    code: "EXTENSION_MISSING",
+                    message: `Required content type "${ctSpec.contentType}" not found`,
+                    severity: "error",
+                    [idField]: idValue,
+                });
+            }
+            continue;
+        }
+        recordsByContentType[ctSpec.contentType] = matched.records;
+    }
+    const fullContentByField = {};
+    if (request.content?.include && item.content?.allowed) {
+        const allowedFields = new Set(request.content.fields ??
+            item.content.allowedFields ??
+            []);
+        for (const section of item.sections) {
+            for (const fieldName of section.fields) {
+                if (allowedFields.size && !allowedFields.has(fieldName))
+                    continue;
+                const prop = entity.properties[fieldName];
+                if (!prop?.content?.enabled || !prop.content.itemBehavior?.fetchContentWhenRequested) {
+                    continue;
+                }
+                const raw = readPropertyValue(recordsByContentType, entity, fieldName);
+                const parsed = resolveMemorixContentObject(raw);
+                if (!parsed.ok) {
+                    issues.push({ ...parsed.issue, path: fieldName });
+                    continue;
+                }
+                const fetched = await fetchMemorixContentObject(client, entity, prop.content, parsed.object, {
+                    maxBytes: request.content.maxBytes ?? item.content.maxBytes,
+                    path: fieldName,
+                });
+                if (fetched.ok) {
+                    fullContentByField[fieldName] = fetched.content;
+                }
+                else {
+                    issues.push(fetched.issue);
+                }
+            }
+        }
+    }
+    const sections = composeMemorixItemSections(entity, item, recordsByContentType, issues, {
+        fetchContent: request.content?.include === true,
+        fullContentByField,
+    });
+    let relations;
+    if (request.includeRelations?.length) {
+        relations = await fetchRelationsForItem(client, entity, item, recordsByContentType, request.includeRelations, issues);
+        if (relations && !Object.keys(relations).length) {
+            relations = undefined;
+        }
+    }
+    return buildItemResponse(item, entity, idField, idValue, sections, issues, relations);
+}
+function buildItemResponse(item, entity, idField, idValue, sections, issues, relations) {
+    const response = {
+        itemDescriptorId: item.id,
+        entity: entity.entityName,
+        sections,
+        ...(idField === "entityId"
+            ? { entityId: idValue }
+            : { eventId: idValue }),
+    };
+    if (relations)
+        response.relations = relations;
+    if (issues.length)
+        response.issues = issues;
+    return response;
+}
+//# sourceMappingURL=fetch-item.js.map

package/dist/retrieval/fetch-item.js.map

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

package/dist/retrieval/fetch-list.d.ts

@@ -0,0 +1,3 @@
+import type { FetchMemorixListRequest, FetchMemorixListResponse, MemorixRetrievalClient } from "../client/types.js";
+export declare function fetchMemorixList(client: MemorixRetrievalClient, request: FetchMemorixListRequest): Promise<FetchMemorixListResponse>;
+//# sourceMappingURL=fetch-list.d.ts.map

package/dist/retrieval/fetch-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-list.d.ts","sourceRoot":"","sources":["../../src/retrieval/fetch-list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AA2B5B,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,wBAAwB,CAAC,CA8MnC"}

package/dist/retrieval/fetch-list.js

@@ -0,0 +1,148 @@
+import { resolveMemorixCollectionName } from "../data/collection-name.js";
+import { getIdentityFromRecord, validateMemorixIdentity, } from "../data/identity.js";
+import { applyMultiMatch } from "../data/multi-match.js";
+import { memorixRead } from "../data/memorix-read.js";
+import { loadMemorixEntityDescriptor } from "../descriptors/load-entity-descriptor.js";
+import { loadMemorixListDescriptor } from "../descriptors/load-list-descriptor.js";
+import { assertListFieldsHumanReadable } from "../descriptors/validate-descriptor.js";
+import { addExtensionMissingIssue, batchFetchByIds, extensionMissingDefault, groupRecordsById, } from "./batch-fetch.js";
+import { composeMemorixRow } from "./compose-row.js";
+import { resolveMemorixFilters } from "./resolve-filters.js";
+import { assertContentTypeExists, resolveCanonicalContentType, resolvePaginationDriver, } from "./resolve-pagination-driver.js";
+import { collectProjectionPaths } from "./resolve-fields.js";
+import { resolveMemorixSort } from "./resolve-sort.js";
+export async function fetchMemorixList(client, request) {
+    const list = await loadMemorixListDescriptor(client, request.listId);
+    const entity = await loadMemorixEntityDescriptor(client, list.entity);
+    assertListFieldsHumanReadable(list, entity);
+    const sort = resolveMemorixSort(entity, list, request.sort, client);
+    const driverContentType = resolvePaginationDriver(list, sort);
+    assertContentTypeExists(entity, driverContentType);
+    const canonicalType = resolveCanonicalContentType(entity, client.defaults.canonicalContentType);
+    const limit = Math.min(request.page?.limit ?? list.pagination.defaultLimit, list.pagination.maxLimit, client.defaults.maxPageLimit);
+    const offset = request.page?.offset ?? 0;
+    const filterQuery = resolveMemorixFilters(entity, list, request.filters, driverContentType);
+    const projectionPaths = collectProjectionPaths(entity, list.fields);
+    const driverCollection = resolveMemorixCollectionName(entity, driverContentType, client.processEnv);
+    const driverRecords = await memorixRead(client, {
+        entity,
+        source: driverCollection,
+        query: filterQuery,
+        project: projectionPaths,
+        sort: sort.mongoSort,
+        limit: limit + 1,
+        skip: offset,
+    });
+    const hasMore = driverRecords.length > limit;
+    const pageRecords = hasMore ? driverRecords.slice(0, limit) : driverRecords;
+    const issues = [];
+    const rows = [];
+    const extensions = (list.extensions ?? []).filter((ext) => request.includeExtensions?.length
+        ? request.includeExtensions.includes(ext.contentType)
+        : true);
+    const idsByField = new Map();
+    const validDriverRecords = [];
+    for (const record of pageRecords) {
+        const idResult = validateMemorixIdentity(record);
+        if (!idResult.ok) {
+            issues.push(idResult.issue);
+            continue;
+        }
+        const idField = "entityId" in idResult.identity ? "entityId" : "eventId";
+        const idValue = idResult.identity[idField];
+        validDriverRecords.push({ record, idField, idValue });
+        const existing = idsByField.get(idField) ?? [];
+        existing.push(idValue);
+        idsByField.set(idField, existing);
+    }
+    for (const [idField, ids] of idsByField) {
+        const uniqueIds = [...new Set(ids)];
+        let canonicalById = new Map();
+        if (driverContentType !== canonicalType) {
+            const canonicalRecords = await batchFetchByIds(client, entity, canonicalType, idField, uniqueIds, projectionPaths);
+            canonicalById = groupRecordsById(canonicalRecords, idField);
+        }
+        const extensionMaps = new Map();
+        for (const ext of extensions) {
+            const extRecords = await batchFetchByIds(client, entity, ext.contentType, ext.join.by, uniqueIds, collectProjectionPaths(entity, list.fields));
+            extensionMaps.set(ext.contentType, groupRecordsById(extRecords, ext.join.by));
+        }
+        for (const { record: driverRecord, idField: rowIdField, idValue } of validDriverRecords.filter((r) => r.idField === idField)) {
+            const recordsByContentType = {
+                [driverContentType]: [driverRecord],
+            };
+            if (driverContentType !== canonicalType) {
+                const canonicalMatches = canonicalById.get(idValue) ?? [];
+                const canonicalRule = entity.contentTypes[canonicalType]?.defaultMultiMatch ?? {
+                    strategy: "last",
+                };
+                const canonicalResult = applyMultiMatch(canonicalMatches, { strategy: "last", ...canonicalRule }, entity, client);
+                if (canonicalResult.ok && canonicalResult.records.length) {
+                    recordsByContentType[canonicalType] = canonicalResult.records;
+                }
+            }
+            let skipRow = false;
+            for (const ext of extensions) {
+                const extMap = extensionMaps.get(ext.contentType);
+                const extMatches = extMap?.get(idValue) ?? [];
+                const rule = ext.multiMatch ??
+                    (ext.mode === "array"
+                        ? { strategy: "all" }
+                        : { strategy: "last" });
+                const extResult = applyMultiMatch(extMatches, rule, entity, client, {
+                    path: ext.contentType,
+                });
+                if (!extResult.ok) {
+                    issues.push(extResult.issue);
+                    continue;
+                }
+                if (extResult.records.length === 0) {
+                    if (!extensionMissingDefault(ext)) {
+                        skipRow = true;
+                        addExtensionMissingIssue(issues, ext, rowIdField, idValue);
+                        break;
+                    }
+                    if (ext.mode === "array") {
+                        recordsByContentType[ext.contentType] = [];
+                    }
+                    continue;
+                }
+                if (ext.mode === "array") {
+                    recordsByContentType[ext.contentType] = extResult.records;
+                }
+                else {
+                    recordsByContentType[ext.contentType] = [extResult.records[0]];
+                }
+            }
+            if (skipRow)
+                continue;
+            const row = composeMemorixRow(entity, list, recordsByContentType, driverRecord, issues);
+            if (row) {
+                const identity = getIdentityFromRecord(driverRecord);
+                if (identity)
+                    row[identity.field] = identity.value;
+                rows.push(row);
+            }
+        }
+    }
+    const response = {
+        listId: list.id,
+        entity: entity.entityName,
+        page: {
+            limit,
+            offset,
+            count: rows.length,
+            hasMore,
+        },
+        sort: {
+            property: sort.property,
+            direction: sort.direction,
+            contentType: sort.contentType,
+        },
+        rows,
+    };
+    if (issues.length)
+        response.issues = issues;
+    return response;
+}
+//# sourceMappingURL=fetch-list.js.map

package/dist/retrieval/fetch-list.js.map

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

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

@@ -0,0 +1,10 @@
+import type { MemorixEntityDescriptor, MemorixPropertyDescriptor } from "../descriptors/descriptor-types.js";
+import type { MemorixRetrievalIssue } from "../errors/issues.js";
+export declare function resolveFieldValueForList(entity: MemorixEntityDescriptor, recordsByContentType: Record<string, Record<string, unknown>[]>, fieldName: string, issues: MemorixRetrievalIssue[]): unknown;
+export declare function resolveFieldValueForItem(entity: MemorixEntityDescriptor, recordsByContentType: Record<string, Record<string, unknown>[]>, fieldName: string, issues: MemorixRetrievalIssue[], options?: {
+    fetchContent?: boolean;
+    fullContentByField?: Record<string, string>;
+}): unknown;
+export declare function collectProjectionPaths(entity: MemorixEntityDescriptor, fieldNames: string[]): string[];
+export declare function getPropertyDescriptor(entity: MemorixEntityDescriptor, name: string): MemorixPropertyDescriptor | undefined;
+//# sourceMappingURL=resolve-fields.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-fields.d.ts","sourceRoot":"","sources":["../../src/retrieval/resolve-fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,yBAAyB,EAC1B,MAAM,oCAAoC,CAAC;AAO5C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,uBAAuB,EAC/B,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,EAC/D,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,qBAAqB,EAAE,GAC9B,OAAO,CAeT;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,uBAAuB,EAC/B,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,EAC/D,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,qBAAqB,EAAE,EAC/B,OAAO,CAAC,EAAE;IACR,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C,GACA,OAAO,CAoBT;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,uBAAuB,EAC/B,UAAU,EAAE,MAAM,EAAE,GACnB,MAAM,EAAE,CAaV;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,uBAAuB,EAC/B,IAAI,EAAE,MAAM,GACX,yBAAyB,GAAG,SAAS,CAEvC"}

package/dist/retrieval/resolve-fields.js

@@ -0,0 +1,52 @@
+import { resolveMemorixContentObject, shapeContentForItem, shapeContentForList, } from "../content/memorix-content-object.js";
+import { readPropertyValue } from "./resolve-property-source.js";
+export function resolveFieldValueForList(entity, recordsByContentType, fieldName, issues) {
+    const prop = entity.properties[fieldName];
+    if (!prop)
+        return undefined;
+    if (prop.content?.enabled && prop.valueType === "content") {
+        const raw = readPropertyValue(recordsByContentType, entity, fieldName);
+        const parsed = resolveMemorixContentObject(raw);
+        if (!parsed.ok) {
+            issues.push({ ...parsed.issue, path: fieldName });
+            return undefined;
+        }
+        return shapeContentForList(parsed.object, prop.content.listBehavior ?? {});
+    }
+    return readPropertyValue(recordsByContentType, entity, fieldName);
+}
+export function resolveFieldValueForItem(entity, recordsByContentType, fieldName, issues, options) {
+    const prop = entity.properties[fieldName];
+    if (!prop)
+        return undefined;
+    if (prop.content?.enabled && prop.valueType === "content") {
+        const raw = readPropertyValue(recordsByContentType, entity, fieldName);
+        const parsed = resolveMemorixContentObject(raw);
+        if (!parsed.ok) {
+            issues.push({ ...parsed.issue, path: fieldName });
+            return undefined;
+        }
+        const fullContent = options?.fullContentByField?.[fieldName];
+        return shapeContentForItem(parsed.object, prop.content.itemBehavior ?? {}, options?.fetchContent ? fullContent : undefined);
+    }
+    return readPropertyValue(recordsByContentType, entity, fieldName);
+}
+export function collectProjectionPaths(entity, fieldNames) {
+    const paths = new Set(["entityId", "eventId"]);
+    for (const name of fieldNames) {
+        const prop = entity.properties[name];
+        if (!prop)
+            continue;
+        paths.add(prop.source.path);
+        const ct = entity.contentTypes[prop.source.contentType];
+        const dataRoot = ct?.dataRoot ?? entity.defaults.dataRoot;
+        if (dataRoot && dataRoot !== ".") {
+            paths.add(dataRoot);
+        }
+    }
+    return [...paths];
+}
+export function getPropertyDescriptor(entity, name) {
+    return entity.properties[name];
+}
+//# sourceMappingURL=resolve-fields.js.map

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

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

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

@@ -0,0 +1,3 @@
+import type { MemorixEntityDescriptor, MemorixFilterInput, MemorixListDescriptor } from "../descriptors/descriptor-types.js";
+export declare function resolveMemorixFilters(entity: MemorixEntityDescriptor, list: MemorixListDescriptor, filters: MemorixFilterInput[] | undefined, driverContentType: string): Record<string, unknown>;
+//# sourceMappingURL=resolve-filters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-filters.d.ts","sourceRoot":"","sources":["../../src/retrieval/resolve-filters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,kBAAkB,EAElB,qBAAqB,EACtB,MAAM,oCAAoC,CAAC;AAmC5C,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,uBAAuB,EAC/B,IAAI,EAAE,qBAAqB,EAC3B,OAAO,EAAE,kBAAkB,EAAE,GAAG,SAAS,EACzC,iBAAiB,EAAE,MAAM,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6CzB"}

package/dist/retrieval/resolve-filters.js

@@ -0,0 +1,57 @@
+import { throwRetrievalError } from "../errors/errors.js";
+import { resolveMemorixPropertySource } from "./resolve-property-source.js";
+function operatorToMongo(operator, mongoPath, value) {
+    switch (operator) {
+        case "eq":
+            return { [mongoPath]: value };
+        case "ne":
+            return { [mongoPath]: { $ne: value } };
+        case "in":
+            return { [mongoPath]: { $in: Array.isArray(value) ? value : [value] } };
+        case "nin":
+            return { [mongoPath]: { $nin: Array.isArray(value) ? value : [value] } };
+        case "gt":
+            return { [mongoPath]: { $gt: value } };
+        case "gte":
+            return { [mongoPath]: { $gte: value } };
+        case "lt":
+            return { [mongoPath]: { $lt: value } };
+        case "lte":
+            return { [mongoPath]: { $lte: value } };
+        case "exists":
+            return { [mongoPath]: { $exists: value !== false } };
+        case "regex":
+            return { [mongoPath]: { $regex: value } };
+        default:
+            throwRetrievalError("INVALID_FILTER", `Unknown filter operator: ${operator}`);
+    }
+}
+export function resolveMemorixFilters(entity, list, filters, driverContentType) {
+    if (!filters?.length)
+        return {};
+    const clauses = [];
+    const allowed = new Set((list.filters ?? []).map((f) => f.property));
+    for (const filter of filters) {
+        const prop = entity.properties[filter.property];
+        if (!prop) {
+            throwRetrievalError("FILTER_PROPERTY_NOT_ALLOWED", `Unknown filter property: ${filter.property}`);
+        }
+        if (!prop.filterable) {
+            throwRetrievalError("FILTER_PROPERTY_NOT_ALLOWED", `Property "${filter.property}" is not filterable`);
+        }
+        if (list.filters?.length && !allowed.has(filter.property)) {
+            throwRetrievalError("FILTER_PROPERTY_NOT_ALLOWED", `Filter property "${filter.property}" is not allowed on this list`);
+        }
+        const source = resolveMemorixPropertySource(entity, filter.property);
+        if (source.contentType !== driverContentType) {
+            throwRetrievalError("FILTER_PROPERTY_NOT_ALLOWED", `Filter property "${filter.property}" belongs to content type "${source.contentType}", not driver "${driverContentType}"`);
+        }
+        clauses.push(operatorToMongo(filter.operator, source.fullPath, filter.value));
+    }
+    if (clauses.length === 0)
+        return {};
+    if (clauses.length === 1)
+        return clauses[0];
+    return { $and: clauses };
+}
+//# sourceMappingURL=resolve-filters.js.map