@restatedev/restate-sdk 1.9.0 → 1.10.0

package/dist/endpoint/lambda_endpoint.cjs

@@ -0,0 +1,36 @@
+const require_generic = require('./handlers/generic.cjs');
+const require_endpoint = require('./endpoint.cjs');
+const require_lambda = require('./handlers/lambda.cjs');
+
+//#region src/endpoint/lambda_endpoint.ts
+var LambdaEndpointImpl = class {
+	builder = new require_endpoint.EndpointBuilder();
+	bind(definition) {
+		this.builder.bind(definition);
+		return this;
+	}
+	withIdentityV1(...keys) {
+		this.builder.addIdentityKeys(...keys);
+		return this;
+	}
+	defaultServiceOptions(options) {
+		this.builder.setDefaultServiceOptions(options);
+		return this;
+	}
+	setLogger(logger) {
+		this.builder.setLogger(logger);
+		return this;
+	}
+	journalValueCodecProvider(codecProvider) {
+		this.builder.setJournalValueCodecProvider(codecProvider);
+		return this;
+	}
+	handler() {
+		const compressionEnabled = require_lambda.isCompressionSupported();
+		const lambdaHandler = new require_lambda.LambdaHandler(new require_generic.GenericHandler(this.builder.build(), "REQUEST_RESPONSE", compressionEnabled ? { lambdaCompression: "zstd" } : {}), compressionEnabled);
+		return lambdaHandler.handleRequest.bind(lambdaHandler);
+	}
+};
+
+//#endregion
+exports.LambdaEndpointImpl = LambdaEndpointImpl;

package/dist/endpoint/lambda_endpoint.d.cts

@@ -0,0 +1,26 @@
+import "../logging/logger_transport.cjs";
+import { RestateEndpointBase } from "../endpoint.cjs";
+import { JournalValueCodec, ServiceDefinition, VirtualObjectDefinition, WorkflowDefinition } from "@restatedev/restate-sdk-core";
+
+//#region src/endpoint/lambda_endpoint.d.ts
+
+/**
+ * LambdaEndpoint encapsulates all the Restate services served by this endpoint.
+ *
+ *
+ * @example
+ * A typical endpoint served as Lambda would look like this:
+ * ```
+ * import * as restate from "@restatedev/restate-sdk/lambda";
+ *
+ * export const handler = restate
+ *   .endpoint()
+ *   .bind(myService)
+ *   .handler();
+ */
+interface LambdaEndpoint extends RestateEndpointBase<LambdaEndpoint> {
+  handler(): (event: any, ctx: any) => Promise<any>;
+}
+//#endregion
+export { LambdaEndpoint };
+//# sourceMappingURL=lambda_endpoint.d.cts.map

package/dist/endpoint/lambda_endpoint.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lambda_endpoint.d.cts","names":[],"sources":["../../src/endpoint/lambda_endpoint.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAwCA;;;;;;;;;;;;UAAiB,cAAA,SAAuB,oBAAoB;uCAErB"}

package/dist/endpoint/lambda_endpoint.d.ts

@@ -0,0 +1,26 @@
+import "../logging/logger_transport.js";
+import { RestateEndpointBase } from "../endpoint.js";
+import { JournalValueCodec, ServiceDefinition, VirtualObjectDefinition, WorkflowDefinition } from "@restatedev/restate-sdk-core";
+
+//#region src/endpoint/lambda_endpoint.d.ts
+
+/**
+ * LambdaEndpoint encapsulates all the Restate services served by this endpoint.
+ *
+ *
+ * @example
+ * A typical endpoint served as Lambda would look like this:
+ * ```
+ * import * as restate from "@restatedev/restate-sdk/lambda";
+ *
+ * export const handler = restate
+ *   .endpoint()
+ *   .bind(myService)
+ *   .handler();
+ */
+interface LambdaEndpoint extends RestateEndpointBase<LambdaEndpoint> {
+  handler(): (event: any, ctx: any) => Promise<any>;
+}
+//#endregion
+export { LambdaEndpoint };
+//# sourceMappingURL=lambda_endpoint.d.ts.map

package/dist/endpoint/lambda_endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lambda_endpoint.d.ts","names":[],"sources":["../../src/endpoint/lambda_endpoint.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAwCA;;;;;;;;;;;;UAAiB,cAAA,SAAuB,oBAAoB;uCAErB"}

package/dist/endpoint/lambda_endpoint.js

@@ -0,0 +1,37 @@
+import { GenericHandler } from "./handlers/generic.js";
+import { EndpointBuilder } from "./endpoint.js";
+import { LambdaHandler, isCompressionSupported } from "./handlers/lambda.js";
+
+//#region src/endpoint/lambda_endpoint.ts
+var LambdaEndpointImpl = class {
+	builder = new EndpointBuilder();
+	bind(definition) {
+		this.builder.bind(definition);
+		return this;
+	}
+	withIdentityV1(...keys) {
+		this.builder.addIdentityKeys(...keys);
+		return this;
+	}
+	defaultServiceOptions(options) {
+		this.builder.setDefaultServiceOptions(options);
+		return this;
+	}
+	setLogger(logger) {
+		this.builder.setLogger(logger);
+		return this;
+	}
+	journalValueCodecProvider(codecProvider) {
+		this.builder.setJournalValueCodecProvider(codecProvider);
+		return this;
+	}
+	handler() {
+		const compressionEnabled = isCompressionSupported();
+		const lambdaHandler = new LambdaHandler(new GenericHandler(this.builder.build(), "REQUEST_RESPONSE", compressionEnabled ? { lambdaCompression: "zstd" } : {}), compressionEnabled);
+		return lambdaHandler.handleRequest.bind(lambdaHandler);
+	}
+};
+
+//#endregion
+export { LambdaEndpointImpl };
+//# sourceMappingURL=lambda_endpoint.js.map

