@x12i/memorix-writer 1.0.0

package/dist/validation/validate-fields.js

@@ -0,0 +1,49 @@
+import { writeIssue } from "../errors/issues.js";
+import { resolveInputPath } from "../writer/resolve-write-field-target.js";
+export function validateInputFields(args) {
+    const issues = [];
+    const { writeDescriptor, input, contentFieldNames = [] } = args;
+    const rejectUnknown = writeDescriptor.validation?.rejectUnknownFields ?? true;
+    const fieldEntries = Object.entries(writeDescriptor.fields);
+    const allowedInputPaths = new Set();
+    for (const [name, field] of fieldEntries) {
+        if (field.writable === false)
+            continue;
+        allowedInputPaths.add(resolveInputPath(name, field));
+        allowedInputPaths.add(name);
+    }
+    for (const cf of contentFieldNames) {
+        allowedInputPaths.add(cf);
+    }
+    if (rejectUnknown) {
+        for (const key of Object.keys(input)) {
+            if (!allowedInputPaths.has(key)) {
+                issues.push(writeIssue("UNKNOWN_FIELD", `unknown input field "${key}"`, {
+                    path: key,
+                    severity: "error",
+                }));
+            }
+        }
+    }
+    let writableProvided = 0;
+    for (const [name, field] of fieldEntries) {
+        const inputPath = resolveInputPath(name, field);
+        const value = input[inputPath] ?? input[name];
+        if (field.required && (value === undefined || value === null)) {
+            issues.push(writeIssue("REQUIRED_FIELD_MISSING", `required field "${name}" is missing`, {
+                path: inputPath,
+                severity: "error",
+            }));
+        }
+        if (field.writable !== false && value !== undefined) {
+            writableProvided++;
+        }
+    }
+    if (writeDescriptor.validation?.requireAtLeastOneWritableField &&
+        writableProvided === 0 &&
+        contentFieldNames.length === 0) {
+        issues.push(writeIssue("VALIDATION_FAILED", "at least one writable field must be provided", { severity: "error" }));
+    }
+    return issues;
+}
+//# sourceMappingURL=validate-fields.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate-fields.js","sourceRoot":"","sources":["../../src/validation/validate-fields.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAE3E,MAAM,UAAU,mBAAmB,CAAC,IAInC;IACC,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,iBAAiB,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC;IAChE,MAAM,aAAa,GAAG,eAAe,CAAC,UAAU,EAAE,mBAAmB,IAAI,IAAI,CAAC;IAC9E,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAE5D,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC5C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,YAAY,EAAE,CAAC;QACzC,IAAI,KAAK,CAAC,QAAQ,KAAK,KAAK;YAAE,SAAS;QACvC,iBAAiB,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QACrD,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,iBAAiB,EAAE,CAAC;QACnC,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,aAAa,EAAE,CAAC;QAClB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAChC,MAAM,CAAC,IAAI,CACT,UAAU,CAAC,eAAe,EAAE,wBAAwB,GAAG,GAAG,EAAE;oBAC1D,IAAI,EAAE,GAAG;oBACT,QAAQ,EAAE,OAAO;iBAClB,CAAC,CACH,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,gBAAgB,GAAG,CAAC,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,YAAY,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC;QAE9C,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,EAAE,CAAC;YAC9D,MAAM,CAAC,IAAI,CACT,UAAU,CAAC,wBAAwB,EAAE,mBAAmB,IAAI,cAAc,EAAE;gBAC1E,IAAI,EAAE,SAAS;gBACf,QAAQ,EAAE,OAAO;aAClB,CAAC,CACH,CAAC;QACJ,CAAC;QAED,IAAI,KAAK,CAAC,QAAQ,KAAK,KAAK,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACpD,gBAAgB,EAAE,CAAC;QACrB,CAAC;IACH,CAAC;IAED,IACE,eAAe,CAAC,UAAU,EAAE,8BAA8B;QAC1D,gBAAgB,KAAK,CAAC;QACtB,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAC9B,CAAC;QACD,MAAM,CAAC,IAAI,CACT,UAAU,CACR,mBAAmB,EACnB,8CAA8C,EAC9C,EAAE,QAAQ,EAAE,OAAO,EAAE,CACtB,CACF,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,3 @@
+export { resolveRequestIdentity, assertDescriptorIdField } from "../data/identity.js";
+export type { ResolvedIdentity } from "../data/identity.js";
+//# sourceMappingURL=validate-identity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate-identity.d.ts","sourceRoot":"","sources":["../../src/validation/validate-identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACtF,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/validation/validate-identity.js

