@restatedev/restate-sdk 1.11.1 → 1.12.0

package/dist/endpoint/node_endpoint.cjs

@@ -3,8 +3,8 @@ const require_errors = require('../types/errors.cjs');
 const require_endpoint = require('./endpoint.cjs');
 const require_utils = require('./handlers/utils.cjs');
 const require_generic = require('./handlers/generic.cjs');
-let http2 = require("http2");
-http2 = require_rolldown_runtime.__toESM(http2);
+let node_http2 = require("node:http2");
+node_http2 = require_rolldown_runtime.__toESM(node_http2);
 
 //#region src/endpoint/node_endpoint.ts
 var NodeEndpoint = class {
@@ -29,14 +29,26 @@ var NodeEndpoint = class {
 		this.builder.setJournalValueCodecProvider(codecProvider);
 		return this;
 	}
-	http2Handler() {
-		return nodeHttp2Handler(this.builder.build());
+	http2Handler(options) {
+		return nodeHttp2Handler(this.builder.build(), options?.bidirectional === false ? "REQUEST_RESPONSE" : "BIDI_STREAM");
+	}
+	http1Handler(options) {
+		return nodeHttp1Handler(this.builder.build(), options?.bidirectional ? "BIDI_STREAM" : "REQUEST_RESPONSE");
+	}
+	handler(options) {
+		const endpoint = this.builder.build();
+		const h2Handler = nodeHttp2Handler(endpoint, options?.bidirectional === false ? "REQUEST_RESPONSE" : "BIDI_STREAM");
+		const h1Handler = nodeHttp1Handler(endpoint, options?.bidirectional ? "BIDI_STREAM" : "REQUEST_RESPONSE");
+		return ((request, response) => {
+			if (request.httpVersionMajor >= 2) h2Handler(request, response);
+			else h1Handler(request, response);
+		});
 	}
 	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));