package/dist/endpoint/lambda_endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lambda_endpoint.js","names":[],"sources":["../../src/endpoint/lambda_endpoint.ts"],"sourcesContent":["/*\n * Copyright (c) 2023-2024 - Restate Software, Inc., Restate GmbH\n *\n * This file is part of the Restate SDK for Node.js/TypeScript,\n * which is released under the MIT license.\n *\n * You can find a copy of the license in file LICENSE in the root\n * directory of this repository or package, or at\n * https://github.com/restatedev/sdk-typescript/blob/main/LICENSE\n */\n\nimport type {\n  JournalValueCodec,\n  ServiceDefinition,\n  VirtualObjectDefinition,\n  WorkflowDefinition,\n} from \"@restatedev/restate-sdk-core\";\nimport { EndpointBuilder } from \"./endpoint.js\";\nimport type {\n  DefaultServiceOptions,\n  RestateEndpointBase,\n} from \"../endpoint.js\";\nimport { GenericHandler } from \"./handlers/generic.js\";\nimport { isCompressionSupported, LambdaHandler } from \"./handlers/lambda.js\";\nimport type { LoggerTransport } from \"../logging/logger_transport.js\";\n\n/**\n * LambdaEndpoint encapsulates all the Restate services served by this endpoint.\n *\n *\n * @example\n * A typical endpoint served as Lambda would look like this:\n * ```\n * import * as restate from \"@restatedev/restate-sdk/lambda\";\n *\n * export const handler = restate\n *   .endpoint()\n *   .bind(myService)\n *   .handler();\n */\nexport interface LambdaEndpoint extends RestateEndpointBase<LambdaEndpoint> {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  handler(): (event: any, ctx: any) => Promise<any>;\n}\n\nexport class LambdaEndpointImpl implements LambdaEndpoint {\n  private builder: EndpointBuilder = new EndpointBuilder();\n\n  public bind<P extends string, M>(\n    definition:\n      | ServiceDefinition<P, M>\n      | VirtualObjectDefinition<P, M>\n      | WorkflowDefinition<P, M>\n  ): LambdaEndpoint {\n    this.builder.bind(definition);\n    return this;\n  }\n\n  public withIdentityV1(...keys: string[]): LambdaEndpoint {\n    this.builder.addIdentityKeys(...keys);\n    return this;\n  }\n\n  public defaultServiceOptions(options: DefaultServiceOptions): LambdaEndpoint {\n    this.builder.setDefaultServiceOptions(options);\n    return this;\n  }\n\n  public setLogger(logger: LoggerTransport): LambdaEndpoint {\n    this.builder.setLogger(logger);\n    return this;\n  }\n\n  public journalValueCodecProvider(\n    codecProvider: () => Promise<JournalValueCodec>\n  ): LambdaEndpoint {\n    this.builder.setJournalValueCodecProvider(codecProvider);\n    return this;\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  handler(): (event: any, ctx: any) => Promise<any> {\n    const compressionEnabled = isCompressionSupported();\n\n    const genericHandler = new GenericHandler(\n      this.builder.build(),\n      \"REQUEST_RESPONSE\",\n      compressionEnabled\n        ? {\n            lambdaCompression: \"zstd\",\n          }\n        : {}\n    );\n    const lambdaHandler = new LambdaHandler(genericHandler, compressionEnabled);\n    return lambdaHandler.handleRequest.bind(lambdaHandler);\n  }\n}\n"],"mappings":";;;;;AA6CA,IAAa,qBAAb,MAA0D;CACxD,AAAQ,UAA2B,IAAI,iBAAiB;CAExD,AAAO,KACL,YAIgB;AAChB,OAAK,QAAQ,KAAK,WAAW;AAC7B,SAAO;;CAGT,AAAO,eAAe,GAAG,MAAgC;AACvD,OAAK,QAAQ,gBAAgB,GAAG,KAAK;AACrC,SAAO;;CAGT,AAAO,sBAAsB,SAAgD;AAC3E,OAAK,QAAQ,yBAAyB,QAAQ;AAC9C,SAAO;;CAGT,AAAO,UAAU,QAAyC;AACxD,OAAK,QAAQ,UAAU,OAAO;AAC9B,SAAO;;CAGT,AAAO,0BACL,eACgB;AAChB,OAAK,QAAQ,6BAA6B,cAAc;AACxD,SAAO;;CAIT,UAAkD;EAChD,MAAM,qBAAqB,wBAAwB;EAWnD,MAAM,gBAAgB,IAAI,cATH,IAAI,eACzB,KAAK,QAAQ,OAAO,EACpB,oBACA,qBACI,EACE,mBAAmB,QACpB,GACD,EAAE,CACP,EACuD,mBAAmB;AAC3E,SAAO,cAAc,cAAc,KAAK,cAAc"}

