@open-mercato/shared 0.4.2-canary-c02407ff85

package/dist/lib/commands/command-bus.js

@@ -0,0 +1,285 @@
+import { commandRegistry } from "./registry.js";
+import { defaultUndoToken } from "./types.js";
+import {
+  canonicalizeResourceTag,
+  deriveResourceFromCommandId,
+  invalidateCrudCache,
+  pickFirstIdentifier,
+  isCrudCacheDebugEnabled
+} from "@open-mercato/shared/lib/crud/cache";
+const SKIPPED_ACTION_LOG_RESOURCE_KINDS = /* @__PURE__ */ new Set([
+  "audit_logs.access",
+  "audit_logs.action",
+  "dashboards.layout",
+  "dashboards.user_widgets",
+  "dashboards.role_widgets"
+]);
+function asRecord(input) {
+  if (!input || typeof input !== "object" || Array.isArray(input)) return null;
+  return input;
+}
+function extractAliasList(source) {
+  if (!source || typeof source !== "object" || Array.isArray(source)) return [];
+  const record = source;
+  const raw = record.cacheAliases;
+  if (!Array.isArray(raw)) return [];
+  const aliases = /* @__PURE__ */ new Set();
+  for (const value of raw) {
+    if (typeof value !== "string") continue;
+    const normalized = canonicalizeResourceTag(value);
+    if (normalized) aliases.add(normalized);
+  }
+  return Array.from(aliases);
+}
+class CommandBus {
+  async execute(commandId, options) {
+    const handler = this.resolveHandler(commandId);
+    const snapshots = await this.prepareSnapshots(handler, options);
+    const result = await handler.execute(options.input, options.ctx);
+    const afterSnapshot = await this.captureAfter(handler, options, result);
+    const snapshotsWithAfter = { ...snapshots, after: afterSnapshot };
+    const logMeta = await this.buildLog(handler, options, result, snapshotsWithAfter);
+    let mergedMeta = this.mergeMetadata(options.metadata, logMeta);
+    const undoable = this.isUndoable(handler);
+    if (undoable) {
+      mergedMeta = mergedMeta ?? {};
+      if (!mergedMeta.undoToken) mergedMeta.undoToken = defaultUndoToken();
+      if (mergedMeta.actorUserId === void 0) mergedMeta.actorUserId = options.ctx.auth?.sub ?? null;
+    }
+    if (afterSnapshot !== void 0 && afterSnapshot !== null) {
+      if (!mergedMeta) {
+        mergedMeta = { snapshotAfter: afterSnapshot };
+      } else if (!mergedMeta.snapshotAfter) {
+        mergedMeta.snapshotAfter = afterSnapshot;
+      }
+    }
+    if (snapshots.before) {
+      if (!mergedMeta) {
+        mergedMeta = { snapshotBefore: snapshots.before };
+      } else if (!mergedMeta.snapshotBefore) {
+        mergedMeta.snapshotBefore = snapshots.before;
+      }
+    }
+    const logEntry = await this.persistLog(commandId, options, mergedMeta);
+    await this.invalidateCacheAfterExecute(commandId, options, result, mergedMeta);
+    await this.flushCrudSideEffects(options.ctx.container);
+    return { result, logEntry };
+  }
+  async undo(undoToken, ctx) {
+    const service = ctx.container.resolve("actionLogService");
+    const log = await service.findByUndoToken(undoToken);
+    if (!log) throw new Error("Undo token expired or not found");
+    const handler = this.resolveHandler(log.commandId);
+    if (!handler.undo || this.isUndoable(handler) === false) {
+      throw new Error(`Command ${log.commandId} is not undoable`);
+    }
+    await handler.undo({
+      input: log.commandPayload,
+      ctx,
+      logEntry: log
+    });
+    await service.markUndone(log.id);
+    await this.invalidateCacheAfterUndo(log, ctx);
+    await this.flushCrudSideEffects(ctx.container);
+  }
+  resolveHandler(commandId) {
+    const handler = commandRegistry.get(commandId);
+    if (!handler) throw new Error(`Command handler not registered for id ${commandId}`);
+    return handler;
+  }
+  async prepareSnapshots(handler, options) {
+    if (!handler.prepare) return {};
+    try {
+      return await handler.prepare(options.input, options.ctx) || {};
+    } catch (err) {
+      throw err;
+    }
+  }
+  async captureAfter(handler, options, result) {
+    if (!handler.captureAfter) return void 0;
+    return handler.captureAfter(options.input, result, options.ctx);
+  }
+  async buildLog(handler, options, result, snapshots) {
+    if (!handler.buildLog) return null;
+    const args = {
+      input: options.input,
+      result,
+      ctx: options.ctx,
+      snapshots
+    };
+    return await handler.buildLog(args) || null;
+  }
+  mergeMetadata(primary, secondary) {
+    if (!primary && !secondary) return null;
+    return {
+      tenantId: primary?.tenantId ?? secondary?.tenantId ?? null,
+      organizationId: primary?.organizationId ?? secondary?.organizationId ?? null,
+      actorUserId: primary?.actorUserId ?? secondary?.actorUserId ?? null,
+      actionLabel: primary?.actionLabel ?? secondary?.actionLabel ?? null,
+      resourceKind: primary?.resourceKind ?? secondary?.resourceKind ?? null,
+      resourceId: primary?.resourceId ?? secondary?.resourceId ?? null,
+      undoToken: primary?.undoToken ?? secondary?.undoToken ?? null,
+      payload: primary?.payload ?? secondary?.payload ?? null,
+      snapshotBefore: primary?.snapshotBefore ?? secondary?.snapshotBefore ?? null,
+      snapshotAfter: primary?.snapshotAfter ?? secondary?.snapshotAfter ?? null,
+      changes: primary?.changes ?? secondary?.changes ?? null,
+      context: primary?.context ?? secondary?.context ?? null
+    };
+  }
+  async persistLog(commandId, options, metadata) {
+    if (!metadata) return null;
+    const resourceKind = typeof metadata.resourceKind === "string" ? metadata.resourceKind : null;
+    if (resourceKind && SKIPPED_ACTION_LOG_RESOURCE_KINDS.has(resourceKind)) {
+      return null;
+    }
+    let service = null;
+    try {
+      service = options.ctx.container.resolve("actionLogService");
+    } catch {
+      service = null;
+    }
+    if (!service) return null;
+    const tenantId = metadata.tenantId ?? options.ctx.auth?.tenantId ?? null;
+    const organizationId = metadata.organizationId ?? options.ctx.selectedOrganizationId ?? options.ctx.auth?.orgId ?? null;
+    const actorUserId = metadata.actorUserId ?? options.ctx.auth?.sub ?? null;
+    const payload = {
+      tenantId: tenantId ?? void 0,
+      organizationId: organizationId ?? void 0,
+      actorUserId: actorUserId ?? void 0,
+      commandId
+    };
+    if (metadata) {
+      if ("actionLabel" in metadata && metadata.actionLabel != null) payload.actionLabel = metadata.actionLabel;
+      if ("resourceKind" in metadata && metadata.resourceKind != null) payload.resourceKind = metadata.resourceKind;
+      if ("resourceId" in metadata && metadata.resourceId != null) payload.resourceId = metadata.resourceId;
+      if ("undoToken" in metadata && metadata.undoToken != null) payload.undoToken = metadata.undoToken;
+      if ("payload" in metadata && metadata.payload !== void 0) payload.commandPayload = metadata.payload;
+      if ("snapshotBefore" in metadata && metadata.snapshotBefore !== void 0) payload.snapshotBefore = metadata.snapshotBefore;
+      if ("snapshotAfter" in metadata && metadata.snapshotAfter !== void 0) payload.snapshotAfter = metadata.snapshotAfter;
+      if ("changes" in metadata && metadata.changes !== void 0 && metadata.changes !== null) payload.changes = metadata.changes;
+      if ("context" in metadata && metadata.context !== void 0 && metadata.context !== null) payload.context = metadata.context;
+    }
+    const redoEnvelope = wrapRedoPayload("commandPayload" in payload ? payload.commandPayload : void 0, options.input);
+    payload.commandPayload = redoEnvelope;
+    return await service.log(payload);
+  }
+  isUndoable(handler) {
+    return handler.isUndoable !== false && typeof handler.undo === "function";
+  }
+  async invalidateCacheAfterExecute(commandId, options, result, metadata) {
+    const resource = typeof metadata?.resourceKind === "string" ? metadata.resourceKind : null;
+    if (!resource) return;
+    try {
+      const ctx = options.ctx;
+      const resultRecord = asRecord(result);
+      const resultEntity = asRecord(resultRecord?.entity);
+      const inputRecord = asRecord(options.input);
+      const inputEntity = asRecord(inputRecord?.entity);
+      const recordId = pickFirstIdentifier(
+        metadata?.resourceId,
+        resultRecord?.entityId,
+        resultRecord?.id,
+        resultRecord?.recordId,
+        resultEntity?.id,
+        inputRecord?.id,
+        inputRecord?.entityId,
+        inputRecord?.recordId,
+        inputEntity?.id
+      );
+      const organizationId = pickFirstIdentifier(
+        metadata?.organizationId,
+        resultRecord?.organizationId,
+        resultEntity?.organizationId,
+        inputRecord?.organizationId,
+        inputEntity?.organizationId,
+        ctx.selectedOrganizationId ?? ctx.auth?.orgId ?? null
+      );
+      const tenantId = pickFirstIdentifier(
+        metadata?.tenantId,
+        resultRecord?.tenantId,
+        resultEntity?.tenantId,
+        inputRecord?.tenantId,
+        inputEntity?.tenantId,
+        ctx.auth?.tenantId ?? null
+      );
+      const fallbackTenant = pickFirstIdentifier(metadata?.tenantId, ctx.auth?.tenantId ?? null);
+      const aliasSet = /* @__PURE__ */ new Set();
+      for (const alias of extractAliasList(metadata?.context ?? null)) {
+        aliasSet.add(alias);
+      }
+      const derived = deriveResourceFromCommandId(commandId);
+      if (derived) aliasSet.add(derived);
+      const aliasExtras = Array.from(aliasSet);
+      await invalidateCrudCache(
+        ctx.container,
+        resource,
+        { id: recordId, organizationId, tenantId },
+        fallbackTenant,
+        `command:${commandId}:execute`,
+        aliasExtras
+      );
+    } catch (err) {
+      if (isCrudCacheDebugEnabled()) {
+        try {
+          console.debug("[crud][cache] execute-invalidation failed", { commandId, err });
+        } catch {
+        }
+      }
+    }
+  }
+  async invalidateCacheAfterUndo(log, ctx) {
+    const resource = typeof log.resourceKind === "string" ? log.resourceKind : null;
+    if (!resource) return;
+    try {
+      const recordId = pickFirstIdentifier(log.resourceId);
+      const organizationId = pickFirstIdentifier(log.organizationId, ctx.selectedOrganizationId ?? ctx.auth?.orgId ?? null);
+      const tenantId = pickFirstIdentifier(log.tenantId, ctx.auth?.tenantId ?? null);
+      const fallbackTenant = pickFirstIdentifier(log.tenantId, ctx.auth?.tenantId ?? null);
+      const aliasSet = /* @__PURE__ */ new Set();
+      for (const alias of extractAliasList(log.contextJson ?? null)) {
+        aliasSet.add(alias);
+      }
+      const derived = deriveResourceFromCommandId(log.commandId);
+      if (derived) aliasSet.add(derived);
+      const aliasExtras = Array.from(aliasSet);
+      await invalidateCrudCache(
+        ctx.container,
+        resource,
+        { id: recordId, organizationId, tenantId },
+        fallbackTenant,
+        `command:${log.commandId}:undo`,
+        aliasExtras
+      );
+    } catch (err) {
+      if (isCrudCacheDebugEnabled()) {
+        try {
+          console.debug("[crud][cache] undo-invalidation failed", { commandId: log.commandId, err });
+        } catch {
+        }
+      }
+    }
+  }
+  async flushCrudSideEffects(container) {
+    try {
+      const dataEngine = container.resolve("dataEngine");
+      await dataEngine.flushOrmEntityChanges();
+    } catch {
+    }
+  }
+}
+function wrapRedoPayload(existing, input) {
+  if (!existing || typeof existing !== "object" || Array.isArray(existing)) {
+    const envelope = { __redoInput: input };
+    if (existing !== void 0) envelope.value = existing;
+    return envelope;
+  }
+  const current = existing;
+  if ("__redoInput" in current && current.__redoInput !== void 0) {
+    return current;
+  }
+  return { __redoInput: input, ...current };
+}
+export {
+  CommandBus
+};
+//# sourceMappingURL=command-bus.js.map

