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

package/README.md

@@ -346,7 +346,6 @@ The queue client provides specific error types:
 - **`UnauthorizedError`**: Authentication failed (invalid or missing token)
 - **`ForbiddenError`**: Access denied (wrong environment or project)
 - **`DuplicateMessageError`**: Idempotency key was already used
-- **`ConcurrencyLimitError`**: Too many in-flight messages
 - **`ConsumerDiscoveryError`**: Could not reach the consumer deployment
 - **`ConsumerRegistryNotConfiguredError`**: Project not configured for queues
 - **`InternalServerError`**: Unexpected server error
@@ -357,7 +356,6 @@ Example error handling:
 ```typescript
 import {
   BadRequestError,
-  ConcurrencyLimitError,
   DuplicateMessageError,
   ForbiddenError,
   InternalServerError,
@@ -375,13 +373,6 @@ try {
     console.log("Invalid parameters:", error.message);
   } else if (error instanceof DuplicateMessageError) {
     console.log("Duplicate message:", error.idempotencyKey);
-  } else if (error instanceof ConcurrencyLimitError) {
-    console.log(
-      "Rate limited:",
-      error.currentInflight,
-      "/",
-      error.maxConcurrency,
-    );
   } else if (error instanceof InternalServerError) {
     console.log("Server error - retry with backoff");
   }
@@ -464,11 +455,10 @@ interface MessageMetadata {
 
 #### Receiving Messages
 
-| Parameter                  | Default   | Min | Max    | Notes                       |
-| -------------------------- | --------- | --- | ------ | --------------------------- |
-| `visibilityTimeoutSeconds` | 30        | 0   | 3,600  | 0 = immediate re-visibility |
-| `limit`                    | 1         | 1   | 10     | Messages per request        |
-| `maxConcurrency`           | unlimited | 1   | 10,000 | In-flight message limit     |
+| Parameter                  | Default | Min | Max   | Notes                       |
+| -------------------------- | ------- | --- | ----- | --------------------------- |
+| `visibilityTimeoutSeconds` | 30      | 0   | 3,600 | 0 = immediate re-visibility |
+| `limit`                    | 1       | 1   | 10    | Messages per request        |
 
 #### Visibility Extension
 

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { Q as QueueClientOptions, S as SendMessageOptions, T as Transport, a as SendMessageResponse, R as ReceiveMessagesOptions, M as Message, b as ReceiveMessageByIdOptions, c as ReceiveMessageByIdResponse, D as DeleteMessageOptions, d as DeleteMessageResponse, C as ChangeVisibilityOptions, e as ChangeVisibilityResponse, f as MessageHandler, P as PublishOptions, g as ConsumerGroupOptions } from './types-BLG4ASI_.mjs';
-export { i as BadRequestError, B as BufferTransport, j as ConcurrencyLimitError, k as ConsumerDiscoveryError, l as ConsumerRegistryNotConfiguredError, m as DuplicateMessageError, F as ForbiddenError, I as InternalServerError, n as InvalidLimitError, J as JsonTransport, o as MessageAlreadyProcessedError, p as MessageCorruptedError, q as MessageLockedError, u as MessageMetadata, r as MessageNotAvailableError, s as MessageNotFoundError, t as QueueEmptyError, h as StreamTransport, U as UnauthorizedError } from './types-BLG4ASI_.mjs';
+import { Q as QueueClientOptions, S as SendMessageOptions, T as Transport, a as SendMessageResponse, R as ReceiveMessagesOptions, M as Message, b as ReceiveMessageByIdOptions, c as ReceiveMessageByIdResponse, D as DeleteMessageOptions, d as DeleteMessageResponse, C as ChangeVisibilityOptions, e as ChangeVisibilityResponse, f as MessageHandler, P as PublishOptions, g as ConsumerGroupOptions } from './types-CAA8nT8x.mjs';
+export { i as BadRequestError, B as BufferTransport, j as ConsumerDiscoveryError, k as ConsumerRegistryNotConfiguredError, l as DuplicateMessageError, F as ForbiddenError, I as InternalServerError, m as InvalidLimitError, J as JsonTransport, n as MessageAlreadyProcessedError, o as MessageCorruptedError, p as MessageLockedError, t as MessageMetadata, q as MessageNotAvailableError, r as MessageNotFoundError, s as QueueEmptyError, h as StreamTransport, U as UnauthorizedError } from './types-CAA8nT8x.mjs';
 
 declare class QueueClient {
     private baseUrl;
@@ -42,12 +42,10 @@ declare class QueueClient {
      * @param options.consumerGroup - Consumer group name (pattern: `[A-Za-z0-9_-]+`)
      * @param options.visibilityTimeoutSeconds - Lock duration (default: 30, min: 0, max: 3600)
      * @param options.limit - Max messages to retrieve (default: 1, min: 1, max: 10)
-     * @param options.maxConcurrency - Max in-flight messages (default: unlimited, min: 1)
      * @param transport - Deserializer for message payloads
      * @yields Message objects with payload, messageId, receiptHandle, etc.
      * @throws {QueueEmptyError} When no messages available
      * @throws {InvalidLimitError} When limit is outside 1-10 range
-     * @throws {ConcurrencyLimitError} When maxConcurrency exceeded
      * @throws {BadRequestError} When parameters are invalid
      * @throws {UnauthorizedError} When authentication fails
      * @throws {ForbiddenError} When access is denied
@@ -62,13 +60,11 @@ declare class QueueClient {
      * @param options.consumerGroup - Consumer group name (pattern: `[A-Za-z0-9_-]+`)
      * @param options.messageId - Message ID to retrieve
      * @param options.visibilityTimeoutSeconds - Lock duration (default: 30, min: 0, max: 3600)
-     * @param options.maxConcurrency - Max in-flight messages (default: unlimited, min: 1)
      * @param transport - Deserializer for the message payload
      * @returns Promise with the message
      * @throws {MessageNotFoundError} When message doesn't exist
      * @throws {MessageNotAvailableError} When message is in wrong state or was a duplicate
      * @throws {MessageAlreadyProcessedError} When message was already processed
-     * @throws {ConcurrencyLimitError} When maxConcurrency exceeded
      * @throws {BadRequestError} When parameters are invalid
      * @throws {UnauthorizedError} When authentication fails
      * @throws {ForbiddenError} When access is denied
@@ -397,7 +393,6 @@ interface ReceiveOptions<T = unknown> extends ConsumerGroupOptions<T>, ConsumeOp
  * @param options.transport - Payload deserializer (default: JsonTransport)
  * @returns Promise that resolves when the message is processed and deleted
  * @throws {QueueEmptyError} When no messages available
- * @throws {ConcurrencyLimitError} When maxConcurrency exceeded
  */
 declare function receive<T = unknown>(topicName: string, consumerGroup: string, handler: MessageHandler<T>, options?: ReceiveOptions<T>): Promise<void>;
 /**

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { Q as QueueClientOptions, S as SendMessageOptions, T as Transport, a as SendMessageResponse, R as ReceiveMessagesOptions, M as Message, b as ReceiveMessageByIdOptions, c as ReceiveMessageByIdResponse, D as DeleteMessageOptions, d as DeleteMessageResponse, C as ChangeVisibilityOptions, e as ChangeVisibilityResponse, f as MessageHandler, P as PublishOptions, g as ConsumerGroupOptions } from './types-BLG4ASI_.js';
-export { i as BadRequestError, B as BufferTransport, j as ConcurrencyLimitError, k as ConsumerDiscoveryError, l as ConsumerRegistryNotConfiguredError, m as DuplicateMessageError, F as ForbiddenError, I as InternalServerError, n as InvalidLimitError, J as JsonTransport, o as MessageAlreadyProcessedError, p as MessageCorruptedError, q as MessageLockedError, u as MessageMetadata, r as MessageNotAvailableError, s as MessageNotFoundError, t as QueueEmptyError, h as StreamTransport, U as UnauthorizedError } from './types-BLG4ASI_.js';
+import { Q as QueueClientOptions, S as SendMessageOptions, T as Transport, a as SendMessageResponse, R as ReceiveMessagesOptions, M as Message, b as ReceiveMessageByIdOptions, c as ReceiveMessageByIdResponse, D as DeleteMessageOptions, d as DeleteMessageResponse, C as ChangeVisibilityOptions, e as ChangeVisibilityResponse, f as MessageHandler, P as PublishOptions, g as ConsumerGroupOptions } from './types-CAA8nT8x.js';
+export { i as BadRequestError, B as BufferTransport, j as ConsumerDiscoveryError, k as ConsumerRegistryNotConfiguredError, l as DuplicateMessageError, F as ForbiddenError, I as InternalServerError, m as InvalidLimitError, J as JsonTransport, n as MessageAlreadyProcessedError, o as MessageCorruptedError, p as MessageLockedError, t as MessageMetadata, q as MessageNotAvailableError, r as MessageNotFoundError, s as QueueEmptyError, h as StreamTransport, U as UnauthorizedError } from './types-CAA8nT8x.js';
 
 declare class QueueClient {
     private baseUrl;
@@ -42,12 +42,10 @@ declare class QueueClient {
      * @param options.consumerGroup - Consumer group name (pattern: `[A-Za-z0-9_-]+`)
      * @param options.visibilityTimeoutSeconds - Lock duration (default: 30, min: 0, max: 3600)
      * @param options.limit - Max messages to retrieve (default: 1, min: 1, max: 10)
-     * @param options.maxConcurrency - Max in-flight messages (default: unlimited, min: 1)
      * @param transport - Deserializer for message payloads
      * @yields Message objects with payload, messageId, receiptHandle, etc.
      * @throws {QueueEmptyError} When no messages available
      * @throws {InvalidLimitError} When limit is outside 1-10 range
-     * @throws {ConcurrencyLimitError} When maxConcurrency exceeded
      * @throws {BadRequestError} When parameters are invalid
      * @throws {UnauthorizedError} When authentication fails
      * @throws {ForbiddenError} When access is denied
@@ -62,13 +60,11 @@ declare class QueueClient {
      * @param options.consumerGroup - Consumer group name (pattern: `[A-Za-z0-9_-]+`)
      * @param options.messageId - Message ID to retrieve
      * @param options.visibilityTimeoutSeconds - Lock duration (default: 30, min: 0, max: 3600)
-     * @param options.maxConcurrency - Max in-flight messages (default: unlimited, min: 1)
      * @param transport - Deserializer for the message payload
      * @returns Promise with the message
      * @throws {MessageNotFoundError} When message doesn't exist
      * @throws {MessageNotAvailableError} When message is in wrong state or was a duplicate
      * @throws {MessageAlreadyProcessedError} When message was already processed
-     * @throws {ConcurrencyLimitError} When maxConcurrency exceeded
      * @throws {BadRequestError} When parameters are invalid
      * @throws {UnauthorizedError} When authentication fails
      * @throws {ForbiddenError} When access is denied
@@ -397,7 +393,6 @@ interface ReceiveOptions<T = unknown> extends ConsumerGroupOptions<T>, ConsumeOp
  * @param options.transport - Payload deserializer (default: JsonTransport)
  * @returns Promise that resolves when the message is processed and deleted
  * @throws {QueueEmptyError} When no messages available
- * @throws {ConcurrencyLimitError} When maxConcurrency exceeded
  */
 declare function receive<T = unknown>(topicName: string, consumerGroup: string, handler: MessageHandler<T>, options?: ReceiveOptions<T>): Promise<void>;
 /**

package/dist/index.js

@@ -33,7 +33,6 @@ __export(index_exports, {
   BadRequestError: () => BadRequestError,
   BufferTransport: () => BufferTransport,
   Client: () => Client,
-  ConcurrencyLimitError: () => ConcurrencyLimitError,
   ConsumerDiscoveryError: () => ConsumerDiscoveryError,
   ConsumerRegistryNotConfiguredError: () => ConsumerRegistryNotConfiguredError,
   DuplicateMessageError: () => DuplicateMessageError,
@@ -211,18 +210,6 @@ var MessageAlreadyProcessedError = class extends Error {
     this.name = "MessageAlreadyProcessedError";
   }
 };
-var ConcurrencyLimitError = class extends Error {
-  /** Current number of in-flight messages for this consumer group. */
-  currentInflight;
-  /** Maximum allowed concurrent messages (as configured). */
-  maxConcurrency;
-  constructor(message = "Concurrency limit exceeded", currentInflight, maxConcurrency) {
-    super(message);
-    this.name = "ConcurrencyLimitError";
-    this.currentInflight = currentInflight;
-    this.maxConcurrency = maxConcurrency;
-  }
-};
 var DuplicateMessageError = class extends Error {
   idempotencyKey;
   constructor(message, idempotencyKey) {
@@ -626,13 +613,30 @@ var QueueClient = class {
       payload,
       idempotencyKey,
       retentionSeconds,
-      delaySeconds
+      delaySeconds,
+      headers: optionHeaders
     } = options;
-    const headers = new Headers({
-      Authorization: `Bearer ${await this.getToken()}`,
-      "Content-Type": transport.contentType,
-      ...this.customHeaders
-    });
+    const headers = new Headers();
+    if (this.customHeaders) {
+      for (const [name, value] of Object.entries(this.customHeaders)) {
+        headers.append(name, value);
+      }
+    }
+    if (optionHeaders) {
+      const protectedHeaderNames = /* @__PURE__ */ new Set(["authorization", "content-type"]);
+      const isProtectedHeader = (name) => {
+        const lower = name.toLowerCase();
+        if (protectedHeaderNames.has(lower)) return true;
+        return lower.startsWith("vqs-");
+      };
+      for (const [name, value] of Object.entries(optionHeaders)) {
+        if (!isProtectedHeader(name) && value !== void 0) {
+          headers.append(name, value);
+        }
+      }
+    }
+    headers.set("Authorization", `Bearer ${await this.getToken()}`);
+    headers.set("Content-Type", transport.contentType);
     const deploymentId = this.getSendDeploymentId();
     if (deploymentId) {
       headers.set("Vqs-Deployment-Id", deploymentId);
@@ -690,25 +694,17 @@ var QueueClient = class {
    * @param options.consumerGroup - Consumer group name (pattern: `[A-Za-z0-9_-]+`)
    * @param options.visibilityTimeoutSeconds - Lock duration (default: 30, min: 0, max: 3600)
    * @param options.limit - Max messages to retrieve (default: 1, min: 1, max: 10)
-   * @param options.maxConcurrency - Max in-flight messages (default: unlimited, min: 1)
    * @param transport - Deserializer for message payloads
    * @yields Message objects with payload, messageId, receiptHandle, etc.
    * @throws {QueueEmptyError} When no messages available
    * @throws {InvalidLimitError} When limit is outside 1-10 range
-   * @throws {ConcurrencyLimitError} When maxConcurrency exceeded
    * @throws {BadRequestError} When parameters are invalid
    * @throws {UnauthorizedError} When authentication fails
    * @throws {ForbiddenError} When access is denied
    * @throws {InternalServerError} When server encounters an error
    */
   async *receiveMessages(options, transport) {
-    const {
-      queueName,
-      consumerGroup,
-      visibilityTimeoutSeconds,
-      limit,
-      maxConcurrency
-    } = options;
+    const { queueName, consumerGroup, visibilityTimeoutSeconds, limit } = options;
     if (limit !== void 0 && (limit < 1 || limit > 10)) {
       throw new InvalidLimitError(limit);
     }
@@ -726,9 +722,6 @@ var QueueClient = class {
     if (limit !== void 0) {
       headers.set("Vqs-Max-Messages", limit.toString());
     }
-    if (maxConcurrency !== void 0) {
-      headers.set("Vqs-Max-Concurrency", maxConcurrency.toString());
-    }
     const effectiveDeploymentId = this.getConsumeDeploymentId();
     if (effectiveDeploymentId) {
       headers.set("Vqs-Deployment-Id", effectiveDeploymentId);
@@ -745,18 +738,6 @@ var QueueClient = class {
     }
     if (!response.ok) {
       const errorText = await response.text();
-      if (response.status === 429) {
-        let errorData = {};
-        try {
-          errorData = JSON.parse(errorText);
-        } catch {
-        }
-        throw new ConcurrencyLimitError(
-          errorData.error || "Concurrency limit exceeded or throttled",
-          errorData.currentInflight,
-          errorData.maxConcurrency
-        );
-      }
       throwCommonHttpError(
         response.status,
         response.statusText,
@@ -794,26 +775,18 @@ var QueueClient = class {
    * @param options.consumerGroup - Consumer group name (pattern: `[A-Za-z0-9_-]+`)
    * @param options.messageId - Message ID to retrieve
    * @param options.visibilityTimeoutSeconds - Lock duration (default: 30, min: 0, max: 3600)
-   * @param options.maxConcurrency - Max in-flight messages (default: unlimited, min: 1)
    * @param transport - Deserializer for the message payload
    * @returns Promise with the message
    * @throws {MessageNotFoundError} When message doesn't exist
    * @throws {MessageNotAvailableError} When message is in wrong state or was a duplicate
    * @throws {MessageAlreadyProcessedError} When message was already processed
-   * @throws {ConcurrencyLimitError} When maxConcurrency exceeded
    * @throws {BadRequestError} When parameters are invalid
    * @throws {UnauthorizedError} When authentication fails
    * @throws {ForbiddenError} When access is denied
    * @throws {InternalServerError} When server encounters an error
    */
   async receiveMessageById(options, transport) {
-    const {
-      queueName,
-      consumerGroup,
-      messageId,
-      visibilityTimeoutSeconds,
-      maxConcurrency
-    } = options;
+    const { queueName, consumerGroup, messageId, visibilityTimeoutSeconds } = options;
     const headers = new Headers({
       Authorization: `Bearer ${await this.getToken()}`,
       Accept: "multipart/mixed",
@@ -825,9 +798,6 @@ var QueueClient = class {
         visibilityTimeoutSeconds.toString()
       );
     }
-    if (maxConcurrency !== void 0) {
-      headers.set("Vqs-Max-Concurrency", maxConcurrency.toString());
-    }
     const effectiveDeploymentId = this.getConsumeDeploymentId();
     if (effectiveDeploymentId) {
       headers.set("Vqs-Deployment-Id", effectiveDeploymentId);
@@ -861,18 +831,6 @@ var QueueClient = class {
       if (response.status === 410) {
         throw new MessageAlreadyProcessedError(messageId);
       }
-      if (response.status === 429) {
-        let errorData = {};
-        try {
-          errorData = JSON.parse(errorText);
-        } catch {
-        }
-        throw new ConcurrencyLimitError(
-          errorData.error || "Concurrency limit exceeded or throttled",
-          errorData.currentInflight,
-          errorData.maxConcurrency
-        );
-      }
       throwCommonHttpError(
         response.status,
         response.statusText,
@@ -1279,7 +1237,8 @@ var Topic = class {
         payload,
         idempotencyKey: options?.idempotencyKey,
         retentionSeconds: options?.retentionSeconds,
-        delaySeconds: options?.delaySeconds
+        delaySeconds: options?.delaySeconds,
+        headers: options?.headers
       },
       this.transport
     );
@@ -1462,7 +1421,8 @@ async function send(topicName, payload, options) {
       payload,
       idempotencyKey: options?.idempotencyKey,
       retentionSeconds: options?.retentionSeconds,
-      delaySeconds: options?.delaySeconds
+      delaySeconds: options?.delaySeconds,
+      headers: options?.headers
     },
     transport
   );
@@ -1552,7 +1512,6 @@ var Client = class {
   BadRequestError,
   BufferTransport,
   Client,
-  ConcurrencyLimitError,
   ConsumerDiscoveryError,
   ConsumerRegistryNotConfiguredError,
   DuplicateMessageError,