package/dist/endpoint/node_endpoint.cjs

@@ -0,0 +1,101 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_errors = require('../types/errors.cjs');
+const require_generic = require('./handlers/generic.cjs');
+const require_endpoint = require('./endpoint.cjs');
+let http2 = require("http2");
+http2 = require_rolldown_runtime.__toESM(http2);
+let node_stream = require("node:stream");
+node_stream = require_rolldown_runtime.__toESM(node_stream);
+
+//#region src/endpoint/node_endpoint.ts
+var NodeEndpoint = class {
+	builder = new require_endpoint.EndpointBuilder();
+	bind(definition) {
+		this.builder.bind(definition);
+		return this;
+	}
+	withIdentityV1(...keys) {
+		this.builder.addIdentityKeys(...keys);
+		return this;
+	}
+	defaultServiceOptions(options) {
+		this.builder.setDefaultServiceOptions(options);
+		return this;
+	}
+	setLogger(logger) {
+		this.builder.setLogger(logger);
+		return this;
+	}
+	journalValueCodecProvider(codecProvider) {
+		this.builder.setJournalValueCodecProvider(codecProvider);
+		return this;
+	}
+	http2Handler() {
+		return nodeHttp2Handler(this.builder.build());
+	}
+	listen(port) {
+		const endpoint = this.builder.build();
+		const actualPort = port ?? parseInt(process.env.PORT ?? "9080");
+		endpoint.rlog.info(`Restate SDK started listening on ${actualPort}...`);
+		const server = http2.createServer(nodeHttp2Handler(endpoint));
+		return new Promise((resolve, reject) => {
+			let failed = false;
+			server.once("error", (e) => {
+				failed = true;
+				reject(e);
+			});
+			server.listen(actualPort, () => {
+				if (failed) return;
+				const address = server.address();
+				if (address === null || typeof address === "string") reject(/* @__PURE__ */ new TypeError("endpoint.listen() currently supports only binding to a PORT"));
+				else resolve(address.port);
+			});
+		});
+	}
+};
+function nodeHttp2Handler(endpoint) {
+	const handler = new require_generic.GenericHandler(endpoint, "BIDI_STREAM", {});
+	return (request, response) => {
+		(async () => {
+			const abortController = new AbortController();
+			request.once("aborted", () => {
+				abortController.abort();
+			});
+			request.once("close", () => {
+				abortController.abort();
+			});
+			request.once("error", () => {
+				abortController.abort();
+			});
+			if (request.destroyed || request.aborted) {
+				endpoint.rlog.error("Client disconnected");
+				abortController.abort();
+			}
+			try {
+				const url = request.url;
+				const webRequestBody = node_stream.Readable.toWeb(request);
+				const resp = await handler.handle({
+					url,
+					headers: request.headers,
+					body: webRequestBody,
+					extraArgs: [],
+					abortSignal: abortController.signal
+				});
+				if (response.destroyed) return;
+				response.writeHead(resp.statusCode, resp.headers);
+				const responseWeb = node_stream.Writable.toWeb(response);
+				await resp.body.pipeTo(responseWeb);
+			} catch (e) {
+				const error = require_errors.ensureError(e);
+				const logger = require_generic.tryCreateContextualLogger(endpoint.loggerTransport, request.url, request.headers) ?? endpoint.rlog;
+				if (error.name === "AbortError") logger.error("Got abort error from connection: " + error.message + "\nThis might indicate that:\n* The restate-server aborted the connection after hitting the 'abort-timeout'\n* The connection with the restate-server was lost\n\nPlease check the invocation in the Restate UI for more details.");
+				else logger.error("Error while handling request: " + (error.stack ?? error.message));
+				response.destroy(error);
+				abortController.abort();
+			}
+		})().catch(() => {});
+	};
+}
+
+//#endregion
+exports.NodeEndpoint = NodeEndpoint;

package/dist/{esm/src/endpoint → endpoint}/node_endpoint.d.ts

@@ -1,4 +1,4 @@
-import type { RestateEndpoint } from "../public_api.js";
+import type { RestateEndpoint } from "../index.js";
 import type { JournalValueCodec, ServiceDefinition, VirtualObjectDefinition, WorkflowDefinition } from "@restatedev/restate-sdk-core";
 import type { Http2ServerRequest, Http2ServerResponse } from "http2";
 import type { LoggerTransport } from "../logging/logger_transport.js";

package/dist/endpoint/node_endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node_endpoint.d.ts","sourceRoot":"","sources":["../../src/endpoint/node_endpoint.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EACnB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAC;AAWrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE5D,qBAAa,YAAa,YAAW,eAAe;IAClD,OAAO,CAAC,OAAO,CAA0C;IAElD,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAC7B,UAAU,EACN,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GACvB,uBAAuB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC7B,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC3B,eAAe;IAKX,cAAc,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,eAAe;IAKlD,qBAAqB,CAC1B,OAAO,EAAE,qBAAqB,GAC7B,eAAe;IAKX,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe;IAKnD,yBAAyB,CAC9B,aAAa,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,GAC9C,eAAe;IAKlB,YAAY,IAAI,CACd,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,mBAAmB,KAC1B,IAAI;IAIT,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CA+BvC"}

