@upstash/qstash 2.9.1-rc.1 → 2.9.1

package/{client-Gv4WRTxB.d.mts → client-jh_SomWB.d.ts}

@@ -103,7 +103,7 @@ type LogPayload = Omit<Log, "urlGroup"> & {
     topicName: string;
 };
 /**
- * Deprecated. Use the `LogPayload` type instead.
+ * Deprecated. Use the `EventPayload` type instead.
  *
  * @deprecated
  */
@@ -464,7 +464,7 @@ type UpstashRequest = {
      * A string to set request's method.
      */
     method?: HTTPMethods;
-    query?: Record<string, string | number | boolean | Date | string[] | undefined>;
+    query?: Record<string, string | number | boolean | undefined>;
     /**
      * if enabled, call `res.json()`
      *
@@ -505,81 +505,6 @@ type RetryConfig = false | {
     backoff?: (retryCount: number) => number;
 };
 
-type NeverAll<T> = {
-    [K in keyof T]?: never;
-};
-type RequireAtLeastOne<T> = {
-    [K in keyof T]-?: Required<Pick<T, K>>;
-}[keyof T];
-/**
- * Three-way exclusive union: at-least-one-filter OR `{ all: true }` OR IDs.
- * Exactly one branch can be satisfied at a time.
- *
- * The filter and all branches intentionally omit `NeverAll<Ids>` so that
- * TypeScript's `"key" in request` narrowing correctly isolates the IDs branch.
- * Excess-property checks on object literals still prevent mixing ID keys with filters.
- */
-type FilterAllOrIds<F extends Record<string, unknown>, Ids extends Record<string, unknown>> = (F & RequireAtLeastOne<F> & {
-    all?: never;
-}) | ({
-    all: true;
-} & NeverAll<F>) | (Ids & NeverAll<F> & {
-    all?: never;
-});
-/** Shared filter fields accepted by every qstash & workflow endpoint. */
-type UniversalFilterFields = {
-    /**
-     * aslkdjasd
-     */
-    fromDate?: Date | number;
-    toDate?: Date | number;
-    callerIp?: string;
-    label?: string;
-    flowControlKey?: string;
-};
-/** QStash-specific identity filters (DLQ + message endpoints). */
-type QStashIdentityFields = {
-    messageId?: string;
-    url?: string;
-    urlGroup?: string;
-    scheduleId?: string;
-    queueName?: string;
-};
-/** DLQ-specific response filter. */
-type DLQResponseFields = {
-    responseStatus?: number;
-};
-/** Logs-specific filter fields exclusive to log endpoints. */
-type LogsFilterFields = {
-    state?: State;
-    messageIds?: string[];
-};
-/**
- * Doesn't allow a single messageId because this is a bulk action
- */
-type MessageCancelFilters = FilterAllOrIds<UniversalFilterFields & Omit<QStashIdentityFields, "messageId">, {
-    messageIds: string[];
-}>;
-type DLQBulkActionFilters = FilterAllOrIds<UniversalFilterFields & QStashIdentityFields & DLQResponseFields, {
-    dlqIds: string | string[];
-}>;
-type DLQListFilters = UniversalFilterFields & QStashIdentityFields & DLQResponseFields;
-type LogsListFilters = UniversalFilterFields & QStashIdentityFields & LogsFilterFields & {
-    /**
-     * @deprecated use `urlGroup` instead
-     */
-    topicName?: string;
-    /**
-     * @deprecated use `count` option in the root instead of the `filter` object
-     *
-     * Example:
-     * ```ts
-     * await client.logs({ count: 50 })
-     * ```
-     */
-    count?: number;
-};
-
 type Message = {
     /**
      * A unique identifier for this message.
@@ -702,33 +627,10 @@ declare class Messages {
      */
     get(messageId: string): Promise<Message>;
     /**
-     * Cancel messages.
-     *
-     * Can be called with:
-     * - A single messageId: `cancel("id")`
-     * - An array of messageIds: `cancel(["id1", "id2"])`
-     * - A filter object: `cancel({ flowControlKey: "key", label: "label" })`
-     * - All messages: `cancel({ all: true })`
-     */
-    cancel(request: string | string[] | MessageCancelFilters): Promise<{
-        cancelled: number;
-    }>;
-    /**
-     * Delete a message.
-     *
-     * @deprecated Use `cancel(messageId: string)` instead
+     * Cancel a message
      */
     delete(messageId: string): Promise<void>;
-    /**
-     * Cancel multiple messages by their messageIds.
-     *
-     * @deprecated Use `cancel(messageIds: string[])` instead
-     */
     deleteMany(messageIds: string[]): Promise<number>;
-    /**
-     * Cancel all messages
-     * @deprecated Use `cancel({all: true})` to cancel all
-     */
     deleteAll(): Promise<number>;
 }
 
@@ -756,6 +658,52 @@ type DlqMessage = Message & {
      */
     responseBodyBase64?: string;
 };
+type DLQFilter = {
+    /**
+     * Filter DLQ entries by message id
+     */
+    messageId?: string;
+    /**
+     * Filter DLQ entries by url
+     */
+    url?: string;
+    /**
+     * Filter DLQ entries by url group name
+     */
+    urlGroup?: string;
+    /**
+     * Filter DLQ entries by api name
+     */
+    api?: string;
+    /**
+     * Filter DLQ entries by queue name
+     */
+    queueName?: string;
+    /**
+     * Filter DLQ entries by schedule id
+     */
+    scheduleId?: string;
+    /**
+     * Filter DLQ entries by starting time, in milliseconds
+     */
+    fromDate?: number;
+    /**
+     * Filter DLQ entries by ending time, in milliseconds
+     */
+    toDate?: number;
+    /**
+     * Filter DLQ entries by label
+     */
+    label?: string;
+    /**
+     * Filter DLQ entries by HTTP status of the response
+     */
+    responseStatus?: number;
+    /**
+     * Filter DLQ entries by IP address of the publisher of the message
+     */
+    callerIp?: string;
+};
 declare class DLQ {
     private readonly http;
     constructor(http: Requester);
@@ -765,59 +713,148 @@ declare class DLQ {
     listMessages(options?: {
         cursor?: string;
         count?: number;
-        /** Defaults to `latestFirst` */
-        order?: "earliestFirst" | "latestFirst";
-        trimBody?: number;
-        filter?: DLQListFilters;
+        filter?: DLQFilter;
     }): Promise<{
         messages: DlqMessage[];
         cursor?: string;
     }>;
     /**
-     * Remove messages from the dlq.
-     *
-     * Can be called with:
-     * - A single dlqId: `delete("id")`
-     * - An array of dlqIds: `delete(["id1", "id2"])`
-     * - An object with dlqIds: `delete({ dlqIds: ["id1", "id2"] })`
-     * - A filter object: `delete({ url: "https://example.com", label: "label" })`
-     * - All messages: `delete({ all: true })`
-     *
-     * Note: passing an empty array returns `{ deleted: 0 }` without making a request.
+     * Remove a message from the dlq using it's `dlqId`
      */
-    delete(request: string | string[] | DLQBulkActionFilters): Promise<{
-        deleted: number;
-        cursor?: string;
-    }>;
+    delete(dlqMessageId: string): Promise<void>;
     /**
      * Remove multiple messages from the dlq using their `dlqId`s
-     *
-     * @deprecated Use `delete` instead
      */
     deleteMany(request: {
         dlqIds: string[];
     }): Promise<{
         deleted: number;
-        cursor?: string;
     }>;
+}
+
+type FlowControlInfo = {
+    /**
+     * The flow control key.
+     */
+    flowControlKey: string;
     /**
-     * Retry messages from the dlq.
+     * The number of messages waiting in the wait list.
+     */
+    waitListSize: number;
+    /**
+     * The maximum parallelism configured for this flow control key.
+     */
+    parallelismMax: number;
+    /**
+     * The current number of active requests for this flow control key.
+     */
+    parallelismCount: number;
+    /**
+     * The maximum rate configured for this flow control key.
+     */
+    rateMax: number;
+    /**
+     * The current number of requests consumed in the current period.
+     */
+    rateCount: number;
+    /**
+     * The rate period in seconds.
+     */
+    ratePeriod: number;
+    /**
+     * The start time of the current rate period as a unix timestamp.
+     */
+    ratePeriodStart: number;
+    /**
+     * Whether message delivery is paused for this flow control key.
+     */
+    isPaused: boolean;
+    /**
+     * Whether the parallelism configuration is pinned.
+     */
+    isPinnedParallelism: boolean;
+    /**
+     * Whether the rate configuration is pinned.
+     */
+    isPinnedRate: boolean;
+};
+type GlobalParallelismInfo = {
+    /**
+     * The maximum global parallelism.
+     */
+    parallelismMax: number;
+    /**
+     * The current number of active requests globally.
+     */
+    parallelismCount: number;
+};
+type PinFlowControlOptions = {
+    /**
+     * The parallelism value to apply to the flow-control key.
+     */
+    parallelism?: number;
+    /**
+     * The rate value to apply to the flow-control key.
+     */
+    rate?: number;
+    /**
+     * The period value to apply to the flow-control key, in seconds.
+     */
+    period?: number;
+};
+type UnpinFlowControlOptions = {
+    /**
+     * Whether to unpin the parallelism configuration.
+     */
+    parallelism?: boolean;
+    /**
+     * Whether to unpin the rate configuration.
+     */
+    rate?: boolean;
+};
+declare class FlowControlApi {
+    private readonly http;
+    constructor(http: Requester);
+    /**
+     * Get a single flow control by key.
+     */
+    get(flowControlKey: string): Promise<FlowControlInfo>;
+    /**
+     * Get the global parallelism info.
+     */
+    getGlobalParallelism(): Promise<GlobalParallelismInfo>;
+    /**
+     * Pause message delivery for a flow-control key.
      *
-     * Can be called with:
-     * - A single dlqId: `retry("id")`
-     * - An array of dlqIds: `retry(["id1", "id2"])`
-     * - An object with dlqIds: `retry({ dlqIds: ["id1", "id2"] })`
-     * - A filter object: `retry({ url: "https://example.com", label: "label" })`
-     * - All messages: `retry({ all: true })`
+     * Messages already in the waitlist will remain there.
+     * New incoming messages will be added directly to the waitlist.
+     */
+    pause(flowControlKey: string): Promise<void>;
+    /**
+     * Resume message delivery for a flow-control key.
+     */
+    resume(flowControlKey: string): Promise<void>;
+    /**
+     * Pin a processing configuration for a flow-control key.
      *
-     * Note: passing an empty array returns `{ responses: [] }` without making a request.
+     * While pinned, the system ignores configurations provided by incoming
+     * messages and uses the pinned configuration instead.
      */
-    retry(request: string | string[] | DLQBulkActionFilters): Promise<{
-        cursor?: string;
-        responses: {
-            messageId: string;
-        }[];
-    }>;
+    pin(flowControlKey: string, options: PinFlowControlOptions): Promise<void>;
+    /**
+     * Remove the pinned configuration for a flow-control key.
+     *
+     * After unpinning, the system resumes updating the configuration
+     * based on incoming messages.
+     */
+    unpin(flowControlKey: string, options: UnpinFlowControlOptions): Promise<void>;
+    /**
+     * Reset the rate configuration state for a flow-control key.
+     *
+     * Clears the current rate count and immediately ends the current period.
+     * The current timestamp becomes the start of the new rate period.
+     */
+    resetRate(flowControlKey: string): Promise<void>;
 }
 
 declare class Chat {
@@ -2122,12 +2159,7 @@ type PublishJsonRequest = Omit<PublishRequest, "body"> & {
 };
 type LogsRequest = {
     cursor?: string | number;
-    /** Max 1000. Defaults to 10 when `groupBy` is used. */
-    count?: number;
-    /** Defaults to `latestFirst` */
-    order?: "earliestFirst" | "latestFirst";
-    trimBody?: number;
-    filter?: LogsListFilters;
+    filter?: LogsRequestFilter;
 };
 /**
  * Deprecated. Use `LogsRequest` instead.
@@ -2135,6 +2167,20 @@ type LogsRequest = {
  * @deprecated
  */
 type EventsRequest = LogsRequest;
+type LogsRequestFilter = {
+    messageId?: string;
+    state?: State;
+    url?: string;
+    urlGroup?: string;
+    topicName?: string;
+    api?: string;
+    scheduleId?: string;
+    queueName?: string;
+    fromDate?: number;
+    toDate?: number;
+    count?: number;
+    label?: string;
+};
 type GetLogsResponse = {
     cursor?: string;
     logs: Log[];
@@ -2190,6 +2236,12 @@ declare class Client {
      * Create, read or delete schedules.
      */
     get schedules(): Schedules;
+    /**
+     * Access the flow control API.
+     *
+     * List, get, or reset flow controls.
+     */
+    get flowControl(): FlowControlApi;
     /**
      * Access the workflow API.
      *
@@ -2285,4 +2337,4 @@ type PublishResponse<TRequest> = TRequest extends {
     urlGroup: string;
 } ? PublishToUrlGroupsResponse : PublishToApiResponse;
 
-export { type ChatCompletionChunk as $, type AddEndpointsRequest as A, BaseProvider as B, type ChatRateLimit as C, type LogPayload as D, type EmailOwner as E, type FailureFunctionPayload as F, type GetLogsResponse as G, type HTTPMethods as H, type EventPayload as I, type GetLogsPayload as J, type GetEventsPayload as K, type LLMOwner as L, type Message as M, type BodyInit as N, type HeadersInit as O, type ProviderInfo as P, type QueueRequest as Q, type RateLimit as R, type Step as S, type RequestOptions as T, type UniversalFilterFields as U, type VerifyRequest as V, type WithCursor as W, type FlowControl as X, Chat as Y, type ChatCompletionMessage as Z, type ChatCompletion as _, type ReceiverConfig as a, type StreamEnabled as a0, type StreamDisabled as a1, type StreamParameter as a2, type OpenAIChatModel as a3, type PromptChatRequest as a4, type ChatRequest as a5, upstash as a6, openai as a7, anthropic as a8, custom as a9, type RouteFunction as aa, type WorkflowServeOptions as ab, Workflow as ac, processOptions as ad, serve as ae, WorkflowContext as af, DisabledWorkflowContext as ag, type WorkflowClient as ah, type WorkflowReceiver as ai, StepTypes as aj, type StepType as ak, type RawStep as al, type SyncStepFunction as am, type AsyncStepFunction as an, type StepFunction as ao, type ParallelCallState as ap, type FinishCondition as aq, type RequiredExceptFields as ar, type LogLevel as as, type WorkflowLoggerOptions as at, WorkflowLogger as au, SignatureError as b, Receiver as c, type PublishBatchRequest as d, type PublishRequest as e, type PublishJsonRequest as f, type LogsRequest as g, type EventsRequest as h, type GetEventsResponse as i, Client as j, type PublishToApiResponse as k, type PublishToUrlResponse as l, type PublishToUrlGroupsResponse as m, type PublishResponse as n, type MessagePayload as o, Messages as p, type Schedule as q, type CreateScheduleRequest as r, Schedules as s, type Endpoint as t, type RemoveEndpointsRequest as u, type UrlGroup as v, UrlGroups as w, type State as x, type Log as y, type Event as z };
+export { type FlowControl as $, type AddEndpointsRequest as A, BaseProvider as B, type ChatRateLimit as C, UrlGroups as D, type EmailOwner as E, type FailureFunctionPayload as F, type GetLogsResponse as G, type State as H, type HTTPMethods as I, type Log as J, type Event as K, type LLMOwner as L, type Message as M, type LogPayload as N, type EventPayload as O, type ProviderInfo as P, type QueueRequest as Q, type RateLimit as R, type Step as S, type GetLogsPayload as T, type UnpinFlowControlOptions as U, type VerifyRequest as V, type GetEventsPayload as W, type WithCursor as X, type BodyInit as Y, type HeadersInit as Z, type RequestOptions as _, type ReceiverConfig as a, Chat as a0, type ChatCompletionMessage as a1, type ChatCompletion as a2, type ChatCompletionChunk as a3, type StreamEnabled as a4, type StreamDisabled as a5, type StreamParameter as a6, type OpenAIChatModel as a7, type PromptChatRequest as a8, type ChatRequest as a9, upstash as aa, openai as ab, anthropic as ac, custom as ad, type RouteFunction as ae, type WorkflowServeOptions as af, Workflow as ag, processOptions as ah, serve as ai, WorkflowContext as aj, DisabledWorkflowContext as ak, type WorkflowClient as al, type WorkflowReceiver as am, StepTypes as an, type StepType as ao, type RawStep as ap, type SyncStepFunction as aq, type AsyncStepFunction as ar, type StepFunction as as, type ParallelCallState as at, type FinishCondition as au, type RequiredExceptFields as av, type LogLevel as aw, type WorkflowLoggerOptions as ax, WorkflowLogger as ay, SignatureError as b, Receiver as c, type PublishBatchRequest as d, type PublishRequest as e, type PublishJsonRequest as f, type LogsRequest as g, type EventsRequest as h, type GetEventsResponse as i, Client as j, type PublishToApiResponse as k, type PublishToUrlResponse as l, type PublishToUrlGroupsResponse as m, type PublishResponse as n, type FlowControlInfo as o, type GlobalParallelismInfo as p, type PinFlowControlOptions as q, FlowControlApi as r, type MessagePayload as s, Messages as t, type Schedule as u, type CreateScheduleRequest as v, Schedules as w, type Endpoint as x, type RemoveEndpointsRequest as y, type UrlGroup as z };

package/cloudflare.d.mts

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

package/cloudflare.d.ts

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