@restatedev/restate-sdk 0.7.3-worker → 0.8.1

package/dist/types/router.d.ts

@@ -1,14 +1,14 @@
-import { RpcContext } from "../restate_context";
-import { Event } from "../types/types";
+import { CombineablePromise, Context, KeyedContext } from "../context";
+import { Event } from "./types";
 type WithKeyArgument<F> = F extends () => infer R ? (key: string) => R : F;
-type WithoutRpcContext<F> = F extends (ctx: RpcContext, ...args: infer P) => infer R ? (...args: P) => R : never;
+type WithoutRpcContext<F> = F extends (ctx: infer C extends Context, ...args: infer P) => infer R ? (...args: P) => R : never;
 export type Client<M> = {
-    [K in keyof M as M[K] extends never ? never : K]: M[K];
+    [K in keyof M as M[K] extends never ? never : K]: M[K] extends (...args: infer P) => PromiseLike<infer O> ? (...args: P) => CombineablePromise<O> : never;
 };
 export type SendClient<M> = {
     [K in keyof M as M[K] extends never ? never : K]: M[K] extends (...args: infer P) => any ? (...args: P) => void : never;
 };
-export type UnKeyedHandler<F> = F extends (ctx: RpcContext) => Promise<any> ? F : F extends (ctx: RpcContext, input: any) => Promise<any> ? F : never;
+export type UnKeyedHandler<F> = F extends (ctx: Context) => Promise<any> ? F : F extends (ctx: Context, input: any) => Promise<any> ? F : never;
 export type UnKeyedRouterOpts<U> = {
     [K in keyof U]: U[K] extends UnKeyedHandler<any> ? U[K] : never;
 };
@@ -16,7 +16,7 @@ export type UnKeyedRouter<U> = {
     [K in keyof U]: U[K] extends UnKeyedHandler<infer F> ? WithoutRpcContext<F> : never;
 };
 export declare const router: <M>(opts: UnKeyedRouterOpts<M>) => UnKeyedRouter<M>;
-export type KeyedHandler<F> = F extends (ctx: RpcContext) => Promise<any> ? F : F extends (ctx: RpcContext, key: string, value: any) => Promise<any> ? F : never;
+export type KeyedHandler<F> = F extends (ctx: KeyedContext) => Promise<any> ? F : F extends (ctx: KeyedContext, key: string, value: any) => Promise<any> ? F : never;
 export type KeyedRouterOpts<U> = {
     [K in keyof U]: U[K] extends KeyedHandler<U[K]> | KeyedEventHandler<U[K]> ? U[K] : never;
 };
@@ -24,10 +24,10 @@ export type KeyedRouter<U> = {
     [K in keyof U]: U[K] extends KeyedEventHandler<U[K]> ? never : U[K] extends KeyedHandler<infer F> ? WithKeyArgument<WithoutRpcContext<F>> : never;
 };
 export declare const keyedRouter: <M>(opts: KeyedRouterOpts<M>) => KeyedRouter<M>;
-export type KeyedEventHandler<U> = U extends () => Promise<void> ? never : U extends (ctx: RpcContext) => Promise<void> ? never : U extends (ctx: RpcContext, event: Event) => Promise<void> ? U : never;
+export type KeyedEventHandler<U> = U extends () => Promise<void> ? never : U extends (ctx: KeyedContext) => Promise<void> ? never : U extends (ctx: KeyedContext, event: Event) => Promise<void> ? U : never;
 export declare const keyedEventHandler: <H>(handler: KeyedEventHandler<H>) => H;
 export declare const isEventHandler: (handler: any) => handler is {
-    handler: (ctx: RpcContext, event: Event) => Promise<void>;
+    handler: (ctx: KeyedContext, event: Event) => Promise<void>;
 };
 export {};
 //# sourceMappingURL=router.d.ts.map

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

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

package/dist/types/router.js