package/dist/endpoint/node_endpoint.js

@@ -0,0 +1,99 @@
+import { ensureError } from "../types/errors.js";
+import { GenericHandler, tryCreateContextualLogger } from "./handlers/generic.js";
+import { EndpointBuilder } from "./endpoint.js";
+import * as http2 from "http2";
+import { Readable, Writable } from "node:stream";
+
+//#region src/endpoint/node_endpoint.ts
+var NodeEndpoint = class {
+	builder = new EndpointBuilder();
+	bind(definition) {
+		this.builder.bind(definition);
+		return this;
+	}
+	withIdentityV1(...keys) {
+		this.builder.addIdentityKeys(...keys);
+		return this;
+	}
+	defaultServiceOptions(options) {
+		this.builder.setDefaultServiceOptions(options);
+		return this;
+	}
+	setLogger(logger) {
+		this.builder.setLogger(logger);
+		return this;
+	}
+	journalValueCodecProvider(codecProvider) {
+		this.builder.setJournalValueCodecProvider(codecProvider);
+		return this;
+	}
+	http2Handler() {
+		return nodeHttp2Handler(this.builder.build());
+	}
+	listen(port) {
+		const endpoint = this.builder.build();
+		const actualPort = port ?? parseInt(process.env.PORT ?? "9080");
+		endpoint.rlog.info(`Restate SDK started listening on ${actualPort}...`);
+		const server = http2.createServer(nodeHttp2Handler(endpoint));
+		return new Promise((resolve, reject) => {
+			let failed = false;
+			server.once("error", (e) => {
+				failed = true;
+				reject(e);
+			});
+			server.listen(actualPort, () => {
+				if (failed) return;
+				const address = server.address();
+				if (address === null || typeof address === "string") reject(/* @__PURE__ */ new TypeError("endpoint.listen() currently supports only binding to a PORT"));
+				else resolve(address.port);
+			});
+		});
+	}
+};
+function nodeHttp2Handler(endpoint) {
+	const handler = new GenericHandler(endpoint, "BIDI_STREAM", {});
+	return (request, response) => {
+		(async () => {
+			const abortController = new AbortController();
+			request.once("aborted", () => {
+				abortController.abort();
+			});
+			request.once("close", () => {
+				abortController.abort();
+			});
+			request.once("error", () => {
+				abortController.abort();
+			});
+			if (request.destroyed || request.aborted) {
+				endpoint.rlog.error("Client disconnected");
+				abortController.abort();
+			}
+			try {
+				const url = request.url;
+				const webRequestBody = Readable.toWeb(request);
+				const resp = await handler.handle({
+					url,
+					headers: request.headers,
+					body: webRequestBody,
+					extraArgs: [],
+					abortSignal: abortController.signal
+				});
+				if (response.destroyed) return;
+				response.writeHead(resp.statusCode, resp.headers);
+				const responseWeb = Writable.toWeb(response);
+				await resp.body.pipeTo(responseWeb);
+			} catch (e) {
+				const error = ensureError(e);
+				const logger = tryCreateContextualLogger(endpoint.loggerTransport, request.url, request.headers) ?? endpoint.rlog;
+				if (error.name === "AbortError") logger.error("Got abort error from connection: " + error.message + "\nThis might indicate that:\n* The restate-server aborted the connection after hitting the 'abort-timeout'\n* The connection with the restate-server was lost\n\nPlease check the invocation in the Restate UI for more details.");
+				else logger.error("Error while handling request: " + (error.stack ?? error.message));
+				response.destroy(error);
+				abortController.abort();
+			}
+		})().catch(() => {});
+	};
+}
+
+//#endregion
+export { NodeEndpoint };
+//# sourceMappingURL=node_endpoint.js.map

