@x12i/memorix-retrieval 1.1.0

package/dist/client/catalox-like.d.ts

@@ -0,0 +1,16 @@
+export type CataloxCatalogItemResult = {
+    outcome: "found";
+    item: {
+        data: Record<string, unknown>;
+    };
+} | {
+    outcome: "not_found";
+} | {
+    outcome: "mapping_blocked";
+};
+export type CataloxLike = {
+    getCatalogItem(context: {
+        appId?: string;
+    }, catalogId: string, itemId: string): Promise<CataloxCatalogItemResult>;
+};
+//# sourceMappingURL=catalox-like.d.ts.map

package/dist/client/catalox-like.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalox-like.d.ts","sourceRoot":"","sources":["../../src/client/catalox-like.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,wBAAwB,GAChC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAA;CAAE,GAC7D;IAAE,OAAO,EAAE,WAAW,CAAA;CAAE,GACxB;IAAE,OAAO,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAEnC,MAAM,MAAM,WAAW,GAAG;IACxB,cAAc,CACZ,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACtC,CAAC"}

package/dist/client/catalox-like.js

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

package/dist/client/catalox-like.js.map

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

package/dist/client/create-client.d.ts

@@ -0,0 +1,3 @@
+import type { CreateMemorixRetrievalOptions, MemorixRetrievalClient } from "./types.js";
+export declare function createMemorixRetrieval(options: CreateMemorixRetrievalOptions): MemorixRetrievalClient;
+//# sourceMappingURL=create-client.d.ts.map

package/dist/client/create-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-client.d.ts","sourceRoot":"","sources":["../../src/client/create-client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,6BAA6B,EAC7B,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAKpB,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,6BAA6B,GACrC,sBAAsB,CAgDxB"}

package/dist/client/create-client.js

@@ -0,0 +1,50 @@
+import { MEMORIX_APP_ID } from "../descriptors/catalog-ids.js";
+import { connectMemorixMongo } from "../mongo/connection.js";
+const DEFAULT_MAX_PAGE_LIMIT = 500;
+const DEFAULT_CONTENT_MAX_BYTES = 5 * 1024 * 1024;
+export function createMemorixRetrieval(options) {
+    const defaults = options.defaults ?? {};
+    const processEnv = options.processEnv ?? process.env;
+    let mongoClient = options.mongo ?? null;
+    let mongoConnect = null;
+    const getMongo = async () => {
+        if (mongoClient)
+            return mongoClient;
+        if (!mongoConnect) {
+            mongoConnect = connectMemorixMongo(processEnv).then((client) => {
+                mongoClient = client;
+                return client;
+            });
+        }
+        return mongoConnect;
+    };
+    const close = async () => {
+        if (mongoClient) {
+            await mongoClient.close();
+            mongoClient = null;
+            mongoConnect = null;
+        }
+    };
+    return {
+        appId: options.appId ?? MEMORIX_APP_ID,
+        catalox: options.catalox,
+        xronox: options.xronox,
+        contentReaders: options.contentReaders,
+        processEnv,
+        memorixDb: options.memorixDb,
+        xronoxRoles: options.xronoxRoles,
+        getMongo: options.xronox ? undefined : getMongo,
+        close: options.xronox ? undefined : close,
+        defaults: {
+            canonicalContentType: defaults.canonicalContentType ?? "snapshots",
+            effectiveDatePath: defaults.effectiveDatePath ?? "modifiedAt",
+            fallbackEffectiveDatePaths: defaults.fallbackEffectiveDatePaths ?? [
+                "capturedAt",
+                "snapshot.capturedAt",
+            ],
+            maxPageLimit: defaults.maxPageLimit ?? DEFAULT_MAX_PAGE_LIMIT,
+            contentMaxBytes: defaults.contentMaxBytes ?? DEFAULT_CONTENT_MAX_BYTES,
+        },
+    };
+}
+//# sourceMappingURL=create-client.js.map

