@restatedev/restate-sdk 1.0.0 → 1.0.1

package/dist/esm/src/logger.js

@@ -0,0 +1,146 @@
+/*
+ * 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
+ */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/* eslint-disable no-console */
+export var RestateLogLevel;
+(function (RestateLogLevel) {
+    RestateLogLevel[RestateLogLevel["TRACE"] = 1] = "TRACE";
+    RestateLogLevel[RestateLogLevel["DEBUG"] = 2] = "DEBUG";
+    RestateLogLevel[RestateLogLevel["INFO"] = 3] = "INFO";
+    RestateLogLevel[RestateLogLevel["WARN"] = 4] = "WARN";
+    RestateLogLevel[RestateLogLevel["ERROR"] = 5] = "ERROR";
+})(RestateLogLevel || (RestateLogLevel = {}));
+function logLevelName(level) {
+    switch (level) {
+        case RestateLogLevel.TRACE:
+            return "TRACE";
+        case RestateLogLevel.DEBUG:
+            return "DEBUG";
+        case RestateLogLevel.INFO:
+            return "INFO";
+        case RestateLogLevel.WARN:
+            return "WARN";
+        case RestateLogLevel.ERROR:
+            return "ERROR";
+    }
+}
+function logLevelFromName(name) {
+    if (!name) {
+        return null;
+    }
+    const n = name.toUpperCase();
+    switch (n) {
+        case "TRACE":
+            return RestateLogLevel.TRACE;
+        case "DEBUG":
+            return RestateLogLevel.DEBUG;
+        case "INFO":
+            return RestateLogLevel.INFO;
+        case "WARN":
+            return RestateLogLevel.WARN;
+        case "ERROR":
+            return RestateLogLevel.ERROR;
+        default:
+            throw new TypeError(`unknown name ${name}`);
+    }
+}
+function logFunction(level) {
+    switch (level) {
+        case RestateLogLevel.TRACE:
+            return console.trace;
+        case RestateLogLevel.DEBUG:
+            return console.debug;
+        case RestateLogLevel.INFO:
+            return console.info;
+        case RestateLogLevel.WARN:
+            return console.warn;
+        case RestateLogLevel.ERROR:
+            return console.error;
+        default:
+            throw new TypeError(`unset or unknown log level ${level}`);
+    }
+}
+function readRestateLogLevel() {
+    const env = globalThis.process?.env?.RESTATE_LOGGING;
+    const level = logLevelFromName(env);
+    if (level != null) {
+        return level;
+    }
+    return RestateLogLevel.INFO;
+}
+export const RESTATE_LOG_LEVEL = readRestateLogLevel();
+export class LoggerContext {
+    invocationId;
+    additionalContext;
+    fqMethodName;
+    constructor(invocationId, packageName, serviceName, handlerName, additionalContext) {
+        this.invocationId = invocationId;
+        this.additionalContext = additionalContext;
+        this.fqMethodName = packageName
+            ? `${packageName}.${serviceName}/${handlerName}`
+            : `${serviceName}/${handlerName}`;
+    }
+}
+function formatLogPrefix(context) {
+    if (context === undefined) {
+        return "[restate] ";
+    }
+    let prefix = `[restate] [${context.fqMethodName}][${context.invocationId}]`;
+    if (context.additionalContext !== undefined) {
+        for (const [k, v] of Object.entries(context.additionalContext)) {
+            prefix = prefix + `[${k}: ${v}]`;
+        }
+    }
+    return prefix;
+}
+const NOOP_DESCRIPTOR = {
+    get() {
+        return () => {
+            // a no-op function
+        };
+    },
+};
+function loggerForLevel(level, shouldLog, prefix) {
+    if (level < RESTATE_LOG_LEVEL) {
+        return NOOP_DESCRIPTOR;
+    }
+    const name = logLevelName(level);
+    const fn = logFunction(level);
+    return {
+        get: () => {
+            if (!shouldLog()) {
+                return () => {
+                    // empty logger
+                };
+            }
+            const p = `${prefix}[${new Date().toISOString()}] ${name}: `;
+            return fn.bind(console, p);
+        },
+    };
+}
+export function createRestateConsole(context, filter) {
+    const prefix = formatLogPrefix(context);
+    const shouldLog = filter ?? (() => true);
+    return Object.create(console, {
+        trace: loggerForLevel(RestateLogLevel.TRACE, shouldLog, prefix),
+        debug: loggerForLevel(RestateLogLevel.DEBUG, shouldLog, prefix),
+        info: loggerForLevel(RestateLogLevel.INFO, shouldLog, prefix),
+        warn: loggerForLevel(RestateLogLevel.WARN, shouldLog, prefix),
+        error: loggerForLevel(RestateLogLevel.ERROR, shouldLog, prefix),
+    });
+}
+/**
+ * This is a simple console without contextual info.
+ *
+ * This should be used only in cases where no contextual info is available.
+ */
+export const rlog = createRestateConsole();
+//# sourceMappingURL=logger.js.map

