@contractspec/example.workflow-system 3.8.9 → 3.8.11

package/dist/browser/instance/index.js

@@ -1,677 +1 @@
-// src/instance/instance.enum.ts
-import { defineEnum } from "@contractspec/lib.schema";
-var InstanceStatusEnum = defineEnum("InstanceStatus", [
-  "PENDING",
-  "RUNNING",
-  "WAITING",
-  "PAUSED",
-  "COMPLETED",
-  "CANCELLED",
-  "FAILED",
-  "TIMEOUT"
-]);
-
-// src/instance/instance.event.ts
-import { defineEvent } from "@contractspec/lib.contracts-spec";
-import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
-var InstanceEventPayload = defineSchemaModel({
-  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 }
-  }
-});
-var StepTransitionPayload = defineSchemaModel({
-  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 }
-  }
-});
-var InstanceCompletedPayload = defineSchemaModel({
-  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 }
-  }
-});
-var InstanceStartedEvent = defineEvent({
-  meta: {
-    key: "workflow.instance.started",
-    version: "1.0.0",
-    description: "A new workflow instance has been started.",
-    stability: "stable",
-    owners: ["@workflow-team"],
-    tags: ["workflow", "instance", "started"]
-  },
-  payload: InstanceEventPayload
-});
-var StepEnteredEvent = defineEvent({
-  meta: {
-    key: "workflow.step.entered",
-    version: "1.0.0",
-    description: "A workflow instance has entered a new step.",
-    stability: "stable",
-    owners: ["@workflow-team"],
-    tags: ["workflow", "step", "entered"]
-  },
-  payload: StepTransitionPayload
-});
-var StepExitedEvent = defineEvent({
-  meta: {
-    key: "workflow.step.exited",
-    version: "1.0.0",
-    description: "A workflow instance has exited a step.",
-    stability: "stable",
-    owners: ["@workflow-team"],
-    tags: ["workflow", "step", "exited"]
-  },
-  payload: StepTransitionPayload
-});
-var InstanceCompletedEvent = defineEvent({
-  meta: {
-    key: "workflow.instance.completed",
-    version: "1.0.0",
-    description: "A workflow instance has completed.",
-    stability: "stable",
-    owners: ["@workflow-team"],
-    tags: ["workflow", "instance", "completed"]
-  },
-  payload: InstanceCompletedPayload
-});
-var InstanceCancelledEvent = defineEvent({
-  meta: {
-    key: "workflow.instance.cancelled",
-    version: "1.0.0",
-    description: "A workflow instance has been cancelled.",
-    stability: "stable",
-    owners: ["@workflow-team"],
-    tags: ["workflow", "instance", "cancelled"]
-  },
-  payload: InstanceEventPayload
-});
-var InstancePausedEvent = defineEvent({
-  meta: {
-    key: "workflow.instance.paused",
-    version: "1.0.0",
-    description: "A workflow instance has been paused.",
-    stability: "stable",
-    owners: ["@workflow-team"],
-    tags: ["workflow", "instance", "paused"]
-  },
-  payload: InstanceEventPayload
-});
-var InstanceResumedEvent = defineEvent({
-  meta: {
-    key: "workflow.instance.resumed",
-    version: "1.0.0",
-    description: "A workflow instance has been resumed.",
-    stability: "stable",
-    owners: ["@workflow-team"],
-    tags: ["workflow", "instance", "resumed"]
-  },
-  payload: InstanceEventPayload
-});
-var InstanceFailedEvent = defineEvent({
-  meta: {
-    key: "workflow.instance.failed",
-    version: "1.0.0",
-    description: "A workflow instance has failed.",
-    stability: "stable",
-    owners: ["@workflow-team"],
-    tags: ["workflow", "instance", "failed"]
-  },
-  payload: InstanceEventPayload
-});
-var InstanceTimedOutEvent = defineEvent({
-  meta: {
-    key: "workflow.instance.timedOut",
-    version: "1.0.0",
-    description: "A workflow instance has timed out.",
-    stability: "stable",
-    owners: ["@workflow-team"],
-    tags: ["workflow", "instance", "timeout"]
-  },
-  payload: InstanceEventPayload
-});
-
-// src/instance/instance.schema.ts
-import { defineSchemaModel as defineSchemaModel2, ScalarTypeEnum as ScalarTypeEnum2 } from "@contractspec/lib.schema";
-var WorkflowInstanceModel = defineSchemaModel2({
-  name: "WorkflowInstanceModel",
-  description: "A running workflow instance",
-  fields: {
-    id: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    workflowDefinitionId: {
-      type: ScalarTypeEnum2.String_unsecure(),
-      isOptional: false
-    },
-    referenceId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-    referenceType: {
-      type: ScalarTypeEnum2.String_unsecure(),
-      isOptional: true
-    },
-    status: { type: InstanceStatusEnum, isOptional: false },
-    currentStepId: {
-      type: ScalarTypeEnum2.String_unsecure(),
-      isOptional: true
-    },
-    contextData: { type: ScalarTypeEnum2.JSON(), isOptional: true },
-    triggeredBy: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    organizationId: {
-      type: ScalarTypeEnum2.String_unsecure(),
-      isOptional: false
-    },
-    priority: { type: ScalarTypeEnum2.Int_unsecure(), isOptional: false },
-    dueAt: { type: ScalarTypeEnum2.DateTime(), isOptional: true },
-    outcome: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-    resultData: { type: ScalarTypeEnum2.JSON(), isOptional: true },
-    errorMessage: {
-      type: ScalarTypeEnum2.String_unsecure(),
-      isOptional: true
-    },
-    createdAt: { type: ScalarTypeEnum2.DateTime(), isOptional: false },
-    startedAt: { type: ScalarTypeEnum2.DateTime(), isOptional: true },
-    completedAt: { type: ScalarTypeEnum2.DateTime(), isOptional: true }
-  }
-});
-var StartWorkflowInputModel = defineSchemaModel2({
-  name: "StartWorkflowInput",
-  description: "Input for starting a workflow",
-  fields: {
-    workflowKey: { type: ScalarTypeEnum2.NonEmptyString(), isOptional: false },
-    contextData: { type: ScalarTypeEnum2.JSON(), isOptional: true },
-    referenceId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-    referenceType: {
-      type: ScalarTypeEnum2.String_unsecure(),
-      isOptional: true
-    },
-    priority: { type: ScalarTypeEnum2.Int_unsecure(), isOptional: true },
-    dueAt: { type: ScalarTypeEnum2.DateTime(), isOptional: true }
-  }
-});
-var TransitionInputModel = defineSchemaModel2({
-  name: "TransitionInput",
-  description: "Input for transitioning a workflow",
-  fields: {
-    instanceId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-    action: { type: ScalarTypeEnum2.NonEmptyString(), isOptional: false },
-    data: { type: ScalarTypeEnum2.JSON(), isOptional: true },
-    comment: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true }
-  }
-});
-var TransitionResultModel = defineSchemaModel2({
-  name: "TransitionResult",
-  description: "Result of a workflow transition",
-  fields: {
-    success: { type: ScalarTypeEnum2.Boolean(), isOptional: false },
-    instance: { type: WorkflowInstanceModel, isOptional: false },
-    previousStepKey: {
-      type: ScalarTypeEnum2.String_unsecure(),
-      isOptional: true
-    },
-    currentStepKey: {
-      type: ScalarTypeEnum2.String_unsecure(),
-      isOptional: true
-    },
-    message: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true }
-  }
-});
-
-// src/instance/instance.operations.ts
-import {
-  defineCommand,
-  defineQuery
-} from "@contractspec/lib.contracts-spec/operations";
-import { defineSchemaModel as defineSchemaModel3, ScalarTypeEnum as ScalarTypeEnum3 } from "@contractspec/lib.schema";
-var OWNERS = ["@example.workflow-system"];
-var StartWorkflowContract = defineCommand({
-  meta: {
-    key: "workflow.instance.start",
-    version: "1.0.0",
-    stability: "stable",
-    owners: [...OWNERS],
-    tags: ["workflow", "instance", "start"],
-    description: "Start a new workflow instance.",
-    goal: "Initiate a workflow for a business process.",
-    context: "Order creation, request submission, etc."
-  },
-  io: {
-    input: StartWorkflowInputModel,
-    output: WorkflowInstanceModel
-  },
-  policy: { auth: "user" },
-  sideEffects: {
-    emits: [
-      {
-        key: "workflow.instance.started",
-        version: "1.0.0",
-        when: "Workflow starts",
-        payload: WorkflowInstanceModel
-      },
-      {
-        key: "workflow.step.entered",
-        version: "1.0.0",
-        when: "First step entered",
-        payload: WorkflowInstanceModel
-      }
-    ],
-    audit: ["workflow.instance.started"]
-  },
-  acceptance: {
-    scenarios: [
-      {
-        key: "start-workflow-happy-path",
-        given: ["Workflow definition exists"],
-        when: ["User starts workflow"],
-        then: ["Instance is created and started"]
-      }
-    ],
-    examples: [
-      {
-        key: "start-onboarding",
-        input: {
-          workflowKey: "onboarding-v1",
-          context: { employeeId: "emp-123" }
-        },
-        output: { id: "inst-456", status: "running" }
-      }
-    ]
-  }
-});
-var TransitionWorkflowContract = defineCommand({
-  meta: {
-    key: "workflow.instance.transition",
-    version: "1.0.0",
-    stability: "stable",
-    owners: [...OWNERS],
-    tags: ["workflow", "instance", "transition", "state-machine"],
-    description: "Transition a workflow instance to the next step.",
-    goal: "Move workflow forward based on action.",
-    context: "Task completion, approval decisions."
-  },
-  io: {
-    input: TransitionInputModel,
-    output: TransitionResultModel
-  },
-  policy: { auth: "user" },
-  sideEffects: {
-    emits: [
-      {
-        key: "workflow.step.exited",
-        version: "1.0.0",
-        when: "Step is exited",
-        payload: WorkflowInstanceModel
-      },
-      {
-        key: "workflow.step.entered",
-        version: "1.0.0",
-        when: "New step is entered",
-        payload: WorkflowInstanceModel
-      },
-      {
-        key: "workflow.instance.completed",
-        version: "1.0.0",
-        when: "Workflow reaches end",
-        payload: WorkflowInstanceModel
-      }
-    ],
-    audit: ["workflow.instance.transitioned"]
-  },
-  acceptance: {
-    scenarios: [
-      {
-        key: "transition-workflow-happy-path",
-        given: ["Workflow instance is waiting at step"],
-        when: ["User provides input"],
-        then: ["Instance moves to next step"]
-      }
-    ],
-    examples: [
-      {
-        key: "complete-task",
-        input: {
-          instanceId: "inst-456",
-          action: "complete",
-          data: { approved: true }
-        },
-        output: { success: true, nextStep: "notify-hr" }
-      }
-    ]
-  }
-});
-var PauseWorkflowContract = defineCommand({
-  meta: {
-    key: "workflow.instance.pause",
-    version: "1.0.0",
-    stability: "stable",
-    owners: [...OWNERS],
-    tags: ["workflow", "instance", "pause"],
-    description: "Pause a running workflow instance.",
-    goal: "Temporarily halt workflow execution.",
-    context: "Administrative action, emergency stop."
-  },
-  io: {
-    input: defineSchemaModel3({
-      name: "PauseResumeInput",
-      fields: {
-        instanceId: {
-          type: ScalarTypeEnum3.String_unsecure(),
-          isOptional: false
-        },
-        reason: { type: ScalarTypeEnum3.String_unsecure(), isOptional: true }
-      }
-    }),
-    output: WorkflowInstanceModel
-  },
-  policy: { auth: "user" },
-  sideEffects: {
-    emits: [
-      {
-        key: "workflow.instance.paused",
-        version: "1.0.0",
-        when: "Workflow is paused",
-        payload: WorkflowInstanceModel
-      }
-    ],
-    audit: ["workflow.instance.paused"]
-  },
-  acceptance: {
-    scenarios: [
-      {
-        key: "pause-workflow-happy-path",
-        given: ["Workflow is running"],
-        when: ["Admin pauses workflow"],
-        then: ["Instance status becomes PAUSED"]
-      }
-    ],
-    examples: [
-      {
-        key: "pause-maintenance",
-        input: { instanceId: "inst-456", reason: "System maintenance" },
-        output: { id: "inst-456", status: "paused" }
-      }
-    ]
-  }
-});
-var ResumeWorkflowContract = defineCommand({
-  meta: {
-    key: "workflow.instance.resume",
-    version: "1.0.0",
-    stability: "stable",
-    owners: [...OWNERS],
-    tags: ["workflow", "instance", "resume"],
-    description: "Resume a paused workflow instance.",
-    goal: "Continue workflow execution.",
-    context: "Administrative action."
-  },
-  io: {
-    input: defineSchemaModel3({
-      name: "PauseResumeInput",
-      fields: {
-        instanceId: {
-          type: ScalarTypeEnum3.String_unsecure(),
-          isOptional: false
-        },
-        reason: { type: ScalarTypeEnum3.String_unsecure(), isOptional: true }
-      }
-    }),
-    output: WorkflowInstanceModel
-  },
-  policy: { auth: "user" },
-  sideEffects: {
-    emits: [
-      {
-        key: "workflow.instance.resumed",
-        version: "1.0.0",
-        when: "Workflow is resumed",
-        payload: WorkflowInstanceModel
-      }
-    ],
-    audit: ["workflow.instance.resumed"]
-  },
-  acceptance: {
-    scenarios: [
-      {
-        key: "resume-workflow-happy-path",
-        given: ["Workflow is paused"],
-        when: ["Admin resumes workflow"],
-        then: ["Instance status becomes RUNNING"]
-      }
-    ],
-    examples: [
-      {
-        key: "resume-normal",
-        input: { instanceId: "inst-456", reason: "Issue resolved" },
-        output: { id: "inst-456", status: "running" }
-      }
-    ]
-  }
-});
-var CancelWorkflowContract = defineCommand({
-  meta: {
-    key: "workflow.instance.cancel",
-    version: "1.0.0",
-    stability: "stable",
-    owners: [...OWNERS],
-    tags: ["workflow", "instance", "cancel"],
-    description: "Cancel a workflow instance.",
-    goal: "Terminate workflow without completion.",
-    context: "User request, system cancellation."
-  },
-  io: {
-    input: defineSchemaModel3({
-      name: "CancelWorkflowInput",
-      fields: {
-        instanceId: {
-          type: ScalarTypeEnum3.String_unsecure(),
-          isOptional: false
-        },
-        reason: {
-          type: ScalarTypeEnum3.String_unsecure(),
-          isOptional: false
-        }
-      }
-    }),
-    output: WorkflowInstanceModel
-  },
-  policy: { auth: "user" },
-  sideEffects: {
-    emits: [
-      {
-        key: "workflow.instance.cancelled",
-        version: "1.0.0",
-        when: "Workflow is cancelled",
-        payload: WorkflowInstanceModel
-      }
-    ],
-    audit: ["workflow.instance.cancelled"]
-  },
-  acceptance: {
-    scenarios: [
-      {
-        key: "cancel-workflow-happy-path",
-        given: ["Workflow is running"],
-        when: ["User cancels workflow"],
-        then: ["Instance status becomes CANCELLED"]
-      }
-    ],
-    examples: [
-      {
-        key: "cancel-mistake",
-        input: { instanceId: "inst-456", reason: "Created by mistake" },
-        output: { id: "inst-456", status: "cancelled" }
-      }
-    ]
-  }
-});
-var ListInstancesContract = defineQuery({
-  meta: {
-    key: "workflow.instance.list",
-    version: "1.0.0",
-    stability: "stable",
-    owners: [...OWNERS],
-    tags: ["workflow", "instance", "list"],
-    description: "List workflow instances with filtering.",
-    goal: "Browse and search running workflows.",
-    context: "Dashboard, monitoring."
-  },
-  io: {
-    input: defineSchemaModel3({
-      name: "ListInstancesInput",
-      fields: {
-        workflowKey: {
-          type: ScalarTypeEnum3.String_unsecure(),
-          isOptional: true
-        },
-        status: { type: InstanceStatusEnum, isOptional: true },
-        referenceType: {
-          type: ScalarTypeEnum3.String_unsecure(),
-          isOptional: true
-        },
-        referenceId: {
-          type: ScalarTypeEnum3.String_unsecure(),
-          isOptional: true
-        },
-        triggeredBy: {
-          type: ScalarTypeEnum3.String_unsecure(),
-          isOptional: true
-        },
-        limit: {
-          type: ScalarTypeEnum3.Int_unsecure(),
-          isOptional: true,
-          defaultValue: 20
-        },
-        offset: {
-          type: ScalarTypeEnum3.Int_unsecure(),
-          isOptional: true,
-          defaultValue: 0
-        }
-      }
-    }),
-    output: defineSchemaModel3({
-      name: "ListInstancesOutput",
-      fields: {
-        instances: {
-          type: WorkflowInstanceModel,
-          isArray: true,
-          isOptional: false
-        },
-        total: { type: ScalarTypeEnum3.Int_unsecure(), isOptional: false }
-      }
-    })
-  },
-  policy: { auth: "user" },
-  acceptance: {
-    scenarios: [
-      {
-        key: "list-instances-happy-path",
-        given: ["Workflow instances exist"],
-        when: ["User lists instances"],
-        then: ["List of instances is returned"]
-      }
-    ],
-    examples: [
-      {
-        key: "list-running",
-        input: { status: "running", limit: 10 },
-        output: { instances: [], total: 5 }
-      }
-    ]
-  }
-});
-var GetInstanceContract = defineQuery({
-  meta: {
-    key: "workflow.instance.get",
-    version: "1.0.0",
-    stability: "stable",
-    owners: [...OWNERS],
-    tags: ["workflow", "instance", "get"],
-    description: "Get a workflow instance with details.",
-    goal: "View workflow instance details.",
-    context: "Instance detail view."
-  },
-  io: {
-    input: defineSchemaModel3({
-      name: "GetInstanceInput",
-      fields: {
-        instanceId: {
-          type: ScalarTypeEnum3.String_unsecure(),
-          isOptional: false
-        }
-      }
-    }),
-    output: WorkflowInstanceModel
-  },
-  policy: { auth: "user" },
-  acceptance: {
-    scenarios: [
-      {
-        key: "get-instance-happy-path",
-        given: ["Instance exists"],
-        when: ["User requests instance details"],
-        then: ["Instance details are returned"]
-      }
-    ],
-    examples: [
-      {
-        key: "get-details",
-        input: { instanceId: "inst-456" },
-        output: { id: "inst-456", workflowKey: "onboarding-v1" }
-      }
-    ]
-  }
-});
-export {
-  WorkflowInstanceModel,
-  TransitionWorkflowContract,
-  TransitionResultModel,
-  TransitionInputModel,
-  StepExitedEvent,
-  StepEnteredEvent,
-  StartWorkflowInputModel,
-  StartWorkflowContract,
-  ResumeWorkflowContract,
-  PauseWorkflowContract,
-  ListInstancesContract,
-  InstanceTimedOutEvent,
-  InstanceStatusEnum,
-  InstanceStartedEvent,
-  InstanceResumedEvent,
-  InstancePausedEvent,
-  InstanceFailedEvent,
-  InstanceCompletedEvent,
-  InstanceCancelledEvent,
-  GetInstanceContract,
-  CancelWorkflowContract
-};
+import{defineEnum as X}from"@contractspec/lib.schema";var z=X("InstanceStatus",["PENDING","RUNNING","WAITING","PAUSED","COMPLETED","CANCELLED","FAILED","TIMEOUT"]);import{defineEvent as G}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as D,ScalarTypeEnum as C}from"@contractspec/lib.schema";var j=D({name:"InstanceEventPayload",description:"Base payload for instance events",fields:{instanceId:{type:C.String_unsecure(),isOptional:!1},workflowId:{type:C.String_unsecure(),isOptional:!1},workflowKey:{type:C.String_unsecure(),isOptional:!1},status:{type:C.String_unsecure(),isOptional:!1},referenceId:{type:C.String_unsecure(),isOptional:!0},referenceType:{type:C.String_unsecure(),isOptional:!0},triggeredBy:{type:C.String_unsecure(),isOptional:!1},organizationId:{type:C.String_unsecure(),isOptional:!1},timestamp:{type:C.DateTime(),isOptional:!1}}}),U=D({name:"StepTransitionEventPayload",description:"Payload for step transition events",fields:{instanceId:{type:C.String_unsecure(),isOptional:!1},workflowId:{type:C.String_unsecure(),isOptional:!1},fromStepKey:{type:C.String_unsecure(),isOptional:!0},toStepKey:{type:C.String_unsecure(),isOptional:!1},action:{type:C.String_unsecure(),isOptional:!0},executedBy:{type:C.String_unsecure(),isOptional:!1},timestamp:{type:C.DateTime(),isOptional:!1}}}),Y=D({name:"InstanceCompletedEventPayload",description:"Payload when instance completes",fields:{instanceId:{type:C.String_unsecure(),isOptional:!1},workflowId:{type:C.String_unsecure(),isOptional:!1},workflowKey:{type:C.String_unsecure(),isOptional:!1},outcome:{type:C.String_unsecure(),isOptional:!1},referenceId:{type:C.String_unsecure(),isOptional:!0},referenceType:{type:C.String_unsecure(),isOptional:!0},duration:{type:C.Int_unsecure(),isOptional:!1},timestamp:{type:C.DateTime(),isOptional:!1}}}),Z=G({meta:{key:"workflow.instance.started",version:"1.0.0",description:"A new workflow instance has been started.",stability:"stable",owners:["@workflow-team"],tags:["workflow","instance","started"]},payload:j}),_=G({meta:{key:"workflow.step.entered",version:"1.0.0",description:"A workflow instance has entered a new step.",stability:"stable",owners:["@workflow-team"],tags:["workflow","step","entered"]},payload:U}),$=G({meta:{key:"workflow.step.exited",version:"1.0.0",description:"A workflow instance has exited a step.",stability:"stable",owners:["@workflow-team"],tags:["workflow","step","exited"]},payload:U}),Q=G({meta:{key:"workflow.instance.completed",version:"1.0.0",description:"A workflow instance has completed.",stability:"stable",owners:["@workflow-team"],tags:["workflow","instance","completed"]},payload:Y}),b=G({meta:{key:"workflow.instance.cancelled",version:"1.0.0",description:"A workflow instance has been cancelled.",stability:"stable",owners:["@workflow-team"],tags:["workflow","instance","cancelled"]},payload:j}),v=G({meta:{key:"workflow.instance.paused",version:"1.0.0",description:"A workflow instance has been paused.",stability:"stable",owners:["@workflow-team"],tags:["workflow","instance","paused"]},payload:j}),O=G({meta:{key:"workflow.instance.resumed",version:"1.0.0",description:"A workflow instance has been resumed.",stability:"stable",owners:["@workflow-team"],tags:["workflow","instance","resumed"]},payload:j}),R=G({meta:{key:"workflow.instance.failed",version:"1.0.0",description:"A workflow instance has failed.",stability:"stable",owners:["@workflow-team"],tags:["workflow","instance","failed"]},payload:j}),N=G({meta:{key:"workflow.instance.timedOut",version:"1.0.0",description:"A workflow instance has timed out.",stability:"stable",owners:["@workflow-team"],tags:["workflow","instance","timeout"]},payload:j});import{defineSchemaModel as B,ScalarTypeEnum as x}from"@contractspec/lib.schema";var g=B({name:"WorkflowInstanceModel",description:"A running workflow instance",fields:{id:{type:x.String_unsecure(),isOptional:!1},workflowDefinitionId:{type:x.String_unsecure(),isOptional:!1},referenceId:{type:x.String_unsecure(),isOptional:!0},referenceType:{type:x.String_unsecure(),isOptional:!0},status:{type:z,isOptional:!1},currentStepId:{type:x.String_unsecure(),isOptional:!0},contextData:{type:x.JSON(),isOptional:!0},triggeredBy:{type:x.String_unsecure(),isOptional:!1},organizationId:{type:x.String_unsecure(),isOptional:!1},priority:{type:x.Int_unsecure(),isOptional:!1},dueAt:{type:x.DateTime(),isOptional:!0},outcome:{type:x.String_unsecure(),isOptional:!0},resultData:{type:x.JSON(),isOptional:!0},errorMessage:{type:x.String_unsecure(),isOptional:!0},createdAt:{type:x.DateTime(),isOptional:!1},startedAt:{type:x.DateTime(),isOptional:!0},completedAt:{type:x.DateTime(),isOptional:!0}}}),H=B({name:"StartWorkflowInput",description:"Input for starting a workflow",fields:{workflowKey:{type:x.NonEmptyString(),isOptional:!1},contextData:{type:x.JSON(),isOptional:!0},referenceId:{type:x.String_unsecure(),isOptional:!0},referenceType:{type:x.String_unsecure(),isOptional:!0},priority:{type:x.Int_unsecure(),isOptional:!0},dueAt:{type:x.DateTime(),isOptional:!0}}}),J=B({name:"TransitionInput",description:"Input for transitioning a workflow",fields:{instanceId:{type:x.String_unsecure(),isOptional:!1},action:{type:x.NonEmptyString(),isOptional:!1},data:{type:x.JSON(),isOptional:!0},comment:{type:x.String_unsecure(),isOptional:!0}}}),K=B({name:"TransitionResult",description:"Result of a workflow transition",fields:{success:{type:x.Boolean(),isOptional:!1},instance:{type:g,isOptional:!1},previousStepKey:{type:x.String_unsecure(),isOptional:!0},currentStepKey:{type:x.String_unsecure(),isOptional:!0},message:{type:x.String_unsecure(),isOptional:!0}}});import{defineCommand as A,defineQuery as V}from"@contractspec/lib.contracts-spec/operations";import{defineSchemaModel as q,ScalarTypeEnum as F}from"@contractspec/lib.schema";var L=["@example.workflow-system"],P=A({meta:{key:"workflow.instance.start",version:"1.0.0",stability:"stable",owners:[...L],tags:["workflow","instance","start"],description:"Start a new workflow instance.",goal:"Initiate a workflow for a business process.",context:"Order creation, request submission, etc."},io:{input:H,output:g},policy:{auth:"user"},sideEffects:{emits:[{key:"workflow.instance.started",version:"1.0.0",when:"Workflow starts",payload:g},{key:"workflow.step.entered",version:"1.0.0",when:"First step entered",payload:g}],audit:["workflow.instance.started"]},acceptance:{scenarios:[{key:"start-workflow-happy-path",given:["Workflow definition exists"],when:["User starts workflow"],then:["Instance is created and started"]}],examples:[{key:"start-onboarding",input:{workflowKey:"onboarding-v1",context:{employeeId:"emp-123"}},output:{id:"inst-456",status:"running"}}]}}),k=A({meta:{key:"workflow.instance.transition",version:"1.0.0",stability:"stable",owners:[...L],tags:["workflow","instance","transition","state-machine"],description:"Transition a workflow instance to the next step.",goal:"Move workflow forward based on action.",context:"Task completion, approval decisions."},io:{input:J,output:K},policy:{auth:"user"},sideEffects:{emits:[{key:"workflow.step.exited",version:"1.0.0",when:"Step is exited",payload:g},{key:"workflow.step.entered",version:"1.0.0",when:"New step is entered",payload:g},{key:"workflow.instance.completed",version:"1.0.0",when:"Workflow reaches end",payload:g}],audit:["workflow.instance.transitioned"]},acceptance:{scenarios:[{key:"transition-workflow-happy-path",given:["Workflow instance is waiting at step"],when:["User provides input"],then:["Instance moves to next step"]}],examples:[{key:"complete-task",input:{instanceId:"inst-456",action:"complete",data:{approved:!0}},output:{success:!0,nextStep:"notify-hr"}}]}}),w=A({meta:{key:"workflow.instance.pause",version:"1.0.0",stability:"stable",owners:[...L],tags:["workflow","instance","pause"],description:"Pause a running workflow instance.",goal:"Temporarily halt workflow execution.",context:"Administrative action, emergency stop."},io:{input:q({name:"PauseResumeInput",fields:{instanceId:{type:F.String_unsecure(),isOptional:!1},reason:{type:F.String_unsecure(),isOptional:!0}}}),output:g},policy:{auth:"user"},sideEffects:{emits:[{key:"workflow.instance.paused",version:"1.0.0",when:"Workflow is paused",payload:g}],audit:["workflow.instance.paused"]},acceptance:{scenarios:[{key:"pause-workflow-happy-path",given:["Workflow is running"],when:["Admin pauses workflow"],then:["Instance status becomes PAUSED"]}],examples:[{key:"pause-maintenance",input:{instanceId:"inst-456",reason:"System maintenance"},output:{id:"inst-456",status:"paused"}}]}}),I=A({meta:{key:"workflow.instance.resume",version:"1.0.0",stability:"stable",owners:[...L],tags:["workflow","instance","resume"],description:"Resume a paused workflow instance.",goal:"Continue workflow execution.",context:"Administrative action."},io:{input:q({name:"PauseResumeInput",fields:{instanceId:{type:F.String_unsecure(),isOptional:!1},reason:{type:F.String_unsecure(),isOptional:!0}}}),output:g},policy:{auth:"user"},sideEffects:{emits:[{key:"workflow.instance.resumed",version:"1.0.0",when:"Workflow is resumed",payload:g}],audit:["workflow.instance.resumed"]},acceptance:{scenarios:[{key:"resume-workflow-happy-path",given:["Workflow is paused"],when:["Admin resumes workflow"],then:["Instance status becomes RUNNING"]}],examples:[{key:"resume-normal",input:{instanceId:"inst-456",reason:"Issue resolved"},output:{id:"inst-456",status:"running"}}]}}),W=A({meta:{key:"workflow.instance.cancel",version:"1.0.0",stability:"stable",owners:[...L],tags:["workflow","instance","cancel"],description:"Cancel a workflow instance.",goal:"Terminate workflow without completion.",context:"User request, system cancellation."},io:{input:q({name:"CancelWorkflowInput",fields:{instanceId:{type:F.String_unsecure(),isOptional:!1},reason:{type:F.String_unsecure(),isOptional:!1}}}),output:g},policy:{auth:"user"},sideEffects:{emits:[{key:"workflow.instance.cancelled",version:"1.0.0",when:"Workflow is cancelled",payload:g}],audit:["workflow.instance.cancelled"]},acceptance:{scenarios:[{key:"cancel-workflow-happy-path",given:["Workflow is running"],when:["User cancels workflow"],then:["Instance status becomes CANCELLED"]}],examples:[{key:"cancel-mistake",input:{instanceId:"inst-456",reason:"Created by mistake"},output:{id:"inst-456",status:"cancelled"}}]}}),t=V({meta:{key:"workflow.instance.list",version:"1.0.0",stability:"stable",owners:[...L],tags:["workflow","instance","list"],description:"List workflow instances with filtering.",goal:"Browse and search running workflows.",context:"Dashboard, monitoring."},io:{input:q({name:"ListInstancesInput",fields:{workflowKey:{type:F.String_unsecure(),isOptional:!0},status:{type:z,isOptional:!0},referenceType:{type:F.String_unsecure(),isOptional:!0},referenceId:{type:F.String_unsecure(),isOptional:!0},triggeredBy:{type:F.String_unsecure(),isOptional:!0},limit:{type:F.Int_unsecure(),isOptional:!0,defaultValue:20},offset:{type:F.Int_unsecure(),isOptional:!0,defaultValue:0}}}),output:q({name:"ListInstancesOutput",fields:{instances:{type:g,isArray:!0,isOptional:!1},total:{type:F.Int_unsecure(),isOptional:!1}}})},policy:{auth:"user"},acceptance:{scenarios:[{key:"list-instances-happy-path",given:["Workflow instances exist"],when:["User lists instances"],then:["List of instances is returned"]}],examples:[{key:"list-running",input:{status:"running",limit:10},output:{instances:[],total:5}}]}}),h=V({meta:{key:"workflow.instance.get",version:"1.0.0",stability:"stable",owners:[...L],tags:["workflow","instance","get"],description:"Get a workflow instance with details.",goal:"View workflow instance details.",context:"Instance detail view."},io:{input:q({name:"GetInstanceInput",fields:{instanceId:{type:F.String_unsecure(),isOptional:!1}}}),output:g},policy:{auth:"user"},acceptance:{scenarios:[{key:"get-instance-happy-path",given:["Instance exists"],when:["User requests instance details"],then:["Instance details are returned"]}],examples:[{key:"get-details",input:{instanceId:"inst-456"},output:{id:"inst-456",workflowKey:"onboarding-v1"}}]}});export{g as WorkflowInstanceModel,k as TransitionWorkflowContract,K as TransitionResultModel,J as TransitionInputModel,$ as StepExitedEvent,_ as StepEnteredEvent,H as StartWorkflowInputModel,P as StartWorkflowContract,I as ResumeWorkflowContract,w as PauseWorkflowContract,t as ListInstancesContract,N as InstanceTimedOutEvent,z as InstanceStatusEnum,Z as InstanceStartedEvent,O as InstanceResumedEvent,v as InstancePausedEvent,R as InstanceFailedEvent,Q as InstanceCompletedEvent,b as InstanceCancelledEvent,h as GetInstanceContract,W as CancelWorkflowContract};