@open-mercato/core 0.4.2-canary-d0a025141f → 0.4.2-canary-3efa759f5c

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

@@ -1,557 +0,0 @@
-/**
- * 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/migrations/Migration20260123143500.ts

@@ -1,38 +0,0 @@
-import { Migration } from '@mikro-orm/migrations';
-
-export class Migration20260123143500 extends Migration {
-
-  override async up(): Promise<void> {
-    // Create workflow_event_triggers table
-    this.addSql(`
-      create table "workflow_event_triggers" (
-        "id" uuid not null default gen_random_uuid(),
-        "name" varchar(255) not null,
-        "description" text null,
-        "workflow_definition_id" uuid not null,
-        "event_pattern" varchar(255) not null,
-        "config" jsonb null,
-        "enabled" bool not null default true,
-        "priority" int4 not null default 0,
-        "tenant_id" uuid not null,
-        "organization_id" uuid not null,
-        "created_by" varchar(255) null,
-        "updated_by" varchar(255) null,
-        "created_at" timestamptz(6) not null,
-        "updated_at" timestamptz(6) not null,
-        "deleted_at" timestamptz(6) null,
-        constraint "workflow_event_triggers_pkey" primary key ("id")
-      );
-    `);
-
-    // Create indexes
-    this.addSql(`create index "workflow_event_triggers_event_pattern_idx" on "workflow_event_triggers" ("event_pattern", "enabled");`);
-    this.addSql(`create index "workflow_event_triggers_definition_idx" on "workflow_event_triggers" ("workflow_definition_id");`);
-    this.addSql(`create index "workflow_event_triggers_tenant_org_idx" on "workflow_event_triggers" ("tenant_id", "organization_id");`);
-    this.addSql(`create index "workflow_event_triggers_enabled_priority_idx" on "workflow_event_triggers" ("enabled", "priority");`);
-  }
-
-  override async down(): Promise<void> {
-    this.addSql(`drop table if exists "workflow_event_triggers" cascade;`);
-  }
-}

package/src/modules/workflows/subscribers/event-trigger.ts

@@ -1,109 +0,0 @@
-/**
- * Workflows Module - Event Trigger Subscriber
- *
- * Wildcard subscriber that listens to all events and evaluates
- * workflow event triggers. When a matching trigger is found,
- * the corresponding workflow is started with mapped context.
- */
-
-import type { EntityManager } from '@mikro-orm/core'
-import type { AwilixContainer } from 'awilix'
-
-export const metadata = {
-  event: '*', // Subscribe to ALL events
-  persistent: true, // Ensure reliability
-  id: 'workflows:event-trigger',
-}
-
-// Events that should never trigger workflows (internal/system events)
-const EXCLUDED_EVENT_PREFIXES = [
-  'query_index.', // Internal indexing events
-  'search.', // Internal search events
-  'workflows.', // Workflow internal events (avoid recursion)
-  'cache.', // Cache events
-  'queue.', // Queue events
-]
-
-/**
- * Check if an event should be excluded from trigger processing.
- */
-function isExcludedEvent(eventName: string): boolean {
-  return EXCLUDED_EVENT_PREFIXES.some(prefix => eventName.startsWith(prefix))
-}
-
-export default async function handle(
-  payload: unknown,
-  ctx: { resolve: <T = unknown>(name: string) => T; eventName?: string }
-): Promise<void> {
-  const eventName = ctx.eventName
-  if (!eventName) {
-    // Skip if no event name (shouldn't happen, but be safe)
-    return
-  }
-
-  // Skip excluded events
-  if (isExcludedEvent(eventName)) {
-    return
-  }
-
-  // Ensure payload is an object
-  const eventPayload = (payload && typeof payload === 'object' ? payload : {}) as Record<string, unknown>
-
-  // Extract tenant/org from payload
-  const tenantId = eventPayload?.tenantId as string | undefined
-  const organizationId = eventPayload?.organizationId as string | undefined
-
-  // Skip events without tenant context
-  if (!tenantId || !organizationId) {
-    return
-  }
-
-  // Get dependencies from container
-  let em: EntityManager
-  let container: AwilixContainer
-
-  try {
-    em = ctx.resolve<EntityManager>('em')
-    // Create a minimal container wrapper using the resolve function
-    // This avoids the need to register 'container' as a self-reference in DI
-    container = {
-      resolve: ctx.resolve,
-      // Provide minimal AwilixContainer interface for type compatibility
-      cradle: new Proxy({}, {
-        get: (_target, prop: string) => ctx.resolve(prop),
-      }),
-    } as unknown as AwilixContainer
-  } catch (error) {
-    // DI not available - skip
-    console.warn(`[workflow-trigger] Cannot resolve dependencies for event "${eventName}":`, error)
-    return
-  }
-
-  // Import service dynamically to avoid circular dependencies
-  const { processEventTriggers } = await import('../lib/event-trigger-service')
-
-  try {
-    const result = await processEventTriggers(em, container, {
-      eventName,
-      payload: eventPayload,
-      tenantId,
-      organizationId,
-    })
-
-    if (result.triggered > 0) {
-      console.log(
-        `[workflow-trigger] Triggered ${result.triggered} workflow(s) for "${eventName}"` +
-        (result.skipped > 0 ? ` (${result.skipped} skipped)` : '') +
-        (result.errors.length > 0 ? ` (${result.errors.length} errors)` : '')
-      )
-    }
-
-    if (result.errors.length > 0) {
-      for (const err of result.errors) {
-        console.error(`[workflow-trigger] Trigger ${err.triggerId} failed:`, err.error)
-      }
-    }
-  } catch (error) {
-    console.error(`[workflow-trigger] Error processing triggers for "${eventName}":`, error)
-  }
-}