@restatedev/restate-sdk 0.0.0-SNAPSHOT-20231025205407

package/dist/utils/logger.d.ts

@@ -0,0 +1,60 @@
+/// <reference types="node" />
+/**
+ * Simple extension of the Console interface, to add debug logging per message.
+ * Because per-message logging can be very expensive, it is not active by default.
+ *
+ * This method also supports lazy construction of stringified message object,
+ * because constructing that stringified representation is even more expensive.
+ */
+export interface RestateConsole extends Console {
+    /**
+     * Called to log per-invocation debug messages.
+     *
+     * Under load, this can generate a large amount of log output. Due to that, this
+     * function by default logs only if the 'NODE_ENV' environment is not set to
+     * 'production', or if explicitly configured via the restate 'RESTATE_DEBUG_LOGGING'
+     * environment variable. See {@link DEBUG_LOG_LEVEL} for details.
+     */
+    debugInvokeMessage(invocationInfo: string, logMessage: string): void;
+    /**
+     * Called to log per-jounral action debug messages.
+     *
+     * Under load, this can generate an insane amount of log output. Due to that, this
+     * function doesn't actually output log entries unless configured via the 'RESTATE_DEBUG_LOGGING'
+     * environment variable. See {@link DEBUG_LOG_LEVEL} for details.
+     */
+    debugJournalMessage(invocationInfo: string, logMessage: string, messageType?: bigint, message?: any): void;
+}
+/**
+ * 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 DEBUG_LOG_LEVEL {
+    /** No debug logging at all. Good for performance and avoid per-invocation log volume */
+    OFF = "OFF",
+    /** Logs debug information for every Restate function invocation. */
+    INVOKE = "INVOKE",
+    /** Logs debug information for every Restate effect (=journal event) inside an invocation,
+     *  like RPC, state access, sideEffect, ... */
+    JOURNAL = "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. */
+    JOURNAL_VERBOSE = "JOURNAL_VERBOSE"
+}
+/**
+ * The RestateLogger lets us add some extra information to logging statements:
+ * [restate] [timestamp] INFO/WARN/ERROR/DEBUG/TRACE <log-message>.
+ *
+ * It also adds the methods {@link RestateConsole.debugInvokeMessage} and *
+ * {@link RestateConsole.debugJournalMessage} for optional intensive (per
+ * invocation / per journal message) logging.
+ *
+ * We don't override the console here, to make sure that this only applies to Restate
+ * log lines, and not to logging from application code.
+ */
+export declare const rlog: RestateConsole;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":";AAiBA;;;;;;GAMG;AACH,MAAM,WAAW,cAAe,SAAQ,OAAO;IAC7C;;;;;;;OAOG;IACH,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAErE;;;;;;OAMG;IACH,mBAAmB,CACjB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,GAAG,GACZ,IAAI,CAAC;CACT;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,0BAA0B,CAAC;AAEzD;;GAEG;AACH,oBAAY,eAAe;IACzB,wFAAwF;IACxF,GAAG,QAAQ;IAEX,oEAAoE;IACpE,MAAM,WAAW;IAEjB;kDAC8C;IAC9C,OAAO,YAAY;IAEnB;;6CAEyC;IACzC,eAAe,oBAAoB;CACpC;AAiGD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,IAAI,gBAAmC,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,102 @@
+"use strict";
+/*
+ * Copyright (c) 2023 - 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.rlog = exports.DEBUG_LOG_LEVEL = 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");
+/**
+ * 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 DEBUG_LOG_LEVEL;
+(function (DEBUG_LOG_LEVEL) {
+    /** No debug logging at all. Good for performance and avoid per-invocation log volume */
+    DEBUG_LOG_LEVEL["OFF"] = "OFF";
+    /** Logs debug information for every Restate function invocation. */
+    DEBUG_LOG_LEVEL["INVOKE"] = "INVOKE";
+    /** Logs debug information for every Restate effect (=journal event) inside an invocation,
+     *  like RPC, state access, sideEffect, ... */
+    DEBUG_LOG_LEVEL["JOURNAL"] = "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. */
+    DEBUG_LOG_LEVEL["JOURNAL_VERBOSE"] = "JOURNAL_VERBOSE";
+})(DEBUG_LOG_LEVEL = exports.DEBUG_LOG_LEVEL || (exports.DEBUG_LOG_LEVEL = {}));
+const log_setting = process.env[exports.DEBUG_LOGGING_ENV]?.toUpperCase();
+const verbose_journal_event_logging = log_setting == DEBUG_LOG_LEVEL.JOURNAL_VERBOSE;
+const journal_event_logging = verbose_journal_event_logging || log_setting == DEBUG_LOG_LEVEL.JOURNAL;
+const invoke_event_logging = journal_event_logging ||
+    log_setting == DEBUG_LOG_LEVEL.INVOKE ||
+    (log_setting != DEBUG_LOG_LEVEL.OFF &&
+        process.env["NODE_ENV"]?.toLowerCase() !== "production");
+// ----------------------------------------------------------------------------
+//  build restate logger
+// ----------------------------------------------------------------------------
+// effectively duplicate the console object (new object with same prototype)
+// to override some specific methods
+const restate_logger = Object.create(console);
+restate_logger.log = (message, ...optionalParams) => {
+    console.log(`[restate] [${new Date().toISOString()}] LOG: ${message}`, ...optionalParams);
+};
+restate_logger.info = (message, ...optionalParams) => {
+    console.info(`[restate] [${new Date().toISOString()}] INFO: ${message}`, ...optionalParams);
+};
+restate_logger.warn = (message, ...optionalParams) => {
+    console.warn(`[restate] [${new Date().toISOString()}] WARN: ${message}`, ...optionalParams);
+};
+restate_logger.error = (message, ...optionalParams) => {
+    console.error(`[restate] [${new Date().toISOString()}] ERROR: ${message}`, ...optionalParams);
+};
+restate_logger.debug = (message, ...optionalParams) => {
+    console.debug(`[restate] [${new Date().toISOString()}] DEBUG: ${message}`, ...optionalParams);
+};
+restate_logger.trace = (message, ...optionalParams) => {
+    console.trace(`[restate] [${new Date().toISOString()}] TRACE: ${message}`, ...optionalParams);
+};
+restate_logger.debugInvokeMessage = function (invocationInfo, logMessage) {
+    if (!invoke_event_logging) {
+        return;
+    }
+    const msg = `[restate] [${new Date().toISOString()}] DEBUG: ${invocationInfo} : ${logMessage}`;
+    console.debug(msg);
+};
+restate_logger.debugJournalMessage = function (invocationInfo, logMessage, messageType, message) {
+    if (!journal_event_logging) {
+        return;
+    }
+    const type = messageType !== undefined
+        ? " ; " + protocol_1.PROTOBUF_MESSAGE_NAME_BY_TYPE.get(messageType) ||
+            "" + messageType
+        : "";
+    const journalEvent = verbose_journal_event_logging && message !== undefined
+        ? " : " + (0, utils_1.printMessageAsJson)(message)
+        : "";
+    console.debug(`[restate] [${new Date().toISOString()}] DEBUG: ${invocationInfo} : ${logMessage}${type}${journalEvent}`);
+};
+/**
+ * The RestateLogger lets us add some extra information to logging statements:
+ * [restate] [timestamp] INFO/WARN/ERROR/DEBUG/TRACE <log-message>.
+ *
+ * It also adds the methods {@link RestateConsole.debugInvokeMessage} and *
+ * {@link RestateConsole.debugJournalMessage} for optional intensive (per
+ * invocation / per journal message) logging.
+ *
+ * We don't override the console here, to make sure that this only applies to Restate
+ * log lines, and not to logging from application code.
+ */
+exports.rlog = restate_logger;
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/public_utils.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Retry policy that decides how to delay between retries.
+ */
+export interface RetryPolicy {
+    computeNextDelay(previousDelayMs: number): number;
+}
+/**
+ * A {@link RetryPolicy} that keeps a fixed delay between retries.
+ */
+export declare const FIXED_DELAY: RetryPolicy;
+/**
+ * A {@link RetryPolicy} that does an exponential backoff delay between retries.
+ * Each delay is twice as long as the previous delay.
+ */
+export declare const EXPONENTIAL_BACKOFF: RetryPolicy;
+/**
+ * All properties related to retrying, like the policy (exponential, fixed, ...), the
+ * initial delay, the maximum number of retries.
+ */
+export interface RetrySettings {
+    /**
+     * The initial delay between retries. As more retries happen, the delay may change per the policy.
+     */
+    initialDelayMs?: number;
+    /**
+     * Optionally, the maximum delay between retries. No matter what the policy says, this is the maximum time
+     * that Restate sleeps between retries.
+     * If not set, there is effectively no limit (internally the limit is Number.MAX_SAFE_INTEGER).
+     */
+    maxDelayMs?: number;
+    /**
+     * Optionally, the maximum number of retries before this function fails with an exception.
+     * If not set, there is effectively no limit (internally the limit is Number.MAX_SAFE_INTEGER).
+     */
+    maxRetries?: number;
+    /**
+     * Optionally, the {@link RetryPolicy} to use. Defaults to {@link EXPONENTIAL_BACKOFF}.
+     */
+    policy?: RetryPolicy;
+    /**
+     * Optionally, the name of side effect action that is used in error- and log messages around retries.
+     */
+    name?: string;
+}
+/**
+ * The default initial delay between retries: 10 milliseconds.
+ */
+export declare const DEFAULT_INITIAL_DELAY_MS = 10;
+/**
+ * Default retry policy that retries an infinite number of times, with exponential backoff
+ * and a starting delay of 10 milliseconds.
+ */
+export declare const DEFAULT_INFINITE_EXPONENTIAL_BACKOFF: RetrySettings;
+/**
+ * Retry policy that does no retries.
+ */
+export declare const NO_RETRIES: RetrySettings;
+//# sourceMappingURL=public_utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"public_utils.d.ts","sourceRoot":"","sources":["../../src/utils/public_utils.ts"],"names":[],"mappings":"AAWA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAAC;CACnD;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,WAIzB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,WAIjC,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,oCAAoC,EAAE,aAKlD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,aAAiC,CAAC"}

