glasswork 0.12.2 → 0.13.1

package/dist/jobs/types.d.ts

@@ -6,19 +6,41 @@ import type { Logger } from '../utils/logger.js';
 export type Duration = string | number;
 /**
  * Retry configuration for jobs.
- * Phase 1 does not implement retries but the shape is defined for forward compatibility.
+ *
+ * Glasswork relies on SQS visibility timeout for retry timing, but this
+ * configuration influences how the worker handles failures and determines
+ * when a job should be considered "dead" (retries exhausted).
+ *
+ * @example
+ * ```typescript
+ * // Default: 25 retries, send to DLQ
+ * defineJob({ name: 'my-job', handler: ... })
+ *
+ * // Custom retry count
+ * defineJob({ name: 'my-job', retry: { maxAttempts: 5 }, handler: ... })
+ *
+ * // No retries, discard on failure
+ * defineJob({ name: 'my-job', retry: false, handler: ... })
+ *
+ * // Retry but don't save to DLQ
+ * defineJob({ name: 'my-job', retry: { maxAttempts: 10, dead: false }, handler: ... })
+ * ```
  */
 export interface RetryConfig {
-    /** Maximum retry attempts (default: 3) */
+    /**
+     * Maximum number of retries before the job is considered dead.
+     * The default is 25 retries.
+     *
+     * @default 25
+     */
     maxAttempts?: number;
-    /** Backoff strategy (default: exponential) */
-    backoff?: 'exponential' | 'linear' | 'fixed';
-    /** Initial delay between retries (default: 30s) */
-    initialDelay?: Duration;
-    /** Maximum delay cap (default: 1h) */
-    maxDelay?: Duration;
-    /** Whether to apply jitter to backoff timing (default: true) */
-    jitter?: boolean;
+    /**
+     * Whether to save failed jobs to the dead letter queue after exhausting retries.
+     * If false, jobs will be discarded (not re-thrown to SQS) after max attempts.
+     *
+     * @default true
+     */
+    dead?: boolean;
 }
 /**
  * Execution context passed to job handlers.
@@ -55,8 +77,15 @@ export interface JobDefinition<TPayload> {
     deadLetterQueue?: string;
     /** Optional payload schema for validation */
     schema?: BaseSchema<TPayload, TPayload, BaseIssue<unknown>>;
-    /** Retry behavior (future phases) */
-    retry?: RetryConfig;
+    /**
+     * Retry configuration for this job.
+     *
+     * - `undefined`: Default (25 retries, send to DLQ)
+     * - `number`: Shorthand for { maxAttempts: N }
+     * - `false`: Disable retries (discard on first failure)
+     * - `RetryConfig`: Full configuration object
+     */
+    retry?: RetryConfig | number | false;
     /**
      * Optional uniqueness constraint. Intended for FIFO queues.
      * The deduplication key should be stable for the same logical job.
@@ -69,6 +98,22 @@ export interface JobDefinition<TPayload> {
     /** Handler invoked by the worker */
     handler: JobHandler<TPayload>;
 }
+/**
+ * Type-erased job definition for use in module registration.
+ *
+ * Use this type when registering jobs in modules to avoid the awkward
+ * `as JobDefinition<unknown>` cast. This works because module registration
+ * only needs to access the `name` property and invoke the handler dynamically.
+ *
+ * @example
+ * ```typescript
+ * // In your module:
+ * export const MyModule = defineModule({
+ *   jobs: [myJob], // No cast needed!
+ * });
+ * ```
+ */
+export type AnyJobDefinition = JobDefinition<any>;
 /**
  * Job message sent to a queue.
  */
@@ -93,32 +138,6 @@ export interface EnqueueResult {
     /** Generated or provided job ID */
     jobId: string;
 }