package/dist/client/create-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-client.js","sourceRoot":"","sources":["../../src/client/create-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAM7D,MAAM,sBAAsB,GAAG,GAAG,CAAC;AACnC,MAAM,yBAAyB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAElD,MAAM,UAAU,sBAAsB,CACpC,OAAsC;IAEtC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;IACxC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC;IAErD,IAAI,WAAW,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC;IACxC,IAAI,YAAY,GAAgC,IAAI,CAAC;IAErD,MAAM,QAAQ,GAAG,KAAK,IAA0B,EAAE;QAChD,IAAI,WAAW;YAAE,OAAO,WAAW,CAAC;QACpC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,YAAY,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;gBAC7D,WAAW,GAAG,MAAM,CAAC;gBACrB,OAAO,MAAM,CAAC;YAChB,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,YAAY,CAAC;IACtB,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,KAAK,IAAmB,EAAE;QACtC,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,WAAW,CAAC,KAAK,EAAE,CAAC;YAC1B,WAAW,GAAG,IAAI,CAAC;YACnB,YAAY,GAAG,IAAI,CAAC;QACtB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,cAAc;QACtC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,UAAU;QACV,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;QAC/C,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK;QACzC,QAAQ,EAAE;YACR,oBAAoB,EAClB,QAAQ,CAAC,oBAAoB,IAAI,WAAW;YAC9C,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB,IAAI,YAAY;YAC7D,0BAA0B,EAAE,QAAQ,CAAC,0BAA0B,IAAI;gBACjE,YAAY;gBACZ,qBAAqB;aACtB;YACD,YAAY,EAAE,QAAQ,CAAC,YAAY,IAAI,sBAAsB;YAC7D,eAAe,EAAE,QAAQ,CAAC,eAAe,IAAI,yBAAyB;SACvE;KACF,CAAC;AACJ,CAAC"}

package/dist/client/create-from-env.d.ts

@@ -0,0 +1,3 @@
+import type { CreateMemorixRetrievalFromEnvOptions, MemorixRetrievalClient } from "./types.js";
+export declare function createMemorixRetrievalFromEnv(options: CreateMemorixRetrievalFromEnvOptions): Promise<MemorixRetrievalClient>;
+//# sourceMappingURL=create-from-env.d.ts.map

package/dist/client/create-from-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-from-env.d.ts","sourceRoot":"","sources":["../../src/client/create-from-env.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oCAAoC,EACpC,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAEpB,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,oCAAoC,GAC5C,OAAO,CAAC,sBAAsB,CAAC,CAMjC"}

package/dist/client/create-from-env.js

@@ -0,0 +1,10 @@
+import { connectMemorixMongo } from "../mongo/connection.js";
+import { createMemorixRetrieval } from "./create-client.js";
+export async function createMemorixRetrievalFromEnv(options) {
+    const mongo = await connectMemorixMongo(options.processEnv);
+    return createMemorixRetrieval({
+        ...options,
+        mongo,
+    });
+}
+//# sourceMappingURL=create-from-env.js.map

package/dist/client/create-from-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-from-env.js","sourceRoot":"","sources":["../../src/client/create-from-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAM5D,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,OAA6C;IAE7C,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5D,OAAO,sBAAsB,CAAC;QAC5B,GAAG,OAAO;QACV,KAAK;KACN,CAAC,CAAC;AACL,CAAC"}

package/dist/client/types.d.ts

