@nebutra/queue 0.1.0 → 0.1.1

package/README.md

@@ -1,4 +1,4 @@
-> **Status: Foundation** — Type definitions, factory pattern, and provider stubs are complete. The in-memory provider exposes a test-only dead-letter queue, and BullMQ exposes retry-exhausted failed jobs through the shared dead-letter contract. QStash provider-side dead-letter retrieval is still not production-ready.
+> **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.
 
 # @nebutra/queue
 
@@ -23,6 +23,71 @@ queue.registerHandler("email", "send", async (job) => {
 });
 ```
 
+## Queuebase-style Jobs
+
+`@nebutra/queue` also exposes a Queuebase-compatible job layer for app-owned
+background jobs: define typed jobs with Zod input, enqueue through a typed
+client, and execute callbacks through a single webhook route.
+
+```ts
+import {
+  createJobClient,
+  createJobRouter,
+  createQueuebaseWebhookHandler,
+  defineQueueJob,
+} from "@nebutra/queue";
+import { z } from "zod";
+
+export const jobs = createJobRouter({
+  sendWelcomeEmail: defineQueueJob({
+    input: z.object({ to: z.string().email(), name: z.string() }),
+    defaults: { retries: 3, backoff: "exponential" },
+    handler: async ({ input, jobId, attempt }) => {
+      await sendWelcomeEmail(input.to, input.name, { jobId, attempt });
+      return { sent: true };
+    },
+  }),
+  dailyCleanup: defineQueueJob({
+    input: z.object({}),
+    schedule: { cron: "0 2 * * *", timezone: "UTC", overlap: "skip" },
+    handler: async () => ({ cleaned: true }),
+  }),
+});
+
+export const jobClient = createJobClient(jobs, {
+  callbackUrl: "https://app.nebutra.com/api/webhooks/queuebase",
+});
+
+export const webhookHandler = createQueuebaseWebhookHandler(jobs);
+```
+
+The default Nebutra web app mounts `queuebaseWebhookHandler` at
+`/api/webhooks/queuebase`. `queuebaseJobClient` uses:
+
+- `QUEUEBASE_API_URL`, defaulting to `http://localhost:3847`
+- `QUEUEBASE_API_KEY`, required by hosted Queuebase
+- `NEXT_PUBLIC_SITE_URL`, `VERCEL_URL`, or `PORT` to derive the callback URL
+
+Local development mirrors Queuebase's callback model:
+
+```bash
+# Terminal 1: Queuebase-compatible dev server / sync process
+npx queuebase dev
+
+# Terminal 2: Nebutra app
+pnpm dev:web
+```
+
+For production, set the env vars on the host and run the provider sync step
+after deployment configuration changes:
+
+```bash
+npx queuebase sync
+```
+
+Use `listQueuebaseSchedules(queuebaseJobs)` to inspect schedule metadata for
+sync tooling without executing handlers.
+
 ## Provider Selection
 
 The factory auto-detects the provider:
@@ -69,4 +134,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. QStash provider-side dead-letter retrieval is still a known gap, so package metadata keeps `productionReady: false`.
+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.
+
+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

@@ -0,0 +1,42 @@
+import type { QueueConfig, QueueProvider } from "./types";
+/**
+ * Create a queue provider instance.
+ *
+ * @example
+ * ```ts
+ * // Auto-detect from environment
+ * const queue = await createQueue();
+ *
+ * // Explicit QStash
+ * const queue = await createQueue({
+ *   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>;
+/**
+ * Get or create the default (singleton) queue provider.
+ * Uses lazy initialisation so import-time side effects are avoided.
+ */
+export declare function getQueue(): Promise<QueueProvider>;
+/**
+ * Replace the default queue provider (useful in tests).
+ */
+export declare function setQueue(provider: QueueProvider): void;
+/**
+ * Gracefully shut down the default queue provider.
+ */
+export declare function closeQueue(): Promise<void>;
+import type { JobOptions, JobPayload } from "./types";
+/**
+ * Build a `JobPayload` with auto-generated ID and timestamp.
+ */
+export declare function createJob(queue: string, type: string, data: Record<string, unknown>, options?: JobOptions): JobPayload;
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +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"}

package/dist/factory.js

