duron 0.3.0-beta.9 → 0.3.0

package/dist/action.d.ts

@@ -1,6 +1,6 @@
 import type { Logger } from 'pino';
 import * as z from 'zod';
-import type { ObserveContext } from './telemetry/adapter.js';
+import type { TelemetryContext } from './step-manager.js';
 export type RetryOptions = z.infer<typeof RetryOptionsSchema>;
 export type StepOptions = z.infer<typeof StepOptionsSchema>;
 export interface ActionHandlerContext<TInput extends z.ZodObject, TVariables = Record<string, unknown>> {
@@ -9,40 +9,387 @@ export interface ActionHandlerContext<TInput extends z.ZodObject, TVariables = R
     groupKey: string;
     var: TVariables;
     logger: Logger;
-    observe: ObserveContext;
+    /**
+     * Telemetry context for recording metrics and span data.
+     * Provides access to OpenTelemetry APIs for recording traces and metrics.
+     */
+    telemetry: TelemetryContext;
+    /**
+     * 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;
-    observe: ObserveContext;
+    /**
+     * Telemetry context for recording metrics and span data.
+     * Provides access to OpenTelemetry APIs for recording traces and metrics.
+     */
+    telemetry: TelemetryContext;
+    /**
+     * 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>> {
-    name: string | ((ctx: {
-        input: z.infer<TInput>;
-    }) => string);
+    /**
+     * The name of the step.
+     * Can be a static string or a function that generates the name from the context.
+     * The function receives a context object with input, variables, jobId, and parentStepId.
+     *
+     * @example
+     * ```typescript
+     * name: (ctx) => `process-user-${ctx.input.userId}`
+     * ```
+     *
+     * @example
+     * ```typescript
+     * name: (ctx) => `step-${ctx.var.environment}-${ctx.jobId.slice(0, 8)}`
+     * ```
+     */
+    name: string | ((ctx: StepNameContext<TInput, TVariables>) => 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>> {
     input: z.infer<TInput>;
     var: TVariables;
 }
-export type ActionDefinition<TInput extends z.ZodObject, TOutput extends z.ZodObject, TVariables = Record<string, unknown>> = z.input<ReturnType<typeof createActionDefinitionSchema<TInput, TOutput, TVariables>>>;
+/**
+ * Context available when generating dynamic step names.
+ * Provides access to input, variables, job ID, and parent step ID.
+ */
+export interface StepNameContext<TInput extends z.ZodObject, TVariables = Record<string, unknown>> {
+    /**
+     * The validated input for this step.
+     */
+    input: z.infer<TInput>;
+    /**
+     * Variables shared across the action.
+     */
+    var: TVariables;
+    /**
+     * The job ID this step belongs to.
+     */
+    jobId: string;
+    /**
+     * The ID of the parent step, or null if this is a root step.
+     */
+    parentStepId: string | null;
+}
+/**
+ * Retry configuration options for actions and steps.
+ * Controls how failed operations are retried with exponential backoff.
+ */
+export interface RetryOptionsInput {
+    /**
+     * Maximum number of retry attempts.
+     * Set to 0 to disable retries.
+     *
+     * @default 4
+     */
+    limit?: number;
+    /**
+     * Exponential backoff factor.
+     * The delay between retries is calculated as: `minTimeout * (factor ^ attemptNumber)`
+     *
+     * @default 2
+     */
+    factor?: number;
+    /**
+     * Minimum delay in milliseconds before the first retry.
+     * This is the base delay that gets multiplied by the factor.
+     *
+     * @default 1000
+     */
+    minTimeout?: number;
+    /**
+     * Maximum delay in milliseconds between retries.
+     * The calculated delay will be capped at this value to prevent
+     * excessively long wait times.
+     *
+     * @default 30000
+     */
+    maxTimeout?: number;
+}
+/**
+ * Configuration options for steps within an action.
+ * Controls concurrency, retries, and timeouts for step execution.
+ */
+export interface StepsConfigInput {
+    /**
+     * Maximum number of steps that can run concurrently within this action.
+     * Higher values allow more parallelism but may increase resource usage.
+     *
+     * @default 100
+     */
+    concurrency?: number;
+    /**
+     * Retry configuration for steps.
+     * These settings apply to all steps unless overridden at the step level.
+     *
+     * @default { limit: 4, factor: 2, minTimeout: 1000, maxTimeout: 30000 }
+     */
+    retry?: RetryOptionsInput;
+    /**
+     * Timeout in milliseconds for each step.
+     * Steps that exceed this timeout will be cancelled and may be retried.
+     *
+     * @default 300000 (5 minutes)
+     */
+    expire?: number;
+}
+/**
+ * Group configuration for concurrency control.
+ * Allows grouping jobs by key and controlling concurrency per group.
+ */
+export interface GroupsConfigInput<TInput extends z.ZodObject, TVariables = Record<string, unknown>> {
+    /**
+     * Function to determine the group key for a job.
+     * Jobs with the same group key will respect the group concurrency limit.
+     * Use this to limit concurrent processing of related jobs (e.g., per user, per tenant).
+     *
+     * If not provided, all jobs for this action will use the '@default' group key.
+     *
+     * @param ctx - Context containing the validated input and variables
+     * @returns Promise resolving to the group key string
+     *
+     * @example
+     * ```typescript
+     * groupKey: async (ctx) => `user:${ctx.input.userId}`
+     * ```
+     */
+    groupKey?: (ctx: ConcurrencyHandlerContext<TInput, TVariables>) => Promise<string>;
+    /**
+     * Function to dynamically determine the concurrency limit for a job's group.
+     * The concurrency limit is stored with each job and used during fetch operations.
+     * This allows different groups to have different concurrency limits.
+     *
+     * If not provided, uses the global `groupConcurrencyLimit` from the client options.
+     *
+     * @param ctx - Context containing the validated input and variables
+     * @returns Promise resolving to the concurrency limit number
+     *
+     * @example
+     * ```typescript
+     * concurrency: async (ctx) => ctx.input.priority === 'high' ? 10 : 2
+     * ```
+     */
+    concurrency?: (ctx: ConcurrencyHandlerContext<TInput, TVariables>) => Promise<number>;
+}
+/**
+ * Definition for creating a Duron action.
+ * Actions are type-safe, durable job handlers with built-in retry logic,
+ * step-based execution, and concurrency control.
+ *
+ * @template TInput - Zod schema type for validating the action input
+ * @template TOutput - Zod schema type for validating the action output
+ * @template TVariables - Type of variables available to the action handler
+ */
+export interface ActionDefinitionInput<TInput extends z.ZodObject, TOutput extends z.ZodObject, TVariables = Record<string, unknown>> {
+    /**
+     * Unique name for this action.
+     * Used as the queue name and must be unique across all actions registered with a client.
+     * This name is used for job routing, logging, and dashboard display.
+     *
+     * @example 'send-email', 'process-payment', 'sync-user-data'
+     */
+    name: string;
+    /**
+     * Optional version string for the action.
+     * Used to track changes to the action and included in the checksum calculation.
+     * Changing the version will cause existing jobs to be treated as having a different checksum.
+     *
+     * @example '1.0.0', '2024-01-15', 'v2'
+     */
+    version?: string;
+    /**
+     * Zod schema for validating the action input.
+     * If provided, input will be validated before the handler is called.
+     * Invalid input will throw a validation error and the job will fail.
+     *
+     * @example
+     * ```typescript
+     * input: z.object({
+     *   email: z.string().email(),
+     *   subject: z.string().min(1),
+     * })
+     * ```
+     */
+    input?: TInput;
+    /**
+     * Zod schema for validating the action output.
+     * If provided, output will be validated after the handler completes.
+     * Invalid output will cause the job to fail.
+     *
+     * @example
+     * ```typescript
+     * output: z.object({
+     *   success: z.boolean(),
+     *   messageId: z.string().optional(),
+     * })
+     * ```
+     */
+    output?: TOutput;
+    /**
+     * Group configuration for concurrency control.
+     * Allows grouping jobs by a dynamic key and controlling concurrency per group.
+     * Useful for rate limiting per user, tenant, or resource.
+     */
+    groups?: GroupsConfigInput<TInput, TVariables>;
+    /**
+     * Configuration for steps within this action.
+     * Steps are retryable units of work that can be executed within the action handler.
+     * These settings apply to all steps unless overridden at the step level.
+     *
+     * @default { concurrency: 100, retry: { limit: 4, factor: 2, minTimeout: 1000, maxTimeout: 30000 }, expire: 300000 }
+     */
+    steps?: StepsConfigInput;
+    /**
+     * Maximum number of jobs for this action that can run concurrently across all workers.
+     * This limit is enforced per action, regardless of group.
+     *
+     * @default 100
+     */
+    concurrency?: number;
+    /**
+     * Timeout in milliseconds for the entire action.
+     * Jobs that exceed this timeout will be cancelled.
+     * Make sure this is greater than the expected total execution time including all steps.
+     *
+     * @default 900000 (15 minutes)
+     */
+    expire?: number;
+    /**
+     * Function to generate a dynamic description for the job.
+     * The description is calculated at job creation time and stored in the database.
+     * Use this to provide context about what the specific job instance is doing.
+     *
+     * @param ctx - Context containing the validated input and variables
+     * @returns Promise resolving to the description string
+     *
+     * @example
+     * ```typescript
+     * description: async (ctx) => `Send email to ${ctx.input.email}`
+     * ```
+     */
+    description?: (ctx: ConcurrencyHandlerContext<TInput, TVariables>) => Promise<string>;
+    /**
+     * The handler function that executes the action logic.
+     * Receives a context object with validated input, variables, logger, and step functions.
+     * Must return a Promise that resolves to the action output (matching the output schema if provided).
+     *
+     * @param ctx - Action handler context with input, variables, and step functions
+     * @returns Promise resolving to the action output
+     *
+     * @example
+     * ```typescript
+     * handler: async (ctx) => {
+     *   const result = await ctx.step('send', async () => {
+     *     return await sendEmail(ctx.input.email, ctx.input.subject)
+     *   })
+     *   return { success: true, messageId: result.id }
+     * }
+     * ```
+     */
+    handler: (ctx: ActionHandlerContext<TInput, TVariables>) => Promise<z.infer<TOutput>>;
+}
+export type ActionDefinition<TInput extends z.ZodObject, TOutput extends z.ZodObject, TVariables = Record<string, unknown>> = ActionDefinitionInput<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>>>;
 export declare const RetryOptionsSchema: z.ZodDefault<z.ZodObject<{
     limit: z.ZodDefault<z.ZodNumber>;
@@ -81,6 +428,7 @@ export declare function createActionDefinitionSchema<TInput extends z.ZodObject,
     }, z.core.$strip>>;
     concurrency: z.ZodDefault<z.ZodNumber>;
     expire: z.ZodDefault<z.ZodNumber>;
+    description: z.ZodOptional<z.ZodCustom<(ctx: ConcurrencyHandlerContext<TInput, TVariables>) => Promise<string>, (ctx: ConcurrencyHandlerContext<TInput, TVariables>) => Promise<string>>>;
     handler: z.ZodCustom<(ctx: ActionHandlerContext<TInput, TVariables>) => Promise<z.infer<TOutput>>, (ctx: ActionHandlerContext<TInput, TVariables>) => Promise<z.infer<TOutput>>>;
 }, z.core.$strip>, z.ZodTransform<{
     checksum: string;
@@ -105,6 +453,7 @@ export declare function createActionDefinitionSchema<TInput extends z.ZodObject,
         groupKey?: ((ctx: ConcurrencyHandlerContext<TInput, TVariables>) => Promise<string>) | undefined;
         concurrency?: ((ctx: ConcurrencyHandlerContext<TInput, TVariables>) => Promise<number>) | undefined;
     } | undefined;
+    description?: ((ctx: ConcurrencyHandlerContext<TInput, TVariables>) => Promise<string>) | undefined;
 }, {
     name: string;
     steps: {
@@ -127,6 +476,7 @@ export declare function createActionDefinitionSchema<TInput extends z.ZodObject,
         groupKey?: ((ctx: ConcurrencyHandlerContext<TInput, TVariables>) => Promise<string>) | undefined;
         concurrency?: ((ctx: ConcurrencyHandlerContext<TInput, TVariables>) => Promise<number>) | undefined;
     } | undefined;
+    description?: ((ctx: ConcurrencyHandlerContext<TInput, TVariables>) => Promise<string>) | undefined;
 }>>;
 export declare const defineAction: <TVariables = Record<string, unknown>>() => <TInput extends z.ZodObject, TOutput extends z.ZodObject>(def: ActionDefinition<TInput, TOutput, TVariables>) => {
     checksum: string;
@@ -151,7 +501,38 @@ export declare const defineAction: <TVariables = Record<string, unknown>>() => <
         groupKey?: ((ctx: ConcurrencyHandlerContext<TInput, TVariables>) => Promise<string>) | undefined;
         concurrency?: ((ctx: ConcurrencyHandlerContext<TInput, TVariables>) => Promise<number>) | undefined;
     } | undefined;
