@nebutra/queue 0.1.4 → 3.0.0

package/README.md

@@ -1,8 +1,8 @@
-> **Status: Foundation** — Type definitions, factory pattern, and provider stubs are complete. The in-memory provider exposes a test-only dead-letter queue, BullMQ exposes retry-exhausted failed jobs, and QStash can map records returned by an injected DLQ fetcher into the shared dead-letter contract.
+> **Status: Foundation** — Type definitions, factory pattern, and provider stubs are complete. The in-memory provider exposes a test-only dead-letter queue, and QStash can map records returned by an injected DLQ fetcher into the shared dead-letter contract.
 
 # @nebutra/queue
 
-Provider-agnostic message queue with support for **Upstash QStash** (serverless) and **BullMQ** (self-hosted Redis).
+Single-provider message queue: **Upstash QStash** (serverless) in production, with an in-memory fallback for local dev and tests.
 
 ## Quick Start
 
@@ -96,8 +96,7 @@ The factory auto-detects the provider:
 |----------|-------------------------------|------------|
 | 1        | `QUEUE_PROVIDER` env var set  | As specified |
 | 2        | `QSTASH_TOKEN` exists         | `qstash`   |
-| 3        | `REDIS_URL` exists            | `bullmq`   |
-| 4        | Fallback                      | `memory`   |
+| 3        | Fallback                      | `memory`   |
 
 ## Environment Variables
 
@@ -111,13 +110,6 @@ QSTASH_CURRENT_SIGNING_KEY="sig_..."
 QSTASH_NEXT_SIGNING_KEY="sig_..."
 ```
 
-### BullMQ
-
-```env
-QUEUE_PROVIDER="bullmq"
-REDIS_URL="redis://localhost:6379"
-```
-
 ## QStash Webhook Route
 
 Mount the verification handler in your API:
@@ -134,6 +126,6 @@ app.post("/api/queue/:queue/:type", async (c) => {
 
 ## Failure Observability
 
-Providers may expose `getDeadLetteredJobs(queue?)` for jobs that exhausted retries and need operator attention. The memory provider implements this for deterministic tests and local harnesses. The BullMQ provider maps durable failed jobs whose attempts are exhausted into the same contract, including the original payload, attempt count, configured retry limit, failure reason, and `failedAt` timestamp.
+Providers may expose `getDeadLetteredJobs(queue?)` for jobs that exhausted retries and need operator attention. The memory provider implements this for deterministic tests and local harnesses.
 
 For QStash, pass an injected `dlqFetcher` and optional `dlqEndpoint`; this package does not assume unstable provider SDK DLQ APIs. The fetcher returns provider-side records, and the provider maps records whose body is the original `JobPayload` into `DeadLetterJob`. Fetcher errors fail closed to `[]` and are logged.

package/dist/factory.d.ts

@@ -12,12 +12,6 @@ import type { QueueConfig, QueueProvider } from "./types";
  *   provider: "qstash",
  *   callbackBaseUrl: "https://api.nebutra.com",
  * });
- *
- * // Explicit BullMQ
- * const queue = await createQueue({
- *   provider: "bullmq",
- *   redisUrl: "redis://localhost:6379",
- * });
  * ```
  */
 export declare function createQueue(config?: QueueConfig): Promise<QueueProvider>;

package/dist/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAqB,MAAM,SAAS,CAAC;AAwC7E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,WAAW,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CA0E9E;AAED;;;GAGG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC,CAKvD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAEtD;AAED;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAKhD;AAMD,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEtD;;GAEG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,UAAU,GACnB,UAAU,CASZ"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAqB,MAAM,SAAS,CAAC;AAoC7E;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,WAAW,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAsC9E;AAED;;;GAGG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC,CAKvD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAEtD;AAED;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAKhD;AAMD,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEtD;;GAEG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,UAAU,GACnB,UAAU,CASZ"}

package/dist/factory.js

@@ -18,11 +18,7 @@ function resolveQueueProvider(explicit) {
     return resolveProviderType({
         explicit,
         envVarName: "QUEUE_PROVIDER",
-        detectors: [
-            { provider: "qstash", when: envPresent("QSTASH_TOKEN") },
-            { provider: "bullmq", when: envPresent("REDIS_URL") },
-            { provider: "sqs", when: envPresent("AWS_SQS_QUEUE_URL") },
-        ],
+        detectors: [{ provider: "qstash", when: envPresent("QSTASH_TOKEN") }],
         fallback: "memory",
     });
 }
