inngest 4.3.0 → 4.4.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # inngest
 
+## 4.4.0
+
+### Minor Changes
+
+- [#1508](https://github.com/inngest/inngest-js/pull/1508) [`4771b424`](https://github.com/inngest/inngest-js/commit/4771b42402f9e2f435417b65f4e5a38e54e398af) Thanks [@amh4r](https://github.com/amh4r)! - Add experimental support for deferred functions
+
+### Patch Changes
+
+- [#1512](https://github.com/inngest/inngest-js/pull/1512) [`be675a3d`](https://github.com/inngest/inngest-js/commit/be675a3d3c2a39b415ded8db5e2626e22b941760) Thanks [@amh4r](https://github.com/amh4r)! - Fix waitForSignal not in middleware StepType union
+
+- [#1513](https://github.com/inngest/inngest-js/pull/1513) [`cbad05c3`](https://github.com/inngest/inngest-js/commit/cbad05c3052de84defe36797c23eb0da295022fb) Thanks [@jakobevangelista](https://github.com/jakobevangelista)! - Standardize variant naming to `variant` instead of `variant_selected`
+
+- [#1516](https://github.com/inngest/inngest-js/pull/1516) [`1bca44a8`](https://github.com/inngest/inngest-js/commit/1bca44a8293d6d44e93266fbe3e8dd4dc7e0fa73) Thanks [@BrunoScheufler](https://github.com/BrunoScheufler)! - - Add Request ID & Job ID to context and logs
+
 ## 4.3.0
 
 ### Minor Changes

package/api/schema.d.cts

@@ -6,11 +6,11 @@ declare const errorSchema: z.ZodObject<{
   error: z.ZodString;
   status: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
-  error: string;
   status: number;
-}, {
   error: string;
+}, {
   status: number;
+  error: string;
 }>;
 type ErrorResponse = z.infer<typeof errorSchema>;
 declare const stepSchema: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodUnion<[z.ZodUnion<[z.ZodObject<{

package/api/schema.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.cts","names":[],"sources":["../../src/api/schema.ts"],"sourcesContent":[],"mappings":";;;;cAGa,aAAW,CAAA,CAAA;;EAAX,MAAA,aAGX;CAAA,EAAA,OAAA,cAAA,EAAA;;;;OAHsB,EAAA,MAAA;EAAA,MAAA,EAAA,MAAA;AAIxB,CAAA,CAAA;AAAyB,KAAb,aAAA,GAAgB,CAAA,CAAE,KAAL,CAAA,OAAkB,WAAlB,CAAA;AAAkB,cAE9B,UAF8B,EAEpB,CAAA,CAAA,UAFoB,CAEpB,CAAA,CAAA,SAFoB,CAEpB,CAAA,CAAA,SAFoB,EAEpB,CAAA,CAAA,QAFoB,CAAA,CAEpB,CAAA,CAAA,QAFoB,CAAA,CAEpB,CAAA,CAAA,QAFoB,CAAA,CAEpB,CAAA,CAAA,SAFoB,CAAA;MAAf,cAAE,cAAA,aAAA,CAAA,MAAA,CAAA,CAAA,CAAA;EAAK,IAAA,cAAA,SAAA,EAAA,GAAA,EAAA,GAAA,CAAA;AAEnC,CAAA,EAAA,QAAa,cAuCC,EAAA;EAAA,IAAA,EAAA,MAAA;MAvCS,CAAA,EAAA,GAAA;;;;;;;WAAA,cAAA,EAAA;;;;;;;;;;;;;;;;;;MAAA;;;IAAA,KAAA,CAAA,EAAA,OAAA;;MAAA,CAAA,EAAA,OAAA,GAAA,SAAA;CAAA,CAAA,CAAA,CAAA,aAAA,CAAA;EAyCX,IAAA,cAAa,cAAA,aAAA,CAAA,OAAA,CAAA,CAAA,CAAA;EAAA,KAAA,cAAA,SAAA,EAAA,GAAA,EAAA,GAAA,CAAA;WAAkB,cAAA,EAAA;MAAf,EAAE,OAAA;EAAK,KAAA,CAAA,EAAA,GAAA;AAEnC,CAAA,EAAA;EAEC,IAAA,CAAA,EAAA,OAAA,GAAA,SAAA;OAFuB,CAAA,EAAA,GAAA;kBAAA,SAAA,EAAA;MAAA,EAAA,MAAA;MAAA,EAAA,GAAA;OAAA,CAAA,CAAA,CAAA,CAAA;AAAA,KAFZ,aAAA,GAAgB,CAAA,CAAE,KAEN,CAAA,OAFmB,UAEnB,CAAA;AAAA,cAAX,WAAW,EAAA,CAAA,CAAA,QAAA,CAAA,CAAA,CAAA,UAAA,CAAA,CAAA,CAAA,SAAA,CAAA,CAAA,CAAA,SAAA,EAAA,CAAA,CAAA,MAAA,CAAA,EAAA,YAAA,CAAA,GAAA,CAAA,EAAA,MAAA,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,EAAA,MAAA,CAAA;AAAA,KAGZ,aAAA,GAAgB,CAAA,CAAE,KAHN,CAAA,OAGmB,WAHnB,CAAA"}
+{"version":3,"file":"schema.d.cts","names":[],"sources":["../../src/api/schema.ts"],"sourcesContent":[],"mappings":";;;;cAGa,aAAW,CAAA,CAAA;;EAAX,MAAA,aAGX;CAAA,EAAA,OAAA,cAAA,EAAA;;;;QAHsB,EAAA,MAAA;EAAA,KAAA,EAAA,MAAA;AAIxB,CAAA,CAAA;AAAyB,KAAb,aAAA,GAAgB,CAAA,CAAE,KAAL,CAAA,OAAkB,WAAlB,CAAA;AAAkB,cAE9B,UAF8B,EAEpB,CAAA,CAAA,UAFoB,CAEpB,CAAA,CAAA,SAFoB,CAEpB,CAAA,CAAA,SAFoB,EAEpB,CAAA,CAAA,QAFoB,CAAA,CAEpB,CAAA,CAAA,QAFoB,CAAA,CAEpB,CAAA,CAAA,QAFoB,CAAA,CAEpB,CAAA,CAAA,SAFoB,CAAA;MAAf,cAAE,cAAA,aAAA,CAAA,MAAA,CAAA,CAAA,CAAA;EAAK,IAAA,cAAA,SAAA,EAAA,GAAA,EAAA,GAAA,CAAA;AAEnC,CAAA,EAAA,QAAa,cAuCC,EAAA;EAAA,IAAA,EAAA,MAAA;MAvCS,CAAA,EAAA,GAAA;;;;;;;WAAA,cAAA,EAAA;;;;;;;;;;;;;;;;;;MAAA;;;IAAA,KAAA,CAAA,EAAA,OAAA;;MAAA,CAAA,EAAA,OAAA,GAAA,SAAA;CAAA,CAAA,CAAA,CAAA,aAAA,CAAA;EAyCX,IAAA,cAAa,cAAA,aAAA,CAAA,OAAA,CAAA,CAAA,CAAA;EAAA,KAAA,cAAA,SAAA,EAAA,GAAA,EAAA,GAAA,CAAA;WAAkB,cAAA,EAAA;MAAf,EAAE,OAAA;EAAK,KAAA,CAAA,EAAA,GAAA;AAEnC,CAAA,EAAA;EAEC,IAAA,CAAA,EAAA,OAAA,GAAA,SAAA;OAFuB,CAAA,EAAA,GAAA;kBAAA,SAAA,EAAA;MAAA,EAAA,MAAA;MAAA,EAAA,GAAA;OAAA,CAAA,CAAA,CAAA,CAAA;AAAA,KAFZ,aAAA,GAAgB,CAAA,CAAE,KAEN,CAAA,OAFmB,UAEnB,CAAA;AAAA,cAAX,WAAW,EAAA,CAAA,CAAA,QAAA,CAAA,CAAA,CAAA,UAAA,CAAA,CAAA,CAAA,SAAA,CAAA,CAAA,CAAA,SAAA,EAAA,CAAA,CAAA,MAAA,CAAA,EAAA,YAAA,CAAA,GAAA,CAAA,EAAA,MAAA,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,EAAA,MAAA,CAAA;AAAA,KAGZ,aAAA,GAAgB,CAAA,CAAE,KAHN,CAAA,OAGmB,WAHnB,CAAA"}

package/api/schema.d.ts

@@ -6,11 +6,11 @@ declare const errorSchema: z.ZodObject<{
   error: z.ZodString;
   status: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
-  error: string;
   status: number;
-}, {
   error: string;
+}, {
   status: number;
+  error: string;
 }>;
 type ErrorResponse = z.infer<typeof errorSchema>;
 declare const stepSchema: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodUnion<[z.ZodUnion<[z.ZodObject<{

package/api/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","names":[],"sources":["../../src/api/schema.ts"],"sourcesContent":[],"mappings":";;;;cAGa,aAAW,CAAA,CAAA;;EAAX,MAAA,aAGX;CAAA,EAAA,OAAA,cAAA,EAAA;;;;OAHsB,EAAA,MAAA;EAAA,MAAA,EAAA,MAAA;AAIxB,CAAA,CAAA;AAAyB,KAAb,aAAA,GAAgB,CAAA,CAAE,KAAL,CAAA,OAAkB,WAAlB,CAAA;AAAkB,cAE9B,UAF8B,EAEpB,CAAA,CAAA,UAFoB,CAEpB,CAAA,CAAA,SAFoB,CAEpB,CAAA,CAAA,SAFoB,EAEpB,CAAA,CAAA,QAFoB,CAAA,CAEpB,CAAA,CAAA,QAFoB,CAAA,CAEpB,CAAA,CAAA,QAFoB,CAAA,CAEpB,CAAA,CAAA,SAFoB,CAAA;MAAf,cAAE,cAAA,aAAA,CAAA,MAAA,CAAA,CAAA,CAAA;EAAK,IAAA,cAAA,SAAA,EAAA,GAAA,EAAA,GAAA,CAAA;AAEnC,CAAA,EAAA,QAAa,cAuCC,EAAA;EAAA,IAAA,EAAA,MAAA;MAvCS,CAAA,EAAA,GAAA;;;;;;;WAAA,cAAA,EAAA;;;;;;;;;;;;;;;;;;MAAA;;;IAAA,KAAA,CAAA,EAAA,OAAA;;MAAA,CAAA,EAAA,OAAA,GAAA,SAAA;CAAA,CAAA,CAAA,CAAA,aAAA,CAAA;EAyCX,IAAA,cAAa,cAAA,aAAA,CAAA,OAAA,CAAA,CAAA,CAAA;EAAA,KAAA,cAAA,SAAA,EAAA,GAAA,EAAA,GAAA,CAAA;WAAkB,cAAA,EAAA;MAAf,EAAE,OAAA;EAAK,KAAA,CAAA,EAAA,GAAA;AAEnC,CAAA,EAAA;EAEC,IAAA,CAAA,EAAA,OAAA,GAAA,SAAA;OAFuB,CAAA,EAAA,GAAA;kBAAA,SAAA,EAAA;MAAA,EAAA,MAAA;MAAA,EAAA,GAAA;OAAA,CAAA,CAAA,CAAA,CAAA;AAAA,KAFZ,aAAA,GAAgB,CAAA,CAAE,KAEN,CAAA,OAFmB,UAEnB,CAAA;AAAA,cAAX,WAAW,EAAA,CAAA,CAAA,QAAA,CAAA,CAAA,CAAA,UAAA,CAAA,CAAA,CAAA,SAAA,CAAA,CAAA,CAAA,SAAA,EAAA,CAAA,CAAA,MAAA,CAAA,EAAA,YAAA,CAAA,GAAA,CAAA,EAAA,MAAA,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,EAAA,MAAA,CAAA;AAAA,KAGZ,aAAA,GAAgB,CAAA,CAAE,KAHN,CAAA,OAGmB,WAHnB,CAAA"}
+{"version":3,"file":"schema.d.ts","names":[],"sources":["../../src/api/schema.ts"],"sourcesContent":[],"mappings":";;;;cAGa,aAAW,CAAA,CAAA;;EAAX,MAAA,aAGX;CAAA,EAAA,OAAA,cAAA,EAAA;;;;QAHsB,EAAA,MAAA;EAAA,KAAA,EAAA,MAAA;AAIxB,CAAA,CAAA;AAAyB,KAAb,aAAA,GAAgB,CAAA,CAAE,KAAL,CAAA,OAAkB,WAAlB,CAAA;AAAkB,cAE9B,UAF8B,EAEpB,CAAA,CAAA,UAFoB,CAEpB,CAAA,CAAA,SAFoB,CAEpB,CAAA,CAAA,SAFoB,EAEpB,CAAA,CAAA,QAFoB,CAAA,CAEpB,CAAA,CAAA,QAFoB,CAAA,CAEpB,CAAA,CAAA,QAFoB,CAAA,CAEpB,CAAA,CAAA,SAFoB,CAAA;MAAf,cAAE,cAAA,aAAA,CAAA,MAAA,CAAA,CAAA,CAAA;EAAK,IAAA,cAAA,SAAA,EAAA,GAAA,EAAA,GAAA,CAAA;AAEnC,CAAA,EAAA,QAAa,cAuCC,EAAA;EAAA,IAAA,EAAA,MAAA;MAvCS,CAAA,EAAA,GAAA;;;;;;;WAAA,cAAA,EAAA;;;;;;;;;;;;;;;;;;MAAA;;;IAAA,KAAA,CAAA,EAAA,OAAA;;MAAA,CAAA,EAAA,OAAA,GAAA,SAAA;CAAA,CAAA,CAAA,CAAA,aAAA,CAAA;EAyCX,IAAA,cAAa,cAAA,aAAA,CAAA,OAAA,CAAA,CAAA,CAAA;EAAA,KAAA,cAAA,SAAA,EAAA,GAAA,EAAA,GAAA,CAAA;WAAkB,cAAA,EAAA;MAAf,EAAE,OAAA;EAAK,KAAA,CAAA,EAAA,GAAA;AAEnC,CAAA,EAAA;EAEC,IAAA,CAAA,EAAA,OAAA,GAAA,SAAA;OAFuB,CAAA,EAAA,GAAA;kBAAA,SAAA,EAAA;MAAA,EAAA,MAAA;MAAA,EAAA,GAAA;OAAA,CAAA,CAAA,CAAA,CAAA;AAAA,KAFZ,aAAA,GAAgB,CAAA,CAAE,KAEN,CAAA,OAFmB,UAEnB,CAAA;AAAA,cAAX,WAAW,EAAA,CAAA,CAAA,QAAA,CAAA,CAAA,CAAA,UAAA,CAAA,CAAA,CAAA,SAAA,CAAA,CAAA,CAAA,SAAA,EAAA,CAAA,CAAA,MAAA,CAAA,EAAA,YAAA,CAAA,GAAA,CAAA,EAAA,MAAA,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,EAAA,MAAA,CAAA;AAAA,KAGZ,aAAA,GAAgB,CAAA,CAAE,KAHN,CAAA,OAGmB,WAHnB,CAAA"}

package/components/DeferredFunction.cjs

@@ -0,0 +1,66 @@
+const require_consts = require('../helpers/consts.cjs');
+const require_marker = require('../helpers/marker.cjs');
+const require_InngestFunction = require('./InngestFunction.cjs');
+
+//#region src/components/DeferredFunction.ts
+const idDenyRegex = /['\\\n\r]/;
+/**
+* EXPERIMENTAL: This API is not yet stable and may change in the future without
+* a major version bump.
+*
+* A defer (companion) function created via `createDefer(...)`. Real
+* `InngestFunction` at runtime, but with the trigger pinned to
+* `inngest/deferred.schedule` (see `getConfigTriggers`), `triggers` and
+* `onFailure` disallowed, and the schema carried as a typed instance
+* property so callers of `defer(id, { function, data })` can extract it.
+*
+* Identify a defer function at runtime via `isDeferredFunction(value)` from
+* `helpers/marker.ts`. Prefer that over `instanceof`, which fails across
+* duplicate SDK copies in the same process.
+*
+* @public
+*/
+var DeferredFunction = class extends require_InngestFunction.InngestFunction {
+	schema;
+	[require_marker.markerKey] = { kind: "deferredFunction" };
+	constructor(client, opts, handler, schema) {
+		if (idDenyRegex.test(opts.id)) throw new Error(`invalid id "${opts.id}"; must match ${idDenyRegex.source}`);
+		super(client, {
+			...opts,
+			triggers: []
+		}, handler);
+		this.schema = schema;
+	}
+	getConfigTriggers(fnId) {
+		return [{
+			event: require_consts.internalEvents.DeferredSchedule,
+			expression: `event.data._inngest.fn_slug == '${fnId}'`
+		}];
+	}
+};
+/**
+* EXPERIMENTAL: This API is not yet stable and may change in the future without
+* a major version bump.
+*
+* Create a typed defer function. One `createDefer` call = one Inngest
+* function. Returns a `DeferredFunction<TSchema>` so callers of `defer(id,
+* { function, data })` get the data type inferred from the schema.
+*
+* Mirrors `inngest.createFunction(opts, handler)`, with three differences:
+* the client is the first positional arg, `triggers` is not accepted (the
+* SDK emits an implicit `inngest/deferred.schedule` trigger), and `schema`
+* describes the payload that callers will send via `defer(id, { function,
+* data })`.
+*
+* Pass the result to `serve()` alongside regular functions so the SDK
+* registers it.
+*/
+function createDefer(client, options, handler) {
+	const { schema, ...rest } = options;
+	return new DeferredFunction(client, rest, handler, schema);
+}
+
+//#endregion
+exports.DeferredFunction = DeferredFunction;
+exports.createDefer = createDefer;
+//# sourceMappingURL=DeferredFunction.cjs.map

package/components/DeferredFunction.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeferredFunction.cjs","names":["InngestFunction","markerKey","internalEvents"],"sources":["../../src/components/DeferredFunction.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { internalEvents } from \"../helpers/consts.ts\";\nimport { type Marker, markerKey } from \"../helpers/marker.ts\";\nimport type {\n  ApplyAllMiddlewareCtxExtensions,\n  ApplyAllMiddlewareStepExtensions,\n  BaseContext,\n  FunctionConfig,\n  Handler,\n} from \"../types.ts\";\nimport type {\n  builtInMiddleware,\n  ClientOptionsFromInngest,\n  Inngest,\n} from \"./Inngest.ts\";\nimport { InngestFunction } from \"./InngestFunction.ts\";\nimport type { createStepTools } from \"./InngestStepTools.ts\";\nimport type { Middleware } from \"./middleware/index.ts\";\n\nconst idDenyRegex = /['\\\\\\n\\r]/;\n\n/**\n * EXPERIMENTAL: This API is not yet stable and may change in the future without\n * a major version bump.\n *\n * A defer (companion) function created via `createDefer(...)`. Real\n * `InngestFunction` at runtime, but with the trigger pinned to\n * `inngest/deferred.schedule` (see `getConfigTriggers`), `triggers` and\n * `onFailure` disallowed, and the schema carried as a typed instance\n * property so callers of `defer(id, { function, data })` can extract it.\n *\n * Identify a defer function at runtime via `isDeferredFunction(value)` from\n * `helpers/marker.ts`. Prefer that over `instanceof`, which fails across\n * duplicate SDK copies in the same process.\n *\n * @public\n */\nexport class DeferredFunction<\n  TSchema extends\n    | StandardSchemaV1<Record<string, unknown>>\n    | undefined = undefined,\n> extends InngestFunction<\n  InngestFunction.Options<[], never>,\n  Handler.Any,\n  never,\n  Inngest.Any,\n  []\n> {\n  readonly schema: TSchema;\n  readonly [markerKey]: Marker = { kind: \"deferredFunction\" };\n\n  constructor(\n    client: Inngest.Any,\n    opts: DeferredFunction.Options,\n    handler: Handler.Any,\n    schema: TSchema,\n  ) {\n    // The id is interpolated into a CEL trigger expression\n    // (`event.data._inngest.fn_slug == '${fnId}'`). Reject characters that\n    // would break the single-quoted string literal.\n    if (idDenyRegex.test(opts.id)) {\n      throw new Error(\n        `invalid id \"${opts.id}\"; must match ${idDenyRegex.source}`,\n      );\n    }\n    super(\n      client,\n      { ...opts, triggers: [] } as InngestFunction.Options<[], never>,\n      handler,\n    );\n    this.schema = schema;\n  }\n\n  protected override getConfigTriggers(\n    fnId: string,\n  ): FunctionConfig[\"triggers\"] {\n    return [\n      {\n        event: internalEvents.DeferredSchedule,\n        expression: `event.data._inngest.fn_slug == '${fnId}'`,\n      },\n    ];\n  }\n}\n\n/**\n * @public\n */\nexport namespace DeferredFunction {\n  /**\n   * Matches any `DeferredFunction` regardless of its schema. Use as the\n   * constraint for the `function` argument of `defer()`.\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: widest schema constraint for inference\n  export type Any = DeferredFunction<StandardSchemaV1<any> | undefined>;\n\n  /**\n   * The user-facing options accepted by `createDefer(client, opts, handler)`.\n   * Mirrors `InngestFunction.Options` minus `triggers` (implicit), `onFailure`\n   * (not yet supported), and `batchEvents` (each `defer(...)` is its own run).\n   */\n  export type Options = Omit<\n    InngestFunction.Options<[], never>,\n    \"triggers\" | \"onFailure\" | \"batchEvents\"\n  >;\n}\n\n/**\n * The `event` shape a defer handler receives. With a schema, `data`\n * narrows to its inferred type; without one, it falls back to\n * `Record<string, any>`.\n */\ntype DeferEvent<TSchema> = {\n  name: internalEvents.DeferredSchedule;\n  data: TSchema extends StandardSchemaV1<\n    infer D extends Record<string, unknown>\n  >\n    ? D\n    : // biome-ignore lint/suspicious/noExplicitAny: no schema = any\n      Record<string, any>;\n};\n\n/**\n * Base ctx shape for a defer handler: the standard function context\n * (`runId`, `attempt`, `group`, `step` with middleware step extensions)\n * with `event`/`events` pinned to `inngest/deferred.schedule` and the\n * schema-typed payload.\n */\ntype BaseDeferCtx<\n  TClient extends Inngest.Any,\n  TFnMiddleware extends Middleware.Class[] | undefined,\n  TSchema extends StandardSchemaV1<Record<string, unknown>> | undefined,\n> = Omit<BaseContext<TClient>, \"event\" | \"events\" | \"step\"> & {\n  event: DeferEvent<TSchema>;\n  events: [DeferEvent<TSchema>];\n  step: ReturnType<typeof createStepTools<TClient, TFnMiddleware>> &\n    ApplyAllMiddlewareStepExtensions<\n      ClientOptionsFromInngest<TClient>[\"middleware\"]\n    > &\n    ApplyAllMiddlewareStepExtensions<TFnMiddleware>;\n};\n\n/**\n * Input type for `createDefer`. Same shape as `DeferredFunction.Options`\n * plus `schema` (the StandardSchema describing `event.data` that flows\n * to caller `defer(id, { function, data })` call sites) and `middleware`.\n */\nexport type CreateDeferInput<\n  TFnMiddleware extends Middleware.Class[] | undefined,\n  TSchema extends StandardSchemaV1<Record<string, unknown>> | undefined,\n> = DeferredFunction.Options & {\n  schema?: TSchema;\n  middleware?: TFnMiddleware;\n};\n\n/**\n * EXPERIMENTAL: This API is not yet stable and may change in the future without\n * a major version bump.\n *\n * Create a typed defer function. One `createDefer` call = one Inngest\n * function. Returns a `DeferredFunction<TSchema>` so callers of `defer(id,\n * { function, data })` get the data type inferred from the schema.\n *\n * Mirrors `inngest.createFunction(opts, handler)`, with three differences:\n * the client is the first positional arg, `triggers` is not accepted (the\n * SDK emits an implicit `inngest/deferred.schedule` trigger), and `schema`\n * describes the payload that callers will send via `defer(id, { function,\n * data })`.\n *\n * Pass the result to `serve()` alongside regular functions so the SDK\n * registers it.\n */\nexport function createDefer<\n  TClient extends Inngest.Any,\n  TSchema extends\n    | StandardSchemaV1<Record<string, unknown>>\n    | undefined = undefined,\n  const TFnMiddleware extends Middleware.Class[] | undefined = undefined,\n  THandler extends Handler.Any = (\n    ctx: BaseDeferCtx<TClient, TFnMiddleware, TSchema> &\n      ApplyAllMiddlewareCtxExtensions<\n        [...ReturnType<typeof builtInMiddleware>]\n      > &\n      ApplyAllMiddlewareCtxExtensions<\n        ClientOptionsFromInngest<TClient>[\"middleware\"]\n      > &\n      ApplyAllMiddlewareCtxExtensions<TFnMiddleware>,\n  ) => unknown,\n>(\n  client: TClient,\n  options: CreateDeferInput<TFnMiddleware, TSchema>,\n  handler: THandler,\n): DeferredFunction<TSchema> {\n  const { schema, ...rest } = options;\n  return new DeferredFunction<TSchema>(\n    client,\n    rest,\n    handler as Handler.Any,\n    schema as TSchema,\n  );\n}\n"],"mappings":";;;;;AAmBA,MAAM,cAAc;;;;;;;;;;;;;;;;;AAkBpB,IAAa,mBAAb,cAIUA,wCAMR;CACA,AAAS;CACT,CAAUC,4BAAqB,EAAE,MAAM,oBAAoB;CAE3D,YACE,QACA,MACA,SACA,QACA;AAIA,MAAI,YAAY,KAAK,KAAK,GAAG,CAC3B,OAAM,IAAI,MACR,eAAe,KAAK,GAAG,gBAAgB,YAAY,SACpD;AAEH,QACE,QACA;GAAE,GAAG;GAAM,UAAU,EAAE;GAAE,EACzB,QACD;AACD,OAAK,SAAS;;CAGhB,AAAmB,kBACjB,MAC4B;AAC5B,SAAO,CACL;GACE,OAAOC,8BAAe;GACtB,YAAY,mCAAmC,KAAK;GACrD,CACF;;;;;;;;;;;;;;;;;;;;AA2FL,SAAgB,YAiBd,QACA,SACA,SAC2B;CAC3B,MAAM,EAAE,QAAQ,GAAG,SAAS;AAC5B,QAAO,IAAI,iBACT,QACA,MACA,SACA,OACD"}

package/components/DeferredFunction.d.cts

@@ -0,0 +1,99 @@
+import { internalEvents } from "../helpers/consts.cjs";
+import { Marker, markerKey } from "../helpers/marker.cjs";
+import { Middleware } from "./middleware/middleware.cjs";
+import { createStepTools } from "./InngestStepTools.cjs";
+import { InngestFunction } from "./InngestFunction.cjs";
+import { ApplyAllMiddlewareCtxExtensions, ApplyAllMiddlewareStepExtensions, BaseContext, FunctionConfig, Handler } from "../types.cjs";
+import { ClientOptionsFromInngest, Inngest, builtInMiddleware } from "./Inngest.cjs";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/components/DeferredFunction.d.ts
+
+/**
+ * EXPERIMENTAL: This API is not yet stable and may change in the future without
+ * a major version bump.
+ *
+ * A defer (companion) function created via `createDefer(...)`. Real
+ * `InngestFunction` at runtime, but with the trigger pinned to
+ * `inngest/deferred.schedule` (see `getConfigTriggers`), `triggers` and
+ * `onFailure` disallowed, and the schema carried as a typed instance
+ * property so callers of `defer(id, { function, data })` can extract it.
+ *
+ * Identify a defer function at runtime via `isDeferredFunction(value)` from
+ * `helpers/marker.ts`. Prefer that over `instanceof`, which fails across
+ * duplicate SDK copies in the same process.
+ *
+ * @public
+ */
+declare class DeferredFunction<TSchema extends StandardSchemaV1<Record<string, unknown>> | undefined = undefined> extends InngestFunction<InngestFunction.Options<[], never>, Handler.Any, never, Inngest.Any, []> {
+  readonly schema: TSchema;
+  readonly [markerKey]: Marker;
+  constructor(client: Inngest.Any, opts: DeferredFunction.Options, handler: Handler.Any, schema: TSchema);
+  protected getConfigTriggers(fnId: string): FunctionConfig["triggers"];
+}
+/**
+ * @public
+ */
+declare namespace DeferredFunction {
+  /**
+   * Matches any `DeferredFunction` regardless of its schema. Use as the
+   * constraint for the `function` argument of `defer()`.
+   */
+  type Any = DeferredFunction<StandardSchemaV1<any> | undefined>;
+  /**
+   * The user-facing options accepted by `createDefer(client, opts, handler)`.
+   * Mirrors `InngestFunction.Options` minus `triggers` (implicit), `onFailure`
+   * (not yet supported), and `batchEvents` (each `defer(...)` is its own run).
+   */
+  type Options = Omit<InngestFunction.Options<[], never>, "triggers" | "onFailure" | "batchEvents">;
+}
+/**
+ * The `event` shape a defer handler receives. With a schema, `data`
+ * narrows to its inferred type; without one, it falls back to
+ * `Record<string, any>`.
+ */
+type DeferEvent<TSchema> = {
+  name: internalEvents.DeferredSchedule;
+  data: TSchema extends StandardSchemaV1<infer D extends Record<string, unknown>> ? D : Record<string, any>;
+};
+/**
+ * Base ctx shape for a defer handler: the standard function context
+ * (`runId`, `attempt`, `group`, `step` with middleware step extensions)
+ * with `event`/`events` pinned to `inngest/deferred.schedule` and the
+ * schema-typed payload.
+ */
+type BaseDeferCtx<TClient extends Inngest.Any, TFnMiddleware extends Middleware.Class[] | undefined, TSchema extends StandardSchemaV1<Record<string, unknown>> | undefined> = Omit<BaseContext<TClient>, "event" | "events" | "step"> & {
+  event: DeferEvent<TSchema>;
+  events: [DeferEvent<TSchema>];
+  step: ReturnType<typeof createStepTools<TClient, TFnMiddleware>> & ApplyAllMiddlewareStepExtensions<ClientOptionsFromInngest<TClient>["middleware"]> & ApplyAllMiddlewareStepExtensions<TFnMiddleware>;
+};
+/**
+ * Input type for `createDefer`. Same shape as `DeferredFunction.Options`
+ * plus `schema` (the StandardSchema describing `event.data` that flows
+ * to caller `defer(id, { function, data })` call sites) and `middleware`.
+ */
+type CreateDeferInput<TFnMiddleware extends Middleware.Class[] | undefined, TSchema extends StandardSchemaV1<Record<string, unknown>> | undefined> = DeferredFunction.Options & {
+  schema?: TSchema;
+  middleware?: TFnMiddleware;
+};
+/**
+ * EXPERIMENTAL: This API is not yet stable and may change in the future without
+ * a major version bump.
+ *
+ * Create a typed defer function. One `createDefer` call = one Inngest
+ * function. Returns a `DeferredFunction<TSchema>` so callers of `defer(id,
+ * { function, data })` get the data type inferred from the schema.
+ *
+ * Mirrors `inngest.createFunction(opts, handler)`, with three differences:
+ * the client is the first positional arg, `triggers` is not accepted (the
+ * SDK emits an implicit `inngest/deferred.schedule` trigger), and `schema`
+ * describes the payload that callers will send via `defer(id, { function,
+ * data })`.
+ *
+ * Pass the result to `serve()` alongside regular functions so the SDK
+ * registers it.
+ */
+declare function createDefer<TClient extends Inngest.Any, TSchema extends StandardSchemaV1<Record<string, unknown>> | undefined = undefined, const TFnMiddleware extends Middleware.Class[] | undefined = undefined, THandler extends Handler.Any = (ctx: BaseDeferCtx<TClient, TFnMiddleware, TSchema> & ApplyAllMiddlewareCtxExtensions<[...ReturnType<typeof builtInMiddleware>]> & ApplyAllMiddlewareCtxExtensions<ClientOptionsFromInngest<TClient>["middleware"]> & ApplyAllMiddlewareCtxExtensions<TFnMiddleware>) => unknown>(client: TClient, options: CreateDeferInput<TFnMiddleware, TSchema>, handler: THandler): DeferredFunction<TSchema>;
+//#endregion
+export { DeferredFunction, createDefer };
+//# sourceMappingURL=DeferredFunction.d.cts.map

package/components/DeferredFunction.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeferredFunction.d.cts","names":[],"sources":["../../src/components/DeferredFunction.ts"],"sourcesContent":[],"mappings":"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"}

package/components/DeferredFunction.d.ts

@@ -0,0 +1,99 @@
+import { internalEvents } from "../helpers/consts.js";
+import { Marker, markerKey } from "../helpers/marker.js";
+import { Middleware } from "./middleware/middleware.js";
+import { createStepTools } from "./InngestStepTools.js";
+import { InngestFunction } from "./InngestFunction.js";
+import { ApplyAllMiddlewareCtxExtensions, ApplyAllMiddlewareStepExtensions, BaseContext, FunctionConfig, Handler } from "../types.js";
+import { ClientOptionsFromInngest, Inngest, builtInMiddleware } from "./Inngest.js";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/components/DeferredFunction.d.ts
+
+/**
+ * EXPERIMENTAL: This API is not yet stable and may change in the future without
+ * a major version bump.
+ *
+ * A defer (companion) function created via `createDefer(...)`. Real
+ * `InngestFunction` at runtime, but with the trigger pinned to
+ * `inngest/deferred.schedule` (see `getConfigTriggers`), `triggers` and
+ * `onFailure` disallowed, and the schema carried as a typed instance
+ * property so callers of `defer(id, { function, data })` can extract it.
+ *
+ * Identify a defer function at runtime via `isDeferredFunction(value)` from
+ * `helpers/marker.ts`. Prefer that over `instanceof`, which fails across
+ * duplicate SDK copies in the same process.
+ *
+ * @public
+ */
+declare class DeferredFunction<TSchema extends StandardSchemaV1<Record<string, unknown>> | undefined = undefined> extends InngestFunction<InngestFunction.Options<[], never>, Handler.Any, never, Inngest.Any, []> {
+  readonly schema: TSchema;
+  readonly [markerKey]: Marker;
+  constructor(client: Inngest.Any, opts: DeferredFunction.Options, handler: Handler.Any, schema: TSchema);
+  protected getConfigTriggers(fnId: string): FunctionConfig["triggers"];
+}
+/**
+ * @public
+ */
+declare namespace DeferredFunction {
+  /**
+   * Matches any `DeferredFunction` regardless of its schema. Use as the
+   * constraint for the `function` argument of `defer()`.
+   */
+  type Any = DeferredFunction<StandardSchemaV1<any> | undefined>;
+  /**
+   * The user-facing options accepted by `createDefer(client, opts, handler)`.
+   * Mirrors `InngestFunction.Options` minus `triggers` (implicit), `onFailure`
+   * (not yet supported), and `batchEvents` (each `defer(...)` is its own run).
+   */
+  type Options = Omit<InngestFunction.Options<[], never>, "triggers" | "onFailure" | "batchEvents">;
+}
+/**
+ * The `event` shape a defer handler receives. With a schema, `data`
+ * narrows to its inferred type; without one, it falls back to
+ * `Record<string, any>`.
+ */
+type DeferEvent<TSchema> = {
+  name: internalEvents.DeferredSchedule;
+  data: TSchema extends StandardSchemaV1<infer D extends Record<string, unknown>> ? D : Record<string, any>;
+};
+/**
+ * Base ctx shape for a defer handler: the standard function context
+ * (`runId`, `attempt`, `group`, `step` with middleware step extensions)
+ * with `event`/`events` pinned to `inngest/deferred.schedule` and the
+ * schema-typed payload.
+ */
+type BaseDeferCtx<TClient extends Inngest.Any, TFnMiddleware extends Middleware.Class[] | undefined, TSchema extends StandardSchemaV1<Record<string, unknown>> | undefined> = Omit<BaseContext<TClient>, "event" | "events" | "step"> & {
+  event: DeferEvent<TSchema>;
+  events: [DeferEvent<TSchema>];
+  step: ReturnType<typeof createStepTools<TClient, TFnMiddleware>> & ApplyAllMiddlewareStepExtensions<ClientOptionsFromInngest<TClient>["middleware"]> & ApplyAllMiddlewareStepExtensions<TFnMiddleware>;
+};
+/**
+ * Input type for `createDefer`. Same shape as `DeferredFunction.Options`
+ * plus `schema` (the StandardSchema describing `event.data` that flows
+ * to caller `defer(id, { function, data })` call sites) and `middleware`.
+ */
+type CreateDeferInput<TFnMiddleware extends Middleware.Class[] | undefined, TSchema extends StandardSchemaV1<Record<string, unknown>> | undefined> = DeferredFunction.Options & {
+  schema?: TSchema;
+  middleware?: TFnMiddleware;
+};
+/**
+ * EXPERIMENTAL: This API is not yet stable and may change in the future without
+ * a major version bump.
+ *
+ * Create a typed defer function. One `createDefer` call = one Inngest
+ * function. Returns a `DeferredFunction<TSchema>` so callers of `defer(id,
+ * { function, data })` get the data type inferred from the schema.
+ *
+ * Mirrors `inngest.createFunction(opts, handler)`, with three differences:
+ * the client is the first positional arg, `triggers` is not accepted (the
+ * SDK emits an implicit `inngest/deferred.schedule` trigger), and `schema`
+ * describes the payload that callers will send via `defer(id, { function,
+ * data })`.
+ *
+ * Pass the result to `serve()` alongside regular functions so the SDK
+ * registers it.
+ */
+declare function createDefer<TClient extends Inngest.Any, TSchema extends StandardSchemaV1<Record<string, unknown>> | undefined = undefined, const TFnMiddleware extends Middleware.Class[] | undefined = undefined, THandler extends Handler.Any = (ctx: BaseDeferCtx<TClient, TFnMiddleware, TSchema> & ApplyAllMiddlewareCtxExtensions<[...ReturnType<typeof builtInMiddleware>]> & ApplyAllMiddlewareCtxExtensions<ClientOptionsFromInngest<TClient>["middleware"]> & ApplyAllMiddlewareCtxExtensions<TFnMiddleware>) => unknown>(client: TClient, options: CreateDeferInput<TFnMiddleware, TSchema>, handler: THandler): DeferredFunction<TSchema>;
+//#endregion
+export { DeferredFunction, createDefer };
+//# sourceMappingURL=DeferredFunction.d.ts.map

package/components/DeferredFunction.d.ts.map

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

package/components/DeferredFunction.js

@@ -0,0 +1,65 @@
+import { internalEvents } from "../helpers/consts.js";
+import { markerKey } from "../helpers/marker.js";
+import { InngestFunction } from "./InngestFunction.js";
+
+//#region src/components/DeferredFunction.ts
+const idDenyRegex = /['\\\n\r]/;
+/**
+* EXPERIMENTAL: This API is not yet stable and may change in the future without
+* a major version bump.
+*
+* A defer (companion) function created via `createDefer(...)`. Real
+* `InngestFunction` at runtime, but with the trigger pinned to
+* `inngest/deferred.schedule` (see `getConfigTriggers`), `triggers` and
+* `onFailure` disallowed, and the schema carried as a typed instance
+* property so callers of `defer(id, { function, data })` can extract it.
+*
+* Identify a defer function at runtime via `isDeferredFunction(value)` from
+* `helpers/marker.ts`. Prefer that over `instanceof`, which fails across
+* duplicate SDK copies in the same process.
+*
+* @public
+*/
+var DeferredFunction = class extends InngestFunction {
+	schema;
+	[markerKey] = { kind: "deferredFunction" };
+	constructor(client, opts, handler, schema) {
+		if (idDenyRegex.test(opts.id)) throw new Error(`invalid id "${opts.id}"; must match ${idDenyRegex.source}`);
+		super(client, {
+			...opts,
+			triggers: []
+		}, handler);
+		this.schema = schema;
+	}
+	getConfigTriggers(fnId) {
+		return [{
+			event: internalEvents.DeferredSchedule,
+			expression: `event.data._inngest.fn_slug == '${fnId}'`
+		}];
+	}
+};
+/**
+* EXPERIMENTAL: This API is not yet stable and may change in the future without
+* a major version bump.
+*
+* Create a typed defer function. One `createDefer` call = one Inngest
+* function. Returns a `DeferredFunction<TSchema>` so callers of `defer(id,
+* { function, data })` get the data type inferred from the schema.
+*
+* Mirrors `inngest.createFunction(opts, handler)`, with three differences:
+* the client is the first positional arg, `triggers` is not accepted (the
+* SDK emits an implicit `inngest/deferred.schedule` trigger), and `schema`
+* describes the payload that callers will send via `defer(id, { function,
+* data })`.
+*
+* Pass the result to `serve()` alongside regular functions so the SDK
+* registers it.
+*/
+function createDefer(client, options, handler) {
+	const { schema, ...rest } = options;
+	return new DeferredFunction(client, rest, handler, schema);
+}
+
+//#endregion
+export { DeferredFunction, createDefer };
+//# sourceMappingURL=DeferredFunction.js.map

package/components/DeferredFunction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeferredFunction.js","names":[],"sources":["../../src/components/DeferredFunction.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { internalEvents } from \"../helpers/consts.ts\";\nimport { type Marker, markerKey } from \"../helpers/marker.ts\";\nimport type {\n  ApplyAllMiddlewareCtxExtensions,\n  ApplyAllMiddlewareStepExtensions,\n  BaseContext,\n  FunctionConfig,\n  Handler,\n} from \"../types.ts\";\nimport type {\n  builtInMiddleware,\n  ClientOptionsFromInngest,\n  Inngest,\n} from \"./Inngest.ts\";\nimport { InngestFunction } from \"./InngestFunction.ts\";\nimport type { createStepTools } from \"./InngestStepTools.ts\";\nimport type { Middleware } from \"./middleware/index.ts\";\n\nconst idDenyRegex = /['\\\\\\n\\r]/;\n\n/**\n * EXPERIMENTAL: This API is not yet stable and may change in the future without\n * a major version bump.\n *\n * A defer (companion) function created via `createDefer(...)`. Real\n * `InngestFunction` at runtime, but with the trigger pinned to\n * `inngest/deferred.schedule` (see `getConfigTriggers`), `triggers` and\n * `onFailure` disallowed, and the schema carried as a typed instance\n * property so callers of `defer(id, { function, data })` can extract it.\n *\n * Identify a defer function at runtime via `isDeferredFunction(value)` from\n * `helpers/marker.ts`. Prefer that over `instanceof`, which fails across\n * duplicate SDK copies in the same process.\n *\n * @public\n */\nexport class DeferredFunction<\n  TSchema extends\n    | StandardSchemaV1<Record<string, unknown>>\n    | undefined = undefined,\n> extends InngestFunction<\n  InngestFunction.Options<[], never>,\n  Handler.Any,\n  never,\n  Inngest.Any,\n  []\n> {\n  readonly schema: TSchema;\n  readonly [markerKey]: Marker = { kind: \"deferredFunction\" };\n\n  constructor(\n    client: Inngest.Any,\n    opts: DeferredFunction.Options,\n    handler: Handler.Any,\n    schema: TSchema,\n  ) {\n    // The id is interpolated into a CEL trigger expression\n    // (`event.data._inngest.fn_slug == '${fnId}'`). Reject characters that\n    // would break the single-quoted string literal.\n    if (idDenyRegex.test(opts.id)) {\n      throw new Error(\n        `invalid id \"${opts.id}\"; must match ${idDenyRegex.source}`,\n      );\n    }\n    super(\n      client,\n      { ...opts, triggers: [] } as InngestFunction.Options<[], never>,\n      handler,\n    );\n    this.schema = schema;\n  }\n\n  protected override getConfigTriggers(\n    fnId: string,\n  ): FunctionConfig[\"triggers\"] {\n    return [\n      {\n        event: internalEvents.DeferredSchedule,\n        expression: `event.data._inngest.fn_slug == '${fnId}'`,\n      },\n    ];\n  }\n}\n\n/**\n * @public\n */\nexport namespace DeferredFunction {\n  /**\n   * Matches any `DeferredFunction` regardless of its schema. Use as the\n   * constraint for the `function` argument of `defer()`.\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: widest schema constraint for inference\n  export type Any = DeferredFunction<StandardSchemaV1<any> | undefined>;\n\n  /**\n   * The user-facing options accepted by `createDefer(client, opts, handler)`.\n   * Mirrors `InngestFunction.Options` minus `triggers` (implicit), `onFailure`\n   * (not yet supported), and `batchEvents` (each `defer(...)` is its own run).\n   */\n  export type Options = Omit<\n    InngestFunction.Options<[], never>,\n    \"triggers\" | \"onFailure\" | \"batchEvents\"\n  >;\n}\n\n/**\n * The `event` shape a defer handler receives. With a schema, `data`\n * narrows to its inferred type; without one, it falls back to\n * `Record<string, any>`.\n */\ntype DeferEvent<TSchema> = {\n  name: internalEvents.DeferredSchedule;\n  data: TSchema extends StandardSchemaV1<\n    infer D extends Record<string, unknown>\n  >\n    ? D\n    : // biome-ignore lint/suspicious/noExplicitAny: no schema = any\n      Record<string, any>;\n};\n\n/**\n * Base ctx shape for a defer handler: the standard function context\n * (`runId`, `attempt`, `group`, `step` with middleware step extensions)\n * with `event`/`events` pinned to `inngest/deferred.schedule` and the\n * schema-typed payload.\n */\ntype BaseDeferCtx<\n  TClient extends Inngest.Any,\n  TFnMiddleware extends Middleware.Class[] | undefined,\n  TSchema extends StandardSchemaV1<Record<string, unknown>> | undefined,\n> = Omit<BaseContext<TClient>, \"event\" | \"events\" | \"step\"> & {\n  event: DeferEvent<TSchema>;\n  events: [DeferEvent<TSchema>];\n  step: ReturnType<typeof createStepTools<TClient, TFnMiddleware>> &\n    ApplyAllMiddlewareStepExtensions<\n      ClientOptionsFromInngest<TClient>[\"middleware\"]\n    > &\n    ApplyAllMiddlewareStepExtensions<TFnMiddleware>;\n};\n\n/**\n * Input type for `createDefer`. Same shape as `DeferredFunction.Options`\n * plus `schema` (the StandardSchema describing `event.data` that flows\n * to caller `defer(id, { function, data })` call sites) and `middleware`.\n */\nexport type CreateDeferInput<\n  TFnMiddleware extends Middleware.Class[] | undefined,\n  TSchema extends StandardSchemaV1<Record<string, unknown>> | undefined,\n> = DeferredFunction.Options & {\n  schema?: TSchema;\n  middleware?: TFnMiddleware;\n};\n\n/**\n * EXPERIMENTAL: This API is not yet stable and may change in the future without\n * a major version bump.\n *\n * Create a typed defer function. One `createDefer` call = one Inngest\n * function. Returns a `DeferredFunction<TSchema>` so callers of `defer(id,\n * { function, data })` get the data type inferred from the schema.\n *\n * Mirrors `inngest.createFunction(opts, handler)`, with three differences:\n * the client is the first positional arg, `triggers` is not accepted (the\n * SDK emits an implicit `inngest/deferred.schedule` trigger), and `schema`\n * describes the payload that callers will send via `defer(id, { function,\n * data })`.\n *\n * Pass the result to `serve()` alongside regular functions so the SDK\n * registers it.\n */\nexport function createDefer<\n  TClient extends Inngest.Any,\n  TSchema extends\n    | StandardSchemaV1<Record<string, unknown>>\n    | undefined = undefined,\n  const TFnMiddleware extends Middleware.Class[] | undefined = undefined,\n  THandler extends Handler.Any = (\n    ctx: BaseDeferCtx<TClient, TFnMiddleware, TSchema> &\n      ApplyAllMiddlewareCtxExtensions<\n        [...ReturnType<typeof builtInMiddleware>]\n      > &\n      ApplyAllMiddlewareCtxExtensions<\n        ClientOptionsFromInngest<TClient>[\"middleware\"]\n      > &\n      ApplyAllMiddlewareCtxExtensions<TFnMiddleware>,\n  ) => unknown,\n>(\n  client: TClient,\n  options: CreateDeferInput<TFnMiddleware, TSchema>,\n  handler: THandler,\n): DeferredFunction<TSchema> {\n  const { schema, ...rest } = options;\n  return new DeferredFunction<TSchema>(\n    client,\n    rest,\n    handler as Handler.Any,\n    schema as TSchema,\n  );\n}\n"],"mappings":";;;;;AAmBA,MAAM,cAAc;;;;;;;;;;;;;;;;;AAkBpB,IAAa,mBAAb,cAIU,gBAMR;CACA,AAAS;CACT,CAAU,aAAqB,EAAE,MAAM,oBAAoB;CAE3D,YACE,QACA,MACA,SACA,QACA;AAIA,MAAI,YAAY,KAAK,KAAK,GAAG,CAC3B,OAAM,IAAI,MACR,eAAe,KAAK,GAAG,gBAAgB,YAAY,SACpD;AAEH,QACE,QACA;GAAE,GAAG;GAAM,UAAU,EAAE;GAAE,EACzB,QACD;AACD,OAAK,SAAS;;CAGhB,AAAmB,kBACjB,MAC4B;AAC5B,SAAO,CACL;GACE,OAAO,eAAe;GACtB,YAAY,mCAAmC,KAAK;GACrD,CACF;;;;;;;;;;;;;;;;;;;;AA2FL,SAAgB,YAiBd,QACA,SACA,SAC2B;CAC3B,MAAM,EAAE,QAAQ,GAAG,SAAS;AAC5B,QAAO,IAAI,iBACT,QACA,MACA,SACA,OACD"}

package/components/Inngest.cjs

@@ -576,10 +576,13 @@ function builtInMiddleware(baseLogger) {
 		transformFunctionInput(arg) {
 			let logger = baseLogger;
 			if ("child" in logger) try {
-				logger = logger.child({
+				const childMetadata = {
 					runID: arg.ctx.runId,
 					eventName: arg.ctx.event.name
-				});
+				};
+				if (typeof arg.ctx.requestId !== "undefined") childMetadata.requestId = arg.ctx.requestId;
+				if (typeof arg.ctx.jobId !== "undefined") childMetadata.jobId = arg.ctx.jobId;
+				logger = logger.child(childMetadata);
 			} catch (err) {
 				logger.error({ err }, "failed to create \"childLogger\" with error");
 			}