@contractspec/example.workflow-system 3.8.9 → 3.8.10

package/dist/browser/entities/instance.js

@@ -1,161 +1 @@
-// src/entities/instance.ts
-import {
-  defineEntity,
-  defineEntityEnum,
-  field,
-  index
-} from "@contractspec/lib.schema";
-var InstanceStatusEnum = defineEntityEnum({
-  name: "InstanceStatus",
-  values: [
-    "PENDING",
-    "RUNNING",
-    "WAITING",
-    "PAUSED",
-    "COMPLETED",
-    "CANCELLED",
-    "FAILED",
-    "TIMEOUT"
-  ],
-  schema: "workflow",
-  description: "Status of a workflow instance."
-});
-var StepExecutionStatusEnum = defineEntityEnum({
-  name: "StepExecutionStatus",
-  values: [
-    "PENDING",
-    "ACTIVE",
-    "COMPLETED",
-    "SKIPPED",
-    "FAILED",
-    "TIMEOUT"
-  ],
-  schema: "workflow",
-  description: "Status of a step execution."
-});
-var WorkflowInstanceEntity = defineEntity({
-  name: "WorkflowInstance",
-  description: "A running instance of a workflow definition.",
-  schema: "workflow",
-  map: "workflow_instance",
-  fields: {
-    id: field.id({ description: "Unique instance ID" }),
-    workflowDefinitionId: field.foreignKey(),
-    referenceId: field.string({
-      isOptional: true,
-      description: "External reference (e.g., order ID)"
-    }),
-    referenceType: field.string({
-      isOptional: true,
-      description: 'Type of reference (e.g., "Order")'
-    }),
-    status: field.enum("InstanceStatus", { default: "PENDING" }),
-    currentStepId: field.string({
-      isOptional: true,
-      description: "Current step being executed"
-    }),
-    contextData: field.json({ description: "Data context for this instance" }),
-    triggeredBy: field.foreignKey({
-      description: "User who triggered the workflow"
-    }),
-    triggerSource: field.string({
-      isOptional: true,
-      description: 'Source of trigger (e.g., "api", "ui")'
-    }),
-    organizationId: field.foreignKey(),
-    priority: field.int({
-      default: 0,
-      description: "Processing priority (higher = more urgent)"
-    }),
-    dueAt: field.dateTime({
-      isOptional: true,
-      description: "When this instance should complete"
-    }),
-    outcome: field.string({
-      isOptional: true,
-      description: 'Final outcome (e.g., "approved", "rejected")'
-    }),
-    resultData: field.json({
-      isOptional: true,
-      description: "Final result data"
-    }),
-    errorMessage: field.string({
-      isOptional: true,
-      description: "Error message if failed"
-    }),
-    createdAt: field.createdAt(),
-    updatedAt: field.updatedAt(),
-    startedAt: field.dateTime({ isOptional: true }),
-    completedAt: field.dateTime({ isOptional: true }),
-    workflowDefinition: field.belongsTo("WorkflowDefinition", ["workflowDefinitionId"], ["id"]),
-    currentStep: field.belongsTo("WorkflowStep", ["currentStepId"], ["id"]),
-    stepExecutions: field.hasMany("StepExecution"),
-    approvalRequests: field.hasMany("ApprovalRequest")
-  },
-  indexes: [
-    index.on(["organizationId", "status"]),
-    index.on(["workflowDefinitionId", "status"]),
-    index.on(["referenceType", "referenceId"]),
-    index.on(["triggeredBy", "status"]),
-    index.on(["status", "dueAt"]),
-    index.on(["createdAt"])
-  ],
-  enums: [InstanceStatusEnum]
-});
-var StepExecutionEntity = defineEntity({
-  name: "StepExecution",
-  description: "Execution record of a step within a workflow instance.",
-  schema: "workflow",
-  map: "step_execution",
-  fields: {
-    id: field.id({ description: "Unique execution ID" }),
-    workflowInstanceId: field.foreignKey(),
-    workflowStepId: field.foreignKey(),
-    status: field.enum("StepExecutionStatus", { default: "PENDING" }),
-    executionOrder: field.int({
-      default: 0,
-      description: "Order of execution within instance"
-    }),
-    inputData: field.json({
-      isOptional: true,
-      description: "Data when entering step"
-    }),
-    outputData: field.json({
-      isOptional: true,
-      description: "Data when exiting step"
-    }),
-    actionTaken: field.string({
-      isOptional: true,
-      description: 'Action that caused transition (e.g., "approve")'
-    }),
-    transitionedTo: field.string({
-      isOptional: true,
-      description: "Step key transitioned to"
-    }),
-    executedBy: field.string({
-      isOptional: true,
-      description: "User who completed this step"
-    }),
-    errorMessage: field.string({ isOptional: true }),
-    errorDetails: field.json({ isOptional: true }),
-    retryCount: field.int({ default: 0 }),
-    createdAt: field.createdAt(),
-    updatedAt: field.updatedAt(),
-    startedAt: field.dateTime({ isOptional: true }),
-    completedAt: field.dateTime({ isOptional: true }),
-    workflowInstance: field.belongsTo("WorkflowInstance", ["workflowInstanceId"], ["id"], { onDelete: "Cascade" }),
-    workflowStep: field.belongsTo("WorkflowStep", ["workflowStepId"], ["id"])
-  },
-  indexes: [
-    index.on(["workflowInstanceId", "executionOrder"]),
-    index.on(["workflowInstanceId", "workflowStepId"]),
-    index.on(["status"])
-  ],
-  enums: [StepExecutionStatusEnum]
-});
-export {
-  WorkflowInstanceEntity,
-  StepExecutionStatusEnum,
-  StepExecutionEntity,
-  InstanceStatusEnum
-};
+import{defineEntity as q,defineEntityEnum as v,field as g,index as j}from"@contractspec/lib.schema";var z=v({name:"InstanceStatus",values:["PENDING","RUNNING","WAITING","PAUSED","COMPLETED","CANCELLED","FAILED","TIMEOUT"],schema:"workflow",description:"Status of a workflow instance."}),B=v({name:"StepExecutionStatus",values:["PENDING","ACTIVE","COMPLETED","SKIPPED","FAILED","TIMEOUT"],schema:"workflow",description:"Status of a step execution."}),D=q({name:"WorkflowInstance",description:"A running instance of a workflow definition.",schema:"workflow",map:"workflow_instance",fields:{id:g.id({description:"Unique instance ID"}),workflowDefinitionId:g.foreignKey(),referenceId:g.string({isOptional:!0,description:"External reference (e.g., order ID)"}),referenceType:g.string({isOptional:!0,description:'Type of reference (e.g., "Order")'}),status:g.enum("InstanceStatus",{default:"PENDING"}),currentStepId:g.string({isOptional:!0,description:"Current step being executed"}),contextData:g.json({description:"Data context for this instance"}),triggeredBy:g.foreignKey({description:"User who triggered the workflow"}),triggerSource:g.string({isOptional:!0,description:'Source of trigger (e.g., "api", "ui")'}),organizationId:g.foreignKey(),priority:g.int({default:0,description:"Processing priority (higher = more urgent)"}),dueAt:g.dateTime({isOptional:!0,description:"When this instance should complete"}),outcome:g.string({isOptional:!0,description:'Final outcome (e.g., "approved", "rejected")'}),resultData:g.json({isOptional:!0,description:"Final result data"}),errorMessage:g.string({isOptional:!0,description:"Error message if failed"}),createdAt:g.createdAt(),updatedAt:g.updatedAt(),startedAt:g.dateTime({isOptional:!0}),completedAt:g.dateTime({isOptional:!0}),workflowDefinition:g.belongsTo("WorkflowDefinition",["workflowDefinitionId"],["id"]),currentStep:g.belongsTo("WorkflowStep",["currentStepId"],["id"]),stepExecutions:g.hasMany("StepExecution"),approvalRequests:g.hasMany("ApprovalRequest")},indexes:[j.on(["organizationId","status"]),j.on(["workflowDefinitionId","status"]),j.on(["referenceType","referenceId"]),j.on(["triggeredBy","status"]),j.on(["status","dueAt"]),j.on(["createdAt"])],enums:[z]}),F=q({name:"StepExecution",description:"Execution record of a step within a workflow instance.",schema:"workflow",map:"step_execution",fields:{id:g.id({description:"Unique execution ID"}),workflowInstanceId:g.foreignKey(),workflowStepId:g.foreignKey(),status:g.enum("StepExecutionStatus",{default:"PENDING"}),executionOrder:g.int({default:0,description:"Order of execution within instance"}),inputData:g.json({isOptional:!0,description:"Data when entering step"}),outputData:g.json({isOptional:!0,description:"Data when exiting step"}),actionTaken:g.string({isOptional:!0,description:'Action that caused transition (e.g., "approve")'}),transitionedTo:g.string({isOptional:!0,description:"Step key transitioned to"}),executedBy:g.string({isOptional:!0,description:"User who completed this step"}),errorMessage:g.string({isOptional:!0}),errorDetails:g.json({isOptional:!0}),retryCount:g.int({default:0}),createdAt:g.createdAt(),updatedAt:g.updatedAt(),startedAt:g.dateTime({isOptional:!0}),completedAt:g.dateTime({isOptional:!0}),workflowInstance:g.belongsTo("WorkflowInstance",["workflowInstanceId"],["id"],{onDelete:"Cascade"}),workflowStep:g.belongsTo("WorkflowStep",["workflowStepId"],["id"])},indexes:[j.on(["workflowInstanceId","executionOrder"]),j.on(["workflowInstanceId","workflowStepId"]),j.on(["status"])],enums:[B]});export{D as WorkflowInstanceEntity,B as StepExecutionStatusEnum,F as StepExecutionEntity,z as InstanceStatusEnum};

