@x12i/memorix-retrieval 1.1.0

package/dist/data/identity.d.ts

@@ -0,0 +1,36 @@
+import { type MemorixRetrievalIssue } from "../errors/issues.js";
+export type MemorixIdentity = {
+    entityId?: string;
+    eventId?: string;
+};
+export type IdentityValidationResult = {
+    ok: true;
+    identity: {
+        entityId: string;
+        eventId?: undefined;
+    };
+} | {
+    ok: true;
+    identity: {
+        eventId: string;
+        entityId?: undefined;
+    };
+} | {
+    ok: false;
+    issue: MemorixRetrievalIssue;
+};
+export declare function validateMemorixIdentity(record: Record<string, unknown>, context?: {
+    entityId?: string;
+    eventId?: string;
+    path?: string;
+}): IdentityValidationResult;
+export declare function getIdentityFromRecord(record: Record<string, unknown>): {
+    field: "entityId" | "eventId";
+    value: string;
+} | null;
+export declare function buildIdFilter(field: "entityId" | "eventId", values: string[]): Record<string, unknown>;
+export declare function assertRequestIdentity(entityId?: string, eventId?: string): {
+    field: "entityId" | "eventId";
+    value: string;
+};
+//# sourceMappingURL=identity.d.ts.map

package/dist/data/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/data/identity.ts"],"names":[],"mappings":"AACA,OAAO,EAAe,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAChC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,SAAS,CAAA;KAAE,CAAA;CAAE,GACjE;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;KAAE,CAAA;CAAE,GACjE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,qBAAqB,CAAA;CAAE,CAAC;AAEhD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/D,wBAAwB,CAoC1B;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B;IAAE,KAAK,EAAE,UAAU,GAAG,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAUzD;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,MAAM,EAAE,MAAM,EAAE,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzB;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GACf;IAAE,KAAK,EAAE,UAAU,GAAG,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAiBlD"}

package/dist/data/identity.js

@@ -0,0 +1,68 @@
+import { throwRetrievalError } from "../errors/errors.js";
+import { createIssue } from "../errors/issues.js";
+export function validateMemorixIdentity(record, context) {
+    const entityId = typeof record.entityId === "string" ? record.entityId : undefined;
+    const eventId = typeof record.eventId === "string" ? record.eventId : undefined;
+    const hasEntity = entityId != null && entityId !== "";
+    const hasEvent = eventId != null && eventId !== "";
+    if (hasEntity && hasEvent) {
+        return {
+            ok: false,
+            issue: createIssue({
+                code: "INVALID_IDENTITY",
+                message: "Record has both entityId and eventId",
+                path: context?.path,
+                entityId,
+                eventId,
+            }),
+        };
+    }
+    if (!hasEntity && !hasEvent) {
+        return {
+            ok: false,
+            issue: createIssue({
+                code: "INVALID_IDENTITY",
+                message: "Record has neither entityId nor eventId",
+                path: context?.path,
+                entityId: context?.entityId,
+                eventId: context?.eventId,
+            }),
+        };
+    }
+    if (hasEntity) {
+        return { ok: true, identity: { entityId: entityId } };
+    }
+    return { ok: true, identity: { eventId: eventId } };
+}
+export function getIdentityFromRecord(record) {
+    const result = validateMemorixIdentity(record);
+    if (!result.ok)
+        return null;
+    if ("entityId" in result.identity && result.identity.entityId) {
+        return { field: "entityId", value: result.identity.entityId };
+    }
+    if ("eventId" in result.identity && result.identity.eventId) {
+        return { field: "eventId", value: result.identity.eventId };
+    }
+    return null;
+}
+export function buildIdFilter(field, values) {
+    if (values.length === 1) {
+        return { [field]: values[0] };
+    }
+    return { [field]: { $in: values } };
+}
+export function assertRequestIdentity(entityId, eventId) {
+    const hasEntity = entityId != null && entityId !== "";
+    const hasEvent = eventId != null && eventId !== "";
+    if (hasEntity && hasEvent) {
+        throwRetrievalError("INVALID_REQUEST", "Request must provide exactly one of entityId or eventId");
+    }
+    if (!hasEntity && !hasEvent) {
+        throwRetrievalError("INVALID_REQUEST", "Request must provide entityId or eventId");
+    }
+    if (hasEntity)
+        return { field: "entityId", value: entityId };
+    return { field: "eventId", value: eventId };
+}
+//# sourceMappingURL=identity.js.map

