@restatedev/restate-sdk 0.7.3-worker → 0.8.1

package/dist/promise_combinator_tracker.d.ts

@@ -0,0 +1,29 @@
+import { WrappedPromise } from "./utils/promises";
+export declare enum PromiseType {
+    JournalEntry = 0
+}
+export interface PromiseId {
+    type: PromiseType;
+    id: number;
+}
+export declare function newJournalEntryPromiseId(entryIndex: number): PromiseId;
+/**
+ * This class takes care of creating and managing deterministic promise combinators.
+ *
+ * It should be wired up to the journal/state machine methods to read and write entries.
+ */
+export declare class PromiseCombinatorTracker {
+    private readonly readReplayOrder;
+    private readonly onWriteCombinatorOrder;
+    private nextCombinatorIndex;
+    private pendingCombinators;
+    constructor(readReplayOrder: (combinatorIndex: number) => PromiseId[] | undefined, onWriteCombinatorOrder: (combinatorIndex: number, order: PromiseId[]) => Promise<void>);
+    createCombinator(combinatorConstructor: (promises: PromiseLike<unknown>[]) => Promise<unknown>, promises: Array<{
+        id: PromiseId;
+        promise: Promise<unknown>;
+    }>): WrappedPromise<unknown>;
+    private appendOrder;
+    private onCombinatorReplayed;
+    private onCombinatorResolved;
+}
+//# sourceMappingURL=promise_combinator_tracker.d.ts.map

package/dist/promise_combinator_tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise_combinator_tracker.d.ts","sourceRoot":"","sources":["../src/promise_combinator_tracker.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,cAAc,EACf,MAAM,kBAAkB,CAAC;AAE1B,oBAAY,WAAW;IACrB,YAAY,IAAA;CAGb;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAKtE;AAkGD;;;;GAIG;AACH,qBAAa,wBAAwB;IAKjC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAGhC,OAAO,CAAC,QAAQ,CAAC,sBAAsB;IAPzC,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,kBAAkB,CAAuC;gBAG9C,eAAe,EAAE,CAChC,eAAe,EAAE,MAAM,KACpB,SAAS,EAAE,GAAG,SAAS,EACX,sBAAsB,EAAE,CACvC,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,SAAS,EAAE,KACf,OAAO,CAAC,IAAI,CAAC;IAGb,gBAAgB,CACrB,qBAAqB,EAAE,CACrB,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,KAC7B,OAAO,CAAC,OAAO,CAAC,EACrB,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,SAAS,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC,GAC5D,cAAc,CAAC,OAAO,CAAC;IAkB1B,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,oBAAoB;YAKd,oBAAoB;CAanC"}