-/**
- * Options for receiving jobs from a queue.
- */
-export interface ReceiveOptions {
-    /** Queue name to poll */
-    queue?: string;
-    /** Visibility timeout in seconds */
-    visibilityTimeout?: number;
-    /** Maximum number of messages to receive */
-    maxMessages?: number;
-    /** Long polling wait time in seconds */
-    waitTimeSeconds?: number;
-}
-/**
- * Job representation when received from a driver.
- */
-export interface ReceivedJob {
-    /** Parsed message */
-    message: JobMessage & {
-        jobId: string;
-    };
-    /** Driver-specific receipt handle */
-    receiptHandle?: string;
-    /** Raw driver payload */
-    raw?: unknown;
-}
 /**
  * Queue driver interface.
  *
@@ -128,6 +147,8 @@ export interface ReceivedJob {
 export interface QueueDriver {
     /** Driver name for logging/debugging */
     readonly name: string;
+    /** Default queue name resolved by the driver (optional) */
+    readonly defaultQueue?: string;
     /**
      * Enqueue a job for immediate processing.
      */
@@ -140,17 +161,5 @@ export interface QueueDriver {
      * Enqueue a job for processing after a delay.
      */
     enqueueIn?(message: JobMessage, delay: Duration): Promise<EnqueueResult>;
-    /**
-     * Receive jobs from the queue (for worker processing).
-     */
-    receive?(options?: ReceiveOptions): Promise<ReceivedJob[]>;
-    /**
-     * Acknowledge successful job completion.
-     */
-    ack?(job: ReceivedJob): Promise<void>;
-    /**
-     * Reject a job (will be retried or sent to DLQ).
-     */
-    nack?(job: ReceivedJob, error?: Error): Promise<void>;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/jobs/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/jobs/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvC;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC7C,mDAAmD;IACnD,YAAY,CAAC,EAAE,QAAQ,CAAC;IACxB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,gEAAgE;IAChE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,UAAU,EAAE,IAAI,CAAC;IACjB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,QAAQ,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEpG;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,QAAQ;IACrC,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5D,qCAAqC;IACrC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE;QACP,GAAG,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,MAAM,CAAC;QACnC,oEAAoE;QACpE,MAAM,CAAC,EAAE,QAAQ,CAAC;KACnB,CAAC;IACF,oCAAoC;IACpC,OAAO,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,qBAAqB;IACrB,OAAO,EAAE,UAAU,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,qCAAqC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yBAAyB;IACzB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAErD;;OAEG;IACH,SAAS,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAElE;;OAEG;IACH,SAAS,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEzE;;OAEG;IACH,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAE3D;;OAEG;IACH,GAAG,CAAC,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtC;;OAEG;IACH,IAAI,CAAC,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/jobs/types.ts"],"names":[],"mappings":"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"}

package/dist/jobs/utils.d.ts

@@ -12,13 +12,4 @@ export declare function calculatePayloadSizeBytes(payload: unknown): number;
  * Supports number (seconds) or string like "5m", "30s", "1h", "1d".
  */
 export declare function durationToSeconds(duration: Duration): number;
-/**
- * Simple exponential backoff with optional jitter.
- */
-export declare function computeBackoffSeconds(attemptNumber: number, config: {
-    baseDelaySeconds: number;
-    maxDelaySeconds?: number;
-    strategy?: 'exponential' | 'linear' | 'fixed';
-    jitter?: boolean;
-}): number;
 //# sourceMappingURL=utils.d.ts.map

package/dist/jobs/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/jobs/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAKtC;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAIlE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CA2B5D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE;IACN,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GACA,MAAM,CAoBR"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/jobs/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAKtC;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAKlE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CA2B5D"}

package/dist/jobs/utils.js

