glasswork 0.12.2 → 0.13.1

package/dist/jobs/drivers/eventbridge-scheduler-driver.d.ts

@@ -0,0 +1,75 @@
+import type { EnqueueResult, JobMessage } from '../types.js';
+export interface EventBridgeSchedulerConfig {
+    /** AWS region */
+    region: string;
+    /** IAM role ARN that EventBridge Scheduler assumes to send messages to SQS */
+    roleArn: string;
+    /** Optional schedule group name for organization (default: 'default') */
+    scheduleGroupName?: string;
+    /** Custom endpoint (for LocalStack) */
+    endpoint?: string;
+}
+export interface ScheduledJobConfig {
+    /** Target SQS queue URL */
+    queueUrl: string;
+    /** Job message */
+    message: JobMessage;
+    /** When to run the job */
+    scheduledAt: Date;
+}
+/**
+ * Result of scheduling a job with EventBridge Scheduler.
+ */
+export interface ScheduleResult extends EnqueueResult {
+    /** EventBridge Scheduler schedule ARN */
+    scheduleArn: string;
+    /** Schedule name (can be used for cancellation) */
+    scheduleName: string;
+}
+/**
+ * EventBridge Scheduler driver for scheduling jobs with delays longer than 15 minutes.
+ *
+ * Uses one-off schedules with `at()` expressions that target an SQS queue.
+ * Schedules are automatically deleted after execution.
+ */
+export declare class EventBridgeSchedulerDriver {
+    private readonly config;
+    private client;
+    constructor(config: EventBridgeSchedulerConfig);
+    /**
+     * Lazily initialize the Scheduler client.
+     */
+    private getClient;
+    /**
+     * Schedule a job to be executed at a specific time.
+     *
+     * Creates a one-off EventBridge Scheduler schedule that sends a message
+     * to the specified SQS queue at the scheduled time.
+     *
+     * @param config - The scheduled job configuration
+     * @returns Schedule result with ARN and name
+     */
+    scheduleAt(config: ScheduledJobConfig): Promise<ScheduleResult>;
+    /**
+     * Cancel a scheduled job.
+     *
+     * @param scheduleName - The name of the schedule to cancel
+     */
+    cancel(scheduleName: string): Promise<void>;
+    /**
+     * Dispose of the driver and release AWS SDK client resources.
+     * Call this when you're done using the driver to prevent memory leaks.
+     */
+    dispose(): Promise<void>;
+    /**
+     * Convert an SQS queue URL to its ARN.
+     *
+     * Supports both standard AWS and LocalStack URL formats:
+     * - AWS: https://sqs.{region}.amazonaws.com/{accountId}/{queueName}
+     * - LocalStack: http://localhost:4566/{accountId}/{queueName}
+     *
+     * ARN format: arn:aws:sqs:{region}:{accountId}:{queueName}
+     */
+    private sqsArnFromUrl;
+}
+//# sourceMappingURL=eventbridge-scheduler-driver.d.ts.map

package/dist/jobs/drivers/eventbridge-scheduler-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventbridge-scheduler-driver.d.ts","sourceRoot":"","sources":["../../../src/jobs/drivers/eventbridge-scheduler-driver.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAO7D,MAAM,WAAW,0BAA0B;IACzC,iBAAiB;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,OAAO,EAAE,UAAU,CAAC;IACpB,0BAA0B;IAC1B,WAAW,EAAE,IAAI,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,qBAAa,0BAA0B;IAGzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,MAAM,CAAgC;gBAEjB,MAAM,EAAE,0BAA0B;IAE/D;;OAEG;YACW,SAAS;IAWvB;;;;;;;;OAQG;IACG,UAAU,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC;IAsDrE;;;;OAIG;IACG,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYjD;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B;;;;;;;;OAQG;IACH,OAAO,CAAC,aAAa;CAwBtB"}

package/dist/jobs/drivers/eventbridge-scheduler-driver.js