package/dist/promise_combinator_tracker.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromiseCombinatorTracker = exports.newJournalEntryPromiseId = exports.PromiseType = void 0;
+const promises_1 = require("./utils/promises");
+var PromiseType;
+(function (PromiseType) {
+    PromiseType[PromiseType["JournalEntry"] = 0] = "JournalEntry";
+    // Combinator?,
+    // SideEffect?
+})(PromiseType = exports.PromiseType || (exports.PromiseType = {}));
+function newJournalEntryPromiseId(entryIndex) {
+    return {
+        type: PromiseType.JournalEntry,
+        id: entryIndex,
+    };
+}
+exports.newJournalEntryPromiseId = newJournalEntryPromiseId;
+/**
+ * Prepare a Promise combinator
+ *
+ * @param combinatorIndex the index of this combinator
+ * @param combinatorConstructor the function that creates the combinator promise, e.g. Promise.all/any/race/allSettled
+ * @param promises the promises given by the user, and the respective ids
+ * @param readReplayOrder the function to read the replay order
+ * @param onNewCompleted callback when a child entry is resolved
+ * @param onCombinatorResolved callback when the combinator is resolved
+ * @param onCombinatorReplayed callback when the combinator is replayed
+ */
+function preparePromiseCombinator(combinatorIndex, combinatorConstructor, promises, readReplayOrder, onNewCompleted, onCombinatorResolved, onCombinatorReplayed) {
+    // Create the proxy promises and index them
+    const promisesWithProxyPromise = promises.map((v) => ({
+        id: v.id,
+        originalPromise: v.promise,
+        proxyPromise: new promises_1.CompletablePromise(),
+    }));
+    const promisesMap = new Map(promisesWithProxyPromise.map((v) => [
+        // We need to define a key format for this map...
+        v.id.type.toString() + "-" + v.id.id.toString(),
+        { originalPromise: v.originalPromise, proxyPromise: v.proxyPromise },
+    ]));
+    // Create the combinator using the proxy promises
+    const combinator = combinatorConstructor(promisesWithProxyPromise.map((v) => v.proxyPromise.promise)).finally(async () => 
+    // Once the combinator is resolved, notify back.
+    await onCombinatorResolved(combinatorIndex));
+    return (0, promises_1.wrapDeeply)(combinator, () => {
+        const replayOrder = readReplayOrder(combinatorIndex);
+        if (replayOrder === undefined) {
+            // We're in processing mode! We need to wire up original promises with proxy promises
+            for (const { originalPromise, proxyPromise, id, } of promisesWithProxyPromise) {
+                originalPromise
+                    // This code works deterministically because the javascript runtime will enqueue
+                    // the listeners of the proxy promise (which are mounted in Promise.all/any) in a single FIFO queue,
+                    // so a subsequent resolve on another proxy promise can't overtake this one.
+                    //
+                    // Some resources:
+                    // * https://stackoverflow.com/questions/38059284/why-does-javascript-promise-then-handler-run-after-other-code
+                    // * https://262.ecma-international.org/6.0/#sec-jobs-and-job-queues
+                    // * https://tr.javascript.info/microtask-queue
+                    .then((v) => {
+                    onNewCompleted(combinatorIndex, id);
+                    proxyPromise.resolve(v);
+                }, (e) => {
+                    onNewCompleted(combinatorIndex, id);
+                    proxyPromise.reject(e);
+                });
+            }
+            return;
+        }
+        // We're in replay mode, Now follow the replayIndexes order.
+        onCombinatorReplayed(combinatorIndex);
+        for (const promiseId of replayOrder) {
+            // These are already completed, so once we set the then callback they will be immediately resolved.
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            const { originalPromise, proxyPromise } = promisesMap.get(promiseId.type.toString() + "-" + promiseId.id.toString());
+            // Because this promise is already completed, promise.then will immediately enqueue in the promise microtask queue
+            // the handlers to execute.
+            // See the comment below for more details.
+            originalPromise.then((v) => proxyPromise.resolve(v), (e) => proxyPromise.reject(e));
+        }
+    });
+}
+/**
+ * This class takes care of creating and managing deterministic promise combinators.
+ *
+ * It should be wired up to the journal/state machine methods to read and write entries.
+ */
+class PromiseCombinatorTracker {
+    readReplayOrder;
+    onWriteCombinatorOrder;
+    nextCombinatorIndex = 0;
+    pendingCombinators = new Map();
+    constructor(readReplayOrder, onWriteCombinatorOrder) {
+        this.readReplayOrder = readReplayOrder;
+        this.onWriteCombinatorOrder = onWriteCombinatorOrder;
+    }
+    createCombinator(combinatorConstructor, promises) {
+        const combinatorIndex = this.nextCombinatorIndex;
+        this.nextCombinatorIndex++;
+        // Prepare combinator order
+        this.pendingCombinators.set(combinatorIndex, []);
+        return preparePromiseCombinator(combinatorIndex, combinatorConstructor, promises, this.readReplayOrder, this.appendOrder.bind(this), this.onCombinatorResolved.bind(this), this.onCombinatorReplayed.bind(this));
+    }
+    appendOrder(idx, promiseId) {
+        const order = this.pendingCombinators.get(idx);
+        if (order === undefined) {
+            // The order was already published, nothing to do here.
+            return;
+        }
+        order.push(promiseId);
+    }
+    onCombinatorReplayed(idx) {
+        // This avoids republishing the order
+        this.pendingCombinators.delete(idx);
+    }
+    async onCombinatorResolved(idx) {
+        const order = this.pendingCombinators.get(idx);
+        if (order === undefined) {
+            // It was already published
+            return;
+        }
+        // We don't need this list anymore.
+        this.pendingCombinators.delete(idx);
+        // Publish the combinator order
+        await this.onWriteCombinatorOrder(idx, order);
+    }
+}
+exports.PromiseCombinatorTracker = PromiseCombinatorTracker;
+//# sourceMappingURL=promise_combinator_tracker.js.map

