@upstash/workflow 0.2.7 → 0.2.8-rc-invoke

package/svelte.js

@@ -20,7 +20,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // platforms/svelte.ts
 var svelte_exports = {};
 __export(svelte_exports, {
-  serve: () => serve
+  createWorkflow: () => createWorkflow,
+  serve: () => serve,
+  serveMany: () => serveMany
 });
 module.exports = __toCommonJS(svelte_exports);
 
@@ -88,7 +90,7 @@ var WORKFLOW_PROTOCOL_VERSION_HEADER = "Upstash-Workflow-Sdk-Version";
 var DEFAULT_CONTENT_TYPE = "application/json";
 var NO_CONCURRENCY = 1;
 var DEFAULT_RETRIES = 3;
-var VERSION = "v0.2.3";
+var VERSION = "v0.2.7";
 var SDK_TELEMETRY = `@upstash/workflow@${VERSION}`;
 var TELEMETRY_HEADER_SDK = "Upstash-Telemetry-Sdk";
 var TELEMETRY_HEADER_FRAMEWORK = "Upstash-Telemetry-Framework";
@@ -135,6 +137,31 @@ var formatWorkflowError = (error) => {
   };
 };
 
+// src/utils.ts
+var NANOID_CHARS = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-_";
+var NANOID_LENGTH = 21;
+function getRandomInt() {
+  return Math.floor(Math.random() * NANOID_CHARS.length);
+}
+function nanoid() {
+  return Array.from({ length: NANOID_LENGTH }).map(() => NANOID_CHARS[getRandomInt()]).join("");
+}
+function getWorkflowRunId(id) {
+  return `wfr_${id ?? nanoid()}`;
+}
+function decodeBase64(base64) {
+  try {
+    const binString = atob(base64);
+    const intArray = Uint8Array.from(binString, (m) => m.codePointAt(0));
+    return new TextDecoder().decode(intArray);
+  } catch (error) {
+    console.warn(
+      `Upstash Qstash: Failed while decoding base64 "${base64}". Decoding with atob and returning it instead. ${error}`
+    );
+    return atob(base64);
+  }
+}
+
 // src/context/steps.ts
 var BaseLazyStep = class {
   stepName;
@@ -315,6 +342,41 @@ var LazyNotifyStep = class extends LazyFunctionStep {
     });
   }
 };