package/dist/esm/src/logger.js.map

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

package/dist/esm/src/promise_combinator_tracker.d.ts

@@ -0,0 +1,29 @@
+import type { WrappedPromise } from "./utils/promises.js";
+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/esm/src/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,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,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;AAmGD;;;;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/esm/src/promise_combinator_tracker.js

@@ -0,0 +1,125 @@
+import { CompletablePromise, wrapDeeply } from "./utils/promises.js";
+export var PromiseType;
+(function (PromiseType) {
+    PromiseType[PromiseType["JournalEntry"] = 0] = "JournalEntry";
+    // Combinator?,
+    // SideEffect?
+})(PromiseType || (PromiseType = {}));
+export function newJournalEntryPromiseId(entryIndex) {
+    return {
+        type: PromiseType.JournalEntry,
+        id: entryIndex,
+    };
+}
+/**
+ * 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 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(
+    // eslint-disable-next-line @typescript-eslint/no-misused-promises
+    async () => 
+    // Once the combinator is resolved, notify back.
+    await onCombinatorResolved(combinatorIndex));
+    return 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.
+ */
+export 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);
+    }
+}
+//# sourceMappingURL=promise_combinator_tracker.js.map

package/dist/esm/src/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/esm/src/public_api.d.ts

@@ -0,0 +1,7 @@
+export * from "./common_api.js";
+import type { RestateEndpoint } from "./endpoint.js";
+/**
+ * Create a new {@link RestateEndpoint}.
+ */
+export declare function endpoint(): RestateEndpoint;
+//# sourceMappingURL=public_api.d.ts.map

package/dist/esm/src/public_api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public_api.d.ts","sourceRoot":"","sources":["../../../src/public_api.ts"],"names":[],"mappings":"AAWA,cAAc,iBAAiB,CAAC;AAEhC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGrD;;GAEG;AACH,wBAAgB,QAAQ,IAAI,eAAe,CAE1C"}

package/dist/esm/src/public_api.js

@@ -0,0 +1,19 @@
+/*
+ * 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
+ */
+export * from "./common_api.js";
+import { NodeEndpoint } from "./endpoint/node_endpoint.js";
+/**
+ * Create a new {@link RestateEndpoint}.
+ */
+export function endpoint() {
+    return new NodeEndpoint();
+}
+//# sourceMappingURL=public_api.js.map

package/dist/esm/src/public_api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public_api.js","sourceRoot":"","sources":["../../../src/public_api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,iBAAiB,CAAC;AAGhC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D;;GAEG;AACH,MAAM,UAAU,QAAQ;IACtB,OAAO,IAAI,YAAY,EAAE,CAAC;AAC5B,CAAC"}

package/dist/esm/src/state_machine.d.ts

