@upstash/workflow 0.2.1 → 0.2.3

package/{types-Be4hC1mu.d.mts → types-R9q4MUwl.d.mts}

@@ -1,4 +1,4 @@
-import { HTTPMethods, Client, Receiver } from '@upstash/qstash';
+import { PublishRequest, Client, Receiver, HTTPMethods as HTTPMethods$1 } from '@upstash/qstash';
 
 /**
  * Base class outlining steps. Basically, each step kind (run/sleep/sleepUntil)
@@ -162,6 +162,230 @@ declare class AutoExecutor {
     private deferExecution;
 }
 
+type HTTPMethods = "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+
+type ProviderInfo = {
+    /**
+     * full url used for request
+     */
+    url: string;
+    /**
+     * base url of the request
+     */
+    baseUrl: string;
+    /**
+     * route elements which will follow the baseUrl
+     */
+    route: string[];
+    /**
+     * headers to include in the request
+     */
+    appendHeaders: Record<string, string>;
+    /**
+     * provider owner
+     */
+    owner: Owner;
+    /**
+     * method to use in the request
+     */
+    method: HTTPMethods;
+};
+type Owner = EmailOwner | LLMOwner;
+/**
+ * Email
+ */
+type EmailOwner = "resend";
+/**
+ * LLM
+ */
+type LLMOwner = "upstash" | "openai" | "anthropic" | "custom";
+
+/**
+ * copies and updates the request by removing the api field and adding url & headers.
+ *
+ * @param api api field of PublishRequest
+ * @returns updated request
+ */
+declare const getProviderInfo: (api: Required<PublishRequest>["api"]) => ProviderInfo;
+
+type ApiCallSettings<TBody = unknown, TFields extends object = object> = Omit<CallSettings<TBody>, "url"> & TFields;
+declare abstract class BaseWorkflowApi {
+    protected context: WorkflowContext;
+    constructor({ context }: {
+        context: WorkflowContext;
+    });
+    /**
+     * context.call which uses a QStash API
+     *
+     * @param stepName
+     * @param settings
+     * @returns
+     */
+    protected callApi<TResult = unknown, TBody = unknown>(stepName: string, settings: ApiCallSettings<TBody, {
+        api: Parameters<typeof getProviderInfo>[0];
+    }>): Promise<CallResponse<TResult>>;
+}
+
+type CreateChatCompletion$1 = {
+    model: string;
+    messages: {
+        role: "user" | "assistant";
+        content: unknown;
+    }[];
+    max_tokens: number;
+    metadata?: object;
+    stop_sequences?: string[];
+    /**
+     * streaming is not possible Upstash Workflow.
+     */
+    stream?: false;
+    system?: string;
+    temparature?: number;
+    top_k?: number;
+    top_p?: number;
+};
+type ChatCompletion$1 = {
+    id: string;
+    type: "message";
+    role: "assistant";
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    model: string;
+    stop_reasong: string;
+    stop_sequence: string[];
+    usage: unknown;
+};
+declare class AnthropicAPI extends BaseWorkflowApi {
+    call<TResult = ChatCompletion$1, TBody = CreateChatCompletion$1>(stepName: string, settings: ApiCallSettings<TBody, {
+        token: string;
+        operation: "messages.create";
+    }>): Promise<CallResponse<TResult>>;
+}
+
+type Messages = {
+    content: string;
+    role: "developer" | "system";
+    name?: string;
+} | {
+    content: unknown;
+    role: "user";
+    name?: string;
+} | {
+    content: unknown;
+    refusal?: string;
+    role: "assistant";
+    name?: string;
+    audio?: unknown;
+    tool_calls?: unknown;
+} | {
+    role: "tool";
+    content: string | unknown;
+    tool_call_id: string;
+} | {
+    role: "function";
+    content: string | undefined;
+    name: string;
+};
+type CreateChatCompletion = {
+    messages: Messages[];
+    model: string;
+    store?: boolean;
+    reasoning_effort?: string;
+    metadata?: unknown;
+    frequency_penalty?: number;
+    logit_bias?: Record<string, number>;
+    logprobs?: boolean;
+    top_logprobs?: number;
+    max_completion_tokens?: number;
+    n?: number;
+    modalities?: string[];
+    prediction?: unknown;
+    audio?: unknown;
+    presence_penalty?: number;
+    response_format?: unknown;
+    seed?: number;
+    service_tier?: string;
+    stop?: string | string[];
+    /**
+     * streaming is not supported in Upstash Workflow.
+     */
+    stream?: false;
+    temperature?: number;
+    top_p?: number;
+    tools?: unknown;
+    tool_choice?: string;
+    parallel_tool_calls?: boolean;
+    user?: string;
+};
+type ChatCompletion = {
+    id: string;
+    choices: ChatCompletionChoice[];
+    created: number;
+    model: string;
+    object: "chat.completion";
+    service_tier?: "scale" | "default" | null;
+    system_fingerprint?: string;
+    usage?: unknown;
+};
+type ChatCompletionChoice = {
+    finish_reason: "stop" | "length" | "tool_calls" | "content_filter" | "function_call";
+    index: number;
+    logprobs: unknown;
+    message: {
+        content: string | null;
+        refusal: string | null;
+        role: "assistant";
+        audio?: unknown;
+        tool_calls?: unknown;
+    };
+};
+declare class OpenAIAPI extends BaseWorkflowApi {
+    call<TResult = ChatCompletion, TBody = CreateChatCompletion>(stepName: string, settings: ApiCallSettings<TBody, {
+        token: string;
+        organization?: string;
+        operation: "chat.completions.create";
+    }>): Promise<CallResponse<TResult>>;
+}
+
+type SendEmail = {
+    from: string;
+    to: string;
+    subject: string;
+    bcc?: string | string[];
+    cc?: string | string[];
+    scheduled_at?: string;
+    reply_to?: string | string[];
+    html?: string;
+    text?: string;
+    headers: unknown;
+    attachments: unknown;
+    tags: {
+        name: string;
+        value: string;
+    }[];
+};
+type SendEmailResponse = {
+    id: string;
+};
+type SendBatchEmail = SendEmail[];
+type SendBatchEmailResponse = {
+    data: SendEmailResponse[];
+};
+declare class ResendAPI extends BaseWorkflowApi {
+    call<TBatch extends boolean = false, TResult = TBatch extends true ? SendBatchEmailResponse : SendEmailResponse, TBody = TBatch extends true ? SendBatchEmail : SendEmail>(stepName: string, settings: ApiCallSettings<TBody, {
+        token: string;
+        batch?: TBatch;
+    }>): Promise<CallResponse<TResult>>;
+}
+
+declare class WorkflowApi extends BaseWorkflowApi {
+    get openai(): OpenAIAPI;
+    get resend(): ResendAPI;
+    get anthropic(): AnthropicAPI;
+}
+
 /**
  * Upstash Workflow context
  *
@@ -385,14 +609,7 @@ declare class WorkflowContext<TInitialPayload = unknown> {
      *     header: Record<string, string[]>
      *   }
      */