@@ -0,0 +1,135 @@
+import { generateJobId } from '../utils.js';
+/**
+ * EventBridge Scheduler driver for scheduling jobs with delays longer than 15 minutes.
+ *
+ * Uses one-off schedules with `at()` expressions that target an SQS queue.
+ * Schedules are automatically deleted after execution.
+ */
+export class EventBridgeSchedulerDriver {
+    config;
+    client = null;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Lazily initialize the Scheduler client.
+     */
+    async getClient() {
+        if (!this.client) {
+            const { SchedulerClient } = await import('@aws-sdk/client-scheduler');
+            this.client = new SchedulerClient({
+                region: this.config.region,
+                ...(this.config.endpoint && { endpoint: this.config.endpoint }),
+            });
+        }
+        return this.client;
+    }
+    /**
+     * Schedule a job to be executed at a specific time.
+     *
+     * Creates a one-off EventBridge Scheduler schedule that sends a message
+     * to the specified SQS queue at the scheduled time.
+     *
+     * @param config - The scheduled job configuration
+     * @returns Schedule result with ARN and name
+     */
+    async scheduleAt(config) {
+        const client = await this.getClient();
+        const { CreateScheduleCommand } = await import('@aws-sdk/client-scheduler');
+        const jobId = config.message.jobId ?? generateJobId();
+        const scheduleName = `glasswork-${jobId}`;
+        // Format: at(yyyy-mm-ddThh:mm:ss)
+        const scheduleExpression = `at(${config.scheduledAt.toISOString().slice(0, 19)})`;
+        // Build the SQS message payload
+        const messageBody = JSON.stringify({
+            jobName: config.message.jobName,
+            payload: config.message.payload,
+            jobId,
+            metadata: config.message.metadata,
+            enqueuedAt: new Date().toISOString(),
+        });
+        const command = new CreateScheduleCommand({
+            Name: scheduleName,
+            GroupName: this.config.scheduleGroupName ?? 'default',
+            ScheduleExpression: scheduleExpression,
+            ScheduleExpressionTimezone: 'UTC',
+            FlexibleTimeWindow: {
+                Mode: 'OFF',
+            },
+            Target: {
+                Arn: this.sqsArnFromUrl(config.queueUrl),
+                RoleArn: this.config.roleArn,
+                Input: messageBody,
+                SqsParameters: {
+                    MessageGroupId: config.message.queue ?? config.message.jobName,
+                },
+            },
+            // Auto-delete the schedule after it runs
+            ActionAfterCompletion: 'DELETE',
+        });
+        const result = await client.send(command);
+        const scheduleArn = result.ScheduleArn;
+        if (!scheduleArn) {
+            throw new Error('EventBridge Scheduler did not return a schedule ARN');
+        }
+        return {
+            messageId: jobId,
+            jobId,
+            scheduleArn,
+            scheduleName,
+        };
+    }
+    /**
+     * Cancel a scheduled job.
+     *
+     * @param scheduleName - The name of the schedule to cancel
+     */
+    async cancel(scheduleName) {
+        const client = await this.getClient();
+        const { DeleteScheduleCommand } = await import('@aws-sdk/client-scheduler');
+        const command = new DeleteScheduleCommand({
+            Name: scheduleName,
+            GroupName: this.config.scheduleGroupName ?? 'default',
+        });
+        await client.send(command);
+    }
+    /**
+     * Dispose of the driver and release AWS SDK client resources.
+     * Call this when you're done using the driver to prevent memory leaks.
+     */
+    async dispose() {
+        if (this.client) {
+            this.client.destroy();
+            this.client = null;
+        }
+    }
+    /**
+     * Convert an SQS queue URL to its ARN.
+     *
+     * Supports both standard AWS and LocalStack URL formats:
+     * - AWS: https://sqs.{region}.amazonaws.com/{accountId}/{queueName}
+     * - LocalStack: http://localhost:4566/{accountId}/{queueName}
+     *
+     * ARN format: arn:aws:sqs:{region}:{accountId}:{queueName}
+     */
+    sqsArnFromUrl(queueUrl) {
+        const url = new URL(queueUrl);
+        const pathParts = url.pathname.split('/').filter(Boolean);
+        if (pathParts.length < 2) {
+            throw new Error(`Invalid SQS queue URL format: ${queueUrl}`);
+        }
+        const accountId = pathParts[0];
+        const queueName = pathParts[1];
+        // Determine region from URL or fall back to configured region
+        // Standard AWS format: sqs.{region}.amazonaws.com
+        // LocalStack format: localhost:4566 (no region in hostname)
+        let region = this.config.region;
+        const hostParts = url.hostname.split('.');
+        const isAwsUrl = url.hostname.includes('amazonaws.com');
+        if (isAwsUrl && hostParts.length >= 2 && hostParts[0] === 'sqs') {
+            region = hostParts[1];
+        }
+        return `arn:aws:sqs:${region}:${accountId}:${queueName}`;
+    }
+}
+//# sourceMappingURL=eventbridge-scheduler-driver.js.map

package/dist/jobs/drivers/eventbridge-scheduler-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventbridge-scheduler-driver.js","sourceRoot":"","sources":["../../../src/jobs/drivers/eventbridge-scheduler-driver.ts"],"names":[],"mappings":"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"}