package/dist/lib/commands/command-bus.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/commands/command-bus.ts"],
+  "sourcesContent": ["import type { ActionLog } from '@open-mercato/core/modules/audit_logs/data/entities'\nimport type { ActionLogCreateInput } from '@open-mercato/core/modules/audit_logs/data/validators'\nimport { commandRegistry } from './registry'\nimport type {\n  CommandExecutionOptions,\n  CommandExecuteResult,\n  CommandHandler,\n  CommandLogBuilderArgs,\n  CommandLogMetadata,\n  CommandRuntimeContext,\n} from './types'\nimport { defaultUndoToken } from './types'\nimport type { ActionLogService } from '@open-mercato/core/modules/audit_logs/services/actionLogService'\nimport type { AwilixContainer } from 'awilix'\nimport type { DataEngine } from '@open-mercato/shared/lib/data/engine'\nimport {\n  canonicalizeResourceTag,\n  deriveResourceFromCommandId,\n  invalidateCrudCache,\n  pickFirstIdentifier,\n  isCrudCacheDebugEnabled,\n} from '@open-mercato/shared/lib/crud/cache'\n\nconst SKIPPED_ACTION_LOG_RESOURCE_KINDS = new Set<string>([\n  'audit_logs.access',\n  'audit_logs.action',\n  'dashboards.layout',\n  'dashboards.user_widgets',\n  'dashboards.role_widgets',\n])\n\nfunction asRecord(input: unknown): Record<string, unknown> | null {\n  if (!input || typeof input !== 'object' || Array.isArray(input)) return null\n  return input as Record<string, unknown>\n}\n\nfunction extractAliasList(source: unknown): string[] {\n  if (!source || typeof source !== 'object' || Array.isArray(source)) return []\n  const record = source as Record<string, unknown>\n  const raw = record.cacheAliases\n  if (!Array.isArray(raw)) return []\n  const aliases = new Set<string>()\n  for (const value of raw) {\n    if (typeof value !== 'string') continue\n    const normalized = canonicalizeResourceTag(value)\n    if (normalized) aliases.add(normalized)\n  }\n  return Array.from(aliases)\n}\n\nexport class CommandBus {\n  async execute<TInput = unknown, TResult = unknown>(\n    commandId: string,\n    options: CommandExecutionOptions<TInput>\n  ): Promise<CommandExecuteResult<TResult>> {\n    const handler = this.resolveHandler<TInput, TResult>(commandId)\n    const snapshots = await this.prepareSnapshots(handler, options)\n    const result = await handler.execute(options.input, options.ctx)\n    const afterSnapshot = await this.captureAfter(handler, options, result)\n    const snapshotsWithAfter = { ...snapshots, after: afterSnapshot }\n    const logMeta = await this.buildLog(handler, options, result, snapshotsWithAfter)\n    let mergedMeta = this.mergeMetadata(options.metadata, logMeta)\n    const undoable = this.isUndoable(handler)\n    if (undoable) {\n      mergedMeta = mergedMeta ?? {}\n      if (!mergedMeta.undoToken) mergedMeta.undoToken = defaultUndoToken()\n      if (mergedMeta.actorUserId === undefined) mergedMeta.actorUserId = options.ctx.auth?.sub ?? null\n    }\n    if (afterSnapshot !== undefined && afterSnapshot !== null) {\n      if (!mergedMeta) {\n        mergedMeta = { snapshotAfter: afterSnapshot }\n      } else if (!mergedMeta.snapshotAfter) {\n        mergedMeta.snapshotAfter = afterSnapshot\n      }\n    }\n    if (snapshots.before) {\n      if (!mergedMeta) {\n        mergedMeta = { snapshotBefore: snapshots.before }\n      } else if (!mergedMeta.snapshotBefore) {\n        mergedMeta.snapshotBefore = snapshots.before\n      }\n    }\n    const logEntry = await this.persistLog(commandId, options, mergedMeta)\n    await this.invalidateCacheAfterExecute(commandId, options, result, mergedMeta)\n    await this.flushCrudSideEffects(options.ctx.container)\n    return { result, logEntry }\n  }\n\n  async undo(undoToken: string, ctx: CommandRuntimeContext): Promise<void> {\n    const service = (ctx.container.resolve('actionLogService') as ActionLogService)\n    const log = await service.findByUndoToken(undoToken)\n    if (!log) throw new Error('Undo token expired or not found')\n    const handler = this.resolveHandler(log.commandId)\n    if (!handler.undo || this.isUndoable(handler) === false) {\n      throw new Error(`Command ${log.commandId} is not undoable`)\n    }\n    await handler.undo({\n      input: log.commandPayload as Parameters<NonNullable<typeof handler.undo>>[0]['input'],\n      ctx,\n      logEntry: log,\n    })\n    await service.markUndone(log.id)\n    await this.invalidateCacheAfterUndo(log, ctx)\n    await this.flushCrudSideEffects(ctx.container)\n  }\n\n  private resolveHandler<TInput, TResult>(commandId: string): CommandHandler<TInput, TResult> {\n    const handler = commandRegistry.get<TInput, TResult>(commandId)\n    if (!handler) throw new Error(`Command handler not registered for id ${commandId}`)\n    return handler\n  }\n\n  private async prepareSnapshots<TInput, TResult>(\n    handler: CommandHandler<TInput, TResult>,\n    options: CommandExecutionOptions<TInput>\n  ): Promise<{ before?: unknown }> {\n    if (!handler.prepare) return {}\n    try {\n      return (await handler.prepare(options.input, options.ctx)) || {}\n    } catch (err) {\n      throw err\n    }\n  }\n\n  private async captureAfter<TInput, TResult>(\n    handler: CommandHandler<TInput, TResult>,\n    options: CommandExecutionOptions<TInput>,\n    result: TResult\n  ): Promise<unknown> {\n    if (!handler.captureAfter) return undefined\n    return handler.captureAfter(options.input, result, options.ctx)\n  }\n\n  private async buildLog<TInput, TResult>(\n    handler: CommandHandler<TInput, TResult>,\n    options: CommandExecutionOptions<TInput>,\n    result: TResult,\n    snapshots: { before?: unknown; after?: unknown }\n  ): Promise<CommandLogMetadata | null> {\n    if (!handler.buildLog) return null\n    const args: CommandLogBuilderArgs<TInput, TResult> = {\n      input: options.input,\n      result,\n      ctx: options.ctx,\n      snapshots,\n    }\n    return (await handler.buildLog(args)) || null\n  }\n\n  private mergeMetadata(primary?: CommandLogMetadata | null, secondary?: CommandLogMetadata | null): CommandLogMetadata | null {\n    if (!primary && !secondary) return null\n    return {\n      tenantId: primary?.tenantId ?? secondary?.tenantId ?? null,\n      organizationId: primary?.organizationId ?? secondary?.organizationId ?? null,\n      actorUserId: primary?.actorUserId ?? secondary?.actorUserId ?? null,\n      actionLabel: primary?.actionLabel ?? secondary?.actionLabel ?? null,\n      resourceKind: primary?.resourceKind ?? secondary?.resourceKind ?? null,\n      resourceId: primary?.resourceId ?? secondary?.resourceId ?? null,\n      undoToken: primary?.undoToken ?? secondary?.undoToken ?? null,\n      payload: primary?.payload ?? secondary?.payload ?? null,\n      snapshotBefore: primary?.snapshotBefore ?? secondary?.snapshotBefore ?? null,\n      snapshotAfter: primary?.snapshotAfter ?? secondary?.snapshotAfter ?? null,\n      changes: primary?.changes ?? secondary?.changes ?? null,\n      context: primary?.context ?? secondary?.context ?? null,\n    }\n  }\n\n  private async persistLog<TInput>(\n    commandId: string,\n    options: CommandExecutionOptions<TInput>,\n    metadata: CommandLogMetadata | null\n  ): Promise<ActionLog | null> {\n    if (!metadata) return null\n    const resourceKind =\n      typeof metadata.resourceKind === 'string' ? metadata.resourceKind : null\n    if (resourceKind && SKIPPED_ACTION_LOG_RESOURCE_KINDS.has(resourceKind)) {\n      return null\n    }\n    let service: ActionLogService | null = null\n    try {\n      service = (options.ctx.container.resolve('actionLogService') as ActionLogService)\n    } catch {\n      service = null\n    }\n    if (!service) return null\n\n    const tenantId = metadata.tenantId ?? options.ctx.auth?.tenantId ?? null\n    const organizationId =\n      metadata.organizationId ?? options.ctx.selectedOrganizationId ?? options.ctx.auth?.orgId ?? null\n    const actorUserId = metadata.actorUserId ?? options.ctx.auth?.sub ?? null\n    const payload: Record<string, unknown> = {\n      tenantId: tenantId ?? undefined,\n      organizationId: organizationId ?? undefined,\n      actorUserId: actorUserId ?? undefined,\n      commandId,\n    }\n\n    if (metadata) {\n      if ('actionLabel' in metadata && metadata.actionLabel != null) payload.actionLabel = metadata.actionLabel\n      if ('resourceKind' in metadata && metadata.resourceKind != null) payload.resourceKind = metadata.resourceKind\n      if ('resourceId' in metadata && metadata.resourceId != null) payload.resourceId = metadata.resourceId\n      if ('undoToken' in metadata && metadata.undoToken != null) payload.undoToken = metadata.undoToken\n      if ('payload' in metadata && metadata.payload !== undefined) payload.commandPayload = metadata.payload\n      if ('snapshotBefore' in metadata && metadata.snapshotBefore !== undefined) payload.snapshotBefore = metadata.snapshotBefore\n      if ('snapshotAfter' in metadata && metadata.snapshotAfter !== undefined) payload.snapshotAfter = metadata.snapshotAfter\n      if ('changes' in metadata && metadata.changes !== undefined && metadata.changes !== null) payload.changes = metadata.changes\n      if ('context' in metadata && metadata.context !== undefined && metadata.context !== null) payload.context = metadata.context\n    }\n\n    const redoEnvelope = wrapRedoPayload('commandPayload' in payload ? (payload.commandPayload as unknown) : undefined, options.input)\n    payload.commandPayload = redoEnvelope\n\n    return await service.log(payload as ActionLogCreateInput)\n  }\n\n  private isUndoable(handler: CommandHandler<unknown, unknown>): boolean {\n    return handler.isUndoable !== false && typeof handler.undo === 'function'\n  }\n\n  private async invalidateCacheAfterExecute<TResult>(\n    commandId: string,\n    options: CommandExecutionOptions<unknown>,\n    result: TResult,\n    metadata: CommandLogMetadata | null\n  ): Promise<void> {\n    const resource = typeof metadata?.resourceKind === 'string' ? metadata.resourceKind : null\n    if (!resource) return\n    try {\n      const ctx = options.ctx\n      const resultRecord = asRecord(result)\n      const resultEntity = asRecord(resultRecord?.entity)\n      const inputRecord = asRecord(options.input)\n      const inputEntity = asRecord(inputRecord?.entity)\n\n      const recordId = pickFirstIdentifier(\n        metadata?.resourceId,\n        resultRecord?.entityId,\n        resultRecord?.id,\n        resultRecord?.recordId,\n        resultEntity?.id,\n        inputRecord?.id,\n        inputRecord?.entityId,\n        inputRecord?.recordId,\n        inputEntity?.id\n      )\n\n      const organizationId = pickFirstIdentifier(\n        metadata?.organizationId,\n        resultRecord?.organizationId,\n        resultEntity?.organizationId,\n        inputRecord?.organizationId,\n        inputEntity?.organizationId,\n        ctx.selectedOrganizationId ?? ctx.auth?.orgId ?? null\n      )\n\n      const tenantId = pickFirstIdentifier(\n        metadata?.tenantId,\n        resultRecord?.tenantId,\n        resultEntity?.tenantId,\n        inputRecord?.tenantId,\n        inputEntity?.tenantId,\n        ctx.auth?.tenantId ?? null\n      )\n\n      const fallbackTenant = pickFirstIdentifier(metadata?.tenantId, ctx.auth?.tenantId ?? null)\n\n      const aliasSet = new Set<string>()\n      for (const alias of extractAliasList(metadata?.context ?? null)) {\n        aliasSet.add(alias)\n      }\n      const derived = deriveResourceFromCommandId(commandId)\n      if (derived) aliasSet.add(derived)\n      const aliasExtras = Array.from(aliasSet)\n      await invalidateCrudCache(\n        ctx.container,\n        resource,\n        { id: recordId, organizationId, tenantId },\n        fallbackTenant,\n        `command:${commandId}:execute`,\n        aliasExtras\n      )\n    } catch (err) {\n      if (isCrudCacheDebugEnabled()) {\n        try {\n          console.debug('[crud][cache] execute-invalidation failed', { commandId, err })\n        } catch {}\n      }\n    }\n  }\n\n  private async invalidateCacheAfterUndo(log: ActionLog, ctx: CommandRuntimeContext): Promise<void> {\n    const resource = typeof log.resourceKind === 'string' ? log.resourceKind : null\n    if (!resource) return\n    try {\n      const recordId = pickFirstIdentifier(log.resourceId)\n      const organizationId = pickFirstIdentifier(log.organizationId, ctx.selectedOrganizationId ?? ctx.auth?.orgId ?? null)\n      const tenantId = pickFirstIdentifier(log.tenantId, ctx.auth?.tenantId ?? null)\n      const fallbackTenant = pickFirstIdentifier(log.tenantId, ctx.auth?.tenantId ?? null)\n      const aliasSet = new Set<string>()\n      for (const alias of extractAliasList(log.contextJson ?? null)) {\n        aliasSet.add(alias)\n      }\n      const derived = deriveResourceFromCommandId(log.commandId)\n      if (derived) aliasSet.add(derived)\n      const aliasExtras = Array.from(aliasSet)\n      await invalidateCrudCache(\n        ctx.container,\n        resource,\n        { id: recordId, organizationId, tenantId },\n        fallbackTenant,\n        `command:${log.commandId}:undo`,\n        aliasExtras\n      )\n    } catch (err) {\n      if (isCrudCacheDebugEnabled()) {\n        try {\n          console.debug('[crud][cache] undo-invalidation failed', { commandId: log.commandId, err })\n        } catch {}\n      }\n    }\n  }\n\n  private async flushCrudSideEffects(container: AwilixContainer): Promise<void> {\n    try {\n      const dataEngine = (container.resolve('dataEngine') as DataEngine)\n      await dataEngine.flushOrmEntityChanges()\n    } catch {\n      // best-effort: failures should not block command execution\n    }\n  }\n}\n\ntype RedoEnvelope = {\n  __redoInput: unknown\n  [key: string]: unknown\n}\n\nfunction wrapRedoPayload(existing: unknown, input: unknown): RedoEnvelope {\n  if (!existing || typeof existing !== 'object' || Array.isArray(existing)) {\n    const envelope: RedoEnvelope = { __redoInput: input }\n    if (existing !== undefined) envelope.value = existing\n    return envelope\n  }\n  const current = existing as Record<string, unknown>\n  if ('__redoInput' in current && current.__redoInput !== undefined) {\n    return current as RedoEnvelope\n  }\n  return { __redoInput: input, ...current }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/lib/commands/customFieldSnapshots.js

@@ -0,0 +1,66 @@
+import { loadCustomFieldValues } from "@open-mercato/shared/lib/crud/custom-fields";
+async function loadCustomFieldSnapshot(em, { entityId, recordId, tenantId, organizationId, tenantFallbacks }) {
+  const tenant = tenantId ?? null;
+  const organization = organizationId ?? void 0;
+  const records = await loadCustomFieldValues({
+    em,
+    entityId,
+    recordIds: [recordId],
+    tenantIdByRecord: { [recordId]: tenant },
+    organizationIdByRecord: organization === void 0 ? void 0 : { [recordId]: organization ?? null },
+    tenantFallbacks: tenantFallbacks ?? [tenant]
+  });
+  const raw = records[recordId] ?? {};
+  const custom = {};
+  for (const [key, value] of Object.entries(raw)) {
+    if (key.startsWith("cf_")) custom[key.slice(3)] = value;
+  }
+  return custom;
+}
+function buildCustomFieldResetMap(before, after) {
+  const values = {};
+  const keys = /* @__PURE__ */ new Set();
+  if (before) for (const key of Object.keys(before)) keys.add(key);
+  if (after) for (const key of Object.keys(after)) keys.add(key);
+  for (const key of keys) {
+    const hasBefore = Boolean(before && Object.prototype.hasOwnProperty.call(before, key));
+    if (hasBefore) {
+      const beforeValue = before?.[key];
+      if (beforeValue === null && Array.isArray(after?.[key])) {
+        values[key] = [];
+      } else {
+        values[key] = beforeValue;
+      }
+    } else {
+      values[key] = Array.isArray(after?.[key]) ? [] : null;
+    }
+  }
+  return values;
+}
+function diffCustomFieldChanges(before, after) {
+  const out = {};
+  const keys = /* @__PURE__ */ new Set();
+  if (before) for (const key of Object.keys(before)) keys.add(key);
+  if (after) for (const key of Object.keys(after)) keys.add(key);
+  for (const key of keys) {
+    const prev = before ? before[key] : void 0;
+    const next = after ? after[key] : void 0;
+    if (!customFieldValuesEqual(prev, next)) {
+      out[key] = { from: prev ?? null, to: next ?? null };
+    }
+  }
+  return out;
+}
+function customFieldValuesEqual(a, b) {
+  if (Array.isArray(a) && Array.isArray(b)) {
+    if (a.length !== b.length) return false;
+    return a.every((value, idx) => customFieldValuesEqual(value, b[idx]));
+  }
+  return a === b;
+}
+export {
+  buildCustomFieldResetMap,
+  diffCustomFieldChanges,
+  loadCustomFieldSnapshot
+};
+//# sourceMappingURL=customFieldSnapshots.js.map

package/dist/lib/commands/customFieldSnapshots.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/commands/customFieldSnapshots.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport { loadCustomFieldValues } from '@open-mercato/shared/lib/crud/custom-fields'\n\nexport type CustomFieldSnapshot = Record<string, unknown>\n\ntype LoadSnapshotOptions = {\n  entityId: string\n  recordId: string\n  tenantId?: string | null\n  organizationId?: string | null\n  tenantFallbacks?: Array<string | null | undefined>\n}\n\nexport async function loadCustomFieldSnapshot(\n  em: EntityManager,\n  { entityId, recordId, tenantId, organizationId, tenantFallbacks }: LoadSnapshotOptions\n): Promise<CustomFieldSnapshot> {\n  const tenant = tenantId ?? null\n  const organization = organizationId ?? undefined\n  const records = await loadCustomFieldValues({\n    em,\n    entityId: entityId as any,\n    recordIds: [recordId],\n    tenantIdByRecord: { [recordId]: tenant },\n    organizationIdByRecord: organization === undefined ? undefined : { [recordId]: organization ?? null },\n    tenantFallbacks: tenantFallbacks ?? [tenant],\n  })\n  const raw = records[recordId] ?? {}\n  const custom: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(raw)) {\n    if (key.startsWith('cf_')) custom[key.slice(3)] = value\n  }\n  return custom\n}\n\nexport function buildCustomFieldResetMap(\n  before: CustomFieldSnapshot | undefined,\n  after: CustomFieldSnapshot | undefined\n): Record<string, unknown> {\n  const values: Record<string, unknown> = {}\n  const keys = new Set<string>()\n  if (before) for (const key of Object.keys(before)) keys.add(key)\n  if (after) for (const key of Object.keys(after)) keys.add(key)\n  for (const key of keys) {\n    const hasBefore = Boolean(before && Object.prototype.hasOwnProperty.call(before, key))\n    if (hasBefore) {\n      const beforeValue = before?.[key]\n      if (beforeValue === null && Array.isArray(after?.[key])) {\n        values[key] = []\n      } else {\n        values[key] = beforeValue\n      }\n    } else {\n      values[key] = Array.isArray(after?.[key]) ? [] : null\n    }\n  }\n  return values\n}\n\nexport type CustomFieldChangeSet = Record<string, { from: unknown; to: unknown }>\n\nexport function diffCustomFieldChanges(\n  before: CustomFieldSnapshot | undefined,\n  after: CustomFieldSnapshot | undefined\n): CustomFieldChangeSet {\n  const out: CustomFieldChangeSet = {}\n  const keys = new Set<string>()\n  if (before) for (const key of Object.keys(before)) keys.add(key)\n  if (after) for (const key of Object.keys(after)) keys.add(key)\n  for (const key of keys) {\n    const prev = before ? before[key] : undefined\n    const next = after ? after[key] : undefined\n    if (!customFieldValuesEqual(prev, next)) {\n      out[key] = { from: prev ?? null, to: next ?? null }\n    }\n  }\n  return out\n}\n\nfunction customFieldValuesEqual(a: unknown, b: unknown): boolean {\n  if (Array.isArray(a) && Array.isArray(b)) {\n    if (a.length !== b.length) return false\n    return a.every((value, idx) => customFieldValuesEqual(value, b[idx]))\n  }\n  return a === b\n}\n"],
+  "mappings": "AACA,SAAS,6BAA6B;AAYtC,eAAsB,wBACpB,IACA,EAAE,UAAU,UAAU,UAAU,gBAAgB,gBAAgB,GAClC;AAC9B,QAAM,SAAS,YAAY;AAC3B,QAAM,eAAe,kBAAkB;AACvC,QAAM,UAAU,MAAM,sBAAsB;AAAA,IAC1C;AAAA,IACA;AAAA,IACA,WAAW,CAAC,QAAQ;AAAA,IACpB,kBAAkB,EAAE,CAAC,QAAQ,GAAG,OAAO;AAAA,IACvC,wBAAwB,iBAAiB,SAAY,SAAY,EAAE,CAAC,QAAQ,GAAG,gBAAgB,KAAK;AAAA,IACpG,iBAAiB,mBAAmB,CAAC,MAAM;AAAA,EAC7C,CAAC;AACD,QAAM,MAAM,QAAQ,QAAQ,KAAK,CAAC;AAClC,QAAM,SAAkC,CAAC;AACzC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,GAAG,GAAG;AAC9C,QAAI,IAAI,WAAW,KAAK,EAAG,QAAO,IAAI,MAAM,CAAC,CAAC,IAAI;AAAA,EACpD;AACA,SAAO;AACT;AAEO,SAAS,yBACd,QACA,OACyB;AACzB,QAAM,SAAkC,CAAC;AACzC,QAAM,OAAO,oBAAI,IAAY;AAC7B,MAAI,OAAQ,YAAW,OAAO,OAAO,KAAK,MAAM,EAAG,MAAK,IAAI,GAAG;AAC/D,MAAI,MAAO,YAAW,OAAO,OAAO,KAAK,KAAK,EAAG,MAAK,IAAI,GAAG;AAC7D,aAAW,OAAO,MAAM;AACtB,UAAM,YAAY,QAAQ,UAAU,OAAO,UAAU,eAAe,KAAK,QAAQ,GAAG,CAAC;AACrF,QAAI,WAAW;AACb,YAAM,cAAc,SAAS,GAAG;AAChC,UAAI,gBAAgB,QAAQ,MAAM,QAAQ,QAAQ,GAAG,CAAC,GAAG;AACvD,eAAO,GAAG,IAAI,CAAC;AAAA,MACjB,OAAO;AACL,eAAO,GAAG,IAAI;AAAA,MAChB;AAAA,IACF,OAAO;AACL,aAAO,GAAG,IAAI,MAAM,QAAQ,QAAQ,GAAG,CAAC,IAAI,CAAC,IAAI;AAAA,IACnD;AAAA,EACF;AACA,SAAO;AACT;AAIO,SAAS,uBACd,QACA,OACsB;AACtB,QAAM,MAA4B,CAAC;AACnC,QAAM,OAAO,oBAAI,IAAY;AAC7B,MAAI,OAAQ,YAAW,OAAO,OAAO,KAAK,MAAM,EAAG,MAAK,IAAI,GAAG;AAC/D,MAAI,MAAO,YAAW,OAAO,OAAO,KAAK,KAAK,EAAG,MAAK,IAAI,GAAG;AAC7D,aAAW,OAAO,MAAM;AACtB,UAAM,OAAO,SAAS,OAAO,GAAG,IAAI;AACpC,UAAM,OAAO,QAAQ,MAAM,GAAG,IAAI;AAClC,QAAI,CAAC,uBAAuB,MAAM,IAAI,GAAG;AACvC,UAAI,GAAG,IAAI,EAAE,MAAM,QAAQ,MAAM,IAAI,QAAQ,KAAK;AAAA,IACpD;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,uBAAuB,GAAY,GAAqB;AAC/D,MAAI,MAAM,QAAQ,CAAC,KAAK,MAAM,QAAQ,CAAC,GAAG;AACxC,QAAI,EAAE,WAAW,EAAE,OAAQ,QAAO;AAClC,WAAO,EAAE,MAAM,CAAC,OAAO,QAAQ,uBAAuB,OAAO,EAAE,GAAG,CAAC,CAAC;AAAA,EACtE;AACA,SAAO,MAAM;AACf;",
+  "names": []
+}

