inngest 2.7.2 → 3.0.0

package/components/Inngest.js

@@ -6,7 +6,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 };
 var _Inngest_instances, _Inngest_getResponseError;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Inngest = void 0;
+exports.builtInMiddleware = exports.Inngest = void 0;
 const api_1 = require("../api/api");
 const consts_1 = require("../helpers/consts");
 const devserver_1 = require("../helpers/devserver");
@@ -60,7 +60,7 @@ class Inngest {
      * });
      * ```
      */
-    constructor({ name, eventKey, inngestBaseUrl = "https://inn.gs/", fetch, env, logger = new logger_1.DefaultLogger(), middleware, }) {
+    constructor({ id, eventKey, baseUrl, fetch, env, logger = new logger_1.DefaultLogger(), middleware, }) {
         _Inngest_instances.add(this);
         /**
          * Inngest event key, used to send events to Inngest Cloud.
@@ -69,14 +69,14 @@ class Inngest {
         /**
          * The absolute URL of the Inngest Cloud API.
          */
-        this.inngestApiUrl = new URL(`e/${this.eventKey}`, "https://inn.gs/");
-        if (!name) {
+        this.sendEventUrl = new URL(`e/${this.eventKey}`, consts_1.defaultInngestEventBaseUrl);
+        if (!id) {
             // TODO PrettyError
-            throw new Error("A name must be passed to create an Inngest instance.");
+            throw new Error("An `id` must be passed to create an Inngest instance.");
         }
-        this.name = name;
-        this.inngestBaseUrl = new URL(inngestBaseUrl);
-        this.setEventKey(eventKey || (0, env_1.processEnv)(consts_1.envKeys.EventKey) || "");
+        this.id = id;
+        this.baseUrl = baseUrl || (0, env_1.processEnv)(consts_1.envKeys.InngestBaseUrl);
+        this.setEventKey(eventKey || (0, env_1.processEnv)(consts_1.envKeys.InngestEventKey) || "");
         if (!this.eventKey) {
             console.warn((0, errors_1.prettyError)({
                 type: "warn",
@@ -91,15 +91,14 @@ class Inngest {
             inngestEnv: env,
         });
         this.fetch = (0, env_1.getFetch)(fetch);
-        const signingKey = (0, env_1.processEnv)(consts_1.envKeys.SigningKey) || "";
         this.inngestApi = new api_1.InngestApi({
-            baseUrl: (0, env_1.processEnv)(consts_1.envKeys.InngestApiBaseUrl) || "https://api.inngest.com",
-            signingKey: signingKey,
+            baseUrl: this.baseUrl || consts_1.defaultInngestBaseUrl,
+            signingKey: (0, env_1.processEnv)(consts_1.envKeys.InngestSigningKey) || "",
             fetch: this.fetch,
         });
         this.logger = logger;
         this.middleware = this.initializeMiddleware([
-            ...builtInMiddleware,
+            ...exports.builtInMiddleware,
             ...(middleware || []),
         ]);
     }
@@ -135,7 +134,7 @@ class Inngest {
      */
     eventKey) {
         this.eventKey = eventKey;
-        this.inngestApiUrl = new URL(`e/${this.eventKey}`, this.inngestBaseUrl);
+        this.sendEventUrl = new URL(`e/${this.eventKey}`, this.baseUrl || consts_1.defaultInngestEventBaseUrl);
     }
     /**
      * Send one or many events to Inngest. Takes an entire payload (including
@@ -165,13 +164,15 @@ class Inngest {
      * ```
      */
     async send(payload) {
-        var _a, _b;
+        var _a;
         const hooks = await (0, InngestMiddleware_1.getHookStack)(this.middleware, "onSendEvent", undefined, {
             transformInput: (prev, output) => {
                 return Object.assign(Object.assign({}, prev), output);
             },
-            transformOutput: (prev, _output) => {
-                return prev;
+            transformOutput(prev, output) {
+                return {
+                    result: Object.assign(Object.assign({}, prev.result), output === null || output === void 0 ? void 0 : output.result),
+                };
             },
         });
         if (!this.eventKey) {
@@ -201,22 +202,28 @@ class Inngest {
                 // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
                 data: p.data || {} });
         });