package/dist/utils/public_utils.js

@@ -0,0 +1,49 @@
+"use strict";
+/*
+ * Copyright (c) 2023 - 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.NO_RETRIES = exports.DEFAULT_INFINITE_EXPONENTIAL_BACKOFF = exports.DEFAULT_INITIAL_DELAY_MS = exports.EXPONENTIAL_BACKOFF = exports.FIXED_DELAY = void 0;
+/**
+ * A {@link RetryPolicy} that keeps a fixed delay between retries.
+ */
+exports.FIXED_DELAY = {
+    computeNextDelay(previousDelayMs) {
+        return previousDelayMs;
+    },
+};
+/**
+ * A {@link RetryPolicy} that does an exponential backoff delay between retries.
+ * Each delay is twice as long as the previous delay.
+ */
+exports.EXPONENTIAL_BACKOFF = {
+    computeNextDelay(previousDelayMs) {
+        return 2 * previousDelayMs;
+    },
+};
+/**
+ * The default initial delay between retries: 10 milliseconds.
+ */
+exports.DEFAULT_INITIAL_DELAY_MS = 10;
+/**
+ * Default retry policy that retries an infinite number of times, with exponential backoff
+ * and a starting delay of 10 milliseconds.
+ */
+exports.DEFAULT_INFINITE_EXPONENTIAL_BACKOFF = {
+    initialDelayMs: exports.DEFAULT_INITIAL_DELAY_MS,
+    maxDelayMs: Number.MAX_SAFE_INTEGER,
+    maxRetries: Number.MAX_SAFE_INTEGER,
+    policy: exports.EXPONENTIAL_BACKOFF,
+};
+/**
+ * Retry policy that does no retries.
+ */
+exports.NO_RETRIES = { maxRetries: 0 };
+//# sourceMappingURL=public_utils.js.map

