@restatedev/restate-sdk 0.0.0-SNAPSHOT-20231025205407

package/dist/server/restate_lambda_handler.js

@@ -0,0 +1,245 @@
+"use strict";
+/*
+ * Copyright (c) 2023 - Restate Software, Inc., Restate GmbH
+ *
+ * This file is part of the Restate SDK for Node.js/TypeScript,
+ * which is released under the MIT license.
+ *
+ * You can find a copy of the license in file LICENSE in the root
+ * directory of this repository or package, or at
+ * https://github.com/restatedev/sdk-typescript/blob/main/LICENSE
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LambdaRestateServer = exports.createLambdaApiGatewayHandler = void 0;
+const logger_1 = require("../utils/logger");
+const discovery_1 = require("../generated/proto/discovery");
+const base_restate_server_1 = require("./base_restate_server");
+const lambda_connection_1 = require("../connection/lambda_connection");
+const invocation_1 = require("../invocation");
+const decoder_1 = require("../io/decoder");
+const state_machine_1 = require("../state_machine");
+const errors_1 = require("../types/errors");
+/**
+ * Creates an Restate entrypoint for services deployed on AWS Lambda and invoked
+ * through API Gateway.
+ *
+ * Register services on this entrypoint via {@link LambdaRestateServer.bindService } and
+ * then create the Lambda invocation handler via {@link LambdaRestateServer.handle }.
+ *
+ * @example
+ * A typical AWS Lambda entry point would look like this
+ * ```
+ * import * as restate from "@restatedev/restate-sdk";
+ *
+ * export const handler = restate
+ *   .createLambdaApiGatewayHandler()
+ *   .bindService({
+ *      service: "MyService",
+ *      instance: new myService.MyServiceImpl(),
+ *      descriptor: myService.protoMetadata,
+ *    })
+ *   .handle();
+ * ```
+ */
+function createLambdaApiGatewayHandler() {
+    return new LambdaRestateServer();
+}
+exports.createLambdaApiGatewayHandler = createLambdaApiGatewayHandler;
+/**
+ * Restate entrypoint implementation for services deployed on AWS Lambda.
+ * This one decodes the requests, create the log event sequence that
+ * drives the durable execution of the service invocations.
+ */
+class LambdaRestateServer extends base_restate_server_1.BaseRestateServer {
+    constructor() {
+        super(discovery_1.ProtocolMode.REQUEST_RESPONSE);
+    }
+    /**
+     * Adds a gRPC service to be served from this endpoint.
+     *
+     * The {@link ServiceOpts} passed here need to describe the following properties:
+     *
+     *   - The 'service' name: the name of the gRPC service (as in the service definition proto file).
+     *   - The service 'instance': the implementation of the service logic (must implement the generated
+     *     gRPC service interface).
+     *   - The gRPC/protobuf 'descriptor': The protoMetadata descriptor that describes the service, methods,
+     *     and parameter types. It is usually found as the value 'protoMetadata' in the generated
+     *     file '(service-name).ts'
+     *
+     *     The descriptor is generated by the protobuf compiler and needed by Restate to reflectively discover
+     *     the service details, understand payload serialization, perform HTTP/JSON-to-gRPC transcoding, or
+     *     to proxy the service.
+     *
+     * If you define multiple services in the same '.proto' file, you may have only one descriptor that
+     * describes all services together. You can pass the same descriptor to multiple calls of '.bindService()'.
+     *
+     * If you don't find the gRPC/protobuf descriptor, make your you generated the gRPC/ProtoBuf code with
+     * the option to generate the descriptor. For example, using the 'ts-proto' plugin, make sure you pass
+     * the 'outputSchema=true' option. If you are using Restate's project templates, this should all be
+     * pre-configured for you.
+     *
+     * @example
+     * ```
+     * endpoint.bindService({
+     *   service: "MyService",
+     *   instance: new myService.MyServiceImpl(),
+     *   descriptor: myService.protoMetadata
+     * })
+     * ```
+     *
+     * @param serviceOpts The options describing the service to be bound. See above for a detailed description.
+     * @returns An instance of this LambdaRestateServer
+     */
+    bindService(serviceOpts) {
+        // Implementation note: This override if here mainly to change the return type to the more
+        // concrete type LambdaRestateServer (from BaseRestateServer).
+        super.bindService(serviceOpts);
+        return this;
+    }
+    bindRouter(path, router) {
+        super.bindRpcService(path, router, false);
+        return this;
+    }
+    bindKeyedRouter(path, router) {
+        super.bindRpcService(path, router, true);
+        return this;
+    }
+    /**
+     * Creates the invocation handler function to be called by AWS Lambda.
+     *
+     * The returned type of this function is `(event: APIGatewayProxyEvent | APIGatewayProxyEventV2) => Promise<APIGatewayProxyResult | APIGatewayProxyResultV2>`.
+     * We use `any` types here to avoid a dependency on the `@types/aws-lambda` dependency for consumers of this API.
+     *
+     * @example
+     * A typical AWS Lambda entry point would use this method the follwing way:
+     * ```
+     * import * as restate from "@restatedev/restate-sdk";
+     *
+     * export const handler = restate
+     *   .createLambdaApiGatewayHandler()
+     *   .bindService({
+     *      service: "MyService",
+     *      instance: new myService.MyServiceImpl(),
+     *      descriptor: myService.protoMetadata,
+     *    })
+     *   .handle();
+     * ```
+     *
+     * @returns The invocation handler function for to be called by AWS Lambda.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    handle() {
+        // return the handler and bind the current context to it, so that it can find the other methods in this class.
+        return this.handleRequest.bind(this);
+    }
+    // --------------------------------------------------------------------------
+    /**
+     * This is the main request handling method, effectively a typed variant of `create()`.
+     */
+    async handleRequest(event) {
+        let path;
+        if ("path" in event) {
+            // V1
+            path = event.path;
+        }
+        else {
+            // V2
+            path = event.rawPath;
+        }
+        const pathSegments = path.split("/");
+        // API Gateway can add a prefix to the path based on the name of the Lambda function and deployment stage
+        // (e.g. /default)
+        // So we only check the ending of the path on correctness.
+        // Logic:
+        // 1. Check whether there are at least three segments in the path and whether the third-last one is "invoke".
+        // If that is the case, treat it as an invocation.
+        // 2. See if the last one is "discover", answer with discovery.
+        // 3. Else report "invalid path".
+        if (pathSegments.length >= 3 &&
+            pathSegments[pathSegments.length - 3] === "invoke") {
+            const url = "/" + pathSegments.slice(-3).join("/");
+            return await this.handleInvoke(url, event);
+        }
+        else if (pathSegments[pathSegments.length - 1] === "discover") {
+            return this.handleDiscovery();
+        }
+        else {
+            const msg = "Invalid path: path doesn't end in /invoke/SvcName/MethodName and also not in /discover: " +
+                path;
+            logger_1.rlog.error(msg);
+            logger_1.rlog.trace();
+            return this.toErrorResponse(500, msg);
+        }
+    }
+    async handleInvoke(url, event) {
+        try {
+            const method = this.methodByUrl(url);
+            if (event.body == null) {
+                throw new Error("The incoming message body was null");
+            }
+            if (method === undefined) {
+                if (url.includes("?")) {
+                    throw new Error(`Invalid path: path URL seems to include query parameters: ${url}`);
+                }
+                else {
+                    const msg = `No service found for URL: ${url}`;
+                    logger_1.rlog.error(msg);
+                    return this.toErrorResponse(404, msg);
+                }
+            }
+            // build the previous journal from the events
+            let decodedEntries = (0, decoder_1.decodeLambdaBody)(event.body);
+            const journalBuilder = new invocation_1.InvocationBuilder(method);
+            decodedEntries.forEach((e) => journalBuilder.handleMessage(e));
+            decodedEntries = null;
+            // set up and invoke the state machine
+            const connection = new lambda_connection_1.LambdaConnection();
+            const stateMachine = new state_machine_1.StateMachine(connection, journalBuilder.build(), discovery_1.ProtocolMode.REQUEST_RESPONSE);
+            await stateMachine.invoke();
+            const result = await connection.getResult();
+            return {
+                headers: {
+                    "content-type": "application/restate",
+                },
+                statusCode: 200,
+                isBase64Encoded: true,
+                body: encodeResponse(result),
+            };
+        }
+        catch (e) {
+            const error = (0, errors_1.ensureError)(e);
+            logger_1.rlog.error(error.message);
+            logger_1.rlog.error(error.stack);
+            return this.toErrorResponse(500, error.message);
+        }
+    }
+    handleDiscovery() {
+        // return discovery information
+        logger_1.rlog.info("Answering discovery request. Registering these services: " +
+            JSON.stringify(this.discovery.services));
+        return {
+            headers: {
+                "content-type": "application/proto",
+            },
+            statusCode: 200,
+            isBase64Encoded: true,
+            body: encodeResponse(discovery_1.ServiceDiscoveryResponse.encode(this.discovery).finish()),
+        };
+    }
+    toErrorResponse(code, message) {
+        return {
+            headers: {
+                "content-type": "application/restate",
+            },
+            statusCode: code,
+            isBase64Encoded: true,
+            body: encodeResponse(Buffer.from(JSON.stringify({ message }))),
+        };
+    }
+}
+exports.LambdaRestateServer = LambdaRestateServer;
+function encodeResponse(data) {
+    const buffer = data instanceof Buffer ? data : Buffer.from(data);
+    return buffer.toString("base64");
+}
+//# sourceMappingURL=restate_lambda_handler.js.map