package/dist/jobs/drivers/mock-driver.d.ts

@@ -1,4 +1,5 @@
-import type { Duration, EnqueueResult, JobMessage, QueueDriver, ReceivedJob, ReceiveOptions } from '../types.js';
+import type { JobRegistry } from '../job-registry.js';
+import type { Duration, EnqueueResult, JobMessage, QueueDriver } from '../types.js';
 export interface MockEnqueuedJob {
     message: JobMessage & {
         jobId: string;
@@ -7,18 +8,55 @@ export interface MockEnqueuedJob {
     delay?: Duration;
 }
 /**
- * In-memory queue driver for testing.
+ * Configuration for MockQueueDriver.
+ */
+export interface MockQueueDriverConfig {
+    /**
+     * Execute jobs synchronously when enqueued.
+     * Useful for local development to test job handlers immediately.
+     * @default false
+     */
+    executeImmediately?: boolean;
+    /**
+     * Job registry for looking up job definitions.
+     * Required when executeImmediately is true.
+     */
+    registry?: JobRegistry;
+    /**
+     * Resolver to get DI services for job execution.
+     * Called when a job is executed, returning the services container.
+     * Required when executeImmediately is true.
+     */
+    serviceResolver?: () => Record<string, unknown>;
+}
+/**
+ * In-memory queue driver for testing and local development.
+ *
+ * @example Testing mode (default)
+ * ```typescript
+ * const driver = new MockQueueDriver();
+ * await jobService.enqueue(myJob, payload);
+ * expect(driver.enqueued).toHaveLength(1);
+ * ```
+ *
+ * @example Development mode with immediate execution
+ * ```typescript
+ * const driver = new MockQueueDriver({
+ *   executeImmediately: true,
+ *   registry: createJobRegistry([myJob]),
+ *   serviceResolver: () => diContainer,
+ * });
+ * ```
  */
 export declare class MockQueueDriver implements QueueDriver {
     readonly name = "mock";
     private counter;
     private failNext?;
+    private readonly executeImmediately;
+    private readonly registry?;
+    private readonly serviceResolver?;
     readonly enqueued: MockEnqueuedJob[];
-    readonly acks: ReceivedJob[];
-    readonly nacks: Array<{
-        job: ReceivedJob;
-        error?: Error;
-    }>;
+    constructor(config?: MockQueueDriverConfig);
     /**
      * Simulate the next enqueue call failing.
      */
@@ -31,8 +69,5 @@ export declare class MockQueueDriver implements QueueDriver {
     enqueue(message: JobMessage): Promise<EnqueueResult>;
     enqueueAt(message: JobMessage, at: Date): Promise<EnqueueResult>;
     enqueueIn(message: JobMessage, delay: Duration): Promise<EnqueueResult>;
-    receive(_options?: ReceiveOptions): Promise<ReceivedJob[]>;
-    ack(job: ReceivedJob): Promise<void>;
-    nack(job: ReceivedJob, error?: Error): Promise<void>;
 }
 //# sourceMappingURL=mock-driver.d.ts.map

package/dist/jobs/drivers/mock-driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mock-driver.d.ts","sourceRoot":"","sources":["../../../src/jobs/drivers/mock-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,aAAa,EACb,UAAU,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACf,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,UAAU,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,EAAE,CAAC,EAAE,IAAI,CAAC;IACV,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,QAAQ,CAAC,IAAI,UAAU;IACvB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,QAAQ,CAAC,CAAQ;IACzB,QAAQ,CAAC,QAAQ,EAAE,eAAe,EAAE,CAAM;IAC1C,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,CAAM;IAClC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,WAAW,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,CAAC,CAAM;IAEhE;;OAEG;IACH,eAAe,CAAC,KAAK,QAAoC,GAAG,IAAI;IAIhE;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb,IAAI,OAAO,IAAI,eAAe,GAAG,SAAS,CAEzC;IAEK,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;IAoBpD,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC;IAShE,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC;IASvE,OAAO,CAAC,QAAQ,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAO1D,GAAG,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpC,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;CAG3D"}
+{"version":3,"file":"mock-driver.d.ts","sourceRoot":"","sources":["../../../src/jobs/drivers/mock-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAc,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGhG,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,UAAU,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,EAAE,CAAC,EAAE,IAAI,CAAC;IACV,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC;IAEvB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,QAAQ,CAAC,IAAI,UAAU;IACvB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,QAAQ,CAAC,CAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAU;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAgC;IACjE,QAAQ,CAAC,QAAQ,EAAE,eAAe,EAAE,CAAM;gBAE9B,MAAM,GAAE,qBAA0B;IAM9C;;OAEG;IACH,eAAe,CAAC,KAAK,QAAoC,GAAG,IAAI;IAIhE;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb,IAAI,OAAO,IAAI,eAAe,GAAG,SAAS,CAEzC;IAEK,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;IAgCpD,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC;IAShE,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC;CAQ9E"}

package/dist/jobs/drivers/mock-driver.js

@@ -1,14 +1,36 @@
 import { generateJobId } from '../utils.js';
 /**
- * In-memory queue driver for testing.
+ * In-memory queue driver for testing and local development.
+ *
+ * @example Testing mode (default)
+ * ```typescript
+ * const driver = new MockQueueDriver();
+ * await jobService.enqueue(myJob, payload);
+ * expect(driver.enqueued).toHaveLength(1);
+ * ```
+ *
+ * @example Development mode with immediate execution
+ * ```typescript
+ * const driver = new MockQueueDriver({
+ *   executeImmediately: true,
+ *   registry: createJobRegistry([myJob]),
+ *   serviceResolver: () => diContainer,
+ * });
+ * ```
  */
 export class MockQueueDriver {
     name = 'mock';
     counter = 0;
     failNext;
+    executeImmediately;
+    registry;
+    serviceResolver;
     enqueued = [];
-    acks = [];
-    nacks = [];
+    constructor(config = {}) {
+        this.executeImmediately = config.executeImmediately ?? false;
+        this.registry = config.registry;
+        this.serviceResolver = config.serviceResolver;
+    }
     /**
      * Simulate the next enqueue call failing.
      */
@@ -20,8 +42,6 @@ export class MockQueueDriver {
      */
     clear() {
         this.enqueued.length = 0;
-        this.acks.length = 0;
-        this.nacks.length = 0;
         this.counter = 0;
         this.failNext = undefined;
     }
@@ -42,6 +62,17 @@ export class MockQueueDriver {
         this.enqueued.push({
             message: { ...message, jobId },
         });
+        // Execute immediately if configured
+        if (this.executeImmediately && this.registry && this.serviceResolver) {
+            const job = this.registry.getOrThrow(message.jobName);
+            const context = {
+                services: this.serviceResolver(),
+                jobId,
+                attemptNumber: 1,
+                enqueuedAt: new Date(),
+            };
+            await job.handler(message.payload, context);
+        }
         return result;
     }
     async enqueueAt(message, at) {
@@ -60,17 +91,5 @@ export class MockQueueDriver {
         }
         return result;
     }
-    async receive(_options) {
-        return this.enqueued.map(({ message }) => ({
-            message,
-            receiptHandle: message.jobId,
-        }));
-    }
-    async ack(job) {
-        this.acks.push(job);
-    }
-    async nack(job, error) {
-        this.nacks.push({ job, error });
-    }
 }
 //# sourceMappingURL=mock-driver.js.map

package/dist/jobs/drivers/mock-driver.js.map

@@ -1 +1 @@
-{"version":3,"file":"mock-driver.js","sourceRoot":"","sources":["../../../src/jobs/drivers/mock-driver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mock-driver.js","sourceRoot":"","sources":["../../../src/jobs/drivers/mock-driver.ts"],"names":[],"mappings":"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"}

package/dist/jobs/drivers/sqs-driver.d.ts

@@ -1,5 +1,6 @@
 import type { SQSClient as SQSClientType } from '@aws-sdk/client-sqs';
-import type { Duration, EnqueueResult, JobMessage, QueueDriver, ReceivedJob, ReceiveOptions } from '../types.js';
+import type { Duration, EnqueueResult, JobMessage, QueueDriver } from '../types.js';
+import { type EventBridgeSchedulerConfig } from './eventbridge-scheduler-driver.js';
 export interface SQSDriverConfig {
     /** AWS region */
     region: string;
@@ -10,43 +11,49 @@ export interface SQSDriverConfig {
     /** Custom endpoint (for LocalStack) */
     endpoint?: string;
     /**
-     * DynamoDB table for scheduled jobs (used when longDelayStrategy is "dynamodb").
-     * Not required when using the default self-rescheduling strategy.
+     * EventBridge Scheduler configuration for delays over 15 minutes.
+     * Required when using enqueueAt or enqueueIn with delays exceeding SQS maximum.
      */
-    schedulerTable?: string;
-    /**
-     * Strategy for delays over 15 minutes (SQS maximum).
-     * - "self-reschedule" (default): the job re-enqueues itself in 15-minute slices until due.
-     * - "dynamodb": store in DynamoDB and poll via the scheduler Lambda.
-     */
-    longDelayStrategy?: 'self-reschedule' | 'dynamodb';
+    scheduler?: EventBridgeSchedulerConfig;
     /** Optional pre-configured SQS client */
     client?: SQSClientType;
 }
 /**
- * AWS SQS queue driver (Phase 1: enqueue only).
+ * AWS SQS queue driver with EventBridge Scheduler support for long delays.
+ *
+ * For delays up to 15 minutes, uses native SQS delay.
+ * For delays over 15 minutes, uses EventBridge Scheduler to create a one-off
+ * schedule that sends the job to SQS at the specified time.
  */
 export declare class SQSQueueDriver implements QueueDriver {
     private readonly config;
     readonly name = "sqs";
+    readonly defaultQueue: string;
     private client;
-    private schedulerClientPromise;
+    private schedulerDriver;
+    private disposed;
     constructor(config: SQSDriverConfig);
     /**
      * Lazily initialize the SQS client.
+     * @throws Error if the driver has been disposed
      */
     private getClient;
     enqueue(message: JobMessage): Promise<EnqueueResult>;
     enqueueAt(message: JobMessage, at: Date): Promise<EnqueueResult>;
     enqueueIn(message: JobMessage, delay: Duration): Promise<EnqueueResult>;
-    receive(_options?: ReceiveOptions): Promise<ReceivedJob[]>;
-    ack(_job: ReceivedJob): Promise<void>;
-    nack(_job: ReceivedJob): Promise<void>;
+    /**
+     * Cancel a scheduled job. Only works for jobs scheduled with EventBridge Scheduler.
+     *
+     * @param scheduleName - The schedule name from the ScheduleResult
+     */
+    cancelSchedule(scheduleName: string): Promise<void>;
+    /**
+     * Dispose of the driver and release AWS SDK client resources.
+     * Call this when you're done using the driver to prevent memory leaks.
+     */
+    dispose(): Promise<void>;
     private getQueueUrl;
     private enqueueWithDelay;
-    private scheduleLongDelay;
-    private scheduleJobWithSelfReschedule;
-    private scheduleJobWithDynamo;
-    private getSchedulerClient;
+    private scheduleWithEventBridge;
 }
 //# sourceMappingURL=sqs-driver.d.ts.map

package/dist/jobs/drivers/sqs-driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqs-driver.d.ts","sourceRoot":"","sources":["../../../src/jobs/drivers/sqs-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,SAAS,IAAI,aAAa,EAC3B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EACV,QAAQ,EACR,aAAa,EACb,UAAU,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACf,MAAM,aAAa,CAAC;AAMrB,MAAM,WAAW,eAAe;IAC9B,iBAAiB;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,yBAAyB;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,UAAU,CAAC;IACnD,yCAAyC;IACzC,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,cAAe,YAAW,WAAW;IAKpC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,QAAQ,CAAC,IAAI,SAAS;IACtB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,sBAAsB,CAAiC;gBAElC,MAAM,EAAE,eAAe;IAMpD;;OAEG;YACW,SAAS;IAWjB,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;IAqCpD,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC;IAWhE,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC;IASvE,OAAO,CAAC,QAAQ,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAI1D,GAAG,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrC,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,OAAO,CAAC,WAAW;YASL,gBAAgB;YAyChB,iBAAiB;YASjB,6BAA6B;YAyB7B,qBAAqB;YAgCrB,kBAAkB;CAqBjC"}
+{"version":3,"file":"sqs-driver.d.ts","sourceRoot":"","sources":["../../../src/jobs/drivers/sqs-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,SAAS,IAAI,aAAa,EAC3B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEpF,OAAO,EACL,KAAK,0BAA0B,EAGhC,MAAM,mCAAmC,CAAC;AAK3C,MAAM,WAAW,eAAe;IAC9B,iBAAiB;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,yBAAyB;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,0BAA0B,CAAC;IACvC,yCAAyC;IACzC,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;;;;;GAMG;AACH,qBAAa,cAAe,YAAW,WAAW;IAOpC,OAAO,CAAC,QAAQ,CAAC,MAAM;IANnC,QAAQ,CAAC,IAAI,SAAS;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,eAAe,CAA2C;IAClE,OAAO,CAAC,QAAQ,CAAS;gBAEI,MAAM,EAAE,eAAe;IAUpD;;;OAGG;YACW,SAAS;IAcjB,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;IAqCpD,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC;IAWhE,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC;IAS7E;;;;OAIG;IACG,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzD;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAW9B,OAAO,CAAC,WAAW;YASL,gBAAgB;YAyChB,uBAAuB;CAgBtC"}