-    call<TResult = unknown>(stepName: string, settings: {
-        url: string;
-        method?: HTTPMethods;
-        body?: unknown;
-        headers?: Record<string, string>;
-        retries?: number;
-        timeout?: Duration | number;
-    }): Promise<CallResponse<TResult>>;
+    call<TResult = unknown, TBody = unknown>(stepName: string, settings: CallSettings<TBody>): Promise<CallResponse<TResult>>;
     /**
      * Pauses workflow execution until a specific event occurs or a timeout is reached.
      *
@@ -462,6 +679,7 @@ declare class WorkflowContext<TInitialPayload = unknown> {
      * DisabledWorkflowContext.
      */
     protected addStep<TResult = unknown>(step: BaseLazyStep<TResult>): Promise<TResult>;
+    get api(): WorkflowApi;
 }
 
 /**
@@ -493,7 +711,7 @@ type ThirdPartyCallFields<TBody = unknown> = {
     /**
      * Third party call method. Set when context.call is used.
      */
-    callMethod: HTTPMethods;
+    callMethod: HTTPMethods$1;
     /**
      * Third party call body. Set when context.call is used.
      */
@@ -567,7 +785,7 @@ type AsyncStepFunction<TResult> = () => Promise<TResult>;
 type StepFunction<TResult> = AsyncStepFunction<TResult> | SyncStepFunction<TResult>;
 type ParallelCallState = "first" | "partial" | "discard" | "last";
 type RouteFunction<TInitialPayload> = (context: WorkflowContext<TInitialPayload>) => Promise<void>;
-type FinishCondition = "success" | "duplicate-step" | "fromCallback" | "auth-fail" | "failure-callback";
+type FinishCondition = "success" | "duplicate-step" | "fromCallback" | "auth-fail" | "failure-callback" | "workflow-already-ended";
 type WorkflowServeOptions<TResponse extends Response = Response, TInitialPayload = unknown> = {
     /**
      * QStash client
@@ -651,7 +869,15 @@ type WorkflowServeOptions<TResponse extends Response = Response, TInitialPayload
      * 3 by default
      */
     retries?: number;
+    /**
+     * Whether the framework should use `content-type: application/json`
+     * in `triggerFirstInvocation`.
+     *
+     * Not part of the public API. Only available in serveBase, which is not exported.
+     */
+    useJSONContent?: boolean;
 };
