@upstash/qstash 2.7.20 → 2.7.22

package/{chunk-3XWIKEL6.mjs → chunk-3N4XI2LB.mjs}

@@ -1,7 +1,7 @@
 import {
   Receiver,
   serve
-} from "./chunk-WXLHIS4A.mjs";
+} from "./chunk-MQSZDXFZ.mjs";
 
 // node_modules/defu/dist/defu.mjs
 function isPlainObject(value) {

package/{chunk-WXLHIS4A.mjs → chunk-MQSZDXFZ.mjs}

@@ -85,7 +85,8 @@ var DLQ = class {
       messages: messagesPayload.messages.map((message) => {
         return {
           ...message,
-          urlGroup: message.topicName
+          urlGroup: message.topicName,
+          ratePerSecond: "rate" in message ? message.rate : void 0
         };
       }),
       cursor: messagesPayload.cursor
@@ -515,7 +516,8 @@ var Messages = class {
     });
     const message = {
       ...messagePayload,
-      urlGroup: messagePayload.topicName
+      urlGroup: messagePayload.topicName,
+      ratePerSecond: "rate" in messagePayload ? messagePayload.rate : void 0
     };
     return message;
   }
@@ -772,6 +774,19 @@ function processHeaders(request) {
       headers.set("Upstash-Timeout", `${request.timeout}s`);
     }
   }
