@x12i/memorix-writer 1.0.0

package/dist/constants.js

@@ -0,0 +1,13 @@
+export const DEFAULT_MEMORIX_APP_ID = "memorix";
+export const MEMORIX_WRITE_DESCRIPTORS_CATALOG_ID = "memorix-write-descriptors";
+export const MEMORIX_ENTITY_DESCRIPTORS_CATALOG_ID = "memorix-entity-descriptors";
+export const DEFAULT_CANONICAL_CONTENT_TYPE = "snapshots";
+export const DEFAULT_DATA_ROOT = "data";
+export const DEFAULT_EFFECTIVE_DATE_PATH = "modifiedAt";
+export const DEFAULT_CONTENT_MAX_BYTES = 5 * 1024 * 1024;
+export const DEFAULT_MEMORIX_METADATA_PATH = "_memorix";
+export const DEFAULT_AUDIT_PATH = "_memorix.audit";
+export const DEFAULT_IDEMPOTENCY_KEY_PATH = "_memorix.idempotencyKey";
+export const DEFAULT_PAYLOAD_HASH_PATH = "_memorix.payloadHash";
+export const DEFAULT_CONTENT_KEY_TEMPLATE = "{{entity}}/{{contentType}}/{{id}}/{{recordId}}/{{field}}.md";
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sBAAsB,GAAG,SAAS,CAAC;AAEhD,MAAM,CAAC,MAAM,oCAAoC,GAAG,2BAA2B,CAAC;AAChF,MAAM,CAAC,MAAM,qCAAqC,GAAG,4BAA4B,CAAC;AAElF,MAAM,CAAC,MAAM,8BAA8B,GAAG,WAAW,CAAC;AAC1D,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC;AACxC,MAAM,CAAC,MAAM,2BAA2B,GAAG,YAAY,CAAC;AACxD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AACzD,MAAM,CAAC,MAAM,6BAA6B,GAAG,UAAU,CAAC;AACxD,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AACnD,MAAM,CAAC,MAAM,4BAA4B,GAAG,yBAAyB,CAAC;AACtE,MAAM,CAAC,MAAM,yBAAyB,GAAG,sBAAsB,CAAC;AAEhE,MAAM,CAAC,MAAM,4BAA4B,GACvC,6DAA6D,CAAC"}

package/dist/content/compute-content-metadata.d.ts

@@ -0,0 +1,16 @@
+export type MemorixWrittenContentMetadata = {
+    sizeBytes: number;
+    words?: number;
+    chars?: number;
+    contentType: "text/markdown" | "text/plain";
+    format: "markdown" | "text";
+    createdAt: string;
+    hash?: string;
+};
+export declare function computeContentMetadata(args: {
+    body: string;
+    format: "markdown" | "text";
+    createdAt: string;
+    hash?: string;
+}): MemorixWrittenContentMetadata;
+//# sourceMappingURL=compute-content-metadata.d.ts.map

package/dist/content/compute-content-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-content-metadata.d.ts","sourceRoot":"","sources":["../../src/content/compute-content-metadata.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,6BAA6B,GAAG;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,eAAe,GAAG,YAAY,CAAC;IAC5C,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,6BAA6B,CAWhC"}

package/dist/content/compute-content-metadata.js

@@ -0,0 +1,13 @@
+export function computeContentMetadata(args) {
+    const words = args.body.trim().split(/\s+/).filter(Boolean).length;
+    return {
+        sizeBytes: Buffer.byteLength(args.body, "utf8"),
+        words,
+        chars: args.body.length,
+        contentType: args.format === "markdown" ? "text/markdown" : "text/plain",
+        format: args.format,
+        createdAt: args.createdAt,
+        hash: args.hash,
+    };
+}
+//# sourceMappingURL=compute-content-metadata.js.map

package/dist/content/compute-content-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-content-metadata.js","sourceRoot":"","sources":["../../src/content/compute-content-metadata.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,sBAAsB,CAAC,IAKtC;IACC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IACnE,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;QAC/C,KAAK;QACL,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM;QACvB,WAAW,EAAE,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,YAAY;QACxE,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC;AACJ,CAAC"}