package/dist/lib/commands/helpers.js

@@ -0,0 +1,98 @@
+import { splitCustomFieldPayload } from "@open-mercato/shared/lib/crud/custom-fields";
+import { CrudHttpError } from "@open-mercato/shared/lib/crud/errors";
+import { normalizeCustomFieldValues } from "../custom-fields/normalize.js";
+import { normalizeCustomFieldValues as normalizeCustomFieldValues2 } from "../custom-fields/normalize.js";
+function parseWithCustomFields(schema, raw) {
+  const { base, custom } = splitCustomFieldPayload(raw);
+  const parsed = schema.parse(base);
+  return { parsed, custom };
+}
+async function setCustomFieldsIfAny(opts) {
+  const { values } = opts;
+  if (!values || !Object.keys(values).length) return;
+  const { dataEngine, entityId, recordId, tenantId, organizationId, notify = false } = opts;
+  const normalized = normalizeCustomFieldValues(values);
+  await dataEngine.setCustomFields({
+    entityId,
+    recordId,
+    tenantId,
+    organizationId,
+    values: normalized,
+    notify
+  });
+}
+async function emitCrudSideEffects(opts) {
+  const { dataEngine, action, entity, identifiers, events, indexer } = opts;
+  dataEngine.markOrmEntityChange({
+    action,
+    entity,
+    identifiers,
+    events,
+    indexer
+  });
+}
+async function emitCrudUndoSideEffects(opts) {
+  const { dataEngine, action, entity, identifiers, events, indexer } = opts;
+  if (!entity) return;
+  dataEngine.markOrmEntityChange({
+    action,
+    entity,
+    identifiers,
+    events,
+    indexer
+  });
+}
+async function flushCrudSideEffects(dataEngine) {
+  await dataEngine.flushOrmEntityChanges();
+}
+function buildChanges(before, after, keys) {
+  if (!before) return {};
+  const diff = {};
+  for (const key of keys) {
+    const prev = before[key];
+    const next = after[key];
+    if (prev !== next) diff[key] = { from: prev, to: next };
+  }
+  return diff;
+}
+function requireTenantScope(authTenantId, requested) {
+  if (authTenantId && requested && requested !== authTenantId) {
+    throw new CrudHttpError(403, { error: "Forbidden" });
+  }
+  const tenantId = requested || authTenantId;
+  if (!tenantId) throw new CrudHttpError(400, { error: "Tenant scope required" });
+  return tenantId;
+}
+function requireId(value, message = "ID is required") {
+  if (typeof value === "string" && value.trim()) return value;
+  if (typeof value === "number" || typeof value === "bigint") return String(value);
+  if (value && typeof value === "object") {
+    const source = value;
+    const candidates = [
+      source.id,
+      source.recordId,
+      isRecord(source.body) ? source.body.id : void 0,
+      isRecord(source.query) ? source.query.id : void 0
+    ];
+    for (const candidate of candidates) {
+      if (typeof candidate === "string" && candidate.trim()) return candidate;
+      if (typeof candidate === "number" || typeof candidate === "bigint") return String(candidate);
+    }
+  }
+  throw new CrudHttpError(400, { error: message });
+}
+function isRecord(input) {
+  return !!input && typeof input === "object";
+}
+export {
+  buildChanges,
+  emitCrudSideEffects,
+  emitCrudUndoSideEffects,
+  flushCrudSideEffects,
+  normalizeCustomFieldValues2 as normalizeCustomFieldValues,
+  parseWithCustomFields,
+  requireId,
+  requireTenantScope,
+  setCustomFieldsIfAny
+};
+//# sourceMappingURL=helpers.js.map

