@contractspec/example.workflow-system 1.44.0

package/dist/instance/instance.event.js

@@ -0,0 +1,293 @@
+import { ScalarTypeEnum } from "@contractspec/lib.schema";
+import { defineEvent, defineSchemaModel as defineSchemaModel$1 } from "@contractspec/lib.contracts";
+
+//#region src/instance/instance.event.ts
+/**
+* Base payload for instance events.
+*/
+const InstanceEventPayload = defineSchemaModel$1({
+	name: "InstanceEventPayload",
+	description: "Base payload for instance events",
+	fields: {
+		instanceId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		workflowId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		workflowKey: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		status: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		referenceId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		referenceType: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		triggeredBy: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		organizationId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		timestamp: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+/**
+* Payload for step transition events.
+*/
+const StepTransitionPayload = defineSchemaModel$1({
+	name: "StepTransitionEventPayload",
+	description: "Payload for step transition events",
+	fields: {
+		instanceId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		workflowId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		fromStepKey: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		toStepKey: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		action: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		executedBy: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		timestamp: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+/**
+* Payload when instance completes.
+*/
+const InstanceCompletedPayload = defineSchemaModel$1({
+	name: "InstanceCompletedEventPayload",
+	description: "Payload when instance completes",
+	fields: {
+		instanceId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		workflowId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		workflowKey: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		outcome: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		referenceId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		referenceType: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		duration: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		timestamp: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+/**
+* InstanceStartedEvent - A new workflow instance has been started.
+*/
+const InstanceStartedEvent = defineEvent({
+	meta: {
+		key: "workflow.instance.started",
+		version: 1,
+		description: "A new workflow instance has been started.",
+		stability: "stable",
+		owners: ["@workflow-team"],
+		tags: [
+			"workflow",
+			"instance",
+			"started"
+		]
+	},
+	payload: InstanceEventPayload
+});
+/**
+* StepEnteredEvent - A workflow instance has entered a new step.
+*/
+const StepEnteredEvent = defineEvent({
+	meta: {
+		key: "workflow.step.entered",
+		version: 1,
+		description: "A workflow instance has entered a new step.",
+		stability: "stable",
+		owners: ["@workflow-team"],
+		tags: [
+			"workflow",
+			"step",
+			"entered"
+		]
+	},
+	payload: StepTransitionPayload
+});
+/**
+* StepExitedEvent - A workflow instance has exited a step.
+*/
+const StepExitedEvent = defineEvent({
+	meta: {
+		key: "workflow.step.exited",
+		version: 1,
+		description: "A workflow instance has exited a step.",
+		stability: "stable",
+		owners: ["@workflow-team"],
+		tags: [
+			"workflow",
+			"step",
+			"exited"
+		]
+	},
+	payload: StepTransitionPayload
+});
+/**
+* InstanceCompletedEvent - A workflow instance has completed.
+*/
+const InstanceCompletedEvent = defineEvent({
+	meta: {
+		key: "workflow.instance.completed",
+		version: 1,
+		description: "A workflow instance has completed.",
+		stability: "stable",
+		owners: ["@workflow-team"],
+		tags: [
+			"workflow",
+			"instance",
+			"completed"
+		]
+	},
+	payload: InstanceCompletedPayload
+});
+/**
+* InstanceCancelledEvent - A workflow instance has been cancelled.
+*/
+const InstanceCancelledEvent = defineEvent({
+	meta: {
+		key: "workflow.instance.cancelled",
+		version: 1,
+		description: "A workflow instance has been cancelled.",
+		stability: "stable",
+		owners: ["@workflow-team"],
+		tags: [
+			"workflow",
+			"instance",
+			"cancelled"
+		]
+	},
+	payload: InstanceEventPayload
+});
+/**
+* InstancePausedEvent - A workflow instance has been paused.
+*/
+const InstancePausedEvent = defineEvent({
+	meta: {
+		key: "workflow.instance.paused",
+		version: 1,
+		description: "A workflow instance has been paused.",
+		stability: "stable",
+		owners: ["@workflow-team"],
+		tags: [
+			"workflow",
+			"instance",
+			"paused"
+		]
+	},
+	payload: InstanceEventPayload
+});
+/**
+* InstanceResumedEvent - A workflow instance has been resumed.
+*/
+const InstanceResumedEvent = defineEvent({
+	meta: {
+		key: "workflow.instance.resumed",
+		version: 1,
+		description: "A workflow instance has been resumed.",
+		stability: "stable",
+		owners: ["@workflow-team"],
+		tags: [
+			"workflow",
+			"instance",
+			"resumed"
+		]
+	},
+	payload: InstanceEventPayload
+});
+/**
+* InstanceFailedEvent - A workflow instance has failed.
+*/
+const InstanceFailedEvent = defineEvent({
+	meta: {
+		key: "workflow.instance.failed",
+		version: 1,
+		description: "A workflow instance has failed.",
+		stability: "stable",
+		owners: ["@workflow-team"],
+		tags: [
+			"workflow",
+			"instance",
+			"failed"
+		]
+	},
+	payload: InstanceEventPayload
+});
+/**
+* InstanceTimedOutEvent - A workflow instance has timed out.
+*/
+const InstanceTimedOutEvent = defineEvent({
+	meta: {
+		key: "workflow.instance.timedOut",
+		version: 1,
+		description: "A workflow instance has timed out.",
+		stability: "stable",
+		owners: ["@workflow-team"],
+		tags: [
+			"workflow",
+			"instance",
+			"timeout"
+		]
+	},
+	payload: InstanceEventPayload
+});
+
+//#endregion
+export { InstanceCancelledEvent, InstanceCompletedEvent, InstanceFailedEvent, InstancePausedEvent, InstanceResumedEvent, InstanceStartedEvent, InstanceTimedOutEvent, StepEnteredEvent, StepExitedEvent };
+//# sourceMappingURL=instance.event.js.map

package/dist/instance/instance.event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.event.js","names":["defineSchemaModel"],"sources":["../../src/instance/instance.event.ts"],"sourcesContent":["import { defineEvent, defineSchemaModel } from '@contractspec/lib.contracts';\nimport { ScalarTypeEnum } from '@contractspec/lib.schema';\n\n/**\n * Base payload for instance events.\n */\nconst InstanceEventPayload = defineSchemaModel({\n  name: 'InstanceEventPayload',\n  description: 'Base payload for instance events',\n  fields: {\n    instanceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    workflowId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    workflowKey: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    referenceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    referenceType: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: true,\n    },\n    triggeredBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    organizationId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    timestamp: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\n/**\n * Payload for step transition events.\n */\nconst StepTransitionPayload = defineSchemaModel({\n  name: 'StepTransitionEventPayload',\n  description: 'Payload for step transition events',\n  fields: {\n    instanceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    workflowId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    fromStepKey: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    toStepKey: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    action: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    executedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    timestamp: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\n/**\n * Payload when instance completes.\n */\nconst InstanceCompletedPayload = defineSchemaModel({\n  name: 'InstanceCompletedEventPayload',\n  description: 'Payload when instance completes',\n  fields: {\n    instanceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    workflowId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    workflowKey: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    outcome: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    referenceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    referenceType: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: true,\n    },\n    duration: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    timestamp: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\n/**\n * InstanceStartedEvent - A new workflow instance has been started.\n */\nexport const InstanceStartedEvent = defineEvent({\n  meta: {\n    key: 'workflow.instance.started',\n    version: 1,\n    description: 'A new workflow instance has been started.',\n    stability: 'stable',\n    owners: ['@workflow-team'],\n    tags: ['workflow', 'instance', 'started'],\n  },\n  payload: InstanceEventPayload,\n});\n\n/**\n * StepEnteredEvent - A workflow instance has entered a new step.\n */\nexport const StepEnteredEvent = defineEvent({\n  meta: {\n    key: 'workflow.step.entered',\n    version: 1,\n    description: 'A workflow instance has entered a new step.',\n    stability: 'stable',\n    owners: ['@workflow-team'],\n    tags: ['workflow', 'step', 'entered'],\n  },\n  payload: StepTransitionPayload,\n});\n\n/**\n * StepExitedEvent - A workflow instance has exited a step.\n */\nexport const StepExitedEvent = defineEvent({\n  meta: {\n    key: 'workflow.step.exited',\n    version: 1,\n    description: 'A workflow instance has exited a step.',\n    stability: 'stable',\n    owners: ['@workflow-team'],\n    tags: ['workflow', 'step', 'exited'],\n  },\n  payload: StepTransitionPayload,\n});\n\n/**\n * InstanceCompletedEvent - A workflow instance has completed.\n */\nexport const InstanceCompletedEvent = defineEvent({\n  meta: {\n    key: 'workflow.instance.completed',\n    version: 1,\n    description: 'A workflow instance has completed.',\n    stability: 'stable',\n    owners: ['@workflow-team'],\n    tags: ['workflow', 'instance', 'completed'],\n  },\n  payload: InstanceCompletedPayload,\n});\n\n/**\n * InstanceCancelledEvent - A workflow instance has been cancelled.\n */\nexport const InstanceCancelledEvent = defineEvent({\n  meta: {\n    key: 'workflow.instance.cancelled',\n    version: 1,\n    description: 'A workflow instance has been cancelled.',\n    stability: 'stable',\n    owners: ['@workflow-team'],\n    tags: ['workflow', 'instance', 'cancelled'],\n  },\n  payload: InstanceEventPayload,\n});\n\n/**\n * InstancePausedEvent - A workflow instance has been paused.\n */\nexport const InstancePausedEvent = defineEvent({\n  meta: {\n    key: 'workflow.instance.paused',\n    version: 1,\n    description: 'A workflow instance has been paused.',\n    stability: 'stable',\n    owners: ['@workflow-team'],\n    tags: ['workflow', 'instance', 'paused'],\n  },\n  payload: InstanceEventPayload,\n});\n\n/**\n * InstanceResumedEvent - A workflow instance has been resumed.\n */\nexport const InstanceResumedEvent = defineEvent({\n  meta: {\n    key: 'workflow.instance.resumed',\n    version: 1,\n    description: 'A workflow instance has been resumed.',\n    stability: 'stable',\n    owners: ['@workflow-team'],\n    tags: ['workflow', 'instance', 'resumed'],\n  },\n  payload: InstanceEventPayload,\n});\n\n/**\n * InstanceFailedEvent - A workflow instance has failed.\n */\nexport const InstanceFailedEvent = defineEvent({\n  meta: {\n    key: 'workflow.instance.failed',\n    version: 1,\n    description: 'A workflow instance has failed.',\n    stability: 'stable',\n    owners: ['@workflow-team'],\n    tags: ['workflow', 'instance', 'failed'],\n  },\n  payload: InstanceEventPayload,\n});\n\n/**\n * InstanceTimedOutEvent - A workflow instance has timed out.\n */\nexport const InstanceTimedOutEvent = defineEvent({\n  meta: {\n    key: 'workflow.instance.timedOut',\n    version: 1,\n    description: 'A workflow instance has timed out.',\n    stability: 'stable',\n    owners: ['@workflow-team'],\n    tags: ['workflow', 'instance', 'timeout'],\n  },\n  payload: InstanceEventPayload,\n});\n"],"mappings":"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"}

package/dist/instance/instance.handler.d.ts

@@ -0,0 +1,27 @@
+import { HandlerContext, WorkflowInstanceRecord } from "../shared/types.js";
+
+//#region src/instance/instance.handler.d.ts
+
+declare function handleStartWorkflow(input: {
+  workflowKey: string;
+  contextData?: Record<string, unknown>;
+  referenceId?: string;
+  referenceType?: string;
+  priority?: number;
+  dueAt?: Date;
+}, context: HandlerContext): Promise<WorkflowInstanceRecord>;
+declare function handleTransitionWorkflow(input: {
+  instanceId: string;
+  action: string;
+  data?: Record<string, unknown>;
+  comment?: string;
+}, context: HandlerContext): Promise<{
+  success: boolean;
+  instance: WorkflowInstanceRecord;
+  previousStepKey?: string;
+  currentStepKey?: string;
+  message?: string;
+}>;
+//#endregion
+export { handleStartWorkflow, handleTransitionWorkflow };
+//# sourceMappingURL=instance.handler.d.ts.map

package/dist/instance/instance.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.handler.d.ts","names":[],"sources":["../../src/instance/instance.handler.ts"],"sourcesContent":[],"mappings":";;;;AAgBkB,iBAHI,mBAAA,CAGJ,KAAA,EAAA;EAIN,WAAA,EAAA,MAAA;EAED,WAAA,CAAA,EANO,MAMP,CAAA,MAAA,EAAA,OAAA,CAAA;EACA,WAAA,CAAA,EAAA,MAAA;EAAR,aAAA,CAAA,EAAA,MAAA;EAAO,QAAA,CAAA,EAAA,MAAA;EA+CY,KAAA,CAAA,EAlDV,IAkDU;CAIX,EAAA,OAAA,EApDA,cAoDA,CAAA,EAnDR,OAmDQ,CAnDA,sBAmDA,CAAA;AAGA,iBAPW,wBAAA,CAOX,KAAA,EAAA;EAGC,UAAA,EAAA,MAAA;EAFT,MAAA,EAAA,MAAA;EAAO,IAAA,CAAA,EAJC,MAID,CAAA,MAAA,EAAA,OAAA,CAAA;;YADC,iBACR;;YAES"}

package/dist/instance/instance.handler.js

@@ -0,0 +1,94 @@
+import { mockDataStore } from "../shared/mock-data.js";
+import { buildStateMachineDefinition, createStateMachineEngine } from "../state-machine/index.js";
+import { createApprovalRequests } from "../approval/approval.handler.js";
+
+//#region src/instance/instance.handler.ts
+async function handleStartWorkflow(input, context) {
+	const workflow = Array.from(mockDataStore.workflows.values()).find((w) => w.key === input.workflowKey && w.status === "ACTIVE" && w.organizationId === context.organizationId);
+	if (!workflow) throw new Error(`Active workflow ${input.workflowKey} not found`);
+	const id = `inst_${Date.now()}`;
+	const now = /* @__PURE__ */ new Date();
+	const instance = {
+		id,
+		workflowDefinitionId: workflow.id,
+		referenceId: input.referenceId,
+		referenceType: input.referenceType,
+		status: "RUNNING",
+		currentStepId: workflow.initialStepId,
+		contextData: input.contextData ?? {},
+		triggeredBy: context.userId,
+		organizationId: context.organizationId,
+		priority: input.priority ?? 0,
+		dueAt: input.dueAt,
+		createdAt: now,
+		updatedAt: now,
+		startedAt: now
+	};
+	mockDataStore.instances.set(id, instance);
+	if (workflow.initialStepId) {
+		const firstStep = mockDataStore.steps.get(workflow.initialStepId);
+		if (firstStep?.type === "APPROVAL") {
+			instance.status = "WAITING";
+			await createApprovalRequests(instance, firstStep, context);
+		}
+	}
+	return instance;
+}
+async function handleTransitionWorkflow(input, context) {
+	const instance = mockDataStore.instances.get(input.instanceId);
+	if (!instance) throw new Error(`Instance ${input.instanceId} not found`);
+	const workflow = mockDataStore.workflows.get(instance.workflowDefinitionId);
+	if (!workflow) throw new Error(`Workflow ${instance.workflowDefinitionId} not found`);
+	const steps = Array.from(mockDataStore.steps.values()).filter((s) => s.workflowDefinitionId === workflow.id);
+	const definition = buildStateMachineDefinition({
+		key: workflow.key,
+		name: workflow.name,
+		version: workflow.version,
+		initialStepId: workflow.initialStepId ?? null
+	}, steps);
+	const currentStep = steps.find((s) => s.id === instance.currentStepId);
+	const state = {
+		currentStepKey: currentStep?.key ?? "",
+		status: instance.status,
+		contextData: instance.contextData,
+		history: []
+	};
+	const transitionContext = {
+		userId: context.userId,
+		userRoles: context.userRoles,
+		data: input.data
+	};
+	const result = createStateMachineEngine().transition(definition, state, input.action, transitionContext);
+	if (!result.success) return {
+		success: false,
+		instance,
+		message: result.error
+	};
+	const previousStepKey = currentStep?.key;
+	const newStep = steps.find((s) => s.key === result.currentStepKey);
+	instance.currentStepId = newStep?.id;
+	instance.status = result.status;
+	instance.contextData = {
+		...instance.contextData,
+		...input.data
+	};
+	instance.updatedAt = /* @__PURE__ */ new Date();
+	if (result.status === "COMPLETED") {
+		instance.completedAt = /* @__PURE__ */ new Date();
+		instance.outcome = input.action;
+	}
+	if (newStep?.type === "APPROVAL") {
+		instance.status = "WAITING";
+		await createApprovalRequests(instance, newStep, context);
+	}
+	return {
+		success: true,
+		instance,
+		previousStepKey,
+		currentStepKey: result.currentStepKey ?? void 0
+	};
+}
+
+//#endregion
+export { handleStartWorkflow, handleTransitionWorkflow };
+//# sourceMappingURL=instance.handler.js.map

package/dist/instance/instance.handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.handler.js","names":["instance: WorkflowInstanceRecord","state: StateMachineState","transitionContext: TransitionContext"],"sources":["../../src/instance/instance.handler.ts"],"sourcesContent":["/**\n * Workflow instance handlers.\n */\n\nimport type { StateMachineState, TransitionContext } from '../state-machine';\nimport {\n  createStateMachineEngine,\n  buildStateMachineDefinition,\n} from '../state-machine';\nimport type { WorkflowInstanceRecord, HandlerContext } from '../shared/types';\nimport { mockDataStore } from '../shared/mock-data';\nimport { createApprovalRequests } from '../approval/approval.handler';\n\nexport async function handleStartWorkflow(\n  input: {\n    workflowKey: string;\n    contextData?: Record<string, unknown>;\n    referenceId?: string;\n    referenceType?: string;\n    priority?: number;\n    dueAt?: Date;\n  },\n  context: HandlerContext\n): Promise<WorkflowInstanceRecord> {\n  // Find active workflow by key\n  const workflow = Array.from(mockDataStore.workflows.values()).find(\n    (w) =>\n      w.key === input.workflowKey &&\n      w.status === 'ACTIVE' &&\n      w.organizationId === context.organizationId\n  );\n\n  if (!workflow) {\n    throw new Error(`Active workflow ${input.workflowKey} not found`);\n  }\n\n  const id = `inst_${Date.now()}`;\n  const now = new Date();\n\n  const instance: WorkflowInstanceRecord = {\n    id,\n    workflowDefinitionId: workflow.id,\n    referenceId: input.referenceId,\n    referenceType: input.referenceType,\n    status: 'RUNNING',\n    currentStepId: workflow.initialStepId,\n    contextData: input.contextData ?? {},\n    triggeredBy: context.userId,\n    organizationId: context.organizationId,\n    priority: input.priority ?? 0,\n    dueAt: input.dueAt,\n    createdAt: now,\n    updatedAt: now,\n    startedAt: now,\n  };\n\n  mockDataStore.instances.set(id, instance);\n\n  // Check if first step is an approval step\n  if (workflow.initialStepId) {\n    const firstStep = mockDataStore.steps.get(workflow.initialStepId);\n    if (firstStep?.type === 'APPROVAL') {\n      instance.status = 'WAITING';\n      await createApprovalRequests(instance, firstStep, context);\n    }\n  }\n\n  return instance;\n}\n\nexport async function handleTransitionWorkflow(\n  input: {\n    instanceId: string;\n    action: string;\n    data?: Record<string, unknown>;\n    comment?: string;\n  },\n  context: HandlerContext\n): Promise<{\n  success: boolean;\n  instance: WorkflowInstanceRecord;\n  previousStepKey?: string;\n  currentStepKey?: string;\n  message?: string;\n}> {\n  const instance = mockDataStore.instances.get(input.instanceId);\n  if (!instance) {\n    throw new Error(`Instance ${input.instanceId} not found`);\n  }\n\n  const workflow = mockDataStore.workflows.get(instance.workflowDefinitionId);\n  if (!workflow) {\n    throw new Error(`Workflow ${instance.workflowDefinitionId} not found`);\n  }\n\n  // Get all steps for this workflow\n  const steps = Array.from(mockDataStore.steps.values()).filter(\n    (s) => s.workflowDefinitionId === workflow.id\n  );\n\n  // Build state machine\n  const definition = buildStateMachineDefinition(\n    {\n      key: workflow.key,\n      name: workflow.name,\n      version: workflow.version,\n      initialStepId: workflow.initialStepId ?? null,\n    },\n    steps\n  );\n  const currentStep = steps.find((s) => s.id === instance.currentStepId);\n\n  const state: StateMachineState = {\n    currentStepKey: currentStep?.key ?? '',\n    status: instance.status,\n    contextData: instance.contextData,\n    history: [],\n  };\n\n  const transitionContext: TransitionContext = {\n    userId: context.userId,\n    userRoles: context.userRoles,\n    data: input.data,\n  };\n\n  const engine = createStateMachineEngine();\n  const result = engine.transition(\n    definition,\n    state,\n    input.action,\n    transitionContext\n  );\n\n  if (!result.success) {\n    return {\n      success: false,\n      instance,\n      message: result.error,\n    };\n  }\n\n  // Update instance\n  const previousStepKey = currentStep?.key;\n  const newStep = steps.find((s) => s.key === result.currentStepKey);\n\n  instance.currentStepId = newStep?.id;\n  instance.status = result.status;\n  instance.contextData = { ...instance.contextData, ...input.data };\n  instance.updatedAt = new Date();\n\n  if (result.status === 'COMPLETED') {\n    instance.completedAt = new Date();\n    instance.outcome = input.action;\n  }\n\n  // Handle approval steps\n  if (newStep?.type === 'APPROVAL') {\n    instance.status = 'WAITING';\n    await createApprovalRequests(instance, newStep, context);\n  }\n\n  return {\n    success: true,\n    instance,\n    previousStepKey,\n    currentStepKey: result.currentStepKey ?? undefined,\n  };\n}\n"],"mappings":";;;;;AAaA,eAAsB,oBACpB,OAQA,SACiC;CAEjC,MAAM,WAAW,MAAM,KAAK,cAAc,UAAU,QAAQ,CAAC,CAAC,MAC3D,MACC,EAAE,QAAQ,MAAM,eAChB,EAAE,WAAW,YACb,EAAE,mBAAmB,QAAQ,eAChC;AAED,KAAI,CAAC,SACH,OAAM,IAAI,MAAM,mBAAmB,MAAM,YAAY,YAAY;CAGnE,MAAM,KAAK,QAAQ,KAAK,KAAK;CAC7B,MAAM,sBAAM,IAAI,MAAM;CAEtB,MAAMA,WAAmC;EACvC;EACA,sBAAsB,SAAS;EAC/B,aAAa,MAAM;EACnB,eAAe,MAAM;EACrB,QAAQ;EACR,eAAe,SAAS;EACxB,aAAa,MAAM,eAAe,EAAE;EACpC,aAAa,QAAQ;EACrB,gBAAgB,QAAQ;EACxB,UAAU,MAAM,YAAY;EAC5B,OAAO,MAAM;EACb,WAAW;EACX,WAAW;EACX,WAAW;EACZ;AAED,eAAc,UAAU,IAAI,IAAI,SAAS;AAGzC,KAAI,SAAS,eAAe;EAC1B,MAAM,YAAY,cAAc,MAAM,IAAI,SAAS,cAAc;AACjE,MAAI,WAAW,SAAS,YAAY;AAClC,YAAS,SAAS;AAClB,SAAM,uBAAuB,UAAU,WAAW,QAAQ;;;AAI9D,QAAO;;AAGT,eAAsB,yBACpB,OAMA,SAOC;CACD,MAAM,WAAW,cAAc,UAAU,IAAI,MAAM,WAAW;AAC9D,KAAI,CAAC,SACH,OAAM,IAAI,MAAM,YAAY,MAAM,WAAW,YAAY;CAG3D,MAAM,WAAW,cAAc,UAAU,IAAI,SAAS,qBAAqB;AAC3E,KAAI,CAAC,SACH,OAAM,IAAI,MAAM,YAAY,SAAS,qBAAqB,YAAY;CAIxE,MAAM,QAAQ,MAAM,KAAK,cAAc,MAAM,QAAQ,CAAC,CAAC,QACpD,MAAM,EAAE,yBAAyB,SAAS,GAC5C;CAGD,MAAM,aAAa,4BACjB;EACE,KAAK,SAAS;EACd,MAAM,SAAS;EACf,SAAS,SAAS;EAClB,eAAe,SAAS,iBAAiB;EAC1C,EACD,MACD;CACD,MAAM,cAAc,MAAM,MAAM,MAAM,EAAE,OAAO,SAAS,cAAc;CAEtE,MAAMC,QAA2B;EAC/B,gBAAgB,aAAa,OAAO;EACpC,QAAQ,SAAS;EACjB,aAAa,SAAS;EACtB,SAAS,EAAE;EACZ;CAED,MAAMC,oBAAuC;EAC3C,QAAQ,QAAQ;EAChB,WAAW,QAAQ;EACnB,MAAM,MAAM;EACb;CAGD,MAAM,SADS,0BAA0B,CACnB,WACpB,YACA,OACA,MAAM,QACN,kBACD;AAED,KAAI,CAAC,OAAO,QACV,QAAO;EACL,SAAS;EACT;EACA,SAAS,OAAO;EACjB;CAIH,MAAM,kBAAkB,aAAa;CACrC,MAAM,UAAU,MAAM,MAAM,MAAM,EAAE,QAAQ,OAAO,eAAe;AAElE,UAAS,gBAAgB,SAAS;AAClC,UAAS,SAAS,OAAO;AACzB,UAAS,cAAc;EAAE,GAAG,SAAS;EAAa,GAAG,MAAM;EAAM;AACjE,UAAS,4BAAY,IAAI,MAAM;AAE/B,KAAI,OAAO,WAAW,aAAa;AACjC,WAAS,8BAAc,IAAI,MAAM;AACjC,WAAS,UAAU,MAAM;;AAI3B,KAAI,SAAS,SAAS,YAAY;AAChC,WAAS,SAAS;AAClB,QAAM,uBAAuB,UAAU,SAAS,QAAQ;;AAG1D,QAAO;EACL,SAAS;EACT;EACA;EACA,gBAAgB,OAAO,kBAAkB;EAC1C"}