package/dist/promise_combinator_tracker.js.map

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

package/dist/public_api.d.ts

@@ -1,10 +1,10 @@
-export { RestateContext, RestateGrpcContext, useContext, ServiceApi, RpcContext, } from "./restate_context";
+export { RestateContext, Context, KeyedContext, useContext, useKeyedContext, ServiceApi, CombineablePromise, Rand, RestateGrpcChannel, } from "./context";
 export { router, keyedRouter, keyedEventHandler, UnKeyedRouter, KeyedRouter, KeyedEventHandler, Client, SendClient, } from "./types/router";
-export { RestateServer, createServer } from "./server/restate_server";
-export { ServiceOpts } from "./server/base_restate_server";
-export { LambdaRestateServer, createLambdaApiGatewayHandler, } from "./server/restate_lambda_handler";
+export { endpoint, ServiceBundle, ServiceOpts, RestateEndpoint, } from "./endpoint";
 export * as RestateUtils from "./utils/public_utils";
-export { ErrorCodes, RestateError, TerminalError } from "./types/errors";
+export { ErrorCodes, RestateError, TerminalError, TimeoutError, } from "./types/errors";
 export { Event } from "./types/types";
 export { RestateConnection, connection, RestateConnectionOptions, } from "./embedded/api";
+export * as workflow from "./workflows/workflow";
+export * as clients from "./clients/workflow_client";
 //# sourceMappingURL=public_api.d.ts.map

package/dist/public_api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public_api.d.ts","sourceRoot":"","sources":["../src/public_api.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,UAAU,GACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,MAAM,EACN,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,MAAM,EACN,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EACL,mBAAmB,EACnB,6BAA6B,GAC9B,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,YAAY,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,wBAAwB,GACzB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"public_api.d.ts","sourceRoot":"","sources":["../src/public_api.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,cAAc,EACd,OAAO,EACP,YAAY,EACZ,UAAU,EACV,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,IAAI,EACJ,kBAAkB,GACnB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,MAAM,EACN,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,MAAM,EACN,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,QAAQ,EACR,aAAa,EACb,WAAW,EACX,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,YAAY,MAAM,sBAAsB,CAAC;AACrD,OAAO,EACL,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,QAAQ,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,OAAO,MAAM,2BAA2B,CAAC"}

package/dist/public_api.js

@@ -0,0 +1,60 @@
+"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.clients = exports.workflow = exports.connection = exports.RestateConnection = exports.Event = exports.TimeoutError = exports.TerminalError = exports.RestateError = exports.ErrorCodes = exports.RestateUtils = exports.endpoint = exports.keyedEventHandler = exports.keyedRouter = exports.router = exports.CombineablePromise = exports.useKeyedContext = exports.useContext = void 0;
+var context_1 = require("./context");
+Object.defineProperty(exports, "useContext", { enumerable: true, get: function () { return context_1.useContext; } });
+Object.defineProperty(exports, "useKeyedContext", { enumerable: true, get: function () { return context_1.useKeyedContext; } });
+Object.defineProperty(exports, "CombineablePromise", { enumerable: true, get: function () { return context_1.CombineablePromise; } });
+var router_1 = require("./types/router");
+Object.defineProperty(exports, "router", { enumerable: true, get: function () { return router_1.router; } });
+Object.defineProperty(exports, "keyedRouter", { enumerable: true, get: function () { return router_1.keyedRouter; } });
+Object.defineProperty(exports, "keyedEventHandler", { enumerable: true, get: function () { return router_1.keyedEventHandler; } });
+var endpoint_1 = require("./endpoint");
+Object.defineProperty(exports, "endpoint", { enumerable: true, get: function () { return endpoint_1.endpoint; } });
+exports.RestateUtils = __importStar(require("./utils/public_utils"));
+var errors_1 = require("./types/errors");
+Object.defineProperty(exports, "ErrorCodes", { enumerable: true, get: function () { return errors_1.ErrorCodes; } });
+Object.defineProperty(exports, "RestateError", { enumerable: true, get: function () { return errors_1.RestateError; } });
+Object.defineProperty(exports, "TerminalError", { enumerable: true, get: function () { return errors_1.TerminalError; } });
+Object.defineProperty(exports, "TimeoutError", { enumerable: true, get: function () { return errors_1.TimeoutError; } });
+var types_1 = require("./types/types");
+Object.defineProperty(exports, "Event", { enumerable: true, get: function () { return types_1.Event; } });
+var api_1 = require("./embedded/api");
+Object.defineProperty(exports, "RestateConnection", { enumerable: true, get: function () { return api_1.RestateConnection; } });
+Object.defineProperty(exports, "connection", { enumerable: true, get: function () { return api_1.connection; } });
+exports.workflow = __importStar(require("./workflows/workflow"));
+exports.clients = __importStar(require("./clients/workflow_client"));
+//# sourceMappingURL=public_api.js.map