@@ -30,7 +26,7 @@ function assertMemoryProviderAllowed() {
     assertProviderAllowed("memory", {
         disallowedInProd: ["memory"],
         overrideEnv: "ALLOW_MEMORY_QUEUE_IN_PRODUCTION",
-        message: "Refusing to use the in-memory queue provider in production. Configure QSTASH_TOKEN or REDIS_URL, or set ALLOW_MEMORY_QUEUE_IN_PRODUCTION=true for an explicit temporary override.",
+        message: "Refusing to use the in-memory queue provider in production. Configure QSTASH_TOKEN, or set ALLOW_MEMORY_QUEUE_IN_PRODUCTION=true for an explicit temporary override.",
     });
 }
 /**
@@ -46,12 +42,6 @@ function assertMemoryProviderAllowed() {
  *   provider: "qstash",
  *   callbackBaseUrl: "https://api.nebutra.com",
  * });
- *
- * // Explicit BullMQ
- * const queue = await createQueue({
- *   provider: "bullmq",
- *   redisUrl: "redis://localhost:6379",
- * });
  * ```
  */
 export async function createQueue(config) {
@@ -79,34 +69,6 @@ export async function createQueue(config) {
                 ...(qstashConfig?.dlqFetcher !== undefined ? { dlqFetcher: qstashConfig.dlqFetcher } : {}),
             });
         }