package/dist/content/generate-content-key.d.ts

@@ -0,0 +1,13 @@
+export type ContentKeyTemplateContext = {
+    entity: string;
+    contentType: string;
+    entityId?: string;
+    eventId?: string;
+    field: string;
+    timestamp: string;
+    recordId: string;
+    idempotencyKey?: string;
+    hash?: string;
+};
+export declare function generateContentKey(template: string, ctx: ContentKeyTemplateContext, bodyForHash?: string): string;
+//# sourceMappingURL=generate-content-key.d.ts.map

package/dist/content/generate-content-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-content-key.d.ts","sourceRoot":"","sources":["../../src/content/generate-content-key.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,yBAAyB,EAC9B,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAsBR"}

package/dist/content/generate-content-key.js

@@ -0,0 +1,22 @@
+import { createHash } from "node:crypto";
+export function generateContentKey(template, ctx, bodyForHash) {
+    const id = ctx.entityId ?? ctx.eventId ?? "unknown";
+    const hash = ctx.hash ??
+        (bodyForHash
+            ? createHash("sha256").update(bodyForHash).digest("hex").slice(0, 12)
+            : "");
+    const vars = {
+        entity: ctx.entity,
+        contentType: ctx.contentType,
+        entityId: ctx.entityId ?? "",
+        eventId: ctx.eventId ?? "",
+        field: ctx.field,
+        timestamp: ctx.timestamp,
+        recordId: ctx.recordId,
+        id: id,
+        idempotencyKey: ctx.idempotencyKey ?? "",
+        hash,
+    };
+    return template.replace(/\{\{(\w+)\}\}/g, (_, key) => vars[key] ?? "");
+}
+//# sourceMappingURL=generate-content-key.js.map

package/dist/content/generate-content-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-content-key.js","sourceRoot":"","sources":["../../src/content/generate-content-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAczC,MAAM,UAAU,kBAAkB,CAChC,QAAgB,EAChB,GAA8B,EAC9B,WAAoB;IAEpB,MAAM,EAAE,GAAG,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,OAAO,IAAI,SAAS,CAAC;IACpD,MAAM,IAAI,GACR,GAAG,CAAC,IAAI;QACR,CAAC,WAAW;YACV,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YACrE,CAAC,CAAC,EAAE,CAAC,CAAC;IAEV,MAAM,IAAI,GAA2B;QACnC,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE;QAC5B,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE;QAC1B,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,EAAE,EAAE,EAAE;QACN,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,EAAE;QACxC,IAAI;KACL,CAAC;IAEF,OAAO,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;AACjF,CAAC"}

package/dist/content/generate-preview.d.ts

@@ -0,0 +1,2 @@
+export declare function generatePreview(body: string, maxChars: number): string;
+//# sourceMappingURL=generate-preview.d.ts.map

package/dist/content/generate-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-preview.d.ts","sourceRoot":"","sources":["../../src/content/generate-preview.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAItE"}

package/dist/content/generate-preview.js

@@ -0,0 +1,7 @@
+export function generatePreview(body, maxChars) {
+    const trimmed = body.trim();
+    if (trimmed.length <= maxChars)
+        return trimmed;
+    return `${trimmed.slice(0, maxChars)}…`;
+}
+//# sourceMappingURL=generate-preview.js.map

package/dist/content/generate-preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-preview.js","sourceRoot":"","sources":["../../src/content/generate-preview.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,QAAgB;IAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,OAAO,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,OAAO,CAAC;IAC/C,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC;AAC1C,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { MemorixWriteIssue } from "../errors/issues.js";
+export declare function mapContentWriteError(fieldName: string, err: unknown): MemorixWriteIssue;
+//# sourceMappingURL=map-content-write-errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"map-content-write-errors.d.ts","sourceRoot":"","sources":["../../src/content/map-content-write-errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,OAAO,GACX,iBAAiB,CAOnB"}

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