@@ -12,8 +12,9 @@ export function generateJobId() {
  * Calculate the size of a payload once serialized.
  */
 export function calculatePayloadSizeBytes(payload) {
-    const serialized = JSON.stringify(payload);
-    const encoded = new TextEncoder().encode(serialized ?? 'null');
+    // JSON.stringify(undefined) returns undefined, not a string
+    const serialized = payload === undefined ? 'null' : JSON.stringify(payload);
+    const encoded = new TextEncoder().encode(serialized);
     return encoded.length;
 }
 /**
@@ -45,25 +46,4 @@ export function durationToSeconds(duration) {
             throw new Error(`Unsupported duration unit: "${unit}"`);
     }
 }
-/**
- * Simple exponential backoff with optional jitter.
- */
-export function computeBackoffSeconds(attemptNumber, config) {
-    const { baseDelaySeconds, maxDelaySeconds, strategy = 'exponential', jitter = true } = config;
-    let delay = baseDelaySeconds;
-    if (strategy === 'exponential') {
-        delay = baseDelaySeconds * 2 ** (attemptNumber - 1);
-    }
-    else if (strategy === 'linear') {
-        delay = baseDelaySeconds * attemptNumber;
-    }
-    if (maxDelaySeconds) {
-        delay = Math.min(delay, maxDelaySeconds);
-    }
-    if (jitter) {
-        const random = Math.random();
-        delay = delay * (0.5 + random / 2); // between 0.5x and 1x
-    }
-    return Math.max(0, Math.floor(delay));
-}
 //# sourceMappingURL=utils.js.map

package/dist/jobs/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/jobs/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,OAAO,UAAU,KAAK,UAAU,EAAE,CAAC;QACrC,OAAO,UAAU,EAAE,CAAC;IACtB,CAAC;IACD,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,CAAC;IAC/D,OAAO,OAAO,CAAC,MAAM,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAkB;IAClD,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,6BAA6B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,GAAG,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAEpC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,GAAG,CAAC;QACT,KAAK,EAAE;YACL,OAAO,KAAK,CAAC;QACf,KAAK,GAAG;YACN,OAAO,KAAK,GAAG,EAAE,CAAC;QACpB,KAAK,GAAG;YACN,OAAO,KAAK,GAAG,EAAE,GAAG,EAAE,CAAC;QACzB,KAAK,GAAG;YACN,OAAO,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QAC9B;YACE,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAI,GAAG,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,aAAqB,EACrB,MAKC;IAED,MAAM,EAAE,gBAAgB,EAAE,eAAe,EAAE,QAAQ,GAAG,aAAa,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IAE9F,IAAI,KAAK,GAAG,gBAAgB,CAAC;IAC7B,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;QAC/B,KAAK,GAAG,gBAAgB,GAAG,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;IACtD,CAAC;SAAM,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,KAAK,GAAG,gBAAgB,GAAG,aAAa,CAAC;IAC3C,CAAC;IAED,IAAI,eAAe,EAAE,CAAC;QACpB,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC7B,KAAK,GAAG,KAAK,GAAG,CAAC,GAAG,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,sBAAsB;IAC5D,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AACxC,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/jobs/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,OAAO,UAAU,KAAK,UAAU,EAAE,CAAC;QACrC,OAAO,UAAU,EAAE,CAAC;IACtB,CAAC;IACD,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,4DAA4D;IAC5D,MAAM,UAAU,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACrD,OAAO,OAAO,CAAC,MAAM,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAkB;IAClD,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,6BAA6B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,GAAG,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAEpC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,GAAG,CAAC;QACT,KAAK,EAAE;YACL,OAAO,KAAK,CAAC;QACf,KAAK,GAAG;YACN,OAAO,KAAK,GAAG,EAAE,CAAC;QACpB,KAAK,GAAG;YACN,OAAO,KAAK,GAAG,EAAE,GAAG,EAAE,CAAC;QACzB,KAAK,GAAG;YACN,OAAO,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QAC9B;YACE,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAI,GAAG,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC"}

package/dist/jobs/worker.d.ts

@@ -1,7 +1,7 @@
 import type { Context, EventBridgeEvent, SQSEvent } from 'aws-lambda';
 import type { ModuleConfig } from '../core/types.js';
 import { type Logger } from '../utils/logger.js';
-import type { JobContext, QueueDriver } from './types.js';
+import type { JobContext } from './types.js';
 interface WorkerHooks {
     onJobStart?: (job: JobExecution, context: JobContext) => Promise<void> | void;
     onJobComplete?: (job: JobExecution, context: JobContext) => Promise<void> | void;
@@ -10,7 +10,6 @@ interface WorkerHooks {
 }
 export interface WorkerConfig {
     module: ModuleConfig;
-    driver?: QueueDriver;
     hooks?: WorkerHooks;
     logger?: Logger;
 }
@@ -25,7 +24,7 @@ export interface JobExecution {
 /**
  * Bootstrap a worker Lambda handler for processing jobs.
  */
-export declare function bootstrapWorker(config: WorkerConfig): (event: SQSEvent | EventBridgeEvent<string, unknown> | Record<string, unknown>, _ctx?: Context) => Promise<{
+export declare function bootstrapWorker(config: WorkerConfig): (event: SQSEvent | EventBridgeEvent<string, unknown> | Record<string, unknown>, ctx?: Context) => Promise<{
     batchItemFailures: import("aws-lambda").SQSBatchItemFailure[];
     success?: undefined;
 } | {

package/dist/jobs/worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/jobs/worker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAoB,QAAQ,EAAa,MAAM,YAAY,CAAC;AAGnG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAI/D,OAAO,KAAK,EAAE,UAAU,EAAiB,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzE,UAAU,WAAW;IACnB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9E,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACjF,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7F,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAClG;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,IAAI,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAUD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,IAKhD,OAAO,QAAQ,GAAG,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7E,OAAO,OAAO;;;;;;GA4CjB"}
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/jobs/worker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAoB,QAAQ,EAAa,MAAM,YAAY,CAAC;AAGnG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAQ/D,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,YAAY,CAAC;AAmB1D,UAAU,WAAW;IACnB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9E,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACjF,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7F,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAClG;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,IAAI,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AASD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,IAKhD,OAAO,QAAQ,GAAG,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7E,MAAM,OAAO;;;;;;GA8ChB"}

package/dist/jobs/worker.js

@@ -1,17 +1,31 @@
 import { asValue, createContainer, InjectionMode } from 'awilix';
-import { safeParse } from 'valibot';
+import { object, optional, record, safeParse, string, unknown } from 'valibot';
 import { collectModules, registerModuleProviders, validateNoCycles } from '../core/bootstrap.js';
 import { createLogger } from '../utils/logger.js';
-import { InvalidJobPayloadError, PermanentJobError, TransientJobError } from './errors.js';
+import { InvalidJobPayloadError, PermanentJobError, RetryExhaustedError, TransientJobError, } from './errors.js';
 import { createJobRegistry } from './job-registry.js';
-import { MAX_SQS_DELAY_SECONDS, RUN_AT_METADATA_KEY } from './schedule-constants.js';
+import { generateJobId } from './utils.js';
+/**
+ * Default maximum retry attempts before a job is considered dead.
+ */
+const DEFAULT_MAX_ATTEMPTS = 25;
+/**
+ * Valibot schema for validating SQS job message structure.
+ */
+const JobMessageSchema = object({
+    jobName: string(),
+    payload: optional(unknown()),
+    jobId: optional(string()),
+    enqueuedAt: optional(string()),
+    metadata: optional(record(string(), string())),
+});
 /**
  * Bootstrap a worker Lambda handler for processing jobs.
  */
 export function bootstrapWorker(config) {
     const logger = config.logger ?? createLogger('JobsWorker');
     const statePromise = buildWorkerState(config.module, logger);
-    return async (event, _ctx) => {
+    return async (event, ctx) => {
         const { container, registry } = await statePromise;
         if (isSQSEvent(event)) {
             const batchItemFailures = [];
@@ -22,7 +36,6 @@ export function bootstrapWorker(config) {
                         moduleContainer: container,
                         hooks: config.hooks,
                         logger,
-                        driver: config.driver,
                     });
                 }
                 catch (_error) {
@@ -37,13 +50,15 @@ export function bootstrapWorker(config) {
         if (!jobName) {
             throw new Error('Job name is required for non-SQS invocation');
         }
+        // Extract attempt number from Lambda context retry metadata if available
+        const attemptNumber = extractAttemptNumber(ctx);
         await executeJob({
             jobName,
-            jobId: 'event',
+            jobId: `eb-${generateJobId()}`,
             payload,
-            attemptNumber: 1,
+            attemptNumber,
             enqueuedAt: new Date(),
-        }, { registry, moduleContainer: container, hooks: config.hooks, logger, driver: config.driver });
+        }, { registry, moduleContainer: container, hooks: config.hooks, logger });
         return { success: true };
     };
 }
@@ -104,17 +119,23 @@ async function processRecord(record, context) {
     if (!parsed || typeof parsed !== 'object') {
         throw new Error('Invalid job message payload');
     }
+    // Validate message structure using Valibot
+    const validationResult = safeParse(JobMessageSchema, parsed);
+    if (!validationResult.success) {
+        context.logger.error('Invalid job message structure', {
+            messageId: record.messageId,
+            issues: validationResult.issues,
+        });
+        throw new Error('Invalid job message structure');
+    }
     const parsedMessage = parsed;
     const jobName = parsedMessage.jobName;
     const payload = parsedMessage.payload;
     const jobId = parsedMessage.jobId ?? record.messageId;
     const enqueuedAt = parsedMessage.enqueuedAt ? new Date(parsedMessage.enqueuedAt) : new Date();
     const metadata = parsedMessage.metadata;
-    if (!jobName) {
-        throw new Error('Job name is required');
-    }
     const attemptNumber = record.attributes?.ApproximateReceiveCount
-        ? Number.parseInt(record.attributes.ApproximateReceiveCount, 10)
+        ? Number.parseInt(record.attributes.ApproximateReceiveCount, 10) || 1
         : 1;
     const execution = {
         jobId,
@@ -128,18 +149,11 @@ async function processRecord(record, context) {
 }
 async function executeJob(execution, context) {
     const job = context.registry.getOrThrow(execution.jobName);
-    if (await rescheduleIfNotDue(execution, job, context)) {
-        return;
-    }
+    // Normalize retry configuration
+    const retryConfig = normalizeRetryConfig(job.retry);
     const scope = context.moduleContainer.createScope();
     const services = scope.cradle;
-    let jobLogger = context.logger;
-    if (context.moduleContainer.hasRegistration('logger')) {
-        const baseLogger = context.moduleContainer.resolve('logger');
-        jobLogger = baseLogger?.child
-            ? baseLogger.child({ jobId: execution.jobId, jobName: execution.jobName })
-            : baseLogger;
-    }
+    const jobLogger = resolveJobLogger(context, execution);
     const jobContext = {
         services,
         jobId: execution.jobId,
@@ -159,85 +173,151 @@ async function executeJob(execution, context) {
         await context.hooks?.onJobComplete?.(execution, jobContext);
     }
     catch (error) {
-        const err = error;
-        await context.hooks?.onJobFailed?.(execution, jobContext, err);
-        if (err instanceof PermanentJobError) {
-            jobLogger?.error('Job permanently failed', { err });
-            await context.hooks?.onJobDeadLetter?.(execution, jobContext, err);
-            return;
-        }
-        if (err instanceof InvalidJobPayloadError) {
-            jobLogger?.warn('Invalid job payload, retrying until DLQ', {
-                err,
-                jobName: execution.jobName,
-                jobId: execution.jobId,
-                attemptNumber: execution.attemptNumber,
-            });
-            throw err;
-        }
-        if (err instanceof TransientJobError) {
-            jobLogger?.warn('Job transient failure, retrying', { err, retryAfter: err.retryAfter });
-        }
-        throw err;
+        await handleJobError(error, execution, jobContext, context, retryConfig, jobLogger);
     }
     finally {
         await scope.dispose();
     }
 }
-async function rescheduleIfNotDue(execution, job, context) {
-    const runAtValue = execution.metadata?.[RUN_AT_METADATA_KEY];
-    if (!runAtValue) {
-        return false;
+/**
+ * Resolve the logger for job execution, scoped to the job if possible.
+ */
+function resolveJobLogger(context, execution) {
+    if (!context.moduleContainer.hasRegistration('logger')) {
+        return context.logger;
+    }
+    const baseLogger = context.moduleContainer.resolve('logger');
+    return baseLogger?.child
+        ? baseLogger.child({ jobId: execution.jobId, jobName: execution.jobName })
+        : baseLogger;
+}
+/**
+ * Handle job execution errors with retry logic.
+ */
+async function handleJobError(err, execution, jobContext, context, retryConfig, jobLogger) {
+    const { maxAttempts, dead: sendToDead } = retryConfig;
+    // PermanentJobError: Never retry, go straight to DLQ
+    if (err instanceof PermanentJobError) {
+        jobLogger?.error('Job permanently failed', { err });
+        await context.hooks?.onJobFailed?.(execution, jobContext, err);
+        await context.hooks?.onJobDeadLetter?.(execution, jobContext, err);
+        throw err;
     }
-    const runAt = new Date(runAtValue);
-    if (Number.isNaN(runAt.getTime())) {
-        context.logger.warn('Ignoring invalid runAt metadata; executing immediately', {
+    // No retries configured: discard the job silently
+    if (maxAttempts === false) {
+        jobLogger?.warn('Job failed with retries disabled, discarding', {
+            err,
             jobName: execution.jobName,
             jobId: execution.jobId,
-            runAt: runAtValue,
         });
-        return false;
+        await context.hooks?.onJobFailed?.(execution, jobContext, err);
+        // Return without throwing to acknowledge and discard the message
+        return undefined;
     }
-    const remainingMs = runAt.getTime() - Date.now();
-    if (remainingMs <= 1000) {
-        return false;
+    // Check if retries are exhausted
+    if (execution.attemptNumber >= maxAttempts) {
+        return handleExhaustedRetries(err, execution, jobContext, context, maxAttempts, sendToDead, jobLogger);
     }
-    const driver = context.driver;
-    if (!driver || (!driver.enqueueIn && !driver.enqueueAt)) {
-        context.logger.warn('Job scheduled in future but worker has no driver; executing now', {
+    // Normal failure: log and throw to trigger SQS retry
+    await context.hooks?.onJobFailed?.(execution, jobContext, err);
+    logRetryableError(err, execution, maxAttempts, jobLogger);
+    throw err;
+}
+/**
+ * Handle the case when all retries are exhausted.
+ */
+async function handleExhaustedRetries(err, execution, jobContext, context, maxAttempts, sendToDead, jobLogger) {
+    const exhaustedError = new RetryExhaustedError(execution.jobName, execution.attemptNumber, maxAttempts, err);
+    jobLogger?.error('Job retries exhausted', {
+        err,
+        attemptNumber: execution.attemptNumber,
+        maxAttempts,
+        cause: err.message,
+    });
+    await context.hooks?.onJobFailed?.(execution, jobContext, err);
+    await context.hooks?.onJobDeadLetter?.(execution, jobContext, exhaustedError);
+    if (!sendToDead) {
+        jobLogger?.info('Job discarded (dead: false)', {
             jobName: execution.jobName,
             jobId: execution.jobId,
-            runAt: runAtValue,
         });
-        return false;
+        // Return without throwing to discard
+        return undefined;
     }
-    const delaySeconds = Math.min(MAX_SQS_DELAY_SECONDS, Math.max(1, Math.floor(remainingMs / 1000)));
-    const message = {
-        jobName: job.name,
-        payload: execution.payload,
-        queue: job.queue,
-        jobId: execution.jobId,
-        metadata: {
-            ...execution.metadata,
-            [RUN_AT_METADATA_KEY]: runAtValue,
-        },
-    };
-    if (driver.enqueueIn) {
-        await driver.enqueueIn(message, delaySeconds);
+    throw exhaustedError;
+}
+/**
+ * Log a retriable error with appropriate context.
+ */
+function logRetryableError(err, execution, maxAttempts, jobLogger) {
+    if (err instanceof InvalidJobPayloadError) {
+        jobLogger?.warn('Invalid job payload, retrying until DLQ', {
+            err,
+            jobName: execution.jobName,
+            jobId: execution.jobId,
+            attemptNumber: execution.attemptNumber,
+            maxAttempts,
+        });
     }
-    else if (driver.enqueueAt) {
-        await driver.enqueueAt(message, runAt);
+    else if (err instanceof TransientJobError) {
+        jobLogger?.warn('Job transient failure, retrying', {
+            err,
+            retryAfter: err.retryAfter,
+            attemptNumber: execution.attemptNumber,
+            maxAttempts,
+        });
+    }
+    else {
+        jobLogger?.warn('Job failed, will retry', {
+            err,
+            attemptNumber: execution.attemptNumber,
+            maxAttempts,
+            remainingAttempts: maxAttempts - execution.attemptNumber,
+        });
     }
-    context.logger.info('Deferred job that is not due yet', {
-        jobName: execution.jobName,
-        jobId: execution.jobId,
-        runAt: runAtValue,
-        delaySeconds,
-    });
-    return true;
 }
+/**
+ * Normalize retry configuration to a consistent format.
+ * Zero or negative maxAttempts are treated as "no retries" (same as retry: false).
+ */
+function normalizeRetryConfig(config) {
+    if (config === false) {
+        return { maxAttempts: false, dead: false };
+    }
+    if (typeof config === 'number') {
+        // Treat zero or negative as "no retries"
+        if (config <= 0) {
+            return { maxAttempts: false, dead: false };
+        }
+        return { maxAttempts: config, dead: true };
+    }
+    if (config === undefined) {
+        return { maxAttempts: DEFAULT_MAX_ATTEMPTS, dead: true };
+    }
+    // Handle object config with potential invalid maxAttempts
+    const maxAttempts = config.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;
+    if (maxAttempts <= 0) {
+        return { maxAttempts: false, dead: false };
+    }
+    return {
+        maxAttempts,
+        dead: config.dead ?? true,
+    };
+}
+/**
+ * Type guard to check if an event is an SQS event.
+ * Validates presence of Records array with SQS-specific properties.
+ */
 function isSQSEvent(event) {
-    return Boolean(event?.Records);
+    const maybeEvent = event;
+    if (!Array.isArray(maybeEvent?.Records) || maybeEvent.Records.length === 0) {
+        return false;
+    }
+    const firstRecord = maybeEvent.Records[0];
+    // Check for SQS-specific properties to distinguish from other AWS event types
+    return (typeof firstRecord.messageId === 'string' &&
+        typeof firstRecord.body === 'string' &&
+        typeof firstRecord.receiptHandle === 'string');
 }
 function extractJobName(event) {
     if (typeof event.jobName === 'string')
@@ -257,4 +337,25 @@ function extractPayload(event) {
         return detail.payload;
     return undefined;
 }
+/**
+ * Extract attempt number from Lambda context.
+ * For EventBridge retries, checks for retry metadata in the context.
+ */
+function extractAttemptNumber(ctx) {
+    if (!ctx)
+        return 1;
+    // EventBridge retry information may be available in client context
+    // or through environment variables in some configurations
+    try {
+        const clientContext = ctx
+            .clientContext;
+        if (clientContext?.custom?.retryAttempt !== undefined) {
+            return clientContext.custom.retryAttempt + 1;
+        }
+    }
+    catch {
+        // Ignore parsing errors
+    }
+    return 1;
+}
 //# sourceMappingURL=worker.js.map