@@ -0,0 +1,156 @@
+import { logger } from "@nebutra/logger";
+import { assertProviderAllowed, envPresent, resolveProviderType } from "@nebutra/provider-factory";
+// =============================================================================
+// Queue Factory — Provider-agnostic queue creation
+// =============================================================================
+// The factory resolves the correct provider at runtime based on:
+//   1. Explicit config passed to `createQueue()`
+//   2. `QUEUE_PROVIDER` environment variable
+//   3. Auto-detection based on available env vars
+//
+// This lets customers switch backends without changing application code.
+// =============================================================================
+let defaultProvider = null;
+// Provider selection is delegated to the shared @nebutra/provider-factory
+// primitive (identical precedence + prod-guard across every provider-agnostic
+// package); only the instantiation switch below stays queue-specific.
+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") },
+        ],
+        fallback: "memory",
+    });
+}
+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.",
+    });
+}
+/**
+ * Create a queue provider instance.
+ *
+ * @example
+ * ```ts
+ * // Auto-detect from environment
+ * const queue = await createQueue();
+ *
+ * // Explicit QStash
+ * const queue = await createQueue({
+ *   provider: "qstash",
+ *   callbackBaseUrl: "https://api.nebutra.com",
+ * });
+ *
+ * // Explicit BullMQ
+ * const queue = await createQueue({
+ *   provider: "bullmq",
+ *   redisUrl: "redis://localhost:6379",
+ * });
+ * ```
+ */
+export async function createQueue(config) {
+    const providerType = resolveQueueProvider(config?.provider);
+    logger.info("[queue] Creating provider", { provider: providerType });
+    switch (providerType) {
+        case "qstash": {
+            const { QStashProvider } = await import("./providers/qstash");
+            const qstashConfig = config;
+            return new QStashProvider({
+                callbackBaseUrl: qstashConfig?.callbackBaseUrl ??
+                    process.env.QSTASH_CALLBACK_BASE_URL ??
+                    process.env.API_GATEWAY_URL ??
+                    "http://localhost:3002",
+                ...(qstashConfig?.token !== undefined ? { token: qstashConfig.token } : {}),
+                ...(qstashConfig?.currentSigningKey !== undefined
+                    ? { currentSigningKey: qstashConfig.currentSigningKey }
+                    : {}),
+                ...(qstashConfig?.nextSigningKey !== undefined
+                    ? { nextSigningKey: qstashConfig.nextSigningKey }
+                    : {}),
+                ...(qstashConfig?.dlqEndpoint !== undefined
+                    ? { dlqEndpoint: qstashConfig.dlqEndpoint }
+                    : {}),
+                ...(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");
+            return new MemoryProvider();
+        }
+        default:
+            throw new Error(`Unknown queue provider: ${providerType}`);
+    }
+}
+/**
+ * Get or create the default (singleton) queue provider.
+ * Uses lazy initialisation so import-time side effects are avoided.
+ */
+export async function getQueue() {
+    if (!defaultProvider) {
+        defaultProvider = await createQueue();
+    }
+    return defaultProvider;
+}
+/**
+ * Replace the default queue provider (useful in tests).
+ */
+export function setQueue(provider) {
+    defaultProvider = provider;
+}
+/**
+ * Gracefully shut down the default queue provider.
+ */
+export async function closeQueue() {
+    if (defaultProvider) {
+        await defaultProvider.close();
+        defaultProvider = null;
+    }
+}
+/**
+ * Build a `JobPayload` with auto-generated ID and timestamp.
+ */
+export function createJob(queue, type, data, options) {
+    return {
+        id: crypto.randomUUID(),
+        queue,
+        type,
+        data,
+        options,
+        createdAt: new Date().toISOString(),
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+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 { createJobClient, createJobRouter, createQueuebaseWebhookHandler, defineQueueJob, getQueuebaseCallbackUrl, listQueuebaseSchedules, queuebaseJobClient, queuebaseJobs, queuebaseWebhookHandler, } from "./queuebase";
+export type { ScheduledJob, ScheduledJobResult } from "./scheduled/index";
+export { clearScheduledJobs, 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 { JobOptionsSchema, JobPayloadSchema } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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,eAAe,EACf,eAAe,EACf,6BAA6B,EAC7B,cAAc,EACd,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EAClB,aAAa,EACb,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE1E,OAAO,EACL,kBAAkB,EAClB,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"}

package/dist/index.js

@@ -0,0 +1,27 @@
+// =============================================================================
+// @nebutra/queue — Provider-agnostic message queue
+// =============================================================================
+// Supports:
+//   - Upstash QStash  (serverless, HTTP-based)
+//   - BullMQ          (self-hosted Redis)
+//   - In-memory       (dev/test only)
+//
+// Usage:
+//   import { getQueue, createJob } from "@nebutra/queue";
+//
+//   const queue = await getQueue();  // auto-detects provider
+//   await queue.enqueue(createJob("email", "send", { to: "user@example.com" }));
+// =============================================================================
+// ── Factory ─────────────────────────────────────────────────────────────────
+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";
+// ── Queuebase-style typed jobs ──────────────────────────────────────────────
+export { createJobClient, createJobRouter, createQueuebaseWebhookHandler, defineQueueJob, getQueuebaseCallbackUrl, listQueuebaseSchedules, queuebaseJobClient, queuebaseJobs, queuebaseWebhookHandler, } from "./queuebase";
+// ── Scheduled (cron) jobs ────────────────────────────────────────────────────
+export { clearScheduledJobs, getScheduledJob, invitationCleanup, listScheduledJobs, registerDefaultScheduledJobs, registerScheduledJob, runInvitationCleanup, runSessionCleanup, sessionCleanup, } from "./scheduled/index";
+export { JobOptionsSchema, JobPayloadSchema } from "./types";

package/dist/middleware/qstash-verify.d.ts

@@ -0,0 +1,16 @@
+interface QStashVerifyOptions {
+    /** Current signing key (defaults to `process.env.QSTASH_CURRENT_SIGNING_KEY`) */
+    currentSigningKey?: string;
+    /** Next signing key for key rotation (defaults to `process.env.QSTASH_NEXT_SIGNING_KEY`) */
+    nextSigningKey?: string;
+}
+/**
+ * Creates a request handler that:
+ * 1. Verifies the QStash signature
+ * 2. Parses the job payload
+ * 3. Routes to the registered handler
+ * 4. Returns 200 on success, 500 on failure (triggers QStash retry)
+ */
+export declare function createQStashWebhookHandler(options?: QStashVerifyOptions): (request: Request) => Promise<Response>;
+export {};
+//# sourceMappingURL=qstash-verify.d.ts.map

package/dist/middleware/qstash-verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qstash-verify.d.ts","sourceRoot":"","sources":["../../src/middleware/qstash-verify.ts"],"names":[],"mappings":"AAyBA,UAAU,mBAAmB;IAC3B,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4FAA4F;IAC5F,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,CAAC,EAAE,mBAAmB,IAYxD,SAAS,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CA4EnD"}

package/dist/middleware/qstash-verify.js

@@ -0,0 +1,87 @@
+import { logger } from "@nebutra/logger";
+import { Receiver } from "@upstash/qstash";
+import { getQStashHandler } from "../providers/qstash";
+/**
+ * Creates a request handler that:
+ * 1. Verifies the QStash signature
+ * 2. Parses the job payload
+ * 3. Routes to the registered handler
+ * 4. Returns 200 on success, 500 on failure (triggers QStash retry)
+ */
+export function createQStashWebhookHandler(options) {
+    const currentSigningKey = options?.currentSigningKey ?? process.env.QSTASH_CURRENT_SIGNING_KEY ?? "";
+    const nextSigningKey = options?.nextSigningKey ?? process.env.QSTASH_NEXT_SIGNING_KEY ?? "";
+    const requiresSignature = process.env.NODE_ENV === "production" || process.env.QUEUE_PROVIDER === "qstash";
+    const receiver = currentSigningKey && nextSigningKey
+        ? new Receiver({ currentSigningKey, nextSigningKey })
+        : null;
+    return async (request) => {
+        const body = await request.text();
+        // ── Signature verification ──────────────────────────────────────────
+        if (!receiver && requiresSignature) {
+            logger.error("[queue:qstash-verify] Signing keys required but not configured", {
+                nodeEnv: process.env.NODE_ENV,
+                queueProvider: process.env.QUEUE_PROVIDER,
+            });
+            return new Response("QStash signing keys not configured", { status: 401 });
+        }
+        if (receiver) {
+            try {
+                const signature = request.headers.get("upstash-signature") ?? "";
+                const isValid = await receiver.verify({
+                    signature,
+                    body,
+                });
+                if (!isValid) {
+                    logger.warn("[queue:qstash-verify] Invalid signature");
+                    return new Response("Unauthorized", { status: 401 });
+                }
+            }
+            catch (error) {
+                logger.error("[queue:qstash-verify] Signature verification failed", {
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                return new Response("Unauthorized", { status: 401 });
+            }
+        }
+        else {
+            logger.warn("[queue:qstash-verify] No signing keys configured — skipping verification (dev mode)");
+        }
+        // ── Parse payload ───────────────────────────────────────────────────
+        let payload;
+        try {
+            payload = JSON.parse(body);
+        }
+        catch {
+            logger.error("[queue:qstash-verify] Invalid JSON payload");
+            return new Response("Bad Request", { status: 400 });
+        }
+        // ── Route to handler ────────────────────────────────────────────────
+        const handler = getQStashHandler(payload.queue, payload.type);
+        if (!handler) {
+            logger.warn("[queue:qstash-verify] No handler for job", {
+                queue: payload.queue,
+                type: payload.type,
+            });
+            // Return 200 to prevent infinite retries for unregistered handlers
+            return new Response("No handler registered", { status: 200 });
+        }
+        try {
+            await handler(payload);
+            logger.info("[queue:qstash-verify] Job processed successfully", {
+                jobId: payload.id,
+                queue: payload.queue,
+                type: payload.type,
+            });
+            return new Response("OK", { status: 200 });
+        }
+        catch (error) {
+            logger.error("[queue:qstash-verify] Job processing failed", {
+                jobId: payload.id,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            // Return 500 so QStash retries the delivery
+            return new Response("Internal Server Error", { status: 500 });
+        }
+    };
+}

package/dist/providers/bullmq.d.ts

@@ -0,0 +1,32 @@
+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

@@ -0,0 +1 @@
+{"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"}