package/dist/endpoint/node_endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node_endpoint.js","names":[],"sources":["../../src/endpoint/node_endpoint.ts"],"sourcesContent":["/*\n * Copyright (c) 2023-2024 - Restate Software, Inc., Restate GmbH\n *\n * This file is part of the Restate SDK for Node.js/TypeScript,\n * which is released under the MIT license.\n *\n * You can find a copy of the license in file LICENSE in the root\n * directory of this repository or package, or at\n * https://github.com/restatedev/sdk-typescript/blob/main/LICENSE\n */\n\nimport type { RestateEndpoint } from \"../index.js\";\nimport type {\n  JournalValueCodec,\n  ServiceDefinition,\n  VirtualObjectDefinition,\n  WorkflowDefinition,\n} from \"@restatedev/restate-sdk-core\";\n\nimport type { Http2ServerRequest, Http2ServerResponse } from \"http2\";\nimport * as http2 from \"http2\";\nimport type { Endpoint } from \"./endpoint.js\";\nimport { EndpointBuilder } from \"./endpoint.js\";\nimport {\n  GenericHandler,\n  tryCreateContextualLogger,\n} from \"./handlers/generic.js\";\nimport { Readable, Writable } from \"node:stream\";\nimport type { WritableStream } from \"node:stream/web\";\nimport { ensureError } from \"../types/errors.js\";\nimport type { LoggerTransport } from \"../logging/logger_transport.js\";\nimport type { DefaultServiceOptions } from \"../endpoint.js\";\n\nexport class NodeEndpoint implements RestateEndpoint {\n  private builder: EndpointBuilder = new EndpointBuilder();\n\n  public bind<P extends string, M>(\n    definition:\n      | ServiceDefinition<P, M>\n      | VirtualObjectDefinition<P, M>\n      | WorkflowDefinition<P, M>\n  ): RestateEndpoint {\n    this.builder.bind(definition);\n    return this;\n  }\n\n  public withIdentityV1(...keys: string[]): RestateEndpoint {\n    this.builder.addIdentityKeys(...keys);\n    return this;\n  }\n\n  public defaultServiceOptions(\n    options: DefaultServiceOptions\n  ): RestateEndpoint {\n    this.builder.setDefaultServiceOptions(options);\n    return this;\n  }\n\n  public setLogger(logger: LoggerTransport): RestateEndpoint {\n    this.builder.setLogger(logger);\n    return this;\n  }\n\n  public journalValueCodecProvider(\n    codecProvider: () => Promise<JournalValueCodec>\n  ): RestateEndpoint {\n    this.builder.setJournalValueCodecProvider(codecProvider);\n    return this;\n  }\n\n  http2Handler(): (\n    request: Http2ServerRequest,\n    response: Http2ServerResponse\n  ) => void {\n    return nodeHttp2Handler(this.builder.build());\n  }\n\n  listen(port?: number): Promise<number> {\n    const endpoint = this.builder.build();\n\n    const actualPort = port ?? parseInt(process.env.PORT ?? \"9080\");\n    endpoint.rlog.info(`Restate SDK started listening on ${actualPort}...`);\n\n    const server = http2.createServer(nodeHttp2Handler(endpoint));\n\n    return new Promise((resolve, reject) => {\n      let failed = false;\n      server.once(\"error\", (e: Error) => {\n        failed = true;\n        reject(e);\n      });\n      server.listen(actualPort, () => {\n        if (failed) {\n          return;\n        }\n        const address = server.address();\n        if (address === null || typeof address === \"string\") {\n          reject(\n            new TypeError(\n              \"endpoint.listen() currently supports only binding to a PORT\"\n            )\n          );\n        } else {\n          resolve(address.port);\n        }\n      });\n    });\n  }\n}\n\nfunction nodeHttp2Handler(\n  endpoint: Endpoint\n): (request: Http2ServerRequest, response: Http2ServerResponse) => void {\n  const handler = new GenericHandler(endpoint, \"BIDI_STREAM\", {});\n\n  return (request, response) => {\n    (async () => {\n      const abortController = new AbortController();\n\n      request.once(\"aborted\", () => {\n        abortController.abort();\n      });\n      request.once(\"close\", () => {\n        abortController.abort();\n      });\n      request.once(\"error\", () => {\n        abortController.abort();\n      });\n\n      if (request.destroyed || request.aborted) {\n        endpoint.rlog.error(\"Client disconnected\");\n        abortController.abort();\n      }\n\n      try {\n        const url = request.url;\n        const webRequestBody = Readable.toWeb(request);\n\n        const resp = await handler.handle({\n          url,\n          headers: request.headers,\n          body: webRequestBody,\n          extraArgs: [],\n          abortSignal: abortController.signal,\n        });\n\n        if (response.destroyed) {\n          return;\n        }\n\n        response.writeHead(resp.statusCode, resp.headers);\n        const responseWeb = Writable.toWeb(\n          response\n        ) as WritableStream<Uint8Array>;\n        await resp.body.pipeTo(responseWeb);\n      } catch (e) {\n        const error = ensureError(e);\n\n        const logger =\n          tryCreateContextualLogger(\n            endpoint.loggerTransport,\n            request.url,\n            request.headers\n          ) ?? endpoint.rlog;\n        if (error.name === \"AbortError\") {\n          logger.error(\n            \"Got abort error from connection: \" +\n              error.message +\n              \"\\n\" +\n              \"This might indicate that:\\n\" +\n              \"* The restate-server aborted the connection after hitting the 'abort-timeout'\\n\" +\n              \"* The connection with the restate-server was lost\\n\" +\n              \"\\n\" +\n              \"Please check the invocation in the Restate UI for more details.\"\n          );\n        } else {\n          logger.error(\n            \"Error while handling request: \" + (error.stack ?? error.message)\n          );\n        }\n\n        response.destroy(error);\n        abortController.abort();\n      }\n    })().catch(() => {});\n  };\n}\n"],"mappings":";;;;;;;AAiCA,IAAa,eAAb,MAAqD;CACnD,AAAQ,UAA2B,IAAI,iBAAiB;CAExD,AAAO,KACL,YAIiB;AACjB,OAAK,QAAQ,KAAK,WAAW;AAC7B,SAAO;;CAGT,AAAO,eAAe,GAAG,MAAiC;AACxD,OAAK,QAAQ,gBAAgB,GAAG,KAAK;AACrC,SAAO;;CAGT,AAAO,sBACL,SACiB;AACjB,OAAK,QAAQ,yBAAyB,QAAQ;AAC9C,SAAO;;CAGT,AAAO,UAAU,QAA0C;AACzD,OAAK,QAAQ,UAAU,OAAO;AAC9B,SAAO;;CAGT,AAAO,0BACL,eACiB;AACjB,OAAK,QAAQ,6BAA6B,cAAc;AACxD,SAAO;;CAGT,eAGU;AACR,SAAO,iBAAiB,KAAK,QAAQ,OAAO,CAAC;;CAG/C,OAAO,MAAgC;EACrC,MAAM,WAAW,KAAK,QAAQ,OAAO;EAErC,MAAM,aAAa,QAAQ,SAAS,QAAQ,IAAI,QAAQ,OAAO;AAC/D,WAAS,KAAK,KAAK,oCAAoC,WAAW,KAAK;EAEvE,MAAM,SAAS,MAAM,aAAa,iBAAiB,SAAS,CAAC;AAE7D,SAAO,IAAI,SAAS,SAAS,WAAW;GACtC,IAAI,SAAS;AACb,UAAO,KAAK,UAAU,MAAa;AACjC,aAAS;AACT,WAAO,EAAE;KACT;AACF,UAAO,OAAO,kBAAkB;AAC9B,QAAI,OACF;IAEF,MAAM,UAAU,OAAO,SAAS;AAChC,QAAI,YAAY,QAAQ,OAAO,YAAY,SACzC,wBACE,IAAI,UACF,8DACD,CACF;QAED,SAAQ,QAAQ,KAAK;KAEvB;IACF;;;AAIN,SAAS,iBACP,UACsE;CACtE,MAAM,UAAU,IAAI,eAAe,UAAU,eAAe,EAAE,CAAC;AAE/D,SAAQ,SAAS,aAAa;AAC5B,GAAC,YAAY;GACX,MAAM,kBAAkB,IAAI,iBAAiB;AAE7C,WAAQ,KAAK,iBAAiB;AAC5B,oBAAgB,OAAO;KACvB;AACF,WAAQ,KAAK,eAAe;AAC1B,oBAAgB,OAAO;KACvB;AACF,WAAQ,KAAK,eAAe;AAC1B,oBAAgB,OAAO;KACvB;AAEF,OAAI,QAAQ,aAAa,QAAQ,SAAS;AACxC,aAAS,KAAK,MAAM,sBAAsB;AAC1C,oBAAgB,OAAO;;AAGzB,OAAI;IACF,MAAM,MAAM,QAAQ;IACpB,MAAM,iBAAiB,SAAS,MAAM,QAAQ;IAE9C,MAAM,OAAO,MAAM,QAAQ,OAAO;KAChC;KACA,SAAS,QAAQ;KACjB,MAAM;KACN,WAAW,EAAE;KACb,aAAa,gBAAgB;KAC9B,CAAC;AAEF,QAAI,SAAS,UACX;AAGF,aAAS,UAAU,KAAK,YAAY,KAAK,QAAQ;IACjD,MAAM,cAAc,SAAS,MAC3B,SACD;AACD,UAAM,KAAK,KAAK,OAAO,YAAY;YAC5B,GAAG;IACV,MAAM,QAAQ,YAAY,EAAE;IAE5B,MAAM,SACJ,0BACE,SAAS,iBACT,QAAQ,KACR,QAAQ,QACT,IAAI,SAAS;AAChB,QAAI,MAAM,SAAS,aACjB,QAAO,MACL,sCACE,MAAM,UACN,mOAMH;QAED,QAAO,MACL,oCAAoC,MAAM,SAAS,MAAM,SAC1D;AAGH,aAAS,QAAQ,MAAM;AACvB,oBAAgB,OAAO;;MAEvB,CAAC,YAAY,GAAG"}

