@upstash/qstash 2.10.1 → 2.11.1

package/{client-CsM1dTnz.d.ts → client-BHOXiX0H.d.mts}

@@ -18,6 +18,15 @@ type ReceiverConfig = {
      * and UPSTASH_REGION header.
      */
     nextSigningKey?: string;
+    /**
+     * Controls the local dev server signing keys.
+     * - `true`: use dev server signing keys
+     * - `false`: never use dev server signing keys (ignores QSTASH_DEV env var)
+     * - `undefined`: check QSTASH_DEV env var
+     *
+     * @default undefined
+     */
+    devMode?: boolean;
 };
 type VerifyRequest = {
     /**
@@ -56,6 +65,7 @@ declare class SignatureError extends Error {
 declare class Receiver {
     private readonly currentSigningKey?;
     private readonly nextSigningKey?;
+    private readonly devMode?;
     constructor(config?: ReceiverConfig);
     /**
      * Verify the signature of a request.
@@ -91,7 +101,19 @@ type Log = {
     endpointName?: string;
     header?: Record<string, string>;
     body?: string;
+    /**
+     * Label of the message.
+     *
+     * @deprecated Use `labels` instead. When a message has multiple labels, this
+     *   field only contains the first one.
+     */
     label?: string;
+    /**
+     * Labels attached to the message.
+     *
+     * A message can have multiple labels when published with `label: string[]`.
+     */
+    labels?: string[];
 };
 /**
  * Deprecated. Use the `Log` type instead.
@@ -518,7 +540,14 @@ type UniversalFilterFields = {
     fromDate?: Date | number;
     toDate?: Date | number;
     callerIp?: string;
-    label?: string;
+    /**
+     * Filter by label.
+     *
+     * Pass an array to match runs that have any of the given labels (OR semantics).
+     * For example, with runs labelled `[label_1, label_2]` and `[label_2, label_3]`,
+     * filtering by `[label_1, label_2]` returns both.
+     */
+    label?: string | string[];
     flowControlKey?: string;
 };
 /** QStash-specific identity filters (DLQ + message endpoints). */
