inngest 1.7.1 → 1.8.1

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # inngest
 
+## 1.8.1
+
+### Patch Changes
+
+- 5573be3: INN-1270 Create an internal handler to enforce more actionable user-facing errors
+
+## 1.8.0
+
+### Minor Changes
+
+- 65966f5: INN-1087 Add edge streaming support to `"inngest/next"` serve handler
+
+### Patch Changes
+
+- 164fd5c: INN-1266 Fix bad link for fetching Inngest signing key on landing page
+
 ## 1.7.1
 
 ### Patch Changes

package/cloudflare.d.ts

@@ -1,5 +1,6 @@
 import { ServeHandler } from "./components/InngestCommHandler";
-export declare const name = "cloudflare-pages";
+import type { SupportedFrameworkName } from "./types";
+export declare const name: SupportedFrameworkName;
 /**
  * In Cloudflare, serve and register any declared functions with Inngest, making
  * them available to be triggered by events.

package/cloudflare.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../src/cloudflare.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,YAAY,EACb,MAAM,iCAAiC,CAAC;AAGzC,eAAO,MAAM,IAAI,qBAAqB,CAAC;AAEvC;;;;;GAKG;AACH,eAAO,MAAM,KAAK,EAAE,YA6DnB,CAAC"}
+{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../src/cloudflare.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,YAAY,EACb,MAAM,iCAAiC,CAAC;AAEzC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEtD,eAAO,MAAM,IAAI,EAAE,sBAA2C,CAAC;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,KAAK,EAAE,YA6DnB,CAAC"}

package/cloudflare.js.map

@@ -1 +1 @@
-{"version":3,"file":"cloudflare.js","sourceRoot":"","sources":["../src/cloudflare.ts"],"names":[],"mappings":";;;AAAA,wEAGyC;AACzC,6CAAyD;AAE5C,QAAA,IAAI,GAAG,kBAAkB,CAAC;AAEvC;;;;;GAKG;AACI,MAAM,KAAK,GAAiB,CAAC,aAAa,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;IAC9D,MAAM,OAAO,GAAG,IAAI,uCAAkB,CACpC,YAAI,EACJ,aAAa,EACb,GAAG;QAED;;;;WAIG;QACH,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAC1B,IAAI,GAET,CAAC,EACC,OAAO,EAAE,GAAG,EACZ,GAAG,GAIJ,EAAE,EAAE;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAEzE,OAAO;YACL,GAAG;YACH,GAAG;YACH,IAAI,EAAE,GAAG,EAAE;gBACT,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE;oBACxB,OAAO;wBACL,eAAe,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,kBAAS,CAAC,UAAU,CAAC;qBAC5D,CAAC;iBACH;YACH,CAAC;YACD,QAAQ,EAAE,GAAG,EAAE;gBACb,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE;oBACxB,OAAO;wBACL,QAAQ,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,kBAAS,CAAC,QAAQ,CAAC;qBACnD,CAAC;iBACH;YACH,CAAC;YACD,GAAG,EAAE,KAAK,IAAI,EAAE;gBACd,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE;oBACzB,OAAO;wBACL,IAAI,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,kBAAS,CAAC,IAAI,CAAW;wBACpD,MAAM,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,kBAAS,CAAC,MAAM,CAAW;wBACxD,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA4B;wBACnD,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAU,CAAC,SAAS,CAAC,IAAI,SAAS;qBAC9D,CAAC;iBACH;YACH,CAAC;SACF,CAAC;IACJ,CAAC,EACD,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAY,EAAE;QACtC,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE;YACxB,MAAM;YACN,OAAO;SACR,CAAC,CAAC;IACL,CAAC,CACF,CAAC;IAEF,OAAO,OAAO,CAAC,aAAa,EAAE,CAAC;AACjC,CAAC,CAAC;AA7DW,QAAA,KAAK,SA6DhB"}
+{"version":3,"file":"cloudflare.js","sourceRoot":"","sources":["../src/cloudflare.ts"],"names":[],"mappings":";;;AAAA,wEAGyC;AACzC,6CAAyD;AAG5C,QAAA,IAAI,GAA2B,kBAAkB,CAAC;AAE/D;;;;;GAKG;AACI,MAAM,KAAK,GAAiB,CAAC,aAAa,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;IAC9D,MAAM,OAAO,GAAG,IAAI,uCAAkB,CACpC,YAAI,EACJ,aAAa,EACb,GAAG;QAED;;;;WAIG;QACH,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAC1B,IAAI,GAET,CAAC,EACC,OAAO,EAAE,GAAG,EACZ,GAAG,GAIJ,EAAE,EAAE;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAEzE,OAAO;YACL,GAAG;YACH,GAAG;YACH,IAAI,EAAE,GAAG,EAAE;gBACT,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE;oBACxB,OAAO;wBACL,eAAe,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,kBAAS,CAAC,UAAU,CAAC;qBAC5D,CAAC;iBACH;YACH,CAAC;YACD,QAAQ,EAAE,GAAG,EAAE;gBACb,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE;oBACxB,OAAO;wBACL,QAAQ,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,kBAAS,CAAC,QAAQ,CAAC;qBACnD,CAAC;iBACH;YACH,CAAC;YACD,GAAG,EAAE,KAAK,IAAI,EAAE;gBACd,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE;oBACzB,OAAO;wBACL,IAAI,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,kBAAS,CAAC,IAAI,CAAW;wBACpD,MAAM,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,kBAAS,CAAC,MAAM,CAAW;wBACxD,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA4B;wBACnD,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAU,CAAC,SAAS,CAAC,IAAI,SAAS;qBAC9D,CAAC;iBACH;YACH,CAAC;SACF,CAAC;IACJ,CAAC,EACD,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAY,EAAE;QACtC,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE;YACxB,MAAM;YACN,OAAO;SACR,CAAC,CAAC;IACL,CAAC,CACF,CAAC;IAEF,OAAO,OAAO,CAAC,aAAa,EAAE,CAAC;AACjC,CAAC,CAAC;AA7DW,QAAA,KAAK,SA6DhB"}

package/components/Inngest.d.ts

@@ -1,8 +1,6 @@
 import type { PartialK, SendEventPayload, SingleOrArray } from "../helpers/types";
 import type { ClientOptions, EventNameFromTrigger, EventPayload, FailureEventArgs, FunctionOptions, Handler, ShimmedFns, TriggerOptions } from "../types";
 import { InngestFunction } from "./InngestFunction";
-export declare const eventKeyWarning = "Could not find an event key to send events; sending will throw unless an event key is added. Please pass one to the constructor, set the INNGEST_EVENT_KEY environment variable, or use inngest.setEventKey() at runtime.";
-export declare const eventKeyError = "Could not find an event key to send events. Please pass one to the constructor, set the INNGEST_EVENT_KEY environment variable, or use inngest.setEventKey() at runtime.";
 /**
  * A client used to interact with the Inngest API by sending or reacting to
  * events.
@@ -73,11 +71,6 @@ export declare class Inngest<Events extends Record<string, EventPayload> = Recor
      * ```
      */
     constructor({ name, eventKey, inngestBaseUrl, fetch, env, }: ClientOptions);