package/dist/lib/commands/helpers.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/commands/helpers.ts"],
+  "sourcesContent": ["import { splitCustomFieldPayload } from '@open-mercato/shared/lib/crud/custom-fields'\nimport type { z } from 'zod'\nimport { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'\nimport type { DataEngine } from '@open-mercato/shared/lib/data/engine'\nimport { normalizeCustomFieldValues } from '../custom-fields/normalize'\nexport { normalizeCustomFieldValues } from '../custom-fields/normalize'\nimport type { CrudEventsConfig, CrudIndexerConfig, CrudEmitContext } from '@open-mercato/shared/lib/crud/types'\nimport type { CommandRuntimeContext } from '@open-mercato/shared/lib/commands'\nimport type { CommandLogMetadata } from '@open-mercato/shared/lib/commands'\n\nexport type ParsedPayload<TSchema extends z.ZodTypeAny> = {\n  parsed: z.infer<TSchema>\n  custom: Record<string, unknown>\n}\n\nexport function parseWithCustomFields<TSchema extends z.ZodTypeAny>(\n  schema: TSchema,\n  raw: unknown\n): ParsedPayload<TSchema> {\n  const { base, custom } = splitCustomFieldPayload(raw)\n  const parsed = schema.parse(base)\n  return { parsed, custom }\n}\n\nexport async function setCustomFieldsIfAny(opts: {\n  dataEngine: DataEngine\n  entityId: string\n  recordId: string\n  tenantId: string | null\n  organizationId: string | null\n  values: Record<string, unknown>\n  notify?: boolean\n}) {\n  const { values } = opts\n  if (!values || !Object.keys(values).length) return\n  const { dataEngine, entityId, recordId, tenantId, organizationId, notify = false } = opts\n  const normalized = normalizeCustomFieldValues(values)\n  await dataEngine.setCustomFields({\n    entityId,\n    recordId,\n    tenantId,\n    organizationId,\n    values: normalized,\n    notify,\n  })\n}\n\nexport async function emitCrudSideEffects<TEntity>(opts: {\n  dataEngine: DataEngine\n  action: 'created' | 'updated' | 'deleted'\n  entity: TEntity\n  identifiers: CrudEmitContext<TEntity>['identifiers']\n  events?: CrudEventsConfig<TEntity>\n  indexer?: CrudIndexerConfig<TEntity>\n}) {\n  const { dataEngine, action, entity, identifiers, events, indexer } = opts\n  dataEngine.markOrmEntityChange({\n    action,\n    entity,\n    identifiers,\n    events,\n    indexer,\n  })\n}\n\nexport async function emitCrudUndoSideEffects<TEntity>(opts: {\n  dataEngine: DataEngine\n  action: 'created' | 'updated' | 'deleted'\n  entity: TEntity | null | undefined\n  identifiers: CrudEmitContext<TEntity>['identifiers']\n  events?: CrudEventsConfig<TEntity>\n  indexer?: CrudIndexerConfig<TEntity>\n}) {\n  const { dataEngine, action, entity, identifiers, events, indexer } = opts\n  if (!entity) return\n  dataEngine.markOrmEntityChange({\n    action,\n    entity,\n    identifiers,\n    events,\n    indexer,\n  })\n}\n\nexport async function flushCrudSideEffects(dataEngine: DataEngine): Promise<void> {\n  await dataEngine.flushOrmEntityChanges()\n}\n\nexport function buildChanges(\n  before: Record<string, unknown> | null | undefined,\n  after: Record<string, unknown>,\n  keys: readonly string[]\n): Record<string, { from: unknown; to: unknown }> {\n  if (!before) return {}\n  const diff: Record<string, { from: unknown; to: unknown }> = {}\n  for (const key of keys) {\n    const prev = before[key]\n    const next = after[key]\n    if (prev !== next) diff[key] = { from: prev, to: next }\n  }\n  return diff\n}\n\nexport function requireTenantScope(authTenantId: string | null, requested?: string | null): string {\n  if (authTenantId && requested && requested !== authTenantId) {\n    throw new CrudHttpError(403, { error: 'Forbidden' })\n  }\n  const tenantId = requested || authTenantId\n  if (!tenantId) throw new CrudHttpError(400, { error: 'Tenant scope required' })\n  return tenantId\n}\n\nexport function requireId(value: unknown, message = 'ID is required'): string {\n  if (typeof value === 'string' && value.trim()) return value\n  if (typeof value === 'number' || typeof value === 'bigint') return String(value)\n  if (value && typeof value === 'object') {\n    const source = value as Record<string, unknown>\n    const candidates: unknown[] = [\n      source.id,\n      source.recordId,\n      isRecord(source.body) ? source.body.id : undefined,\n      isRecord(source.query) ? source.query.id : undefined,\n    ]\n    for (const candidate of candidates) {\n      if (typeof candidate === 'string' && candidate.trim()) return candidate\n      if (typeof candidate === 'number' || typeof candidate === 'bigint') return String(candidate)\n    }\n  }\n  throw new CrudHttpError(400, { error: message })\n}\n\nfunction isRecord(input: unknown): input is { [key: string]: unknown } {\n  return !!input && typeof input === 'object'\n}\n\nexport type LogBuilderArgs<TInput, TResult> = {\n  input: TInput\n  result: TResult\n  ctx: CommandRuntimeContext\n  snapshots: { before?: unknown; after?: unknown }\n}\n\nexport type LogBuilder<TInput, TResult> = (args: LogBuilderArgs<TInput, TResult>) => CommandLogMetadata | null | Promise<CommandLogMetadata | null>\n"],
+  "mappings": "AAAA,SAAS,+BAA+B;AAExC,SAAS,qBAAqB;AAE9B,SAAS,kCAAkC;AAC3C,SAAS,8BAAAA,mCAAkC;AAUpC,SAAS,sBACd,QACA,KACwB;AACxB,QAAM,EAAE,MAAM,OAAO,IAAI,wBAAwB,GAAG;AACpD,QAAM,SAAS,OAAO,MAAM,IAAI;AAChC,SAAO,EAAE,QAAQ,OAAO;AAC1B;AAEA,eAAsB,qBAAqB,MAQxC;AACD,QAAM,EAAE,OAAO,IAAI;AACnB,MAAI,CAAC,UAAU,CAAC,OAAO,KAAK,MAAM,EAAE,OAAQ;AAC5C,QAAM,EAAE,YAAY,UAAU,UAAU,UAAU,gBAAgB,SAAS,MAAM,IAAI;AACrF,QAAM,aAAa,2BAA2B,MAAM;AACpD,QAAM,WAAW,gBAAgB;AAAA,IAC/B;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,IACR;AAAA,EACF,CAAC;AACH;AAEA,eAAsB,oBAA6B,MAOhD;AACD,QAAM,EAAE,YAAY,QAAQ,QAAQ,aAAa,QAAQ,QAAQ,IAAI;AACrE,aAAW,oBAAoB;AAAA,IAC7B;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACH;AAEA,eAAsB,wBAAiC,MAOpD;AACD,QAAM,EAAE,YAAY,QAAQ,QAAQ,aAAa,QAAQ,QAAQ,IAAI;AACrE,MAAI,CAAC,OAAQ;AACb,aAAW,oBAAoB;AAAA,IAC7B;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACH;AAEA,eAAsB,qBAAqB,YAAuC;AAChF,QAAM,WAAW,sBAAsB;AACzC;AAEO,SAAS,aACd,QACA,OACA,MACgD;AAChD,MAAI,CAAC,OAAQ,QAAO,CAAC;AACrB,QAAM,OAAuD,CAAC;AAC9D,aAAW,OAAO,MAAM;AACtB,UAAM,OAAO,OAAO,GAAG;AACvB,UAAM,OAAO,MAAM,GAAG;AACtB,QAAI,SAAS,KAAM,MAAK,GAAG,IAAI,EAAE,MAAM,MAAM,IAAI,KAAK;AAAA,EACxD;AACA,SAAO;AACT;AAEO,SAAS,mBAAmB,cAA6B,WAAmC;AACjG,MAAI,gBAAgB,aAAa,cAAc,cAAc;AAC3D,UAAM,IAAI,cAAc,KAAK,EAAE,OAAO,YAAY,CAAC;AAAA,EACrD;AACA,QAAM,WAAW,aAAa;AAC9B,MAAI,CAAC,SAAU,OAAM,IAAI,cAAc,KAAK,EAAE,OAAO,wBAAwB,CAAC;AAC9E,SAAO;AACT;AAEO,SAAS,UAAU,OAAgB,UAAU,kBAA0B;AAC5E,MAAI,OAAO,UAAU,YAAY,MAAM,KAAK,EAAG,QAAO;AACtD,MAAI,OAAO,UAAU,YAAY,OAAO,UAAU,SAAU,QAAO,OAAO,KAAK;AAC/E,MAAI,SAAS,OAAO,UAAU,UAAU;AACtC,UAAM,SAAS;AACf,UAAM,aAAwB;AAAA,MAC5B,OAAO;AAAA,MACP,OAAO;AAAA,MACP,SAAS,OAAO,IAAI,IAAI,OAAO,KAAK,KAAK;AAAA,MACzC,SAAS,OAAO,KAAK,IAAI,OAAO,MAAM,KAAK;AAAA,IAC7C;AACA,eAAW,aAAa,YAAY;AAClC,UAAI,OAAO,cAAc,YAAY,UAAU,KAAK,EAAG,QAAO;AAC9D,UAAI,OAAO,cAAc,YAAY,OAAO,cAAc,SAAU,QAAO,OAAO,SAAS;AAAA,IAC7F;AAAA,EACF;AACA,QAAM,IAAI,cAAc,KAAK,EAAE,OAAO,QAAQ,CAAC;AACjD;AAEA,SAAS,SAAS,OAAqD;AACrE,SAAO,CAAC,CAAC,SAAS,OAAO,UAAU;AACrC;",
+  "names": ["normalizeCustomFieldValues"]
+}