@@ -0,0 +1,36 @@
+"use strict";
+/*
+ * Copyright (c) 2023-2024 - Restate Software, Inc., Restate GmbH
+ *
+ * This file is part of the Restate SDK for Node.js/TypeScript,
+ * which is released under the MIT license.
+ *
+ * You can find a copy of the license in file LICENSE in the root
+ * directory of this repository or package, or at
+ * https://github.com/restatedev/sdk-typescript/blob/main/LICENSE
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isEventHandler = exports.keyedEventHandler = exports.keyedRouter = exports.router = void 0;
+const router = (opts) => {
+    if (opts === undefined || opts === null) {
+        throw new Error("router must be defined");
+    }
+    return opts;
+};
+exports.router = router;
+const keyedRouter = (opts) => {
+    if (opts === undefined || opts === null) {
+        throw new Error("router must be defined");
+    }
+    return opts;
+};
+exports.keyedRouter = keyedRouter;
+const keyedEventHandler = (handler) => {
+    return { eventHandler: true, handler: handler };
+};
+exports.keyedEventHandler = keyedEventHandler;
+const isEventHandler = (handler) => {
+    return typeof handler === "object" && handler["eventHandler"];
+};
+exports.isEventHandler = isEventHandler;
+//# sourceMappingURL=router.js.map

package/dist/types/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/types/router.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAoDI,MAAM,MAAM,GAAG,CAAI,IAA0B,EAAoB,EAAE;IACxE,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,EAAE;QACvC,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;KAC3C;IACD,OAAO,IAAwB,CAAC;AAClC,CAAC,CAAC;AALW,QAAA,MAAM,UAKjB;AAwBK,MAAM,WAAW,GAAG,CAAI,IAAwB,EAAkB,EAAE;IACzE,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,EAAE;QACvC,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;KAC3C;IACD,OAAO,IAAsB,CAAC;AAChC,CAAC,CAAC;AALW,QAAA,WAAW,eAKtB;AAYK,MAAM,iBAAiB,GAAG,CAAI,OAA6B,EAAK,EAAE;IACvE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAO,CAAC;AACvD,CAAC,CAAC;AAFW,QAAA,iBAAiB,qBAE5B;AAEK,MAAM,cAAc,GAAG,CAC5B,OAAY,EAGZ,EAAE;IACF,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;AAChE,CAAC,CAAC;AANW,QAAA,cAAc,kBAMzB"}

package/dist/types/types.d.ts

@@ -7,6 +7,7 @@ export declare class Message {
     readonly protocolVersion?: number | undefined;
     readonly requiresAck?: boolean | undefined;
     constructor(messageType: bigint, message: ProtocolMessage, completed?: boolean | undefined, protocolVersion?: number | undefined, requiresAck?: boolean | undefined);
+    toJSON(): unknown;
 }
 export declare class Header {
     readonly messageType: bigint;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types/types.ts"],"names":[],"mappings":";AAWA,OAAO,EAaL,eAAe,EAMhB,MAAM,YAAY,CAAC;AAEpB,qBAAa,OAAO;IAEhB,QAAQ,CAAC,WAAW,EAAE,MAAM;IAC5B,QAAQ,CAAC,OAAO,EAAE,eAAe;IACjC,QAAQ,CAAC,SAAS,CAAC;IACnB,QAAQ,CAAC,eAAe,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC;gBAJZ,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,eAAe,EACxB,SAAS,CAAC,qBAAS,EACnB,eAAe,CAAC,oBAAQ,EACxB,WAAW,CAAC,qBAAS;CAEjC;AA2CD,qBAAa,MAAM;IAEf,QAAQ,CAAC,WAAW,EAAE,MAAM;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM;IAC5B,QAAQ,CAAC,aAAa,CAAC;IACvB,QAAQ,CAAC,eAAe,CAAC;IACzB,QAAQ,CAAC,eAAe,CAAC;IACzB,QAAQ,CAAC,gBAAgB,CAAC;gBALjB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,aAAa,CAAC,qBAAS,EACvB,eAAe,CAAC,oBAAQ,EACxB,eAAe,CAAC,qBAAS,EACzB,gBAAgB,CAAC,qBAAS;WAGvB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IA4BvC,OAAO,IAAI,MAAM;CAazB;AAED,qBAAa,KAAK;IAEd,QAAQ,CAAC,GAAG,EAAE,MAAM;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;gBAFlC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAGtC,IAAI,CAAC,CAAC,KAAK,CAAC;IAIZ,IAAI,IAAI,UAAU;CAG1B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types/types.ts"],"names":[],"mappings":";AAWA,OAAO,EAWL,eAAe,EAIhB,MAAM,YAAY,CAAC;AAEpB,qBAAa,OAAO;IAEhB,QAAQ,CAAC,WAAW,EAAE,MAAM;IAC5B,QAAQ,CAAC,OAAO,EAAE,eAAe;IACjC,QAAQ,CAAC,SAAS,CAAC;IACnB,QAAQ,CAAC,eAAe,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC;gBAJZ,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,eAAe,EACxB,SAAS,CAAC,qBAAS,EACnB,eAAe,CAAC,oBAAQ,EACxB,WAAW,CAAC,qBAAS;IAIhC,MAAM,IAAI,OAAO;CAUlB;AA4CD,qBAAa,MAAM;IAEf,QAAQ,CAAC,WAAW,EAAE,MAAM;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM;IAC5B,QAAQ,CAAC,aAAa,CAAC;IACvB,QAAQ,CAAC,eAAe,CAAC;IACzB,QAAQ,CAAC,eAAe,CAAC;IACzB,QAAQ,CAAC,gBAAgB,CAAC;gBALjB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,aAAa,CAAC,qBAAS,EACvB,eAAe,CAAC,oBAAQ,EACxB,eAAe,CAAC,qBAAS,EACzB,gBAAgB,CAAC,qBAAS;WAGvB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IA4BvC,OAAO,IAAI,MAAM;CAazB;AAED,qBAAa,KAAK;IAEd,QAAQ,CAAC,GAAG,EAAE,MAAM;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;gBAFlC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAGtC,IAAI,CAAC,CAAC,KAAK,CAAC;IAIZ,IAAI,IAAI,UAAU;CAG1B"}

package/dist/types/types.js

@@ -0,0 +1,138 @@
+"use strict";
+/*
+ * Copyright (c) 2023-2024 - Restate Software, Inc., Restate GmbH
+ *
+ * This file is part of the Restate SDK for Node.js/TypeScript,
+ * which is released under the MIT license.
+ *
+ * You can find a copy of the license in file LICENSE in the root
+ * directory of this repository or package, or at
+ * https://github.com/restatedev/sdk-typescript/blob/main/LICENSE
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Event = exports.Header = exports.Message = void 0;
+const protocol_1 = require("./protocol");
+class Message {
+    messageType;
+    message;
+    completed;
+    protocolVersion;
+    requiresAck;
+    constructor(messageType, message, completed, protocolVersion, requiresAck) {
+        this.messageType = messageType;
+        this.message = message;
+        this.completed = completed;
+        this.protocolVersion = protocolVersion;
+        this.requiresAck = requiresAck;
+    }
+    // For debugging purposes
+    toJSON() {
+        const pbType = protocol_1.PROTOBUF_MESSAGE_BY_TYPE.get(this.messageType);
+        if (pbType === undefined) {
+            return this;
+        }
+        return {
+            messageType: (0, protocol_1.formatMessageType)(this.messageType),
+            message: pbType.toJSON(this.message),
+        };
+    }
+}
+exports.Message = Message;
+class MessageType {
+    static assertValid(messageTypeId) {
+        if (protocol_1.KNOWN_MESSAGE_TYPES.has(messageTypeId)) {
+            return;
+        }
+        if ((messageTypeId & CUSTOM_MESSAGE_MASK) !== 0n) {
+            return;
+        }
+        throw new Error(`Unknown message type ${messageTypeId}`);
+    }
+    static hasCompletedFlag(messageType) {
+        return (messageType === protocol_1.POLL_INPUT_STREAM_ENTRY_MESSAGE_TYPE ||
+            messageType === protocol_1.GET_STATE_ENTRY_MESSAGE_TYPE ||
+            messageType === protocol_1.GET_STATE_KEYS_ENTRY_MESSAGE_TYPE ||
+            messageType === protocol_1.SLEEP_ENTRY_MESSAGE_TYPE ||
+            messageType === protocol_1.AWAKEABLE_ENTRY_MESSAGE_TYPE);
+    }
+    static hasProtocolVersion(messageType) {
+        return messageType == protocol_1.START_MESSAGE_TYPE;
+    }
+    static hasRequiresAckFlag(messageType) {
+        return (messageType !== protocol_1.START_MESSAGE_TYPE &&
+            messageType !== protocol_1.ERROR_MESSAGE_TYPE &&
+            messageType !== protocol_1.SUSPENSION_MESSAGE_TYPE &&
+            messageType !== protocol_1.ENTRY_ACK_MESSAGE_TYPE &&
+            messageType !== protocol_1.COMPLETION_MESSAGE_TYPE);
+    }
+}
+const CUSTOM_MESSAGE_MASK = BigInt(0xfc00);
+const COMPLETED_MASK = BigInt(0x0001_0000_0000);
+const VERSION_MASK = BigInt(0x03ff_0000_0000);
+const REQUIRES_ACK_MASK = BigInt(0x8000_0000_0000);
+// The header is exported but only for tests.
+class Header {
+    messageType;
+    frameLength;
+    completedFlag;
+    protocolVersion;
+    requiresAckFlag;
+    partialStateFlag;
+    constructor(messageType, frameLength, completedFlag, protocolVersion, requiresAckFlag, partialStateFlag) {
+        this.messageType = messageType;
+        this.frameLength = frameLength;
+        this.completedFlag = completedFlag;
+        this.protocolVersion = protocolVersion;
+        this.requiresAckFlag = requiresAckFlag;
+        this.partialStateFlag = partialStateFlag;
+    }
+    static fromU64be(value) {
+        const messageType = (value >> 48n) & 0xffffn;
+        MessageType.assertValid(messageType);
+        const completedFlag = MessageType.hasCompletedFlag(messageType) &&
+            (value & COMPLETED_MASK) !== 0n
+            ? true
+            : undefined;
+        const protocolVersion = MessageType.hasProtocolVersion(messageType)
+            ? Number(((value & VERSION_MASK) >> 32n) & 0xffffn)
+            : undefined;
+        const requiresAckFlag = MessageType.hasRequiresAckFlag(messageType) &&
+            (value & REQUIRES_ACK_MASK) !== 0n
+            ? true
+            : undefined;
+        const frameLength = Number(value & 0xffffffffn);
+        return new Header(messageType, frameLength, completedFlag, protocolVersion, requiresAckFlag);
+    }
+    toU64be() {
+        let res = (this.messageType << 48n) | BigInt(this.frameLength);
+        if (this.completedFlag) {
+            res = res | COMPLETED_MASK;
+        }
+        if (this.protocolVersion !== undefined) {
+            res = res | (BigInt(this.protocolVersion) << 32n);
+        }
+        if (this.requiresAckFlag) {
+            res = res | REQUIRES_ACK_MASK;
+        }
+        return res;
+    }
+}
+exports.Header = Header;
+class Event {
+    key;
+    payload;
+    attributes;
+    constructor(key, payload, attributes) {
+        this.key = key;
+        this.payload = payload;
+        this.attributes = attributes;
+    }
+    json() {
+        return JSON.parse(this.payload.toString("utf-8"));
+    }
+    body() {
+        return this.payload;
+    }
+}
+exports.Event = Event;
+//# sourceMappingURL=types.js.map

package/dist/types/types.js.map

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

package/dist/utils/{assumpsions.d.ts → assumptions.d.ts}

@@ -5,4 +5,4 @@ export declare const verifyAssumptions: (isKeyed: boolean, request: RpcRequest)
     key?: string | undefined;
     request?: JsType;
 };
-//# sourceMappingURL=assumpsions.d.ts.map
+//# sourceMappingURL=assumptions.d.ts.map

package/dist/utils/{assumpsions.d.ts.map → assumptions.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"assumpsions.d.ts","sourceRoot":"","sources":["../../src/utils/assumpsions.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAQvD,eAAO,MAAM,eAAe,SAAU,OAAO,EAAE,KAAG,UAoCjD,CAAC;AAGF,MAAM,MAAM,MAAM,GACd,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,GACN,IAAI,GACJ,KAAK,CAAC,GAAG,CAAC,GACV,SAAS,CAAC;AASd,eAAO,MAAM,iBAAiB,YACnB,OAAO,WACP,UAAU;;cACQ,MAAM;CAqDlC,CAAC"}
+{"version":3,"file":"assumptions.d.ts","sourceRoot":"","sources":["../../src/utils/assumptions.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAQvD,eAAO,MAAM,eAAe,SAAU,OAAO,EAAE,KAAG,UAoCjD,CAAC;AAGF,MAAM,MAAM,MAAM,GACd,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,GACN,IAAI,GACJ,KAAK,CAAC,GAAG,CAAC,GACV,SAAS,CAAC;AASd,eAAO,MAAM,iBAAiB,YACnB,OAAO,WACP,UAAU;;cACQ,MAAM;CAqDlC,CAAC"}

package/dist/utils/assumptions.js

@@ -0,0 +1,101 @@
+"use strict";
+/*
+ * Copyright (c) 2023-2024 - Restate Software, Inc., Restate GmbH
+ *
+ * This file is part of the Restate SDK for Node.js/TypeScript,
+ * which is released under the MIT license.
+ *
+ * You can find a copy of the license in file LICENSE in the root
+ * directory of this repository or package, or at
+ * https://github.com/restatedev/sdk-typescript/blob/main/LICENSE
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.verifyAssumptions = exports.requestFromArgs = void 0;
+const dynrpc_1 = require("../generated/proto/dynrpc");
+const errors_1 = require("../types/errors");
+const ASSUME_UNKEYED_SINCE_FIRST_PARAM_NOT_STRING = 1;
+const ASSUME_UNKEYED_SINCE_ZERO_ARGS = 2;
+const ASSUME_KEYED_SINCE_TWO_ARGS_STR_AND_ANY = 3;
+const ASSUME_EITHER_KEYED_OR_UNKEYED_ONE_STR_ARG = 4;
+const requestFromArgs = (args) => {
+    switch (args.length) {
+        case 0: {
+            return dynrpc_1.RpcRequest.create({
+                senderAssumes: ASSUME_UNKEYED_SINCE_ZERO_ARGS,
+            });
+        }
+        case 1: {
+            if (typeof args[0] === "string") {
+                return dynrpc_1.RpcRequest.create({
+                    key: args[0],
+                    senderAssumes: ASSUME_EITHER_KEYED_OR_UNKEYED_ONE_STR_ARG,
+                });
+            }
+            else {
+                return dynrpc_1.RpcRequest.create({
+                    request: args[0],
+                    senderAssumes: ASSUME_UNKEYED_SINCE_FIRST_PARAM_NOT_STRING,
+                });
+            }
+        }
+        case 2: {
+            if (typeof args[0] !== "string") {
+                throw new errors_1.TerminalError(`Two argument handlers are only possible for keyed handlers. Where the first argument must be of type 'string'.`);
+            }
+            return dynrpc_1.RpcRequest.create({
+                key: args[0],
+                request: args[1],
+                senderAssumes: ASSUME_KEYED_SINCE_TWO_ARGS_STR_AND_ANY,
+            });
+        }
+        default: {
+            throw new errors_1.TerminalError("wrong number of arguments " + args.length);
+        }
+    }
+};
+exports.requestFromArgs = requestFromArgs;
+/* eslint-enable @typescript-eslint/ban-types, @typescript-eslint/no-explicit-any */
+const requireThat = (condition, errorMessage) => {
+    if (!condition) {
+        throw new errors_1.TerminalError(errorMessage);
+    }
+};
+const verifyAssumptions = (isKeyed, request) => {
+    const assumption = request.senderAssumes ?? 0;
+    switch (assumption) {
+        case 0: {
+            // no assumption: this comes from an ingress.
+            const hasKeyProperty = typeof request.key === "string" && request.key.length > 0;
+            if (isKeyed) {
+                requireThat(hasKeyProperty, "Trying to call a keyed handler with a missing or empty 'key' property.");
+            }
+            else {
+                requireThat(!hasKeyProperty, "Trying to call a an unkeyed handler with a 'key' property. Did you mean using the 'request' property instead?");
+            }
+            return { key: request.key, request: request.request };
+        }
+        case ASSUME_UNKEYED_SINCE_FIRST_PARAM_NOT_STRING: {
+            requireThat(!isKeyed, "Trying to call a keyed handler with a missing key. This could happen if the first argument passed is not a 'string'.");
+            return { request: request.request };
+        }
+        case ASSUME_UNKEYED_SINCE_ZERO_ARGS: {
+            requireThat(!isKeyed, "A keyed handler must at least be invoked with a single non empty string argument, that represents the key. 0 arguments given.");
+            return { request: request.request };
+        }
+        case ASSUME_KEYED_SINCE_TWO_ARGS_STR_AND_ANY: {
+            requireThat(isKeyed, "An unkeyed handler must have at most 1 argument. two given.");
+            return { key: request.key, request: request.request };
+        }
+        case ASSUME_EITHER_KEYED_OR_UNKEYED_ONE_STR_ARG: {
+            if (isKeyed) {
+                return { key: request.key };
+            }
+            return { request: request.key };
+        }
+        default: {
+            throw new errors_1.TerminalError(`Unknown assumption id ${assumption}. This indicates an incorrect (or involuntary) setting of the assumption property at the ingress request, or an SDK bug.`);
+        }
+    }
+};
+exports.verifyAssumptions = verifyAssumptions;
+//# sourceMappingURL=assumptions.js.map

