@open-mercato/core 0.4.2-canary-51881f6bf3 → 0.4.2-canary-5f415b8a44

package/src/modules/workflows/lib/event-trigger-service.ts

@@ -0,0 +1,557 @@
+/**
+ * Workflows Module - Event Trigger Service
+ *
+ * Core service for evaluating and processing workflow event triggers.
+ * Handles pattern matching, filter evaluation, context mapping, and workflow starting.
+ */
+
+import type { EntityManager } from '@mikro-orm/core'
+import type { AwilixContainer } from 'awilix'
+import type { CacheService } from '@open-mercato/cache'
+import {
+  WorkflowEventTrigger,
+  WorkflowDefinition,
+  WorkflowInstance,
+  type TriggerFilterCondition,
+  type TriggerContextMapping,
+  type WorkflowEventTriggerConfig,
+  type WorkflowDefinitionTrigger,
+} from '../data/entities'
+import { startWorkflow, executeWorkflow } from './workflow-executor'
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export interface EventTriggerContext {
+  eventName: string
+  payload: Record<string, unknown>
+  tenantId: string
+  organizationId: string
+}
+
+export interface ProcessTriggersResult {
+  triggered: number
+  skipped: number
+  errors: Array<{ triggerId: string; error: string }>
+  instances: Array<{ triggerId: string; instanceId: string }>
+}
+
+/**
+ * Unified trigger interface for both legacy (entity) and embedded (definition) triggers
+ */
+export interface UnifiedTrigger {
+  id: string  // For legacy: entity ID, for embedded: `${definitionId}:${triggerId}`
+  triggerId: string
+  name: string
+  description?: string | null
+  eventPattern: string
+  config: WorkflowEventTriggerConfig | null
+  enabled: boolean
+  priority: number
+  workflowDefinitionId: string
+  workflowId: string
+  workflowVersion: number
+  source: 'legacy' | 'embedded'
+  tenantId: string
+  organizationId: string
+}
+
+interface CachedTriggers {
+  triggers: UnifiedTrigger[]
+  cachedAt: number
+}
+
+// Cache TTL: 5 minutes
+const TRIGGER_CACHE_TTL = 5 * 60 * 1000
+
+// ============================================================================
+// Pattern Matching
+// ============================================================================
+
+/**
+ * Match an event name against a pattern.
+ *
+ * Supports:
+ * - Exact match: `customers.people.created`
+ * - Wildcard `*` matches single segment: `customers.*` matches `customers.people` but not `customers.people.created`
+ * - Global wildcard: `*` alone matches all events
+ */
+export function matchEventPattern(eventName: string, pattern: string): boolean {
+  // Global wildcard matches all events
+  if (pattern === '*') return true
+
+  // Exact match
+  if (pattern === eventName) return true
+
+  // No wildcards in pattern means we need exact match, which already failed
+  if (!pattern.includes('*')) return false
+
+  // Convert pattern to regex:
+  // - Escape regex special chars (except *)
+  // - Replace * with [^.]+ (match one or more non-dot chars)
+  const regexPattern = pattern
+    .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+    .replace(/\*/g, '[^.]+')
+  const regex = new RegExp(`^${regexPattern}$`)
+  return regex.test(eventName)
+}
+
+// ============================================================================
+// Filter Evaluation
+// ============================================================================
+
+/**
+ * Get a nested value from an object using dot notation.
+ */
+function getNestedValue(obj: unknown, path: string): unknown {
+  if (obj === null || obj === undefined) return undefined
+
+  const parts = path.split('.')
+  let current: unknown = obj
+
+  for (const part of parts) {
+    if (current === null || current === undefined) return undefined
+    if (typeof current !== 'object') return undefined
+    current = (current as Record<string, unknown>)[part]
+  }
+
+  return current
+}
+
+/**
+ * Evaluate a single filter condition against the event payload.
+ */
+function evaluateCondition(condition: TriggerFilterCondition, payload: Record<string, unknown>): boolean {
+  const value = getNestedValue(payload, condition.field)
+  const expected = condition.value
+
+  switch (condition.operator) {
+    case 'eq':
+      return value === expected
+
+    case 'neq':
+      return value !== expected
+
+    case 'gt':
+      return typeof value === 'number' && typeof expected === 'number' && value > expected
+
+    case 'gte':
+      return typeof value === 'number' && typeof expected === 'number' && value >= expected
+
+    case 'lt':
+      return typeof value === 'number' && typeof expected === 'number' && value < expected
+
+    case 'lte':
+      return typeof value === 'number' && typeof expected === 'number' && value <= expected
+
+    case 'contains':
+      if (typeof value === 'string' && typeof expected === 'string') {
+        return value.includes(expected)
+      }
+      if (Array.isArray(value)) {
+        return value.includes(expected)
+      }
+      return false
+
+    case 'startsWith':
+      return typeof value === 'string' && typeof expected === 'string' && value.startsWith(expected)
+
+    case 'endsWith':
+      return typeof value === 'string' && typeof expected === 'string' && value.endsWith(expected)
+
+    case 'in':
+      return Array.isArray(expected) && expected.includes(value)
+
+    case 'notIn':
+      return Array.isArray(expected) && !expected.includes(value)
+
+    case 'exists':
+      return value !== undefined && value !== null
+
+    case 'notExists':
+      return value === undefined || value === null
+
+    case 'regex':
+      if (typeof value !== 'string' || typeof expected !== 'string') return false
+      try {
+        const regex = new RegExp(expected)
+        return regex.test(value)
+      } catch {
+        return false
+      }
+
+    default:
+      return false
+  }
+}
+
+/**
+ * Evaluate all filter conditions against the event payload.
+ * All conditions must pass (AND logic).
+ */
+export function evaluateFilterConditions(
+  conditions: TriggerFilterCondition[] | undefined,
+  payload: Record<string, unknown>
+): boolean {
+  if (!conditions || conditions.length === 0) return true
+
+  return conditions.every(condition => evaluateCondition(condition, payload))
+}
+
+// ============================================================================
+// Context Mapping
+// ============================================================================
+
+/**
+ * Map event payload to workflow initial context.
+ */
+export function mapEventToContext(
+  mapping: TriggerContextMapping[] | undefined,
+  payload: Record<string, unknown>
+): Record<string, unknown> {
+  const context: Record<string, unknown> = {}
+
+  if (!mapping || mapping.length === 0) return context
+
+  for (const item of mapping) {
+    const value = getNestedValue(payload, item.sourceExpression)
+    context[item.targetKey] = value !== undefined ? value : item.defaultValue
+  }
+
+  return context
+}
+
+// ============================================================================
+// Trigger Loading with Caching
+// ============================================================================
+
+// In-memory cache for triggers (per tenant/org)
+const triggerCache = new Map<string, CachedTriggers>()
+
+function getCacheKey(tenantId: string, organizationId: string): string {
+  return `${tenantId}:${organizationId}`
+}
+
+/**
+ * Load legacy triggers from WorkflowEventTrigger entity table.
+ * For backward compatibility with existing triggers.
+ */
+async function loadLegacyTriggers(
+  em: EntityManager,
+  tenantId: string,
+  organizationId: string
+): Promise<UnifiedTrigger[]> {
+  const legacyTriggers = await em.find(
+    WorkflowEventTrigger,
+    {
+      tenantId,
+      organizationId,
+      enabled: true,
+      deletedAt: null,
+    },
+    {
+      orderBy: { priority: 'DESC', createdAt: 'ASC' },
+    }
+  )
+
+  // Get definitions for these triggers to get workflowId
+  const definitionIds = [...new Set(legacyTriggers.map(t => t.workflowDefinitionId))]
+  const definitions = definitionIds.length > 0 ? await em.find(WorkflowDefinition, {
+    id: { $in: definitionIds },
+    enabled: true,
+    deletedAt: null,
+  }) : []
+  const definitionMap = new Map(definitions.map(d => [d.id, d]))
+
+  return legacyTriggers
+    .filter(t => definitionMap.has(t.workflowDefinitionId))
+    .map(t => {
+      const def = definitionMap.get(t.workflowDefinitionId)!
+      return {
+        id: t.id,
+        triggerId: t.id,
+        name: t.name,
+        description: t.description,
+        eventPattern: t.eventPattern,
+        config: t.config ?? null,
+        enabled: t.enabled,
+        priority: t.priority,
+        workflowDefinitionId: t.workflowDefinitionId,
+        workflowId: def.workflowId,
+        workflowVersion: def.version,
+        source: 'legacy' as const,
+        tenantId: t.tenantId,
+        organizationId: t.organizationId,
+      }
+    })
+}
+
+/**
+ * Load embedded triggers from workflow definitions.
+ * New triggers are embedded directly in the definition JSONB.
+ */
+async function loadEmbeddedTriggers(
+  em: EntityManager,
+  tenantId: string,
+  organizationId: string
+): Promise<UnifiedTrigger[]> {
+  // Load all enabled definitions that may have triggers
+  const definitions = await em.find(
+    WorkflowDefinition,
+    {
+      tenantId,
+      organizationId,
+      enabled: true,
+      deletedAt: null,
+    }
+  )
+
+  const triggers: UnifiedTrigger[] = []
+
+  for (const def of definitions) {
+    const embeddedTriggers = def.definition?.triggers as WorkflowDefinitionTrigger[] | undefined
+    if (!embeddedTriggers || embeddedTriggers.length === 0) continue
+
+    for (const trigger of embeddedTriggers) {
+      if (!trigger.enabled) continue
+
+      triggers.push({
+        id: `${def.id}:${trigger.triggerId}`,
+        triggerId: trigger.triggerId,
+        name: trigger.name,
+        description: trigger.description ?? null,
+        eventPattern: trigger.eventPattern,
+        config: trigger.config ?? null,
+        enabled: trigger.enabled,
+        priority: trigger.priority,
+        workflowDefinitionId: def.id,
+        workflowId: def.workflowId,
+        workflowVersion: def.version,
+        source: 'embedded' as const,
+        tenantId,
+        organizationId,
+      })
+    }
+  }
+
+  return triggers
+}
+
+/**
+ * Load all enabled triggers for a tenant/organization with caching.
+ * Merges both legacy (entity) triggers and embedded (definition) triggers.
+ */
+export async function loadTriggersForTenant(
+  em: EntityManager,
+  tenantId: string,
+  organizationId: string,
+  cacheService?: CacheService
+): Promise<UnifiedTrigger[]> {
+  const cacheKey = getCacheKey(tenantId, organizationId)
+
+  // Check in-memory cache
+  const cached = triggerCache.get(cacheKey)
+  if (cached && Date.now() - cached.cachedAt < TRIGGER_CACHE_TTL) {
+    return cached.triggers
+  }
+
+  // Load from both sources
+  const [legacyTriggers, embeddedTriggers] = await Promise.all([
+    loadLegacyTriggers(em, tenantId, organizationId),
+    loadEmbeddedTriggers(em, tenantId, organizationId),
+  ])
+
+  // Merge and sort by priority (higher first)
+  const allTriggers = [...legacyTriggers, ...embeddedTriggers]
+    .sort((a, b) => b.priority - a.priority)
+
+  // Update cache
+  triggerCache.set(cacheKey, {
+    triggers: allTriggers,
+    cachedAt: Date.now(),
+  })
+
+  return allTriggers
+}
+
+/**
+ * Invalidate trigger cache for a tenant/organization.
+ * Call this when:
+ * - Legacy triggers are created/updated/deleted
+ * - Workflow definitions with embedded triggers are created/updated/deleted
+ */
+export function invalidateTriggerCache(tenantId: string, organizationId?: string): void {
+  if (organizationId) {
+    // Invalidate specific org
+    const cacheKey = getCacheKey(tenantId, organizationId)
+    triggerCache.delete(cacheKey)
+  } else {
+    // Invalidate all orgs for tenant
+    for (const key of triggerCache.keys()) {
+      if (key.startsWith(`${tenantId}:`)) {
+        triggerCache.delete(key)
+      }
+    }
+  }
+}
+
+// ============================================================================
+// Trigger Matching
+// ============================================================================
+
+/**
+ * Find all triggers that match an event.
+ */
+export async function findMatchingTriggers(
+  em: EntityManager,
+  context: EventTriggerContext
+): Promise<UnifiedTrigger[]> {
+  const triggers = await loadTriggersForTenant(
+    em,
+    context.tenantId,
+    context.organizationId
+  )
+
+  return triggers.filter(trigger => {
+    // Check event pattern
+    if (!matchEventPattern(context.eventName, trigger.eventPattern)) {
+      return false
+    }
+
+    // Check filter conditions
+    if (!evaluateFilterConditions(trigger.config?.filterConditions, context.payload)) {
+      return false
+    }
+
+    return true
+  })
+}
+
+// ============================================================================
+// Trigger Processing
+// ============================================================================
+
+/**
+ * Check if max concurrent instances limit is reached.
+ */
+async function checkConcurrencyLimit(
+  em: EntityManager,
+  trigger: UnifiedTrigger
+): Promise<boolean> {
+  const maxInstances = trigger.config?.maxConcurrentInstances
+
+  if (!maxInstances) return true // No limit
+
+  // Count running instances for this trigger's workflow definition
+  const runningCount = await em.count(WorkflowInstance, {
+    definitionId: trigger.workflowDefinitionId,
+    status: { $in: ['RUNNING', 'WAITING_FOR_ACTIVITIES'] },
+    tenantId: trigger.tenantId,
+    organizationId: trigger.organizationId,
+    deletedAt: null,
+  })
+
+  return runningCount < maxInstances
+}
+
+/**
+ * Process all matching triggers for an event and start workflows.
+ */
+export async function processEventTriggers(
+  em: EntityManager,
+  container: AwilixContainer,
+  context: EventTriggerContext
+): Promise<ProcessTriggersResult> {
+  const result: ProcessTriggersResult = {
+    triggered: 0,
+    skipped: 0,
+    errors: [],
+    instances: [],
+  }
+
+  // Find matching triggers
+  const triggers = await findMatchingTriggers(em, context)
+
+  if (triggers.length === 0) {
+    return result
+  }
+
+  // Process each trigger (definitions already validated during loading)
+  for (const trigger of triggers) {
+    try {
+      // Check concurrency limit
+      const canStart = await checkConcurrencyLimit(em, trigger)
+      if (!canStart) {
+        console.log(`[workflow-trigger] Skipping trigger "${trigger.name}": max concurrent instances reached`)
+        result.skipped++
+        continue
+      }
+
+      // Map event payload to workflow context
+      const mappedContext = mapEventToContext(trigger.config?.contextMapping, context.payload)
+
+      // Extract entity info from payload for metadata
+      const payloadId = context.payload?.id as string | undefined
+      const payloadEntityType = context.payload?.entityType as string | undefined
+
+      // Include event metadata and payload in context
+      const initialContext = {
+        // Include raw event payload fields (e.g., id, organizationId, tenantId)
+        ...context.payload,
+        // Override with explicit mappings if provided
+        ...mappedContext,
+        __trigger: {
+          triggerId: trigger.id,
+          triggerName: trigger.name,
+          eventName: context.eventName,
+          eventPayload: context.payload,
+          triggeredAt: new Date().toISOString(),
+          source: trigger.source,
+        },
+      }
+
+      // Start workflow
+      const instance = await startWorkflow(em, {
+        workflowId: trigger.workflowId,
+        version: trigger.workflowVersion,
+        initialContext,
+        metadata: {
+          initiatedBy: `trigger:${trigger.id}`,
+          // Include entityId and entityType for widget discovery
+          entityId: payloadId,
+          entityType: payloadEntityType || trigger.config?.entityType,
+          labels: {
+            trigger_id: trigger.id,
+            trigger_name: trigger.name,
+            event_name: context.eventName,
+            trigger_source: trigger.source,
+          },
+        },
+        tenantId: context.tenantId,
+        organizationId: context.organizationId,
+      })
+
+      result.triggered++
+      result.instances.push({
+        triggerId: trigger.id,
+        instanceId: instance.id,
+      })
+
+      // Execute workflow asynchronously (don't wait)
+      executeWorkflow(em.fork(), container, instance.id).catch(err => {
+        console.error(`[workflow-trigger] Error executing workflow ${instance.id}:`, err)
+      })
+
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error)
+      console.error(`[workflow-trigger] Error processing trigger "${trigger.name}":`, error)
+      result.errors.push({
+        triggerId: trigger.id,
+        error: errorMessage,
+      })
+    }
+  }
+
+  return result
+}

