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

package/src/modules/business_rules/lib/rule-engine.ts

@@ -4,7 +4,7 @@ import * as ruleEvaluator from './rule-evaluator'
 import * as actionExecutor from './action-executor'
 import type { RuleEvaluationContext } from './rule-evaluator'
 import type { ActionContext, ActionExecutionOutcome } from './action-executor'
-import { ruleEngineContextSchema, ruleDiscoveryOptionsSchema } from '../data/validators'
+import { ruleEngineContextSchema, ruleDiscoveryOptionsSchema, directRuleExecutionContextSchema, ruleIdExecutionContextSchema } from '../data/validators'
 
 /**
  * Constants
@@ -85,6 +85,65 @@ export interface RuleDiscoveryOptions {
   ruleType?: RuleType
 }
 
+/**
+ * Direct rule execution context (for executing a specific rule by ID)
+ */
+export interface DirectRuleExecutionContext {
+  ruleId: string  // Database UUID of the rule
+  data: any
+  user?: {
+    id?: string
+    email?: string
+    role?: string
+    [key: string]: any
+  }
+  tenantId: string
+  organizationId: string
+  executedBy?: string
+  dryRun?: boolean
+  // Optional for logging (falls back to rule's entityType)
+  entityType?: string
+  entityId?: string
+  eventType?: string
+}
+
+/**
+ * Direct rule execution result
+ */
+export interface DirectRuleExecutionResult {
+  success: boolean
+  ruleId: string
+  ruleName: string
+  conditionResult: boolean
+  actionsExecuted: ActionExecutionOutcome | null
+  executionTime: number
+  error?: string
+  logId?: string
+}
+
+/**
+ * Context for executing a rule by its string rule_id identifier
+ * Unlike DirectRuleExecutionContext which uses database UUID,
+ * this uses the string identifier (e.g., "workflow_checkout_inventory_available")
+ */
+export interface RuleIdExecutionContext {
+  ruleId: string  // String identifier (e.g., "workflow_checkout_inventory_available")
+  data: any
+  user?: {
+    id?: string
+    email?: string
+    role?: string
+    [key: string]: any
+  }
+  tenantId: string
+  organizationId: string
+  executedBy?: string
+  dryRun?: boolean
+  entityType?: string
+  entityId?: string
+  eventType?: string
+}
+
 /**
  * Execute a function with a timeout
  */
@@ -404,6 +463,227 @@ export async function findApplicableRules(
   })
 }
 