package/dist/utils/public_utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public_utils.js","sourceRoot":"","sources":["../../src/utils/public_utils.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AASH;;GAEG;AACU,QAAA,WAAW,GAAgB;IACtC,gBAAgB,CAAC,eAAuB;QACtC,OAAO,eAAe,CAAC;IACzB,CAAC;CACF,CAAC;AAEF;;;GAGG;AACU,QAAA,mBAAmB,GAAgB;IAC9C,gBAAgB,CAAC,eAAuB;QACtC,OAAO,CAAC,GAAG,eAAe,CAAC;IAC7B,CAAC;CACF,CAAC;AAoCF;;GAEG;AACU,QAAA,wBAAwB,GAAG,EAAE,CAAC;AAE3C;;;GAGG;AACU,QAAA,oCAAoC,GAAkB;IACjE,cAAc,EAAE,gCAAwB;IACxC,UAAU,EAAE,MAAM,CAAC,gBAAgB;IACnC,UAAU,EAAE,MAAM,CAAC,gBAAgB;IACnC,MAAM,EAAE,2BAAmB;CAC5B,CAAC;AAEF;;GAEG;AACU,QAAA,UAAU,GAAkB,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC"}

package/dist/utils/utils.d.ts

@@ -0,0 +1,14 @@
+export declare class CompletablePromise<T> {
+    private success;
+    private failure;
+    readonly promise: Promise<T>;
+    constructor();
+    resolve(value: T): void;
+    reject(reason?: any): void;
+}
+export declare function jsonSerialize(obj: any): string;
+export declare function jsonDeserialize<T>(json: string): T;
+export declare function printMessageAsJson(obj: any): string;
+export declare function makeFqServiceName(pckg: string, name: string): string;
+export declare const equalityCheckers: Map<bigint, (msg1: any, msg2: any) => boolean>;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils/utils.ts"],"names":[],"mappings":"AAmCA,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;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAI9C;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAMlD;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAWnD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpE;AA+ED,eAAO,MAAM,gBAAgB,qBAEpB,GAAG,QAAQ,GAAG,KAAK,OAAO,CAYjC,CAAC"}

