@restatedev/restate-sdk 1.4.0 → 1.5.1

package/dist/cjs/src/promises.js

@@ -0,0 +1,323 @@
+"use strict";
+/*
+ * Copyright (c) 2023-2025 - 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.PromisesExecutor = exports.RestateMappedPromise = exports.InvocationPendingPromise = exports.RestatePendingPromise = exports.RestateCombinatorPromise = exports.RestateInvocationPromise = exports.RestateSinglePromise = exports.extractContext = exports.RESTATE_CTX_SYMBOL = exports.pendingPromise = void 0;
+const errors_js_1 = require("./types/errors.js");
+const completable_promise_js_1 = require("./utils/completable_promise.js");
+const promises_1 = require("timers/promises");
+// A promise that is never completed
+function pendingPromise() {
+    // eslint-disable-next-line @typescript-eslint/no-empty-function
+    return new Promise(() => { });
+}
+exports.pendingPromise = pendingPromise;
+// ------ Restate promises ------
+// These promises are "proxy promises" that will be handed over to the user,
+// and moved forward by the PromiseExecutor below when the user awaits on them.
+var PromiseState;
+(function (PromiseState) {
+    PromiseState[PromiseState["COMPLETED"] = 0] = "COMPLETED";
+    PromiseState[PromiseState["NOT_COMPLETED"] = 1] = "NOT_COMPLETED";
+})(PromiseState || (PromiseState = {}));
+exports.RESTATE_CTX_SYMBOL = Symbol("restateContext");
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function extractContext(n) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+    return n[exports.RESTATE_CTX_SYMBOL];
+}
+exports.extractContext = extractContext;
+class AbstractRestatePromise {
+    [exports.RESTATE_CTX_SYMBOL];
+    pollingPromise;
+    cancelPromise = new completable_promise_js_1.CompletablePromise();
+    constructor(ctx) {
+        this[exports.RESTATE_CTX_SYMBOL] = ctx;
+    }
+    // --- Promise methods
+    then(onfulfilled, onrejected) {
+        this.pollingPromise =
+            this.pollingPromise ||
+                this[exports.RESTATE_CTX_SYMBOL].promisesExecutor
+                    .doProgress(this)
+                    .catch(() => { });
+        return this.publicPromiseOrCancelPromise().then(onfulfilled, onrejected);
+    }
+    catch(onrejected) {
+        this.pollingPromise =
+            this.pollingPromise ||
+                this[exports.RESTATE_CTX_SYMBOL].promisesExecutor
+                    .doProgress(this)
+                    .catch(() => { });
+        return this.publicPromiseOrCancelPromise().catch(onrejected);
+    }
+    finally(onfinally) {
+        this.pollingPromise =
+            this.pollingPromise ||
+                this[exports.RESTATE_CTX_SYMBOL].promisesExecutor
+                    .doProgress(this)
+                    .catch(() => { });
+        return this.publicPromiseOrCancelPromise().finally(onfinally);
+    }
+    publicPromiseOrCancelPromise() {
+        return Promise.race([
+            this.cancelPromise.promise,
+            this.publicPromise(),
+        ]);
+    }
+    // --- Combineable Promise methods
+    orTimeout(millis) {
+        return new RestateCombinatorPromise(this[exports.RESTATE_CTX_SYMBOL], ([thisPromise, sleepPromise]) => {
+            return new Promise((resolve, reject) => {
+                thisPromise.then(resolve, reject);
+                sleepPromise.then(() => {
+                    reject(new errors_js_1.TimeoutError());
+                }, reject);
+            });
+        }, [this, this[exports.RESTATE_CTX_SYMBOL].sleep(millis)]);
+    }
+    map(mapper) {
+        return new RestateMappedPromise(this[exports.RESTATE_CTX_SYMBOL], this, mapper);
+    }
+    tryCancel() {
+        this.cancelPromise.reject(new errors_js_1.CancelledError());
+    }
+}
+class RestateSinglePromise extends AbstractRestatePromise {
+    handle;
+    completer;
+    state = PromiseState.NOT_COMPLETED;
+    completablePromise = new completable_promise_js_1.CompletablePromise();
+    constructor(ctx, handle, completer) {
+        super(ctx);
+        this.handle = handle;
+        this.completer = completer;
+    }
+    uncompletedLeaves() {
+        return this.state === PromiseState.COMPLETED ? [] : [this.handle];
+    }
+    tryComplete() {
+        if (this.state === PromiseState.COMPLETED) {
+            return;
+        }
+        const notification = this[exports.RESTATE_CTX_SYMBOL].coreVm.take_notification(this.handle);
+        if (notification === "NotReady") {
+            return;
+        }
+        this.state = PromiseState.COMPLETED;
+        this.completer(notification, this.completablePromise);
+    }
+    publicPromise() {
+        return this.completablePromise.promise;
+    }
+    [Symbol.toStringTag] = "RestateSinglePromise";
+}
+exports.RestateSinglePromise = RestateSinglePromise;
+class RestateInvocationPromise extends RestateSinglePromise {
+    invocationIdPromise;
+    constructor(ctx, handle, completer, invocationIdPromise) {
+        super(ctx, handle, completer);
+        this.invocationIdPromise = invocationIdPromise;
+    }
+    get invocationId() {
+        return this.invocationIdPromise;
+    }
+}
+exports.RestateInvocationPromise = RestateInvocationPromise;
+class RestateCombinatorPromise extends AbstractRestatePromise {
+    childs;
+    state = PromiseState.NOT_COMPLETED;
+    combinatorPromise;
+    constructor(ctx, combinatorConstructor, childs) {
+        super(ctx);
+        this.childs = childs;
+        this.combinatorPromise = combinatorConstructor(childs.map((p) => p.publicPromise())).finally(() => {
+            this.state = PromiseState.COMPLETED;
+        });
+    }
+    uncompletedLeaves() {
+        return this.state === PromiseState.COMPLETED
+            ? []
+            : this.childs.flatMap((p) => p.uncompletedLeaves());
+    }
+    tryComplete() {
+        this.childs.forEach((c) => c.tryComplete());
+    }
+    publicPromise() {
+        return this.combinatorPromise;
+    }
+    [Symbol.toStringTag] = "RestateCombinatorPromise";
+}
+exports.RestateCombinatorPromise = RestateCombinatorPromise;
+class RestatePendingPromise {
+    [exports.RESTATE_CTX_SYMBOL];
+    constructor(ctx) {
+        this[exports.RESTATE_CTX_SYMBOL] = ctx;
+    }
+    // --- Promise methods
+    then(onfulfilled, onrejected) {
+        return pendingPromise().then(onfulfilled, onrejected);
+    }
+    catch(onrejected) {
+        return pendingPromise().catch(onrejected);
+    }
+    finally(onfinally) {
+        return pendingPromise().finally(onfinally);
+    }
+    // --- RestatePromise methods
+    orTimeout() {
+        return this;
+    }
+    map() {
+        return this;
+    }
+    tryCancel() { }
+    tryComplete() { }
+    uncompletedLeaves() {
+        return [];
+    }
+    publicPromise() {
+        return pendingPromise();
+    }
+    [Symbol.toStringTag] = "RestatePendingPromise";
+}
+exports.RestatePendingPromise = RestatePendingPromise;
+class InvocationPendingPromise extends RestatePendingPromise {
+    constructor(ctx) {
+        super(ctx);
+    }
+    get invocationId() {
+        return pendingPromise();
+    }
+}
+exports.InvocationPendingPromise = InvocationPendingPromise;
+class RestateMappedPromise extends AbstractRestatePromise {
+    inner;
+    publicPromiseMapper;
+    constructor(ctx, inner, mapper) {
+        super(ctx);
+        this.inner = inner;
+        this.publicPromiseMapper = (value, failure) => {
+            try {
+                return Promise.resolve(mapper(value, failure));
+            }
+            catch (e) {
+                if (e instanceof errors_js_1.TerminalError) {
+                    return Promise.reject(e);
+                }
+                else {
+                    ctx.handleInvocationEndError(e);
+                    return pendingPromise();
+                }
+            }
+        };
+    }
+    tryComplete() {
+        this.inner.tryComplete();
+    }
+    uncompletedLeaves() {
+        return this.inner.uncompletedLeaves();
+    }
+    publicPromise() {
+        const promiseMapper = this.publicPromiseMapper;
+        return this.inner.publicPromise().then((t) => promiseMapper(t, undefined), (error) => {
+            if (error instanceof errors_js_1.RestateError) {
+                return promiseMapper(undefined, error);
+            }
+            else {
+                // Something else, just re-throw it
+                throw error;
+            }
+        });
+    }
+    [Symbol.toStringTag] = "RestateMappedPromise";
+}
+exports.RestateMappedPromise = RestateMappedPromise;
+/**
+ * Promises executor, gluing VM with I/O and Promises given to user space.
+ */
+class PromisesExecutor {
+    coreVm;
+    inputPump;
+    outputPump;
+    runClosuresTracker;
+    errorCallback;
+    constructor(coreVm, inputPump, outputPump, runClosuresTracker, errorCallback) {
+        this.coreVm = coreVm;
+        this.inputPump = inputPump;
+        this.outputPump = outputPump;
+        this.runClosuresTracker = runClosuresTracker;
+        this.errorCallback = errorCallback;
+    }
+    async doProgress(restatePromise) {
+        // Only the first time try process output
+        await this.outputPump.awaitNextProgress();
+        await this.doProgressInner(restatePromise);
+    }
+    async doProgressInner(restatePromise) {
+        // Try complete the promise
+        try {
+            restatePromise.tryComplete();
+        }
+        catch (e) {
+            // This can happen if either take_notification throws an exception or completer throws an exception.
+            // Both should be programming mistakes of the SDK, but we cover them here.
+            restatePromise[exports.RESTATE_CTX_SYMBOL].handleInvocationEndError(e);
+            return Promise.resolve();
+        }
+        // tl;dr don't touch this, or you can break combineable promises,
+        // slinkydeveloper won't be happy about it
+        //
+        // The reason for this setTimeout is that we need to enqueue the polling after
+        // we eventually resolve some promises. This is especially crucial for RestateCombinatorPromise
+        // as it flips the completed state using .finally() on the combinator.
+        return (0, promises_1.setTimeout)().then(async () => {
+            try {
+                // Invoke do progress on the vm
+                const handles = restatePromise.uncompletedLeaves();
+                if (handles.length === 0) {
+                    // Completed, we're good!
+                    return;
+                }
+                const doProgressResult = this.coreVm.do_progress(new Uint32Array(handles));
+                if (doProgressResult === "AnyCompleted") {
+                    // Next recursion will cause the promise to do some progress
+                }
+                else if (doProgressResult === "ReadFromInput") {
+                    // Read from input
+                    await this.inputPump.awaitNextProgress();
+                }
+                else if (doProgressResult === "WaitingPendingRun") {
+                    // Wait for any of the pending run to complete
+                    await this.runClosuresTracker.awaitNextCompletedRun();
+                }
+                else if (doProgressResult === "CancelSignalReceived") {
+                    restatePromise.tryCancel();
+                    return;
+                }
+                else {
+                    // We need to execute a run closure
+                    this.runClosuresTracker.executeRun(doProgressResult.ExecuteRun);
+                    // Let the run context switch, then come back to this flow.
+                    await (0, promises_1.setTimeout)();
+                }
+                // Recursion
+                await this.doProgress(restatePromise);
+            }
+            catch (e) {
+                // Not good, this is a retryable error.
+                this.errorCallback(e);
+            }
+        });
+    }
+}
+exports.PromisesExecutor = PromisesExecutor;
+//# sourceMappingURL=promises.js.map