+/**
+ * Execute a specific rule by its database UUID
+ * This bypasses the entityType/eventType discovery mechanism and directly executes the rule
+ */
+export async function executeRuleById(
+  em: EntityManager,
+  context: DirectRuleExecutionContext
+): Promise<DirectRuleExecutionResult> {
+  const startTime = Date.now()
+
+  // Validate input
+  const validation = directRuleExecutionContextSchema.safeParse(context)
+  if (!validation.success) {
+    const validationErrors = validation.error.issues.map(e => `${e.path.join('.')}: ${e.message}`)
+    return {
+      success: false,
+      ruleId: context.ruleId,
+      ruleName: 'Unknown',
+      conditionResult: false,
+      actionsExecuted: null,
+      executionTime: Date.now() - startTime,
+      error: `Validation failed: ${validationErrors.join(', ')}`,
+    }
+  }
+
+  // Fetch rule by ID with tenant/org validation
+  const rule = await em.findOne(BusinessRule, {
+    id: context.ruleId,
+    tenantId: context.tenantId,
+    organizationId: context.organizationId,
+    deletedAt: null,
+  })
+
+  if (!rule) {
+    return {
+      success: false,
+      ruleId: context.ruleId,
+      ruleName: 'Unknown',
+      conditionResult: false,
+      actionsExecuted: null,
+      executionTime: Date.now() - startTime,
+      error: 'Rule not found',
+    }
+  }
+
+  if (!rule.enabled) {
+    return {
+      success: false,
+      ruleId: rule.ruleId,
+      ruleName: rule.ruleName,
+      conditionResult: false,
+      actionsExecuted: null,
+      executionTime: Date.now() - startTime,
+      error: 'Rule is disabled',
+    }
+  }
+
+  // Check effective date range
+  const now = new Date()
+  if (rule.effectiveFrom && rule.effectiveFrom > now) {
+    return {
+      success: false,
+      ruleId: rule.ruleId,
+      ruleName: rule.ruleName,
+      conditionResult: false,
+      actionsExecuted: null,
+      executionTime: Date.now() - startTime,
+      error: `Rule is not yet effective (starts ${rule.effectiveFrom.toISOString()})`,
+    }
+  }
+  if (rule.effectiveTo && rule.effectiveTo < now) {
+    return {
+      success: false,
+      ruleId: rule.ruleId,
+      ruleName: rule.ruleName,
+      conditionResult: false,
+      actionsExecuted: null,
+      executionTime: Date.now() - startTime,
+      error: `Rule has expired (ended ${rule.effectiveTo.toISOString()})`,
+    }
+  }
+
+  // Build RuleEngineContext (use provided entityType or fall back to rule's)
+  const engineContext: RuleEngineContext = {
+    entityType: context.entityType || rule.entityType,
+    entityId: context.entityId,
+    eventType: context.eventType || rule.eventType || undefined,
+    data: context.data,
+    user: context.user,
+    tenantId: context.tenantId,
+    organizationId: context.organizationId,
+    executedBy: context.executedBy,
+    dryRun: context.dryRun,
+  }
+
+  // Execute via existing executeSingleRule
+  const result = await executeSingleRule(em, rule, engineContext)
+
+  return {
+    success: !result.error,
+    ruleId: rule.ruleId,
+    ruleName: rule.ruleName,
+    conditionResult: result.conditionResult,
+    actionsExecuted: result.actionsExecuted,
+    executionTime: result.executionTime,
+    error: result.error,
+    logId: result.logId,
+  }
+}
+
+/**
+ * Execute a rule by its string rule_id identifier
+ * Looks up rule by rule_id (string column) + tenant_id (unique constraint)
+ * This is useful for workflow conditions that reference rules by their string identifiers
+ */
+export async function executeRuleByRuleId(
+  em: EntityManager,
+  context: RuleIdExecutionContext
+): Promise<DirectRuleExecutionResult> {
+  const startTime = Date.now()
+
+  // Validate input
+  const validation = ruleIdExecutionContextSchema.safeParse(context)
+  if (!validation.success) {
+    const validationErrors = validation.error.issues.map(e => `${e.path.join('.')}: ${e.message}`)
+    return {
+      success: false,
+      ruleId: context.ruleId || 'unknown',
+      ruleName: 'Unknown',
+      conditionResult: false,
+      actionsExecuted: null,
+      executionTime: Date.now() - startTime,
+      error: `Validation failed: ${validationErrors.join(', ')}`,
+    }
+  }
+
+  // Fetch rule by rule_id (string identifier) + tenant/org
+  const rule = await em.findOne(BusinessRule, {
+    ruleId: context.ruleId,  // String identifier column
+    tenantId: context.tenantId,
+    organizationId: context.organizationId,
+    deletedAt: null,
+  })
+
+  if (!rule) {
+    return {
+      success: false,
+      ruleId: context.ruleId,
+      ruleName: 'Unknown',
+      conditionResult: false,
+      actionsExecuted: null,
+      executionTime: Date.now() - startTime,
+      error: 'Rule not found',
+    }
+  }
+
+  if (!rule.enabled) {
+    return {
+      success: false,
+      ruleId: rule.ruleId,
+      ruleName: rule.ruleName,
+      conditionResult: false,
+      actionsExecuted: null,
+      executionTime: Date.now() - startTime,
+      error: 'Rule is disabled',
+    }
+  }
+
+  // Check effective date range
+  const now = new Date()
+  if (rule.effectiveFrom && rule.effectiveFrom > now) {
+    return {
+      success: false,
+      ruleId: rule.ruleId,
+      ruleName: rule.ruleName,
+      conditionResult: false,
+      actionsExecuted: null,
+      executionTime: Date.now() - startTime,
+      error: `Rule is not yet effective (starts ${rule.effectiveFrom.toISOString()})`,
+    }
+  }
+  if (rule.effectiveTo && rule.effectiveTo < now) {
+    return {
+      success: false,
+      ruleId: rule.ruleId,
+      ruleName: rule.ruleName,
+      conditionResult: false,
+      actionsExecuted: null,
+      executionTime: Date.now() - startTime,
+      error: `Rule has expired (ended ${rule.effectiveTo.toISOString()})`,
+    }
+  }
+
+  // Build RuleEngineContext (use provided entityType or fall back to rule's)
+  const engineContext: RuleEngineContext = {
+    entityType: context.entityType || rule.entityType,
+    entityId: context.entityId,
+    eventType: context.eventType || rule.eventType || undefined,
+    data: context.data,
+    user: context.user,
+    tenantId: context.tenantId,
+    organizationId: context.organizationId,
+    executedBy: context.executedBy,
+    dryRun: context.dryRun,
+  }
+
+  // Execute via existing executeSingleRule
+  const result = await executeSingleRule(em, rule, engineContext)
+
+  return {
+    success: !result.error,
+    ruleId: rule.ruleId,
+    ruleName: rule.ruleName,
+    conditionResult: result.conditionResult,
+    actionsExecuted: result.actionsExecuted,
+    executionTime: result.executionTime,
+    error: result.error,
+    logId: result.logId,
+  }
+}
+
 /**
  * Sensitive field patterns to exclude from logs
  */