@@ -0,0 +1,9 @@
+import { writeIssue } from "../errors/issues.js";
+export function mapContentWriteError(fieldName, err) {
+    const message = err instanceof Error ? err.message : "content object write failed";
+    return writeIssue("CONTENT_WRITE_FAILED", message, {
+        path: fieldName,
+        details: err instanceof Error ? { name: err.name } : undefined,
+    });
+}
+//# sourceMappingURL=map-content-write-errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"map-content-write-errors.js","sourceRoot":"","sources":["../../src/content/map-content-write-errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,MAAM,UAAU,oBAAoB,CAClC,SAAiB,EACjB,GAAY;IAEZ,MAAM,OAAO,GACX,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,6BAA6B,CAAC;IACrE,OAAO,UAAU,CAAC,sBAAsB,EAAE,OAAO,EAAE;QACjD,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;KAC/D,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,25 @@
+import type { MemorixContentStorageDescriptor, MemorixEntityDescriptor } from "../descriptors/entity-descriptor-types.js";
+import type { MemorixWriteFieldDescriptor } from "../descriptors/write-descriptor-types.js";
+import type { MemorixWriterDefaults } from "../client/types.js";
+export type ResolvedContentWriteConfig = {
+    storage: MemorixContentStorageDescriptor;
+    maxBytes: number;
+    contentKeyTemplate?: string;
+    generatePreview: boolean;
+    previewMaxChars: number;
+    computeMetadata: boolean;
+};
+export declare function resolveMemorixContentWriteConfig(args: {
+    entity: MemorixEntityDescriptor;
+    propertyName?: string;
+    field?: MemorixWriteFieldDescriptor;
+    defaults: MemorixWriterDefaults;
+    writeContentDefaults?: {
+        maxBytes?: number;
+        contentKeyTemplate?: string;
+        generatePreview?: boolean;
+        previewMaxChars?: number;
+        computeMetadata?: boolean;
+    };
+}): ResolvedContentWriteConfig;
+//# sourceMappingURL=resolve-content-write-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-content-write-config.d.ts","sourceRoot":"","sources":["../../src/content/resolve-content-write-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,+BAA+B,EAC/B,uBAAuB,EAExB,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AAC5F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAGhE,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,EAAE,+BAA+B,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,wBAAgB,gCAAgC,CAAC,IAAI,EAAE;IACrD,MAAM,EAAE,uBAAuB,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,2BAA2B,CAAC;IACpC,QAAQ,EAAE,qBAAqB,CAAC;IAChC,oBAAoB,CAAC,EAAE;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B,CAAC;CACH,GAAG,0BAA0B,CA6C7B"}

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