@@ -0,0 +1,109 @@
+import type { MongoClient } from "mongodb";
+import type { createGcsClient } from "@x12i/helpers/gcs";
+import type { createS3Client } from "@x12i/helpers/s3";
+import type { CataloxLike } from "./catalox-like.js";
+import type { XronoxLike } from "./xronox-like.js";
+import type { MemorixTarget } from "../mongo/types.js";
+export type { CataloxLike } from "./catalox-like.js";
+export type { XronoxLike, XronoxReadParams } from "./xronox-like.js";
+export type ContentReaders = {
+    gcs?: ReturnType<typeof createGcsClient>;
+    s3?: ReturnType<typeof createS3Client>;
+};
+export type CreateMemorixRetrievalOptions = {
+    appId?: string;
+    catalox: CataloxLike;
+    /** Advanced: inject a pre-configured Xronox client instead of built-in Mongo reads. */
+    xronox?: XronoxLike;
+    /** Advanced: reuse an existing MongoClient (otherwise connects lazily from `MONGO_URI`). */
+    mongo?: MongoClient;
+    contentReaders?: ContentReaders;
+    processEnv?: NodeJS.ProcessEnv;
+    /** Advanced: per-target database overrides (default: env resolution). */
+    memorixDb?: Partial<Record<MemorixTarget, string>>;
+    /** Advanced with `xronox`: role names for entity/event databases. */
+    xronoxRoles?: Partial<Record<MemorixTarget, string>>;
+    defaults?: {
+        canonicalContentType?: string;
+        effectiveDatePath?: string;
+        fallbackEffectiveDatePaths?: string[];
+        maxPageLimit?: number;
+        contentMaxBytes?: number;
+    };
+};
+export type CreateMemorixRetrievalFromEnvOptions = Omit<CreateMemorixRetrievalOptions, "xronox" | "mongo">;
+export type MemorixRetrievalClient = {
+    appId: string;
+    catalox: CataloxLike;
+    xronox?: XronoxLike;
+    contentReaders?: ContentReaders;
+    processEnv: NodeJS.ProcessEnv;
+    memorixDb?: Partial<Record<MemorixTarget, string>>;
+    xronoxRoles?: Partial<Record<MemorixTarget, string>>;
+    /** Internal Mongo access (simple mode). */
+    getMongo?: () => Promise<MongoClient>;
+    close?: () => Promise<void>;
+    defaults: {
+        canonicalContentType: string;
+        effectiveDatePath: string;
+        fallbackEffectiveDatePaths: string[];
+        maxPageLimit: number;
+        contentMaxBytes: number;
+    };
+};
+export type FetchMemorixListRequest = {
+    listId: string;
+    page?: {
+        limit?: number;
+        offset?: number;
+    };
+    sort?: {
+        property: string;
+        direction: "asc" | "desc";
+    };
+    filters?: Array<import("../descriptors/descriptor-types.js").MemorixFilterInput>;
+    includeExtensions?: string[];
+    includeRelations?: string[];
+};
+export type FetchMemorixListResponse = {
+    listId: string;
+    entity: string;
+    page: {
+        limit: number;
+        offset: number;
+        count: number;
+        hasMore: boolean;
+    };
+    sort?: {
+        property: string;
+        direction: "asc" | "desc";
+        contentType: string;
+    };
+    rows: Array<Record<string, unknown>>;
+    issues?: import("../errors/issues.js").MemorixRetrievalIssue[];
+};
+export type FetchMemorixItemRequest = {
+    itemDescriptorId: string;
+    entityId?: string;
+    eventId?: string;
+    content?: {
+        include: boolean;
+        fields?: string[];
+        maxBytes?: number;
+    };
+    includeRelations?: string[];
+};
+export type FetchMemorixItemResponse = {
+    itemDescriptorId: string;
+    entity: string;
+    entityId?: string;
+    eventId?: string;
+    sections: Array<{
+        id: string;
+        title: string;
+        fields: Record<string, unknown>;
+    }>;
+    relations?: Record<string, unknown>;
+    issues?: import("../errors/issues.js").MemorixRetrievalIssue[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/client/types.d.ts.map

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

package/dist/client/types.js

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

package/dist/client/types.js.map

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

package/dist/client/xronox-like.d.ts

@@ -0,0 +1,18 @@
+export type XronoxReadParams = {
+    dataType: "metadata";
+    sourceType: "database";
+    subSourceType: "mongo";
+    source: string;
+    /** Xronox role selecting Mongo database (default operational/logs for entity/event). */
+    role?: string;
+    query?: Record<string, unknown>;
+    project?: string[];
+    sort?: string | string[] | Record<string, 1 | -1>;
+    limit?: number;
+    skip?: number;
+};
+export type XronoxLike = {
+    read(params: XronoxReadParams): Promise<unknown[] | AsyncIterable<unknown>>;
+    readArray?(params: XronoxReadParams): Promise<unknown[]>;
+};
+//# sourceMappingURL=xronox-like.d.ts.map

package/dist/client/xronox-like.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xronox-like.d.ts","sourceRoot":"","sources":["../../src/client/xronox-like.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,UAAU,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,wFAAwF;IACxF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,EAAE,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5E,SAAS,CAAC,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;CAC1D,CAAC"}

package/dist/client/xronox-like.js

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

package/dist/client/xronox-like.js.map

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

package/dist/content/fetch-content-object.d.ts

@@ -0,0 +1,16 @@
+import type { MemorixRetrievalClient } from "../client/types.js";
+import type { MemorixContentObject } from "../descriptors/descriptor-types.js";
+import type { MemorixRetrievalIssue } from "../errors/issues.js";
+import type { MemorixEntityDescriptor, MemorixPropertyContentDescriptor } from "../descriptors/descriptor-types.js";
+export declare function fetchMemorixContentObject(client: MemorixRetrievalClient, entity: MemorixEntityDescriptor, fieldContent: MemorixPropertyContentDescriptor, contentObject: MemorixContentObject, options?: {
+    maxBytes?: number;
+    path?: string;
+}): Promise<{
+    ok: true;
+    content: string;
+    format: "markdown" | "text";
+} | {
+    ok: false;
+    issue: MemorixRetrievalIssue;
+}>;
+//# sourceMappingURL=fetch-content-object.d.ts.map

package/dist/content/fetch-content-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-content-object.d.ts","sourceRoot":"","sources":["../../src/content/fetch-content-object.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAMjE,OAAO,KAAK,EACV,uBAAuB,EACvB,gCAAgC,EACjC,MAAM,oCAAoC,CAAC;AAI5C,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE,uBAAuB,EAC/B,YAAY,EAAE,gCAAgC,EAC9C,aAAa,EAAE,oBAAoB,EACnC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CACN;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAA;CAAE,GAC1D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,qBAAqB,CAAA;CAAE,CAC9C,CA4BA"}

package/dist/content/fetch-content-object.js

@@ -0,0 +1,54 @@
+import { buildStorageObjectKey, resolveContentConfig, } from "./resolve-content-config.js";
+import { mapContentFetchError } from "./map-content-errors.js";
+import { createIssue } from "../errors/issues.js";
+export async function fetchMemorixContentObject(client, entity, fieldContent, contentObject, options) {
+    const config = resolveContentConfig(entity, fieldContent, client, {
+        maxBytes: options?.maxBytes,
+    });
+    if (!config) {
+        return {
+            ok: false,
+            issue: createIssue({
+                code: "CONTENT_PERMISSION_DENIED",
+                message: "Content storage is not configured; provide contentReaders with matching provider",
+                path: options?.path,
+            }),
+        };
+    }
+    const objectKey = buildStorageObjectKey(config.storage, contentObject.contentKey);
+    try {
+        const buffer = await readFromStorage(client, config, objectKey);
+        const text = buffer.toString(config.encoding);
+        return { ok: true, content: text, format: config.format };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            issue: mapContentFetchError(error, { path: options?.path }),
+        };
+    }
+}
+async function readFromStorage(client, config, objectKey) {
+    const { provider } = config.storage;
+    const maxBytes = config.maxBytes;
+    if (provider === "gcs") {
+        const gcs = client.contentReaders?.gcs;
+        if (!gcs) {
+            throw Object.assign(new Error("GCS content reader not configured"), {
+                name: "PermissionError",
+            });
+        }
+        return gcs.readObjectBuffer(objectKey, { maxBytes });
+    }
+    if (provider === "s3") {
+        const s3 = client.contentReaders?.s3;
+        if (!s3) {
+            throw Object.assign(new Error("S3 content reader not configured"), {
+                name: "PermissionError",
+            });
+        }
+        return s3.readObjectBuffer(objectKey, { maxBytes });
+    }
+    throw new Error(`Unsupported storage provider: ${provider}`);
+}
+//# sourceMappingURL=fetch-content-object.js.map

package/dist/content/fetch-content-object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-content-object.js","sourceRoot":"","sources":["../../src/content/fetch-content-object.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,qBAAqB,EACrB,oBAAoB,GAErB,MAAM,6BAA6B,CAAC;AAKrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,MAA8B,EAC9B,MAA+B,EAC/B,YAA8C,EAC9C,aAAmC,EACnC,OAA8C;IAK9C,MAAM,MAAM,GAAG,oBAAoB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE;QAChE,QAAQ,EAAE,OAAO,EAAE,QAAQ;KAC5B,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,WAAW,CAAC;gBACjB,IAAI,EAAE,2BAA2B;gBACjC,OAAO,EACL,kFAAkF;gBACpF,IAAI,EAAE,OAAO,EAAE,IAAI;aACpB,CAAC;SACH,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,qBAAqB,CAAC,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAElF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QAChE,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,QAA0B,CAAC,CAAC;QAChE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC5D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,oBAAoB,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;SAC5D,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,MAA8B,EAC9B,MAA6B,EAC7B,SAAiB;IAEjB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC;IACpC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAEjC,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,MAAM,CAAC,cAAc,EAAE,GAAG,CAAC;QACvC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,mCAAmC,CAAC,EAAE;gBAClE,IAAI,EAAE,iBAAiB;aACxB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,GAAG,CAAC,gBAAgB,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,MAAM,EAAE,GAAG,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC;QACrC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,kCAAkC,CAAC,EAAE;gBACjE,IAAI,EAAE,iBAAiB;aACxB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,iCAAiC,QAAQ,EAAE,CAAC,CAAC;AAC/D,CAAC"}

package/dist/content/map-content-errors.d.ts

@@ -0,0 +1,5 @@
+import { type MemorixRetrievalIssue } from "../errors/issues.js";
+export declare function mapContentFetchError(error: unknown, context?: {
+    path?: string;
+}): MemorixRetrievalIssue;
+//# sourceMappingURL=map-content-errors.d.ts.map

package/dist/content/map-content-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-content-errors.d.ts","sourceRoot":"","sources":["../../src/content/map-content-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1B,qBAAqB,CA4CvB"}

package/dist/content/map-content-errors.js

@@ -0,0 +1,39 @@
+import { createIssue } from "../errors/issues.js";
+export function mapContentFetchError(error, context) {
+    const name = error && typeof error === "object" && "name" in error
+        ? String(error.name)
+        : "";
+    const message = error instanceof Error ? error.message : String(error);
+    if (name.includes("NotFound") ||
+        name.includes("NoSuchKey") ||
+        message.toLowerCase().includes("not found")) {
+        return createIssue({
+            code: "CONTENT_NOT_FOUND",
+            message: message || "Content object not found",
+            path: context?.path,
+        });
+    }
+    if (name.includes("TooLarge") || message.toLowerCase().includes("too large")) {
+        return createIssue({
+            code: "CONTENT_TOO_LARGE",
+            message: message || "Content exceeds maxBytes",
+            path: context?.path,
+        });
+    }
+    if (name.includes("Permission") ||
+        name.includes("AccessDenied") ||
+        name.includes("Forbidden")) {
+        return createIssue({
+            code: "CONTENT_PERMISSION_DENIED",
+            message: message || "Content access denied",
+            path: context?.path,
+        });
+    }
+    return createIssue({
+        code: "CONTENT_NOT_FOUND",
+        message: message || "Failed to fetch content",
+        path: context?.path,
+        severity: "error",
+    });
+}
+//# sourceMappingURL=map-content-errors.js.map

package/dist/content/map-content-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-content-errors.js","sourceRoot":"","sources":["../../src/content/map-content-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA8B,MAAM,qBAAqB,CAAC;AAE9E,MAAM,UAAU,oBAAoB,CAClC,KAAc,EACd,OAA2B;IAE3B,MAAM,IAAI,GACR,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK;QACnD,CAAC,CAAC,MAAM,CAAE,KAA0B,CAAC,IAAI,CAAC;QAC1C,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEzD,IACE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;QACzB,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;QAC1B,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,EAC3C,CAAC;QACD,OAAO,WAAW,CAAC;YACjB,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,OAAO,IAAI,0BAA0B;YAC9C,IAAI,EAAE,OAAO,EAAE,IAAI;SACpB,CAAC,CAAC;IACL,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7E,OAAO,WAAW,CAAC;YACjB,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,OAAO,IAAI,0BAA0B;YAC9C,IAAI,EAAE,OAAO,EAAE,IAAI;SACpB,CAAC,CAAC;IACL,CAAC;IACD,IACE,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC3B,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAC1B,CAAC;QACD,OAAO,WAAW,CAAC;YACjB,IAAI,EAAE,2BAA2B;YACjC,OAAO,EAAE,OAAO,IAAI,uBAAuB;YAC3C,IAAI,EAAE,OAAO,EAAE,IAAI;SACpB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,WAAW,CAAC;QACjB,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,OAAO,IAAI,yBAAyB;QAC7C,IAAI,EAAE,OAAO,EAAE,IAAI;QACnB,QAAQ,EAAE,OAAO;KAClB,CAAC,CAAC;AACL,CAAC"}

package/dist/content/memorix-content-object.d.ts

@@ -0,0 +1,21 @@
+import type { MemorixContentObject } from "../descriptors/descriptor-types.js";
+import { type MemorixRetrievalIssue } from "../errors/issues.js";
+export type { MemorixContentObject };
+export declare function resolveMemorixContentObject(value: unknown): {
+    ok: true;
+    object: MemorixContentObject;
+} | {
+    ok: false;
+    issue: MemorixRetrievalIssue;
+};
+export declare function shapeContentForList(object: MemorixContentObject, behavior: {
+    returnPreview?: boolean;
+    returnMetadata?: boolean;
+    returnContentKey?: boolean;
+}): Record<string, unknown>;
+export declare function shapeContentForItem(object: MemorixContentObject, behavior: {
+    returnPreview?: boolean;
+    returnMetadata?: boolean;
+    returnContentKey?: boolean;
+}, fullContent?: string): Record<string, unknown>;
+//# sourceMappingURL=memorix-content-object.d.ts.map

package/dist/content/memorix-content-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memorix-content-object.d.ts","sourceRoot":"","sources":["../../src/content/memorix-content-object.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAe,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,YAAY,EAAE,oBAAoB,EAAE,CAAC;AAErC,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,GACb;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,qBAAqB,CAAA;CAAE,CAgC1F;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,oBAAoB,EAC5B,QAAQ,EAAE;IACR,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,GACA,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzB;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,oBAAoB,EAC5B,QAAQ,EAAE;IACR,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,EACD,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB"}

package/dist/content/memorix-content-object.js

@@ -0,0 +1,54 @@
+import { createIssue } from "../errors/issues.js";
+export function resolveMemorixContentObject(value) {
+    if (value == null || typeof value !== "object" || Array.isArray(value)) {
+        return {
+            ok: false,
+            issue: createIssue({
+                code: "MISSING_CONTENT_OBJECT",
+                message: "Expected memorix-content-object",
+            }),
+        };
+    }
+    const obj = value;
+    const contentKey = obj.contentKey;
+    if (typeof contentKey !== "string" || !contentKey) {
+        return {
+            ok: false,
+            issue: createIssue({
+                code: "MISSING_CONTENT_KEY",
+                message: "Content object missing contentKey",
+            }),
+        };
+    }
+    return {
+        ok: true,
+        object: {
+            contentKey,
+            metadata: obj.metadata && typeof obj.metadata === "object" && !Array.isArray(obj.metadata)
+                ? obj.metadata
+                : undefined,
+            preview: typeof obj.preview === "string" ? obj.preview : undefined,
+        },
+    };
+}
+export function shapeContentForList(object, behavior) {
+    const out = {};
+    if (behavior.returnPreview !== false && object.preview != null) {
+        out.preview = object.preview;
+    }
+    if (behavior.returnMetadata !== false && object.metadata) {
+        out.metadata = object.metadata;
+    }
+    if (behavior.returnContentKey && object.contentKey) {
+        out.contentKey = object.contentKey;
+    }
+    return out;
+}
+export function shapeContentForItem(object, behavior, fullContent) {
+    const out = shapeContentForList(object, behavior);
+    if (fullContent != null) {
+        out.content = fullContent;
+    }
+    return out;
+}
+//# sourceMappingURL=memorix-content-object.js.map

package/dist/content/memorix-content-object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memorix-content-object.js","sourceRoot":"","sources":["../../src/content/memorix-content-object.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAA8B,MAAM,qBAAqB,CAAC;AAI9E,MAAM,UAAU,2BAA2B,CACzC,KAAc;IAEd,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvE,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,WAAW,CAAC;gBACjB,IAAI,EAAE,wBAAwB;gBAC9B,OAAO,EAAE,iCAAiC;aAC3C,CAAC;SACH,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;IAClC,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,UAAU,EAAE,CAAC;QAClD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,WAAW,CAAC;gBACjB,IAAI,EAAE,qBAAqB;gBAC3B,OAAO,EAAE,mCAAmC;aAC7C,CAAC;SACH,CAAC;IACJ,CAAC;IACD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,MAAM,EAAE;YACN,UAAU;YACV,QAAQ,EACN,GAAG,CAAC,QAAQ,IAAI,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;gBAC9E,CAAC,CAAE,GAAG,CAAC,QAAoC;gBAC3C,CAAC,CAAC,SAAS;YACf,OAAO,EAAE,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;SACnE;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAA4B,EAC5B,QAIC;IAED,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,IAAI,QAAQ,CAAC,aAAa,KAAK,KAAK,IAAI,MAAM,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;QAC/D,GAAG,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,CAAC;IACD,IAAI,QAAQ,CAAC,cAAc,KAAK,KAAK,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACzD,GAAG,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IACjC,CAAC;IACD,IAAI,QAAQ,CAAC,gBAAgB,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACnD,GAAG,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACrC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAA4B,EAC5B,QAIC,EACD,WAAoB;IAEpB,MAAM,GAAG,GAAG,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAClD,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;QACxB,GAAG,CAAC,OAAO,GAAG,WAAW,CAAC;IAC5B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/content/resolve-content-config.d.ts

@@ -0,0 +1,19 @@
+import type { MemorixRetrievalClient } from "../client/types.js";
+import type { MemorixContentStorageDescriptor, MemorixEntityDescriptor, MemorixPropertyContentDescriptor } from "../descriptors/descriptor-types.js";
+export type ResolvedContentConfig = {
+    format: "markdown" | "text";
+    storage: MemorixContentStorageDescriptor;
+    maxBytes: number;
+    encoding: string;
+};
+export declare function resolveContentMaxBytes(client: MemorixRetrievalClient, options: {
+    requestMaxBytes?: number;
+    itemDescriptorMaxBytes?: number;
+    fieldMaxBytes?: number;
+    entityMaxBytes?: number;
+}): number;
+export declare function resolveContentConfig(entity: MemorixEntityDescriptor, fieldContent: MemorixPropertyContentDescriptor, client: MemorixRetrievalClient, overrides?: {
+    maxBytes?: number;
+}): ResolvedContentConfig | null;
+export declare function buildStorageObjectKey(storage: MemorixContentStorageDescriptor, contentKey: string): string;
+//# sourceMappingURL=resolve-content-config.d.ts.map

package/dist/content/resolve-content-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-content-config.d.ts","sourceRoot":"","sources":["../../src/content/resolve-content-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAEV,+BAA+B,EAC/B,uBAAuB,EACvB,gCAAgC,EACjC,MAAM,oCAAoC,CAAC;AAE5C,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC;IAC5B,OAAO,EAAE,+BAA+B,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE;IACP,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GACA,MAAM,CAWR;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,uBAAuB,EAC/B,YAAY,EAAE,gCAAgC,EAC9C,MAAM,EAAE,sBAAsB,EAC9B,SAAS,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC,qBAAqB,GAAG,IAAI,CAoB9B;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,+BAA+B,EACxC,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR"}

package/dist/content/resolve-content-config.js

@@ -0,0 +1,37 @@
+export function resolveContentMaxBytes(client, options) {
+    const candidates = [
+        options.requestMaxBytes,
+        options.itemDescriptorMaxBytes,
+        options.fieldMaxBytes,
+        options.entityMaxBytes,
+        client.defaults.contentMaxBytes,
+    ].filter((n) => typeof n === "number" && n > 0);
+    const resolved = Math.min(...candidates);
+    return Math.min(resolved, client.defaults.contentMaxBytes);
+}
+export function resolveContentConfig(entity, fieldContent, client, overrides) {
+    const defaults = entity.contentDefaults ?? {};
+    const storage = fieldContent.storage ?? defaults.storage;
+    if (!storage?.provider || !storage.bucket) {
+        return null;
+    }
+    const maxBytes = resolveContentMaxBytes(client, {
+        requestMaxBytes: overrides?.maxBytes,
+        fieldMaxBytes: storage.maxBytes,
+        entityMaxBytes: defaults.maxBytes,
+    });
+    return {
+        format: fieldContent.format ?? defaults.format ?? "markdown",
+        storage,
+        maxBytes,
+        encoding: storage.encoding ?? defaults.encoding ?? "utf8",
+    };
+}
+export function buildStorageObjectKey(storage, contentKey) {
+    const prefix = storage.prefix?.replace(/\/$/, "") ?? "";
+    if (!prefix)
+        return contentKey.replace(/^\//, "");
+    const key = contentKey.replace(/^\//, "");
+    return `${prefix}/${key}`;
+}
+//# sourceMappingURL=resolve-content-config.js.map

package/dist/content/resolve-content-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-content-config.js","sourceRoot":"","sources":["../../src/content/resolve-content-config.ts"],"names":[],"mappings":"AAeA,MAAM,UAAU,sBAAsB,CACpC,MAA8B,EAC9B,OAKC;IAED,MAAM,UAAU,GAAG;QACjB,OAAO,CAAC,eAAe;QACvB,OAAO,CAAC,sBAAsB;QAC9B,OAAO,CAAC,aAAa;QACrB,OAAO,CAAC,cAAc;QACtB,MAAM,CAAC,QAAQ,CAAC,eAAe;KAChC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAE7D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC;IACzC,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,MAA+B,EAC/B,YAA8C,EAC9C,MAA8B,EAC9B,SAAiC;IAEjC,MAAM,QAAQ,GAAG,MAAM,CAAC,eAAe,IAAI,EAAE,CAAC;IAC9C,MAAM,OAAO,GACX,YAAY,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC;IAC3C,IAAI,CAAC,OAAO,EAAE,QAAQ,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,sBAAsB,CAAC,MAAM,EAAE;QAC9C,eAAe,EAAE,SAAS,EAAE,QAAQ;QACpC,aAAa,EAAE,OAAO,CAAC,QAAQ;QAC/B,cAAc,EAAE,QAAQ,CAAC,QAAQ;KAClC,CAAC,CAAC;IAEH,OAAO;QACL,MAAM,EAAE,YAAY,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,IAAI,UAAU;QAC5D,OAAO;QACP,QAAQ;QACR,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,IAAI,MAAM;KAC1D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,OAAwC,EACxC,UAAkB;IAElB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;IACxD,IAAI,CAAC,MAAM;QAAE,OAAO,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC1C,OAAO,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC;AAC5B,CAAC"}

package/dist/data/collection-name.d.ts

@@ -0,0 +1,4 @@
+import type { MemorixContentTypeDescriptor, MemorixEntityDescriptor } from "../descriptors/descriptor-types.js";
+export declare function resolveMemorixCollectionName(entity: MemorixEntityDescriptor, contentTypeKey: string, env?: NodeJS.ProcessEnv): string;
+export declare function resolveMemorixCollectionNameFromDescriptor(entity: MemorixEntityDescriptor, contentType: MemorixContentTypeDescriptor, env?: NodeJS.ProcessEnv): string;
+//# sourceMappingURL=collection-name.d.ts.map

package/dist/data/collection-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-name.d.ts","sourceRoot":"","sources":["../../src/data/collection-name.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAC5B,uBAAuB,EACxB,MAAM,oCAAoC,CAAC;AAK5C,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,uBAAuB,EAC/B,cAAc,EAAE,MAAM,EACtB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CASR;AAED,wBAAgB,0CAA0C,CACxD,MAAM,EAAE,uBAAuB,EAC/B,WAAW,EAAE,4BAA4B,EACzC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAaR"}

package/dist/data/collection-name.js

@@ -0,0 +1,23 @@
+import { throwRetrievalError } from "../errors/errors.js";
+import { targetCollectionEnvKey } from "../mongo/env.js";
+import { resolveEntityTarget } from "../mongo/resolve-db.js";
+export function resolveMemorixCollectionName(entity, contentTypeKey, env = process.env) {
+    const ct = entity.contentTypes[contentTypeKey];
+    if (!ct) {
+        throwRetrievalError("UNKNOWN_CONTENT_TYPE", `Unknown content type "${contentTypeKey}" on entity "${entity.id}"`);
+    }
+    return resolveMemorixCollectionNameFromDescriptor(entity, ct, env);
+}
+export function resolveMemorixCollectionNameFromDescriptor(entity, contentType, env = process.env) {
+    if (contentType.collection) {
+        return contentType.collection;
+    }
+    const target = resolveEntityTarget(entity);
+    const envKey = targetCollectionEnvKey(target, entity.entityName);
+    const fromEnv = env[envKey]?.trim();
+    if (fromEnv) {
+        return fromEnv;
+    }
+    return `${entity.collectionPrefix}-${contentType.postfix}`;
+}
+//# sourceMappingURL=collection-name.js.map

package/dist/data/collection-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-name.js","sourceRoot":"","sources":["../../src/data/collection-name.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,UAAU,4BAA4B,CAC1C,MAA+B,EAC/B,cAAsB,EACtB,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;IAC/C,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,mBAAmB,CACjB,sBAAsB,EACtB,yBAAyB,cAAc,gBAAgB,MAAM,CAAC,EAAE,GAAG,CACpE,CAAC;IACJ,CAAC;IACD,OAAO,0CAA0C,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,0CAA0C,CACxD,MAA+B,EAC/B,WAAyC,EACzC,MAAyB,OAAO,CAAC,GAAG;IAEpC,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;QAC3B,OAAO,WAAW,CAAC,UAAU,CAAC;IAChC,CAAC;IAED,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;IACpC,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,GAAG,MAAM,CAAC,gBAAgB,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;AAC7D,CAAC"}