package/dist/data/identity.js.map

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

package/dist/data/memorix-read.d.ts

@@ -0,0 +1,17 @@
+import type { MemorixRetrievalClient } from "../client/types.js";
+import type { XronoxReadParams } from "../client/xronox-like.js";
+import type { MemorixEntityDescriptor } from "../descriptors/descriptor-types.js";
+import type { MemorixTarget } from "../mongo/types.js";
+/** Advanced only: Xronox role names when passing a custom `xronox` client. */
+export declare const DEFAULT_MEMORIX_XRONOX_ROLES: Record<MemorixTarget, string>;
+export declare function resolveMemorixXronoxRole(entity: MemorixEntityDescriptor, client: MemorixRetrievalClient): string;
+export type MemorixReadParams = Omit<XronoxReadParams, "dataType" | "sourceType" | "subSourceType" | "role"> & {
+    source: string;
+    entity: MemorixEntityDescriptor;
+    db?: string;
+    role?: string;
+};
+export declare function memorixRead(client: MemorixRetrievalClient, params: MemorixReadParams): Promise<Record<string, unknown>[]>;
+/** @deprecated Use {@link memorixRead}. */
+export declare const memorixXronoxRead: typeof memorixRead;
+//# sourceMappingURL=memorix-read.d.ts.map

package/dist/data/memorix-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memorix-read.d.ts","sourceRoot":"","sources":["../../src/data/memorix-read.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAGlF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,8EAA8E;AAC9E,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAGtE,CAAC;AAEF,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,uBAAuB,EAC/B,MAAM,EAAE,sBAAsB,GAC7B,MAAM,CAGR;AAED,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,gBAAgB,EAChB,UAAU,GAAG,YAAY,GAAG,eAAe,GAAG,MAAM,CACrD,GAAG;IACF,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,uBAAuB,CAAC;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,wBAAsB,WAAW,CAC/B,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CA+CpC;AAED,2CAA2C;AAC3C,eAAO,MAAM,iBAAiB,oBAAc,CAAC"}

package/dist/data/memorix-read.js

@@ -0,0 +1,55 @@
+import { readMemorixCollection } from "../mongo/read-collection.js";
+import { resolveMemorixDbNameForEntity } from "../mongo/resolve-db.js";
+/** Advanced only: Xronox role names when passing a custom `xronox` client. */
+export const DEFAULT_MEMORIX_XRONOX_ROLES = {
+    entity: "operational",
+    event: "logs",
+};
+export function resolveMemorixXronoxRole(entity, client) {
+    const target = entity.target ?? "entity";
+    return client.xronoxRoles?.[target] ?? DEFAULT_MEMORIX_XRONOX_ROLES[target];
+}
+export async function memorixRead(client, params) {
+    const { entity, db: dbOverride, role: roleOverride, ...readParams } = params;
+    const db = dbOverride ?? resolveMemorixDbNameForEntity(entity, client);
+    if (client.xronox) {
+        const fullParams = {
+            dataType: "metadata",
+            sourceType: "database",
+            subSourceType: "mongo",
+            role: roleOverride ?? resolveMemorixXronoxRole(entity, client),
+            ...readParams,
+            source: params.source,
+        };
+        if (client.xronox.readArray) {
+            const rows = await client.xronox.readArray(fullParams);
+            return rows.map((r) => r);
+        }
+        const result = await client.xronox.read(fullParams);
+        if (Array.isArray(result)) {
+            return result.map((r) => r);
+        }
+        const rows = [];
+        for await (const row of result) {
+            rows.push(row);
+        }
+        return rows;
+    }
+    if (!client.getMongo) {
+        throw new Error("Memorix retrieval client is missing Mongo access. Use createMemorixRetrieval({ catalox }) " +
+            "or createMemorixRetrievalFromEnv({ catalox }).");
+    }
+    const mongo = await client.getMongo();
+    return readMemorixCollection(mongo, {
+        db,
+        collection: params.source,
+        query: readParams.query,
+        project: readParams.project,
+        sort: readParams.sort,
+        limit: readParams.limit,
+        skip: readParams.skip,
+    });
+}
+/** @deprecated Use {@link memorixRead}. */
+export const memorixXronoxRead = memorixRead;
+//# sourceMappingURL=memorix-read.js.map