@@ -0,0 +1,35 @@
+import { throwWriterError } from "../errors/errors.js";
+export function resolveMemorixContentWriteConfig(args) {
+    const property = args.propertyName
+        ? args.entity.properties[args.propertyName]
+        : undefined;
+    const storage = args.field?.content?.storage ??
+        property?.content?.storage ??
+        args.entity.contentDefaults?.storage;
+    if (!storage?.provider || !storage?.bucket) {
+        throwWriterError("CONTENT_WRITE_FAILED", "content storage provider and bucket must be configured in descriptors");
+    }
+    const maxBytes = args.field?.content?.maxBytes ??
+        property?.content?.maxBytes ??
+        args.entity.contentDefaults?.maxBytes ??
+        args.writeContentDefaults?.maxBytes ??
+        args.defaults.packageMaxContentBytes ??
+        args.defaults.contentMaxBytes;
+    return {
+        storage,
+        maxBytes,
+        contentKeyTemplate: args.field?.content?.contentKeyTemplate ??
+            args.writeContentDefaults?.contentKeyTemplate ??
+            args.defaults.contentKeyTemplate,
+        generatePreview: args.field?.content?.generatePreview ??
+            args.writeContentDefaults?.generatePreview ??
+            true,
+        previewMaxChars: args.field?.content?.previewMaxChars ??
+            args.writeContentDefaults?.previewMaxChars ??
+            500,
+        computeMetadata: args.field?.content?.computeMetadata ??
+            args.writeContentDefaults?.computeMetadata ??
+            true,
+    };
+}
+//# sourceMappingURL=resolve-content-write-config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-content-write-config.js","sourceRoot":"","sources":["../../src/content/resolve-content-write-config.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAWvD,MAAM,UAAU,gCAAgC,CAAC,IAYhD;IACC,MAAM,QAAQ,GAA0C,IAAI,CAAC,YAAY;QACvE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC;QAC3C,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,OAAO,GACX,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO;QAC5B,QAAQ,EAAE,OAAO,EAAE,OAAO;QAC1B,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC;IAEvC,IAAI,CAAC,OAAO,EAAE,QAAQ,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAC3C,gBAAgB,CACd,sBAAsB,EACtB,uEAAuE,CACxE,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GACZ,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ;QAC7B,QAAQ,EAAE,OAAO,EAAE,QAAQ;QAC3B,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,QAAQ;QACrC,IAAI,CAAC,oBAAoB,EAAE,QAAQ;QACnC,IAAI,CAAC,QAAQ,CAAC,sBAAsB;QACpC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC;IAEhC,OAAO;QACL,OAAO;QACP,QAAQ;QACR,kBAAkB,EAChB,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,kBAAkB;YACvC,IAAI,CAAC,oBAAoB,EAAE,kBAAkB;YAC7C,IAAI,CAAC,QAAQ,CAAC,kBAAkB;QAClC,eAAe,EACb,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,eAAe;YACpC,IAAI,CAAC,oBAAoB,EAAE,eAAe;YAC1C,IAAI;QACN,eAAe,EACb,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,eAAe;YACpC,IAAI,CAAC,oBAAoB,EAAE,eAAe;YAC1C,GAAG;QACL,eAAe,EACb,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,eAAe;YACpC,IAAI,CAAC,oBAAoB,EAAE,eAAe;YAC1C,IAAI;KACP,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,40 @@
+import type { MemorixContentObject } from "../descriptors/entity-descriptor-types.js";
+import type { MemorixWriteFieldDescriptor } from "../descriptors/write-descriptor-types.js";
+import type { MemorixWriterClient } from "../client/types.js";
+import type { MemorixEntityDescriptor } from "../descriptors/entity-descriptor-types.js";
+import type { MemorixWriteDescriptor } from "../descriptors/write-descriptor-types.js";
+export type ContentWriteResult = {
+    pointer: MemorixContentObject;
+    written: boolean;
+    sizeBytes?: number;
+    format?: "markdown" | "text";
+    storageKey: string;
+};
+export type WrittenContentHandle = {
+    fieldName: string;
+    storageKey: string;
+    provider: "gcs" | "s3";
+};
+export declare function writeMemorixContentObject(args: {
+    client: MemorixWriterClient;
+    entity: MemorixEntityDescriptor;
+    writeDescriptor: MemorixWriteDescriptor;
+    fieldName: string;
+    field: MemorixWriteFieldDescriptor;
+    body?: string;
+    format?: "markdown" | "text";
+    existingPointer?: MemorixContentObject;
+    context: {
+        entityId?: string;
+        eventId?: string;
+        recordId: string;
+        timestamp: string;
+        idempotencyKey?: string;
+    };
+    skipUpload?: boolean;
+}): Promise<{
+    result: ContentWriteResult;
+    handle?: WrittenContentHandle;
+}>;
+export declare function cleanupWrittenContent(client: MemorixWriterClient, handles: WrittenContentHandle[]): Promise<void>;
+//# sourceMappingURL=write-content-object.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write-content-object.d.ts","sourceRoot":"","sources":["../../src/content/write-content-object.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACtF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AAC5F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AACzF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAQvF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,oBAAoB,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,KAAK,GAAG,IAAI,CAAC;CACxB,CAAC;AAoBF,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,EAAE,uBAAuB,CAAC;IAChC,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,eAAe,CAAC,EAAE,oBAAoB,CAAC;IACvC,OAAO,EAAE;QACP,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,kBAAkB,CAAC;IAAC,MAAM,CAAC,EAAE,oBAAoB,CAAA;CAAE,CAAC,CAwGzE;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,oBAAoB,EAAE,GAC9B,OAAO,CAAC,IAAI,CAAC,CAOf"}

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