+var LazyInvokeStep = class extends BaseLazyStep {
+  stepType = "Invoke";
+  params;
+  constructor(stepName, { workflow, body, headers = {}, workflowRunId, retries }) {
+    super(stepName);
+    this.params = {
+      workflow,
+      body,
+      headers,
+      workflowRunId: getWorkflowRunId(workflowRunId),
+      retries
+    };
+  }
+  getPlanStep(concurrent, targetStep) {
+    return {
+      stepId: 0,
+      stepName: this.stepName,
+      stepType: this.stepType,
+      concurrent,
+      targetStep
+    };
+  }
+  /**
+   * won't be used as it's the server who will add the result step
+   * in Invoke step.
+   */
+  getResultStep(concurrent, stepId) {
+    return Promise.resolve({
+      stepId,
+      stepName: this.stepName,
+      stepType: this.stepType,
+      concurrent
+    });
+  }
+};
 
 // node_modules/neverthrow/dist/index.es.js
 var defaultErrorConfig = {
@@ -739,7 +801,8 @@ var StepTypes = [
   "SleepUntil",
   "Call",
   "Wait",
-  "Notify"
+  "Notify",
+  "Invoke"
 ];
 
 // src/workflow-requests.ts
@@ -747,7 +810,7 @@ var import_qstash3 = require("@upstash/qstash");
 var triggerFirstInvocation = async ({
   workflowContext,
   useJSONContent,
-  telemetry,
+  telemetry: telemetry2,
   debug
 }) => {
   const { headers } = getHeaders({
@@ -757,7 +820,7 @@ var triggerFirstInvocation = async ({
     userHeaders: workflowContext.headers,
     failureUrl: workflowContext.failureUrl,
     retries: workflowContext.retries,
-    telemetry
+    telemetry: telemetry2
   });
   if (workflowContext.headers.get("content-type")) {
     headers["content-type"] = workflowContext.headers.get("content-type");
@@ -803,8 +866,8 @@ var triggerRouteFunction = async ({
   debug
 }) => {
   try {
-    await onStep();
-    await onCleanup();
+    const result = await onStep();
+    await onCleanup(result);
     return ok("workflow-finished");
   } catch (error) {
     const error_ = error;
@@ -825,14 +888,15 @@ var triggerRouteFunction = async ({
     }
   }
 };
-var triggerWorkflowDelete = async (workflowContext, debug, cancel = false) => {
+var triggerWorkflowDelete = async (workflowContext, result, debug, cancel = false) => {
   await debug?.log("SUBMIT", "SUBMIT_CLEANUP", {
     deletedWorkflowRunId: workflowContext.workflowRunId
   });
   await workflowContext.qstashClient.http.request({
     path: ["v2", "workflows", "runs", `${workflowContext.workflowRunId}?cancel=${cancel}`],
     method: "DELETE",
-    parseResponseAsJson: false
+    parseResponseAsJson: false,
+    body: JSON.stringify(result)
   });
   await debug?.log(
     "SUBMIT",
@@ -861,7 +925,7 @@ var handleThirdPartyCallResult = async ({
   workflowUrl,
   failureUrl,
   retries,
-  telemetry,
+  telemetry: telemetry2,
   debug
 }) => {
   try {
@@ -929,7 +993,7 @@ ${atob(callbackMessage.body ?? "")}`
         userHeaders,
         failureUrl,
         retries,
-        telemetry
+        telemetry: telemetry2
       });
       const callResponse = {
         status: callbackMessage.status,
@@ -968,11 +1032,11 @@ ${atob(callbackMessage.body ?? "")}`
     );
   }
 };
-var getTelemetryHeaders = (telemetry) => {
+var getTelemetryHeaders = (telemetry2) => {
   return {
-    [TELEMETRY_HEADER_SDK]: telemetry.sdk,
-    [TELEMETRY_HEADER_FRAMEWORK]: telemetry.framework,
-    [TELEMETRY_HEADER_RUNTIME]: telemetry.runtime ?? "unknown"
+    [TELEMETRY_HEADER_SDK]: telemetry2.sdk,
+    [TELEMETRY_HEADER_FRAMEWORK]: telemetry2.framework,
+    [TELEMETRY_HEADER_RUNTIME]: telemetry2.runtime ?? "unknown"
   };
 };
 var getHeaders = ({
@@ -985,14 +1049,17 @@ var getHeaders = ({
   step,
   callRetries,
   callTimeout,
-  telemetry
+  telemetry: telemetry2
 }) => {
+  const contentType = (userHeaders ? userHeaders.get("Content-Type") : void 0) ?? DEFAULT_CONTENT_TYPE;
   const baseHeaders = {
     [WORKFLOW_INIT_HEADER]: initHeaderValue,
     [WORKFLOW_ID_HEADER]: workflowRunId,
     [WORKFLOW_URL_HEADER]: workflowUrl,
     [WORKFLOW_FEATURE_HEADER]: "LazyFetch,InitialBody",
-    ...telemetry ? getTelemetryHeaders(telemetry) : {}
+    [WORKFLOW_PROTOCOL_VERSION_HEADER]: WORKFLOW_PROTOCOL_VERSION,
+    "content-type": contentType,
+    ...telemetry2 ? getTelemetryHeaders(telemetry2) : {}
   };
   if (!step?.callUrl) {
     baseHeaders[`Upstash-Forward-${WORKFLOW_PROTOCOL_VERSION_HEADER}`] = WORKFLOW_PROTOCOL_VERSION;
@@ -1006,6 +1073,9 @@ var getHeaders = ({
       baseHeaders["Upstash-Failure-Callback"] = failureUrl;
     }
   }
+  if (step?.stepType === "Invoke") {
+    baseHeaders["upstash-workflow-invoke"] = "true";
+  }
   if (step?.callUrl) {
     baseHeaders["Upstash-Retries"] = callRetries?.toString() ?? "0";
     baseHeaders[WORKFLOW_FEATURE_HEADER] = "WF_NoDelete,InitialBody";
@@ -1027,7 +1097,6 @@ var getHeaders = ({
       baseHeaders[`Upstash-Failure-Callback-Forward-${header}`] = userHeaders.get(header);
     }
   }
-  const contentType = (userHeaders ? userHeaders.get("Content-Type") : void 0) ?? DEFAULT_CONTENT_TYPE;
   if (step?.callHeaders) {
     const forwardedHeaders = Object.fromEntries(
       Object.entries(step.callHeaders).map(([header, value]) => [
@@ -1067,8 +1136,8 @@ var getHeaders = ({
           Object.entries(baseHeaders).map(([header, value]) => [header, [value]])
         ),
         // to include telemetry headers:
-        ...telemetry ? Object.fromEntries(
-          Object.entries(getTelemetryHeaders(telemetry)).map(([header, value]) => [
+        ...telemetry2 ? Object.fromEntries(
+          Object.entries(getTelemetryHeaders(telemetry2)).map(([header, value]) => [
             header,
             [value]
           ])
@@ -1077,8 +1146,7 @@ var getHeaders = ({
         "Upstash-Workflow-Runid": [workflowRunId],
         [WORKFLOW_INIT_HEADER]: ["false"],
         [WORKFLOW_URL_HEADER]: [workflowUrl],
-        "Upstash-Workflow-CallType": ["step"],
-        "Content-Type": [contentType]
+        "Upstash-Workflow-CallType": ["step"]
       }
     };
   }
@@ -1124,10 +1192,10 @@ var AutoExecutor = class _AutoExecutor {
   stepCount = 0;
   planStepCount = 0;
   executingStep = false;
-  constructor(context, steps, telemetry, debug) {
+  constructor(context, steps, telemetry2, debug) {
     this.context = context;
     this.steps = steps;
-    this.telemetry = telemetry;
+    this.telemetry = telemetry2;
     this.debug = debug;
     this.nonPlanStepCount = this.steps.filter((step) => !step.targetStep).length;
   }
@@ -1373,7 +1441,23 @@ var AutoExecutor = class _AutoExecutor {
         method: "POST",
         parseResponseAsJson: false
       });
-      throw new WorkflowAbort(steps[0].stepName, steps[0]);
+      throw new WorkflowAbort(waitStep.stepName, waitStep);
+    }
+    if (steps.length === 1 && lazySteps[0] instanceof LazyInvokeStep) {
+      const invokeStep = steps[0];
+      const lazyInvokeStep = lazySteps[0];
+      await lazyInvokeStep.params.workflow.callback(
+        {
+          body: lazyInvokeStep.params.body,
+          headers: lazyInvokeStep.params.headers,
+          workflowRunId: lazyInvokeStep.params.workflowRunId,
+          workflow: lazyInvokeStep.params.workflow,
+          retries: lazyInvokeStep.params.retries
+        },
+        invokeStep,
+        this.context
+      );
+      throw new WorkflowAbort(invokeStep.stepName, invokeStep);
     }
     const result = await this.context.qstashClient.batchJSON(
       steps.map((singleStep, index) => {
@@ -2059,7 +2143,7 @@ var WorkflowContext = class {
     initialPayload,
     env,
     retries,
-    telemetry
+    telemetry: telemetry2
   }) {
     this.qstashClient = qstashClient;
     this.workflowRunId = workflowRunId;
@@ -2070,7 +2154,7 @@ var WorkflowContext = class {
     this.requestPayload = initialPayload;
     this.env = env ?? {};
     this.retries = retries ?? DEFAULT_RETRIES;
-    this.executor = new AutoExecutor(this, this.steps, telemetry, debug);
+    this.executor = new AutoExecutor(this, this.steps, telemetry2, debug);
   }
   /**
    * Executes a workflow step
@@ -2290,6 +2374,13 @@ var WorkflowContext = class {
       return result;
     }
   }
+  async invoke(stepName, settings) {
+    const result = await this.addStep(new LazyInvokeStep(stepName, settings));
+    return {
+      ...result,
+      body: result.body ? JSON.parse(result.body) : void 0
+    };
+  }
   /**
    * Cancel the current workflow run
    *
@@ -2367,31 +2458,6 @@ var WorkflowLogger = class _WorkflowLogger {
   }
 };
 
-// src/utils.ts
-var NANOID_CHARS = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-_";
-var NANOID_LENGTH = 21;
-function getRandomInt() {
-  return Math.floor(Math.random() * NANOID_CHARS.length);
-}
-function nanoid() {
-  return Array.from({ length: NANOID_LENGTH }).map(() => NANOID_CHARS[getRandomInt()]).join("");
-}
-function getWorkflowRunId(id) {
-  return `wfr_${id ?? nanoid()}`;
-}
-function decodeBase64(base64) {
-  try {
-    const binString = atob(base64);
-    const intArray = Uint8Array.from(binString, (m) => m.codePointAt(0));
-    return new TextDecoder().decode(intArray);
-  } catch (error) {
-    console.warn(
-      `Upstash Qstash: Failed while decoding base64 "${base64}". Decoding with atob and returning it instead. ${error}`
-    );
-    return atob(base64);
-  }
-}
-
 // src/serve/authorization.ts
 var import_qstash8 = require("@upstash/qstash");
 var DisabledWorkflowContext = class _DisabledWorkflowContext extends WorkflowContext {
@@ -2729,7 +2795,7 @@ var determineUrls = async (request, url, baseUrl, failureFunction, failureUrl, d
 var AUTH_FAIL_MESSAGE = `Failed to authenticate Workflow request. If this is unexpected, see the caveat https://upstash.com/docs/workflow/basics/caveats#avoid-non-deterministic-code-outside-context-run`;
 
 // src/serve/index.ts
-var serveBase = (routeFunction, telemetry, options) => {
+var serveBase = (routeFunction, telemetry2, options) => {
   const {
     qstashClient,
     onStepFinish,
@@ -2745,7 +2811,7 @@ var serveBase = (routeFunction, telemetry, options) => {
     useJSONContent,
     disableTelemetry
   } = processOptions(options);
-  telemetry = disableTelemetry ? void 0 : telemetry;
+  telemetry2 = disableTelemetry ? void 0 : telemetry2;
   const debug = WorkflowLogger.getLogger(verbose);
   const handler = async (request) => {
     await debug?.log("INFO", "ENDPOINT_START");
@@ -2803,7 +2869,7 @@ var serveBase = (routeFunction, telemetry, options) => {
       debug,
       env,
       retries,
-      telemetry
+      telemetry: telemetry2
     });
     const authCheck = await DisabledWorkflowContext.tryAuthentication(
       routeFunction,
@@ -2826,7 +2892,7 @@ var serveBase = (routeFunction, telemetry, options) => {
       workflowUrl,
       failureUrl: workflowFailureUrl,
       retries,
-      telemetry,
+      telemetry: telemetry2,
       debug
     });
     if (callReturnCheck.isErr()) {
@@ -2835,10 +2901,10 @@ var serveBase = (routeFunction, telemetry, options) => {
       });
       throw callReturnCheck.error;
     } else if (callReturnCheck.value === "continue-workflow") {
-      const result = isFirstInvocation ? await triggerFirstInvocation({ workflowContext, useJSONContent, telemetry, debug }) : await triggerRouteFunction({
+      const result = isFirstInvocation ? await triggerFirstInvocation({ workflowContext, useJSONContent, telemetry: telemetry2, debug }) : await triggerRouteFunction({
         onStep: async () => routeFunction(workflowContext),
-        onCleanup: async () => {
-          await triggerWorkflowDelete(workflowContext, debug);
+        onCleanup: async (result2) => {
+          await triggerWorkflowDelete(workflowContext, result2, debug);
         },
         onCancel: async () => {
           await makeCancelRequest(workflowContext.qstashClient.http, workflowRunId);
@@ -2870,25 +2936,128 @@ var serveBase = (routeFunction, telemetry, options) => {
   return { handler: safeHandler };
 };
 
+// src/serve/serve-many.ts
+var serveManyBase = ({
+  workflows,
+  getWorkflowId
+}) => {
+  const workflowIds = [];
+  const workflowMap = Object.fromEntries(
+    Object.entries(workflows).map((workflow) => {
+      const workflowId = workflow[0];
+      if (workflowIds.includes(workflowId)) {
+        throw new WorkflowError(
+          `Duplicate workflow name found: '${workflowId}'. Please set different workflow names in serveMany.`
+        );
+      }
+      if (workflowId.includes("/")) {
+        throw new WorkflowError(
+          `Invalid workflow name found: '${workflowId}'. Workflow name cannot contain '/'.`
+        );
+      }
+      workflowIds.push(workflowId);
+      workflow[1].workflowId = workflowId;
+      return [workflowId, workflow[1].handler];
+    })
+  );
+  return {
+    handler: async (...params) => {
+      const pickedWorkflowId = getWorkflowId(...params);
+      if (!pickedWorkflowId) {
+        throw new WorkflowError(`Unexpected request in serveMany. workflowId not set. Please update the URL of your request.`);
+      }
+      const workflow = workflowMap[pickedWorkflowId];
+      if (!workflow) {
+        throw new WorkflowError(`No workflows in serveMany found for '${pickedWorkflowId}'. Please update the URL of your request.`);
+      }
+      return await workflow(...params);
+    }
+  };
+};
+var createInvokeCallback = (telemetry2) => {
+  const invokeCallback = async (settings, invokeStep, context) => {
+    const { body, workflow, headers = {}, workflowRunId = getWorkflowRunId(), retries } = settings;
+    const { workflowId } = workflow;
+    if (!workflowId) {
+      throw new WorkflowError("You can only invoke workflow which has a workflowId");
+    }
+    const { headers: invokerHeaders } = getHeaders({
+      initHeaderValue: "false",
+      workflowRunId: context.workflowRunId,
+      workflowUrl: context.url,
+      userHeaders: context.headers,
+      failureUrl: context.failureUrl,
+      retries: context.retries,
+      telemetry: telemetry2
+    });
+    invokerHeaders["Upstash-Workflow-Runid"] = context.workflowRunId;
+    const newUrl = context.url.replace(/[^/]+$/, workflowId);
+    const { headers: triggerHeaders } = getHeaders({
+      initHeaderValue: "true",
+      workflowRunId,
+      workflowUrl: newUrl,
+      userHeaders: new Headers(headers),
+      retries,
+      telemetry: telemetry2
+    });
+    triggerHeaders["Upstash-Workflow-Invoke"] = "true";
+    const request = {
+      body: JSON.stringify(body),
+      headers: Object.fromEntries(
+        Object.entries(invokerHeaders).map((pairs) => [pairs[0], [pairs[1]]])
+      ),
+      workflowRunId,
+      workflowUrl: context.url,
+      step: invokeStep
+    };
+    await context.qstashClient.publish({
+      headers: triggerHeaders,
+      method: "POST",
+      body: JSON.stringify(request),
+      url: newUrl
+    });
+    return void 0;
+  };
+  return invokeCallback;
+};
+
 // platforms/svelte.ts
+var telemetry = {
+  sdk: SDK_TELEMETRY,
+  framework: "svelte"
+};
 var serve = (routeFunction, options) => {
   const handler = async ({ request }) => {
-    const { handler: serveHandler } = serveBase(
-      routeFunction,
-      {
-        sdk: SDK_TELEMETRY,
-        framework: "svelte"
-      },
-      {
-        ...options,
-        useJSONContent: true
-      }
-    );
+    const { handler: serveHandler } = serveBase(routeFunction, telemetry, {
+      ...options,
+      useJSONContent: true
+    });
     return await serveHandler(request);
   };
   return { POST: handler };
 };
+var createWorkflow = (...params) => {
+  const { POST } = serve(...params);
+  return {
+    callback: createInvokeCallback(telemetry),
+    handler: POST,
+    workflowId: void 0
+  };
+};
+var serveMany = (workflows) => {
+  return {
+    POST: serveManyBase({
+      workflows,
+      getWorkflowId(params) {
+        const components = params.url.toString().split("/");
+        return components[components.length - 1];
+      }
+    }).handler
+  };
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  serve
+  createWorkflow,
+  serve,
+  serveMany
 });

package/svelte.mjs

@@ -1,26 +1,48 @@
+import {
+  createInvokeCallback,
+  serveManyBase
+} from "./chunk-LCZMBGEM.mjs";
 import {
   SDK_TELEMETRY,
   serveBase
-} from "./chunk-U6XFLG7W.mjs";
+} from "./chunk-IWAW7GIG.mjs";
 
 // platforms/svelte.ts
+var telemetry = {
+  sdk: SDK_TELEMETRY,
+  framework: "svelte"
+};
 var serve = (routeFunction, options) => {
   const handler = async ({ request }) => {
-    const { handler: serveHandler } = serveBase(
-      routeFunction,
-      {
-        sdk: SDK_TELEMETRY,
-        framework: "svelte"
-      },
-      {
-        ...options,
-        useJSONContent: true
-      }
-    );
+    const { handler: serveHandler } = serveBase(routeFunction, telemetry, {
+      ...options,
+      useJSONContent: true
+    });
     return await serveHandler(request);
   };
   return { POST: handler };
 };
+var createWorkflow = (...params) => {
+  const { POST } = serve(...params);
+  return {
+    callback: createInvokeCallback(telemetry),
+    handler: POST,
+    workflowId: void 0
+  };
+};
+var serveMany = (workflows) => {
+  return {
+    POST: serveManyBase({
+      workflows,
+      getWorkflowId(params) {
+        const components = params.url.toString().split("/");
+        return components[components.length - 1];
+      }
+    }).handler
+  };
+};
 export {
-  serve
+  createWorkflow,
+  serve,
+  serveMany
 };

package/{types-Cuqlx2Cr.d.mts → types-C7Y7WUQd.d.mts}

@@ -33,6 +33,11 @@ declare abstract class BaseLazyStep<TResult = unknown> {
      */
     abstract getResultStep(concurrent: number, stepId: number): Promise<Step<TResult>>;
 }
+type LazyInvokeStepParams<TInitiaPayload, TResult> = {
+    workflow: Pick<InvokableWorkflow<TInitiaPayload, TResult, unknown[]>, "callback" | "workflowId">;
+    body: TInitiaPayload;
+    workflowRunId?: string;
+} & Pick<CallSettings, "retries" | "headers">;
 
 declare const LOG_LEVELS: readonly ["DEBUG", "INFO", "SUBMIT", "WARN", "ERROR"];
 type LogLevel = (typeof LOG_LEVELS)[number];
@@ -917,6 +922,11 @@ declare class WorkflowContext<TInitialPayload = unknown> {
      * @returns notify response which has event id, event data and list of waiters which were notified
      */
     notify(stepName: string, eventId: string, eventData: unknown): Promise<NotifyStepResponse>;
+    invoke<TInitialPayload, TResult>(stepName: string, settings: LazyInvokeStepParams<TInitialPayload, TResult>): Promise<{
+        body: any;
+        isCanceled?: boolean;
+        isFailed?: boolean;
+    }>;
     /**
      * Cancel the current workflow run
      *
@@ -952,7 +962,7 @@ type WorkflowClient = {
 type WorkflowReceiver = {
     verify: InstanceType<typeof Receiver>["verify"];
 };
-declare const StepTypes: readonly ["Initial", "Run", "SleepFor", "SleepUntil", "Call", "Wait", "Notify"];
+declare const StepTypes: readonly ["Initial", "Run", "SleepFor", "SleepUntil", "Call", "Wait", "Notify", "Invoke"];
 type StepType = (typeof StepTypes)[number];
 type ThirdPartyCallFields<TBody = unknown> = {
     /**
@@ -1035,7 +1045,7 @@ type SyncStepFunction<TResult> = () => TResult;
 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 RouteFunction<TInitialPayload, TResult = unknown> = (context: WorkflowContext<TInitialPayload>) => Promise<TResult>;
 type FinishCondition = "success" | "duplicate-step" | "fromCallback" | "auth-fail" | "failure-callback" | "workflow-already-ended";
 type WorkflowServeOptions<TResponse extends Response = Response, TInitialPayload = unknown> = ValidationOptions<TInitialPayload> & {
     /**
@@ -1312,5 +1322,23 @@ type HeaderParams = {
      */
     callTimeout?: never;
 });
+type InvokeWorkflowRequest = {
+    workflowUrl: string;
+    workflowRunId: string;
+    headers: Record<string, string[]>;
+    step: Step;
+    body: string;
+};
+type InvokeStepResponse<TBody> = {
+    body: TBody;
+    isCanceled?: boolean;
+    isFailed?: boolean;
+};
+type InvokeCallback<TInitiaPayload, TResult> = (settings: LazyInvokeStepParams<TInitiaPayload, TResult>, invokeStep: Step, context: WorkflowContext) => Promise<TResult>;
+type InvokableWorkflow<TInitialPayload, TResult, THandlerParams extends unknown[]> = {
+    handler: (...args: THandlerParams) => any;
+    callback: InvokeCallback<TInitialPayload, TResult>;
+    workflowId?: string;
+};
 
-export { type AsyncStepFunction as A, type CallResponse as C, type Duration as D, type ExclusiveValidationOptions as E, type FinishCondition as F, type HeaderParams as H, type LogLevel as L, type NotifyResponse as N, type ParallelCallState as P, type RouteFunction as R, type Step as S, type Telemetry as T, 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 };
+export { type AsyncStepFunction as A, type CallResponse as C, type Duration as D, type ExclusiveValidationOptions as E, type FinishCondition as F, type HeaderParams as H, type InvokeWorkflowRequest as I, type LogLevel as L, type NotifyResponse as N, type ParallelCallState as P, type RouteFunction as R, type Step as S, type Telemetry as T, 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 InvokeStepResponse as r, type InvokeCallback as s, type InvokableWorkflow as t, type WorkflowLoggerOptions as u, WorkflowLogger as v };