@lssm/lib.contracts 0.0.0-canary-20251207012602 → 0.0.0-canary-20251207043720

package/dist/workflow/index.d.ts

@@ -1,10 +0,0 @@
-import { CompensationStep, CompensationStrategy, FormRef, GuardCondition, GuardConditionKind, RetryPolicy, SLA, Step, StepAction, StepType, Transition, WorkflowDefinition, WorkflowMeta, WorkflowRegistry, WorkflowSpec, WorkflowStatus } from "./spec.js";
-import { ValidateWorkflowSpecOptions, WorkflowValidationError, WorkflowValidationIssue, WorkflowValidationLevel, assertWorkflowSpecValid, validateWorkflowSpec } from "./validation.js";
-import { StateStore, StepExecution, WorkflowState, WorkflowStateFilters } from "./state.js";
-import { GuardContext, GuardEvaluator, OperationExecutor, OperationExecutorContext, WorkflowPreFlightError, WorkflowPreFlightIssue, WorkflowPreFlightIssueSeverity, WorkflowPreFlightIssueType, WorkflowPreFlightResult, WorkflowRunner, WorkflowRunnerConfig } from "./runner.js";
-import { ExpressionContext, evaluateExpression } from "./expression.js";
-import { InMemoryStateStore } from "./adapters/memory-store.js";
-import { PrismaStateStore } from "./adapters/db-adapter.js";
-import { FileStateStoreOptions, createFileStateStore } from "./adapters/file-adapter.js";
-import "./adapters/index.js";
-export { CompensationStep, CompensationStrategy, ExpressionContext, FileStateStoreOptions, FormRef, GuardCondition, GuardConditionKind, GuardContext, GuardEvaluator, InMemoryStateStore, OperationExecutor, OperationExecutorContext, PrismaStateStore, RetryPolicy, SLA, StateStore, Step, StepAction, StepExecution, StepType, Transition, ValidateWorkflowSpecOptions, WorkflowDefinition, WorkflowMeta, WorkflowPreFlightError, WorkflowPreFlightIssue, WorkflowPreFlightIssueSeverity, WorkflowPreFlightIssueType, WorkflowPreFlightResult, WorkflowRegistry, WorkflowRunner, WorkflowRunnerConfig, WorkflowSpec, WorkflowState, WorkflowStateFilters, WorkflowStatus, WorkflowValidationError, WorkflowValidationIssue, WorkflowValidationLevel, assertWorkflowSpecValid, createFileStateStore, evaluateExpression, validateWorkflowSpec };

package/dist/workflow/runner.d.ts

@@ -1,74 +0,0 @@
-import { ResolvedBranding } from "../app-config/branding.js";
-import { OpRef } from "../features.js";
-import { GuardCondition, Step, WorkflowRegistry } from "./spec.js";
-import { ResolvedAppConfig, ResolvedIntegration, ResolvedKnowledge, ResolvedTranslation } from "../app-config/runtime.js";
-import { SecretProvider } from "../integrations/secrets/provider.js";
-import { TranslationResolver } from "../types.js";
-import { StateStore, WorkflowState } from "./state.js";
-
-//#region src/workflow/runner.d.ts
-interface OperationExecutorContext {
-  workflow: WorkflowState;
-  step: Step;
-  resolvedAppConfig?: ResolvedAppConfig;
-  integrations?: ResolvedIntegration[];
-  knowledge?: ResolvedKnowledge[];
-  branding?: ResolvedBranding;
-  translation?: ResolvedTranslation;
-  translationResolver?: TranslationResolver;
-  secretProvider?: SecretProvider;
-}
-type OperationExecutor = (op: OpRef, input: unknown, context: OperationExecutorContext) => Promise<unknown>;
-type WorkflowPreFlightIssueType = 'integration' | 'capability';
-type WorkflowPreFlightIssueSeverity = 'error' | 'warning';
-interface WorkflowPreFlightIssue {
-  stepId: string;
-  type: WorkflowPreFlightIssueType;
-  identifier: string;
-  severity: WorkflowPreFlightIssueSeverity;
-  reason: string;
-}
-interface WorkflowPreFlightResult {
-  canStart: boolean;
-  issues: WorkflowPreFlightIssue[];
-}
-interface GuardContext {
-  workflow: WorkflowState;
-  step: Step;
-  input?: unknown;
-}
-type GuardEvaluator = (guard: GuardCondition, context: GuardContext) => Promise<boolean> | boolean;
-interface WorkflowRunnerConfig {
-  registry: WorkflowRegistry;
-  stateStore: StateStore;
-  opExecutor: OperationExecutor;
-  guardEvaluator?: GuardEvaluator;
-  eventEmitter?: (event: string, payload: Record<string, unknown>) => void;
-  appConfigProvider?: (state: WorkflowState) => ResolvedAppConfig | undefined | Promise<ResolvedAppConfig | undefined>;
-  enforceCapabilities?: (operation: OpRef, context: OperationExecutorContext) => void | Promise<void>;
-  secretProvider?: SecretProvider;
-  translationResolver?: TranslationResolver;
-}
-declare class WorkflowRunner {
-  private readonly config;
-  constructor(config: WorkflowRunnerConfig);
-  preFlightCheck(workflowName: string, version?: number, resolvedConfig?: ResolvedAppConfig): Promise<WorkflowPreFlightResult>;
-  start(workflowName: string, version?: number, initialData?: Record<string, unknown>): Promise<string>;
-  executeStep(workflowId: string, input?: unknown): Promise<void>;
-  rollback(workflowId: string): Promise<void>;
-  getState(workflowId: string): Promise<WorkflowState>;
-  cancel(workflowId: string): Promise<void>;
-  private performPreFlight;
-  private evaluateGuard;
-  private runStepAction;
-  private pickNextStepId;
-  private getSpec;
-  private getStateOrThrow;
-  private emit;
-}
-declare class WorkflowPreFlightError extends Error {
-  readonly issues: WorkflowPreFlightIssue[];
-  constructor(issues: WorkflowPreFlightIssue[]);
-}
-//#endregion
-export { GuardContext, GuardEvaluator, OperationExecutor, OperationExecutorContext, WorkflowPreFlightError, WorkflowPreFlightIssue, WorkflowPreFlightIssueSeverity, WorkflowPreFlightIssueType, WorkflowPreFlightResult, WorkflowRunner, WorkflowRunnerConfig };