package/dist/endpoint/types.d.cts

@@ -0,0 +1,61 @@
+import { LoggerTransport } from "../logging/logger_transport.cjs";
+import { DefaultServiceOptions } from "../endpoint.cjs";
+import { JournalValueCodec, ServiceDefinition, VirtualObjectDefinition, WorkflowDefinition } from "../common_api.cjs";
+
+//#region src/endpoint/types.d.ts
+/**
+ * Options for creating an endpoint handler for Node.js HTTP/2 servers.
+ */
+interface EndpointOptions {
+  /**
+   * A list of Restate services, virtual objects, or workflows that will be exposed via the endpoint.
+   */
+  services: Array<ServiceDefinition<string, unknown> | VirtualObjectDefinition<string, unknown> | WorkflowDefinition<string, unknown>>;
+  /**
+   * Provide a list of v1 request identity public keys eg `publickeyv1_2G8dCQhArfvGpzPw5Vx2ALciR4xCLHfS5YaT93XjNxX9` to validate
+   * incoming requests against, limiting requests to Restate clusters with the corresponding private keys. This public key format is
+   * logged by the Restate process at startup if a request identity private key is provided.
+   *
+   * If this function is called, all incoming requests irrelevant of endpoint type will be expected to have
+   * `x-restate-signature-scheme: v1` and `x-restate-jwt-v1: <valid jwt signed with one of these keys>`. If not called,
+   *
+   */
+  identityKeys?: string[];
+  /**
+   * Default service options that will be used by all services bind to this endpoint.
+   *
+   * Options can be overridden on each service/handler.
+   */
+  defaultServiceOptions?: DefaultServiceOptions;
+  /**
+   * Replace the default console-based {@link LoggerTransport}
+   * @example
+   * Using console:
+   * ```ts
+   * createEndpointHandler({ logger: (meta, message, ...o) => {console.log(`${meta.level}: `, message, ...o)}})
+   * ```
+   * @example
+   * Using winston:
+   * ```ts
+   * const logger = createLogger({ ... })
+   * createEndpointHandler({ logger: (meta, message, ...o) => {logger.log(meta.level, {invocationId: meta.context?.invocationId}, [message, ...o].join(' '))} })
+   * ```
+   * @example
+   * Using pino:
+   * ```ts
+   * const logger = pino()
+   * createEndpointHandler({ logger: (meta, message, ...o) => {logger[meta.level]({invocationId: meta.context?.invocationId}, [message, ...o].join(' '))}} )
+   * ```
+   */
+  logger?: LoggerTransport;
+  /**
+   * Provider for the codec to use for journal values. One codec will be instantiated globally for this endpoint.
+   * Check {@link JournalValueCodec} for more details
+   *
+   * @experimental
+   */
+  journalValueCodecProvider?: () => Promise<JournalValueCodec>;
+}
+//#endregion
+export { EndpointOptions };
+//# sourceMappingURL=types.d.cts.map