package/dist/utils/assumptions.js.map

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

package/dist/utils/message_logger.d.ts

@@ -0,0 +1,28 @@
+/// <reference types="node" />
+import { LoggerContext } from "../logger";
+/**
+ * The environment variable which is read to determine the debug log settings.
+ */
+export declare const DEBUG_LOGGING_ENV = "RESTATE_DEBUG_LOGGING";
+/**
+ * The values for the {@link DEBUG_LOGGING_ENV} variable.
+ */
+export declare enum RestateDebugLogLevel {
+    /** No debug logging at all. Good for performance and avoid per-invocation log volume */
+    OFF = 0,
+    /** Logs debug information for every Restate function invocation. */
+    INVOKE = 1,
+    /** Logs debug information for every Restate effect (=journal event) inside an invocation,
+     *  like RPC, state access, sideEffect, ... */
+    JOURNAL = 2,
+    /** Logs debug information for every Restate effect (=journal event) inside an invocation,
+     *  like RPC, state access, sideEffect, ... Additionally, this adds a JSON representation
+     *  of the journal message to the log. */
+    JOURNAL_VERBOSE = 3
+}
+export type StateMachineConsole = Console & {
+    debugInvokeMessage: (msg: string) => void;
+    debugJournalMessage: (logMessage: string, messageType?: bigint, message?: any) => void;
+};
+export declare function createStateMachineConsole(context: LoggerContext): StateMachineConsole;
+//# sourceMappingURL=message_logger.d.ts.map

