@fragno-dev/workflows 0.0.1

package/dist/node/workflow.d.ts

@@ -0,0 +1,252 @@
+import { FragnoRuntime } from "@fragno-dev/core";
+import { DbNow } from "@fragno-dev/db";
+import { StandardSchemaV1 } from "@fragno-dev/core/api";
+
+//#region src/workflow.d.ts
+/** Relative or absolute durations supported by workflow steps. */
+type WorkflowDuration = string | number;
+/** Event delivered to a workflow instance run. */
+type WorkflowEvent<T> = {
+  payload: Readonly<T>;
+  timestamp: Date;
+  instanceId: string;
+};
+/** Retry/timeout behavior for a step execution. */
+type WorkflowStepConfig = {
+  retries?: {
+    limit: number;
+    delay: WorkflowDuration;
+    backoff?: "constant" | "linear" | "exponential";
+  };
+  timeout?: WorkflowDuration;
+};
+type WorkflowLogLevel = "debug" | "info" | "warn" | "error";
+type WorkflowLogOptions = {
+  category?: string;
+};
+type WorkflowLogger = {
+  debug: (message: string, data?: unknown, options?: WorkflowLogOptions) => Promise<void>;
+  info: (message: string, data?: unknown, options?: WorkflowLogOptions) => Promise<void>;
+  warn: (message: string, data?: unknown, options?: WorkflowLogOptions) => Promise<void>;
+  error: (message: string, data?: unknown, options?: WorkflowLogOptions) => Promise<void>;
+};
+/** Execution helpers that provide replay-safe step semantics. */
+interface WorkflowStep {
+  log: WorkflowLogger;
+  do<T>(name: string, callback: () => Promise<T> | T): Promise<T>;
+  do<T>(name: string, config: WorkflowStepConfig, callback: () => Promise<T> | T): Promise<T>;
+  sleep(name: string, duration: WorkflowDuration): Promise<void>;
+  sleepUntil(name: string, timestamp: Date | number): Promise<void>;
+  waitForEvent<T = unknown>(name: string, options: {
+    type: string;
+    timeout?: WorkflowDuration;
+  }): Promise<{
+    type: string;
+    payload: Readonly<T>;
+    timestamp: Date;
+  }>;
+}
+/** Serialized instance status returned to API consumers. */
+type InstanceStatusWithOutput<TOutput$1 = unknown> = {
+  status: "queued" | "running" | "paused" | "errored" | "terminated" | "complete" | "waiting" | "waitingForPause" | "unknown";
+  error?: {
+    name: string;
+    message: string;
+  };
+  output?: TOutput$1;
+};
+type InstanceStatus = InstanceStatusWithOutput<unknown>;
+/** Summary of the latest step execution for an instance run. */
+type WorkflowInstanceCurrentStep = {
+  stepKey: string;
+  name: string;
+  type: string;
+  status: string;
+  attempts: number;
+  maxAttempts: number;
+  timeoutMs: number | null;
+  nextRetryAt: Date | null;
+  wakeAt: Date | null;
+  waitEventType: string | null;
+  error?: {
+    name: string;
+    message: string;
+  };
+};
+/** Metadata describing a workflow instance for operators. */
+type WorkflowInstanceMetadata = {
+  workflowName: string;
+  runNumber: number;
+  params: unknown;
+  pauseRequested: boolean;
+  createdAt: Date;
+  updatedAt: Date;
+  startedAt: Date | null;
+  completedAt: Date | null;
+  currentStep?: WorkflowInstanceCurrentStep;
+};
+/** Handle for a workflow instance returned by the management API. */
+interface WorkflowInstance<TOutput$1 = unknown> {
+  id: string;
+  status(): Promise<InstanceStatusWithOutput<TOutput$1>>;
+  pause(): Promise<void>;
+  resume(): Promise<void>;
+  terminate(): Promise<void>;
+  restart(): Promise<void>;
+  sendEvent(options: {
+    type: string;
+    payload?: unknown;
+  }): Promise<void>;
+}
+/** Options for creating a workflow instance. */
+interface WorkflowInstanceCreateOptions<TParams$1 = unknown> {
+  id?: string;
+  params?: TParams$1;
+}
+/** Create options that require a user-specified instance id. */
+interface WorkflowInstanceCreateOptionsWithId<TParams$1 = unknown> extends WorkflowInstanceCreateOptions<TParams$1> {
+  id: string;
+}
+/** Management API for a named workflow. */
+interface Workflow<TParams$1 = unknown, TOutput$1 = unknown> {
+  create(options?: WorkflowInstanceCreateOptions<TParams$1>): Promise<WorkflowInstance<TOutput$1>>;
+  createBatch(batch: WorkflowInstanceCreateOptionsWithId<TParams$1>[]): Promise<WorkflowInstance<TOutput$1>[]>;
+  get(id: string): Promise<WorkflowInstance<TOutput$1>>;
+}
+/** Bound workflow handles exposed on fragments. */
+type WorkflowBindings<TRegistry extends WorkflowsRegistry = WorkflowsRegistry> = { [K in keyof TRegistry]: Workflow<WorkflowParamsFromEntry<TRegistry[K]>, WorkflowOutputFromEntry<TRegistry[K]>> };
+/** Execution context passed to workflow functions. */
+type WorkflowContext<TRegistry extends WorkflowsRegistry = WorkflowsRegistry> = {
+  workflows: WorkflowBindings<TRegistry>;
+};
+/** Function-based workflow run signature. */
+type WorkflowRunFn<TParams$1 = unknown, TOutput$1 = unknown> = (event: WorkflowEvent<TParams$1>, step: WorkflowStep, context: WorkflowContext) => Promise<TOutput$1> | TOutput$1;
+/** Function-based workflow definition. */
+interface WorkflowDefinition<TParams$1 = unknown, TOutput$1 = unknown, TInputSchema extends StandardSchemaV1 | undefined = StandardSchemaV1 | undefined, TOutputSchema extends StandardSchemaV1 | undefined = StandardSchemaV1 | undefined> {
+  name: string;
+  schema?: TInputSchema;
+  outputSchema?: TOutputSchema;
+  run(event: WorkflowEvent<TParams$1>, step: WorkflowStep, context: WorkflowContext): Promise<TOutput$1> | TOutput$1;
+}
+declare function defineWorkflow<TParams$1, TOutput$1 = unknown>(options: {
+  name: string;
+  schema?: undefined;
+  outputSchema?: undefined;
+}, run: WorkflowRunFn<TParams$1, TOutput$1>): WorkflowDefinition<TParams$1, TOutput$1, undefined, undefined>;
+declare function defineWorkflow<TSchema extends StandardSchemaV1, TOutput$1 = unknown>(options: {
+  name: string;
+  schema: TSchema;
+  outputSchema?: undefined;
+}, run: WorkflowRunFn<StandardSchemaV1.InferOutput<TSchema>, TOutput$1>): WorkflowDefinition<StandardSchemaV1.InferOutput<TSchema>, TOutput$1, TSchema, undefined>;
+declare function defineWorkflow<TOutputSchema extends StandardSchemaV1, TParams$1 = unknown>(options: {
+  name: string;
+  schema?: undefined;
+  outputSchema: TOutputSchema;
+}, run: WorkflowRunFn<TParams$1, StandardSchemaV1.InferOutput<TOutputSchema>>): WorkflowDefinition<TParams$1, StandardSchemaV1.InferOutput<TOutputSchema>, undefined, TOutputSchema>;
+declare function defineWorkflow<TInputSchema extends StandardSchemaV1, TOutputSchema extends StandardSchemaV1>(options: {
+  name: string;
+  schema: TInputSchema;
+  outputSchema: TOutputSchema;
+}, run: WorkflowRunFn<StandardSchemaV1.InferOutput<TInputSchema>, StandardSchemaV1.InferOutput<TOutputSchema>>): WorkflowDefinition<StandardSchemaV1.InferOutput<TInputSchema>, StandardSchemaV1.InferOutput<TOutputSchema>, TInputSchema, TOutputSchema>;
+/** Base class for user-defined workflows (legacy). */
+declare abstract class WorkflowEntrypoint<_Env = unknown, Params = unknown, Output = unknown> {
+  workflows: WorkflowBindings;
+  abstract run(event: WorkflowEvent<Params>, step: WorkflowStep): Promise<Output> | Output;
+}
+/** Legacy class-based workflow registry entry. */
+type LegacyWorkflowDefinition<TParams$1 = unknown, TOutput$1 = unknown> = {
+  name: string;
+  workflow: new (...args: unknown[]) => WorkflowEntrypoint<unknown, TParams$1, TOutput$1>;
+};
+/** Workflow registry entry (function-based or legacy class-based). */
+type WorkflowRegistryEntry = WorkflowDefinition<unknown, unknown, StandardSchemaV1 | undefined, StandardSchemaV1 | undefined> | LegacyWorkflowDefinition<unknown, unknown>;
+declare const isLegacyWorkflowDefinition: (entry: WorkflowRegistryEntry) => entry is LegacyWorkflowDefinition;
+type WorkflowParamsFromEntry<TEntry> = TEntry extends WorkflowDefinition<infer TParams, unknown, StandardSchemaV1 | undefined, StandardSchemaV1 | undefined> ? TParams : TEntry extends LegacyWorkflowDefinition<infer TParams, unknown> ? TParams : unknown;
+type WorkflowOutputFromEntry<TEntry> = TEntry extends WorkflowDefinition<unknown, infer TOutput, StandardSchemaV1 | undefined, StandardSchemaV1 | undefined> ? TOutput : TEntry extends LegacyWorkflowDefinition<unknown, infer TOutput> ? TOutput : unknown;
+/** Map of binding keys to workflow definitions. */
+type WorkflowsRegistry = Record<string, WorkflowRegistryEntry>;
+/** Error type that bypasses automatic retries. */
+declare class NonRetryableError extends Error {
+  constructor(message: string, name?: string);
+}
+/** Durable hook payload emitted when a workflow is ready to run. */
+type WorkflowEnqueuedHookPayload = {
+  workflowName: string;
+  instanceId: string;
+  reason: "create" | "event" | "resume" | "retry" | "wake";
+};
+type WorkflowsHooks = {
+  onWorkflowEnqueued: (payload: WorkflowEnqueuedHookPayload) => void | Promise<void>;
+};
+/** Dispatcher interface used by durable hooks to trigger runner work. */
+interface WorkflowsDispatcher {
+  wake: (payload: WorkflowEnqueuedHookPayload) => Promise<void> | void;
+}
+/** Controls how much work a runner processes per tick. */
+type RunnerTickOptions = {
+  maxInstances?: number;
+  maxSteps?: number;
+};
+/** Runner interface used by routes and dispatchers. */
+interface WorkflowsRunner {
+  tick: (options?: RunnerTickOptions) => Promise<number> | number;
+}
+/** Request metadata passed into authorization hooks. */
+type WorkflowsAuthorizeContext = {
+  method: string;
+  path: string;
+  pathParams: Record<string, string>;
+  query: URLSearchParams;
+  headers: Headers;
+  input?: unknown;
+};
+/** Actions available on workflow instances. */
+type WorkflowManagementAction = "pause" | "resume" | "terminate" | "restart";
+/** Authorization hook signature for workflow routes. */
+type WorkflowsAuthorizeHook<TContext extends WorkflowsAuthorizeContext> = (context: TContext) => Promise<Response | void> | Response | void;
+/** Authorization context for instance creation requests. */
+type WorkflowsAuthorizeInstanceCreationContext = WorkflowsAuthorizeContext & {
+  workflowName: string;
+  instances: {
+    id?: string;
+    params?: unknown;
+  }[];
+};
+/** Authorization context for management actions. */
+type WorkflowsAuthorizeManagementContext = WorkflowsAuthorizeContext & {
+  workflowName: string;
+  instanceId: string;
+  action: WorkflowManagementAction;
+};
+/** Authorization context for sendEvent requests. */
+type WorkflowsAuthorizeSendEventContext = WorkflowsAuthorizeContext & {
+  workflowName: string;
+  instanceId: string;
+  eventType: string;
+  payload?: unknown;
+};
+/** Authorization context for runner tick requests. */
+type WorkflowsAuthorizeRunnerTickContext = WorkflowsAuthorizeContext & {
+  options: RunnerTickOptions;
+};
+/** Configuration for the workflows fragment. */
+interface WorkflowsFragmentConfig<TRegistry extends WorkflowsRegistry = WorkflowsRegistry> {
+  workflows?: TRegistry;
+  dispatcher?: WorkflowsDispatcher;
+  runner?: WorkflowsRunner;
+  runtime: FragnoRuntime;
+  dbNow?: () => Date | DbNow;
+  enableRunnerTick?: boolean;
+  authorizeRequest?: WorkflowsAuthorizeHook<WorkflowsAuthorizeContext>;
+  authorizeInstanceCreation?: WorkflowsAuthorizeHook<WorkflowsAuthorizeInstanceCreationContext>;
+  authorizeManagement?: WorkflowsAuthorizeHook<WorkflowsAuthorizeManagementContext>;
+  authorizeSendEvent?: WorkflowsAuthorizeHook<WorkflowsAuthorizeSendEventContext>;
+  authorizeRunnerTick?: WorkflowsAuthorizeHook<WorkflowsAuthorizeRunnerTickContext>;
+}
+declare const isTerminalStatus: (status: InstanceStatus["status"]) => boolean;
+declare const isWaitingStatus: (status: InstanceStatus["status"]) => boolean;
+declare const statusLabel: (status: InstanceStatus["status"]) => string;
+declare const currentStepLabel: (step?: WorkflowInstanceCurrentStep | null) => string | undefined;
+//#endregion
+export { InstanceStatus, InstanceStatusWithOutput, LegacyWorkflowDefinition, NonRetryableError, RunnerTickOptions, Workflow, WorkflowBindings, WorkflowContext, WorkflowDefinition, WorkflowDuration, WorkflowEnqueuedHookPayload, WorkflowEntrypoint, WorkflowEvent, WorkflowInstance, WorkflowInstanceCreateOptions, WorkflowInstanceCreateOptionsWithId, WorkflowInstanceCurrentStep, WorkflowInstanceMetadata, WorkflowLogLevel, WorkflowLogOptions, WorkflowLogger, WorkflowManagementAction, WorkflowOutputFromEntry, WorkflowParamsFromEntry, WorkflowRegistryEntry, WorkflowRunFn, WorkflowStep, WorkflowStepConfig, WorkflowsAuthorizeContext, WorkflowsAuthorizeHook, WorkflowsAuthorizeInstanceCreationContext, WorkflowsAuthorizeManagementContext, WorkflowsAuthorizeRunnerTickContext, WorkflowsAuthorizeSendEventContext, WorkflowsDispatcher, WorkflowsFragmentConfig, WorkflowsHooks, WorkflowsRegistry, WorkflowsRunner, currentStepLabel, defineWorkflow, isLegacyWorkflowDefinition, isTerminalStatus, isWaitingStatus, statusLabel };
+//# sourceMappingURL=workflow.d.ts.map