@@ -0,0 +1,2 @@
+export { resolveRequestIdentity, assertDescriptorIdField } from "../data/identity.js";
+//# sourceMappingURL=validate-identity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate-identity.js","sourceRoot":"","sources":["../../src/validation/validate-identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC"}

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

@@ -0,0 +1,9 @@
+import type { MemorixWriteFieldDescriptor } from "../descriptors/write-descriptor-types.js";
+import type { MemorixWriteIssue } from "../errors/issues.js";
+export declare function validateImmutableFieldsOnPatch(args: {
+    existing: Record<string, unknown>;
+    fields: Record<string, MemorixWriteFieldDescriptor>;
+    input: Record<string, unknown>;
+    inputPathResolver: (name: string, field: MemorixWriteFieldDescriptor) => string;
+}): MemorixWriteIssue[];
+//# sourceMappingURL=validate-immutability.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate-immutability.d.ts","sourceRoot":"","sources":["../../src/validation/validate-immutability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AAC5F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAY7D,wBAAgB,8BAA8B,CAAC,IAAI,EAAE;IACnD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;IACpD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,2BAA2B,KAAK,MAAM,CAAC;CACjF,GAAG,iBAAiB,EAAE,CA0BtB"}

package/dist/validation/validate-immutability.js

@@ -0,0 +1,35 @@
+import { writeIssue } from "../errors/issues.js";
+import { deepGet } from "../utils/path.js";
+const PROTECTED_PATHS = new Set([
+    "entityId",
+    "eventId",
+    "recordId",
+    "createdAt",
+    "_memorix.writeDescriptorId",
+]);
+export function validateImmutableFieldsOnPatch(args) {
+    const issues = [];
+    for (const [name, field] of Object.entries(args.fields)) {
+        if (!field.immutable)
+            continue;
+        const inputPath = args.inputPathResolver(name, field);
+        if (!(inputPath in args.input) && !(name in args.input))
+            continue;
+        const existingVal = deepGet(args.existing, field.target.path);
+        const newVal = args.input[inputPath] ?? args.input[name];
+        if (newVal !== undefined && newVal !== existingVal) {
+            issues.push(writeIssue("IMMUTABLE_FIELD_UPDATE", `field "${name}" is immutable`, {
+                path: field.target.path,
+            }));
+        }
+    }
+    for (const path of PROTECTED_PATHS) {
+        if (path in args.input) {
+            issues.push(writeIssue("IMMUTABLE_FIELD_UPDATE", `system field "${path}" cannot be patched`, {
+                path,
+            }));
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=validate-immutability.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate-immutability.js","sourceRoot":"","sources":["../../src/validation/validate-immutability.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,UAAU;IACV,SAAS;IACT,UAAU;IACV,WAAW;IACX,4BAA4B;CAC7B,CAAC,CAAC;AAEH,MAAM,UAAU,8BAA8B,CAAC,IAK9C;IACC,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,IAAI,CAAC,KAAK,CAAC,SAAS;YAAE,SAAS;QAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACtD,IAAI,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC;YAAE,SAAS;QAClE,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;YACnD,MAAM,CAAC,IAAI,CACT,UAAU,CAAC,wBAAwB,EAAE,UAAU,IAAI,gBAAgB,EAAE;gBACnE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI;aACxB,CAAC,CACH,CAAC;QACJ,CAAC;IACH,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACnC,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CACT,UAAU,CAAC,wBAAwB,EAAE,iBAAiB,IAAI,qBAAqB,EAAE;gBAC/E,IAAI;aACL,CAAC,CACH,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { MemorixWriteFieldDescriptor } from "../descriptors/write-descriptor-types.js";
+import type { MemorixWriteIssue } from "../errors/issues.js";
+export declare function validateFieldValue(fieldName: string, field: MemorixWriteFieldDescriptor, value: unknown): MemorixWriteIssue[];
+//# sourceMappingURL=validate-values.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate-values.d.ts","sourceRoot":"","sources":["../../src/validation/validate-values.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AAC5F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAY7D,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,2BAA2B,EAClC,KAAK,EAAE,OAAO,GACb,iBAAiB,EAAE,CAuDrB"}

package/dist/validation/validate-values.js

@@ -0,0 +1,55 @@
+import { writeIssue } from "../errors/issues.js";
+function isContentPointer(value) {
+    return (value != null &&
+        typeof value === "object" &&
+        "contentKey" in value &&
+        typeof value.contentKey === "string");
+}
+export function validateFieldValue(fieldName, field, value) {
+    const issues = [];
+    if (value === undefined || value === null) {
+        if (value === null && field.nullBehavior === "error") {
+            issues.push(writeIssue("VALIDATION_FAILED", `null not allowed for "${fieldName}"`, {
+                path: fieldName,
+            }));
+        }
+        return issues;
+    }
+    const vt = field.valueType;
+    if (!vt)
+        return issues;
+    if (vt === "content") {
+        if (!isContentPointer(value) && typeof value !== "object") {
+            issues.push(writeIssue("INVALID_VALUE_TYPE", `"${fieldName}" must be content object or provided via content.fields`, {
+                path: fieldName,
+            }));
+        }
+        return issues;
+    }
+    if (vt === "enum") {
+        if (typeof value !== "string" || !field.enumValues?.includes(value)) {
+            issues.push(writeIssue("INVALID_ENUM_VALUE", `"${fieldName}" must be one of: ${field.enumValues?.join(", ") ?? ""}`, { path: fieldName }));
+        }
+        return issues;
+    }
+    if (vt === "string" && typeof value !== "string") {
+        issues.push(writeIssue("INVALID_VALUE_TYPE", `"${fieldName}" must be a string`, { path: fieldName }));
+    }
+    else if (vt === "number" && typeof value !== "number") {
+        issues.push(writeIssue("INVALID_VALUE_TYPE", `"${fieldName}" must be a number`, { path: fieldName }));
+    }
+    else if (vt === "boolean" && typeof value !== "boolean") {
+        issues.push(writeIssue("INVALID_VALUE_TYPE", `"${fieldName}" must be a boolean`, { path: fieldName }));
+    }
+    else if ((vt === "date" || vt === "datetime") && typeof value !== "string") {
+        issues.push(writeIssue("INVALID_VALUE_TYPE", `"${fieldName}" must be an ISO date string`, { path: fieldName }));
+    }
+    else if (vt === "array" && !Array.isArray(value)) {
+        issues.push(writeIssue("INVALID_VALUE_TYPE", `"${fieldName}" must be an array`, { path: fieldName }));
+    }
+    else if (vt === "object" && (typeof value !== "object" || Array.isArray(value))) {
+        issues.push(writeIssue("INVALID_VALUE_TYPE", `"${fieldName}" must be an object`, { path: fieldName }));
+    }
+    return issues;
+}
+//# sourceMappingURL=validate-values.js.map

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

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

package/dist/writer/apply-audit.d.ts

@@ -0,0 +1,10 @@
+import type { MemorixWriteDescriptor } from "../descriptors/write-descriptor-types.js";
+import type { WriteMemorixRecordRequest } from "../client/types.js";
+export declare function applyAuditMetadata(args: {
+    record: Record<string, unknown>;
+    writeDescriptor: MemorixWriteDescriptor;
+    request: Pick<WriteMemorixRecordRequest, "source" | "actor" | "options">;
+    operation: string;
+    metadataRootPath: string;
+}): void;
+//# sourceMappingURL=apply-audit.d.ts.map

package/dist/writer/apply-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-audit.d.ts","sourceRoot":"","sources":["../../src/writer/apply-audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AACvF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAGpE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,eAAe,EAAE,sBAAsB,CAAC;IACxC,OAAO,EAAE,IAAI,CAAC,yBAAyB,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,GAAG,IAAI,CA4CP"}

package/dist/writer/apply-audit.js

@@ -0,0 +1,39 @@
+import { deepSet } from "../utils/path.js";
+export function applyAuditMetadata(args) {
+    const audit = args.writeDescriptor.audit;
+    if (audit?.enabled === false)
+        return;
+    const auditPath = audit?.path ?? "_memorix.audit";
+    const block = {
+        at: new Date().toISOString(),
+        operation: args.operation,
+    };
+    if (audit?.includeDescriptorId !== false) {
+        block.writeDescriptorId = args.writeDescriptor.id;
+    }
+    if (audit?.includeSource !== false && args.request.source) {
+        block.source = args.request.source;
+    }
+    if (audit?.includeActor !== false && args.request.actor) {
+        block.actor = args.request.actor;
+    }
+    if (audit?.includeCorrelationId !== false && args.request.options?.correlationId) {
+        block.correlationId = args.request.options.correlationId;
+    }
+    const relative = auditPath.startsWith(`${args.metadataRootPath}.`)
+        ? auditPath.slice(args.metadataRootPath.length + 1)
+        : auditPath === args.metadataRootPath
+            ? ""
+            : auditPath.replace(/^_memorix\.?/, "");
+    if (!relative) {
+        const meta = args.record[args.metadataRootPath] ?? {};
+        Object.assign(meta, block);
+        args.record[args.metadataRootPath] = meta;
+        return;
+    }
+    if (!args.record[args.metadataRootPath]) {
+        args.record[args.metadataRootPath] = {};
+    }
+    deepSet(args.record[args.metadataRootPath], relative, block);
+}
+//# sourceMappingURL=apply-audit.js.map

package/dist/writer/apply-audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-audit.js","sourceRoot":"","sources":["../../src/writer/apply-audit.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,MAAM,UAAU,kBAAkB,CAAC,IAMlC;IACC,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC;IACzC,IAAI,KAAK,EAAE,OAAO,KAAK,KAAK;QAAE,OAAO;IAErC,MAAM,SAAS,GAAG,KAAK,EAAE,IAAI,IAAI,gBAAgB,CAAC;IAClD,MAAM,KAAK,GAA4B;QACrC,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC;IACF,IAAI,KAAK,EAAE,mBAAmB,KAAK,KAAK,EAAE,CAAC;QACzC,KAAK,CAAC,iBAAiB,GAAG,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;IACpD,CAAC;IACD,IAAI,KAAK,EAAE,aAAa,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC1D,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IACrC,CAAC;IACD,IAAI,KAAK,EAAE,YAAY,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACxD,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;IACnC,CAAC;IACD,IAAI,KAAK,EAAE,oBAAoB,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,CAAC;QACjF,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC;IAC3D,CAAC;IAED,MAAM,QAAQ,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,gBAAgB,GAAG,CAAC;QAChE,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC;QACnD,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,gBAAgB;YACnC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IAE5C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,GACP,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAA6B,IAAI,EAAE,CAAC;QACxE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;QAC1C,OAAO;IACT,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,CAAC;IAC1C,CAAC;IACD,OAAO,CACL,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAA4B,EAC7D,QAAQ,EACR,KAAK,CACN,CAAC;AACJ,CAAC"}

package/dist/writer/apply-field-mapping.d.ts

@@ -0,0 +1,9 @@
+import type { MemorixWriteFieldDescriptor } from "../descriptors/write-descriptor-types.js";
+import type { MemorixContentObject } from "../descriptors/entity-descriptor-types.js";
+export declare function applyFieldMapping(args: {
+    record: Record<string, unknown>;
+    fields: Record<string, MemorixWriteFieldDescriptor>;
+    input: Record<string, unknown>;
+    contentPointers?: Record<string, MemorixContentObject>;
+}): void;
+//# sourceMappingURL=apply-field-mapping.d.ts.map

package/dist/writer/apply-field-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-field-mapping.d.ts","sourceRoot":"","sources":["../../src/writer/apply-field-mapping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AAC5F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAItF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;IACpD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;CACxD,GAAG,IAAI,CA6BP"}

package/dist/writer/apply-field-mapping.js

@@ -0,0 +1,32 @@
+import { deepSet } from "../utils/path.js";
+import { resolveInputPath } from "./resolve-write-field-target.js";
+export function applyFieldMapping(args) {
+    for (const [name, field] of Object.entries(args.fields)) {
+        if (field.writable === false)
+            continue;
+        const inputPath = resolveInputPath(name, field);
+        let value = args.contentPointers?.[name] ??
+            args.input[inputPath] ??
+            args.input[name];
+        if (value === undefined) {
+            if (field.defaultValue !== undefined) {
+                value = field.defaultValue;
+            }
+            else if (field.nullBehavior === "ignore") {
+                continue;
+            }
+            else {
+                continue;
+            }
+        }
+        if (value === null && field.nullBehavior === "ignore")
+            continue;
+        if (value === null && field.nullBehavior === "clear") {
+            deepSet(args.record, field.target.path, null);
+            continue;
+        }
+        const targetRoot = args.record;
+        deepSet(targetRoot, field.target.path, value);
+    }
+}
+//# sourceMappingURL=apply-field-mapping.js.map

package/dist/writer/apply-field-mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-field-mapping.js","sourceRoot":"","sources":["../../src/writer/apply-field-mapping.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,MAAM,UAAU,iBAAiB,CAAC,IAKjC;IACC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,IAAI,KAAK,CAAC,QAAQ,KAAK,KAAK;YAAE,SAAS;QAEvC,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAChD,IAAI,KAAK,GACP,IAAI,CAAC,eAAe,EAAE,CAAC,IAAI,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;YACrB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEnB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;gBACrC,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC;YAC7B,CAAC;iBAAM,IAAI,KAAK,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;gBAC3C,SAAS;YACX,CAAC;iBAAM,CAAC;gBACN,SAAS;YACX,CAAC;QACH,CAAC;QAED,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,YAAY,KAAK,QAAQ;YAAE,SAAS;QAChE,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,YAAY,KAAK,OAAO,EAAE,CAAC;YACrD,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC9C,SAAS;QACX,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC;QAC/B,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/writer/apply-timestamps.d.ts

@@ -0,0 +1,8 @@
+import type { MemorixWriteDescriptor } from "../descriptors/write-descriptor-types.js";
+export declare function applyTimestamps(args: {
+    record: Record<string, unknown>;
+    writeDescriptor: MemorixWriteDescriptor;
+    now: string;
+    isNew: boolean;
+}): void;
+//# sourceMappingURL=apply-timestamps.d.ts.map

package/dist/writer/apply-timestamps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-timestamps.d.ts","sourceRoot":"","sources":["../../src/writer/apply-timestamps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAEvF,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,eAAe,EAAE,sBAAsB,CAAC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,IAAI,CAWP"}

package/dist/writer/apply-timestamps.js

@@ -0,0 +1,12 @@
+export function applyTimestamps(args) {
+    const createdPath = args.writeDescriptor.timestamps?.createdAtPath ?? "createdAt";
+    const updatedPath = args.writeDescriptor.timestamps?.updatedAtPath ?? "modifiedAt";
+    const source = args.writeDescriptor.timestamps?.writeTimeSource ?? "server";
+    if (source === "server") {
+        if (args.isNew) {
+            args.record[createdPath] = args.now;
+        }
+        args.record[updatedPath] = args.now;
+    }
+}
+//# sourceMappingURL=apply-timestamps.js.map

package/dist/writer/apply-timestamps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-timestamps.js","sourceRoot":"","sources":["../../src/writer/apply-timestamps.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,eAAe,CAAC,IAK/B;IACC,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,aAAa,IAAI,WAAW,CAAC;IAClF,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,aAAa,IAAI,YAAY,CAAC;IACnF,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,eAAe,IAAI,QAAQ,CAAC;IAE5E,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;QACtC,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/writer/build-record.d.ts

@@ -0,0 +1,28 @@
+import type { MemorixEntityDescriptor } from "../descriptors/entity-descriptor-types.js";
+import type { MemorixWriteDescriptor } from "../descriptors/write-descriptor-types.js";
+import type { ResolvedIdentity } from "../data/identity.js";
+import type { MemorixWriterDefaults } from "../client/types.js";
+export type MemorixWrittenRecordBase = {
+    entityId?: string;
+    eventId?: string;
+    recordId: string;
+    createdAt: string;
+    modifiedAt: string;
+    data: Record<string, unknown>;
+    _memorix?: Record<string, unknown>;
+};
+export declare function buildBaseRecord(args: {
+    identity: ResolvedIdentity;
+    writeDescriptor: MemorixWriteDescriptor;
+    entity: MemorixEntityDescriptor;
+    defaults: MemorixWriterDefaults;
+    recordId?: string;
+    now: string;
+    idempotencyKey?: string;
+    correlationId?: string;
+    source?: Record<string, unknown>;
+    actor?: Record<string, unknown>;
+    operation: string;
+}): Record<string, unknown>;
+export declare function setPayloadHash(record: Record<string, unknown>, hash: string, path?: string): void;
+//# sourceMappingURL=build-record.d.ts.map

package/dist/writer/build-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-record.d.ts","sourceRoot":"","sources":["../../src/writer/build-record.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AACzF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AACvF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAGhE,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,eAAe,EAAE,sBAAsB,CAAC;IACxC,MAAM,EAAE,uBAAuB,CAAC;IAChC,QAAQ,EAAE,qBAAqB,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2B1B;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,SAAyB,GAC5B,IAAI,CAEN"}

package/dist/writer/build-record.js

@@ -0,0 +1,36 @@
+import { randomUUID } from "node:crypto";
+import { deepSet } from "../utils/path.js";
+export function buildBaseRecord(args) {
+    const recordId = args.recordId ?? `rec_${randomUUID().replace(/-/g, "")}`;
+    const metaPath = args.defaults.memorixMetadataPath;
+    const record = {
+        recordId,
+        data: {},
+        [args.writeDescriptor.timestamps?.createdAtPath ?? "createdAt"]: args.now,
+        [args.writeDescriptor.timestamps?.updatedAtPath ?? "modifiedAt"]: args.now,
+    };
+    if (args.identity.entityId)
+        record.entityId = args.identity.entityId;
+    if (args.identity.eventId)
+        record.eventId = args.identity.eventId;
+    const meta = {
+        entity: args.entity.entityName,
+        contentType: args.writeDescriptor.target.contentType,
+        writeDescriptorId: args.writeDescriptor.id,
+        operation: args.operation,
+    };
+    if (args.idempotencyKey)
+        meta.idempotencyKey = args.idempotencyKey;
+    if (args.correlationId)
+        meta.correlationId = args.correlationId;
+    if (args.source)
+        meta.source = args.source;
+    if (args.actor)
+        meta.actor = args.actor;
+    record[metaPath] = meta;
+    return record;
+}
+export function setPayloadHash(record, hash, path = "_memorix.payloadHash") {
+    deepSet(record, path, hash);
+}
+//# sourceMappingURL=build-record.js.map

package/dist/writer/build-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-record.js","sourceRoot":"","sources":["../../src/writer/build-record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAKzC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAY3C,MAAM,UAAU,eAAe,CAAC,IAY/B;IACC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,UAAU,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;IAC1E,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAEnD,MAAM,MAAM,GAA4B;QACtC,QAAQ;QACR,IAAI,EAAE,EAAE;QACR,CAAC,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,aAAa,IAAI,WAAW,CAAC,EAAE,IAAI,CAAC,GAAG;QACzE,CAAC,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,aAAa,IAAI,YAAY,CAAC,EAAE,IAAI,CAAC,GAAG;KAC3E,CAAC;IAEF,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ;QAAE,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;IACrE,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO;QAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;IAElE,MAAM,IAAI,GAA4B;QACpC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;QAC9B,WAAW,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,WAAW;QACpD,iBAAiB,EAAE,IAAI,CAAC,eAAe,CAAC,EAAE;QAC1C,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC;IACF,IAAI,IAAI,CAAC,cAAc;QAAE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;IACnE,IAAI,IAAI,CAAC,aAAa;QAAE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;IAChE,IAAI,IAAI,CAAC,MAAM;QAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3C,IAAI,IAAI,CAAC,KAAK;QAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAExC,MAAM,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IACxB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,MAA+B,EAC/B,IAAY,EACZ,IAAI,GAAG,sBAAsB;IAE7B,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAC9B,CAAC"}

package/dist/writer/resolve-conflict.d.ts

@@ -0,0 +1,12 @@
+import type { MemorixWriteDescriptor } from "../descriptors/write-descriptor-types.js";
+import type { MemorixWriteAdapter } from "../data/memorix-write-adapter.js";
+export declare function buildMatchFilter(matchBy: string[], identity: Record<string, unknown>, input: Record<string, unknown>): Record<string, unknown>;
+export declare function findExistingForUpsert(args: {
+    adapter: MemorixWriteAdapter;
+    collection: string;
+    writeDescriptor: MemorixWriteDescriptor;
+    identityFilter: Record<string, unknown>;
+    input: Record<string, unknown>;
+}): Promise<Record<string, unknown>[]>;
+export declare function resolveConflictAction(writeDescriptor: MemorixWriteDescriptor, matchCount: number): "insert" | "update" | "skip" | "fail" | "append";
+//# sourceMappingURL=resolve-conflict.d.ts.map

package/dist/writer/resolve-conflict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-conflict.d.ts","sourceRoot":"","sources":["../../src/writer/resolve-conflict.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AACvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAG5E,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EAAE,EACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,OAAO,EAAE,mBAAmB,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,sBAAsB,CAAC;IACxC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAMrC;AAED,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,sBAAsB,EACvC,UAAU,EAAE,MAAM,GACjB,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAalD"}

package/dist/writer/resolve-conflict.js

@@ -0,0 +1,32 @@
+import { throwWriterError } from "../errors/errors.js";
+export function buildMatchFilter(matchBy, identity, input) {
+    const filter = { ...identity };
+    for (const key of matchBy) {
+        if (key in input)
+            filter[key] = input[key];
+    }
+    return filter;
+}
+export async function findExistingForUpsert(args) {
+    const matchBy = args.writeDescriptor.conflict?.matchBy ?? [
+        args.writeDescriptor.identity.idField,
+    ];
+    const filter = buildMatchFilter(matchBy, args.identityFilter, args.input);
+    return args.adapter.findMany(args.collection, filter, { limit: 25 });
+}
+export function resolveConflictAction(writeDescriptor, matchCount) {
+    if (matchCount === 0)
+        return "insert";
+    const onConflict = writeDescriptor.conflict?.onConflict ?? "update";
+    if (matchCount > 1 && onConflict === "fail") {
+        throwWriterError("CONFLICT", `multiple records match upsert criteria (${matchCount})`);
+    }
+    if (matchCount > 1 && onConflict === "append")
+        return "insert";
+    if (onConflict === "skip")
+        return "skip";
+    if (onConflict === "replace")
+        return "update";
+    return onConflict === "append" ? "insert" : "update";
+}
+//# sourceMappingURL=resolve-conflict.js.map

package/dist/writer/resolve-conflict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-conflict.js","sourceRoot":"","sources":["../../src/writer/resolve-conflict.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,UAAU,gBAAgB,CAC9B,OAAiB,EACjB,QAAiC,EACjC,KAA8B;IAE9B,MAAM,MAAM,GAA4B,EAAE,GAAG,QAAQ,EAAE,CAAC;IACxD,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,GAAG,IAAI,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAM3C;IACC,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,OAAO,IAAI;QACxD,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,OAAO;KACtC,CAAC;IACF,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1E,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,eAAuC,EACvC,UAAkB;IAElB,IAAI,UAAU,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IACtC,MAAM,UAAU,GAAG,eAAe,CAAC,QAAQ,EAAE,UAAU,IAAI,QAAQ,CAAC;IACpE,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QAC5C,gBAAgB,CACd,UAAU,EACV,2CAA2C,UAAU,GAAG,CACzD,CAAC;IACJ,CAAC;IACD,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC/D,IAAI,UAAU,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACzC,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC9C,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;AACvD,CAAC"}

package/dist/writer/resolve-idempotency.d.ts

@@ -0,0 +1,23 @@
+import type { MemorixWriteDescriptor } from "../descriptors/write-descriptor-types.js";
+import type { MemorixWriteAdapter } from "../data/memorix-write-adapter.js";
+import type { MemorixWriteIssue } from "../errors/issues.js";
+export declare function hashPayload(payload: unknown): string;
+export type IdempotencyCheckResult = {
+    action: "proceed";
+} | {
+    action: "deduplicated";
+    existing: Record<string, unknown>;
+} | {
+    action: "conflict";
+    issues: MemorixWriteIssue[];
+};
+export declare function checkIdempotency(args: {
+    adapter: MemorixWriteAdapter;
+    collection: string;
+    writeDescriptor: MemorixWriteDescriptor;
+    idempotencyKey: string;
+    payloadHash: string;
+    identityFilter: Record<string, unknown>;
+}): Promise<IdempotencyCheckResult>;
+export declare function applyIdempotencyToRecord(record: Record<string, unknown>, idempotencyKey: string, payloadHash: string, writeDescriptor: MemorixWriteDescriptor): void;
+//# sourceMappingURL=resolve-idempotency.d.ts.map

package/dist/writer/resolve-idempotency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-idempotency.d.ts","sourceRoot":"","sources":["../../src/writer/resolve-idempotency.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AACvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAO7D,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAIpD;AAED,MAAM,MAAM,sBAAsB,GAC9B;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC7D;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,iBAAiB,EAAE,CAAA;CAAE,CAAC;AAExD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,OAAO,EAAE,mBAAmB,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,sBAAsB,CAAC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAkClC;AASD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,sBAAsB,GACtC,IAAI,CAsBN"}

package/dist/writer/resolve-idempotency.js

@@ -0,0 +1,69 @@
+import { createHash } from "node:crypto";
+import { writeIssue } from "../errors/issues.js";
+import { DEFAULT_IDEMPOTENCY_KEY_PATH, DEFAULT_PAYLOAD_HASH_PATH, } from "../constants.js";
+export function hashPayload(payload) {
+    return createHash("sha256")
+        .update(JSON.stringify(payload))
+        .digest("hex");
+}
+export async function checkIdempotency(args) {
+    const cfg = args.writeDescriptor.conflict?.idempotency;
+    if (!cfg?.enabled)
+        return { action: "proceed" };
+    const keyPath = cfg.keyPath ?? DEFAULT_IDEMPOTENCY_KEY_PATH;
+    const hashPath = cfg.payloadHashPath ?? DEFAULT_PAYLOAD_HASH_PATH;
+    const filter = {
+        ...args.identityFilter,
+        [keyPath]: args.idempotencyKey,
+    };
+    const existing = await args.adapter.findOne(args.collection, filter);
+    if (!existing)
+        return { action: "proceed" };
+    const existingHash = getByPath(existing, hashPath);
+    if (existingHash === args.payloadHash) {
+        const behavior = cfg.behavior ?? "deduplicate";
+        if (behavior === "failOnDifferentPayload") {
+            return { action: "deduplicated", existing };
+        }
+        return { action: "deduplicated", existing };
+    }
+    return {
+        action: "conflict",
+        issues: [
+            writeIssue("IDEMPOTENCY_CONFLICT", `idempotency key "${args.idempotencyKey}" already used with different payload`, { severity: "error", details: { idempotencyKey: args.idempotencyKey } }),
+        ],
+    };
+}
+function getByPath(obj, path) {
+    return path.split(".").reduce((acc, p) => {
+        if (acc == null || typeof acc !== "object")
+            return undefined;
+        return acc[p];
+    }, obj);
+}
+export function applyIdempotencyToRecord(record, idempotencyKey, payloadHash, writeDescriptor) {
+    const cfg = writeDescriptor.conflict?.idempotency;
+    if (!cfg?.enabled)
+        return;
+    const keyPath = cfg.storePath ?? cfg.keyPath ?? DEFAULT_IDEMPOTENCY_KEY_PATH;
+    const hashPath = cfg.payloadHashPath ?? DEFAULT_PAYLOAD_HASH_PATH;
+    const parts = keyPath.split(".");
+    let cur = record;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const p = parts[i];
+        if (!cur[p] || typeof cur[p] !== "object")
+            cur[p] = {};
+        cur = cur[p];
+    }
+    cur[parts[parts.length - 1]] = idempotencyKey;
+    const hashParts = hashPath.split(".");
+    cur = record;
+    for (let i = 0; i < hashParts.length - 1; i++) {
+        const p = hashParts[i];
+        if (!cur[p] || typeof cur[p] !== "object")
+            cur[p] = {};
+        cur = cur[p];
+    }
+    cur[hashParts[hashParts.length - 1]] = payloadHash;
+}
+//# sourceMappingURL=resolve-idempotency.js.map

package/dist/writer/resolve-idempotency.js.map

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

package/dist/writer/resolve-operation.d.ts

@@ -0,0 +1,4 @@
+import type { MemorixWriteDescriptor } from "../descriptors/write-descriptor-types.js";
+export type WriteOperation = "add" | "upsert" | "patch" | "replace";
+export declare function resolveWriteOperation(writeDescriptor: MemorixWriteDescriptor, requested?: WriteOperation): WriteOperation;
+//# sourceMappingURL=resolve-operation.d.ts.map

package/dist/writer/resolve-operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-operation.d.ts","sourceRoot":"","sources":["../../src/writer/resolve-operation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAGvF,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAEpE,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,sBAAsB,EACvC,SAAS,CAAC,EAAE,cAAc,GACzB,cAAc,CAShB"}

package/dist/writer/resolve-operation.js

@@ -0,0 +1,9 @@
+import { throwWriterError } from "../errors/errors.js";
+export function resolveWriteOperation(writeDescriptor, requested) {
+    const op = requested ?? writeDescriptor.operations.default;
+    if (!writeDescriptor.operations.allowed.includes(op)) {
+        throwWriterError("OPERATION_NOT_ALLOWED", `operation "${op}" is not allowed by write descriptor "${writeDescriptor.id}"`);
+    }
+    return op;
+}
+//# sourceMappingURL=resolve-operation.js.map

package/dist/writer/resolve-operation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-operation.js","sourceRoot":"","sources":["../../src/writer/resolve-operation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAIvD,MAAM,UAAU,qBAAqB,CACnC,eAAuC,EACvC,SAA0B;IAE1B,MAAM,EAAE,GAAG,SAAS,IAAI,eAAe,CAAC,UAAU,CAAC,OAAO,CAAC;IAC3D,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QACrD,gBAAgB,CACd,uBAAuB,EACvB,cAAc,EAAE,yCAAyC,eAAe,CAAC,EAAE,GAAG,CAC/E,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/writer/resolve-write-field-target.d.ts

@@ -0,0 +1,4 @@
+import type { MemorixWriteFieldDescriptor } from "../descriptors/write-descriptor-types.js";
+export declare function resolveMemorixWriteFieldTarget(fieldName: string, field: MemorixWriteFieldDescriptor): string;
+export declare function resolveInputPath(fieldName: string, field: MemorixWriteFieldDescriptor): string;
+//# sourceMappingURL=resolve-write-field-target.d.ts.map