package/dist/utils/message_logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message_logger.d.ts","sourceRoot":"","sources":["../../src/utils/message_logger.ts"],"names":[],"mappings":";AAgBA,OAAO,EAAwB,aAAa,EAAE,MAAM,WAAW,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,iBAAiB,0BAA0B,CAAC;AAEzD;;GAEG;AACH,oBAAY,oBAAoB;IAC9B,wFAAwF;IACxF,GAAG,IAAA;IAEH,oEAAoE;IACpE,MAAM,IAAA;IAEN;kDAC8C;IAC9C,OAAO,IAAA;IAEP;;6CAEyC;IACzC,eAAe,IAAA;CAChB;AA4BD,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG;IAC1C,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAE1C,mBAAmB,EAAE,CACnB,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,GAAG,KACV,IAAI,CAAC;CACX,CAAC;AAEF,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,aAAa,GACrB,mBAAmB,CA8BrB"}

package/dist/utils/message_logger.js

@@ -0,0 +1,88 @@
+"use strict";
+/*
+ * Copyright (c) 2023-2024 - Restate Software, Inc., Restate GmbH
+ *
+ * This file is part of the Restate SDK for Node.js/TypeScript,
+ * which is released under the MIT license.
+ *
+ * You can find a copy of the license in file LICENSE in the root
+ * directory of this repository or package, or at
+ * https://github.com/restatedev/sdk-typescript/blob/main/LICENSE
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStateMachineConsole = exports.RestateDebugLogLevel = exports.DEBUG_LOGGING_ENV = void 0;
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/* eslint-disable no-console */
+const protocol_1 = require("../types/protocol");
+const utils_1 = require("./utils");
+const logger_1 = require("../logger");
+/**
+ * The environment variable which is read to determine the debug log settings.
+ */
+exports.DEBUG_LOGGING_ENV = "RESTATE_DEBUG_LOGGING";
+/**
+ * The values for the {@link DEBUG_LOGGING_ENV} variable.
+ */
+var RestateDebugLogLevel;
+(function (RestateDebugLogLevel) {
+    /** No debug logging at all. Good for performance and avoid per-invocation log volume */
+    RestateDebugLogLevel[RestateDebugLogLevel["OFF"] = 0] = "OFF";
+    /** Logs debug information for every Restate function invocation. */
+    RestateDebugLogLevel[RestateDebugLogLevel["INVOKE"] = 1] = "INVOKE";
+    /** Logs debug information for every Restate effect (=journal event) inside an invocation,
+     *  like RPC, state access, sideEffect, ... */
+    RestateDebugLogLevel[RestateDebugLogLevel["JOURNAL"] = 2] = "JOURNAL";
+    /** Logs debug information for every Restate effect (=journal event) inside an invocation,
+     *  like RPC, state access, sideEffect, ... Additionally, this adds a JSON representation
+     *  of the journal message to the log. */
+    RestateDebugLogLevel[RestateDebugLogLevel["JOURNAL_VERBOSE"] = 3] = "JOURNAL_VERBOSE";
+})(RestateDebugLogLevel = exports.RestateDebugLogLevel || (exports.RestateDebugLogLevel = {}));
+const DEFAULT_DEBUG_LOG_LEVEL = process.env["NODE_ENV"]?.toUpperCase() === "PRODUCTION"
+    ? RestateDebugLogLevel.OFF
+    : RestateDebugLogLevel.INVOKE;
+function readLogLevel() {
+    const env = process.env[exports.DEBUG_LOGGING_ENV]?.toUpperCase();
+    if (env == undefined) {
+        return DEFAULT_DEBUG_LOG_LEVEL;
+    }
+    const idx = Object.keys(RestateDebugLogLevel)
+        .filter((t) => 
+    // Object.keys contains the numbers as well
+    // https://stackoverflow.com/questions/48768774/how-to-get-all-the-values-of-an-enum-with-typescript
+    isNaN(Number(t)))
+        .findIndex((level) => level == env);
+    if (idx < 0) {
+        return DEFAULT_DEBUG_LOG_LEVEL;
+    }
+    return idx;
+}
+const log_level = readLogLevel();
+function createStateMachineConsole(context) {
+    const console = (0, logger_1.createRestateConsole)(context);
+    Object.defineProperties(console, {
+        debugInvokeMessage: {
+            value: (msg) => {
+                if (log_level >= RestateDebugLogLevel.INVOKE) {
+                    console.debug(msg);
+                }
+            },
+        },
+        debugJournalMessage: {
+            value: (logMessage, messageType, message) => {
+                if (log_level >= RestateDebugLogLevel.JOURNAL) {
+                    const type = messageType !== undefined
+                        ? " ; " + (0, protocol_1.formatMessageType)(messageType)
+                        : "";
+                    const journalEvent = log_level >= RestateDebugLogLevel.JOURNAL_VERBOSE &&
+                        message !== undefined
+                        ? " : " + (0, utils_1.formatMessageAsJson)(message)
+                        : "";
+                    console.debug(`${logMessage}${type}${journalEvent}`);
+                }
+            },
+        },
+    });
+    return console;
+}
+exports.createStateMachineConsole = createStateMachineConsole;
+//# sourceMappingURL=message_logger.js.map

