duron 0.3.0-beta.1 → 0.3.0-beta.11

package/dist/action-job.d.ts

@@ -16,11 +16,42 @@ export interface ActionJobOptions<TAction extends Action<any, any, any>> {
     variables: Record<string, unknown>;
     logger: Logger;
 }
+/**
+ * ActionJob represents a single job execution for an action.
+ * Manages the execution lifecycle, timeout handling, and cancellation.
+ *
+ * @template TAction - The action type being executed
+ */
 export declare class ActionJob<TAction extends Action<any, any, any>> {
     #private;
+    /**
+     * Create a new ActionJob instance.
+     *
+     * @param options - Configuration options for the action job
+     */
     constructor(options: ActionJobOptions<TAction>);
+    /**
+     * Execute the action job.
+     * Creates the action context, sets up timeout, executes the handler,
+     * validates output, and marks the job as completed or failed.
+     *
+     * @returns Promise resolving to the action result
+     * @throws ActionTimeoutError if the job times out
+     * @throws ActionCancelError if the job is cancelled
+     * @throws Error if the job fails or output validation fails
+     */
     execute(): Promise<any>;
+    /**
+     * Wait for the job execution to complete.
+     * Returns a promise that resolves when the job finishes (successfully or with error).
+     *
+     * @returns Promise that resolves when the job is done
+     */
     waitForDone(): Promise<void>;
+    /**
+     * Cancel the job execution.
+     * Clears the timeout and aborts the action handler.
+     */
     cancel(): void;
 }
 //# sourceMappingURL=action-job.d.ts.map

package/dist/action-job.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action-job.d.ts","sourceRoot":"","sources":["../src/action-job.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAElC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAGpD,OAAO,KAAK,EAAQ,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAGpE,MAAM,WAAW,gBAAgB,CAAC,OAAO,SAAS,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IACrE,GAAG,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,GAAG,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;IACxF,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,EAAE,gBAAgB,CAAA;IAC3B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,MAAM,EAAE,MAAM,CAAA;CACf;AAQD,qBAAa,SAAS,CAAC,OAAO,SAAS,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;;gBAuB9C,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC;IAsCxC,OAAO;IA2Hb,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,MAAM;CAmBP"}
+{"version":3,"file":"action-job.d.ts","sourceRoot":"","sources":["../src/action-job.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAElC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAGpD,OAAO,KAAK,EAAQ,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAGpE,MAAM,WAAW,gBAAgB,CAAC,OAAO,SAAS,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IACrE,GAAG,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,GAAG,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;IACxF,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,EAAE,gBAAgB,CAAA;IAC3B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;GAKG;AACH,qBAAa,SAAS,CAAC,OAAO,SAAS,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;;IAkB1D;;;;OAIG;gBACS,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC;IA4B9C;;;;;;;;;OASG;IACG,OAAO;IA4Hb;;;;;OAKG;IACH,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;OAGG;IACH,MAAM;CAmBP"}

package/dist/action-job.js

@@ -1,6 +1,12 @@
-import { ActionCancelError, ActionTimeoutError, isCancelError, StepTimeoutError, serializeError } from './errors.js';
+import { ActionCancelError, ActionTimeoutError, isCancelError, isTimeoutError, serializeError } from './errors.js';
 import { StepManager } from './step-manager.js';
 import waitForAbort from './utils/wait-for-abort.js';
+/**
+ * ActionJob represents a single job execution for an action.
+ * Manages the execution lifecycle, timeout handling, and cancellation.
+ *
+ * @template TAction - The action type being executed
+ */
 export class ActionJob {
     #job;
     #action;
@@ -14,6 +20,14 @@ export class ActionJob {
     #done;
     #resolve = null;
     #jobSpan = null;
+    // ============================================================================
+    // Constructor
+    // ============================================================================
+    /**
+     * Create a new ActionJob instance.
+     *
+     * @param options - Configuration options for the action job
+     */
     constructor(options) {
         this.#job = options.job;
         this.#action = options.action;
@@ -22,38 +36,58 @@ export class ActionJob {
         this.#variables = options.variables;
         this.#logger = options.logger;
         this.#abortController = new AbortController();
+        // Create StepManager for this job
         this.#stepManager = new StepManager({
             jobId: options.job.id,
             actionName: options.job.actionName,
             adapter: options.database,
             telemetry: options.telemetry,
             logger: options.logger,
-            concurrencyLimit: options.action.concurrency,
+            concurrencyLimit: options.action.steps.concurrency,
         });
         this.#done = new Promise((resolve) => {
             this.#resolve = resolve;
         });
     }
