@x12i/memorix-writer 1.0.0

package/dist/mongo/collection-documents.js

@@ -0,0 +1,100 @@
+import { assertMemorixCollectionName } from "./collection-name-validate.js";
+import { normalizeMemorixFilter } from "./id-normalize.js";
+const DEFAULT_LIST_LIMIT = 50;
+const MAX_LIST_LIMIT = 500;
+const MAX_LIST_SKIP = 50_000;
+function assertTierReady(tier) {
+    if (!tier.memorixReady) {
+        throw new Error("Memorix: tier.init() must be called before this operation");
+    }
+}
+function resolveCollection(collectionName) {
+    return assertMemorixCollectionName(collectionName);
+}
+export async function listMemorixCollectionDocuments(tier, args) {
+    assertTierReady(tier);
+    const col = tier.db.collection(resolveCollection(args.collection));
+    const filter = normalizeMemorixFilter(args.filter ?? {});
+    const skip = args.skip ?? 0;
+    if (skip < 0 || skip > MAX_LIST_SKIP) {
+        throw new Error(`Memorix: skip must be between 0 and ${MAX_LIST_SKIP}`);
+    }
+    const limit = args.limit ?? DEFAULT_LIST_LIMIT;
+    if (limit < 1 || limit > MAX_LIST_LIMIT) {
+        throw new Error(`Memorix: limit must be between 1 and ${MAX_LIST_LIMIT}`);
+    }
+    const sort = args.sort ?? { _id: 1 };
+    if (args.includeTotal) {
+        const facet = await col
+            .aggregate([
+            { $match: filter },
+            {
+                $facet: {
+                    docs: [
+                        { $sort: sort },
+                        { $skip: skip },
+                        { $limit: limit },
+                        ...(args.projection ? [{ $project: args.projection }] : []),
+                    ],
+                    total: [{ $count: "c" }],
+                },
+            },
+        ])
+            .toArray();
+        const f = facet[0];
+        return {
+            documents: f.docs ?? [],
+            totalCount: f.total?.[0]?.c ?? 0,
+        };
+    }
+    const documents = (await col
+        .find(filter, {
+        sort,
+        skip,
+        limit,
+        projection: args.projection,
+    })
+        .toArray());
+    return { documents };
+}
+export async function getMemorixCollectionDocument(tier, args) {
+    assertTierReady(tier);
+    const col = tier.db.collection(resolveCollection(args.collection));
+    const filter = normalizeMemorixFilter(args.filter);
+    const doc = await col.findOne(filter, {
+        projection: args.projection,
+    });
+    return doc;
+}
+export async function insertMemorixCollectionDocument(tier, args) {
+    assertTierReady(tier);
+    const col = tier.db.collection(resolveCollection(args.collection));
+    const r = await col.insertOne(args.document);
+    return { insertedId: r.insertedId };
+}
+export async function replaceMemorixCollectionDocument(tier, args) {
+    assertTierReady(tier);
+    const col = tier.db.collection(resolveCollection(args.collection));
+    const filter = normalizeMemorixFilter(args.filter);
+    const r = await col.replaceOne(filter, args.replacement, { upsert: args.upsert ?? false });
+    return {
+        matchedCount: r.matchedCount,
+        modifiedCount: r.modifiedCount,
+        upsertedCount: r.upsertedCount,
+    };
+}
+export async function updateMemorixCollectionDocument(tier, args) {
+    assertTierReady(tier);
+    const col = tier.db.collection(resolveCollection(args.collection));
+    const filter = normalizeMemorixFilter(args.filter);
+    const r = await col.updateOne(filter, args.update);
+    return { matchedCount: r.matchedCount, modifiedCount: r.modifiedCount };
+}
+export async function patchMemorixCollectionDocument(tier, args) {
+    return updateMemorixCollectionDocument(tier, {
+        collection: args.collection,
+        filter: args.filter,
+        update: { $set: args.$set },
+    });
+}
+//# sourceMappingURL=collection-documents.js.map

package/dist/mongo/collection-documents.js.map

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

package/dist/mongo/collection-name-validate.d.ts

@@ -0,0 +1,2 @@
+export declare function assertMemorixCollectionName(collectionName: string): string;
+//# sourceMappingURL=collection-name-validate.d.ts.map

package/dist/mongo/collection-name-validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-name-validate.d.ts","sourceRoot":"","sources":["../../src/mongo/collection-name-validate.ts"],"names":[],"mappings":"AAGA,wBAAgB,2BAA2B,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAmB1E"}