package/dist/utils/message_logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message_logger.js","sourceRoot":"","sources":["../../src/utils/message_logger.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,uDAAuD;AACvD,+BAA+B;AAE/B,gDAAsD;AACtD,mCAA8C;AAC9C,sCAAgE;AAEhE;;GAEG;AACU,QAAA,iBAAiB,GAAG,uBAAuB,CAAC;AAEzD;;GAEG;AACH,IAAY,oBAeX;AAfD,WAAY,oBAAoB;IAC9B,wFAAwF;IACxF,6DAAG,CAAA;IAEH,oEAAoE;IACpE,mEAAM,CAAA;IAEN;kDAC8C;IAC9C,qEAAO,CAAA;IAEP;;6CAEyC;IACzC,qFAAe,CAAA;AACjB,CAAC,EAfW,oBAAoB,GAApB,4BAAoB,KAApB,4BAAoB,QAe/B;AAED,MAAM,uBAAuB,GAC3B,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,WAAW,EAAE,KAAK,YAAY;IACrD,CAAC,CAAC,oBAAoB,CAAC,GAAG;IAC1B,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC;AAElC,SAAS,YAAY;IACnB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAiB,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1D,IAAI,GAAG,IAAI,SAAS,EAAE;QACpB,OAAO,uBAAuB,CAAC;KAChC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC;SAC1C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;IACZ,2CAA2C;IAC3C,oGAAoG;IACpG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CACjB;SACA,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC;IACtC,IAAI,GAAG,GAAG,CAAC,EAAE;QACX,OAAO,uBAAuB,CAAC;KAChC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;AAYjC,SAAgB,yBAAyB,CACvC,OAAsB;IAEtB,MAAM,OAAO,GAAG,IAAA,6BAAoB,EAAC,OAAO,CAAC,CAAC;IAE9C,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE;QAC/B,kBAAkB,EAAE;YAClB,KAAK,EAAE,CAAC,GAAW,EAAE,EAAE;gBACrB,IAAI,SAAS,IAAI,oBAAoB,CAAC,MAAM,EAAE;oBAC5C,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;iBACpB;YACH,CAAC;SACF;QACD,mBAAmB,EAAE;YACnB,KAAK,EAAE,CAAC,UAAkB,EAAE,WAAoB,EAAE,OAAa,EAAE,EAAE;gBACjE,IAAI,SAAS,IAAI,oBAAoB,CAAC,OAAO,EAAE;oBAC7C,MAAM,IAAI,GACR,WAAW,KAAK,SAAS;wBACvB,CAAC,CAAC,KAAK,GAAG,IAAA,4BAAiB,EAAC,WAAW,CAAC;wBACxC,CAAC,CAAC,EAAE,CAAC;oBACT,MAAM,YAAY,GAChB,SAAS,IAAI,oBAAoB,CAAC,eAAe;wBACjD,OAAO,KAAK,SAAS;wBACnB,CAAC,CAAC,KAAK,GAAG,IAAA,2BAAmB,EAAC,OAAO,CAAC;wBACtC,CAAC,CAAC,EAAE,CAAC;oBACT,OAAO,CAAC,KAAK,CAAC,GAAG,UAAU,GAAG,IAAI,GAAG,YAAY,EAAE,CAAC,CAAC;iBACtD;YACH,CAAC;SACF;KACF,CAAC,CAAC;IAEH,OAAO,OAA8B,CAAC;AACxC,CAAC;AAhCD,8DAgCC"}