package/dist/utils/utils.js

@@ -0,0 +1,119 @@
+"use strict";
+/*
+ * Copyright (c) 2023 - 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.equalityCheckers = exports.makeFqServiceName = exports.printMessageAsJson = exports.jsonDeserialize = exports.jsonSerialize = exports.CompletablePromise = void 0;
+const protocol_1 = require("../types/protocol");
+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;
+function jsonSerialize(obj) {
+    return JSON.stringify(obj, (_, v) => typeof v === "bigint" ? "BIGINT::" + v.toString() : v);
+}
+exports.jsonSerialize = jsonSerialize;
+function jsonDeserialize(json) {
+    return JSON.parse(json, (_, v) => typeof v === "string" && v.startsWith("BIGINT::")
+        ? BigInt(v.substring(8))
+        : v);
+}
+exports.jsonDeserialize = jsonDeserialize;
+function printMessageAsJson(obj) {
+    const newObj = { ...obj };
+    for (const [key, value] of Object.entries(newObj)) {
+        if (Buffer.isBuffer(value)) {
+            newObj[key] = value.toString().trim();
+        }
+    }
+    // Stringify object. Replace bigintToString serializer to prevent "BigInt not serializable" errors
+    return JSON.stringify(obj, (_, v) => typeof v === "bigint" ? v.toString() + "n" : v);
+}
+exports.printMessageAsJson = printMessageAsJson;
+function makeFqServiceName(pckg, name) {
+    return pckg ? `${pckg}.${name}` : name;
+}
+exports.makeFqServiceName = makeFqServiceName;
+/**
+ * Equality functions
+ * @param msg1 the current message from user code
+ * @param msg2 the replayed message
+ */
+// These functions are used to check whether a replayed message matches the current user code.
+// We check the fields which we can check
+// (the fields which do not contain results, because these might be filled in the result)
+const getStateMsgEquality = (msg1, msg2) => {
+    return msg1.key.equals(msg2.key);
+};
+const invokeMsgEquality = (msg1, msg2) => {
+    return (msg1.serviceName === msg2.serviceName &&
+        msg1.methodName === msg2.methodName &&
+        msg1.parameter.equals(msg2.parameter));
+};
+const setStateMsgEquality = (msg1, msg2) => {
+    return msg1.key.equals(msg2.key) && msg1.value.equals(msg2.value);
+};
+const clearStateMsgEquality = (msg1, msg2) => {
+    return msg1.key.equals(msg2.key);
+};
+const completeAwakeableMsgEquality = (msg1, msg2) => {
+    if (!(msg1.id === msg2.id)) {
+        return false;
+    }
+    if (msg1.value && msg2.value) {
+        return msg1.value.equals(msg2.value);
+    }
+    else if (msg1.failure && msg2.failure) {
+        return (msg1.failure?.code === msg2.failure?.code &&
+            msg1.failure?.message === msg2.failure?.message);
+    }
+    else {
+        return false;
+    }
+};
+const outputMsgEquality = (msg1, msg2) => {
+    if (msg1.value && msg2.value) {
+        return msg1.value.equals(msg2.value);
+    }
+    else if (msg1.failure && msg2.failure) {
+        return (msg1.failure?.code === msg2.failure?.code &&
+            msg1.failure?.message === msg2.failure?.message);
+    }
+    else {
+        return false;
+    }
+};
+exports.equalityCheckers = new Map([
+    [protocol_1.GET_STATE_ENTRY_MESSAGE_TYPE, getStateMsgEquality],
+    [protocol_1.SET_STATE_ENTRY_MESSAGE_TYPE, setStateMsgEquality],
+    [protocol_1.CLEAR_STATE_ENTRY_MESSAGE_TYPE, clearStateMsgEquality],
+    [protocol_1.INVOKE_ENTRY_MESSAGE_TYPE, invokeMsgEquality],
+    [protocol_1.BACKGROUND_INVOKE_ENTRY_MESSAGE_TYPE, invokeMsgEquality],
+    [protocol_1.COMPLETE_AWAKEABLE_ENTRY_MESSAGE_TYPE, completeAwakeableMsgEquality],
+    [protocol_1.OUTPUT_STREAM_ENTRY_MESSAGE_TYPE, outputMsgEquality],
+    [protocol_1.AWAKEABLE_ENTRY_MESSAGE_TYPE, () => true],
+    [protocol_1.SIDE_EFFECT_ENTRY_MESSAGE_TYPE, () => true],
+    [protocol_1.SLEEP_ENTRY_MESSAGE_TYPE, () => true],
+]);
+//# sourceMappingURL=utils.js.map