package/src/modules/catalog/events.ts

@@ -0,0 +1,45 @@
+import { createModuleEvents } from '@open-mercato/shared/modules/events'
+
+/**
+ * Catalog Module Events
+ *
+ * Declares all events that can be emitted by the catalog module.
+ */
+const events = [
+  // Products
+  { id: 'catalog.product.created', label: 'Product Created', entity: 'product', category: 'crud' },
+  { id: 'catalog.product.updated', label: 'Product Updated', entity: 'product', category: 'crud' },
+  { id: 'catalog.product.deleted', label: 'Product Deleted', entity: 'product', category: 'crud' },
+
+  // Categories
+  { id: 'catalog.category.created', label: 'Category Created', entity: 'category', category: 'crud' },
+  { id: 'catalog.category.updated', label: 'Category Updated', entity: 'category', category: 'crud' },
+  { id: 'catalog.category.deleted', label: 'Category Deleted', entity: 'category', category: 'crud' },
+
+  // Variants
+  { id: 'catalog.variant.created', label: 'Variant Created', entity: 'variant', category: 'crud' },
+  { id: 'catalog.variant.updated', label: 'Variant Updated', entity: 'variant', category: 'crud' },
+  { id: 'catalog.variant.deleted', label: 'Variant Deleted', entity: 'variant', category: 'crud' },
+
+  // Prices
+  { id: 'catalog.price.created', label: 'Price Created', entity: 'price', category: 'crud' },
+  { id: 'catalog.price.updated', label: 'Price Updated', entity: 'price', category: 'crud' },
+  { id: 'catalog.price.deleted', label: 'Price Deleted', entity: 'price', category: 'crud' },
+
+  // Lifecycle events - Pricing resolution
+  { id: 'catalog.pricing.resolve.before', label: 'Before Pricing Resolve', category: 'lifecycle', excludeFromTriggers: true },
+  { id: 'catalog.pricing.resolve.after', label: 'After Pricing Resolve', category: 'lifecycle', excludeFromTriggers: true },
+] as const
+
+export const eventsConfig = createModuleEvents({
+  moduleId: 'catalog',
+  events,
+})
+
+/** Type-safe event emitter for catalog module */
+export const emitCatalogEvent = eventsConfig.emit
+
+/** Event IDs that can be emitted by the catalog module */
+export type CatalogEventId = typeof events[number]['id']
+
+export default eventsConfig

package/src/modules/customers/events.ts