package/dist/utils/promises.d.ts

@@ -0,0 +1,15 @@
+export type WrappedPromise<T> = Promise<T> & {
+    transform: <TResult1 = T, TResult2 = never>(onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null | undefined, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null | undefined) => WrappedPromise<TResult1 | TResult2>;
+};
+export declare function wrapDeeply<T>(promise: Promise<T>, onThen?: () => void): WrappedPromise<T>;
+export declare class CompletablePromise<T> {
+    private success;
+    private failure;
+    readonly promise: Promise<T>;
+    constructor();
+    resolve(value: T): void;
+    reject(reason?: any): void;
+}
+export declare const PROMISE_PENDING: Promise<any>;
+export declare const WRAPPED_PROMISE_PENDING: Promise<any>;
+//# sourceMappingURL=promises.d.ts.map

package/dist/utils/promises.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promises.d.ts","sourceRoot":"","sources":["../../src/utils/promises.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG;IAG3C,SAAS,EAAE,CAAC,QAAQ,GAAG,CAAC,EAAE,QAAQ,GAAG,KAAK,EACxC,WAAW,CAAC,EACR,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAChD,IAAI,GACJ,SAAS,EACb,UAAU,CAAC,EACP,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GACnD,IAAI,GACJ,SAAS,KACV,cAAc,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAAC;CAC1C,CAAC;AAEF,wBAAgB,UAAU,CAAC,CAAC,EAC1B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,MAAM,CAAC,EAAE,MAAM,IAAI,GAClB,cAAc,CAAC,CAAC,CAAC,CAuDnB;AAID,qBAAa,kBAAkB,CAAC,CAAC;IAC/B,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,OAAO,CAA0B;IAEzC,SAAgB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;;IAS7B,OAAO,CAAC,KAAK,EAAE,CAAC;IAIhB,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG;CAG3B;AAID,eAAO,MAAM,eAAe,EAAE,OAAO,CAAC,GAAG,CAA8B,CAAC;AACxE,eAAO,MAAM,uBAAuB,EAAE,OAAO,CAAC,GAAG,CACpB,CAAC"}

