@gravito/flux 3.0.1 → 3.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (48) hide show
  1. package/README.md +298 -0
  2. package/bin/flux.js +25 -1
  3. package/dev/viewer/app.js +4 -4
  4. package/dist/bun.cjs +2 -2
  5. package/dist/bun.cjs.map +1 -1
  6. package/dist/bun.d.cts +65 -26
  7. package/dist/bun.d.ts +65 -26
  8. package/dist/bun.js +1 -1
  9. package/dist/chunk-4DXCQ6CL.js +3486 -0
  10. package/dist/chunk-4DXCQ6CL.js.map +1 -0
  11. package/dist/chunk-6AZNHVEO.cjs +316 -0
  12. package/dist/chunk-6AZNHVEO.cjs.map +1 -0
  13. package/dist/{chunk-ZAMVC732.js → chunk-NAIVO7RR.js} +64 -15
  14. package/dist/chunk-NAIVO7RR.js.map +1 -0
  15. package/dist/chunk-WAPZDXSX.cjs +3486 -0
  16. package/dist/chunk-WAPZDXSX.cjs.map +1 -0
  17. package/dist/chunk-WGDTB6OC.js +316 -0
  18. package/dist/chunk-WGDTB6OC.js.map +1 -0
  19. package/dist/{chunk-SJSPR4ZU.cjs → chunk-YXBEYVGY.cjs} +66 -17
  20. package/dist/chunk-YXBEYVGY.cjs.map +1 -0
  21. package/dist/cli/flux-visualize.cjs +108 -0
  22. package/dist/cli/flux-visualize.cjs.map +1 -0
  23. package/dist/cli/flux-visualize.d.cts +1 -0
  24. package/dist/cli/flux-visualize.d.ts +1 -0
  25. package/dist/cli/flux-visualize.js +108 -0
  26. package/dist/cli/flux-visualize.js.map +1 -0
  27. package/dist/index.cjs +97 -9
  28. package/dist/index.cjs.map +1 -1
  29. package/dist/index.d.cts +369 -13
  30. package/dist/index.d.ts +369 -13
  31. package/dist/index.js +96 -8
  32. package/dist/index.js.map +1 -1
  33. package/dist/index.node.cjs +11 -3
  34. package/dist/index.node.cjs.map +1 -1
  35. package/dist/index.node.d.cts +1110 -247
  36. package/dist/index.node.d.ts +1110 -247
  37. package/dist/index.node.js +10 -2
  38. package/dist/types-CRz5XdLd.d.cts +433 -0
  39. package/dist/types-CRz5XdLd.d.ts +433 -0
  40. package/package.json +17 -6
  41. package/dist/chunk-3JGQYHUN.js +0 -1006
  42. package/dist/chunk-3JGQYHUN.js.map +0 -1
  43. package/dist/chunk-5OXXH442.cjs +0 -1006
  44. package/dist/chunk-5OXXH442.cjs.map +0 -1
  45. package/dist/chunk-SJSPR4ZU.cjs.map +0 -1
  46. package/dist/chunk-ZAMVC732.js.map +0 -1
  47. package/dist/types-CZwYGpou.d.cts +0 -353
  48. package/dist/types-CZwYGpou.d.ts +0 -353