package/dist/browser/entities/step.js

@@ -1,124 +1 @@
-// src/entities/step.ts
-import {
-  defineEntity,
-  defineEntityEnum,
-  field,
-  index
-} from "@contractspec/lib.schema";
-var StepTypeEnum = defineEntityEnum({
-  name: "StepType",
-  values: [
-    "START",
-    "APPROVAL",
-    "TASK",
-    "CONDITION",
-    "PARALLEL",
-    "WAIT",
-    "ACTION",
-    "END"
-  ],
-  schema: "workflow",
-  description: "Type of workflow step."
-});
-var ApprovalModeEnum = defineEntityEnum({
-  name: "ApprovalMode",
-  values: [
-    "ANY",
-    "ALL",
-    "MAJORITY",
-    "SEQUENTIAL"
-  ],
-  schema: "workflow",
-  description: "How multiple approvers are handled."
-});
-var WorkflowStepEntity = defineEntity({
-  name: "WorkflowStep",
-  description: "A single step/state in a workflow definition.",
-  schema: "workflow",
-  map: "workflow_step",
-  fields: {
-    id: field.id({ description: "Unique step ID" }),
-    workflowDefinitionId: field.foreignKey(),
-    name: field.string({ description: "Human-readable step name" }),
-    key: field.string({
-      description: 'Unique key within workflow (e.g., "manager_approval")'
-    }),
-    description: field.string({ isOptional: true }),
-    type: field.enum("StepType", { default: "TASK" }),
-    position: field.int({ default: 0, description: "Order for display" }),
-    transitions: field.json({ description: "Map of action -> next step key" }),
-    approvalMode: field.enum("ApprovalMode", {
-      default: "ANY",
-      isOptional: true
-    }),
-    approverRoles: field.string({
-      isArray: true,
-      description: "Roles that can approve"
-    }),
-    approverUserIds: field.string({
-      isArray: true,
-      description: "Specific users that can approve"
-    }),
-    escalationConfig: field.json({
-      isOptional: true,
-      description: "Escalation rules"
-    }),
-    assigneeRoles: field.string({
-      isArray: true,
-      description: "Roles that can be assigned"
-    }),
-    taskTemplate: field.json({
-      isOptional: true,
-      description: "Template for task creation"
-    }),
-    conditionExpression: field.string({
-      isOptional: true,
-      description: "Expression for branching"
-    }),
-    waitDuration: field.int({
-      isOptional: true,
-      description: "Wait duration in seconds"
-    }),
-    waitForEvent: field.string({
-      isOptional: true,
-      description: "Event name to wait for"
-    }),
-    actionType: field.string({
-      isOptional: true,
-      description: "Action to execute"
-    }),
-    actionConfig: field.json({
-      isOptional: true,
-      description: "Action parameters"
-    }),
-    timeoutSeconds: field.int({
-      isOptional: true,
-      description: "Step timeout"
-    }),
-    slaSeconds: field.int({ isOptional: true, description: "SLA deadline" }),
-    notifyOnEnter: field.json({
-      isOptional: true,
-      description: "Notification config when entering step"
-    }),
-    notifyOnExit: field.json({
-      isOptional: true,
-      description: "Notification config when exiting step"
-    }),
-    metadata: field.json({ isOptional: true }),
-    createdAt: field.createdAt(),
-    updatedAt: field.updatedAt(),
-    workflowDefinition: field.belongsTo("WorkflowDefinition", ["workflowDefinitionId"], ["id"], { onDelete: "Cascade" }),
-    executions: field.hasMany("StepExecution")
-  },
-  indexes: [
-    index.unique(["workflowDefinitionId", "key"]),
-    index.on(["workflowDefinitionId", "position"]),
-    index.on(["type"])
-  ],
-  enums: [StepTypeEnum, ApprovalModeEnum]
-});
-export {
-  WorkflowStepEntity,
-  StepTypeEnum,
-  ApprovalModeEnum
-};
+import{defineEntity as z,defineEntityEnum as q,field as j,index as k}from"@contractspec/lib.schema";var B=q({name:"StepType",values:["START","APPROVAL","TASK","CONDITION","PARALLEL","WAIT","ACTION","END"],schema:"workflow",description:"Type of workflow step."}),D=q({name:"ApprovalMode",values:["ANY","ALL","MAJORITY","SEQUENTIAL"],schema:"workflow",description:"How multiple approvers are handled."}),G=z({name:"WorkflowStep",description:"A single step/state in a workflow definition.",schema:"workflow",map:"workflow_step",fields:{id:j.id({description:"Unique step ID"}),workflowDefinitionId:j.foreignKey(),name:j.string({description:"Human-readable step name"}),key:j.string({description:'Unique key within workflow (e.g., "manager_approval")'}),description:j.string({isOptional:!0}),type:j.enum("StepType",{default:"TASK"}),position:j.int({default:0,description:"Order for display"}),transitions:j.json({description:"Map of action -> next step key"}),approvalMode:j.enum("ApprovalMode",{default:"ANY",isOptional:!0}),approverRoles:j.string({isArray:!0,description:"Roles that can approve"}),approverUserIds:j.string({isArray:!0,description:"Specific users that can approve"}),escalationConfig:j.json({isOptional:!0,description:"Escalation rules"}),assigneeRoles:j.string({isArray:!0,description:"Roles that can be assigned"}),taskTemplate:j.json({isOptional:!0,description:"Template for task creation"}),conditionExpression:j.string({isOptional:!0,description:"Expression for branching"}),waitDuration:j.int({isOptional:!0,description:"Wait duration in seconds"}),waitForEvent:j.string({isOptional:!0,description:"Event name to wait for"}),actionType:j.string({isOptional:!0,description:"Action to execute"}),actionConfig:j.json({isOptional:!0,description:"Action parameters"}),timeoutSeconds:j.int({isOptional:!0,description:"Step timeout"}),slaSeconds:j.int({isOptional:!0,description:"SLA deadline"}),notifyOnEnter:j.json({isOptional:!0,description:"Notification config when entering step"}),notifyOnExit:j.json({isOptional:!0,description:"Notification config when exiting step"}),metadata:j.json({isOptional:!0}),createdAt:j.createdAt(),updatedAt:j.updatedAt(),workflowDefinition:j.belongsTo("WorkflowDefinition",["workflowDefinitionId"],["id"],{onDelete:"Cascade"}),executions:j.hasMany("StepExecution")},indexes:[k.unique(["workflowDefinitionId","key"]),k.on(["workflowDefinitionId","position"]),k.on(["type"])],enums:[B,D]});export{G as WorkflowStepEntity,B as StepTypeEnum,D as ApprovalModeEnum};