+type PublicServeOptions<TInitialPayload = unknown, TResponse extends Response = Response> = Omit<WorkflowServeOptions<TResponse, TInitialPayload>, "onStepFinish" | "useJSONContent">;
 /**
  * Payload passed as body in failureFunction
  */
@@ -737,5 +963,13 @@ interface WaitEventOptions {
      */
     timeout?: number | Duration;
 }
+type CallSettings<TBody = unknown> = {
+    url: string;
+    method?: HTTPMethods$1;
+    body?: TBody;
+    headers?: Record<string, string>;
+    retries?: number;
+    timeout?: Duration | number;
+};
 
-export { type AsyncStepFunction as A, type CallResponse as C, type Duration as D, type FinishCondition as F, type LogLevel as L, type NotifyResponse as N, type ParallelCallState as P, type RouteFunction as R, type Step as S, type WorkflowServeOptions as W, type Waiter as a, WorkflowContext as b, type WorkflowClient as c, type WorkflowReceiver as d, StepTypes as e, type StepType as f, type RawStep as g, type SyncStepFunction as h, type StepFunction as i, type FailureFunctionPayload as j, type RequiredExceptFields as k, type WaitRequest as l, type WaitStepResponse as m, type NotifyStepResponse as n, type WaitEventOptions as o, type WorkflowLoggerOptions as p, WorkflowLogger as q };
+export { type AsyncStepFunction as A, type CallResponse as C, type Duration as D, type FinishCondition as F, type LogLevel as L, type NotifyResponse as N, type ParallelCallState as P, type RouteFunction as R, type Step as S, type WorkflowServeOptions as W, type Waiter as a, WorkflowContext as b, type WorkflowClient as c, type WorkflowReceiver as d, StepTypes as e, type StepType as f, type RawStep as g, type SyncStepFunction as h, type StepFunction as i, type PublicServeOptions as j, type FailureFunctionPayload as k, type RequiredExceptFields as l, type WaitRequest as m, type WaitStepResponse as n, type NotifyStepResponse as o, type WaitEventOptions as p, type CallSettings as q, type WorkflowLoggerOptions as r, WorkflowLogger as s };

package/{types-Be4hC1mu.d.ts → types-R9q4MUwl.d.ts}