package/dist/mongo/collection-name-validate.js

@@ -0,0 +1,19 @@
+const MEMORIX_COLLECTION_NAME_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9-]*$/;
+const MEMORIX_COLLECTION_NAME_MAX_LENGTH = 401;
+export function assertMemorixCollectionName(collectionName) {
+    const trimmed = collectionName.trim();
+    if (!trimmed) {
+        throw new Error("collectionName must be a non-empty trimmed string");
+    }
+    if (trimmed.length > MEMORIX_COLLECTION_NAME_MAX_LENGTH) {
+        throw new Error(`collectionName exceeds max length ${MEMORIX_COLLECTION_NAME_MAX_LENGTH}`);
+    }
+    if (trimmed.startsWith("_")) {
+        throw new Error("collectionName must not start with '_'");
+    }
+    if (!MEMORIX_COLLECTION_NAME_PATTERN.test(trimmed)) {
+        throw new Error("collectionName must match /^[a-zA-Z0-9][a-zA-Z0-9-]*$/");
+    }
+    return trimmed;
+}
+//# sourceMappingURL=collection-name-validate.js.map

package/dist/mongo/collection-name-validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-name-validate.js","sourceRoot":"","sources":["../../src/mongo/collection-name-validate.ts"],"names":[],"mappings":"AAAA,MAAM,+BAA+B,GAAG,4BAA4B,CAAC;AACrE,MAAM,kCAAkC,GAAG,GAAG,CAAC;AAE/C,MAAM,UAAU,2BAA2B,CAAC,cAAsB;IAChE,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,EAAE,CAAC;IACtC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,kCAAkC,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CACb,qCAAqC,kCAAkC,EAAE,CAC1E,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,CAAC,+BAA+B,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CACb,wDAAwD,CACzD,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/mongo/connection.d.ts

@@ -0,0 +1,3 @@
+import { MongoClient } from "mongodb";
+export declare function connectMemorixMongo(env?: NodeJS.ProcessEnv): Promise<MongoClient>;
+//# sourceMappingURL=connection.d.ts.map

package/dist/mongo/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/mongo/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGtC,wBAAsB,mBAAmB,CACvC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,WAAW,CAAC,CAItB"}

package/dist/mongo/connection.js

@@ -0,0 +1,8 @@
+import { MongoClient } from "mongodb";
+import { resolveMongoUri } from "./env.js";
+export async function connectMemorixMongo(env = process.env) {
+    const client = new MongoClient(resolveMongoUri(env));
+    await client.connect();
+    return client;
+}
+//# sourceMappingURL=connection.js.map

package/dist/mongo/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/mongo/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IACvB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/mongo/default-collections.d.ts

@@ -0,0 +1,3 @@
+export declare const DEFAULT_ENTITY_COLLECTION_CANDIDATES: Record<string, string[]>;
+export declare const DEFAULT_EVENT_COLLECTION_CANDIDATES: Record<string, string[]>;
+//# sourceMappingURL=default-collections.d.ts.map

package/dist/mongo/default-collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-collections.d.ts","sourceRoot":"","sources":["../../src/mongo/default-collections.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oCAAoC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAQzE,CAAC;AAEF,eAAO,MAAM,mCAAmC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAGxE,CAAC"}

package/dist/mongo/default-collections.js

@@ -0,0 +1,14 @@
+export const DEFAULT_ENTITY_COLLECTION_CANDIDATES = {
+    vulnerability: ["vulnerabilities", "vulnerability"],
+    "variabilities-group": [
+        "vulnerability-groups",
+        "vulnerabilities-groups",
+        "variabilities-groups",
+    ],
+    assets: ["assets"],
+};
+export const DEFAULT_EVENT_COLLECTION_CANDIDATES = {
+    vulnerability: ["vulnerability-events", "vulnerabilities-events"],
+    assets: ["asset-events", "assets-events"],
+};
+//# sourceMappingURL=default-collections.js.map

package/dist/mongo/default-collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-collections.js","sourceRoot":"","sources":["../../src/mongo/default-collections.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oCAAoC,GAA6B;IAC5E,aAAa,EAAE,CAAC,iBAAiB,EAAE,eAAe,CAAC;IACnD,qBAAqB,EAAE;QACrB,sBAAsB;QACtB,wBAAwB;QACxB,sBAAsB;KACvB;IACD,MAAM,EAAE,CAAC,QAAQ,CAAC;CACnB,CAAC;AAEF,MAAM,CAAC,MAAM,mCAAmC,GAA6B;IAC3E,aAAa,EAAE,CAAC,sBAAsB,EAAE,wBAAwB,CAAC;IACjE,MAAM,EAAE,CAAC,cAAc,EAAE,eAAe,CAAC;CAC1C,CAAC"}