package/dist/node/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","names":[],"sources":["../../src/workflow.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/node/workflow.js

@@ -0,0 +1,48 @@
+//#region src/workflow.ts
+function defineWorkflow(options, run) {
+	return {
+		...options,
+		run
+	};
+}
+/** Base class for user-defined workflows (legacy). */
+var WorkflowEntrypoint = class {
+	workflows;
+};
+const isLegacyWorkflowDefinition = (entry) => "workflow" in entry;
+/** Error type that bypasses automatic retries. */
+var NonRetryableError = class extends Error {
+	constructor(message, name) {
+		super(message);
+		this.name = name ?? "NonRetryableError";
+	}
+};
+const TERMINAL_STATUSES = [
+	"complete",
+	"terminated",
+	"errored"
+];
+const WAITING_STATUSES = ["waiting", "waitingForPause"];
+const isTerminalStatus = (status) => TERMINAL_STATUSES.includes(status);
+const isWaitingStatus = (status) => WAITING_STATUSES.includes(status);
+const statusLabel = (status) => {
+	return {
+		queued: "Queued",
+		running: "Running",
+		paused: "Paused",
+		errored: "Errored",
+		terminated: "Terminated",
+		complete: "Complete",
+		waiting: "Waiting",
+		waitingForPause: "Waiting For Pause",
+		unknown: "Unknown"
+	}[status] ?? "Unknown";
+};
+const currentStepLabel = (step) => {
+	if (!step) return;
+	return step.name ? `${step.name} (${step.type})` : step.type;
+};
+
+//#endregion
+export { NonRetryableError, WorkflowEntrypoint, currentStepLabel, defineWorkflow, isLegacyWorkflowDefinition, isTerminalStatus, isWaitingStatus, statusLabel };
+//# sourceMappingURL=workflow.js.map