@@ -1,4 +1,4 @@
-import { HTTPMethods, Client, Receiver } from '@upstash/qstash';
+import { PublishRequest, Client, Receiver, HTTPMethods as HTTPMethods$1 } from '@upstash/qstash';
 
 /**
  * Base class outlining steps. Basically, each step kind (run/sleep/sleepUntil)
@@ -162,6 +162,230 @@ declare class AutoExecutor {
     private deferExecution;
 }
 
+type HTTPMethods = "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+
+type ProviderInfo = {
+    /**
+     * full url used for request
+     */
+    url: string;
+    /**
+     * base url of the request
+     */
+    baseUrl: string;
+    /**
+     * route elements which will follow the baseUrl
+     */
+    route: string[];
+    /**
+     * headers to include in the request
+     */
+    appendHeaders: Record<string, string>;
+    /**
+     * provider owner
+     */
+    owner: Owner;
+    /**
+     * method to use in the request
+     */
+    method: HTTPMethods;
+};
+type Owner = EmailOwner | LLMOwner;
+/**
+ * Email
+ */
+type EmailOwner = "resend";
+/**
+ * LLM
+ */
+type LLMOwner = "upstash" | "openai" | "anthropic" | "custom";
+
+/**
+ * copies and updates the request by removing the api field and adding url & headers.
+ *
+ * @param api api field of PublishRequest
+ * @returns updated request
+ */
+declare const getProviderInfo: (api: Required<PublishRequest>["api"]) => ProviderInfo;
+
+type ApiCallSettings<TBody = unknown, TFields extends object = object> = Omit<CallSettings<TBody>, "url"> & TFields;
+declare abstract class BaseWorkflowApi {
+    protected context: WorkflowContext;
+    constructor({ context }: {
+        context: WorkflowContext;
+    });
+    /**
+     * context.call which uses a QStash API
+     *
+     * @param stepName
+     * @param settings
+     * @returns
+     */
+    protected callApi<TResult = unknown, TBody = unknown>(stepName: string, settings: ApiCallSettings<TBody, {
+        api: Parameters<typeof getProviderInfo>[0];
+    }>): Promise<CallResponse<TResult>>;
+}
+
+type CreateChatCompletion$1 = {
+    model: string;
+    messages: {
+        role: "user" | "assistant";
+        content: unknown;
+    }[];
+    max_tokens: number;
+    metadata?: object;
+    stop_sequences?: string[];
+    /**
+     * streaming is not possible Upstash Workflow.
+     */
+    stream?: false;
+    system?: string;
+    temparature?: number;
+    top_k?: number;
+    top_p?: number;
+};
+type ChatCompletion$1 = {
+    id: string;
+    type: "message";
+    role: "assistant";
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    model: string;
+    stop_reasong: string;
+    stop_sequence: string[];
+    usage: unknown;
+};
+declare class AnthropicAPI extends BaseWorkflowApi {
+    call<TResult = ChatCompletion$1, TBody = CreateChatCompletion$1>(stepName: string, settings: ApiCallSettings<TBody, {
+        token: string;
+        operation: "messages.create";
+    }>): Promise<CallResponse<TResult>>;
+}
+
+type Messages = {
+    content: string;
+    role: "developer" | "system";
+    name?: string;
+} | {
+    content: unknown;
+    role: "user";
+    name?: string;
+} | {
+    content: unknown;
+    refusal?: string;
+    role: "assistant";
+    name?: string;
+    audio?: unknown;
+    tool_calls?: unknown;
+} | {
+    role: "tool";
+    content: string | unknown;
+    tool_call_id: string;
+} | {
+    role: "function";
+    content: string | undefined;
+    name: string;
+};
+type CreateChatCompletion = {
+    messages: Messages[];
+    model: string;
+    store?: boolean;
+    reasoning_effort?: string;
+    metadata?: unknown;
+    frequency_penalty?: number;
+    logit_bias?: Record<string, number>;
+    logprobs?: boolean;
+    top_logprobs?: number;
+    max_completion_tokens?: number;
+    n?: number;
+    modalities?: string[];
+    prediction?: unknown;
+    audio?: unknown;
+    presence_penalty?: number;
+    response_format?: unknown;
+    seed?: number;
+    service_tier?: string;
+    stop?: string | string[];
+    /**
+     * streaming is not supported in Upstash Workflow.
+     */
+    stream?: false;
+    temperature?: number;
+    top_p?: number;
+    tools?: unknown;
+    tool_choice?: string;
+    parallel_tool_calls?: boolean;
+    user?: string;
+};
+type ChatCompletion = {
+    id: string;
+    choices: ChatCompletionChoice[];
+    created: number;
+    model: string;
+    object: "chat.completion";
+    service_tier?: "scale" | "default" | null;
+    system_fingerprint?: string;
+    usage?: unknown;
+};
+type ChatCompletionChoice = {
+    finish_reason: "stop" | "length" | "tool_calls" | "content_filter" | "function_call";
+    index: number;
+    logprobs: unknown;
+    message: {
+        content: string | null;
+        refusal: string | null;
+        role: "assistant";
+        audio?: unknown;
+        tool_calls?: unknown;
+    };
+};
+declare class OpenAIAPI extends BaseWorkflowApi {
+    call<TResult = ChatCompletion, TBody = CreateChatCompletion>(stepName: string, settings: ApiCallSettings<TBody, {
+        token: string;
+        organization?: string;
+        operation: "chat.completions.create";
+    }>): Promise<CallResponse<TResult>>;
+}
+
+type SendEmail = {
+    from: string;
+    to: string;
+    subject: string;
+    bcc?: string | string[];
+    cc?: string | string[];
+    scheduled_at?: string;
+    reply_to?: string | string[];
+    html?: string;
+    text?: string;
+    headers: unknown;
+    attachments: unknown;
+    tags: {
+        name: string;
+        value: string;
+    }[];
+};
+type SendEmailResponse = {
+    id: string;
+};
+type SendBatchEmail = SendEmail[];
+type SendBatchEmailResponse = {
+    data: SendEmailResponse[];
+};
+declare class ResendAPI extends BaseWorkflowApi {
+    call<TBatch extends boolean = false, TResult = TBatch extends true ? SendBatchEmailResponse : SendEmailResponse, TBody = TBatch extends true ? SendBatchEmail : SendEmail>(stepName: string, settings: ApiCallSettings<TBody, {
+        token: string;
+        batch?: TBatch;
+    }>): Promise<CallResponse<TResult>>;
+}
+
+declare class WorkflowApi extends BaseWorkflowApi {
+    get openai(): OpenAIAPI;
+    get resend(): ResendAPI;
+    get anthropic(): AnthropicAPI;
+}
+
 /**
  * Upstash Workflow context
  *
@@ -385,14 +609,7 @@ declare class WorkflowContext<TInitialPayload = unknown> {
      *     header: Record<string, string[]>
      *   }
      */
