@orpc/standard-server-node 0.0.0-next.6e49c5c → 0.0.0-next.6e7c532

package/README.md

@@ -21,28 +21,24 @@
 
 <h3 align="center">Typesafe APIs Made Simple 🪄</h3>
 
-**oRPC is a powerful combination of RPC and OpenAPI**, makes it easy to build APIs that are end-to-end type-safe and adhere to OpenAPI standards, ensuring a smooth and enjoyable developer experience.
+**oRPC is a powerful combination of RPC and OpenAPI**, makes it easy to build APIs that are end-to-end type-safe and adhere to OpenAPI standards
 
 ---
 
 ## Highlights
 
-- **End-to-End Type Safety 🔒**: Ensure complete type safety from inputs to outputs and errors, bridging server and client seamlessly.
-- **First-Class OpenAPI 📄**: Adheres to the OpenAPI standard out of the box, ensuring seamless integration and comprehensive API documentation.
-- **Contract-First Development 📜**: (Optional) Define your API contract upfront and implement it with confidence.
-- **Exceptional Developer Experience ✨**: Enjoy a streamlined workflow with robust typing and clear, in-code documentation.
-- **Multi-Runtime Support 🌍**: Run your code seamlessly on Cloudflare, Deno, Bun, Node.js, and more.
-- **Framework Integrations 🧩**: Supports Tanstack Query (React, Vue, Solid, Svelte), Pinia Colada, and more.
-- **Server Actions ⚡️**: Fully compatible with React Server Actions on Next.js, TanStack Start, and more.
-- **Standard Schema Support 🗂️**: Effortlessly work with Zod, Valibot, ArkType, and others right out of the box.
-- **Fast & Lightweight 💨**: Built on native APIs across all runtimes – optimized for speed and efficiency.
-- **Native Types 📦**: Enjoy built-in support for Date, File, Blob, BigInt, URL and more with no extra setup.
-- **Lazy Router ⏱️**: Improve cold start times with our lazy routing feature.
-- **SSE & Streaming 📡**: Provides SSE and streaming features – perfect for real-time notifications and AI-powered streaming responses.
-- **Reusability 🔄**: Write once and reuse your code across multiple purposes effortlessly.
-- **Extendability 🔌**: Easily enhance oRPC with plugins, middleware, and interceptors.
-- **Reliability 🛡️**: Well-tested, fully TypeScript, production-ready, and MIT licensed for peace of mind.
-- **Simplicity 💡**: Enjoy straightforward, clean code with no hidden magic.
+- **🔗 End-to-End Type Safety**: Ensure type-safe inputs, outputs, and errors from client to server.
+- **📘 First-Class OpenAPI**: Built-in support that fully adheres to the OpenAPI standard.
+- **📝 Contract-First Development**: Optionally define your API contract before implementation.
+- **⚙️ Framework Integrations**: Seamlessly integrate with TanStack Query (React, Vue, Solid, Svelte), Pinia Colada, and more.
+- **🚀 Server Actions**: Fully compatible with React Server Actions on Next.js, TanStack Start, and other platforms.
+- **🔠 Standard Schema Support**: Works out of the box with Zod, Valibot, ArkType, and other schema validators.
+- **🗃️ Native Types**: Supports native types like Date, File, Blob, BigInt, URL, and more.
+- **⏱️ Lazy Router**: Enhance cold start times with our lazy routing feature.
+- **📡 SSE & Streaming**: Enjoy full type-safe support for SSE and streaming.
+- **🌍 Multi-Runtime Support**: Fast and lightweight on Cloudflare, Deno, Bun, Node.js, and beyond.
+- **🔌 Extendability**: Easily extend functionality with plugins, middleware, and interceptors.
+- **🛡️ Reliability**: Well-tested, TypeScript-based, production-ready, and MIT licensed.
 
 ## Documentation
 
