@x12i/memorix-service 3.12.4 → 3.13.0

package/dist/patches/paths.js

@@ -0,0 +1,204 @@
+/**
+ * Record paths for patches. `.` separates keys. A key ending in `[]` steps into each array member.
+ */
+import { isDeepStrictEqual } from "node:util";
+const BLOCKED_KEYS = new Set(["__proto__", "prototype", "constructor"]);
+/** A row cannot take this op as written, for example a path through a string. */
+export class PatchRowError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "PatchRowError";
+    }
+}
+export function isPlainObject(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function has(node, key) {
+    return Object.prototype.hasOwnProperty.call(node, key);
+}
+export function parsePath(path) {
+    const parts = path.split(".");
+    return parts.map((part) => {
+        const each = part.endsWith("[]");
+        const key = each ? part.slice(0, -2) : part;
+        if (!key)
+            throw new Error(`empty key in ${JSON.stringify(path)}`);
+        if (key.includes("[") || key.includes("]"))
+            throw new Error(`bad array step in ${JSON.stringify(path)}`);
+        if (BLOCKED_KEYS.has(key))
+            throw new Error(`key ${key} is not allowed`);
+        return { key, each };
+    });
+}
+/** Every place the path names. The last key may be absent at a location. */
+export function locate(root, segments) {
+    let frontier = [root];
+    const out = [];
+    segments.forEach((segment, index) => {
+        const last = index === segments.length - 1;
+        const next = [];
+        for (const node of frontier) {
+            if (!isPlainObject(node))
+                continue;
+            if (!segment.each) {
+                if (last)
+                    out.push({ parent: node, key: segment.key });
+                else if (has(node, segment.key))
+                    next.push(node[segment.key]);
+                continue;
+            }
+            const list = has(node, segment.key) ? node[segment.key] : undefined;
+            if (!Array.isArray(list))
+                continue;
+            if (last)
+                list.forEach((_, i) => out.push({ parent: list, key: i }));
+            else
+                next.push(...list);
+        }
+        frontier = next;
+    });
+    return out;
+}
+export function isPresent(location) {
+    if (Array.isArray(location.parent))
+        return typeof location.key === "number" && location.key < location.parent.length;
+    return has(location.parent, String(location.key));
+}
+export function valueAt(location) {
+    return Array.isArray(location.parent)
+        ? location.parent[location.key]
+        : location.parent[String(location.key)];
+}
+export function writeAt(location, value) {
+    if (Array.isArray(location.parent))
+        location.parent[location.key] = value;
+    else
+        location.parent[String(location.key)] = value;
+}
+export function readValues(root, path) {
+    return locate(root, parsePath(path)).filter(isPresent).map(valueAt);
+}
+/** Value at a path without array steps, or undefined. */
+export function readPlain(root, path) {
+    let cur = root;
+    for (const segment of parsePath(path)) {
+        if (!isPlainObject(cur) || !has(cur, segment.key))
+            return undefined;
+        cur = cur[segment.key];
+    }
+    return cur;
+}
+export function hasPlain(root, path) {
+    const segments = parsePath(path);
+    let cur = root;
+    for (const segment of segments) {
+        if (!isPlainObject(cur) || !has(cur, segment.key))
+            return false;
+        cur = cur[segment.key];
+    }
+    return true;
+}
+/** Set a value, creating objects on the way. A non-object on the way fails the row. */
+export function setPlain(root, path, value) {
+    const segments = parsePath(path);
+    let cur = root;
+    for (let i = 0; i < segments.length - 1; i += 1) {
+        const key = segments[i].key;
+        if (!has(cur, key) || cur[key] === undefined || cur[key] === null)
+            cur[key] = {};
+        const child = cur[key];
+        if (!isPlainObject(child)) {
+            throw new PatchRowError(`${segments.slice(0, i + 1).map((s) => s.key).join(".")} is not an object`);
+        }
+        cur = child;
+    }
+    cur[segments.at(-1).key] = value;
+}
+export function deletePlain(root, path) {
+    const segments = parsePath(path);
+    let cur = root;
+    for (let i = 0; i < segments.length - 1; i += 1) {
+        if (!isPlainObject(cur) || !has(cur, segments[i].key))
+            return false;
+        cur = cur[segments[i].key];
+    }
+    const key = segments.at(-1).key;
+    if (!isPlainObject(cur) || !has(cur, key))
+        return false;
+    delete cur[key];
+    return true;
+}
+/** Values of `key` at any depth under `value`, including inside arrays. */
+export function valuesForKey(value, key, out = []) {
+    if (Array.isArray(value)) {
+        for (const item of value)
+            valuesForKey(item, key, out);
+        return out;
+    }
+    if (!isPlainObject(value))
+        return out;
+    for (const [childKey, child] of Object.entries(value)) {
+        if (childKey === key)
+            out.push(child);
+        valuesForKey(child, key, out);
+    }
+    return out;
+}
+/** Remove `key` at every depth under `value`. With `when`, only where its value passes. */
+export function deleteKeyEverywhere(value, key, when) {
+    let changed = false;
+    if (Array.isArray(value)) {
+        for (const item of value)
+            changed = deleteKeyEverywhere(item, key, when) || changed;
+        return changed;
+    }
+    if (!isPlainObject(value))
+        return false;
+    if (has(value, key) && (!when || testValues([value[key]], when))) {
+        delete value[key];
+        changed = true;
+    }
+    for (const child of Object.values(value))
+        changed = deleteKeyEverywhere(child, key, when) || changed;
+    return changed;
+}
+const regexCache = new Map();
+function regex(pattern) {
+    let compiled = regexCache.get(pattern);
+    if (!compiled) {
+        compiled = new RegExp(pattern);
+        if (regexCache.size > 500)
+            regexCache.clear();
+        regexCache.set(pattern, compiled);
+    }
+    return compiled;
+}
+export function matchesPattern(value, pattern) {
+    return typeof value === "string" && regex(pattern).test(value);
+}
+/** `values` are what the path or key found. Absent locations are not in the list. */
+export function testValues(values, test) {
+    if (test.exists)
+        return values.length > 0;
+    if (test.missing)
+        return values.length === 0;
+    if (Object.prototype.hasOwnProperty.call(test, "equals")) {
+        return values.some((value) => isDeepStrictEqual(value, test.equals));
+    }
+    if (test.in) {
+        const candidates = test.in;
+        return values.some((value) => candidates.some((candidate) => isDeepStrictEqual(value, candidate)));
+    }
+    if (test.matches !== undefined) {
+        const pattern = test.matches;
+        return values.some((value) => matchesPattern(value, pattern));
+    }
+    return values.length > 0;
+}
+export function evaluatePredicate(record, predicate) {
+    const values = "key" in predicate
+        ? valuesForKey(record.data, predicate.key)
+        : readValues(record, predicate.path);
+    return testValues(values, predicate);
+}
+//# sourceMappingURL=paths.js.map

package/dist/patches/paths.js.map

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

package/dist/patches/service.d.ts

@@ -0,0 +1,16 @@
+/**
+ * MX-PATCH-01 — platform wiring for the patch engine: deps per request, guard checks on content writes,
+ * and the ticker that resumes apply and revert work after a restart.
+ */
+import type { MemorixPlatform } from "../platform.js";
+import type { MemorixScope } from "../scope.js";
+import type { StoredContentWrite } from "../writes/receipt-store.js";
+import { type PatchEngineDeps } from "./engine.js";
+export declare function patchEngineDeps(platform: MemorixPlatform, scope: MemorixScope, caller: string): PatchEngineDeps;
+/** `checkWrite` for content writes: 400 `PATCH_GUARD` when the write matches an installed guard. */
+export declare function patchGuardCheck(platform: MemorixPlatform, scope: MemorixScope): (request: StoredContentWrite) => Promise<void>;
+/** Resume apply or revert work whose lease ran out (another instance died, or this one restarted). */
+export declare function startPatchTicker(platform: MemorixPlatform, opts?: {
+    intervalMs?: number;
+}): () => void;
+//# sourceMappingURL=service.d.ts.map

package/dist/patches/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/patches/service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAIpE,wBAAgB,eAAe,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CA0C/G;AAED,oGAAoG;AACpG,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,YAAY,GAClB,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAoBhD;AAED,sGAAsG;AACtG,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,IAAI,CA0CtG"}

package/dist/patches/service.js

@@ -0,0 +1,128 @@
+import { ServiceError } from "../errors.js";
+import { declaredDiscriminatorValues } from "../catalog-bridge.js";
+import { maybeEnqueueNexumAnalysis } from "../nexum-analysis/enqueue.js";
+import { isOperationalDbName, orgIdFromOperationalDbName } from "../operational-db.js";
+import { resumePatchWork } from "./engine.js";
+import { assertPatchGuards } from "./guards.js";
+import { PATCHES_COLLECTION } from "./store.js";
+export function patchEngineDeps(platform, scope, caller) {
+    const client = platform.getMongoClient();
+    if (!client) {
+        throw new ServiceError("PATCH_UNAVAILABLE", "patches need the MongoDB data plane", 503, { retryable: false });
+    }
+    const resolved = { ...scope, orgId: platform.resolveOrgId(scope.orgId) };
+    const ports = platform.portsFor(resolved);
+    return {
+        client,
+        operationalDb: platform.operationalDbFor(resolved.orgId),
+        scope: { orgId: resolved.orgId, agentIds: [...resolved.agentIds] },
+        catalog: ports.catalog,
+        caller,
+        reconcileDirectory: async (recordId) => {
+            await ports.writer.reconcileDirectory(resolved, recordId);
+        },
+        onRowWritten: async (event) => {
+            try {
+                platform.analytics?.onWrite(resolved, {
+                    objectType: event.objectType,
+                    contentType: event.contentType,
+                    recordId: event.recordId,
+                    op: event.op,
+                    datasourceService: caller,
+                });
+            }
+            catch {
+                /* tracking never fails a patch */
+            }
+            if (event.op === "removed" || event.revision === undefined)
+                return;
+            await maybeEnqueueNexumAnalysis({
+                platform,
+                scope: resolved,
+                objectType: event.objectType,
+                contentType: event.contentType,
+                recordId: event.recordId,
+                revision: event.revision,
+                data: event.data,
+            }).catch(() => undefined);
+        },
+        declaredDiscriminatorValues: (objectType, contentType, path) => declaredDiscriminatorValues(platform.metadata, resolved.agentIds, objectType, contentType, path),
+    };
+}
+/** `checkWrite` for content writes: 400 `PATCH_GUARD` when the write matches an installed guard. */
+export function patchGuardCheck(platform, scope) {
+    return async (request) => {
+        if (!platform.getMongoClient())
+            return;
+        const orgId = platform.resolveOrgId(scope.orgId);
+        const recordId = typeof request.record?.recordId === "string" ? request.record.recordId : undefined;
+        await assertPatchGuards({
+            db: platform.operationalDbFor(orgId),
+            orgId,
+            write: request,
+            readCurrent: recordId
+                ? async () => (await platform.portsFor(scope).reader.getContent(scope, {
+                    objectType: request.objectType,
+                    contentType: request.contentType,
+                    recordId,
+                    ...(request.discriminatorValue ? { discriminatorValue: request.discriminatorValue } : {}),
+                }))
+                : undefined,
+        });
+    };
+}
+/** Resume apply or revert work whose lease ran out (another instance died, or this one restarted). */
+export function startPatchTicker(platform, opts) {
+    const intervalMs = opts?.intervalMs ?? 5_000;
+    let busy = false;
+    const tickOnce = async () => {
+        if (busy)
+            return;
+        busy = true;
+        try {
+            const client = platform.getMongoClient();
+            if (!client)
+                return;
+            const dbs = await client.db().admin().listDatabases({ nameOnly: true });
+            for (const d of dbs.databases ?? []) {
+                const name = d.name ?? "";
+                if (!isOperationalDbName(name))
+                    continue;
+                const orgId = orgIdFromOperationalDbName(name);
+                if (!orgId)
+                    continue;
+                try {
+                    const db = platform.operationalDbFor(orgId);
+                    const busyPatches = await db
+                        .collection(PATCHES_COLLECTION)
+                        .countDocuments({ state: { $in: ["applying", "reverting"] } }, { limit: 1 });
+                    if (!busyPatches)
+                        continue;
+                    await resumePatchWork(db, (patch) => {
+                        try {
+                            return patchEngineDeps(platform, { orgId: patch.orgId, agentIds: patch.agentIds }, patch.caller);
+                        }
+                        catch {
+                            return null;
+                        }
+                    });
+                }
+                catch {
+                    // One org must not stop the others.
+                }
+            }
+        }
+        catch {
+            // Ticker must not crash the service.
+        }
+        finally {
+            busy = false;
+        }
+    };
+    void tickOnce();
+    const handle = setInterval(() => void tickOnce(), intervalMs);
+    if (typeof handle.unref === "function")
+        handle.unref();
+    return () => clearInterval(handle);
+}
+//# sourceMappingURL=service.js.map

package/dist/patches/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/patches/service.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAEvF,OAAO,EAAE,eAAe,EAAwB,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,UAAU,eAAe,CAAC,QAAyB,EAAE,KAAmB,EAAE,MAAc;IAC5F,MAAM,MAAM,GAAG,QAAQ,CAAC,cAAc,EAAE,CAAC;IACzC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,YAAY,CAAC,mBAAmB,EAAE,qCAAqC,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IAChH,CAAC;IACD,MAAM,QAAQ,GAAiB,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;IACvF,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC1C,OAAO;QACL,MAAM;QACN,aAAa,EAAE,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC;QACxD,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAClE,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM;QACN,kBAAkB,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;YACrC,MAAM,KAAK,CAAC,MAAM,CAAC,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC5D,CAAC;QACD,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YAC5B,IAAI,CAAC;gBACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,EAAE;oBACpC,UAAU,EAAE,KAAK,CAAC,UAAU;oBAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;oBAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,EAAE,EAAE,KAAK,CAAC,EAAE;oBACZ,iBAAiB,EAAE,MAAM;iBAC1B,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,kCAAkC;YACpC,CAAC;YACD,IAAI,KAAK,CAAC,EAAE,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;gBAAE,OAAO;YACnE,MAAM,yBAAyB,CAAC;gBAC9B,QAAQ;gBACR,KAAK,EAAE,QAAQ;gBACf,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,IAAI,EAAE,KAAK,CAAC,IAAI;aACjB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC5B,CAAC;QACD,2BAA2B,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,CAC7D,2BAA2B,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,IAAI,CAAC;KACnG,CAAC;AACJ,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,eAAe,CAC7B,QAAyB,EACzB,KAAmB;IAEnB,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE;QACvB,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE;YAAE,OAAO;QACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,OAAO,OAAO,CAAC,MAAM,EAAE,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QACpG,MAAM,iBAAiB,CAAC;YACtB,EAAE,EAAE,QAAQ,CAAC,gBAAgB,CAAC,KAAK,CAAC;YACpC,KAAK;YACL,KAAK,EAAE,OAAO;YACd,WAAW,EAAE,QAAQ;gBACnB,CAAC,CAAC,KAAK,IAAI,EAAE,CACT,CAAC,MAAM,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE;oBACvD,UAAU,EAAE,OAAO,CAAC,UAAU;oBAC9B,WAAW,EAAE,OAAO,CAAC,WAAW;oBAChC,QAAQ;oBACR,GAAG,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC1F,CAAC,CAAuC;gBAC7C,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,gBAAgB,CAAC,QAAyB,EAAE,IAA8B;IACxF,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,KAAK,CAAC;IAC7C,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,IAAI,IAAI;YAAE,OAAO;QACjB,IAAI,GAAG,IAAI,CAAC;QACZ,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,QAAQ,CAAC,cAAc,EAAE,CAAC;YACzC,IAAI,CAAC,MAAM;gBAAE,OAAO;YACpB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YACxE,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;gBACpC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;gBAC1B,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC;oBAAE,SAAS;gBACzC,MAAM,KAAK,GAAG,0BAA0B,CAAC,IAAI,CAAC,CAAC;gBAC/C,IAAI,CAAC,KAAK;oBAAE,SAAS;gBACrB,IAAI,CAAC;oBACH,MAAM,EAAE,GAAG,QAAQ,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;oBAC5C,MAAM,WAAW,GAAG,MAAM,EAAE;yBACzB,UAAU,CAAC,kBAAkB,CAAC;yBAC9B,cAAc,CAAC,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;oBAC/E,IAAI,CAAC,WAAW;wBAAE,SAAS;oBAC3B,MAAM,eAAe,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE;wBAClC,IAAI,CAAC;4BACH,OAAO,eAAe,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;wBACnG,CAAC;wBAAC,MAAM,CAAC;4BACP,OAAO,IAAI,CAAC;wBACd,CAAC;oBACH,CAAC,CAAC,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACP,oCAAoC;gBACtC,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,qCAAqC;QACvC,CAAC;gBAAS,CAAC;YACT,IAAI,GAAG,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IACF,KAAK,QAAQ,EAAE,CAAC;IAChB,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,EAAE,UAAU,CAAC,CAAC;IAC9D,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,UAAU;QAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IACvD,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC"}

package/dist/patches/store.d.ts

@@ -0,0 +1,87 @@
+import type { Collection, Db } from "mongodb";
+import type { PatchCounts, PatchGuard, PatchRequest, PatchSample, PatchState, RevertCounts, RevertOutcome, RowOutcome } from "./types.js";
+export declare const PATCHES_COLLECTION = "memorix_patches";
+export declare const PATCH_ROWS_COLLECTION = "memorix_patch_rows";
+export type PlannedOutcome = "change" | "unchanged" | "conflict" | "fail";
+/** A stored content document: `_id` is the storage key. */
+export type StoredDoc = {
+    _id: string;
+    [key: string]: unknown;
+};
+export type PatchDoc = {
+    _id: string;
+    patchId: string;
+    orgId: string;
+    agentIds: string[];
+    caller: string;
+    objectType: string;
+    contentTypes: string[];
+    request: PatchRequest;
+    state: PatchState;
+    planChecksum: string;
+    plan: {
+        matched: number;
+        wouldChange: number;
+        unchanged: number;
+        conflicts: number;
+        failed: number;
+        limitHit: boolean;
+        warnings: string[];
+        samples: PatchSample[];
+    };
+    counts: PatchCounts;
+    revertCounts?: RevertCounts;
+    guards: PatchGuard[];
+    guardsActive: boolean;
+    createdAt: string;
+    planExpiresAt: string;
+    startedAt?: string;
+    finishedAt?: string;
+    revertRetainUntil?: string;
+    revertStartedAt?: string;
+    revertedAt?: string;
+    appliedBy?: string;
+    revertedBy?: string;
+    error?: string;
+    lease?: {
+        owner: string;
+        until: string;
+    };
+    /** TTL: set while the plan waits for apply. */
+    expireAt?: Date;
+};
+export type PatchRowDoc = {
+    _id: string;
+    patchId: string;
+    seq: number;
+    objectType: string;
+    contentType: string;
+    recordId: string;
+    storageKey: string;
+    plannedRevision: number;
+    planned: PlannedOutcome;
+    plannedError?: string;
+    outcome?: RowOutcome;
+    error?: string;
+    /** The stored document before the patch wrote it. Kept for revert. */
+    before?: StoredDoc;
+    /** The instance a `setDiscriminator` with `onExisting: "replace"` overwrote. */
+    beforeTarget?: StoredDoc;
+    after?: {
+        storageKey: string;
+        revision: number;
+    } | {
+        deleted: true;
+        keptStorageKey?: string;
+        mode: "purge" | "legacy";
+    };
+    revert?: RevertOutcome;
+    revertError?: string;
+    expireAt: Date;
+};
+export type PatchCollections = {
+    patches: Collection<PatchDoc>;
+    rows: Collection<PatchRowDoc>;
+};
+export declare function patchCollections(db: Db): Promise<PatchCollections>;
+//# sourceMappingURL=store.d.ts.map

package/dist/patches/store.d.ts.map

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

package/dist/patches/store.js

@@ -0,0 +1,27 @@
+export const PATCHES_COLLECTION = "memorix_patches";
+export const PATCH_ROWS_COLLECTION = "memorix_patch_rows";
+const indexed = new Set();
+export async function patchCollections(db) {
+    const patches = db.collection(PATCHES_COLLECTION);
+    const rows = db.collection(PATCH_ROWS_COLLECTION);
+    if (!indexed.has(db.databaseName)) {
+        indexed.add(db.databaseName);
+        try {
+            await Promise.all([
+                patches.createIndex({ expireAt: 1 }, { name: "plan_ttl", expireAfterSeconds: 0 }),
+                patches.createIndex({ objectType: 1, createdAt: -1 }, { name: "object_type_created" }),
+                patches.createIndex({ state: 1 }, { name: "state" }),
+                patches.createIndex({ guardsActive: 1 }, { name: "guards_active" }),
+                rows.createIndex({ patchId: 1, seq: 1 }, { name: "patch_seq", unique: true }),
+                rows.createIndex({ patchId: 1, outcome: 1, seq: 1 }, { name: "patch_outcome_seq" }),
+                rows.createIndex({ expireAt: 1 }, { name: "row_ttl", expireAfterSeconds: 0 }),
+            ]);
+        }
+        catch (err) {
+            indexed.delete(db.databaseName);
+            throw err;
+        }
+    }
+    return { patches, rows };
+}
+//# sourceMappingURL=store.js.map

package/dist/patches/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/patches/store.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AACpD,MAAM,CAAC,MAAM,qBAAqB,GAAG,oBAAoB,CAAC;AA2E1D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;AAElC,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,EAAM;IAC3C,MAAM,OAAO,GAAG,EAAE,CAAC,UAAU,CAAW,kBAAkB,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,EAAE,CAAC,UAAU,CAAc,qBAAqB,CAAC,CAAC;IAC/D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,GAAG,CAAC;gBAChB,OAAO,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,kBAAkB,EAAE,CAAC,EAAE,CAAC;gBACjF,OAAO,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC;gBACtF,OAAO,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBACpD,OAAO,CAAC,WAAW,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;gBACnE,IAAI,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;gBAC7E,IAAI,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC;gBACnF,IAAI,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,EAAE,CAAC;aAC9E,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC;YAChC,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC"}

package/dist/patches/types.d.ts

@@ -0,0 +1,112 @@
+/**
+ * MX-PATCH-01 — a patch request repairs stored rows: `select`, ordered `ops`, optional `guards`.
+ */
+export type ValueTest = {
+    exists?: true;
+    missing?: true;
+    equals?: unknown;
+    in?: unknown[];
+    matches?: string;
+};
+/** A predicate on a record path, or on a key at any depth under `data`. */
+export type Predicate = ({
+    path: string;
+} & ValueTest) | ({
+    key: string;
+    anyDepth: true;
+} & ValueTest);
+export type PatchSelect = {
+    objectType: string;
+    contentTypes: string[];
+    recordIds?: string[];
+    idPrefix?: string;
+    discriminator?: {
+        value: string;
+    } | {
+        absent: true;
+    };
+    where?: Predicate[];
+    state: "active" | "tombstoned" | "any";
+    limit?: number;
+};
+export type PatchOp = {
+    op: "set";
+    path: string;
+    value: unknown;
+    onlyIfAbsent?: boolean;
+} | {
+    op: "delete";
+    path: string;
+    when?: ValueTest;
+} | {
+    op: "delete";
+    key: string;
+    anyDepth: true;
+    when?: ValueTest;
+} | {
+    op: "move";
+    from: string;
+    to: string;
+    overwrite?: boolean;
+} | {
+    op: "copy";
+    from: string;
+    to: string;
+    overwrite?: boolean;
+} | {
+    op: "rename";
+    path: string;
+    to: string;
+} | {
+    op: "mapValues";
+    path: string;
+    map: Record<string, unknown>;
+} | {
+    op: "dropValues";
+    path: string;
+    values?: string[];
+    matches?: string;
+} | {
+    op: "prune";
+    path?: string;
+} | {
+    op: "setDiscriminator";
+    value: string;
+    onExisting?: "skip" | "replace" | "deleteLegacy";
+} | {
+    op: "deleteRecord";
+    mode?: "tombstone" | "purge";
+};
+export type PatchGuard = {
+    rejectWhen: Predicate;
+    message: string;
+};
+export type PatchRequest = {
+    reason?: string;
+    select: PatchSelect;
+    ops: PatchOp[];
+    guards: PatchGuard[];
+};
+export type PatchState = "planned" | "applying" | "applied" | "failed" | "reverting" | "reverted";
+export type RowOutcome = "changed" | "unchanged" | "drifted" | "conflict" | "failed";
+export type RevertOutcome = "reverted" | "drifted" | "failed" | "skipped";
+export type PatchCounts = {
+    changed: number;
+    unchanged: number;
+    drifted: number;
+    conflicts: number;
+    failed: number;
+};
+export type RevertCounts = {
+    reverted: number;
+    drifted: number;
+    failed: number;
+};
+export type PatchSample = {
+    recordId: string;
+    contentType: string;
+    revision: number;
+    before: Record<string, unknown>;
+    after: Record<string, unknown>;
+};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/patches/types.js

@@ -0,0 +1,5 @@
+/**
+ * MX-PATCH-01 — a patch request repairs stored rows: `select`, ordered `ops`, optional `guards`.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/patches/types.js.map

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

package/dist/platform.d.ts

@@ -15,6 +15,7 @@ import { ServiceError } from "./errors.js";
 import { type DeliveryArtifactStore, type RawRecordStore, type TargetItemReceiptStore } from "./mgc-landing-stores.js";
 import { type ServiceCatalog } from "./catalog-bridge.js";
 import { type MemorixScope } from "./scope.js";
+import { type WriteReceiptStore } from "./writes/receipt-store.js";
 import type { HookStore } from "./hooks/types.js";
 import { type IsolationSession } from "./isolation.js";
 import { type MagitPackService } from "./magit/magit-pack-service.js";
@@ -188,6 +189,13 @@ export type MemorixPlatform = {
     }): () => void;
     /** Content-hook subscriptions and deliveries for one org. */
     hooksFor(orgId: string): HookStore;
+    /** Accepted content writes for one org. */
+    writeReceiptsFor(orgId: string): WriteReceiptStore;
+    /** Retry content writes that were accepted and not finished. */
+    startWriteReceiptTicker(opts?: {
+        intervalMs?: number;
+    }): () => void;
+    tickWriteReceipts(): Promise<void>;
     /** Deliver pending content hooks. Works with memory stores when Mongo is absent. */
     startContentHookTicker(opts?: {
         intervalMs?: number;