@vercel/queue 0.1.3 → 0.1.5

package/README.md

@@ -92,7 +92,7 @@ await send(
   { message: "Hello world" },
   {
     idempotencyKey: "unique-key", // Prevent duplicate messages
-    retentionSeconds: 3600, // 1 hour TTL (default: 24h)
+    retentionSeconds: 3600, // 1 hour TTL (default: 24h, max: 7d)
     delaySeconds: 60, // Delay delivery by 1 minute
     region: "sfo1", // Top-level send() only — not available on QueueClient.send()
   },
@@ -274,7 +274,7 @@ Multiple route files for the same topic create separate consumer groups — each
 
 ### 3. Retry and Backoff
 
-When a handler throws, the message is not acknowledged and becomes available for redelivery after the `retryAfterSeconds` interval configured in `vercel.json`. Retries continue until the handler succeeds or the message expires (default: 24 hours).
+When a handler throws, the message is not acknowledged and becomes available for redelivery after the `retryAfterSeconds` interval configured in `vercel.json`. Retries continue until the handler succeeds or the message expires (default: 24 hours, max: 7 days).
 
 For finer control over retry timing, pass a `retry` option. You can also set `visibilityTimeoutSeconds` to control how long the message is locked during processing (default: 300):
 
@@ -570,11 +570,11 @@ All error types:
 
 #### Publishing Messages
 
-| Parameter          | Default      | Min | Max         | Notes                               |
-| ------------------ | ------------ | --- | ----------- | ----------------------------------- |
-| `retentionSeconds` | 86,400 (24h) | 60  | 86,400      | Message TTL                         |
-| `delaySeconds`     | 0            | 0   | ≤ retention | Cannot exceed retention             |
-| `idempotencyKey`   | —            | —   | —           | Dedup window: `min(retention, 24h)` |
+| Parameter          | Default      | Min | Max          | Notes                               |
+| ------------------ | ------------ | --- | ------------ | ----------------------------------- |
+| `retentionSeconds` | 86,400 (24h) | 60  | 604,800 (7d) | Message TTL                         |
+| `delaySeconds`     | 0            | 0   | 432,000 (5d) | Cannot exceed retention             |
+| `idempotencyKey`   | —            | —   | —            | Dedup window: `min(retention, 24h)` |
 
 #### Receiving Messages
 
@@ -620,8 +620,8 @@ import { send } from "@vercel/queue";
 
 const { messageId } = await send("my-topic", payload, {
   idempotencyKey: "unique-key", // Dedup window: min(retention, 24h)
-  retentionSeconds: 3600, // Message TTL (default: 86400)
-  delaySeconds: 60, // Delay before visible (default: 0)
+  retentionSeconds: 3600, // Message TTL (default: 86400, max: 604800)
+  delaySeconds: 60, // Delay before visible (default: 0, max: 5d)
   headers: { "X-Custom": "val" }, // Custom headers
   region: "sfo1", // Override the auto-detected region for this send
 });

package/dist/index.d.mts

@@ -205,6 +205,25 @@ interface QueueClientOptions {
      * @default JsonTransport
      */
     transport?: Transport;
+    /**
+     * Custom HTTP dispatcher passed to every `fetch()` call.
+     *
+     * Use this to plug in an undici `RetryAgent` or `Agent` for automatic
+     * retries on transient network errors (ECONNRESET, 429, 5xx) and
+     * connection pooling.
+     *
+     * @example
+     * ```ts
+     * import { Agent, RetryAgent } from 'undici';
+     *
+     * const dispatcher = new RetryAgent(new Agent({ connections: 8 }), {
+     *   retryAfter: true,
+     * });
+     *
+     * new QueueClient({ dispatcher });
+     * ```
+     */
+    dispatcher?: unknown;
 }
 /**
  * Options for creating a {@link PollingQueueClient}.
@@ -241,7 +260,7 @@ interface SendOptions {
      * Message retention time in seconds. After this period, the message expires.
      * @default 86400 (24 hours)
      * @minimum 60 (1 minute)
-     * @maximum 86400 (24 hours)
+     * @maximum 604800 (7 days)
      */
     retentionSeconds?: number;
     /**
@@ -249,7 +268,7 @@ interface SendOptions {
      * The message will not be visible to consumers until the delay has passed.
      * @default 0
      * @minimum 0
-     * @maximum Value of retentionSeconds (delay cannot exceed retention)
+     * @maximum 432000 (5 days, and cannot exceed retentionSeconds)
      */
     delaySeconds?: number;
     /**

package/dist/index.d.ts

@@ -205,6 +205,25 @@ interface QueueClientOptions {
      * @default JsonTransport
      */
     transport?: Transport;
+    /**
+     * Custom HTTP dispatcher passed to every `fetch()` call.
+     *
+     * Use this to plug in an undici `RetryAgent` or `Agent` for automatic
+     * retries on transient network errors (ECONNRESET, 429, 5xx) and
+     * connection pooling.
+     *
+     * @example
+     * ```ts
+     * import { Agent, RetryAgent } from 'undici';
+     *
+     * const dispatcher = new RetryAgent(new Agent({ connections: 8 }), {
+     *   retryAfter: true,
+     * });
+     *
+     * new QueueClient({ dispatcher });
+     * ```
+     */
+    dispatcher?: unknown;
 }
 /**
  * Options for creating a {@link PollingQueueClient}.
@@ -241,7 +260,7 @@ interface SendOptions {
      * Message retention time in seconds. After this period, the message expires.
      * @default 86400 (24 hours)
      * @minimum 60 (1 minute)
-     * @maximum 86400 (24 hours)
+     * @maximum 604800 (7 days)
      */
     retentionSeconds?: number;
     /**
@@ -249,7 +268,7 @@ interface SendOptions {
      * The message will not be visible to consumers until the delay has passed.
      * @default 0
      * @minimum 0
-     * @maximum Value of retentionSeconds (delay cannot exceed retention)
+     * @maximum 432000 (5 days, and cannot exceed retentionSeconds)
      */
     delaySeconds?: number;
     /**

package/dist/index.js

@@ -1524,6 +1524,7 @@ var ApiClient = class _ApiClient {
   transport;
   region;
   baseUrlResolver;
+  dispatcher;
   constructor(options) {
     this.region = options.region;
     this.baseUrlResolver = options.resolveBaseUrl;
@@ -1531,6 +1532,7 @@ var ApiClient = class _ApiClient {
     this.customHeaders = options.headers || {};
     this.providedToken = options.token;
     this.transport = options.transport || new JsonTransport();
+    this.dispatcher = options.dispatcher;
     if (options.deploymentId === null) {
       this.pinSends = false;
       this.explicitlyUnpinned = true;
@@ -1553,7 +1555,8 @@ var ApiClient = class _ApiClient {
       token: this.providedToken,
       headers: { ...this.customHeaders },
       deploymentId: this.explicitlyUnpinned ? null : this.resolvedDeploymentId,
-      transport: this.transport
+      transport: this.transport,
+      dispatcher: this.dispatcher
     });
   }
   getRegion() {
@@ -1637,9 +1640,10 @@ Cause: ${cause}`
       }
       console.debug("[VQS Debug] Request:", JSON.stringify(logData, null, 2));
     }
-    init.headers.set("User-Agent", `@vercel/queue/${"0.1.3"}`);
+    init.headers.set("User-Agent", `@vercel/queue/${"0.1.5"}`);
     init.headers.set("Vqs-Client-Ts", (/* @__PURE__ */ new Date()).toISOString());
-    const response = await fetch(url, init);
+    const fetchInit = this.dispatcher ? { ...init, dispatcher: this.dispatcher } : init;
+    const response = await fetch(url, fetchInit);
     if (isDebugEnabled()) {
       const logData = {
         method,