package/dist/browser/entities/workflow.js

@@ -1,82 +1 @@
-// src/entities/workflow.ts
-import {
-  defineEntity,
-  defineEntityEnum,
-  field,
-  index
-} from "@contractspec/lib.schema";
-var WorkflowStatusEnum = defineEntityEnum({
-  name: "WorkflowStatus",
-  values: ["DRAFT", "ACTIVE", "DEPRECATED", "ARCHIVED"],
-  schema: "workflow",
-  description: "Status of a workflow definition."
-});
-var WorkflowTriggerTypeEnum = defineEntityEnum({
-  name: "WorkflowTriggerType",
-  values: ["MANUAL", "EVENT", "SCHEDULED", "API"],
-  schema: "workflow",
-  description: "What triggers workflow instantiation."
-});
-var WorkflowDefinitionEntity = defineEntity({
-  name: "WorkflowDefinition",
-  description: "A workflow blueprint that defines the process structure.",
-  schema: "workflow",
-  map: "workflow_definition",
-  fields: {
-    id: field.id({ description: "Unique workflow definition ID" }),
-    name: field.string({ description: "Human-readable workflow name" }),
-    key: field.string({
-      description: 'Unique key for referencing (e.g., "purchase_approval")'
-    }),
-    description: field.string({
-      isOptional: true,
-      description: "Detailed description"
-    }),
-    version: field.int({
-      default: 1,
-      description: "Version number for versioning definitions"
-    }),
-    status: field.enum("WorkflowStatus", { default: "DRAFT" }),
-    triggerType: field.enum("WorkflowTriggerType", { default: "MANUAL" }),
-    triggerConfig: field.json({
-      isOptional: true,
-      description: "Trigger-specific configuration"
-    }),
-    initialStepId: field.string({
-      isOptional: true,
-      description: "First step when workflow starts"
-    }),
-    featureFlagKey: field.string({
-      isOptional: true,
-      description: "Feature flag to control availability"
-    }),
-    settings: field.json({
-      isOptional: true,
-      description: "Workflow-wide settings"
-    }),
-    metadata: field.json({ isOptional: true, description: "Custom metadata" }),
-    organizationId: field.foreignKey({ description: "Owning organization" }),
-    createdBy: field.foreignKey({
-      description: "User who created this workflow"
-    }),
-    createdAt: field.createdAt(),
-    updatedAt: field.updatedAt(),
-    publishedAt: field.dateTime({
-      isOptional: true,
-      description: "When workflow was activated"
-    }),
-    steps: field.hasMany("WorkflowStep"),
-    instances: field.hasMany("WorkflowInstance")
-  },
-  indexes: [
-    index.unique(["organizationId", "key", "version"]),
-    index.on(["organizationId", "status"]),
-    index.on(["key", "version"])
-  ],
-  enums: [WorkflowStatusEnum, WorkflowTriggerTypeEnum]
-});
-export {
-  WorkflowTriggerTypeEnum,
-  WorkflowStatusEnum,
-  WorkflowDefinitionEntity
-};
+import{defineEntity as z,defineEntityEnum as v,field as j,index as q}from"@contractspec/lib.schema";var B=v({name:"WorkflowStatus",values:["DRAFT","ACTIVE","DEPRECATED","ARCHIVED"],schema:"workflow",description:"Status of a workflow definition."}),G=v({name:"WorkflowTriggerType",values:["MANUAL","EVENT","SCHEDULED","API"],schema:"workflow",description:"What triggers workflow instantiation."}),J=z({name:"WorkflowDefinition",description:"A workflow blueprint that defines the process structure.",schema:"workflow",map:"workflow_definition",fields:{id:j.id({description:"Unique workflow definition ID"}),name:j.string({description:"Human-readable workflow name"}),key:j.string({description:'Unique key for referencing (e.g., "purchase_approval")'}),description:j.string({isOptional:!0,description:"Detailed description"}),version:j.int({default:1,description:"Version number for versioning definitions"}),status:j.enum("WorkflowStatus",{default:"DRAFT"}),triggerType:j.enum("WorkflowTriggerType",{default:"MANUAL"}),triggerConfig:j.json({isOptional:!0,description:"Trigger-specific configuration"}),initialStepId:j.string({isOptional:!0,description:"First step when workflow starts"}),featureFlagKey:j.string({isOptional:!0,description:"Feature flag to control availability"}),settings:j.json({isOptional:!0,description:"Workflow-wide settings"}),metadata:j.json({isOptional:!0,description:"Custom metadata"}),organizationId:j.foreignKey({description:"Owning organization"}),createdBy:j.foreignKey({description:"User who created this workflow"}),createdAt:j.createdAt(),updatedAt:j.updatedAt(),publishedAt:j.dateTime({isOptional:!0,description:"When workflow was activated"}),steps:j.hasMany("WorkflowStep"),instances:j.hasMany("WorkflowInstance")},indexes:[q.unique(["organizationId","key","version"]),q.on(["organizationId","status"]),q.on(["key","version"])],enums:[B,G]});export{G as WorkflowTriggerTypeEnum,B as WorkflowStatusEnum,J as WorkflowDefinitionEntity};