package/dist/public_api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public_api.js","sourceRoot":"","sources":["../src/public_api.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,qCAUmB;AANjB,qGAAA,UAAU,OAAA;AACV,0GAAA,eAAe,OAAA;AAEf,6GAAA,kBAAkB,OAAA;AAIpB,yCASwB;AARtB,gGAAA,MAAM,OAAA;AACN,qGAAA,WAAW,OAAA;AACX,2GAAA,iBAAiB,OAAA;AAOnB,uCAKoB;AAJlB,oGAAA,QAAQ,OAAA;AAKV,qEAAqD;AACrD,yCAKwB;AAJtB,oGAAA,UAAU,OAAA;AACV,sGAAA,YAAY,OAAA;AACZ,uGAAA,aAAa,OAAA;AACb,sGAAA,YAAY,OAAA;AAEd,uCAAsC;AAA7B,8FAAA,KAAK,OAAA;AACd,sCAIwB;AAHtB,wGAAA,iBAAiB,OAAA;AACjB,iGAAA,UAAU,OAAA;AAGZ,iEAAiD;AACjD,qEAAqD"}

package/dist/state_machine.d.ts

@@ -3,9 +3,12 @@ import * as p from "./types/protocol";
 import { Connection, RestateStreamConsumer } from "./connection/connection";
 import { ProtocolMode } from "./generated/proto/discovery";
 import { Message } from "./types/types";
+import { StateMachineConsole } from "./utils/message_logger";
 import { Invocation } from "./invocation";
-import { TerminalError, RetryableError } from "./types/errors";
 import { LocalStateStore } from "./local_state_store";