+    // ============================================================================
+    // Public API Methods
+    // ============================================================================
+    /**
+     * Execute the action job.
+     * Creates the action context, sets up timeout, executes the handler,
+     * validates output, and marks the job as completed or failed.
+     *
+     * @returns Promise resolving to the action result
+     * @throws ActionTimeoutError if the job times out
+     * @throws ActionCancelError if the job is cancelled
+     * @throws Error if the job fails or output validation fails
+     */
     async execute() {
+        // Start job telemetry span
         this.#jobSpan = await this.#telemetry.startJobSpan({
             jobId: this.#job.id,
             actionName: this.#action.name,
             groupKey: this.#job.groupKey,
             input: this.#job.input,
         });
+        // Set the job span on the step manager
         this.#stepManager.setJobSpan(this.#jobSpan);
         try {
+            // Create a child logger for this job
             const jobLogger = this.#logger.child({
                 jobId: this.#job.id,
                 actionName: this.#action.name,
             });
+            // Create observe context for the action handler
             const observeContext = this.#telemetry.createObserveContext(this.#job.id, null, this.#jobSpan);
+            // Create action context with step manager
             const ctx = this.#stepManager.createActionContext(this.#job, this.#action, this.#variables, this.#abortController.signal, jobLogger, observeContext);
             this.#timeoutId = setTimeout(() => {
-                const timeoutError = new ActionTimeoutError(this.#action.name, this.#job.timeoutMs);
+                const timeoutError = new ActionTimeoutError(this.#action.name, this.#job.id, this.#job.timeoutMs);
                 this.#abortController.abort(timeoutError);
             }, this.#job.timeoutMs);
             this.#timeoutId?.unref?.();
+            // Execute handler with timeout - race between handler and abort signal
             const abortWaiter = waitForAbort(this.#abortController.signal);
             let result = null;
             await Promise.race([
@@ -69,37 +103,48 @@ export class ActionJob {
                 }),
                 abortWaiter.promise,
             ]);
+            // Validate output if schema is provided
             if (this.#action.output) {
                 result = this.#action.output.parse(result, {
                     error: () => 'Error parsing action output',
                     reportInput: true,
                 });
             }
+            // Complete job
             const completed = await this.#database.completeJob({ jobId: this.#job.id, output: result });
             if (!completed) {
                 throw new Error('Job not completed');
             }
+            // Log action completion
             this.#logger.debug({ jobId: this.#job.id, actionName: this.#action.name }, '[ActionJob] Action finished executing');
+            // End job span successfully
             await this.#telemetry.endJobSpan(this.#jobSpan, { status: 'ok' });
             return result;
         }
         catch (error) {
+            // Abort all running steps when an error occurs
+            // This ensures cascading failure and stops any steps still running
+            if (!this.#abortController.signal.aborted) {
+                this.#abortController.abort(error);
+            }
+            // Wait for step manager to drain (all steps to settle)
+            await this.#stepManager.drain();
             if (isCancelError(error) ||
                 (error instanceof Error && error.name === 'AbortError' && isCancelError(error.cause))) {
                 this.#logger.warn({ jobId: this.#job.id, actionName: this.#action.name }, '[ActionJob] Job cancelled');
                 await this.#database.cancelJob({ jobId: this.#job.id });
+                // End job span as cancelled
                 if (this.#jobSpan) {
                     await this.#telemetry.endJobSpan(this.#jobSpan, { status: 'cancelled' });
                 }
                 return;
             }
-            const message = error instanceof ActionTimeoutError
+            const message = isTimeoutError(error)
                 ? '[ActionJob] Job timed out'
-                : error instanceof StepTimeoutError
-                    ? '[ActionJob] Step timed out'
-                    : '[ActionJob] Job failed';
+                : '[ActionJob] Job failed';
             this.#logger.error({ jobId: this.#job.id, actionName: this.#action.name }, message);
             await this.#database.failJob({ jobId: this.#job.id, error: serializeError(error) });
+            // End job span with error
             if (this.#jobSpan) {
                 await this.#telemetry.endJobSpan(this.#jobSpan, { status: 'error', error });
             }
@@ -110,14 +155,30 @@ export class ActionJob {
             this.#resolve?.();
         }
     }