package/dist/server/restate_lambda_handler.js.map

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

package/dist/server/restate_server.d.ts

@@ -0,0 +1,91 @@
+import { BaseRestateServer, ServiceOpts } from "./base_restate_server";
+import { KeyedRouter, UnKeyedRouter } from "../types/router";
+/**
+ * Creates a Restate entrypoint based on a HTTP2 server. The entrypoint will listen
+ * for requests to the services at a specified port.
+ *
+ * This is the entrypoint to be used in most scenarios (standalone, Docker, Kubernetes, ...);
+ * any deployments that forwards requests to a network endpoint. The prominent exception is
+ * AWS Lambda, which uses the {@link restate_lambda_handler#lambdaApiGatewayHandler}
+ * function to create an entry point.
+ *
+ * After creating this endpoint, register services on this entrypoint via {@link RestateServer.bindService }
+ * and start it via {@link RestateServer.listen }.
+ *
+ * @example
+ * A typical entry point would look like this:
+ * ```
+ * import * as restate from "@restatedev/restate-sdk";
+ *
+ * export const handler = restate
+ *   .createServer()
+ *   .bindService({
+ *      service: "MyService",
+ *      instance: new myService.MyServiceImpl(),
+ *      descriptor: myService.protoMetadata,
+ *    })
+ *   .listen(8000);
+ * ```
+ */
+export declare function createServer(): RestateServer;
+/**
+ * Restate entrypoint implementation for services. This server receives and
+ * decodes the requests, streams events between the service and the Restate runtime,
+ * and drives the durable execution of the service invocations.
+ */
+export declare class RestateServer extends BaseRestateServer {
+    constructor();
+    bindKeyedRouter<M>(path: string, router: KeyedRouter<M>): RestateServer;
+    bindRouter<M>(path: string, router: UnKeyedRouter<M>): RestateServer;
+    /**
+     * Adds a gRPC service to be served from this endpoint.
+     *
+     * The {@link ServiceOpts} passed here need to describe the following properties:
+     *
+     *   - The 'service' name: the name of the gRPC service (as in the service definition proto file).
+     *   - The service 'instance': the implementation of the service logic (must implement the generated
+     *     gRPC service interface).
+     *   - The gRPC/protobuf 'descriptor': The protoMetadata descriptor that describes the service, methods,
+     *     and parameter types. It is usually found as the value 'protoMetadata' in the generated
+     *     file '(service-name).ts'
+     *
+     *     The descriptor is generated by the protobuf compiler and needed by Restate to reflectively discover
+     *     the service details, understand payload serialization, perform HTTP/JSON-to-gRPC transcoding, or
+     *     to proxy the service.
+     *
+     * If you define multiple services in the same '.proto' file, you may have only one descriptor that
+     * describes all services together. You can pass the same descriptor to multiple calls of '.bindService()'.
+     *
+     * If you don't find the gRPC/protobuf descriptor, make your you generated the gRPC/ProtoBuf code with
+     * the option to generate the descriptor. For example, using the 'ts-proto' plugin, make sure you pass
+     * the 'outputSchema=true' option. If you are using Restate's project templates, this should all be
+     * pre-configured for you.
+     *
+     * @example
+     * ```
+     * endpoint.bindService({
+     *   service: "MyService",
+     *   instance: new myService.MyServiceImpl(),
+     *   descriptor: myService.protoMetadata
+     * })
+     * ```
+     *
+     * @param serviceOpts The options describing the service to be bound. See above for a detailed description.
+     * @returns An instance of this RestateServer
+     */
+    bindService(serviceOpts: ServiceOpts): RestateServer;
+    /**
+     * Starts the Restate server and listens at the given port.
+     *
+     * If the port is undefined, this method will use the port set in the `PORT`
+     * environment variable. If that variable is undefined as well, the method will
+     * default to port 9080.
+     *
+     * This method's result promise never completes.
+     *
+     * @param port The port to listen at. May be undefined (see above).
+     */
+    listen(port?: number): Promise<void>;
+    private handleConnection;
+}
+//# sourceMappingURL=restate_server.d.ts.map