+    description?: ((ctx: ConcurrencyHandlerContext<TInput, TVariables>) => Promise<string>) | 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":"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"}
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../src/action.ts"],"names":[],"mappings":"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"}

package/dist/action.js

@@ -1,5 +1,6 @@
 import * as z from 'zod';
 import generateChecksum from './utils/checksum.js';
+const _checkActionDef = true;
 export const RetryOptionsSchema = z
     .object({
     limit: z.number().default(4),
@@ -7,21 +8,17 @@ export const RetryOptionsSchema = z
     minTimeout: z.number().default(1000),
     maxTimeout: z.number().default(30000),
 })
-    .default({ limit: 4, factor: 2, minTimeout: 1000, maxTimeout: 30000 })
-    .describe('The retry options');
+    .default({ limit: 4, factor: 2, minTimeout: 1000, maxTimeout: 30000 });
 export const StepOptionsSchema = z.object({
     retry: RetryOptionsSchema,
-    expire: z
-        .number()
-        .default(5 * 60 * 1000)
-        .describe('The expire time for the step (milliseconds)'),
-    parallel: z.boolean().default(false).describe('Whether this step runs in parallel (independent from siblings)'),
+    expire: z.number().default(5 * 60 * 1000),
+    parallel: z.boolean().default(false),
 });
 export function createActionDefinitionSchema() {
     return z
         .object({
-        name: z.string().describe('The name of the action'),
-        version: z.string().describe('The version of the action').optional(),
+        name: z.string(),
+        version: z.string().optional(),
         input: z
             .custom((val) => {
             return !val || ('_zod' in val && 'type' in val && val.type === 'object');
@@ -48,28 +45,25 @@ export function createActionDefinitionSchema() {
             .optional(),
         steps: z
             .object({
-            concurrency: z.number().default(100).describe('How many steps can run concurrently for this action'),
-            retry: RetryOptionsSchema.describe('How to retry on failure for the steps of this action'),
-            expire: z
-                .number()
-                .default(5 * 60 * 1000)
-                .describe('How long a step can run for (milliseconds)'),
+            concurrency: z.number().default(100),
+            retry: RetryOptionsSchema,
+            expire: z.number().default(5 * 60 * 1000),
         })
             .default({
             concurrency: 100,
             retry: { limit: 4, factor: 2, minTimeout: 1000, maxTimeout: 30000 },
             expire: 5 * 60 * 1000,
         }),
-        concurrency: z.number().default(100).describe('How many jobs can run concurrently for this action'),
-        expire: z
-            .number()
-            .default(15 * 60 * 1000)
-            .describe('How long a job can run for (milliseconds)'),
-        handler: z
+        concurrency: z.number().default(100),
+        expire: z.number().default(15 * 60 * 1000),
+        description: z
             .custom((val) => {
-            return val instanceof Function;
+            return !val || val instanceof Function;
         })
-            .describe('The handler for the action'),
+            .optional(),
+        handler: z.custom((val) => {
+            return val instanceof Function;
+        }),
     })
         .transform((def) => {
         const checksum = [def.name, def.version, def.handler.toString()].filter(Boolean).join(':');
@@ -86,6 +80,33 @@ export const defineAction = () => {
         });
     };
 };
+/**
+ * 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 const createStep = () => {
     return (def) => {
         return {