-        case "bullmq": {
-            const { BullMQProvider } = await import("./providers/bullmq");
-            const bullConfig = config;
-            return new BullMQProvider({
-                ...(bullConfig?.redisUrl !== undefined ? { redisUrl: bullConfig.redisUrl } : {}),
-                ...(bullConfig?.concurrency !== undefined ? { concurrency: bullConfig.concurrency } : {}),
-                ...(bullConfig?.prefix !== undefined ? { prefix: bullConfig.prefix } : {}),
-            });
-        }
-        case "sqs": {
-            const { SQSProvider } = await import("./providers/sqs");
-            const sqsConfig = config;
-            return new SQSProvider({
-                ...(sqsConfig?.region !== undefined ? { region: sqsConfig.region } : {}),
-                ...(sqsConfig?.queueUrl !== undefined ? { queueUrl: sqsConfig.queueUrl } : {}),
-                ...(sqsConfig?.accessKeyId !== undefined ? { accessKeyId: sqsConfig.accessKeyId } : {}),
-                ...(sqsConfig?.secretAccessKey !== undefined
-                    ? { secretAccessKey: sqsConfig.secretAccessKey }
-                    : {}),
-                ...(sqsConfig?.waitTimeSeconds !== undefined
-                    ? { waitTimeSeconds: sqsConfig.waitTimeSeconds }
-                    : {}),
-                ...(sqsConfig?.maxMessages !== undefined ? { maxMessages: sqsConfig.maxMessages } : {}),
-                ...(sqsConfig?.visibilityTimeoutSeconds !== undefined
-                    ? { visibilityTimeoutSeconds: sqsConfig.visibilityTimeoutSeconds }
-                    : {}),
-            });
-        }
         case "memory": {
             assertMemoryProviderAllowed();
             const { MemoryProvider } = await import("./providers/memory");

package/dist/index.d.ts

@@ -1,12 +1,11 @@
 export { closeQueue, createJob, createQueue, getQueue, setQueue, } from "./factory";
 export { createQStashWebhookHandler } from "./middleware/qstash-verify";
-export { BullMQProvider } from "./providers/bullmq";
 export { MemoryProvider } from "./providers/memory";
 export { getQStashHandler, getQStashHandlerKeys, QStashProvider } from "./providers/qstash";
 export type { QueuebaseBackoff, QueuebaseClient, QueuebaseClientOptions, QueuebaseEnqueueResult, QueuebaseJobContext, QueuebaseJobDefinition, QueuebaseJobRouter, QueuebaseJobs, QueuebaseSchedule, QueuebaseScheduleConfig, QueuebaseScheduleMetadata, } from "./queuebase";
 export { createDefaultQueuebaseJobs, createJobClient, createJobRouter, createQueuebaseWebhookHandler, defineQueueJob, getQueuebaseCallbackUrl, listQueuebaseSchedules, queuebaseJobClient, queuebaseJobs, queuebaseWebhookHandler, } from "./queuebase";
 export type { InvitationCleanupClient, RegisterDefaultScheduledJobsOptions, ScheduledJob, ScheduledJobResult, SessionCleanupClient, } from "./scheduled/index";
 export { clearScheduledJobs, createInvitationCleanup, createSessionCleanup, getScheduledJob, invitationCleanup, listScheduledJobs, registerDefaultScheduledJobs, registerScheduledJob, runInvitationCleanup, runSessionCleanup, sessionCleanup, } from "./scheduled/index";
-export type { BullMQProviderConfig, DeadLetterJob, JobHandler, JobLifecycleAction, JobLifecycleActionResult, JobLifecycleEvent, JobOptions, JobPayload, JobResult, JobStatus, JobStatusInfo, MemoryProviderConfig, QStashProviderConfig, QueueConfig, QueueProvider, QueueProviderType, } from "./types";
+export type { DeadLetterJob, JobHandler, JobLifecycleAction, JobLifecycleActionResult, JobLifecycleEvent, JobOptions, JobPayload, JobResult, JobStatus, JobStatusInfo, MemoryProviderConfig, QStashProviderConfig, QueueConfig, QueueProvider, QueueProviderType, } from "./types";
 export { JobOptionsSchema, JobPayloadSchema } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EACL,UAAU,EACV,SAAS,EACT,WAAW,EACX,QAAQ,EACR,QAAQ,GACT,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC5F,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,0BAA0B,EAC1B,eAAe,EACf,eAAe,EACf,6BAA6B,EAC7B,cAAc,EACd,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EAClB,aAAa,EACb,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,uBAAuB,EACvB,mCAAmC,EACnC,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,4BAA4B,EAC5B,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,oBAAoB,EACpB,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,SAAS,EACT,SAAS,EACT,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACX,aAAa,EACb,iBAAiB,GAClB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,UAAU,EACV,SAAS,EACT,WAAW,EACX,QAAQ,EACR,QAAQ,GACT,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC5F,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,0BAA0B,EAC1B,eAAe,EACf,eAAe,EACf,6BAA6B,EAC7B,cAAc,EACd,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EAClB,aAAa,EACb,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,uBAAuB,EACvB,mCAAmC,EACnC,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,4BAA4B,EAC5B,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,SAAS,EACT,SAAS,EACT,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACX,aAAa,EACb,iBAAiB,GAClB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -3,7 +3,6 @@
 // =============================================================================
 // Supports:
 //   - Upstash QStash  (serverless, HTTP-based)
-//   - BullMQ          (self-hosted Redis)
 //   - In-memory       (dev/test only)
 //
 // Usage:
@@ -16,7 +15,6 @@
 export { closeQueue, createJob, createQueue, getQueue, setQueue, } from "./factory";
 // ── Middleware ───────────────────────────────────────────────────────────────
 export { createQStashWebhookHandler } from "./middleware/qstash-verify";
-export { BullMQProvider } from "./providers/bullmq";
 export { MemoryProvider } from "./providers/memory";
 // ── Providers (tree-shakable direct imports) ────────────────────────────────
 export { getQStashHandler, getQStashHandlerKeys, QStashProvider } from "./providers/qstash";

package/dist/queuebase.js

@@ -42,7 +42,9 @@ export const queuebaseJobClient = createJobClient(queuebaseJobs, {
 function getBaseUrlFromEnv() {
     if (process.env.NEXT_PUBLIC_SITE_URL)
         return process.env.NEXT_PUBLIC_SITE_URL;
-    if (process.env.VERCEL_URL)
-        return `https://${process.env.VERCEL_URL}`;
+    // Fly sets FLY_APP_NAME on every Machine; the Vercel fallback went with the
+    // Vercel deploy surface on 2026-09-22.
+    if (process.env.FLY_APP_NAME)
+        return `https://${process.env.FLY_APP_NAME}.fly.dev`;
     return `http://localhost:${process.env.PORT ?? "3001"}`;
 }

package/dist/scheduled/scheduler.js

@@ -5,7 +5,7 @@
 //
 // Schedule activation is decoupled from job definition: jobs are registered
 // here with their cron expression, and an external scheduler (Vercel Cron,
-// QStash schedules, BullMQ repeatable jobs) triggers them via HTTP route or
+// QStash schedules) triggers them via HTTP route or
 // worker.
 //
 // Default activation in this codebase is Vercel Cron — see

package/dist/types.d.ts

@@ -3,11 +3,9 @@ import { z } from "zod";
  * Supported queue backend providers.
  *
  * - `qstash`  — Upstash QStash (serverless, HTTP-based, zero infra)
- * - `bullmq`  — BullMQ over self-hosted Redis (full-featured, self-managed)
- * - `sqs`     — AWS SQS (managed, pull-based, ideal for AWS-native deployments)
  * - `memory`  — In-memory queue for local dev & testing (NOT for production)
  */
-export type QueueProviderType = "qstash" | "bullmq" | "sqs" | "memory";
+export type QueueProviderType = "qstash" | "memory";
 export declare const JobOptionsSchema: z.ZodObject<{
     idempotencyKey: z.ZodOptional<z.ZodString>;
     delaySec: z.ZodOptional<z.ZodNumber>;
@@ -119,7 +117,6 @@ export interface QueueProvider {
     enqueueBatch(jobs: JobPayload[]): Promise<JobResult[]>;
     /**
      * Register a handler for a given job type.
-     * - BullMQ: starts a Worker that polls Redis.
      * - QStash: returns an HTTP handler to mount in your API route.
      * - Memory: processes inline.
      */
@@ -169,34 +166,8 @@ export interface QStashProviderConfig {
     /** Injectable provider-side DLQ fetcher. No Upstash SDK DLQ APIs are assumed. */
     dlqFetcher?: QueueDeadLetterFetcher;
 }
-export interface BullMQProviderConfig {
-    provider: "bullmq";
-    /** Redis connection URL (defaults to `process.env.REDIS_URL`) */
-    redisUrl?: string;
-    /** Default concurrency per worker (default: 5) */
-    concurrency?: number;
-    /** Key prefix for Redis keys (default: "nebutra:queue") */
-    prefix?: string;
-}
 export interface MemoryProviderConfig {
     provider: "memory";
 }
-export interface SQSProviderConfig {
-    provider: "sqs";
-    /** AWS region (defaults to `process.env.AWS_REGION`) */
-    region?: string;
-    /** SQS queue URL (defaults to `process.env.AWS_SQS_QUEUE_URL`) */
-    queueUrl?: string;
-    /** AWS access key (defaults to `process.env.AWS_ACCESS_KEY_ID`) */
-    accessKeyId?: string;
-    /** AWS secret key (defaults to `process.env.AWS_SECRET_ACCESS_KEY`) */
-    secretAccessKey?: string;
-    /** Long-poll wait time in seconds when receiving (1-20, default 20) */
-    waitTimeSeconds?: number;
-    /** Max messages per receive call (1-10, default 10) */
-    maxMessages?: number;
-    /** Visibility timeout in seconds — how long a received message is hidden (default 30) */
-    visibilityTimeoutSeconds?: number;
-}
-export type QueueConfig = QStashProviderConfig | BullMQProviderConfig | SQSProviderConfig | MemoryProviderConfig;
+export type QueueConfig = QStashProviderConfig | MemoryProviderConfig;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -7,7 +7,7 @@ export const JobOptionsSchema = z.object({
     delaySec: z.number().int().min(0).optional(),
     /** Maximum retry attempts on failure (default: 3) */
     maxRetries: z.number().int().min(0).optional(),
-    /** Priority: lower number = higher priority (BullMQ only, ignored by QStash) */
+    /** Priority: lower number = higher priority (ignored by QStash) */
     priority: z.number().int().min(0).optional(),
     /** Cron expression for recurring jobs (e.g. "0 3 * * *") */
     cron: z.string().optional(),

package/package.json

@@ -1,17 +1,16 @@
 {
   "name": "@nebutra/queue",
-  "version": "0.1.4",
+  "version": "3.0.0",
   "private": false,
   "license": "MIT",
   "type": "module",
   "nebutra": {
+    "graph": "core",
     "status": "foundation",
     "productionReady": false,
     "requires": [
       "QSTASH_TOKEN (+ signing keys) for serverless",
       "Configured QStash dlqFetcher/dlqEndpoint for provider-side DLQ observability",
-      "REDIS_URL for BullMQ self-hosted",
-      "AWS_SQS_QUEUE_URL (+ AWS credentials) for SQS",
       "Host-injected getSystemDb for registerDefaultScheduledJobs (optional scheduled jobs)"
     ],
     "gaps": [
@@ -29,14 +28,6 @@
       "types": "./dist/providers/qstash.d.ts",
       "import": "./dist/providers/qstash.js"
     },
-    "./bullmq": {
-      "types": "./dist/providers/bullmq.d.ts",
-      "import": "./dist/providers/bullmq.js"
-    },
-    "./sqs": {
-      "types": "./dist/providers/sqs.d.ts",
-      "import": "./dist/providers/sqs.js"
-    },
     "./queuebase": {
       "types": "./dist/queuebase.d.ts",
       "import": "./dist/queuebase.js"
@@ -55,13 +46,10 @@
     "README.md"
   ],
   "dependencies": {
-    "@aws-sdk/client-sqs": "^3.700.0",
     "@upstash/qstash": "^2.7.17",
-    "bullmq": "^5.34.8",
-    "ioredis": "^5.4.2",
     "zod": "^4.3.6",
-    "@nebutra/logger": "0.1.2",
-    "@nebutra/provider-factory": "0.2.3"
+    "@nebutra/logger": "3.0.0",
+    "@nebutra/provider-factory": "3.0.0"
   },
   "devDependencies": {
     "typescript": "^5.9.3",

package/dist/providers/bullmq.d.ts

@@ -1,32 +0,0 @@
-import type { BullMQProviderConfig, DeadLetterJob, JobHandler, JobPayload, JobResult, JobStatusInfo, QueueProvider } from "../types";
-interface BullMQFailedJobLike {
-    id?: string;
-    data: JobPayload;
-    attemptsMade: number;
-    opts: {
-        attempts?: number;
-    };
-    failedReason?: string;
-    finishedOn?: number;
-}
-export declare function toBullMQDeadLetterJob(queue: string, job: BullMQFailedJobLike): DeadLetterJob | undefined;
-export declare class BullMQProvider implements QueueProvider {
-    readonly name: "bullmq";
-    private connection;
-    private queues;
-    private workers;
-    private handlers;
-    private prefix;
-    private concurrency;
-    constructor(config: Omit<BullMQProviderConfig, "provider">);
-    private getOrCreateQueue;
-    enqueue(job: JobPayload): Promise<JobResult>;
-    enqueueBatch(jobs: JobPayload[]): Promise<JobResult[]>;
-    registerHandler<T extends Record<string, unknown>>(queue: string, type: string, handler: JobHandler<T>): void;
-    private ensureWorker;
-    getJobStatus(jobId: string, queue: string): Promise<JobStatusInfo | undefined>;
-    getDeadLetteredJobs(queue?: string): Promise<DeadLetterJob[]>;
-    close(): Promise<void>;
-}
-export {};
-//# sourceMappingURL=bullmq.d.ts.map

package/dist/providers/bullmq.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bullmq.d.ts","sourceRoot":"","sources":["../../src/providers/bullmq.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EACb,UAAU,EACV,UAAU,EACV,SAAS,EAET,aAAa,EACb,aAAa,EACd,MAAM,UAAU,CAAC;AAIlB,UAAU,mBAAmB;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,UAAU,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,mBAAmB,GACvB,aAAa,GAAG,SAAS,CAe3B;AAaD,qBAAa,cAAe,YAAW,aAAa;IAClD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAElC,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,QAAQ,CAAsC;IACtD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,UAAU,CAAC;IA+B1D,OAAO,CAAC,gBAAgB;IAoBlB,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAgC5C,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IA0C5D,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/C,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GACrB,IAAI;IAUP,OAAO,CAAC,YAAY;IAyDd,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAiC9E,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAkB7D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CA4B7B"}

package/dist/providers/bullmq.js

@@ -1,258 +0,0 @@
-import { logger } from "@nebutra/logger";
-import { Queue, Worker } from "bullmq";
-import IORedis from "ioredis";
-export function toBullMQDeadLetterJob(queue, job) {
-    const maxRetries = job.opts.attempts ?? job.data.options?.maxRetries ?? 3;
-    if (job.attemptsMade < maxRetries)
-        return undefined;
-    return {
-        id: job.id ?? job.data.id,
-        queue,
-        type: job.data.type,
-        originalJob: job.data,
-        attempts: job.attemptsMade,
-        maxRetries,
-        failedReason: job.failedReason ?? "Job failed without a provider reason",
-        provider: "bullmq",
-        failedAt: new Date(job.finishedOn ?? Date.now()).toISOString(),
-    };
-}
-// BullMQ Provider — self-hosted Redis queue backend
-// =============================================================================
-// Uses BullMQ (the successor to Bull) for job queuing over a standard Redis
-// instance. Ideal for customers who self-host Redis or need features like
-// priority queues, rate limiting, and the Bull Board dashboard.
-//
-// Architecture:
-//   enqueue()        →  Redis LPUSH via BullMQ Queue
-//   registerHandler  →  BullMQ Worker (long-polling BRPOPLPUSH)
-//   getJobStatus     →  Redis HGET on the job hash
-// =============================================================================
-export class BullMQProvider {
-    name = "bullmq";
-    connection;
-    queues = new Map();
-    workers = new Map();
-    handlers = new Map();
-    prefix;
-    concurrency;
-    constructor(config) {
-        const redisUrl = config.redisUrl ?? process.env.REDIS_URL;
-        if (!redisUrl) {
-            throw new Error("Redis URL not configured. Set REDIS_URL env var or pass `redisUrl` in config.");
-        }
-        this.prefix = config.prefix ?? "nebutra:queue";
-        this.concurrency = config.concurrency ?? 5;
-        this.connection = new IORedis(redisUrl, {
-            maxRetriesPerRequest: null, // Required by BullMQ
-            enableReadyCheck: false,
-            lazyConnect: true,
-        });
-        this.connection.on("error", (err) => {
-            logger.error("[queue:bullmq] Redis connection error", {
-                error: err.message,
-            });
-        });
-        logger.info("[queue:bullmq] Provider initialised", {
-            prefix: this.prefix,
-            concurrency: this.concurrency,
-        });
-    }
-    // ── Internal helpers ────────────────────────────────────────────────────
-    getOrCreateQueue(queueName) {
-        let queue = this.queues.get(queueName);
-        if (!queue) {
-            queue = new Queue(queueName, {
-                connection: this.connection.duplicate(),
-                prefix: this.prefix,
-                defaultJobOptions: {
-                    attempts: 3,
-                    backoff: { type: "exponential", delay: 1000 },
-                    removeOnComplete: { count: 1000 },
-                    removeOnFail: { count: 5000 },
-                },
-            });
-            this.queues.set(queueName, queue);
-        }
-        return queue;
-    }
-    // ── Enqueue ─────────────────────────────────────────────────────────────
-    async enqueue(job) {
-        const queue = this.getOrCreateQueue(job.queue);
-        try {
-            const bullJob = await queue.add(job.type, job, {
-                jobId: job.id,
-                ...(job.options?.delaySec ? { delay: job.options.delaySec * 1000 } : {}),
-                attempts: job.options?.maxRetries ?? 3,
-                ...(job.options?.priority !== undefined ? { priority: job.options.priority } : {}),
-                ...(job.options?.cron ? { repeat: { pattern: job.options.cron } } : {}),
-            });
-            logger.info("[queue:bullmq] Job enqueued", {
-                jobId: bullJob.id,
-                queue: job.queue,
-                type: job.type,
-            });
-            return {
-                jobId: bullJob.id ?? job.id,
-                accepted: true,
-                provider: "bullmq",
-            };
-        }
-        catch (error) {
-            logger.error("[queue:bullmq] Failed to enqueue job", {
-                jobId: job.id,
-                error: error instanceof Error ? error.message : String(error),
-            });
-            throw error;
-        }
-    }
-    async enqueueBatch(jobs) {
-        // Group jobs by queue name for efficient bulk add
-        const grouped = new Map();
-        for (const job of jobs) {
-            const list = grouped.get(job.queue) ?? [];
-            list.push(job);
-            grouped.set(job.queue, list);
-        }
-        const results = [];
-        for (const [queueName, queueJobs] of grouped) {
-            const queue = this.getOrCreateQueue(queueName);
-            const bulkData = queueJobs.map((job) => ({
-                name: job.type,
-                data: job,
-                opts: {
-                    jobId: job.id,
-                    ...(job.options?.delaySec ? { delay: job.options.delaySec * 1000 } : {}),
-                    attempts: job.options?.maxRetries ?? 3,
-                    ...(job.options?.priority !== undefined ? { priority: job.options.priority } : {}),
-                },
-            }));
-            const bullJobs = await queue.addBulk(bulkData);
-            for (let i = 0; i < bullJobs.length; i++) {
-                results.push({
-                    jobId: bullJobs[i]?.id ?? queueJobs[i]?.id ?? "",
-                    accepted: true,
-                    provider: "bullmq",
-                });
-            }
-        }
-        logger.info("[queue:bullmq] Batch enqueued", { count: jobs.length });
-        return results;
-    }
-    // ── Handler Registration ────────────────────────────────────────────────
-    registerHandler(queue, type, handler) {
-        const key = `${queue}:${type}`;
-        this.handlers.set(key, handler);
-        // Create or update the worker for this queue
-        this.ensureWorker(queue);
-        logger.info("[queue:bullmq] Handler registered", { key });
-    }
-    ensureWorker(queueName) {
-        if (this.workers.has(queueName))
-            return;
-        const worker = new Worker(queueName, async (bullJob) => {
-            const payload = bullJob.data;
-            const key = `${payload.queue}:${payload.type}`;
-            const handler = this.handlers.get(key);
-            if (!handler) {
-                logger.warn("[queue:bullmq] No handler registered for job type", {
-                    key,
-                    jobId: payload.id,
-                });
-                throw new Error(`No handler registered for ${key}`);
-            }
-            await handler(payload);
-        }, {
-            connection: this.connection.duplicate(),
-            prefix: this.prefix,
-            concurrency: this.concurrency,
-            removeOnComplete: { count: 1000 },
-            removeOnFail: { count: 5000 },
-        });
-        worker.on("completed", (job) => {
-            logger.info("[queue:bullmq] Job completed", {
-                jobId: job.id,
-                queue: queueName,
-            });
-        });
-        worker.on("failed", (job, err) => {
-            logger.error("[queue:bullmq] Job failed", {
-                jobId: job?.id,
-                queue: queueName,
-                error: err.message,
-                attempts: job?.attemptsMade,
-            });
-        });
-        worker.on("error", (err) => {
-            logger.error("[queue:bullmq] Worker error", {
-                queue: queueName,
-                error: err.message,
-            });
-        });
-        this.workers.set(queueName, worker);
-    }
-    // ── Job Status ──────────────────────────────────────────────────────────
-    async getJobStatus(jobId, queue) {
-        const q = this.queues.get(queue);
-        if (!q)
-            return undefined;
-        const bullJob = await q.getJob(jobId);
-        if (!bullJob)
-            return undefined;
-        const state = await bullJob.getState();
-        const statusMap = {
-            completed: "completed",
-            failed: "failed",
-            delayed: "delayed",
-            active: "active",
-            waiting: "waiting",
-            "waiting-children": "waiting",
-            prioritized: "pending",
-            unknown: "pending",
-        };
-        return {
-            id: bullJob.id ?? jobId,
-            queue,
-            status: statusMap[state] ?? "pending",
-            attempts: bullJob.attemptsMade,
-            maxRetries: bullJob.opts.attempts ?? 3,
-            ...(bullJob.failedReason ? { failedReason: bullJob.failedReason } : {}),
-            createdAt: new Date(bullJob.timestamp).toISOString(),
-            ...(bullJob.processedOn ? { processedAt: new Date(bullJob.processedOn).toISOString() } : {}),
-            ...(bullJob.finishedOn ? { completedAt: new Date(bullJob.finishedOn).toISOString() } : {}),
-        };
-    }
-    async getDeadLetteredJobs(queue) {
-        const entries = queue !== undefined ? [[queue, this.getOrCreateQueue(queue)]] : this.queues;
-        const deadLetters = [];
-        for (const [queueName, q] of entries) {
-            const failedJobs = await q.getFailed(0, -1);
-            for (const failedJob of failedJobs) {
-                const deadLetter = toBullMQDeadLetterJob(queueName, failedJob);
-                if (deadLetter)
-                    deadLetters.push(deadLetter);
-            }
-        }
-        return deadLetters;
-    }
-    // ── Lifecycle ───────────────────────────────────────────────────────────
-    async close() {
-        const closeTasks = [];
-        for (const [name, worker] of this.workers) {
-            closeTasks.push(worker.close().then(() => {
-                logger.info("[queue:bullmq] Worker closed", { queue: name });
-            }));
-        }
-        for (const [name, queue] of this.queues) {
-            closeTasks.push(queue.close().then(() => {
-                logger.info("[queue:bullmq] Queue closed", { queue: name });
-            }));
-        }
-        await Promise.allSettled(closeTasks);
-        await this.connection.quit();
-        this.workers.clear();
-        this.queues.clear();
-        this.handlers.clear();
-        logger.info("[queue:bullmq] Provider closed");
-    }
-}

package/dist/providers/sqs.d.ts

@@ -1,18 +0,0 @@
-import type { JobHandler, JobPayload, JobResult, QueueProvider, SQSProviderConfig } from "../types";
-export declare class SQSProvider implements QueueProvider {
-    readonly name: "sqs";
-    private client;
-    private queueUrl;
-    private waitTimeSeconds;
-    private maxMessages;
-    private visibilityTimeoutSeconds;
-    constructor(config: Omit<SQSProviderConfig, "provider">);
-    enqueue(job: JobPayload): Promise<JobResult>;
-    enqueueBatch(jobs: JobPayload[]): Promise<JobResult[]>;
-    registerHandler<T extends Record<string, unknown>>(queue: string, type: string, handler: JobHandler<T>): void;
-    private pollLoop;
-    private dispatch;
-    private deleteMessage;
-    close(): Promise<void>;
-}
-//# sourceMappingURL=sqs.d.ts.map

package/dist/providers/sqs.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sqs.d.ts","sourceRoot":"","sources":["../../src/providers/sqs.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AA6BpG,qBAAa,WAAY,YAAW,aAAa;IAC/C,QAAQ,CAAC,IAAI,EAAG,KAAK,CAAU;IAE/B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,wBAAwB,CAAS;gBAE7B,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,CAAC;IA+BjD,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAmC5C,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IA6C5D,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/C,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GACrB,IAAI;YAgBO,QAAQ;YAgCR,QAAQ;YAmCR,aAAa;IAcrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAM7B"}

package/dist/providers/sqs.js

@@ -1,197 +0,0 @@
-import { DeleteMessageCommand, ReceiveMessageCommand, SendMessageBatchCommand, SendMessageCommand, SQSClient, } from "@aws-sdk/client-sqs";
-import { logger } from "@nebutra/logger";
-const handlerRegistry = new Map();
-function handlerKey(queue, type) {
-    return `${queue}:${type}`;
-}
-export class SQSProvider {
-    name = "sqs";
-    client;
-    queueUrl;
-    waitTimeSeconds;
-    maxMessages;
-    visibilityTimeoutSeconds;
-    constructor(config) {
-        const region = config.region ?? process.env.AWS_REGION;
-        const queueUrl = config.queueUrl ?? process.env.AWS_SQS_QUEUE_URL;
-        if (!region) {
-            throw new Error("SQS region not configured. Set AWS_REGION env var or pass `region`.");
-        }
-        if (!queueUrl) {
-            throw new Error("SQS queue URL not configured. Set AWS_SQS_QUEUE_URL env var or pass `queueUrl`.");
-        }
-        const accessKeyId = config.accessKeyId ?? process.env.AWS_ACCESS_KEY_ID;
-        const secretAccessKey = config.secretAccessKey ?? process.env.AWS_SECRET_ACCESS_KEY;
-        this.client = new SQSClient({
-            region,
-            // If explicit creds provided, use them; otherwise AWS SDK uses default
-            // chain (IAM role on EC2/ECS/Lambda, ~/.aws/credentials, env, etc.).
-            ...(accessKeyId && secretAccessKey ? { credentials: { accessKeyId, secretAccessKey } } : {}),
-        });
-        this.queueUrl = queueUrl;
-        this.waitTimeSeconds = config.waitTimeSeconds ?? 20;
-        this.maxMessages = config.maxMessages ?? 10;
-        this.visibilityTimeoutSeconds = config.visibilityTimeoutSeconds ?? 30;
-        logger.info("[queue:sqs] Provider initialised", { region, queueUrl: queueUrl.slice(0, 60) });
-    }
-    // ── Enqueue ─────────────────────────────────────────────────────────────
-    async enqueue(job) {
-        try {
-            const response = await this.client.send(new SendMessageCommand({
-                QueueUrl: this.queueUrl,
-                MessageBody: JSON.stringify(job),
-                ...(job.options?.delaySec ? { DelaySeconds: Math.min(job.options.delaySec, 900) } : {}),
-                ...(job.options?.idempotencyKey
-                    ? {
-                        // FIFO queues use deduplication ID; standard queues ignore it.
-                        MessageDeduplicationId: job.options.idempotencyKey,
-                        MessageGroupId: job.queue,
-                    }
-                    : {}),
-            }));
-            const messageId = response.MessageId ?? job.id;
-            logger.info("[queue:sqs] Job enqueued", { jobId: job.id, messageId });
-            return {
-                jobId: messageId,
-                accepted: true,
-                provider: "sqs",
-            };
-        }
-        catch (error) {
-            logger.error("[queue:sqs] Failed to enqueue job", {
-                jobId: job.id,
-                error: error instanceof Error ? error.message : String(error),
-            });
-            throw error;
-        }
-    }
-    async enqueueBatch(jobs) {
-        // SQS SendMessageBatch caps at 10 entries per request — chunk if needed.
-        const results = [];
-        for (let i = 0; i < jobs.length; i += 10) {
-            const chunk = jobs.slice(i, i + 10);
-            try {
-                const response = await this.client.send(new SendMessageBatchCommand({
-                    QueueUrl: this.queueUrl,
-                    Entries: chunk.map((job, idx) => ({
-                        Id: `msg-${idx}-${Date.now()}`,
-                        MessageBody: JSON.stringify(job),
-                        ...(job.options?.delaySec
-                            ? { DelaySeconds: Math.min(job.options.delaySec, 900) }
-                            : {}),
-                    })),
-                }));
-                const successful = response.Successful ?? [];
-                for (let j = 0; j < chunk.length; j++) {
-                    const ok = successful[j];
-                    results.push({
-                        jobId: ok?.MessageId ?? chunk[j]?.id ?? "",
-                        accepted: Boolean(ok),
-                        provider: "sqs",
-                    });
-                }
-            }
-            catch (error) {
-                logger.error("[queue:sqs] Batch enqueue failed, falling back to sequential", {
-                    error: error instanceof Error ? error.message : String(error),
-                });
-                for (const job of chunk) {
-                    try {
-                        results.push(await this.enqueue(job));
-                    }
-                    catch {
-                        results.push({ jobId: job.id, accepted: false, provider: "sqs" });
-                    }
-                }
-            }
-        }
-        return results;
-    }
-    // ── Handler Registration & Poll Loop ─────────────────────────────────────
-    registerHandler(queue, type, handler) {
-        const key = handlerKey(queue, type);
-        if (handlerRegistry.has(key)) {
-            logger.warn("[queue:sqs] Handler already registered, replacing", { key });
-            const existing = handlerRegistry.get(key);
-            existing?.abort.abort();
-        }
-        const abort = new AbortController();
-        handlerRegistry.set(key, { handler: handler, abort });
-        void this.pollLoop(queue, type, handler, abort.signal);
-        logger.info("[queue:sqs] Handler registered + poll loop started", { key });
-    }
-    async pollLoop(queue, type, handler, signal) {
-        while (!signal.aborted) {
-            try {
-                const response = await this.client.send(new ReceiveMessageCommand({
-                    QueueUrl: this.queueUrl,
-                    MaxNumberOfMessages: this.maxMessages,
-                    WaitTimeSeconds: this.waitTimeSeconds,
-                    VisibilityTimeout: this.visibilityTimeoutSeconds,
-                }));
-                const messages = response.Messages ?? [];
-                for (const msg of messages) {
-                    if (signal.aborted)
-                        break;
-                    await this.dispatch(msg, queue, type, handler);
-                }
-            }
-            catch (error) {
-                if (signal.aborted)
-                    break;
-                logger.error("[queue:sqs] Poll error, sleeping 5s", {
-                    error: error instanceof Error ? error.message : String(error),
-                });
-                await new Promise((r) => setTimeout(r, 5000));
-            }
-        }
-    }
-    async dispatch(msg, queue, type, handler) {
-        if (!msg.Body || !msg.ReceiptHandle)
-            return;
-        let job;
-        try {
-            job = JSON.parse(msg.Body);
-        }
-        catch {
-            logger.error("[queue:sqs] Malformed message body, deleting", { messageId: msg.MessageId });
-            await this.deleteMessage(msg.ReceiptHandle);
-            return;
-        }
-        if (job.queue !== queue || job.type !== type) {
-            // Not for this handler — leave it for whoever owns it. Visibility timeout
-            // will expire and another consumer can pick it up.
-            return;
-        }
-        try {
-            await handler(job);
-            await this.deleteMessage(msg.ReceiptHandle);
-        }
-        catch (error) {
-            logger.error("[queue:sqs] Handler failed; message will be retried by SQS", {
-                jobId: job.id,
-                error: error instanceof Error ? error.message : String(error),
-            });
-            // Don't delete — SQS will redeliver after visibility timeout.
-            // Configure a DLQ on the SQS queue side for terminal failure handling.
-        }
-    }
-    async deleteMessage(receiptHandle) {
-        try {
-            await this.client.send(new DeleteMessageCommand({ QueueUrl: this.queueUrl, ReceiptHandle: receiptHandle }));
-        }
-        catch (error) {
-            logger.error("[queue:sqs] DeleteMessage failed", {
-                error: error instanceof Error ? error.message : String(error),
-            });
-        }
-    }
-    // ── Lifecycle ───────────────────────────────────────────────────────────
-    async close() {
-        for (const entry of handlerRegistry.values())
-            entry.abort.abort();
-        handlerRegistry.clear();
-        this.client.destroy();
-        logger.info("[queue:sqs] Provider closed");
-    }
-}