-    /**
-     * Given a potential fetch function, return the fetch function to use based on
-     * this and the environment.
-     */
-    private static parseFetch;
     /**
      * Set the event key for this instance of Inngest. This is useful if for some
      * reason the key is not available at time of instantiation or present in the

package/components/Inngest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Inngest.d.ts","sourceRoot":"","sources":["../../src/components/Inngest.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,QAAQ,EACR,gBAAgB,EAChB,aAAa,EAEd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,OAAO,EACP,UAAU,EACV,cAAc,EACf,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAOpD,eAAO,MAAM,eAAe,8NACiM,CAAC;AAE9N,eAAO,MAAM,aAAa,6KACkJ,CAAC;AAE7K;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,OAAO,CAClB,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;;IAE1E;;;OAGG;IACH,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAM;IAEtB;;OAEG;IACH,SAAgB,cAAc,EAAE,GAAG,CAAC;IAEpC;;OAEG;IACH,OAAO,CAAC,aAAa,CAAyD;IAE9E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IAEjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B;;;;;;;;;;;;;;;;;;;;;;OAsBG;gBACS,EACV,IAAI,EACJ,QAAQ,EACR,cAAkC,EAClC,KAAK,EACL,GAAG,GACJ,EAAE,aAAa;IAoBhB;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;IAgDzB;;;;OAIG;IACI,WAAW;IAChB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,GACf,IAAI;IAKP;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACU,IAAI,CAAC,KAAK,SAAS,MAAM,MAAM,EAC1C,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,GACxE,OAAO,CAAC,IAAI,CAAC;IAChB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACU,IAAI,CAAC,OAAO,SAAS,gBAAgB,CAAC,MAAM,CAAC,EACxD,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC;IAgFT,cAAc,CACnB,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,QAAQ,SAAS,cAAc,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,EACtD,WAAW,SAAS,MAAM,CACxB,MAAM,EAEN,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CACxB,GAAG,UAAU,CAAC,IAAI,CAAC,EACpB,YAAY,SAAS,MAAM,MAAM,GAAG,MAAM,GAAG,oBAAoB,CAC/D,MAAM,EACN,QAAQ,CACT,EAED,UAAU,EACN,MAAM,GACN,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,KAAK,GAAG,WAAW,CAAC,GAAG;QAClE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WA+BG;QACH,GAAG,CAAC,EAAE,IAAI,CAAC;QAEX;;;;;;;WAOG;QACH,SAAS,CAAC,EAAE,OAAO,CACjB,MAAM,EACN,YAAY,EACZ,WAAW,EACX,gBAAgB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CACvC,CAAC;KACH,CAAC,EACN,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,WAAW,CAAC,GAClD,eAAe;CAYnB"}
+{"version":3,"file":"Inngest.d.ts","sourceRoot":"","sources":["../../src/components/Inngest.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,QAAQ,EACR,gBAAgB,EAChB,aAAa,EAEd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,OAAO,EACP,UAAU,EACV,cAAc,EACf,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAOpD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,OAAO,CAClB,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;;IAE1E;;;OAGG;IACH,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAM;IAEtB;;OAEG;IACH,SAAgB,cAAc,EAAE,GAAG,CAAC;IAEpC;;OAEG;IACH,OAAO,CAAC,aAAa,CAAyD;IAE9E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IAEjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B;;;;;;;;;;;;;;;;;;;;;;OAsBG;gBACS,EACV,IAAI,EACJ,QAAQ,EACR,cAAkC,EAClC,KAAK,EACL,GAAG,GACJ,EAAE,aAAa;IAuEhB;;;;OAIG;IACI,WAAW;IAChB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,GACf,IAAI;IAKP;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACU,IAAI,CAAC,KAAK,SAAS,MAAM,MAAM,EAC1C,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,GACxE,OAAO,CAAC,IAAI,CAAC;IAChB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACU,IAAI,CAAC,OAAO,SAAS,gBAAgB,CAAC,MAAM,CAAC,EACxD,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC;IAuGT,cAAc,CACnB,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,QAAQ,SAAS,cAAc,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,EACtD,WAAW,SAAS,MAAM,CACxB,MAAM,EAEN,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CACxB,GAAG,UAAU,CAAC,IAAI,CAAC,EACpB,YAAY,SAAS,MAAM,MAAM,GAAG,MAAM,GAAG,oBAAoB,CAC/D,MAAM,EACN,QAAQ,CACT,EAED,UAAU,EACN,MAAM,GACN,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,KAAK,GAAG,WAAW,CAAC,GAAG;QAClE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WA+BG;QACH,GAAG,CAAC,EAAE,IAAI,CAAC;QAEX;;;;;;;WAOG;QACH,SAAS,CAAC,EAAE,OAAO,CACjB,MAAM,EACN,YAAY,EACZ,WAAW,EACX,gBAAgB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CACvC,CAAC;KACH,CAAC,EACN,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,WAAW,CAAC,GAClD,eAAe;CAYnB"}

package/components/Inngest.js

@@ -6,13 +6,12 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 };
 var _Inngest_instances, _Inngest_getResponseError;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Inngest = exports.eventKeyError = exports.eventKeyWarning = void 0;
+exports.Inngest = void 0;
 const consts_1 = require("../helpers/consts");
 const devserver_1 = require("../helpers/devserver");
 const env_1 = require("../helpers/env");
+const errors_1 = require("../helpers/errors");
 const InngestFunction_1 = require("./InngestFunction");
-exports.eventKeyWarning = "Could not find an event key to send events; sending will throw unless an event key is added. Please pass one to the constructor, set the INNGEST_EVENT_KEY environment variable, or use inngest.setEventKey() at runtime.";
-exports.eventKeyError = "Could not find an event key to send events. Please pass one to the constructor, set the INNGEST_EVENT_KEY environment variable, or use inngest.setEventKey() at runtime.";
 /**
  * A client used to interact with the Inngest API by sending or reacting to
  * events.
@@ -73,32 +72,30 @@ class Inngest {
          */
         this.inngestApiUrl = new URL(`e/${this.eventKey}`, "https://inn.gs/");
         if (!name) {
+            // TODO PrettyError
             throw new Error("A name 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) || "");
         if (!this.eventKey) {
-            console.warn(exports.eventKeyWarning);
+            console.warn((0, errors_1.prettyError)({
+                type: "warn",
+                whatHappened: "Could not find event key",
+                consequences: "Sending events will throw in production unless an event key is added.",
+                toFixNow: [
+                    "Pass a key to the `new Inngest()` constructor using the `eventKey` option",
+                    "Set the `INNGEST_EVENT_KEY` environment variable",
+                    "Use `inngest.setEventKey()` at runtime",
+                ],
+                why: "We couldn't find an event key to use to send events to Inngest.",
+                otherwise: "Create a new production event key at https://app.inngest.com/env/production/manage/keys.",
+            }));
         }
         this.headers = (0, env_1.inngestHeaders)({
             inngestEnv: env,
         });
-        this.fetch = Inngest.parseFetch(fetch);
-    }
-    /**
-     * Given a potential fetch function, return the fetch function to use based on
-     * this and the environment.
-     */
-    static parseFetch(fetchArg) {
-        if (fetchArg) {
-            return fetchArg;
-        }
-        if (typeof fetch !== "undefined") {
-            return fetch;
-        }
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        return require("cross-fetch");
+        this.fetch = (0, env_1.getFetch)(fetch);
     }
     /**
      * Set the event key for this instance of Inngest. This is useful if for some
@@ -117,7 +114,16 @@ class Inngest {
     }
     async send(nameOrPayload, maybePayload) {
         if (!this.eventKey) {
-            throw new Error(exports.eventKeyError);
+            throw new Error((0, errors_1.prettyError)({
+                whatHappened: "Failed to send event",
+                consequences: "Your event or events were not sent to Inngest.",
+                why: "We couldn't find an event key to use to send events to Inngest.",
+                toFixNow: [
+                    `Pass a key to the \`new Inngest()\` constructor using the \`${"eventKey"}\` option`,
+                    "Set the `INNGEST_EVENT_KEY` environment variable",
+                    `Use \`inngest.${"setEventKey"}()\` at runtime`,
+                ],
+            }));
         }
         let payloads;
         if (typeof nameOrPayload === "string") {
@@ -145,7 +151,13 @@ class Inngest {
          * happens, show a warning that this may not be intended, but don't throw.
          */
         if (!payloads.length) {
-            return console.warn("Warning: You have called `inngest.send()` with an empty array; the operation will resolve, but no events have been sent. This may be intentional, in which case you can ignore this warning.");
+            return 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,
+            }));
         }
         // When sending events, check if the dev server is available.  If so, use the
         // dev server.

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,7 +1,7 @@
 import { ServerTiming } from "../helpers/ServerTiming";
 import type { MaybePromise } from "../helpers/types";
 import { FunctionConfig, LogLevel, RegisterOptions, RegisterRequest, StepRunResponse } from "../types";