package/dist/lib/commands/index.js

@@ -0,0 +1,8 @@
+export * from "./types.js";
+export * from "./registry.js";
+import { CommandBus } from "./command-bus.js";
+export * from "./customFieldSnapshots.js";
+export {
+  CommandBus
+};
+//# sourceMappingURL=index.js.map

package/dist/lib/commands/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/commands/index.ts"],
+  "sourcesContent": ["export * from './types'\nexport * from './registry'\nexport { CommandBus } from './command-bus'\nexport * from './customFieldSnapshots'\n"],
+  "mappings": "AAAA,cAAc;AACd,cAAc;AACd,SAAS,kBAAkB;AAC3B,cAAc;",
+  "names": []
+}

package/dist/lib/commands/operationMetadata.js

@@ -0,0 +1,32 @@
+const HEADER_PREFIX = "omop:";
+function serializeOperationMetadata(payload) {
+  const encoded = encodeURIComponent(JSON.stringify(payload));
+  return `${HEADER_PREFIX}${encoded}`;
+}
+function deserializeOperationMetadata(value) {
+  if (!value || typeof value !== "string") return null;
+  const trimmed = value.startsWith(HEADER_PREFIX) ? value.slice(HEADER_PREFIX.length) : value;
+  try {
+    const parsed = JSON.parse(decodeURIComponent(trimmed));
+    if (!parsed || typeof parsed !== "object") return null;
+    if (typeof parsed.id !== "string" || typeof parsed.commandId !== "string") return null;
+    if (typeof parsed.undoToken !== "string" || !parsed.undoToken) return null;
+    if (typeof parsed.executedAt !== "string") return null;
+    return {
+      id: parsed.id,
+      undoToken: parsed.undoToken,
+      commandId: parsed.commandId,
+      actionLabel: parsed.actionLabel ?? null,
+      resourceKind: parsed.resourceKind ?? null,
+      resourceId: parsed.resourceId ?? null,
+      executedAt: parsed.executedAt
+    };
+  } catch {
+    return null;
+  }
+}
+export {
+  deserializeOperationMetadata,
+  serializeOperationMetadata
+};
+//# sourceMappingURL=operationMetadata.js.map