package/dist/endpoint/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/endpoint/types.ts"],"sourcesContent":[],"mappings":";;;;;;;;UAYiB,eAAA;EAAA;;;EAOX,QAAA,EAHM,KAGN,CAFA,iBAEA,CAAA,MAAA,EAAA,OAAA,CAAA,GADA,uBACA,CAAA,MAAA,EAAA,OAAA,CAAA,GAAA,kBAAA,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA;EAHM;;;;;;;;;;;;;;;0BAoBc;;;;;;;;;;;;;;;;;;;;;WAqBf;;;;;;;oCAQyB,QAAQ"}

package/dist/endpoint/types.d.ts

@@ -0,0 +1,61 @@
+import { LoggerTransport } from "../logging/logger_transport.js";
+import { DefaultServiceOptions } from "../endpoint.js";
+import { JournalValueCodec, ServiceDefinition, VirtualObjectDefinition, WorkflowDefinition } from "../common_api.js";
+
+//#region src/endpoint/types.d.ts
+/**
+ * Options for creating an endpoint handler for Node.js HTTP/2 servers.
+ */
+interface EndpointOptions {
+  /**
+   * A list of Restate services, virtual objects, or workflows that will be exposed via the endpoint.
+   */
+  services: Array<ServiceDefinition<string, unknown> | VirtualObjectDefinition<string, unknown> | WorkflowDefinition<string, unknown>>;
+  /**
+   * Provide a list of v1 request identity public keys eg `publickeyv1_2G8dCQhArfvGpzPw5Vx2ALciR4xCLHfS5YaT93XjNxX9` to validate
+   * incoming requests against, limiting requests to Restate clusters with the corresponding private keys. This public key format is
+   * logged by the Restate process at startup if a request identity private key is provided.
+   *
+   * If this function is called, all incoming requests irrelevant of endpoint type will be expected to have
+   * `x-restate-signature-scheme: v1` and `x-restate-jwt-v1: <valid jwt signed with one of these keys>`. If not called,
+   *
+   */
+  identityKeys?: string[];
+  /**
+   * Default service options that will be used by all services bind to this endpoint.
+   *
+   * Options can be overridden on each service/handler.
+   */
+  defaultServiceOptions?: DefaultServiceOptions;
+  /**
+   * Replace the default console-based {@link LoggerTransport}
+   * @example
+   * Using console:
+   * ```ts
+   * createEndpointHandler({ logger: (meta, message, ...o) => {console.log(`${meta.level}: `, message, ...o)}})
+   * ```
+   * @example
+   * Using winston:
+   * ```ts
+   * const logger = createLogger({ ... })
+   * createEndpointHandler({ logger: (meta, message, ...o) => {logger.log(meta.level, {invocationId: meta.context?.invocationId}, [message, ...o].join(' '))} })
+   * ```
+   * @example
+   * Using pino:
+   * ```ts
+   * const logger = pino()
+   * createEndpointHandler({ logger: (meta, message, ...o) => {logger[meta.level]({invocationId: meta.context?.invocationId}, [message, ...o].join(' '))}} )
+   * ```
+   */
+  logger?: LoggerTransport;
+  /**
+   * Provider for the codec to use for journal values. One codec will be instantiated globally for this endpoint.
+   * Check {@link JournalValueCodec} for more details
+   *
+   * @experimental
+   */
+  journalValueCodecProvider?: () => Promise<JournalValueCodec>;
+}
+//#endregion
+export { EndpointOptions };
+//# sourceMappingURL=types.d.ts.map