@@ -0,0 +1,117 @@
+import { createHash } from "node:crypto";
+import { generateContentKey } from "./generate-content-key.js";
+import { generatePreview } from "./generate-preview.js";
+import { computeContentMetadata } from "./compute-content-metadata.js";
+import { resolveMemorixContentWriteConfig } from "./resolve-content-write-config.js";
+import { mapContentWriteError } from "./map-content-write-errors.js";
+import { isMemorixContentPointer } from "../validation/validate-content.js";
+function resolveObjectWriter(client, provider) {
+    const w = client.contentWriters[provider];
+    if (!w) {
+        throw new Error(`MemorixWriter: content writer for provider "${provider}" is not configured`);
+    }
+    return w;
+}
+function fullStorageKey(prefix, contentKey) {
+    const p = prefix?.replace(/\/+$/, "") ?? "";
+    return p ? `${p}/${contentKey.replace(/^\/+/, "")}` : contentKey.replace(/^\/+/, "");
+}
+export async function writeMemorixContentObject(args) {
+    const { client, entity, writeDescriptor, fieldName, field } = args;
+    if (args.existingPointer && isMemorixContentPointer(args.existingPointer)) {
+        if (field.content?.acceptPointer === false) {
+            throw new Error(`pointer not accepted for field "${fieldName}"`);
+        }
+        return {
+            result: {
+                pointer: args.existingPointer,
+                written: false,
+                sizeBytes: typeof args.existingPointer.metadata?.sizeBytes === "number"
+                    ? args.existingPointer.metadata.sizeBytes
+                    : undefined,
+                format: args.existingPointer.metadata?.format ??
+                    undefined,
+                storageKey: args.existingPointer.contentKey,
+            },
+        };
+    }
+    if (!args.body) {
+        throw new Error(`content body required for field "${fieldName}"`);
+    }
+    const config = resolveMemorixContentWriteConfig({
+        entity,
+        propertyName: fieldName,
+        field,
+        defaults: client.defaults,
+        writeContentDefaults: writeDescriptor.content,
+    });
+    const fmt = args.format ?? field.content?.format ?? "markdown";
+    const hash = createHash("sha256").update(args.body).digest("hex").slice(0, 12);
+    const contentKey = generateContentKey(config.contentKeyTemplate ?? client.defaults.contentKeyTemplate, {
+        entity: entity.entityName,
+        contentType: writeDescriptor.target.contentType,
+        entityId: args.context.entityId,
+        eventId: args.context.eventId,
+        field: fieldName,
+        timestamp: args.context.timestamp,
+        recordId: args.context.recordId,
+        idempotencyKey: args.context.idempotencyKey,
+        hash,
+    }, args.body);
+    const storageKey = fullStorageKey(config.storage.prefix, contentKey);
+    const mime = fmt === "markdown" ? "text/markdown" : "text/plain";
+    if (!args.skipUpload) {
+        try {
+            const writer = resolveObjectWriter(client, config.storage.provider);
+            await writer.uploadObject({
+                key: storageKey,
+                body: args.body,
+                contentType: mime,
+            });
+        }
+        catch (err) {
+            throw mapContentWriteError(fieldName, err);
+        }
+    }
+    const metadata = config.computeMetadata
+        ? computeContentMetadata({
+            body: args.body,
+            format: fmt,
+            createdAt: args.context.timestamp,
+            hash,
+        })
+        : { sizeBytes: Buffer.byteLength(args.body, "utf8"), format: fmt, contentType: mime, createdAt: args.context.timestamp };
+    const preview = config.generatePreview
+        ? generatePreview(args.body, config.previewMaxChars)
+        : undefined;
+    const pointer = {
+        contentKey,
+        metadata,
+        preview,
+    };
+    return {
+        result: {
+            pointer,
+            written: !args.skipUpload,
+            sizeBytes: metadata.sizeBytes,
+            format: fmt,
+            storageKey,
+        },
+        handle: args.skipUpload
+            ? undefined
+            : {
+                fieldName,
+                storageKey,
+                provider: config.storage.provider,
+            },
+    };
+}
+export async function cleanupWrittenContent(client, handles) {
+    for (const h of handles) {
+        const w = client.contentWriters[h.provider];
+        if (w?.deleteObject) {
+            await w.deleteObject({ key: h.storageKey });
+        }
+    }
+}
+//# sourceMappingURL=write-content-object.js.map

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

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

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