package/dist/utils/promises.js

@@ -0,0 +1,67 @@
+"use strict";
+/*
+ * Copyright (c) 2023-2024 - Restate Software, Inc., Restate GmbH
+ *
+ * This file is part of the Restate SDK for Node.js/TypeScript,
+ * which is released under the MIT license.
+ *
+ * You can find a copy of the license in file LICENSE in the root
+ * directory of this repository or package, or at
+ * https://github.com/restatedev/sdk-typescript/blob/main/LICENSE
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WRAPPED_PROMISE_PENDING = exports.PROMISE_PENDING = exports.CompletablePromise = exports.wrapDeeply = void 0;
+function wrapDeeply(promise, onThen) {
+    // We need this to support nesting of WrappedPromise
+    let transform;
+    if (Object.hasOwn(promise, "transform")) {
+        const wrappedPromise = promise;
+        transform = (onfulfilled, onrejected) => wrapDeeply(wrappedPromise.transform(onfulfilled, onrejected), onThen);
+    }
+    else {
+        transform = (onfulfilled, onrejected) => wrapDeeply(promise.then(onfulfilled, onrejected), onThen);
+    }
+    /* eslint-disable @typescript-eslint/no-explicit-any */
+    return {
+        transform,
+        then: function (onfulfilled, onrejected) {
+            if (onThen !== undefined) {
+                onThen();
+            }
+            return promise.then(onfulfilled, onrejected);
+        },
+        catch: function (onrejected) {
+            return wrapDeeply(promise.catch(onrejected), onThen);
+        },
+        finally: function (onfinally) {
+            return wrapDeeply(promise.finally(onfinally), onThen);
+        },
+        [Symbol.toStringTag]: "",
+    };
+}
+exports.wrapDeeply = wrapDeeply;
+// Like https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/withResolvers
+// (not yet available in node)
+class CompletablePromise {
+    success;
+    failure;
+    promise;
+    constructor() {
+        this.promise = new Promise((resolve, reject) => {
+            this.success = resolve;
+            this.failure = reject;
+        });
+    }
+    resolve(value) {
+        this.success(value);
+    }
+    reject(reason) {
+        this.failure(reason);
+    }
+}
+exports.CompletablePromise = CompletablePromise;
+// A promise that is never completed
+// eslint-disable-next-line @typescript-eslint/no-empty-function
+exports.PROMISE_PENDING = new Promise(() => { });
+exports.WRAPPED_PROMISE_PENDING = wrapDeeply(exports.PROMISE_PENDING);
+//# sourceMappingURL=promises.js.map