+		const server = node_http2.createServer(nodeHttp2Handler(endpoint, "BIDI_STREAM"));
 		return new Promise((resolve, reject) => {
 			let failed = false;
 			server.once("error", (e) => {
@@ -52,8 +64,14 @@ var NodeEndpoint = class {
 		});
 	}
 };
-function nodeHttp2Handler(endpoint) {
-	const handler = require_generic.createRestateHandler(endpoint, "BIDI_STREAM", {});
+function nodeHttp1Handler(endpoint, protocolMode) {
+	return nodeHandlerImpl(endpoint, protocolMode);
+}
+function nodeHttp2Handler(endpoint, protocolMode) {
+	return nodeHandlerImpl(endpoint, protocolMode);
+}
+function nodeHandlerImpl(endpoint, protocolMode) {
+	const handler = require_generic.createRestateHandler(endpoint, protocolMode, {});
 	return (httpRequest, httpResponse) => {
 		const url = httpRequest.url;
 		const abortController = new AbortController();
@@ -80,18 +98,16 @@ function inputReaderAdapter(request) {
 	return request[Symbol.asyncIterator]();
 }
 function outputWriterAdapter(response) {
+	const res = response;
 	return {
 		write: function(value) {
 			return new Promise((resolve, reject) => {
-				response.write(value, (err) => {
-					if (err) reject(err);
-					else resolve();
-				});
+				res.write(value, (err) => err ? reject(err) : resolve());
 			});
 		},
 		close: function() {
 			return new Promise((resolve) => {
-				response.end(() => resolve());
+				res.end(() => resolve());
 			});
 		}
 	};

package/dist/endpoint/node_endpoint.d.ts

@@ -1,6 +1,7 @@
 import type { RestateEndpoint } from "../index.js";
 import type { JournalValueCodec, ServiceDefinition, VirtualObjectDefinition, WorkflowDefinition } from "@restatedev/restate-sdk-core";
-import { Http2ServerRequest, Http2ServerResponse } from "http2";
+import { IncomingMessage, ServerResponse } from "node:http";
+import { Http2ServerRequest, Http2ServerResponse } from "node:http2";
 import type { LoggerTransport } from "../logging/logger_transport.js";
 import type { DefaultServiceOptions } from "../endpoint.js";
 export declare class NodeEndpoint implements RestateEndpoint {
@@ -10,7 +11,18 @@ export declare class NodeEndpoint implements RestateEndpoint {
     defaultServiceOptions(options: DefaultServiceOptions): RestateEndpoint;
     setLogger(logger: LoggerTransport): RestateEndpoint;
     journalValueCodecProvider(codecProvider: () => Promise<JournalValueCodec>): RestateEndpoint;
-    http2Handler(): (request: Http2ServerRequest, response: Http2ServerResponse) => void;
+    http2Handler(options?: {
+        bidirectional?: boolean;
+    }): (request: Http2ServerRequest, response: Http2ServerResponse) => void;
+    http1Handler(options?: {
+        bidirectional?: boolean;
+    }): (request: IncomingMessage, response: ServerResponse) => void;
+    handler(options?: {
+        bidirectional?: boolean;
+    }): {
+        (request: IncomingMessage, response: ServerResponse): void;
+        (request: Http2ServerRequest, response: Http2ServerResponse): void;
+    };
     listen(port?: number): Promise<number>;
 }
 //# sourceMappingURL=node_endpoint.d.ts.map

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

@@ -1 +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;AACtC,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAC;AAMhE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAI5D,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"}
+{"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;AACtC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAMrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAK5D,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,CAAC,OAAO,CAAC,EAAE;QACrB,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,GAAG,CAAC,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,mBAAmB,KAAK,IAAI;IAOxE,YAAY,CAAC,OAAO,CAAC,EAAE;QACrB,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,GAAG,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,KAAK,IAAI;IAOhE,OAAO,CAAC,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG;QAC9C,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;QAC3D,CAAC,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAC;KACpE;IA6BD,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAiCvC"}

package/dist/endpoint/node_endpoint.js

@@ -2,7 +2,7 @@ import { ensureError } from "../types/errors.js";
 import { EndpointBuilder } from "./endpoint.js";
 import { tryCreateContextualLogger } from "./handlers/utils.js";
 import { createRestateHandler } from "./handlers/generic.js";
-import * as http2 from "http2";
+import * as http2 from "node:http2";
 
 //#region src/endpoint/node_endpoint.ts
 var NodeEndpoint = class {
@@ -27,14 +27,26 @@ var NodeEndpoint = class {
 		this.builder.setJournalValueCodecProvider(codecProvider);
 		return this;
 	}
-	http2Handler() {
-		return nodeHttp2Handler(this.builder.build());
+	http2Handler(options) {
+		return nodeHttp2Handler(this.builder.build(), options?.bidirectional === false ? "REQUEST_RESPONSE" : "BIDI_STREAM");
+	}
+	http1Handler(options) {
+		return nodeHttp1Handler(this.builder.build(), options?.bidirectional ? "BIDI_STREAM" : "REQUEST_RESPONSE");
+	}
+	handler(options) {
+		const endpoint = this.builder.build();
+		const h2Handler = nodeHttp2Handler(endpoint, options?.bidirectional === false ? "REQUEST_RESPONSE" : "BIDI_STREAM");
+		const h1Handler = nodeHttp1Handler(endpoint, options?.bidirectional ? "BIDI_STREAM" : "REQUEST_RESPONSE");
+		return ((request, response) => {
+			if (request.httpVersionMajor >= 2) h2Handler(request, response);
+			else h1Handler(request, response);
+		});
 	}
 	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));
+		const server = http2.createServer(nodeHttp2Handler(endpoint, "BIDI_STREAM"));
 		return new Promise((resolve, reject) => {
 			let failed = false;
 			server.once("error", (e) => {
@@ -50,8 +62,14 @@ var NodeEndpoint = class {
 		});
 	}
 };
-function nodeHttp2Handler(endpoint) {
-	const handler = createRestateHandler(endpoint, "BIDI_STREAM", {});
+function nodeHttp1Handler(endpoint, protocolMode) {
+	return nodeHandlerImpl(endpoint, protocolMode);
+}
+function nodeHttp2Handler(endpoint, protocolMode) {
+	return nodeHandlerImpl(endpoint, protocolMode);
+}
+function nodeHandlerImpl(endpoint, protocolMode) {
+	const handler = createRestateHandler(endpoint, protocolMode, {});
 	return (httpRequest, httpResponse) => {
 		const url = httpRequest.url;
 		const abortController = new AbortController();
@@ -78,18 +96,16 @@ function inputReaderAdapter(request) {
 	return request[Symbol.asyncIterator]();
 }
 function outputWriterAdapter(response) {
+	const res = response;
 	return {
 		write: function(value) {
 			return new Promise((resolve, reject) => {
-				response.write(value, (err) => {
-					if (err) reject(err);
-					else resolve();
-				});
+				res.write(value, (err) => err ? reject(err) : resolve());
 			});
 		},
 		close: function() {
 			return new Promise((resolve) => {
-				response.end(() => resolve());
+				res.end(() => resolve());
 			});
 		}
 	};

package/dist/endpoint/node_endpoint.js.map

@@ -1 +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\";\nimport { Http2ServerRequest, Http2ServerResponse } from \"http2\";\nimport * as http2 from \"http2\";\nimport type { Endpoint } from \"./endpoint.js\";\nimport { EndpointBuilder } from \"./endpoint.js\";\nimport { createRestateHandler } from \"./handlers/generic.js\";\nimport { ensureError } from \"../types/errors.js\";\nimport type { LoggerTransport } from \"../logging/logger_transport.js\";\nimport type { DefaultServiceOptions } from \"../endpoint.js\";\nimport { tryCreateContextualLogger } from \"./handlers/utils.js\";\nimport { InputReader, OutputWriter } from \"./handlers/types.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 = createRestateHandler(endpoint, \"BIDI_STREAM\", {});\n\n  return (httpRequest, httpResponse) => {\n    const url = httpRequest.url;\n\n    // Abort controller used to cleanup resources at the end of this stream lifecycle\n    const abortController = new AbortController();\n    httpRequest.on(\"close\", () => {\n      // The 'close' event is emitted when the Http2Stream is destroyed.\n      abortController.abort();\n    });\n\n    const restateResponse = handler.handle({\n      url,\n      headers: httpRequest.headers,\n      extraArgs: [],\n    });\n\n    httpResponse.writeHead(restateResponse.statusCode, restateResponse.headers);\n\n    restateResponse\n      .process({\n        inputReader: inputReaderAdapter(httpRequest),\n        outputWriter: outputWriterAdapter(httpResponse),\n        abortSignal: abortController.signal,\n      })\n      .catch((e) => {\n        // handle should never throw\n        const error = ensureError(e);\n        const logger =\n          tryCreateContextualLogger(\n            endpoint.loggerTransport,\n            url,\n            httpRequest.headers\n          ) ?? endpoint.rlog;\n        logger.error(\"Unexpected error: \" + (error.stack ?? error.message));\n      });\n  };\n}\n\nfunction inputReaderAdapter(request: Http2ServerRequest): InputReader {\n  return request[Symbol.asyncIterator]();\n}\n\nfunction outputWriterAdapter(response: Http2ServerResponse): OutputWriter {\n  return {\n    write: function (value: Uint8Array): Promise<void> {\n      return new Promise((resolve, reject) => {\n        response.write(value, (err) => {\n          if (err) {\n            reject(err);\n          } else {\n            resolve();\n          }\n        });\n      });\n    },\n    close: function (): Promise<void> {\n      return new Promise((resolve) => {\n        response.end(() => resolve());\n      });\n    },\n  };\n}\n"],"mappings":";;;;;;;AA6BA,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,qBAAqB,UAAU,eAAe,EAAE,CAAC;AAEjE,SAAQ,aAAa,iBAAiB;EACpC,MAAM,MAAM,YAAY;EAGxB,MAAM,kBAAkB,IAAI,iBAAiB;AAC7C,cAAY,GAAG,eAAe;AAE5B,mBAAgB,OAAO;IACvB;EAEF,MAAM,kBAAkB,QAAQ,OAAO;GACrC;GACA,SAAS,YAAY;GACrB,WAAW,EAAE;GACd,CAAC;AAEF,eAAa,UAAU,gBAAgB,YAAY,gBAAgB,QAAQ;AAE3E,kBACG,QAAQ;GACP,aAAa,mBAAmB,YAAY;GAC5C,cAAc,oBAAoB,aAAa;GAC/C,aAAa,gBAAgB;GAC9B,CAAC,CACD,OAAO,MAAM;GAEZ,MAAM,QAAQ,YAAY,EAAE;AAO5B,IALE,0BACE,SAAS,iBACT,KACA,YAAY,QACb,IAAI,SAAS,MACT,MAAM,wBAAwB,MAAM,SAAS,MAAM,SAAS;IACnE;;;AAIR,SAAS,mBAAmB,SAA0C;AACpE,QAAO,QAAQ,OAAO,gBAAgB;;AAGxC,SAAS,oBAAoB,UAA6C;AACxE,QAAO;EACL,OAAO,SAAU,OAAkC;AACjD,UAAO,IAAI,SAAS,SAAS,WAAW;AACtC,aAAS,MAAM,QAAQ,QAAQ;AAC7B,SAAI,IACF,QAAO,IAAI;SAEX,UAAS;MAEX;KACF;;EAEJ,OAAO,WAA2B;AAChC,UAAO,IAAI,SAAS,YAAY;AAC9B,aAAS,UAAU,SAAS,CAAC;KAC7B;;EAEL"}
+{"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\";\nimport { IncomingMessage, ServerResponse } from \"node:http\";\nimport { Http2ServerRequest, Http2ServerResponse } from \"node:http2\";\nimport * as http2 from \"node:http2\";\nimport type { Endpoint } from \"./endpoint.js\";\nimport { EndpointBuilder } from \"./endpoint.js\";\nimport { createRestateHandler } from \"./handlers/generic.js\";\nimport { ensureError } from \"../types/errors.js\";\nimport type { LoggerTransport } from \"../logging/logger_transport.js\";\nimport type { DefaultServiceOptions } from \"../endpoint.js\";\nimport { tryCreateContextualLogger } from \"./handlers/utils.js\";\nimport type { InputReader, OutputWriter } from \"./handlers/types.js\";\nimport type { ProtocolMode } from \"./discovery.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(options?: {\n    bidirectional?: boolean;\n  }): (request: Http2ServerRequest, response: Http2ServerResponse) => void {\n    return nodeHttp2Handler(\n      this.builder.build(),\n      options?.bidirectional === false ? \"REQUEST_RESPONSE\" : \"BIDI_STREAM\"\n    );\n  }\n\n  http1Handler(options?: {\n    bidirectional?: boolean;\n  }): (request: IncomingMessage, response: ServerResponse) => void {\n    return nodeHttp1Handler(\n      this.builder.build(),\n      options?.bidirectional ? \"BIDI_STREAM\" : \"REQUEST_RESPONSE\"\n    );\n  }\n\n  handler(options?: { bidirectional?: boolean }): {\n    (request: IncomingMessage, response: ServerResponse): void;\n    (request: Http2ServerRequest, response: Http2ServerResponse): void;\n  } {\n    const endpoint = this.builder.build();\n    const h2Handler = nodeHttp2Handler(\n      endpoint,\n      options?.bidirectional === false ? \"REQUEST_RESPONSE\" : \"BIDI_STREAM\"\n    );\n    const h1Handler = nodeHttp1Handler(\n      endpoint,\n      options?.bidirectional ? \"BIDI_STREAM\" : \"REQUEST_RESPONSE\"\n    );\n\n    return ((\n      request: IncomingMessage | Http2ServerRequest,\n      response: ServerResponse | Http2ServerResponse\n    ) => {\n      if (request.httpVersionMajor >= 2) {\n        h2Handler(\n          request as Http2ServerRequest,\n          response as Http2ServerResponse\n        );\n      } else {\n        h1Handler(request as IncomingMessage, response as ServerResponse);\n      }\n    }) as {\n      (request: IncomingMessage, response: ServerResponse): void;\n      (request: Http2ServerRequest, response: Http2ServerResponse): void;\n    };\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(\n      nodeHttp2Handler(endpoint, \"BIDI_STREAM\")\n    );\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 nodeHttp1Handler(\n  endpoint: Endpoint,\n  protocolMode: ProtocolMode\n): (request: IncomingMessage, response: ServerResponse) => void {\n  return nodeHandlerImpl(endpoint, protocolMode);\n}\n\nfunction nodeHttp2Handler(\n  endpoint: Endpoint,\n  protocolMode: ProtocolMode\n): (request: Http2ServerRequest, response: Http2ServerResponse) => void {\n  return nodeHandlerImpl(endpoint, protocolMode);\n}\n\nfunction nodeHandlerImpl(\n  endpoint: Endpoint,\n  protocolMode: ProtocolMode\n): (\n  request: Http2ServerRequest | IncomingMessage,\n  response: Http2ServerResponse | ServerResponse\n) => void {\n  const handler = createRestateHandler(endpoint, protocolMode, {});\n\n  return (httpRequest, httpResponse) => {\n    const url = httpRequest.url!;\n\n    // Abort controller used to cleanup resources at the end of this stream lifecycle\n    const abortController = new AbortController();\n    httpRequest.on(\"close\", () => {\n      abortController.abort();\n    });\n\n    const restateResponse = handler.handle({\n      url,\n      headers: httpRequest.headers,\n      extraArgs: [],\n    });\n    const res = httpResponse as NodeWritableResponse;\n    res.writeHead(restateResponse.statusCode, restateResponse.headers);\n\n    restateResponse\n      .process({\n        inputReader: inputReaderAdapter(httpRequest),\n        outputWriter: outputWriterAdapter(httpResponse),\n        abortSignal: abortController.signal,\n      })\n      .catch((e) => {\n        // handle should never throw\n        const error = ensureError(e);\n        const logger =\n          tryCreateContextualLogger(\n            endpoint.loggerTransport,\n            url,\n            httpRequest.headers\n          ) ?? endpoint.rlog;\n        logger.error(\"Unexpected error: \" + (error.stack ?? error.message));\n      });\n  };\n}\n\n// Both ServerResponse and Http2ServerResponse satisfy this interface.\n// We use it to avoid TS union overload incompatibilities.\ninterface NodeWritableResponse {\n  writeHead(statusCode: number, headers: Record<string, string>): void;\n  write(chunk: Uint8Array, callback: (err?: Error | null) => void): boolean;\n  end(callback: () => void): void;\n}\n\nfunction inputReaderAdapter(\n  request: Http2ServerRequest | IncomingMessage\n): InputReader {\n  return (request as AsyncIterable<Uint8Array>)[Symbol.asyncIterator]();\n}\n\nfunction outputWriterAdapter(\n  response: Http2ServerResponse | ServerResponse\n): OutputWriter {\n  const res = response as NodeWritableResponse;\n  return {\n    write: function (value: Uint8Array): Promise<void> {\n      return new Promise((resolve, reject) => {\n        res.write(value, (err) => (err ? reject(err) : resolve()));\n      });\n    },\n    close: function (): Promise<void> {\n      return new Promise((resolve) => {\n        res.end(() => resolve());\n      });\n    },\n  };\n}\n"],"mappings":";;;;;;;AA+BA,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,aAAa,SAE4D;AACvE,SAAO,iBACL,KAAK,QAAQ,OAAO,EACpB,SAAS,kBAAkB,QAAQ,qBAAqB,cACzD;;CAGH,aAAa,SAEoD;AAC/D,SAAO,iBACL,KAAK,QAAQ,OAAO,EACpB,SAAS,gBAAgB,gBAAgB,mBAC1C;;CAGH,QAAQ,SAGN;EACA,MAAM,WAAW,KAAK,QAAQ,OAAO;EACrC,MAAM,YAAY,iBAChB,UACA,SAAS,kBAAkB,QAAQ,qBAAqB,cACzD;EACD,MAAM,YAAY,iBAChB,UACA,SAAS,gBAAgB,gBAAgB,mBAC1C;AAED,WACE,SACA,aACG;AACH,OAAI,QAAQ,oBAAoB,EAC9B,WACE,SACA,SACD;OAED,WAAU,SAA4B,SAA2B;;;CAQvE,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,aACnB,iBAAiB,UAAU,cAAc,CAC1C;AAED,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,UACA,cAC8D;AAC9D,QAAO,gBAAgB,UAAU,aAAa;;AAGhD,SAAS,iBACP,UACA,cACsE;AACtE,QAAO,gBAAgB,UAAU,aAAa;;AAGhD,SAAS,gBACP,UACA,cAIQ;CACR,MAAM,UAAU,qBAAqB,UAAU,cAAc,EAAE,CAAC;AAEhE,SAAQ,aAAa,iBAAiB;EACpC,MAAM,MAAM,YAAY;EAGxB,MAAM,kBAAkB,IAAI,iBAAiB;AAC7C,cAAY,GAAG,eAAe;AAC5B,mBAAgB,OAAO;IACvB;EAEF,MAAM,kBAAkB,QAAQ,OAAO;GACrC;GACA,SAAS,YAAY;GACrB,WAAW,EAAE;GACd,CAAC;AAEF,EADY,aACR,UAAU,gBAAgB,YAAY,gBAAgB,QAAQ;AAElE,kBACG,QAAQ;GACP,aAAa,mBAAmB,YAAY;GAC5C,cAAc,oBAAoB,aAAa;GAC/C,aAAa,gBAAgB;GAC9B,CAAC,CACD,OAAO,MAAM;GAEZ,MAAM,QAAQ,YAAY,EAAE;AAO5B,IALE,0BACE,SAAS,iBACT,KACA,YAAY,QACb,IAAI,SAAS,MACT,MAAM,wBAAwB,MAAM,SAAS,MAAM,SAAS;IACnE;;;AAYR,SAAS,mBACP,SACa;AACb,QAAQ,QAAsC,OAAO,gBAAgB;;AAGvE,SAAS,oBACP,UACc;CACd,MAAM,MAAM;AACZ,QAAO;EACL,OAAO,SAAU,OAAkC;AACjD,UAAO,IAAI,SAAS,SAAS,WAAW;AACtC,QAAI,MAAM,QAAQ,QAAS,MAAM,OAAO,IAAI,GAAG,SAAS,CAAE;KAC1D;;EAEJ,OAAO,WAA2B;AAChC,UAAO,IAAI,SAAS,YAAY;AAC9B,QAAI,UAAU,SAAS,CAAC;KACxB;;EAEL"}

package/dist/endpoint/types.d.cts

@@ -4,7 +4,7 @@ import { JournalValueCodec, ServiceDefinition, VirtualObjectDefinition, Workflow
 
 //#region src/endpoint/types.d.ts
 /**
- * Options for creating an endpoint handler for Node.js HTTP/2 servers.
+ * Options for creating an endpoint handler.
  */
 interface EndpointOptions {
   /**

package/dist/endpoint/types.d.ts

@@ -4,7 +4,7 @@ import { JournalValueCodec, ServiceDefinition, VirtualObjectDefinition, Workflow
 
 //#region src/endpoint/types.d.ts
 /**
- * Options for creating an endpoint handler for Node.js HTTP/2 servers.
+ * Options for creating an endpoint handler.
  */
 interface EndpointOptions {
   /**

package/dist/endpoint.d.cts

@@ -1,7 +1,8 @@
 import { ObjectOptions, ServiceOptions, WorkflowOptions } from "./types/rpc.cjs";
 import { LoggerTransport } from "./logging/logger_transport.cjs";
 import { JournalValueCodec, ServiceDefinition, VirtualObjectDefinition, WorkflowDefinition } from "@restatedev/restate-sdk-core";
-import { Http2ServerRequest, Http2ServerResponse } from "http2";
+import { IncomingMessage, ServerResponse } from "node:http";
+import { Http2ServerRequest, Http2ServerResponse } from "node:http2";
 
 //#region src/endpoint.d.ts
 type DefaultServiceOptions = ServiceOptions & ObjectOptions & WorkflowOptions;
@@ -63,12 +64,15 @@ interface RestateEndpointBase<E> {
 /**
  * RestateEndpoint encapsulates all the Restate services served by this endpoint.
  *
- * A RestateEndpoint can either be served as HTTP2 server, using the methods {@link RestateEndpoint.listen} or {@link RestateEndpoint.http2Handler}.
+ * A RestateEndpoint can be served as:
+ * - An HTTP/2 server using {@link RestateEndpoint.listen}, {@link RestateEndpoint.http2Handler}
+ * - An HTTP/1.1 server using {@link RestateEndpoint.http1Handler}
+ * - A combined HTTP/1.1 + HTTP/2 server using {@link RestateEndpoint.handler}
  *
  * For Lambda, check {@link LambdaEndpoint}
  *
  * @example
- * A typical endpoint served as HTTP server would look like this:
+ * A typical endpoint served as HTTP/2 server:
  * ```
  * import * as restate from "@restatedev/restate-sdk";
  *
@@ -77,6 +81,28 @@ interface RestateEndpointBase<E> {
  *   .bind(myService)
  *   .listen(8000);
  * ```
+ *
+ * @example
+ * Using the HTTP/1.1 handler with your own server:
+ * ```
+ * import * as http from "node:http";
+ * import * as restate from "@restatedev/restate-sdk";
+ *
+ * const endpoint = restate.endpoint().bind(myService);
+ * const server = http.createServer(endpoint.http1Handler());
+ * server.listen(8000);
+ * ```
+ *
+ * @example
+ * Using the combined handler with an HTTP/2 server that also accepts HTTP/1.1:
+ * ```
+ * import * as http2 from "node:http2";
+ * import * as restate from "@restatedev/restate-sdk";
+ *
+ * const endpoint = restate.endpoint().bind(myService);
+ * const server = http2.createSecureServer({ key, cert, allowHTTP1: true }, endpoint.handler());
+ * server.listen(8000);
+ * ```
  */
 interface RestateEndpoint extends RestateEndpointBase<RestateEndpoint> {
   /**
@@ -103,9 +129,65 @@ interface RestateEndpoint extends RestateEndpointBase<RestateEndpoint> {
    */
   listen(port?: number): Promise<number>;
   /**
-   * Returns an http2 server handler. See {@link RestateEndpoint.listen} for more details.
+   * Returns an http2 server handler.
+   *
+   * By default, this handler uses bidirectional streaming (`BIDI_STREAM`).
+   * Set `bidirectional: false` to use request-response mode (`REQUEST_RESPONSE`).
+   *
+   * See {@link RestateEndpoint.listen} for more details.
+   */
+  http2Handler(options?: {
+    bidirectional?: boolean;
+  }): (request: Http2ServerRequest, response: Http2ServerResponse) => void;
+  /**
+   * Returns an http1 server handler.
+   *
+   * By default, this handler operates in request-response protocol mode (`REQUEST_RESPONSE`),
+   * which buffers the full request before sending the response. This is the safest mode
+   * for HTTP/1.1 and works across all environments and proxies.
+   *
+   * Set `bidirectional: true` to enable bidirectional streaming (`BIDI_STREAM`) for
+   * HTTP/1.1 servers that support it. Note that some proxies and clients may not
+   * handle HTTP/1.1 bidirectional streaming correctly.
+   *
+   * @example
+   * ```
+   * const httpServer = http.createServer(endpoint.http1Handler());
+   * httpServer.listen(port);
+   * ```
+   */
+  http1Handler(options?: {
+    bidirectional?: boolean;
+  }): (request: IncomingMessage, response: ServerResponse) => void;
+  /**
+   * Returns a combined request handler that auto-detects HTTP/1 vs HTTP/2
+   * requests and dispatches to the appropriate internal handler.
+   *
+   * By default (when `bidirectional` is omitted), HTTP/2+ requests use
+   * bidirectional streaming (`BIDI_STREAM`) and HTTP/1 requests use
+   * request-response mode (`REQUEST_RESPONSE`).
+   *
+   * Set `bidirectional: true` to force `BIDI_STREAM` for all requests,
+   * or `bidirectional: false` to force `REQUEST_RESPONSE` for all requests.
+   *
+   * This is useful with `http2.createSecureServer({ allowHTTP1: true })`, where
+   * the same server handles both HTTP/1.1 and HTTP/2 connections.
+   *
+   * @example
+   * ```
+   * const server = http2.createSecureServer(
+   *   { key, cert, allowHTTP1: true },
+   *   endpoint.handler()
+   * );
+   * server.listen(port);
+   * ```
    */
-  http2Handler(): (request: Http2ServerRequest, response: Http2ServerResponse) => void;
+  handler(options?: {
+    bidirectional?: boolean;
+  }): {
+    (request: IncomingMessage, response: ServerResponse): void;
+    (request: Http2ServerRequest, response: Http2ServerResponse): void;
+  };
 }
 //#endregion
 export { DefaultServiceOptions, RestateEndpoint, RestateEndpointBase };

package/dist/endpoint.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"endpoint.d.cts","names":[],"sources":["../src/endpoint.ts"],"sourcesContent":[],"mappings":";;;;;;KAyBY,qBAAA,GAAwB,iBAClC,gBACA;UAEe;EAJL;;;;;EAIK,IAAA,CAAA,UAAA,MAAA,EAAmB,CAAA,CAAA,CAAA,OAAA,EAQ5B,iBAR4B,CAQV,CARU,EAQP,CARO,CAAA,GAS5B,uBAT4B,CASJ,CATI,EASD,CATC,CAAA,GAU5B,kBAV4B,CAUT,CAVS,EAUN,CAVM,CAAA,CAAA,EAW/B,CAX+B;EAQV;;;;;;;;;EAGrB,cAAA,CAAA,GAAA,IAAA,EAAA,MAAA,EAAA,CAAA,EAWgC,CAXhC;EAWgC;;;;;;;EAwCyC,qBAAA,CAAA,OAAA,EA/B7C,qBA+B6C,CAAA,EA/BrB,CA+BqB;EAAC;AAqB/E;;;;;;;;;;;;;;;;;;;;oBA7BoB,kBAAkB;;;;;;;iDAQW,QAAQ,qBAAqB;;;;;;;;;;;;;;;;;;;;UAqB7D,eAAA,SAAwB,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;yBAuBpC;;;;4BAMZ,8BACC"}
+{"version":3,"file":"endpoint.d.cts","names":[],"sources":["../src/endpoint.ts"],"sourcesContent":[],"mappings":";;;;;;;KA0BY,qBAAA,GAAwB,iBAClC,gBACA;UAEe;EAJL;;;;;EAIK,IAAA,CAAA,UAAA,MAAA,EAAmB,CAAA,CAAA,CAAA,OAAA,EAQ5B,iBAR4B,CAQV,CARU,EAQP,CARO,CAAA,GAS5B,uBAT4B,CASJ,CATI,EASD,CATC,CAAA,GAU5B,kBAV4B,CAUT,CAVS,EAUN,CAVM,CAAA,CAAA,EAW/B,CAX+B;EAQV;;;;;;;;;EAGrB,cAAA,CAAA,GAAA,IAAA,EAAA,MAAA,EAAA,CAAA,EAWgC,CAXhC;EAWgC;;;;;;;EAwCyC,qBAAA,CAAA,OAAA,EA/B7C,qBA+B6C,CAAA,EA/BrB,CA+BqB;EAAC;AA8C/E;;;;;;;;;;;;;;;;;;;;oBAtDoB,kBAAkB;;;;;;;iDAQW,QAAQ,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA8C7D,eAAA,SAAwB,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;yBAuBpC;;;;;;;;;;;gBAYT,8BAA8B;;;;;;;;;;;;;;;;;;;;gBAqB9B,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;cA0B7B,2BAA2B;cAC3B,8BAA8B"}

package/dist/endpoint.d.ts

@@ -1,7 +1,8 @@
 import { ObjectOptions, ServiceOptions, WorkflowOptions } from "./types/rpc.js";
 import { LoggerTransport } from "./logging/logger_transport.js";
 import { JournalValueCodec, ServiceDefinition, VirtualObjectDefinition, WorkflowDefinition } from "@restatedev/restate-sdk-core";
-import { Http2ServerRequest, Http2ServerResponse } from "http2";
+import { Http2ServerRequest, Http2ServerResponse } from "node:http2";
+import { IncomingMessage, ServerResponse } from "node:http";
 
 //#region src/endpoint.d.ts
 type DefaultServiceOptions = ServiceOptions & ObjectOptions & WorkflowOptions;
@@ -63,12 +64,15 @@ interface RestateEndpointBase<E> {
 /**
  * RestateEndpoint encapsulates all the Restate services served by this endpoint.
  *
- * A RestateEndpoint can either be served as HTTP2 server, using the methods {@link RestateEndpoint.listen} or {@link RestateEndpoint.http2Handler}.
+ * A RestateEndpoint can be served as:
+ * - An HTTP/2 server using {@link RestateEndpoint.listen}, {@link RestateEndpoint.http2Handler}
+ * - An HTTP/1.1 server using {@link RestateEndpoint.http1Handler}
+ * - A combined HTTP/1.1 + HTTP/2 server using {@link RestateEndpoint.handler}
  *
  * For Lambda, check {@link LambdaEndpoint}
  *
  * @example
- * A typical endpoint served as HTTP server would look like this:
+ * A typical endpoint served as HTTP/2 server:
  * ```
  * import * as restate from "@restatedev/restate-sdk";
  *
@@ -77,6 +81,28 @@ interface RestateEndpointBase<E> {
  *   .bind(myService)
  *   .listen(8000);
  * ```
+ *
+ * @example
+ * Using the HTTP/1.1 handler with your own server:
+ * ```
+ * import * as http from "node:http";
+ * import * as restate from "@restatedev/restate-sdk";
+ *
+ * const endpoint = restate.endpoint().bind(myService);
+ * const server = http.createServer(endpoint.http1Handler());
+ * server.listen(8000);
+ * ```
+ *
+ * @example
+ * Using the combined handler with an HTTP/2 server that also accepts HTTP/1.1:
+ * ```
+ * import * as http2 from "node:http2";
+ * import * as restate from "@restatedev/restate-sdk";
+ *
+ * const endpoint = restate.endpoint().bind(myService);
+ * const server = http2.createSecureServer({ key, cert, allowHTTP1: true }, endpoint.handler());
+ * server.listen(8000);
+ * ```
  */
 interface RestateEndpoint extends RestateEndpointBase<RestateEndpoint> {
   /**
@@ -103,9 +129,65 @@ interface RestateEndpoint extends RestateEndpointBase<RestateEndpoint> {
    */
   listen(port?: number): Promise<number>;
   /**
-   * Returns an http2 server handler. See {@link RestateEndpoint.listen} for more details.
+   * Returns an http2 server handler.
+   *
+   * By default, this handler uses bidirectional streaming (`BIDI_STREAM`).
+   * Set `bidirectional: false` to use request-response mode (`REQUEST_RESPONSE`).
+   *
+   * See {@link RestateEndpoint.listen} for more details.
+   */
+  http2Handler(options?: {
+    bidirectional?: boolean;
+  }): (request: Http2ServerRequest, response: Http2ServerResponse) => void;
+  /**
+   * Returns an http1 server handler.
+   *
+   * By default, this handler operates in request-response protocol mode (`REQUEST_RESPONSE`),
+   * which buffers the full request before sending the response. This is the safest mode
+   * for HTTP/1.1 and works across all environments and proxies.
+   *
+   * Set `bidirectional: true` to enable bidirectional streaming (`BIDI_STREAM`) for
+   * HTTP/1.1 servers that support it. Note that some proxies and clients may not
+   * handle HTTP/1.1 bidirectional streaming correctly.
+   *
+   * @example
+   * ```
+   * const httpServer = http.createServer(endpoint.http1Handler());
+   * httpServer.listen(port);
+   * ```
+   */
+  http1Handler(options?: {
+    bidirectional?: boolean;
+  }): (request: IncomingMessage, response: ServerResponse) => void;
+  /**
+   * Returns a combined request handler that auto-detects HTTP/1 vs HTTP/2
+   * requests and dispatches to the appropriate internal handler.
+   *
+   * By default (when `bidirectional` is omitted), HTTP/2+ requests use
+   * bidirectional streaming (`BIDI_STREAM`) and HTTP/1 requests use
+   * request-response mode (`REQUEST_RESPONSE`).
+   *
+   * Set `bidirectional: true` to force `BIDI_STREAM` for all requests,
+   * or `bidirectional: false` to force `REQUEST_RESPONSE` for all requests.
+   *
+   * This is useful with `http2.createSecureServer({ allowHTTP1: true })`, where
+   * the same server handles both HTTP/1.1 and HTTP/2 connections.
+   *
+   * @example
+   * ```
+   * const server = http2.createSecureServer(
+   *   { key, cert, allowHTTP1: true },
+   *   endpoint.handler()
+   * );
+   * server.listen(port);
+   * ```
    */
-  http2Handler(): (request: Http2ServerRequest, response: Http2ServerResponse) => void;
+  handler(options?: {
+    bidirectional?: boolean;
+  }): {
+    (request: IncomingMessage, response: ServerResponse): void;
+    (request: Http2ServerRequest, response: Http2ServerResponse): void;
+  };
 }
 //#endregion
 export { DefaultServiceOptions, RestateEndpoint, RestateEndpointBase };

package/dist/endpoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"endpoint.d.ts","names":[],"sources":["../src/endpoint.ts"],"sourcesContent":[],"mappings":";;;;;;KAyBY,qBAAA,GAAwB,iBAClC,gBACA;UAEe;EAJL;;;;;EAIK,IAAA,CAAA,UAAA,MAAA,EAAmB,CAAA,CAAA,CAAA,OAAA,EAQ5B,iBAR4B,CAQV,CARU,EAQP,CARO,CAAA,GAS5B,uBAT4B,CASJ,CATI,EASD,CATC,CAAA,GAU5B,kBAV4B,CAUT,CAVS,EAUN,CAVM,CAAA,CAAA,EAW/B,CAX+B;EAQV;;;;;;;;;EAGrB,cAAA,CAAA,GAAA,IAAA,EAAA,MAAA,EAAA,CAAA,EAWgC,CAXhC;EAWgC;;;;;;;EAwCyC,qBAAA,CAAA,OAAA,EA/B7C,qBA+B6C,CAAA,EA/BrB,CA+BqB;EAAC;AAqB/E;;;;;;;;;;;;;;;;;;;;oBA7BoB,kBAAkB;;;;;;;iDAQW,QAAQ,qBAAqB;;;;;;;;;;;;;;;;;;;;UAqB7D,eAAA,SAAwB,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;yBAuBpC;;;;4BAMZ,8BACC"}
+{"version":3,"file":"endpoint.d.ts","names":[],"sources":["../src/endpoint.ts"],"sourcesContent":[],"mappings":";;;;;;;KA0BY,qBAAA,GAAwB,iBAClC,gBACA;UAEe;EAJL;;;;;EAIK,IAAA,CAAA,UAAA,MAAA,EAAmB,CAAA,CAAA,CAAA,OAAA,EAQ5B,iBAR4B,CAQV,CARU,EAQP,CARO,CAAA,GAS5B,uBAT4B,CASJ,CATI,EASD,CATC,CAAA,GAU5B,kBAV4B,CAUT,CAVS,EAUN,CAVM,CAAA,CAAA,EAW/B,CAX+B;EAQV;;;;;;;;;EAGrB,cAAA,CAAA,GAAA,IAAA,EAAA,MAAA,EAAA,CAAA,EAWgC,CAXhC;EAWgC;;;;;;;EAwCyC,qBAAA,CAAA,OAAA,EA/B7C,qBA+B6C,CAAA,EA/BrB,CA+BqB;EAAC;AA8C/E;;;;;;;;;;;;;;;;;;;;oBAtDoB,kBAAkB;;;;;;;iDAQW,QAAQ,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA8C7D,eAAA,SAAwB,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;yBAuBpC;;;;;;;;;;;gBAYT,8BAA8B;;;;;;;;;;;;;;;;;;;;gBAqB9B,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;cA0B7B,2BAA2B;cAC3B,8BAA8B"}

package/dist/error_sanitization.cjs

@@ -0,0 +1,26 @@
+const require_errors = require('./types/errors.cjs');
+const require_context_impl = require('./context_impl.cjs');
+
+//#region src/error_sanitization.ts
+/**
+* Strips SDK-internal metadata from an error before it enters the interceptor
+* chain. Interceptors see a plain Error — no CommandError.
+*/
+function sanitizeError(e) {
+	if (e instanceof require_context_impl.CommandError) return require_errors.ensureError(e.cause);
+	return require_errors.ensureError(e);
+}
+/**
+* Restores SDK-internal metadata after the interceptor chain exits, using the
+* original error's metadata and the interceptor's error as the new cause.
+* If the original had no SDK metadata, the interceptor's error passes through
+* unchanged.
+*/
+function restoreError(interceptorError, original) {
+	if (original instanceof require_context_impl.CommandError) return original.commandIndex !== void 0 ? new require_context_impl.CommandError(interceptorError, original.commandType, original.commandIndex) : new require_context_impl.CommandError(interceptorError, original.commandType);
+	return interceptorError;
+}
+
+//#endregion
+exports.restoreError = restoreError;
+exports.sanitizeError = sanitizeError;

package/dist/error_sanitization.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Strips SDK-internal metadata from an error before it enters the interceptor
+ * chain. Interceptors see a plain Error — no CommandError.
+ */
+export declare function sanitizeError(e: unknown): Error;
+/**
+ * Restores SDK-internal metadata after the interceptor chain exits, using the
+ * original error's metadata and the interceptor's error as the new cause.
+ * If the original had no SDK metadata, the interceptor's error passes through
+ * unchanged.
+ */
+export declare function restoreError(interceptorError: unknown, original: unknown): unknown;
+//# sourceMappingURL=error_sanitization.d.ts.map

package/dist/error_sanitization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error_sanitization.d.ts","sourceRoot":"","sources":["../src/error_sanitization.ts"],"names":[],"mappings":"AAcA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,KAAK,CAG/C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,gBAAgB,EAAE,OAAO,EACzB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAWT"}

package/dist/error_sanitization.js

@@ -0,0 +1,26 @@
+import { ensureError } from "./types/errors.js";
+import { CommandError } from "./context_impl.js";
+
+//#region src/error_sanitization.ts
+/**
+* Strips SDK-internal metadata from an error before it enters the interceptor
+* chain. Interceptors see a plain Error — no CommandError.
+*/
+function sanitizeError(e) {
+	if (e instanceof CommandError) return ensureError(e.cause);
+	return ensureError(e);
+}
+/**
+* Restores SDK-internal metadata after the interceptor chain exits, using the
+* original error's metadata and the interceptor's error as the new cause.
+* If the original had no SDK metadata, the interceptor's error passes through
+* unchanged.
+*/
+function restoreError(interceptorError, original) {
+	if (original instanceof CommandError) return original.commandIndex !== void 0 ? new CommandError(interceptorError, original.commandType, original.commandIndex) : new CommandError(interceptorError, original.commandType);
+	return interceptorError;
+}
+
+//#endregion
+export { restoreError, sanitizeError };
+//# sourceMappingURL=error_sanitization.js.map

package/dist/error_sanitization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error_sanitization.js","names":[],"sources":["../src/error_sanitization.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 { CommandError } from \"./context_impl.js\";\nimport { ensureError } from \"./types/errors.js\";\n\n/**\n * Strips SDK-internal metadata from an error before it enters the interceptor\n * chain. Interceptors see a plain Error — no CommandError.\n */\nexport function sanitizeError(e: unknown): Error {\n  if (e instanceof CommandError) return ensureError(e.cause);\n  return ensureError(e);\n}\n\n/**\n * Restores SDK-internal metadata after the interceptor chain exits, using the\n * original error's metadata and the interceptor's error as the new cause.\n * If the original had no SDK metadata, the interceptor's error passes through\n * unchanged.\n */\nexport function restoreError(\n  interceptorError: unknown,\n  original: unknown\n): unknown {\n  if (original instanceof CommandError) {\n    return original.commandIndex !== undefined\n      ? new CommandError(\n          interceptorError,\n          original.commandType,\n          original.commandIndex\n        )\n      : new CommandError(interceptorError, original.commandType);\n  }\n  return interceptorError;\n}\n"],"mappings":";;;;;;;;AAkBA,SAAgB,cAAc,GAAmB;AAC/C,KAAI,aAAa,aAAc,QAAO,YAAY,EAAE,MAAM;AAC1D,QAAO,YAAY,EAAE;;;;;;;;AASvB,SAAgB,aACd,kBACA,UACS;AACT,KAAI,oBAAoB,aACtB,QAAO,SAAS,iBAAiB,SAC7B,IAAI,aACF,kBACA,SAAS,aACT,SAAS,aACV,GACD,IAAI,aAAa,kBAAkB,SAAS,YAAY;AAE9D,QAAO"}

package/dist/fetch.cjs

@@ -1,7 +1,8 @@
 const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
 const require_errors = require('./types/errors.cjs');
-const require_rpc = require('./types/rpc.cjs');
+const require_promises = require('./promises.cjs');
 const require_context = require('./context.cjs');
+const require_rpc = require('./types/rpc.cjs');
 const require_internal = require('./internal.cjs');
 const require_common_api = require('./common_api.cjs');
 const require_fetch_endpoint = require('./endpoint/fetch_endpoint.cjs');
@@ -73,6 +74,7 @@ Object.defineProperty(exports, 'internal', {
     return require_internal.internal_exports;
   }
 });
+exports.isRestatePromise = require_promises.isRestatePromise;
 exports.object = require_rpc.object;
 Object.defineProperty(exports, 'rpc', {
   enumerable: true,