@@ -0,0 +1,30 @@
+import type { MemorixDataTier } from "../mongo/tier.js";
+import type { MemorixEntityDescriptor } from "../descriptors/entity-descriptor-types.js";
+import type { MemorixWriteDescriptor } from "../descriptors/write-descriptor-types.js";
+import type { MemorixTarget } from "../mongo/target.js";
+export type ResolveMemorixWriteCollectionOptions = {
+    override?: string;
+    env?: NodeJS.ProcessEnv;
+};
+export declare function resolveEntityType(entity: MemorixEntityDescriptor): string;
+export declare function buildMemorixWriteCollectionCandidates(args: {
+    entity: MemorixEntityDescriptor;
+    writeDescriptor: MemorixWriteDescriptor;
+    override?: string;
+    env?: NodeJS.ProcessEnv;
+}): string[];
+/** Sync resolver: returns the first configured candidate (no Mongo existence check). */
+export declare function resolveMemorixWriteCollectionName(entity: MemorixEntityDescriptor, writeDescriptor: MemorixWriteDescriptor, options?: ResolveMemorixWriteCollectionOptions): string;
+export declare function resolveMemorixWriteTargetCollection(args: {
+    tier: MemorixDataTier;
+    entity: MemorixEntityDescriptor;
+    writeDescriptor: MemorixWriteDescriptor;
+    override?: string;
+    env?: NodeJS.ProcessEnv;
+    verifyExists?: boolean;
+}): Promise<{
+    collection: string;
+    target: MemorixTarget;
+    database: string;
+}>;
+//# sourceMappingURL=collection-name.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collection-name.d.ts","sourceRoot":"","sources":["../../src/data/collection-name.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AACzF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAQvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,MAAM,oCAAoC,GAAG;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM,CAEzE;AAED,wBAAgB,qCAAqC,CAAC,IAAI,EAAE;IAC1D,MAAM,EAAE,uBAAuB,CAAC;IAChC,eAAe,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,GAAG,MAAM,EAAE,CAkDX;AAED,wFAAwF;AACxF,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,uBAAuB,EAC/B,eAAe,EAAE,sBAAsB,EACvC,OAAO,GAAE,oCAAyC,GACjD,MAAM,CAQR;AAED,wBAAsB,mCAAmC,CAAC,IAAI,EAAE;IAC9D,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,uBAAuB,CAAC;IAChC,eAAe,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA8B3E"}

package/dist/data/collection-name.js