package/dist/browser/example.js

@@ -1,42 +1 @@
-// src/example.ts
-import { defineExample } from "@contractspec/lib.contracts-spec";
-var example = defineExample({
-  meta: {
-    key: "workflow-system",
-    version: "1.0.0",
-    title: "Workflow / Approval System",
-    description: "State-machine driven approvals with RBAC, audit trail, notifications, and jobs.",
-    kind: "template",
-    visibility: "public",
-    stability: "experimental",
-    owners: ["@platform.core"],
-    tags: ["workflow", "approval", "state-machine", "rbac"]
-  },
-  docs: {
-    rootDocId: "docs.examples.workflow-system",
-    goalDocId: "docs.examples.workflow-system.goal",
-    usageDocId: "docs.examples.workflow-system.usage",
-    constraintsDocId: "docs.examples.workflow-system.constraints"
-  },
-  entrypoints: {
-    packageName: "@contractspec/example.workflow-system",
-    feature: "./feature",
-    contracts: "./contracts",
-    presentations: "./presentations",
-    handlers: "./handlers",
-    docs: "./docs"
-  },
-  surfaces: {
-    templates: true,
-    sandbox: {
-      enabled: true,
-      modes: ["playground", "specs", "builder", "markdown", "evolution"]
-    },
-    studio: { enabled: true, installable: true },
-    mcp: { enabled: true }
-  }
-});
-var example_default = example;
-export {
-  example_default as default
-};
+import{defineExample as g}from"@contractspec/lib.contracts-spec";var h=g({meta:{key:"workflow-system",version:"1.0.0",title:"Workflow / Approval System",description:"State-machine driven approvals with RBAC, audit trail, notifications, and jobs.",kind:"template",visibility:"public",stability:"experimental",owners:["@platform.core"],tags:["workflow","approval","state-machine","rbac"]},docs:{rootDocId:"docs.examples.workflow-system",goalDocId:"docs.examples.workflow-system.goal",usageDocId:"docs.examples.workflow-system.usage",constraintsDocId:"docs.examples.workflow-system.constraints"},entrypoints:{packageName:"@contractspec/example.workflow-system",feature:"./feature",contracts:"./contracts",presentations:"./presentations",handlers:"./handlers",docs:"./docs"},surfaces:{templates:!0,sandbox:{enabled:!0,modes:["playground","specs","builder","markdown","evolution"]},studio:{enabled:!0,installable:!0},mcp:{enabled:!0}}}),q=h;export{q as default};