@@ -0,0 +1,86 @@
+/// <reference types="node" resolution-mode="require"/>
+import * as p from "./types/protocol.js";
+import type { Connection, RestateStreamConsumer } from "./connection/connection.js";
+import { Message } from "./types/types.js";
+import type { StateMachineConsole } from "./utils/message_logger.js";
+import type { Invocation } from "./invocation.js";
+import type { JournalErrorContext } from "./types/errors.js";
+import type { LocalStateStore } from "./local_state_store.js";
+import type { LoggerContext } from "./logger.js";
+import type { WrappedPromise } from "./utils/promises.js";
+import type { PromiseId } from "./promise_combinator_tracker.js";
+import { ProtocolMode } from "./types/discovery.js";
+import { Buffer } from "node:buffer";
+import type { HandlerKind } from "./types/rpc.js";
+export declare class StateMachine implements RestateStreamConsumer {
+    private readonly connection;
+    private readonly invocation;
+    private readonly protocolMode;
+    private readonly suspensionMillis;
+    private journal;
+    private restateContext;
+    private readonly invocationComplete;
+    private stateMachineClosed;
+    readonly localStateStore: LocalStateStore;
+    private inputChannelClosed;
+    private suspensionTimeout?;
+    private promiseCombinatorTracker;
+    console: StateMachineConsole;
+    constructor(connection: Connection, invocation: Invocation, protocolMode: ProtocolMode, handlerKind: HandlerKind, loggerContext: LoggerContext, suspensionMillis?: number);
+    handleMessage(m: Message): boolean;
+    handleUserCodeMessage<T>(messageType: bigint, message: p.ProtocolMessage, completedFlag?: boolean, 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:
+     *   - The function completes with a result or an exception
+     *   - The execution suspends
+     *   - An error is raised in the state machine (network, API violation, ...)
+     *
+     * The returned promise resolves successfully for all the cases above, because the are (from
+     * the perspective of the state machine) expected outcomes in which it send out corresponding
+     * result messages and cleanly closed the connection.
+     *
+     * The returned promise is rejected when an unhandled error arises and the caller would be
+     * expected to ensure that resources are properly cleaned up.
+     */
+    invoke(): Promise<Buffer | void>;
+    sendErrorAndFinish(e: Error, ctx?: JournalErrorContext): Promise<void>;
+    private sendRetryableError;
+    private sendTerminalError;
+    private send;
+    /**
+     * Closes the state machine, flushes all output, and resolves the invocation promise.
+     */
+    private finish;
+    /**
+     * This function propagates errors up to the completion promise, to be handled
+     * on the connection layer.
+     */
+    private unhandledError;
+    /**
+     * 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;
+    /**
+     * 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;
+    handleInputClosed(): void;
+    handleStreamError(e: Error): void;
+    handleDanglingPromiseError(e: Error): void;
+    nextEntryWillBeReplayed(): boolean;
+    private clearSuspensionTimeout;
+}
+//# sourceMappingURL=state_machine.d.ts.map

package/dist/esm/src/state_machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state_machine.d.ts","sourceRoot":"","sources":["../../../src/state_machine.ts"],"names":[],"mappings":";AAWA,OAAO,KAAK,CAAC,MAAM,qBAAqB,CAAC;AAEzC,OAAO,KAAK,EACV,UAAU,EACV,qBAAqB,EACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAerE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAO7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAM1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAMjE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,qBAAa,YAAa,YAAW,qBAAqB;IA4BtD,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAG7B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAhCnC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,cAAc,CAAc;IAEpC,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;IAE3C,OAAO,CAAC,wBAAwB,CAA2B;IAE3D,OAAO,EAAE,mBAAmB,CAAC;gBAGV,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,YAAY,EAC3C,WAAW,EAAE,WAAW,EACxB,aAAa,EAAE,aAAa,EACX,gBAAgB,GAAE,MAAe;IAuB7C,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO;IAwClC,qBAAqB,CAAC,CAAC,EAC5B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,CAAC,CAAC,eAAe,EAC1B,aAAa,CAAC,EAAE,OAAO,EACvB,eAAe,CAAC,EAAE,OAAO,GACxB,cAAc,CAAC,CAAC,GAAG,IAAI,CAAC;IAyCpB,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;IAe/D,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,SAAS;IA8CjE,yBAAyB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE;IA+BxE;;;;;;;;;;;;;OAaG;IACI,MAAM,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAuG1B,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,mBAAmB;IAWnE,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,iBAAiB;IAsBzB,OAAO,CAAC,IAAI;IAMZ;;OAEG;YACW,MAAM;IAcpB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAOtB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IA0B1B,OAAO,CAAC,mBAAmB;YAOb,OAAO;IAmCrB;;;;OAIG;IACI,uBAAuB,IAAI,MAAM;IAIjC,iBAAiB,IAAI,IAAI;IAmBzB,iBAAiB,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI;IASjC,0BAA0B,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI;IAS1C,uBAAuB;IAI9B,OAAO,CAAC,sBAAsB;CAM/B"}