package/dist/server/restate_server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restate_server.d.ts","sourceRoot":"","sources":["../../src/server/restate_server.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAOvE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,YAAY,IAAI,aAAa,CAE5C;AAED;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,iBAAiB;;IAK3C,eAAe,CAAC,CAAC,EACtB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GACrB,aAAa;IAOT,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa;IAO3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACI,WAAW,CAAC,WAAW,EAAE,WAAW,GAAG,aAAa;IAO3D;;;;;;;;;;OAUG;IACU,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM;YAiBnB,gBAAgB;CAgC/B"}

package/dist/server/restate_server.js

@@ -0,0 +1,230 @@
+"use strict";
+/*
+ * Copyright (c) 2023 - Restate Software, Inc., Restate GmbH
+ *
+ * This file is part of the Restate SDK for Node.js/TypeScript,
+ * which is released under the MIT license.
+ *
+ * You can find a copy of the license in file LICENSE in the root
+ * directory of this repository or package, or at
+ * https://github.com/restatedev/sdk-typescript/blob/main/LICENSE
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RestateServer = exports.createServer = void 0;
+const events_1 = require("events");
+const stream_1 = __importDefault(require("stream"));
+const promises_1 = require("stream/promises");
+const http2_1 = __importDefault(require("http2"));
+const url_1 = require("url");
+const discovery_1 = require("../generated/proto/discovery");
+const base_restate_server_1 = require("./base_restate_server");
+const logger_1 = require("../utils/logger");
+const http_connection_1 = require("../connection/http_connection");
+const errors_1 = require("../types/errors");
+const invocation_1 = require("../invocation");
+const state_machine_1 = require("../state_machine");
+/**
+ * Creates a Restate entrypoint based on a HTTP2 server. The entrypoint will listen
+ * for requests to the services at a specified port.
+ *
+ * This is the entrypoint to be used in most scenarios (standalone, Docker, Kubernetes, ...);
+ * any deployments that forwards requests to a network endpoint. The prominent exception is
+ * AWS Lambda, which uses the {@link restate_lambda_handler#lambdaApiGatewayHandler}
+ * function to create an entry point.
+ *
+ * After creating this endpoint, register services on this entrypoint via {@link RestateServer.bindService }
+ * and start it via {@link RestateServer.listen }.
+ *
+ * @example
+ * A typical entry point would look like this:
+ * ```
+ * import * as restate from "@restatedev/restate-sdk";
+ *
+ * export const handler = restate
+ *   .createServer()
+ *   .bindService({
+ *      service: "MyService",
+ *      instance: new myService.MyServiceImpl(),
+ *      descriptor: myService.protoMetadata,
+ *    })
+ *   .listen(8000);
+ * ```
+ */
+function createServer() {
+    return new RestateServer();
+}
+exports.createServer = createServer;
+/**
+ * Restate entrypoint implementation for services. This server receives and
+ * decodes the requests, streams events between the service and the Restate runtime,
+ * and drives the durable execution of the service invocations.
+ */
+class RestateServer extends base_restate_server_1.BaseRestateServer {
+    constructor() {
+        super(discovery_1.ProtocolMode.BIDI_STREAM);
+    }
+    bindKeyedRouter(path, router) {
+        // Implementation note: This override if here mainly to change the return type to the more
+        // concrete type RestateServer (from BaseRestateServer).
+        super.bindRpcService(path, router, true);
+        return this;
+    }
+    bindRouter(path, router) {
+        // Implementation note: This override if here mainly to change the return type to the more
+        // concrete type RestateServer (from BaseRestateServer).
+        super.bindRpcService(path, router, false);
+        return this;
+    }
+    /**
+     * Adds a gRPC service to be served from this endpoint.
+     *
+     * The {@link ServiceOpts} passed here need to describe the following properties:
+     *
+     *   - The 'service' name: the name of the gRPC service (as in the service definition proto file).
+     *   - The service 'instance': the implementation of the service logic (must implement the generated
+     *     gRPC service interface).
+     *   - The gRPC/protobuf 'descriptor': The protoMetadata descriptor that describes the service, methods,
+     *     and parameter types. It is usually found as the value 'protoMetadata' in the generated
+     *     file '(service-name).ts'
+     *
+     *     The descriptor is generated by the protobuf compiler and needed by Restate to reflectively discover
+     *     the service details, understand payload serialization, perform HTTP/JSON-to-gRPC transcoding, or
+     *     to proxy the service.
+     *
+     * If you define multiple services in the same '.proto' file, you may have only one descriptor that
+     * describes all services together. You can pass the same descriptor to multiple calls of '.bindService()'.
+     *
+     * If you don't find the gRPC/protobuf descriptor, make your you generated the gRPC/ProtoBuf code with
+     * the option to generate the descriptor. For example, using the 'ts-proto' plugin, make sure you pass
+     * the 'outputSchema=true' option. If you are using Restate's project templates, this should all be
+     * pre-configured for you.
+     *
+     * @example
+     * ```
+     * endpoint.bindService({
+     *   service: "MyService",
+     *   instance: new myService.MyServiceImpl(),
+     *   descriptor: myService.protoMetadata
+     * })
+     * ```
+     *
+     * @param serviceOpts The options describing the service to be bound. See above for a detailed description.
+     * @returns An instance of this RestateServer
+     */
+    bindService(serviceOpts) {
+        // Implementation note: This override if here mainly to change the return type to the more
+        // concrete type RestateServer (from BaseRestateServer).
+        super.bindService(serviceOpts);
+        return this;
+    }
+    /**
+     * Starts the Restate server and listens at the given port.
+     *
+     * If the port is undefined, this method will use the port set in the `PORT`
+     * environment variable. If that variable is undefined as well, the method will
+     * default to port 9080.
+     *
+     * This method's result promise never completes.
+     *
+     * @param port The port to listen at. May be undefined (see above).
+     */
+    async listen(port) {
+        // Infer the port if not specified, or default it
+        const actualPort = port ?? parseInt(process.env.PORT ?? "9080");
+        logger_1.rlog.info(`Listening on ${actualPort}...`);
+        for await (const connection of incomingConnectionAtPort(actualPort)) {
+            this.handleConnection(connection.url, connection.stream).catch((e) => {
+                const error = (0, errors_1.ensureError)(e);
+                logger_1.rlog.error("Error while handling connection: " + (error.stack ?? error.message));
+                connection.stream.end();
+                connection.stream.destroy();
+            });
+        }
+    }
+    async handleConnection(url, stream) {
+        const method = this.methodByUrl(url.path);
+        if (method !== undefined) {
+            // valid connection, let's dispatch the invocation
+            stream.respond({
+                "content-type": "application/restate",
+                ":status": 200,
+            });
+            const restateStream = http_connection_1.RestateHttp2Connection.from(stream);
+            await handleInvocation(method, restateStream);
+            return;
+        }
+        // no method under that name. might be a discovery request
+        if (url.path == "/discover") {
+            logger_1.rlog.info("Answering discovery request. Registering these services: " +
+                JSON.stringify(this.discovery.services));
+            await respondDiscovery(this.discovery, stream);
+            return;
+        }
+        // no discovery, so unknown method: 404
+        logger_1.rlog.error(`No service and function found for URL ${url.path}`);
+        await respondNotFound(stream);
+    }
+}
+exports.RestateServer = RestateServer;
+async function* incomingConnectionAtPort(port) {
+    const server = http2_1.default.createServer();
+    server.on("error", (err) => logger_1.rlog.error("Error in Restate service endpoint http2 server: " + err));
+    server.listen(port);
+    let connectionId = 1n;
+    for await (const [s, h] of (0, events_1.on)(server, "stream")) {
+        const stream = s;
+        const headers = h;
+        const url = (0, url_1.parse)(headers[":path"] ?? "/");
+        connectionId++;
+        yield { connectionId, url, headers, stream };
+    }
+}
+async function respondDiscovery(response, http2Stream) {
+    const responseData = discovery_1.ServiceDiscoveryResponse.encode(response).finish();
+    http2Stream.respond({
+        ":status": 200,
+        "content-type": "application/proto",
+    });
+    await (0, promises_1.pipeline)(stream_1.default.Readable.from(responseData), http2Stream, {
+        end: true,
+    });
+}
+async function respondNotFound(stream) {
+    stream.respond({
+        "content-type": "application/restate",
+        ":status": 404,
+    });
+    stream.end();
+    await (0, promises_1.finished)(stream);
+}
+async function handleInvocation(func, connection) {
+    // step 1: collect all journal events
+    const journalBuilder = new invocation_1.InvocationBuilder(func);
+    connection.pipeToConsumer(journalBuilder);
+    try {
+        await journalBuilder.completion();
+    }
+    finally {
+        // ensure GC friendliness, also in case of errors
+        connection.removeCurrentConsumer();
+    }
+    // step 2: create the state machine
+    const stateMachine = new state_machine_1.StateMachine(connection, journalBuilder.build(), discovery_1.ProtocolMode.BIDI_STREAM);
+    connection.pipeToConsumer(stateMachine);
+    // step 3: invoke the function
+    // This call would propagate errors in the state machine logic, but not errors
+    // in the application function code. Ending a function with an error as well
+    // as failign an invocation and being retried are perfectly valid actions from the
+    // SDK's perspective.
+    try {
+        await stateMachine.invoke();
+    }
+    finally {
+        // ensure GC friendliness, also in case of errors
+        connection.removeCurrentConsumer();
+    }
+}
+//# sourceMappingURL=restate_server.js.map