package/dist/data/memorix-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memorix-read.js","sourceRoot":"","sources":["../../src/data/memorix-read.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AAGvE,8EAA8E;AAC9E,MAAM,CAAC,MAAM,4BAA4B,GAAkC;IACzE,MAAM,EAAE,aAAa;IACrB,KAAK,EAAE,MAAM;CACd,CAAC;AAEF,MAAM,UAAU,wBAAwB,CACtC,MAA+B,EAC/B,MAA8B;IAE9B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,QAAQ,CAAC;IACzC,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,4BAA4B,CAAC,MAAM,CAAC,CAAC;AAC9E,CAAC;AAYD,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAA8B,EAC9B,MAAyB;IAEzB,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,UAAU,EAAE,GAAG,MAAM,CAAC;IAC7E,MAAM,EAAE,GAAG,UAAU,IAAI,6BAA6B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEvE,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,MAAM,UAAU,GAAqB;YACnC,QAAQ,EAAE,UAAU;YACpB,UAAU,EAAE,UAAU;YACtB,aAAa,EAAE,OAAO;YACtB,IAAI,EAAE,YAAY,IAAI,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC;YAC9D,GAAG,UAAU;YACb,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC;QAEF,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YACvD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAA4B,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAA4B,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,IAAI,GAA8B,EAAE,CAAC;QAC3C,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,GAA8B,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,4FAA4F;YAC1F,gDAAgD,CACnD,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;IACtC,OAAO,qBAAqB,CAAC,KAAK,EAAE;QAClC,EAAE;QACF,UAAU,EAAE,MAAM,CAAC,MAAM;QACzB,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,IAAI,EAAE,UAAU,CAAC,IAAI;KACtB,CAAC,CAAC;AACL,CAAC;AAED,2CAA2C;AAC3C,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAC"}

package/dist/data/multi-match.d.ts

@@ -0,0 +1,16 @@
+import type { MemorixRetrievalClient } from "../client/types.js";
+import type { MemorixEntityDescriptor, MemorixMultiMatchRule } from "../descriptors/descriptor-types.js";
+import { type MemorixRetrievalIssue } from "../errors/issues.js";
+export type MultiMatchResult<T> = {
+    ok: true;
+    records: T[];
+} | {
+    ok: false;
+    issue: MemorixRetrievalIssue;
+};
+export declare function resolveEffectiveDatePaths(entity: MemorixEntityDescriptor, rule?: MemorixMultiMatchRule, client?: MemorixRetrievalClient): string[];
+export declare function applyMultiMatch<T extends Record<string, unknown>>(records: T[], rule: MemorixMultiMatchRule, entity: MemorixEntityDescriptor, client?: MemorixRetrievalClient, context?: {
+    path?: string;
+}): MultiMatchResult<T>;
+export declare function defaultExtensionMultiMatch(mode: "extendFields" | "array"): MemorixMultiMatchRule;
+//# sourceMappingURL=multi-match.d.ts.map

package/dist/data/multi-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-match.d.ts","sourceRoot":"","sources":["../../src/data/multi-match.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAe,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAG9E,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,CAAC,EAAE,CAAA;CAAE,GAC1B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,qBAAqB,CAAA;CAAE,CAAC;AAEhD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,uBAAuB,EAC/B,IAAI,CAAC,EAAE,qBAAqB,EAC5B,MAAM,CAAC,EAAE,sBAAsB,GAC9B,MAAM,EAAE,CAYV;AAoBD,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,OAAO,EAAE,CAAC,EAAE,EACZ,IAAI,EAAE,qBAAqB,EAC3B,MAAM,EAAE,uBAAuB,EAC/B,MAAM,CAAC,EAAE,sBAAsB,EAC/B,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1B,gBAAgB,CAAC,CAAC,CAAC,CAiCrB;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,cAAc,GAAG,OAAO,GAC7B,qBAAqB,CAKvB"}

package/dist/data/multi-match.js