@@ -1 +0,0 @@
1
- {"version":3,"sources":["/Users/carl/Dev/Carl/gravito-core/packages/flux/dist/chunk-5OXXH442.cjs","../src/builder/WorkflowBuilder.ts","../src/core/ContextManager.ts","../src/core/StateMachine.ts","../src/core/StepExecutor.ts","../src/storage/MemoryStorage.ts","../src/engine/FluxEngine.ts","../src/trace/JsonFileTraceSink.ts","../src/logger/FluxLogger.ts","../src/orbit/OrbitFlux.ts"],"names":[],"mappings":"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","file":"/Users/carl/Dev/Carl/gravito-core/packages/flux/dist/chunk-5OXXH442.cjs","sourcesContent":[null,"/**\n * @fileoverview Workflow Builder - Fluent API for defining workflows\n *\n * Type-safe, chainable workflow definition.\n *\n * @module @gravito/flux/builder\n */\n\nimport type {\n FluxWaitResult,\n StepDefinition,\n StepDescriptor,\n WorkflowContext,\n WorkflowDefinition,\n WorkflowDescriptor,\n} from '../types'\n\n/**\n * Options for configuring a single step in a workflow.\n * @public\n */\nexport interface StepOptions<TInput = any, TData = any> {\n /** Maximum number of automatic retries on failure (default: 0) */\n retries?: number\n /** Maximum execution time in milliseconds before timeout error */\n timeout?: number\n /** Predicate to determine if the step should be executed or skipped */\n when?: (ctx: WorkflowContext<TInput, TData>) => boolean\n /** Logic to undo the effects of this step if a later step fails */\n compensate?: (ctx: WorkflowContext<TInput, TData>) => Promise<void> | void\n}\n\n/**\n * WorkflowBuilder provides a fluent, type-safe API for defining sequential logic.\n *\n * @example\n * ```typescript\n * const myFlow = createWorkflow('process-order')\n * .input<{ orderId: string }>()\n * .step('validate', async (ctx) => { ... })\n * .step('charge', async (ctx) => { ... }, { compensate: async (ctx) => { ... } })\n * .commit('ship', async (ctx) => { ... });\n * ```\n * @public\n */\nexport class WorkflowBuilder<TInput = unknown, TData = Record<string, unknown>> {\n drum: any = null // No!\n private _name: string\n private _steps: StepDefinition[] = []\n private _validateInput?: (input: unknown) => input is TInput\n\n constructor(name: string) {\n this._name = name\n }\n\n /**\n * Define input type\n *\n * This method is used for TypeScript type inference.\n */\n input<T>(): WorkflowBuilder<T, TData> {\n return this as unknown as WorkflowBuilder<T, TData>\n }\n\n /**\n * Define workflow data (state) type\n *\n * This method is used for TypeScript type inference.\n */\n data<T>(): WorkflowBuilder<TInput, T> {\n return this as unknown as WorkflowBuilder<TInput, T>\n }\n\n /**\n * Add input validator\n */\n validate(validator: (input: unknown) => input is TInput): this {\n this._validateInput = validator\n return this\n }\n\n /**\n * Add a step to the workflow\n */\n step(\n name: string,\n handler: (\n ctx: WorkflowContext<TInput, TData>\n ) => void | Promise<void | undefined | FluxWaitResult> | undefined | FluxWaitResult,\n options?: StepOptions<TInput, TData>\n ): this {\n this._steps.push({\n name,\n handler: handler as (\n ctx: WorkflowContext\n ) => void | Promise<void | undefined | FluxWaitResult> | undefined | FluxWaitResult,\n retries: options?.retries,\n timeout: options?.timeout,\n when: options?.when as ((ctx: WorkflowContext) => boolean) | undefined,\n compensate: options?.compensate as\n | ((ctx: WorkflowContext) => Promise<void> | void)\n | undefined,\n commit: false,\n })\n return this\n }\n\n /**\n * Add a commit step (always executes, even on replay)\n *\n * Commit steps are for side effects that should not be skipped,\n * such as database writes or external API calls.\n */\n commit(\n name: string,\n handler: (ctx: WorkflowContext<TInput, TData>) => Promise<void> | void,\n options?: Omit<StepOptions<TInput, TData>, 'compensate'>\n ): this {\n this._steps.push({\n name,\n handler: handler as unknown as StepDefinition['handler'],\n retries: options?.retries,\n timeout: options?.timeout,\n when: options?.when as ((ctx: WorkflowContext) => boolean) | undefined,\n commit: true,\n })\n return this\n }\n\n /**\n * Build the workflow definition\n */\n build(): WorkflowDefinition<TInput, TData> {\n if (this._steps.length === 0) {\n throw new Error(`Workflow \"${this._name}\" has no steps`)\n }\n\n return {\n name: this._name,\n steps: [...this._steps],\n validateInput: this._validateInput,\n }\n }\n\n /**\n * Describe workflow (serializable metadata)\n */\n describe(): WorkflowDescriptor {\n const steps: StepDescriptor[] = this._steps.map((step) => ({\n name: step.name,\n commit: Boolean(step.commit),\n retries: step.retries,\n timeout: step.timeout,\n hasCondition: Boolean(step.when),\n }))\n\n return {\n name: this._name,\n steps,\n }\n }\n\n /**\n * Get workflow name\n */\n get name(): string {\n return this._name\n }\n\n /**\n * Get step count\n */\n get stepCount(): number {\n return this._steps.length\n }\n}\n\n/**\n * Create a new workflow builder\n *\n * @param name - Unique workflow name\n * @returns WorkflowBuilder instance\n *\n * @example\n * ```typescript\n * const uploadFlow = createWorkflow('image-upload')\n * .input<{ file: Buffer }>()\n * .step('resize', async (ctx) => {\n * ctx.data.resized = await sharp(ctx.input.file).resize(200).toBuffer()\n * })\n * .commit('save', async (ctx) => {\n * await storage.put(ctx.data.resized)\n * })\n * ```\n */\nexport function createWorkflow(name: string): WorkflowBuilder {\n return new WorkflowBuilder(name)\n}\n","/**\n * @fileoverview Context Manager for workflow execution\n *\n * Manages workflow context lifecycle and state snapshots.\n *\n * @module @gravito/flux/core\n */\n\nimport type { StepExecution, WorkflowContext, WorkflowState, WorkflowStatus } from '../types'\n\n/**\n * Generate unique ID using crypto.randomUUID (Web Standard)\n */\nfunction generateId(): string {\n return crypto.randomUUID()\n}\n\n/**\n * Context Manager\n *\n * Creates and manages workflow execution contexts.\n */\nexport class ContextManager {\n /**\n * Create a new workflow context\n */\n create<TInput, TData = any>(\n name: string,\n input: TInput,\n stepCount: number\n ): WorkflowContext<TInput, TData> {\n const history: StepExecution[] = Array.from({ length: stepCount }, (_, _i) => ({\n name: '',\n status: 'pending',\n retries: 0,\n }))\n\n return {\n id: generateId(),\n name,\n input,\n data: {} as TData,\n status: 'pending',\n currentStep: 0,\n history,\n }\n }\n\n /**\n * Restore context from saved state\n */\n restore<TInput, TData = any>(\n state: WorkflowState<TInput, TData>\n ): WorkflowContext<TInput, TData> {\n return {\n id: state.id,\n name: state.name,\n input: state.input as TInput,\n data: { ...state.data } as unknown as TData,\n status: state.status,\n currentStep: state.currentStep,\n history: state.history.map((h) => ({ ...h })),\n }\n }\n\n /**\n * Convert context to serializable state\n */\n toState<TInput, TData>(ctx: WorkflowContext<TInput, TData>): WorkflowState<TInput, TData> {\n return {\n id: ctx.id,\n name: ctx.name,\n status: ctx.status,\n input: ctx.input,\n data: { ...(ctx.data as any) },\n currentStep: ctx.currentStep,\n history: ctx.history.map((h) => ({ ...h })),\n createdAt: new Date(),\n updatedAt: new Date(),\n }\n }\n\n /**\n * Update context status (returns new context for immutability)\n */\n updateStatus<TInput, TData>(\n ctx: WorkflowContext<TInput, TData>,\n status: WorkflowStatus\n ): WorkflowContext<TInput, TData> {\n return {\n ...ctx,\n status,\n }\n }\n\n /**\n * Advance to next step\n */\n advanceStep<TInput, TData>(ctx: WorkflowContext<TInput, TData>): WorkflowContext<TInput, TData> {\n return {\n ...ctx,\n currentStep: ctx.currentStep + 1,\n }\n }\n\n /**\n * Update step name in history\n */\n setStepName<TInput, TData>(\n ctx: WorkflowContext<TInput, TData>,\n index: number,\n name: string\n ): void {\n if (ctx.history[index]) {\n ctx.history[index].name = name\n }\n }\n}\n","/**\n * @fileoverview State Machine for workflow status transitions\n *\n * Pure state machine with no runtime dependencies.\n *\n * @module @gravito/flux/core\n */\n\nimport type { WorkflowStatus } from '../types'\n\n/**\n * Valid state transitions\n */\nconst TRANSITIONS: Record<WorkflowStatus, WorkflowStatus[]> = {\n pending: ['running', 'failed'],\n running: ['paused', 'completed', 'failed', 'suspended', 'rolling_back'],\n paused: ['running', 'failed'],\n suspended: ['running', 'failed'],\n rolling_back: ['rolled_back', 'failed'],\n rolled_back: ['pending'], // allow retry from scratch\n completed: [], // terminal state\n failed: ['pending'], // allow retry\n}\n\n/**\n * State Machine for workflow status management\n *\n * Provides validated state transitions using EventTarget for events.\n */\nexport class StateMachine extends EventTarget {\n private _status: WorkflowStatus = 'pending'\n\n /**\n * Current status\n */\n get status(): WorkflowStatus {\n return this._status\n }\n\n /**\n * Check if transition to target status is allowed\n */\n canTransition(to: WorkflowStatus): boolean {\n return TRANSITIONS[this._status].includes(to)\n }\n\n /**\n * Transition to a new status\n *\n * @throws {Error} If transition is not allowed\n */\n transition(to: WorkflowStatus): void {\n if (!this.canTransition(to)) {\n throw new Error(`Invalid state transition: ${this._status} → ${to}`)\n }\n\n const from = this._status\n this._status = to\n\n // Emit transition event\n this.dispatchEvent(\n new CustomEvent('transition', {\n detail: { from, to },\n })\n )\n }\n\n /**\n * Force set status (for replay/restore)\n */\n forceStatus(status: WorkflowStatus): void {\n this._status = status\n }\n\n /**\n * Check if workflow is in terminal state\n */\n isTerminal(): boolean {\n return (\n this._status === 'completed' || this._status === 'failed' || this._status === 'rolled_back'\n )\n }\n\n /**\n * Check if workflow can be executed\n */\n canExecute(): boolean {\n return this._status === 'pending' || this._status === 'paused'\n }\n}\n","/**\n * @fileoverview Step Executor for workflow steps\n *\n * Handles step execution with retry and timeout support.\n *\n * @module @gravito/flux/core\n */\n\nimport type {\n FluxWaitResult,\n StepDefinition,\n StepExecution,\n StepResult,\n WorkflowContext,\n} from '../types'\n\n/**\n * Step Executor\n *\n * Executes individual workflow steps with retry and timeout support.\n */\nexport class StepExecutor {\n private defaultRetries: number\n private defaultTimeout: number\n private onRetry?: (\n step: StepDefinition<any, any>,\n ctx: WorkflowContext<any, any>,\n error: Error,\n attempt: number,\n maxRetries: number\n ) => void | Promise<void>\n\n constructor(\n options: {\n defaultRetries?: number\n defaultTimeout?: number\n onRetry?: (\n step: StepDefinition<any, any>,\n ctx: WorkflowContext<any, any>,\n error: Error,\n attempt: number,\n maxRetries: number\n ) => void | Promise<void>\n } = {}\n ) {\n this.defaultRetries = options.defaultRetries ?? 3\n this.defaultTimeout = options.defaultTimeout ?? 30000\n this.onRetry = options.onRetry\n }\n\n /**\n * Execute a step with retry and timeout\n */\n async execute<TInput, TData>(\n step: StepDefinition<TInput, TData>,\n ctx: WorkflowContext<TInput, TData>,\n execution: StepExecution\n ): Promise<StepResult> {\n const maxRetries = step.retries ?? this.defaultRetries\n const timeout = step.timeout ?? this.defaultTimeout\n const startTime = Date.now()\n\n // Check condition\n if (step.when && !step.when(ctx)) {\n execution.status = 'skipped'\n return {\n success: true,\n duration: 0,\n }\n }\n\n execution.status = 'running'\n execution.startedAt = new Date()\n\n let lastError: Error | undefined\n\n for (let attempt = 0; attempt <= maxRetries; attempt++) {\n execution.retries = attempt\n\n try {\n // Execute with timeout\n const result = await this.executeWithTimeout(step.handler, ctx, timeout)\n\n if (\n result &&\n typeof result === 'object' &&\n '__kind' in result &&\n result.__kind === 'flux_wait'\n ) {\n execution.status = 'suspended'\n execution.waitingFor = result.signal\n execution.suspendedAt = new Date()\n execution.duration = Date.now() - startTime\n\n return {\n success: true,\n suspended: true,\n waitingFor: result.signal,\n duration: execution.duration,\n }\n }\n\n execution.status = 'completed'\n execution.completedAt = new Date()\n execution.duration = Date.now() - startTime\n\n return {\n success: true,\n duration: execution.duration,\n }\n } catch (error) {\n lastError = error instanceof Error ? error : new Error(String(error))\n\n // If not last retry, continue\n if (attempt < maxRetries) {\n await this.onRetry?.(step, ctx, lastError, attempt + 1, maxRetries)\n // Exponential backoff\n await this.sleep(Math.min(1000 * 2 ** attempt, 10000))\n }\n }\n }\n\n // All retries failed\n execution.status = 'failed'\n execution.completedAt = new Date()\n execution.duration = Date.now() - startTime\n execution.error = lastError?.message\n\n return {\n success: false,\n error: lastError,\n duration: execution.duration,\n }\n }\n\n /**\n * Execute handler with timeout\n */\n private async executeWithTimeout<TInput, TData>(\n handler: (\n ctx: WorkflowContext<TInput, TData>\n ) => void | Promise<void | undefined | FluxWaitResult> | undefined | FluxWaitResult,\n ctx: WorkflowContext<TInput, TData>,\n timeout: number\n ): Promise<void | undefined | FluxWaitResult> {\n let timer: ReturnType<typeof setTimeout> | null = null\n try {\n const timeoutPromise = new Promise<never>((_, reject) => {\n timer = setTimeout(() => reject(new Error('Step timeout')), timeout)\n })\n\n return await Promise.race([Promise.resolve(handler(ctx)), timeoutPromise])\n } finally {\n if (timer) {\n clearTimeout(timer)\n }\n }\n }\n\n /**\n * Sleep helper\n */\n private sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms))\n }\n}\n","/**\n * @fileoverview In-memory storage adapter\n *\n * Simple storage for development and testing.\n *\n * @module @gravito/flux/storage\n */\n\nimport type { WorkflowFilter, WorkflowState, WorkflowStorage } from '../types'\n\n/**\n * Memory Storage\n *\n * In-memory storage adapter for development and testing.\n * Data is not persisted across restarts.\n */\nexport class MemoryStorage implements WorkflowStorage {\n private store = new Map<string, WorkflowState>()\n\n async save(state: WorkflowState): Promise<void> {\n this.store.set(state.id, {\n ...state,\n updatedAt: new Date(),\n })\n }\n\n async load(id: string): Promise<WorkflowState | null> {\n return this.store.get(id) ?? null\n }\n\n async list(filter?: WorkflowFilter): Promise<WorkflowState[]> {\n let results = Array.from(this.store.values())\n\n if (filter?.name) {\n results = results.filter((s) => s.name === filter.name)\n }\n\n if (filter?.status) {\n const statuses = Array.isArray(filter.status) ? filter.status : [filter.status]\n results = results.filter((s) => statuses.includes(s.status))\n }\n\n // Sort by createdAt desc\n results.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime())\n\n // Apply pagination\n if (filter?.offset) {\n results = results.slice(filter.offset)\n }\n if (filter?.limit) {\n results = results.slice(0, filter.limit)\n }\n\n return results\n }\n\n async delete(id: string): Promise<void> {\n this.store.delete(id)\n }\n\n async init(): Promise<void> {\n // No-op for memory storage\n }\n\n async close(): Promise<void> {\n this.store.clear()\n }\n\n /**\n * Get store size (for testing)\n */\n size(): number {\n return this.store.size\n }\n}\n","/**\n * @fileoverview Flux Engine - Main workflow execution engine\n *\n * Orchestrates workflow execution with storage and event handling.\n *\n * @module @gravito/flux\n */\n\nimport { WorkflowBuilder } from '../builder/WorkflowBuilder'\nimport { ContextManager } from '../core/ContextManager'\nimport { StateMachine } from '../core/StateMachine'\nimport { StepExecutor } from '../core/StepExecutor'\nimport { MemoryStorage } from '../storage/MemoryStorage'\nimport type {\n FluxConfig,\n FluxResult,\n FluxTraceEvent,\n WorkflowContext,\n WorkflowDefinition,\n WorkflowState,\n WorkflowStorage,\n} from '../types'\n\n/**\n * FluxEngine is the primary execution orchestrator for workflows.\n * It manages context lifecycle, persistence via storage adapters,\n * step execution with retries, and transactional rollbacks (compensation).\n *\n * @example\n * ```typescript\n * const engine = new FluxEngine({\n * storage: new BunSQLiteStorage(),\n * logger: new FluxConsoleLogger()\n * });\n *\n * const workflow = createWorkflow('onboard-user')\n * .step('create-account', async (ctx) => { ... })\n * .step('send-email', async (ctx) => { ... });\n *\n * const result = await engine.execute(workflow, { email: 'user@example.com' });\n * if (result.status === 'completed') {\n * console.log('User onboarded successfully');\n * }\n * ```\n * @public\n */\nexport class FluxEngine {\n private storage: WorkflowStorage\n private executor: StepExecutor\n private contextManager: ContextManager\n private config: FluxConfig\n\n constructor(config: FluxConfig = {}) {\n this.config = config\n this.storage = config.storage ?? new MemoryStorage()\n this.executor = new StepExecutor({\n defaultRetries: config.defaultRetries,\n defaultTimeout: config.defaultTimeout,\n onRetry: async (step, ctx, error, attempt, maxRetries) => {\n await this.emitTrace({\n type: 'step:retry',\n timestamp: Date.now(),\n workflowId: ctx.id,\n workflowName: ctx.name,\n stepName: step.name,\n stepIndex: ctx.currentStep,\n commit: Boolean(step.commit),\n retries: attempt,\n maxRetries,\n error: error.message,\n status: 'running',\n })\n },\n })\n this.contextManager = new ContextManager()\n }\n\n /**\n * Execute a workflow with input data\n *\n * @param workflow - Workflow builder or definition\n * @param input - Input data for the workflow\n * @returns Execution result\n */\n async execute<TInput, TData = any>(\n workflow: WorkflowBuilder<TInput, TData> | WorkflowDefinition<TInput, TData>,\n input: TInput\n ): Promise<FluxResult<TData>> {\n const startTime = Date.now()\n const definition = this.resolveDefinition(workflow)\n\n // Validate input if validator provided\n if (definition.validateInput && !definition.validateInput(input)) {\n throw new Error(`Invalid input for workflow \"${definition.name}\"`)\n }\n\n // Create context\n const ctx = this.contextManager.create<TInput, TData>(\n definition.name,\n input,\n definition.steps.length\n ) as WorkflowContext<TInput, TData>\n\n // Create state machine\n const stateMachine = new StateMachine()\n\n // Save initial state\n await this.storage.save(this.contextManager.toState<TInput, TData>(ctx))\n\n return this.runFrom(definition, ctx, stateMachine, startTime, 0)\n }\n\n /**\n * Resume a paused or failed workflow\n *\n * @param workflowId - Workflow instance ID\n * @returns Execution result or null if not found\n */\n async resume<TInput, TData = any>(\n workflow: WorkflowBuilder<TInput, TData> | WorkflowDefinition<TInput, TData>,\n workflowId: string,\n options?: { fromStep?: number | string }\n ): Promise<FluxResult<TData> | null> {\n const definition = this.resolveDefinition(workflow)\n const state = await this.storage.load(workflowId)\n if (!state) {\n return null\n }\n if (state.name !== definition.name) {\n throw new Error(`Workflow name mismatch: ${state.name} !== ${definition.name}`)\n }\n if (state.history.length !== definition.steps.length) {\n throw new Error('Workflow definition changed; resume is not safe')\n }\n\n const ctx = this.contextManager.restore<TInput, TData>(state)\n const stateMachine = new StateMachine()\n stateMachine.forceStatus('pending')\n\n const startIndex = this.resolveStartIndex(definition, options?.fromStep, ctx.currentStep)\n this.resetHistoryFrom(ctx, startIndex)\n Object.assign(ctx, { status: 'pending', currentStep: startIndex })\n\n await this.storage.save(this.contextManager.toState<TInput, TData>(ctx))\n\n return this.runFrom(definition, ctx, stateMachine, Date.now(), startIndex, {\n resume: true,\n fromStep: startIndex,\n })\n }\n\n /**\n * Send a signal to a suspended workflow\n */\n async signal<TInput, TData = any>(\n workflow: WorkflowBuilder<TInput, TData> | WorkflowDefinition<TInput, TData>,\n workflowId: string,\n signalName: string,\n payload?: any\n ): Promise<FluxResult<TData>> {\n const definition = this.resolveDefinition(workflow)\n const state = await this.storage.load(workflowId)\n if (!state) {\n throw new Error('Workflow not found')\n }\n if (state.status !== 'suspended') {\n throw new Error(`Workflow is not suspended (status: ${state.status})`)\n }\n\n const ctx = this.contextManager.restore<TInput, TData>(state)\n const currentStep = ctx.history[ctx.currentStep]\n\n if (!currentStep || currentStep.status !== 'suspended') {\n throw new Error('Workflow state invalid: no suspended step found')\n }\n if (currentStep.waitingFor !== signalName) {\n throw new Error(\n `Workflow waiting for signal \"${currentStep.waitingFor}\", received \"${signalName}\"`\n )\n }\n\n // Complete the suspended step\n currentStep.status = 'completed'\n currentStep.completedAt = new Date()\n currentStep.output = payload\n // If payload contains data, we might want to merge it?\n // For now, allow next step to access it via history or we need a cleaner way.\n // Let's assume user grabs it from history for now or we build a helper later.\n\n const stateMachine = new StateMachine()\n stateMachine.forceStatus('suspended')\n // ctx status will be updated to 'running' in runFrom\n\n await this.emitTrace({\n type: 'signal:received',\n timestamp: Date.now(),\n workflowId: ctx.id,\n workflowName: ctx.name,\n status: 'suspended',\n input: payload,\n })\n\n // Resume from NEXT step\n const nextStepIndex = ctx.currentStep + 1\n\n return this.runFrom(definition, ctx, stateMachine, Date.now(), nextStepIndex, {\n resume: true,\n fromStep: nextStepIndex,\n })\n }\n\n /**\n * Retry a specific step (replays from that step onward)\n */\n async retryStep<TInput, TData = any>(\n workflow: WorkflowBuilder<TInput, TData> | WorkflowDefinition<TInput, TData>,\n workflowId: string,\n stepName: string\n ): Promise<FluxResult<TData> | null> {\n const definition = this.resolveDefinition(workflow)\n const state = await this.storage.load(workflowId)\n if (!state) {\n return null\n }\n if (state.name !== definition.name) {\n throw new Error(`Workflow name mismatch: ${state.name} !== ${definition.name}`)\n }\n if (state.history.length !== definition.steps.length) {\n throw new Error('Workflow definition changed; retry is not safe')\n }\n\n const ctx = this.contextManager.restore<TInput, TData>(state)\n const stateMachine = new StateMachine()\n stateMachine.forceStatus('pending')\n\n const startIndex = this.resolveStartIndex(definition, stepName, ctx.currentStep)\n this.resetHistoryFrom(ctx, startIndex)\n Object.assign(ctx, { status: 'pending', currentStep: startIndex })\n\n await this.storage.save(this.contextManager.toState<TInput, TData>(ctx))\n\n return this.runFrom(definition, ctx, stateMachine, Date.now(), startIndex, {\n retry: true,\n fromStep: startIndex,\n })\n }\n\n /**\n * Get workflow state by ID\n */\n async get<TInput = any, TData = any>(\n workflowId: string\n ): Promise<WorkflowState<TInput, TData> | null> {\n return this.storage.load(workflowId) as Promise<WorkflowState<TInput, TData> | null>\n }\n\n /**\n * Save workflow state manually (e.g., for external updates)\n */\n async saveState<TInput, TData>(state: WorkflowState<TInput, TData>): Promise<void> {\n return this.storage.save(state)\n }\n\n /**\n * List workflows\n */\n async list(filter?: Parameters<WorkflowStorage['list']>[0]) {\n return this.storage.list(filter)\n }\n\n /**\n * Initialize engine (init storage)\n */\n async init(): Promise<void> {\n await this.storage.init?.()\n }\n\n /**\n * Shutdown engine (cleanup)\n */\n async close(): Promise<void> {\n await this.storage.close?.()\n }\n\n private resolveDefinition<TInput, TData>(\n workflow: WorkflowBuilder<TInput, TData> | WorkflowDefinition<TInput, TData>\n ): WorkflowDefinition<TInput, TData> {\n return workflow instanceof WorkflowBuilder ? workflow.build() : workflow\n }\n\n private resolveStartIndex<TInput, TData>(\n definition: WorkflowDefinition<TInput, TData>,\n fromStep: number | string | undefined,\n fallback: number\n ): number {\n if (typeof fromStep === 'number') {\n if (fromStep < 0 || fromStep >= definition.steps.length) {\n throw new Error(`Invalid step index: ${fromStep}`)\n }\n return fromStep\n }\n if (typeof fromStep === 'string') {\n const index = definition.steps.findIndex((step) => step.name === fromStep)\n if (index === -1) {\n throw new Error(`Step not found: ${fromStep}`)\n }\n return index\n }\n return Math.max(0, Math.min(fallback, definition.steps.length - 1))\n }\n\n private resetHistoryFrom<TInput, TData>(\n ctx: WorkflowContext<TInput, TData>,\n startIndex: number\n ): void {\n for (let i = startIndex; i < ctx.history.length; i++) {\n const entry = ctx.history[i]\n if (!entry) {\n continue\n }\n entry.status = 'pending'\n entry.startedAt = undefined\n entry.completedAt = undefined\n entry.duration = undefined\n entry.error = undefined\n entry.retries = 0\n }\n }\n\n /**\n * Rollback workflow by executing compensation handlers in reverse order\n */\n private async rollback<TInput, TData>(\n definition: WorkflowDefinition<TInput, TData>,\n ctx: WorkflowContext<TInput, TData>,\n failedAtIndex: number,\n originalError: Error\n ): Promise<void> {\n Object.assign(ctx, { status: 'rolling_back' })\n\n await this.emitTrace({\n type: 'workflow:rollback_start',\n timestamp: Date.now(),\n workflowId: ctx.id,\n workflowName: ctx.name,\n status: 'rolling_back',\n error: originalError.message,\n })\n\n let compensatedCount = 0\n\n // Iterate backwards from the step BEFORE the failed one\n for (let i = failedAtIndex - 1; i >= 0; i--) {\n const step = definition.steps[i]\n const execution = ctx.history[i]\n\n // Only compensate completed steps with compensation handler\n if (!step || !step.compensate || !execution || execution.status !== 'completed') {\n continue\n }\n\n try {\n execution.status = 'compensating'\n await this.storage.save(this.contextManager.toState<TInput, TData>(ctx))\n\n await step.compensate(ctx)\n\n execution.status = 'compensated'\n execution.compensatedAt = new Date()\n compensatedCount++\n\n await this.emitTrace({\n type: 'step:compensate',\n timestamp: Date.now(),\n workflowId: ctx.id,\n workflowName: ctx.name,\n stepName: step.name,\n stepIndex: i,\n status: 'compensated',\n })\n } catch (err) {\n const error = err instanceof Error ? err : new Error(String(err))\n // Compensation failed - this is bad. Mark workflow as failed (not rolled_back)\n Object.assign(ctx, { status: 'failed' })\n\n await this.emitTrace({\n type: 'workflow:error',\n timestamp: Date.now(),\n workflowId: ctx.id,\n workflowName: ctx.name,\n status: 'failed',\n error: `Compensation failed at step \"${step.name}\": ${error.message}`,\n })\n return // Stop rollback\n }\n\n await this.storage.save(this.contextManager.toState<TInput, TData>(ctx))\n }\n\n if (compensatedCount > 0) {\n Object.assign(ctx, { status: 'rolled_back' })\n await this.emitTrace({\n type: 'workflow:rollback_complete',\n timestamp: Date.now(),\n workflowId: ctx.id,\n workflowName: ctx.name,\n status: 'rolled_back',\n })\n } else {\n // No compensation occurred, revert to failed status\n Object.assign(ctx, { status: 'failed' })\n }\n }\n\n private async runFrom<TInput, TData = any>(\n definition: WorkflowDefinition<TInput, TData>,\n ctx: WorkflowContext<TInput, TData>,\n stateMachine: StateMachine,\n startTime: number,\n startIndex: number,\n meta?: { resume?: boolean; retry?: boolean; fromStep?: number }\n ): Promise<FluxResult<TData>> {\n try {\n // Transition to running\n stateMachine.transition('running')\n Object.assign(ctx, { status: 'running' })\n if (!meta?.resume) {\n await this.emitTrace({\n type: 'workflow:start',\n timestamp: Date.now(),\n workflowId: ctx.id,\n workflowName: ctx.name,\n status: ctx.status,\n input: ctx.input,\n meta,\n })\n }\n\n // Execute steps\n for (let i = startIndex; i < definition.steps.length; i++) {\n const step = definition.steps[i]!\n const execution = ctx.history[i]!\n\n // Update step name\n this.contextManager.setStepName(ctx, i, step.name)\n Object.assign(ctx, { currentStep: i })\n\n // Emit step start event\n this.config.on?.stepStart?.(step.name, ctx as any)\n await this.emitTrace({\n type: 'step:start',\n timestamp: Date.now(),\n workflowId: ctx.id,\n workflowName: ctx.name,\n stepName: step.name,\n stepIndex: i,\n commit: Boolean(step.commit),\n retries: execution.retries,\n status: execution.status,\n meta,\n })\n\n // Execute step\n const result = await this.executor.execute(step, ctx, execution)\n\n if (result.success) {\n if (result.suspended) {\n // Handle suspension\n stateMachine.transition('suspended')\n Object.assign(ctx, { status: 'suspended' })\n\n await this.emitTrace({\n type: 'step:suspend',\n timestamp: Date.now(),\n workflowId: ctx.id,\n workflowName: ctx.name,\n stepName: step.name,\n stepIndex: i,\n meta: { signal: result.waitingFor },\n })\n\n await this.storage.save(this.contextManager.toState<TInput, TData>(ctx))\n\n return {\n id: ctx.id,\n status: 'suspended',\n data: ctx.data as TData,\n history: ctx.history,\n duration: Date.now() - startTime,\n }\n }\n\n // Emit step complete event\n this.config.on?.stepComplete?.(step.name, ctx as any, result)\n if (execution.status === 'skipped') {\n await this.emitTrace({\n type: 'step:skipped',\n timestamp: Date.now(),\n workflowId: ctx.id,\n workflowName: ctx.name,\n stepName: step.name,\n stepIndex: i,\n commit: Boolean(step.commit),\n retries: execution.retries,\n duration: result.duration,\n status: execution.status,\n meta,\n })\n } else {\n await this.emitTrace({\n type: 'step:complete',\n timestamp: Date.now(),\n workflowId: ctx.id,\n workflowName: ctx.name,\n stepName: step.name,\n stepIndex: i,\n commit: Boolean(step.commit),\n retries: execution.retries,\n duration: result.duration,\n status: execution.status,\n meta,\n })\n }\n } else {\n // Emit step error event\n this.config.on?.stepError?.(step.name, ctx as any, result.error!)\n await this.emitTrace({\n type: 'step:error',\n timestamp: Date.now(),\n workflowId: ctx.id,\n workflowName: ctx.name,\n stepName: step.name,\n stepIndex: i,\n commit: Boolean(step.commit),\n retries: execution.retries,\n duration: result.duration,\n error: result.error?.message,\n status: execution.status,\n meta,\n })\n\n // Fail workflow with potential rollback\n await this.rollback<TInput, TData>(definition, ctx, i, result.error!)\n\n const finalStatus = ctx.status\n stateMachine.forceStatus(finalStatus)\n\n await this.storage.save({\n ...this.contextManager.toState<TInput, TData>(ctx),\n error: result.error?.message,\n })\n\n return {\n id: ctx.id,\n status: finalStatus,\n data: ctx.data as TData,\n history: ctx.history,\n duration: Date.now() - startTime,\n error: result.error,\n }\n }\n\n // Save progress after each step\n await this.storage.save(this.contextManager.toState<TInput, TData>(ctx))\n }\n\n // Complete workflow\n stateMachine.transition('completed')\n Object.assign(ctx, { status: 'completed' })\n\n await this.storage.save({\n ...this.contextManager.toState<TInput, TData>(ctx),\n completedAt: new Date(),\n })\n\n // Emit workflow complete event\n this.config.on?.workflowComplete?.(ctx as any)\n await this.emitTrace({\n type: 'workflow:complete',\n timestamp: Date.now(),\n workflowId: ctx.id,\n workflowName: ctx.name,\n status: ctx.status,\n duration: Date.now() - startTime,\n data: ctx.data as Record<string, unknown>,\n meta,\n })\n\n return {\n id: ctx.id,\n status: 'completed',\n data: ctx.data as TData,\n history: ctx.history,\n duration: Date.now() - startTime,\n }\n } catch (error) {\n const err = error instanceof Error ? error : new Error(String(error))\n\n // Emit workflow error event\n this.config.on?.workflowError?.(ctx as any, err)\n await this.emitTrace({\n type: 'workflow:error',\n timestamp: Date.now(),\n workflowId: ctx.id,\n workflowName: ctx.name,\n status: 'failed',\n duration: Date.now() - startTime,\n error: err.message,\n meta,\n })\n\n stateMachine.forceStatus('failed')\n Object.assign(ctx, { status: 'failed' })\n\n await this.storage.save({\n ...this.contextManager.toState<TInput, TData>(ctx),\n error: err.message,\n })\n\n return {\n id: ctx.id,\n status: 'failed',\n data: ctx.data as TData,\n history: ctx.history,\n duration: Date.now() - startTime,\n error: err,\n }\n }\n }\n\n private async emitTrace(event: FluxTraceEvent): Promise<void> {\n try {\n await this.config.trace?.emit(event)\n } catch {\n // Ignore trace failures to avoid breaking workflow execution\n }\n }\n}\n","/**\n * @fileoverview JSON file trace sink (NDJSON)\n *\n * Writes trace events to a newline-delimited JSON file.\n */\n\nimport { appendFile, mkdir, writeFile } from 'node:fs/promises'\nimport { dirname } from 'node:path'\nimport type { FluxTraceEvent, FluxTraceSink } from '../types'\n\n/**\n * Options for configuring the `JsonFileTraceSink`.\n *\n * @public\n * @since 3.0.0\n */\nexport interface JsonFileTraceSinkOptions {\n /** Absolute path where the trace file should be stored. */\n path: string\n /** Whether to reset (clear) the file on initialization. @default true */\n reset?: boolean\n}\n\n/**\n * A trace sink that writes events to a newline-delimited JSON (NDJSON) file.\n *\n * This sink is ideal for local development and debugging as it produces\n * a human-readable and easily machine-parsable log of workflow events.\n *\n * @example\n * ```typescript\n * const sink = new JsonFileTraceSink({\n * path: './traces/workflow.jsonl',\n * reset: true\n * });\n * ```\n *\n * @public\n * @since 3.0.0\n */\nexport class JsonFileTraceSink implements FluxTraceSink {\n private path: string\n private ready: Promise<void>\n\n constructor(options: JsonFileTraceSinkOptions) {\n this.path = options.path\n this.ready = this.init(options.reset ?? true)\n }\n\n private async init(reset: boolean): Promise<void> {\n await mkdir(dirname(this.path), { recursive: true })\n if (reset) {\n await writeFile(this.path, '', 'utf8')\n }\n }\n\n async emit(event: FluxTraceEvent): Promise<void> {\n await this.ready\n await appendFile(this.path, `${JSON.stringify(event)}\\n`, 'utf8')\n }\n}\n","/**\n * @fileoverview Console Logger for FluxEngine\n *\n * Default logger implementation using console.\n *\n * @module @gravito/flux\n */\n\nimport type { FluxLogger } from '../types'\n\n/**\n * Console Logger\n *\n * Default logger that outputs to console.\n *\n * @example\n * ```typescript\n * const engine = new FluxEngine({\n * logger: new FluxConsoleLogger()\n * })\n * ```\n */\nexport class FluxConsoleLogger implements FluxLogger {\n private prefix: string\n\n constructor(prefix = '[Flux]') {\n this.prefix = prefix\n }\n\n debug(message: string, ...args: unknown[]): void {\n console.debug(`${this.prefix} ${message}`, ...args)\n }\n\n info(message: string, ...args: unknown[]): void {\n console.info(`${this.prefix} ${message}`, ...args)\n }\n\n warn(message: string, ...args: unknown[]): void {\n console.warn(`${this.prefix} ${message}`, ...args)\n }\n\n error(message: string, ...args: unknown[]): void {\n console.error(`${this.prefix} ${message}`, ...args)\n }\n}\n\n/**\n * Silent Logger\n *\n * Logger that outputs nothing (for testing or production).\n */\nexport class FluxSilentLogger implements FluxLogger {\n debug(): void {}\n info(): void {}\n warn(): void {}\n error(): void {}\n}\n","import type { GravitoOrbit, PlanetCore } from '@gravito/core'\nimport { FluxEngine } from '../engine/FluxEngine'\nimport { BunSQLiteStorage } from '../storage/BunSQLiteStorage'\nimport { MemoryStorage } from '../storage/MemoryStorage'\nimport type { FluxConfig, FluxLogger, WorkflowStorage } from '../types'\n\n/**\n * OrbitFlux configuration options\n */\nexport interface OrbitFluxOptions {\n /**\n * Storage driver: 'memory' | 'sqlite' | custom WorkflowStorage\n * @default 'memory'\n */\n storage?: 'memory' | 'sqlite' | WorkflowStorage\n\n /**\n * SQLite database path (only used if storage is 'sqlite')\n * @default ':memory:'\n */\n dbPath?: string\n\n /**\n * Service name in core.services\n * @default 'flux'\n */\n exposeAs?: string\n\n /**\n * Custom logger\n */\n logger?: FluxLogger\n\n /**\n * Default retry count for steps\n * @default 3\n */\n defaultRetries?: number\n\n /**\n * Default timeout for steps (ms)\n * @default 30000\n */\n defaultTimeout?: number\n}\n\n/**\n * OrbitFlux - Gravito Workflow Integration\n *\n * @example\n * ```typescript\n * import { OrbitFlux } from '@gravito/flux'\n *\n * const core = await PlanetCore.boot({\n * orbits: [\n * new OrbitFlux({ storage: 'sqlite', dbPath: './data/workflows.db' })\n * ]\n * })\n *\n * // Access via container\n * const flux = core.container.make<FluxEngine>('flux')\n * await flux.execute(myWorkflow, input)\n * ```\n */\nexport class OrbitFlux implements GravitoOrbit {\n private options: OrbitFluxOptions\n private engine?: FluxEngine\n\n constructor(options: OrbitFluxOptions = {}) {\n this.options = {\n storage: 'memory',\n exposeAs: 'flux',\n defaultRetries: 3,\n defaultTimeout: 30000,\n ...options,\n }\n }\n\n /**\n * Create OrbitFlux with configuration\n */\n static configure(options: OrbitFluxOptions = {}): OrbitFlux {\n return new OrbitFlux(options)\n }\n\n /**\n * Install into PlanetCore\n *\n * @param core - The PlanetCore instance\n */\n async install(core: PlanetCore): Promise<void> {\n const { storage, dbPath, exposeAs, defaultRetries, defaultTimeout, logger } = this.options\n\n // Resolve storage adapter\n let storageAdapter: WorkflowStorage\n\n if (typeof storage === 'string') {\n switch (storage) {\n case 'sqlite':\n storageAdapter = new BunSQLiteStorage({ path: dbPath })\n break\n default:\n storageAdapter = new MemoryStorage()\n }\n } else {\n storageAdapter = storage!\n }\n\n // Initialize storage\n await storageAdapter.init?.()\n\n // Create engine configuration\n const engineConfig: FluxConfig = {\n storage: storageAdapter,\n defaultRetries,\n defaultTimeout,\n logger: logger ?? {\n debug: (msg) => core.logger.debug(`[Flux] ${msg}`),\n info: (msg) => core.logger.info(`[Flux] ${msg}`),\n warn: (msg) => core.logger.warn(`[Flux] ${msg}`),\n error: (msg) => core.logger.error(`[Flux] ${msg}`),\n },\n on: {\n stepStart: (step) => {\n core.hooks.doAction('flux:step:start', { step })\n },\n stepComplete: (step, ctx, result) => {\n core.hooks.doAction('flux:step:complete', { step, ctx, result })\n },\n stepError: (step, ctx, error) => {\n core.hooks.doAction('flux:step:error', { step, ctx, error })\n },\n workflowComplete: (ctx) => {\n core.hooks.doAction('flux:workflow:complete', { ctx })\n },\n workflowError: (ctx, error) => {\n core.hooks.doAction('flux:workflow:error', { ctx, error })\n },\n },\n }\n\n // Create engine\n this.engine = new FluxEngine(engineConfig)\n\n // Register in core container\n core.container.instance(exposeAs!, this.engine)\n\n core.logger.info(\n `[OrbitFlux] Initialized (Storage: ${typeof storage === 'string' ? storage : 'custom'})`\n )\n }\n\n /**\n * Get the FluxEngine instance\n */\n getEngine(): FluxEngine | undefined {\n return this.engine\n }\n}\n"]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["/Users/carl/Dev/Carl/gravito-core/packages/flux/dist/chunk-SJSPR4ZU.cjs","../src/storage/BunSQLiteStorage.ts"],"names":[],"mappings":"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","file":"/Users/carl/Dev/Carl/gravito-core/packages/flux/dist/chunk-SJSPR4ZU.cjs","sourcesContent":[null,"/**\n * @fileoverview Bun SQLite Storage Adapter\n *\n * High-performance storage using Bun's built-in SQLite.\n *\n * @module @gravito/flux/storage\n */\n\nimport { Database } from 'bun:sqlite'\nimport type { WorkflowFilter, WorkflowState, WorkflowStorage } from '../types'\n\n/**\n * SQLite Storage Options\n */\nexport interface BunSQLiteStorageOptions {\n /** Database file path (default: ':memory:') */\n path?: string\n /** Table name (default: 'flux_workflows') */\n tableName?: string\n}\n\n/**\n * Bun SQLite Storage\n *\n * High-performance storage adapter using Bun's built-in SQLite.\n *\n * @example\n * ```typescript\n * const engine = new FluxEngine({\n * storage: new BunSQLiteStorage({ path: './data/flux.db' })\n * })\n * ```\n */\nexport class BunSQLiteStorage implements WorkflowStorage {\n private db: Database\n private tableName: string\n private initialized = false\n\n constructor(options: BunSQLiteStorageOptions = {}) {\n this.db = new Database(options.path ?? ':memory:')\n this.tableName = options.tableName ?? 'flux_workflows'\n }\n\n /**\n * Initialize storage (create tables)\n */\n async init(): Promise<void> {\n if (this.initialized) {\n return\n }\n\n this.db.run(`\n CREATE TABLE IF NOT EXISTS ${this.tableName} (\n id TEXT PRIMARY KEY,\n name TEXT NOT NULL,\n status TEXT NOT NULL,\n input TEXT NOT NULL,\n data TEXT NOT NULL,\n current_step INTEGER NOT NULL,\n history TEXT NOT NULL,\n error TEXT,\n created_at TEXT NOT NULL,\n updated_at TEXT NOT NULL,\n completed_at TEXT\n )\n `)\n\n // Create indexes for common queries\n this.db.run(`\n CREATE INDEX IF NOT EXISTS idx_${this.tableName}_name \n ON ${this.tableName}(name)\n `)\n this.db.run(`\n CREATE INDEX IF NOT EXISTS idx_${this.tableName}_status \n ON ${this.tableName}(status)\n `)\n this.db.run(`\n CREATE INDEX IF NOT EXISTS idx_${this.tableName}_created \n ON ${this.tableName}(created_at DESC)\n `)\n\n this.initialized = true\n }\n\n /**\n * Save workflow state\n */\n async save(state: WorkflowState): Promise<void> {\n await this.init()\n\n const stmt = this.db.prepare(`\n INSERT OR REPLACE INTO ${this.tableName} \n (id, name, status, input, data, current_step, history, error, created_at, updated_at, completed_at)\n VALUES ($id, $name, $status, $input, $data, $currentStep, $history, $error, $createdAt, $updatedAt, $completedAt)\n `)\n\n stmt.run({\n $id: state.id,\n $name: state.name,\n $status: state.status,\n $input: JSON.stringify(state.input),\n $data: JSON.stringify(state.data),\n $currentStep: state.currentStep,\n $history: JSON.stringify(state.history),\n $error: state.error ?? null,\n $createdAt: state.createdAt.toISOString(),\n $updatedAt: state.updatedAt.toISOString(),\n $completedAt: state.completedAt?.toISOString() ?? null,\n })\n }\n\n /**\n * Load workflow state by ID\n */\n async load(id: string): Promise<WorkflowState | null> {\n await this.init()\n\n const stmt = this.db.prepare(`\n SELECT * FROM ${this.tableName} WHERE id = $id\n `)\n\n const row = stmt.get({ $id: id }) as SQLiteRow | null\n\n if (!row) {\n return null\n }\n\n return this.rowToState(row)\n }\n\n /**\n * List workflow states with optional filter\n */\n async list(filter?: WorkflowFilter): Promise<WorkflowState[]> {\n await this.init()\n\n let query = `SELECT * FROM ${this.tableName} WHERE 1=1`\n const params: Record<string, unknown> = {}\n\n if (filter?.name) {\n query += ' AND name = $name'\n params.$name = filter.name\n }\n\n if (filter?.status) {\n if (Array.isArray(filter.status)) {\n const placeholders = filter.status.map((_, i) => `$status${i}`).join(', ')\n query += ` AND status IN (${placeholders})`\n filter.status.forEach((s, i) => {\n params[`$status${i}`] = s\n })\n } else {\n query += ' AND status = $status'\n params.$status = filter.status\n }\n }\n\n query += ' ORDER BY created_at DESC'\n\n if (filter?.limit) {\n query += ' LIMIT $limit'\n params.$limit = filter.limit\n }\n\n if (filter?.offset) {\n query += ' OFFSET $offset'\n params.$offset = filter.offset\n }\n\n const stmt = this.db.prepare(query)\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const rows = stmt.all(params as any) as SQLiteRow[]\n\n return rows.map((row) => this.rowToState(row))\n }\n\n /**\n * Delete workflow state\n */\n async delete(id: string): Promise<void> {\n await this.init()\n\n const stmt = this.db.prepare(`\n DELETE FROM ${this.tableName} WHERE id = $id\n `)\n\n stmt.run({ $id: id })\n }\n\n /**\n * Close database connection\n */\n async close(): Promise<void> {\n this.db.close()\n this.initialized = false\n }\n\n /**\n * Convert SQLite row to WorkflowState\n */\n private rowToState(row: SQLiteRow): WorkflowState {\n return {\n id: row.id,\n name: row.name,\n status: row.status as WorkflowState['status'],\n input: JSON.parse(row.input),\n data: JSON.parse(row.data),\n currentStep: row.current_step,\n history: JSON.parse(row.history),\n error: row.error ?? undefined,\n createdAt: new Date(row.created_at),\n updatedAt: new Date(row.updated_at),\n completedAt: row.completed_at ? new Date(row.completed_at) : undefined,\n }\n }\n\n /**\n * Get raw database (for advanced usage)\n */\n getDatabase(): Database {\n return this.db\n }\n\n /**\n * Run a vacuum to optimize database\n */\n vacuum(): void {\n this.db.run('VACUUM')\n }\n}\n\n/**\n * SQLite row type\n */\ninterface SQLiteRow {\n id: string\n name: string\n status: string\n input: string\n data: string\n current_step: number\n history: string\n error: string | null\n created_at: string\n updated_at: string\n completed_at: string | null\n}\n"]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/storage/BunSQLiteStorage.ts"],"sourcesContent":["/**\n * @fileoverview Bun SQLite Storage Adapter\n *\n * High-performance storage using Bun's built-in SQLite.\n *\n * @module @gravito/flux/storage\n */\n\nimport { Database } from 'bun:sqlite'\nimport type { WorkflowFilter, WorkflowState, WorkflowStorage } from '../types'\n\n/**\n * SQLite Storage Options\n */\nexport interface BunSQLiteStorageOptions {\n /** Database file path (default: ':memory:') */\n path?: string\n /** Table name (default: 'flux_workflows') */\n tableName?: string\n}\n\n/**\n * Bun SQLite Storage\n *\n * High-performance storage adapter using Bun's built-in SQLite.\n *\n * @example\n * ```typescript\n * const engine = new FluxEngine({\n * storage: new BunSQLiteStorage({ path: './data/flux.db' })\n * })\n * ```\n */\nexport class BunSQLiteStorage implements WorkflowStorage {\n private db: Database\n private tableName: string\n private initialized = false\n\n constructor(options: BunSQLiteStorageOptions = {}) {\n this.db = new Database(options.path ?? ':memory:')\n this.tableName = options.tableName ?? 'flux_workflows'\n }\n\n /**\n * Initialize storage (create tables)\n */\n async init(): Promise<void> {\n if (this.initialized) {\n return\n }\n\n this.db.run(`\n CREATE TABLE IF NOT EXISTS ${this.tableName} (\n id TEXT PRIMARY KEY,\n name TEXT NOT NULL,\n status TEXT NOT NULL,\n input TEXT NOT NULL,\n data TEXT NOT NULL,\n current_step INTEGER NOT NULL,\n history TEXT NOT NULL,\n error TEXT,\n created_at TEXT NOT NULL,\n updated_at TEXT NOT NULL,\n completed_at TEXT\n )\n `)\n\n // Create indexes for common queries\n this.db.run(`\n CREATE INDEX IF NOT EXISTS idx_${this.tableName}_name \n ON ${this.tableName}(name)\n `)\n this.db.run(`\n CREATE INDEX IF NOT EXISTS idx_${this.tableName}_status \n ON ${this.tableName}(status)\n `)\n this.db.run(`\n CREATE INDEX IF NOT EXISTS idx_${this.tableName}_created \n ON ${this.tableName}(created_at DESC)\n `)\n\n this.initialized = true\n }\n\n /**\n * Save workflow state\n */\n async save(state: WorkflowState): Promise<void> {\n await this.init()\n\n const stmt = this.db.prepare(`\n INSERT OR REPLACE INTO ${this.tableName} \n (id, name, status, input, data, current_step, history, error, created_at, updated_at, completed_at)\n VALUES ($id, $name, $status, $input, $data, $currentStep, $history, $error, $createdAt, $updatedAt, $completedAt)\n `)\n\n stmt.run({\n $id: state.id,\n $name: state.name,\n $status: state.status,\n $input: JSON.stringify(state.input),\n $data: JSON.stringify(state.data),\n $currentStep: state.currentStep,\n $history: JSON.stringify(state.history),\n $error: state.error ?? null,\n $createdAt: state.createdAt.toISOString(),\n $updatedAt: state.updatedAt.toISOString(),\n $completedAt: state.completedAt?.toISOString() ?? null,\n })\n }\n\n /**\n * Load workflow state by ID\n */\n async load(id: string): Promise<WorkflowState | null> {\n await this.init()\n\n const stmt = this.db.prepare(`\n SELECT * FROM ${this.tableName} WHERE id = $id\n `)\n\n const row = stmt.get({ $id: id }) as SQLiteRow | null\n\n if (!row) {\n return null\n }\n\n return this.rowToState(row)\n }\n\n /**\n * List workflow states with optional filter\n */\n async list(filter?: WorkflowFilter): Promise<WorkflowState[]> {\n await this.init()\n\n let query = `SELECT * FROM ${this.tableName} WHERE 1=1`\n const params: Record<string, unknown> = {}\n\n if (filter?.name) {\n query += ' AND name = $name'\n params.$name = filter.name\n }\n\n if (filter?.status) {\n if (Array.isArray(filter.status)) {\n const placeholders = filter.status.map((_, i) => `$status${i}`).join(', ')\n query += ` AND status IN (${placeholders})`\n filter.status.forEach((s, i) => {\n params[`$status${i}`] = s\n })\n } else {\n query += ' AND status = $status'\n params.$status = filter.status\n }\n }\n\n query += ' ORDER BY created_at DESC'\n\n if (filter?.limit) {\n query += ' LIMIT $limit'\n params.$limit = filter.limit\n }\n\n if (filter?.offset) {\n query += ' OFFSET $offset'\n params.$offset = filter.offset\n }\n\n const stmt = this.db.prepare(query)\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const rows = stmt.all(params as any) as SQLiteRow[]\n\n return rows.map((row) => this.rowToState(row))\n }\n\n /**\n * Delete workflow state\n */\n async delete(id: string): Promise<void> {\n await this.init()\n\n const stmt = this.db.prepare(`\n DELETE FROM ${this.tableName} WHERE id = $id\n `)\n\n stmt.run({ $id: id })\n }\n\n /**\n * Close database connection\n */\n async close(): Promise<void> {\n this.db.close()\n this.initialized = false\n }\n\n /**\n * Convert SQLite row to WorkflowState\n */\n private rowToState(row: SQLiteRow): WorkflowState {\n return {\n id: row.id,\n name: row.name,\n status: row.status as WorkflowState['status'],\n input: JSON.parse(row.input),\n data: JSON.parse(row.data),\n currentStep: row.current_step,\n history: JSON.parse(row.history),\n error: row.error ?? undefined,\n createdAt: new Date(row.created_at),\n updatedAt: new Date(row.updated_at),\n completedAt: row.completed_at ? new Date(row.completed_at) : undefined,\n }\n }\n\n /**\n * Get raw database (for advanced usage)\n */\n getDatabase(): Database {\n return this.db\n }\n\n /**\n * Run a vacuum to optimize database\n */\n vacuum(): void {\n this.db.run('VACUUM')\n }\n}\n\n/**\n * SQLite row type\n */\ninterface SQLiteRow {\n id: string\n name: string\n status: string\n input: string\n data: string\n current_step: number\n history: string\n error: string | null\n created_at: string\n updated_at: string\n completed_at: string | null\n}\n"],"mappings":"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","names":[]}
@@ -1,353 +0,0 @@
1
- /**
2
- * @fileoverview Core type definitions for @gravito/flux
3
- *
4
- * Platform-agnostic workflow engine types.
5
- *
6
- * @module @gravito/flux
7
- */
8
- /**
9
- * Workflow execution status
10
- */
11
- /**
12
- * Workflow execution status lifecycle states.
13
- * @public
14
- */
15
- type WorkflowStatus = 'pending' | 'running' | 'paused' | 'completed' | 'failed' | 'suspended' | 'rolling_back' | 'rolled_back';
16
- /**
17
- * Result of the Flux.wait() signal.
18
- * Used to pause a workflow until an external event occurs.
19
- * @public
20
- */
21
- interface FluxWaitResult {
22
- __kind: 'flux_wait';
23
- /** The unique signal name to wait for */
24
- signal: string;
25
- }
26
- /**
27
- * Detailed result of a single step's execution.
28
- * @public
29
- */
30
- interface StepResult<T = unknown> {
31
- /** Whether the step completed successfully */
32
- success: boolean;
33
- /** Data returned by the step handler */
34
- data?: T;
35
- /** Error encountered during execution */
36
- error?: Error;
37
- /** Processing time in milliseconds */
38
- duration: number;
39
- /** Whether the step triggered a suspension */
40
- suspended?: boolean;
41
- /** If suspended, the signal name it is waiting for */
42
- waitingFor?: string;
43
- }
44
- /**
45
- * Audit log entry for a step execution within a workflow instance.
46
- * @public
47
- */
48
- interface StepExecution {
49
- /** The unique name of the step */
50
- name: string;
51
- /** Current state of this specific step execution */
52
- status: 'pending' | 'running' | 'completed' | 'failed' | 'skipped' | 'suspended' | 'compensated' | 'compensating';
53
- /** Timestamp when the step was first started */
54
- startedAt?: Date;
55
- /** Timestamp when the step reached a terminal state */
56
- completedAt?: Date;
57
- /** Timestamp when the step was suspended */
58
- suspendedAt?: Date;
59
- /** Timestamp when the step was compensated (undone) */
60
- compensatedAt?: Date;
61
- /** The signal name if the step is currently suspended */
62
- waitingFor?: string;
63
- /** Execution time in milliseconds */
64
- duration?: number;
65
- /** Serialized output data from the step */
66
- output?: any;
67
- /** Serialized error message if failed */
68
- error?: string;
69
- /** Number of times this step has been retried */
70
- retries: number;
71
- }
72
- /**
73
- * Definition of a single functional unit (step) in a workflow.
74
- * @public
75
- */
76
- interface StepDefinition<TInput = any, TData = any> {
77
- /** Unique name for the step within the workflow */
78
- name: string;
79
- /**
80
- * The primary logic of the step.
81
- * Can return a result, void, or a wait signal.
82
- */
83
- handler: (ctx: WorkflowContext<TInput, TData>) => void | Promise<void | undefined | FluxWaitResult> | undefined | FluxWaitResult;
84
- /**
85
- * Logic to undo the effects of this step if a later step fails.
86
- * Used in long-running transactions (Saga pattern).
87
- */
88
- compensate?: (ctx: WorkflowContext<TInput, TData>) => Promise<void> | void;
89
- /** Maximum number of automatic retries on error (default: 0) */
90
- retries?: number;
91
- /** Maximum execution time in milliseconds before timeout error */
92
- timeout?: number;
93
- /** Predicate to determine if the step should be executed or skipped */
94
- when?: (ctx: WorkflowContext<TInput, TData>) => boolean;
95
- /**
96
- * If true, this step is treated as a side-effect that has already happened.
97
- * It will NOT be re-executed during a workflow resumption/replay if it previously succeeded.
98
- */
99
- commit?: boolean;
100
- }
101
- /**
102
- * The dynamic state and utility container passed to every step handler.
103
- * Provides access to input data, shared state, and orchestration metadata.
104
- * @public
105
- */
106
- interface WorkflowContext<TInput = unknown, TData = Record<string, unknown>> {
107
- /** Unique instance ID for this specific workflow run */
108
- readonly id: string;
109
- /** Name of the workflow definition */
110
- readonly name: string;
111
- /** The initial input data passed to the engine */
112
- readonly input: TInput;
113
- /**
114
- * Mutable state shared across all steps.
115
- * Steps should write their results here to pass data to subsequent steps.
116
- */
117
- data: TData;
118
- /** Current execution status of the entire workflow */
119
- readonly status: WorkflowStatus;
120
- /** The 0-based index of the currently executing step */
121
- readonly currentStep: number;
122
- /** History of all steps executed or currently running in this instance */
123
- readonly history: StepExecution[];
124
- }
125
- /**
126
- * The complete, serializable state of a workflow instance.
127
- * Suitable for persistence in a database to support long-running processes.
128
- * @public
129
- */
130
- interface WorkflowState<TInput = any, TData = any> {
131
- /** Unique instance ID */
132
- id: string;
133
- /** Name of the workflow definition */
134
- name: string;
135
- /** Current lifecycle status */
136
- status: WorkflowStatus;
137
- /** Original input data */
138
- input: TInput;
139
- /** Current accumulated shared data */
140
- data: TData;
141
- /** Index of the next step to execute */
142
- currentStep: number;
143
- /** Full step execution history */
144
- history: StepExecution[];
145
- /** Creation timestamp */
146
- createdAt: Date;
147
- /** Last update timestamp */
148
- updatedAt: Date;
149
- /** Completion timestamp (if finished) */
150
- completedAt?: Date;
151
- /** Final error message if failed */
152
- error?: string;
153
- }
154
- /**
155
- * The static blueprint defining a workflow's structure and behavior.
156
- * @public
157
- */
158
- interface WorkflowDefinition<TInput = unknown, TData = Record<string, unknown>> {
159
- /** Human-readable workflow identifier */
160
- name: string;
161
- /** Sequential list of steps to execute */
162
- steps: StepDefinition<TInput, TData>[];
163
- /** Optional runtime validator for input data */
164
- validateInput?: (input: unknown) => input is TInput;
165
- }
166
- /**
167
- * Lightweight, serializable overview of a workflow definition.
168
- * @public
169
- */
170
- interface WorkflowDescriptor {
171
- name: string;
172
- steps: StepDescriptor[];
173
- }
174
- /**
175
- * Lightweight, serializable overview of a step definition.
176
- * @public
177
- */
178
- interface StepDescriptor {
179
- name: string;
180
- commit: boolean;
181
- retries?: number;
182
- timeout?: number;
183
- hasCondition: boolean;
184
- }
185
- /**
186
- * Interface for workflow persistence adapters.
187
- * Allows Flux to survive server restarts by saving state to a database.
188
- * @public
189
- */
190
- interface WorkflowStorage {
191
- /** Persist a workflow instance state */
192
- save(state: WorkflowState): Promise<void>;
193
- /** Retrieve a workflow instance by its unique ID */
194
- load(id: string): Promise<WorkflowState | null>;
195
- /** Search/list workflow instances based on criteria */
196
- list(filter?: WorkflowFilter): Promise<WorkflowState[]>;
197
- /** Permanently remove a workflow instance record */
198
- delete(id: string): Promise<void>;
199
- /** Prepare the storage backend (e.g., migrations) */
200
- init?(): Promise<void>;
201
- /** Gracefully shut down storage connections */
202
- close?(): Promise<void>;
203
- }
204
- /**
205
- * Query parameters for listing workflow instances.
206
- * @public
207
- */
208
- interface WorkflowFilter {
209
- /** Filter by workflow definition name */
210
- name?: string;
211
- /** Filter by one or more statuses */
212
- status?: WorkflowStatus | WorkflowStatus[];
213
- /** Maximum number of records to return */
214
- limit?: number;
215
- /** Number of records to skip */
216
- offset?: number;
217
- }
218
- /**
219
- * Pluggable logger interface for the Flux engine.
220
- * @public
221
- */
222
- interface FluxLogger {
223
- debug(message: string, ...args: unknown[]): void;
224
- info(message: string, ...args: unknown[]): void;
225
- warn(message: string, ...args: unknown[]): void;
226
- error(message: string, ...args: unknown[]): void;
227
- }
228
- /**
229
- * Low-level event types emitted during workflow execution for observability.
230
- *
231
- * These types identify specific lifecycle events for both workflows and
232
- * individual steps, enabling fine-grained tracing and monitoring.
233
- *
234
- * @public
235
- * @since 3.0.0
236
- */
237
- type FluxTraceEventType = 'workflow:start' | 'workflow:complete' | 'workflow:error' | 'workflow:rollback_start' | 'workflow:rollback_complete' | 'step:start' | 'step:complete' | 'step:error' | 'step:skipped' | 'step:retry' | 'step:suspend' | 'step:compensate' | 'signal:received';
238
- /**
239
- * A discrete event representing a change in workflow or step state.
240
- *
241
- * Trace events provide a comprehensive audit log of everything that happens
242
- * during a workflow execution, including performance metrics (duration),
243
- * error details, and captured data snapshots.
244
- *
245
- * @public
246
- * @since 3.0.0
247
- */
248
- interface FluxTraceEvent {
249
- /** The type of event */
250
- type: FluxTraceEventType;
251
- /** Epoch timestamp in milliseconds */
252
- timestamp: number;
253
- /** Unique ID of the affected workflow instance */
254
- workflowId: string;
255
- /** Name of the affected workflow definition */
256
- workflowName: string;
257
- /** Name of the step (if applicable) */
258
- stepName?: string;
259
- /** 0-based index of the step (if applicable) */
260
- stepIndex?: number;
261
- /** Whether the step was a commit step */
262
- commit?: boolean;
263
- /** Current retry attempt count */
264
- retries?: number;
265
- /** Limit of retries configured */
266
- maxRetries?: number;
267
- /** Duration of the operation in milliseconds */
268
- duration?: number;
269
- /** Error message (if applicable) */
270
- error?: string;
271
- /** The new status reached */
272
- status?: WorkflowStatus | StepExecution['status'];
273
- /** Captured input (if tracing enabled) */
274
- input?: unknown;
275
- /** Captured partial data (if tracing enabled) */
276
- data?: Record<string, unknown>;
277
- /** Additional custom metadata */
278
- meta?: Record<string, unknown>;
279
- }
280
- /**
281
- * Destination for trace events (e.g., Log file, OpenTelemetry, Zipkin).
282
- *
283
- * Implement this interface to create custom observability adapters for Flux.
284
- *
285
- * @example
286
- * ```typescript
287
- * class MyTraceSink implements FluxTraceSink {
288
- * emit(event: FluxTraceEvent) {
289
- * console.log(`[Flux Trace] ${event.type} in ${event.workflowName}`);
290
- * }
291
- * }
292
- * ```
293
- *
294
- * @public
295
- * @since 3.0.0
296
- */
297
- interface FluxTraceSink {
298
- /**
299
- * Emit a trace event to the sink.
300
- *
301
- * @param event - The trace event to process.
302
- */
303
- emit(event: FluxTraceEvent): void | Promise<void>;
304
- }
305
- /**
306
- * Global configuration for a FluxEngine instance.
307
- * @public
308
- */
309
- interface FluxConfig {
310
- /** The persistence adapter to use (default: MemoryStorage) */
311
- storage?: WorkflowStorage;
312
- /** The logger to use for engine internals */
313
- logger?: FluxLogger;
314
- /** The observability sink for trace events */
315
- trace?: FluxTraceSink;
316
- /** Global default retry count for all steps (default: 0) */
317
- defaultRetries?: number;
318
- /** Global default timeout in ms for all steps (default: no timeout) */
319
- defaultTimeout?: number;
320
- /**
321
- * Experimental: Attempt to execute independent steps in parallel.
322
- * (Standard workflows execute sequentially).
323
- */
324
- parallel?: boolean;
325
- /** Functional hooks for reacting to engine events */
326
- on?: {
327
- stepStart?: (step: string, ctx: WorkflowContext) => void;
328
- stepComplete?: (step: string, ctx: WorkflowContext, result: StepResult) => void;
329
- stepError?: (step: string, ctx: WorkflowContext, error: Error) => void;
330
- workflowComplete?: (ctx: WorkflowContext) => void;
331
- workflowError?: (ctx: WorkflowContext, error: Error) => void;
332
- };
333
- }
334
- /**
335
- * The result returned after executing or resuming a workflow.
336
- * @public
337
- */
338
- interface FluxResult<TData = Record<string, unknown>> {
339
- /** Unique instance ID of the execution */
340
- id: string;
341
- /** Terminal status (e.g., 'completed', 'failed', 'suspended') */
342
- status: WorkflowStatus;
343
- /** The final state of the shared data map */
344
- data: TData;
345
- /** Full execution history including all step outcomes */
346
- history: StepExecution[];
347
- /** Wall-clock time of the execution session in milliseconds */
348
- duration: number;
349
- /** The final error that halted the workflow (if applicable) */
350
- error?: Error;
351
- }
352
-
353
- export type { FluxWaitResult as F, StepDefinition as S, WorkflowDefinition as W, FluxConfig as a, FluxLogger as b, FluxResult as c, FluxTraceEvent as d, FluxTraceEventType as e, FluxTraceSink as f, StepDescriptor as g, StepExecution as h, StepResult as i, WorkflowContext as j, WorkflowDescriptor as k, WorkflowFilter as l, WorkflowState as m, WorkflowStatus as n, WorkflowStorage as o };