package/dist/workflow/sla-monitor.d.ts

@@ -1,20 +0,0 @@
-import { WorkflowSpec } from "./spec.js";
-import { WorkflowState } from "./state.js";
-
-//#region src/workflow/sla-monitor.d.ts
-interface SLABreachEvent {
-  workflowId: string;
-  workflowName: string;
-  type: 'workflow_duration' | 'step_duration';
-  stepId?: string;
-  expectedMs: number;
-  actualMs: number;
-  breachedAt: Date;
-}
-declare class SLAMonitor {
-  private readonly eventEmitter;
-  constructor(eventEmitter: (event: string, payload: SLABreachEvent) => void);
-  check(state: WorkflowState, spec: WorkflowSpec): void;
-}
-//#endregion
-export { SLABreachEvent, SLAMonitor };

package/dist/workflow/spec.d.ts

@@ -1,99 +0,0 @@
-import { OwnerShipMeta } from "../ownership.js";
-import { CapabilityRef } from "../capabilities.js";
-import { ExperimentRef } from "../experiments/spec.js";
-import { OpRef } from "../features.js";
-
-//#region src/workflow/spec.d.ts
-
-/**
- * Reference to a form spec declared in {@link FormRegistry}.
- */
-interface FormRef {
-  key: string;
-  version: number;
-}
-type StepType = 'human' | 'automation' | 'decision';
-type WorkflowStatus = 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
-type GuardConditionKind = 'policy' | 'expression';
-interface GuardCondition {
-  type: GuardConditionKind;
-  /** Policy name or expression string depending on the type. */
-  value: string;
-}
-interface RetryPolicy {
-  maxAttempts: number;
-  backoff: 'linear' | 'exponential';
-  delayMs: number;
-  /** Optional max delay cap for exponential backoff. */
-  maxDelayMs?: number;
-}
-interface StepAction {
-  /** Operation executed for automation steps. */
-  operation?: OpRef;
-  /** Form rendered for human input steps. */
-  form?: FormRef;
-}
-interface Step {
-  id: string;
-  type: StepType;
-  label: string;
-  description?: string;
-  action?: StepAction;
-  guard?: GuardCondition;
-  timeoutMs?: number;
-  retry?: RetryPolicy;
-  /** Integration slot identifiers required before this step can execute. */
-  requiredIntegrations?: string[];
-  /** Capabilities that must be enabled for this step to execute. */
-  requiredCapabilities?: CapabilityRef[];
-}
-interface Transition {
-  from: string;
-  to: string;
-  label?: string;
-  /** Expression evaluated against workflow data (e.g., `data.approved === true`). */
-  condition?: string;
-}
-interface SLA {
-  totalDurationMs?: number;
-  stepDurationMs?: Record<string, number>;
-}
-interface CompensationStep {
-  stepId: string;
-  operation: OpRef;
-  description?: string;
-}
-interface CompensationStrategy {
-  trigger?: 'on_failure' | 'manual';
-  steps: CompensationStep[];
-}
-interface WorkflowDefinition {
-  steps: Step[];
-  transitions: Transition[];
-  /** Optional explicit entry step. Defaults to the first step when omitted. */
-  entryStepId?: string;
-  sla?: SLA;
-  compensation?: CompensationStrategy;
-}
-interface WorkflowMeta extends OwnerShipMeta {
-  /** Fully-qualified workflow name (e.g., `sigil.onboarding.basic`). */
-  name: string;
-  /** Version of the workflow. Increment on breaking changes. */
-  version: number;
-}
-interface WorkflowSpec {
-  meta: WorkflowMeta;
-  definition: WorkflowDefinition;
-  policy?: {
-    flags?: string[];
-  };
-  experiments?: ExperimentRef[];
-}
-declare class WorkflowRegistry {
-  private readonly items;
-  register(spec: WorkflowSpec): this;
-  list(): WorkflowSpec[];
-  get(name: string, version?: number): WorkflowSpec | undefined;
-}
-//#endregion
-export { CompensationStep, CompensationStrategy, FormRef, GuardCondition, GuardConditionKind, RetryPolicy, SLA, Step, StepAction, StepType, Transition, WorkflowDefinition, WorkflowMeta, WorkflowRegistry, WorkflowSpec, WorkflowStatus };