-import type { Inngest } from "./Inngest";
+import { Inngest } from "./Inngest";
 import type { InngestFunction } from "./InngestFunction";
 /**
  * A handler for serving Inngest functions. This type should be used
@@ -91,7 +91,7 @@ opts?: RegisterOptions
  *
  * @public
  */
-export declare class InngestCommHandler<H extends Handler, TransformedRes> {
+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> {
     /**
      * 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
@@ -105,7 +105,8 @@ export declare class InngestCommHandler<H extends Handler, TransformedRes> {
     /**
      * The response transformer specified during instantiation of the class.
      */
-    readonly transformRes: (res: ActionResponse, ...args: Parameters<H>) => TransformedRes;
+    readonly transformRes: TResTransform;
+    readonly streamTransformRes: TStreamTransform | undefined;
     /**
      * The URL of the Inngest function registration endpoint.
      */
@@ -176,6 +177,7 @@ export declare class InngestCommHandler<H extends Handler, TransformedRes> {
      * The minimum level to log from the Inngest serve handler.
      */
     protected readonly logLevel: LogLevel;
+    protected readonly streaming: RegisterOptions["streaming"];
     /**
      * A private collection of just Inngest functions, as they have been passed
      * when instantiating the class.
@@ -210,7 +212,7 @@ export declare class InngestCommHandler<H extends Handler, TransformedRes> {
     /**
      * An array of the functions to serve and register with Inngest.
      */
-    functions: InngestFunction<any, any, any>[], { inngestRegisterUrl, fetch, landingPage, logLevel, signingKey, serveHost, servePath, }: RegisterOptions | undefined, 
+    functions: InngestFunction<any, any, any>[], { inngestRegisterUrl, fetch, landingPage, logLevel, signingKey, serveHost, servePath, streaming, }: 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
@@ -260,7 +262,32 @@ export declare class InngestCommHandler<H extends Handler, TransformedRes> {
      * This should never be defined by the user; a {@link ServeHandler} should
      * abstract this.
      */
-    transformRes: (actionRes: ActionResponse, ...args: Parameters<H>) => TransformedRes);
+    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);
     private get hashedSigningKey();
     /**
      * `createHandler` should be used to return a type-equivalent version of the
@@ -285,7 +312,7 @@ export declare class InngestCommHandler<H extends Handler, TransformedRes> {
      * };
      * ```
      */
-    createHandler(): (...args: Parameters<H>) => Promise<TransformedRes>;
+    createHandler(): (...args: Parameters<H>) => Promise<Awaited<ReturnType<TResTransform>>>;
     /**
      * Given a set of functions to check if an action is available from the
      * instance's handler, enact any action that is found.
@@ -346,7 +373,7 @@ type Handler = (...args: any[]) => {
  * The response from the Inngest SDK before it is transformed in to a
  * framework-compatible response by an {@link InngestCommHandler} instance.
  */
-export interface ActionResponse {
+export interface ActionResponse<TBody extends string | ReadableStream = string> {
     /**
      * The HTTP status code to return.
      */
@@ -358,7 +385,7 @@ export interface ActionResponse {
     /**
      * A stringified body to return.
      */
-    body: string;
+    body: TBody;
 }
 /**
  * A set of actions the SDK is aware of, including any payloads they require

package/components/InngestCommHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InngestCommHandler.d.ts","sourceRoot":"","sources":["../../src/components/InngestCommHandler.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAOvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EACL,cAAc,EAGd,QAAQ,EACR,eAAe,EACf,eAAe,EACf,eAAe,EAChB,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,MAAM,YAAY,GAAG;AACzB;;;GAGG;AAEH,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;AAEpC;;GAEG;AAEH,SAAS,EAAE,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE;AAE3C;;;GAGG;AACH,IAAI,CAAC,EAAE,eAAe;AACtB;;;;;;;;;;GAUG;KAEA,GAAG,CAAC;AAgBT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,kBAAkB,CAAC,CAAC,SAAS,OAAO,EAAE,cAAc;IAC/D;;;;OAIG;IACH,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,SAAgB,OAAO,EAAE,CAAC,CAAC;IAE3B;;OAEG;IACH,SAAgB,YAAY,EAAE,CAC5B,GAAG,EAAE,cAAc,EACnB,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KACnB,cAAc,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAM;IAEzC;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAEzC;;;;OAIG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAEzC;;;;;OAKG;IACH,SAAS,CAAC,OAAO,UAAS;IAE1B;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,OAAO,GAAG,SAAS,CAAC;IAExD;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAEjD;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAEjD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAEtC;;;OAGG;IAEH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAE1D;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,GAAG,CAGb;IAEP,OAAO,CAAC,sBAAsB,CAAU;;IAGtC;;;;;;OAMG;IACH,aAAa,EAAE,MAAM;IAErB;;;;;;;;;OASG;IAEH,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAEvC;;OAEG;IAEH,SAAS,EAAE,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,EAC3C,EACE,kBAAkB,EAClB,KAAK,EACL,WAAW,EACX,QAAiB,EACjB,UAAU,EACV,SAAS,EACT,SAAS,GACV,6BAAsB;IAEvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,OAAO,EAAE,CAAC;IAEV;;;;;;;;;;;;;;;;OAgBG;IACH,YAAY,EAAE,CACZ,SAAS,EAAE,cAAc,EACzB,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KACnB,cAAc;IA4ErB,OAAO,KAAK,gBAAgB,GAU3B;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACI,aAAa,IAAI,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,cAAc,CAAC;IAmB3E;;;;;;;;;;OAUG;YACW,YAAY;cAgJV,OAAO,CACrB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,eAAe,CAAC;IAmI3B,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,cAAc,EAAE;IAO7C;;;;;OAKG;IACH,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG;IAe/B,SAAS,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,eAAe;cAgBjC,QAAQ,CACtB,GAAG,EAAE,GAAG,EACR,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EACnC,UAAU,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACvC,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAsE/C,OAAO,KAAK,MAAM,GAEjB;IAED,OAAO,CAAC,uBAAuB;IAM/B,SAAS,CAAC,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO;IAIvE,SAAS,CAAC,iBAAiB,CACzB,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAkC/B,SAAS,CAAC,YAAY,IAAI,MAAM;IAIhC;;;;;;;OAOG;IACH,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;CAuBlD;AA0DD;;;GAGG;AAEH,KAAK,OAAO,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,GAAG,EAAE,GAAG,CAAC;CACV,GAAG;KACD,CAAC,IAAI,OAAO,CACX,aAAa,EACb;QAAE,MAAM,EAAE,KAAK,GAAG,UAAU,GAAG,MAAM,CAAA;KAAE,CACxC,CAAC,QAAQ,CAAC,GAAG,MAAM,YAAY,CAC9B,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE;QAAE,MAAM,EAAE,CAAC,CAAA;KAAE,CAAC,EAAE,QAAQ,CAAC,GAAG,SAAS,CAClE;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,KAAK,aAAa,GACd;IACE,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B,GACD;IACE,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,OAAO,CAAC;CAC1B,GACD;IACE,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;CAC1B,GACD;IACE,MAAM,EAAE,KAAK,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B,GACD;IACE,MAAM,EAAE,YAAY,CAAC;CACtB,CAAC"}
+{"version":3,"file":"InngestCommHandler.d.ts","sourceRoot":"","sources":["../../src/components/InngestCommHandler.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAevD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EACL,cAAc,EAGd,QAAQ,EACR,eAAe,EACf,eAAe,EACf,eAAe,EAEhB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,MAAM,YAAY,GAAG;AACzB;;;GAGG;AAEH,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;AAEpC;;GAEG;AAEH,SAAS,EAAE,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE;AAE3C;;;GAGG;AACH,IAAI,CAAC,EAAE,eAAe;AACtB;;;;;;;;;;GAUG;KAEA,GAAG,CAAC;AAgBT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,kBAAkB,CAC7B,CAAC,SAAS,OAAO,EACjB,aAAa,SAAS,CACpB,GAAG,EAAE,cAAc,CAAC,MAAM,CAAC,EAC3B,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAExB,GAAG,EACH,gBAAgB,SAAS,CACvB,GAAG,EAAE,cAAc,CAAC,cAAc,CAAC,EACnC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAExB,GAAG;IAEH;;;;OAIG;IACH,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,SAAgB,OAAO,EAAE,CAAC,CAAC;IAE3B;;OAEG;IACH,SAAgB,YAAY,EAAE,aAAa,CAAC;IAE5C,SAAgB,kBAAkB,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAEjE;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAM;IAEzC;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAEzC;;;;OAIG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAEzC;;;;;OAKG;IACH,SAAS,CAAC,OAAO,UAAS;IAE1B;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,OAAO,GAAG,SAAS,CAAC;IAExD;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAEjD;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAEjD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAEtC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC,WAAW,CAAC,CAAC;IAE3D;;;OAGG;IAEH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAE1D;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,GAAG,CAGb;IAEP,OAAO,CAAC,sBAAsB,CAAU;;IAGtC;;;;;;OAMG;IACH,aAAa,EAAE,MAAM;IAErB;;;;;;;;;OASG;IAEH,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAEvC;;OAEG;IAEH,SAAS,EAAE,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,EAC3C,EACE,kBAAkB,EAClB,KAAK,EACL,WAAW,EACX,QAAiB,EACjB,UAAU,EACV,SAAS,EACT,SAAS,EACT,SAAS,GACV,6BAAsB;IAEvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,OAAO,EAAE,CAAC;IAEV;;;;;;;;;;;;;;;;OAgBG;IACH,YAAY,EAAE,aAAa;IAE3B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,kBAAkB,CAAC,EAAE,gBAAgB;IA+EvC,OAAO,KAAK,gBAAgB,GAU3B;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACI,aAAa,IAAI,CACtB,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KACnB,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC;IAkGhD;;;;;;;;;;OAUG;YACW,YAAY;cA0IV,OAAO,CACrB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,eAAe,CAAC;IAsI3B,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,cAAc,EAAE;IAO7C;;;;;OAKG;IACH,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG;IAe/B,SAAS,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,eAAe;cAgBjC,QAAQ,CACtB,GAAG,EAAE,GAAG,EACR,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EACnC,UAAU,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACvC,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAsE/C,OAAO,KAAK,MAAM,GAEjB;IAED,OAAO,CAAC,uBAAuB;IAM/B,SAAS,CAAC,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO;IAIvE,SAAS,CAAC,iBAAiB,CACzB,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAqC/B,SAAS,CAAC,YAAY,IAAI,MAAM;IAIhC;;;;;;;OAOG;IACH,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;CAuBlD;AA6DD;;;GAGG;AAEH,KAAK,OAAO,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,GAAG,EAAE,GAAG,CAAC;CACV,GAAG;KACD,CAAC,IAAI,OAAO,CACX,aAAa,EACb;QAAE,MAAM,EAAE,KAAK,GAAG,UAAU,GAAG,MAAM,CAAA;KAAE,CACxC,CAAC,QAAQ,CAAC,GAAG,MAAM,YAAY,CAC9B,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE;QAAE,MAAM,EAAE,CAAC,CAAA;KAAE,CAAC,EAAE,QAAQ,CAAC,GAAG,SAAS,CAClE;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,cAAc,CAC7B,KAAK,SAAS,MAAM,GAAG,cAAc,GAAG,MAAM;IAE9C;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhC;;OAEG;IACH,IAAI,EAAE,KAAK,CAAC;CACb;AAED;;;GAGG;AACH,KAAK,aAAa,GACd;IACE,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B,GACD;IACE,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,OAAO,CAAC;CAC1B,GACD;IACE,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;CAC1B,GACD;IACE,MAAM,EAAE,KAAK,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B,GACD;IACE,MAAM,EAAE,YAAY,CAAC;CACtB,CAAC"}

package/components/InngestCommHandler.js

@@ -12,7 +12,9 @@ const consts_1 = require("../helpers/consts");
 const devserver_1 = require("../helpers/devserver");
 const env_1 = require("../helpers/env");
 const errors_1 = require("../helpers/errors");
+const functions_1 = require("../helpers/functions");
 const scalar_1 = require("../helpers/scalar");
+const stream_1 = require("../helpers/stream");
 const strings_1 = require("../helpers/strings");
 const landing_1 = require("../landing");
 const version_1 = require("../version");
@@ -86,7 +88,7 @@ class InngestCommHandler {
      * An array of the functions to serve and register with Inngest.
      */
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    functions, { inngestRegisterUrl, fetch, landingPage, logLevel = "info", signingKey, serveHost, servePath, } = {}, 
+    functions, { inngestRegisterUrl, fetch, landingPage, logLevel = "info", signingKey, serveHost, servePath, streaming, } = {}, 
     /**
      * The `handler` is the function your framework requires to handle a
      * request. For example, this is most commonly a function that is given a
@@ -136,7 +138,32 @@ class InngestCommHandler {
      * This should never be defined by the user; a {@link ServeHandler} should
      * abstract this.
      */
-    transformRes) {
+    transformRes, 
+    /**
+     * 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) {
         var _a;
         /**
          * A property that can be set to indicate whether or not we believe we are in
@@ -157,6 +184,7 @@ class InngestCommHandler {
                 : appNameOrInngest.name;
         this.handler = handler;
         this.transformRes = transformRes;
+        this.streamTransformRes = streamTransformRes;
         /**
          * Provide a hidden option to allow expired signatures to be accepted during
          * testing.
@@ -167,6 +195,7 @@ class InngestCommHandler {
         // Ensure we filter any undefined functions in case of missing imports.
         this.rawFns = functions.filter(Boolean);
         if (this.rawFns.length !== functions.length) {
+            // TODO PrettyError
             console.warn(`Some functions passed to serve() are undefined and misconfigured.  Please check your imports.`);
         }
         this.fns = this.rawFns.reduce((acc, fn) => {
@@ -176,6 +205,7 @@ class InngestCommHandler {
             }, {});
             configs.forEach(({ id }) => {
                 if (acc[id]) {
+                    // TODO PrettyError
                     throw new Error(`Duplicate function ID "${id}"; please change a function's name or provide an explicit ID to avoid conflicts.`);
                 }
             });
@@ -187,13 +217,11 @@ class InngestCommHandler {
         this.serveHost = serveHost;
         this.servePath = servePath;
         this.logLevel = logLevel;
-        this.fetch =
-            fetch ||
-                (typeof appNameOrInngest === "string"
-                    ? undefined
-                    : appNameOrInngest["fetch"]) ||
-                // eslint-disable-next-line @typescript-eslint/no-var-requires
-                require("cross-fetch");
+        this.streaming = streaming !== null && streaming !== void 0 ? streaming : false;
+        this.fetch = (0, env_1.getFetch)(fetch ||
+            (typeof appNameOrInngest === "string"
+                ? undefined
+                : appNameOrInngest["fetch"]));
     }
     // hashedSigningKey creates a sha256 checksum of the signing key with the
     // same signing key prefix.
@@ -238,9 +266,62 @@ class InngestCommHandler {
              * async.
              */
             // eslint-disable-next-line @typescript-eslint/await-thenable
-            const actions = await timer.wrap("handler", () => this.handler(...args));
-            const actionRes = await timer.wrap("action", () => this.handleAction(actions, timer));
-            return timer.wrap("res", () => this.transformRes(actionRes, ...args));
+            const rawActions = await timer.wrap("handler", () => this.handler(...args));
+            /**
+             * For each function within the actions returned, ensure that its value
+             * caches when run. This ensures that the function is only run once, even
+             * if it's called multiple times throughout this handler's invocation.
+             *
+             * Many frameworks have issues with multiple calls to req/res objects;
+             * reading a request's body multiple times is a common example. This makes
+             * sure to handle this without having to pass around references.
+             */
+            const actions = Object.fromEntries(Object.entries(rawActions).map(([key, val]) => [
+                key,
+                typeof val === "function" ? (0, functions_1.cacheFn)(val) : val,
+            ]));
+            const getHeaders = () => (Object.assign(Object.assign({}, (0, env_1.inngestHeaders)({
+                env: actions.env,
+                framework: this.frameworkName,
+            })), { "Server-Timing": timer.getHeader() }));
+            const actionRes = timer.wrap("action", () => this.handleAction(actions, timer));
+            /**
+             * Prepares an action response by merging returned data to provide
+             * trailing information such as `Server-Timing` headers.
+             *
+             * It should always prioritize the headers returned by the action, as
+             * they may contain important information such as `Content-Type`.
+             */
+            const prepareActionRes = (res) => (Object.assign(Object.assign({}, res), { headers: Object.assign(Object.assign({}, getHeaders()), res.headers) }));
+            const wantToStream = this.streaming === "force" ||
+                (this.streaming === "allow" &&
+                    (0, env_1.platformSupportsStreaming)(this.frameworkName, actions.env));
+            if (wantToStream && this.streamTransformRes) {
+                const runRes = await actions.run();
+                if (runRes) {
+                    const { stream, finalize } = await (0, stream_1.createStream)();
+                    /**
+                     * Errors are handled by `handleAction` here to ensure that an
+                     * appropriate response is always given.
+                     */
+                    void actionRes.then((res) => finalize(prepareActionRes(res)));
+                    return timer.wrap("res", () => {
+                        var _a;
+                        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+                        return (_a = this.streamTransformRes) === null || _a === void 0 ? void 0 : _a.call(this, {
+                            status: 201,
+                            headers: getHeaders(),
+                            body: stream,
+                        }, ...args);
+                    });
+                }
+            }
+            return timer.wrap("res", async () => {
+                return actionRes.then((res) => {
+                    // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+                    return this.transformRes(prepareActionRes(res), ...args);
+                });
+            });
         };
     }
     /**
@@ -273,13 +354,17 @@ class InngestCommHandler {
                         status: stepRes.status,
                         body: JSON.stringify(stepRes.error ||
                             (0, errors_1.serializeError)(new Error("Unknown error; function failed but no error was returned"))),
-                        headers: Object.assign(Object.assign({}, getHeaders()), { "Content-Type": "application/json" }),
+                        headers: {
+                            "Content-Type": "application/json",
+                        },
                     };
                 }
                 return {
                     status: stepRes.status,
                     body: JSON.stringify(stepRes.body),
-                    headers: Object.assign(Object.assign({}, getHeaders()), { "Content-Type": "application/json" }),
+                    headers: {
+                        "Content-Type": "application/json",
+                    },
                 };
             }
             const viewRes = await actions.view();
@@ -290,7 +375,7 @@ class InngestCommHandler {
                     return {
                         status: 405,
                         body: "",
-                        headers: getHeaders(),
+                        headers: {},
                     };
                 }
                 if (viewRes.isIntrospection) {
@@ -298,13 +383,17 @@ class InngestCommHandler {
                     return {
                         status: 200,
                         body: JSON.stringify(introspection),
-                        headers: Object.assign(Object.assign({}, getHeaders()), { "Content-Type": "application/json" }),
+                        headers: {
+                            "Content-Type": "application/json",
+                        },
                     };
                 }
                 return {
                     status: 200,
                     body: landing_1.landing,
-                    headers: Object.assign(Object.assign({}, getHeaders()), { "Content-Type": "text/html; charset=utf-8" }),
+                    headers: {
+                        "Content-Type": "text/html; charset=utf-8",
+                    },
                 };
             }
             const registerRes = await actions.register();
@@ -314,7 +403,9 @@ class InngestCommHandler {
                 return {
                     status,
                     body: JSON.stringify({ message }),
-                    headers: Object.assign(Object.assign({}, getHeaders()), { "Content-Type": "application/json" }),
+                    headers: {
+                        "Content-Type": "application/json",
+                    },
                 };
             }
         }
@@ -322,13 +413,15 @@ class InngestCommHandler {
             return {
                 status: 500,
                 body: JSON.stringify(Object.assign({ type: "internal" }, (0, errors_1.serializeError)(err))),
-                headers: Object.assign(Object.assign({}, getHeaders()), { "Content-Type": "application/json" }),
+                headers: {
+                    "Content-Type": "application/json",
+                },
             };
         }
         return {
             status: 405,
             body: "",
-            headers: getHeaders(),
+            headers: {},
         };
     }
     async runStep(functionId, stepId, data, timer) {
@@ -336,8 +429,10 @@ class InngestCommHandler {
         try {
             const fn = this.fns[functionId];
             if (!fn) {
+                // TODO PrettyError
                 throw new Error(`Could not find function with ID "${functionId}"`);
             }
+            // TODO PrettyError on parse failure; serve handler may be set up badly
             const { event, steps, ctx } = zod_1.z
                 .object({
                 event: zod_1.z.object({}).passthrough(),
@@ -385,6 +480,7 @@ class InngestCommHandler {
                 // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
                 const step = steps === null || steps === void 0 ? void 0 : steps[opId];
                 if (typeof step === "undefined") {
+                    // TODO PrettyError
                     throw new Error(`Could not find step with ID "${opId}"`);
                 }
                 // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
@@ -546,16 +642,19 @@ class InngestCommHandler {
         if (!this.isProd) {
             // In dev, warning users about signing keys ensures that it's considered
             if (!this.signingKey) {
+                // TODO PrettyError
                 console.warn("No signing key provided to validate signature. Find your dev keys at https://app.inngest.com/test/secrets");
             }
             return;
         }
         // If we're here, we're in production; lack of a signing key is an error.
         if (!this.signingKey) {
+            // TODO PrettyError
             throw new Error(`No signing key found in client options or ${consts_1.envKeys.SigningKey} env var. Find your keys at https://app.inngest.com/secrets`);
         }
         // If we're here, we're in production; lack of a req signature is an error.
         if (!sig) {
+            // TODO PrettyError
             throw new Error(`No ${consts_1.headerKeys.Signature} provided`);
         }
         // Validate the signature
@@ -603,6 +702,7 @@ class RequestSignature {
         this.timestamp = params.get("t") || "";
         this.signature = params.get("s") || "";
         if (!this.timestamp || !this.signature) {
+            // TODO PrettyError
             throw new Error(`Invalid ${consts_1.headerKeys.Signature} provided`);
         }
     }
@@ -615,6 +715,7 @@ class RequestSignature {
     }
     verifySignature({ body, signingKey, allowExpiredSignatures, }) {
         if (this.hasExpired(allowExpiredSignatures)) {
+            // TODO PrettyError
             throw new Error("Signature has expired");
         }
         // Calculate the HMAC of the request body ourselves.
@@ -630,6 +731,7 @@ class RequestSignature {
             .update(this.timestamp)
             .digest("hex");
         if (mac !== this.signature) {
+            // TODO PrettyError
             throw new Error("Invalid signature");
         }
     }