package/src/modules/workflows/lib/graph-utils.ts

@@ -205,12 +205,20 @@ export function definitionToGraph(
   definition: WorkflowDefinition['definition'],
   options: DefinitionToGraphOptions = {}
 ): { nodes: Node[]; edges: Edge[] } {
-  const { autoLayout = true, layoutSpacing = { vertical: 250, horizontal: 100 } } = options
+  const { autoLayout = true, layoutSpacing = { vertical: 200, horizontal: 300 } } = options
+
+  // Build step map for quick lookup
+  const stepMap = new Map(definition.steps.map(step => [step.stepId, step]))
+
+  // Calculate smart layout positions if autoLayout is enabled
+  const positions = autoLayout
+    ? calculateSmartLayout(definition.steps, definition.transitions, layoutSpacing)
+    : null
 
   // Convert steps to nodes
   const nodes: Node[] = definition.steps.map((step, index) => {
     // Determine position
-    let position = { x: 250, y: 50 + index * layoutSpacing.vertical }
+    let position = positions?.get(step.stepId) || { x: 250, y: 50 + index * layoutSpacing.vertical }
 
     // Use stored position if available and not auto-layouting
     if (!autoLayout && (step as any)._editorPosition) {
@@ -326,6 +334,113 @@ export function definitionToGraph(
   return { nodes, edges }
 }
 
+/**
+ * Calculate smart layout positions for workflow nodes
+ * Uses a layered/hierarchical layout algorithm that:
+ * 1. Assigns levels (ranks) to nodes based on graph topology
+ * 2. Spreads sibling nodes horizontally at the same level
+ * 3. Centers merge points below their incoming nodes
+ */
+function calculateSmartLayout(
+  steps: any[],
+  transitions: any[],
+  spacing: { vertical: number; horizontal: number }
+): Map<string, { x: number; y: number }> {
+  const positions = new Map<string, { x: number; y: number }>()
+
+  if (steps.length === 0) return positions
+
+  // Build adjacency lists
+  const outgoing = new Map<string, string[]>() // node -> children
+  const incoming = new Map<string, string[]>() // node -> parents
+
+  for (const step of steps) {
+    outgoing.set(step.stepId, [])
+    incoming.set(step.stepId, [])
+  }
+
+  for (const t of transitions) {
+    const children = outgoing.get(t.fromStepId) || []
+    children.push(t.toStepId)
+    outgoing.set(t.fromStepId, children)
+
+    const parents = incoming.get(t.toStepId) || []
+    parents.push(t.fromStepId)
+    incoming.set(t.toStepId, parents)
+  }
+
+  // Find start node(s) - nodes with no incoming edges
+  const startNodes = steps.filter(s => (incoming.get(s.stepId) || []).length === 0)
+  if (startNodes.length === 0) {
+    // Fallback: use first step as start
+    startNodes.push(steps[0])
+  }
+
+  // Assign levels using BFS (longest path from start)
+  const levels = new Map<string, number>()
+  const queue: Array<{ id: string; level: number }> = []
+
+  for (const start of startNodes) {
+    queue.push({ id: start.stepId, level: 0 })
+  }
+
+  while (queue.length > 0) {
+    const { id, level } = queue.shift()!
+    const currentLevel = levels.get(id)
+
+    // Take the maximum level (longest path)
+    if (currentLevel === undefined || level > currentLevel) {
+      levels.set(id, level)
+    }
+
+    const children = outgoing.get(id) || []
+    for (const child of children) {
+      queue.push({ id: child, level: level + 1 })
+    }
+  }
+
+  // Group nodes by level
+  const nodesByLevel = new Map<number, string[]>()
+  for (const [nodeId, level] of levels) {
+    const nodesAtLevel = nodesByLevel.get(level) || []
+    nodesAtLevel.push(nodeId)
+    nodesByLevel.set(level, nodesAtLevel)
+  }
+
+  // Calculate positions
+  const centerX = 400 // Center line for the graph
+  const startY = 50
+
+  for (const [level, nodeIds] of nodesByLevel) {
+    const count = nodeIds.length
+    const y = startY + level * spacing.vertical
+
+    if (count === 1) {
+      // Single node at this level - center it
+      positions.set(nodeIds[0], { x: centerX, y })
+    } else {
+      // Multiple nodes at this level - spread them horizontally
+      const totalWidth = (count - 1) * spacing.horizontal
+      const startX = centerX - totalWidth / 2
+
+      // Sort nodes by their parent's position for consistent ordering
+      nodeIds.sort((a, b) => {
+        const parentsA = incoming.get(a) || []
+        const parentsB = incoming.get(b) || []
+        const parentPosA = parentsA.length > 0 ? (positions.get(parentsA[0])?.x || 0) : 0
+        const parentPosB = parentsB.length > 0 ? (positions.get(parentsB[0])?.x || 0) : 0
+        return parentPosA - parentPosB
+      })
+
+      nodeIds.forEach((nodeId, idx) => {
+        positions.set(nodeId, { x: startX + idx * spacing.horizontal, y })
+      })
+    }
+  }
+
+  return positions
+}
+
 /**
  * Map node type to step type (for graph → definition)
  */