-    call<TResult = unknown>(stepName: string, settings: {
-        url: string;
-        method?: HTTPMethods;
-        body?: unknown;
-        headers?: Record<string, string>;
-        retries?: number;
-        timeout?: Duration | number;
-    }): Promise<CallResponse<TResult>>;
+    call<TResult = unknown, TBody = unknown>(stepName: string, settings: CallSettings<TBody>): Promise<CallResponse<TResult>>;
     /**
      * Pauses workflow execution until a specific event occurs or a timeout is reached.
      *
@@ -462,6 +679,7 @@ declare class WorkflowContext<TInitialPayload = unknown> {
      * DisabledWorkflowContext.
      */
     protected addStep<TResult = unknown>(step: BaseLazyStep<TResult>): Promise<TResult>;
+    get api(): WorkflowApi;
 }
 
 /**
@@ -493,7 +711,7 @@ type ThirdPartyCallFields<TBody = unknown> = {
     /**
      * Third party call method. Set when context.call is used.
      */
-    callMethod: HTTPMethods;
+    callMethod: HTTPMethods$1;
     /**
      * Third party call body. Set when context.call is used.
      */
@@ -567,7 +785,7 @@ type AsyncStepFunction<TResult> = () => Promise<TResult>;
 type StepFunction<TResult> = AsyncStepFunction<TResult> | SyncStepFunction<TResult>;
 type ParallelCallState = "first" | "partial" | "discard" | "last";
 type RouteFunction<TInitialPayload> = (context: WorkflowContext<TInitialPayload>) => Promise<void>;
-type FinishCondition = "success" | "duplicate-step" | "fromCallback" | "auth-fail" | "failure-callback";
+type FinishCondition = "success" | "duplicate-step" | "fromCallback" | "auth-fail" | "failure-callback" | "workflow-already-ended";
 type WorkflowServeOptions<TResponse extends Response = Response, TInitialPayload = unknown> = {
     /**
      * QStash client
@@ -651,7 +869,15 @@ type WorkflowServeOptions<TResponse extends Response = Response, TInitialPayload
      * 3 by default
      */
     retries?: number;
+    /**
+     * Whether the framework should use `content-type: application/json`
+     * in `triggerFirstInvocation`.
+     *
+     * Not part of the public API. Only available in serveBase, which is not exported.
+     */
+    useJSONContent?: boolean;
 };
+type PublicServeOptions<TInitialPayload = unknown, TResponse extends Response = Response> = Omit<WorkflowServeOptions<TResponse, TInitialPayload>, "onStepFinish" | "useJSONContent">;
 /**
  * Payload passed as body in failureFunction
  */
@@ -737,5 +963,13 @@ interface WaitEventOptions {
      */
     timeout?: number | Duration;
 }
+type CallSettings<TBody = unknown> = {
+    url: string;
+    method?: HTTPMethods$1;
+    body?: TBody;
+    headers?: Record<string, string>;
+    retries?: number;
+    timeout?: Duration | number;
+};
 
-export { type AsyncStepFunction as A, type CallResponse as C, type Duration as D, type FinishCondition as F, type LogLevel as L, type NotifyResponse as N, type ParallelCallState as P, type RouteFunction as R, type Step as S, type WorkflowServeOptions as W, type Waiter as a, WorkflowContext as b, type WorkflowClient as c, type WorkflowReceiver as d, StepTypes as e, type StepType as f, type RawStep as g, type SyncStepFunction as h, type StepFunction as i, type FailureFunctionPayload as j, type RequiredExceptFields as k, type WaitRequest as l, type WaitStepResponse as m, type NotifyStepResponse as n, type WaitEventOptions as o, type WorkflowLoggerOptions as p, WorkflowLogger as q };
+export { type AsyncStepFunction as A, type CallResponse as C, type Duration as D, type FinishCondition as F, type LogLevel as L, type NotifyResponse as N, type ParallelCallState as P, type RouteFunction as R, type Step as S, type WorkflowServeOptions as W, type Waiter as a, WorkflowContext as b, type WorkflowClient as c, type WorkflowReceiver as d, StepTypes as e, type StepType as f, type RawStep as g, type SyncStepFunction as h, type StepFunction as i, type PublicServeOptions as j, type FailureFunctionPayload as k, type RequiredExceptFields as l, type WaitRequest as m, type WaitStepResponse as n, type NotifyStepResponse as o, type WaitEventOptions as p, type CallSettings as q, type WorkflowLoggerOptions as r, WorkflowLogger as s };