+import { LoggerContext } from "./logger";
+import { WrappedPromise } from "./utils/promises";
+import { PromiseId } from "./promise_combinator_tracker";
 export declare class StateMachine<I, O> implements RestateStreamConsumer {
     private readonly connection;
     private readonly invocation;
@@ -18,9 +21,17 @@ export declare class StateMachine<I, O> implements RestateStreamConsumer {
     readonly localStateStore: LocalStateStore;
     private inputChannelClosed;
     private suspensionTimeout?;
-    constructor(connection: Connection, invocation: Invocation<I, O>, protocolMode: ProtocolMode, suspensionMillis?: number);
+    private promiseCombinatorTracker;
+    console: StateMachineConsole;
+    constructor(connection: Connection, invocation: Invocation<I, O>, protocolMode: ProtocolMode, keyedContext: boolean, loggerContext: LoggerContext, suspensionMillis?: number);
     handleMessage(m: Message): boolean;
     handleUserCodeMessage<T>(messageType: bigint, message: p.ProtocolMessage, completedFlag?: boolean, protocolVersion?: number, requiresAckFlag?: boolean): WrappedPromise<T | void>;
+    createCombinator(combinatorConstructor: (promises: PromiseLike<unknown>[]) => Promise<unknown>, promises: Array<{
+        id: PromiseId;
+        promise: Promise<unknown>;
+    }>): WrappedPromise<unknown>;
+    readCombinatorOrderEntry(combinatorId: number): PromiseId[] | undefined;
+    writeCombinatorOrderEntry(combinatorId: number, order: PromiseId[]): Promise<void>;
     /**
      * Invokes the RPC function and returns a promise that completes when the state machine
      * stops processing the invocation, meaning when:
@@ -49,27 +60,23 @@ export declare class StateMachine<I, O> implements RestateStreamConsumer {
      * on the connection layer.
      */
     private unhandledError;
-    private scheduleSuspension;
+    /**
+     * This method is invoked when we hit a suspension point. A suspension point is everytime the user "await"s a Promise returned by RestateContext that might be completed at a later point in time by a CompletionMessage/AckMessage.
+     *
+     * Depending on the state of the read channel, and on the protocol mode, it might either immediately suspend, or schedule a suspension to happen at a later point in time.
+     */
+    private hitSuspensionPoint;
     private getSuspensionMillis;
     private suspend;
-    notifyHandlerExecutionError(e: RetryableError | TerminalError): Promise<void>;
     /**
      * WARNING: make sure you use this at the right point in the code
      * After the index has been incremented...
      * This is error-prone... Would be good to have a better solution for this.
      */
     getUserCodeJournalIndex(): number;
-    getFullServiceName(): string;
     handleInputClosed(): void;
     handleStreamError(e: Error): void;
     nextEntryWillBeReplayed(): boolean;
     private clearSuspensionTimeout;
 }
-/**
- * Returns a promise that wraps the original promise and calls cb() at the first time
- * this promise or any nested promise that is chained to it is awaited. (then-ed)
- */
-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) => Promise<TResult1 | TResult2>;
-};
 //# sourceMappingURL=state_machine.d.ts.map

package/dist/state_machine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state_machine.d.ts","sourceRoot":"","sources":["../src/state_machine.ts"],"names":[],"mappings":";AAWA,OAAO,KAAK,CAAC,MAAM,kBAAkB,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAgBxC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAEL,aAAa,EACb,cAAc,EAGf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,qBAAa,YAAY,CAAC,CAAC,EAAE,CAAC,CAAE,YAAW,qBAAqB;IAwB5D,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IA1BnC,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,cAAc,CAAyB;IAE/C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA2C;IAO9E,OAAO,CAAC,kBAAkB,CAAS;IAEnC,SAAgB,eAAe,EAAE,eAAe,CAAC;IAKjD,OAAO,CAAC,kBAAkB,CAAS;IAGnC,OAAO,CAAC,iBAAiB,CAAC,CAAiB;gBAGxB,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EAC5B,YAAY,EAAE,YAAY,EAC1B,gBAAgB,GAAE,MAAe;IAY7C,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO;IA0ClC,qBAAqB,CAAC,CAAC,EAC5B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,CAAC,CAAC,eAAe,EAC1B,aAAa,CAAC,EAAE,OAAO,EACvB,eAAe,CAAC,EAAE,MAAM,EACxB,eAAe,CAAC,EAAE,OAAO,GACxB,cAAc,CAAC,CAAC,GAAG,IAAI,CAAC;IA+C3B;;;;;;;;;;;;;OAaG;IACI,MAAM,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;YAqIzB,kBAAkB;IAUhC,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,iBAAiB;IAuBzB,OAAO,CAAC,IAAI;IAMZ;;OAEG;YACW,MAAM;IAcpB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,kBAAkB;IA8B1B,OAAO,CAAC,mBAAmB;YAOb,OAAO;IAoCR,2BAA2B,CAAC,CAAC,EAAE,cAAc,GAAG,aAAa;IAI1E;;;;OAIG;IACI,uBAAuB,IAAI,MAAM;IAIjC,kBAAkB,IAAI,MAAM;IAO5B,iBAAiB,IAAI,IAAI;IAsBzB,iBAAiB,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI;IASjC,uBAAuB;IAI9B,OAAO,CAAC,sBAAsB;CAM/B;AACD;;;GAGG;AAGH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG;IAC3C,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,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAAC;CACnC,CAAC"}
+{"version":3,"file":"state_machine.d.ts","sourceRoot":"","sources":["../src/state_machine.ts"],"names":[],"mappings":"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"}