package/dist/mongo/env.d.ts

@@ -0,0 +1,6 @@
+import type { MemorixTarget } from "./target.js";
+export declare function resolveMongoUri(env?: NodeJS.ProcessEnv): string;
+export declare function resolveMemorixDbName(target: MemorixTarget, env?: NodeJS.ProcessEnv): string;
+export declare function resolveDefaultSourceDbName(env?: NodeJS.ProcessEnv): string | undefined;
+export declare function targetCollectionEnvKey(target: MemorixTarget, entityType: string): string;
+//# sourceMappingURL=env.d.ts.map

package/dist/mongo/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/mongo/env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAUjD,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAM5E;AAKD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,aAAa,EACrB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAoBR;AAED,wBAAgB,0BAA0B,CACxC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,GAAG,SAAS,CAQpB;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR"}

package/dist/mongo/env.js

@@ -0,0 +1,33 @@
+function firstNonEmpty(...vals) {
+    for (const v of vals) {
+        const t = v?.trim();
+        if (t)
+            return t;
+    }
+    return undefined;
+}
+export function resolveMongoUri(env = process.env) {
+    const uri = firstNonEmpty(env.MONGO_URI, env.MONGO_CONNECTION_STRING);
+    if (!uri) {
+        throw new Error("Missing MONGO_URI or MONGO_CONNECTION_STRING in environment");
+    }
+    return uri;
+}
+const MEMORIX_ENTITIES_DB_DEFAULT = "memorix-entities";
+const MEMORIX_EVENTS_DB_DEFAULT = "memorix-events";
+export function resolveMemorixDbName(target, env = process.env) {
+    if (target === "entity") {
+        return (firstNonEmpty(env.MEMORIX_ENTITIES_DB, env.MEMORIX_DB_ENTITIES, env.memorix_entities_db, env.MEMORIX_DB) ?? MEMORIX_ENTITIES_DB_DEFAULT);
+    }
+    return (firstNonEmpty(env.MEMORIX_EVENTS_DB, env.MEMORIX_DB_EVENTS, env.memorix_events_db, env.MEMORIX_DB) ?? MEMORIX_EVENTS_DB_DEFAULT);
+}
+export function resolveDefaultSourceDbName(env = process.env) {
+    return firstNonEmpty(env.MEMORIX_SOURCE_DB, env.SOURCE_DATABASE_NAME, env.SOURCEDATABASENAME, env.sourceDatabaseName, env.source_database_name);
+}
+export function targetCollectionEnvKey(target, entityType) {
+    const normalized = entityType.replace(/-/g, "_").toUpperCase();
+    return target === "entity"
+        ? `MEMORIX_ENTITIES_COLLECTION_${normalized}`
+        : `MEMORIX_EVENTS_COLLECTION_${normalized}`;
+}
+//# sourceMappingURL=env.js.map

package/dist/mongo/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/mongo/env.ts"],"names":[],"mappings":"AAEA,SAAS,aAAa,CAAC,GAAG,IAA4B;IACpD,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC;QACpB,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAyB,OAAO,CAAC,GAAG;IAClE,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACtE,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,2BAA2B,GAAG,kBAAkB,CAAC;AACvD,MAAM,yBAAyB,GAAG,gBAAgB,CAAC;AAEnD,MAAM,UAAU,oBAAoB,CAClC,MAAqB,EACrB,MAAyB,OAAO,CAAC,GAAG;IAEpC,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,OAAO,CACL,aAAa,CACX,GAAG,CAAC,mBAAmB,EACvB,GAAG,CAAC,mBAAmB,EACvB,GAAG,CAAC,mBAAmB,EACvB,GAAG,CAAC,UAAU,CACf,IAAI,2BAA2B,CACjC,CAAC;IACJ,CAAC;IAED,OAAO,CACL,aAAa,CACX,GAAG,CAAC,iBAAiB,EACrB,GAAG,CAAC,iBAAiB,EACrB,GAAG,CAAC,iBAAiB,EACrB,GAAG,CAAC,UAAU,CACf,IAAI,yBAAyB,CAC/B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,MAAyB,OAAO,CAAC,GAAG;IAEpC,OAAO,aAAa,CAClB,GAAG,CAAC,iBAAiB,EACrB,GAAG,CAAC,oBAAoB,EACxB,GAAG,CAAC,kBAAkB,EACtB,GAAG,CAAC,kBAAkB,EACtB,GAAG,CAAC,oBAAoB,CACzB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,MAAqB,EACrB,UAAkB;IAElB,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/D,OAAO,MAAM,KAAK,QAAQ;QACxB,CAAC,CAAC,+BAA+B,UAAU,EAAE;QAC7C,CAAC,CAAC,6BAA6B,UAAU,EAAE,CAAC;AAChD,CAAC"}

