@orpc/standard-server-node 0.0.0-next.d5f6b77 → 0.0.0-next.d63ea0a

package/README.md

@@ -17,6 +17,9 @@
   <a href="https://discord.gg/TXEbwRBvQn">
     <img alt="Discord" src="https://img.shields.io/discord/1308966753044398161?color=7389D8&label&logo=discord&logoColor=ffffff" />
   </a>
+  <a href="https://deepwiki.com/unnoq/orpc">
+    <img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki">
+  </a>
 </div>
 
 <h3 align="center">Typesafe APIs Made Simple 🪄</h3>
@@ -30,7 +33,8 @@
 - **🔗 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.
+- **🔍 First-Class OpenTelemetry**: Seamlessly integrate with OpenTelemetry for observability.
+- **⚙️ Framework Integrations**: Seamlessly integrate with TanStack Query (React, Vue, Solid, Svelte, Angular), SWR, 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.
@@ -38,7 +42,6 @@
 - **📡 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
 
@@ -49,13 +52,14 @@ 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/openapi](https://www.npmjs.com/package/@orpc/openapi): Generate OpenAPI specs and handle OpenAPI requests.
+- [@orpc/otel](https://www.npmjs.com/package/@orpc/otel): [OpenTelemetry](https://opentelemetry.io/) integration for observability.
+- [@orpc/nest](https://www.npmjs.com/package/@orpc/nest): Deeply integrate oRPC with [NestJS](https://nestjs.com/).
 - [@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).
-- [@orpc/solid-query](https://www.npmjs.com/package/@orpc/solid-query): Integration with [Solid Query](https://tanstack.com/query/latest/docs/framework/solid/overview).
-- [@orpc/svelte-query](https://www.npmjs.com/package/@orpc/svelte-query): Integration with [Svelte Query](https://tanstack.com/query/latest/docs/framework/svelte/overview).
+- [@orpc/tanstack-query](https://www.npmjs.com/package/@orpc/tanstack-query): [TanStack Query](https://tanstack.com/query/latest) integration.
+- [@orpc/experimental-react-swr](https://www.npmjs.com/package/@orpc/experimental-react-swr): [SWR](https://swr.vercel.app/) integration.
 - [@orpc/vue-colada](https://www.npmjs.com/package/@orpc/vue-colada): Integration with [Pinia Colada](https://pinia-colada.esm.dev/).
-- [@orpc/openapi](https://www.npmjs.com/package/@orpc/openapi): Generate OpenAPI specs and handle OpenAPI requests.
+- [@orpc/hey-api](https://www.npmjs.com/package/@orpc/hey-api): [Hey API](https://heyapi.dev/) integration.
 - [@orpc/zod](https://www.npmjs.com/package/@orpc/zod): More schemas that [Zod](https://zod.dev/) doesn't support yet.
 - [@orpc/valibot](https://www.npmjs.com/package/@orpc/valibot): OpenAPI spec generation from [Valibot](https://valibot.dev/).
 - [@orpc/arktype](https://www.npmjs.com/package/@orpc/arktype): OpenAPI spec generation from [ArkType](https://arktype.io/).

package/dist/index.d.mts

@@ -1,28 +1,13 @@
 import { StandardBody, StandardHeaders, StandardLazyRequest, StandardResponse } from '@orpc/standard-server';
-import { Readable } from 'node:stream';
+import { ToEventIteratorOptions as ToEventIteratorOptions$1, ToEventStreamOptions as ToEventStreamOptions$1 } from '@orpc/standard-server-fetch';
+import Stream, { Readable } from 'node:stream';
 import { IncomingMessage, ServerResponse } from 'node:http';
 import { Http2ServerRequest, Http2ServerResponse } from 'node:http2';
 
-declare function toEventIterator(stream: Readable): AsyncGenerator<unknown | void, unknown | void, void>;
-interface ToEventStreamOptions {
-    /**
-     * If true, a ping comment is sent periodically to keep the connection alive.
-     *
-     * @default true
-     */
-    eventIteratorKeepAliveEnabled?: boolean;
-    /**
-     * Interval (in milliseconds) between ping comments sent after the last event.
-     *
-     * @default 5000
-     */
-    eventIteratorKeepAliveInterval?: number;
-    /**
-     * The content of the ping comment. Must not include newline characters.
-     *
-     * @default ''
-     */
-    eventIteratorKeepAliveComment?: string;
+interface ToEventIteratorOptions extends ToEventIteratorOptions$1 {
+}
+declare function toEventIterator(stream: Readable, options?: ToEventIteratorOptions): AsyncIteratorObject<unknown | void, unknown | void, void> & AsyncGenerator<unknown | void, unknown | void, void>;
+interface ToEventStreamOptions extends ToEventStreamOptions$1 {
 }
 declare function toEventStream(iterator: AsyncIterator<unknown | void, unknown | void, void>, options?: ToEventStreamOptions): Readable;
 
@@ -32,10 +17,16 @@ type NodeHttpRequest = (IncomingMessage | Http2ServerRequest) & {
      * This is useful for `express.js` middleware.
      */
     originalUrl?: string;
+    /**
+     * Prefer parsed body if it is available.
+     */
+    body?: unknown;
 };
 type NodeHttpResponse = ServerResponse | Http2ServerResponse;
 
-declare function toStandardBody(req: NodeHttpRequest): Promise<StandardBody>;
+interface ToStandardBodyOptions extends ToEventIteratorOptions {
+}
+declare function toStandardBody(req: NodeHttpRequest, options?: ToStandardBodyOptions): Promise<StandardBody>;
 interface ToNodeHttpBodyOptions extends ToEventStreamOptions {
 }
 /**
@@ -45,13 +36,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 { sendStandardResponse, toAbortSignal, toEventIterator, toEventStream, toNodeHttpBody, toStandardBody, toStandardLazyRequest };
-export type { NodeHttpRequest, NodeHttpResponse, SendStandardResponseOptions, ToEventStreamOptions, ToNodeHttpBodyOptions };
+export { sendStandardResponse, toAbortSignal, toEventIterator, toEventStream, toNodeHttpBody, toStandardBody, toStandardLazyRequest, toStandardMethod, toStandardUrl };
+export type { NodeHttpRequest, NodeHttpResponse, SendStandardResponseOptions, ToEventIteratorOptions, ToEventStreamOptions, ToNodeHttpBodyOptions, ToStandardBodyOptions };

package/dist/index.d.ts

@@ -1,28 +1,13 @@
 import { StandardBody, StandardHeaders, StandardLazyRequest, StandardResponse } from '@orpc/standard-server';
-import { Readable } from 'node:stream';
+import { ToEventIteratorOptions as ToEventIteratorOptions$1, ToEventStreamOptions as ToEventStreamOptions$1 } from '@orpc/standard-server-fetch';
+import Stream, { Readable } from 'node:stream';
 import { IncomingMessage, ServerResponse } from 'node:http';
 import { Http2ServerRequest, Http2ServerResponse } from 'node:http2';
 
-declare function toEventIterator(stream: Readable): AsyncGenerator<unknown | void, unknown | void, void>;
-interface ToEventStreamOptions {
-    /**
-     * If true, a ping comment is sent periodically to keep the connection alive.
-     *
-     * @default true
-     */
-    eventIteratorKeepAliveEnabled?: boolean;
-    /**
-     * Interval (in milliseconds) between ping comments sent after the last event.
-     *
-     * @default 5000
-     */
-    eventIteratorKeepAliveInterval?: number;
-    /**
-     * The content of the ping comment. Must not include newline characters.
-     *
-     * @default ''
-     */
-    eventIteratorKeepAliveComment?: string;
+interface ToEventIteratorOptions extends ToEventIteratorOptions$1 {
+}
+declare function toEventIterator(stream: Readable, options?: ToEventIteratorOptions): AsyncIteratorObject<unknown | void, unknown | void, void> & AsyncGenerator<unknown | void, unknown | void, void>;
+interface ToEventStreamOptions extends ToEventStreamOptions$1 {
 }
 declare function toEventStream(iterator: AsyncIterator<unknown | void, unknown | void, void>, options?: ToEventStreamOptions): Readable;
 
@@ -32,10 +17,16 @@ type NodeHttpRequest = (IncomingMessage | Http2ServerRequest) & {
      * This is useful for `express.js` middleware.
      */
     originalUrl?: string;
+    /**
+     * Prefer parsed body if it is available.
+     */
+    body?: unknown;
 };
 type NodeHttpResponse = ServerResponse | Http2ServerResponse;
 
-declare function toStandardBody(req: NodeHttpRequest): Promise<StandardBody>;
+interface ToStandardBodyOptions extends ToEventIteratorOptions {
+}
+declare function toStandardBody(req: NodeHttpRequest, options?: ToStandardBodyOptions): Promise<StandardBody>;
 interface ToNodeHttpBodyOptions extends ToEventStreamOptions {
 }
 /**
@@ -45,13 +36,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 { sendStandardResponse, toAbortSignal, toEventIterator, toEventStream, toNodeHttpBody, toStandardBody, toStandardLazyRequest };
-export type { NodeHttpRequest, NodeHttpResponse, SendStandardResponseOptions, ToEventStreamOptions, ToNodeHttpBodyOptions };
+export { sendStandardResponse, toAbortSignal, toEventIterator, toEventStream, toNodeHttpBody, toStandardBody, toStandardLazyRequest, toStandardMethod, toStandardUrl };
+export type { NodeHttpRequest, NodeHttpResponse, SendStandardResponseOptions, ToEventIteratorOptions, ToEventStreamOptions, ToNodeHttpBodyOptions, ToStandardBodyOptions };

package/dist/index.mjs

@@ -1,138 +1,48 @@
 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 { runWithSpan, parseEmptyableJSON, isAsyncIteratorObject, stringifyJSON, AbortError, guard, once } from '@orpc/shared';
+import { getFilenameFromContentDisposition, flattenHeader, generateContentDisposition } from '@orpc/standard-server';
+import { toEventIterator as toEventIterator$1, toEventStream as toEventStream$1 } from '@orpc/standard-server-fetch';
 
-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;
-          }
-          case "done": {
-            let done2 = parseEmptyableJSON(value.data);
-            if (isTypescriptObject(done2)) {
-              done2 = withEventMeta(done2, value);
-            }
-            return done2;
-          }
-        }
-      }
-    } finally {
-      await reader.cancel();
-    }
-  }
-  return gen();
+function toEventIterator(stream, options = {}) {
+  return toEventIterator$1(Readable.toWeb(stream), options);
 }
 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) {
-      try {
-        if (keepAliveEnabled) {
-          timeout = setInterval(() => {
-            controller.enqueue(encodeEventMessage({
-              comments: [keepAliveComment]
-            }));
-          }, keepAliveInterval);
-        }
-        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({
-            ...meta,
-            event: value.done ? "done" : "message",
-            data: stringifyJSON(value.value)
-          }));
-        }
-        if (value.done) {
-          controller.close();
-        }
-      } catch (err) {
-        clearInterval(timeout);
-        if (cancelled) {
-          return;
-        }
-        controller.enqueue(encodeEventMessage({
-          ...getEventMeta(err),
-          event: "error",
-          data: err instanceof ErrorEvent ? stringifyJSON(err.data) : void 0
-        }));
-        controller.close();
-      }
-    },
-    async cancel(reason) {
-      cancelled = true;
-      clearInterval(timeout);
-      if (reason) {
-        await iterator.throw?.(reason);
-      } else {
-        await iterator.return?.();
-      }
-    }
-  });
-  return Readable.fromWeb(stream);
+  return Readable.fromWeb(toEventStream$1(iterator, options));
 }
 
-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") {
-    const fileName = getFilenameFromContentDisposition(contentDisposition) ?? "blob";
-    return _streamToFile(req, fileName, contentType ?? "");
-  }
-  if (!contentType || contentType.startsWith("application/json")) {
-    const text = await _streamToString(req);
-    return parseEmptyableJSON(text);
-  }
-  if (contentType.startsWith("multipart/form-data")) {
-    return _streamToFormData(req, contentType);
-  }
-  if (contentType.startsWith("application/x-www-form-urlencoded")) {
-    const text = await _streamToString(req);
-    return new URLSearchParams(text);
-  }
-  if (contentType.startsWith("text/event-stream")) {
-    return toEventIterator(req);
+function toStandardBody(req, options = {}) {
+  if (req.body !== void 0) {
+    return Promise.resolve(req.body);
   }
-  if (contentType.startsWith("text/plain")) {
-    return _streamToString(req);
-  }
-  return _streamToFile(req, "blob", contentType);
+  return runWithSpan({ name: "parse_standard_body", signal: options.signal }, async () => {
+    const contentDisposition = req.headers["content-disposition"];
+    const contentType = req.headers["content-type"];
+    if (typeof contentDisposition === "string") {
+      const fileName = getFilenameFromContentDisposition(contentDisposition) ?? "blob";
+      return _streamToFile(req, fileName, contentType ?? "");
+    }
+    if (!contentType || contentType.startsWith("application/json")) {
+      const text = await _streamToString(req);
+      return parseEmptyableJSON(text);
+    }
+    if (contentType.startsWith("multipart/form-data")) {
+      return _streamToFormData(req, contentType);
+    }
+    if (contentType.startsWith("application/x-www-form-urlencoded")) {
+      const text = await _streamToString(req);
+      return new URLSearchParams(text);
+    }
+    if (contentType.startsWith("text/event-stream")) {
+      return toEventIterator(req, options);
+    }
+    if (contentType.startsWith("text/plain")) {
+      return _streamToString(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) {
@@ -155,8 +65,6 @@ function toNodeHttpBody(body, headers, options = {}) {
   }
   if (isAsyncIteratorObject(body)) {
     headers["content-type"] = "text/event-stream";
-    headers["cache-control"] = "no-cache";
-    headers.connection = "keep-alive";
     return toEventStream(body, options);
   }
   headers["content-type"] = "application/json";
@@ -185,54 +93,60 @@ 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 AbortError("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}`);
+  const origin = guard(() => new URL(`${protocol}//${req.headers.host ?? "localhost"}`).origin) ?? `${protocol}//localhost`;
+  const path = req.originalUrl ?? req.url ?? "/";
+  return new URL(`${origin}${path.startsWith("/") ? "" : "/"}${path}`);
+}
+
+function toStandardLazyRequest(req, res) {
+  const signal = toAbortSignal(res);
   return {
-    method,
-    url,
+    method: toStandardMethod(req.method),
+    url: toStandardUrl(req),
     headers: req.headers,
-    body: once(() => toStandardBody(req)),
-    signal: toAbortSignal(res)
+    body: once(() => toStandardBody(req, { signal })),
+    signal
   };
 }
 
 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.d5f6b77",
+  "version": "0.0.0-next.d63ea0a",
   "license": "MIT",
   "homepage": "https://orpc.unnoq.com",
   "repository": {
@@ -23,13 +23,14 @@
     "dist"
   ],
   "dependencies": {
-    "@orpc/shared": "0.0.0-next.d5f6b77",
-    "@orpc/standard-server": "0.0.0-next.d5f6b77"
+    "@orpc/shared": "0.0.0-next.d63ea0a",
+    "@orpc/standard-server-fetch": "0.0.0-next.d63ea0a",
+    "@orpc/standard-server": "0.0.0-next.d63ea0a"
   },
   "devDependencies": {
-    "@types/node": "^22.14.1",
+    "@types/node": "^22.15.30",
     "@types/supertest": "^6.0.3",
-    "supertest": "^7.1.0"
+    "supertest": "^7.1.4"
   },
   "scripts": {
     "build": "unbuild",