@restatedev/restate-sdk 0.7.3-worker → 0.8.1

package/dist/utils/public_utils.js

@@ -0,0 +1,49 @@
+"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.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/rand.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="node" />
-import { Rand } from "../restate_context";
+import { Rand } from "../context";
 export declare class RandImpl implements Rand {
     private randstate256;
     constructor(id: Buffer | [bigint, bigint, bigint, bigint]);

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

@@ -1 +1 @@
-{"version":3,"file":"rand.d.ts","sourceRoot":"","sources":["../../src/utils/rand.ts"],"names":[],"mappings":";AAcA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAQ1C,qBAAa,QAAS,YAAW,IAAI;IACnC,OAAO,CAAC,YAAY,CAAmC;gBAE3C,EAAE,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAgBzD,MAAM,CAAC,QAAQ,SAAoB;IAInC,GAAG,IAAI,MAAM;IAuBb,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IAIzC,YAAY;IAUZ,MAAM,CAAC,QAAQ,SAAoB;IAE5B,MAAM,IAAI,MAAM;IAShB,MAAM,IAAI,MAAM;CAWxB"}
+{"version":3,"file":"rand.d.ts","sourceRoot":"","sources":["../../src/utils/rand.ts"],"names":[],"mappings":";AAcA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAKlC,qBAAa,QAAS,YAAW,IAAI;IACnC,OAAO,CAAC,YAAY,CAAmC;gBAE3C,EAAE,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAgBzD,MAAM,CAAC,QAAQ,SAAoB;IAInC,GAAG,IAAI,MAAM;IAuBb,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IAIzC,YAAY;IAUZ,MAAM,CAAC,QAAQ,SAAoB;IAE5B,MAAM,IAAI,MAAM;IAShB,MAAM,IAAI,MAAM;CAWxB"}

package/dist/utils/rand.js

@@ -0,0 +1,114 @@
+"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.RandImpl = void 0;
+const errors_1 = require("../types/errors");
+const context_impl_1 = require("../context_impl");
+const crypto_1 = require("crypto");
+class RandImpl {
+    randstate256;
+    constructor(id) {
+        if (id instanceof Buffer) {
+            // hash the invocation ID, which is known to contain 74 bits of entropy
+            const hash = (0, crypto_1.createHash)("sha256").update(id).digest();
+            this.randstate256 = [
+                hash.readBigUInt64LE(0),
+                hash.readBigUInt64LE(8),
+                hash.readBigUInt64LE(16),
+                hash.readBigUInt64LE(24),
+            ];
+        }
+        else {
+            this.randstate256 = id;
+        }
+    }
+    static U64_MASK = (1n << 64n) - 1n;
+    // xoshiro256++
+    // https://prng.di.unimi.it/xoshiro256plusplus.c - public domain
+    u64() {
+        const result = (RandImpl.rotl((this.randstate256[0] + this.randstate256[3]) & RandImpl.U64_MASK, 23n) +
+            this.randstate256[0]) &
+            RandImpl.U64_MASK;
+        const t = (this.randstate256[1] << 17n) & RandImpl.U64_MASK;
+        this.randstate256[2] ^= this.randstate256[0];
+        this.randstate256[3] ^= this.randstate256[1];
+        this.randstate256[1] ^= this.randstate256[2];
+        this.randstate256[0] ^= this.randstate256[3];
+        this.randstate256[2] ^= t;
+        this.randstate256[3] = RandImpl.rotl(this.randstate256[3], 45n);
+        return result;
+    }
+    static rotl(x, k) {
+        return ((x << k) & RandImpl.U64_MASK) | (x >> (64n - k));
+    }
+    checkContext() {
+        const context = context_impl_1.ContextImpl.callContext.getStore();
+        if (context && context.type === context_impl_1.CallContexType.SideEffect) {
+            throw new errors_1.TerminalError(`You may not call methods on Rand from within a side effect.`, { errorCode: errors_1.ErrorCodes.INTERNAL });
+        }
+    }
+    static U53_MASK = (1n << 53n) - 1n;
+    random() {
+        this.checkContext();
+        // first generate a uint in range [0,2^53), which can be mapped 1:1 to a float64 in [0,1)
+        const u53 = this.u64() & RandImpl.U53_MASK;
+        // then divide by 2^53, which will simply update the exponent
+        return Number(u53) / 2 ** 53;
+    }
+    uuidv4() {
+        this.checkContext();
+        const buf = Buffer.alloc(16);
+        buf.writeBigUInt64LE(this.u64(), 0);
+        buf.writeBigUInt64LE(this.u64(), 8);
+        // Per 4.4, set bits for version and `clock_seq_hi_and_reserved`
+        buf[6] = (buf[6] & 0x0f) | 0x40;
+        buf[8] = (buf[8] & 0x3f) | 0x80;
+        return uuidStringify(buf);
+    }
+}
+exports.RandImpl = RandImpl;
+const byteToHex = [];
+for (let i = 0; i < 256; ++i) {
+    byteToHex.push((i + 0x100).toString(16).slice(1));
+}
+/**
+ * Convert array of 16 byte values to UUID string format of the form:
+ * XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
+ */
+function uuidStringify(arr, offset = 0) {
+    // Note: Be careful editing this code!  It's been tuned for performance
+    // and works in ways you may not expect. See https://github.com/uuidjs/uuid/pull/434
+    //
+    // Note to future-self: No, you can't remove the `toLowerCase()` call.
+    // REF: https://github.com/uuidjs/uuid/pull/677#issuecomment-1757351351
+    return (byteToHex[arr[offset + 0]] +
+        byteToHex[arr[offset + 1]] +
+        byteToHex[arr[offset + 2]] +
+        byteToHex[arr[offset + 3]] +
+        "-" +
+        byteToHex[arr[offset + 4]] +
+        byteToHex[arr[offset + 5]] +
+        "-" +
+        byteToHex[arr[offset + 6]] +
+        byteToHex[arr[offset + 7]] +
+        "-" +
+        byteToHex[arr[offset + 8]] +
+        byteToHex[arr[offset + 9]] +
+        "-" +
+        byteToHex[arr[offset + 10]] +
+        byteToHex[arr[offset + 11]] +
+        byteToHex[arr[offset + 12]] +
+        byteToHex[arr[offset + 13]] +
+        byteToHex[arr[offset + 14]] +
+        byteToHex[arr[offset + 15]]).toLowerCase();
+}
+//# sourceMappingURL=rand.js.map

package/dist/utils/rand.js.map

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

package/dist/utils/utils.d.ts

@@ -1,15 +1,6 @@
-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 jsonSafeAny(key: string, value: any): any;
-export declare function printMessageAsJson(obj: any): string;
-export declare function makeFqServiceName(pckg: string, name: string): string;
+export declare function formatMessageAsJson(obj: any): string;
 export declare const equalityCheckers: Map<bigint, (msg1: any, msg2: any) => boolean>;
 //# sourceMappingURL=utils.d.ts.map

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

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

package/dist/utils/utils.js

@@ -0,0 +1,122 @@
+"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.equalityCheckers = exports.formatMessageAsJson = exports.jsonSafeAny = exports.jsonDeserialize = exports.jsonSerialize = void 0;
+const protocol_1 = require("../types/protocol");
+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;
+// When using google.protobuf.Value in RPC handler responses, we want to roughly match the behaviour of JSON.stringify
+// for example in converting Date objects to a UTC string
+function jsonSafeAny(key, value) {
+    if (value !== undefined &&
+        value !== null &&
+        typeof value.toJSON == "function") {
+        return value.toJSON(key);
+    }
+    else if (globalThis.Array.isArray(value)) {
+        // in place replace
+        value.forEach((_, i) => (value[i] = jsonSafeAny(i.toString(), value[i])));
+        return value;
+    }
+    else if (typeof value === "object") {
+        Object.keys(value).forEach((key) => {
+            value[key] = jsonSafeAny(key, value[key]);
+        });
+        return value;
+    }
+    else {
+        // primitive that doesn't have a toJSON method, with no children
+        return value;
+    }
+}
+exports.jsonSafeAny = jsonSafeAny;
+function formatMessageAsJson(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.formatMessageAsJson = formatMessageAsJson;
+/**
+ * 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/dist/workflows/workflow.d.ts

@@ -0,0 +1,101 @@
+import * as restate from "../public_api";
+/**
+ * Creates a new workflow service that will be served under the given path.
+ *
+ * A workflow must consist of
+ *   - one run method: `run(ctx: WfContext, params: T) => Promise<R>`
+ *   - an arbitrary number of interaction methods: `foo(ctx: SharedWfContext, params: X) => Promise<Y>`
+ */
+export declare function workflow<R, T, U>(path: string, workflow: Workflow<R, T, U>): WorkflowServices<R, T, U>;
+/**
+ * The type signature of a workflow.
+ * A workflow must consist of
+ *   - one run method: `run(ctx: WfContext, params: T) => Promise<R>`
+ *   - an arbitrary number of interaction methods: `foo(ctx: SharedWfContext, params: T) => Promise<R>`
+ */
+export type Workflow<R, T, U> = {
+    run: RunMethod<R, T>;
+} & WorkflowMethods<R, T, U>;
+type RunMethod<R, T> = (ctx: WfContext, params: T) => Promise<R>;
+type InteractionMethod<R, T> = (ctx: SharedWfContext, params: T) => Promise<R>;
+type WorkflowMethods<R, T, U> = {
+    [K in keyof U]: K extends "run" ? U[K] extends RunMethod<R, T> ? U[K] : "The 'run' methods needs to follow the signature: (ctx: WfContext, params: any) => Promise<any> " : U[K] extends InteractionMethod<any, any> ? U[K] : "Methods other than 'run' are interaction methods and need to follow the signature: (ctx: SharedWfContext, params: any) => Promise<any>";
+};
+/**
+ * The workflow service(s) and API.
+ *
+ * Register at a Restate endpoint (HTTP/2, Lambda, etc.) as follows:
+ * ```
+ * const myWorkflow = restate.workflows.workflow("org.acme.myworkflow", {
+ * // workflow implementation
+ * })
+ * restate.createServer().bind(myWorkflow)
+ * ```
+ *
+ * The {@link WorkflowServices.api} can be used to create typed clients, both
+ * from other Restate-backed serviced (e.g., `ctx.rpc(api).triggerMySignal()`)
+ * or from external clients (`clients.connectWorkflows(restateUri).connectToWorkflow(api, id);`).
+ */
+export interface WorkflowServices<R, T, U> extends restate.ServiceBundle {
+    readonly api: restate.ServiceApi<WorkflowRestateRpcApi<R, T, U>>;
+}
+export type DurablePromise<T> = restate.CombineablePromise<T> & {
+    peek(): Promise<T | null>;
+    resolve(value?: T): void;
+    reject(errorMsg: string): void;
+};
+/**
+ * The context for the workflow's interaction methods, which are all methods
+ * other than the 'run()' method.
+ *
+ * This gives primarily access to state reads and promises.
+ */
+export interface SharedWfContext {
+    workflowId(): string;
+    get<T>(stateName: string): Promise<T | null>;
+    promise<T = void>(name: string): DurablePromise<T>;
+}
+/**
+ * The context for the workflow's 'run()' function.
+ *
+ * This is a full context as for stateful durable keyed services, plus the
+ * workflow-specific bits, like workflowID and durable promises.
+ */
+export interface WfContext extends SharedWfContext, restate.KeyedContext {
+}
+export declare enum LifecycleStatus {
+    NOT_STARTED = "NOT_STARTED",
+    RUNNING = "RUNNING",
+    FINISHED = "FINISHED",
+    FAILED = "FAILED"
+}
+export declare enum WorkflowStartResult {
+    STARTED = "STARTED",
+    ALREADY_STARTED = "ALREADY_STARTED",
+    ALREADY_FINISHED = "ALREADY_FINISHED"
+}
+/**
+ * The type of requests accepted by the workflow service.
+ * Must contain the 'workflowId' property.
+ */
+export type WorkflowRequest<T> = T & {
+    workflowId: string;
+};
+/**
+ * The API signature of the workflow for use with RPC operations from Restate services.
+ */
+export type WorkflowRestateRpcApi<R, T, U> = {
+    start: (param: WorkflowRequest<T>) => Promise<WorkflowStartResult>;
+    waitForResult: (request: WorkflowRequest<unknown>) => Promise<R>;
+    status: (request: WorkflowRequest<unknown>) => Promise<LifecycleStatus>;
+} & {
+    [K in keyof Omit<U, "run">]: U[K] extends InteractionMethod<infer R, infer T> ? (request: WorkflowRequest<T>) => Promise<R> : never;
+};
+/**
+ * The API signature of the workflow for external clients.
+ */
+export type WorkflowClientApi<U> = {
+    [K in keyof Omit<U, "run">]: U[K] extends (ctx: SharedWfContext) => Promise<infer R> ? () => Promise<R> : U[K] extends (ctx: SharedWfContext, params: infer T) => Promise<infer R> ? (request: T) => Promise<R> : never;
+};
+export {};
+//# sourceMappingURL=workflow.d.ts.map

package/dist/workflows/workflow.d.ts.map

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

package/dist/workflows/workflow.js

@@ -0,0 +1,80 @@
+"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
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowStartResult = exports.LifecycleStatus = exports.workflow = void 0;
+const wws = __importStar(require("./workflow_wrapper_service"));
+const wss = __importStar(require("./workflow_state_service"));
+const STATE_SERVICE_PATH_SUFFIX = "_state";
+// ----------------------------------------------------------------------------
+//                    workflow definition / registration
+// ----------------------------------------------------------------------------
+/**
+ * Creates a new workflow service that will be served under the given path.
+ *
+ * A workflow must consist of
+ *   - one run method: `run(ctx: WfContext, params: T) => Promise<R>`
+ *   - an arbitrary number of interaction methods: `foo(ctx: SharedWfContext, params: X) => Promise<Y>`
+ */
+function workflow(path, workflow) {
+    // the state service manages all state and promises for us
+    const stateServiceRouter = wss.workflowStateService;
+    const stateServiceApi = {
+        path: path + STATE_SERVICE_PATH_SUFFIX,
+    };
+    // the wrapper service manages life cycle, contexts, delegation to the state service
+    const wrapperServiceRouter = wws.createWrapperService(workflow, path, stateServiceApi);
+    return {
+        api: { path },
+        registerServices: (endpoint) => {
+            endpoint.bindKeyedRouter(stateServiceApi.path, stateServiceRouter);
+            endpoint.bindRouter(path, wrapperServiceRouter);
+        },
+    };
+}
+exports.workflow = workflow;
+var LifecycleStatus;
+(function (LifecycleStatus) {
+    LifecycleStatus["NOT_STARTED"] = "NOT_STARTED";
+    LifecycleStatus["RUNNING"] = "RUNNING";
+    LifecycleStatus["FINISHED"] = "FINISHED";
+    LifecycleStatus["FAILED"] = "FAILED";
+})(LifecycleStatus = exports.LifecycleStatus || (exports.LifecycleStatus = {}));
+var WorkflowStartResult;
+(function (WorkflowStartResult) {
+    WorkflowStartResult["STARTED"] = "STARTED";
+    WorkflowStartResult["ALREADY_STARTED"] = "ALREADY_STARTED";
+    WorkflowStartResult["ALREADY_FINISHED"] = "ALREADY_FINISHED";
+})(WorkflowStartResult = exports.WorkflowStartResult || (exports.WorkflowStartResult = {}));
+//# sourceMappingURL=workflow.js.map

package/dist/workflows/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../src/workflows/workflow.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;;;;;;;;;;;;;;;;;;;;;;AAGH,gEAAkD;AAClD,8DAAgD;AAEhD,MAAM,yBAAyB,GAAG,QAAQ,CAAC;AAE3C,+EAA+E;AAC/E,wDAAwD;AACxD,+EAA+E;AAE/E;;;;;;GAMG;AACH,SAAgB,QAAQ,CACtB,IAAY,EACZ,QAA2B;IAE3B,0DAA0D;IAC1D,MAAM,kBAAkB,GAAG,GAAG,CAAC,oBAAoB,CAAC;IACpD,MAAM,eAAe,GAAgC;QACnD,IAAI,EAAE,IAAI,GAAG,yBAAyB;KACvC,CAAC;IAEF,oFAAoF;IACpF,MAAM,oBAAoB,GAAG,GAAG,CAAC,oBAAoB,CACnD,QAAQ,EACR,IAAI,EACJ,eAAe,CAChB,CAAC;IAEF,OAAO;QACL,GAAG,EAAE,EAAE,IAAI,EAAwD;QACnE,gBAAgB,EAAE,CAAC,QAAiC,EAAE,EAAE;YACtD,QAAQ,CAAC,eAAe,CAAC,eAAe,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;YACnE,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;QAClD,CAAC;KACkC,CAAC;AACxC,CAAC;AAxBD,4BAwBC;AA8ED,IAAY,eAKX;AALD,WAAY,eAAe;IACzB,8CAA2B,CAAA;IAC3B,sCAAmB,CAAA;IACnB,wCAAqB,CAAA;IACrB,oCAAiB,CAAA;AACnB,CAAC,EALW,eAAe,GAAf,uBAAe,KAAf,uBAAe,QAK1B;AAED,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC7B,0CAAmB,CAAA;IACnB,0DAAmC,CAAA;IACnC,4DAAqC,CAAA;AACvC,CAAC,EAJW,mBAAmB,GAAnB,2BAAmB,KAAnB,2BAAmB,QAI9B"}

package/dist/workflows/workflow_state_service.d.ts

@@ -0,0 +1,35 @@
+import * as restate from "../public_api";
+import { LifecycleStatus, WorkflowStartResult } from "./workflow";
+export type ValueOrError<T> = {
+    value?: T;
+    error?: string;
+};
+export declare const workflowStateService: restate.KeyedRouter<{
+    startWorkflow: (ctx: restate.KeyedContext) => Promise<WorkflowStartResult>;
+    finishOrFailWorkflow: <R>(ctx: restate.KeyedContext, _workflowId: string, result: ValueOrError<R>) => Promise<void>;
+    getStatus: (ctx: restate.KeyedContext) => Promise<LifecycleStatus>;
+    completePromise: <T>(ctx: restate.KeyedContext, _workflowId: string, req: {
+        promiseName: string;
+        completion: ValueOrError<T>;
+    }) => Promise<void>;
+    peekPromise: <T_1>(ctx: restate.KeyedContext, _workflowId: string, req: {
+        promiseName: string;
+    }) => Promise<ValueOrError<T_1> | null>;
+    subscribePromise: <T_2>(ctx: restate.KeyedContext, _workflowId: string, req: {
+        promiseName: string;
+        awkId: string;
+    }) => Promise<ValueOrError<T_2> | null>;
+    getResult: <R_1>(ctx: restate.KeyedContext) => Promise<ValueOrError<R_1> | null>;
+    subscribeResult: <T_3>(ctx: restate.KeyedContext, workflowId: string, awkId: string) => Promise<ValueOrError<T_3> | null>;
+    getState: <T_4>(ctx: restate.KeyedContext, _workflowId: string, stateName: string) => Promise<T_4 | null>;
+    setState: <T_5>(ctx: restate.KeyedContext, _workflowId: string, request: {
+        stateName: string;
+        value: T_5;
+    }) => Promise<void>;
+    clearState: (ctx: restate.KeyedContext, _workflowId: string, stateName: string) => Promise<void>;
+    stateKeys: (ctx: restate.KeyedContext) => Promise<Array<string>>;
+    clearAllState: (ctx: restate.KeyedContext) => Promise<void>;
+    dispose: (ctx: restate.KeyedContext) => Promise<void>;
+}>;
+export type api = typeof workflowStateService;
+//# sourceMappingURL=workflow_state_service.d.ts.map

package/dist/workflows/workflow_state_service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow_state_service.d.ts","sourceRoot":"","sources":["../../src/workflows/workflow_state_service.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,OAAO,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AASlE,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;IAC5B,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,oBAAoB;yBAExB,QAAQ,YAAY,KACxB,QAAQ,mBAAmB,CAAC;mCAgBxB,QAAQ,YAAY,eACZ,MAAM,8BAElB,QAAQ,IAAI,CAAC;qBA2BO,QAAQ,YAAY,KAAG,QAAQ,eAAe,CAAC;8BAQ/D,QAAQ,YAAY,eACZ,MAAM;qBACC,MAAM;;UACzB,QAAQ,IAAI,CAAC;4BAeT,QAAQ,YAAY,eACZ,MAAM,OACd;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE;iCAMvB,QAAQ,YAAY,eACZ,MAAM,OACd;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;0BAWtC,QAAQ,YAAY;gCAMpB,QAAQ,YAAY,cACb,MAAM,SACX,MAAM;yBAmBR,QAAQ,YAAY,eACZ,MAAM,aACR,MAAM;yBAMZ,QAAQ,YAAY,eACZ,MAAM;mBACG,MAAM;;UAC3B,QAAQ,IAAI,CAAC;sBAqBT,QAAQ,YAAY,eACZ,MAAM,aACR,MAAM,KAChB,QAAQ,IAAI,CAAC;qBAIO,QAAQ,YAAY,KAAG,QAAQ,MAAM,MAAM,CAAC,CAAC;yBAMzC,QAAQ,YAAY,KAAG,QAAQ,IAAI,CAAC;mBAS1C,QAAQ,YAAY,KAAG,QAAQ,IAAI,CAAC;EAGzD,CAAC;AAEH,MAAM,MAAM,GAAG,GAAG,OAAO,oBAAoB,CAAC"}