@open-mercato/core 0.6.5-develop.4674.1.bf258550ce → 0.6.5-develop.4691.1.bb409545b3

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
-[build:core] found 3185 entry points
+[build:core] found 3206 entry points
 [build:core] built successfully
 [build:core:generated] found 185 entry points
 [build:core:generated] built successfully

package/AGENTS.md

@@ -552,6 +552,37 @@ await withAtomicFlush(em, [
 await emitCrudSideEffects({ ... })
 ```
 
+### Preferred: `runCrudCommandWrite` for entity + custom fields + side effects
+
+For commands that write an entity, optionally write custom fields, and emit CRUD/index side effects in one logical operation, prefer `runCrudCommandWrite` over composing `withAtomicFlush` + `setCustomFieldsIfAny` + `emitCrudSideEffects` by hand. The helper owns the EM fork, the atomic flush boundary, the custom-field write, and the side-effect queue in the only correct order, and fails closed if any earlier step throws.
+
+```typescript
+import { runCrudCommandWrite } from '@open-mercato/shared/lib/commands/runCrudCommandWrite'
+
+await runCrudCommandWrite({
+  ctx,
+  entityId: 'my_module:my_entity',
+  action: 'updated',
+  scope: { tenantId: record.tenantId, organizationId: record.organizationId },
+  customFields: custom,
+  events: myCrudEvents,
+  indexer: myCrudIndexer,
+  sideEffect: () => ({
+    entity: record,
+    identifiers: { id: record.id, tenantId: record.tenantId, organizationId: record.organizationId },
+  }),
+  phases: [
+    () => {
+      record.name = parsed.name
+      record.status = parsed.status
+    },
+    () => syncEntityTags(em, record, parsed.tags),
+  ],
+})
+```
+
+Reference migration: `customers.deals.update` in `packages/core/src/modules/customers/commands/deals.ts`. Keep `withAtomicFlush` for cases the helper doesn't fit (multiple separate transactions per command, etc.).
+
 ## Profiling
 
 - Enable with `OM_PROFILE` env (comma-separated filters: `*`, `all`, `customers.*`, etc.)

package/dist/helpers/integration/standaloneEnv.js

@@ -0,0 +1,58 @@
+import fs from "fs";
+import path from "path";
+const truthyValues = /* @__PURE__ */ new Set(["1", "true", "yes", "on"]);
+const falsyValues = /* @__PURE__ */ new Set(["0", "false", "no", "off"]);
+let cachedStandaloneEnv = null;
+function parseDotEnv(contents) {
+  const values = {};
+  for (const line of contents.split(/\r?\n/)) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const index = trimmed.indexOf("=");
+    if (index <= 0) continue;
+    const key = trimmed.slice(0, index).trim();
+    let value = trimmed.slice(index + 1).trim();
+    if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+      value = value.slice(1, -1);
+    }
+    values[key] = value;
+  }
+  return values;
+}
+function readStandaloneEnv() {
+  if (cachedStandaloneEnv) return cachedStandaloneEnv;
+  const appRoot = process.env.OM_TEST_APP_ROOT?.trim();
+  if (!appRoot) {
+    cachedStandaloneEnv = {};
+    return cachedStandaloneEnv;
+  }
+  const envPath = path.join(appRoot, ".env");
+  try {
+    cachedStandaloneEnv = parseDotEnv(fs.readFileSync(envPath, "utf8"));
+  } catch {
+    cachedStandaloneEnv = {};
+  }
+  return cachedStandaloneEnv;
+}
+function readIntegrationEnv(name) {
+  const fromProcess = process.env[name];
+  if (typeof fromProcess === "string") return fromProcess;
+  return readStandaloneEnv()[name];
+}
+function isStandaloneIntegration() {
+  return Boolean(process.env.OM_TEST_APP_ROOT?.trim());
+}
+function readIntegrationEnvFlag(name, defaultValue = false) {
+  const raw = readIntegrationEnv(name)?.trim().toLowerCase();
+  if (!raw) return defaultValue;
+  if (truthyValues.has(raw)) return true;
+  if (falsyValues.has(raw)) return false;
+  return defaultValue;
+}
+export {
+  isStandaloneIntegration,
+  readIntegrationEnv,
+  readIntegrationEnvFlag,
+  readStandaloneEnv
+};
+//# sourceMappingURL=standaloneEnv.js.map

package/dist/helpers/integration/standaloneEnv.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/helpers/integration/standaloneEnv.ts"],
+  "sourcesContent": ["import fs from 'fs';\nimport path from 'path';\n\nconst truthyValues = new Set(['1', 'true', 'yes', 'on']);\nconst falsyValues = new Set(['0', 'false', 'no', 'off']);\n\nlet cachedStandaloneEnv: Record<string, string> | null = null;\n\nfunction parseDotEnv(contents: string): Record<string, string> {\n  const values: Record<string, string> = {};\n  for (const line of contents.split(/\\r?\\n/)) {\n    const trimmed = line.trim();\n    if (!trimmed || trimmed.startsWith('#')) continue;\n    const index = trimmed.indexOf('=');\n    if (index <= 0) continue;\n    const key = trimmed.slice(0, index).trim();\n    let value = trimmed.slice(index + 1).trim();\n    if (\n      (value.startsWith('\"') && value.endsWith('\"')) ||\n      (value.startsWith(\"'\") && value.endsWith(\"'\"))\n    ) {\n      value = value.slice(1, -1);\n    }\n    values[key] = value;\n  }\n  return values;\n}\n\nexport function readStandaloneEnv(): Record<string, string> {\n  if (cachedStandaloneEnv) return cachedStandaloneEnv;\n  const appRoot = process.env.OM_TEST_APP_ROOT?.trim();\n  if (!appRoot) {\n    cachedStandaloneEnv = {};\n    return cachedStandaloneEnv;\n  }\n\n  const envPath = path.join(appRoot, '.env');\n  try {\n    cachedStandaloneEnv = parseDotEnv(fs.readFileSync(envPath, 'utf8'));\n  } catch {\n    cachedStandaloneEnv = {};\n  }\n  return cachedStandaloneEnv;\n}\n\nexport function readIntegrationEnv(name: string): string | undefined {\n  const fromProcess = process.env[name];\n  if (typeof fromProcess === 'string') return fromProcess;\n  return readStandaloneEnv()[name];\n}\n\nexport function isStandaloneIntegration(): boolean {\n  return Boolean(process.env.OM_TEST_APP_ROOT?.trim());\n}\n\nexport function readIntegrationEnvFlag(name: string, defaultValue = false): boolean {\n  const raw = readIntegrationEnv(name)?.trim().toLowerCase();\n  if (!raw) return defaultValue;\n  if (truthyValues.has(raw)) return true;\n  if (falsyValues.has(raw)) return false;\n  return defaultValue;\n}\n"],
+  "mappings": "AAAA,OAAO,QAAQ;AACf,OAAO,UAAU;AAEjB,MAAM,eAAe,oBAAI,IAAI,CAAC,KAAK,QAAQ,OAAO,IAAI,CAAC;AACvD,MAAM,cAAc,oBAAI,IAAI,CAAC,KAAK,SAAS,MAAM,KAAK,CAAC;AAEvD,IAAI,sBAAqD;AAEzD,SAAS,YAAY,UAA0C;AAC7D,QAAM,SAAiC,CAAC;AACxC,aAAW,QAAQ,SAAS,MAAM,OAAO,GAAG;AAC1C,UAAM,UAAU,KAAK,KAAK;AAC1B,QAAI,CAAC,WAAW,QAAQ,WAAW,GAAG,EAAG;AACzC,UAAM,QAAQ,QAAQ,QAAQ,GAAG;AACjC,QAAI,SAAS,EAAG;AAChB,UAAM,MAAM,QAAQ,MAAM,GAAG,KAAK,EAAE,KAAK;AACzC,QAAI,QAAQ,QAAQ,MAAM,QAAQ,CAAC,EAAE,KAAK;AAC1C,QACG,MAAM,WAAW,GAAG,KAAK,MAAM,SAAS,GAAG,KAC3C,MAAM,WAAW,GAAG,KAAK,MAAM,SAAS,GAAG,GAC5C;AACA,cAAQ,MAAM,MAAM,GAAG,EAAE;AAAA,IAC3B;AACA,WAAO,GAAG,IAAI;AAAA,EAChB;AACA,SAAO;AACT;AAEO,SAAS,oBAA4C;AAC1D,MAAI,oBAAqB,QAAO;AAChC,QAAM,UAAU,QAAQ,IAAI,kBAAkB,KAAK;AACnD,MAAI,CAAC,SAAS;AACZ,0BAAsB,CAAC;AACvB,WAAO;AAAA,EACT;AAEA,QAAM,UAAU,KAAK,KAAK,SAAS,MAAM;AACzC,MAAI;AACF,0BAAsB,YAAY,GAAG,aAAa,SAAS,MAAM,CAAC;AAAA,EACpE,QAAQ;AACN,0BAAsB,CAAC;AAAA,EACzB;AACA,SAAO;AACT;AAEO,SAAS,mBAAmB,MAAkC;AACnE,QAAM,cAAc,QAAQ,IAAI,IAAI;AACpC,MAAI,OAAO,gBAAgB,SAAU,QAAO;AAC5C,SAAO,kBAAkB,EAAE,IAAI;AACjC;AAEO,SAAS,0BAAmC;AACjD,SAAO,QAAQ,QAAQ,IAAI,kBAAkB,KAAK,CAAC;AACrD;AAEO,SAAS,uBAAuB,MAAc,eAAe,OAAgB;AAClF,QAAM,MAAM,mBAAmB,IAAI,GAAG,KAAK,EAAE,YAAY;AACzD,MAAI,CAAC,IAAK,QAAO;AACjB,MAAI,aAAa,IAAI,GAAG,EAAG,QAAO;AAClC,MAAI,YAAY,IAAI,GAAG,EAAG,QAAO;AACjC,SAAO;AACT;",
+  "names": []
+}

package/dist/helpers/integration/undoHarness.js

@@ -1,9 +1,18 @@
-import { expect } from "@playwright/test";
+import { expect, test } from "@playwright/test";
+import { parseBooleanWithDefault } from "@open-mercato/shared/lib/boolean";
 import { apiRequest } from "./api.js";
+import { expectId, readJsonSafe } from "./generalFixtures.js";
 const HEADER_PREFIX = "omop:";
 const UNDO_PATH = "/api/audit_logs/audit-logs/actions/undo";
 const REDO_PATH = "/api/audit_logs/audit-logs/actions/redo";
 const ACTIONS_PATH = "/api/audit_logs/audit-logs/actions";
+const UNDO_TESTS_DISABLED_ENV = "OM_INTEGRATION_UNDO_TESTS_DISABLED";
+function undoTestsDisabled(env = process.env) {
+  return parseBooleanWithDefault(env[UNDO_TESTS_DISABLED_ENV], false);
+}
+function skipIfUndoTestsDisabled() {
+  test.skip(undoTestsDisabled(), `${UNDO_TESTS_DISABLED_ENV} is set \u2014 undo/redo integration tests skipped`);
+}
 function extractOperation(response) {
   const header = response.headers()["x-om-operation"];
   if (!header || typeof header !== "string") return null;
@@ -67,7 +76,90 @@ function assertFieldsEqual(actual, expected, fields, context) {
     ).toBe(JSON.stringify(expected[field]));
   }
 }
+function findRecord(body, id) {
+  if (!body || typeof body !== "object") return null;
+  if (!Array.isArray(body) && body.id === id) {
+    return body;
+  }
+  for (const value of Array.isArray(body) ? body : Object.values(body)) {
+    const found = findRecord(value, id);
+    if (found) return found;
+  }
+  return null;
+}
+async function readRecord(request, token, entity, id) {
+  const path = entity.readPath?.(id) ?? `${entity.collectionPath}?id=${encodeURIComponent(id)}`;
+  const response = await apiRequest(request, "GET", path, { token });
+  const body = await readJsonSafe(response);
+  if (!response.ok()) return null;
+  return findRecord(body, id);
+}
+function fieldValue(record, field) {
+  return record?.[field];
+}
+async function deleteEntity(request, token, entity, id) {
+  const path = entity.deletePath?.(id) ?? `${entity.collectionPath}?id=${encodeURIComponent(id)}`;
+  return apiRequest(request, "DELETE", path, { token });
+}
+async function runCrudUndoRoundTrip(request, token, entity) {
+  const stamp = `${Date.now()}${Math.floor(Math.random() * 1e3)}`;
+  let createUndoId = null;
+  let cycleId = null;
+  try {
+    const createUndoRes = await apiRequest(request, "POST", entity.collectionPath, {
+      token,
+      data: entity.createPayload(`${stamp}a`)
+    });
+    expect(createUndoRes.status(), `${entity.label} create-for-undo status`).toBe(entity.createStatus ?? 201);
+    const createUndoOp = expectOperation(createUndoRes, `${entity.label}.create`);
+    createUndoId = createUndoOp.resourceId || expectId((await readJsonSafe(createUndoRes))?.id, `${entity.label} create id`);
+    expect(fieldValue(await readRecord(request, token, entity, createUndoId), entity.field), `${entity.label} field readable after create`).toBeDefined();
+    await undoOk(request, token, createUndoOp.undoToken, `${entity.label} undo create`);
+    expect(await readRecord(request, token, entity, createUndoId), `${entity.label} create\u2192undo soft-deletes/removes the record (I3)`).toBeNull();
+    await expectTokenConsumed(request, token, createUndoOp.undoToken, `${entity.label} create token consumed (I5)`);
+    const createRes = await apiRequest(request, "POST", entity.collectionPath, {
+      token,
+      data: entity.createPayload(`${stamp}b`)
+    });
+    expect(createRes.status(), `${entity.label} create status`).toBe(entity.createStatus ?? 201);
+    const createOp = expectOperation(createRes, `${entity.label}.create`);
+    cycleId = createOp.resourceId || expectId((await readJsonSafe(createRes))?.id, `${entity.label} cycle id`);
+    const beforeUpdate = await readRecord(request, token, entity, cycleId);
+    const beforeValue = fieldValue(beforeUpdate, entity.field);
+    expect(beforeValue, `${entity.label} field readable before update`).toBeDefined();
+    const updateRes = await apiRequest(request, "PUT", entity.collectionPath, {
+      token,
+      data: entity.updatePayload(cycleId, stamp)
+    });
+    expect(updateRes.status(), `${entity.label} update status`).toBe(entity.updateStatus ?? 200);
+    const updateOp = expectOperation(updateRes, `${entity.label}.update`);
+    const afterUpdate = await readRecord(request, token, entity, cycleId);
+    const afterUpdateValue = fieldValue(afterUpdate, entity.field);
+    expect(JSON.stringify(afterUpdateValue), `${entity.label} field changed by update`).not.toBe(JSON.stringify(beforeValue));
+    await new Promise((resolve) => setTimeout(resolve, 10));
+    await undoOk(request, token, updateOp.undoToken, `${entity.label} undo update`);
+    const afterUndo = await readRecord(request, token, entity, cycleId);
+    expect(JSON.stringify(fieldValue(afterUndo, entity.field)), `${entity.label} update\u2192undo restores ${entity.field} (I1)`).toBe(JSON.stringify(beforeValue));
+    if (typeof beforeUpdate?.updatedAt === "string" && typeof afterUndo?.updatedAt === "string") {
+      expect(afterUndo.updatedAt, `${entity.label} undo bumps updatedAt`).not.toBe(beforeUpdate.updatedAt);
+    }
+    await redoOk(request, token, updateOp.logId, `${entity.label} redo update`);
+    expect(JSON.stringify(fieldValue(await readRecord(request, token, entity, cycleId), entity.field)), `${entity.label} redo re-applies update (I6)`).toBe(JSON.stringify(afterUpdateValue));
+    const deleteRes = await deleteEntity(request, token, entity, cycleId);
+    expect(deleteRes.ok(), `${entity.label} delete status ${deleteRes.status()}`).toBeTruthy();
+    const deleteOp = expectOperation(deleteRes, `${entity.label}.delete`);
+    expect(await readRecord(request, token, entity, cycleId), `${entity.label} deleted record should not read`).toBeNull();
+    await undoOk(request, token, deleteOp.undoToken, `${entity.label} undo delete`);
+    expect(fieldValue(await readRecord(request, token, entity, cycleId), entity.field), `${entity.label} delete\u2192undo re-materializes (I2)`).toBeDefined();
+  } finally {
+    if (createUndoId) await deleteEntity(request, token, entity, createUndoId).catch(() => {
+    });
+    if (cycleId) await deleteEntity(request, token, entity, cycleId).catch(() => {
+    });
+  }
+}
 export {
+  UNDO_TESTS_DISABLED_ENV,
   assertFieldsEqual,
   expectOperation,
   expectTokenConsumed,
@@ -75,7 +167,10 @@ export {
   listUndoable,
   redoByLogId,
   redoOk,
+  runCrudUndoRoundTrip,
+  skipIfUndoTestsDisabled,
   undoByToken,
-  undoOk
+  undoOk,
+  undoTestsDisabled
 };
 //# sourceMappingURL=undoHarness.js.map

package/dist/helpers/integration/undoHarness.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/helpers/integration/undoHarness.ts"],
-  "sourcesContent": ["import { type APIRequestContext, type APIResponse, expect } from '@playwright/test'\nimport { apiRequest } from './api'\n\n/**\n * Shared harness for verifying Undo/Redo correctness against the real command bus.\n *\n * Every mutating Open Mercato API response carries the operation metadata in the\n * `x-om-operation` header (`omop:<urlencoded JSON>`) containing the `undoToken` and the\n * audit log `id` (used as `logId` for redo). These helpers extract that envelope and drive\n * the real undo/redo endpoints so tests can assert full state restoration per TC-UNDO-001.\n */\n\nconst HEADER_PREFIX = 'omop:'\nconst UNDO_PATH = '/api/audit_logs/audit-logs/actions/undo'\nconst REDO_PATH = '/api/audit_logs/audit-logs/actions/redo'\nconst ACTIONS_PATH = '/api/audit_logs/audit-logs/actions'\n\nexport type Operation = {\n  logId: string\n  undoToken: string\n  commandId: string\n  resourceKind: string | null\n  resourceId: string | null\n}\n\n/** Parse the `x-om-operation` header into a structured operation, or null when absent/malformed. */\nexport function extractOperation(response: APIResponse): Operation | null {\n  const header = response.headers()['x-om-operation']\n  if (!header || typeof header !== 'string') return null\n  const trimmed = header.startsWith(HEADER_PREFIX) ? header.slice(HEADER_PREFIX.length) : header\n  try {\n    const parsed = JSON.parse(decodeURIComponent(trimmed)) as Record<string, unknown>\n    if (typeof parsed.id !== 'string' || typeof parsed.commandId !== 'string') return null\n    if (typeof parsed.undoToken !== 'string' || !parsed.undoToken) return null\n    return {\n      logId: parsed.id,\n      undoToken: parsed.undoToken,\n      commandId: parsed.commandId,\n      resourceKind: (parsed.resourceKind as string) ?? null,\n      resourceId: (parsed.resourceId as string) ?? null,\n    }\n  } catch {\n    return null\n  }\n}\n\n/** Like extractOperation but fails the test if no undo token was issued. */\nexport function expectOperation(response: APIResponse, context: string): Operation {\n  const op = extractOperation(response)\n  expect(op, `Expected an undo token (x-om-operation header) for ${context}, got none`).toBeTruthy()\n  return op as Operation\n}\n\nexport async function undoByToken(request: APIRequestContext, token: string, undoToken: string): Promise<APIResponse> {\n  return apiRequest(request, 'POST', UNDO_PATH, { token, data: { undoToken } })\n}\n\nexport async function redoByLogId(request: APIRequestContext, token: string, logId: string): Promise<APIResponse> {\n  return apiRequest(request, 'POST', REDO_PATH, { token, data: { logId } })\n}\n\n/** Undo and assert success; returns the resolved logId. */\nexport async function undoOk(request: APIRequestContext, token: string, undoToken: string, context: string): Promise<string> {\n  const res = await undoByToken(request, token, undoToken)\n  const body = (await res.json().catch(() => null)) as { ok?: boolean; logId?: string } | null\n  expect(res.ok(), `Undo failed for ${context}: status ${res.status()} body ${JSON.stringify(body)}`).toBeTruthy()\n  expect(body?.ok, `Undo not ok for ${context}: ${JSON.stringify(body)}`).toBeTruthy()\n  return body?.logId as string\n}\n\n/** Redo and assert success; returns the new operation (new undoToken + logId). */\nexport async function redoOk(request: APIRequestContext, token: string, logId: string, context: string): Promise<{ logId: string; undoToken: string | null }> {\n  const res = await redoByLogId(request, token, logId)\n  const body = (await res.json().catch(() => null)) as { ok?: boolean; logId?: string; undoToken?: string } | null\n  expect(res.ok(), `Redo failed for ${context}: status ${res.status()} body ${JSON.stringify(body)}`).toBeTruthy()\n  expect(body?.ok, `Redo not ok for ${context}: ${JSON.stringify(body)}`).toBeTruthy()\n  return { logId: body?.logId as string, undoToken: body?.undoToken ?? null }\n}\n\n/** Assert that undoing an already-consumed token is rejected (token consumption / no double-undo). */\nexport async function expectTokenConsumed(request: APIRequestContext, token: string, undoToken: string, context: string): Promise<void> {\n  const res = await undoByToken(request, token, undoToken)\n  expect(res.ok(), `Expected double-undo to be rejected for ${context}, but it succeeded`).toBeFalsy()\n}\n\n/** Fetch undoable actions list (for Version History assertions). */\nexport async function listUndoable(request: APIRequestContext, token: string, params: Record<string, string> = {}): Promise<unknown> {\n  const qs = new URLSearchParams({ undoableOnly: 'true', ...params }).toString()\n  const res = await apiRequest(request, 'GET', `${ACTIONS_PATH}?${qs}`, { token })\n  return res.json().catch(() => null)\n}\n\n/**\n * Deep-equality assertion for a selected set of fields between two entity snapshots.\n * Reports the first mismatching field with context for clear bug triage.\n */\nexport function assertFieldsEqual(\n  actual: Record<string, unknown> | null | undefined,\n  expected: Record<string, unknown> | null | undefined,\n  fields: string[],\n  context: string,\n): void {\n  expect(actual, `${context}: actual entity missing`).toBeTruthy()\n  expect(expected, `${context}: expected entity missing`).toBeTruthy()\n  for (const field of fields) {\n    expect(\n      JSON.stringify((actual as Record<string, unknown>)[field]),\n      `${context}: field \"${field}\" not restored (expected ${JSON.stringify((expected as Record<string, unknown>)[field])}, got ${JSON.stringify((actual as Record<string, unknown>)[field])})`,\n    ).toBe(JSON.stringify((expected as Record<string, unknown>)[field]))\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { type APIRequestContext, type APIResponse, expect, test } from '@playwright/test'\nimport { parseBooleanWithDefault } from '@open-mercato/shared/lib/boolean'\nimport { apiRequest } from './api'\nimport { expectId, readJsonSafe } from './generalFixtures'\n\n/**\n * Shared harness for verifying Undo/Redo correctness against the real command bus.\n *\n * Every mutating Open Mercato API response carries the operation metadata in the\n * `x-om-operation` header (`omop:<urlencoded JSON>`) containing the `undoToken` and the\n * audit log `id` (used as `logId` for redo). These helpers extract that envelope and drive\n * the real undo/redo endpoints so tests can assert full state restoration per TC-UNDO-001.\n */\n\nconst HEADER_PREFIX = 'omop:'\nconst UNDO_PATH = '/api/audit_logs/audit-logs/actions/undo'\nconst REDO_PATH = '/api/audit_logs/audit-logs/actions/redo'\nconst ACTIONS_PATH = '/api/audit_logs/audit-logs/actions'\nexport const UNDO_TESTS_DISABLED_ENV = 'OM_INTEGRATION_UNDO_TESTS_DISABLED'\n\nexport type Operation = {\n  logId: string\n  undoToken: string\n  commandId: string\n  resourceKind: string | null\n  resourceId: string | null\n}\n\nexport type CrudUndoEntityConfig = {\n  label: string\n  collectionPath: string\n  field: string\n  createPayload: (stamp: string) => Record<string, unknown>\n  updatePayload: (id: string, stamp: string) => Record<string, unknown>\n  readPath?: (id: string) => string\n  deletePath?: (id: string) => string\n  createStatus?: number\n  updateStatus?: number\n}\n\nexport function undoTestsDisabled(env: NodeJS.ProcessEnv = process.env): boolean {\n  return parseBooleanWithDefault(env[UNDO_TESTS_DISABLED_ENV], false)\n}\n\nexport function skipIfUndoTestsDisabled(): void {\n  test.skip(undoTestsDisabled(), `${UNDO_TESTS_DISABLED_ENV} is set \u2014 undo/redo integration tests skipped`)\n}\n\n/** Parse the `x-om-operation` header into a structured operation, or null when absent/malformed. */\nexport function extractOperation(response: APIResponse): Operation | null {\n  const header = response.headers()['x-om-operation']\n  if (!header || typeof header !== 'string') return null\n  const trimmed = header.startsWith(HEADER_PREFIX) ? header.slice(HEADER_PREFIX.length) : header\n  try {\n    const parsed = JSON.parse(decodeURIComponent(trimmed)) as Record<string, unknown>\n    if (typeof parsed.id !== 'string' || typeof parsed.commandId !== 'string') return null\n    if (typeof parsed.undoToken !== 'string' || !parsed.undoToken) return null\n    return {\n      logId: parsed.id,\n      undoToken: parsed.undoToken,\n      commandId: parsed.commandId,\n      resourceKind: (parsed.resourceKind as string) ?? null,\n      resourceId: (parsed.resourceId as string) ?? null,\n    }\n  } catch {\n    return null\n  }\n}\n\n/** Like extractOperation but fails the test if no undo token was issued. */\nexport function expectOperation(response: APIResponse, context: string): Operation {\n  const op = extractOperation(response)\n  expect(op, `Expected an undo token (x-om-operation header) for ${context}, got none`).toBeTruthy()\n  return op as Operation\n}\n\nexport async function undoByToken(request: APIRequestContext, token: string, undoToken: string): Promise<APIResponse> {\n  return apiRequest(request, 'POST', UNDO_PATH, { token, data: { undoToken } })\n}\n\nexport async function redoByLogId(request: APIRequestContext, token: string, logId: string): Promise<APIResponse> {\n  return apiRequest(request, 'POST', REDO_PATH, { token, data: { logId } })\n}\n\n/** Undo and assert success; returns the resolved logId. */\nexport async function undoOk(request: APIRequestContext, token: string, undoToken: string, context: string): Promise<string> {\n  const res = await undoByToken(request, token, undoToken)\n  const body = (await res.json().catch(() => null)) as { ok?: boolean; logId?: string } | null\n  expect(res.ok(), `Undo failed for ${context}: status ${res.status()} body ${JSON.stringify(body)}`).toBeTruthy()\n  expect(body?.ok, `Undo not ok for ${context}: ${JSON.stringify(body)}`).toBeTruthy()\n  return body?.logId as string\n}\n\n/** Redo and assert success; returns the new operation (new undoToken + logId). */\nexport async function redoOk(request: APIRequestContext, token: string, logId: string, context: string): Promise<{ logId: string; undoToken: string | null }> {\n  const res = await redoByLogId(request, token, logId)\n  const body = (await res.json().catch(() => null)) as { ok?: boolean; logId?: string; undoToken?: string } | null\n  expect(res.ok(), `Redo failed for ${context}: status ${res.status()} body ${JSON.stringify(body)}`).toBeTruthy()\n  expect(body?.ok, `Redo not ok for ${context}: ${JSON.stringify(body)}`).toBeTruthy()\n  return { logId: body?.logId as string, undoToken: body?.undoToken ?? null }\n}\n\n/** Assert that undoing an already-consumed token is rejected (token consumption / no double-undo). */\nexport async function expectTokenConsumed(request: APIRequestContext, token: string, undoToken: string, context: string): Promise<void> {\n  const res = await undoByToken(request, token, undoToken)\n  expect(res.ok(), `Expected double-undo to be rejected for ${context}, but it succeeded`).toBeFalsy()\n}\n\n/** Fetch undoable actions list (for Version History assertions). */\nexport async function listUndoable(request: APIRequestContext, token: string, params: Record<string, string> = {}): Promise<unknown> {\n  const qs = new URLSearchParams({ undoableOnly: 'true', ...params }).toString()\n  const res = await apiRequest(request, 'GET', `${ACTIONS_PATH}?${qs}`, { token })\n  return res.json().catch(() => null)\n}\n\n/**\n * Deep-equality assertion for a selected set of fields between two entity snapshots.\n * Reports the first mismatching field with context for clear bug triage.\n */\nexport function assertFieldsEqual(\n  actual: Record<string, unknown> | null | undefined,\n  expected: Record<string, unknown> | null | undefined,\n  fields: string[],\n  context: string,\n): void {\n  expect(actual, `${context}: actual entity missing`).toBeTruthy()\n  expect(expected, `${context}: expected entity missing`).toBeTruthy()\n  for (const field of fields) {\n    expect(\n      JSON.stringify((actual as Record<string, unknown>)[field]),\n      `${context}: field \"${field}\" not restored (expected ${JSON.stringify((expected as Record<string, unknown>)[field])}, got ${JSON.stringify((actual as Record<string, unknown>)[field])})`,\n    ).toBe(JSON.stringify((expected as Record<string, unknown>)[field]))\n  }\n}\n\nfunction findRecord(body: unknown, id: string): Record<string, unknown> | null {\n  if (!body || typeof body !== 'object') return null\n  if (!Array.isArray(body) && (body as Record<string, unknown>).id === id) {\n    return body as Record<string, unknown>\n  }\n  for (const value of Array.isArray(body) ? body : Object.values(body)) {\n    const found = findRecord(value, id)\n    if (found) return found\n  }\n  return null\n}\n\nasync function readRecord(\n  request: APIRequestContext,\n  token: string,\n  entity: CrudUndoEntityConfig,\n  id: string,\n): Promise<Record<string, unknown> | null> {\n  const path = entity.readPath?.(id) ?? `${entity.collectionPath}?id=${encodeURIComponent(id)}`\n  const response = await apiRequest(request, 'GET', path, { token })\n  const body = await readJsonSafe(response)\n  if (!response.ok()) return null\n  return findRecord(body, id)\n}\n\nfunction fieldValue(record: Record<string, unknown> | null, field: string): unknown {\n  return record?.[field]\n}\n\nasync function deleteEntity(\n  request: APIRequestContext,\n  token: string,\n  entity: CrudUndoEntityConfig,\n  id: string,\n): Promise<APIResponse> {\n  const path = entity.deletePath?.(id) ?? `${entity.collectionPath}?id=${encodeURIComponent(id)}`\n  return apiRequest(request, 'DELETE', path, { token })\n}\n\nexport async function runCrudUndoRoundTrip(\n  request: APIRequestContext,\n  token: string,\n  entity: CrudUndoEntityConfig,\n): Promise<void> {\n  const stamp = `${Date.now()}${Math.floor(Math.random() * 1000)}`\n  let createUndoId: string | null = null\n  let cycleId: string | null = null\n\n  try {\n    const createUndoRes = await apiRequest(request, 'POST', entity.collectionPath, {\n      token,\n      data: entity.createPayload(`${stamp}a`),\n    })\n    expect(createUndoRes.status(), `${entity.label} create-for-undo status`).toBe(entity.createStatus ?? 201)\n    const createUndoOp = expectOperation(createUndoRes, `${entity.label}.create`)\n    createUndoId = createUndoOp.resourceId || expectId((await readJsonSafe<Record<string, unknown>>(createUndoRes))?.id, `${entity.label} create id`)\n    expect(fieldValue(await readRecord(request, token, entity, createUndoId), entity.field), `${entity.label} field readable after create`).toBeDefined()\n\n    await undoOk(request, token, createUndoOp.undoToken, `${entity.label} undo create`)\n    expect(await readRecord(request, token, entity, createUndoId), `${entity.label} create\u2192undo soft-deletes/removes the record (I3)`).toBeNull()\n    await expectTokenConsumed(request, token, createUndoOp.undoToken, `${entity.label} create token consumed (I5)`)\n\n    const createRes = await apiRequest(request, 'POST', entity.collectionPath, {\n      token,\n      data: entity.createPayload(`${stamp}b`),\n    })\n    expect(createRes.status(), `${entity.label} create status`).toBe(entity.createStatus ?? 201)\n    const createOp = expectOperation(createRes, `${entity.label}.create`)\n    cycleId = createOp.resourceId || expectId((await readJsonSafe<Record<string, unknown>>(createRes))?.id, `${entity.label} cycle id`)\n\n    const beforeUpdate = await readRecord(request, token, entity, cycleId)\n    const beforeValue = fieldValue(beforeUpdate, entity.field)\n    expect(beforeValue, `${entity.label} field readable before update`).toBeDefined()\n\n    const updateRes = await apiRequest(request, 'PUT', entity.collectionPath, {\n      token,\n      data: entity.updatePayload(cycleId, stamp),\n    })\n    expect(updateRes.status(), `${entity.label} update status`).toBe(entity.updateStatus ?? 200)\n    const updateOp = expectOperation(updateRes, `${entity.label}.update`)\n    const afterUpdate = await readRecord(request, token, entity, cycleId)\n    const afterUpdateValue = fieldValue(afterUpdate, entity.field)\n    expect(JSON.stringify(afterUpdateValue), `${entity.label} field changed by update`).not.toBe(JSON.stringify(beforeValue))\n\n    await new Promise((resolve) => setTimeout(resolve, 10))\n    await undoOk(request, token, updateOp.undoToken, `${entity.label} undo update`)\n    const afterUndo = await readRecord(request, token, entity, cycleId)\n    expect(JSON.stringify(fieldValue(afterUndo, entity.field)), `${entity.label} update\u2192undo restores ${entity.field} (I1)`).toBe(JSON.stringify(beforeValue))\n    if (typeof beforeUpdate?.updatedAt === 'string' && typeof afterUndo?.updatedAt === 'string') {\n      expect(afterUndo.updatedAt, `${entity.label} undo bumps updatedAt`).not.toBe(beforeUpdate.updatedAt)\n    }\n\n    await redoOk(request, token, updateOp.logId, `${entity.label} redo update`)\n    expect(JSON.stringify(fieldValue(await readRecord(request, token, entity, cycleId), entity.field)), `${entity.label} redo re-applies update (I6)`).toBe(JSON.stringify(afterUpdateValue))\n\n    const deleteRes = await deleteEntity(request, token, entity, cycleId)\n    expect(deleteRes.ok(), `${entity.label} delete status ${deleteRes.status()}`).toBeTruthy()\n    const deleteOp = expectOperation(deleteRes, `${entity.label}.delete`)\n    expect(await readRecord(request, token, entity, cycleId), `${entity.label} deleted record should not read`).toBeNull()\n\n    await undoOk(request, token, deleteOp.undoToken, `${entity.label} undo delete`)\n    expect(fieldValue(await readRecord(request, token, entity, cycleId), entity.field), `${entity.label} delete\u2192undo re-materializes (I2)`).toBeDefined()\n  } finally {\n    if (createUndoId) await deleteEntity(request, token, entity, createUndoId).catch(() => {})\n    if (cycleId) await deleteEntity(request, token, entity, cycleId).catch(() => {})\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/customers/commands/deals.js

@@ -8,6 +8,7 @@ import {
   normalizeAuthorUserId
 } from "@open-mercato/shared/lib/commands/helpers";
 import { withAtomicFlush } from "@open-mercato/shared/lib/commands/flush";
+import { runCrudCommandWrite } from "@open-mercato/shared/lib/commands/runCrudCommandWrite";
 import {
   CustomerDeal,
   CustomerDealPersonLink,
@@ -437,92 +438,88 @@ const updateDealCommand = {
     };
     let nextPipelineStageLabel = null;
     let resolvedCurrentPipelineStageLabel = null;
-    await withAtomicFlush(em, [
-      async () => {
-        const pipelineAssignmentChanged = parsed.pipelineId !== void 0 || parsed.pipelineStageId !== void 0;
-        const requestedPipelineStageId = parsed.pipelineStageId !== void 0 ? parsed.pipelineStageId ?? null : record.pipelineStageId ?? null;
-        const requestedPipelineId = parsed.pipelineId !== void 0 ? parsed.pipelineId ?? null : record.pipelineId ?? null;
-        nextStageSnapshot = requestedPipelineStageId && (pipelineAssignmentChanged || !record.pipelineStage) ? await loadPipelineStageSnapshot(em, requestedPipelineStageId, record.tenantId, record.organizationId) : null;
-        if (pipelineAssignmentChanged) {
-          nextPipelineAssignment = resolvePipelineAssignment({
-            pipelineId: requestedPipelineId,
-            pipelineStageId: requestedPipelineStageId,
-            stageSnapshot: nextStageSnapshot
-          });
-        }
-        nextPipelineStageLabel = nextStageSnapshot ? (await ensureDictionaryEntry(em, {
-          tenantId: record.tenantId,
-          organizationId: record.organizationId,
-          kind: "pipeline_stage",
-          value: nextStageSnapshot.label
-        }))?.value ?? nextStageSnapshot.label : null;
-        resolvedCurrentPipelineStageLabel = !nextStageSnapshot && record.pipelineStageId && (parsed.pipelineStageId !== void 0 || !record.pipelineStage) ? await resolvePipelineStageValue(em, record.pipelineStageId, record.tenantId, record.organizationId) : null;
-      },
-      () => {
-        if (parsed.title !== void 0) record.title = parsed.title;
-        if (parsed.description !== void 0) record.description = parsed.description ?? null;
-        if (parsed.status !== void 0) record.status = parsed.status ?? record.status;
-        if (parsed.pipelineStage !== void 0) record.pipelineStage = parsed.pipelineStage ?? null;
-        if (parsed.pipelineId !== void 0 || parsed.pipelineStageId !== void 0 && nextStageSnapshot) {
-          record.pipelineId = nextPipelineAssignment.pipelineId;
-        }
-        if (parsed.pipelineStageId !== void 0) record.pipelineStageId = nextPipelineAssignment.pipelineStageId;
-        if (nextPipelineStageLabel && (parsed.pipelineStageId !== void 0 || !record.pipelineStage)) {
-          record.pipelineStage = nextPipelineStageLabel;
-        } else if (resolvedCurrentPipelineStageLabel && (parsed.pipelineStageId !== void 0 || !record.pipelineStage)) {
-          record.pipelineStage = resolvedCurrentPipelineStageLabel;
-        }
-        if (parsed.valueAmount !== void 0) record.valueAmount = toNumericString(parsed.valueAmount);
-        if (parsed.valueCurrency !== void 0) record.valueCurrency = parsed.valueCurrency ?? null;
-        if (parsed.probability !== void 0) record.probability = parsed.probability ?? null;
-        if (parsed.expectedCloseAt !== void 0) record.expectedCloseAt = parsed.expectedCloseAt ?? null;
-        if (parsed.ownerUserId !== void 0) record.ownerUserId = parsed.ownerUserId ?? null;
-        if (parsed.source !== void 0) record.source = parsed.source ?? null;
-        if (parsed.closureOutcome !== void 0) record.closureOutcome = parsed.closureOutcome ?? null;
-        if (parsed.lossReasonId !== void 0) record.lossReasonId = parsed.lossReasonId ?? null;
-        if (parsed.lossNotes !== void 0) record.lossNotes = parsed.lossNotes ?? null;
-      },
-      async () => {
-        await em.flush();
-      },
-      async () => {
-        const snapshot = nextStageSnapshot;
-        if (!snapshot) return;
-        const shouldRecord = parsed.pipelineStageId !== void 0 && parsed.pipelineStageId !== null && parsed.pipelineStageId !== previousPipelineStageId;
-        if (!shouldRecord) return;
-        await upsertDealStageTransition(em, {
-          deal: record,
-          pipelineId: snapshot.pipelineId,
-          stageId: snapshot.id,
-          stageLabel: nextPipelineStageLabel ?? snapshot.label,
-          stageOrder: snapshot.order,
-          transitionedByUserId: normalizedTransitionAuthorUserId
-        });
-      },
-      () => syncDealPeople(em, record, parsed.personIds),
-      () => syncDealCompanies(em, record, parsed.companyIds)
-    ], { transaction: true });
-    const de = ctx.container.resolve("dataEngine");
-    await setCustomFieldsIfAny({
-      dataEngine: de,
+    await runCrudCommandWrite({
+      ctx,
+      em,
       entityId: DEAL_ENTITY_ID,
-      recordId: record.id,
-      organizationId: record.organizationId,
-      tenantId: record.tenantId,
-      values: custom,
-      notify: false
-    });
-    await emitCrudSideEffects({
-      dataEngine: de,
       action: "updated",
-      entity: record,
-      identifiers: {
-        id: record.id,
-        organizationId: record.organizationId,
-        tenantId: record.tenantId
-      },
+      scope: { tenantId: record.tenantId, organizationId: record.organizationId },
+      customFields: custom,
+      events: dealCrudEvents,
       indexer: dealCrudIndexer,
-      events: dealCrudEvents
+      sideEffect: () => ({
+        entity: record,
+        identifiers: {
+          id: record.id,
+          organizationId: record.organizationId,
+          tenantId: record.tenantId
+        }
+      }),
+      phases: [
+        async () => {
+          const pipelineAssignmentChanged = parsed.pipelineId !== void 0 || parsed.pipelineStageId !== void 0;
+          const requestedPipelineStageId = parsed.pipelineStageId !== void 0 ? parsed.pipelineStageId ?? null : record.pipelineStageId ?? null;
+          const requestedPipelineId = parsed.pipelineId !== void 0 ? parsed.pipelineId ?? null : record.pipelineId ?? null;
+          nextStageSnapshot = requestedPipelineStageId && (pipelineAssignmentChanged || !record.pipelineStage) ? await loadPipelineStageSnapshot(em, requestedPipelineStageId, record.tenantId, record.organizationId) : null;
+          if (pipelineAssignmentChanged) {
+            nextPipelineAssignment = resolvePipelineAssignment({
+              pipelineId: requestedPipelineId,
+              pipelineStageId: requestedPipelineStageId,
+              stageSnapshot: nextStageSnapshot
+            });
+          }
+          nextPipelineStageLabel = nextStageSnapshot ? (await ensureDictionaryEntry(em, {
+            tenantId: record.tenantId,
+            organizationId: record.organizationId,
+            kind: "pipeline_stage",
+            value: nextStageSnapshot.label
+          }))?.value ?? nextStageSnapshot.label : null;
+          resolvedCurrentPipelineStageLabel = !nextStageSnapshot && record.pipelineStageId && (parsed.pipelineStageId !== void 0 || !record.pipelineStage) ? await resolvePipelineStageValue(em, record.pipelineStageId, record.tenantId, record.organizationId) : null;
+        },
+        () => {
+          if (parsed.title !== void 0) record.title = parsed.title;
+          if (parsed.description !== void 0) record.description = parsed.description ?? null;
+          if (parsed.status !== void 0) record.status = parsed.status ?? record.status;
+          if (parsed.pipelineStage !== void 0) record.pipelineStage = parsed.pipelineStage ?? null;
+          if (parsed.pipelineId !== void 0 || parsed.pipelineStageId !== void 0 && nextStageSnapshot) {
+            record.pipelineId = nextPipelineAssignment.pipelineId;
+          }
+          if (parsed.pipelineStageId !== void 0) record.pipelineStageId = nextPipelineAssignment.pipelineStageId;
+          if (nextPipelineStageLabel && (parsed.pipelineStageId !== void 0 || !record.pipelineStage)) {
+            record.pipelineStage = nextPipelineStageLabel;
+          } else if (resolvedCurrentPipelineStageLabel && (parsed.pipelineStageId !== void 0 || !record.pipelineStage)) {
+            record.pipelineStage = resolvedCurrentPipelineStageLabel;
+          }
+          if (parsed.valueAmount !== void 0) record.valueAmount = toNumericString(parsed.valueAmount);
+          if (parsed.valueCurrency !== void 0) record.valueCurrency = parsed.valueCurrency ?? null;
+          if (parsed.probability !== void 0) record.probability = parsed.probability ?? null;
+          if (parsed.expectedCloseAt !== void 0) record.expectedCloseAt = parsed.expectedCloseAt ?? null;
+          if (parsed.ownerUserId !== void 0) record.ownerUserId = parsed.ownerUserId ?? null;
+          if (parsed.source !== void 0) record.source = parsed.source ?? null;
+          if (parsed.closureOutcome !== void 0) record.closureOutcome = parsed.closureOutcome ?? null;
+          if (parsed.lossReasonId !== void 0) record.lossReasonId = parsed.lossReasonId ?? null;
+          if (parsed.lossNotes !== void 0) record.lossNotes = parsed.lossNotes ?? null;
+        },
+        async () => {
+          await em.flush();
+        },
+        async () => {
+          const snapshot = nextStageSnapshot;
+          if (!snapshot) return;
+          const shouldRecord = parsed.pipelineStageId !== void 0 && parsed.pipelineStageId !== null && parsed.pipelineStageId !== previousPipelineStageId;
+          if (!shouldRecord) return;
+          await upsertDealStageTransition(em, {
+            deal: record,
+            pipelineId: snapshot.pipelineId,
+            stageId: snapshot.id,
+            stageLabel: nextPipelineStageLabel ?? snapshot.label,
+            stageOrder: snapshot.order,
+            transitionedByUserId: normalizedTransitionAuthorUserId
+          });
+        },
+        () => syncDealPeople(em, record, parsed.personIds),
+        () => syncDealCompanies(em, record, parsed.companyIds)
+      ]
     });
     const newStatus = record.status;
     const normalizedStatus = newStatus === "win" ? "won" : newStatus === "loose" ? "lost" : newStatus;