package/dist/lib/commands/operationMetadata.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/commands/operationMetadata.ts"],
+  "sourcesContent": ["export type OperationMetadataPayload = {\n  id: string\n  undoToken: string\n  commandId: string\n  actionLabel: string | null\n  resourceKind: string | null\n  resourceId: string | null\n  executedAt: string\n}\n\nconst HEADER_PREFIX = 'omop:'\n\nexport function serializeOperationMetadata(payload: OperationMetadataPayload): string {\n  const encoded = encodeURIComponent(JSON.stringify(payload))\n  return `${HEADER_PREFIX}${encoded}`\n}\n\nexport function deserializeOperationMetadata(value: string | null | undefined): OperationMetadataPayload | null {\n  if (!value || typeof value !== 'string') return null\n  const trimmed = value.startsWith(HEADER_PREFIX) ? value.slice(HEADER_PREFIX.length) : value\n  try {\n    const parsed = JSON.parse(decodeURIComponent(trimmed))\n    if (!parsed || typeof parsed !== 'object') return null\n    if (typeof parsed.id !== 'string' || typeof parsed.commandId !== 'string') return null\n    if (typeof parsed.undoToken !== 'string' || !parsed.undoToken) return null\n    if (typeof parsed.executedAt !== 'string') return null\n    return {\n      id: parsed.id,\n      undoToken: parsed.undoToken,\n      commandId: parsed.commandId,\n      actionLabel: parsed.actionLabel ?? null,\n      resourceKind: parsed.resourceKind ?? null,\n      resourceId: parsed.resourceId ?? null,\n      executedAt: parsed.executedAt,\n    }\n  } catch {\n    return null\n  }\n}\n\n"],
+  "mappings": "AAUA,MAAM,gBAAgB;AAEf,SAAS,2BAA2B,SAA2C;AACpF,QAAM,UAAU,mBAAmB,KAAK,UAAU,OAAO,CAAC;AAC1D,SAAO,GAAG,aAAa,GAAG,OAAO;AACnC;AAEO,SAAS,6BAA6B,OAAmE;AAC9G,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,UAAU,MAAM,WAAW,aAAa,IAAI,MAAM,MAAM,cAAc,MAAM,IAAI;AACtF,MAAI;AACF,UAAM,SAAS,KAAK,MAAM,mBAAmB,OAAO,CAAC;AACrD,QAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAClD,QAAI,OAAO,OAAO,OAAO,YAAY,OAAO,OAAO,cAAc,SAAU,QAAO;AAClF,QAAI,OAAO,OAAO,cAAc,YAAY,CAAC,OAAO,UAAW,QAAO;AACtE,QAAI,OAAO,OAAO,eAAe,SAAU,QAAO;AAClD,WAAO;AAAA,MACL,IAAI,OAAO;AAAA,MACX,WAAW,OAAO;AAAA,MAClB,WAAW,OAAO;AAAA,MAClB,aAAa,OAAO,eAAe;AAAA,MACnC,cAAc,OAAO,gBAAgB;AAAA,MACrC,YAAY,OAAO,cAAc;AAAA,MACjC,YAAY,OAAO;AAAA,IACrB;AAAA,EACF,QAAQ;AACN,WAAO;AAAA,EACT;AACF;",
+  "names": []
+}

package/dist/lib/commands/registry.js

@@ -0,0 +1,43 @@
+class CommandRegistry {
+  constructor() {
+    this.handlers = /* @__PURE__ */ new Map();
+  }
+  register(handler) {
+    if (!handler?.id) throw new Error("Command handler must define an id");
+    if (this.handlers.has(handler.id)) {
+      throw new Error(`Duplicate command registration for id ${handler.id}`);
+    }
+    this.handlers.set(handler.id, handler);
+  }
+  unregister(id) {
+    this.handlers.delete(id);
+  }
+  get(id) {
+    return this.handlers.get(id) ?? null;
+  }
+  has(id) {
+    return this.handlers.has(id);
+  }
+  /**
+   * List all registered command handler IDs.
+   */
+  list() {
+    return Array.from(this.handlers.keys());
+  }
+  clear() {
+    this.handlers.clear();
+  }
+}
+const commandRegistry = new CommandRegistry();
+function registerCommand(handler) {
+  commandRegistry.register(handler);
+}
+function unregisterCommand(id) {
+  commandRegistry.unregister(id);
+}
+export {
+  commandRegistry,
+  registerCommand,
+  unregisterCommand
+};
+//# sourceMappingURL=registry.js.map