package/dist/utils/utils.js.map

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

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@restatedev/restate-sdk",
+  "version": "0.0.0-SNAPSHOT-20231025205407",
+  "description": "Typescript SDK for Restate",
+  "engines": {
+    "node": ">= 10"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/restatedev/sdk-typescript.git"
+  },
+  "release-it": {
+    "git": {
+      "pushRepo": "https://github.com/restatedev/sdk-typescript.git"
+    },
+    "github": {
+      "release": true
+    },
+    "npm": {
+      "publish": false
+    }
+  },
+  "publishConfig": {
+    "@restatedev:registry": "https://registry.npmjs.org"
+  },
+  "type": "commonjs",
+  "main": "dist/public_api.js",
+  "types": "dist/public_api.d.ts",
+  "author": "Restate Developers",
+  "license": "MIT",
+  "email": "code@restate.dev",
+  "scripts": {
+    "proto": "npx buf mod update && npx buf generate",
+    "build": "tsc --noEmitOnError",
+    "test": "jest --silent --maxWorkers=1",
+    "lint": "eslint --ignore-path .eslintignore --ext .ts .",
+    "format": "prettier --ignore-path .eslintignore --write \"**/*.+(js|ts|json)\"",
+    "verify": "npm run format -- --check && npm run test && npm run lint && npm run build",
+    "release": "release-it",
+    "example": "RESTATE_DEBUG_LOGGING=JOURNAL ts-node-dev --respawn --transpile-only ./examples/example.ts",
+    "grpcexample": "RESTATE_DEBUG_LOGGING=JOURNAL ts-node-dev --respawn --transpile-only ./examples/grpc_example.ts",
+    "handlerexample": "RESTATE_DEBUG_LOGGING=JOURNAL ts-node-dev --respawn --transpile-only ./examples/handler_example.ts",
+    "expressexample": "RESTATE_DEBUG_LOGGING=JOURNAL ts-node-dev --respawn --transpile-only ./examples/embedded_example.ts"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "protobufjs": "^7.2.2",
+    "ts-proto": "^1.140.0"
+  },
+  "devDependencies": {
+    "@bufbuild/buf": "^1.15.0",
+    "@types/aws-lambda": "^8.10.115",
+    "@types/jest": "^29.4.0",
+    "@types/node": "^18.14.2",
+    "@typescript-eslint/eslint-plugin": "^5.53.0",
+    "@typescript-eslint/parser": "^5.53.0",
+    "eslint": "^8.35.0",
+    "prettier": "^2.8.4",
+    "release-it": "^16.1.4",
+    "ts-jest": "^29.0.5",
+    "ts-node-dev": "^2.0.0",
+    "typescript": "^4.9.5",
+    "express": "*"
+  },
+  "bugs": {
+    "url": "https://github.com/restatedev/sdk-typescript/issues"
+  },
+  "homepage": "https://github.com/restatedev/sdk-typescript#readme",
+  "directories": {
+    "example": "examples",
+    "test": "test"
+  }
+}