inngest 4.12.0 → 4.13.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # inngest
 
+## 4.13.0
+
+### Minor Changes
+
+- [#1630](https://github.com/inngest/inngest-js/pull/1630) [`7b5907e4`](https://github.com/inngest/inngest-js/commit/7b5907e44f9662cd64c45ede8802d0d2d42dc8c3) Thanks [@Linell](https://github.com/Linell)! - Added support for aborting deferred runs via defer().abort()
+
+## 4.12.1
+
+### Patch Changes
+
+- [#1622](https://github.com/inngest/inngest-js/pull/1622) [`0706a1f5`](https://github.com/inngest/inngest-js/commit/0706a1f51316e0748b3b24c0e9bca864233e75c0) Thanks [@amh4r](https://github.com/amh4r)! - Fix step.run not JSON-serializing during checkpointing
+
 ## 4.12.0
 
 ### Minor Changes

package/api/schema.d.cts

@@ -27,8 +27,8 @@ declare const stepSchema: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<[z.Zo
   error: z.ZodType<JsonError, z.ZodTypeDef, JsonError>;
 }, "strict", z.ZodTypeAny, {
   error: {
-    name?: string | undefined;
     error?: string | undefined;
+    name?: string | undefined;
     message?: string | undefined;
     stack?: string | undefined;
   } & {
@@ -39,8 +39,8 @@ declare const stepSchema: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<[z.Zo
   type: "error";
 }, {
   error: {
-    name?: string | undefined;
     error?: string | undefined;
+    name?: string | undefined;
     message?: string | undefined;
     stack?: string | undefined;
   } & {

package/api/schema.d.ts

@@ -27,8 +27,8 @@ declare const stepSchema: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<[z.Zo
   error: z.ZodType<JsonError, z.ZodTypeDef, JsonError>;
 }, "strict", z.ZodTypeAny, {
   error: {
-    name?: string | undefined;
     error?: string | undefined;
+    name?: string | undefined;
     message?: string | undefined;
     stack?: string | undefined;
   } & {
@@ -39,8 +39,8 @@ declare const stepSchema: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<[z.Zo
   type: "error";
 }, {
   error: {
-    name?: string | undefined;
     error?: string | undefined;
+    name?: string | undefined;
     message?: string | undefined;
     stack?: string | undefined;
   } & {

package/components/execution/InngestExecution.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"InngestExecution.cjs","names":["ExecutionVersion","options: InngestExecutionOptions","debugPrefix"],"sources":["../../../src/components/execution/InngestExecution.ts"],"sourcesContent":["import Debug, { type Debugger } from \"debug\";\nimport { debugPrefix, ExecutionVersion } from \"../../helpers/consts.ts\";\nimport type { ServerTiming } from \"../../helpers/ServerTiming.ts\";\nimport type { MaybePromise, Simplify } from \"../../helpers/types.ts\";\nimport type {\n  Context,\n  IncomingOp,\n  InternalCheckpointingOptions,\n  OutgoingOp,\n  StepMode,\n} from \"../../types.ts\";\nimport type { Inngest } from \"../Inngest.ts\";\nimport type { ActionResponse } from \"../InngestCommHandler.ts\";\nimport type { InngestFunction } from \"../InngestFunction.ts\";\nimport type {\n  MetadataKind,\n  MetadataOpcode,\n  MetadataScope,\n} from \"../InngestMetadata.ts\";\nimport type { Middleware } from \"../middleware/middleware.ts\";\n\n// Re-export ExecutionVersion so it's correctly recognized as an enum and not\n// just a type. This can be lost when bundling if we don't re-export it here.\n// See `pnpm run test:dist`.\nexport { ExecutionVersion };\n\n/**\n * The possible results of an execution.\n */\nexport interface ExecutionResults {\n  \"function-resolved\": { data: unknown };\n  \"step-ran\": { step: OutgoingOp; retriable?: boolean | string };\n  \"function-rejected\": { error: unknown; retriable: boolean | string };\n  \"steps-found\": { steps: [OutgoingOp, ...OutgoingOp[]] };\n  \"step-not-found\": {\n    step: OutgoingOp;\n    foundSteps: BasicFoundStep[];\n    totalFoundSteps: number;\n  };\n\n  /**\n   * Indicates that we need to relinquish control back to Inngest in order to\n   * change step modes.\n   */\n  \"change-mode\": {\n    to: StepMode;\n    token: string;\n  };\n}\n\nexport type ExecutionResult = {\n  [K in keyof ExecutionResults]: Simplify<\n    {\n      type: K;\n      ctx: Context.Any;\n      ops: Record<string, MemoizedOp>;\n    } & ExecutionResults[K]\n  >;\n}[keyof ExecutionResults];\n\nexport interface BasicFoundStep {\n  id: string;\n  displayName?: string;\n}\n\nexport type ExecutionResultHandler<T = ActionResponse> = (\n  result: ExecutionResult,\n) => MaybePromise<T>;\n\nexport type ExecutionResultHandlers<T = ActionResponse> = {\n  [E in ExecutionResult as E[\"type\"]]: (result: E) => MaybePromise<T>;\n};\n\nexport interface MemoizedOp extends IncomingOp {\n  /**\n   * If the step has been hit during this run, these will be the arguments\n   * passed to it.\n   */\n  rawArgs?: unknown[];\n  fulfilled?: boolean;\n\n  /**\n   * The promise that has been returned to userland code.\n   */\n  promise?: Promise<unknown>;\n  seen?: boolean;\n}\n\n/**\n * The preferred execution version that will be used by the SDK when handling\n * brand new runs where the Executor is allowing us to choose.\n *\n * Changing this should not ever be a breaking change, as this will only change\n * new runs, not existing ones.\n */\nexport const PREFERRED_ASYNC_EXECUTION_VERSION =\n  ExecutionVersion.V2 satisfies ExecutionVersion;\n\n/**\n * Options for creating a new {@link InngestExecution} instance.\n */\nexport interface InngestExecutionOptions {\n  client: Inngest.Any;\n  fn: InngestFunction.Any;\n\n  /**\n   * The UUID that represents this function in Inngest.\n   *\n   * This is used to reference the function during async checkpointing, when we\n   * know the function/run already exists and just wish to reference it\n   * directly.\n   */\n  internalFnId?: string;\n  reqArgs: unknown[];\n  runId: string;\n  data: Omit<Context.Any, \"step\" | \"group\" | \"publish\" | \"defer\">;\n  stepState: Record<string, MemoizedOp>;\n\n  /**\n   * A map of hashed defer step IDs to their backend-side metadata\n   * (e.g. `{ abortable: true }`). Defer ops are not steps in the\n   * memoization sense — they don't produce results — but the backend\n   * tracks which ones it has already received so the SDK can avoid\n   * re-emitting them on replay.\n   */\n  priorDefers?: Record<string, unknown>;\n\n  stepCompletionOrder: string[];\n  stepMode: StepMode;\n  checkpointingConfig?: InternalCheckpointingOptions;\n\n  /**\n   * If this execution is being run from a queue job, this will be an identifier\n   * used to reference this execution in Inngest. SDKs are expected to parrot\n   * this back in some responses to correctly attribute actions to this queue\n   * item.\n   */\n  queueItemId?: string;\n\n  /**\n   * Unique identifier for each execution request\n   */\n  requestId?: string;\n\n  /**\n   * Incrementing ID used to denote the generation in which this job was queued\n   */\n  generationId?: number;\n\n  /**\n   * Time the SDK starts handling an execution request. Format is unix millis.\n   */\n  requestStartedAt?: number;\n\n  /**\n   * Headers to be sent with any request to Inngest during this execution.\n   */\n  headers: Record<string, string>;\n  requestedRunStep?: string;\n  timer?: ServerTiming;\n  /**\n   * Which handler variant is being executed. `\"failure\"` skips\n   * trigger-schema validation and resolves `onFailure` instead of the\n   * main handler. `\"defer\"` marks the fn as a standalone defer function\n   * (created via `createDefer`); incoming event data is validated\n   * against the defer function's schema.\n   *\n   * @default \"main\"\n   */\n  handlerKind?: \"main\" | \"failure\" | \"defer\";\n\n  /**\n   * Whether this execution is part of a Durable Endpoint flow. Could be either\n   * sync mode (request not from Inngest) or async mode (request from Inngest).\n   *\n   * @default false\n   */\n  isDurableEndpoint?: boolean;\n\n  disableImmediateExecution?: boolean;\n\n  /**\n   * Information about the incoming HTTP request that triggered this execution.\n   * Used by middleware `wrapRequest` hooks.\n   */\n  requestInfo?: Middleware.Request;\n\n  /**\n   * Pre-created middleware instances to use for this execution. When provided,\n   * the execution will use these instead of instantiating new ones from the\n   * client. This ensures `wrapRequest` and other hooks share state on `this`.\n   */\n  middlewareInstances?: Middleware.BaseMiddleware[];\n\n  /**\n   * Whether the client accepts SSE (`Accept: text/event-stream`). When true,\n   * the execution engine may deliver the result as an SSE stream even if\n   * `stream.push()` was not called.\n   */\n  acceptsSse?: boolean;\n\n  /**\n   * Provide the ability to transform the context passed to the function before\n   * the execution starts.\n   */\n  transformCtx?: (ctx: Readonly<Context.Any>) => Context.Any;\n\n  /**\n   * A hook that is called to create an {@link ActionResponse} from the returned\n   * value of an execution.\n   *\n   * This is required for checkpointing executions.\n   */\n  createResponse?: (data: unknown) => MaybePromise<ActionResponse>;\n}\n\nexport type InngestExecutionFactory = (\n  options: InngestExecutionOptions,\n) => IInngestExecution;\n\nexport class InngestExecution {\n  protected devDebug: Debugger;\n\n  constructor(protected options: InngestExecutionOptions) {\n    this.devDebug = Debug(`${debugPrefix}:${this.options.runId}`);\n  }\n}\n\nexport interface IInngestExecution {\n  version: ExecutionVersion;\n  start(): Promise<ExecutionResult>;\n\n  addMetadata(\n    stepId: string,\n    kind: MetadataKind,\n    scope: MetadataScope,\n    op: MetadataOpcode,\n    values: Record<string, unknown>,\n  ): boolean;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AA+FA,MAAa,oCACXA,gCAAiB;AA4HnB,IAAa,mBAAb,MAA8B;CAC5B,AAAU;CAEV,YAAY,AAAUC,SAAkC;EAAlC;AACpB,OAAK,8BAAiB,GAAGC,2BAAY,GAAG,KAAK,QAAQ,QAAQ"}
+{"version":3,"file":"InngestExecution.cjs","names":["ExecutionVersion","options: InngestExecutionOptions","debugPrefix"],"sources":["../../../src/components/execution/InngestExecution.ts"],"sourcesContent":["import Debug, { type Debugger } from \"debug\";\nimport { debugPrefix, ExecutionVersion } from \"../../helpers/consts.ts\";\nimport type { ServerTiming } from \"../../helpers/ServerTiming.ts\";\nimport type { MaybePromise, Simplify } from \"../../helpers/types.ts\";\nimport type {\n  Context,\n  IncomingOp,\n  InternalCheckpointingOptions,\n  OutgoingOp,\n  StepMode,\n} from \"../../types.ts\";\nimport type { Inngest } from \"../Inngest.ts\";\nimport type { ActionResponse } from \"../InngestCommHandler.ts\";\nimport type { InngestFunction } from \"../InngestFunction.ts\";\nimport type {\n  MetadataKind,\n  MetadataOpcode,\n  MetadataScope,\n} from \"../InngestMetadata.ts\";\nimport type { Middleware } from \"../middleware/middleware.ts\";\n\n// Re-export ExecutionVersion so it's correctly recognized as an enum and not\n// just a type. This can be lost when bundling if we don't re-export it here.\n// See `pnpm run test:dist`.\nexport { ExecutionVersion };\n\n/**\n * The possible results of an execution.\n */\nexport interface ExecutionResults {\n  \"function-resolved\": { data: unknown };\n  \"step-ran\": { step: OutgoingOp; retriable?: boolean | string };\n  \"function-rejected\": { error: unknown; retriable: boolean | string };\n  \"steps-found\": { steps: [OutgoingOp, ...OutgoingOp[]] };\n  \"step-not-found\": {\n    step: OutgoingOp;\n    foundSteps: BasicFoundStep[];\n    totalFoundSteps: number;\n  };\n\n  /**\n   * Indicates that we need to relinquish control back to Inngest in order to\n   * change step modes.\n   */\n  \"change-mode\": {\n    to: StepMode;\n    token: string;\n  };\n}\n\nexport type ExecutionResult = {\n  [K in keyof ExecutionResults]: Simplify<\n    {\n      type: K;\n      ctx: Context.Any;\n      ops: Record<string, MemoizedOp>;\n    } & ExecutionResults[K]\n  >;\n}[keyof ExecutionResults];\n\nexport interface BasicFoundStep {\n  id: string;\n  displayName?: string;\n}\n\nexport type ExecutionResultHandler<T = ActionResponse> = (\n  result: ExecutionResult,\n) => MaybePromise<T>;\n\nexport type ExecutionResultHandlers<T = ActionResponse> = {\n  [E in ExecutionResult as E[\"type\"]]: (result: E) => MaybePromise<T>;\n};\n\nexport interface MemoizedOp extends IncomingOp {\n  /**\n   * If the step has been hit during this run, these will be the arguments\n   * passed to it.\n   */\n  rawArgs?: unknown[];\n  fulfilled?: boolean;\n\n  /**\n   * The promise that has been returned to userland code.\n   */\n  promise?: Promise<unknown>;\n  seen?: boolean;\n}\n\n/**\n * The preferred execution version that will be used by the SDK when handling\n * brand new runs where the Executor is allowing us to choose.\n *\n * Changing this should not ever be a breaking change, as this will only change\n * new runs, not existing ones.\n */\nexport const PREFERRED_ASYNC_EXECUTION_VERSION =\n  ExecutionVersion.V2 satisfies ExecutionVersion;\n\n/**\n * Options for creating a new {@link InngestExecution} instance.\n */\nexport interface InngestExecutionOptions {\n  client: Inngest.Any;\n  fn: InngestFunction.Any;\n\n  /**\n   * The UUID that represents this function in Inngest.\n   *\n   * This is used to reference the function during async checkpointing, when we\n   * know the function/run already exists and just wish to reference it\n   * directly.\n   */\n  internalFnId?: string;\n  reqArgs: unknown[];\n  runId: string;\n  data: Omit<Context.Any, \"step\" | \"group\" | \"publish\" | \"defer\">;\n  stepState: Record<string, MemoizedOp>;\n\n  /**\n   * A map of hashed defer step IDs to their backend-side metadata\n   * (e.g. `{ abortable: true }`). Defer ops are not steps in the\n   * memoization sense — they don't produce results — but the backend\n   * tracks which ones it has already received so the SDK can avoid\n   * re-emitting them on replay.\n   */\n  priorDefers?: Record<string, { abortable?: boolean }>;\n\n  stepCompletionOrder: string[];\n  stepMode: StepMode;\n  checkpointingConfig?: InternalCheckpointingOptions;\n\n  /**\n   * If this execution is being run from a queue job, this will be an identifier\n   * used to reference this execution in Inngest. SDKs are expected to parrot\n   * this back in some responses to correctly attribute actions to this queue\n   * item.\n   */\n  queueItemId?: string;\n\n  /**\n   * Unique identifier for each execution request\n   */\n  requestId?: string;\n\n  /**\n   * Incrementing ID used to denote the generation in which this job was queued\n   */\n  generationId?: number;\n\n  /**\n   * Time the SDK starts handling an execution request. Format is unix millis.\n   */\n  requestStartedAt?: number;\n\n  /**\n   * Headers to be sent with any request to Inngest during this execution.\n   */\n  headers: Record<string, string>;\n  requestedRunStep?: string;\n  timer?: ServerTiming;\n  /**\n   * Which handler variant is being executed. `\"failure\"` skips\n   * trigger-schema validation and resolves `onFailure` instead of the\n   * main handler. `\"defer\"` marks the fn as a standalone defer function\n   * (created via `createDefer`); incoming event data is validated\n   * against the defer function's schema.\n   *\n   * @default \"main\"\n   */\n  handlerKind?: \"main\" | \"failure\" | \"defer\";\n\n  /**\n   * Whether this execution is part of a Durable Endpoint flow. Could be either\n   * sync mode (request not from Inngest) or async mode (request from Inngest).\n   *\n   * @default false\n   */\n  isDurableEndpoint?: boolean;\n\n  disableImmediateExecution?: boolean;\n\n  /**\n   * Information about the incoming HTTP request that triggered this execution.\n   * Used by middleware `wrapRequest` hooks.\n   */\n  requestInfo?: Middleware.Request;\n\n  /**\n   * Pre-created middleware instances to use for this execution. When provided,\n   * the execution will use these instead of instantiating new ones from the\n   * client. This ensures `wrapRequest` and other hooks share state on `this`.\n   */\n  middlewareInstances?: Middleware.BaseMiddleware[];\n\n  /**\n   * Whether the client accepts SSE (`Accept: text/event-stream`). When true,\n   * the execution engine may deliver the result as an SSE stream even if\n   * `stream.push()` was not called.\n   */\n  acceptsSse?: boolean;\n\n  /**\n   * Provide the ability to transform the context passed to the function before\n   * the execution starts.\n   */\n  transformCtx?: (ctx: Readonly<Context.Any>) => Context.Any;\n\n  /**\n   * A hook that is called to create an {@link ActionResponse} from the returned\n   * value of an execution.\n   *\n   * This is required for checkpointing executions.\n   */\n  createResponse?: (data: unknown) => MaybePromise<ActionResponse>;\n}\n\nexport type InngestExecutionFactory = (\n  options: InngestExecutionOptions,\n) => IInngestExecution;\n\nexport class InngestExecution {\n  protected devDebug: Debugger;\n\n  constructor(protected options: InngestExecutionOptions) {\n    this.devDebug = Debug(`${debugPrefix}:${this.options.runId}`);\n  }\n}\n\nexport interface IInngestExecution {\n  version: ExecutionVersion;\n  start(): Promise<ExecutionResult>;\n\n  addMetadata(\n    stepId: string,\n    kind: MetadataKind,\n    scope: MetadataScope,\n    op: MetadataOpcode,\n    values: Record<string, unknown>,\n  ): boolean;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AA+FA,MAAa,oCACXA,gCAAiB;AA4HnB,IAAa,mBAAb,MAA8B;CAC5B,AAAU;CAEV,YAAY,AAAUC,SAAkC;EAAlC;AACpB,OAAK,8BAAiB,GAAGC,2BAAY,GAAG,KAAK,QAAQ,QAAQ"}

package/components/execution/InngestExecution.d.cts

@@ -102,7 +102,9 @@ interface InngestExecutionOptions {
    * tracks which ones it has already received so the SDK can avoid
    * re-emitting them on replay.
    */
-  priorDefers?: Record<string, unknown>;
+  priorDefers?: Record<string, {
+    abortable?: boolean;
+  }>;
   stepCompletionOrder: string[];
   stepMode: StepMode;
   checkpointingConfig?: InternalCheckpointingOptions;

package/components/execution/InngestExecution.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"InngestExecution.d.cts","names":[],"sources":["../../../src/components/execution/InngestExecution.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;UA6BiB,gBAAA;;;;;UAEK;;;;;;;;IAFL,KAAA,EAAA,CAIU,UAJM,EAAA,GAIS,UAJT,EAAA,CAAA;EAAA,CAAA;kBAEX,EAAA;IAEK,IAAA,EAEjB,UAFiB;IAAe,UAAA,EAG1B,cAH0B,EAAA;IAEhC,eAAA,EAAA,MAAA;;;;AAeV;;eACc,EAAA;IAEF,EAAA,EARJ,QAQI;IACD,KAAA,EAAQ,MAAA;;;AAEX,KANI,eAAA,GAMJ,QAAiB,MALX,gBAKW,GALQ,QAKR,CAAA;EALQ,IAAA,EAErB,CAFqB;EAOzB,GAAA,EAJG,OAAA,CAAQ,GAIX;EAAgB,GAAA,EAHb,MAGa,CAAA,MAAA,EAHE,UAGF,CAAA;AAEP,CAAA,GAJT,gBAIuB,CAJN,CAIM,CAAA,CAAA,EAK/B,CAAA,MAPQ,gBAOI,CAAA;AAAsB,UALjB,cAAA,CAKiB;MAAK,MAAA;aAC7B,CAAA,EAAA,MAAA;;AACL,KAFO,sBAEP,CAAA,IAFkC,cAElC,CAAA,GAAA,CAAA,MAAA,EADK,eACL,EAAA,GAAA,YAAA,CAAa,CAAb,CAAA;AAAY,KAEL,uBAFK,CAAA,IAEuB,cAFvB,CAAA,GAAA,QAGT,eADI,IACe,CADQ,CAAA,MAAA,CAAA,GAAA,CAAA,MAAA,EACa,CADb,EAAA,GACmB,YADnB,CACgC,CADhC,CAAA,EAAA;AAAK,UAIvB,UAAA,SAAmB,UAJI,CAAA;;;;;SACc,CAAA,EAAA,OAAA,EAAA;EAAY,SAAA,CAAA,EAAA,OAAA;EAGjD;;;SAAmB,CAAA,EAWxB,OAXwB,CAAA,OAAA,CAAA;EAAU,IAAA,CAAA,EAAA,OAAA;AAsB9C;AAMA;;;;;;;AAea,cArBA,iCAAA,GAqBA,gBAAA,CAAA,EAAA;;;;AAyCF,UAxDM,uBAAA,CAwDN;QAED,EAzDA,OAAA,CAAQ,GAyDR;MAxDJ,eAAA,CAAgB,GAkFK;;;;;;;;EA+Bf,YAAA,CAAA,EAAA,MAAA;EAAuB,OAAA,EAAA,OAAA,EAAA;OACxB,EAAA,MAAA;MACN,EAvGG,IAuGH,CAvGQ,OAAA,CAAQ,GAuGhB,EAAA,MAAA,GAAA,OAAA,GAAA,SAAA,GAAA,OAAA,CAAA;EAAiB,SAAA,EAtGT,MAsGS,CAAA,MAAA,EAtGM,UAsGN,CAAA;EAET;;;;;;AAQb;EAAkC,WAAA,CAAA,EAvGlB,MAuGkB,CAAA,MAAA,EAAA,OAAA,CAAA;qBACvB,EAAA,MAAA,EAAA;UACQ,EAtGP,QAsGO;qBAAR,CAAA,EArGa,4BAqGb;;;;;;;;;;;;;;;;;;;;;;;WAzEA;;UAED;;;;;;;;;;;;;;;;;;;;;;;gBA0BM,UAAA,CAAW;;;;;;wBAOH,UAAA,CAAW;;;;;;;;;;;uBAaZ,SAAS,OAAA,CAAQ,SAAS,OAAA,CAAQ;;;;;;;sCAQnB,aAAa;;KAGvC,uBAAA,aACD,4BACN;cAEQ,gBAAA;qBAGoB;sBAFX;uBAEW;;UAKhB,iBAAA;WACN;WACA,QAAQ;oCAIT,qBACC,mBACH,wBACI"}
+{"version":3,"file":"InngestExecution.d.cts","names":[],"sources":["../../../src/components/execution/InngestExecution.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;UA6BiB,gBAAA;;;;;UAEK;;;;;;;;IAFL,KAAA,EAAA,CAIU,UAJM,EAAA,GAIS,UAJT,EAAA,CAAA;EAAA,CAAA;kBAEX,EAAA;IAEK,IAAA,EAEjB,UAFiB;IAAe,UAAA,EAG1B,cAH0B,EAAA;IAEhC,eAAA,EAAA,MAAA;;;;AAeV;;eACc,EAAA;IAEF,EAAA,EARJ,QAQI;IACD,KAAA,EAAQ,MAAA;;;AAEX,KANI,eAAA,GAMJ,QAAiB,MALX,gBAKW,GALQ,QAKR,CAAA;EALQ,IAAA,EAErB,CAFqB;EAOzB,GAAA,EAJG,OAAA,CAAQ,GAIX;EAAgB,GAAA,EAHb,MAGa,CAAA,MAAA,EAHE,UAGF,CAAA;AAEP,CAAA,GAJT,gBAIuB,CAJN,CAIM,CAAA,CAAA,EAK/B,CAAA,MAPQ,gBAOI,CAAA;AAAsB,UALjB,cAAA,CAKiB;MAAK,MAAA;aAC7B,CAAA,EAAA,MAAA;;AACL,KAFO,sBAEP,CAAA,IAFkC,cAElC,CAAA,GAAA,CAAA,MAAA,EADK,eACL,EAAA,GAAA,YAAA,CAAa,CAAb,CAAA;AAAY,KAEL,uBAFK,CAAA,IAEuB,cAFvB,CAAA,GAAA,QAGT,eADI,IACe,CADQ,CAAA,MAAA,CAAA,GAAA,CAAA,MAAA,EACa,CADb,EAAA,GACmB,YADnB,CACgC,CADhC,CAAA,EAAA;AAAK,UAIvB,UAAA,SAAmB,UAJI,CAAA;;;;;SACc,CAAA,EAAA,OAAA,EAAA;EAAY,SAAA,CAAA,EAAA,OAAA;EAGjD;;;SAAmB,CAAA,EAWxB,OAXwB,CAAA,OAAA,CAAA;EAAU,IAAA,CAAA,EAAA,OAAA;AAsB9C;AAMA;;;;;;;AAea,cArBA,iCAAA,GAqBA,gBAAA,CAAA,EAAA;;;;AAyCF,UAxDM,uBAAA,CAwDN;QAED,EAzDA,OAAA,CAAQ,GAyDR;MAxDJ,eAAA,CAAgB,GAkFK;;;;;;;;EA+Bf,YAAA,CAAA,EAAA,MAAA;EAAuB,OAAA,EAAA,OAAA,EAAA;OACxB,EAAA,MAAA;MACN,EAvGG,IAuGH,CAvGQ,OAAA,CAAQ,GAuGhB,EAAA,MAAA,GAAA,OAAA,GAAA,SAAA,GAAA,OAAA,CAAA;EAAiB,SAAA,EAtGT,MAsGS,CAAA,MAAA,EAtGM,UAsGN,CAAA;EAET;;;;;;AAQb;EAAkC,WAAA,CAAA,EAvGlB,MAuGkB,CAAA,MAAA,EAAA;IACvB,SAAA,CAAA,EAAA,OAAA;;qBACA,EAAA,MAAA,EAAA;UAID,EA1GE,QA0GF;qBACC,CAAA,EA1Ga,4BA0Gb;;;;;;;;;;;;;;;;;;;;;;;WA9EA;;UAED;;;;;;;;;;;;;;;;;;;;;;;gBA0BM,UAAA,CAAW;;;;;;wBAOH,UAAA,CAAW;;;;;;;;;;;uBAaZ,SAAS,OAAA,CAAQ,SAAS,OAAA,CAAQ;;;;;;;sCAQnB,aAAa;;KAGvC,uBAAA,aACD,4BACN;cAEQ,gBAAA;qBAGoB;sBAFX;uBAEW;;UAKhB,iBAAA;WACN;WACA,QAAQ;oCAIT,qBACC,mBACH,wBACI"}

package/components/execution/InngestExecution.d.ts

@@ -102,7 +102,9 @@ interface InngestExecutionOptions {
    * tracks which ones it has already received so the SDK can avoid
    * re-emitting them on replay.
    */
-  priorDefers?: Record<string, unknown>;
+  priorDefers?: Record<string, {
+    abortable?: boolean;
+  }>;
   stepCompletionOrder: string[];
   stepMode: StepMode;
   checkpointingConfig?: InternalCheckpointingOptions;

package/components/execution/InngestExecution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InngestExecution.d.ts","names":[],"sources":["../../../src/components/execution/InngestExecution.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;UA6BiB,gBAAA;;;;;UAEK;;;;;;;;IAFL,KAAA,EAAA,CAIU,UAJM,EAAA,GAIS,UAJT,EAAA,CAAA;EAAA,CAAA;kBAEX,EAAA;IAEK,IAAA,EAEjB,UAFiB;IAAe,UAAA,EAG1B,cAH0B,EAAA;IAEhC,eAAA,EAAA,MAAA;;;;AAeV;;eACc,EAAA;IAEF,EAAA,EARJ,QAQI;IACD,KAAA,EAAQ,MAAA;;;AAEX,KANI,eAAA,GAMJ,QAAiB,MALX,gBAKW,GALQ,QAKR,CAAA;EALQ,IAAA,EAErB,CAFqB;EAOzB,GAAA,EAJG,OAAA,CAAQ,GAIX;EAAgB,GAAA,EAHb,MAGa,CAAA,MAAA,EAHE,UAGF,CAAA;AAEP,CAAA,GAJT,gBAIuB,CAJN,CAIM,CAAA,CAAA,EAK/B,CAAA,MAPQ,gBAOI,CAAA;AAAsB,UALjB,cAAA,CAKiB;MAAK,MAAA;aAC7B,CAAA,EAAA,MAAA;;AACL,KAFO,sBAEP,CAAA,IAFkC,cAElC,CAAA,GAAA,CAAA,MAAA,EADK,eACL,EAAA,GAAA,YAAA,CAAa,CAAb,CAAA;AAAY,KAEL,uBAFK,CAAA,IAEuB,cAFvB,CAAA,GAAA,QAGT,eADI,IACe,CADQ,CAAA,MAAA,CAAA,GAAA,CAAA,MAAA,EACa,CADb,EAAA,GACmB,YADnB,CACgC,CADhC,CAAA,EAAA;AAAK,UAIvB,UAAA,SAAmB,UAJI,CAAA;;;;;SACc,CAAA,EAAA,OAAA,EAAA;EAAY,SAAA,CAAA,EAAA,OAAA;EAGjD;;;SAAmB,CAAA,EAWxB,OAXwB,CAAA,OAAA,CAAA;EAAU,IAAA,CAAA,EAAA,OAAA;AAsB9C;AAMA;;;;;;;AAea,cArBA,iCAAA,GAqBA,gBAAA,CAAA,EAAA;;;;AAyCF,UAxDM,uBAAA,CAwDN;QAED,EAzDA,OAAA,CAAQ,GAyDR;MAxDJ,eAAA,CAAgB,GAkFK;;;;;;;;EA+Bf,YAAA,CAAA,EAAA,MAAA;EAAuB,OAAA,EAAA,OAAA,EAAA;OACxB,EAAA,MAAA;MACN,EAvGG,IAuGH,CAvGQ,OAAA,CAAQ,GAuGhB,EAAA,MAAA,GAAA,OAAA,GAAA,SAAA,GAAA,OAAA,CAAA;EAAiB,SAAA,EAtGT,MAsGS,CAAA,MAAA,EAtGM,UAsGN,CAAA;EAET;;;;;;AAQb;EAAkC,WAAA,CAAA,EAvGlB,MAuGkB,CAAA,MAAA,EAAA,OAAA,CAAA;qBACvB,EAAA,MAAA,EAAA;UACQ,EAtGP,QAsGO;qBAAR,CAAA,EArGa,4BAqGb;;;;;;;;;;;;;;;;;;;;;;;WAzEA;;UAED;;;;;;;;;;;;;;;;;;;;;;;gBA0BM,UAAA,CAAW;;;;;;wBAOH,UAAA,CAAW;;;;;;;;;;;uBAaZ,SAAS,OAAA,CAAQ,SAAS,OAAA,CAAQ;;;;;;;sCAQnB,aAAa;;KAGvC,uBAAA,aACD,4BACN;cAEQ,gBAAA;qBAGoB;sBAFX;uBAEW;;UAKhB,iBAAA;WACN;WACA,QAAQ;oCAIT,qBACC,mBACH,wBACI"}
+{"version":3,"file":"InngestExecution.d.ts","names":[],"sources":["../../../src/components/execution/InngestExecution.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;UA6BiB,gBAAA;;;;;UAEK;;;;;;;;IAFL,KAAA,EAAA,CAIU,UAJM,EAAA,GAIS,UAJT,EAAA,CAAA;EAAA,CAAA;kBAEX,EAAA;IAEK,IAAA,EAEjB,UAFiB;IAAe,UAAA,EAG1B,cAH0B,EAAA;IAEhC,eAAA,EAAA,MAAA;;;;AAeV;;eACc,EAAA;IAEF,EAAA,EARJ,QAQI;IACD,KAAA,EAAQ,MAAA;;;AAEX,KANI,eAAA,GAMJ,QAAiB,MALX,gBAKW,GALQ,QAKR,CAAA;EALQ,IAAA,EAErB,CAFqB;EAOzB,GAAA,EAJG,OAAA,CAAQ,GAIX;EAAgB,GAAA,EAHb,MAGa,CAAA,MAAA,EAHE,UAGF,CAAA;AAEP,CAAA,GAJT,gBAIuB,CAJN,CAIM,CAAA,CAAA,EAK/B,CAAA,MAPQ,gBAOI,CAAA;AAAsB,UALjB,cAAA,CAKiB;MAAK,MAAA;aAC7B,CAAA,EAAA,MAAA;;AACL,KAFO,sBAEP,CAAA,IAFkC,cAElC,CAAA,GAAA,CAAA,MAAA,EADK,eACL,EAAA,GAAA,YAAA,CAAa,CAAb,CAAA;AAAY,KAEL,uBAFK,CAAA,IAEuB,cAFvB,CAAA,GAAA,QAGT,eADI,IACe,CADQ,CAAA,MAAA,CAAA,GAAA,CAAA,MAAA,EACa,CADb,EAAA,GACmB,YADnB,CACgC,CADhC,CAAA,EAAA;AAAK,UAIvB,UAAA,SAAmB,UAJI,CAAA;;;;;SACc,CAAA,EAAA,OAAA,EAAA;EAAY,SAAA,CAAA,EAAA,OAAA;EAGjD;;;SAAmB,CAAA,EAWxB,OAXwB,CAAA,OAAA,CAAA;EAAU,IAAA,CAAA,EAAA,OAAA;AAsB9C;AAMA;;;;;;;AAea,cArBA,iCAAA,GAqBA,gBAAA,CAAA,EAAA;;;;AAyCF,UAxDM,uBAAA,CAwDN;QAED,EAzDA,OAAA,CAAQ,GAyDR;MAxDJ,eAAA,CAAgB,GAkFK;;;;;;;;EA+Bf,YAAA,CAAA,EAAA,MAAA;EAAuB,OAAA,EAAA,OAAA,EAAA;OACxB,EAAA,MAAA;MACN,EAvGG,IAuGH,CAvGQ,OAAA,CAAQ,GAuGhB,EAAA,MAAA,GAAA,OAAA,GAAA,SAAA,GAAA,OAAA,CAAA;EAAiB,SAAA,EAtGT,MAsGS,CAAA,MAAA,EAtGM,UAsGN,CAAA;EAET;;;;;;AAQb;EAAkC,WAAA,CAAA,EAvGlB,MAuGkB,CAAA,MAAA,EAAA;IACvB,SAAA,CAAA,EAAA,OAAA;;qBACA,EAAA,MAAA,EAAA;UAID,EA1GE,QA0GF;qBACC,CAAA,EA1Ga,4BA0Gb;;;;;;;;;;;;;;;;;;;;;;;WA9EA;;UAED;;;;;;;;;;;;;;;;;;;;;;;gBA0BM,UAAA,CAAW;;;;;;wBAOH,UAAA,CAAW;;;;;;;;;;;uBAaZ,SAAS,OAAA,CAAQ,SAAS,OAAA,CAAQ;;;;;;;sCAQnB,aAAa;;KAGvC,uBAAA,aACD,4BACN;cAEQ,gBAAA;qBAGoB;sBAFX;uBAEW;;UAKhB,iBAAA;WACN;WACA,QAAQ;oCAIT,qBACC,mBACH,wBACI"}

package/components/execution/InngestExecution.js.map

@@ -1 +1 @@
-{"version":3,"file":"InngestExecution.js","names":["options: InngestExecutionOptions"],"sources":["../../../src/components/execution/InngestExecution.ts"],"sourcesContent":["import Debug, { type Debugger } from \"debug\";\nimport { debugPrefix, ExecutionVersion } from \"../../helpers/consts.ts\";\nimport type { ServerTiming } from \"../../helpers/ServerTiming.ts\";\nimport type { MaybePromise, Simplify } from \"../../helpers/types.ts\";\nimport type {\n  Context,\n  IncomingOp,\n  InternalCheckpointingOptions,\n  OutgoingOp,\n  StepMode,\n} from \"../../types.ts\";\nimport type { Inngest } from \"../Inngest.ts\";\nimport type { ActionResponse } from \"../InngestCommHandler.ts\";\nimport type { InngestFunction } from \"../InngestFunction.ts\";\nimport type {\n  MetadataKind,\n  MetadataOpcode,\n  MetadataScope,\n} from \"../InngestMetadata.ts\";\nimport type { Middleware } from \"../middleware/middleware.ts\";\n\n// Re-export ExecutionVersion so it's correctly recognized as an enum and not\n// just a type. This can be lost when bundling if we don't re-export it here.\n// See `pnpm run test:dist`.\nexport { ExecutionVersion };\n\n/**\n * The possible results of an execution.\n */\nexport interface ExecutionResults {\n  \"function-resolved\": { data: unknown };\n  \"step-ran\": { step: OutgoingOp; retriable?: boolean | string };\n  \"function-rejected\": { error: unknown; retriable: boolean | string };\n  \"steps-found\": { steps: [OutgoingOp, ...OutgoingOp[]] };\n  \"step-not-found\": {\n    step: OutgoingOp;\n    foundSteps: BasicFoundStep[];\n    totalFoundSteps: number;\n  };\n\n  /**\n   * Indicates that we need to relinquish control back to Inngest in order to\n   * change step modes.\n   */\n  \"change-mode\": {\n    to: StepMode;\n    token: string;\n  };\n}\n\nexport type ExecutionResult = {\n  [K in keyof ExecutionResults]: Simplify<\n    {\n      type: K;\n      ctx: Context.Any;\n      ops: Record<string, MemoizedOp>;\n    } & ExecutionResults[K]\n  >;\n}[keyof ExecutionResults];\n\nexport interface BasicFoundStep {\n  id: string;\n  displayName?: string;\n}\n\nexport type ExecutionResultHandler<T = ActionResponse> = (\n  result: ExecutionResult,\n) => MaybePromise<T>;\n\nexport type ExecutionResultHandlers<T = ActionResponse> = {\n  [E in ExecutionResult as E[\"type\"]]: (result: E) => MaybePromise<T>;\n};\n\nexport interface MemoizedOp extends IncomingOp {\n  /**\n   * If the step has been hit during this run, these will be the arguments\n   * passed to it.\n   */\n  rawArgs?: unknown[];\n  fulfilled?: boolean;\n\n  /**\n   * The promise that has been returned to userland code.\n   */\n  promise?: Promise<unknown>;\n  seen?: boolean;\n}\n\n/**\n * The preferred execution version that will be used by the SDK when handling\n * brand new runs where the Executor is allowing us to choose.\n *\n * Changing this should not ever be a breaking change, as this will only change\n * new runs, not existing ones.\n */\nexport const PREFERRED_ASYNC_EXECUTION_VERSION =\n  ExecutionVersion.V2 satisfies ExecutionVersion;\n\n/**\n * Options for creating a new {@link InngestExecution} instance.\n */\nexport interface InngestExecutionOptions {\n  client: Inngest.Any;\n  fn: InngestFunction.Any;\n\n  /**\n   * The UUID that represents this function in Inngest.\n   *\n   * This is used to reference the function during async checkpointing, when we\n   * know the function/run already exists and just wish to reference it\n   * directly.\n   */\n  internalFnId?: string;\n  reqArgs: unknown[];\n  runId: string;\n  data: Omit<Context.Any, \"step\" | \"group\" | \"publish\" | \"defer\">;\n  stepState: Record<string, MemoizedOp>;\n\n  /**\n   * A map of hashed defer step IDs to their backend-side metadata\n   * (e.g. `{ abortable: true }`). Defer ops are not steps in the\n   * memoization sense — they don't produce results — but the backend\n   * tracks which ones it has already received so the SDK can avoid\n   * re-emitting them on replay.\n   */\n  priorDefers?: Record<string, unknown>;\n\n  stepCompletionOrder: string[];\n  stepMode: StepMode;\n  checkpointingConfig?: InternalCheckpointingOptions;\n\n  /**\n   * If this execution is being run from a queue job, this will be an identifier\n   * used to reference this execution in Inngest. SDKs are expected to parrot\n   * this back in some responses to correctly attribute actions to this queue\n   * item.\n   */\n  queueItemId?: string;\n\n  /**\n   * Unique identifier for each execution request\n   */\n  requestId?: string;\n\n  /**\n   * Incrementing ID used to denote the generation in which this job was queued\n   */\n  generationId?: number;\n\n  /**\n   * Time the SDK starts handling an execution request. Format is unix millis.\n   */\n  requestStartedAt?: number;\n\n  /**\n   * Headers to be sent with any request to Inngest during this execution.\n   */\n  headers: Record<string, string>;\n  requestedRunStep?: string;\n  timer?: ServerTiming;\n  /**\n   * Which handler variant is being executed. `\"failure\"` skips\n   * trigger-schema validation and resolves `onFailure` instead of the\n   * main handler. `\"defer\"` marks the fn as a standalone defer function\n   * (created via `createDefer`); incoming event data is validated\n   * against the defer function's schema.\n   *\n   * @default \"main\"\n   */\n  handlerKind?: \"main\" | \"failure\" | \"defer\";\n\n  /**\n   * Whether this execution is part of a Durable Endpoint flow. Could be either\n   * sync mode (request not from Inngest) or async mode (request from Inngest).\n   *\n   * @default false\n   */\n  isDurableEndpoint?: boolean;\n\n  disableImmediateExecution?: boolean;\n\n  /**\n   * Information about the incoming HTTP request that triggered this execution.\n   * Used by middleware `wrapRequest` hooks.\n   */\n  requestInfo?: Middleware.Request;\n\n  /**\n   * Pre-created middleware instances to use for this execution. When provided,\n   * the execution will use these instead of instantiating new ones from the\n   * client. This ensures `wrapRequest` and other hooks share state on `this`.\n   */\n  middlewareInstances?: Middleware.BaseMiddleware[];\n\n  /**\n   * Whether the client accepts SSE (`Accept: text/event-stream`). When true,\n   * the execution engine may deliver the result as an SSE stream even if\n   * `stream.push()` was not called.\n   */\n  acceptsSse?: boolean;\n\n  /**\n   * Provide the ability to transform the context passed to the function before\n   * the execution starts.\n   */\n  transformCtx?: (ctx: Readonly<Context.Any>) => Context.Any;\n\n  /**\n   * A hook that is called to create an {@link ActionResponse} from the returned\n   * value of an execution.\n   *\n   * This is required for checkpointing executions.\n   */\n  createResponse?: (data: unknown) => MaybePromise<ActionResponse>;\n}\n\nexport type InngestExecutionFactory = (\n  options: InngestExecutionOptions,\n) => IInngestExecution;\n\nexport class InngestExecution {\n  protected devDebug: Debugger;\n\n  constructor(protected options: InngestExecutionOptions) {\n    this.devDebug = Debug(`${debugPrefix}:${this.options.runId}`);\n  }\n}\n\nexport interface IInngestExecution {\n  version: ExecutionVersion;\n  start(): Promise<ExecutionResult>;\n\n  addMetadata(\n    stepId: string,\n    kind: MetadataKind,\n    scope: MetadataScope,\n    op: MetadataOpcode,\n    values: Record<string, unknown>,\n  ): boolean;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AA+FA,MAAa,oCACX,iBAAiB;AA4HnB,IAAa,mBAAb,MAA8B;CAC5B,AAAU;CAEV,YAAY,AAAUA,SAAkC;EAAlC;AACpB,OAAK,WAAW,MAAM,GAAG,YAAY,GAAG,KAAK,QAAQ,QAAQ"}
+{"version":3,"file":"InngestExecution.js","names":["options: InngestExecutionOptions"],"sources":["../../../src/components/execution/InngestExecution.ts"],"sourcesContent":["import Debug, { type Debugger } from \"debug\";\nimport { debugPrefix, ExecutionVersion } from \"../../helpers/consts.ts\";\nimport type { ServerTiming } from \"../../helpers/ServerTiming.ts\";\nimport type { MaybePromise, Simplify } from \"../../helpers/types.ts\";\nimport type {\n  Context,\n  IncomingOp,\n  InternalCheckpointingOptions,\n  OutgoingOp,\n  StepMode,\n} from \"../../types.ts\";\nimport type { Inngest } from \"../Inngest.ts\";\nimport type { ActionResponse } from \"../InngestCommHandler.ts\";\nimport type { InngestFunction } from \"../InngestFunction.ts\";\nimport type {\n  MetadataKind,\n  MetadataOpcode,\n  MetadataScope,\n} from \"../InngestMetadata.ts\";\nimport type { Middleware } from \"../middleware/middleware.ts\";\n\n// Re-export ExecutionVersion so it's correctly recognized as an enum and not\n// just a type. This can be lost when bundling if we don't re-export it here.\n// See `pnpm run test:dist`.\nexport { ExecutionVersion };\n\n/**\n * The possible results of an execution.\n */\nexport interface ExecutionResults {\n  \"function-resolved\": { data: unknown };\n  \"step-ran\": { step: OutgoingOp; retriable?: boolean | string };\n  \"function-rejected\": { error: unknown; retriable: boolean | string };\n  \"steps-found\": { steps: [OutgoingOp, ...OutgoingOp[]] };\n  \"step-not-found\": {\n    step: OutgoingOp;\n    foundSteps: BasicFoundStep[];\n    totalFoundSteps: number;\n  };\n\n  /**\n   * Indicates that we need to relinquish control back to Inngest in order to\n   * change step modes.\n   */\n  \"change-mode\": {\n    to: StepMode;\n    token: string;\n  };\n}\n\nexport type ExecutionResult = {\n  [K in keyof ExecutionResults]: Simplify<\n    {\n      type: K;\n      ctx: Context.Any;\n      ops: Record<string, MemoizedOp>;\n    } & ExecutionResults[K]\n  >;\n}[keyof ExecutionResults];\n\nexport interface BasicFoundStep {\n  id: string;\n  displayName?: string;\n}\n\nexport type ExecutionResultHandler<T = ActionResponse> = (\n  result: ExecutionResult,\n) => MaybePromise<T>;\n\nexport type ExecutionResultHandlers<T = ActionResponse> = {\n  [E in ExecutionResult as E[\"type\"]]: (result: E) => MaybePromise<T>;\n};\n\nexport interface MemoizedOp extends IncomingOp {\n  /**\n   * If the step has been hit during this run, these will be the arguments\n   * passed to it.\n   */\n  rawArgs?: unknown[];\n  fulfilled?: boolean;\n\n  /**\n   * The promise that has been returned to userland code.\n   */\n  promise?: Promise<unknown>;\n  seen?: boolean;\n}\n\n/**\n * The preferred execution version that will be used by the SDK when handling\n * brand new runs where the Executor is allowing us to choose.\n *\n * Changing this should not ever be a breaking change, as this will only change\n * new runs, not existing ones.\n */\nexport const PREFERRED_ASYNC_EXECUTION_VERSION =\n  ExecutionVersion.V2 satisfies ExecutionVersion;\n\n/**\n * Options for creating a new {@link InngestExecution} instance.\n */\nexport interface InngestExecutionOptions {\n  client: Inngest.Any;\n  fn: InngestFunction.Any;\n\n  /**\n   * The UUID that represents this function in Inngest.\n   *\n   * This is used to reference the function during async checkpointing, when we\n   * know the function/run already exists and just wish to reference it\n   * directly.\n   */\n  internalFnId?: string;\n  reqArgs: unknown[];\n  runId: string;\n  data: Omit<Context.Any, \"step\" | \"group\" | \"publish\" | \"defer\">;\n  stepState: Record<string, MemoizedOp>;\n\n  /**\n   * A map of hashed defer step IDs to their backend-side metadata\n   * (e.g. `{ abortable: true }`). Defer ops are not steps in the\n   * memoization sense — they don't produce results — but the backend\n   * tracks which ones it has already received so the SDK can avoid\n   * re-emitting them on replay.\n   */\n  priorDefers?: Record<string, { abortable?: boolean }>;\n\n  stepCompletionOrder: string[];\n  stepMode: StepMode;\n  checkpointingConfig?: InternalCheckpointingOptions;\n\n  /**\n   * If this execution is being run from a queue job, this will be an identifier\n   * used to reference this execution in Inngest. SDKs are expected to parrot\n   * this back in some responses to correctly attribute actions to this queue\n   * item.\n   */\n  queueItemId?: string;\n\n  /**\n   * Unique identifier for each execution request\n   */\n  requestId?: string;\n\n  /**\n   * Incrementing ID used to denote the generation in which this job was queued\n   */\n  generationId?: number;\n\n  /**\n   * Time the SDK starts handling an execution request. Format is unix millis.\n   */\n  requestStartedAt?: number;\n\n  /**\n   * Headers to be sent with any request to Inngest during this execution.\n   */\n  headers: Record<string, string>;\n  requestedRunStep?: string;\n  timer?: ServerTiming;\n  /**\n   * Which handler variant is being executed. `\"failure\"` skips\n   * trigger-schema validation and resolves `onFailure` instead of the\n   * main handler. `\"defer\"` marks the fn as a standalone defer function\n   * (created via `createDefer`); incoming event data is validated\n   * against the defer function's schema.\n   *\n   * @default \"main\"\n   */\n  handlerKind?: \"main\" | \"failure\" | \"defer\";\n\n  /**\n   * Whether this execution is part of a Durable Endpoint flow. Could be either\n   * sync mode (request not from Inngest) or async mode (request from Inngest).\n   *\n   * @default false\n   */\n  isDurableEndpoint?: boolean;\n\n  disableImmediateExecution?: boolean;\n\n  /**\n   * Information about the incoming HTTP request that triggered this execution.\n   * Used by middleware `wrapRequest` hooks.\n   */\n  requestInfo?: Middleware.Request;\n\n  /**\n   * Pre-created middleware instances to use for this execution. When provided,\n   * the execution will use these instead of instantiating new ones from the\n   * client. This ensures `wrapRequest` and other hooks share state on `this`.\n   */\n  middlewareInstances?: Middleware.BaseMiddleware[];\n\n  /**\n   * Whether the client accepts SSE (`Accept: text/event-stream`). When true,\n   * the execution engine may deliver the result as an SSE stream even if\n   * `stream.push()` was not called.\n   */\n  acceptsSse?: boolean;\n\n  /**\n   * Provide the ability to transform the context passed to the function before\n   * the execution starts.\n   */\n  transformCtx?: (ctx: Readonly<Context.Any>) => Context.Any;\n\n  /**\n   * A hook that is called to create an {@link ActionResponse} from the returned\n   * value of an execution.\n   *\n   * This is required for checkpointing executions.\n   */\n  createResponse?: (data: unknown) => MaybePromise<ActionResponse>;\n}\n\nexport type InngestExecutionFactory = (\n  options: InngestExecutionOptions,\n) => IInngestExecution;\n\nexport class InngestExecution {\n  protected devDebug: Debugger;\n\n  constructor(protected options: InngestExecutionOptions) {\n    this.devDebug = Debug(`${debugPrefix}:${this.options.runId}`);\n  }\n}\n\nexport interface IInngestExecution {\n  version: ExecutionVersion;\n  start(): Promise<ExecutionResult>;\n\n  addMetadata(\n    stepId: string,\n    kind: MetadataKind,\n    scope: MetadataScope,\n    op: MetadataOpcode,\n    values: Record<string, unknown>,\n  ): boolean;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AA+FA,MAAa,oCACX,iBAAiB;AA4HnB,IAAa,mBAAb,MAA8B;CAC5B,AAAU;CAEV,YAAY,AAAUA,SAAkC;EAAlC;AACpB,OAAK,WAAW,MAAM,GAAG,YAAY,GAAG,KAAK,QAAQ,QAAQ"}

package/components/execution/engine.cjs

@@ -9,6 +9,7 @@ const require_types$1 = require('../../helpers/types.cjs');
 const require_functions = require('../../helpers/functions.cjs');
 const require_marker = require('../../helpers/marker.cjs');
 const require_temporal = require('../../helpers/temporal.cjs');
+const require_strings = require('../../helpers/strings.cjs');
 const require_promises = require('../../helpers/promises.cjs');
 const require_als = require('./als.cjs');
 const require_aiExtractor = require('./otel/aiExtractor.cjs');
@@ -556,7 +557,7 @@ var InngestExecutionEngine = class extends require_InngestExecution.InngestExecu
 				delete this.state.executingStep;
 				this.state.checkpointingStepBuffer.push({
 					...stepToResume,
-					data: stepResult.data
+					data: stepToResume.data
 				});
 			}
 			if (force || !this.options.checkpointingConfig?.bufferedSteps || this.state.checkpointingStepBuffer.length >= this.options.checkpointingConfig.bufferedSteps) {
@@ -1488,45 +1489,48 @@ var InngestExecutionEngine = class extends require_InngestExecution.InngestExecu
 		return (idOrOptions, { function: deferFn, data, experiment }) => {
 			const log = this.options.client[require_Inngest.internalLoggerSymbol];
 			const runId = this.fnArg.runId;
+			const noopHandle = { abort: () => {} };
 			try {
 				if (!require_marker.isDeferredFunction(deferFn)) {
 					log.error({ runId }, "defer skipped: function not created via createDefer");
-					return;
+					return noopHandle;
 				}
 				const { schema } = deferFn;
 				const deferFnSlug = deferFn.id(this.options.client.id);
+				const stepOptions = require_InngestStepTools.getStepOptions(idOrOptions);
+				const hashedId = _internals.hashId(stepOptions.id);
 				let input = data;
 				if (schema) {
 					const result = schema["~standard"].validate(data);
 					if (result instanceof Promise) {
 						log.error({ runId }, "defer() requires a synchronous schema validator. The defer call was skipped.");
-						return;
+						return noopHandle;
 					}
 					if (result.issues) {
 						log.error({
 							runId,
 							issues: result.issues
 						}, "defer skipped: schema validation failed");
-						return;
+						return noopHandle;
 					}
 					input = result.value ?? data;
 				}
 				stepHandler({
-					args: [idOrOptions, experiment && require_types$1.isRecord(input) ? {
+					args: [stepOptions, experiment && require_types$1.isRecord(input) ? {
 						...input,
 						[require_consts.deferExperimentKey]: experiment
 					} : input],
-					matchOp: (stepOptions, inputArg) => ({
-						id: stepOptions.id,
+					matchOp: (stepOptions$1, inputArg) => ({
+						id: stepOptions$1.id,
 						mode: require_types.StepMode.Sync,
 						op: require_types.StepOpCode.DeferAdd,
-						name: stepOptions.name ?? stepOptions.id,
-						displayName: stepOptions.name ?? stepOptions.id,
+						name: stepOptions$1.name ?? stepOptions$1.id,
+						displayName: stepOptions$1.name ?? stepOptions$1.id,
 						opts: {
 							fn_slug: deferFnSlug,
 							input: inputArg
 						},
-						userland: { id: stepOptions.id }
+						userland: { id: stepOptions$1.id }
 					})
 				}).catch((err) => {
 					log.error({
@@ -1534,11 +1538,48 @@ var InngestExecutionEngine = class extends require_InngestExecution.InngestExecu
 						err
 					}, "defer skipped: unexpected error");
 				});
+				return { abort: () => {
+					try {
+						if (this.state.priorDefers[hashedId]?.abortable === false) return;
+						const abortId = `${hashedId}:abort`;
+						if (this.state.lazyOps.hasId(_internals.hashId(abortId))) return;
+						stepHandler({
+							args: [{
+								id: abortId,
+								name: stepOptions.name
+							}, null],
+							matchOp: (abortStepOptions) => ({
+								id: abortStepOptions.id,
+								mode: require_types.StepMode.Sync,
+								op: require_types.StepOpCode.DeferAbort,
+								name: stepOptions.name ?? stepOptions.id,
+								displayName: stepOptions.name ?? stepOptions.id,
+								opts: {
+									target_hashed_id: hashedId,
+									fn_slug: deferFnSlug,
+									id: stepOptions.id
+								},
+								userland: { id: stepOptions.id }
+							})
+						}).catch((err) => {
+							log.error({
+								runId,
+								err
+							}, "defer abort skipped: unexpected error");
+						});
+					} catch (err) {
+						log.error({
+							runId,
+							err
+						}, "defer abort skipped: unexpected error");
+					}
+				} };
 			} catch (err) {
 				log.error({
 					runId,
 					err
 				}, "defer skipped: unexpected error");
+				return noopHandle;
 			}
 		};
 	}
@@ -1608,7 +1649,7 @@ var InngestExecutionEngine = class extends require_InngestExecution.InngestExecu
 	resumeStepWithResult(resultOp, resume = true) {
 		const userlandStep = this.state.steps.get(resultOp.id);
 		if (!userlandStep) throw new Error("Step not found in memoization state during async checkpointing; this should never happen and is a bug in the Inngest SDK");
-		userlandStep.data = require_functions.undefinedToNull(resultOp.data);
+		userlandStep.data = JSON.parse(require_strings.stringify(require_functions.undefinedToNull(resultOp.data)));
 		userlandStep.timing = resultOp.timing;
 		userlandStep.op = resultOp.op;
 		userlandStep.id = resultOp.id;