@@ -0,0 +1,65 @@
+import { createIssue } from "../errors/issues.js";
+import { getByPath } from "./path.js";
+export function resolveEffectiveDatePaths(entity, rule, client) {
+    const primary = rule?.effectiveDatePath ??
+        entity.defaults.effectiveDatePath ??
+        client?.defaults.effectiveDatePath ??
+        "modifiedAt";
+    const fallbacks = rule?.fallbackEffectiveDatePaths ??
+        entity.defaults.fallbackEffectiveDatePaths ??
+        client?.defaults.fallbackEffectiveDatePaths ??
+        ["capturedAt", "snapshot.capturedAt"];
+    return [primary, ...fallbacks.filter((p) => p !== primary)];
+}
+function getEffectiveDate(record, paths) {
+    for (const path of paths) {
+        const value = getByPath(record, path);
+        if (value == null)
+            continue;
+        const ts = value instanceof Date
+            ? value.getTime()
+            : typeof value === "string" || typeof value === "number"
+                ? new Date(value).getTime()
+                : NaN;
+        if (!Number.isNaN(ts))
+            return ts;
+    }
+    return 0;
+}
+export function applyMultiMatch(records, rule, entity, client, context) {
+    const strategy = rule.strategy ?? "last";
+    if (records.length === 0) {
+        return { ok: true, records: [] };
+    }
+    if (strategy === "all") {
+        return { ok: true, records };
+    }
+    if (strategy === "ignore") {
+        return { ok: true, records: [] };
+    }
+    if (strategy === "error" && records.length > 1) {
+        return {
+            ok: false,
+            issue: createIssue({
+                code: "MULTI_MATCH_ERROR",
+                message: `Multiple records (${records.length}) matched; strategy is error`,
+                path: context?.path,
+                details: { count: records.length },
+            }),
+        };
+    }
+    const paths = resolveEffectiveDatePaths(entity, rule, client);
+    const sorted = [...records].sort((a, b) => getEffectiveDate(b, paths) - getEffectiveDate(a, paths));
+    if (strategy === "first") {
+        return { ok: true, records: [sorted[sorted.length - 1]] };
+    }
+    // last (default)
+    return { ok: true, records: [sorted[0]] };
+}
+export function defaultExtensionMultiMatch(mode) {
+    if (mode === "array") {
+        return { strategy: "all" };
+    }
+    return { strategy: "last" };
+}
+//# sourceMappingURL=multi-match.js.map

package/dist/data/multi-match.js.map

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

package/dist/data/path.d.ts