package/dist/mongo/id-normalize.d.ts

@@ -0,0 +1,3 @@
+export declare function maybeObjectId(value: unknown): unknown;
+export declare function normalizeMemorixFilter(filter: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=id-normalize.d.ts.map

package/dist/mongo/id-normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-normalize.d.ts","sourceRoot":"","sources":["../../src/mongo/id-normalize.ts"],"names":[],"mappings":"AAIA,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CASrD;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzB"}

package/dist/mongo/id-normalize.js

@@ -0,0 +1,23 @@
+import { ObjectId } from "mongodb";
+const HEX24 = /^[a-fA-F0-9]{24}$/;
+export function maybeObjectId(value) {
+    if (typeof value === "string" && HEX24.test(value)) {
+        try {
+            return new ObjectId(value);
+        }
+        catch {
+            return value;
+        }
+    }
+    return value;
+}
+export function normalizeMemorixFilter(filter) {
+    if (!filter || typeof filter !== "object")
+        return filter;
+    const out = { ...filter };
+    if ("_id" in out) {
+        out._id = maybeObjectId(out._id);
+    }
+    return out;
+}
+//# sourceMappingURL=id-normalize.js.map

package/dist/mongo/id-normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-normalize.js","sourceRoot":"","sources":["../../src/mongo/id-normalize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,MAAM,KAAK,GAAG,mBAAmB,CAAC;AAElC,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACnD,IAAI,CAAC;YACH,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,MAA+B;IAE/B,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IACzD,MAAM,GAAG,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAC1B,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;QACjB,GAAG,CAAC,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/mongo/index.d.ts

@@ -0,0 +1,5 @@
+export { resolveDefaultSourceDbName, resolveMemorixDbName, resolveMongoUri, targetCollectionEnvKey, } from "./env.js";
+export { resolveMemorixWriteTarget, type MemorixTarget } from "./target.js";
+export { DEFAULT_ENTITY_COLLECTION_CANDIDATES, DEFAULT_EVENT_COLLECTION_CANDIDATES, } from "./default-collections.js";
+export { createMemorixDataTier, type CreateMemorixDataTierOptions, type MemorixDataTier, } from "./tier.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/mongo/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mongo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,eAAe,EACf,sBAAsB,GACvB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,yBAAyB,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EACL,oCAAoC,EACpC,mCAAmC,GACpC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,qBAAqB,EACrB,KAAK,4BAA4B,EACjC,KAAK,eAAe,GACrB,MAAM,WAAW,CAAC"}

package/dist/mongo/index.js

@@ -0,0 +1,5 @@
+export { resolveDefaultSourceDbName, resolveMemorixDbName, resolveMongoUri, targetCollectionEnvKey, } from "./env.js";
+export { resolveMemorixWriteTarget } from "./target.js";
+export { DEFAULT_ENTITY_COLLECTION_CANDIDATES, DEFAULT_EVENT_COLLECTION_CANDIDATES, } from "./default-collections.js";
+export { createMemorixDataTier, } from "./tier.js";
+//# sourceMappingURL=index.js.map

package/dist/mongo/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mongo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,eAAe,EACf,sBAAsB,GACvB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,yBAAyB,EAAsB,MAAM,aAAa,CAAC;AAC5E,OAAO,EACL,oCAAoC,EACpC,mCAAmC,GACpC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,qBAAqB,GAGtB,MAAM,WAAW,CAAC"}

package/dist/mongo/target.d.ts

@@ -0,0 +1,4 @@
+import type { MemorixWriteDescriptor } from "../descriptors/write-descriptor-types.js";
+export type MemorixTarget = "entity" | "event";
+export declare function resolveMemorixWriteTarget(writeDescriptor: MemorixWriteDescriptor): MemorixTarget;
+//# sourceMappingURL=target.d.ts.map