@@ -0,0 +1,86 @@
+import { throwWriterError } from "../errors/errors.js";
+import { DEFAULT_ENTITY_COLLECTION_CANDIDATES, DEFAULT_EVENT_COLLECTION_CANDIDATES, } from "../mongo/default-collections.js";
+import { resolveMemorixDbName, targetCollectionEnvKey } from "../mongo/env.js";
+import { resolveMemorixWriteTarget } from "../mongo/target.js";
+export function resolveEntityType(entity) {
+    return entity.entityType?.trim() || entity.entityName.trim();
+}
+export function buildMemorixWriteCollectionCandidates(args) {
+    const env = args.env ?? process.env;
+    const target = resolveMemorixWriteTarget(args.writeDescriptor);
+    const entityType = resolveEntityType(args.entity);
+    const contentTypeKey = args.writeDescriptor.target.contentType;
+    const contentType = args.entity.contentTypes[contentTypeKey];
+    if (!contentType) {
+        throwWriterError("UNKNOWN_CONTENT_TYPE", `unknown content type "${contentTypeKey}" for entity "${args.entity.entityName}"`);
+    }
+    const candidates = [];
+    if (args.override?.trim())
+        candidates.push(args.override.trim());
+    if (args.writeDescriptor.target.targetCollection?.trim()) {
+        candidates.push(args.writeDescriptor.target.targetCollection.trim());
+    }
+    if (contentType.collection?.trim()) {
+        candidates.push(contentType.collection.trim());
+    }
+    const envKey = targetCollectionEnvKey(target, entityType);
+    const fromEnv = env[envKey]?.trim();
+    if (fromEnv)
+        candidates.push(fromEnv);
+    if (args.writeDescriptor.target.targetCollectionCandidates?.length) {
+        candidates.push(...args.writeDescriptor.target.targetCollectionCandidates);
+    }
+    const prefix = args.entity.collectionPrefix.trim();
+    const postfix = contentType.postfix?.trim();
+    if (prefix && postfix) {
+        candidates.push(`${prefix}-${postfix}`);
+    }
+    const defaultCandidates = target === "entity"
+        ? DEFAULT_ENTITY_COLLECTION_CANDIDATES
+        : DEFAULT_EVENT_COLLECTION_CANDIDATES;
+    if (defaultCandidates[entityType]) {
+        candidates.push(...defaultCandidates[entityType]);
+    }
+    candidates.push(target === "entity" ? entityType : `${entityType}-events`);
+    return [...new Set(candidates.filter(Boolean))];
+}
+/** Sync resolver: returns the first configured candidate (no Mongo existence check). */
+export function resolveMemorixWriteCollectionName(entity, writeDescriptor, options = {}) {
+    const candidates = buildMemorixWriteCollectionCandidates({
+        entity,
+        writeDescriptor,
+        override: options.override,
+        env: options.env,
+    });
+    return candidates[0];
+}
+export async function resolveMemorixWriteTargetCollection(args) {
+    const env = args.env ?? process.env;
+    const target = resolveMemorixWriteTarget(args.writeDescriptor);
+    const database = resolveMemorixDbName(target, env);
+    const candidates = buildMemorixWriteCollectionCandidates({
+        entity: args.entity,
+        writeDescriptor: args.writeDescriptor,
+        override: args.override,
+        env,
+    });
+    if (args.verifyExists === false) {
+        return { collection: candidates[0], target, database };
+    }
+    const db = args.tier.client.db(database);
+    const existing = await listCollectionNames(db);
+    for (const name of candidates) {
+        if (existing.has(name)) {
+            return { collection: name, target, database };
+        }
+    }
+    const envKey = targetCollectionEnvKey(target, resolveEntityType(args.entity));
+    throwWriterError("UNKNOWN_COLLECTION", `No ${target} collection found for entityType=${resolveEntityType(args.entity)} ` +
+        `(database=${database}). Tried: ${candidates.join(", ")}. Set ` +
+        `write descriptor targetCollection, ${envKey}, or create one of the collections.`);
+}
+async function listCollectionNames(db) {
+    const existing = await db.listCollections().toArray();
+    return new Set(existing.map((c) => c.name));
+}
+//# sourceMappingURL=collection-name.js.map

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

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

package/dist/data/identity.d.ts

@@ -0,0 +1,13 @@
+export type ResolvedIdentity = {
+    entityId?: string;
+    eventId?: string;
+    idField: "entityId" | "eventId";
+    idValue: string;
+};
+export declare function resolveRequestIdentity(args: {
+    entityId?: string;
+    eventId?: string;
+    descriptorIdField?: "entityId" | "eventId";
+}): ResolvedIdentity;
+export declare function assertDescriptorIdField(identity: ResolvedIdentity, descriptorIdField: "entityId" | "eventId"): void;
+//# sourceMappingURL=identity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/data/identity.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CAC5C,GAAG,gBAAgB,CA8BnB;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,gBAAgB,EAC1B,iBAAiB,EAAE,UAAU,GAAG,SAAS,GACxC,IAAI,CAON"}

package/dist/data/identity.js

@@ -0,0 +1,29 @@
+import { throwWriterError } from "../errors/errors.js";
+export function resolveRequestIdentity(args) {
+    const hasEntity = Boolean(args.entityId?.trim());
+    const hasEvent = Boolean(args.eventId?.trim());
+    if (hasEntity && hasEvent) {
+        throwWriterError("INVALID_IDENTITY", "request must contain exactly one of entityId or eventId, not both");
+    }
+    if (!hasEntity && !hasEvent) {
+        throwWriterError("INVALID_IDENTITY", "request must contain exactly one of entityId or eventId");
+    }
+    if (hasEntity) {
+        return {
+            entityId: args.entityId.trim(),
+            idField: "entityId",
+            idValue: args.entityId.trim(),
+        };
+    }
+    return {
+        eventId: args.eventId.trim(),
+        idField: "eventId",
+        idValue: args.eventId.trim(),
+    };
+}
+export function assertDescriptorIdField(identity, descriptorIdField) {
+    if (identity.idField !== descriptorIdField) {
+        throwWriterError("INVALID_IDENTITY", `write descriptor requires idField "${descriptorIdField}" but request used "${identity.idField}"`);
+    }
+}
+//# sourceMappingURL=identity.js.map