@@ -0,0 +1,63 @@
+import { createModuleEvents } from '@open-mercato/shared/modules/events'
+
+/**
+ * Customers Module Events
+ *
+ * Declares all events that can be emitted by the customers module.
+ */
+const events = [
+  // People
+  { id: 'customers.people.created', label: 'Customer (Person) Created', entity: 'people', category: 'crud' },
+  { id: 'customers.people.updated', label: 'Customer (Person) Updated', entity: 'people', category: 'crud' },
+  { id: 'customers.people.deleted', label: 'Customer (Person) Deleted', entity: 'people', category: 'crud' },
+
+  // Companies
+  { id: 'customers.companies.created', label: 'Customer (Company) Created', entity: 'companies', category: 'crud' },
+  { id: 'customers.companies.updated', label: 'Customer (Company) Updated', entity: 'companies', category: 'crud' },
+  { id: 'customers.companies.deleted', label: 'Customer (Company) Deleted', entity: 'companies', category: 'crud' },
+
+  // Deals
+  { id: 'customers.deals.created', label: 'Deal Created', entity: 'deals', category: 'crud' },
+  { id: 'customers.deals.updated', label: 'Deal Updated', entity: 'deals', category: 'crud' },
+  { id: 'customers.deals.deleted', label: 'Deal Deleted', entity: 'deals', category: 'crud' },
+
+  // Comments
+  { id: 'customers.comments.created', label: 'Comment Created', entity: 'comments', category: 'crud' },
+  { id: 'customers.comments.updated', label: 'Comment Updated', entity: 'comments', category: 'crud' },
+  { id: 'customers.comments.deleted', label: 'Comment Deleted', entity: 'comments', category: 'crud' },
+
+  // Addresses
+  { id: 'customers.addresses.created', label: 'Address Created', entity: 'addresses', category: 'crud' },
+  { id: 'customers.addresses.updated', label: 'Address Updated', entity: 'addresses', category: 'crud' },
+  { id: 'customers.addresses.deleted', label: 'Address Deleted', entity: 'addresses', category: 'crud' },
+
+  // Activities
+  { id: 'customers.activities.created', label: 'Activity Created', entity: 'activities', category: 'crud' },
+  { id: 'customers.activities.updated', label: 'Activity Updated', entity: 'activities', category: 'crud' },
+  { id: 'customers.activities.deleted', label: 'Activity Deleted', entity: 'activities', category: 'crud' },
+
+  // Tags
+  { id: 'customers.tags.created', label: 'Tag Created', entity: 'tags', category: 'crud' },
+  { id: 'customers.tags.updated', label: 'Tag Updated', entity: 'tags', category: 'crud' },
+  { id: 'customers.tags.deleted', label: 'Tag Deleted', entity: 'tags', category: 'crud' },
+  { id: 'customers.tags.assigned', label: 'Tag Assigned', entity: 'tags', category: 'crud' },
+  { id: 'customers.tags.removed', label: 'Tag Removed', entity: 'tags', category: 'crud' },
+
+  // Todos
+  { id: 'customers.todos.created', label: 'Todo Created', entity: 'todos', category: 'crud' },
+  { id: 'customers.todos.updated', label: 'Todo Updated', entity: 'todos', category: 'crud' },
+  { id: 'customers.todos.deleted', label: 'Todo Deleted', entity: 'todos', category: 'crud' },
+] as const
+
+export const eventsConfig = createModuleEvents({
+  moduleId: 'customers',
+  events,
+})
+
+/** Type-safe event emitter for customers module */
+export const emitCustomersEvent = eventsConfig.emit
+
+/** Event IDs that can be emitted by the customers module */
+export type CustomersEventId = typeof events[number]['id']
+
+export default eventsConfig

package/src/modules/directory/events.ts

@@ -0,0 +1,31 @@
+import { createModuleEvents } from '@open-mercato/shared/modules/events'
+
+/**
+ * Directory Module Events
+ *
+ * Declares all events that can be emitted by the directory module.
+ */
+const events = [
+  // Tenants
+  { id: 'directory.tenants.created', label: 'Tenant Created', entity: 'tenants', category: 'crud' },
+  { id: 'directory.tenants.updated', label: 'Tenant Updated', entity: 'tenants', category: 'crud' },
+  { id: 'directory.tenants.deleted', label: 'Tenant Deleted', entity: 'tenants', category: 'crud' },
+
+  // Organizations
+  { id: 'directory.organizations.created', label: 'Organization Created', entity: 'organizations', category: 'crud' },
+  { id: 'directory.organizations.updated', label: 'Organization Updated', entity: 'organizations', category: 'crud' },
+  { id: 'directory.organizations.deleted', label: 'Organization Deleted', entity: 'organizations', category: 'crud' },
+] as const
+
+export const eventsConfig = createModuleEvents({
+  moduleId: 'directory',
+  events,
+})
+
+/** Type-safe event emitter for directory module */
+export const emitDirectoryEvent = eventsConfig.emit
+
+/** Event IDs that can be emitted by the directory module */
+export type DirectoryEventId = typeof events[number]['id']
+
+export default eventsConfig