+        const applyHookToOutput = async (arg) => {
+            var _a;
+            const hookOutput = await ((_a = hooks.transformOutput) === null || _a === void 0 ? void 0 : _a.call(hooks, arg));
+            return Object.assign(Object.assign({}, arg.result), hookOutput === null || hookOutput === void 0 ? void 0 : hookOutput.result);
+        };
         /**
          * It can be valid for a user to send an empty list of events; if this
          * happens, show a warning that this may not be intended, but don't throw.
          */
         if (!payloads.length) {
-            return console.warn((0, errors_1.prettyError)({
+            console.warn((0, errors_1.prettyError)({
                 type: "warn",
                 whatHappened: "`inngest.send()` called with no events",
                 reassurance: "This is not an error, but you may not have intended to do this.",
                 consequences: "The returned promise will resolve, but no events have been sent to Inngest.",
                 stack: true,
             }));
+            return await applyHookToOutput({ result: { ids: [] } });
         }
         // When sending events, check if the dev server is available.  If so, use the
         // dev server.
-        let url = this.inngestApiUrl.href;
+        let url = this.sendEventUrl.href;
         if (!(0, env_1.skipDevServer)()) {
             const host = (0, env_1.devServerHost)();
             // If the dev server host env var has been set we always want to use
@@ -242,13 +249,25 @@ class Inngest {
         if (body.status / 100 !== 2 || body.error) {
             throw await __classPrivateFieldGet(this, _Inngest_instances, "m", _Inngest_getResponseError).call(this, response, body.error);
         }
-        return void (await ((_b = hooks.transformOutput) === null || _b === void 0 ? void 0 : _b.call(hooks, { payloads: [...payloads] })));
+        return await applyHookToOutput({ result: { ids: body.ids } });
     }
-    createFunction(nameOrOpts, trigger, handler) {
-        const sanitizedOpts = (typeof nameOrOpts === "string" ? { name: nameOrOpts } : nameOrOpts);
+    createFunction(options, trigger, handler) {
+        let sanitizedOpts;
+        if (typeof options === "string") {
+            // v2 -> v3 runtime migraton warning
+            console.warn(`${consts_1.logPrefix} InngestFunction: Creating a function with a string as the first argument has been deprecated in v3; pass an object instead. See https://www.inngest.com/docs/sdk/migration`);
+            sanitizedOpts = { id: options };
+        }
+        else {
+            sanitizedOpts = options;
+        }
         let sanitizedTrigger;
         if (typeof trigger === "string") {
-            sanitizedTrigger = { event: trigger };
+            // v2 -> v3 migration warning
+            console.warn(`${consts_1.logPrefix} InngestFunction: Creating a function with a string as the second argument has been deprecated in v3; pass an object instead. See https://www.inngest.com/docs/sdk/migration`);
+            sanitizedTrigger = {
+                event: trigger,
+            };
         }
         else if (trigger.event) {
             sanitizedTrigger = {
@@ -259,9 +278,11 @@ class Inngest {
         else {
             sanitizedTrigger = trigger;
         }
-        return new InngestFunction_1.InngestFunction(this, sanitizedOpts, sanitizedTrigger, 
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument, @typescript-eslint/no-explicit-any
-        handler);
+        if (Object.prototype.hasOwnProperty.call(sanitizedOpts, "fns")) {
+            // v2 -> v3 migration warning
+            console.warn(`${consts_1.logPrefix} InngestFunction: \`fns\` option has been deprecated in v3; use \`middleware\` instead. See https://www.inngest.com/docs/sdk/migration`);
+        }
+        return new InngestFunction_1.InngestFunction(this, sanitizedOpts, sanitizedTrigger, handler);
     }
 }
 exports.Inngest = Inngest;
@@ -316,7 +337,7 @@ async function _Inngest_getResponseError(response, foundErr = "Unknown error") {
  * If this is moved, please ensure that using this package in another project
  * can correctly access comments on mutated input and output.
  */
-const builtInMiddleware = ((m) => m)([
+exports.builtInMiddleware = ((m) => m)([
     new InngestMiddleware_1.InngestMiddleware({
         name: "Inngest: Logger",
         init({ client }) {

package/components/Inngest.js.map

@@ -1 +1 @@
-{"version":3,"file":"Inngest.js","sourceRoot":"","sources":["../../src/components/Inngest.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Inngest.js","sourceRoot":"","sources":["../../src/components/Inngest.ts"],"names":[],"mappings":"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"}

package/components/InngestCommHandler.d.ts

@@ -1,61 +1,90 @@
 import { ServerTiming } from "../helpers/ServerTiming";
+import { type Env } from "../helpers/env";
 import { type MaybePromise } from "../helpers/types";
-import { type FunctionConfig, type LogLevel, type RegisterOptions, type RegisterRequest, type StepRunResponse } from "../types";
-import { type Inngest } from "./Inngest";
-import { type InngestFunction } from "./InngestFunction";
+import { type FunctionConfig, type LogLevel, type RegisterOptions, type RegisterRequest } from "../types";
+import { type AnyInngest } from "./Inngest";
+import { type AnyInngestFunction } from "./InngestFunction";
+import { ExecutionVersion, type ExecutionResult } from "./execution/InngestExecution";
 /**
- * A handler for serving Inngest functions. This type should be used
- * whenever a handler for a new framework is being added to enforce that the
- * registration process is always the same for the user.
- *
- * @example
- * ```
- * // my-custom-handler.ts
- * import { InngestCommHandler, ServeHandler } from "inngest";
- *
- * export const serve: ServeHandler = (nameOrInngest, fns, opts) => {
- *   const handler = new InngestCommHandler(
- *     "my-custom-handler",
- *     nameOrInngest,
- *     fns,
- *     opts,
- *     () => { ... },
- *     () => { ... }
- *   );
- *
- *   return handler.createHandler();
- * };
- * ```
+ * A set of options that can be passed to a serve handler, intended to be used
+ * by internal and custom serve handlers to provide a consistent interface.
  *
  * @public
  */
-export type ServeHandler = (
-/**
- * The name of this app, used to scope and group Inngest functions, or
- * the `Inngest` instance used to declare all functions.
- */
-client: Inngest<any>, 
-/**
- * An array of the functions to serve and register with Inngest.
- */
-functions: InngestFunction<any, any, any, any>[], 
-/**
- * A set of options to further configure the registration of Inngest
- * functions.
- */
-opts?: RegisterOptions
-/**
- * This `any` return is appropriate.
- *
- * While we can infer the signature of the returned value, we cannot guarantee
- * that we have used the same types as the framework we are integrating with,
- * which sometimes can cause frustrating collisions for a user that result in
- * `as unknown as X` casts.
- *
- * Instead, we will use `any` here and have the user be able to place it
- * anywhere they need.
- */
-) => any;
+export interface ServeHandlerOptions extends RegisterOptions {
+    /**
+     * The `Inngest` instance used to declare all functions.
+     */
+    client: AnyInngest;
+    /**
+     * An array of the functions to serve and register with Inngest.
+     */
+    functions: readonly AnyInngestFunction[];
+}
+export interface InternalServeHandlerOptions extends ServeHandlerOptions {
+    /**
+     * Can be used to override the framework name given to a particular serve
+     * handler.
+     */
+    frameworkName?: string;
+}
+interface InngestCommHandlerOptions<Input extends any[] = any[], Output = any, StreamOutput = any> extends RegisterOptions {
+    /**
+     * The name of the framework this handler is designed for. Should be
+     * lowercase, alphanumeric characters inclusive of `-` and `/`.
+     *
+     * This should never be defined by the user; a {@link ServeHandler} should
+     * abstract this.
+     */
+    frameworkName: string;
+    /**
+     * The name of this serve handler, e.g. `"My App"`. It's recommended that this
+     * value represents the overarching app/service that this set of functions is
+     * being served from.
+     *
+     * This can also be an `Inngest` client, in which case the name given when
+     * instantiating the client is used. This is useful if you're sending and
+     * receiving events from the same service, as you can reuse a single
+     * definition of Inngest.
+     */
+    client: AnyInngest;
+    /**
+     * An array of the functions to serve and register with Inngest.
+     */
+    functions: readonly AnyInngestFunction[];
+    /**
+     * The `handler` is the function your framework requires to handle a
+     * request. For example, this is most commonly a function that is given a
+     * `Request` and must return a `Response`.
+     *
+     * The handler must map out any incoming parameters, then return a
+     * strictly-typed object to assess what kind of request is being made,
+     * collecting any relevant data as we go.
+     *
+     * @example
+     * ```
+     * return {
+     *   register: () => { ... },
+     *   run: () => { ... },
+     *   view: () => { ... }
+     * };
+     * ```
+     *
+     * Every key must be specified and must be a function that either returns
+     * a strictly-typed payload or `undefined` if the request is not for that
+     * purpose.
+     *
+     * This gives handlers freedom to choose how their platform of choice will
+     * trigger differing actions, whilst also ensuring all required information
+     * is given for each request type.
+     *
+     * See any existing handler for a full example.
+     *
+     * This should never be defined by the user; a {@link ServeHandler} should
+     * abstract this.
+     */
+    handler: Handler<Input, Output, StreamOutput>;
+}
 /**
  * `InngestCommHandler` is a class for handling incoming requests from Inngest (or
  * Inngest's tooling such as the dev server or CLI) and taking appropriate
@@ -91,30 +120,24 @@ opts?: RegisterOptions
  *
  * @public
  */
-export declare class InngestCommHandler<H extends Handler, TResTransform extends (res: ActionResponse<string>, ...args: Parameters<H>) => any, TStreamTransform extends (res: ActionResponse<ReadableStream>, ...args: Parameters<H>) => any> {
+export declare class InngestCommHandler<Input extends any[] = any[], Output = any, StreamOutput = any> {
     /**
-     * The name of this serve handler, e.g. `"My App"`. It's recommended that this
+     * The ID of this serve handler, e.g. `"my-app"`. It's recommended that this
      * value represents the overarching app/service that this set of functions is
      * being served from.
      */
-    readonly name: string;
+    readonly id: string;
     /**
      * The handler specified during instantiation of the class.
      */
-    readonly handler: H;
-    /**
-     * The response transformer specified during instantiation of the class.
-     */
-    readonly transformRes: TResTransform;
-    readonly streamTransformRes: TStreamTransform | undefined;
+    readonly handler: Handler;
     /**
      * The URL of the Inngest function registration endpoint.
      */
     private readonly inngestRegisterUrl;
     /**
      * The name of the framework this handler is designed for. Should be
-     * lowercase, alphanumeric characters inclusive of `-` and `/`. This should
-     * never be defined by the user; a {@link ServeHandler} should abstract this.
+     * lowercase, alphanumeric characters inclusive of `-` and `/`.
      */
     protected readonly frameworkName: string;
     /**
@@ -188,106 +211,9 @@ export declare class InngestCommHandler<H extends Handler, TResTransform extends
      * to find and register functions when interacting with Inngest Cloud.
      */
     private readonly fns;
+    private env;
     private allowExpiredSignatures;
-    constructor(
-    /**
-     * The name of the framework this handler is designed for. Should be
-     * lowercase, alphanumeric characters inclusive of `-` and `/`.
-     *
-     * This should never be defined by the user; a {@link ServeHandler} should
-     * abstract this.
-     */
-    frameworkName: string, 
-    /**
-     * The name of this serve handler, e.g. `"My App"`. It's recommended that this
-     * value represents the overarching app/service that this set of functions is
-     * being served from.
-     *
-     * This can also be an `Inngest` client, in which case the name given when
-     * instantiating the client is used. This is useful if you're sending and
-     * receiving events from the same service, as you can reuse a single
-     * definition of Inngest.
-     */
-    client: Inngest<any>, 
-    /**
-     * An array of the functions to serve and register with Inngest.
-     */
-    functions: InngestFunction<any, any, any, any>[], options: RegisterOptions | undefined, 
-    /**
-     * The `handler` is the function your framework requires to handle a
-     * request. For example, this is most commonly a function that is given a
-     * `Request` and must return a `Response`.
-     *
-     * The handler must map out any incoming parameters, then return a
-     * strictly-typed object to assess what kind of request is being made,
-     * collecting any relevant data as we go.
-     *
-     * @example
-     * ```
-     * return {
-     *   register: () => { ... },
-     *   run: () => { ... },
-     *   view: () => { ... }
-     * };
-     * ```
-     *
-     * Every key must be specified and must be a function that either returns
-     * a strictly-typed payload or `undefined` if the request is not for that
-     * purpose.
-     *
-     * This gives handlers freedom to choose how their platform of choice will
-     * trigger differing actions, whilst also ensuring all required information
-     * is given for each request type.
-     *
-     * See any existing handler for a full example.
-     *
-     * This should never be defined by the user; a {@link ServeHandler} should
-     * abstract this.
-     */
-    handler: H, 
-    /**
-     * The `transformRes` function receives the output of the Inngest SDK and
-     * can decide how to package up that information to appropriately return the
-     * information to Inngest.
-     *
-     * Mostly, this is taking the given parameters and returning a new
-     * `Response`.
-     *
-     * The function is passed an {@link ActionResponse} (an object containing a
-     * `status` code, a `headers` object, and a stringified `body`), as well as
-     * every parameter passed to the given `handler` function. This ensures you
-     * can appropriately handle the response, including use of any required
-     * parameters such as `res` in Express-/Connect-like frameworks.
-     *
-     * This should never be defined by the user; a {@link ServeHandler} should
-     * abstract this.
-     */
-    transformRes: TResTransform, 
-    /**
-     * The `streamTransformRes` function, if defined, declares that this handler
-     * supports streaming responses back to Inngest. This is useful for
-     * functions that are expected to take a long time, as edge streaming can
-     * often circumvent restrictive request timeouts and other limitations.
-     *
-     * If your handler does not support streaming, do not define this function.
-     *
-     * It receives the output of the Inngest SDK and can decide how to package
-     * up that information to appropriately return the information in a stream
-     * to Inngest.
-     *
-     * Mostly, this is taking the given parameters and returning a new
-     * `Response`.
-     *
-     * The function is passed an {@link ActionResponse} (an object containing a
-     * `status` code, a `headers` object, and `body`, a `ReadableStream`), as
-     * well as every parameter passed to the given `handler` function. This
-     * ensures you can appropriately handle the response, including use of any
-     * required parameters such as `res` in Express-/Connect-like frameworks.
-     *
-     * This should never be defined by the user; a {@link ServeHandler} should
-     * abstract this.
-     */
-    streamTransformRes?: TStreamTransform);
+    constructor(options: InngestCommHandlerOptions<Input, Output, StreamOutput>);
     private get hashedSigningKey();
     /**
      * `createHandler` should be used to return a type-equivalent version of the
@@ -312,7 +238,7 @@ export declare class InngestCommHandler<H extends Handler, TResTransform extends
      * };
      * ```
      */
-    createHandler(): (...args: Parameters<H>) => Promise<Awaited<ReturnType<TResTransform>>>;
+    createHandler(): (...args: Input) => Promise<Awaited<Output>>;
     /**
      * Given a set of functions to check if an action is available from the
      * instance's handler, enact any action that is found.
@@ -325,7 +251,10 @@ export declare class InngestCommHandler<H extends Handler, TResTransform extends
      * found (e.g. env vars, options, etc).
      */
     private handleAction;
-    protected runStep(functionId: string, stepId: string | null, data: unknown, timer: ServerTiming): Promise<StepRunResponse>;
+    protected runStep(functionId: string, stepId: string | null, data: unknown, timer: ServerTiming): {
+        version: ExecutionVersion;
+        result: Promise<ExecutionResult>;
+    };
     protected configs(url: URL): FunctionConfig[];
     /**
      * Return an Inngest serve endpoint URL given a potential `path` and `host`.
@@ -335,7 +264,7 @@ export declare class InngestCommHandler<H extends Handler, TResTransform extends
      */
     protected reqUrl(url: URL): URL;
     protected registerBody(url: URL): RegisterRequest;
-    protected register(url: URL, devServerHost: string | undefined, deployId: string | undefined | null, getHeaders: () => Record<string, string>): Promise<{
+    protected register(url: URL, deployId: string | undefined | null, getHeaders: () => Record<string, string>): Promise<{
         status: number;
         message: string;
         modified: boolean;
@@ -347,7 +276,7 @@ export declare class InngestCommHandler<H extends Handler, TResTransform extends
      * are otherwise difficult to access during initialization.
      */
     private upsertKeysFromEnv;
-    protected validateSignature(sig: string | undefined, body: Record<string, unknown>): void;
+    protected validateSignature(sig: string | undefined, body: unknown): void;
     protected signResponse(): string;
     /**
      * Log to stdout/stderr if the log level is set to include the given level.
@@ -363,16 +292,57 @@ export declare class InngestCommHandler<H extends Handler, TResTransform extends
  * The broad definition of a handler passed when instantiating an
  * {@link InngestCommHandler} instance.
  */
-type Handler = (...args: any[]) => {
-    env?: Record<string, unknown>;
-    isProduction?: boolean;
-    url: URL;
-} & {
-    [K in Extract<HandlerAction, {
-        action: "run" | "register" | "view";
-    }>["action"]]: () => MaybePromise<Omit<Extract<HandlerAction, {
-        action: K;
-    }>, "action"> | undefined>;
+export type Handler<Input extends any[] = any[], Output = any, StreamOutput = any> = (...args: Input) => HandlerResponse<Output, StreamOutput>;
+export type HandlerResponse<Output = any, StreamOutput = any> = {
+    body: () => MaybePromise<any>;
+    env?: () => MaybePromise<Env>;
+    headers: (key: string) => MaybePromise<string | null | undefined>;
+    /**
+     * Whether the current environment is production. This is used to determine
+     * some functionality like whether to connect to the dev server or whether to
+     * show debug logging.
+     *
+     * If this is not provided--or is provided and returns `undefined`--we'll try
+     * to automatically detect whether we're in production by checking various
+     * environment variables.
+     */
+    isProduction?: () => MaybePromise<boolean | undefined>;
+    method: () => MaybePromise<string>;
+    queryString?: (key: string, url: URL) => MaybePromise<string | null | undefined>;
+    url: () => MaybePromise<URL>;
+    /**
+     * The `transformResponse` function receives the output of the Inngest SDK and
+     * can decide how to package up that information to appropriately return the
+     * information to Inngest.
+     *
+     * Mostly, this is taking the given parameters and returning a new `Response`.
+     *
+     * The function is passed an {@link ActionResponse}, an object containing a
+     * `status` code, a `headers` object, and a stringified `body`. This ensures
+     * you can appropriately handle the response, including use of any required
+     * parameters such as `res` in Express-/Connect-like frameworks.
+     */
+    transformResponse: (res: ActionResponse<string>) => Output;
+    /**
+     * The `transformStreamingResponse` function, if defined, declares that this
+     * handler supports streaming responses back to Inngest. This is useful for
+     * functions that are expected to take a long time, as edge streaming can
+     * often circumvent restrictive request timeouts and other limitations.
+     *
+     * If your handler does not support streaming, do not define this function.
+     *
+     * It receives the output of the Inngest SDK and can decide how to package
+     * up that information to appropriately return the information in a stream
+     * to Inngest.
+     *
+     * Mostly, this is taking the given parameters and returning a new `Response`.
+     *
+     * The function is passed an {@link ActionResponse}, an object containing a
+     * `status` code, a `headers` object, and `body`, a `ReadableStream`. This
+     * ensures you can appropriately handle the response, including use of any
+     * required parameters such as `res` in Express-/Connect-like frameworks.
+     */
+    transformStreamingResponse?: (res: ActionResponse<ReadableStream>) => StreamOutput;
 };
 /**
  * The response from the Inngest SDK before it is transformed in to a
@@ -391,28 +361,16 @@ export interface ActionResponse<TBody extends string | ReadableStream = string>
      * A stringified body to return.
      */
     body: TBody;
+    /**
+     * The version of the execution engine that was used to run this action.
+     *
+     * If the action didn't use the execution engine (for example, a GET request
+     * as a health check), this will be `undefined`.
+     *
+     * If the version should be entirely omitted from the response (for example,
+     * when sending preliminary headers when streaming), this will be `null`.
+     */
+    version: ExecutionVersion | null | undefined;
 }
-/**
- * A set of actions the SDK is aware of, including any payloads they require
- * when requesting them.
- */
-type HandlerAction = {
-    action: "error";
-    data: Record<string, string>;
-} | {
-    action: "view";
-    isIntrospection: boolean;
-} | {
-    action: "register";
-    deployId?: null | string;
-} | {
-    action: "run";
-    fnId: string;
-    stepId: string | null;
-    data: Record<string, unknown>;
-    signature: string | undefined;
-} | {
-    action: "bad-method";
-};
 export {};
 //# sourceMappingURL=InngestCommHandler.d.ts.map