package/dist/cjs/src/promises.js.map

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

package/dist/cjs/src/types/components.d.ts

@@ -15,8 +15,10 @@ export interface ComponentHandler {
 }
 export declare class ServiceComponent implements Component {
     private readonly componentName;
+    readonly description?: string | undefined;
+    readonly metadata?: Record<string, string> | undefined;
     private readonly handlers;
-    constructor(componentName: string);
+    constructor(componentName: string, description?: string | undefined, metadata?: Record<string, string> | undefined);
     name(): string;
     add(name: string, handlerWrapper: HandlerWrapper): void;
     discovery(): d.Service;
@@ -34,8 +36,10 @@ export declare class ServiceHandler implements ComponentHandler {
 }
 export declare class VirtualObjectComponent implements Component {
     readonly componentName: string;
+    readonly description?: string | undefined;
+    readonly metadata?: Record<string, string> | undefined;
     private readonly handlers;
-    constructor(componentName: string);
+    constructor(componentName: string, description?: string | undefined, metadata?: Record<string, string> | undefined);
     name(): string;
     add(name: string, wrapper: HandlerWrapper): void;
     discovery(): d.Service;
@@ -53,8 +57,10 @@ export declare class VirtualObjectHandler implements ComponentHandler {
 }
 export declare class WorkflowComponent implements Component {
     readonly componentName: string;
+    readonly description?: string | undefined;
+    readonly metadata?: Record<string, string> | undefined;
     private readonly handlers;
-    constructor(componentName: string);
+    constructor(componentName: string, description?: string | undefined, metadata?: Record<string, string> | undefined);
     name(): string;
     add(name: string, wrapper: HandlerWrapper): void;
     discovery(): d.Service;
@@ -72,6 +78,8 @@ export declare class WorkflowHandler implements ComponentHandler {
 }
 export type PathComponents = InvokePathComponents | {
     type: "discover";
+} | {
+    type: "health";
 } | {
     type: "unknown";
     path: string;

package/dist/cjs/src/types/components.d.ts.map

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

package/dist/cjs/src/types/components.js

@@ -43,9 +43,13 @@ const rpc_js_1 = require("./rpc.js");
 //
 class ServiceComponent {
     componentName;
+    description;
+    metadata;
     handlers = new Map();
-    constructor(componentName) {
+    constructor(componentName, description, metadata) {
         this.componentName = componentName;
+        this.description = description;
+        this.metadata = metadata;
     }
     name() {
         return this.componentName;
@@ -61,17 +65,23 @@ class ServiceComponent {
                 input: {
                     required: false,
                     contentType: serviceHandler.handlerWrapper.accept ?? "application/json",
+                    jsonSchema: serviceHandler.handlerWrapper.inputSerde.jsonSchema,
                 },
                 output: {
                     setContentTypeIfEmpty: false,
                     contentType: serviceHandler.handlerWrapper.contentType ?? "application/json",
+                    jsonSchema: serviceHandler.handlerWrapper.outputSerde.jsonSchema,
                 },
+                documentation: serviceHandler.handlerWrapper.description,
+                metadata: serviceHandler.handlerWrapper.metadata,
             };
         });
         return {
             name: this.componentName,
             ty: d.ServiceType.SERVICE,
             handlers,
+            documentations: this.description,
+            metadata: this.metadata,
         };
     }
     handlerMatching(url) {
@@ -107,9 +117,13 @@ exports.ServiceHandler = ServiceHandler;
 //
 class VirtualObjectComponent {
     componentName;
+    description;
+    metadata;
     handlers = new Map();
-    constructor(componentName) {
+    constructor(componentName, description, metadata) {
         this.componentName = componentName;
+        this.description = description;
+        this.metadata = metadata;
     }
     name() {
         return this.componentName;
@@ -124,20 +138,26 @@ class VirtualObjectComponent {
                 input: {
                     required: false,
                     contentType: opts.accept ?? "application/json",
+                    jsonSchema: opts.inputSerde.jsonSchema,
                 },
                 output: {
                     setContentTypeIfEmpty: false,
                     contentType: opts.contentType ?? "application/json",
+                    jsonSchema: opts.outputSerde.jsonSchema,
                 },
                 ty: opts.kind === rpc_js_1.HandlerKind.EXCLUSIVE
                     ? d.ServiceHandlerType.EXCLUSIVE
                     : d.ServiceHandlerType.SHARED,
+                documentation: opts.description,
+                metadata: opts.metadata,
             };
         });
         return {
             name: this.componentName,
             ty: d.ServiceType.VIRTUAL_OBJECT,
             handlers,
+            documentations: this.description,
+            metadata: this.metadata,
         };
     }
     handlerMatching(url) {
@@ -175,9 +195,13 @@ exports.VirtualObjectHandler = VirtualObjectHandler;
 // Workflow
 class WorkflowComponent {
     componentName;
+    description;
+    metadata;
     handlers = new Map();
-    constructor(componentName) {
+    constructor(componentName, description, metadata) {
         this.componentName = componentName;
+        this.description = description;
+        this.metadata = metadata;
     }
     name() {
         return this.componentName;
@@ -192,20 +216,26 @@ class WorkflowComponent {
                 input: {
                     required: false,
                     contentType: handler.accept ?? "application/json",
+                    jsonSchema: handler.inputSerde.jsonSchema,
                 },
                 output: {
                     setContentTypeIfEmpty: false,
                     contentType: handler.contentType ?? "application/json",
+                    jsonSchema: handler.outputSerde.jsonSchema,
                 },
                 ty: handler.kind === rpc_js_1.HandlerKind.WORKFLOW
                     ? d.ServiceHandlerType.WORKFLOW
                     : d.ServiceHandlerType.SHARED,
+                documentation: handler.description,
+                metadata: handler.metadata,
             };
         });
         return {
             name: this.componentName,
             ty: d.ServiceType.WORKFLOW,
             handlers,
+            documentations: this.description,
+            metadata: this.metadata,
         };
     }
     handlerMatching(url) {
@@ -255,6 +285,9 @@ function parseUrlComponents(urlPath) {
     if (fragments.length > 0 && fragments[fragments.length - 1] === "discover") {
         return { type: "discover" };
     }
+    if (fragments.length > 0 && fragments[fragments.length - 1] === "health") {
+        return { type: "health" };
+    }
     return { type: "unknown", path: urlPath };
 }
 exports.parseUrlComponents = parseUrlComponents;

package/dist/cjs/src/types/components.js.map

@@ -1 +1 @@
-{"version":3,"file":"components.js","sourceRoot":"","sources":["../../../../src/types/components.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,iDAAiD;AACjD,uDAAuD;AAEvD,kDAAoC;AAGpC,qCAAuC;AAkBvC,EAAE;AACF,UAAU;AACV,EAAE;AAEF,MAAa,gBAAgB;IAGE;IAFZ,QAAQ,GAAgC,IAAI,GAAG,EAAE,CAAC;IAEnE,YAA6B,aAAqB;QAArB,kBAAa,GAAb,aAAa,CAAQ;IAAG,CAAC;IAEtD,IAAI;QACF,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,GAAG,CAAC,IAAY,EAAE,cAA8B;QAC9C,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;QACtE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAC1C,CAAC;IAED,SAAS;QACP,MAAM,QAAQ,GAAgB,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAC5D,CAAC,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE;YACzB,OAAO;gBACL,IAAI;gBACJ,KAAK,EAAE;oBACL,QAAQ,EAAE,KAAK;oBACf,WAAW,EACT,cAAc,CAAC,cAAc,CAAC,MAAM,IAAI,kBAAkB;iBAC7D;gBACD,MAAM,EAAE;oBACN,qBAAqB,EAAE,KAAK;oBAC5B,WAAW,EACT,cAAc,CAAC,cAAc,CAAC,WAAW,IAAI,kBAAkB;iBAClE;aACF,CAAC;QACJ,CAAC,CACF,CAAC;QAEF,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,aAAa;YACxB,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,OAAO;YACzB,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,eAAe,CAAC,GAAyB;QACvC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC5C,CAAC;CACF;AA3CD,4CA2CC;AAED,MAAa,cAAc;IACR,WAAW,CAAS;IACpB,MAAM,CAAmB;IAC1B,cAAc,CAAiB;IAE/C,YACE,IAAY,EACZ,cAA8B,EAC9B,MAAwB;QAExB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;IAClC,CAAC;IAED,MAAM,CAAC,OAAoB,EAAE,KAAiB;QAC5C,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AA9BD,wCA8BC;AAED,EAAE;AACF,iBAAiB;AACjB,EAAE;AAEF,MAAa,sBAAsB;IAGL;IAFX,QAAQ,GAAgC,IAAI,GAAG,EAAE,CAAC;IAEnE,YAA4B,aAAqB;QAArB,kBAAa,GAAb,aAAa,CAAQ;IAAG,CAAC;IAErD,IAAI;QACF,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,GAAG,CAAC,IAAY,EAAE,OAAuB;QACvC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,SAAS;QACP,MAAM,QAAQ,GAAgB,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAC5D,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;YACf,OAAO;gBACL,IAAI;gBACJ,KAAK,EAAE;oBACL,QAAQ,EAAE,KAAK;oBACf,WAAW,EAAE,IAAI,CAAC,MAAM,IAAI,kBAAkB;iBAC/C;gBACD,MAAM,EAAE;oBACN,qBAAqB,EAAE,KAAK;oBAC5B,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,kBAAkB;iBACpD;gBACD,EAAE,EACA,IAAI,CAAC,IAAI,KAAK,oBAAW,CAAC,SAAS;oBACjC,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,SAAS;oBAChC,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,MAAM;aAClC,CAAC;QACJ,CAAC,CACF,CAAC;QAEF,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,aAAa;YACxB,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,cAAc;YAChC,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,eAAe,CAAC,GAAyB;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,oBAAoB,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;CACF;AAhDD,wDAgDC;AAED,MAAa,oBAAoB;IAEZ;IACA;IACA;IAHnB,YACmB,aAAqB,EACrB,MAA8B,EAC9B,cAA8B;QAF9B,kBAAa,GAAb,aAAa,CAAQ;QACrB,WAAM,GAAN,MAAM,CAAwB;QAC9B,mBAAc,GAAd,cAAc,CAAgB;IAC9C,CAAC;IAEJ,IAAI;QACF,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IACD,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;IAClC,CAAC;IAED,MAAM,CAAC,OAAoB,EAAE,KAAiB;QAC5C,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC;CACF;AArBD,oDAqBC;AAED,WAAW;AAEX,MAAa,iBAAiB;IAGA;IAFX,QAAQ,GAAgC,IAAI,GAAG,EAAE,CAAC;IAEnE,YAA4B,aAAqB;QAArB,kBAAa,GAAb,aAAa,CAAQ;IAAG,CAAC;IAErD,IAAI;QACF,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,GAAG,CAAC,IAAY,EAAE,OAAuB;QACvC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,SAAS;QACP,MAAM,QAAQ,GAAgB,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAC5D,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE;YAClB,OAAO;gBACL,IAAI;gBACJ,KAAK,EAAE;oBACL,QAAQ,EAAE,KAAK;oBACf,WAAW,EAAE,OAAO,CAAC,MAAM,IAAI,kBAAkB;iBAClD;gBACD,MAAM,EAAE;oBACN,qBAAqB,EAAE,KAAK;oBAC5B,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,kBAAkB;iBACvD;gBACD,EAAE,EACA,OAAO,CAAC,IAAI,KAAK,oBAAW,CAAC,QAAQ;oBACnC,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,QAAQ;oBAC/B,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,MAAM;aAClC,CAAC;QACJ,CAAC,CACF,CAAC;QAEF,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,aAAa;YACxB,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,QAAQ;YAC1B,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,eAAe,CAAC,GAAyB;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,eAAe,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;CACF;AAhDD,8CAgDC;AAED,MAAa,eAAe;IAEP;IACA;IACA;IAHnB,YACmB,aAAqB,EACrB,MAAyB,EACzB,cAA8B;QAF9B,kBAAa,GAAb,aAAa,CAAQ;QACrB,WAAM,GAAN,MAAM,CAAmB;QACzB,mBAAc,GAAd,cAAc,CAAgB;IAC9C,CAAC;IAEJ,IAAI;QACF,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IACD,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;IAClC,CAAC;IAED,MAAM,CAAC,OAAoB,EAAE,KAAiB;QAC5C,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC;CACF;AArBD,0CAqBC;AAaD,SAAgB,kBAAkB,CAAC,OAAgB;IACjD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACvC,CAAC;IACD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,SAAS,CAAC,MAAM,IAAI,CAAC,IAAI,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1E,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,aAAa,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;YAC9C,WAAW,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;SAC7C,CAAC;IACJ,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;QAC3E,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC9B,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC5C,CAAC;AAhBD,gDAgBC"}
+{"version":3,"file":"components.js","sourceRoot":"","sources":["../../../../src/types/components.ts"],"names":[],"mappings":"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"}

package/dist/cjs/src/types/discovery.d.ts

@@ -27,11 +27,15 @@ export interface Handler {
     ty?: ServiceHandlerType;
     input?: InputPayload;
     output?: OutputPayload;
+    metadata?: Record<string, string>;
+    documentation?: string;
 }
 export interface Service {
     name: string;
     ty: ServiceType;
     handlers: Handler[];
+    metadata?: Record<string, string>;
+    documentations?: string;
 }
 export interface Endpoint {
     protocolMode: ProtocolMode;

package/dist/cjs/src/types/discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../../src/types/discovery.ts"],"names":[],"mappings":"AAWA,oBAAY,YAAY;IACtB,WAAW,gBAAgB;IAC3B,gBAAgB,qBAAqB;CACtC;AAED,oBAAY,WAAW;IACrB,cAAc,mBAAmB;IACjC,OAAO,YAAY;IACnB,QAAQ,aAAa;CACtB;AAED,oBAAY,kBAAkB;IAC5B,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,MAAM,WAAW;CAClB;AAED,KAAK,YAAY,GAAG;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IAEpB,UAAU,CAAC,EAAE,GAAG,CAAC;CAClB,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,OAAO,CAAC;IAE/B,UAAU,CAAC,EAAE,GAAG,CAAC;CAClB,CAAC;AAEF,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,kBAAkB,CAAC;IACxB,KAAK,CAAC,EAAE,YAAY,CAAC;IAErB,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,WAAW,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,YAAY,EAAE,YAAY,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB"}
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../../src/types/discovery.ts"],"names":[],"mappings":"AAWA,oBAAY,YAAY;IACtB,WAAW,gBAAgB;IAC3B,gBAAgB,qBAAqB;CACtC;AAED,oBAAY,WAAW;IACrB,cAAc,mBAAmB;IACjC,OAAO,YAAY;IACnB,QAAQ,aAAa;CACtB;AAED,oBAAY,kBAAkB;IAC5B,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,MAAM,WAAW;CAClB;AAED,KAAK,YAAY,GAAG;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IAEpB,UAAU,CAAC,EAAE,GAAG,CAAC;CAClB,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,OAAO,CAAC;IAE/B,UAAU,CAAC,EAAE,GAAG,CAAC;CAClB,CAAC;AAEF,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,kBAAkB,CAAC;IACxB,KAAK,CAAC,EAAE,YAAY,CAAC;IAErB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,WAAW,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,QAAQ;IACvB,YAAY,EAAE,YAAY,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB"}

package/dist/cjs/src/types/errors.d.ts

@@ -1,22 +1,30 @@
 export declare const INTERNAL_ERROR_CODE = 500;
 export declare const TIMEOUT_ERROR_CODE = 408;
+export declare const CANCEL_ERROR_CODE = 409;
 export declare const UNKNOWN_ERROR_CODE = 500;
 export declare const SUSPENDED_ERROR_CODE = 599;
 export declare function ensureError(e: unknown): Error;
 export declare class RestateError extends Error {
     readonly code: number;
+    name: string;
     constructor(message: string, options?: {
         errorCode?: number;
         cause?: any;
     });
 }
 export declare class TerminalError extends RestateError {
+    name: string;
     constructor(message: string, options?: {
         errorCode?: number;
         cause?: any;
     });
 }
 export declare class TimeoutError extends TerminalError {
+    name: string;
+    constructor();
+}
+export declare class CancelledError extends TerminalError {
+    name: string;
     constructor();
 }
 //# sourceMappingURL=errors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/types/errors.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAGtC,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,KAAK,CAmB7C;AAED,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,GAAG,CAAA;KAAE;CAI3E;AAID,qBAAa,aAAc,SAAQ,YAAY;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,GAAG,CAAA;KAAE;CAG3E;AAED,qBAAa,YAAa,SAAQ,aAAa;;CAI9C"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/types/errors.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAGtC,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,KAAK,CAmB7C;AAED,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAgB,IAAI,EAAE,MAAM,CAAC;IACtB,IAAI,SAAkB;gBAEjB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,GAAG,CAAA;KAAE;CAI3E;AAID,qBAAa,aAAc,SAAQ,YAAY;IACtC,IAAI,SAAmB;gBAElB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,GAAG,CAAA;KAAE;CAG3E;AAED,qBAAa,YAAa,SAAQ,aAAa;IACtC,IAAI,SAAkB;;CAK9B;AAED,qBAAa,cAAe,SAAQ,aAAa;IACxC,IAAI,SAAoB;;CAKhC"}