package/dist/server/restate_server.js.map

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

package/dist/state_machine.d.ts

@@ -0,0 +1,75 @@
+/// <reference types="node" />
+import * as p from "./types/protocol";
+import { Connection, RestateStreamConsumer } from "./connection/connection";
+import { ProtocolMode } from "./generated/proto/discovery";
+import { Message } from "./types/types";
+import { Invocation } from "./invocation";
+import { TerminalError, RetryableError } from "./types/errors";
+import { LocalStateStore } from "./local_state_store";
+export declare class StateMachine<I, O> implements RestateStreamConsumer {
+    private readonly connection;
+    private readonly invocation;
+    private readonly protocolMode;
+    private journal;
+    private restateContext;
+    private readonly invocationComplete;
+    private stateMachineClosed;
+    readonly localStateStore: LocalStateStore;
+    private inputChannelClosed;
+    private suspensionTimeout?;
+    private readonly suspensionMillis;
+    constructor(connection: Connection, invocation: Invocation<I, O>, protocolMode: ProtocolMode);
+    handleMessage(m: Message): boolean;
+    handleUserCodeMessage<T>(messageType: bigint, message: p.ProtocolMessage, completedFlag?: boolean, protocolVersion?: number, requiresAckFlag?: boolean): WrappedPromise<T | 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>;
+    private finishWithError;
+    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;
+    private scheduleSuspension;
+    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

@@ -0,0 +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;AAaxC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAEL,aAAa,EACb,cAAc,EAEf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,qBAAa,YAAY,CAAC,CAAC,EAAE,CAAC,CAAE,YAAW,qBAAqB;IA0B5D,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY;IA3B/B,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;IAE3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAU;gBAGxB,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EAC5B,YAAY,EAAE,YAAY;IAYtC,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO;IAiClC,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;YAsHzB,eAAe;IAU7B,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,iBAAiB;IAoBzB,OAAO,CAAC,IAAI;IAMZ;;OAEG;YACW,MAAM;IAcpB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,kBAAkB;IA0B1B,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"}