@restatedev/restate-sdk 1.11.1 → 1.12.0

package/dist/promises.js

@@ -6,20 +6,31 @@ import { setImmediate } from "node:timers/promises";
 function pendingPromise() {
 	return new Promise(() => {});
 }
+/**
+* Returns `true` if the given value is a {@link RestatePromise}.
+*
+* Use this for runtime type detection when you need to distinguish Restate promises
+* from regular promises, e.g. for overload resolution.
+*/
+function isRestatePromise(p) {
+	return p instanceof InternalRestatePromise;
+}
 var PromiseState = /* @__PURE__ */ function(PromiseState$1) {
 	PromiseState$1[PromiseState$1["COMPLETED"] = 0] = "COMPLETED";
 	PromiseState$1[PromiseState$1["NOT_COMPLETED"] = 1] = "NOT_COMPLETED";
 	return PromiseState$1;
 }(PromiseState || {});
+var InternalRestatePromise = class {};
 const RESTATE_CTX_SYMBOL = Symbol("restateContext");
 function extractContext(n) {
 	return n[RESTATE_CTX_SYMBOL];
 }
-var AbstractRestatePromise = class {
+var BaseRestatePromise = class extends InternalRestatePromise {
 	[RESTATE_CTX_SYMBOL];
 	pollingPromise;
 	cancelPromise = new CompletablePromise();
 	constructor(ctx) {
+		super();
 		this[RESTATE_CTX_SYMBOL] = ctx;
 	}
 	then(onfulfilled, onrejected) {
@@ -38,7 +49,7 @@ var AbstractRestatePromise = class {
 		return Promise.race([this.cancelPromise.promise, this.publicPromise()]);
 	}
 	orTimeout(duration) {
-		return new RestateCombinatorPromise(this[RESTATE_CTX_SYMBOL], ([thisPromise, sleepPromise]) => {
+		return new CombinatorRestatePromise(this[RESTATE_CTX_SYMBOL], ([thisPromise, sleepPromise]) => {
 			return new Promise((resolve, reject) => {
 				thisPromise.then(resolve, reject);
 				sleepPromise.then(() => {
@@ -48,13 +59,13 @@ var AbstractRestatePromise = class {
 		}, [this, this[RESTATE_CTX_SYMBOL].sleep(duration)]);
 	}
 	map(mapper) {
-		return new RestateMappedPromise(this[RESTATE_CTX_SYMBOL], this, mapper);
+		return new MappedRestatePromise(this[RESTATE_CTX_SYMBOL], this, mapper);
 	}
 	tryCancel() {
 		this.cancelPromise.reject(new CancelledError());
 	}
 };
-var RestateSinglePromise = class extends AbstractRestatePromise {
+var SingleRestatePromise = class extends BaseRestatePromise {
 	state = PromiseState.NOT_COMPLETED;
 	completablePromise = new CompletablePromise();
 	constructor(ctx, handle, completer) {
@@ -75,9 +86,12 @@ var RestateSinglePromise = class extends AbstractRestatePromise {
 	publicPromise() {
 		return this.completablePromise.promise;
 	}
+	isCompleted() {
+		return this.state === PromiseState.COMPLETED;
+	}
 	[Symbol.toStringTag] = "RestateSinglePromise";
 };
-var RestateInvocationPromise = class extends RestateSinglePromise {
+var InvocationRestatePromise = class extends SingleRestatePromise {
 	constructor(ctx, handle, completer, invocationIdPromise) {
 		super(ctx, handle, completer);
 		this.invocationIdPromise = invocationIdPromise;
@@ -86,7 +100,7 @@ var RestateInvocationPromise = class extends RestateSinglePromise {
 		return this.invocationIdPromise;
 	}
 };
-var RestateCombinatorPromise = class extends AbstractRestatePromise {
+var CombinatorRestatePromise = class CombinatorRestatePromise extends BaseRestatePromise {
 	state = PromiseState.NOT_COMPLETED;
 	combinatorPromise;
 	constructor(ctx, combinatorConstructor, childs) {
@@ -96,6 +110,21 @@ var RestateCombinatorPromise = class extends AbstractRestatePromise {
 			this.state = PromiseState.COMPLETED;
 		});
 	}
+	static fromPromises(combinatorConstructor, promises) {
+		const castedPromises = [];
+		let foundContext = void 0;
+		for (const [idx, promise] of promises.entries()) {
+			if (!isRestatePromise(promise)) throw new Error(`Promise index ${idx} used inside the combinator is not an instance of RestatePromise. This is not supported.`);
+			else if (foundContext === void 0) foundContext = extractContext(promise);
+			else {
+				const thisContext = extractContext(promise);
+				if (thisContext !== void 0 && thisContext !== foundContext) throw new Error("You're mixing up RestatePromises from different RestateContext. This is not supported.");
+			}
+			castedPromises.push(promise);
+		}
+		if (foundContext === void 0) return ConstRestatePromise.fromPromise(combinatorConstructor(castedPromises), true);
+		return new CombinatorRestatePromise(foundContext, combinatorConstructor, castedPromises);
+	}
 	uncompletedLeaves() {
 		return this.state === PromiseState.COMPLETED ? [] : this.childs.flatMap((p) => p.uncompletedLeaves());
 	}
@@ -107,45 +136,7 @@ var RestateCombinatorPromise = class extends AbstractRestatePromise {
 	}
 	[Symbol.toStringTag] = "RestateCombinatorPromise";
 };
-var RestatePendingPromise = class {
-	[RESTATE_CTX_SYMBOL];
-	constructor(ctx) {
-		this[RESTATE_CTX_SYMBOL] = ctx;
-	}
-	then(onfulfilled, onrejected) {
-		return pendingPromise().then(onfulfilled, onrejected);
-	}
-	catch(onrejected) {
-		return pendingPromise().catch(onrejected);
-	}
-	finally(onfinally) {
-		return pendingPromise().finally(onfinally);
-	}
-	orTimeout() {
-		return this;
-	}
-	map() {
-		return this;
-	}
-	tryCancel() {}
-	async tryComplete() {}
-	uncompletedLeaves() {
-		return [];
-	}
-	publicPromise() {
-		return pendingPromise();
-	}
-	[Symbol.toStringTag] = "RestatePendingPromise";
-};
-var InvocationPendingPromise = class extends RestatePendingPromise {
-	constructor(ctx) {
-		super(ctx);
-	}
-	get invocationId() {
-		return pendingPromise();
-	}
-};
-var RestateMappedPromise = class extends AbstractRestatePromise {
+var MappedRestatePromise = class extends BaseRestatePromise {
 	publicPromiseMapper;
 	constructor(ctx, inner, mapper) {
 		super(ctx);
@@ -156,7 +147,7 @@ var RestateMappedPromise = class extends AbstractRestatePromise {
 			} catch (e) {
 				if (e instanceof TerminalError) return Promise.reject(e);
 				else {
-					ctx.handleInvocationEndError(e);
+					ctx.abortAttempt(e);
 					return pendingPromise();
 				}
 			}
@@ -177,6 +168,52 @@ var RestateMappedPromise = class extends AbstractRestatePromise {
 	}
 	[Symbol.toStringTag] = "RestateMappedPromise";
 };
+var ConstRestatePromise = class ConstRestatePromise extends InternalRestatePromise {
+	constructor(constPromise, settled) {
+		super();
+		this.constPromise = constPromise;
+		this.settled = settled;
+	}
+	static resolve(value) {
+		return new ConstRestatePromise(Promise.resolve(value), true);
+	}
+	static reject(reason) {
+		return new ConstRestatePromise(Promise.reject(reason), true);
+	}
+	static pending() {
+		return new ConstRestatePromise(pendingPromise(), false);
+	}
+	static fromPromise(promise, settled) {
+		return new ConstRestatePromise(promise, settled);
+	}
+	then(onfulfilled, onrejected) {
+		return this.constPromise.then(onfulfilled, onrejected);
+	}
+	catch(onrejected) {
+		return this.constPromise.catch(onrejected);
+	}
+	finally(onfinally) {
+		return this.constPromise.finally(onfinally);
+	}
+	orTimeout() {
+		if (this.settled) return this;
+		return ConstRestatePromise.reject(new TimeoutError());
+	}
+	map(mapper) {
+		return ConstRestatePromise.fromPromise(this.constPromise.then((value) => mapper(value, void 0), (reason) => mapper(void 0, reason)), this.settled);
+	}
+	tryCancel() {}
+	publicPromise() {
+		return this.constPromise;
+	}
+	tryComplete() {
+		return Promise.resolve();
+	}
+	uncompletedLeaves() {
+		return [];
+	}
+	[Symbol.toStringTag] = "ConstRestatePromise";
+};
 /**
 * Promises executor, gluing VM with I/O and Promises given to user space.
 */
@@ -196,7 +233,7 @@ var PromisesExecutor = class {
 		try {
 			await restatePromise.tryComplete();
 		} catch (e) {
-			restatePromise[RESTATE_CTX_SYMBOL].handleInvocationEndError(e);
+			this.errorCallback(e);
 			return Promise.resolve();
 		}
 		return setImmediate().then(async () => {
@@ -222,5 +259,5 @@ var PromisesExecutor = class {
 };
 
 //#endregion
-export { InvocationPendingPromise, PromisesExecutor, RestateCombinatorPromise, RestateInvocationPromise, RestatePendingPromise, RestateSinglePromise, extractContext, pendingPromise };
+export { CombinatorRestatePromise, ConstRestatePromise, InternalRestatePromise, InvocationRestatePromise, PromisesExecutor, SingleRestatePromise, isRestatePromise, pendingPromise };
 //# sourceMappingURL=promises.js.map

package/dist/promises.js.map

@@ -1 +1 @@
-{"version":3,"file":"promises.js","names":["handle: number","completer: (\n      value: AsyncResultValue,\n      prom: CompletablePromise<T>\n    ) => Promise<void>","invocationIdPromise: Promise<InvocationId>","childs: Array<InternalRestatePromise<any>>","inner: InternalRestatePromise<T>","coreVm: vm.WasmVM","inputPump: InputPump","outputPump: OutputPump","runClosuresTracker: RunClosuresTracker","errorCallback: (e: any) => void"],"sources":["../src/promises.ts"],"sourcesContent":["/*\n * Copyright (c) 2023-2025 - Restate Software, Inc., Restate GmbH\n *\n * This file is part of the Restate SDK for Node.js/TypeScript,\n * which is released under the MIT license.\n *\n * You can find a copy of the license in file LICENSE in the root\n * directory of this repository or package, or at\n * https://github.com/restatedev/sdk-typescript/blob/main/LICENSE\n */\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\nimport type {\n  RestatePromise,\n  InvocationId,\n  InvocationPromise,\n} from \"./context.js\";\nimport type * as vm from \"./endpoint/handlers/vm/sdk_shared_core_wasm_bindings.js\";\nimport {\n  CancelledError,\n  RestateError,\n  TerminalError,\n  TimeoutError,\n} from \"./types/errors.js\";\nimport { CompletablePromise } from \"./utils/completable_promise.js\";\nimport type { ContextImpl, RunClosuresTracker } from \"./context_impl.js\";\nimport { setImmediate } from \"node:timers/promises\";\nimport type { InputPump, OutputPump } from \"./io.js\";\nimport type { Duration } from \"@restatedev/restate-sdk-core\";\n\n// A promise that is never completed\nexport function pendingPromise<T>(): Promise<T> {\n  return new Promise<T>(() => {});\n}\n\n// ------ Restate promises ------\n// These promises are \"proxy promises\" that will be handed over to the user,\n// and moved forward by the PromiseExecutor below when the user awaits on them.\n\nenum PromiseState {\n  COMPLETED,\n  NOT_COMPLETED,\n}\n\nexport const RESTATE_CTX_SYMBOL = Symbol(\"restateContext\");\n\nexport interface InternalRestatePromise<T> extends RestatePromise<T> {\n  [RESTATE_CTX_SYMBOL]: ContextImpl;\n\n  tryCancel(): void;\n  tryComplete(): Promise<void>;\n  uncompletedLeaves(): Array<number>;\n  publicPromise(): Promise<T>;\n}\n\nexport type AsyncResultValue =\n  | \"Empty\"\n  | { Success: Uint8Array }\n  | { Failure: vm.WasmFailure }\n  | { StateKeys: string[] }\n  | { InvocationId: string };\n\nexport function extractContext(n: any): ContextImpl | undefined {\n  // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n  return n[RESTATE_CTX_SYMBOL] as ContextImpl | undefined;\n}\n\nabstract class AbstractRestatePromise<T> implements InternalRestatePromise<T> {\n  [RESTATE_CTX_SYMBOL]: ContextImpl;\n  private pollingPromise?: Promise<any>;\n  private cancelPromise: CompletablePromise<any> = new CompletablePromise();\n\n  protected constructor(ctx: ContextImpl) {\n    this[RESTATE_CTX_SYMBOL] = ctx;\n  }\n\n  // --- Promise methods\n\n  then<TResult1 = T, TResult2 = never>(\n    onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null,\n    onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null\n  ): Promise<TResult1 | TResult2> {\n    this.pollingPromise =\n      this.pollingPromise ||\n      this[RESTATE_CTX_SYMBOL].promisesExecutor\n        .doProgress(this)\n        .catch(() => {});\n    return this.publicPromiseOrCancelPromise().then(onfulfilled, onrejected);\n  }\n\n  catch<TResult = never>(\n    onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | null\n  ): Promise<T | TResult> {\n    this.pollingPromise =\n      this.pollingPromise ||\n      this[RESTATE_CTX_SYMBOL].promisesExecutor\n        .doProgress(this)\n        .catch(() => {});\n    return this.publicPromiseOrCancelPromise().catch(onrejected);\n  }\n\n  finally(onfinally?: (() => void) | null): Promise<T> {\n    this.pollingPromise =\n      this.pollingPromise ||\n      this[RESTATE_CTX_SYMBOL].promisesExecutor\n        .doProgress(this)\n        .catch(() => {});\n    return this.publicPromiseOrCancelPromise().finally(onfinally);\n  }\n\n  private publicPromiseOrCancelPromise(): Promise<T> {\n    return Promise.race([\n      this.cancelPromise.promise as Promise<T>,\n      this.publicPromise(),\n    ]);\n  }\n\n  // --- RestatePromise methods\n\n  orTimeout(duration: number | Duration): RestatePromise<T> {\n    return new RestateCombinatorPromise(\n      this[RESTATE_CTX_SYMBOL],\n      ([thisPromise, sleepPromise]) => {\n        return new Promise((resolve, reject) => {\n          thisPromise!.then(resolve, reject);\n          sleepPromise!.then(() => {\n            reject(new TimeoutError());\n          }, reject);\n        });\n      },\n      [\n        this,\n        this[RESTATE_CTX_SYMBOL].sleep(duration) as InternalRestatePromise<any>,\n      ]\n    ) as RestatePromise<T>;\n  }\n\n  map<U>(mapper: (value?: T, failure?: TerminalError) => U): RestatePromise<U> {\n    return new RestateMappedPromise(this[RESTATE_CTX_SYMBOL], this, mapper);\n  }\n\n  tryCancel() {\n    this.cancelPromise.reject(new CancelledError());\n  }\n\n  abstract tryComplete(): Promise<void>;\n\n  abstract uncompletedLeaves(): Array<number>;\n\n  abstract publicPromise(): Promise<T>;\n\n  abstract [Symbol.toStringTag]: string;\n}\n\nexport class RestateSinglePromise<T> extends AbstractRestatePromise<T> {\n  private state: PromiseState = PromiseState.NOT_COMPLETED;\n  private completablePromise: CompletablePromise<T> = new CompletablePromise();\n\n  constructor(\n    ctx: ContextImpl,\n    readonly handle: number,\n    private readonly completer: (\n      value: AsyncResultValue,\n      prom: CompletablePromise<T>\n    ) => Promise<void>\n  ) {\n    super(ctx);\n  }\n\n  uncompletedLeaves(): number[] {\n    return this.state === PromiseState.COMPLETED ? [] : [this.handle];\n  }\n\n  async tryComplete(): Promise<void> {\n    if (this.state === PromiseState.COMPLETED) {\n      return;\n    }\n    const notification = this[RESTATE_CTX_SYMBOL].coreVm.take_notification(\n      this.handle\n    );\n    if (notification === \"NotReady\") {\n      return;\n    }\n    this.state = PromiseState.COMPLETED;\n    await this.completer(notification, this.completablePromise);\n  }\n\n  publicPromise(): Promise<T> {\n    return this.completablePromise.promise;\n  }\n\n  readonly [Symbol.toStringTag] = \"RestateSinglePromise\";\n}\n\nexport class RestateInvocationPromise<T>\n  extends RestateSinglePromise<T>\n  implements InvocationPromise<T>\n{\n  constructor(\n    ctx: ContextImpl,\n    handle: number,\n    completer: (\n      value: AsyncResultValue,\n      prom: CompletablePromise<T>\n    ) => Promise<void>,\n    private readonly invocationIdPromise: Promise<InvocationId>\n  ) {\n    super(ctx, handle, completer);\n  }\n\n  get invocationId(): Promise<InvocationId> {\n    return this.invocationIdPromise;\n  }\n}\n\nexport class RestateCombinatorPromise extends AbstractRestatePromise<any> {\n  private state: PromiseState = PromiseState.NOT_COMPLETED;\n  private readonly combinatorPromise: Promise<any>;\n\n  constructor(\n    ctx: ContextImpl,\n    combinatorConstructor: (promises: Promise<any>[]) => Promise<any>,\n    readonly childs: Array<InternalRestatePromise<any>>\n  ) {\n    super(ctx);\n    this.combinatorPromise = combinatorConstructor(\n      childs.map((p) => p.publicPromise())\n    ).finally(() => {\n      this.state = PromiseState.COMPLETED;\n    });\n  }\n\n  uncompletedLeaves(): number[] {\n    return this.state === PromiseState.COMPLETED\n      ? []\n      : this.childs.flatMap((p) => p.uncompletedLeaves());\n  }\n\n  async tryComplete(): Promise<void> {\n    await Promise.allSettled(this.childs.map((c) => c.tryComplete()));\n  }\n\n  publicPromise(): Promise<unknown> {\n    return this.combinatorPromise;\n  }\n\n  readonly [Symbol.toStringTag] = \"RestateCombinatorPromise\";\n}\n\nexport class RestatePendingPromise<T> implements InternalRestatePromise<T> {\n  [RESTATE_CTX_SYMBOL]: ContextImpl;\n\n  constructor(ctx: ContextImpl) {\n    this[RESTATE_CTX_SYMBOL] = ctx;\n  }\n\n  // --- Promise methods\n\n  then<TResult1 = T, TResult2 = never>(\n    onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null,\n    onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null\n  ): Promise<TResult1 | TResult2> {\n    return pendingPromise<T>().then(onfulfilled, onrejected);\n  }\n\n  catch<TResult = never>(\n    onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | null\n  ): Promise<T | TResult> {\n    return pendingPromise<T>().catch(onrejected);\n  }\n\n  finally(onfinally?: (() => void) | null): Promise<T> {\n    return pendingPromise<T>().finally(onfinally);\n  }\n\n  // --- RestatePromise methods\n\n  orTimeout(): RestatePromise<T> {\n    return this;\n  }\n\n  map<U>(): RestatePromise<U> {\n    return this as unknown as RestatePromise<U>;\n  }\n\n  tryCancel(): void {}\n  async tryComplete(): Promise<void> {}\n  uncompletedLeaves(): number[] {\n    return [];\n  }\n  publicPromise(): Promise<T> {\n    return pendingPromise<T>();\n  }\n\n  readonly [Symbol.toStringTag] = \"RestatePendingPromise\";\n}\n\nexport class InvocationPendingPromise<T>\n  extends RestatePendingPromise<T>\n  implements InvocationPromise<T>\n{\n  constructor(ctx: ContextImpl) {\n    super(ctx);\n  }\n\n  get invocationId(): Promise<InvocationId> {\n    return pendingPromise();\n  }\n}\n\nexport class RestateMappedPromise<T, U> extends AbstractRestatePromise<U> {\n  private publicPromiseMapper: (\n    value?: T,\n    failure?: TerminalError\n  ) => Promise<U>;\n\n  constructor(\n    ctx: ContextImpl,\n    readonly inner: InternalRestatePromise<T>,\n    mapper: (value?: T, failure?: TerminalError) => U\n  ) {\n    super(ctx);\n    this.publicPromiseMapper = (value?: T, failure?: TerminalError) => {\n      try {\n        return Promise.resolve(mapper(value, failure));\n      } catch (e) {\n        if (e instanceof TerminalError) {\n          return Promise.reject(e);\n        } else {\n          ctx.handleInvocationEndError(e);\n          return pendingPromise();\n        }\n      }\n    };\n  }\n\n  async tryComplete(): Promise<void> {\n    await this.inner.tryComplete();\n  }\n\n  uncompletedLeaves(): number[] {\n    return this.inner.uncompletedLeaves();\n  }\n\n  publicPromise(): Promise<U> {\n    const promiseMapper = this.publicPromiseMapper;\n    return this.inner.publicPromise().then(\n      (t) => promiseMapper(t, undefined),\n      (error) => {\n        if (error instanceof RestateError) {\n          return promiseMapper(undefined, error);\n        } else {\n          // Something else, just re-throw it\n          throw error;\n        }\n      }\n    );\n  }\n\n  readonly [Symbol.toStringTag] = \"RestateMappedPromise\";\n}\n\n/**\n * Promises executor, gluing VM with I/O and Promises given to user space.\n */\nexport class PromisesExecutor {\n  constructor(\n    private readonly coreVm: vm.WasmVM,\n    private readonly inputPump: InputPump,\n    private readonly outputPump: OutputPump,\n    private readonly runClosuresTracker: RunClosuresTracker,\n    private readonly errorCallback: (e: any) => void\n  ) {}\n\n  async doProgress(restatePromise: InternalRestatePromise<unknown>) {\n    // Only the first time try process output\n    await this.outputPump.awaitNextProgress();\n    await this.doProgressInner(restatePromise);\n  }\n\n  private async doProgressInner(\n    restatePromise: InternalRestatePromise<unknown>\n  ) {\n    // Try complete the promise\n    try {\n      await restatePromise.tryComplete();\n    } catch (e) {\n      // This can happen if either take_notification throws an exception or completer throws an exception.\n      // This could either happen for a deserialization issue, or for an SDK bug, but we cover them here.\n      restatePromise[RESTATE_CTX_SYMBOL].handleInvocationEndError(e);\n      return Promise.resolve();\n    }\n\n    // tl;dr don't touch this, or you can break combineable promises,\n    // slinkydeveloper won't be happy about it\n    //\n    // The reason for this setTimeout is that we need to enqueue the polling after\n    // we eventually resolve some promises. This is especially crucial for RestateCombinatorPromise\n    // as it flips the completed state using .finally() on the combinator.\n    return setImmediate().then(async () => {\n      try {\n        // Invoke do progress on the vm\n        const handles = restatePromise.uncompletedLeaves();\n        if (handles.length === 0) {\n          // Completed, we're good!\n          return;\n        }\n        const doProgressResult = this.coreVm.do_progress(\n          new Uint32Array(handles)\n        );\n\n        if (doProgressResult === \"AnyCompleted\") {\n          // Next recursion will cause the promise to do some progress\n        } else if (doProgressResult === \"ReadFromInput\") {\n          // Read from input\n          await this.inputPump.awaitNextProgress();\n        } else if (doProgressResult === \"WaitingPendingRun\") {\n          // Wait for any of the pending run to complete\n          await this.runClosuresTracker.awaitNextCompletedRun();\n        } else if (doProgressResult === \"CancelSignalReceived\") {\n          restatePromise.tryCancel();\n          return;\n        } else {\n          // We need to execute a run closure\n          this.runClosuresTracker.executeRun(doProgressResult.ExecuteRun);\n          // Let the run context switch, then come back to this flow.\n          await setImmediate();\n        }\n\n        // Recursion\n        await this.doProgressInner(restatePromise);\n      } catch (e) {\n        // Not good, this is a retryable error.\n        this.errorCallback(e);\n      }\n    });\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"promises.js","names":["handle: number","completer: (\n      value: AsyncResultValue,\n      prom: CompletablePromise<T>\n    ) => Promise<void>","invocationIdPromise: Promise<InvocationId>","childs: Array<InternalRestatePromise<any>>","castedPromises: InternalRestatePromise<any>[]","foundContext: ContextImpl | undefined","inner: InternalRestatePromise<T>","constPromise: Promise<T>","settled: boolean","coreVm: vm.WasmVM","inputPump: InputPump","outputPump: OutputPump","runClosuresTracker: RunClosuresTracker","errorCallback: (e: any) => void"],"sources":["../src/promises.ts"],"sourcesContent":["/*\n * Copyright (c) 2023-2025 - Restate Software, Inc., Restate GmbH\n *\n * This file is part of the Restate SDK for Node.js/TypeScript,\n * which is released under the MIT license.\n *\n * You can find a copy of the license in file LICENSE in the root\n * directory of this repository or package, or at\n * https://github.com/restatedev/sdk-typescript/blob/main/LICENSE\n */\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\nimport type {\n  RestatePromise,\n  InvocationId,\n  InvocationPromise,\n} from \"./context.js\";\nimport type * as vm from \"./endpoint/handlers/vm/sdk_shared_core_wasm_bindings.js\";\nimport {\n  CancelledError,\n  RestateError,\n  TerminalError,\n  TimeoutError,\n} from \"./types/errors.js\";\nimport { CompletablePromise } from \"./utils/completable_promise.js\";\nimport type { ContextImpl, RunClosuresTracker } from \"./context_impl.js\";\nimport { setImmediate } from \"node:timers/promises\";\nimport type { InputPump, OutputPump } from \"./io.js\";\nimport type { Duration } from \"@restatedev/restate-sdk-core\";\n\n// A promise that is never completed\nexport function pendingPromise<T>(): Promise<T> {\n  return new Promise<T>(() => {});\n}\n\n// ------ Restate promises ------\n// These promises are \"proxy promises\" that will be handed over to the user,\n// and moved forward by the PromiseExecutor below when the user awaits on them.\n\n/**\n * Returns `true` if the given value is a {@link RestatePromise}.\n *\n * Use this for runtime type detection when you need to distinguish Restate promises\n * from regular promises, e.g. for overload resolution.\n */\nexport function isRestatePromise<T>(p: Promise<T>): p is RestatePromise<T> {\n  return p instanceof InternalRestatePromise;\n}\n\nenum PromiseState {\n  COMPLETED,\n  NOT_COMPLETED,\n}\n\nexport abstract class InternalRestatePromise<T> implements RestatePromise<T> {\n  abstract then<TResult1, TResult2>(\n    onfulfilled:\n      | ((value: T) => PromiseLike<TResult1> | TResult1)\n      | undefined\n      | null,\n    onrejected:\n      | ((reason: any) => PromiseLike<TResult2> | TResult2)\n      | undefined\n      | null\n  ): Promise<TResult1 | TResult2>;\n  abstract catch<TResult>(\n    onrejected:\n      | ((reason: any) => PromiseLike<TResult> | TResult)\n      | undefined\n      | null\n  ): Promise<T | TResult>;\n  abstract finally(onfinally: (() => void) | undefined | null): Promise<T>;\n\n  abstract map<U>(\n    mapper: (value?: T, failure?: TerminalError) => U\n  ): RestatePromise<U>;\n  abstract orTimeout(millis: Duration | number): RestatePromise<T>;\n\n  abstract tryCancel(): void;\n  abstract tryComplete(): Promise<void>;\n  abstract uncompletedLeaves(): Array<number>;\n  abstract publicPromise(): Promise<T>;\n\n  abstract readonly [Symbol.toStringTag]: string;\n}\n\nexport type AsyncResultValue =\n  | \"Empty\"\n  | { Success: Uint8Array }\n  | { Failure: vm.WasmFailure }\n  | { StateKeys: string[] }\n  | { InvocationId: string };\n\nconst RESTATE_CTX_SYMBOL = Symbol(\"restateContext\");\n\nfunction extractContext(n: any): ContextImpl | undefined {\n  // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n  return n[RESTATE_CTX_SYMBOL] as ContextImpl | undefined;\n}\n\nabstract class BaseRestatePromise<T> extends InternalRestatePromise<T> {\n  [RESTATE_CTX_SYMBOL]: ContextImpl;\n  private pollingPromise?: Promise<any>;\n  private cancelPromise: CompletablePromise<any> = new CompletablePromise();\n\n  protected constructor(ctx: ContextImpl) {\n    super();\n    this[RESTATE_CTX_SYMBOL] = ctx;\n  }\n\n  // --- Promise methods\n\n  then<TResult1 = T, TResult2 = never>(\n    onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null,\n    onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null\n  ): Promise<TResult1 | TResult2> {\n    this.pollingPromise =\n      this.pollingPromise ||\n      this[RESTATE_CTX_SYMBOL].promisesExecutor\n        .doProgress(this)\n        .catch(() => {});\n    return this.publicPromiseOrCancelPromise().then(onfulfilled, onrejected);\n  }\n\n  catch<TResult = never>(\n    onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | null\n  ): Promise<T | TResult> {\n    this.pollingPromise =\n      this.pollingPromise ||\n      this[RESTATE_CTX_SYMBOL].promisesExecutor\n        .doProgress(this)\n        .catch(() => {});\n    return this.publicPromiseOrCancelPromise().catch(onrejected);\n  }\n\n  finally(onfinally?: (() => void) | null): Promise<T> {\n    this.pollingPromise =\n      this.pollingPromise ||\n      this[RESTATE_CTX_SYMBOL].promisesExecutor\n        .doProgress(this)\n        .catch(() => {});\n    return this.publicPromiseOrCancelPromise().finally(onfinally);\n  }\n\n  private publicPromiseOrCancelPromise(): Promise<T> {\n    return Promise.race([\n      this.cancelPromise.promise as Promise<T>,\n      this.publicPromise(),\n    ]);\n  }\n\n  // --- RestatePromise methods\n\n  orTimeout(duration: number | Duration): RestatePromise<T> {\n    return new CombinatorRestatePromise(\n      this[RESTATE_CTX_SYMBOL],\n      ([thisPromise, sleepPromise]) => {\n        return new Promise((resolve, reject) => {\n          thisPromise!.then(resolve, reject);\n          sleepPromise!.then(() => {\n            reject(new TimeoutError());\n          }, reject);\n        });\n      },\n      [\n        this,\n        this[RESTATE_CTX_SYMBOL].sleep(duration) as InternalRestatePromise<any>,\n      ]\n    ) as RestatePromise<T>;\n  }\n\n  map<U>(mapper: (value?: T, failure?: TerminalError) => U): RestatePromise<U> {\n    return new MappedRestatePromise(this[RESTATE_CTX_SYMBOL], this, mapper);\n  }\n\n  tryCancel() {\n    this.cancelPromise.reject(new CancelledError());\n  }\n\n  abstract override tryComplete(): Promise<void>;\n\n  abstract override uncompletedLeaves(): Array<number>;\n\n  abstract override publicPromise(): Promise<T>;\n\n  abstract override [Symbol.toStringTag]: string;\n}\n\nexport class SingleRestatePromise<T> extends BaseRestatePromise<T> {\n  private state: PromiseState = PromiseState.NOT_COMPLETED;\n  private completablePromise: CompletablePromise<T> = new CompletablePromise();\n\n  constructor(\n    ctx: ContextImpl,\n    readonly handle: number,\n    private readonly completer: (\n      value: AsyncResultValue,\n      prom: CompletablePromise<T>\n    ) => Promise<void>\n  ) {\n    super(ctx);\n  }\n\n  uncompletedLeaves(): number[] {\n    return this.state === PromiseState.COMPLETED ? [] : [this.handle];\n  }\n\n  async tryComplete(): Promise<void> {\n    if (this.state === PromiseState.COMPLETED) {\n      return;\n    }\n    const notification = this[RESTATE_CTX_SYMBOL].coreVm.take_notification(\n      this.handle\n    );\n    if (notification === \"NotReady\") {\n      return;\n    }\n    this.state = PromiseState.COMPLETED;\n    await this.completer(notification, this.completablePromise);\n  }\n\n  publicPromise(): Promise<T> {\n    return this.completablePromise.promise;\n  }\n\n  isCompleted(): boolean {\n    return this.state === PromiseState.COMPLETED;\n  }\n\n  readonly [Symbol.toStringTag] = \"RestateSinglePromise\";\n}\n\nexport class InvocationRestatePromise<T>\n  extends SingleRestatePromise<T>\n  implements InvocationPromise<T>\n{\n  constructor(\n    ctx: ContextImpl,\n    handle: number,\n    completer: (\n      value: AsyncResultValue,\n      prom: CompletablePromise<T>\n    ) => Promise<void>,\n    private readonly invocationIdPromise: Promise<InvocationId>\n  ) {\n    super(ctx, handle, completer);\n  }\n\n  get invocationId(): Promise<InvocationId> {\n    return this.invocationIdPromise;\n  }\n}\n\nexport class CombinatorRestatePromise extends BaseRestatePromise<any> {\n  private state: PromiseState = PromiseState.NOT_COMPLETED;\n  private readonly combinatorPromise: Promise<any>;\n\n  constructor(\n    ctx: ContextImpl,\n    combinatorConstructor: (promises: Promise<any>[]) => Promise<any>,\n    readonly childs: Array<InternalRestatePromise<any>>\n  ) {\n    super(ctx);\n    this.combinatorPromise = combinatorConstructor(\n      childs.map((p) => p.publicPromise())\n    ).finally(() => {\n      this.state = PromiseState.COMPLETED;\n    });\n  }\n\n  // Used by static methods of RestatePromise\n  public static fromPromises<T extends readonly RestatePromise<unknown>[]>(\n    combinatorConstructor: (promises: Promise<any>[]) => Promise<any>,\n    promises: T\n  ): RestatePromise<unknown> {\n    const castedPromises: InternalRestatePromise<any>[] = [];\n    let foundContext: ContextImpl | undefined = undefined;\n\n    for (const [idx, promise] of promises.entries()) {\n      if (!isRestatePromise(promise)) {\n        throw new Error(\n          `Promise index ${idx} used inside the combinator is not an instance of RestatePromise. This is not supported.`\n        );\n      } else if (foundContext === undefined) {\n        foundContext = extractContext(promise);\n      } else {\n        const thisContext = extractContext(promise);\n        if (thisContext !== undefined && thisContext !== foundContext) {\n          throw new Error(\n            \"You're mixing up RestatePromises from different RestateContext. This is not supported.\"\n          );\n        }\n      }\n      castedPromises.push(promise as InternalRestatePromise<any>);\n    }\n\n    if (foundContext === undefined) {\n      // The only situation where this can happen is when the combined promise contains only ConstRestatePromise as children.\n      // In this case, just return back a nice and clean ConstRestatePromise.\n      // There is a specific workaround for the funky interface of Promise.race, inside the RestatePromise.race factory method.\n      return ConstRestatePromise.fromPromise(\n        combinatorConstructor(castedPromises),\n        true\n      );\n    }\n\n    return new CombinatorRestatePromise(\n      foundContext,\n      combinatorConstructor,\n      castedPromises\n    );\n  }\n\n  uncompletedLeaves(): number[] {\n    return this.state === PromiseState.COMPLETED\n      ? []\n      : this.childs.flatMap((p) => p.uncompletedLeaves());\n  }\n\n  async tryComplete(): Promise<void> {\n    await Promise.allSettled(this.childs.map((c) => c.tryComplete()));\n  }\n\n  publicPromise(): Promise<unknown> {\n    return this.combinatorPromise;\n  }\n\n  readonly [Symbol.toStringTag] = \"RestateCombinatorPromise\";\n}\n\nexport class MappedRestatePromise<T, U> extends BaseRestatePromise<U> {\n  private publicPromiseMapper: (\n    value?: T,\n    failure?: TerminalError\n  ) => Promise<U>;\n\n  constructor(\n    ctx: ContextImpl,\n    readonly inner: InternalRestatePromise<T>,\n    mapper: (value?: T, failure?: TerminalError) => U\n  ) {\n    super(ctx);\n    this.publicPromiseMapper = (value?: T, failure?: TerminalError) => {\n      try {\n        return Promise.resolve(mapper(value, failure));\n      } catch (e) {\n        if (e instanceof TerminalError) {\n          return Promise.reject(e);\n        } else {\n          ctx.abortAttempt(e);\n          return pendingPromise();\n        }\n      }\n    };\n  }\n\n  async tryComplete(): Promise<void> {\n    await this.inner.tryComplete();\n  }\n\n  uncompletedLeaves(): number[] {\n    return this.inner.uncompletedLeaves();\n  }\n\n  publicPromise(): Promise<U> {\n    const promiseMapper = this.publicPromiseMapper;\n    return this.inner.publicPromise().then(\n      (t) => promiseMapper(t, undefined),\n      (error) => {\n        if (error instanceof RestateError) {\n          return promiseMapper(undefined, error);\n        } else {\n          // Something else, just re-throw it\n          throw error;\n        }\n      }\n    );\n  }\n\n  readonly [Symbol.toStringTag] = \"RestateMappedPromise\";\n}\n\nexport class ConstRestatePromise<T> extends InternalRestatePromise<T> {\n  private constructor(\n    private readonly constPromise: Promise<T>,\n    private readonly settled: boolean\n  ) {\n    super();\n  }\n\n  static resolve<T>(value: T): ConstRestatePromise<Awaited<T>> {\n    return new ConstRestatePromise(Promise.resolve(value), true);\n  }\n\n  static reject<T = never>(reason: TerminalError): ConstRestatePromise<T> {\n    return new ConstRestatePromise<T>(Promise.reject(reason), true);\n  }\n\n  static pending<T>(): ConstRestatePromise<T> {\n    return new ConstRestatePromise<T>(pendingPromise(), false);\n  }\n\n  static fromPromise<T>(\n    promise: Promise<T>,\n    settled: boolean\n  ): ConstRestatePromise<T> {\n    return new ConstRestatePromise(promise, settled);\n  }\n\n  // --- Promise methods\n\n  then<TResult1 = T, TResult2 = never>(\n    onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null,\n    onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null\n  ): Promise<TResult1 | TResult2> {\n    return this.constPromise.then(onfulfilled, onrejected);\n  }\n\n  catch<TResult = never>(\n    onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | null\n  ): Promise<T | TResult> {\n    return this.constPromise.catch(onrejected);\n  }\n\n  finally(onfinally?: (() => void) | null): Promise<T> {\n    return this.constPromise.finally(onfinally);\n  }\n\n  // --- RestatePromise methods\n\n  orTimeout(): RestatePromise<T> {\n    if (this.settled) return this;\n    return ConstRestatePromise.reject(new TimeoutError());\n  }\n\n  map<U>(mapper: (value?: T, failure?: TerminalError) => U): RestatePromise<U> {\n    return ConstRestatePromise.fromPromise(\n      this.constPromise.then(\n        (value) => mapper(value, undefined),\n        (reason) => mapper(undefined, reason as TerminalError)\n      ),\n      this.settled\n    );\n  }\n\n  tryCancel() {}\n\n  publicPromise(): Promise<T> {\n    return this.constPromise;\n  }\n\n  tryComplete(): Promise<void> {\n    return Promise.resolve();\n  }\n\n  uncompletedLeaves(): Array<number> {\n    return [];\n  }\n\n  readonly [Symbol.toStringTag] = \"ConstRestatePromise\";\n}\n\n/**\n * Promises executor, gluing VM with I/O and Promises given to user space.\n */\nexport class PromisesExecutor {\n  constructor(\n    private readonly coreVm: vm.WasmVM,\n    private readonly inputPump: InputPump,\n    private readonly outputPump: OutputPump,\n    private readonly runClosuresTracker: RunClosuresTracker,\n    private readonly errorCallback: (e: any) => void\n  ) {}\n\n  async doProgress(restatePromise: InternalRestatePromise<unknown>) {\n    // Only the first time try process output\n    await this.outputPump.awaitNextProgress();\n    await this.doProgressInner(restatePromise);\n  }\n\n  private async doProgressInner(\n    restatePromise: InternalRestatePromise<unknown>\n  ) {\n    // Try complete the promise\n    try {\n      await restatePromise.tryComplete();\n    } catch (e) {\n      // This can happen if either take_notification throws an exception or completer throws an exception.\n      // This could either happen for a deserialization issue, or for an SDK bug, but we cover them here.\n      this.errorCallback(e);\n      return Promise.resolve();\n    }\n\n    // tl;dr don't touch this, or you can break combineable promises,\n    // slinkydeveloper won't be happy about it\n    //\n    // The reason for this setTimeout is that we need to enqueue the polling after\n    // we eventually resolve some promises. This is especially crucial for RestateCombinatorPromise\n    // as it flips the completed state using .finally() on the combinator.\n    return setImmediate().then(async () => {\n      try {\n        // Invoke do progress on the vm\n        const handles = restatePromise.uncompletedLeaves();\n        if (handles.length === 0) {\n          // Completed, we're good!\n          return;\n        }\n        const doProgressResult = this.coreVm.do_progress(\n          new Uint32Array(handles)\n        );\n\n        if (doProgressResult === \"AnyCompleted\") {\n          // Next recursion will cause the promise to do some progress\n        } else if (doProgressResult === \"ReadFromInput\") {\n          // Read from input\n          await this.inputPump.awaitNextProgress();\n        } else if (doProgressResult === \"WaitingPendingRun\") {\n          // Wait for any of the pending run to complete\n          await this.runClosuresTracker.awaitNextCompletedRun();\n        } else if (doProgressResult === \"CancelSignalReceived\") {\n          restatePromise.tryCancel();\n          return;\n        } else {\n          // We need to execute a run closure\n          this.runClosuresTracker.executeRun(doProgressResult.ExecuteRun);\n          // Let the run context switch, then come back to this flow.\n          await setImmediate();\n        }\n\n        // Recursion\n        await this.doProgressInner(restatePromise);\n      } catch (e) {\n        // Not good, this is a retryable error.\n        this.errorCallback(e);\n      }\n    });\n  }\n}\n"],"mappings":"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"}

package/dist/types/errors.cjs

@@ -99,6 +99,18 @@ var RetryableError = class RetryableError extends RestateError {
 		});
 	}
 };
+/**
+* Returns true if the error indicates the current attempt is ending without
+* a failure — e.g. the runtime suspended the invocation (waiting for
+* `ctx.sleep()` or `ctx.call()`), or the connection was dropped (kill).
+*
+* Use this in handler interceptor catch blocks to distinguish attempt-ending
+* signals from real errors (e.g. to avoid logging it as a failure or to set
+* a neutral span status).
+*/
+function isSuspendedError(e) {
+	return e instanceof RestateError && e.code === SUSPENDED_ERROR_CODE;
+}
 
 //#endregion
 exports.CancelledError = CancelledError;
@@ -109,4 +121,5 @@ exports.TerminalError = TerminalError;
 exports.TimeoutError = TimeoutError;
 exports.UNKNOWN_ERROR_CODE = UNKNOWN_ERROR_CODE;
 exports.ensureError = ensureError;
+exports.isSuspendedError = isSuspendedError;
 exports.logError = logError;

package/dist/types/errors.d.cts

@@ -23,10 +23,6 @@ declare class TerminalError extends RestateError {
      * Error code. This should be an HTTP status code, and in case the service was invoked from the ingress, this will be propagated back to the caller.
      */
     errorCode?: number;
-    /**
-     * @deprecated YOU MUST NOT USE THIS FIELD, AS IT WON'T BE RECORDED AND CAN LEAD TO NON-DETERMINISM! From the next SDK version, the constructor won't accept this field anymore.
-     */
-    cause?: any;
     /**
      * Metadata key-value pairs to attach to the terminal error.
      * These will be recorded together with error message and code.
@@ -74,6 +70,16 @@ declare class RetryableError extends RestateError {
    */
   static from(cause: any, options?: RetryableErrorOptions): RetryableError;
 }
+/**
+ * Returns true if the error indicates the current attempt is ending without
+ * a failure — e.g. the runtime suspended the invocation (waiting for
+ * `ctx.sleep()` or `ctx.call()`), or the connection was dropped (kill).
+ *
+ * Use this in handler interceptor catch blocks to distinguish attempt-ending
+ * signals from real errors (e.g. to avoid logging it as a failure or to set
+ * a neutral span status).
+ */
+declare function isSuspendedError(e: unknown): boolean;
 //#endregion
-export { CancelledError, RestateError, RetryableError, RetryableErrorOptions, TerminalError, TimeoutError };
+export { CancelledError, RestateError, RetryableError, RetryableErrorOptions, TerminalError, TimeoutError, isSuspendedError };
 //# sourceMappingURL=errors.d.cts.map

package/dist/types/errors.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.cts","names":[],"sources":["../../src/types/errors.ts"],"sourcesContent":[],"mappings":";;;;AA4Ha,cA/CA,YAAA,SAAqB,KAAA,CA+Ca;EAWlC,SAAA,IAAA,EAAA,MAAe;EAQX,IAAA,EAAA,MAAA;EAaJ,WAAA,CAAA,OAAe,EAAA,MAAA,EAAA,OAuBQ,CAvBR,EAAA;IAGJ,SAAA,CAAA,EAAA,MAAA;IAIV,KAAA,CAAA,EAAA,GAAA;EAgBsB,CAAA;;;;;;;cAvFvB,aAAA,SAAsB,YAAA;;sBAEN;;;;;;;;;;;;;;;;eAmBZ;;;;;;cAWJ,YAAA,SAAqB,aAAA;;;;;;;cAWrB,cAAA,SAAuB,aAAA;;;;UAQnB,qBAAA;;;;eAIF;;;;;;;;cASF,cAAA,SAAuB,YAAA;;wBAGZ;yCAIV;;;;;;;oCAgBsB,wBAAwB"}
+{"version":3,"file":"errors.d.cts","names":[],"sources":["../../src/types/errors.ts"],"sourcesContent":[],"mappings":";;;;AAwHa,cA3CA,YAAA,SAAqB,KAAA,CA2Ca;EAWlC,SAAA,IAAA,EAAA,MAAe;EAQX,IAAA,EAAA,MAAA;EAaJ,WAAA,CAAA,OAAe,EAAA,MAAA,EAAA,OAuBQ,CAvBR,EAAA;IAGJ,SAAA,CAAA,EAAA,MAAA;IAIV,KAAA,CAAA,EAAA,GAAA;EAgBsB,CAAA;;;;AAmBpC;;;cAtGa,aAAA,SAAsB,YAAA;;sBAEN;;;;;;;;;;;;eAeZ;;;;;;cAWJ,YAAA,SAAqB,aAAA;;;;;;;cAWrB,cAAA,SAAuB,aAAA;;;;UAQnB,qBAAA;;;;eAIF;;;;;;;;cASF,cAAA,SAAuB,YAAA;;wBAGZ;yCAIV;;;;;;;oCAgBsB,wBAAwB;;;;;;;;;;;iBAmB5C,gBAAA"}

package/dist/types/errors.d.ts

@@ -23,10 +23,6 @@ declare class TerminalError extends RestateError {
      * Error code. This should be an HTTP status code, and in case the service was invoked from the ingress, this will be propagated back to the caller.
      */
     errorCode?: number;
-    /**
-     * @deprecated YOU MUST NOT USE THIS FIELD, AS IT WON'T BE RECORDED AND CAN LEAD TO NON-DETERMINISM! From the next SDK version, the constructor won't accept this field anymore.
-     */
-    cause?: any;
     /**
      * Metadata key-value pairs to attach to the terminal error.
      * These will be recorded together with error message and code.
@@ -74,6 +70,16 @@ declare class RetryableError extends RestateError {
    */
   static from(cause: any, options?: RetryableErrorOptions): RetryableError;
 }
+/**
+ * Returns true if the error indicates the current attempt is ending without
+ * a failure — e.g. the runtime suspended the invocation (waiting for
+ * `ctx.sleep()` or `ctx.call()`), or the connection was dropped (kill).
+ *
+ * Use this in handler interceptor catch blocks to distinguish attempt-ending
+ * signals from real errors (e.g. to avoid logging it as a failure or to set
+ * a neutral span status).
+ */
+declare function isSuspendedError(e: unknown): boolean;
 //#endregion
-export { CancelledError, RestateError, RetryableError, RetryableErrorOptions, TerminalError, TimeoutError };
+export { CancelledError, RestateError, RetryableError, RetryableErrorOptions, TerminalError, TimeoutError, isSuspendedError };
 //# sourceMappingURL=errors.d.ts.map

package/dist/types/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","names":[],"sources":["../../src/types/errors.ts"],"sourcesContent":[],"mappings":";;;;AA4Ha,cA/CA,YAAA,SAAqB,KAAA,CA+Ca;EAWlC,SAAA,IAAA,EAAA,MAAe;EAQX,IAAA,EAAA,MAAA;EAaJ,WAAA,CAAA,OAAe,EAAA,MAAA,EAAA,OAuBQ,CAvBR,EAAA;IAGJ,SAAA,CAAA,EAAA,MAAA;IAIV,KAAA,CAAA,EAAA,GAAA;EAgBsB,CAAA;;;;;;;cAvFvB,aAAA,SAAsB,YAAA;;sBAEN;;;;;;;;;;;;;;;;eAmBZ;;;;;;cAWJ,YAAA,SAAqB,aAAA;;;;;;;cAWrB,cAAA,SAAuB,aAAA;;;;UAQnB,qBAAA;;;;eAIF;;;;;;;;cASF,cAAA,SAAuB,YAAA;;wBAGZ;yCAIV;;;;;;;oCAgBsB,wBAAwB"}
+{"version":3,"file":"errors.d.ts","names":[],"sources":["../../src/types/errors.ts"],"sourcesContent":[],"mappings":";;;;AAwHa,cA3CA,YAAA,SAAqB,KAAA,CA2Ca;EAWlC,SAAA,IAAA,EAAA,MAAe;EAQX,IAAA,EAAA,MAAA;EAaJ,WAAA,CAAA,OAAe,EAAA,MAAA,EAAA,OAuBQ,CAvBR,EAAA;IAGJ,SAAA,CAAA,EAAA,MAAA;IAIV,KAAA,CAAA,EAAA,GAAA;EAgBsB,CAAA;;;;AAmBpC;;;cAtGa,aAAA,SAAsB,YAAA;;sBAEN;;;;;;;;;;;;eAeZ;;;;;;cAWJ,YAAA,SAAqB,aAAA;;;;;;;cAWrB,cAAA,SAAuB,aAAA;;;;UAQnB,qBAAA;;;;eAIF;;;;;;;;cASF,cAAA,SAAuB,YAAA;;wBAGZ;yCAIV;;;;;;;oCAgBsB,wBAAwB;;;;;;;;;;;iBAmB5C,gBAAA"}

package/dist/types/errors.js

@@ -98,7 +98,19 @@ var RetryableError = class RetryableError extends RestateError {
 		});
 	}
 };
+/**
+* Returns true if the error indicates the current attempt is ending without
+* a failure — e.g. the runtime suspended the invocation (waiting for
+* `ctx.sleep()` or `ctx.call()`), or the connection was dropped (kill).
+*
+* Use this in handler interceptor catch blocks to distinguish attempt-ending
+* signals from real errors (e.g. to avoid logging it as a failure or to set
+* a neutral span status).
+*/
+function isSuspendedError(e) {
+	return e instanceof RestateError && e.code === SUSPENDED_ERROR_CODE;
+}
 
 //#endregion
-export { CancelledError, INTERNAL_ERROR_CODE, RestateError, RetryableError, TerminalError, TimeoutError, UNKNOWN_ERROR_CODE, ensureError, logError };
+export { CancelledError, INTERNAL_ERROR_CODE, RestateError, RetryableError, TerminalError, TimeoutError, UNKNOWN_ERROR_CODE, ensureError, isSuspendedError, logError };
 //# sourceMappingURL=errors.js.map

package/dist/types/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","names":[],"sources":["../../src/types/errors.ts"],"sourcesContent":["/*\n * Copyright (c) 2023-2024 - Restate Software, Inc., Restate GmbH\n *\n * This file is part of the Restate SDK for Node.js/TypeScript,\n * which is released under the MIT license.\n *\n * You can find a copy of the license in file LICENSE in the root\n * directory of this repository or package, or at\n * https://github.com/restatedev/sdk-typescript/blob/main/LICENSE\n */\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\nimport type { Duration } from \"@restatedev/restate-sdk-core\";\n\nexport const INTERNAL_ERROR_CODE = 500;\nexport const TIMEOUT_ERROR_CODE = 408;\nexport const CANCEL_ERROR_CODE = 409;\nexport const UNKNOWN_ERROR_CODE = 500;\n\n// From shared core!\nexport const CLOSED_ERROR_CODE = 598;\nexport const SUSPENDED_ERROR_CODE = 599;\n\nexport function ensureError(\n  e: unknown,\n  asTerminalError?: (error: any) => TerminalError | undefined\n): Error {\n  if (e instanceof TerminalError) {\n    return e;\n  }\n  // Try convert to terminal error\n  const maybeTerminalError = asTerminalError ? asTerminalError(e) : undefined;\n  if (maybeTerminalError) {\n    return maybeTerminalError;\n  }\n\n  if (e instanceof Error) {\n    return e;\n  }\n  if (typeof e === \"object\" && e !== null && \"code\" in e && \"message\" in e) {\n    // This is an error from the VM\n    return new RestateError(e.message as string, {\n      errorCode: e.code as number,\n    });\n  }\n\n  // None of the types we know\n  let msg;\n  try {\n    msg = JSON.stringify(e);\n  } catch {\n    msg = \"(no JSON representation)\";\n  }\n\n  return new Error(\"Non-Error value: \" + msg);\n}\n\nexport function logError(log: Console, e: unknown) {\n  if (e instanceof RestateError) {\n    if (e.code === SUSPENDED_ERROR_CODE) {\n      log.info(\"Invocation suspended\");\n      return;\n    } else if (e.code === CLOSED_ERROR_CODE) {\n      log.error(\n        \"DANGER! The invocation is closed, but some related operation is still running. \\n\" +\n          \"This might indicate that a RestatePromise is being awaited on an asynchronous task, outside the handler, or you're awaiting a RestatePromise inside a ctx.run.\\n\" +\n          \"This is dangerous, and can lead the service to deadlock. Please fix the issue.\\n\" +\n          \"Diagnostic: \",\n        e\n      );\n      return;\n    }\n  }\n  log.warn(\"Error when processing a Restate context operation.\\n\", e);\n}\n\nexport class RestateError extends Error {\n  public readonly code: number;\n  public override name = \"RestateError\";\n\n  constructor(message: string, options?: { errorCode?: number; cause?: any }) {\n    super(message, { cause: options?.cause });\n    this.code = options?.errorCode ?? INTERNAL_ERROR_CODE;\n  }\n}\n\n/**\n * Does not lead to Restate retries.\n *\n * Leads to an output message with a failure defined.\n */\nexport class TerminalError extends RestateError {\n  public override name = \"TerminalError\";\n  public readonly metadata?: Record<string, string>;\n\n  constructor(\n    message: string,\n    options?: {\n      /**\n       * Error code. This should be an HTTP status code, and in case the service was invoked from the ingress, this will be propagated back to the caller.\n       */\n      errorCode?: number;\n      /**\n       * @deprecated YOU MUST NOT USE THIS FIELD, AS IT WON'T BE RECORDED AND CAN LEAD TO NON-DETERMINISM! From the next SDK version, the constructor won't accept this field anymore.\n       */\n      cause?: any;\n      /**\n       * Metadata key-value pairs to attach to the terminal error.\n       * These will be recorded together with error message and code.\n       *\n       * **Note **: requires Restate 1.6+.\n       */\n      metadata?: Record<string, string>;\n    }\n  ) {\n    super(message, options);\n    this.metadata = options?.metadata ?? {};\n  }\n}\n\n/**\n * Returned by `RestatePromise.withTimeout` when the timeout is reached.\n */\nexport class TimeoutError extends TerminalError {\n  public override name = \"TimeoutError\";\n\n  constructor() {\n    super(\"Timeout occurred\", { errorCode: TIMEOUT_ERROR_CODE });\n  }\n}\n\n/**\n * Returned when the invocation was cancelled.\n */\nexport class CancelledError extends TerminalError {\n  public override name = \"CancelledError\";\n\n  constructor() {\n    super(\"Cancelled\", { errorCode: CANCEL_ERROR_CODE });\n  }\n}\n\nexport interface RetryableErrorOptions {\n  /**\n   * In how long it should retry.\n   */\n  retryAfter?: Duration | number;\n}\n\n/**\n * Error that Restate will retry. By using this error type within a `ctx.run` closure,\n * you can dynamically provide the retry delay specified in {@link RetryableErrorOptions}.\n *\n * You can wrap another error using {@link from}.\n */\nexport class RetryableError extends RestateError {\n  public override name = \"RetryableError\";\n\n  readonly retryAfter?: Duration | number;\n\n  constructor(\n    message: string,\n    options?: RetryableErrorOptions & {\n      errorCode?: number;\n      cause?: any;\n    }\n  ) {\n    super(message, {\n      errorCode: options?.errorCode,\n      // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n      cause: options?.cause,\n    });\n    this.retryAfter = options?.retryAfter;\n  }\n\n  /**\n   * Create a `RetryableError` from the given cause.\n   */\n  static from(cause: any, options?: RetryableErrorOptions): RetryableError {\n    const error = ensureError(cause);\n    return new RetryableError(error.message, {\n      errorCode: error[\"errorCode\" as keyof typeof error] as number,\n      cause: cause,\n      ...options,\n    });\n  }\n}\n"],"mappings":";AAeA,MAAa,sBAAsB;AACnC,MAAa,qBAAqB;AAClC,MAAa,oBAAoB;AACjC,MAAa,qBAAqB;AAGlC,MAAa,oBAAoB;AACjC,MAAa,uBAAuB;AAEpC,SAAgB,YACd,GACA,iBACO;AACP,KAAI,aAAa,cACf,QAAO;CAGT,MAAM,qBAAqB,kBAAkB,gBAAgB,EAAE,GAAG;AAClE,KAAI,mBACF,QAAO;AAGT,KAAI,aAAa,MACf,QAAO;AAET,KAAI,OAAO,MAAM,YAAY,MAAM,QAAQ,UAAU,KAAK,aAAa,EAErE,QAAO,IAAI,aAAa,EAAE,SAAmB,EAC3C,WAAW,EAAE,MACd,CAAC;CAIJ,IAAI;AACJ,KAAI;AACF,QAAM,KAAK,UAAU,EAAE;SACjB;AACN,QAAM;;AAGR,wBAAO,IAAI,MAAM,sBAAsB,IAAI;;AAG7C,SAAgB,SAAS,KAAc,GAAY;AACjD,KAAI,aAAa,cACf;MAAI,EAAE,SAAS,sBAAsB;AACnC,OAAI,KAAK,uBAAuB;AAChC;aACS,EAAE,SAAS,mBAAmB;AACvC,OAAI,MACF,iVAIA,EACD;AACD;;;AAGJ,KAAI,KAAK,wDAAwD,EAAE;;AAGrE,IAAa,eAAb,cAAkC,MAAM;CACtC,AAAgB;CAChB,AAAgB,OAAO;CAEvB,YAAY,SAAiB,SAA+C;AAC1E,QAAM,SAAS,EAAE,OAAO,SAAS,OAAO,CAAC;AACzC,OAAK,OAAO,SAAS,aAAa;;;;;;;;AAStC,IAAa,gBAAb,cAAmC,aAAa;CAC9C,AAAgB,OAAO;CACvB,AAAgB;CAEhB,YACE,SACA,SAiBA;AACA,QAAM,SAAS,QAAQ;AACvB,OAAK,WAAW,SAAS,YAAY,EAAE;;;;;;AAO3C,IAAa,eAAb,cAAkC,cAAc;CAC9C,AAAgB,OAAO;CAEvB,cAAc;AACZ,QAAM,oBAAoB,EAAE,WAAW,oBAAoB,CAAC;;;;;;AAOhE,IAAa,iBAAb,cAAoC,cAAc;CAChD,AAAgB,OAAO;CAEvB,cAAc;AACZ,QAAM,aAAa,EAAE,WAAW,mBAAmB,CAAC;;;;;;;;;AAiBxD,IAAa,iBAAb,MAAa,uBAAuB,aAAa;CAC/C,AAAgB,OAAO;CAEvB,AAAS;CAET,YACE,SACA,SAIA;AACA,QAAM,SAAS;GACb,WAAW,SAAS;GAEpB,OAAO,SAAS;GACjB,CAAC;AACF,OAAK,aAAa,SAAS;;;;;CAM7B,OAAO,KAAK,OAAY,SAAiD;EACvE,MAAM,QAAQ,YAAY,MAAM;AAChC,SAAO,IAAI,eAAe,MAAM,SAAS;GACvC,WAAW,MAAM;GACV;GACP,GAAG;GACJ,CAAC"}
+{"version":3,"file":"errors.js","names":[],"sources":["../../src/types/errors.ts"],"sourcesContent":["/*\n * Copyright (c) 2023-2024 - Restate Software, Inc., Restate GmbH\n *\n * This file is part of the Restate SDK for Node.js/TypeScript,\n * which is released under the MIT license.\n *\n * You can find a copy of the license in file LICENSE in the root\n * directory of this repository or package, or at\n * https://github.com/restatedev/sdk-typescript/blob/main/LICENSE\n */\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\nimport type { Duration } from \"@restatedev/restate-sdk-core\";\n\nexport const INTERNAL_ERROR_CODE = 500;\nexport const TIMEOUT_ERROR_CODE = 408;\nexport const CANCEL_ERROR_CODE = 409;\nexport const UNKNOWN_ERROR_CODE = 500;\n\n// From shared core!\nexport const CLOSED_ERROR_CODE = 598;\nexport const SUSPENDED_ERROR_CODE = 599;\n\nexport function ensureError(\n  e: unknown,\n  asTerminalError?: (error: any) => TerminalError | undefined\n): Error {\n  if (e instanceof TerminalError) {\n    return e;\n  }\n  // Try convert to terminal error\n  const maybeTerminalError = asTerminalError ? asTerminalError(e) : undefined;\n  if (maybeTerminalError) {\n    return maybeTerminalError;\n  }\n\n  if (e instanceof Error) {\n    return e;\n  }\n  if (typeof e === \"object\" && e !== null && \"code\" in e && \"message\" in e) {\n    // This is an error from the VM\n    return new RestateError(e.message as string, {\n      errorCode: e.code as number,\n    });\n  }\n\n  // None of the types we know\n  let msg;\n  try {\n    msg = JSON.stringify(e);\n  } catch {\n    msg = \"(no JSON representation)\";\n  }\n\n  return new Error(\"Non-Error value: \" + msg);\n}\n\nexport function logError(log: Console, e: unknown) {\n  if (e instanceof RestateError) {\n    if (e.code === SUSPENDED_ERROR_CODE) {\n      log.info(\"Invocation suspended\");\n      return;\n    } else if (e.code === CLOSED_ERROR_CODE) {\n      log.error(\n        \"DANGER! The invocation is closed, but some related operation is still running. \\n\" +\n          \"This might indicate that a RestatePromise is being awaited on an asynchronous task, outside the handler, or you're awaiting a RestatePromise inside a ctx.run.\\n\" +\n          \"This is dangerous, and can lead the service to deadlock. Please fix the issue.\\n\" +\n          \"Diagnostic: \",\n        e\n      );\n      return;\n    }\n  }\n  log.warn(\"Error when processing a Restate context operation.\\n\", e);\n}\n\nexport class RestateError extends Error {\n  public readonly code: number;\n  public override name = \"RestateError\";\n\n  constructor(message: string, options?: { errorCode?: number; cause?: any }) {\n    super(message, { cause: options?.cause });\n    this.code = options?.errorCode ?? INTERNAL_ERROR_CODE;\n  }\n}\n\n/**\n * Does not lead to Restate retries.\n *\n * Leads to an output message with a failure defined.\n */\nexport class TerminalError extends RestateError {\n  public override name = \"TerminalError\";\n  public readonly metadata?: Record<string, string>;\n\n  constructor(\n    message: string,\n    options?: {\n      /**\n       * Error code. This should be an HTTP status code, and in case the service was invoked from the ingress, this will be propagated back to the caller.\n       */\n      errorCode?: number;\n      /**\n       * Metadata key-value pairs to attach to the terminal error.\n       * These will be recorded together with error message and code.\n       *\n       * **Note **: requires Restate 1.6+.\n       */\n      metadata?: Record<string, string>;\n    }\n  ) {\n    super(message, options);\n    this.metadata = options?.metadata ?? {};\n  }\n}\n\n/**\n * Returned by `RestatePromise.withTimeout` when the timeout is reached.\n */\nexport class TimeoutError extends TerminalError {\n  public override name = \"TimeoutError\";\n\n  constructor() {\n    super(\"Timeout occurred\", { errorCode: TIMEOUT_ERROR_CODE });\n  }\n}\n\n/**\n * Returned when the invocation was cancelled.\n */\nexport class CancelledError extends TerminalError {\n  public override name = \"CancelledError\";\n\n  constructor() {\n    super(\"Cancelled\", { errorCode: CANCEL_ERROR_CODE });\n  }\n}\n\nexport interface RetryableErrorOptions {\n  /**\n   * In how long it should retry.\n   */\n  retryAfter?: Duration | number;\n}\n\n/**\n * Error that Restate will retry. By using this error type within a `ctx.run` closure,\n * you can dynamically provide the retry delay specified in {@link RetryableErrorOptions}.\n *\n * You can wrap another error using {@link from}.\n */\nexport class RetryableError extends RestateError {\n  public override name = \"RetryableError\";\n\n  readonly retryAfter?: Duration | number;\n\n  constructor(\n    message: string,\n    options?: RetryableErrorOptions & {\n      errorCode?: number;\n      cause?: any;\n    }\n  ) {\n    super(message, {\n      errorCode: options?.errorCode,\n      // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n      cause: options?.cause,\n    });\n    this.retryAfter = options?.retryAfter;\n  }\n\n  /**\n   * Create a `RetryableError` from the given cause.\n   */\n  static from(cause: any, options?: RetryableErrorOptions): RetryableError {\n    const error = ensureError(cause);\n    return new RetryableError(error.message, {\n      errorCode: error[\"errorCode\" as keyof typeof error] as number,\n      cause: cause,\n      ...options,\n    });\n  }\n}\n\n/**\n * Returns true if the error indicates the current attempt is ending without\n * a failure — e.g. the runtime suspended the invocation (waiting for\n * `ctx.sleep()` or `ctx.call()`), or the connection was dropped (kill).\n *\n * Use this in handler interceptor catch blocks to distinguish attempt-ending\n * signals from real errors (e.g. to avoid logging it as a failure or to set\n * a neutral span status).\n */\nexport function isSuspendedError(e: unknown): boolean {\n  return e instanceof RestateError && e.code === SUSPENDED_ERROR_CODE;\n}\n"],"mappings":";AAeA,MAAa,sBAAsB;AACnC,MAAa,qBAAqB;AAClC,MAAa,oBAAoB;AACjC,MAAa,qBAAqB;AAGlC,MAAa,oBAAoB;AACjC,MAAa,uBAAuB;AAEpC,SAAgB,YACd,GACA,iBACO;AACP,KAAI,aAAa,cACf,QAAO;CAGT,MAAM,qBAAqB,kBAAkB,gBAAgB,EAAE,GAAG;AAClE,KAAI,mBACF,QAAO;AAGT,KAAI,aAAa,MACf,QAAO;AAET,KAAI,OAAO,MAAM,YAAY,MAAM,QAAQ,UAAU,KAAK,aAAa,EAErE,QAAO,IAAI,aAAa,EAAE,SAAmB,EAC3C,WAAW,EAAE,MACd,CAAC;CAIJ,IAAI;AACJ,KAAI;AACF,QAAM,KAAK,UAAU,EAAE;SACjB;AACN,QAAM;;AAGR,wBAAO,IAAI,MAAM,sBAAsB,IAAI;;AAG7C,SAAgB,SAAS,KAAc,GAAY;AACjD,KAAI,aAAa,cACf;MAAI,EAAE,SAAS,sBAAsB;AACnC,OAAI,KAAK,uBAAuB;AAChC;aACS,EAAE,SAAS,mBAAmB;AACvC,OAAI,MACF,iVAIA,EACD;AACD;;;AAGJ,KAAI,KAAK,wDAAwD,EAAE;;AAGrE,IAAa,eAAb,cAAkC,MAAM;CACtC,AAAgB;CAChB,AAAgB,OAAO;CAEvB,YAAY,SAAiB,SAA+C;AAC1E,QAAM,SAAS,EAAE,OAAO,SAAS,OAAO,CAAC;AACzC,OAAK,OAAO,SAAS,aAAa;;;;;;;;AAStC,IAAa,gBAAb,cAAmC,aAAa;CAC9C,AAAgB,OAAO;CACvB,AAAgB;CAEhB,YACE,SACA,SAaA;AACA,QAAM,SAAS,QAAQ;AACvB,OAAK,WAAW,SAAS,YAAY,EAAE;;;;;;AAO3C,IAAa,eAAb,cAAkC,cAAc;CAC9C,AAAgB,OAAO;CAEvB,cAAc;AACZ,QAAM,oBAAoB,EAAE,WAAW,oBAAoB,CAAC;;;;;;AAOhE,IAAa,iBAAb,cAAoC,cAAc;CAChD,AAAgB,OAAO;CAEvB,cAAc;AACZ,QAAM,aAAa,EAAE,WAAW,mBAAmB,CAAC;;;;;;;;;AAiBxD,IAAa,iBAAb,MAAa,uBAAuB,aAAa;CAC/C,AAAgB,OAAO;CAEvB,AAAS;CAET,YACE,SACA,SAIA;AACA,QAAM,SAAS;GACb,WAAW,SAAS;GAEpB,OAAO,SAAS;GACjB,CAAC;AACF,OAAK,aAAa,SAAS;;;;;CAM7B,OAAO,KAAK,OAAY,SAAiD;EACvE,MAAM,QAAQ,YAAY,MAAM;AAChC,SAAO,IAAI,eAAe,MAAM,SAAS;GACvC,WAAW,MAAM;GACV;GACP,GAAG;GACJ,CAAC;;;;;;;;;;;;AAaN,SAAgB,iBAAiB,GAAqB;AACpD,QAAO,aAAa,gBAAgB,EAAE,SAAS"}

package/dist/types/rpc.cjs

@@ -77,13 +77,13 @@ const makeRpcCallProxy = (genericCall, defaultSerde, service$1, key) => {
 		};
 	} });
 };
-const makeRpcSendProxy = (genericSend, defaultSerde, service$1, key, legacyDelay) => {
+const makeRpcSendProxy = (genericSend, defaultSerde, service$1, key) => {
 	return new Proxy({}, { get: (_target, prop) => {
 		const method = prop;
 		return (...args) => {
 			const { parameter, opts } = optsFromArgs(args);
 			const requestSerde = opts?.input ?? defaultSerde;
-			const delay = legacyDelay ?? opts?.delay;
+			const delay = opts?.delay;
 			return genericSend({
 				service: service$1,
 				method,
@@ -111,27 +111,15 @@ var HandlerWrapper = class HandlerWrapper {
 		const handlerCopy = function(...args) {
 			return handler.apply(this, args);
 		};
-		return new HandlerWrapper(kind, handlerCopy, opts?.input, opts?.output, opts?.accept, opts?.description, opts?.metadata, opts?.idempotencyRetention, opts?.journalRetention, opts?.inactivityTimeout, opts?.abortTimeout, opts?.ingressPrivate, opts !== void 0 && "enableLazyState" in opts ? opts?.enableLazyState : void 0, opts?.retryPolicy);
+		return new HandlerWrapper(kind, handlerCopy, opts);
 	}
 	static fromHandler(handler) {
 		return handler[HANDLER_SYMBOL];
 	}
-	constructor(kind, handler, inputSerde, outputSerde, accept, description, metadata, idempotencyRetention, journalRetention, inactivityTimeout, abortTimeout, ingressPrivate, enableLazyState, retryPolicy, asTerminalError) {
+	constructor(kind, handler, options) {
 		this.kind = kind;
 		this.handler = handler;
-		this.inputSerde = inputSerde;
-		this.outputSerde = outputSerde;
-		this.accept = accept;
-		this.description = description;
-		this.metadata = metadata;
-		this.idempotencyRetention = idempotencyRetention;
-		this.journalRetention = journalRetention;
-		this.inactivityTimeout = inactivityTimeout;
-		this.abortTimeout = abortTimeout;
-		this.ingressPrivate = ingressPrivate;
-		this.enableLazyState = enableLazyState;
-		this.retryPolicy = retryPolicy;
-		this.asTerminalError = asTerminalError;
+		this.options = options;
 	}
 	bindInstance(t) {
 		this.handler = this.handler.bind(t);
@@ -139,12 +127,12 @@ var HandlerWrapper = class HandlerWrapper {
 	async invoke(context, input) {
 		let req;
 		try {
-			req = (this.inputSerde ?? context.defaultSerde).deserialize(input);
+			req = (this.options?.input ?? context.defaultSerde).deserialize(input);
 		} catch (e) {
 			throw new require_errors.TerminalError(`Failed to deserialize input: ${require_errors.ensureError(e).message}`, { errorCode: 400 });
 		}
 		const res = await this.handler(context, req);
-		return (this.outputSerde ?? context.defaultSerde).serialize(res);
+		return (this.options?.output ?? context.defaultSerde).serialize(res);
 	}
 	/**
 	* Instead of a HandlerWrapper with a handler property,