package/dist/node/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","names":["TERMINAL_STATUSES: InstanceStatus[\"status\"][]","WAITING_STATUSES: InstanceStatus[\"status\"][]"],"sources":["../../src/workflow.ts"],"sourcesContent":["import type { FragnoRuntime } from \"@fragno-dev/core\";\nimport type { StandardSchemaV1 } from \"@fragno-dev/core/api\";\nimport type { DbNow } from \"@fragno-dev/db\";\n\n/** Relative or absolute durations supported by workflow steps. */\nexport type WorkflowDuration = string | number;\n\n/** Event delivered to a workflow instance run. */\nexport type WorkflowEvent<T> = {\n  payload: Readonly<T>;\n  timestamp: Date;\n  instanceId: string;\n};\n\n/** Retry/timeout behavior for a step execution. */\nexport type WorkflowStepConfig = {\n  retries?: {\n    limit: number;\n    delay: WorkflowDuration;\n    backoff?: \"constant\" | \"linear\" | \"exponential\";\n  };\n  timeout?: WorkflowDuration;\n};\n\nexport type WorkflowLogLevel = \"debug\" | \"info\" | \"warn\" | \"error\";\n\nexport type WorkflowLogOptions = {\n  category?: string;\n};\n\nexport type WorkflowLogger = {\n  debug: (message: string, data?: unknown, options?: WorkflowLogOptions) => Promise<void>;\n  info: (message: string, data?: unknown, options?: WorkflowLogOptions) => Promise<void>;\n  warn: (message: string, data?: unknown, options?: WorkflowLogOptions) => Promise<void>;\n  error: (message: string, data?: unknown, options?: WorkflowLogOptions) => Promise<void>;\n};\n\n/** Execution helpers that provide replay-safe step semantics. */\nexport interface WorkflowStep {\n  log: WorkflowLogger;\n  do<T>(name: string, callback: () => Promise<T> | T): Promise<T>;\n  do<T>(name: string, config: WorkflowStepConfig, callback: () => Promise<T> | T): Promise<T>;\n  sleep(name: string, duration: WorkflowDuration): Promise<void>;\n  sleepUntil(name: string, timestamp: Date | number): Promise<void>;\n  waitForEvent<T = unknown>(\n    name: string,\n    options: { type: string; timeout?: WorkflowDuration },\n  ): Promise<{ type: string; payload: Readonly<T>; timestamp: Date }>;\n}\n\n/** Serialized instance status returned to API consumers. */\nexport type InstanceStatusWithOutput<TOutput = unknown> = {\n  status:\n    | \"queued\"\n    | \"running\"\n    | \"paused\"\n    | \"errored\"\n    | \"terminated\"\n    | \"complete\"\n    | \"waiting\"\n    | \"waitingForPause\"\n    | \"unknown\";\n  error?: { name: string; message: string };\n  output?: TOutput;\n};\n\nexport type InstanceStatus = InstanceStatusWithOutput<unknown>;\n\n/** Summary of the latest step execution for an instance run. */\nexport type WorkflowInstanceCurrentStep = {\n  stepKey: string;\n  name: string;\n  type: string;\n  status: string;\n  attempts: number;\n  maxAttempts: number;\n  timeoutMs: number | null;\n  nextRetryAt: Date | null;\n  wakeAt: Date | null;\n  waitEventType: string | null;\n  error?: { name: string; message: string };\n};\n\n/** Metadata describing a workflow instance for operators. */\nexport type WorkflowInstanceMetadata = {\n  workflowName: string;\n  runNumber: number;\n  params: unknown;\n  pauseRequested: boolean;\n  createdAt: Date;\n  updatedAt: Date;\n  startedAt: Date | null;\n  completedAt: Date | null;\n  currentStep?: WorkflowInstanceCurrentStep;\n};\n\n/** Handle for a workflow instance returned by the management API. */\nexport interface WorkflowInstance<TOutput = unknown> {\n  id: string;\n  status(): Promise<InstanceStatusWithOutput<TOutput>>;\n  pause(): Promise<void>;\n  resume(): Promise<void>;\n  terminate(): Promise<void>;\n  restart(): Promise<void>;\n  sendEvent(options: { type: string; payload?: unknown }): Promise<void>;\n}\n\n/** Options for creating a workflow instance. */\nexport interface WorkflowInstanceCreateOptions<TParams = unknown> {\n  id?: string;\n  params?: TParams;\n}\n\n/** Create options that require a user-specified instance id. */\nexport interface WorkflowInstanceCreateOptionsWithId<TParams = unknown>\n  extends WorkflowInstanceCreateOptions<TParams> {\n  id: string;\n}\n\n/** Management API for a named workflow. */\nexport interface Workflow<TParams = unknown, TOutput = unknown> {\n  create(options?: WorkflowInstanceCreateOptions<TParams>): Promise<WorkflowInstance<TOutput>>;\n  createBatch(\n    batch: WorkflowInstanceCreateOptionsWithId<TParams>[],\n  ): Promise<WorkflowInstance<TOutput>[]>;\n  get(id: string): Promise<WorkflowInstance<TOutput>>;\n}\n\n/** Bound workflow handles exposed on fragments. */\nexport type WorkflowBindings<TRegistry extends WorkflowsRegistry = WorkflowsRegistry> = {\n  [K in keyof TRegistry]: Workflow<\n    WorkflowParamsFromEntry<TRegistry[K]>,\n    WorkflowOutputFromEntry<TRegistry[K]>\n  >;\n};\n\n/** Execution context passed to workflow functions. */\nexport type WorkflowContext<TRegistry extends WorkflowsRegistry = WorkflowsRegistry> = {\n  workflows: WorkflowBindings<TRegistry>;\n};\n\n/** Function-based workflow run signature. */\nexport type WorkflowRunFn<TParams = unknown, TOutput = unknown> = (\n  event: WorkflowEvent<TParams>,\n  step: WorkflowStep,\n  context: WorkflowContext,\n) => Promise<TOutput> | TOutput;\n\n/** Function-based workflow definition. */\nexport interface WorkflowDefinition<\n  TParams = unknown,\n  TOutput = unknown,\n  TInputSchema extends StandardSchemaV1 | undefined = StandardSchemaV1 | undefined,\n  TOutputSchema extends StandardSchemaV1 | undefined = StandardSchemaV1 | undefined,\n> {\n  name: string;\n  schema?: TInputSchema;\n  outputSchema?: TOutputSchema;\n  run(\n    event: WorkflowEvent<TParams>,\n    step: WorkflowStep,\n    context: WorkflowContext,\n  ): Promise<TOutput> | TOutput;\n}\n\nexport function defineWorkflow<TParams, TOutput = unknown>(\n  options: { name: string; schema?: undefined; outputSchema?: undefined },\n  run: WorkflowRunFn<TParams, TOutput>,\n): WorkflowDefinition<TParams, TOutput, undefined, undefined>;\nexport function defineWorkflow<TSchema extends StandardSchemaV1, TOutput = unknown>(\n  options: { name: string; schema: TSchema; outputSchema?: undefined },\n  run: WorkflowRunFn<StandardSchemaV1.InferOutput<TSchema>, TOutput>,\n): WorkflowDefinition<StandardSchemaV1.InferOutput<TSchema>, TOutput, TSchema, undefined>;\nexport function defineWorkflow<TOutputSchema extends StandardSchemaV1, TParams = unknown>(\n  options: { name: string; schema?: undefined; outputSchema: TOutputSchema },\n  run: WorkflowRunFn<TParams, StandardSchemaV1.InferOutput<TOutputSchema>>,\n): WorkflowDefinition<\n  TParams,\n  StandardSchemaV1.InferOutput<TOutputSchema>,\n  undefined,\n  TOutputSchema\n>;\nexport function defineWorkflow<\n  TInputSchema extends StandardSchemaV1,\n  TOutputSchema extends StandardSchemaV1,\n>(\n  options: { name: string; schema: TInputSchema; outputSchema: TOutputSchema },\n  run: WorkflowRunFn<\n    StandardSchemaV1.InferOutput<TInputSchema>,\n    StandardSchemaV1.InferOutput<TOutputSchema>\n  >,\n): WorkflowDefinition<\n  StandardSchemaV1.InferOutput<TInputSchema>,\n  StandardSchemaV1.InferOutput<TOutputSchema>,\n  TInputSchema,\n  TOutputSchema\n>;\nexport function defineWorkflow(\n  options: { name: string; schema?: StandardSchemaV1; outputSchema?: StandardSchemaV1 },\n  run: WorkflowRunFn,\n): WorkflowDefinition {\n  return { ...options, run };\n}\n\n/** Base class for user-defined workflows (legacy). */\nexport abstract class WorkflowEntrypoint<_Env = unknown, Params = unknown, Output = unknown> {\n  public workflows!: WorkflowBindings;\n\n  abstract run(event: WorkflowEvent<Params>, step: WorkflowStep): Promise<Output> | Output;\n}\n\n/** Legacy class-based workflow registry entry. */\nexport type LegacyWorkflowDefinition<TParams = unknown, TOutput = unknown> = {\n  name: string;\n  workflow: new (...args: unknown[]) => WorkflowEntrypoint<unknown, TParams, TOutput>;\n};\n\n/** Workflow registry entry (function-based or legacy class-based). */\nexport type WorkflowRegistryEntry =\n  | WorkflowDefinition<unknown, unknown, StandardSchemaV1 | undefined, StandardSchemaV1 | undefined>\n  | LegacyWorkflowDefinition<unknown, unknown>;\n\nexport const isLegacyWorkflowDefinition = (\n  entry: WorkflowRegistryEntry,\n): entry is LegacyWorkflowDefinition => \"workflow\" in entry;\n\nexport type WorkflowParamsFromEntry<TEntry> =\n  TEntry extends WorkflowDefinition<\n    infer TParams,\n    unknown,\n    StandardSchemaV1 | undefined,\n    StandardSchemaV1 | undefined\n  >\n    ? TParams\n    : TEntry extends LegacyWorkflowDefinition<infer TParams, unknown>\n      ? TParams\n      : unknown;\n\nexport type WorkflowOutputFromEntry<TEntry> =\n  TEntry extends WorkflowDefinition<\n    unknown,\n    infer TOutput,\n    StandardSchemaV1 | undefined,\n    StandardSchemaV1 | undefined\n  >\n    ? TOutput\n    : TEntry extends LegacyWorkflowDefinition<unknown, infer TOutput>\n      ? TOutput\n      : unknown;\n\n/** Map of binding keys to workflow definitions. */\nexport type WorkflowsRegistry = Record<string, WorkflowRegistryEntry>;\n\n/** Error type that bypasses automatic retries. */\nexport class NonRetryableError extends Error {\n  constructor(message: string, name?: string) {\n    super(message);\n    this.name = name ?? \"NonRetryableError\";\n  }\n}\n\n/** Durable hook payload emitted when a workflow is ready to run. */\nexport type WorkflowEnqueuedHookPayload = {\n  workflowName: string;\n  instanceId: string;\n  reason: \"create\" | \"event\" | \"resume\" | \"retry\" | \"wake\";\n};\n\nexport type WorkflowsHooks = {\n  onWorkflowEnqueued: (payload: WorkflowEnqueuedHookPayload) => void | Promise<void>;\n};\n\n/** Dispatcher interface used by durable hooks to trigger runner work. */\nexport interface WorkflowsDispatcher {\n  wake: (payload: WorkflowEnqueuedHookPayload) => Promise<void> | void;\n}\n\n/** Controls how much work a runner processes per tick. */\nexport type RunnerTickOptions = {\n  maxInstances?: number;\n  maxSteps?: number;\n};\n\n/** Runner interface used by routes and dispatchers. */\nexport interface WorkflowsRunner {\n  tick: (options?: RunnerTickOptions) => Promise<number> | number;\n}\n\n/** Request metadata passed into authorization hooks. */\nexport type WorkflowsAuthorizeContext = {\n  method: string;\n  path: string;\n  pathParams: Record<string, string>;\n  query: URLSearchParams;\n  headers: Headers;\n  input?: unknown;\n};\n\n/** Actions available on workflow instances. */\nexport type WorkflowManagementAction = \"pause\" | \"resume\" | \"terminate\" | \"restart\";\n\n/** Authorization hook signature for workflow routes. */\nexport type WorkflowsAuthorizeHook<TContext extends WorkflowsAuthorizeContext> = (\n  context: TContext,\n) => Promise<Response | void> | Response | void;\n\n/** Authorization context for instance creation requests. */\nexport type WorkflowsAuthorizeInstanceCreationContext = WorkflowsAuthorizeContext & {\n  workflowName: string;\n  instances: { id?: string; params?: unknown }[];\n};\n\n/** Authorization context for management actions. */\nexport type WorkflowsAuthorizeManagementContext = WorkflowsAuthorizeContext & {\n  workflowName: string;\n  instanceId: string;\n  action: WorkflowManagementAction;\n};\n\n/** Authorization context for sendEvent requests. */\nexport type WorkflowsAuthorizeSendEventContext = WorkflowsAuthorizeContext & {\n  workflowName: string;\n  instanceId: string;\n  eventType: string;\n  payload?: unknown;\n};\n\n/** Authorization context for runner tick requests. */\nexport type WorkflowsAuthorizeRunnerTickContext = WorkflowsAuthorizeContext & {\n  options: RunnerTickOptions;\n};\n\n/** Configuration for the workflows fragment. */\nexport interface WorkflowsFragmentConfig<TRegistry extends WorkflowsRegistry = WorkflowsRegistry> {\n  workflows?: TRegistry;\n  dispatcher?: WorkflowsDispatcher;\n  runner?: WorkflowsRunner;\n  runtime: FragnoRuntime;\n  dbNow?: () => Date | DbNow;\n  enableRunnerTick?: boolean;\n  authorizeRequest?: WorkflowsAuthorizeHook<WorkflowsAuthorizeContext>;\n  authorizeInstanceCreation?: WorkflowsAuthorizeHook<WorkflowsAuthorizeInstanceCreationContext>;\n  authorizeManagement?: WorkflowsAuthorizeHook<WorkflowsAuthorizeManagementContext>;\n  authorizeSendEvent?: WorkflowsAuthorizeHook<WorkflowsAuthorizeSendEventContext>;\n  authorizeRunnerTick?: WorkflowsAuthorizeHook<WorkflowsAuthorizeRunnerTickContext>;\n}\n\nconst TERMINAL_STATUSES: InstanceStatus[\"status\"][] = [\"complete\", \"terminated\", \"errored\"];\nconst WAITING_STATUSES: InstanceStatus[\"status\"][] = [\"waiting\", \"waitingForPause\"];\n\nexport const isTerminalStatus = (status: InstanceStatus[\"status\"]) =>\n  TERMINAL_STATUSES.includes(status);\n\nexport const isWaitingStatus = (status: InstanceStatus[\"status\"]) =>\n  WAITING_STATUSES.includes(status);\n\nexport const statusLabel = (status: InstanceStatus[\"status\"]) => {\n  const labels: Record<InstanceStatus[\"status\"], string> = {\n    queued: \"Queued\",\n    running: \"Running\",\n    paused: \"Paused\",\n    errored: \"Errored\",\n    terminated: \"Terminated\",\n    complete: \"Complete\",\n    waiting: \"Waiting\",\n    waitingForPause: \"Waiting For Pause\",\n    unknown: \"Unknown\",\n  };\n\n  return labels[status] ?? \"Unknown\";\n};\n\nexport const currentStepLabel = (step?: WorkflowInstanceCurrentStep | null) => {\n  if (!step) {\n    return undefined;\n  }\n\n  return step.name ? `${step.name} (${step.type})` : step.type;\n};\n"],"mappings":";AAqMA,SAAgB,eACd,SACA,KACoB;AACpB,QAAO;EAAE,GAAG;EAAS;EAAK;;;AAI5B,IAAsB,qBAAtB,MAA6F;CAC3F,AAAO;;AAgBT,MAAa,8BACX,UACsC,cAAc;;AA8BtD,IAAa,oBAAb,cAAuC,MAAM;CAC3C,YAAY,SAAiB,MAAe;AAC1C,QAAM,QAAQ;AACd,OAAK,OAAO,QAAQ;;;AA0FxB,MAAMA,oBAAgD;CAAC;CAAY;CAAc;CAAU;AAC3F,MAAMC,mBAA+C,CAAC,WAAW,kBAAkB;AAEnF,MAAa,oBAAoB,WAC/B,kBAAkB,SAAS,OAAO;AAEpC,MAAa,mBAAmB,WAC9B,iBAAiB,SAAS,OAAO;AAEnC,MAAa,eAAe,WAAqC;AAa/D,QAZyD;EACvD,QAAQ;EACR,SAAS;EACT,QAAQ;EACR,SAAS;EACT,YAAY;EACZ,UAAU;EACV,SAAS;EACT,iBAAiB;EACjB,SAAS;EACV,CAEa,WAAW;;AAG3B,MAAa,oBAAoB,SAA8C;AAC7E,KAAI,CAAC,KACH;AAGF,QAAO,KAAK,OAAO,GAAG,KAAK,KAAK,IAAI,KAAK,KAAK,KAAK,KAAK"}