package/src/modules/sales/acl.ts

@@ -1,6 +1,7 @@
 export const features = [
   { id: 'sales.orders.view', title: 'View sales orders', module: 'sales' },
   { id: 'sales.orders.manage', title: 'Manage sales orders', module: 'sales' },
+  { id: 'sales.orders.approve', title: 'Approve sales orders', module: 'sales' },
   { id: 'sales.quotes.view', title: 'View sales quotes', module: 'sales' },
   { id: 'sales.quotes.manage', title: 'Manage sales quotes', module: 'sales' },
   { id: 'sales.shipments.manage', title: 'Manage order shipments', module: 'sales' },

package/src/modules/sales/backend/sales/documents/[id]/page.tsx

@@ -50,6 +50,9 @@ import {
   emitSalesDocumentTotalsRefresh,
   subscribeSalesDocumentTotalsRefresh,
 } from '@open-mercato/core/modules/sales/lib/frontend/documentTotalsEvents'
+import {
+  subscribeSalesDocumentDataRefresh,
+} from '@open-mercato/core/modules/sales/lib/frontend/documentDataEvents'
 import type { CommentSummary, SectionAction } from '@open-mercato/ui/backend/detail'
 import { ICON_SUGGESTIONS } from '@open-mercato/core/modules/customers/lib/dictionaries'
 import { readMarkdownPreferenceCookie, writeMarkdownPreferenceCookie } from '@open-mercato/core/modules/customers/lib/markdownPreference'
@@ -2601,6 +2604,19 @@ export default function SalesDocumentDetailPage({
     [kind, record?.id, refreshDocumentTotals],
   )
 
+  // Subscribe to document data refresh events (e.g., from workflow status updates)
+  React.useEffect(
+    () =>
+      subscribeSalesDocumentDataRefresh((detail) => {
+        if (!record?.id) return
+        if (detail.documentId !== record.id) return
+        if (detail.kind && detail.kind !== kind) return
+        // Increment reloadKey to trigger a full document reload
+        setReloadKey((prev) => prev + 1)
+      }),
+    [kind, record?.id],
+  )
+
   const statusDictionaryMap = React.useMemo(
     () =>
       createDictionaryMap(

package/src/modules/sales/commands/documents.ts

@@ -4,7 +4,7 @@ import { randomUUID } from 'crypto'
 import { z } from 'zod'
 import { registerCommand } from '@open-mercato/shared/lib/commands'
 import type { CommandHandler } from '@open-mercato/shared/lib/commands'
-import { emitCrudSideEffects, requireId } from '@open-mercato/shared/lib/commands/helpers'
+import { emitCrudSideEffects, requireId, type CrudEventsConfig } from '@open-mercato/shared/lib/commands/helpers'
 import type { EntityManager } from '@mikro-orm/postgresql'
 import type { EventBus } from '@open-mercato/events'
 import type { DataEngine } from '@open-mercato/shared/lib/data/engine'
@@ -89,6 +89,29 @@ import { resolveStatusEntryIdByValue } from '../lib/statusHelpers'
 import { SalesDocumentNumberGenerator } from '../services/salesDocumentNumberGenerator'
 import { loadSalesSettings } from './settings'
 
+// CRUD events configuration for workflow triggers
+const orderCrudEvents: CrudEventsConfig<SalesOrder> = {
+  module: 'sales',
+  entity: 'orders',
+  persistent: true,
+  buildPayload: (ctx) => ({
+    id: ctx.identifiers.id,
+    organizationId: ctx.identifiers.organizationId,
+    tenantId: ctx.identifiers.tenantId,
+  }),
+}
+
+const quoteCrudEvents: CrudEventsConfig<SalesQuote> = {
+  module: 'sales',
+  entity: 'quotes',
+  persistent: true,
+  buildPayload: (ctx) => ({
+    id: ctx.identifiers.id,
+    organizationId: ctx.identifiers.organizationId,
+    tenantId: ctx.identifiers.tenantId,
+  }),
+}
+
 type DocumentAddressSnapshot = {
   id: string
   organizationId: string
@@ -3111,6 +3134,31 @@ const createQuoteCommand: CommandHandler<QuoteCreateInput, { quoteId: string }>
     })
     await em.flush()
 
+    // Emit CRUD side effects to trigger workflow event listeners
+    const dataEngine = ctx.container.resolve('dataEngine') as DataEngine
+    await emitCrudSideEffects({
+      dataEngine,
+      action: 'created',
+      entity: quote,
+      identifiers: {
+        id: quote.id,
+        organizationId: quote.organizationId,
+        tenantId: quote.tenantId,
+      },
+      events: quoteCrudEvents,
+      indexer: { entityType: E.sales.sales_quote },
+    })
+
+    // Invalidate cache
+    const resourceKind = deriveResourceFromCommandId(createQuoteCommand.id) ?? 'sales.quote'
+    await invalidateCrudCache(
+      ctx.container,
+      resourceKind,
+      { id: quote.id, organizationId: quote.organizationId, tenantId: quote.tenantId },
+      ctx.auth?.tenantId ?? null,
+      'created'
+    )
+
     return { quoteId: quote.id }
   },
   captureAfter: async (_input, result, ctx) => {
@@ -3782,6 +3830,31 @@ const createOrderCommand: CommandHandler<OrderCreateInput, { orderId: string }>
     })
     await em.flush()
 
+    // Emit CRUD side effects to trigger workflow event listeners
+    const dataEngine = ctx.container.resolve('dataEngine') as DataEngine
+    await emitCrudSideEffects({
+      dataEngine,
+      action: 'created',
+      entity: order,
+      identifiers: {
+        id: order.id,
+        organizationId: order.organizationId,
+        tenantId: order.tenantId,
+      },
+      events: orderCrudEvents,
+      indexer: { entityType: E.sales.sales_order },
+    })
+
+    // Invalidate cache
+    const resourceKind = deriveResourceFromCommandId(createOrderCommand.id) ?? 'sales.order'
+    await invalidateCrudCache(
+      ctx.container,
+      resourceKind,
+      { id: order.id, organizationId: order.organizationId, tenantId: order.tenantId },
+      ctx.auth?.tenantId ?? null,
+      'created'
+    )
+
     return { orderId: order.id }
   },
   captureAfter: async (_input, result, ctx) => {

package/src/modules/sales/events.ts

@@ -0,0 +1,82 @@
+import { createModuleEvents } from '@open-mercato/shared/modules/events'
+
+/**
+ * Sales Module Events
+ *
+ * Declares all events that can be emitted by the sales module.
+ */
+const events = [
+  // Orders
+  { id: 'sales.orders.created', label: 'Sales Order Created', entity: 'orders', category: 'crud' },
+  { id: 'sales.orders.updated', label: 'Sales Order Updated', entity: 'orders', category: 'crud' },
+  { id: 'sales.orders.deleted', label: 'Sales Order Deleted', entity: 'orders', category: 'crud' },
+
+  // Quotes
+  { id: 'sales.quotes.created', label: 'Quote Created', entity: 'quotes', category: 'crud' },
+  { id: 'sales.quotes.updated', label: 'Quote Updated', entity: 'quotes', category: 'crud' },
+  { id: 'sales.quotes.deleted', label: 'Quote Deleted', entity: 'quotes', category: 'crud' },
+
+  // Invoices
+  { id: 'sales.invoices.created', label: 'Invoice Created', entity: 'invoices', category: 'crud' },
+  { id: 'sales.invoices.updated', label: 'Invoice Updated', entity: 'invoices', category: 'crud' },
+  { id: 'sales.invoices.deleted', label: 'Invoice Deleted', entity: 'invoices', category: 'crud' },
+
+  // Order Lines
+  { id: 'sales.lines.created', label: 'Order Line Created', entity: 'lines', category: 'crud' },
+  { id: 'sales.lines.updated', label: 'Order Line Updated', entity: 'lines', category: 'crud' },
+  { id: 'sales.lines.deleted', label: 'Order Line Deleted', entity: 'lines', category: 'crud' },
+
+  // Payments
+  { id: 'sales.payments.created', label: 'Payment Created', entity: 'payments', category: 'crud' },
+  { id: 'sales.payments.updated', label: 'Payment Updated', entity: 'payments', category: 'crud' },
+  { id: 'sales.payments.deleted', label: 'Payment Deleted', entity: 'payments', category: 'crud' },
+
+  // Shipments
+  { id: 'sales.shipments.created', label: 'Shipment Created', entity: 'shipments', category: 'crud' },
+  { id: 'sales.shipments.updated', label: 'Shipment Updated', entity: 'shipments', category: 'crud' },
+  { id: 'sales.shipments.deleted', label: 'Shipment Deleted', entity: 'shipments', category: 'crud' },
+
+  // Notes
+  { id: 'sales.notes.created', label: 'Note Created', entity: 'notes', category: 'crud' },
+  { id: 'sales.notes.updated', label: 'Note Updated', entity: 'notes', category: 'crud' },
+  { id: 'sales.notes.deleted', label: 'Note Deleted', entity: 'notes', category: 'crud' },
+
+  // Configuration
+  { id: 'sales.configuration.created', label: 'Configuration Created', entity: 'configuration', category: 'crud' },
+  { id: 'sales.configuration.updated', label: 'Configuration Updated', entity: 'configuration', category: 'crud' },
+  { id: 'sales.configuration.deleted', label: 'Configuration Deleted', entity: 'configuration', category: 'crud' },
+
+  // Lifecycle events - Document calculations
+  { id: 'sales.document.totals.calculated', label: 'Document Totals Calculated', category: 'lifecycle' },
+  { id: 'sales.document.calculate.before', label: 'Before Document Calculate', category: 'lifecycle', excludeFromTriggers: true },
+  { id: 'sales.document.calculate.after', label: 'After Document Calculate', category: 'lifecycle', excludeFromTriggers: true },
+
+  // Lifecycle events - Line calculations
+  { id: 'sales.line.calculate.before', label: 'Before Line Calculate', category: 'lifecycle', excludeFromTriggers: true },
+  { id: 'sales.line.calculate.after', label: 'After Line Calculate', category: 'lifecycle', excludeFromTriggers: true },
+
+  // Lifecycle events - Tax calculations
+  { id: 'sales.tax.calculate.before', label: 'Before Tax Calculate', category: 'lifecycle', excludeFromTriggers: true },
+  { id: 'sales.tax.calculate.after', label: 'After Tax Calculate', category: 'lifecycle', excludeFromTriggers: true },
+
+  // Lifecycle events - Shipping adjustments
+  { id: 'sales.shipping.adjustments.apply.before', label: 'Before Shipping Adjustments', category: 'lifecycle', excludeFromTriggers: true },
+  { id: 'sales.shipping.adjustments.apply.after', label: 'After Shipping Adjustments', category: 'lifecycle', excludeFromTriggers: true },
+
+  // Lifecycle events - Payment adjustments
+  { id: 'sales.payment.adjustments.apply.before', label: 'Before Payment Adjustments', category: 'lifecycle', excludeFromTriggers: true },
+  { id: 'sales.payment.adjustments.apply.after', label: 'After Payment Adjustments', category: 'lifecycle', excludeFromTriggers: true },
+] as const
+
+export const eventsConfig = createModuleEvents({
+  moduleId: 'sales',
+  events,
+})
+
+/** Type-safe event emitter for sales module */
+export const emitSalesEvent = eventsConfig.emit
+
+/** Event IDs that can be emitted by the sales module */
+export type SalesEventId = typeof events[number]['id']
+
+export default eventsConfig

package/src/modules/sales/lib/dictionaries.ts

@@ -125,6 +125,9 @@ type SeedScope = { tenantId: string; organizationId: string }
 
 const ORDER_STATUS_DEFAULTS: SalesDictionarySeed[] = [
   { value: 'draft', label: 'Draft', color: '#94a3b8', icon: 'lucide:file-pen-line' },
+  { value: 'pending_approval', label: 'Pending Approval', color: '#f59e0b', icon: 'lucide:hourglass' },
+  { value: 'approved', label: 'Approved', color: '#16a34a', icon: 'lucide:check-circle' },
+  { value: 'rejected', label: 'Rejected', color: '#ef4444', icon: 'lucide:x-circle' },
   { value: 'sent', label: 'Sent', color: '#0ea5e9', icon: 'lucide:send' },
   { value: 'confirmed', label: 'Confirmed', color: '#2563eb', icon: 'lucide:badge-check' },
   { value: 'in_fulfillment', label: 'In fulfillment', color: '#f59e0b', icon: 'lucide:loader-2' },