@x12i/memorix-writer 1.0.0

package/dist/data/memorix-write-adapter.js

@@ -0,0 +1,45 @@
+import { getMemorixCollectionDocument, insertMemorixCollectionDocument, listMemorixCollectionDocuments, patchMemorixCollectionDocument, replaceMemorixCollectionDocument, updateMemorixCollectionDocument, } from "../mongo/collection-documents.js";
+import { resolveMemorixDbName } from "../mongo/env.js";
+function tierForTargetDb(tier, target, env) {
+    const memorixDb = resolveMemorixDbName(target, env);
+    if (tier.db.databaseName === memorixDb)
+        return tier;
+    return {
+        ...tier,
+        db: tier.client.db(memorixDb),
+        env: { ...tier.env, memorixDb },
+    };
+}
+export function createMemorixWriteAdapter(tier, options) {
+    const env = options.env ?? process.env;
+    const database = resolveMemorixDbName(options.target, env);
+    const scopedTier = tierForTargetDb(tier, options.target, env);
+    return {
+        target: options.target,
+        database,
+        findOne: (collection, filter) => getMemorixCollectionDocument(scopedTier, { collection, filter }),
+        findMany: async (collection, filter, opts) => {
+            const r = await listMemorixCollectionDocuments(scopedTier, {
+                collection,
+                filter,
+                limit: opts?.limit ?? 10,
+                sort: opts?.sort ?? { modifiedAt: -1 },
+            });
+            return r.documents;
+        },
+        insert: (collection, document) => insertMemorixCollectionDocument(scopedTier, { collection, document }),
+        patch: (collection, filter, $set) => patchMemorixCollectionDocument(scopedTier, { collection, filter, $set }),
+        replace: (collection, filter, replacement, upsert) => replaceMemorixCollectionDocument(scopedTier, {
+            collection,
+            filter,
+            replacement,
+            upsert,
+        }),
+        update: (collection, filter, update) => updateMemorixCollectionDocument(scopedTier, {
+            collection,
+            filter,
+            update: update,
+        }),
+    };
+}
+//# sourceMappingURL=memorix-write-adapter.js.map