package/dist/data/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/data/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AASvD,MAAM,UAAU,sBAAsB,CAAC,IAItC;IACC,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/C,IAAI,SAAS,IAAI,QAAQ,EAAE,CAAC;QAC1B,gBAAgB,CACd,kBAAkB,EAClB,mEAAmE,CACpE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,SAAS,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC5B,gBAAgB,CACd,kBAAkB,EAClB,yDAAyD,CAC1D,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACd,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAS,CAAC,IAAI,EAAE;YAC/B,OAAO,EAAE,UAAU;YACnB,OAAO,EAAE,IAAI,CAAC,QAAS,CAAC,IAAI,EAAE;SAC/B,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,OAAQ,CAAC,IAAI,EAAE;QAC7B,OAAO,EAAE,SAAS;QAClB,OAAO,EAAE,IAAI,CAAC,OAAQ,CAAC,IAAI,EAAE;KAC9B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,QAA0B,EAC1B,iBAAyC;IAEzC,IAAI,QAAQ,CAAC,OAAO,KAAK,iBAAiB,EAAE,CAAC;QAC3C,gBAAgB,CACd,kBAAkB,EAClB,sCAAsC,iBAAiB,uBAAuB,QAAQ,CAAC,OAAO,GAAG,CAClG,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/data/memorix-write-adapter.d.ts

@@ -0,0 +1,33 @@
+import type { MemorixDataTier } from "../mongo/tier.js";
+import type { MemorixTarget } from "../mongo/target.js";
+export type MemorixWriteAdapter = {
+    target: MemorixTarget;
+    database: string;
+    findOne(collection: string, filter: Record<string, unknown>): Promise<Record<string, unknown> | null>;
+    findMany(collection: string, filter: Record<string, unknown>, opts?: {
+        limit?: number;
+        sort?: Record<string, unknown>;
+    }): Promise<Record<string, unknown>[]>;
+    insert(collection: string, document: Record<string, unknown>): Promise<{
+        insertedId: unknown;
+    }>;
+    patch(collection: string, filter: Record<string, unknown>, $set: Record<string, unknown>): Promise<{
+        matchedCount: number;
+        modifiedCount: number;
+    }>;
+    replace(collection: string, filter: Record<string, unknown>, replacement: Record<string, unknown>, upsert?: boolean): Promise<{
+        matchedCount: number;
+        modifiedCount: number;
+        upsertedCount: number;
+    }>;
+    update(collection: string, filter: Record<string, unknown>, update: Record<string, unknown>): Promise<{
+        matchedCount: number;
+        modifiedCount: number;
+    }>;
+};
+export type CreateMemorixWriteAdapterOptions = {
+    target: MemorixTarget;
+    env?: NodeJS.ProcessEnv;
+};
+export declare function createMemorixWriteAdapter(tier: MemorixDataTier, options: CreateMemorixWriteAdapterOptions): MemorixWriteAdapter;
+//# sourceMappingURL=memorix-write-adapter.d.ts.map

package/dist/data/memorix-write-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memorix-write-adapter.d.ts","sourceRoot":"","sources":["../../src/data/memorix-write-adapter.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CACL,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3C,QAAQ,CACN,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GACxD,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IACtC,MAAM,CACJ,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC;QAAE,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACpC,KAAK,CACH,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,OAAO,CACL,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,MAAM,CAAC,EAAE,OAAO,GACf,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnF,MAAM,CACJ,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7D,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,MAAM,EAAE,aAAa,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,CAAC;AAgBF,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,gCAAgC,GACxC,mBAAmB,CA2CrB"}