@@ -0,0 +1,3 @@
+export declare function getByPath(obj: Record<string, unknown>, path: string): unknown;
+export declare function resolveDataRoot(dataRoot: string | undefined, record: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=path.d.ts.map

package/dist/data/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/data/path.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CACvB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,EAAE,MAAM,GACX,OAAO,CAWT;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzB"}

package/dist/data/path.js

@@ -0,0 +1,23 @@
+export function getByPath(obj, path) {
+    if (!path)
+        return obj;
+    const parts = path.split(".");
+    let current = obj;
+    for (const part of parts) {
+        if (current == null || typeof current !== "object") {
+            return undefined;
+        }
+        current = current[part];
+    }
+    return current;
+}
+export function resolveDataRoot(dataRoot, record) {
+    if (!dataRoot || dataRoot === ".")
+        return record;
+    const nested = getByPath(record, dataRoot);
+    if (nested && typeof nested === "object" && !Array.isArray(nested)) {
+        return nested;
+    }
+    return record;
+}
+//# sourceMappingURL=path.js.map

package/dist/data/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../src/data/path.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CACvB,GAA4B,EAC5B,IAAY;IAEZ,IAAI,CAAC,IAAI;QAAE,OAAO,GAAG,CAAC;IACtB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,OAAO,GAAY,GAAG,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YACnD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,GAAI,OAAmC,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,QAA4B,EAC5B,MAA+B;IAE/B,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,GAAG;QAAE,OAAO,MAAM,CAAC;IACjD,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC3C,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnE,OAAO,MAAiC,CAAC;IAC3C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/data/xronox-read.d.ts

@@ -0,0 +1,13 @@
+import type { MemorixRetrievalClient } from "../client/types.js";
+import type { XronoxReadParams } from "../client/xronox-like.js";
+import type { MemorixEntityDescriptor } from "../descriptors/descriptor-types.js";
+import type { MemorixTarget } from "../mongo/types.js";
+/** Default Xronox role names for Memorix entity/event databases (see README). */
+export declare const DEFAULT_MEMORIX_XRONOX_ROLES: Record<MemorixTarget, string>;
+export declare function resolveMemorixXronoxRole(entity: MemorixEntityDescriptor, client: MemorixRetrievalClient): string;
+export declare function memorixXronoxRead(client: MemorixRetrievalClient, params: Omit<XronoxReadParams, "dataType" | "sourceType" | "subSourceType"> & {
+    source: string;
+    entity: MemorixEntityDescriptor;
+    role?: string;
+}): Promise<Record<string, unknown>[]>;
+//# sourceMappingURL=xronox-read.d.ts.map

package/dist/data/xronox-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xronox-read.d.ts","sourceRoot":"","sources":["../../src/data/xronox-read.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAElF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,iFAAiF;AACjF,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAGtE,CAAC;AAEF,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,uBAAuB,EAC/B,MAAM,EAAE,sBAAsB,GAC7B,MAAM,CAGR;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,GAAG,YAAY,GAAG,eAAe,CAAC,GAAG;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,uBAAuB,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GACA,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAyBpC"}

package/dist/data/xronox-read.js

@@ -0,0 +1,34 @@
+import { resolveEntityTarget } from "../mongo/resolve-db.js";
+/** Default Xronox role names for Memorix entity/event databases (see README). */
+export const DEFAULT_MEMORIX_XRONOX_ROLES = {
+    entity: "operational",
+    event: "logs",
+};
+export function resolveMemorixXronoxRole(entity, client) {
+    const target = resolveEntityTarget(entity);
+    return client.xronoxRoles?.[target] ?? DEFAULT_MEMORIX_XRONOX_ROLES[target];
+}
+export async function memorixXronoxRead(client, params) {
+    const { entity, role: roleOverride, ...readParams } = params;
+    const fullParams = {
+        dataType: "metadata",
+        sourceType: "database",
+        subSourceType: "mongo",
+        role: roleOverride ?? resolveMemorixXronoxRole(entity, client),
+        ...readParams,
+    };
+    if (client.xronox.readArray) {
+        const rows = await client.xronox.readArray(fullParams);
+        return rows.map((r) => r);
+    }
+    const result = await client.xronox.read(fullParams);
+    if (Array.isArray(result)) {
+        return result.map((r) => r);
+    }
+    const rows = [];
+    for await (const row of result) {
+        rows.push(row);
+    }
+    return rows;
+}
+//# sourceMappingURL=xronox-read.js.map

package/dist/data/xronox-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xronox-read.js","sourceRoot":"","sources":["../../src/data/xronox-read.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG7D,iFAAiF;AACjF,MAAM,CAAC,MAAM,4BAA4B,GAAkC;IACzE,MAAM,EAAE,aAAa;IACrB,KAAK,EAAE,MAAM;CACd,CAAC;AAEF,MAAM,UAAU,wBAAwB,CACtC,MAA+B,EAC/B,MAA8B;IAE9B,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC3C,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,4BAA4B,CAAC,MAAM,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAA8B,EAC9B,MAIC;IAED,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,UAAU,EAAE,GAAG,MAAM,CAAC;IAE7D,MAAM,UAAU,GAAqB;QACnC,QAAQ,EAAE,UAAU;QACpB,UAAU,EAAE,UAAU;QACtB,aAAa,EAAE,OAAO;QACtB,IAAI,EAAE,YAAY,IAAI,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC;QAC9D,GAAG,UAAU;KACd,CAAC;IAEF,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAA4B,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACpD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAA4B,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,IAAI,GAA8B,EAAE,CAAC;IAC3C,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,GAA8B,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/descriptors/catalog-ids.d.ts

@@ -0,0 +1,5 @@
+export declare const MEMORIX_APP_ID = "memorix";
+export declare const MEMORIX_ENTITY_DESCRIPTORS_CATALOG = "memorix-entity-descriptors";
+export declare const MEMORIX_LIST_DESCRIPTORS_CATALOG = "memorix-list-descriptors";
+export declare const MEMORIX_ITEM_DESCRIPTORS_CATALOG = "memorix-item-descriptors";
+//# sourceMappingURL=catalog-ids.d.ts.map

package/dist/descriptors/catalog-ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-ids.d.ts","sourceRoot":"","sources":["../../src/descriptors/catalog-ids.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,YAAY,CAAC;AAExC,eAAO,MAAM,kCAAkC,+BAA+B,CAAC;AAC/E,eAAO,MAAM,gCAAgC,6BAA6B,CAAC;AAC3E,eAAO,MAAM,gCAAgC,6BAA6B,CAAC"}

package/dist/descriptors/catalog-ids.js

@@ -0,0 +1,5 @@
+export const MEMORIX_APP_ID = "memorix";
+export const MEMORIX_ENTITY_DESCRIPTORS_CATALOG = "memorix-entity-descriptors";
+export const MEMORIX_LIST_DESCRIPTORS_CATALOG = "memorix-list-descriptors";
+export const MEMORIX_ITEM_DESCRIPTORS_CATALOG = "memorix-item-descriptors";
+//# sourceMappingURL=catalog-ids.js.map

package/dist/descriptors/catalog-ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-ids.js","sourceRoot":"","sources":["../../src/descriptors/catalog-ids.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC;AAExC,MAAM,CAAC,MAAM,kCAAkC,GAAG,4BAA4B,CAAC;AAC/E,MAAM,CAAC,MAAM,gCAAgC,GAAG,0BAA0B,CAAC;AAC3E,MAAM,CAAC,MAAM,gCAAgC,GAAG,0BAA0B,CAAC"}

package/dist/descriptors/descriptor-types.d.ts

@@ -0,0 +1,187 @@
+export type MemorixContentObject = {
+    contentKey: string;
+    metadata?: Record<string, unknown>;
+    preview?: string;
+};
+export type MemorixContentStorageDescriptor = {
+    provider: "gcs" | "s3";
+    bucket: string;
+    prefix?: string;
+    maxBytes?: number;
+    encoding?: "utf8";
+    credentialsRef?: string;
+};
+export type MemorixContentDefaults = {
+    format?: "markdown" | "text";
+    storage?: MemorixContentStorageDescriptor;
+    maxBytes?: number;
+    encoding?: "utf8";
+};
+export type MemorixMultiMatchRule = {
+    strategy: "last" | "first" | "all" | "error" | "ignore";
+    effectiveDatePath?: string;
+    fallbackEffectiveDatePaths?: string[];
+};
+export type MemorixContentTypeDescriptor = {
+    postfix: string;
+    collection?: string;
+    dataRoot?: string;
+    isCanonical?: boolean;
+    effectiveDatePath?: string;
+    fallbackEffectiveDatePaths?: string[];
+    defaultMultiMatch?: {
+        extendFields?: MemorixMultiMatchRule["strategy"];
+        array?: MemorixMultiMatchRule["strategy"];
+    };
+};
+export type MemorixPropertyContentDescriptor = {
+    enabled: true;
+    objectType: "memorix-content-object";
+    format?: "markdown" | "text";
+    storage?: MemorixContentStorageDescriptor;
+    listBehavior?: {
+        returnPreview?: boolean;
+        returnMetadata?: boolean;
+        returnContentKey?: boolean;
+        fetchContent?: false;
+    };
+    itemBehavior?: {
+        returnPreview?: boolean;
+        returnMetadata?: boolean;
+        returnContentKey?: boolean;
+        fetchContentWhenRequested?: boolean;
+    };
+};
+export type MemorixPropertyDescriptor = {
+    label: string;
+    source: {
+        contentType: string;
+        path: string;
+    };
+    humanReadable: boolean;
+    sortable?: boolean;
+    filterable?: boolean;
+    list?: boolean;
+    item?: boolean;
+    content?: MemorixPropertyContentDescriptor;
+    valueType?: "string" | "number" | "boolean" | "date" | "datetime" | "enum" | "object" | "array" | "content";
+    format?: string;
+    metadata?: Record<string, unknown>;
+};
+export type MemorixRelationDescriptor = {
+    targetEntity: string;
+    type: "oneToOne" | "oneToMany" | "manyToOne" | "manyToMany";
+    source: {
+        contentType: string;
+        path: string;
+    };
+    target: {
+        contentType: string;
+        path: string;
+    };
+    defaultMode?: "extendFields" | "array";
+    defaultArrayProperty?: string;
+    targetFields?: string[];
+};
+export type MemorixEntityDescriptor = {
+    id: string;
+    entityName: string;
+    /** Selects memorix-entities vs memorix-events via env (default: entity). */
+    target?: "entity" | "event";
+    collectionPrefix: string;
+    identity: {
+        allowedIdFields: Array<"entityId" | "eventId">;
+        requiredExactlyOne: true;
+        defaultIdField: "entityId" | "eventId";
+    };
+    defaults: {
+        canonicalContentType: string;
+        dataRoot: string;
+        effectiveDatePath: string;
+        fallbackEffectiveDatePaths: string[];
+    };
+    contentDefaults?: MemorixContentDefaults;
+    contentTypes: Record<string, MemorixContentTypeDescriptor>;
+    properties: Record<string, MemorixPropertyDescriptor>;
+    relations?: Record<string, MemorixRelationDescriptor>;
+};
+export type MemorixDescriptorFilter = {
+    property: string;
+    operator?: MemorixFilterOperator;
+    value?: unknown;
+    default?: unknown;
+};
+export type MemorixFilterOperator = "eq" | "ne" | "in" | "nin" | "gt" | "gte" | "lt" | "lte" | "exists" | "regex";
+export type MemorixFilterInput = {
+    property: string;
+    operator: MemorixFilterOperator;
+    value?: unknown;
+};
+export type MemorixContentExtensionDescriptor = {
+    contentType: string;
+    mode: "extendFields" | "array";
+    join: {
+        by: "entityId" | "eventId";
+    };
+    arrayProperty?: string;
+    multiMatch?: MemorixMultiMatchRule;
+    onMissing?: {
+        includeRow?: boolean;
+        defaultValue?: unknown;
+    };
+    fields?: Record<string, string>;
+};
+export type MemorixRelationIncludeDescriptor = {
+    relation: string;
+    mode?: "extendFields" | "array";
+    arrayProperty?: string;
+    limit?: number;
+    fields?: string[];
+};
+export type MemorixListDescriptor = {
+    id: string;
+    entity: string;
+    title?: string;
+    leadingContentType: string;
+    pagination: {
+        enabled: true;
+        defaultLimit: number;
+        maxLimit: number;
+    };
+    filters?: MemorixDescriptorFilter[];
+    fields: string[];
+    extensions?: MemorixContentExtensionDescriptor[];
+    includeRelations?: MemorixRelationIncludeDescriptor[];
+    allowedSorts?: string[];
+    defaultSort?: {
+        property: string;
+        direction: "asc" | "desc";
+    };
+    allowSortDrivenLeadingOverride?: boolean;
+};
+export type MemorixItemDescriptor = {
+    id: string;
+    entity: string;
+    title?: string;
+    identity: {
+        idField: "entityId" | "eventId";
+    };
+    contentTypes: Array<{
+        contentType: string;
+        required: boolean;
+        multiMatch?: MemorixMultiMatchRule;
+    }>;
+    sections: Array<{
+        id: string;
+        title: string;
+        fields: string[];
+    }>;
+    includeRelations?: MemorixRelationIncludeDescriptor[];
+    content?: {
+        allowed: true;
+        defaultIncludeFullContent?: boolean;
+        allowedFields?: string[];
+        maxBytes?: number;
+    };
+};
+//# sourceMappingURL=descriptor-types.d.ts.map

package/dist/descriptors/descriptor-types.d.ts.map

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

package/dist/descriptors/descriptor-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=descriptor-types.js.map

package/dist/descriptors/descriptor-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor-types.js","sourceRoot":"","sources":["../../src/descriptors/descriptor-types.ts"],"names":[],"mappings":""}

package/dist/descriptors/load-entity-descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { MemorixRetrievalClient } from "../client/types.js";
+import type { MemorixEntityDescriptor } from "./descriptor-types.js";
+export declare function loadMemorixEntityDescriptor(client: MemorixRetrievalClient, entityDescriptorId: string): Promise<MemorixEntityDescriptor>;
+//# sourceMappingURL=load-entity-descriptor.d.ts.map

package/dist/descriptors/load-entity-descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-entity-descriptor.d.ts","sourceRoot":"","sources":["../../src/descriptors/load-entity-descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAGjE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAMrE,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,sBAAsB,EAC9B,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC,uBAAuB,CAAC,CAoBlC"}