package/dist/utils/promises.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promises.js","sourceRoot":"","sources":["../../src/utils/promises.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAoBH,SAAgB,UAAU,CACxB,OAAmB,EACnB,MAAmB;IAEnB,oDAAoD;IACpD,IAAI,SASoC,CAAC;IACzC,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE;QACvC,MAAM,cAAc,GAAG,OAA4B,CAAC;QACpD,SAAS,GAAG,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,CACtC,UAAU,CAAC,cAAc,CAAC,SAAS,CAAC,WAAW,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC;KACzE;SAAM;QACL,SAAS,GAAG,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,CACtC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC;KAC7D;IAED,uDAAuD;IACvD,OAAO;QACL,SAAS;QAET,IAAI,EAAE,UACJ,WAGa,EACb,UAGa;YAEb,IAAI,MAAM,KAAK,SAAS,EAAE;gBACxB,MAAM,EAAE,CAAC;aACV;YACD,OAAO,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QAC/C,CAAC;QACD,KAAK,EAAE,UACL,UAGa;YAEb,OAAO,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,EAAE,UACP,SAA2C;YAE3C,OAAO,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;QACxD,CAAC;QACD,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE;KACzB,CAAC;AACJ,CAAC;AA1DD,gCA0DC;AAED,8GAA8G;AAC9G,8BAA8B;AAC9B,MAAa,kBAAkB;IACrB,OAAO,CAAuC;IAC9C,OAAO,CAA0B;IAEzB,OAAO,CAAa;IAEpC;QACE,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC7C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;YACvB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACxB,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,OAAO,CAAC,KAAQ;QACrB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAEM,MAAM,CAAC,MAAY;QACxB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;CACF;AApBD,gDAoBC;AAED,oCAAoC;AACpC,gEAAgE;AACnD,QAAA,eAAe,GAAiB,IAAI,OAAO,CAAM,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AAC3D,QAAA,uBAAuB,GAClC,UAAU,CAAC,uBAAe,CAAC,CAAC"}