@@ -753,8 +782,17 @@ type Message = {
     period?: number;
     /**
      * The label assigned to the message for filtering purposes.
+     *
+     * @deprecated Use `labels` instead. When a message has multiple labels, this
+     *   field only contains the first one.
      */
     label?: string;
+    /**
+     * The labels assigned to the message for filtering purposes.
+     *
+     * A message can have multiple labels when published with `label: string[]`.
+     */
+    labels?: string[];
 };
 type MessagePayload = Omit<Message, "urlGroup"> & {
     topicName: string;
@@ -2125,6 +2163,15 @@ type ClientConfig = {
      * @default true
      */
     enableTelemetry?: boolean;
+    /**
+     * Controls the local dev server.
+     * - `true`: force dev mode on (downloads, starts, and manages the dev server automatically)
+     * - `false`: force dev mode off (ignores QSTASH_DEV env var)
+     * - `undefined`: check QSTASH_DEV env var
+     *
+     * @default undefined
+     */
+    devMode?: boolean;
 };
 type PublishBatchRequest<TBody = BodyInit> = PublishRequest<TBody> & {
     queueName?: string;
@@ -2266,9 +2313,12 @@ type PublishRequest<TBody = BodyInit> = {
     /**
      * Assign a label to the request to filter logs later.
      *
+     * Pass an array to attach multiple labels to a single message; they are
+     * sent as a comma-separated value in the `Upstash-Label` header.
+     *
      * @default undefined
      */
-    label?: string;
+    label?: string | string[];
     /**
      * Configure which fields should be redacted in logs.
      *

package/{client-CsM1dTnz.d.mts → client-BHOXiX0H.d.ts}

@@ -18,6 +18,15 @@ type ReceiverConfig = {
      * and UPSTASH_REGION header.
      */
     nextSigningKey?: string;
+    /**
+     * Controls the local dev server signing keys.
+     * - `true`: use dev server signing keys
+     * - `false`: never use dev server signing keys (ignores QSTASH_DEV env var)
+     * - `undefined`: check QSTASH_DEV env var
+     *
+     * @default undefined
+     */
+    devMode?: boolean;
 };
 type VerifyRequest = {
     /**
@@ -56,6 +65,7 @@ declare class SignatureError extends Error {
 declare class Receiver {
     private readonly currentSigningKey?;
     private readonly nextSigningKey?;
+    private readonly devMode?;
     constructor(config?: ReceiverConfig);
     /**
      * Verify the signature of a request.
@@ -91,7 +101,19 @@ type Log = {
     endpointName?: string;
     header?: Record<string, string>;
     body?: string;
+    /**
+     * Label of the message.
+     *
+     * @deprecated Use `labels` instead. When a message has multiple labels, this
+     *   field only contains the first one.
+     */
     label?: string;
+    /**
+     * Labels attached to the message.
+     *
+     * A message can have multiple labels when published with `label: string[]`.
+     */
+    labels?: string[];
 };
 /**
  * Deprecated. Use the `Log` type instead.
@@ -518,7 +540,14 @@ type UniversalFilterFields = {
     fromDate?: Date | number;
     toDate?: Date | number;
     callerIp?: string;
-    label?: string;
+    /**
+     * Filter by label.
+     *
+     * Pass an array to match runs that have any of the given labels (OR semantics).
+     * For example, with runs labelled `[label_1, label_2]` and `[label_2, label_3]`,
+     * filtering by `[label_1, label_2]` returns both.
+     */
+    label?: string | string[];
     flowControlKey?: string;
 };
 /** QStash-specific identity filters (DLQ + message endpoints). */
@@ -753,8 +782,17 @@ type Message = {
     period?: number;
     /**
      * The label assigned to the message for filtering purposes.
+     *
+     * @deprecated Use `labels` instead. When a message has multiple labels, this
+     *   field only contains the first one.
      */
     label?: string;
+    /**
+     * The labels assigned to the message for filtering purposes.
+     *
+     * A message can have multiple labels when published with `label: string[]`.
+     */
+    labels?: string[];
 };
 type MessagePayload = Omit<Message, "urlGroup"> & {
     topicName: string;
@@ -2125,6 +2163,15 @@ type ClientConfig = {
      * @default true
      */
     enableTelemetry?: boolean;
+    /**
+     * Controls the local dev server.
+     * - `true`: force dev mode on (downloads, starts, and manages the dev server automatically)
+     * - `false`: force dev mode off (ignores QSTASH_DEV env var)
+     * - `undefined`: check QSTASH_DEV env var
+     *
+     * @default undefined
+     */
+    devMode?: boolean;
 };
 type PublishBatchRequest<TBody = BodyInit> = PublishRequest<TBody> & {
     queueName?: string;
@@ -2266,9 +2313,12 @@ type PublishRequest<TBody = BodyInit> = {
     /**
      * Assign a label to the request to filter logs later.
      *
+     * Pass an array to attach multiple labels to a single message; they are
+     * sent as a comma-separated value in the `Upstash-Label` header.
+     *
      * @default undefined
      */
-    label?: string;
+    label?: string | string[];
     /**
      * Configure which fields should be redacted in logs.
      *

package/cloudflare.d.mts

@@ -1,4 +1,4 @@
-import { ae as RouteFunction, af as WorkflowServeOptions } from './client-CsM1dTnz.mjs';
+import { ae as RouteFunction, af as WorkflowServeOptions } from './client-BHOXiX0H.mjs';
 import 'neverthrow';
 
 type WorkflowBindings = {

package/cloudflare.d.ts

@@ -1,4 +1,4 @@
-import { ae as RouteFunction, af as WorkflowServeOptions } from './client-CsM1dTnz.js';
+import { ae as RouteFunction, af as WorkflowServeOptions } from './client-BHOXiX0H.js';
 import 'neverthrow';
 
 type WorkflowBindings = {