package/dist/mongo/target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../src/mongo/target.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAEvF,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE/C,wBAAgB,yBAAyB,CACvC,eAAe,EAAE,sBAAsB,GACtC,aAAa,CAKf"}

package/dist/mongo/target.js

@@ -0,0 +1,9 @@
+export function resolveMemorixWriteTarget(writeDescriptor) {
+    const kind = writeDescriptor.target.kind?.trim();
+    if (kind === "entity" || kind === "event")
+        return kind;
+    if (writeDescriptor.identity.idField === "eventId")
+        return "event";
+    return "entity";
+}
+//# sourceMappingURL=target.js.map

package/dist/mongo/target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.js","sourceRoot":"","sources":["../../src/mongo/target.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,yBAAyB,CACvC,eAAuC;IAEvC,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IACjD,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,eAAe,CAAC,QAAQ,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC;IACnE,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/mongo/tier-env.d.ts

@@ -0,0 +1,9 @@
+export type MemorixTierEnv = {
+    mongoUri: string;
+    memorixDb: string;
+    memorixDiscoveryHeuristic: boolean;
+};
+export declare function resolveMemorixTierEnv(overrides?: Partial<MemorixTierEnv> & {
+    processEnv?: NodeJS.ProcessEnv;
+}): MemorixTierEnv;
+//# sourceMappingURL=tier-env.d.ts.map

package/dist/mongo/tier-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier-env.d.ts","sourceRoot":"","sources":["../../src/mongo/tier-env.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB,EAAE,OAAO,CAAC;CACpC,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,SAAS,GAAE,OAAO,CAAC,cAAc,CAAC,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,GAC3E,cAAc,CAWhB"}

package/dist/mongo/tier-env.js

@@ -0,0 +1,11 @@
+import { resolveMemorixDbName, resolveMongoUri } from "./env.js";
+export function resolveMemorixTierEnv(overrides = {}) {
+    const env = overrides.processEnv ?? process.env;
+    const mongoUri = overrides.mongoUri ?? resolveMongoUri(env);
+    const memorixDb = overrides.memorixDb ?? resolveMemorixDbName("entity", env);
+    const memorixDiscoveryHeuristic = overrides.memorixDiscoveryHeuristic ??
+        (env.MEMORIX_DISCOVERY_HEURISTIC === "1" ||
+            env.MEMORIX_DISCOVERY_HEURISTIC === "true");
+    return { mongoUri, memorixDb, memorixDiscoveryHeuristic };
+}
+//# sourceMappingURL=tier-env.js.map

package/dist/mongo/tier-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier-env.js","sourceRoot":"","sources":["../../src/mongo/tier-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAQjE,MAAM,UAAU,qBAAqB,CACnC,YAA0E,EAAE;IAE5E,MAAM,GAAG,GAAG,SAAS,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC;IAChD,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC;IAC5D,MAAM,SAAS,GACb,SAAS,CAAC,SAAS,IAAI,oBAAoB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC7D,MAAM,yBAAyB,GAC7B,SAAS,CAAC,yBAAyB;QACnC,CAAC,GAAG,CAAC,2BAA2B,KAAK,GAAG;YACtC,GAAG,CAAC,2BAA2B,KAAK,MAAM,CAAC,CAAC;IAEhD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,yBAAyB,EAAE,CAAC;AAC5D,CAAC"}

package/dist/mongo/tier.d.ts

@@ -0,0 +1,22 @@
+import { MongoClient, type Db, type Document } from "mongodb";
+import type { MemorixTierEnv } from "./tier-env.js";
+export type MemorixDataTier = {
+    env: MemorixTierEnv;
+    client: MongoClient;
+    db: Db;
+    /** @internal set by init/close; collection I/O requires true */
+    memorixReady: boolean;
+    init(): Promise<void>;
+    close(): Promise<void>;
+    runMongoAggregate(args: {
+        database: string;
+        collection: string;
+        pipeline: Document[];
+    }): Promise<unknown[]>;
+};
+export type CreateMemorixDataTierOptions = Partial<MemorixTierEnv> & {
+    processEnv?: NodeJS.ProcessEnv;
+    client?: MongoClient;
+};
+export declare function createMemorixDataTier(options?: CreateMemorixDataTierOptions): MemorixDataTier;
+//# sourceMappingURL=tier.d.ts.map