+    /**
+     * Wait for the job execution to complete.
+     * Returns a promise that resolves when the job finishes (successfully or with error).
+     *
+     * @returns Promise that resolves when the job is done
+     */
     waitForDone() {
         return this.#done;
     }
+    /**
+     * Cancel the job execution.
+     * Clears the timeout and aborts the action handler.
+     */
     cancel() {
         this.#clear();
         const cancelError = new ActionCancelError(this.#action.name, this.#job.id);
         this.#abortController.abort(cancelError);
     }
+    // ============================================================================
+    // Private Methods
+    // ============================================================================
+    /**
+     * Clear the timeout timer.
+     */
     #clear() {
         if (this.#timeoutId) {
             clearTimeout(this.#timeoutId);

package/dist/action-manager.d.ts

@@ -10,14 +10,56 @@ export interface ActionManagerOptions<TAction extends Action<any, any, any>> {
     logger: Logger;
     concurrencyLimit: number;
 }
+/**
+ * ActionManager manages the execution of jobs for a specific action.
+ * Uses a fastq queue to control concurrency and process jobs.
+ *
+ * @template TAction - The action type being managed
+ */
 export declare class ActionManager<TAction extends Action<any, any, any>> {
     #private;
+    /**
+     * Create a new ActionManager instance.
+     *
+     * @param options - Configuration options for the action manager
+     */
     constructor(options: ActionManagerOptions<TAction>);
+    /**
+     * Queue a job for execution.
+     *
+     * @param job - The job to queue
+     * @returns Promise that resolves when the job is queued
+     */
     push(job: Job): Promise<void>;
+    /**
+     * Cancel a specific job by ID.
+     *
+     * @param jobId - The ID of the job to cancel
+     * @returns If the manager has the job, it will be cancelled and true will be returned. Otherwise, false will be returned.
+     */
     cancelJob(jobId: string): boolean;
+    /**
+     * Cancel all active jobs.
+     */
     abortAll(): void;
+    /**
+     * Check if the queue is idle (no jobs being processed).
+     *
+     * @returns Promise resolving to `true` if idle, `false` otherwise
+     */
     idle(): Promise<boolean>;
+    /**
+     * Wait for the queue to drain (all jobs completed).
+     *
+     * @returns Promise that resolves when the queue is drained
+     */
     drain(): Promise<void>;
+    /**
+     * Stop the action manager.
+     * Aborts all active jobs and waits for the queue to drain.
+     *
+     * @returns Promise that resolves when the action manager is stopped
+     */
     stop(): Promise<void>;
 }
 //# sourceMappingURL=action-manager.d.ts.map

package/dist/action-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action-manager.d.ts","sourceRoot":"","sources":["../src/action-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAElC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAE9D,MAAM,WAAW,oBAAoB,CAAC,OAAO,SAAS,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IACzE,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,EAAE,gBAAgB,CAAA;IAC3B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAQD,qBAAa,aAAa,CAAC,OAAO,SAAS,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;;gBAoBlD,OAAO,EAAE,oBAAoB,CAAC,OAAO,CAAC;IA4B5C,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAUnC,SAAS,CAAC,KAAK,EAAE,MAAM;IAYvB,QAAQ,IAAI,IAAI;IAWV,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IASxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAUtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CA+C5B"}
+{"version":3,"file":"action-manager.d.ts","sourceRoot":"","sources":["../src/action-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAElC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAE9D,MAAM,WAAW,oBAAoB,CAAC,OAAO,SAAS,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IACzE,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,EAAE,gBAAgB,CAAA;IAC3B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAED;;;;;GAKG;AACH,qBAAa,aAAa,CAAC,OAAO,SAAS,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;;IAe9D;;;;OAIG;gBACS,OAAO,EAAE,oBAAoB,CAAC,OAAO,CAAC;IAsBlD;;;;;OAKG;IACG,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAInC;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM;IASvB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAMhB;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAI9B;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CA+C5B"}

package/dist/action-manager.js

@@ -1,5 +1,11 @@
 import fastq from 'fastq';
 import { ActionJob } from './action-job.js';
+/**
+ * ActionManager manages the execution of jobs for a specific action.
+ * Uses a fastq queue to control concurrency and process jobs.
+ *
+ * @template TAction - The action type being managed
+ */
 export class ActionManager {
     #action;
     #database;
@@ -10,6 +16,14 @@ export class ActionManager {
     #concurrencyLimit;
     #activeJobs = new Map();
     #stopped = false;
+    // ============================================================================
+    // Constructor
+    // ============================================================================
+    /**
+     * Create a new ActionManager instance.
+     *
+     * @param options - Configuration options for the action manager
+     */
     constructor(options) {
         this.#action = options.action;
         this.#database = options.database;
@@ -17,6 +31,7 @@ export class ActionManager {
         this.#variables = options.variables;
         this.#logger = options.logger;
         this.#concurrencyLimit = options.concurrencyLimit;
+        // Create fastq queue with action concurrency limit
         this.#queue = fastq.promise(async (job) => {
             if (this.#stopped) {
                 return;
@@ -24,9 +39,24 @@ export class ActionManager {
             await this.#executeJob(job);
         }, this.#concurrencyLimit);
     }
+    // ============================================================================
+    // Public API Methods
+    // ============================================================================
+    /**
+     * Queue a job for execution.
+     *
+     * @param job - The job to queue
+     * @returns Promise that resolves when the job is queued
+     */
     async push(job) {
         return this.#queue.push(job);
     }
+    /**
+     * Cancel a specific job by ID.
+     *
+     * @param jobId - The ID of the job to cancel
+     * @returns If the manager has the job, it will be cancelled and true will be returned. Otherwise, false will be returned.
+     */
     cancelJob(jobId) {
         const actionJob = this.#activeJobs.get(jobId);
         if (actionJob) {
@@ -35,17 +65,36 @@ export class ActionManager {
         }
         return false;
     }
+    /**
+     * Cancel all active jobs.
+     */
     abortAll() {
         for (const actionJob of this.#activeJobs.values()) {
             actionJob.cancel();
         }
     }
+    /**
+     * Check if the queue is idle (no jobs being processed).
+     *
+     * @returns Promise resolving to `true` if idle, `false` otherwise
+     */
     async idle() {
         return this.#queue.idle();
     }
+    /**
+     * Wait for the queue to drain (all jobs completed).
+     *
+     * @returns Promise that resolves when the queue is drained
+     */
     async drain() {
         return this.#queue.drain();
     }
+    /**
+     * Stop the action manager.
+     * Aborts all active jobs and waits for the queue to drain.
+     *
+     * @returns Promise that resolves when the action manager is stopped
+     */
     async stop() {
         if (this.#stopped) {
             return;
@@ -55,7 +104,16 @@ export class ActionManager {
         await this.#queue.killAndDrain();
         await Promise.all(Array.from(this.#activeJobs.values()).map((actionJob) => actionJob.waitForDone()));
     }
+    // ============================================================================
+    // Private Methods
+    // ============================================================================
+    /**
+     * Execute a job by creating an ActionJob and running it.
+     *
+     * @param job - The job to execute
+     */
     async #executeJob(job) {
+        // Create ActionJob for this job
         const actionJob = new ActionJob({
             job: {
                 id: job.id,
@@ -72,9 +130,12 @@ export class ActionManager {
         });
         this.#activeJobs.set(job.id, actionJob);
         try {
+            // Execute the job - all error handling is done inside ActionJob.execute()
             await actionJob.execute();
         }
         finally {
+            // Always cleanup, even if the job failed or was cancelled
+            // Errors are already handled in ActionJob.execute() (logging, failing job, etc.)
             this.#activeJobs.delete(job.id);
         }
     }

package/dist/action.d.ts

@@ -9,32 +9,132 @@ export interface ActionHandlerContext<TInput extends z.ZodObject, TVariables = R
     groupKey: string;
     var: TVariables;
     logger: Logger;
+    /**
+     * Observability context for recording metrics and span data.
+     * Allows recording custom metrics, span attributes, and events.
+     */
     observe: ObserveContext;
+    /**
+     * Execute an inline step within the action.
+     *
+     * @param name - The name of the step (must be unique within the job)
+     * @param cb - The step handler callback
+     * @param options - Optional step configuration
+     * @returns Promise resolving to the step result
+     */
     step: <TResult>(name: string, cb: (ctx: StepHandlerContext) => Promise<TResult>, options?: z.input<typeof StepOptionsSchema>) => Promise<TResult>;
+    /**
+     * Execute a reusable step definition created with createStep().
+     *
+     * @param stepDef - The step definition to execute
+     * @param input - The input data for the step (validated against the step's input schema)
+     * @param options - Optional step configuration overrides
+     * @returns Promise resolving to the step result
+     */
     run: <TStepInput extends z.ZodObject, TResult>(stepDef: StepDefinition<TStepInput, TResult, TVariables>, input: z.input<TStepInput>, options?: Partial<z.input<typeof StepOptionsSchema>>) => Promise<TResult>;
 }
 export interface StepHandlerContext {
+    /**
+     * The abort signal for this step.
+     * This signal will be aborted when:
+     * - The action is cancelled
+     * - The parent step times out
+     * - This step times out
+     */
     signal: AbortSignal;
+    /**
+     * The unique ID of this step.
+     */
     stepId: string;
+    /**
+     * The ID of the parent step, or null if this is a root step.
+     */
     parentStepId: string | null;
+    /**
+     * Observability context for recording metrics and span data.
+     * Allows recording custom metrics, span attributes, and events.
+     */
     observe: ObserveContext;
+    /**
+     * Create a nested child step.
+     * Child steps inherit the abort signal chain from their parent.
+     * All child steps MUST be awaited before the parent step returns.
+     *
+     * @param name - The name of the child step (must be unique within the job)
+     * @param cb - The step handler callback
+     * @param options - Optional step configuration
+     * @returns Promise resolving to the step result
+     */
     step: <TResult>(name: string, cb: (ctx: StepHandlerContext) => Promise<TResult>, options?: z.input<typeof StepOptionsSchema>) => Promise<TResult>;
+    /**
+     * Execute a reusable step definition created with createStep().
+     * Allows inline steps to call step definitions.
+     *
+     * @param stepDef - The step definition to execute
+     * @param input - The input data for the step (validated against the step's input schema)
+     * @param options - Optional step configuration overrides
+     * @returns Promise resolving to the step result
+     */
+    run: <TStepInput extends z.ZodObject, TResult>(stepDef: StepDefinition<TStepInput, TResult, any>, input: z.input<TStepInput>, options?: Partial<z.input<typeof StepOptionsSchema>>) => Promise<TResult>;
 }
+/**
+ * Extended context for step definition handlers.
+ * Includes all StepHandlerContext properties plus action-level context.
+ */
 export interface StepDefinitionHandlerContext<TInput extends z.ZodObject, TVariables = Record<string, unknown>> extends StepHandlerContext {
+    /**
+     * The validated input for this step.
+     */
     input: z.infer<TInput>;
+    /**
+     * Variables shared across the action.
+     */
     var: TVariables;
+    /**
+     * Logger instance for this step.
+     */
     logger: Logger;
+    /**
+     * The job ID this step belongs to.
+     */
     jobId: string;
 }
+/**
+ * A reusable step definition created with createStep().
+ * Can be executed within an action handler using ctx.run().
+ */
 export interface StepDefinition<TInput extends z.ZodObject, TResult, TVariables = Record<string, unknown>> {
+    /**
+     * The name of the step.
+     * Can be a static string or a function that generates the name from the input.
+     */
     name: string | ((ctx: {
         input: z.infer<TInput>;
     }) => string);
+    /**
+     * Zod schema for validating the step input.
+     */
     input?: TInput;
+    /**
+     * Retry configuration for this step.
+     */
     retry?: z.input<typeof RetryOptionsSchema>;
+    /**
+     * Timeout in milliseconds for this step.
+     */
     expire?: number;
+    /**
+     * Whether this step runs in parallel with siblings.
+     */
     parallel?: boolean;
+    /**
+     * The handler function that executes the step logic.
+     */
     handler: (ctx: StepDefinitionHandlerContext<TInput, TVariables>) => Promise<TResult>;
+    /**
+     * Internal marker to identify this as a step definition.
+     * @internal
+     */
     __stepDefinition: true;
 }
 export interface ConcurrencyHandlerContext<TInput extends z.ZodObject, TVariables = Record<string, unknown>> {
@@ -43,12 +143,18 @@ export interface ConcurrencyHandlerContext<TInput extends z.ZodObject, TVariable
 }
 export type ActionDefinition<TInput extends z.ZodObject, TOutput extends z.ZodObject, TVariables = Record<string, unknown>> = z.input<ReturnType<typeof createActionDefinitionSchema<TInput, TOutput, TVariables>>>;
 export type Action<TInput extends z.ZodObject, TOutput extends z.ZodObject, TVariables = Record<string, unknown>> = z.infer<ReturnType<typeof createActionDefinitionSchema<TInput, TOutput, TVariables>>>;
+/**
+ * Retry configuration options for actions and steps.
+ */
 export declare const RetryOptionsSchema: z.ZodDefault<z.ZodObject<{
     limit: z.ZodDefault<z.ZodNumber>;
     factor: z.ZodDefault<z.ZodNumber>;
     minTimeout: z.ZodDefault<z.ZodNumber>;
     maxTimeout: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>>;
+/**
+ * Options for configuring a step within an action.
+ */
 export declare const StepOptionsSchema: z.ZodObject<{
     retry: z.ZodDefault<z.ZodObject<{
         limit: z.ZodDefault<z.ZodNumber>;
@@ -59,6 +165,14 @@ export declare const StepOptionsSchema: z.ZodObject<{
     expire: z.ZodDefault<z.ZodNumber>;
     parallel: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
+/**
+ * Creates a Zod schema for validating action definitions.
+ *
+ * @template TInput - Zod schema for the action input
+ * @template TOutput - Zod schema for the action output
+ * @template TVariables - Type of variables available to the action
+ * @returns Zod schema for action definitions
+ */
 export declare function createActionDefinitionSchema<TInput extends z.ZodObject, TOutput extends z.ZodObject, TVariables = Record<string, unknown>>(): z.ZodPipe<z.ZodObject<{
     name: z.ZodString;
     version: z.ZodOptional<z.ZodString>;
@@ -151,6 +265,36 @@ export declare const defineAction: <TVariables = Record<string, unknown>>() => <
         concurrency?: ((ctx: ConcurrencyHandlerContext<TInput, TVariables>) => Promise<number>) | undefined;
     } | undefined;
 };
+/**
+ * Input type for createStep() - the definition object before transformation.
+ */
 export type StepDefinitionInput<TInput extends z.ZodObject, TResult, TVariables = Record<string, unknown>> = Omit<StepDefinition<TInput, TResult, TVariables>, '__stepDefinition'>;
+/**
+ * Creates a reusable step definition that can be executed within action handlers.
+ *
+ * @template TVariables - Type of variables available to the step handler
+ * @returns A curried function that accepts the step definition and returns a StepDefinition
+ *
+ * @example
+ * ```typescript
+ * const sendEmailStep = createStep<typeof variables>()({
+ *   name: 'send-email',
+ *   input: z.object({
+ *     email: z.string().email(),
+ *     body: z.string(),
+ *   }),
+ *   retry: { limit: 3 },
+ *   expire: 60000,
+ *   handler: async (ctx) => {
+ *     // ctx.input is typed as { email: string, body: string }
+ *     // ctx.var, ctx.logger, ctx.jobId are also available
+ *     return { success: true }
+ *   },
+ * })
+ *
+ * // In an action handler:
+ * const result = await ctx.run(sendEmailStep, { email: 'test@example.com', body: 'Hello' })
+ * ```
+ */
 export declare const createStep: <TVariables = Record<string, unknown>>() => <TInput extends z.ZodObject, TResult>(def: StepDefinitionInput<TInput, TResult, TVariables>) => StepDefinition<TInput, TResult, TVariables>;
 //# sourceMappingURL=action.d.ts.map

package/dist/action.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../src/action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAClC,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAG5D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAE7D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAE3D,MAAM,WAAW,oBAAoB,CAAC,MAAM,SAAS,CAAC,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACpG,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,GAAG,EAAE,UAAU,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IAMd,OAAO,EAAE,cAAc,CAAA;IAUvB,IAAI,EAAE,CAAC,OAAO,EACZ,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,CAAC,EACjD,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,KACxC,OAAO,CAAC,OAAO,CAAC,CAAA;IAUrB,GAAG,EAAE,CAAC,UAAU,SAAS,CAAC,CAAC,SAAS,EAAE,OAAO,EAC3C,OAAO,EAAE,cAAc,CAAC,UAAU,EAAE,OAAO,EAAE,UAAU,CAAC,EACxD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,EAC1B,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC,KACjD,OAAO,CAAC,OAAO,CAAC,CAAA;CACtB;AAED,MAAM,WAAW,kBAAkB;IAQjC,MAAM,EAAE,WAAW,CAAA;IAKnB,MAAM,EAAE,MAAM,CAAA;IAKd,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAM3B,OAAO,EAAE,cAAc,CAAA;IAYvB,IAAI,EAAE,CAAC,OAAO,EACZ,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,CAAC,EACjD,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,KACxC,OAAO,CAAC,OAAO,CAAC,CAAA;CACtB;AAMD,MAAM,WAAW,4BAA4B,CAAC,MAAM,SAAS,CAAC,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAC5G,SAAQ,kBAAkB;IAI1B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAKtB,GAAG,EAAE,UAAU,CAAA;IAKf,MAAM,EAAE,MAAM,CAAA;IAKd,KAAK,EAAE,MAAM,CAAA;CACd;AAMD,MAAM,WAAW,cAAc,CAC7B,MAAM,SAAS,CAAC,CAAC,SAAS,EAC1B,OAAO,EACP,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAMpC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE;QAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;KAAE,KAAK,MAAM,CAAC,CAAA;IAK5D,KAAK,CAAC,EAAE,MAAM,CAAA;IAKd,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;IAK1C,MAAM,CAAC,EAAE,MAAM,CAAA;IAKf,QAAQ,CAAC,EAAE,OAAO,CAAA;IAKlB,OAAO,EAAE,CAAC,GAAG,EAAE,4BAA4B,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAMpF,gBAAgB,EAAE,IAAI,CAAA;CACvB;AAED,MAAM,WAAW,yBAAyB,CAAC,MAAM,SAAS,CAAC,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACzG,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACtB,GAAG,EAAE,UAAU,CAAA;CAChB;AAED,MAAM,MAAM,gBAAgB,CAC1B,MAAM,SAAS,CAAC,CAAC,SAAS,EAC1B,OAAO,SAAS,CAAC,CAAC,SAAS,EAC3B,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAClC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,4BAA4B,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAA;AAEzF,MAAM,MAAM,MAAM,CAChB,MAAM,SAAS,CAAC,CAAC,SAAS,EAC1B,OAAO,SAAS,CAAC,CAAC,SAAS,EAC3B,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAClC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,4BAA4B,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAA;AAKzF,eAAO,MAAM,kBAAkB;;;;;kBAiCC,CAAA;AAKhC,eAAO,MAAM,iBAAiB;;;;;;;;;iBA0B5B,CAAA;AAUF,wBAAgB,4BAA4B,CAC1C,MAAM,SAAS,CAAC,CAAC,SAAS,EAC1B,OAAO,SAAS,CAAC,CAAC,SAAS,EAC3B,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;kDAkDZ,yBAAyB,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,QAAjE,yBAAyB,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC;qDAejE,yBAAyB,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,QAAjE,yBAAyB,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC;;;;;;;;;;;;;;+BA6CrE,oBAAoB,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,QAAtE,oBAAoB,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;;;;;;;;;;;;;;;;mBAAtE,oBAAoB,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;;;;;0BA5DlE,yBAAyB,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC;6BAejE,yBAAyB,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;;mBA6CrE,oBAAoB,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;;;;;0BA5DlE,yBAAyB,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC;6BAejE,yBAAyB,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC;;IAyD1F;AAED,eAAO,MAAM,YAAY,GAAI,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QACvD,MAAM,SAAS,CAAC,CAAC,SAAS,EAAE,OAAO,SAAS,CAAC,CAAC,SAAS,EAC7D,KAAK,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;4EA5EsB,OAAO,CAAC,MAAM,CAAC;+EAef,OAAO,CAAC,MAAM,CAAC;;CAmE1F,CAAA;AAKD,MAAM,MAAM,mBAAmB,CAC7B,MAAM,SAAS,CAAC,CAAC,SAAS,EAC1B,OAAO,EACP,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAClC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,kBAAkB,CAAC,CAAA;AA6BzE,eAAO,MAAM,UAAU,GAAI,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QACrD,MAAM,SAAS,CAAC,CAAC,SAAS,EAAE,OAAO,EACzC,KAAK,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,KACpD,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAM9C,CAAA"}
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../src/action.ts"],"names":[],"mappings":"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"}