@vercel/queue 0.0.0-alpha.37 → 0.0.0-alpha.38

package/dist/web.d.ts

@@ -0,0 +1,60 @@
+import { M as MessageHandler, H as HandleCallbackOptions } from './callback-lq_sorrn.js';
+
+/**
+ * Web API (App Router / Hono) wrapper for queue callback handling.
+ *
+ * Provides a `handleCallback` that returns a standard `(Request) => Promise<Response>`
+ * handler, compatible with Next.js App Router route handlers, Hono, and any
+ * framework that uses the Web API `Request`/`Response` types.
+ *
+ * @example
+ * ```typescript
+ * // Next.js App Router — app/api/queue/route.ts
+ * import { handleCallback } from "@vercel/queue/web";
+ *
+ * export const POST = handleCallback(async (message, metadata) => {
+ *   console.log("Processing:", message);
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Hono
+ * import { Hono } from "hono";
+ * import { handleCallback } from "@vercel/queue/web";
+ *
+ * const app = new Hono();
+ * app.post("/api/queue", handleCallback(handler));
+ * ```
+ */
+
+/**
+ * Create a Web API route handler for processing queue callback messages.
+ *
+ * Parses the incoming `Request` as a CloudEvent and invokes the message handler.
+ * Returns appropriate HTTP responses:
+ * - **200** on success
+ * - **400** for invalid CloudEvent payloads
+ * - **500** for unexpected processing errors
+ *
+ * @param handler - Function to process the message payload and metadata
+ * @param options - Optional configuration
+ * @param options.client - Custom QueueClient instance
+ * @param options.visibilityTimeoutSeconds - Message lock duration (default: 300, max: 3600)
+ * @returns A `(request: Request) => Promise<Response>` route handler
+ *
+ * @example
+ * ```typescript
+ * import { handleCallback } from "@vercel/queue/web";
+ *
+ * export const POST = handleCallback(
+ *   async (order, metadata) => {
+ *     await processOrder(order);
+ *   },
+ *   { visibilityTimeoutSeconds: 300 },
+ * );
+ * ```
+ */
+declare function handleCallback<T = unknown>(handler: MessageHandler<T>, options?: HandleCallbackOptions): (request: Request) => Promise<Response>;
+
+export { handleCallback };