npm - @open-mercato/core - Versions diffs - 0.6.6-develop.6551.1.1511bfa890 → 0.6.6 - Mend

@open-mercato/core 0.6.6-develop.6551.1.1511bfa890 → 0.6.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (304) hide show

package/dist/modules/workflows/lib/step-handler.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/workflows/lib/step-handler.ts"],
-  "sourcesContent": ["/**\n * Workflows Module - Step Handler Service\n *\n * Handles individual workflow step execution:\n * - Creating step instances when entering a step\n * - Executing step logic based on step type (START, END, AUTOMATED, USER_TASK)\n * - Completing step instances when exiting\n *\n * Functional API (no classes) following Open Mercato conventions.\n */\n\nimport { EntityManager } from '@mikro-orm/core'\nimport {\n  WorkflowInstance,\n  WorkflowBranchInstance,\n  WorkflowDefinition,\n  StepInstance,\n  UserTask,\n  WorkflowEvent,\n  type StepInstanceStatus,\n  type WorkflowStepType,\n} from '../data/entities'\nimport { parseDuration } from './duration'\nimport { logWorkflowEvent } from './event-logger'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\n\nconst logger = createLogger('workflows')\n\n// ============================================================================\n// Types and Interfaces\n// ============================================================================\n\nexport interface StepExecutionContext {\n  workflowContext: Record<string, any>\n  userId?: string\n  triggerData?: any\n}\n\nexport interface StepExecutionResult {\n  status: 'COMPLETED' | 'WAITING' | 'FAILED'\n  outputData?: any\n  nextSteps?: string[] // For parallel forks (Phase 7)\n  waitReason?: 'USER_TASK' | 'SIGNAL' | 'TIMER' | 'FORK'\n  error?: string\n}\n\nexport class StepExecutionError extends Error {\n  constructor(\n    message: string,\n    public code: string,\n    public details?: any\n  ) {\n    super(message)\n    this.name = 'StepExecutionError'\n  }\n}\n\n// ============================================================================\n// Main Step Execution Functions\n// ============================================================================\n\n/**\n * Enter a workflow step - create step instance and mark as ACTIVE\n *\n * @param em - Entity manager\n * @param instance - Workflow instance\n * @param stepId - Step ID to enter\n * @param context - Execution context\n * @returns Created step instance\n */\nexport async function enterStep(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepId: string,\n  context: StepExecutionContext,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepInstance> {\n  // Load workflow definition to get step details\n  const definition = await em.findOne(WorkflowDefinition, {\n    id: instance.definitionId,\n  })\n\n  if (!definition) {\n    throw new StepExecutionError(\n      `Workflow definition not found: ${instance.definitionId}`,\n      'DEFINITION_NOT_FOUND',\n      { definitionId: instance.definitionId }\n    )\n  }\n\n  // Find step in definition\n  const stepDef = definition.definition.steps.find((s: any) => s.stepId === stepId)\n  if (!stepDef) {\n    throw new StepExecutionError(\n      `Step not found in workflow definition: ${stepId}`,\n      'STEP_NOT_FOUND',\n      { workflowId: definition.workflowId, stepId }\n    )\n  }\n\n  const now = new Date()\n\n  // Create step instance\n  const stepInstance = em.create(StepInstance, {\n    workflowInstanceId: instance.id,\n    branchInstanceId: branch ? branch.id : null,\n    stepId: stepDef.stepId,\n    stepName: stepDef.stepName,\n    stepType: stepDef.stepType,\n    status: 'ACTIVE',\n    inputData: context.triggerData || null,\n    enteredAt: now,\n    retryCount: 0,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n    createdAt: now,\n    updatedAt: now,\n  })\n\n  await em.persist(stepInstance).flush()\n\n  // Log STEP_ENTERED event\n  await logStepEvent(em, {\n    workflowInstanceId: instance.id,\n    stepInstanceId: stepInstance.id,\n    ...(branch ? { branchInstanceId: branch.id } : {}),\n    eventType: 'STEP_ENTERED',\n    eventData: {\n      stepId: stepDef.stepId,\n      stepName: stepDef.stepName,\n      stepType: stepDef.stepType,\n    },\n    userId: context.userId,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n  })\n\n  return stepInstance\n}\n\n/**\n * Exit a workflow step - mark as completed and record timing\n *\n * @param em - Entity manager\n * @param stepInstance - Step instance to exit\n * @param outputData - Optional output data from step execution\n */\nexport async function exitStep(\n  em: EntityManager,\n  stepInstance: StepInstance,\n  outputData?: any\n): Promise<void> {\n  const now = new Date()\n\n  // Calculate execution time if we have enteredAt\n  let executionTimeMs: number | null = null\n  if (stepInstance.enteredAt) {\n    executionTimeMs = now.getTime() - stepInstance.enteredAt.getTime()\n  }\n\n  // Update step instance\n  stepInstance.status = 'COMPLETED'\n  stepInstance.outputData = outputData || null\n  stepInstance.exitedAt = now\n  stepInstance.executionTimeMs = executionTimeMs\n  stepInstance.updatedAt = now\n\n  await em.flush()\n\n  // Log STEP_EXITED event\n  await logStepEvent(em, {\n    workflowInstanceId: stepInstance.workflowInstanceId,\n    stepInstanceId: stepInstance.id,\n    eventType: 'STEP_EXITED',\n    eventData: {\n      stepId: stepInstance.stepId,\n      status: 'COMPLETED',\n      executionTimeMs,\n      hasOutput: !!outputData,\n    },\n    tenantId: stepInstance.tenantId,\n    organizationId: stepInstance.organizationId,\n  })\n}\n\n/**\n * Execute a workflow step based on its type\n *\n * Main entry point for step execution. Handles:\n * - START: Immediate completion\n * - END: Workflow completion\n * - AUTOMATED: Activity execution (MVP: immediate completion)\n * - USER_TASK: Create user task and wait\n * - SUB_WORKFLOW: Invoke child workflow\n *\n * @param em - Entity manager\n * @param instance - Workflow instance\n * @param stepId - Step ID to execute\n * @param context - Execution context\n * @param container - DI container (required for SUB_WORKFLOW steps)\n * @returns Execution result with status and output\n */\nexport async function executeStep(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepId: string,\n  context: StepExecutionContext,\n  container?: any,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepExecutionResult> {\n  try {\n    // Enter the step (create step instance)\n    const stepInstance = await enterStep(em, instance, stepId, context, branch)\n\n    // Load workflow definition to get step configuration\n    const definition = await em.findOne(WorkflowDefinition, {\n      id: instance.definitionId,\n    })\n\n    if (!definition) {\n      throw new StepExecutionError(\n        `Workflow definition not found: ${instance.definitionId}`,\n        'DEFINITION_NOT_FOUND',\n        { definitionId: instance.definitionId }\n      )\n    }\n\n    const stepDef = definition.definition.steps.find((s: any) => s.stepId === stepId)\n    if (!stepDef) {\n      throw new StepExecutionError(\n        `Step not found: ${stepId}`,\n        'STEP_NOT_FOUND',\n        { stepId }\n      )\n    }\n\n    // Execute based on step type\n    const result = await executeStepByType(\n      em,\n      instance,\n      stepInstance,\n      stepDef,\n      context,\n      container,\n      branch\n    )\n\n    // If step completed, exit it\n    if (result.status === 'COMPLETED') {\n      await exitStep(em, stepInstance, result.outputData)\n    }\n\n    return result\n  } catch (error) {\n    // Handle step execution errors\n    const errorMessage = error instanceof Error ? error.message : String(error)\n\n    // Try to mark step as failed if we have a step instance\n    try {\n      const failedStepInstance = await em.findOne(StepInstance, {\n        workflowInstanceId: instance.id,\n        stepId,\n        status: 'ACTIVE',\n      })\n\n      if (failedStepInstance) {\n        failedStepInstance.status = 'FAILED'\n        failedStepInstance.errorData = {\n          error: errorMessage,\n          details: error instanceof StepExecutionError ? error.details : undefined,\n        }\n        failedStepInstance.exitedAt = new Date()\n        failedStepInstance.updatedAt = new Date()\n        await em.flush()\n\n        await logStepEvent(em, {\n          workflowInstanceId: instance.id,\n          stepInstanceId: failedStepInstance.id,\n          eventType: 'STEP_FAILED',\n          eventData: { error: errorMessage },\n          tenantId: instance.tenantId,\n          organizationId: instance.organizationId,\n        })\n      }\n    } catch (updateError) {\n      // Swallow update errors to preserve original error\n      logger.error('Failed to update step instance with error', { err: updateError })\n    }\n\n    return {\n      status: 'FAILED',\n      error: errorMessage,\n    }\n  }\n}\n\n// ============================================================================\n// Step Type Handlers\n// ============================================================================\n\n/**\n * Execute step based on its type\n *\n * @param em - Entity manager\n * @param instance - Workflow instance\n * @param stepInstance - Step instance\n * @param stepDef - Step definition from workflow\n * @param context - Execution context\n * @returns Execution result\n */\nasync function executeStepByType(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepInstance: StepInstance,\n  stepDef: any,\n  context: StepExecutionContext,\n  container?: any,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepExecutionResult> {\n  const stepType: WorkflowStepType = stepDef.stepType\n\n  switch (stepType) {\n    case 'START':\n      return handleStartStep(stepDef, context)\n\n    case 'END':\n      return handleEndStep(stepDef, context)\n\n    case 'AUTOMATED':\n      return await handleAutomatedStep(em, instance, stepInstance, stepDef, context, container, branch)\n\n    case 'USER_TASK':\n      return await handleUserTaskStep(em, instance, stepInstance, stepDef, context, branch)\n\n    case 'SUB_WORKFLOW':\n      if (!container) {\n        throw new StepExecutionError(\n          'Container required for SUB_WORKFLOW execution',\n          'CONTAINER_REQUIRED',\n          { stepType }\n        )\n      }\n      return await handleSubWorkflowStep(em, container, instance, stepInstance, stepDef, context)\n\n    case 'WAIT_FOR_SIGNAL':\n      return await handleWaitForSignalStep(em, instance, stepInstance, stepDef, context, branch)\n\n    case 'WAIT_FOR_TIMER':\n      return await handleWaitForTimerStep(em, instance, stepInstance, stepDef, context, branch)\n\n    case 'PARALLEL_FORK': {\n      // Entering a fork opens branch tokens and parks the root token in the\n      // FORKED state; the interleaved loop in the executor drives the branches.\n      if (branch) {\n        // Nested forks are rejected by definition validation; fail closed.\n        throw new StepExecutionError(\n          'Nested PARALLEL_FORK is not supported',\n          'NESTED_FORK_NOT_SUPPORTED',\n          { stepType, stepId: stepDef.stepId }\n        )\n      }\n      const definition = await em.findOne(WorkflowDefinition, { id: instance.definitionId })\n      if (!definition) {\n        throw new StepExecutionError(\n          `Workflow definition not found: ${instance.definitionId}`,\n          'DEFINITION_NOT_FOUND',\n          { definitionId: instance.definitionId }\n        )\n      }\n      const { openFork } = await import('./parallel-handler')\n      await openFork(em, instance, definition, stepDef)\n      return { status: 'WAITING', waitReason: 'FORK', outputData: { stepType: 'PARALLEL_FORK', forkStepId: stepDef.stepId } }\n    }\n\n    case 'PARALLEL_JOIN':\n      // The join is a synchronization point handled by the parallel loop\n      // (branches are marked COMPLETED on arrival; the loop fires the join).\n      // Executing the step itself is a no-op.\n      return { status: 'COMPLETED', outputData: { stepType: 'PARALLEL_JOIN', timestamp: new Date().toISOString() } }\n\n    default:\n      throw new StepExecutionError(\n        `Unknown step type: ${stepType}`,\n        'UNKNOWN_STEP_TYPE',\n        { stepType }\n      )\n  }\n}\n\n/**\n * Handle START step - no-op, immediately complete\n */\nfunction handleStartStep(\n  stepDef: any,\n  context: StepExecutionContext\n): StepExecutionResult {\n  return {\n    status: 'COMPLETED',\n    outputData: {\n      stepType: 'START',\n      timestamp: new Date().toISOString(),\n    },\n  }\n}\n\n/**\n * Handle END step - mark as complete\n */\nfunction handleEndStep(\n  stepDef: any,\n  context: StepExecutionContext\n): StepExecutionResult {\n  return {\n    status: 'COMPLETED',\n    outputData: {\n      stepType: 'END',\n      timestamp: new Date().toISOString(),\n      finalContext: context.workflowContext,\n    },\n  }\n}\n\n/**\n * Handle AUTOMATED step - execute activities\n *\n * Executes activities defined in step configuration.\n * Supports both sync and async activities.\n */\nasync function handleAutomatedStep(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepInstance: StepInstance,\n  stepDef: any,\n  context: StepExecutionContext,\n  container?: any,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepExecutionResult> {\n  // Extract activities from step definition\n  const activities = stepDef.activities || []\n\n  if (activities.length === 0) {\n    // No activities defined - immediate completion (legacy behavior)\n    return {\n      status: 'COMPLETED',\n      outputData: {\n        stepType: 'AUTOMATED',\n        timestamp: new Date().toISOString(),\n      },\n    }\n  }\n\n  // Import activity executor\n  const { executeActivities } = await import('./activity-executor')\n\n  try {\n    // Execute activities with proper context\n    const results = await executeActivities(em, container, activities, {\n      workflowInstance: instance,\n      workflowContext: context.workflowContext,\n      stepContext: { stepId: stepDef.stepId, stepName: stepDef.stepName },\n      stepInstanceId: stepInstance.id,\n      userId: context.userId,\n    })\n\n    // Check if there are pending async activities\n    const pendingActivities = results.filter(r => r.async && !r.success)\n    if (pendingActivities.length > 0) {\n      // Workflow should pause and wait for async activities\n      const now = new Date()\n      if (branch) {\n        branch.status = 'WAITING_FOR_ACTIVITIES'\n        branch.updatedAt = now\n      } else {\n        instance.status = 'WAITING_FOR_ACTIVITIES'\n        instance.pausedAt = now\n        instance.updatedAt = now\n      }\n      await em.flush()\n\n      return {\n        status: 'WAITING',\n        waitReason: 'SIGNAL', // Reuse SIGNAL wait reason (will be resumed by activity completion)\n        outputData: {\n          pendingActivities: pendingActivities.map(r => ({\n            activityId: r.activityId,\n            activityName: r.activityName,\n            jobId: r.jobId,\n          })),\n        },\n      }\n    }\n\n    // Check for failures in sync activities\n    const failures = results.filter(r => !r.success && !r.async)\n    if (failures.length > 0) {\n      const errorMessages = failures.map(f => `${f.activityName || f.activityId}: ${f.error}`).join('; ')\n      return {\n        status: 'FAILED',\n        error: `${failures.length} activity(ies) failed: ${errorMessages}`,\n        outputData: {\n          failures: failures.map(f => ({\n            activityId: f.activityId,\n            activityName: f.activityName,\n            error: f.error,\n            retryCount: f.retryCount,\n          })),\n        },\n      }\n    }\n\n    // All activities completed successfully\n    const activityOutputs = results.reduce((acc, r) => {\n      if (r.output) {\n        acc[r.activityId] = r.output\n      }\n      return acc\n    }, {} as Record<string, any>)\n\n    return {\n      status: 'COMPLETED',\n      outputData: {\n        stepType: 'AUTOMATED',\n        timestamp: new Date().toISOString(),\n        activityResults: activityOutputs,\n        activityCount: results.length,\n      },\n    }\n  } catch (error: any) {\n    return {\n      status: 'FAILED',\n      error: `Activity execution failed: ${error.message}`,\n    }\n  }\n}\n\n/**\n * Handle USER_TASK step - create user task and enter waiting state\n *\n * Creates a UserTask entity and returns WAITING status.\n * The workflow will pause until the task is completed by a user.\n */\nasync function handleUserTaskStep(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepInstance: StepInstance,\n  stepDef: any,\n  context: StepExecutionContext,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepExecutionResult> {\n  const userTaskConfig = stepDef.userTaskConfig || {}\n\n  // Handle assignedTo - if it's an array, treat it as roles\n  let assignedTo = userTaskConfig.assignedTo || null\n  let assignedToRoles = userTaskConfig.assignedToRoles || null\n\n  if (Array.isArray(assignedTo)) {\n    assignedToRoles = assignedTo\n    assignedTo = null\n  }\n\n  // Create user task\n  const now = new Date()\n  const userTask = em.create(UserTask, {\n    workflowInstanceId: instance.id,\n    stepInstanceId: stepInstance.id,\n    branchInstanceId: branch ? branch.id : null,\n    taskName: stepDef.stepName,\n    description: stepDef.description || null,\n    status: 'PENDING',\n    formSchema: userTaskConfig.formSchema || null,\n    formData: null,\n    assignedTo: assignedTo,\n    assignedToRoles: assignedToRoles,\n    dueDate: userTaskConfig.slaDuration ? calculateDueDate(userTaskConfig.slaDuration) : null,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n    createdAt: now,\n    updatedAt: now,\n  })\n\n  await em.persist(userTask).flush()\n\n  // Log USER_TASK_CREATED event\n  await logStepEvent(em, {\n    workflowInstanceId: instance.id,\n    stepInstanceId: stepInstance.id,\n    ...(branch ? { branchInstanceId: branch.id } : {}),\n    eventType: 'USER_TASK_CREATED',\n    eventData: {\n      userTaskId: userTask.id,\n      taskName: userTask.taskName,\n      assignedTo: userTask.assignedTo,\n      assignedToRoles: userTask.assignedToRoles,\n    },\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n  })\n\n  // Pause execution - waits for user task completion. For a branch, only the\n  // branch pauses; sibling branches keep running.\n  if (branch) {\n    branch.status = 'PAUSED'\n    branch.updatedAt = now\n  } else {\n    instance.status = 'PAUSED'\n    instance.updatedAt = now\n  }\n  await em.flush()\n\n  return {\n    status: 'WAITING',\n    waitReason: 'USER_TASK',\n    outputData: {\n      userTaskId: userTask.id,\n    },\n  }\n}\n\n/**\n * Handle SUB_WORKFLOW step - invoke another workflow and wait for completion\n *\n * Creates a child workflow instance with mapped input data,\n * executes it synchronously, and returns mapped output data.\n */\nasync function handleSubWorkflowStep(\n  em: EntityManager,\n  container: any,\n  instance: WorkflowInstance,\n  stepInstance: StepInstance,\n  stepDef: any,\n  context: StepExecutionContext\n): Promise<StepExecutionResult> {\n  const { subWorkflowId, inputMapping, outputMapping, version } = stepDef.config || {}\n\n  if (!subWorkflowId) {\n    return {\n      status: 'FAILED',\n      error: 'Sub-workflow ID not specified in step configuration'\n    }\n  }\n\n  // Map input data from parent context to child context\n  const childContext = mapInputData(instance.context, inputMapping || {})\n\n  // Import workflow executor functions\n  const { startWorkflow, executeWorkflow } = await import('./workflow-executor')\n\n  try {\n    // Start child workflow with parent metadata\n    const childInstance = await startWorkflow(em, {\n      workflowId: subWorkflowId,\n      version,\n      initialContext: childContext,\n      correlationKey: instance.correlationKey || undefined,\n      metadata: {\n        ...instance.metadata,\n        labels: {\n          ...instance.metadata?.labels,\n          parentInstanceId: instance.id,\n          parentStepId: stepDef.stepId,\n          parentStepInstanceId: stepInstance.id,\n        },\n      },\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n    })\n\n    // Log sub-workflow invocation event\n    await logStepEvent(em, {\n      workflowInstanceId: instance.id,\n      stepInstanceId: stepInstance.id,\n      eventType: 'SUB_WORKFLOW_STARTED',\n      eventData: {\n        childInstanceId: childInstance.id,\n        subWorkflowId,\n        version,\n        inputData: childContext,\n      },\n      userId: context.userId,\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n    })\n\n    // Execute child workflow synchronously\n    const result = await executeWorkflow(em, container, childInstance.id, {\n      userId: context.userId,\n    })\n\n    // Handle child workflow result\n    if (result.status === 'COMPLETED') {\n      // Map output data from child context to parent context\n      const outputData = mapOutputData(result.context, outputMapping || {})\n\n      await logStepEvent(em, {\n        workflowInstanceId: instance.id,\n        stepInstanceId: stepInstance.id,\n        eventType: 'SUB_WORKFLOW_COMPLETED',\n        eventData: {\n          childInstanceId: childInstance.id,\n          outputData,\n        },\n        userId: context.userId,\n        tenantId: instance.tenantId,\n        organizationId: instance.organizationId,\n      })\n\n      return {\n        status: 'COMPLETED',\n        outputData,\n      }\n    } else if (result.status === 'FAILED') {\n      await logStepEvent(em, {\n        workflowInstanceId: instance.id,\n        stepInstanceId: stepInstance.id,\n        eventType: 'SUB_WORKFLOW_FAILED',\n        eventData: {\n          childInstanceId: childInstance.id,\n          error: result.errors?.join(', '),\n        },\n        userId: context.userId,\n        tenantId: instance.tenantId,\n        organizationId: instance.organizationId,\n      })\n\n      return {\n        status: 'FAILED',\n        error: `Sub-workflow failed: ${result.errors?.join(', ')}`,\n      }\n    } else {\n      // WAITING, PAUSED, etc. - For synchronous execution, treat as error\n      return {\n        status: 'FAILED',\n        error: `Sub-workflow ended in unexpected state: ${result.status}`,\n      }\n    }\n  } catch (error: any) {\n    await logStepEvent(em, {\n      workflowInstanceId: instance.id,\n      stepInstanceId: stepInstance.id,\n      eventType: 'SUB_WORKFLOW_FAILED',\n      eventData: {\n        subWorkflowId,\n        error: error.message,\n      },\n      userId: context.userId,\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n    })\n\n    return {\n      status: 'FAILED',\n      error: `Sub-workflow execution failed: ${error.message}`,\n    }\n  }\n}\n\n/**\n * Handle WAIT_FOR_SIGNAL step - pause workflow until signal received\n *\n * Creates a waiting state and pauses the workflow until an external signal\n * with the matching signal name is received. The signal payload will be merged\n * into the workflow context when received.\n */\nasync function handleWaitForSignalStep(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepInstance: StepInstance,\n  stepDef: any,\n  context: StepExecutionContext,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepExecutionResult> {\n  const signalConfig = stepDef.signalConfig || {}\n  const signalName = signalConfig.signalName || stepDef.stepId\n  const timeout = signalConfig.timeout ? parseDuration(signalConfig.timeout) : null\n\n  const now = new Date()\n\n  // Log signal awaiting event\n  await logStepEvent(em, {\n    workflowInstanceId: instance.id,\n    stepInstanceId: stepInstance.id,\n    ...(branch ? { branchInstanceId: branch.id } : {}),\n    eventType: 'SIGNAL_AWAITING',\n    eventData: {\n      signalName,\n      timeout,\n      description: stepDef.description,\n    },\n    userId: context.userId,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n  })\n\n  // Pause execution (branch-scoped when running inside a parallel branch)\n  if (branch) {\n    branch.status = 'PAUSED'\n    branch.updatedAt = now\n  } else {\n    instance.status = 'PAUSED'\n    instance.pausedAt = now\n    instance.updatedAt = now\n  }\n  await em.flush()\n\n  // Return WAITING status to halt executor\n  return {\n    status: 'WAITING',\n    waitReason: 'SIGNAL',\n    outputData: {\n      signalName,\n      timeout,\n      awaitingSince: now,\n    },\n  }\n}\n\n/**\n * Handle WAIT_FOR_TIMER step - pause workflow until a timer fires.\n *\n * Reads `duration` (relative, e.g. \"PT5M\") or `until` (ISO 8601 datetime) from\n * `stepDef.config` (preferred \u2014 matches StepsEditor) or `stepDef.timerConfig`.\n * Enqueues a delayed timer job on the workflow-activities queue; when the job\n * is processed by the activity worker, it calls `timerHandler.fireTimer` to\n * resume the workflow.\n */\nasync function handleWaitForTimerStep(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepInstance: StepInstance,\n  stepDef: any,\n  context: StepExecutionContext,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepExecutionResult> {\n  const timerConfig = stepDef.config || stepDef.timerConfig || {}\n  const duration: string | undefined = timerConfig.duration\n  const until: string | undefined = timerConfig.until\n\n  if (!duration && !until) {\n    throw new StepExecutionError(\n      'WAIT_FOR_TIMER requires either \"duration\" (e.g., \"PT5M\") or \"until\" (ISO 8601 datetime)',\n      'TIMER_CONFIG_MISSING',\n      { stepId: stepDef.stepId }\n    )\n  }\n\n  let fireAtMs: number\n  if (until) {\n    const targetDate = new Date(until)\n    if (isNaN(targetDate.getTime())) {\n      throw new StepExecutionError(\n        `WAIT_FOR_TIMER invalid \"until\" datetime: ${until}`,\n        'TIMER_CONFIG_INVALID',\n        { until }\n      )\n    }\n    fireAtMs = targetDate.getTime()\n  } else {\n    fireAtMs = Date.now() + parseDuration(duration as string)\n  }\n\n  const delayMs = fireAtMs - Date.now()\n  const fireAt = new Date(fireAtMs)\n\n  // Immediate-fire path: skip the queue round-trip if the timer is in the past\n  if (delayMs <= 0) {\n    return {\n      status: 'COMPLETED',\n      outputData: {\n        stepType: 'WAIT_FOR_TIMER',\n        timerFiredImmediately: true,\n        fireAt,\n        duration,\n        until,\n      },\n    }\n  }\n\n  const now = new Date()\n\n  // Enqueue delayed timer job via the shared activity queue.\n  // Imported here to avoid a top-level cycle between step-handler and activity-executor.\n  const { enqueueTimerJob } = await import('./activity-executor')\n  const jobId = await enqueueTimerJob({\n    workflowInstanceId: instance.id,\n    stepInstanceId: stepInstance.id,\n    branchInstanceId: branch ? branch.id : undefined,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n    userId: context.userId,\n    fireAt: fireAt.toISOString(),\n    delayMs,\n  })\n\n  await logWorkflowEvent(em, {\n    workflowInstanceId: instance.id,\n    stepInstanceId: stepInstance.id,\n    ...(branch ? { branchInstanceId: branch.id } : {}),\n    eventType: 'TIMER_AWAITING',\n    eventData: {\n      fireAt: fireAt.toISOString(),\n      duration: duration || null,\n      until: until || null,\n      jobId,\n    },\n    userId: context.userId,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n  })\n\n  if (branch) {\n    branch.status = 'PAUSED'\n    branch.updatedAt = now\n  } else {\n    instance.status = 'PAUSED'\n    instance.pausedAt = now\n    instance.updatedAt = now\n  }\n  await em.flush()\n\n  return {\n    status: 'WAITING',\n    waitReason: 'TIMER',\n    outputData: {\n      fireAt,\n      duration,\n      until,\n      jobId,\n    },\n  }\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n// parseDuration is imported from ./duration\n\n/**\n * Log step-related event to event sourcing table\n */\nasync function logStepEvent(\n  em: EntityManager,\n  event: {\n    workflowInstanceId: string\n    stepInstanceId: string\n    branchInstanceId?: string | null\n    eventType: string\n    eventData: any\n    userId?: string\n    tenantId: string\n    organizationId: string\n  }\n): Promise<WorkflowEvent> {\n  const workflowEvent = em.create(WorkflowEvent, {\n    ...event,\n    occurredAt: new Date(),\n  })\n\n  await em.persist(workflowEvent).flush()\n  return workflowEvent\n}\n\n/**\n * Calculate due date from ISO 8601 duration string\n *\n * @param duration - ISO 8601 duration (e.g., \"P1D\" for 1 day)\n * @returns Due date\n */\nfunction calculateDueDate(duration: string): Date {\n  // Simple implementation for MVP\n  // Supports: P1D (1 day), P1H (1 hour), P1W (1 week)\n  const now = new Date()\n\n  const daysMatch = duration.match(/P(\\d+)D/)\n  if (daysMatch) {\n    const days = parseInt(daysMatch[1], 10)\n    return new Date(now.getTime() + days * 24 * 60 * 60 * 1000)\n  }\n\n  const hoursMatch = duration.match(/PT(\\d+)H/)\n  if (hoursMatch) {\n    const hours = parseInt(hoursMatch[1], 10)\n    return new Date(now.getTime() + hours * 60 * 60 * 1000)\n  }\n\n  const weeksMatch = duration.match(/P(\\d+)W/)\n  if (weeksMatch) {\n    const weeks = parseInt(weeksMatch[1], 10)\n    return new Date(now.getTime() + weeks * 7 * 24 * 60 * 60 * 1000)\n  }\n\n  // Default: 1 day\n  return new Date(now.getTime() + 24 * 60 * 60 * 1000)\n}\n\n/**\n * Get nested value from object using dot notation\n *\n * @param obj - Source object\n * @param path - Dot-notation path (e.g., \"user.email\")\n * @returns Value at path or undefined\n */\nfunction getNestedValue(obj: any, path: string): any {\n  return path.split('.').reduce((current, key) => current?.[key], obj)\n}\n\n/**\n * Set nested value in object using dot notation\n *\n * @param obj - Target object\n * @param path - Dot-notation path (e.g., \"user.email\")\n * @param value - Value to set\n */\nfunction setNestedValue(obj: any, path: string, value: any): void {\n  const keys = path.split('.')\n  const lastKey = keys.pop()!\n  const target = keys.reduce((current, key) => {\n    if (!(key in current)) current[key] = {}\n    return current[key]\n  }, obj)\n  target[lastKey] = value\n}\n\n/**\n * Map data from source context using mapping configuration\n *\n * @param sourceContext - Source data object\n * @param mapping - Mapping configuration (targetKey -> sourcePath)\n * @returns Mapped data object\n */\nfunction mapInputData(\n  sourceContext: Record<string, any>,\n  mapping: Record<string, string>\n): Record<string, any> {\n  const result: Record<string, any> = {}\n\n  for (const [targetKey, sourcePath] of Object.entries(mapping)) {\n    const value = getNestedValue(sourceContext, sourcePath)\n    if (value !== undefined) {\n      setNestedValue(result, targetKey, value)\n    }\n  }\n\n  // If no mapping provided, pass entire context\n  return Object.keys(result).length > 0 ? result : sourceContext\n}\n\n/**\n * Map output data from child context back to parent\n *\n * @param childContext - Child workflow context\n * @param mapping - Mapping configuration (targetKey -> sourcePath)\n * @returns Mapped output data\n */\nfunction mapOutputData(\n  childContext: Record<string, any>,\n  mapping: Record<string, string>\n): Record<string, any> {\n  const result: Record<string, any> = {}\n\n  for (const [targetKey, sourcePath] of Object.entries(mapping)) {\n    const value = getNestedValue(childContext, sourcePath)\n    if (value !== undefined) {\n      setNestedValue(result, targetKey, value)\n    }\n  }\n\n  // If no mapping provided, pass entire child context\n  return Object.keys(result).length > 0 ? result : childContext\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Workflows Module - Step Handler Service\n *\n * Handles individual workflow step execution:\n * - Creating step instances when entering a step\n * - Executing step logic based on step type (START, END, AUTOMATED, USER_TASK)\n * - Completing step instances when exiting\n *\n * Functional API (no classes) following Open Mercato conventions.\n */\n\nimport { EntityManager } from '@mikro-orm/core'\nimport {\n  WorkflowInstance,\n  WorkflowBranchInstance,\n  StepInstance,\n  UserTask,\n  WorkflowEvent,\n  type StepInstanceStatus,\n  type WorkflowStepType,\n} from '../data/entities'\nimport { parseDuration } from './duration'\nimport { logWorkflowEvent } from './event-logger'\nimport { findDefinitionForInstance } from './find-definition'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\n\nconst logger = createLogger('workflows')\n\n// ============================================================================\n// Types and Interfaces\n// ============================================================================\n\nexport interface StepExecutionContext {\n  workflowContext: Record<string, any>\n  userId?: string\n  triggerData?: any\n}\n\nexport interface StepExecutionResult {\n  status: 'COMPLETED' | 'WAITING' | 'FAILED'\n  outputData?: any\n  nextSteps?: string[] // For parallel forks (Phase 7)\n  waitReason?: 'USER_TASK' | 'SIGNAL' | 'TIMER' | 'FORK'\n  error?: string\n}\n\nexport class StepExecutionError extends Error {\n  constructor(\n    message: string,\n    public code: string,\n    public details?: any\n  ) {\n    super(message)\n    this.name = 'StepExecutionError'\n  }\n}\n\n// ============================================================================\n// Main Step Execution Functions\n// ============================================================================\n\n/**\n * Enter a workflow step - create step instance and mark as ACTIVE\n *\n * @param em - Entity manager\n * @param instance - Workflow instance\n * @param stepId - Step ID to enter\n * @param context - Execution context\n * @returns Created step instance\n */\nexport async function enterStep(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepId: string,\n  context: StepExecutionContext,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepInstance> {\n  // Load workflow definition to get step details\n  const definition = await findDefinitionForInstance(em, instance)\n\n  if (!definition) {\n    throw new StepExecutionError(\n      `Workflow definition not found: ${instance.definitionId}`,\n      'DEFINITION_NOT_FOUND',\n      { definitionId: instance.definitionId }\n    )\n  }\n\n  // Find step in definition\n  const stepDef = definition.definition.steps.find((s: any) => s.stepId === stepId)\n  if (!stepDef) {\n    throw new StepExecutionError(\n      `Step not found in workflow definition: ${stepId}`,\n      'STEP_NOT_FOUND',\n      { workflowId: definition.workflowId, stepId }\n    )\n  }\n\n  const now = new Date()\n\n  // Create step instance\n  const stepInstance = em.create(StepInstance, {\n    workflowInstanceId: instance.id,\n    branchInstanceId: branch ? branch.id : null,\n    stepId: stepDef.stepId,\n    stepName: stepDef.stepName,\n    stepType: stepDef.stepType,\n    status: 'ACTIVE',\n    inputData: context.triggerData || null,\n    enteredAt: now,\n    retryCount: 0,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n    createdAt: now,\n    updatedAt: now,\n  })\n\n  await em.persist(stepInstance).flush()\n\n  // Log STEP_ENTERED event\n  await logStepEvent(em, {\n    workflowInstanceId: instance.id,\n    stepInstanceId: stepInstance.id,\n    ...(branch ? { branchInstanceId: branch.id } : {}),\n    eventType: 'STEP_ENTERED',\n    eventData: {\n      stepId: stepDef.stepId,\n      stepName: stepDef.stepName,\n      stepType: stepDef.stepType,\n    },\n    userId: context.userId,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n  })\n\n  return stepInstance\n}\n\n/**\n * Exit a workflow step - mark as completed and record timing\n *\n * @param em - Entity manager\n * @param stepInstance - Step instance to exit\n * @param outputData - Optional output data from step execution\n */\nexport async function exitStep(\n  em: EntityManager,\n  stepInstance: StepInstance,\n  outputData?: any\n): Promise<void> {\n  const now = new Date()\n\n  // Calculate execution time if we have enteredAt\n  let executionTimeMs: number | null = null\n  if (stepInstance.enteredAt) {\n    executionTimeMs = now.getTime() - stepInstance.enteredAt.getTime()\n  }\n\n  // Update step instance\n  stepInstance.status = 'COMPLETED'\n  stepInstance.outputData = outputData || null\n  stepInstance.exitedAt = now\n  stepInstance.executionTimeMs = executionTimeMs\n  stepInstance.updatedAt = now\n\n  await em.flush()\n\n  // Log STEP_EXITED event\n  await logStepEvent(em, {\n    workflowInstanceId: stepInstance.workflowInstanceId,\n    stepInstanceId: stepInstance.id,\n    eventType: 'STEP_EXITED',\n    eventData: {\n      stepId: stepInstance.stepId,\n      status: 'COMPLETED',\n      executionTimeMs,\n      hasOutput: !!outputData,\n    },\n    tenantId: stepInstance.tenantId,\n    organizationId: stepInstance.organizationId,\n  })\n}\n\n/**\n * Execute a workflow step based on its type\n *\n * Main entry point for step execution. Handles:\n * - START: Immediate completion\n * - END: Workflow completion\n * - AUTOMATED: Activity execution (MVP: immediate completion)\n * - USER_TASK: Create user task and wait\n * - SUB_WORKFLOW: Invoke child workflow\n *\n * @param em - Entity manager\n * @param instance - Workflow instance\n * @param stepId - Step ID to execute\n * @param context - Execution context\n * @param container - DI container (required for SUB_WORKFLOW steps)\n * @returns Execution result with status and output\n */\nexport async function executeStep(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepId: string,\n  context: StepExecutionContext,\n  container?: any,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepExecutionResult> {\n  try {\n    // Enter the step (create step instance)\n    const stepInstance = await enterStep(em, instance, stepId, context, branch)\n\n    // Load workflow definition to get step configuration\n    const definition = await findDefinitionForInstance(em, instance)\n\n    if (!definition) {\n      throw new StepExecutionError(\n        `Workflow definition not found: ${instance.definitionId}`,\n        'DEFINITION_NOT_FOUND',\n        { definitionId: instance.definitionId }\n      )\n    }\n\n    const stepDef = definition.definition.steps.find((s: any) => s.stepId === stepId)\n    if (!stepDef) {\n      throw new StepExecutionError(\n        `Step not found: ${stepId}`,\n        'STEP_NOT_FOUND',\n        { stepId }\n      )\n    }\n\n    // Execute based on step type\n    const result = await executeStepByType(\n      em,\n      instance,\n      stepInstance,\n      stepDef,\n      context,\n      container,\n      branch\n    )\n\n    // If step completed, exit it\n    if (result.status === 'COMPLETED') {\n      await exitStep(em, stepInstance, result.outputData)\n    }\n\n    return result\n  } catch (error) {\n    // Handle step execution errors\n    const errorMessage = error instanceof Error ? error.message : String(error)\n\n    // Try to mark step as failed if we have a step instance\n    try {\n      const failedStepInstance = await em.findOne(StepInstance, {\n        workflowInstanceId: instance.id,\n        stepId,\n        status: 'ACTIVE',\n      })\n\n      if (failedStepInstance) {\n        failedStepInstance.status = 'FAILED'\n        failedStepInstance.errorData = {\n          error: errorMessage,\n          details: error instanceof StepExecutionError ? error.details : undefined,\n        }\n        failedStepInstance.exitedAt = new Date()\n        failedStepInstance.updatedAt = new Date()\n        await em.flush()\n\n        await logStepEvent(em, {\n          workflowInstanceId: instance.id,\n          stepInstanceId: failedStepInstance.id,\n          eventType: 'STEP_FAILED',\n          eventData: { error: errorMessage },\n          tenantId: instance.tenantId,\n          organizationId: instance.organizationId,\n        })\n      }\n    } catch (updateError) {\n      // Swallow update errors to preserve original error\n      logger.error('Failed to update step instance with error', { err: updateError })\n    }\n\n    return {\n      status: 'FAILED',\n      error: errorMessage,\n    }\n  }\n}\n\n// ============================================================================\n// Step Type Handlers\n// ============================================================================\n\n/**\n * Execute step based on its type\n *\n * @param em - Entity manager\n * @param instance - Workflow instance\n * @param stepInstance - Step instance\n * @param stepDef - Step definition from workflow\n * @param context - Execution context\n * @returns Execution result\n */\nasync function executeStepByType(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepInstance: StepInstance,\n  stepDef: any,\n  context: StepExecutionContext,\n  container?: any,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepExecutionResult> {\n  const stepType: WorkflowStepType = stepDef.stepType\n\n  switch (stepType) {\n    case 'START':\n      return handleStartStep(stepDef, context)\n\n    case 'END':\n      return handleEndStep(stepDef, context)\n\n    case 'AUTOMATED':\n      return await handleAutomatedStep(em, instance, stepInstance, stepDef, context, container, branch)\n\n    case 'USER_TASK':\n      return await handleUserTaskStep(em, instance, stepInstance, stepDef, context, branch)\n\n    case 'SUB_WORKFLOW':\n      if (!container) {\n        throw new StepExecutionError(\n          'Container required for SUB_WORKFLOW execution',\n          'CONTAINER_REQUIRED',\n          { stepType }\n        )\n      }\n      return await handleSubWorkflowStep(em, container, instance, stepInstance, stepDef, context)\n\n    case 'WAIT_FOR_SIGNAL':\n      return await handleWaitForSignalStep(em, instance, stepInstance, stepDef, context, branch)\n\n    case 'WAIT_FOR_TIMER':\n      return await handleWaitForTimerStep(em, instance, stepInstance, stepDef, context, branch)\n\n    case 'PARALLEL_FORK': {\n      // Entering a fork opens branch tokens and parks the root token in the\n      // FORKED state; the interleaved loop in the executor drives the branches.\n      if (branch) {\n        // Nested forks are rejected by definition validation; fail closed.\n        throw new StepExecutionError(\n          'Nested PARALLEL_FORK is not supported',\n          'NESTED_FORK_NOT_SUPPORTED',\n          { stepType, stepId: stepDef.stepId }\n        )\n      }\n      const definition = await findDefinitionForInstance(em, instance)\n      if (!definition) {\n        throw new StepExecutionError(\n          `Workflow definition not found: ${instance.definitionId}`,\n          'DEFINITION_NOT_FOUND',\n          { definitionId: instance.definitionId }\n        )\n      }\n      const { openFork } = await import('./parallel-handler')\n      await openFork(em, instance, definition, stepDef)\n      return { status: 'WAITING', waitReason: 'FORK', outputData: { stepType: 'PARALLEL_FORK', forkStepId: stepDef.stepId } }\n    }\n\n    case 'PARALLEL_JOIN':\n      // The join is a synchronization point handled by the parallel loop\n      // (branches are marked COMPLETED on arrival; the loop fires the join).\n      // Executing the step itself is a no-op.\n      return { status: 'COMPLETED', outputData: { stepType: 'PARALLEL_JOIN', timestamp: new Date().toISOString() } }\n\n    default:\n      throw new StepExecutionError(\n        `Unknown step type: ${stepType}`,\n        'UNKNOWN_STEP_TYPE',\n        { stepType }\n      )\n  }\n}\n\n/**\n * Handle START step - no-op, immediately complete\n */\nfunction handleStartStep(\n  stepDef: any,\n  context: StepExecutionContext\n): StepExecutionResult {\n  return {\n    status: 'COMPLETED',\n    outputData: {\n      stepType: 'START',\n      timestamp: new Date().toISOString(),\n    },\n  }\n}\n\n/**\n * Handle END step - mark as complete\n */\nfunction handleEndStep(\n  stepDef: any,\n  context: StepExecutionContext\n): StepExecutionResult {\n  return {\n    status: 'COMPLETED',\n    outputData: {\n      stepType: 'END',\n      timestamp: new Date().toISOString(),\n      finalContext: context.workflowContext,\n    },\n  }\n}\n\n/**\n * Handle AUTOMATED step - execute activities\n *\n * Executes activities defined in step configuration.\n * Supports both sync and async activities.\n */\nasync function handleAutomatedStep(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepInstance: StepInstance,\n  stepDef: any,\n  context: StepExecutionContext,\n  container?: any,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepExecutionResult> {\n  // Extract activities from step definition\n  const activities = stepDef.activities || []\n\n  if (activities.length === 0) {\n    // No activities defined - immediate completion (legacy behavior)\n    return {\n      status: 'COMPLETED',\n      outputData: {\n        stepType: 'AUTOMATED',\n        timestamp: new Date().toISOString(),\n      },\n    }\n  }\n\n  // Import activity executor\n  const { executeActivities } = await import('./activity-executor')\n\n  try {\n    // Execute activities with proper context\n    const results = await executeActivities(em, container, activities, {\n      workflowInstance: instance,\n      workflowContext: context.workflowContext,\n      stepContext: { stepId: stepDef.stepId, stepName: stepDef.stepName },\n      stepInstanceId: stepInstance.id,\n      userId: context.userId,\n    })\n\n    // Check if there are pending async activities\n    const pendingActivities = results.filter(r => r.async && !r.success)\n    if (pendingActivities.length > 0) {\n      // Workflow should pause and wait for async activities\n      const now = new Date()\n      if (branch) {\n        branch.status = 'WAITING_FOR_ACTIVITIES'\n        branch.updatedAt = now\n      } else {\n        instance.status = 'WAITING_FOR_ACTIVITIES'\n        instance.pausedAt = now\n        instance.updatedAt = now\n      }\n      await em.flush()\n\n      return {\n        status: 'WAITING',\n        waitReason: 'SIGNAL', // Reuse SIGNAL wait reason (will be resumed by activity completion)\n        outputData: {\n          pendingActivities: pendingActivities.map(r => ({\n            activityId: r.activityId,\n            activityName: r.activityName,\n            jobId: r.jobId,\n          })),\n        },\n      }\n    }\n\n    // Check for failures in sync activities\n    const failures = results.filter(r => !r.success && !r.async)\n    if (failures.length > 0) {\n      const errorMessages = failures.map(f => `${f.activityName || f.activityId}: ${f.error}`).join('; ')\n      return {\n        status: 'FAILED',\n        error: `${failures.length} activity(ies) failed: ${errorMessages}`,\n        outputData: {\n          failures: failures.map(f => ({\n            activityId: f.activityId,\n            activityName: f.activityName,\n            error: f.error,\n            retryCount: f.retryCount,\n          })),\n        },\n      }\n    }\n\n    // All activities completed successfully\n    const activityOutputs = results.reduce((acc, r) => {\n      if (r.output) {\n        acc[r.activityId] = r.output\n      }\n      return acc\n    }, {} as Record<string, any>)\n\n    return {\n      status: 'COMPLETED',\n      outputData: {\n        stepType: 'AUTOMATED',\n        timestamp: new Date().toISOString(),\n        activityResults: activityOutputs,\n        activityCount: results.length,\n      },\n    }\n  } catch (error: any) {\n    return {\n      status: 'FAILED',\n      error: `Activity execution failed: ${error.message}`,\n    }\n  }\n}\n\n/**\n * Handle USER_TASK step - create user task and enter waiting state\n *\n * Creates a UserTask entity and returns WAITING status.\n * The workflow will pause until the task is completed by a user.\n */\nasync function handleUserTaskStep(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepInstance: StepInstance,\n  stepDef: any,\n  context: StepExecutionContext,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepExecutionResult> {\n  const userTaskConfig = stepDef.userTaskConfig || {}\n\n  // Handle assignedTo - if it's an array, treat it as roles\n  let assignedTo = userTaskConfig.assignedTo || null\n  let assignedToRoles = userTaskConfig.assignedToRoles || null\n\n  if (Array.isArray(assignedTo)) {\n    assignedToRoles = assignedTo\n    assignedTo = null\n  }\n\n  // Create user task\n  const now = new Date()\n  const userTask = em.create(UserTask, {\n    workflowInstanceId: instance.id,\n    stepInstanceId: stepInstance.id,\n    branchInstanceId: branch ? branch.id : null,\n    taskName: stepDef.stepName,\n    description: stepDef.description || null,\n    status: 'PENDING',\n    formSchema: userTaskConfig.formSchema || null,\n    formData: null,\n    assignedTo: assignedTo,\n    assignedToRoles: assignedToRoles,\n    dueDate: userTaskConfig.slaDuration ? calculateDueDate(userTaskConfig.slaDuration) : null,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n    createdAt: now,\n    updatedAt: now,\n  })\n\n  await em.persist(userTask).flush()\n\n  // Log USER_TASK_CREATED event\n  await logStepEvent(em, {\n    workflowInstanceId: instance.id,\n    stepInstanceId: stepInstance.id,\n    ...(branch ? { branchInstanceId: branch.id } : {}),\n    eventType: 'USER_TASK_CREATED',\n    eventData: {\n      userTaskId: userTask.id,\n      taskName: userTask.taskName,\n      assignedTo: userTask.assignedTo,\n      assignedToRoles: userTask.assignedToRoles,\n    },\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n  })\n\n  // Pause execution - waits for user task completion. For a branch, only the\n  // branch pauses; sibling branches keep running.\n  if (branch) {\n    branch.status = 'PAUSED'\n    branch.updatedAt = now\n  } else {\n    instance.status = 'PAUSED'\n    instance.updatedAt = now\n  }\n  await em.flush()\n\n  return {\n    status: 'WAITING',\n    waitReason: 'USER_TASK',\n    outputData: {\n      userTaskId: userTask.id,\n    },\n  }\n}\n\n/**\n * Handle SUB_WORKFLOW step - invoke another workflow and wait for completion\n *\n * Creates a child workflow instance with mapped input data,\n * executes it synchronously, and returns mapped output data.\n */\nasync function handleSubWorkflowStep(\n  em: EntityManager,\n  container: any,\n  instance: WorkflowInstance,\n  stepInstance: StepInstance,\n  stepDef: any,\n  context: StepExecutionContext\n): Promise<StepExecutionResult> {\n  const { subWorkflowId, inputMapping, outputMapping, version } = stepDef.config || {}\n\n  if (!subWorkflowId) {\n    return {\n      status: 'FAILED',\n      error: 'Sub-workflow ID not specified in step configuration'\n    }\n  }\n\n  // Map input data from parent context to child context\n  const childContext = mapInputData(instance.context, inputMapping || {})\n\n  // Import workflow executor functions\n  const { startWorkflow, executeWorkflow } = await import('./workflow-executor')\n\n  try {\n    // Start child workflow with parent metadata\n    const childInstance = await startWorkflow(em, {\n      workflowId: subWorkflowId,\n      version,\n      initialContext: childContext,\n      correlationKey: instance.correlationKey || undefined,\n      metadata: {\n        ...instance.metadata,\n        labels: {\n          ...instance.metadata?.labels,\n          parentInstanceId: instance.id,\n          parentStepId: stepDef.stepId,\n          parentStepInstanceId: stepInstance.id,\n        },\n      },\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n    })\n\n    // Log sub-workflow invocation event\n    await logStepEvent(em, {\n      workflowInstanceId: instance.id,\n      stepInstanceId: stepInstance.id,\n      eventType: 'SUB_WORKFLOW_STARTED',\n      eventData: {\n        childInstanceId: childInstance.id,\n        subWorkflowId,\n        version,\n        inputData: childContext,\n      },\n      userId: context.userId,\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n    })\n\n    // Execute child workflow synchronously\n    const result = await executeWorkflow(em, container, childInstance.id, {\n      userId: context.userId,\n    })\n\n    // Handle child workflow result\n    if (result.status === 'COMPLETED') {\n      // Map output data from child context to parent context\n      const outputData = mapOutputData(result.context, outputMapping || {})\n\n      await logStepEvent(em, {\n        workflowInstanceId: instance.id,\n        stepInstanceId: stepInstance.id,\n        eventType: 'SUB_WORKFLOW_COMPLETED',\n        eventData: {\n          childInstanceId: childInstance.id,\n          outputData,\n        },\n        userId: context.userId,\n        tenantId: instance.tenantId,\n        organizationId: instance.organizationId,\n      })\n\n      return {\n        status: 'COMPLETED',\n        outputData,\n      }\n    } else if (result.status === 'FAILED') {\n      await logStepEvent(em, {\n        workflowInstanceId: instance.id,\n        stepInstanceId: stepInstance.id,\n        eventType: 'SUB_WORKFLOW_FAILED',\n        eventData: {\n          childInstanceId: childInstance.id,\n          error: result.errors?.join(', '),\n        },\n        userId: context.userId,\n        tenantId: instance.tenantId,\n        organizationId: instance.organizationId,\n      })\n\n      return {\n        status: 'FAILED',\n        error: `Sub-workflow failed: ${result.errors?.join(', ')}`,\n      }\n    } else {\n      // WAITING, PAUSED, etc. - For synchronous execution, treat as error\n      return {\n        status: 'FAILED',\n        error: `Sub-workflow ended in unexpected state: ${result.status}`,\n      }\n    }\n  } catch (error: any) {\n    await logStepEvent(em, {\n      workflowInstanceId: instance.id,\n      stepInstanceId: stepInstance.id,\n      eventType: 'SUB_WORKFLOW_FAILED',\n      eventData: {\n        subWorkflowId,\n        error: error.message,\n      },\n      userId: context.userId,\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n    })\n\n    return {\n      status: 'FAILED',\n      error: `Sub-workflow execution failed: ${error.message}`,\n    }\n  }\n}\n\n/**\n * Handle WAIT_FOR_SIGNAL step - pause workflow until signal received\n *\n * Creates a waiting state and pauses the workflow until an external signal\n * with the matching signal name is received. The signal payload will be merged\n * into the workflow context when received.\n */\nasync function handleWaitForSignalStep(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepInstance: StepInstance,\n  stepDef: any,\n  context: StepExecutionContext,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepExecutionResult> {\n  const signalConfig = stepDef.signalConfig || {}\n  const signalName = signalConfig.signalName || stepDef.stepId\n  const timeout = signalConfig.timeout ? parseDuration(signalConfig.timeout) : null\n\n  const now = new Date()\n\n  // Log signal awaiting event\n  await logStepEvent(em, {\n    workflowInstanceId: instance.id,\n    stepInstanceId: stepInstance.id,\n    ...(branch ? { branchInstanceId: branch.id } : {}),\n    eventType: 'SIGNAL_AWAITING',\n    eventData: {\n      signalName,\n      timeout,\n      description: stepDef.description,\n    },\n    userId: context.userId,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n  })\n\n  // Pause execution (branch-scoped when running inside a parallel branch)\n  if (branch) {\n    branch.status = 'PAUSED'\n    branch.updatedAt = now\n  } else {\n    instance.status = 'PAUSED'\n    instance.pausedAt = now\n    instance.updatedAt = now\n  }\n  await em.flush()\n\n  // Return WAITING status to halt executor\n  return {\n    status: 'WAITING',\n    waitReason: 'SIGNAL',\n    outputData: {\n      signalName,\n      timeout,\n      awaitingSince: now,\n    },\n  }\n}\n\n/**\n * Handle WAIT_FOR_TIMER step - pause workflow until a timer fires.\n *\n * Reads `duration` (relative, e.g. \"PT5M\") or `until` (ISO 8601 datetime) from\n * `stepDef.config` (preferred \u2014 matches StepsEditor) or `stepDef.timerConfig`.\n * Enqueues a delayed timer job on the workflow-activities queue; when the job\n * is processed by the activity worker, it calls `timerHandler.fireTimer` to\n * resume the workflow.\n */\nasync function handleWaitForTimerStep(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepInstance: StepInstance,\n  stepDef: any,\n  context: StepExecutionContext,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepExecutionResult> {\n  const timerConfig = stepDef.config || stepDef.timerConfig || {}\n  const duration: string | undefined = timerConfig.duration\n  const until: string | undefined = timerConfig.until\n\n  if (!duration && !until) {\n    throw new StepExecutionError(\n      'WAIT_FOR_TIMER requires either \"duration\" (e.g., \"PT5M\") or \"until\" (ISO 8601 datetime)',\n      'TIMER_CONFIG_MISSING',\n      { stepId: stepDef.stepId }\n    )\n  }\n\n  let fireAtMs: number\n  if (until) {\n    const targetDate = new Date(until)\n    if (isNaN(targetDate.getTime())) {\n      throw new StepExecutionError(\n        `WAIT_FOR_TIMER invalid \"until\" datetime: ${until}`,\n        'TIMER_CONFIG_INVALID',\n        { until }\n      )\n    }\n    fireAtMs = targetDate.getTime()\n  } else {\n    fireAtMs = Date.now() + parseDuration(duration as string)\n  }\n\n  const delayMs = fireAtMs - Date.now()\n  const fireAt = new Date(fireAtMs)\n\n  // Immediate-fire path: skip the queue round-trip if the timer is in the past\n  if (delayMs <= 0) {\n    return {\n      status: 'COMPLETED',\n      outputData: {\n        stepType: 'WAIT_FOR_TIMER',\n        timerFiredImmediately: true,\n        fireAt,\n        duration,\n        until,\n      },\n    }\n  }\n\n  const now = new Date()\n\n  // Enqueue delayed timer job via the shared activity queue.\n  // Imported here to avoid a top-level cycle between step-handler and activity-executor.\n  const { enqueueTimerJob } = await import('./activity-executor')\n  const jobId = await enqueueTimerJob({\n    workflowInstanceId: instance.id,\n    stepInstanceId: stepInstance.id,\n    branchInstanceId: branch ? branch.id : undefined,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n    userId: context.userId,\n    fireAt: fireAt.toISOString(),\n    delayMs,\n  })\n\n  await logWorkflowEvent(em, {\n    workflowInstanceId: instance.id,\n    stepInstanceId: stepInstance.id,\n    ...(branch ? { branchInstanceId: branch.id } : {}),\n    eventType: 'TIMER_AWAITING',\n    eventData: {\n      fireAt: fireAt.toISOString(),\n      duration: duration || null,\n      until: until || null,\n      jobId,\n    },\n    userId: context.userId,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n  })\n\n  if (branch) {\n    branch.status = 'PAUSED'\n    branch.updatedAt = now\n  } else {\n    instance.status = 'PAUSED'\n    instance.pausedAt = now\n    instance.updatedAt = now\n  }\n  await em.flush()\n\n  return {\n    status: 'WAITING',\n    waitReason: 'TIMER',\n    outputData: {\n      fireAt,\n      duration,\n      until,\n      jobId,\n    },\n  }\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n// parseDuration is imported from ./duration\n\n/**\n * Log step-related event to event sourcing table\n */\nasync function logStepEvent(\n  em: EntityManager,\n  event: {\n    workflowInstanceId: string\n    stepInstanceId: string\n    branchInstanceId?: string | null\n    eventType: string\n    eventData: any\n    userId?: string\n    tenantId: string\n    organizationId: string\n  }\n): Promise<WorkflowEvent> {\n  const workflowEvent = em.create(WorkflowEvent, {\n    ...event,\n    occurredAt: new Date(),\n  })\n\n  await em.persist(workflowEvent).flush()\n  return workflowEvent\n}\n\n/**\n * Calculate due date from ISO 8601 duration string\n *\n * @param duration - ISO 8601 duration (e.g., \"P1D\" for 1 day)\n * @returns Due date\n */\nfunction calculateDueDate(duration: string): Date {\n  // Simple implementation for MVP\n  // Supports: P1D (1 day), P1H (1 hour), P1W (1 week)\n  const now = new Date()\n\n  const daysMatch = duration.match(/P(\\d+)D/)\n  if (daysMatch) {\n    const days = parseInt(daysMatch[1], 10)\n    return new Date(now.getTime() + days * 24 * 60 * 60 * 1000)\n  }\n\n  const hoursMatch = duration.match(/PT(\\d+)H/)\n  if (hoursMatch) {\n    const hours = parseInt(hoursMatch[1], 10)\n    return new Date(now.getTime() + hours * 60 * 60 * 1000)\n  }\n\n  const weeksMatch = duration.match(/P(\\d+)W/)\n  if (weeksMatch) {\n    const weeks = parseInt(weeksMatch[1], 10)\n    return new Date(now.getTime() + weeks * 7 * 24 * 60 * 60 * 1000)\n  }\n\n  // Default: 1 day\n  return new Date(now.getTime() + 24 * 60 * 60 * 1000)\n}\n\n/**\n * Get nested value from object using dot notation\n *\n * @param obj - Source object\n * @param path - Dot-notation path (e.g., \"user.email\")\n * @returns Value at path or undefined\n */\nfunction getNestedValue(obj: any, path: string): any {\n  return path.split('.').reduce((current, key) => current?.[key], obj)\n}\n\n/**\n * Set nested value in object using dot notation\n *\n * @param obj - Target object\n * @param path - Dot-notation path (e.g., \"user.email\")\n * @param value - Value to set\n */\nfunction setNestedValue(obj: any, path: string, value: any): void {\n  const keys = path.split('.')\n  const lastKey = keys.pop()!\n  const target = keys.reduce((current, key) => {\n    if (!(key in current)) current[key] = {}\n    return current[key]\n  }, obj)\n  target[lastKey] = value\n}\n\n/**\n * Map data from source context using mapping configuration\n *\n * @param sourceContext - Source data object\n * @param mapping - Mapping configuration (targetKey -> sourcePath)\n * @returns Mapped data object\n */\nfunction mapInputData(\n  sourceContext: Record<string, any>,\n  mapping: Record<string, string>\n): Record<string, any> {\n  const result: Record<string, any> = {}\n\n  for (const [targetKey, sourcePath] of Object.entries(mapping)) {\n    const value = getNestedValue(sourceContext, sourcePath)\n    if (value !== undefined) {\n      setNestedValue(result, targetKey, value)\n    }\n  }\n\n  // If no mapping provided, pass entire context\n  return Object.keys(result).length > 0 ? result : sourceContext\n}\n\n/**\n * Map output data from child context back to parent\n *\n * @param childContext - Child workflow context\n * @param mapping - Mapping configuration (targetKey -> sourcePath)\n * @returns Mapped output data\n */\nfunction mapOutputData(\n  childContext: Record<string, any>,\n  mapping: Record<string, string>\n): Record<string, any> {\n  const result: Record<string, any> = {}\n\n  for (const [targetKey, sourcePath] of Object.entries(mapping)) {\n    const value = getNestedValue(childContext, sourcePath)\n    if (value !== undefined) {\n      setNestedValue(result, targetKey, value)\n    }\n  }\n\n  // If no mapping provided, pass entire child context\n  return Object.keys(result).length > 0 ? result : childContext\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/workflows/lib/task-handler.js CHANGED Viewed

@@ -2,10 +2,10 @@ import {
   UserTask,
   WorkflowInstance,
   WorkflowEvent,
-  StepInstance,
-  WorkflowDefinition
+  StepInstance
 } from "../data/entities.js";
 import { executeWorkflow } from "./workflow-executor.js";
+import { findDefinitionForInstance } from "./find-definition.js";
 import * as stepHandler from "./step-handler.js";
 import * as transitionHandler from "./transition-handler.js";
 import { createLogger } from "@open-mercato/shared/lib/logger";
@@ -111,9 +111,7 @@ async function completeUserTask(em, container, options) {
     await stepHandler.exitStep(em, stepInstance, { userTaskId: task.id, formData });
   }
   const currentStepId = instance.currentStepId;
-  const definition = await em.findOne(WorkflowDefinition, {
-    id: instance.definitionId
-  });
+  const definition = await findDefinitionForInstance(em, instance);
   if (!definition) {
     throw new UserTaskError(
       "Workflow definition not found",

package/dist/modules/workflows/lib/task-handler.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/workflows/lib/task-handler.ts"],
-  "sourcesContent": ["/**\n * Workflows Module - User Task Handler Service\n *\n * Handles user task lifecycle operations:\n * - Completing user tasks\n * - Claiming tasks from role queues\n * - Reassigning tasks\n * - Escalating overdue tasks\n *\n * Functional API (no classes) following Open Mercato conventions.\n */\n\nimport { EntityManager } from '@mikro-orm/core'\nimport type { AwilixContainer } from 'awilix'\nimport {\n  UserTask,\n  WorkflowInstance,\n  WorkflowEvent,\n  StepInstance,\n  WorkflowDefinition,\n} from '../data/entities'\nimport { executeWorkflow } from './workflow-executor'\nimport * as stepHandler from './step-handler'\nimport * as transitionHandler from './transition-handler'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\n\nconst logger = createLogger('workflows')\n\n// ============================================================================\n// Types and Interfaces\n// ============================================================================\n\nexport interface CompleteUserTaskOptions {\n  taskId: string\n  formData: Record<string, any>\n  userId: string\n  comments?: string\n}\n\nexport class UserTaskError extends Error {\n  constructor(\n    message: string,\n    public code: string,\n    public details?: any\n  ) {\n    super(message)\n    this.name = 'UserTaskError'\n  }\n}\n\n// ============================================================================\n// User Task Completion\n// ============================================================================\n\n/**\n * Complete a user task and resume workflow execution\n *\n * This function:\n * 1. Validates the task exists and can be completed\n * 2. Updates the task with form data and completion info\n * 3. Merges form data into workflow context\n * 4. Logs completion event\n * 5. Resumes workflow execution\n *\n * @param em - Entity manager\n * @param container - DI container for workflow execution\n * @param options - Task completion options\n * @throws UserTaskError if task not found or validation fails\n */\nexport async function completeUserTask(\n  em: EntityManager,\n  container: AwilixContainer,\n  options: CompleteUserTaskOptions\n): Promise<void> {\n  const { taskId, formData, userId, comments } = options\n\n  // Fetch task\n  const task = await em.findOne(UserTask, {\n    id: taskId,\n    status: { $in: ['PENDING', 'IN_PROGRESS'] },\n  })\n\n  if (!task) {\n    throw new UserTaskError(\n      'Task not found or already completed',\n      'TASK_NOT_FOUND',\n      { taskId }\n    )\n  }\n\n  // Validate form data against schema (simple validation for MVP)\n  // In Phase 7, we'll add comprehensive JSON Schema validation\n  if (task.formSchema) {\n    try {\n      validateFormData(formData, task.formSchema)\n    } catch (error) {\n      throw new UserTaskError(\n        error instanceof Error ? error.message : 'Form validation failed',\n        'FORM_VALIDATION_FAILED',\n        { taskId, formSchema: task.formSchema, formData }\n      )\n    }\n  }\n\n  // Update task\n  const now = new Date()\n  task.status = 'COMPLETED'\n  task.formData = formData\n  task.completedBy = userId\n  task.completedAt = now\n  task.comments = comments || null\n  task.updatedAt = now\n\n  await em.flush()\n\n  // Fetch workflow instance\n  const instance = await em.findOne(WorkflowInstance, task.workflowInstanceId)\n  if (!instance) {\n    throw new UserTaskError(\n      'Workflow instance not found',\n      'INSTANCE_NOT_FOUND',\n      { workflowInstanceId: task.workflowInstanceId }\n    )\n  }\n\n  // Branch-scoped completion: when the task belongs to a parallel branch,\n  // merge form data into the branch namespace and resume just that branch.\n  if (task.branchInstanceId) {\n    await logWorkflowEvent(em, {\n      workflowInstanceId: instance.id,\n      stepInstanceId: task.stepInstanceId,\n      branchInstanceId: task.branchInstanceId,\n      eventType: 'USER_TASK_COMPLETED',\n      eventData: { taskId: task.id, taskName: task.taskName, completedBy: userId, formData },\n      userId,\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n    })\n\n    const { resumeBranch } = await import('./parallel-handler')\n    const resumed = await resumeBranch(em, {\n      instanceId: instance.id,\n      branchInstanceId: task.branchInstanceId,\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n      contextMerge: formData,\n      exitStepInstanceId: task.stepInstanceId,\n      exitOutput: { userTaskId: task.id, formData },\n    })\n\n    if (resumed) {\n      await executeWorkflow(em, container, instance.id, { userId })\n    }\n    return\n  }\n\n  // Merge form data into workflow context\n  instance.context = {\n    ...instance.context,\n    ...formData,\n  }\n  instance.updatedAt = now\n\n  // Log USER_TASK_COMPLETED event\n  await logWorkflowEvent(em, {\n    workflowInstanceId: instance.id,\n    stepInstanceId: task.stepInstanceId,\n    eventType: 'USER_TASK_COMPLETED',\n    eventData: {\n      taskId: task.id,\n      taskName: task.taskName,\n      completedBy: userId,\n      formData,\n    },\n    userId,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n  })\n\n  // Mark the step instance as completed\n  const stepInstance = await em.findOne(StepInstance, {\n    id: task.stepInstanceId,\n    status: 'ACTIVE',\n  })\n\n  if (stepInstance) {\n    await stepHandler.exitStep(em, stepInstance, { userTaskId: task.id, formData })\n  }\n\n  // Find the next automatic transition from the current step\n  const currentStepId = instance.currentStepId\n\n  // Load workflow definition to find transitions\n  const definition = await em.findOne(WorkflowDefinition, {\n    id: instance.definitionId,\n  })\n\n  if (!definition) {\n    throw new UserTaskError(\n      'Workflow definition not found',\n      'DEFINITION_NOT_FOUND',\n      { definitionId: instance.definitionId }\n    )\n  }\n\n  // Find automatic transitions from current step\n  const autoTransitions = (definition.definition.transitions || []).filter(\n    (t: any) => t.fromStepId === currentStepId && t.trigger === 'auto'\n  )\n\n  if (autoTransitions.length === 0) {\n    // No automatic transitions, workflow stays paused at current step\n    return\n  }\n\n  // Find valid transitions using transition handler\n  const transitionContext = {\n    workflowContext: instance.context,\n    userId,\n  }\n\n  const validTransitions = await transitionHandler.findValidTransitions(\n    em,\n    instance,\n    currentStepId,\n    transitionContext\n  )\n\n  const firstValidTransition = validTransitions.find(t => t.isValid)\n\n  if (!firstValidTransition || !firstValidTransition.transition) {\n    // Resume workflow execution anyway, maybe conditions will be met later\n    instance.status = 'RUNNING'\n    await em.flush()\n    return\n  }\n\n  // Execute the transition to move to next step\n\n  const transitionResult = await transitionHandler.executeTransition(\n    em,\n    container,\n    instance,\n    currentStepId,\n    firstValidTransition.transition.toStepId,\n    transitionContext\n  )\n\n  if (!transitionResult.success) {\n    logger.error('Transition failed', { component: 'task-handler', err: transitionResult.error })\n    // Don't throw, just leave workflow in current state\n    return\n  }\n\n  // Now continue workflow execution from the new step\n  await executeWorkflow(em, container, instance.id, { userId })\n}\n\n/**\n * Claim a user task from a role queue\n *\n * Allows a user to claim a task that's assigned to their role(s).\n * Prevents race conditions by checking task status.\n *\n * @param em - Entity manager\n * @param taskId - Task ID to claim\n * @param userId - User claiming the task\n * @throws UserTaskError if task cannot be claimed\n */\nexport async function claimUserTask(\n  em: EntityManager,\n  taskId: string,\n  userId: string\n): Promise<void> {\n  const task = await em.findOne(UserTask, {\n    id: taskId,\n    status: 'PENDING',\n  })\n\n  if (!task) {\n    throw new UserTaskError(\n      'Task not found or already claimed',\n      'TASK_NOT_FOUND',\n      { taskId }\n    )\n  }\n\n  if (task.assignedTo) {\n    throw new UserTaskError(\n      'Task is already assigned to a specific user',\n      'TASK_ALREADY_ASSIGNED',\n      { taskId, assignedTo: task.assignedTo }\n    )\n  }\n\n  if (!task.assignedToRoles || task.assignedToRoles.length === 0) {\n    throw new UserTaskError(\n      'Task is not assigned to any roles',\n      'TASK_NOT_ROLE_ASSIGNED',\n      { taskId }\n    )\n  }\n\n  // Update task\n  const now = new Date()\n  task.claimedBy = userId\n  task.claimedAt = now\n  task.status = 'IN_PROGRESS'\n  task.updatedAt = now\n\n  await em.flush()\n\n  // Log event\n  const instance = await em.findOne(WorkflowInstance, task.workflowInstanceId)\n  if (instance) {\n    await logWorkflowEvent(em, {\n      workflowInstanceId: instance.id,\n      stepInstanceId: task.stepInstanceId,\n      eventType: 'USER_TASK_STARTED',\n      eventData: {\n        taskId: task.id,\n        taskName: task.taskName,\n        claimedBy: userId,\n      },\n      userId,\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n    })\n  }\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Log workflow event to event sourcing table\n */\nasync function logWorkflowEvent(\n  em: EntityManager,\n  event: {\n    workflowInstanceId: string\n    stepInstanceId: string | null\n    branchInstanceId?: string | null\n    eventType: string\n    eventData: any\n    userId?: string\n    tenantId: string\n    organizationId: string\n  }\n): Promise<WorkflowEvent> {\n  const workflowEvent = em.create(WorkflowEvent, {\n    ...event,\n    occurredAt: new Date(),\n  })\n\n  await em.persist(workflowEvent).flush()\n  return workflowEvent\n}\n\n/**\n * Validate form data against JSON schema (basic validation for MVP)\n *\n * In Phase 7, we'll implement comprehensive JSON Schema validation.\n * For MVP, we do basic type checking.\n *\n * @param formData - User-provided form data\n * @param formSchema - JSON schema defining expected structure\n * @throws Error if validation fails\n */\nfunction validateFormData(\n  formData: Record<string, any>,\n  formSchema: any\n): void {\n  // For MVP: Basic validation - just check required fields exist\n  if (!formSchema || !formSchema.properties) {\n    return // No schema to validate against\n  }\n\n  const requiredFields = formSchema.required || []\n\n  for (const field of requiredFields) {\n    if (!(field in formData) || formData[field] === null || formData[field] === undefined) {\n      throw new Error(`Required field missing: ${field}`)\n    }\n  }\n\n  // Additional type validation can be added in Phase 7\n  // For now, this basic validation is sufficient\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Workflows Module - User Task Handler Service\n *\n * Handles user task lifecycle operations:\n * - Completing user tasks\n * - Claiming tasks from role queues\n * - Reassigning tasks\n * - Escalating overdue tasks\n *\n * Functional API (no classes) following Open Mercato conventions.\n */\n\nimport { EntityManager } from '@mikro-orm/core'\nimport type { AwilixContainer } from 'awilix'\nimport {\n  UserTask,\n  WorkflowInstance,\n  WorkflowEvent,\n  StepInstance,\n} from '../data/entities'\nimport { executeWorkflow } from './workflow-executor'\nimport { findDefinitionForInstance } from './find-definition'\nimport * as stepHandler from './step-handler'\nimport * as transitionHandler from './transition-handler'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\n\nconst logger = createLogger('workflows')\n\n// ============================================================================\n// Types and Interfaces\n// ============================================================================\n\nexport interface CompleteUserTaskOptions {\n  taskId: string\n  formData: Record<string, any>\n  userId: string\n  comments?: string\n}\n\nexport class UserTaskError extends Error {\n  constructor(\n    message: string,\n    public code: string,\n    public details?: any\n  ) {\n    super(message)\n    this.name = 'UserTaskError'\n  }\n}\n\n// ============================================================================\n// User Task Completion\n// ============================================================================\n\n/**\n * Complete a user task and resume workflow execution\n *\n * This function:\n * 1. Validates the task exists and can be completed\n * 2. Updates the task with form data and completion info\n * 3. Merges form data into workflow context\n * 4. Logs completion event\n * 5. Resumes workflow execution\n *\n * @param em - Entity manager\n * @param container - DI container for workflow execution\n * @param options - Task completion options\n * @throws UserTaskError if task not found or validation fails\n */\nexport async function completeUserTask(\n  em: EntityManager,\n  container: AwilixContainer,\n  options: CompleteUserTaskOptions\n): Promise<void> {\n  const { taskId, formData, userId, comments } = options\n\n  // Fetch task\n  const task = await em.findOne(UserTask, {\n    id: taskId,\n    status: { $in: ['PENDING', 'IN_PROGRESS'] },\n  })\n\n  if (!task) {\n    throw new UserTaskError(\n      'Task not found or already completed',\n      'TASK_NOT_FOUND',\n      { taskId }\n    )\n  }\n\n  // Validate form data against schema (simple validation for MVP)\n  // In Phase 7, we'll add comprehensive JSON Schema validation\n  if (task.formSchema) {\n    try {\n      validateFormData(formData, task.formSchema)\n    } catch (error) {\n      throw new UserTaskError(\n        error instanceof Error ? error.message : 'Form validation failed',\n        'FORM_VALIDATION_FAILED',\n        { taskId, formSchema: task.formSchema, formData }\n      )\n    }\n  }\n\n  // Update task\n  const now = new Date()\n  task.status = 'COMPLETED'\n  task.formData = formData\n  task.completedBy = userId\n  task.completedAt = now\n  task.comments = comments || null\n  task.updatedAt = now\n\n  await em.flush()\n\n  // Fetch workflow instance\n  const instance = await em.findOne(WorkflowInstance, task.workflowInstanceId)\n  if (!instance) {\n    throw new UserTaskError(\n      'Workflow instance not found',\n      'INSTANCE_NOT_FOUND',\n      { workflowInstanceId: task.workflowInstanceId }\n    )\n  }\n\n  // Branch-scoped completion: when the task belongs to a parallel branch,\n  // merge form data into the branch namespace and resume just that branch.\n  if (task.branchInstanceId) {\n    await logWorkflowEvent(em, {\n      workflowInstanceId: instance.id,\n      stepInstanceId: task.stepInstanceId,\n      branchInstanceId: task.branchInstanceId,\n      eventType: 'USER_TASK_COMPLETED',\n      eventData: { taskId: task.id, taskName: task.taskName, completedBy: userId, formData },\n      userId,\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n    })\n\n    const { resumeBranch } = await import('./parallel-handler')\n    const resumed = await resumeBranch(em, {\n      instanceId: instance.id,\n      branchInstanceId: task.branchInstanceId,\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n      contextMerge: formData,\n      exitStepInstanceId: task.stepInstanceId,\n      exitOutput: { userTaskId: task.id, formData },\n    })\n\n    if (resumed) {\n      await executeWorkflow(em, container, instance.id, { userId })\n    }\n    return\n  }\n\n  // Merge form data into workflow context\n  instance.context = {\n    ...instance.context,\n    ...formData,\n  }\n  instance.updatedAt = now\n\n  // Log USER_TASK_COMPLETED event\n  await logWorkflowEvent(em, {\n    workflowInstanceId: instance.id,\n    stepInstanceId: task.stepInstanceId,\n    eventType: 'USER_TASK_COMPLETED',\n    eventData: {\n      taskId: task.id,\n      taskName: task.taskName,\n      completedBy: userId,\n      formData,\n    },\n    userId,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n  })\n\n  // Mark the step instance as completed\n  const stepInstance = await em.findOne(StepInstance, {\n    id: task.stepInstanceId,\n    status: 'ACTIVE',\n  })\n\n  if (stepInstance) {\n    await stepHandler.exitStep(em, stepInstance, { userTaskId: task.id, formData })\n  }\n\n  // Find the next automatic transition from the current step\n  const currentStepId = instance.currentStepId\n\n  // Load workflow definition to find transitions\n  const definition = await findDefinitionForInstance(em, instance)\n\n  if (!definition) {\n    throw new UserTaskError(\n      'Workflow definition not found',\n      'DEFINITION_NOT_FOUND',\n      { definitionId: instance.definitionId }\n    )\n  }\n\n  // Find automatic transitions from current step\n  const autoTransitions = (definition.definition.transitions || []).filter(\n    (t: any) => t.fromStepId === currentStepId && t.trigger === 'auto'\n  )\n\n  if (autoTransitions.length === 0) {\n    // No automatic transitions, workflow stays paused at current step\n    return\n  }\n\n  // Find valid transitions using transition handler\n  const transitionContext = {\n    workflowContext: instance.context,\n    userId,\n  }\n\n  const validTransitions = await transitionHandler.findValidTransitions(\n    em,\n    instance,\n    currentStepId,\n    transitionContext\n  )\n\n  const firstValidTransition = validTransitions.find(t => t.isValid)\n\n  if (!firstValidTransition || !firstValidTransition.transition) {\n    // Resume workflow execution anyway, maybe conditions will be met later\n    instance.status = 'RUNNING'\n    await em.flush()\n    return\n  }\n\n  // Execute the transition to move to next step\n\n  const transitionResult = await transitionHandler.executeTransition(\n    em,\n    container,\n    instance,\n    currentStepId,\n    firstValidTransition.transition.toStepId,\n    transitionContext\n  )\n\n  if (!transitionResult.success) {\n    logger.error('Transition failed', { component: 'task-handler', err: transitionResult.error })\n    // Don't throw, just leave workflow in current state\n    return\n  }\n\n  // Now continue workflow execution from the new step\n  await executeWorkflow(em, container, instance.id, { userId })\n}\n\n/**\n * Claim a user task from a role queue\n *\n * Allows a user to claim a task that's assigned to their role(s).\n * Prevents race conditions by checking task status.\n *\n * @param em - Entity manager\n * @param taskId - Task ID to claim\n * @param userId - User claiming the task\n * @throws UserTaskError if task cannot be claimed\n */\nexport async function claimUserTask(\n  em: EntityManager,\n  taskId: string,\n  userId: string\n): Promise<void> {\n  const task = await em.findOne(UserTask, {\n    id: taskId,\n    status: 'PENDING',\n  })\n\n  if (!task) {\n    throw new UserTaskError(\n      'Task not found or already claimed',\n      'TASK_NOT_FOUND',\n      { taskId }\n    )\n  }\n\n  if (task.assignedTo) {\n    throw new UserTaskError(\n      'Task is already assigned to a specific user',\n      'TASK_ALREADY_ASSIGNED',\n      { taskId, assignedTo: task.assignedTo }\n    )\n  }\n\n  if (!task.assignedToRoles || task.assignedToRoles.length === 0) {\n    throw new UserTaskError(\n      'Task is not assigned to any roles',\n      'TASK_NOT_ROLE_ASSIGNED',\n      { taskId }\n    )\n  }\n\n  // Update task\n  const now = new Date()\n  task.claimedBy = userId\n  task.claimedAt = now\n  task.status = 'IN_PROGRESS'\n  task.updatedAt = now\n\n  await em.flush()\n\n  // Log event\n  const instance = await em.findOne(WorkflowInstance, task.workflowInstanceId)\n  if (instance) {\n    await logWorkflowEvent(em, {\n      workflowInstanceId: instance.id,\n      stepInstanceId: task.stepInstanceId,\n      eventType: 'USER_TASK_STARTED',\n      eventData: {\n        taskId: task.id,\n        taskName: task.taskName,\n        claimedBy: userId,\n      },\n      userId,\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n    })\n  }\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Log workflow event to event sourcing table\n */\nasync function logWorkflowEvent(\n  em: EntityManager,\n  event: {\n    workflowInstanceId: string\n    stepInstanceId: string | null\n    branchInstanceId?: string | null\n    eventType: string\n    eventData: any\n    userId?: string\n    tenantId: string\n    organizationId: string\n  }\n): Promise<WorkflowEvent> {\n  const workflowEvent = em.create(WorkflowEvent, {\n    ...event,\n    occurredAt: new Date(),\n  })\n\n  await em.persist(workflowEvent).flush()\n  return workflowEvent\n}\n\n/**\n * Validate form data against JSON schema (basic validation for MVP)\n *\n * In Phase 7, we'll implement comprehensive JSON Schema validation.\n * For MVP, we do basic type checking.\n *\n * @param formData - User-provided form data\n * @param formSchema - JSON schema defining expected structure\n * @throws Error if validation fails\n */\nfunction validateFormData(\n  formData: Record<string, any>,\n  formSchema: any\n): void {\n  // For MVP: Basic validation - just check required fields exist\n  if (!formSchema || !formSchema.properties) {\n    return // No schema to validate against\n  }\n\n  const requiredFields = formSchema.required || []\n\n  for (const field of requiredFields) {\n    if (!(field in formData) || formData[field] === null || formData[field] === undefined) {\n      throw new Error(`Required field missing: ${field}`)\n    }\n  }\n\n  // Additional type validation can be added in Phase 7\n  // For now, this basic validation is sufficient\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/workflows/lib/timer-handler.js CHANGED Viewed

@@ -1,5 +1,6 @@
 import { findOneWithDecryption } from "@open-mercato/shared/lib/encryption/find";
 import { WorkflowInstance, WorkflowDefinition, StepInstance } from "../data/entities.js";
+import { resolveCodeDefinitionForInstance } from "./find-definition.js";
 class TimerError extends Error {
   constructor(message, code, details) {
     super(message);
@@ -75,7 +76,7 @@ async function fireTimer(em, container, options) {
     },
     void 0,
     { tenantId: instance.tenantId, organizationId: instance.organizationId }
-  );
+  ) ?? resolveCodeDefinitionForInstance(instance);
   if (!definition) {
     throw new TimerError(
       "Workflow definition not found",

package/dist/modules/workflows/lib/timer-handler.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/workflows/lib/timer-handler.ts"],
-  "sourcesContent": ["/**\n * Timer Handler Service\n *\n * Fires timers for WAIT_FOR_TIMER steps: resumes a paused workflow instance\n * when its scheduled timer job is processed by the activity worker.\n */\n\nimport { EntityManager } from '@mikro-orm/core'\nimport type { EntityManager as PostgreSqlEntityManager } from '@mikro-orm/postgresql'\nimport type { AwilixContainer } from 'awilix'\nimport { findOneWithDecryption } from '@open-mercato/shared/lib/encryption/find'\nimport { WorkflowInstance, WorkflowDefinition, StepInstance } from '../data/entities'\nimport type * as eventLoggerModule from './event-logger'\nimport type * as stepHandlerModule from './step-handler'\nimport type * as transitionHandlerModule from './transition-handler'\nimport type * as workflowExecutorModule from './workflow-executor'\n\nexport interface FireTimerOptions {\n  instanceId: string\n  stepInstanceId?: string\n  branchInstanceId?: string | null\n  userId?: string\n  tenantId: string\n  organizationId: string\n}\n\nexport class TimerError extends Error {\n  constructor(\n    message: string,\n    public code: string,\n    public details?: any\n  ) {\n    super(message)\n    this.name = 'TimerError'\n  }\n}\n\n/**\n * Fire a timer and resume workflow execution.\n *\n * Mirrors `sendSignal` from signal-handler.ts \u2014 verifies the instance is\n * paused at a WAIT_FOR_TIMER step, logs TIMER_FIRED, exits the step, then\n * executes auto transitions and resumes the workflow.\n */\nexport async function fireTimer(\n  em: EntityManager,\n  container: AwilixContainer,\n  options: FireTimerOptions\n): Promise<void> {\n  const { instanceId, stepInstanceId, branchInstanceId, userId, tenantId, organizationId } = options\n\n  const eventLogger = container.resolve<typeof eventLoggerModule>('eventLogger')\n  const stepHandler = container.resolve<typeof stepHandlerModule>('stepHandler')\n  const transitionHandler = container.resolve<typeof transitionHandlerModule>('transitionHandler')\n  const workflowExecutor = container.resolve<typeof workflowExecutorModule>('workflowExecutor')\n\n  // Branch-scoped timer: the instance is FORKED and the branch is PAUSED at the\n  // WAIT_FOR_TIMER step. Resume just that branch, then drive the parallel loop.\n  if (branchInstanceId) {\n    await eventLogger.logWorkflowEvent(em, {\n      workflowInstanceId: instanceId,\n      stepInstanceId,\n      branchInstanceId,\n      eventType: 'TIMER_FIRED',\n      eventData: { firedAt: new Date().toISOString(), branch: true },\n      userId,\n      tenantId,\n      organizationId,\n    })\n    const { resumeBranch } = await import('./parallel-handler')\n    const resumed = await resumeBranch(em, {\n      instanceId,\n      branchInstanceId,\n      tenantId,\n      organizationId,\n      exitStepInstanceId: stepInstanceId,\n      exitOutput: { firedAt: new Date().toISOString() },\n    })\n    if (resumed) {\n      await workflowExecutor.executeWorkflow(em, container, instanceId, { userId })\n    }\n    return\n  }\n\n  const instance = await findOneWithDecryption(\n    em as PostgreSqlEntityManager,\n    WorkflowInstance,\n    {\n      id: instanceId,\n      tenantId,\n      organizationId,\n    },\n    undefined,\n    { tenantId, organizationId },\n  )\n\n  if (!instance) {\n    throw new TimerError(\n      'Workflow instance not found',\n      'INSTANCE_NOT_FOUND',\n      { instanceId }\n    )\n  }\n\n  if (instance.status !== 'PAUSED') {\n    throw new TimerError(\n      'Workflow is not paused',\n      'WORKFLOW_NOT_PAUSED',\n      { instanceId, status: instance.status }\n    )\n  }\n\n  const definition = await findOneWithDecryption(\n    em as PostgreSqlEntityManager,\n    WorkflowDefinition,\n    {\n      id: instance.definitionId,\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n      deletedAt: null,\n    },\n    undefined,\n    { tenantId: instance.tenantId, organizationId: instance.organizationId },\n  )\n  if (!definition) {\n    throw new TimerError(\n      'Workflow definition not found',\n      'DEFINITION_NOT_FOUND',\n      { definitionId: instance.definitionId }\n    )\n  }\n\n  const currentStep = definition.definition.steps.find(\n    (s: any) => s.stepId === instance.currentStepId\n  )\n\n  if (!currentStep || currentStep.stepType !== 'WAIT_FOR_TIMER') {\n    throw new TimerError(\n      'Workflow is not waiting for timer',\n      'NOT_WAITING_FOR_TIMER',\n      { instanceId, currentStepId: instance.currentStepId }\n    )\n  }\n\n  const now = new Date()\n  instance.updatedAt = now\n\n  await eventLogger.logWorkflowEvent(em, {\n    workflowInstanceId: instance.id,\n    stepInstanceId,\n    eventType: 'TIMER_FIRED',\n    eventData: {\n      stepId: instance.currentStepId,\n      firedAt: now.toISOString(),\n    },\n    userId,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n  })\n\n  const stepInstance = stepInstanceId\n    ? await findOneWithDecryption(\n        em as PostgreSqlEntityManager,\n        StepInstance,\n        {\n          id: stepInstanceId,\n          workflowInstanceId: instance.id,\n          tenantId: instance.tenantId,\n          organizationId: instance.organizationId,\n        },\n        undefined,\n        { tenantId: instance.tenantId, organizationId: instance.organizationId },\n      )\n    : await findOneWithDecryption(\n        em as PostgreSqlEntityManager,\n        StepInstance,\n        {\n          workflowInstanceId: instance.id,\n          stepId: instance.currentStepId,\n          status: 'ACTIVE',\n          tenantId: instance.tenantId,\n          organizationId: instance.organizationId,\n        },\n        undefined,\n        { tenantId: instance.tenantId, organizationId: instance.organizationId },\n      )\n\n  if (stepInstance) {\n    await stepHandler.exitStep(em, stepInstance, {\n      firedAt: now.toISOString(),\n    })\n  }\n\n  const autoTransitions = (definition.definition.transitions || []).filter(\n    (t: any) => t.fromStepId === instance.currentStepId && t.trigger === 'auto'\n  )\n\n  if (autoTransitions.length === 0) {\n    instance.status = 'RUNNING'\n    await em.flush()\n    return\n  }\n\n  const transitionContext = {\n    workflowContext: instance.context,\n    userId,\n  }\n\n  const validTransitions = await transitionHandler.findValidTransitions(\n    em,\n    instance,\n    instance.currentStepId,\n    transitionContext\n  )\n\n  const firstValidTransition = validTransitions.find((t) => t.isValid)\n\n  if (!firstValidTransition || !firstValidTransition.transition) {\n    instance.status = 'RUNNING'\n    await em.flush()\n    return\n  }\n\n  const transitionResult = await transitionHandler.executeTransition(\n    em,\n    container,\n    instance,\n    instance.currentStepId,\n    firstValidTransition.transition.toStepId,\n    transitionContext\n  )\n\n  if (!transitionResult.success) {\n    throw new TimerError(\n      'Transition failed after timer fired',\n      'TRANSITION_FAILED',\n      { error: transitionResult.error }\n    )\n  }\n\n  await workflowExecutor.executeWorkflow(em, container, instance.id, { userId })\n}\n"],
-  "mappings": "AAUA,SAAS,6BAA6B;AACtC,SAAS,kBAAkB,oBAAoB,oBAAoB;AAe5D,MAAM,mBAAmB,MAAM;AAAA,EACpC,YACE,SACO,MACA,SACP;AACA,UAAM,OAAO;AAHN;AACA;AAGP,SAAK,OAAO;AAAA,EACd;AACF;AASA,eAAsB,UACpB,IACA,WACA,SACe;AACf,QAAM,EAAE,YAAY,gBAAgB,kBAAkB,QAAQ,UAAU,eAAe,IAAI;AAE3F,QAAM,cAAc,UAAU,QAAkC,aAAa;AAC7E,QAAM,cAAc,UAAU,QAAkC,aAAa;AAC7E,QAAM,oBAAoB,UAAU,QAAwC,mBAAmB;AAC/F,QAAM,mBAAmB,UAAU,QAAuC,kBAAkB;AAI5F,MAAI,kBAAkB;AACpB,UAAM,YAAY,iBAAiB,IAAI;AAAA,MACrC,oBAAoB;AAAA,MACpB;AAAA,MACA;AAAA,MACA,WAAW;AAAA,MACX,WAAW,EAAE,UAAS,oBAAI,KAAK,GAAE,YAAY,GAAG,QAAQ,KAAK;AAAA,MAC7D;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AACD,UAAM,EAAE,aAAa,IAAI,MAAM,OAAO,oBAAoB;AAC1D,UAAM,UAAU,MAAM,aAAa,IAAI;AAAA,MACrC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,oBAAoB;AAAA,MACpB,YAAY,EAAE,UAAS,oBAAI,KAAK,GAAE,YAAY,EAAE;AAAA,IAClD,CAAC;AACD,QAAI,SAAS;AACX,YAAM,iBAAiB,gBAAgB,IAAI,WAAW,YAAY,EAAE,OAAO,CAAC;AAAA,IAC9E;AACA;AAAA,EACF;AAEA,QAAM,WAAW,MAAM;AAAA,IACrB;AAAA,IACA;AAAA,IACA;AAAA,MACE,IAAI;AAAA,MACJ;AAAA,MACA;AAAA,IACF;AAAA,IACA;AAAA,IACA,EAAE,UAAU,eAAe;AAAA,EAC7B;AAEA,MAAI,CAAC,UAAU;AACb,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,MACA,EAAE,WAAW;AAAA,IACf;AAAA,EACF;AAEA,MAAI,SAAS,WAAW,UAAU;AAChC,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,MACA,EAAE,YAAY,QAAQ,SAAS,OAAO;AAAA,IACxC;AAAA,EACF;AAEA,QAAM,aAAa,MAAM;AAAA,IACvB;AAAA,IACA;AAAA,IACA;AAAA,MACE,IAAI,SAAS;AAAA,MACb,UAAU,SAAS;AAAA,MACnB,gBAAgB,SAAS;AAAA,MACzB,WAAW;AAAA,IACb;AAAA,IACA;AAAA,IACA,EAAE,UAAU,SAAS,UAAU,gBAAgB,SAAS,eAAe;AAAA,EACzE;AACA,MAAI,CAAC,YAAY;AACf,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,MACA,EAAE,cAAc,SAAS,aAAa;AAAA,IACxC;AAAA,EACF;AAEA,QAAM,cAAc,WAAW,WAAW,MAAM;AAAA,IAC9C,CAAC,MAAW,EAAE,WAAW,SAAS;AAAA,EACpC;AAEA,MAAI,CAAC,eAAe,YAAY,aAAa,kBAAkB;AAC7D,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,MACA,EAAE,YAAY,eAAe,SAAS,cAAc;AAAA,IACtD;AAAA,EACF;AAEA,QAAM,MAAM,oBAAI,KAAK;AACrB,WAAS,YAAY;AAErB,QAAM,YAAY,iBAAiB,IAAI;AAAA,IACrC,oBAAoB,SAAS;AAAA,IAC7B;AAAA,IACA,WAAW;AAAA,IACX,WAAW;AAAA,MACT,QAAQ,SAAS;AAAA,MACjB,SAAS,IAAI,YAAY;AAAA,IAC3B;AAAA,IACA;AAAA,IACA,UAAU,SAAS;AAAA,IACnB,gBAAgB,SAAS;AAAA,EAC3B,CAAC;AAED,QAAM,eAAe,iBACjB,MAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,MACE,IAAI;AAAA,MACJ,oBAAoB,SAAS;AAAA,MAC7B,UAAU,SAAS;AAAA,MACnB,gBAAgB,SAAS;AAAA,IAC3B;AAAA,IACA;AAAA,IACA,EAAE,UAAU,SAAS,UAAU,gBAAgB,SAAS,eAAe;AAAA,EACzE,IACA,MAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,MACE,oBAAoB,SAAS;AAAA,MAC7B,QAAQ,SAAS;AAAA,MACjB,QAAQ;AAAA,MACR,UAAU,SAAS;AAAA,MACnB,gBAAgB,SAAS;AAAA,IAC3B;AAAA,IACA;AAAA,IACA,EAAE,UAAU,SAAS,UAAU,gBAAgB,SAAS,eAAe;AAAA,EACzE;AAEJ,MAAI,cAAc;AAChB,UAAM,YAAY,SAAS,IAAI,cAAc;AAAA,MAC3C,SAAS,IAAI,YAAY;AAAA,IAC3B,CAAC;AAAA,EACH;AAEA,QAAM,mBAAmB,WAAW,WAAW,eAAe,CAAC,GAAG;AAAA,IAChE,CAAC,MAAW,EAAE,eAAe,SAAS,iBAAiB,EAAE,YAAY;AAAA,EACvE;AAEA,MAAI,gBAAgB,WAAW,GAAG;AAChC,aAAS,SAAS;AAClB,UAAM,GAAG,MAAM;AACf;AAAA,EACF;AAEA,QAAM,oBAAoB;AAAA,IACxB,iBAAiB,SAAS;AAAA,IAC1B;AAAA,EACF;AAEA,QAAM,mBAAmB,MAAM,kBAAkB;AAAA,IAC/C;AAAA,IACA;AAAA,IACA,SAAS;AAAA,IACT;AAAA,EACF;AAEA,QAAM,uBAAuB,iBAAiB,KAAK,CAAC,MAAM,EAAE,OAAO;AAEnE,MAAI,CAAC,wBAAwB,CAAC,qBAAqB,YAAY;AAC7D,aAAS,SAAS;AAClB,UAAM,GAAG,MAAM;AACf;AAAA,EACF;AAEA,QAAM,mBAAmB,MAAM,kBAAkB;AAAA,IAC/C;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS;AAAA,IACT,qBAAqB,WAAW;AAAA,IAChC;AAAA,EACF;AAEA,MAAI,CAAC,iBAAiB,SAAS;AAC7B,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,MACA,EAAE,OAAO,iBAAiB,MAAM;AAAA,IAClC;AAAA,EACF;AAEA,QAAM,iBAAiB,gBAAgB,IAAI,WAAW,SAAS,IAAI,EAAE,OAAO,CAAC;AAC/E;",
+  "sourcesContent": ["/**\n * Timer Handler Service\n *\n * Fires timers for WAIT_FOR_TIMER steps: resumes a paused workflow instance\n * when its scheduled timer job is processed by the activity worker.\n */\n\nimport { EntityManager } from '@mikro-orm/core'\nimport type { EntityManager as PostgreSqlEntityManager } from '@mikro-orm/postgresql'\nimport type { AwilixContainer } from 'awilix'\nimport { findOneWithDecryption } from '@open-mercato/shared/lib/encryption/find'\nimport { WorkflowInstance, WorkflowDefinition, StepInstance } from '../data/entities'\nimport type * as eventLoggerModule from './event-logger'\nimport type * as stepHandlerModule from './step-handler'\nimport type * as transitionHandlerModule from './transition-handler'\nimport type * as workflowExecutorModule from './workflow-executor'\nimport { resolveCodeDefinitionForInstance } from './find-definition'\n\nexport interface FireTimerOptions {\n  instanceId: string\n  stepInstanceId?: string\n  branchInstanceId?: string | null\n  userId?: string\n  tenantId: string\n  organizationId: string\n}\n\nexport class TimerError extends Error {\n  constructor(\n    message: string,\n    public code: string,\n    public details?: any\n  ) {\n    super(message)\n    this.name = 'TimerError'\n  }\n}\n\n/**\n * Fire a timer and resume workflow execution.\n *\n * Mirrors `sendSignal` from signal-handler.ts \u2014 verifies the instance is\n * paused at a WAIT_FOR_TIMER step, logs TIMER_FIRED, exits the step, then\n * executes auto transitions and resumes the workflow.\n */\nexport async function fireTimer(\n  em: EntityManager,\n  container: AwilixContainer,\n  options: FireTimerOptions\n): Promise<void> {\n  const { instanceId, stepInstanceId, branchInstanceId, userId, tenantId, organizationId } = options\n\n  const eventLogger = container.resolve<typeof eventLoggerModule>('eventLogger')\n  const stepHandler = container.resolve<typeof stepHandlerModule>('stepHandler')\n  const transitionHandler = container.resolve<typeof transitionHandlerModule>('transitionHandler')\n  const workflowExecutor = container.resolve<typeof workflowExecutorModule>('workflowExecutor')\n\n  // Branch-scoped timer: the instance is FORKED and the branch is PAUSED at the\n  // WAIT_FOR_TIMER step. Resume just that branch, then drive the parallel loop.\n  if (branchInstanceId) {\n    await eventLogger.logWorkflowEvent(em, {\n      workflowInstanceId: instanceId,\n      stepInstanceId,\n      branchInstanceId,\n      eventType: 'TIMER_FIRED',\n      eventData: { firedAt: new Date().toISOString(), branch: true },\n      userId,\n      tenantId,\n      organizationId,\n    })\n    const { resumeBranch } = await import('./parallel-handler')\n    const resumed = await resumeBranch(em, {\n      instanceId,\n      branchInstanceId,\n      tenantId,\n      organizationId,\n      exitStepInstanceId: stepInstanceId,\n      exitOutput: { firedAt: new Date().toISOString() },\n    })\n    if (resumed) {\n      await workflowExecutor.executeWorkflow(em, container, instanceId, { userId })\n    }\n    return\n  }\n\n  const instance = await findOneWithDecryption(\n    em as PostgreSqlEntityManager,\n    WorkflowInstance,\n    {\n      id: instanceId,\n      tenantId,\n      organizationId,\n    },\n    undefined,\n    { tenantId, organizationId },\n  )\n\n  if (!instance) {\n    throw new TimerError(\n      'Workflow instance not found',\n      'INSTANCE_NOT_FOUND',\n      { instanceId }\n    )\n  }\n\n  if (instance.status !== 'PAUSED') {\n    throw new TimerError(\n      'Workflow is not paused',\n      'WORKFLOW_NOT_PAUSED',\n      { instanceId, status: instance.status }\n    )\n  }\n\n  const definition = (await findOneWithDecryption(\n    em as PostgreSqlEntityManager,\n    WorkflowDefinition,\n    {\n      id: instance.definitionId,\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n      deletedAt: null,\n    },\n    undefined,\n    { tenantId: instance.tenantId, organizationId: instance.organizationId },\n  )) ?? resolveCodeDefinitionForInstance(instance)\n  if (!definition) {\n    throw new TimerError(\n      'Workflow definition not found',\n      'DEFINITION_NOT_FOUND',\n      { definitionId: instance.definitionId }\n    )\n  }\n\n  const currentStep = definition.definition.steps.find(\n    (s: any) => s.stepId === instance.currentStepId\n  )\n\n  if (!currentStep || currentStep.stepType !== 'WAIT_FOR_TIMER') {\n    throw new TimerError(\n      'Workflow is not waiting for timer',\n      'NOT_WAITING_FOR_TIMER',\n      { instanceId, currentStepId: instance.currentStepId }\n    )\n  }\n\n  const now = new Date()\n  instance.updatedAt = now\n\n  await eventLogger.logWorkflowEvent(em, {\n    workflowInstanceId: instance.id,\n    stepInstanceId,\n    eventType: 'TIMER_FIRED',\n    eventData: {\n      stepId: instance.currentStepId,\n      firedAt: now.toISOString(),\n    },\n    userId,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n  })\n\n  const stepInstance = stepInstanceId\n    ? await findOneWithDecryption(\n        em as PostgreSqlEntityManager,\n        StepInstance,\n        {\n          id: stepInstanceId,\n          workflowInstanceId: instance.id,\n          tenantId: instance.tenantId,\n          organizationId: instance.organizationId,\n        },\n        undefined,\n        { tenantId: instance.tenantId, organizationId: instance.organizationId },\n      )\n    : await findOneWithDecryption(\n        em as PostgreSqlEntityManager,\n        StepInstance,\n        {\n          workflowInstanceId: instance.id,\n          stepId: instance.currentStepId,\n          status: 'ACTIVE',\n          tenantId: instance.tenantId,\n          organizationId: instance.organizationId,\n        },\n        undefined,\n        { tenantId: instance.tenantId, organizationId: instance.organizationId },\n      )\n\n  if (stepInstance) {\n    await stepHandler.exitStep(em, stepInstance, {\n      firedAt: now.toISOString(),\n    })\n  }\n\n  const autoTransitions = (definition.definition.transitions || []).filter(\n    (t: any) => t.fromStepId === instance.currentStepId && t.trigger === 'auto'\n  )\n\n  if (autoTransitions.length === 0) {\n    instance.status = 'RUNNING'\n    await em.flush()\n    return\n  }\n\n  const transitionContext = {\n    workflowContext: instance.context,\n    userId,\n  }\n\n  const validTransitions = await transitionHandler.findValidTransitions(\n    em,\n    instance,\n    instance.currentStepId,\n    transitionContext\n  )\n\n  const firstValidTransition = validTransitions.find((t) => t.isValid)\n\n  if (!firstValidTransition || !firstValidTransition.transition) {\n    instance.status = 'RUNNING'\n    await em.flush()\n    return\n  }\n\n  const transitionResult = await transitionHandler.executeTransition(\n    em,\n    container,\n    instance,\n    instance.currentStepId,\n    firstValidTransition.transition.toStepId,\n    transitionContext\n  )\n\n  if (!transitionResult.success) {\n    throw new TimerError(\n      'Transition failed after timer fired',\n      'TRANSITION_FAILED',\n      { error: transitionResult.error }\n    )\n  }\n\n  await workflowExecutor.executeWorkflow(em, container, instance.id, { userId })\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/workflows/lib/transition-handler.js CHANGED Viewed

@@ -1,11 +1,11 @@
 import {
-  WorkflowDefinition,
   WorkflowEvent
 } from "../data/entities.js";
 import * as ruleEvaluator from "../../business_rules/lib/rule-evaluator.js";
 import * as ruleEngine from "../../business_rules/lib/rule-engine.js";
 import * as activityExecutor from "./activity-executor.js";
 import * as stepHandler from "./step-handler.js";
+import { findDefinitionForInstance } from "./find-definition.js";
 import {
   rootToken,
   tokenBranchInstanceId,
@@ -30,9 +30,7 @@ class TransitionError extends Error {
 async function evaluateTransition(em, instance, fromStepId, toStepId, context) {
   const startTime = Date.now();
   try {
-    const definition = await em.findOne(WorkflowDefinition, {
-      id: instance.definitionId
-    });
+    const definition = await findDefinitionForInstance(em, instance);
     if (!definition) {
       return {
         isValid: false,
@@ -106,9 +104,7 @@ async function evaluateTransition(em, instance, fromStepId, toStepId, context) {
 }
 async function findValidTransitions(em, instance, fromStepId, context) {
   try {
-    const definition = await em.findOne(WorkflowDefinition, {
-      id: instance.definitionId
-    });
+    const definition = await findDefinitionForInstance(em, instance);
     if (!definition) {
       return [];
     }
@@ -451,9 +447,7 @@ async function evaluateTransitionConditions(em, instance, transition, context) {
 }
 async function evaluatePreConditions(em, instance, transition, context, eventBus) {
   try {
-    const definition = await em.findOne(WorkflowDefinition, {
-      id: instance.definitionId
-    });
+    const definition = await findDefinitionForInstance(em, instance);
     if (!definition) {
       return {
         allowed: true,
@@ -541,9 +535,7 @@ async function evaluatePreConditions(em, instance, transition, context, eventBus
 }
 async function evaluatePostConditions(em, instance, transition, context, eventBus) {
   try {
-    const definition = await em.findOne(WorkflowDefinition, {
-      id: instance.definitionId
-    });
+    const definition = await findDefinitionForInstance(em, instance);
     if (!definition) {
       return {
         allowed: true,