@upstash/workflow 0.1.1-canary-2 → 0.1.1

package/README.md

@@ -1,3 +1,120 @@
-# Upstash Workflow
+# Upstash Workflow SDK
 
-Durable, Reliable and Performant Serverless Functions
+![npm (scoped)](https://img.shields.io/npm/v/@upstash/workflow)
+
+> [!NOTE]  
+> **This project is in GA Stage.**
+> The Upstash Professional Support fully covers this project. It receives regular updates, and bug fixes.
+> The Upstash team is committed to maintaining and improving its functionality.
+
+**Upstash Workflow** lets you write durable, reliable and performant serverless functions. Get delivery guarantees, automatic retries on failure, scheduling and more without managing any infrastructure.
+
+See [the documentation](https://upstash.com/docs/qstash/workflow/getstarted) for more details
+
+## Quick Start
+
+Here, we will briefly showcase how you can get started with Upstash Workflow.
+
+Alternatively, you can check [our quickstarts for different frameworks](https://upstash.com/docs/qstash/workflow/quickstarts/platforms), including [Next.js](https://upstash.com/docs/qstash/workflow/quickstarts/vercel-nextjs) and [Cloudflare](https://upstash.com/docs/qstash/workflow/quickstarts/cloudflare-workers).
+
+### Install
+
+First, install the package with:
+
+```
+npm install @upstash/workflow
+```
+
+### Get QStash token
+
+Go to [Upstash Console](https://console.upstash.com/qstash) and copy the QSTASH_TOKEN.
+
+### Define a Workflow Endpoint
+
+To declare workflow endpoints, use the `serve` method:
+
+```ts
+import { serve } from "@upstash/workflow/nextjs";
+
+// mock function
+const someWork = (input: string) => {
+  return `processed '${JSON.stringify(input)}'`;
+};
+
+// serve endpoint which expects a string payload:
+export const { POST } = serve<string>(async (context) => {
+  // get request body:
+  const input = context.requestPayload;
+
+  // run the first step:
+  const result1 = await context.run("step1", async () => {
+    const output = someWork(input);
+    console.log("step 1 input", input, "output", output);
+    return output;
+  });
+
+  // run the second step:
+  await context.run("step2", async () => {
+    const output = someWork(result1);
+    console.log("step 2 input", result1, "output", output);
+  });
+});
+```
+
+In the example, you can see that steps are declared through the `context` object.
+
+The kinds of steps which are available are:
+
+- `context.run`: execute a function
+- `context.sleep`: sleep for some time
+- `context.sleepUntil`: sleep until some timestamp
+- `context.call`: make a third party call without consuming any runtime
+- `context.waitForEvent`: wait for an event
+- `context.notify`: notify an event to make workflows waiting for the event continue
+
+You can [learn more about these methods from our documentation](https://upstash.com/docs/qstash/workflow/basics/context).
+
+### Workflow Client
+
+You can use [the Upstash Workflow client](https://upstash.com/docs/qstash/workflow/basics/client) to cancel workflows, notify workflows
+waiting for an event or get the workflows waiting for an event:
+
+```ts
+import { Client } from "@upstash/workflow";
+const client = new Client({ token: "<QSTASH_TOKEN>" });
+
+// cancel workflow:
+await client.cancel({ workflowRunId: "<WORKFLOW_RUN_ID>" });
+
+// notify workflows:
+await client.notify({
+  eventId: "my-event-id",
+  eventData: "my-data", // data passed to the workflow run
+});
+
+// get waiters:
+const result = await client.getWaiters({
+  eventId: "my-event-id",
+});
+```
+
+## Contributing
+
+### Setup
+
+This project requires [Bun](https://bun.sh/) to be installed. Please see the [Bun installation documentation](https://bun.sh/docs/installation) for further instructions.
+
+Once you have cloned the project, you will need to install the dependencies and then you can run the project.
+
+```sh
+bun install
+bun run build
+```
+
+### Testing
+
+To begin testing, environment variables will need to be setup. First, create a `.env` file in the root of the project. [`.env.template`](/.env.template) can be used as a template. Your values can be found in the [Qstash Console](https://console.upstash.com/qstash).
+
+```sh
+bun run test
+```

package/{chunk-BPN5JBNG.mjs → chunk-XPMFG3Q4.mjs}

@@ -448,6 +448,7 @@ var WORKFLOW_ID_HEADER = "Upstash-Workflow-RunId";
 var WORKFLOW_INIT_HEADER = "Upstash-Workflow-Init";
 var WORKFLOW_URL_HEADER = "Upstash-Workflow-Url";
 var WORKFLOW_FAILURE_HEADER = "Upstash-Workflow-Is-Failure";
+var WORKFLOW_FEATURE_HEADER = "Upstash-Feature-Set";
 var WORKFLOW_PROTOCOL_VERSION = "1";
 var WORKFLOW_PROTOCOL_VERSION_HEADER = "Upstash-Workflow-Sdk-Version";
 var DEFAULT_CONTENT_TYPE = "application/json";
@@ -533,13 +534,13 @@ var handleThirdPartyCallResult = async (request, requestPayload, client, workflo
   try {
     if (request.headers.get("Upstash-Workflow-Callback")) {
       const callbackMessage = JSON.parse(requestPayload);
-      if (!(callbackMessage.status >= 200 && callbackMessage.status < 300)) {
+      if (!(callbackMessage.status >= 200 && callbackMessage.status < 300) && callbackMessage.maxRetries && callbackMessage.retried !== callbackMessage.maxRetries) {
         await debug?.log("WARN", "SUBMIT_THIRD_PARTY_RESULT", {
           status: callbackMessage.status,
           body: atob(callbackMessage.body)
         });
         console.warn(
-          `Workflow Warning: "context.call" failed with status ${callbackMessage.status} and will retry (if there are retries remaining). Error Message:
+          `Workflow Warning: "context.call" failed with status ${callbackMessage.status} and will retry (retried ${callbackMessage.retried ?? 0} out of ${callbackMessage.maxRetries} times). Error Message:
 ${atob(callbackMessage.body)}`
         );
         return ok("call-will-retry");
@@ -576,7 +577,11 @@ ${atob(callbackMessage.body)}`
         stepId: Number(stepIdString),
         stepName,
         stepType,
-        out: atob(callbackMessage.body),
+        out: {
+          status: callbackMessage.status,
+          body: atob(callbackMessage.body),
+          header: callbackMessage.header
+        },
         concurrent: Number(concurrentString)
       };
       await debug?.log("SUBMIT", "SUBMIT_THIRD_PARTY_RESULT", {
@@ -611,15 +616,24 @@ var getHeaders = (initHeaderValue, workflowRunId, workflowUrl, userHeaders, step
     [WORKFLOW_INIT_HEADER]: initHeaderValue,
     [WORKFLOW_ID_HEADER]: workflowRunId,
     [WORKFLOW_URL_HEADER]: workflowUrl,
-    [`Upstash-Forward-${WORKFLOW_PROTOCOL_VERSION_HEADER}`]: WORKFLOW_PROTOCOL_VERSION,
-    ...failureUrl ? {
-      [`Upstash-Failure-Callback-Forward-${WORKFLOW_FAILURE_HEADER}`]: "true",
-      "Upstash-Failure-Callback": failureUrl
-    } : {},
-    ...retries === void 0 ? {} : {
-      "Upstash-Retries": retries.toString()
-    }
+    [WORKFLOW_FEATURE_HEADER]: "WF_NoDelete",
+    [`Upstash-Forward-${WORKFLOW_PROTOCOL_VERSION_HEADER}`]: WORKFLOW_PROTOCOL_VERSION
   };
+  if (failureUrl) {
+    if (!step?.callUrl) {
+      baseHeaders[`Upstash-Failure-Callback-Forward-${WORKFLOW_FAILURE_HEADER}`] = "true";
+    }
+    baseHeaders["Upstash-Failure-Callback"] = failureUrl;
+  }
+  if (step?.callUrl) {
+    baseHeaders["Upstash-Retries"] = "0";
+    if (retries) {
+      baseHeaders["Upstash-Callback-Retries"] = retries.toString();
+      baseHeaders["Upstash-Failure-Callback-Retries"] = retries.toString();
+    }
+  } else if (retries !== void 0) {
+    baseHeaders["Upstash-Retries"] = retries.toString();
+  }
   if (userHeaders) {
     for (const header of userHeaders.keys()) {
       if (step?.callHeaders) {
@@ -959,7 +973,8 @@ var AutoExecutor = class _AutoExecutor {
         path: ["v2", "wait", waitStep.waitEventId],
         body: JSON.stringify(waitBody),
         headers,
-        method: "POST"
+        method: "POST",
+        parseResponseAsJson: false
       });
       throw new QStashWorkflowAbort(steps[0].stepName, steps[0]);
     }
@@ -1505,15 +1520,38 @@ var WorkflowContext = class {
    * @param method call method
    * @param body call body
    * @param headers call headers
-   * @returns call result (parsed as JSON if possible)
+   * @returns call result as {
+   *     status: number;
+   *     body: unknown;
+   *     header: Record<string, string[]>
+   *   }
    */
-  // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-parameters
-  async call(stepName, url, method, body, headers) {
+  async call(stepName, settings) {
+    const { url, method = "GET", body, headers = {} } = settings;
     const result = await this.addStep(
       new LazyCallStep(stepName, url, method, body, headers ?? {})
     );
+    if (typeof result === "string") {
+      try {
+        const body2 = JSON.parse(result);
+        return {
+          status: 200,
+          header: {},
+          body: body2
+        };
+      } catch {
+        return {
+          status: 200,
+          header: {},
+          body: result
+        };
+      }
+    }
     try {
-      return JSON.parse(result);
+      return {
+        ...result,
+        body: JSON.parse(result.body)
+      };
     } catch {
       return result;
     }
@@ -1936,6 +1974,7 @@ var serve = (routeFunction, options) => {
   } = processOptions(options);
   const debug = WorkflowLogger.getLogger(verbose);
   const handler = async (request) => {
+    await debug?.log("INFO", "ENDPOINT_START");
     const { workflowUrl, workflowFailureUrl } = await determineUrls(
       request,
       url,
@@ -1979,7 +2018,8 @@ var serve = (routeFunction, options) => {
       url: workflowUrl,
       failureUrl: workflowFailureUrl,
       debug,
-      env
+      env,
+      retries
     });
     const authCheck = await DisabledWorkflowContext.tryAuthentication(
       routeFunction,
@@ -2022,7 +2062,7 @@ var serve = (routeFunction, options) => {
     await debug?.log("INFO", "RESPONSE_DEFAULT");
     return onStepFinish("no-workflow-id", "fromCallback");
   };
-  return async (request) => {
+  const safeHandler = async (request) => {
     try {
       return await handler(request);
     } catch (error) {
@@ -2032,6 +2072,7 @@ var serve = (routeFunction, options) => {
       });
     }
   };
+  return { handler: safeHandler };
 };
 
 // src/client/index.ts
@@ -2047,6 +2088,13 @@ var Client3 = class {
   /**
    * Cancel an ongoing workflow
    *
+   * ```ts
+   * import { Client } from "@upstash/workflow";
+   *
+   * const client = new Client({ token: "<QSTASH_TOKEN>" })
+   * await client.cancel({ workflowRunId: "<WORKFLOW_RUN_ID>" })
+   * ```
+   *
    * @param workflowRunId run id of the workflow to delete
    * @returns true if workflow is succesfully deleted. Otherwise throws QStashError
    */
@@ -2061,6 +2109,16 @@ var Client3 = class {
   /**
    * Notify a workflow run waiting for an event
    *
+   * ```ts
+   * import { Client } from "@upstash/workflow";
+   *
+   * const client = new Client({ token: "<QSTASH_TOKEN>" })
+   * await client.notify({
+   *   eventId: "my-event-id",
+   *   eventData: "my-data" // data passed to the workflow run
+   * });
+   * ```
+   *
    * @param eventId event id to notify
    * @param eventData data to provide to the workflow
    */
@@ -2073,6 +2131,15 @@ var Client3 = class {
   /**
    * Check waiters of an event
    *
+   * ```ts
+   * import { Client } from "@upstash/workflow";
+   *
+   * const client = new Client({ token: "<QSTASH_TOKEN>" })
+   * const result = await client.getWaiters({
+   *   eventId: "my-event-id"
+   * })
+   * ```
+   *
    * @param eventId event id to check
    */
   async getWaiters({ eventId }) {

package/cloudflare.d.mts

@@ -1,4 +1,4 @@
-import { R as RouteFunction, W as WorkflowServeOptions } from './types-CoXaNrxX.mjs';
+import { R as RouteFunction, W as WorkflowServeOptions } from './types-p7sxktVE.mjs';
 import '@upstash/qstash';
 
 type WorkflowBindings = {
@@ -28,6 +28,8 @@ type WorkersHandlerArgs = [Request, Record<string, string | undefined>];
  * @param options workflow options
  * @returns
  */
-declare const serve: <TInitialPayload = unknown>(routeFunction: RouteFunction<TInitialPayload>, options?: Omit<WorkflowServeOptions<Response, TInitialPayload>, "onStepFinish">) => ((...args: PagesHandlerArgs | WorkersHandlerArgs) => Promise<Response>);
+declare const serve: <TInitialPayload = unknown>(routeFunction: RouteFunction<TInitialPayload>, options?: Omit<WorkflowServeOptions<Response, TInitialPayload>, "onStepFinish">) => {
+    fetch: (...args: PagesHandlerArgs | WorkersHandlerArgs) => Promise<Response>;
+};
 
 export { type PagesHandlerArgs, type WorkersHandlerArgs, type WorkflowBindings, serve };

package/cloudflare.d.ts

@@ -1,4 +1,4 @@
-import { R as RouteFunction, W as WorkflowServeOptions } from './types-CoXaNrxX.js';
+import { R as RouteFunction, W as WorkflowServeOptions } from './types-p7sxktVE.js';
 import '@upstash/qstash';
 
 type WorkflowBindings = {
@@ -28,6 +28,8 @@ type WorkersHandlerArgs = [Request, Record<string, string | undefined>];
  * @param options workflow options
  * @returns
  */
-declare const serve: <TInitialPayload = unknown>(routeFunction: RouteFunction<TInitialPayload>, options?: Omit<WorkflowServeOptions<Response, TInitialPayload>, "onStepFinish">) => ((...args: PagesHandlerArgs | WorkersHandlerArgs) => Promise<Response>);
+declare const serve: <TInitialPayload = unknown>(routeFunction: RouteFunction<TInitialPayload>, options?: Omit<WorkflowServeOptions<Response, TInitialPayload>, "onStepFinish">) => {
+    fetch: (...args: PagesHandlerArgs | WorkersHandlerArgs) => Promise<Response>;
+};
 
 export { type PagesHandlerArgs, type WorkersHandlerArgs, type WorkflowBindings, serve };

package/cloudflare.js

@@ -474,6 +474,7 @@ var WORKFLOW_ID_HEADER = "Upstash-Workflow-RunId";
 var WORKFLOW_INIT_HEADER = "Upstash-Workflow-Init";
 var WORKFLOW_URL_HEADER = "Upstash-Workflow-Url";
 var WORKFLOW_FAILURE_HEADER = "Upstash-Workflow-Is-Failure";
+var WORKFLOW_FEATURE_HEADER = "Upstash-Feature-Set";
 var WORKFLOW_PROTOCOL_VERSION = "1";
 var WORKFLOW_PROTOCOL_VERSION_HEADER = "Upstash-Workflow-Sdk-Version";
 var DEFAULT_CONTENT_TYPE = "application/json";
@@ -559,13 +560,13 @@ var handleThirdPartyCallResult = async (request, requestPayload, client, workflo
   try {
     if (request.headers.get("Upstash-Workflow-Callback")) {
       const callbackMessage = JSON.parse(requestPayload);
-      if (!(callbackMessage.status >= 200 && callbackMessage.status < 300)) {
+      if (!(callbackMessage.status >= 200 && callbackMessage.status < 300) && callbackMessage.maxRetries && callbackMessage.retried !== callbackMessage.maxRetries) {
         await debug?.log("WARN", "SUBMIT_THIRD_PARTY_RESULT", {
           status: callbackMessage.status,
           body: atob(callbackMessage.body)
         });
         console.warn(
-          `Workflow Warning: "context.call" failed with status ${callbackMessage.status} and will retry (if there are retries remaining). Error Message:
+          `Workflow Warning: "context.call" failed with status ${callbackMessage.status} and will retry (retried ${callbackMessage.retried ?? 0} out of ${callbackMessage.maxRetries} times). Error Message:
 ${atob(callbackMessage.body)}`
         );
         return ok("call-will-retry");
@@ -602,7 +603,11 @@ ${atob(callbackMessage.body)}`
         stepId: Number(stepIdString),
         stepName,
         stepType,
-        out: atob(callbackMessage.body),
+        out: {
+          status: callbackMessage.status,
+          body: atob(callbackMessage.body),
+          header: callbackMessage.header
+        },
         concurrent: Number(concurrentString)
       };
       await debug?.log("SUBMIT", "SUBMIT_THIRD_PARTY_RESULT", {
@@ -637,15 +642,24 @@ var getHeaders = (initHeaderValue, workflowRunId, workflowUrl, userHeaders, step
     [WORKFLOW_INIT_HEADER]: initHeaderValue,
     [WORKFLOW_ID_HEADER]: workflowRunId,
     [WORKFLOW_URL_HEADER]: workflowUrl,
-    [`Upstash-Forward-${WORKFLOW_PROTOCOL_VERSION_HEADER}`]: WORKFLOW_PROTOCOL_VERSION,
-    ...failureUrl ? {
-      [`Upstash-Failure-Callback-Forward-${WORKFLOW_FAILURE_HEADER}`]: "true",
-      "Upstash-Failure-Callback": failureUrl
-    } : {},
-    ...retries === void 0 ? {} : {
-      "Upstash-Retries": retries.toString()
-    }
+    [WORKFLOW_FEATURE_HEADER]: "WF_NoDelete",
+    [`Upstash-Forward-${WORKFLOW_PROTOCOL_VERSION_HEADER}`]: WORKFLOW_PROTOCOL_VERSION
   };
+  if (failureUrl) {
+    if (!step?.callUrl) {
+      baseHeaders[`Upstash-Failure-Callback-Forward-${WORKFLOW_FAILURE_HEADER}`] = "true";
+    }
+    baseHeaders["Upstash-Failure-Callback"] = failureUrl;
+  }
+  if (step?.callUrl) {
+    baseHeaders["Upstash-Retries"] = "0";
+    if (retries) {
+      baseHeaders["Upstash-Callback-Retries"] = retries.toString();
+      baseHeaders["Upstash-Failure-Callback-Retries"] = retries.toString();
+    }
+  } else if (retries !== void 0) {
+    baseHeaders["Upstash-Retries"] = retries.toString();
+  }
   if (userHeaders) {
     for (const header of userHeaders.keys()) {
       if (step?.callHeaders) {
@@ -985,7 +999,8 @@ var AutoExecutor = class _AutoExecutor {
         path: ["v2", "wait", waitStep.waitEventId],
         body: JSON.stringify(waitBody),
         headers,
-        method: "POST"
+        method: "POST",
+        parseResponseAsJson: false
       });
       throw new QStashWorkflowAbort(steps[0].stepName, steps[0]);
     }
@@ -1524,15 +1539,38 @@ var WorkflowContext = class {
    * @param method call method
    * @param body call body
    * @param headers call headers
-   * @returns call result (parsed as JSON if possible)
+   * @returns call result as {
+   *     status: number;
+   *     body: unknown;
+   *     header: Record<string, string[]>
+   *   }
    */
-  // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-parameters
-  async call(stepName, url, method, body, headers) {
+  async call(stepName, settings) {
+    const { url, method = "GET", body, headers = {} } = settings;
     const result = await this.addStep(
       new LazyCallStep(stepName, url, method, body, headers ?? {})
     );
+    if (typeof result === "string") {
+      try {
+        const body2 = JSON.parse(result);
+        return {
+          status: 200,
+          header: {},
+          body: body2
+        };
+      } catch {
+        return {
+          status: 200,
+          header: {},
+          body: result
+        };
+      }
+    }
     try {
-      return JSON.parse(result);
+      return {
+        ...result,
+        body: JSON.parse(result.body)
+      };
     } catch {
       return result;
     }
@@ -1955,6 +1993,7 @@ var serve = (routeFunction, options) => {
   } = processOptions(options);
   const debug = WorkflowLogger.getLogger(verbose);
   const handler = async (request) => {
+    await debug?.log("INFO", "ENDPOINT_START");
     const { workflowUrl, workflowFailureUrl } = await determineUrls(
       request,
       url,
@@ -1998,7 +2037,8 @@ var serve = (routeFunction, options) => {
       url: workflowUrl,
       failureUrl: workflowFailureUrl,
       debug,
-      env
+      env,
+      retries
     });
     const authCheck = await DisabledWorkflowContext.tryAuthentication(
       routeFunction,
@@ -2041,7 +2081,7 @@ var serve = (routeFunction, options) => {
     await debug?.log("INFO", "RESPONSE_DEFAULT");
     return onStepFinish("no-workflow-id", "fromCallback");
   };
-  return async (request) => {
+  const safeHandler = async (request) => {
     try {
       return await handler(request);
     } catch (error) {
@@ -2051,6 +2091,7 @@ var serve = (routeFunction, options) => {
       });
     }
   };
+  return { handler: safeHandler };
 };
 
 // src/client/index.ts
@@ -2076,15 +2117,15 @@ var getArgs = (args) => {
   throw new Error("Could not derive handler arguments from input. Please check how serve is used.");
 };
 var serve2 = (routeFunction, options) => {
-  const handler = async (...args) => {
+  const fetch = async (...args) => {
     const { request, env } = getArgs(args);
-    const serveHandler = serve(routeFunction, {
+    const { handler: serveHandler } = serve(routeFunction, {
       env,
       ...options
     });
     return await serveHandler(request);
   };
-  return handler;
+  return { fetch };
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/cloudflare.mjs

@@ -1,6 +1,6 @@
 import {
   serve
-} from "./chunk-BPN5JBNG.mjs";
+} from "./chunk-XPMFG3Q4.mjs";
 
 // platforms/cloudflare.ts
 var getArgs = (args) => {
@@ -22,15 +22,15 @@ var getArgs = (args) => {
   throw new Error("Could not derive handler arguments from input. Please check how serve is used.");
 };
 var serve2 = (routeFunction, options) => {
-  const handler = async (...args) => {
+  const fetch = async (...args) => {
     const { request, env } = getArgs(args);
-    const serveHandler = serve(routeFunction, {
+    const { handler: serveHandler } = serve(routeFunction, {
       env,
       ...options
     });
     return await serveHandler(request);
   };
-  return handler;
+  return { fetch };
 };
 export {
   serve2 as serve

package/h3.d.mts

@@ -1,10 +1,12 @@
 import * as h3 from 'h3';
-import { R as RouteFunction, W as WorkflowServeOptions } from './types-CoXaNrxX.mjs';
+import { R as RouteFunction, W as WorkflowServeOptions } from './types-p7sxktVE.mjs';
 import '@upstash/qstash';
 
-declare const serve: <TInitialPayload = unknown>(routeFunction: RouteFunction<TInitialPayload>, options?: Omit<WorkflowServeOptions<Response, TInitialPayload>, "onStepFinish">) => h3.EventHandler<h3.EventHandlerRequest, Promise<Response | {
-    status: number;
-    body: string;
-}>>;
+declare const serve: <TInitialPayload = unknown>(routeFunction: RouteFunction<TInitialPayload>, options?: Omit<WorkflowServeOptions<Response, TInitialPayload>, "onStepFinish">) => {
+    handler: h3.EventHandler<h3.EventHandlerRequest, Promise<Response | {
+        status: number;
+        body: string;
+    }>>;
+};
 
 export { serve };

package/h3.d.ts

@@ -1,10 +1,12 @@
 import * as h3 from 'h3';
-import { R as RouteFunction, W as WorkflowServeOptions } from './types-CoXaNrxX.js';
+import { R as RouteFunction, W as WorkflowServeOptions } from './types-p7sxktVE.js';
 import '@upstash/qstash';
 
-declare const serve: <TInitialPayload = unknown>(routeFunction: RouteFunction<TInitialPayload>, options?: Omit<WorkflowServeOptions<Response, TInitialPayload>, "onStepFinish">) => h3.EventHandler<h3.EventHandlerRequest, Promise<Response | {
-    status: number;
-    body: string;
-}>>;
+declare const serve: <TInitialPayload = unknown>(routeFunction: RouteFunction<TInitialPayload>, options?: Omit<WorkflowServeOptions<Response, TInitialPayload>, "onStepFinish">) => {
+    handler: h3.EventHandler<h3.EventHandlerRequest, Promise<Response | {
+        status: number;
+        body: string;
+    }>>;
+};
 
 export { serve };