package/dist/data/memorix-write-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memorix-write-adapter.js","sourceRoot":"","sources":["../../src/data/memorix-write-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,+BAA+B,EAC/B,8BAA8B,EAC9B,8BAA8B,EAC9B,gCAAgC,EAChC,+BAA+B,GAChC,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AA0CvD,SAAS,eAAe,CACtB,IAAqB,EACrB,MAAqB,EACrB,GAAsB;IAEtB,MAAM,SAAS,GAAG,oBAAoB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpD,IAAI,IAAI,CAAC,EAAE,CAAC,YAAY,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACpD,OAAO;QACL,GAAG,IAAI;QACP,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC;QAC7B,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,IAAqB,EACrB,OAAyC;IAEzC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,QAAQ,GAAG,oBAAoB,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3D,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE9D,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,QAAQ;QAER,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,CAC9B,4BAA4B,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QAElE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;YAC3C,MAAM,CAAC,GAAG,MAAM,8BAA8B,CAAC,UAAU,EAAE;gBACzD,UAAU;gBACV,MAAM;gBACN,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE;gBACxB,IAAI,EAAG,IAAI,EAAE,IAA+B,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE;aACnE,CAAC,CAAC;YACH,OAAO,CAAC,CAAC,SAAS,CAAC;QACrB,CAAC;QAED,MAAM,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,EAAE,CAC/B,+BAA+B,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;QAEvE,KAAK,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAClC,8BAA8B,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAE1E,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,CACnD,gCAAgC,CAAC,UAAU,EAAE;YAC3C,UAAU;YACV,MAAM;YACN,WAAW;YACX,MAAM;SACP,CAAC;QAEJ,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CACrC,+BAA+B,CAAC,UAAU,EAAE;YAC1C,UAAU;YACV,MAAM;YACN,MAAM,EAAE,MAAoC;SAC7C,CAAC;KACL,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,59 @@
+export type MemorixContentStorageDescriptor = {
+    provider: "gcs" | "s3";
+    bucket: string;
+    prefix?: string;
+    maxBytes?: number;
+    encoding?: "utf8";
+    credentialsRef?: string;
+};
+export type MemorixContentObject = {
+    contentKey: string;
+    metadata?: Record<string, unknown>;
+    preview?: string;
+};
+export type MemorixContentDefaults = {
+    storage?: MemorixContentStorageDescriptor;
+    maxBytes?: number;
+};
+export type MemorixContentTypeDescriptor = {
+    postfix: string;
+    collection?: string;
+    label?: string;
+    canonical?: boolean;
+};
+export type MemorixPropertyDescriptor = {
+    sourcePath: string;
+    label?: string;
+    valueType?: string;
+    content?: {
+        storage?: MemorixContentStorageDescriptor;
+        maxBytes?: number;
+    };
+};
+export type MemorixRelationDescriptor = {
+    targetEntity: string;
+    type?: string;
+};
+export type MemorixEntityDescriptor = {
+    id: string;
+    entityName: string;
+    /** Kebab-case domain id; defaults to `entityName`. See Memorix Database Conventions. */
+    entityType?: string;
+    collectionPrefix: string;
+    identity: {
+        allowedIdFields: ["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>;
+};
+//# sourceMappingURL=entity-descriptor-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entity-descriptor-types.d.ts","sourceRoot":"","sources":["../../src/descriptors/entity-descriptor-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,+BAA+B,GAAG;IAC5C,QAAQ,EAAE,KAAK,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,CAAC,EAAE,+BAA+B,CAAC;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,+BAA+B,CAAC;QAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,wFAAwF;IACxF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IAEzB,QAAQ,EAAE;QACR,eAAe,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QACzC,kBAAkB,EAAE,IAAI,CAAC;QACzB,cAAc,EAAE,UAAU,GAAG,SAAS,CAAC;KACxC,CAAC;IAEF,QAAQ,EAAE;QACR,oBAAoB,EAAE,MAAM,CAAC;QAC7B,QAAQ,EAAE,MAAM,CAAC;QACjB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,0BAA0B,CAAC,EAAE,MAAM,EAAE,CAAC;KACvC,CAAC;IAEF,eAAe,CAAC,EAAE,sBAAsB,CAAC;IAEzC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC;IAE3D,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;IAEtD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;CACvD,CAAC"}

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

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

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

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

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

@@ -0,0 +1,7 @@
+import type { CataloxLike, MemorixWriterClient } from "../client/types.js";
+import type { MemorixEntityDescriptor } from "./entity-descriptor-types.js";
+export declare function loadMemorixEntityDescriptorFromCatalox(catalox: CataloxLike, appId: string, entityDescriptorId: string): Promise<MemorixEntityDescriptor>;
+export declare function loadMemorixEntityDescriptor(client: MemorixWriterClient, entityDescriptorId: string): Promise<MemorixEntityDescriptor>;
+/** Resolve entity descriptor by write descriptor's entity name (catalog item id = entity name). */
+export declare function loadMemorixEntityDescriptorForWrite(client: MemorixWriterClient, entityName: 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":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAI5E,wBAAsB,sCAAsC,CAC1D,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,MAAM,EACb,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC,uBAAuB,CAAC,CAkBlC;AAED,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,mBAAmB,EAC3B,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC,uBAAuB,CAAC,CAMlC;AAED,mGAAmG;AACnG,wBAAsB,mCAAmC,CACvD,MAAM,EAAE,mBAAmB,EAC3B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,uBAAuB,CAAC,CAElC"}

package/dist/descriptors/load-entity-descriptor.js

@@ -0,0 +1,23 @@
+import { DEFAULT_MEMORIX_APP_ID, MEMORIX_ENTITY_DESCRIPTORS_CATALOG_ID, } from "../constants.js";
+import { validateMemorixEntityDescriptorShape } from "./validate-write-descriptor.js";
+import { throwWriterError } from "../errors/errors.js";
+export async function loadMemorixEntityDescriptorFromCatalox(catalox, appId, entityDescriptorId) {
+    const item = await catalox.getCatalogItem(appId, MEMORIX_ENTITY_DESCRIPTORS_CATALOG_ID, entityDescriptorId);
+    if (!item?.data) {
+        throwWriterError("MISSING_ENTITY_DESCRIPTOR", `entity descriptor not found: ${entityDescriptorId}`);
+    }
+    const descriptor = item.data;
+    if (!descriptor.id) {
+        descriptor.id = entityDescriptorId;
+    }
+    validateMemorixEntityDescriptorShape(descriptor);
+    return descriptor;
+}
+export async function loadMemorixEntityDescriptor(client, entityDescriptorId) {
+    return loadMemorixEntityDescriptorFromCatalox(client.catalox, client.appId ?? DEFAULT_MEMORIX_APP_ID, entityDescriptorId);
+}
+/** Resolve entity descriptor by write descriptor's entity name (catalog item id = entity name). */
+export async function loadMemorixEntityDescriptorForWrite(client, entityName) {
+    return loadMemorixEntityDescriptor(client, entityName);
+}
+//# sourceMappingURL=load-entity-descriptor.js.map

package/dist/descriptors/load-entity-descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-entity-descriptor.js","sourceRoot":"","sources":["../../src/descriptors/load-entity-descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,qCAAqC,GACtC,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,oCAAoC,EAAE,MAAM,gCAAgC,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,CAAC,KAAK,UAAU,sCAAsC,CAC1D,OAAoB,EACpB,KAAa,EACb,kBAA0B;IAE1B,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,cAAc,CACvC,KAAK,EACL,qCAAqC,EACrC,kBAAkB,CACnB,CAAC;IACF,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;QAChB,gBAAgB,CACd,2BAA2B,EAC3B,gCAAgC,kBAAkB,EAAE,CACrD,CAAC;IACJ,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,IAA0C,CAAC;IACnE,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;QACnB,UAAU,CAAC,EAAE,GAAG,kBAAkB,CAAC;IACrC,CAAC;IACD,oCAAoC,CAAC,UAAU,CAAC,CAAC;IACjD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,MAA2B,EAC3B,kBAA0B;IAE1B,OAAO,sCAAsC,CAC3C,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,KAAK,IAAI,sBAAsB,EACtC,kBAAkB,CACnB,CAAC;AACJ,CAAC;AAED,mGAAmG;AACnG,MAAM,CAAC,KAAK,UAAU,mCAAmC,CACvD,MAA2B,EAC3B,UAAkB;IAElB,OAAO,2BAA2B,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AACzD,CAAC"}

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

@@ -0,0 +1,5 @@
+import type { CataloxLike, MemorixWriterClient } from "../client/types.js";
+import type { MemorixWriteDescriptor } from "./write-descriptor-types.js";
+export declare function loadMemorixWriteDescriptorFromCatalox(catalox: CataloxLike, appId: string, writeDescriptorId: string): Promise<MemorixWriteDescriptor>;
+export declare function loadMemorixWriteDescriptor(client: MemorixWriterClient, writeDescriptorId: string): Promise<MemorixWriteDescriptor>;
+//# sourceMappingURL=load-write-descriptor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"load-write-descriptor.d.ts","sourceRoot":"","sources":["../../src/descriptors/load-write-descriptor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAI1E,wBAAsB,qCAAqC,CACzD,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,MAAM,EACb,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,sBAAsB,CAAC,CAkBjC;AAED,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,mBAAmB,EAC3B,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,sBAAsB,CAAC,CAMjC"}

package/dist/descriptors/load-write-descriptor.js

@@ -0,0 +1,19 @@
+import { DEFAULT_MEMORIX_APP_ID, MEMORIX_WRITE_DESCRIPTORS_CATALOG_ID, } from "../constants.js";
+import { validateMemorixWriteDescriptorShape } from "./validate-write-descriptor.js";
+import { throwWriterError } from "../errors/errors.js";
+export async function loadMemorixWriteDescriptorFromCatalox(catalox, appId, writeDescriptorId) {
+    const item = await catalox.getCatalogItem(appId, MEMORIX_WRITE_DESCRIPTORS_CATALOG_ID, writeDescriptorId);
+    if (!item?.data) {
+        throwWriterError("MISSING_WRITE_DESCRIPTOR", `write descriptor not found: ${writeDescriptorId}`);
+    }
+    const descriptor = item.data;
+    if (!descriptor.id) {
+        descriptor.id = writeDescriptorId;
+    }
+    validateMemorixWriteDescriptorShape(descriptor);
+    return descriptor;
+}
+export async function loadMemorixWriteDescriptor(client, writeDescriptorId) {
+    return loadMemorixWriteDescriptorFromCatalox(client.catalox, client.appId ?? DEFAULT_MEMORIX_APP_ID, writeDescriptorId);
+}
+//# sourceMappingURL=load-write-descriptor.js.map

package/dist/descriptors/load-write-descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-write-descriptor.js","sourceRoot":"","sources":["../../src/descriptors/load-write-descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,oCAAoC,GACrC,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,mCAAmC,EAAE,MAAM,gCAAgC,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,CAAC,KAAK,UAAU,qCAAqC,CACzD,OAAoB,EACpB,KAAa,EACb,iBAAyB;IAEzB,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,cAAc,CACvC,KAAK,EACL,oCAAoC,EACpC,iBAAiB,CAClB,CAAC;IACF,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;QAChB,gBAAgB,CACd,0BAA0B,EAC1B,+BAA+B,iBAAiB,EAAE,CACnD,CAAC;IACJ,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAyC,CAAC;IAClE,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;QACnB,UAAU,CAAC,EAAE,GAAG,iBAAiB,CAAC;IACpC,CAAC;IACD,mCAAmC,CAAC,UAAU,CAAC,CAAC;IAChD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,MAA2B,EAC3B,iBAAyB;IAEzB,OAAO,qCAAqC,CAC1C,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,KAAK,IAAI,sBAAsB,EACtC,iBAAiB,CAClB,CAAC;AACJ,CAAC"}

package/dist/descriptors/secret-scan.d.ts

@@ -0,0 +1,2 @@
+export declare function scanForSecrets(value: unknown, path?: string): string[];
+//# sourceMappingURL=secret-scan.d.ts.map

package/dist/descriptors/secret-scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret-scan.d.ts","sourceRoot":"","sources":["../../src/descriptors/secret-scan.ts"],"names":[],"mappings":"AASA,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,IAAI,SAAK,GACR,MAAM,EAAE,CA+BV"}

package/dist/descriptors/secret-scan.js

@@ -0,0 +1,39 @@
+const SECRET_PATTERNS = [
+    /-----BEGIN (RSA |EC |OPENSSH )?PRIVATE KEY-----/i,
+    /"type"\s*:\s*"service_account"/i,
+    /aws_secret_access_key/i,
+    /AKIA[0-9A-Z]{16}/,
+    /mongodb(\+srv)?:\/\/[^/\s]+:[^@\s]+@/i,
+    /\b(secret|api[_-]?key|access[_-]?key|password|token)\s*[:=]\s*["']?[a-zA-Z0-9_\-]{8,}/i,
+];
+export function scanForSecrets(value, path = "") {
+    const hits = [];
+    if (typeof value === "string") {
+        for (const re of SECRET_PATTERNS) {
+            if (re.test(value)) {
+                hits.push(path || "(root)");
+                break;
+            }
+        }
+        return hits;
+    }
+    if (Array.isArray(value)) {
+        value.forEach((v, i) => {
+            hits.push(...scanForSecrets(v, path ? `${path}[${i}]` : `[${i}]`));
+        });
+        return hits;
+    }
+    if (value != null && typeof value === "object") {
+        for (const [k, v] of Object.entries(value)) {
+            const p = path ? `${path}.${k}` : k;
+            if (/secret|password|token|private_key|service_account/i.test(k) &&
+                typeof v === "string" &&
+                v.length > 0) {
+                hits.push(p);
+            }
+            hits.push(...scanForSecrets(v, p));
+        }
+    }
+    return hits;
+}
+//# sourceMappingURL=secret-scan.js.map

package/dist/descriptors/secret-scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret-scan.js","sourceRoot":"","sources":["../../src/descriptors/secret-scan.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAAa;IAChC,kDAAkD;IAClD,iCAAiC;IACjC,wBAAwB;IACxB,kBAAkB;IAClB,uCAAuC;IACvC,wFAAwF;CACzF,CAAC;AAEF,MAAM,UAAU,cAAc,CAC5B,KAAc,EACd,IAAI,GAAG,EAAE;IAET,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,KAAK,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC;YACjC,IAAI,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBACnB,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,CAAC;gBAC5B,MAAM;YACR,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACrB,IAAI,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;YACtE,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YACpC,IACE,oDAAoD,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC5D,OAAO,CAAC,KAAK,QAAQ;gBACrB,CAAC,CAAC,MAAM,GAAG,CAAC,EACZ,CAAC;gBACD,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACf,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/descriptors/validate-write-descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { MemorixWriteDescriptor } from "./write-descriptor-types.js";
+export declare function validateMemorixWriteDescriptorShape(descriptor: MemorixWriteDescriptor): void;
+export declare function validateMemorixEntityDescriptorShape(descriptor: import("./entity-descriptor-types.js").MemorixEntityDescriptor): void;
+//# sourceMappingURL=validate-write-descriptor.d.ts.map

package/dist/descriptors/validate-write-descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-write-descriptor.d.ts","sourceRoot":"","sources":["../../src/descriptors/validate-write-descriptor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAG1E,wBAAgB,mCAAmC,CACjD,UAAU,EAAE,sBAAsB,GACjC,IAAI,CAuCN;AAED,wBAAgB,oCAAoC,CAClD,UAAU,EAAE,OAAO,8BAA8B,EAAE,uBAAuB,GACzE,IAAI,CA2BN"}

package/dist/descriptors/validate-write-descriptor.js

@@ -0,0 +1,45 @@
+import { scanForSecrets } from "./secret-scan.js";
+import { throwWriterError } from "../errors/errors.js";
+export function validateMemorixWriteDescriptorShape(descriptor) {
+    if (!descriptor.id?.trim()) {
+        throwWriterError("INVALID_DESCRIPTOR", "write descriptor id is required");
+    }
+    if (!descriptor.entity?.trim()) {
+        throwWriterError("INVALID_DESCRIPTOR", "write descriptor entity is required");
+    }
+    if (!descriptor.target?.contentType?.trim()) {
+        throwWriterError("INVALID_DESCRIPTOR", "write descriptor target.contentType is required");
+    }
+    if (!descriptor.operations?.allowed?.length) {
+        throwWriterError("INVALID_DESCRIPTOR", "write descriptor operations.allowed must be non-empty");
+    }
+    if (!descriptor.operations.allowed.includes(descriptor.operations.default)) {
+        throwWriterError("INVALID_DESCRIPTOR", "write descriptor operations.default must be in operations.allowed");
+    }
+    if (!descriptor.fields || Object.keys(descriptor.fields).length === 0) {
+        throwWriterError("INVALID_DESCRIPTOR", "write descriptor must declare at least one field");
+    }
+    const secretHits = scanForSecrets(descriptor);
+    if (secretHits.length > 0) {
+        throwWriterError("INVALID_DESCRIPTOR", `write descriptor contains forbidden secret material at: ${secretHits.join(", ")}`);
+    }
+}
+export function validateMemorixEntityDescriptorShape(descriptor) {
+    if (!descriptor.id?.trim()) {
+        throwWriterError("INVALID_DESCRIPTOR", "entity descriptor id is required");
+    }
+    if (!descriptor.entityName?.trim()) {
+        throwWriterError("INVALID_DESCRIPTOR", "entity descriptor entityName is required");
+    }
+    if (!descriptor.collectionPrefix?.trim()) {
+        throwWriterError("INVALID_DESCRIPTOR", "entity descriptor collectionPrefix is required");
+    }
+    if (!descriptor.contentTypes || Object.keys(descriptor.contentTypes).length === 0) {
+        throwWriterError("INVALID_DESCRIPTOR", "entity descriptor must declare contentTypes");
+    }
+    const secretHits = scanForSecrets(descriptor);
+    if (secretHits.length > 0) {
+        throwWriterError("INVALID_DESCRIPTOR", `entity descriptor contains forbidden secret material at: ${secretHits.join(", ")}`);
+    }
+}
+//# sourceMappingURL=validate-write-descriptor.js.map

package/dist/descriptors/validate-write-descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-write-descriptor.js","sourceRoot":"","sources":["../../src/descriptors/validate-write-descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,UAAU,mCAAmC,CACjD,UAAkC;IAElC,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;QAC3B,gBAAgB,CAAC,oBAAoB,EAAE,iCAAiC,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;QAC/B,gBAAgB,CAAC,oBAAoB,EAAE,qCAAqC,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC;QAC5C,gBAAgB,CACd,oBAAoB,EACpB,iDAAiD,CAClD,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAC5C,gBAAgB,CACd,oBAAoB,EACpB,uDAAuD,CACxD,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3E,gBAAgB,CACd,oBAAoB,EACpB,mEAAmE,CACpE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtE,gBAAgB,CACd,oBAAoB,EACpB,kDAAkD,CACnD,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAC9C,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,gBAAgB,CACd,oBAAoB,EACpB,2DAA2D,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACnF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,UAA0E;IAE1E,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;QAC3B,gBAAgB,CAAC,oBAAoB,EAAE,kCAAkC,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;QACnC,gBAAgB,CAAC,oBAAoB,EAAE,0CAA0C,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,gBAAgB,EAAE,IAAI,EAAE,EAAE,CAAC;QACzC,gBAAgB,CACd,oBAAoB,EACpB,gDAAgD,CACjD,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClF,gBAAgB,CACd,oBAAoB,EACpB,6CAA6C,CAC9C,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAC9C,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,gBAAgB,CACd,oBAAoB,EACpB,4DAA4D,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACpF,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,112 @@
+import type { MemorixContentStorageDescriptor } from "./entity-descriptor-types.js";
+export type MemorixIdempotencyDescriptor = {
+    enabled: boolean;
+    keyPath?: string;
+    storePath?: string;
+    behavior?: "deduplicate" | "failOnDifferentPayload" | "returnExisting";
+    payloadHashPath?: string;
+};
+export type MemorixWriteValidationRule = {
+    id: string;
+    type: "requiredWhen" | "forbiddenWhen" | "oneOf" | "regex" | "min" | "max" | "customFunction";
+    path: string;
+    params?: Record<string, unknown>;
+    severity?: "error" | "warning";
+    message?: string;
+};
+export type MemorixWriteFieldDescriptor = {
+    label?: string;
+    inputPath?: string;
+    target: {
+        path: string;
+    };
+    required?: boolean;
+    writable?: boolean;
+    immutable?: boolean;
+    valueType?: "string" | "number" | "boolean" | "date" | "datetime" | "enum" | "object" | "array" | "content";
+    enumValues?: string[];
+    defaultValue?: unknown;
+    nullBehavior?: "allow" | "ignore" | "clear" | "error";
+    mergeBehavior?: "replace" | "deepMerge" | "appendArray" | "setIfMissing";
+    content?: {
+        enabled: true;
+        objectType: "memorix-content-object";
+        acceptBody?: boolean;
+        acceptPointer?: boolean;
+        format?: "markdown" | "text";
+        storage?: MemorixContentStorageDescriptor;
+        maxBytes?: number;
+        contentKeyTemplate?: string;
+        generatePreview?: boolean;
+        previewMaxChars?: number;
+        computeMetadata?: boolean;
+    };
+    metadata?: Record<string, unknown>;
+};
+export type MemorixWriteDescriptor = {
+    id: string;
+    entity: string;
+    title?: string;
+    description?: string;
+    target: {
+        /** Memorix database role; defaults from `identity.idField`. */
+        kind?: "entity" | "event";
+        contentType: string;
+        /** Explicit Memorix collection override (recommended for canonical stores). */
+        targetCollection?: string;
+        targetCollectionCandidates?: string[];
+    };
+    identity: {
+        idField: "entityId" | "eventId";
+        requireExistingCanonical?: boolean;
+        createCanonicalIfMissing?: boolean;
+    };
+    operations: {
+        allowed: Array<"add" | "upsert" | "patch" | "replace">;
+        default: "add" | "upsert" | "patch" | "replace";
+    };
+    conflict?: {
+        matchBy?: string[];
+        idempotency?: MemorixIdempotencyDescriptor;
+        onConflict?: "fail" | "skip" | "append" | "update" | "replace";
+    };
+    fields: Record<string, MemorixWriteFieldDescriptor>;
+    content?: {
+        allowed: boolean;
+        allowedFields?: string[];
+        generatePreview?: boolean;
+        previewMaxChars?: number;
+        computeMetadata?: boolean;
+        maxBytes?: number;
+        contentKeyTemplate?: string;
+        contentWriteFailure?: {
+            cleanupOnRecordFailure?: boolean;
+            orphanIssueSeverity?: "warning" | "error";
+        };
+    };
+    timestamps?: {
+        createdAtPath?: string;
+        updatedAtPath?: string;
+        effectiveDatePath?: string;
+        writeTimeSource?: "server" | "input";
+    };
+    audit?: {
+        enabled?: boolean;
+        path?: string;
+        includeSource?: boolean;
+        includeCorrelationId?: boolean;
+        includeActor?: boolean;
+        includeDescriptorId?: boolean;
+    };
+    validation?: {
+        rejectUnknownFields?: boolean;
+        requireAtLeastOneWritableField?: boolean;
+        allowNulls?: boolean;
+        customRules?: MemorixWriteValidationRule[];
+    };
+    return?: {
+        defaultMode?: "summary" | "record" | "retrievalItem";
+        itemDescriptorId?: string;
+    };
+};
+//# sourceMappingURL=write-descriptor-types.d.ts.map

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

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

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

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

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

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

package/dist/errors/errors.d.ts

@@ -0,0 +1,6 @@
+export declare class MemorixWriterError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare function throwWriterError(code: string, message: string): never;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAErE"}

package/dist/errors/errors.js

@@ -0,0 +1,12 @@
+export class MemorixWriterError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "MemorixWriterError";
+        this.code = code;
+    }
+}
+export function throwWriterError(code, message) {
+    throw new MemorixWriterError(code, message);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,CAAS;IAEtB,YAAY,IAAY,EAAE,OAAe;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,OAAe;IAC5D,MAAM,IAAI,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC"}

package/dist/errors/issues.d.ts

@@ -0,0 +1,13 @@
+export type MemorixWriteIssueCode = "MISSING_WRITE_DESCRIPTOR" | "MISSING_ENTITY_DESCRIPTOR" | "UNKNOWN_CONTENT_TYPE" | "INVALID_IDENTITY" | "OPERATION_NOT_ALLOWED" | "FIELD_NOT_WRITABLE" | "UNKNOWN_FIELD" | "REQUIRED_FIELD_MISSING" | "INVALID_VALUE_TYPE" | "INVALID_ENUM_VALUE" | "IMMUTABLE_FIELD_UPDATE" | "VALIDATION_FAILED" | "CONTENT_FIELD_NOT_ALLOWED" | "MISSING_CONTENT_BODY" | "MISSING_CONTENT_KEY" | "CONTENT_TOO_LARGE" | "CONTENT_FORMAT_NOT_ALLOWED" | "CONTENT_WRITE_FAILED" | "CONTENT_ORPHANED" | "COLLECTION_WRITE_FAILED" | "CONFLICT" | "IDEMPOTENCY_CONFLICT" | "CANONICAL_RECORD_MISSING" | "RELATION_VALIDATION_FAILED" | "RETRIEVAL_NOT_CONFIGURED";
+export type MemorixWriteIssue = {
+    code: MemorixWriteIssueCode;
+    message: string;
+    severity: "info" | "warning" | "error";
+    path?: string;
+    entityId?: string;
+    eventId?: string;
+    recordId?: string;
+    details?: Record<string, unknown>;
+};
+export declare function writeIssue(code: MemorixWriteIssueCode, message: string, opts?: Partial<Omit<MemorixWriteIssue, "code" | "message">>): MemorixWriteIssue;
+//# sourceMappingURL=issues.d.ts.map

package/dist/errors/issues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issues.d.ts","sourceRoot":"","sources":["../../src/errors/issues.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAC7B,0BAA0B,GAC1B,2BAA2B,GAC3B,sBAAsB,GACtB,kBAAkB,GAClB,uBAAuB,GACvB,oBAAoB,GACpB,eAAe,GACf,wBAAwB,GACxB,oBAAoB,GACpB,oBAAoB,GACpB,wBAAwB,GACxB,mBAAmB,GACnB,2BAA2B,GAC3B,sBAAsB,GACtB,qBAAqB,GACrB,mBAAmB,GACnB,4BAA4B,GAC5B,sBAAsB,GACtB,kBAAkB,GAClB,yBAAyB,GACzB,UAAU,GACV,sBAAsB,GACtB,0BAA0B,GAC1B,4BAA4B,GAC5B,0BAA0B,CAAC;AAE/B,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,qBAAqB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAEF,wBAAgB,UAAU,CACxB,IAAI,EAAE,qBAAqB,EAC3B,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAC1D,iBAAiB,CAOnB"}

package/dist/errors/issues.js

@@ -0,0 +1,9 @@
+export function writeIssue(code, message, opts) {
+    return {
+        code,
+        message,
+        severity: opts?.severity ?? "error",
+        ...opts,
+    };
+}
+//# sourceMappingURL=issues.js.map

package/dist/errors/issues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issues.js","sourceRoot":"","sources":["../../src/errors/issues.ts"],"names":[],"mappings":"AAsCA,MAAM,UAAU,UAAU,CACxB,IAA2B,EAC3B,OAAe,EACf,IAA2D;IAE3D,OAAO;QACL,IAAI;QACJ,OAAO;QACP,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,OAAO;QACnC,GAAG,IAAI;KACR,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+export { createMemorixWriter } from "./client/create-client.js";
+export { createMemorixWriterFromEnv } from "./client/create-from-env.js";
+export { writeMemorixRecord } from "./writer/write-record.js";
+export { writeMemorixRecords } from "./writer/write-records.js";
+export { validateMemorixWrite } from "./writer/validate-write.js";
+export { loadMemorixWriteDescriptor } from "./descriptors/load-write-descriptor.js";
+export { loadMemorixEntityDescriptor } from "./descriptors/load-entity-descriptor.js";
+export { resolveMemorixWriteCollectionName, resolveMemorixWriteTargetCollection, buildMemorixWriteCollectionCandidates, resolveEntityType, } from "./data/collection-name.js";
+export { resolveMemorixDbName, resolveDefaultSourceDbName, resolveMongoUri, targetCollectionEnvKey, resolveMemorixWriteTarget, DEFAULT_ENTITY_COLLECTION_CANDIDATES, DEFAULT_EVENT_COLLECTION_CANDIDATES, } from "./mongo/index.js";
+export { connectMemorixMongo } from "./mongo/connection.js";
+export type { MemorixTarget } from "./mongo/target.js";
+export { resolveMemorixWriteFieldTarget } from "./writer/resolve-write-field-target.js";
+export { resolveMemorixContentWriteConfig } from "./content/resolve-content-write-config.js";
+export { writeMemorixContentObject, cleanupWrittenContent, } from "./content/write-content-object.js";
+export type { MemorixWriterClient, CreateMemorixWriterOptions, CreateMemorixWriterFromEnvOptions, CataloxLike, MemorixObjectWriterLike, MemorixContentWriterRegistry, MemorixRetrievalClient, MemorixWriterDefaults, WriteMemorixRecordRequest, WriteMemorixRecordResponse, WriteMemorixRecordsRequest, WriteMemorixRecordsResponse, ValidateMemorixWriteResponse, } from "./client/types.js";
+export type { MemorixWriteDescriptor, MemorixWriteFieldDescriptor, MemorixIdempotencyDescriptor, MemorixWriteValidationRule, } from "./descriptors/write-descriptor-types.js";
+export type { MemorixEntityDescriptor, MemorixContentObject, MemorixContentStorageDescriptor, MemorixContentTypeDescriptor, MemorixPropertyDescriptor, } from "./descriptors/entity-descriptor-types.js";
+export type { MemorixWriteIssue } from "./errors/issues.js";
+export { MemorixWriterError } from "./errors/errors.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAEzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElE,OAAO,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AACpF,OAAO,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAC;AAEtF,OAAO,EACL,iCAAiC,EACjC,mCAAmC,EACnC,qCAAqC,EACrC,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,eAAe,EACf,sBAAsB,EACtB,yBAAyB,EACzB,oCAAoC,EACpC,mCAAmC,GACpC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AACxF,OAAO,EAAE,gCAAgC,EAAE,MAAM,2CAA2C,CAAC;AAC7F,OAAO,EACL,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,mCAAmC,CAAC;AAE3C,YAAY,EACV,mBAAmB,EACnB,0BAA0B,EAC1B,iCAAiC,EACjC,WAAW,EACX,uBAAuB,EACvB,4BAA4B,EAC5B,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EACzB,0BAA0B,EAC1B,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,sBAAsB,EACtB,2BAA2B,EAC3B,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,yCAAyC,CAAC;AAEjD,YAAY,EACV,uBAAuB,EACvB,oBAAoB,EACpB,+BAA+B,EAC/B,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,0CAA0C,CAAC;AAElD,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+export { createMemorixWriter } from "./client/create-client.js";
+export { createMemorixWriterFromEnv } from "./client/create-from-env.js";
+export { writeMemorixRecord } from "./writer/write-record.js";
+export { writeMemorixRecords } from "./writer/write-records.js";
+export { validateMemorixWrite } from "./writer/validate-write.js";
+export { loadMemorixWriteDescriptor } from "./descriptors/load-write-descriptor.js";
+export { loadMemorixEntityDescriptor } from "./descriptors/load-entity-descriptor.js";
+export { resolveMemorixWriteCollectionName, resolveMemorixWriteTargetCollection, buildMemorixWriteCollectionCandidates, resolveEntityType, } from "./data/collection-name.js";
+export { resolveMemorixDbName, resolveDefaultSourceDbName, resolveMongoUri, targetCollectionEnvKey, resolveMemorixWriteTarget, DEFAULT_ENTITY_COLLECTION_CANDIDATES, DEFAULT_EVENT_COLLECTION_CANDIDATES, } from "./mongo/index.js";
+export { connectMemorixMongo } from "./mongo/connection.js";
+export { resolveMemorixWriteFieldTarget } from "./writer/resolve-write-field-target.js";
+export { resolveMemorixContentWriteConfig } from "./content/resolve-content-write-config.js";
+export { writeMemorixContentObject, cleanupWrittenContent, } from "./content/write-content-object.js";
+export { MemorixWriterError } from "./errors/errors.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAEzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElE,OAAO,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AACpF,OAAO,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAC;AAEtF,OAAO,EACL,iCAAiC,EACjC,mCAAmC,EACnC,qCAAqC,EACrC,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,eAAe,EACf,sBAAsB,EACtB,yBAAyB,EACzB,oCAAoC,EACpC,mCAAmC,GACpC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AACxF,OAAO,EAAE,gCAAgC,EAAE,MAAM,2CAA2C,CAAC;AAC7F,OAAO,EACL,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,mCAAmC,CAAC;AAmC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/mongo/collection-documents.d.ts

@@ -0,0 +1,54 @@
+/** Descriptor-driven physical collection I/O (e.g. `assets-analysis`). */
+import type { Document, Sort } from "mongodb";
+import type { MemorixDataTier } from "./tier.js";
+export type ListMemorixCollectionDocumentsResult = {
+    documents: Record<string, unknown>[];
+    totalCount?: number;
+};
+export declare function listMemorixCollectionDocuments(tier: MemorixDataTier, args: {
+    collection: string;
+    filter?: Record<string, unknown>;
+    sort?: Sort;
+    skip?: number;
+    limit?: number;
+    projection?: Document;
+    includeTotal?: boolean;
+}): Promise<ListMemorixCollectionDocumentsResult>;
+export declare function getMemorixCollectionDocument(tier: MemorixDataTier, args: {
+    collection: string;
+    filter: Record<string, unknown>;
+    projection?: Document;
+}): Promise<Record<string, unknown> | null>;
+export declare function insertMemorixCollectionDocument(tier: MemorixDataTier, args: {
+    collection: string;
+    document: Record<string, unknown>;
+}): Promise<{
+    insertedId: unknown;
+}>;
+export declare function replaceMemorixCollectionDocument(tier: MemorixDataTier, args: {
+    collection: string;
+    filter: Record<string, unknown>;
+    replacement: Record<string, unknown>;
+    upsert?: boolean;
+}): Promise<{
+    matchedCount: number;
+    modifiedCount: number;
+    upsertedCount: number;
+}>;
+export declare function updateMemorixCollectionDocument(tier: MemorixDataTier, args: {
+    collection: string;
+    filter: Record<string, unknown>;
+    update: Document;
+}): Promise<{
+    matchedCount: number;
+    modifiedCount: number;
+}>;
+export declare function patchMemorixCollectionDocument(tier: MemorixDataTier, args: {
+    collection: string;
+    filter: Record<string, unknown>;
+    $set: Record<string, unknown>;
+}): Promise<{
+    matchedCount: number;
+    modifiedCount: number;
+}>;
+//# sourceMappingURL=collection-documents.d.ts.map

package/dist/mongo/collection-documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-documents.d.ts","sourceRoot":"","sources":["../../src/mongo/collection-documents.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAoBjD,MAAM,MAAM,oCAAoC,GAAG;IACjD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,wBAAsB,8BAA8B,CAClD,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE;IACJ,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,QAAQ,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GACA,OAAO,CAAC,oCAAoC,CAAC,CAkD/C;AAED,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE;IACJ,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,UAAU,CAAC,EAAE,QAAQ,CAAC;CACvB,GACA,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAQzC;AAED,wBAAsB,+BAA+B,CACnD,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE;IACJ,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,GACA,OAAO,CAAC;IAAE,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC,CAKlC;AAED,wBAAsB,gCAAgC,CACpD,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE;IACJ,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GACA,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC,CAcjF;AAED,wBAAsB,+BAA+B,CACnD,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE;IACJ,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,QAAQ,CAAC;CAClB,GACA,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC,CAM1D;AAED,wBAAsB,8BAA8B,CAClD,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE;IACJ,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,GACA,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC,CAM1D"}