@@ -53,6 +49,7 @@ You can find the full documentation [here](https://orpc.unnoq.com).
 - [@orpc/contract](https://www.npmjs.com/package/@orpc/contract): Build your API contract.
 - [@orpc/server](https://www.npmjs.com/package/@orpc/server): Build your API or implement API contract.
 - [@orpc/client](https://www.npmjs.com/package/@orpc/client): Consume your API on the client with type-safety.
+- [@orpc/nest](https://www.npmjs.com/package/@orpc/nest): Deeply integrate oRPC with NestJS.
 - [@orpc/react](https://www.npmjs.com/package/@orpc/react): Utilities for integrating oRPC with React and React Server Actions.
 - [@orpc/react-query](https://www.npmjs.com/package/@orpc/react-query): Integration with [React Query](https://tanstack.com/query/latest/docs/framework/react/overview).
 - [@orpc/vue-query](https://www.npmjs.com/package/@orpc/vue-query): Integration with [Vue Query](https://tanstack.com/query/latest/docs/framework/vue/overview).

package/dist/index.d.mts

@@ -1,9 +1,9 @@
-import { Readable } from 'node:stream';
+import { StandardBody, StandardHeaders, StandardLazyRequest, StandardResponse } from '@orpc/standard-server';
+import Stream, { Readable } from 'node:stream';
 import { IncomingMessage, ServerResponse } from 'node:http';
 import { Http2ServerRequest, Http2ServerResponse } from 'node:http2';
-import { StandardBody, StandardHeaders, StandardLazyRequest, StandardResponse } from '@orpc/standard-server';
 
-declare function toEventIterator(stream: Readable): AsyncGenerator<unknown | void, unknown | void, void>;
+declare function toEventIterator(stream: Readable): AsyncIteratorObject<unknown | void, unknown | void, void> & AsyncGenerator<unknown | void, unknown | void, void>;
 interface ToEventStreamOptions {
     /**
      * If true, a ping comment is sent periodically to keep the connection alive.
@@ -45,12 +45,17 @@ interface ToNodeHttpBodyOptions extends ToEventStreamOptions {
  */
 declare function toNodeHttpBody(body: StandardBody, headers: StandardHeaders, options?: ToNodeHttpBodyOptions): Readable | undefined | string;
 
+declare function toStandardMethod(method: string | undefined): string;
+
 declare function toStandardLazyRequest(req: NodeHttpRequest, res: NodeHttpResponse): StandardLazyRequest;
 
 interface SendStandardResponseOptions extends ToNodeHttpBodyOptions {
 }
 declare function sendStandardResponse(res: NodeHttpResponse, standardResponse: StandardResponse, options?: SendStandardResponseOptions): Promise<void>;
 
-declare function toAbortSignal(res: NodeHttpResponse): AbortSignal;
+declare function toAbortSignal(stream: Stream.Writable): AbortSignal;
+
+declare function toStandardUrl(req: NodeHttpRequest): URL;
 
-export { type NodeHttpRequest, type NodeHttpResponse, type SendStandardResponseOptions, type ToEventStreamOptions, type ToNodeHttpBodyOptions, sendStandardResponse, toAbortSignal, toEventIterator, toEventStream, toNodeHttpBody, toStandardBody, toStandardLazyRequest };
+export { sendStandardResponse, toAbortSignal, toEventIterator, toEventStream, toNodeHttpBody, toStandardBody, toStandardLazyRequest, toStandardMethod, toStandardUrl };
+export type { NodeHttpRequest, NodeHttpResponse, SendStandardResponseOptions, ToEventStreamOptions, ToNodeHttpBodyOptions };

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { Readable } from 'node:stream';
+import { StandardBody, StandardHeaders, StandardLazyRequest, StandardResponse } from '@orpc/standard-server';
+import Stream, { Readable } from 'node:stream';
 import { IncomingMessage, ServerResponse } from 'node:http';
 import { Http2ServerRequest, Http2ServerResponse } from 'node:http2';
-import { StandardBody, StandardHeaders, StandardLazyRequest, StandardResponse } from '@orpc/standard-server';
 
-declare function toEventIterator(stream: Readable): AsyncGenerator<unknown | void, unknown | void, void>;
+declare function toEventIterator(stream: Readable): AsyncIteratorObject<unknown | void, unknown | void, void> & AsyncGenerator<unknown | void, unknown | void, void>;
 interface ToEventStreamOptions {
     /**
      * If true, a ping comment is sent periodically to keep the connection alive.
@@ -45,12 +45,17 @@ interface ToNodeHttpBodyOptions extends ToEventStreamOptions {
  */
 declare function toNodeHttpBody(body: StandardBody, headers: StandardHeaders, options?: ToNodeHttpBodyOptions): Readable | undefined | string;
 
+declare function toStandardMethod(method: string | undefined): string;
+
 declare function toStandardLazyRequest(req: NodeHttpRequest, res: NodeHttpResponse): StandardLazyRequest;
 
 interface SendStandardResponseOptions extends ToNodeHttpBodyOptions {
 }
 declare function sendStandardResponse(res: NodeHttpResponse, standardResponse: StandardResponse, options?: SendStandardResponseOptions): Promise<void>;
 
-declare function toAbortSignal(res: NodeHttpResponse): AbortSignal;
+declare function toAbortSignal(stream: Stream.Writable): AbortSignal;
+
+declare function toStandardUrl(req: NodeHttpRequest): URL;
 
-export { type NodeHttpRequest, type NodeHttpResponse, type SendStandardResponseOptions, type ToEventStreamOptions, type ToNodeHttpBodyOptions, sendStandardResponse, toAbortSignal, toEventIterator, toEventStream, toNodeHttpBody, toStandardBody, toStandardLazyRequest };
+export { sendStandardResponse, toAbortSignal, toEventIterator, toEventStream, toNodeHttpBody, toStandardBody, toStandardLazyRequest, toStandardMethod, toStandardUrl };
+export type { NodeHttpRequest, NodeHttpResponse, SendStandardResponseOptions, ToEventStreamOptions, ToNodeHttpBodyOptions };

package/dist/index.mjs

@@ -1,52 +1,49 @@
 import { Readable } from 'node:stream';
-import { stringifyJSON, parseEmptyableJSON, isTypescriptObject, toArray, isAsyncIteratorObject, once } from '@orpc/shared';
-import { EventDecoderStream, encodeEventMessage, getEventMeta, ErrorEvent, withEventMeta, getFilenameFromContentDisposition, generateContentDisposition } from '@orpc/standard-server';
+import { createAsyncIteratorObject, parseEmptyableJSON, isTypescriptObject, stringifyJSON, isAsyncIteratorObject, once } from '@orpc/shared';
+import { EventDecoderStream, withEventMeta, ErrorEvent, encodeEventMessage, getEventMeta, getFilenameFromContentDisposition, flattenHeader, generateContentDisposition } from '@orpc/standard-server';
 
 function toEventIterator(stream) {
   const eventStream = Readable.toWeb(stream).pipeThrough(new TextDecoderStream()).pipeThrough(new EventDecoderStream());
   const reader = eventStream.getReader();
-  async function* gen() {
-    try {
-      while (true) {
-        const { done, value } = await reader.read();
-        if (done) {
-          return;
-        }
-        switch (value.event) {
-          case "message": {
-            let message = parseEmptyableJSON(value.data);
-            if (isTypescriptObject(message)) {
-              message = withEventMeta(message, value);
-            }
-            yield message;
-            break;
-          }
-          case "error": {
-            let error = new ErrorEvent({
-              data: parseEmptyableJSON(value.data)
-            });
-            error = withEventMeta(error, value);
-            throw error;
+  return createAsyncIteratorObject(async () => {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) {
+        return { done: true, value: void 0 };
+      }
+      switch (value.event) {
+        case "message": {
+          let message = parseEmptyableJSON(value.data);
+          if (isTypescriptObject(message)) {
+            message = withEventMeta(message, value);
           }
-          case "done": {
-            let done2 = parseEmptyableJSON(value.data);
-            if (isTypescriptObject(done2)) {
-              done2 = withEventMeta(done2, value);
-            }
-            return done2;
+          return { done: false, value: message };
+        }
+        case "error": {
+          let error = new ErrorEvent({
+            data: parseEmptyableJSON(value.data)
+          });
+          error = withEventMeta(error, value);
+          throw error;
+        }
+        case "done": {
+          let done2 = parseEmptyableJSON(value.data);
+          if (isTypescriptObject(done2)) {
+            done2 = withEventMeta(done2, value);
           }
+          return { done: true, value: done2 };
         }
       }
-    } finally {
-      await reader.cancel();
     }
-  }
-  return gen();
+  }, async () => {
+    await reader.cancel();
+  });
 }
 function toEventStream(iterator, options = {}) {
   const keepAliveEnabled = options.eventIteratorKeepAliveEnabled ?? true;
   const keepAliveInterval = options.eventIteratorKeepAliveInterval ?? 5e3;
   const keepAliveComment = options.eventIteratorKeepAliveComment ?? "";
+  let cancelled = false;
   let timeout;
   const stream = new ReadableStream({
     async pull(controller) {
@@ -60,6 +57,9 @@ function toEventStream(iterator, options = {}) {
         }
         const value = await iterator.next();
         clearInterval(timeout);
+        if (cancelled) {
+          return;
+        }
         const meta = getEventMeta(value.value);
         if (!value.done || value.value !== void 0 || meta !== void 0) {
           controller.enqueue(encodeEventMessage({
@@ -73,6 +73,9 @@ function toEventStream(iterator, options = {}) {
         }
       } catch (err) {
         clearInterval(timeout);
+        if (cancelled) {
+          return;
+        }
         controller.enqueue(encodeEventMessage({
           ...getEventMeta(err),
           event: "error",
@@ -81,22 +84,16 @@ function toEventStream(iterator, options = {}) {
         controller.close();
       }
     },
-    async cancel(reason) {
-      if (reason) {
-        await iterator.throw?.(reason);
-      } else {
-        await iterator.return?.();
-      }
+    async cancel() {
+      cancelled = true;
+      clearInterval(timeout);
+      await iterator.return?.();
     }
   });
   return Readable.fromWeb(stream);
 }
 
 async function toStandardBody(req) {
-  const method = req.method ?? "GET";
-  if (method === "GET" || method === "HEAD") {
-    return void 0;
-  }
   const contentDisposition = req.headers["content-disposition"];
   const contentType = req.headers["content-type"];
   if (typeof contentDisposition === "string") {
@@ -123,7 +120,7 @@ async function toStandardBody(req) {
   return _streamToFile(req, "blob", contentType);
 }
 function toNodeHttpBody(body, headers, options = {}) {
-  const currentContentDisposition = toArray(headers["content-disposition"])[0];
+  const currentContentDisposition = flattenHeader(headers["content-disposition"]);
   delete headers["content-type"];
   delete headers["content-disposition"];
   if (body === void 0) {
@@ -176,28 +173,32 @@ async function _streamToFile(stream, fileName, contentType) {
   return new File(chunks, fileName, { type: contentType });
 }
 
-function toAbortSignal(res) {
+function toStandardMethod(method) {
+  return method ?? "GET";
+}
+
+function toAbortSignal(stream) {
   const controller = new AbortController();
-  res.on("close", () => {
-    if (res.errored) {
-      controller.abort(res.errored.toString());
-    } else if (!res.writableFinished) {
-      controller.abort("Client connection prematurely closed.");
-    } else {
-      controller.abort("Server closed the connection.");
+  stream.once("error", (error) => controller.abort(error));
+  stream.once("close", () => {
+    if (!stream.writableFinished) {
+      controller.abort(new Error("Writable stream closed before it finished writing"));
     }
   });
   return controller.signal;
 }
 
-function toStandardLazyRequest(req, res) {
-  const method = req.method ?? "GET";
+function toStandardUrl(req) {
   const protocol = "encrypted" in req.socket && req.socket.encrypted ? "https:" : "http:";
   const host = req.headers.host ?? "localhost";
   const url = new URL(req.originalUrl ?? req.url ?? "/", `${protocol}//${host}`);
+  return url;
+}
+
+function toStandardLazyRequest(req, res) {
   return {
-    method,
-    url,
+    method: toStandardMethod(req.method),
+    url: toStandardUrl(req),
     headers: req.headers,
     body: once(() => toStandardBody(req)),
     signal: toAbortSignal(res)
@@ -206,24 +207,25 @@ function toStandardLazyRequest(req, res) {
 
 function sendStandardResponse(res, standardResponse, options = {}) {
   return new Promise((resolve, reject) => {
-    res.on("error", reject);
-    res.on("finish", resolve);
-    const resHeaders = standardResponse.headers;
+    res.once("error", reject);
+    res.once("close", resolve);
+    const resHeaders = { ...standardResponse.headers };
     const resBody = toNodeHttpBody(standardResponse.body, resHeaders, options);
     res.writeHead(standardResponse.status, resHeaders);
     if (resBody === void 0) {
-      res.end(resBody);
+      res.end();
     } else if (typeof resBody === "string") {
       res.end(resBody);
     } else {
-      res.on("close", () => {
+      res.once("close", () => {
         if (!resBody.closed) {
           resBody.destroy(res.errored ?? void 0);
         }
       });
+      resBody.once("error", (error) => res.destroy(error));
       resBody.pipe(res);
     }
   });
 }
 
-export { sendStandardResponse, toAbortSignal, toEventIterator, toEventStream, toNodeHttpBody, toStandardBody, toStandardLazyRequest };
+export { sendStandardResponse, toAbortSignal, toEventIterator, toEventStream, toNodeHttpBody, toStandardBody, toStandardLazyRequest, toStandardMethod, toStandardUrl };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@orpc/standard-server-node",
   "type": "module",
-  "version": "0.0.0-next.6e49c5c",
+  "version": "0.0.0-next.6e7c532",
   "license": "MIT",
   "homepage": "https://orpc.unnoq.com",
   "repository": {
@@ -23,13 +23,13 @@
     "dist"
   ],
   "dependencies": {
-    "@orpc/shared": "0.0.0-next.6e49c5c",
-    "@orpc/standard-server": "0.0.0-next.6e49c5c"
+    "@orpc/shared": "0.0.0-next.6e7c532",
+    "@orpc/standard-server": "0.0.0-next.6e7c532"
   },
   "devDependencies": {
-    "@types/node": "^22.13.1",
-    "@types/supertest": "^6.0.2",
-    "supertest": "^7.0.0"
+    "@types/node": "^22.15.17",
+    "@types/supertest": "^6.0.3",
+    "supertest": "^7.1.0"
   },
   "scripts": {
     "build": "unbuild",