package/dist/workflow/state.d.ts

@@ -1,35 +0,0 @@
-import { WorkflowStatus } from "./spec.js";
-
-//#region src/workflow/state.d.ts
-interface StepExecution {
-  stepId: string;
-  startedAt: Date;
-  completedAt?: Date;
-  status: 'pending' | 'running' | 'completed' | 'failed';
-  input?: unknown;
-  output?: unknown;
-  error?: string;
-}
-interface WorkflowState {
-  workflowId: string;
-  workflowName: string;
-  workflowVersion: number;
-  currentStep: string;
-  data: Record<string, unknown>;
-  retryCounts?: Record<string, number>;
-  history: StepExecution[];
-  status: WorkflowStatus;
-  createdAt: Date;
-  updatedAt: Date;
-}
-interface WorkflowStateFilters {
-  status?: WorkflowStatus;
-}
-interface StateStore {
-  create(state: WorkflowState): Promise<void>;
-  get(workflowId: string): Promise<WorkflowState | undefined>;
-  update(workflowId: string, updater: (current: WorkflowState) => WorkflowState): Promise<WorkflowState>;
-  list(filters?: WorkflowStateFilters): Promise<WorkflowState[]>;
-}
-//#endregion
-export { StateStore, StepExecution, WorkflowState, WorkflowStateFilters };

package/dist/workflow/validation.d.ts

@@ -1,28 +0,0 @@
-import { WorkflowSpec } from "./spec.js";
-import { SpecRegistry } from "../registry.js";
-import { FormRegistry } from "../forms.js";
-
-//#region src/workflow/validation.d.ts
-type WorkflowValidationLevel = 'error' | 'warning';
-interface WorkflowValidationIssue {
-  level: WorkflowValidationLevel;
-  message: string;
-  context?: Record<string, unknown>;
-}
-interface ValidateWorkflowSpecOptions {
-  operations?: SpecRegistry;
-  forms?: FormRegistry;
-}
-declare class WorkflowValidationError extends Error {
-  readonly issues: WorkflowValidationIssue[];
-  constructor(message: string, issues: WorkflowValidationIssue[]);
-}
-/**
- * Validate workflow structure, references, and reachability.
- * Returns the collected issues. Consumers may call {@link assertWorkflowSpecValid}
- * to throw on validation errors.
- */
-declare function validateWorkflowSpec(spec: WorkflowSpec, options?: ValidateWorkflowSpecOptions): WorkflowValidationIssue[];
-declare function assertWorkflowSpecValid(spec: WorkflowSpec, options?: ValidateWorkflowSpecOptions): void;
-//#endregion
-export { ValidateWorkflowSpecOptions, WorkflowValidationError, WorkflowValidationIssue, WorkflowValidationLevel, assertWorkflowSpecValid, validateWorkflowSpec };