+  if (request.flowControl?.key) {
+    const parallelism = request.flowControl.parallelism?.toString();
+    const rate = request.flowControl.ratePerSecond?.toString();
+    const controlValue = [
+      parallelism ? `parallelism=${parallelism}` : void 0,
+      rate ? `rate=${rate}` : void 0
+    ].filter(Boolean);
+    if (controlValue.length === 0) {
+      throw new QstashError("Provide at least one of parallelism or ratePerSecond for flowControl");
+    }
+    headers.set("Upstash-Flow-Control-Key", request.flowControl.key);
+    headers.set("Upstash-Flow-Control-Value", controlValue.join(", "));
+  }
   return headers;
 }
 function getRequestPath(request) {
@@ -988,6 +1003,21 @@ var Schedules = class {
     if (request.queueName !== void 0) {
       headers.set("Upstash-Queue-Name", request.queueName);
     }
+    if (request.flowControl?.key) {
+      const parallelism = request.flowControl.parallelism?.toString();
+      const rate = request.flowControl.ratePerSecond?.toString();
+      const controlValue = [
+        parallelism ? `parallelism=${parallelism}` : void 0,
+        rate ? `rate=${rate}` : void 0
+      ].filter(Boolean);
+      if (controlValue.length === 0) {
+        throw new QstashError(
+          "Provide at least one of parallelism or ratePerSecond for flowControl"
+        );
+      }
+      headers.set("Upstash-Flow-Control-Key", request.flowControl.key);
+      headers.set("Upstash-Flow-Control-Value", controlValue.join(", "));
+    }
     return await this.http.request({
       method: "POST",
       headers: wrapWithGlobalHeaders(headers, this.http.headers),
@@ -999,19 +1029,27 @@ var Schedules = class {
    * Get a schedule
    */
   async get(scheduleId) {
-    return await this.http.request({
+    const schedule = await this.http.request({
       method: "GET",
       path: ["v2", "schedules", scheduleId]
     });
+    if ("rate" in schedule)
+      schedule.ratePerSecond = schedule.rate;
+    return schedule;
   }
   /**
    * List your schedules
    */
   async list() {
-    return await this.http.request({
+    const schedules = await this.http.request({
       method: "GET",
       path: ["v2", "schedules"]
     });
+    for (const schedule of schedules) {
+      if ("rate" in schedule)
+        schedule.ratePerSecond = schedule.rate;
+    }
+    return schedules;
   }
   /**
    * Delete a schedule
@@ -1113,14 +1151,22 @@ var Client = class {
   http;
   token;
   constructor(config) {
+    const environment = typeof process === "undefined" ? {} : process.env;
+    const baseUrl = config?.baseUrl ? config.baseUrl.replace(/\/$/, "") : environment.QSTASH_URL ?? "https://qstash.upstash.io";
+    const token = config?.token ?? environment.QSTASH_TOKEN;
     this.http = new HttpClient({
-      retry: config.retry,
-      baseUrl: config.baseUrl ? config.baseUrl.replace(/\/$/, "") : "https://qstash.upstash.io",
-      authorization: `Bearer ${config.token}`,
+      retry: config?.retry,
+      baseUrl,
+      authorization: `Bearer ${token}`,
       //@ts-expect-error caused by undici and bunjs type overlap
-      headers: prefixHeaders(new Headers(config.headers))
+      headers: prefixHeaders(new Headers(config?.headers ?? {}))
     });
-    this.token = config.token;
+    if (!token) {
+      console.warn(
+        "[Upstash QStash] client token is not set. Either pass a token or set QSTASH_TOKEN env variable."
+      );
+    }
+    this.token = token;
   }
   /**
    * Access the urlGroup API.

package/{chunk-JSD5ZIXP.mjs → chunk-RQQYKT2M.mjs}

@@ -1,6 +1,6 @@
 import {
   BaseProvider
-} from "./chunk-WXLHIS4A.mjs";
+} from "./chunk-MQSZDXFZ.mjs";
 
 // src/client/api/email.ts
 var EmailProvider = class extends BaseProvider {

package/{client-CdYtp0E1.d.ts → client-vTeVVeh7.d.mts}

@@ -105,6 +105,30 @@ type RateLimit = {
     remaining: string | null;
     reset: string | null;
 };
+type FlowControl = {
+    /**
+     * flow control key
+     */
+    key: string;
+} & ({
+    /**
+     * number of requests which can be active with the same flow control key
+     */
+    parallelism: number;
+    /**
+     * number of requests to activate per second with the same flow control key
+     */
+    ratePerSecond?: number;
+} | {
+    /**
+     * number of requests which can be active with the same flow control key
+     */
+    parallelism?: number;
+    /**
+     * number of requests to activate per second with the same flow control key
+     */
+    ratePerSecond: number;
+});
 
 type ProviderInfo = {
     /**
@@ -457,6 +481,18 @@ type Message = {
      * IP address of the publisher of this message
      */
     callerIp?: string;
+    /**
+     * flow control key
+     */
+    flowControlKey: string;
+    /**
+     * number of requests which can be active with the same flow control key
+     */
+    parallelism?: number;
+    /**
+     * number of requests to activate per second with the same flow control key
+     */
+    ratePerSecond?: number;
 };
 type MessagePayload = Omit<Message, "urlGroup"> & {
     topicName: string;
@@ -693,6 +729,9 @@ type Schedule = {
     callerIp?: string;
     isPaused: boolean;
     queueName?: string;
+    flowControlKey?: string;
+    parallelism?: number;
+    ratePerSecond?: number;
 };
 type CreateScheduleRequest = {
     /**
@@ -781,6 +820,11 @@ type CreateScheduleRequest = {
      * Queue name to schedule the message over.
      */
     queueName?: string;
+    /**
+     * Settings for controlling the number of active requests
+     * and number of requests per second with the same key.
+     */
+    flowControl?: FlowControl;
 };
 declare class Schedules {
     private readonly http;
@@ -1564,13 +1608,20 @@ type ClientConfig = {
      *
      * This is only used for testing.
      *
+     * If not provided, value of the QSTASH_URL environment
+     * variable will be used if it exists. If the QSTASH_URL
+     * environment variable isn't set either, default is used.
+     *
      * @default "https://qstash.upstash.io"
      */
     baseUrl?: string;
     /**
      * The authorization token from the upstash console.
+     *
+     * If not provided, value of the QSTASH_TOKEN environment
+     * variable will be used if it exists.
      */
-    token: string;
+    token?: string;
     /**
      * Configure how the client should retry requests.
      */
@@ -1682,6 +1733,11 @@ type PublishRequest<TBody = BodyInit> = {
      * @default undefined
      */
     timeout?: Duration | number;
+    /**
+     * Settings for controlling the number of active requests
+     * and number of requests per second with the same key.
+     */
+    flowControl?: FlowControl;
 } & ({
     /**
      * The url where the message should be sent to.
@@ -1792,7 +1848,7 @@ type QueueRequest = {
 declare class Client {
     http: Requester;
     private token;
-    constructor(config: ClientConfig);
+    constructor(config?: ClientConfig);
     /**
      * Access the urlGroup API.
      *
@@ -1896,4 +1952,4 @@ type PublishResponse<TRequest> = TRequest extends {
     urlGroup: string;
 } ? PublishToUrlGroupsResponse : PublishToApiResponse;
 
-export { upstash as $, type AddEndpointsRequest as A, BaseProvider as B, type ChatRateLimit as C, type RequestOptions as D, type EmailOwner as E, type FailureFunctionPayload as F, type GetEventsResponse as G, type HTTPMethods as H, Chat as I, type ChatCompletionMessage as J, type ChatCompletion as K, type LLMOwner as L, type Message as M, type ChatCompletionChunk as N, type StreamEnabled as O, type ProviderInfo as P, type QueueRequest as Q, type RateLimit as R, type Step as S, type StreamDisabled as T, type UrlGroup as U, type VerifyRequest as V, type WithCursor as W, type StreamParameter as X, type OpenAIChatModel as Y, type PromptChatRequest as Z, type ChatRequest as _, type ReceiverConfig as a, openai as a0, anthropic as a1, custom as a2, type RouteFunction as a3, type WorkflowServeOptions as a4, Workflow as a5, processOptions as a6, serve as a7, WorkflowContext as a8, DisabledWorkflowContext as a9, type WorkflowClient as aa, type WorkflowReceiver as ab, StepTypes as ac, type StepType as ad, type RawStep as ae, type SyncStepFunction as af, type AsyncStepFunction as ag, type StepFunction as ah, type ParallelCallState as ai, type FinishCondition as aj, type RequiredExceptFields as ak, type LogLevel as al, type WorkflowLoggerOptions as am, WorkflowLogger as an, SignatureError as b, Receiver as c, type PublishBatchRequest as d, type PublishRequest as e, type PublishJsonRequest as f, type EventsRequest as g, Client as h, type PublishToApiResponse as i, type PublishToUrlResponse as j, type PublishToUrlGroupsResponse as k, type PublishResponse as l, type MessagePayload as m, Messages as n, type Schedule as o, type CreateScheduleRequest as p, Schedules as q, type Endpoint as r, type RemoveEndpointsRequest as s, UrlGroups as t, type State as u, type Event as v, type EventPayload as w, type GetEventsPayload as x, type BodyInit as y, type HeadersInit as z };
+export { type ChatRequest as $, type AddEndpointsRequest as A, BaseProvider as B, type ChatRateLimit as C, type RequestOptions as D, type EmailOwner as E, type FailureFunctionPayload as F, type GetEventsResponse as G, type HTTPMethods as H, type FlowControl as I, Chat as J, type ChatCompletionMessage as K, type LLMOwner as L, type Message as M, type ChatCompletion as N, type ChatCompletionChunk as O, type ProviderInfo as P, type QueueRequest as Q, type RateLimit as R, type Step as S, type StreamEnabled as T, type UrlGroup as U, type VerifyRequest as V, type WithCursor as W, type StreamDisabled as X, type StreamParameter as Y, type OpenAIChatModel as Z, type PromptChatRequest as _, type ReceiverConfig as a, upstash as a0, openai as a1, anthropic as a2, custom as a3, type RouteFunction as a4, type WorkflowServeOptions as a5, Workflow as a6, processOptions as a7, serve as a8, WorkflowContext as a9, DisabledWorkflowContext as aa, type WorkflowClient as ab, type WorkflowReceiver as ac, StepTypes as ad, type StepType as ae, type RawStep as af, type SyncStepFunction as ag, type AsyncStepFunction as ah, type StepFunction as ai, type ParallelCallState as aj, type FinishCondition as ak, type RequiredExceptFields as al, type LogLevel as am, type WorkflowLoggerOptions as an, WorkflowLogger as ao, SignatureError as b, Receiver as c, type PublishBatchRequest as d, type PublishRequest as e, type PublishJsonRequest as f, type EventsRequest as g, Client as h, type PublishToApiResponse as i, type PublishToUrlResponse as j, type PublishToUrlGroupsResponse as k, type PublishResponse as l, type MessagePayload as m, Messages as n, type Schedule as o, type CreateScheduleRequest as p, Schedules as q, type Endpoint as r, type RemoveEndpointsRequest as s, UrlGroups as t, type State as u, type Event as v, type EventPayload as w, type GetEventsPayload as x, type BodyInit as y, type HeadersInit as z };

package/{client-CdYtp0E1.d.mts → client-vTeVVeh7.d.ts}

@@ -105,6 +105,30 @@ type RateLimit = {
     remaining: string | null;
     reset: string | null;
 };
+type FlowControl = {
+    /**
+     * flow control key
+     */
+    key: string;
+} & ({
+    /**
+     * number of requests which can be active with the same flow control key
+     */
+    parallelism: number;
+    /**
+     * number of requests to activate per second with the same flow control key
+     */
+    ratePerSecond?: number;
+} | {
+    /**
+     * number of requests which can be active with the same flow control key
+     */
+    parallelism?: number;
+    /**
+     * number of requests to activate per second with the same flow control key
+     */
+    ratePerSecond: number;
+});
 
 type ProviderInfo = {
     /**
@@ -457,6 +481,18 @@ type Message = {
      * IP address of the publisher of this message
      */
     callerIp?: string;
+    /**
+     * flow control key
+     */
+    flowControlKey: string;
+    /**
+     * number of requests which can be active with the same flow control key
+     */
+    parallelism?: number;
+    /**
+     * number of requests to activate per second with the same flow control key
+     */
+    ratePerSecond?: number;
 };
 type MessagePayload = Omit<Message, "urlGroup"> & {
     topicName: string;
@@ -693,6 +729,9 @@ type Schedule = {
     callerIp?: string;
     isPaused: boolean;
     queueName?: string;
+    flowControlKey?: string;
+    parallelism?: number;
+    ratePerSecond?: number;
 };
 type CreateScheduleRequest = {
     /**
@@ -781,6 +820,11 @@ type CreateScheduleRequest = {
      * Queue name to schedule the message over.
      */
     queueName?: string;
+    /**
+     * Settings for controlling the number of active requests
+     * and number of requests per second with the same key.
+     */
+    flowControl?: FlowControl;
 };
 declare class Schedules {
     private readonly http;
@@ -1564,13 +1608,20 @@ type ClientConfig = {
      *
      * This is only used for testing.
      *
+     * If not provided, value of the QSTASH_URL environment
+     * variable will be used if it exists. If the QSTASH_URL
+     * environment variable isn't set either, default is used.
+     *
      * @default "https://qstash.upstash.io"
      */
     baseUrl?: string;
     /**
      * The authorization token from the upstash console.
+     *
+     * If not provided, value of the QSTASH_TOKEN environment
+     * variable will be used if it exists.
      */
-    token: string;
+    token?: string;
     /**
      * Configure how the client should retry requests.
      */
@@ -1682,6 +1733,11 @@ type PublishRequest<TBody = BodyInit> = {
      * @default undefined
      */
     timeout?: Duration | number;
+    /**
+     * Settings for controlling the number of active requests
+     * and number of requests per second with the same key.
+     */
+    flowControl?: FlowControl;
 } & ({
     /**
      * The url where the message should be sent to.
@@ -1792,7 +1848,7 @@ type QueueRequest = {
 declare class Client {
     http: Requester;
     private token;
-    constructor(config: ClientConfig);
+    constructor(config?: ClientConfig);
     /**
      * Access the urlGroup API.
      *
@@ -1896,4 +1952,4 @@ type PublishResponse<TRequest> = TRequest extends {
     urlGroup: string;
 } ? PublishToUrlGroupsResponse : PublishToApiResponse;
 
-export { upstash as $, type AddEndpointsRequest as A, BaseProvider as B, type ChatRateLimit as C, type RequestOptions as D, type EmailOwner as E, type FailureFunctionPayload as F, type GetEventsResponse as G, type HTTPMethods as H, Chat as I, type ChatCompletionMessage as J, type ChatCompletion as K, type LLMOwner as L, type Message as M, type ChatCompletionChunk as N, type StreamEnabled as O, type ProviderInfo as P, type QueueRequest as Q, type RateLimit as R, type Step as S, type StreamDisabled as T, type UrlGroup as U, type VerifyRequest as V, type WithCursor as W, type StreamParameter as X, type OpenAIChatModel as Y, type PromptChatRequest as Z, type ChatRequest as _, type ReceiverConfig as a, openai as a0, anthropic as a1, custom as a2, type RouteFunction as a3, type WorkflowServeOptions as a4, Workflow as a5, processOptions as a6, serve as a7, WorkflowContext as a8, DisabledWorkflowContext as a9, type WorkflowClient as aa, type WorkflowReceiver as ab, StepTypes as ac, type StepType as ad, type RawStep as ae, type SyncStepFunction as af, type AsyncStepFunction as ag, type StepFunction as ah, type ParallelCallState as ai, type FinishCondition as aj, type RequiredExceptFields as ak, type LogLevel as al, type WorkflowLoggerOptions as am, WorkflowLogger as an, SignatureError as b, Receiver as c, type PublishBatchRequest as d, type PublishRequest as e, type PublishJsonRequest as f, type EventsRequest as g, Client as h, type PublishToApiResponse as i, type PublishToUrlResponse as j, type PublishToUrlGroupsResponse as k, type PublishResponse as l, type MessagePayload as m, Messages as n, type Schedule as o, type CreateScheduleRequest as p, Schedules as q, type Endpoint as r, type RemoveEndpointsRequest as s, UrlGroups as t, type State as u, type Event as v, type EventPayload as w, type GetEventsPayload as x, type BodyInit as y, type HeadersInit as z };
+export { type ChatRequest as $, type AddEndpointsRequest as A, BaseProvider as B, type ChatRateLimit as C, type RequestOptions as D, type EmailOwner as E, type FailureFunctionPayload as F, type GetEventsResponse as G, type HTTPMethods as H, type FlowControl as I, Chat as J, type ChatCompletionMessage as K, type LLMOwner as L, type Message as M, type ChatCompletion as N, type ChatCompletionChunk as O, type ProviderInfo as P, type QueueRequest as Q, type RateLimit as R, type Step as S, type StreamEnabled as T, type UrlGroup as U, type VerifyRequest as V, type WithCursor as W, type StreamDisabled as X, type StreamParameter as Y, type OpenAIChatModel as Z, type PromptChatRequest as _, type ReceiverConfig as a, upstash as a0, openai as a1, anthropic as a2, custom as a3, type RouteFunction as a4, type WorkflowServeOptions as a5, Workflow as a6, processOptions as a7, serve as a8, WorkflowContext as a9, DisabledWorkflowContext as aa, type WorkflowClient as ab, type WorkflowReceiver as ac, StepTypes as ad, type StepType as ae, type RawStep as af, type SyncStepFunction as ag, type AsyncStepFunction as ah, type StepFunction as ai, type ParallelCallState as aj, type FinishCondition as ak, type RequiredExceptFields as al, type LogLevel as am, type WorkflowLoggerOptions as an, WorkflowLogger as ao, SignatureError as b, Receiver as c, type PublishBatchRequest as d, type PublishRequest as e, type PublishJsonRequest as f, type EventsRequest as g, Client as h, type PublishToApiResponse as i, type PublishToUrlResponse as j, type PublishToUrlGroupsResponse as k, type PublishResponse as l, type MessagePayload as m, Messages as n, type Schedule as o, type CreateScheduleRequest as p, Schedules as q, type Endpoint as r, type RemoveEndpointsRequest as s, UrlGroups as t, type State as u, type Event as v, type EventPayload as w, type GetEventsPayload as x, type BodyInit as y, type HeadersInit as z };

package/cloudflare.d.mts

@@ -1,4 +1,4 @@
-import { a3 as RouteFunction, a4 as WorkflowServeOptions } from './client-CdYtp0E1.mjs';
+import { a4 as RouteFunction, a5 as WorkflowServeOptions } from './client-vTeVVeh7.mjs';
 import 'neverthrow';
 
 type WorkflowBindings = {

package/cloudflare.d.ts

@@ -1,4 +1,4 @@
-import { a3 as RouteFunction, a4 as WorkflowServeOptions } from './client-CdYtp0E1.js';
+import { a4 as RouteFunction, a5 as WorkflowServeOptions } from './client-vTeVVeh7.js';
 import 'neverthrow';
 
 type WorkflowBindings = {

package/cloudflare.js

@@ -121,7 +121,8 @@ var DLQ = class {
       messages: messagesPayload.messages.map((message) => {
         return {
           ...message,
-          urlGroup: message.topicName
+          urlGroup: message.topicName,
+          ratePerSecond: "rate" in message ? message.rate : void 0
         };
       }),
       cursor: messagesPayload.cursor
@@ -551,7 +552,8 @@ var Messages = class {
     });
     const message = {
       ...messagePayload,
-      urlGroup: messagePayload.topicName
+      urlGroup: messagePayload.topicName,
+      ratePerSecond: "rate" in messagePayload ? messagePayload.rate : void 0
     };
     return message;
   }
@@ -792,6 +794,19 @@ function processHeaders(request) {
       headers.set("Upstash-Timeout", `${request.timeout}s`);
     }
   }
+  if (request.flowControl?.key) {
+    const parallelism = request.flowControl.parallelism?.toString();
+    const rate = request.flowControl.ratePerSecond?.toString();
+    const controlValue = [
+      parallelism ? `parallelism=${parallelism}` : void 0,
+      rate ? `rate=${rate}` : void 0
+    ].filter(Boolean);
+    if (controlValue.length === 0) {
+      throw new QstashError("Provide at least one of parallelism or ratePerSecond for flowControl");
+    }
+    headers.set("Upstash-Flow-Control-Key", request.flowControl.key);
+    headers.set("Upstash-Flow-Control-Value", controlValue.join(", "));
+  }
   return headers;
 }
 function getRequestPath(request) {
@@ -1008,6 +1023,21 @@ var Schedules = class {
     if (request.queueName !== void 0) {
       headers.set("Upstash-Queue-Name", request.queueName);
     }
+    if (request.flowControl?.key) {
+      const parallelism = request.flowControl.parallelism?.toString();
+      const rate = request.flowControl.ratePerSecond?.toString();
+      const controlValue = [
+        parallelism ? `parallelism=${parallelism}` : void 0,
+        rate ? `rate=${rate}` : void 0
+      ].filter(Boolean);
+      if (controlValue.length === 0) {
+        throw new QstashError(
+          "Provide at least one of parallelism or ratePerSecond for flowControl"
+        );
+      }
+      headers.set("Upstash-Flow-Control-Key", request.flowControl.key);
+      headers.set("Upstash-Flow-Control-Value", controlValue.join(", "));
+    }
     return await this.http.request({
       method: "POST",
       headers: wrapWithGlobalHeaders(headers, this.http.headers),
@@ -1019,19 +1049,27 @@ var Schedules = class {
    * Get a schedule
    */
   async get(scheduleId) {
-    return await this.http.request({
+    const schedule = await this.http.request({
       method: "GET",
       path: ["v2", "schedules", scheduleId]
     });
+    if ("rate" in schedule)
+      schedule.ratePerSecond = schedule.rate;
+    return schedule;
   }
   /**
    * List your schedules
    */
   async list() {
-    return await this.http.request({
+    const schedules = await this.http.request({
       method: "GET",
       path: ["v2", "schedules"]
     });
+    for (const schedule of schedules) {
+      if ("rate" in schedule)
+        schedule.ratePerSecond = schedule.rate;
+    }
+    return schedules;
   }
   /**
    * Delete a schedule
@@ -1133,14 +1171,22 @@ var Client = class {
   http;
   token;
   constructor(config) {
+    const environment = typeof process === "undefined" ? {} : process.env;
+    const baseUrl = config?.baseUrl ? config.baseUrl.replace(/\/$/, "") : environment.QSTASH_URL ?? "https://qstash.upstash.io";
+    const token = config?.token ?? environment.QSTASH_TOKEN;
     this.http = new HttpClient({
-      retry: config.retry,
-      baseUrl: config.baseUrl ? config.baseUrl.replace(/\/$/, "") : "https://qstash.upstash.io",
-      authorization: `Bearer ${config.token}`,
+      retry: config?.retry,
+      baseUrl,
+      authorization: `Bearer ${token}`,
       //@ts-expect-error caused by undici and bunjs type overlap
-      headers: prefixHeaders(new Headers(config.headers))
+      headers: prefixHeaders(new Headers(config?.headers ?? {}))
     });
-    this.token = config.token;
+    if (!token) {
+      console.warn(
+        "[Upstash QStash] client token is not set. Either pass a token or set QSTASH_TOKEN env variable."
+      );
+    }
+    this.token = token;
   }
   /**
    * Access the urlGroup API.

package/cloudflare.mjs

@@ -1,6 +1,6 @@
 import {
   serve
-} from "./chunk-WXLHIS4A.mjs";
+} from "./chunk-MQSZDXFZ.mjs";
 
 // platforms/cloudflare.ts
 var getArgs = (args) => {

package/h3.d.mts

@@ -1,6 +1,6 @@
 import * as h3 from 'h3';
 import { H3Event } from 'h3';
-import { a3 as RouteFunction, a4 as WorkflowServeOptions } from './client-CdYtp0E1.mjs';
+import { a4 as RouteFunction, a5 as WorkflowServeOptions } from './client-vTeVVeh7.mjs';
 import 'neverthrow';
 
 type VerifySignatureConfig = {

package/h3.d.ts

@@ -1,6 +1,6 @@
 import * as h3 from 'h3';
 import { H3Event } from 'h3';
-import { a3 as RouteFunction, a4 as WorkflowServeOptions } from './client-CdYtp0E1.js';
+import { a4 as RouteFunction, a5 as WorkflowServeOptions } from './client-vTeVVeh7.js';
 import 'neverthrow';
 
 type VerifySignatureConfig = {

package/h3.js

@@ -445,7 +445,8 @@ var DLQ = class {
       messages: messagesPayload.messages.map((message) => {
         return {
           ...message,
-          urlGroup: message.topicName
+          urlGroup: message.topicName,
+          ratePerSecond: "rate" in message ? message.rate : void 0
         };
       }),
       cursor: messagesPayload.cursor
@@ -875,7 +876,8 @@ var Messages = class {
     });
     const message = {
       ...messagePayload,
-      urlGroup: messagePayload.topicName
+      urlGroup: messagePayload.topicName,
+      ratePerSecond: "rate" in messagePayload ? messagePayload.rate : void 0
     };
     return message;
   }
@@ -1116,6 +1118,19 @@ function processHeaders(request) {
       headers.set("Upstash-Timeout", `${request.timeout}s`);
     }
   }
+  if (request.flowControl?.key) {
+    const parallelism = request.flowControl.parallelism?.toString();
+    const rate = request.flowControl.ratePerSecond?.toString();
+    const controlValue = [
+      parallelism ? `parallelism=${parallelism}` : void 0,
+      rate ? `rate=${rate}` : void 0
+    ].filter(Boolean);
+    if (controlValue.length === 0) {
+      throw new QstashError("Provide at least one of parallelism or ratePerSecond for flowControl");
+    }
+    headers.set("Upstash-Flow-Control-Key", request.flowControl.key);
+    headers.set("Upstash-Flow-Control-Value", controlValue.join(", "));
+  }
   return headers;
 }
 function getRequestPath(request) {
@@ -1332,6 +1347,21 @@ var Schedules = class {
     if (request.queueName !== void 0) {
       headers.set("Upstash-Queue-Name", request.queueName);
     }
+    if (request.flowControl?.key) {
+      const parallelism = request.flowControl.parallelism?.toString();
+      const rate = request.flowControl.ratePerSecond?.toString();
+      const controlValue = [
+        parallelism ? `parallelism=${parallelism}` : void 0,
+        rate ? `rate=${rate}` : void 0
+      ].filter(Boolean);
+      if (controlValue.length === 0) {
+        throw new QstashError(
+          "Provide at least one of parallelism or ratePerSecond for flowControl"
+        );
+      }
+      headers.set("Upstash-Flow-Control-Key", request.flowControl.key);
+      headers.set("Upstash-Flow-Control-Value", controlValue.join(", "));
+    }
     return await this.http.request({
       method: "POST",
       headers: wrapWithGlobalHeaders(headers, this.http.headers),
@@ -1343,19 +1373,27 @@ var Schedules = class {
    * Get a schedule
    */
   async get(scheduleId) {
-    return await this.http.request({
+    const schedule = await this.http.request({
       method: "GET",
       path: ["v2", "schedules", scheduleId]
     });
+    if ("rate" in schedule)
+      schedule.ratePerSecond = schedule.rate;
+    return schedule;
   }
   /**
    * List your schedules
    */
   async list() {
-    return await this.http.request({
+    const schedules = await this.http.request({
       method: "GET",
       path: ["v2", "schedules"]
     });
+    for (const schedule of schedules) {
+      if ("rate" in schedule)
+        schedule.ratePerSecond = schedule.rate;
+    }
+    return schedules;
   }
   /**
    * Delete a schedule
@@ -2843,14 +2881,22 @@ var Client = class {
   http;
   token;
   constructor(config) {
+    const environment = typeof process === "undefined" ? {} : process.env;
+    const baseUrl = config?.baseUrl ? config.baseUrl.replace(/\/$/, "") : environment.QSTASH_URL ?? "https://qstash.upstash.io";
+    const token = config?.token ?? environment.QSTASH_TOKEN;
     this.http = new HttpClient({
-      retry: config.retry,
-      baseUrl: config.baseUrl ? config.baseUrl.replace(/\/$/, "") : "https://qstash.upstash.io",
-      authorization: `Bearer ${config.token}`,
+      retry: config?.retry,
+      baseUrl,
+      authorization: `Bearer ${token}`,
       //@ts-expect-error caused by undici and bunjs type overlap
-      headers: prefixHeaders(new Headers(config.headers))
+      headers: prefixHeaders(new Headers(config?.headers ?? {}))
     });
-    this.token = config.token;
+    if (!token) {
+      console.warn(
+        "[Upstash QStash] client token is not set. Either pass a token or set QSTASH_TOKEN env variable."
+      );
+    }
+    this.token = token;
   }
   /**
    * Access the urlGroup API.

package/h3.mjs

@@ -1,9 +1,9 @@
 import {
   serve,
   verifySignatureH3
-} from "./chunk-3XWIKEL6.mjs";
-import "./chunk-JSD5ZIXP.mjs";
-import "./chunk-WXLHIS4A.mjs";
+} from "./chunk-3N4XI2LB.mjs";
+import "./chunk-RQQYKT2M.mjs";
+import "./chunk-MQSZDXFZ.mjs";
 export {
   serve,
   verifySignatureH3