package/dist/mongo/tier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier.d.ts","sourceRoot":"","sources":["../../src/mongo/tier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,MAAM,MAAM,eAAe,GAAG;IAC5B,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,EAAE,EAAE,EAAE,CAAC;IACP,gEAAgE;IAChE,YAAY,EAAE,OAAO,CAAC;IACtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,iBAAiB,CAAC,IAAI,EAAE;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,QAAQ,EAAE,CAAC;KACtB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAgBF,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,4BAAiC,GACzC,eAAe,CAyCjB"}

package/dist/mongo/tier.js

@@ -0,0 +1,50 @@
+import { MongoClient } from "mongodb";
+import { resolveMemorixTierEnv } from "./tier-env.js";
+const DISALLOWED_AGG_STAGES = new Set(["$out", "$merge"]);
+function assertReadOnlyAggregate(pipeline) {
+    for (const stage of pipeline) {
+        if (!stage || typeof stage !== "object")
+            continue;
+        const key = Object.keys(stage)[0];
+        if (key && DISALLOWED_AGG_STAGES.has(key)) {
+            throw new Error(`Memorix: runMongoAggregate disallows stage ${key} (read-only reporting only)`);
+        }
+    }
+}
+export function createMemorixDataTier(options = {}) {
+    const { client: injectedClient, processEnv, ...envOverrides } = options;
+    const env = resolveMemorixTierEnv({ ...envOverrides, processEnv });
+    const client = injectedClient ??
+        new MongoClient(env.mongoUri, { ignoreUndefined: true });
+    const db = client.db(env.memorixDb);
+    const tier = {
+        env,
+        client,
+        db,
+        memorixReady: false,
+        async init() {
+            await client.connect();
+            await db.command({ ping: 1 });
+            tier.memorixReady = true;
+        },
+        async close() {
+            tier.memorixReady = false;
+            if (!injectedClient) {
+                await client.close();
+            }
+        },
+        async runMongoAggregate({ database, collection, pipeline }) {
+            if (!tier.memorixReady) {
+                throw new Error("Memorix: tier.init() must be called before runMongoAggregate");
+            }
+            if (database !== env.memorixDb) {
+                throw new Error(`Memorix: runMongoAggregate database must be memorixDb "${env.memorixDb}" (got "${database}")`);
+            }
+            assertReadOnlyAggregate(pipeline);
+            const col = db.collection(collection);
+            return col.aggregate(pipeline).toArray();
+        },
+    };
+    return tier;
+}
+//# sourceMappingURL=tier.js.map

package/dist/mongo/tier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier.js","sourceRoot":"","sources":["../../src/mongo/tier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA0B,MAAM,SAAS,CAAC;AAE9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAsBtD,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE1D,SAAS,uBAAuB,CAAC,QAAiC;IAChE,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,SAAS;QAClD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,GAAG,IAAI,qBAAqB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CACb,8CAA8C,GAAG,6BAA6B,CAC/E,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,UAAwC,EAAE;IAE1C,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,YAAY,EAAE,GAAG,OAAO,CAAC;IACxE,MAAM,GAAG,GAAG,qBAAqB,CAAC,EAAE,GAAG,YAAY,EAAE,UAAU,EAAE,CAAC,CAAC;IACnE,MAAM,MAAM,GACV,cAAc;QACd,IAAI,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAEpC,MAAM,IAAI,GAAoB;QAC5B,GAAG;QACH,MAAM;QACN,EAAE;QACF,YAAY,EAAE,KAAK;QACnB,KAAK,CAAC,IAAI;YACR,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;YACvB,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC;QACD,KAAK,CAAC,KAAK;YACT,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;YAC1B,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACvB,CAAC;QACH,CAAC;QACD,KAAK,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE;YACxD,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CACb,8DAA8D,CAC/D,CAAC;YACJ,CAAC;YACD,IAAI,QAAQ,KAAK,GAAG,CAAC,SAAS,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CACb,0DAA0D,GAAG,CAAC,SAAS,WAAW,QAAQ,IAAI,CAC/F,CAAC;YACJ,CAAC;YACD,uBAAuB,CAAC,QAAQ,CAAC,CAAC;YAClC,MAAM,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YACtC,OAAO,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;QAC3C,CAAC;KACF,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/path.d.ts