package/dist/endpoint/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/endpoint/types.ts"],"sourcesContent":[],"mappings":";;;;;;;;UAYiB,eAAA;EAAA;;;EAOX,QAAA,EAHM,KAGN,CAFA,iBAEA,CAAA,MAAA,EAAA,OAAA,CAAA,GADA,uBACA,CAAA,MAAA,EAAA,OAAA,CAAA,GAAA,kBAAA,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA;EAHM;;;;;;;;;;;;;;;0BAoBc;;;;;;;;;;;;;;;;;;;;;WAqBf;;;;;;;oCAQyB,QAAQ"}

package/dist/{cjs/src/endpoint → endpoint}/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/endpoint/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/endpoint/types.ts"],"names":[],"mappings":""}

package/dist/endpoint/withOptions.cjs

@@ -0,0 +1,15 @@
+
+//#region src/endpoint/withOptions.ts
+function withOptions(endpoint, { identityKeys, defaultServiceOptions, logger, services, journalValueCodecProvider }) {
+	let endpointWithOptions = endpoint;
+	if (identityKeys && identityKeys.length > 0) endpointWithOptions = endpointWithOptions.withIdentityV1(...identityKeys);
+	if (defaultServiceOptions) endpointWithOptions = endpointWithOptions.defaultServiceOptions(defaultServiceOptions);
+	if (journalValueCodecProvider) endpointWithOptions = endpointWithOptions.journalValueCodecProvider(journalValueCodecProvider);
+	if (logger) endpointWithOptions = endpointWithOptions.setLogger(logger);
+	return services.reduce((results, service) => {
+		return results.bind(service);
+	}, endpointWithOptions);
+}
+
+//#endregion
+exports.withOptions = withOptions;

package/dist/endpoint/withOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withOptions.d.ts","sourceRoot":"","sources":["../../src/endpoint/withOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,wBAAgB,WAAW,CAAC,CAAC,SAAS,mBAAmB,CAAC,CAAC,CAAC,EAC1D,QAAQ,EAAE,CAAC,EACX,EACE,YAAY,EACZ,qBAAqB,EACrB,MAAM,EACN,QAAQ,EACR,yBAAyB,GAC1B,EAAE,eAAe,GACjB,CAAC,CAsBH"}

package/dist/endpoint/withOptions.js

@@ -0,0 +1,15 @@
+//#region src/endpoint/withOptions.ts
+function withOptions(endpoint, { identityKeys, defaultServiceOptions, logger, services, journalValueCodecProvider }) {
+	let endpointWithOptions = endpoint;
+	if (identityKeys && identityKeys.length > 0) endpointWithOptions = endpointWithOptions.withIdentityV1(...identityKeys);
+	if (defaultServiceOptions) endpointWithOptions = endpointWithOptions.defaultServiceOptions(defaultServiceOptions);
+	if (journalValueCodecProvider) endpointWithOptions = endpointWithOptions.journalValueCodecProvider(journalValueCodecProvider);
+	if (logger) endpointWithOptions = endpointWithOptions.setLogger(logger);
+	return services.reduce((results, service) => {
+		return results.bind(service);
+	}, endpointWithOptions);
+}
+
+//#endregion
+export { withOptions };
+//# sourceMappingURL=withOptions.js.map

package/dist/endpoint/withOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withOptions.js","names":[],"sources":["../../src/endpoint/withOptions.ts"],"sourcesContent":["import type { RestateEndpointBase } from \"../endpoint.js\";\nimport type { EndpointOptions } from \"./types.js\";\n\nexport function withOptions<E extends RestateEndpointBase<E>>(\n  endpoint: E,\n  {\n    identityKeys,\n    defaultServiceOptions,\n    logger,\n    services,\n    journalValueCodecProvider,\n  }: EndpointOptions\n): E {\n  let endpointWithOptions = endpoint;\n  if (identityKeys && identityKeys.length > 0) {\n    endpointWithOptions = endpointWithOptions.withIdentityV1(...identityKeys);\n  }\n  if (defaultServiceOptions) {\n    endpointWithOptions = endpointWithOptions.defaultServiceOptions(\n      defaultServiceOptions\n    );\n  }\n  if (journalValueCodecProvider) {\n    endpointWithOptions = endpointWithOptions.journalValueCodecProvider(\n      journalValueCodecProvider\n    );\n  }\n  if (logger) {\n    endpointWithOptions = endpointWithOptions.setLogger(logger);\n  }\n\n  return services.reduce((results, service) => {\n    return results.bind(service);\n  }, endpointWithOptions);\n}\n"],"mappings":";AAGA,SAAgB,YACd,UACA,EACE,cACA,uBACA,QACA,UACA,6BAEC;CACH,IAAI,sBAAsB;AAC1B,KAAI,gBAAgB,aAAa,SAAS,EACxC,uBAAsB,oBAAoB,eAAe,GAAG,aAAa;AAE3E,KAAI,sBACF,uBAAsB,oBAAoB,sBACxC,sBACD;AAEH,KAAI,0BACF,uBAAsB,oBAAoB,0BACxC,0BACD;AAEH,KAAI,OACF,uBAAsB,oBAAoB,UAAU,OAAO;AAG7D,QAAO,SAAS,QAAQ,SAAS,YAAY;AAC3C,SAAO,QAAQ,KAAK,QAAQ;IAC3B,oBAAoB"}