@@ -0,0 +1,4 @@
+export declare function deepGet(obj: Record<string, unknown>, path: string): unknown;
+export declare function deepSet(obj: Record<string, unknown>, path: string, value: unknown): void;
+export declare function deepMerge(target: Record<string, unknown>, source: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=path.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/utils/path.ts"],"names":[],"mappings":"AAAA,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAQ3E;AAED,wBAAgB,OAAO,CACrB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,IAAI,CAYN;AAED,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBzB"}

package/dist/utils/path.js

@@ -0,0 +1,42 @@
+export function deepGet(obj, path) {
+    const parts = path.split(".");
+    let cur = obj;
+    for (const p of parts) {
+        if (cur == null || typeof cur !== "object")
+            return undefined;
+        cur = cur[p];
+    }
+    return cur;
+}
+export function deepSet(obj, path, value) {
+    const parts = path.split(".");
+    let cur = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const p = parts[i];
+        const next = cur[p];
+        if (next == null || typeof next !== "object" || Array.isArray(next)) {
+            cur[p] = {};
+        }
+        cur = cur[p];
+    }
+    cur[parts[parts.length - 1]] = value;
+}
+export function deepMerge(target, source) {
+    const out = { ...target };
+    for (const [k, v] of Object.entries(source)) {
+        const existing = out[k];
+        if (v != null &&
+            typeof v === "object" &&
+            !Array.isArray(v) &&
+            existing != null &&
+            typeof existing === "object" &&
+            !Array.isArray(existing)) {
+            out[k] = deepMerge(existing, v);
+        }
+        else {
+            out[k] = v;
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=path.js.map

package/dist/utils/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../src/utils/path.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,OAAO,CAAC,GAA4B,EAAE,IAAY;IAChE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,GAAG,GAAY,GAAG,CAAC;IACvB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QAC7D,GAAG,GAAI,GAA+B,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,GAA4B,EAC5B,IAAY,EACZ,KAAc;IAEd,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,GAAG,GAA4B,GAAG,CAAC;IACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACpB,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,IAAI,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACpE,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QACd,CAAC;QACD,GAAG,GAAG,GAAG,CAAC,CAAC,CAA4B,CAAC;IAC1C,CAAC;IACD,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,GAAG,KAAK,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,MAA+B,EAC/B,MAA+B;IAE/B,MAAM,GAAG,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAC1B,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACxB,IACE,CAAC,IAAI,IAAI;YACT,OAAO,CAAC,KAAK,QAAQ;YACrB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YACjB,QAAQ,IAAI,IAAI;YAChB,OAAO,QAAQ,KAAK,QAAQ;YAC5B,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EACxB,CAAC;YACD,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,CAChB,QAAmC,EACnC,CAA4B,CAC7B,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/validation/validate-content.d.ts

@@ -0,0 +1,17 @@
+import type { MemorixWriteDescriptor } from "../descriptors/write-descriptor-types.js";
+import type { MemorixWriteFieldDescriptor } from "../descriptors/write-descriptor-types.js";
+import type { MemorixWriteIssue } from "../errors/issues.js";
+export declare function validateContentRequest(args: {
+    writeDescriptor: MemorixWriteDescriptor;
+    fieldName: string;
+    field: MemorixWriteFieldDescriptor;
+    body?: string;
+    format?: "markdown" | "text";
+    maxBytes: number;
+}): MemorixWriteIssue[];
+export declare function isMemorixContentPointer(value: unknown): value is {
+    contentKey: string;
+    metadata?: Record<string, unknown>;
+    preview?: string;
+};
+//# sourceMappingURL=validate-content.d.ts.map

package/dist/validation/validate-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-content.d.ts","sourceRoot":"","sources":["../../src/validation/validate-content.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AACvF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AAC5F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,eAAe,EAAE,sBAAsB,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,2BAA2B,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,iBAAiB,EAAE,CAwDtB;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAMvF"}

package/dist/validation/validate-content.js

@@ -0,0 +1,47 @@
+import { writeIssue } from "../errors/issues.js";
+export function validateContentRequest(args) {
+    const issues = [];
+    const { writeDescriptor, fieldName, field, body, format, maxBytes } = args;
+    if (!writeDescriptor.content?.allowed && !field.content?.enabled) {
+        issues.push(writeIssue("CONTENT_FIELD_NOT_ALLOWED", `content field "${fieldName}" is not allowed`, {
+            path: fieldName,
+        }));
+        return issues;
+    }
+    const allowedFields = writeDescriptor.content?.allowedFields;
+    if (allowedFields?.length && !allowedFields.includes(fieldName)) {
+        issues.push(writeIssue("CONTENT_FIELD_NOT_ALLOWED", `content field "${fieldName}" is not in allowedFields`, {
+            path: fieldName,
+        }));
+    }
+    if (body === undefined) {
+        return issues;
+    }
+    if (field.content?.acceptBody === false) {
+        issues.push(writeIssue("CONTENT_FIELD_NOT_ALLOWED", `content body not accepted for "${fieldName}"`, {
+            path: fieldName,
+        }));
+        return issues;
+    }
+    const fmt = format ?? field.content?.format ?? "markdown";
+    if (fmt !== "markdown" && fmt !== "text") {
+        issues.push(writeIssue("CONTENT_FORMAT_NOT_ALLOWED", `format "${fmt}" is not allowed`, {
+            path: fieldName,
+        }));
+    }
+    const bytes = Buffer.byteLength(body, "utf8");
+    const fieldMax = field.content?.maxBytes ?? writeDescriptor.content?.maxBytes ?? maxBytes;
+    if (bytes > fieldMax) {
+        issues.push(writeIssue("CONTENT_TOO_LARGE", `content for "${fieldName}" exceeds ${fieldMax} bytes`, {
+            path: fieldName,
+            details: { sizeBytes: bytes, maxBytes: fieldMax },
+        }));
+    }
+    return issues;
+}
+export function isMemorixContentPointer(value) {
+    return (value != null &&
+        typeof value === "object" &&
+        typeof value.contentKey === "string");
+}
+//# sourceMappingURL=validate-content.js.map

package/dist/validation/validate-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-content.js","sourceRoot":"","sources":["../../src/validation/validate-content.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,MAAM,UAAU,sBAAsB,CAAC,IAOtC;IACC,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAE3E,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC;QACjE,MAAM,CAAC,IAAI,CACT,UAAU,CAAC,2BAA2B,EAAE,kBAAkB,SAAS,kBAAkB,EAAE;YACrF,IAAI,EAAE,SAAS;SAChB,CAAC,CACH,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,aAAa,GAAG,eAAe,CAAC,OAAO,EAAE,aAAa,CAAC;IAC7D,IAAI,aAAa,EAAE,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAChE,MAAM,CAAC,IAAI,CACT,UAAU,CAAC,2BAA2B,EAAE,kBAAkB,SAAS,2BAA2B,EAAE;YAC9F,IAAI,EAAE,SAAS;SAChB,CAAC,CACH,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,EAAE,UAAU,KAAK,KAAK,EAAE,CAAC;QACxC,MAAM,CAAC,IAAI,CACT,UAAU,CAAC,2BAA2B,EAAE,kCAAkC,SAAS,GAAG,EAAE;YACtF,IAAI,EAAE,SAAS;SAChB,CAAC,CACH,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,MAAM,IAAI,UAAU,CAAC;IAC1D,IAAI,GAAG,KAAK,UAAU,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;QACzC,MAAM,CAAC,IAAI,CACT,UAAU,CAAC,4BAA4B,EAAE,WAAW,GAAG,kBAAkB,EAAE;YACzE,IAAI,EAAE,SAAS;SAChB,CAAC,CACH,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,EAAE,QAAQ,IAAI,eAAe,CAAC,OAAO,EAAE,QAAQ,IAAI,QAAQ,CAAC;IAC1F,IAAI,KAAK,GAAG,QAAQ,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CACT,UAAU,CAAC,mBAAmB,EAAE,gBAAgB,SAAS,aAAa,QAAQ,QAAQ,EAAE;YACtF,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE;SAClD,CAAC,CACH,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,KAAc;IAEd,OAAO,CACL,KAAK,IAAI,IAAI;QACb,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAQ,KAAiC,CAAC,UAAU,KAAK,QAAQ,CAClE,CAAC;AACJ,CAAC"}

package/dist/validation/validate-fields.d.ts

@@ -0,0 +1,8 @@
+import type { MemorixWriteDescriptor } from "../descriptors/write-descriptor-types.js";
+import type { MemorixWriteIssue } from "../errors/issues.js";
+export declare function validateInputFields(args: {
+    writeDescriptor: MemorixWriteDescriptor;
+    input: Record<string, unknown>;
+    contentFieldNames?: string[];
+}): MemorixWriteIssue[];
+//# sourceMappingURL=validate-fields.d.ts.map

package/dist/validation/validate-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-fields.d.ts","sourceRoot":"","sources":["../../src/validation/validate-fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AACvF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAI7D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,eAAe,EAAE,sBAAsB,CAAC;IACxC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B,GAAG,iBAAiB,EAAE,CA+DtB"}