@orpc/standard-server 0.0.0-next.fd1ee2a → 0.0.0-next.fdd2389

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, Angular), 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
 
@@ -50,9 +53,11 @@ You can find the full documentation [here](https://orpc.unnoq.com).
 - [@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/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/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.

package/dist/batch/index.mjs

@@ -1,4 +1,4 @@
-import { stringifyJSON, parseEmptyableJSON, isAsyncIteratorObject, isObject } from '@orpc/shared';
+import { stringifyJSON, parseEmptyableJSON, AsyncIteratorClass, isAsyncIteratorObject, isObject } from '@orpc/shared';
 
 function toBatchAbortSignal(signals) {
   const realSignals = signals.filter((signal) => signal !== void 0);
@@ -91,46 +91,56 @@ function toBatchResponse(options) {
   return {
     headers: options.headers,
     status: options.status,
-    body: async function* () {
-      try {
-        for await (const item of options.body) {
-          yield {
-            index: item.index,
-            status: item.status === options.status ? void 0 : item.status,
-            headers: Object.keys(item.headers).length ? item.headers : void 0,
-            body: item.body
-          };
+    body: new AsyncIteratorClass(
+      async () => {
+        const { done, value } = await options.body.next();
+        if (done) {
+          return { done, value };
+        }
+        return {
+          done,
+          value: {
+            index: value.index,
+            status: value.status === options.status ? void 0 : value.status,
+            headers: Object.keys(value.headers).length ? value.headers : void 0,
+            body: value.body
+          }
+        };
+      },
+      async (reason) => {
+        if (reason !== "next") {
+          await options.body.return?.();
         }
-      } finally {
-        await options.body.return?.();
       }
-    }()
+    )
   };
 }
 function parseBatchResponse(response) {
   const body = response.body;
   if (isAsyncIteratorObject(body) || Array.isArray(body)) {
-    return async function* () {
-      try {
-        for await (const item of body) {
-          if (!isObject(item) || !("index" in item) || typeof item.index !== "number") {
-            throw new TypeError("Invalid batch response", {
-              cause: item
-            });
-          }
-          yield {
-            index: item.index,
-            status: item.status ?? response.status,
-            headers: item.headers ?? {},
-            body: item.body
-          };
+    const iterator = (async function* () {
+      for await (const item of body) {
+        if (!isObject(item) || !("index" in item) || typeof item.index !== "number") {
+          throw new TypeError("Invalid batch response", {
+            cause: item
+          });
         }
-      } finally {
-        if (isAsyncIteratorObject(body)) {
+        yield {
+          index: item.index,
+          status: item.status ?? response.status,
+          headers: item.headers ?? {},
+          body: item.body
+        };
+      }
+    })();
+    return new AsyncIteratorClass(
+      () => iterator.next(),
+      async (reason) => {
+        if (reason !== "next" && isAsyncIteratorObject(body)) {
           await body.return?.();
         }
       }
-    }();
+    );
   }
   throw new TypeError("Invalid batch response", {
     cause: response

package/dist/index.d.mts

@@ -53,15 +53,15 @@ type EventMeta = Partial<Pick<EventMessage, 'retry' | 'id' | 'comments'>>;
 declare function withEventMeta<T extends object>(container: T, meta: EventMeta): T;
 declare function getEventMeta(container: unknown): EventMeta | undefined;
 
-interface experimental_HibernationEventIteratorCallback {
+interface HibernationEventIteratorCallback {
     (id: string): void;
 }
-declare class experimental_HibernationEventIterator<T, TReturn = unknown, TNext = unknown> extends AsyncIteratorClass<T, TReturn, TNext> {
+declare class HibernationEventIterator<T, TReturn = unknown, TNext = unknown> extends AsyncIteratorClass<T, TReturn, TNext> {
     /**
      * this property is not transferred to the client, so it should be optional for type safety
      */
-    readonly hibernationCallback?: experimental_HibernationEventIteratorCallback;
-    constructor(hibernationCallback: experimental_HibernationEventIteratorCallback);
+    readonly hibernationCallback?: HibernationEventIteratorCallback;
+    constructor(hibernationCallback: HibernationEventIteratorCallback);
 }
 
 declare function generateContentDisposition(filename: string): string;
@@ -71,5 +71,5 @@ declare function flattenHeader(header: string | readonly string[] | undefined):
 declare function replicateStandardLazyResponse(response: StandardLazyResponse, count: number): StandardLazyResponse[];
 declare function isEventIteratorHeaders(headers: StandardHeaders): boolean;
 
-export { ErrorEvent, EventDecoder, EventDecoderError, EventDecoderStream, EventEncoderError, StandardHeaders, StandardLazyResponse, assertEventComment, assertEventId, assertEventName, assertEventRetry, decodeEventMessage, encodeEventComments, encodeEventData, encodeEventMessage, experimental_HibernationEventIterator, flattenHeader, generateContentDisposition, getEventMeta, getFilenameFromContentDisposition, isEventIteratorHeaders, mergeStandardHeaders, replicateStandardLazyResponse, withEventMeta };
-export type { ErrorEventOptions, EventDecoderOptions, EventMessage, EventMeta, experimental_HibernationEventIteratorCallback };
+export { ErrorEvent, EventDecoder, EventDecoderError, EventDecoderStream, EventEncoderError, HibernationEventIterator, StandardHeaders, StandardLazyResponse, assertEventComment, assertEventId, assertEventName, assertEventRetry, decodeEventMessage, encodeEventComments, encodeEventData, encodeEventMessage, flattenHeader, generateContentDisposition, getEventMeta, getFilenameFromContentDisposition, isEventIteratorHeaders, mergeStandardHeaders, replicateStandardLazyResponse, withEventMeta };
+export type { ErrorEventOptions, EventDecoderOptions, EventMessage, EventMeta, HibernationEventIteratorCallback };

package/dist/index.d.ts

@@ -53,15 +53,15 @@ type EventMeta = Partial<Pick<EventMessage, 'retry' | 'id' | 'comments'>>;
 declare function withEventMeta<T extends object>(container: T, meta: EventMeta): T;
 declare function getEventMeta(container: unknown): EventMeta | undefined;
 
-interface experimental_HibernationEventIteratorCallback {
+interface HibernationEventIteratorCallback {
     (id: string): void;
 }
-declare class experimental_HibernationEventIterator<T, TReturn = unknown, TNext = unknown> extends AsyncIteratorClass<T, TReturn, TNext> {
+declare class HibernationEventIterator<T, TReturn = unknown, TNext = unknown> extends AsyncIteratorClass<T, TReturn, TNext> {
     /**
      * this property is not transferred to the client, so it should be optional for type safety
      */
-    readonly hibernationCallback?: experimental_HibernationEventIteratorCallback;
-    constructor(hibernationCallback: experimental_HibernationEventIteratorCallback);
+    readonly hibernationCallback?: HibernationEventIteratorCallback;
+    constructor(hibernationCallback: HibernationEventIteratorCallback);
 }
 
 declare function generateContentDisposition(filename: string): string;
@@ -71,5 +71,5 @@ declare function flattenHeader(header: string | readonly string[] | undefined):
 declare function replicateStandardLazyResponse(response: StandardLazyResponse, count: number): StandardLazyResponse[];
 declare function isEventIteratorHeaders(headers: StandardHeaders): boolean;
 
-export { ErrorEvent, EventDecoder, EventDecoderError, EventDecoderStream, EventEncoderError, StandardHeaders, StandardLazyResponse, assertEventComment, assertEventId, assertEventName, assertEventRetry, decodeEventMessage, encodeEventComments, encodeEventData, encodeEventMessage, experimental_HibernationEventIterator, flattenHeader, generateContentDisposition, getEventMeta, getFilenameFromContentDisposition, isEventIteratorHeaders, mergeStandardHeaders, replicateStandardLazyResponse, withEventMeta };
-export type { ErrorEventOptions, EventDecoderOptions, EventMessage, EventMeta, experimental_HibernationEventIteratorCallback };
+export { ErrorEvent, EventDecoder, EventDecoderError, EventDecoderStream, EventEncoderError, HibernationEventIterator, StandardHeaders, StandardLazyResponse, assertEventComment, assertEventId, assertEventName, assertEventRetry, decodeEventMessage, encodeEventComments, encodeEventData, encodeEventMessage, flattenHeader, generateContentDisposition, getEventMeta, getFilenameFromContentDisposition, isEventIteratorHeaders, mergeStandardHeaders, replicateStandardLazyResponse, withEventMeta };
+export type { ErrorEventOptions, EventDecoderOptions, EventMessage, EventMeta, HibernationEventIteratorCallback };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { isTypescriptObject, AsyncIteratorClass, toArray, once, isAsyncIteratorObject, replicateAsyncIterator } from '@orpc/shared';
+import { isTypescriptObject, AsyncIteratorClass, tryDecodeURIComponent, toArray, once, isAsyncIteratorObject, replicateAsyncIterator } from '@orpc/shared';
 
 class EventEncoderError extends TypeError {
 }
@@ -158,6 +158,9 @@ function encodeEventMessage(message) {
 
 const EVENT_SOURCE_META_SYMBOL = Symbol("ORPC_EVENT_SOURCE_META");
 function withEventMeta(container, meta) {
+  if (meta.id === void 0 && meta.retry === void 0 && !meta.comments?.length) {
+    return container;
+  }
   if (meta.id !== void 0) {
     assertEventId(meta.id);
   }
@@ -182,7 +185,7 @@ function getEventMeta(container) {
   return isTypescriptObject(container) ? Reflect.get(container, EVENT_SOURCE_META_SYMBOL) : void 0;
 }
 
-class experimental_HibernationEventIterator extends AsyncIteratorClass {
+class HibernationEventIterator extends AsyncIteratorClass {
   /**
    * this property is not transferred to the client, so it should be optional for type safety
    */
@@ -207,7 +210,7 @@ function generateContentDisposition(filename) {
 function getFilenameFromContentDisposition(contentDisposition) {
   const encodedFilenameStarMatch = contentDisposition.match(/filename\*=(UTF-8'')?([^;]*)/i);
   if (encodedFilenameStarMatch && typeof encodedFilenameStarMatch[2] === "string") {
-    return decodeURIComponent(encodedFilenameStarMatch[2]);
+    return tryDecodeURIComponent(encodedFilenameStarMatch[2]);
   }
   const encodedFilenameMatch = contentDisposition.match(/filename="((?:\\"|[^"])*)"/i);
   if (encodedFilenameMatch && typeof encodedFilenameMatch[1] === "string") {
@@ -248,14 +251,11 @@ function replicateStandardLazyResponse(response, count) {
     replicated.push({
       ...response,
       body: once(async () => {
-        if (replicatedAsyncIteratorObjects) {
-          return replicatedAsyncIteratorObjects.shift();
-        }
         const body = await (bodyPromise ??= response.body());
         if (!isAsyncIteratorObject(body)) {
           return body;
         }
-        replicatedAsyncIteratorObjects = replicateAsyncIterator(body, count);
+        replicatedAsyncIteratorObjects ??= replicateAsyncIterator(body, count);
         return replicatedAsyncIteratorObjects.shift();
       })
     });
@@ -266,4 +266,4 @@ function isEventIteratorHeaders(headers) {
   return Boolean(flattenHeader(headers["content-type"])?.startsWith("text/event-stream") && flattenHeader(headers["content-disposition"]) === void 0);
 }
 
-export { ErrorEvent, EventDecoder, EventDecoderError, EventDecoderStream, EventEncoderError, assertEventComment, assertEventId, assertEventName, assertEventRetry, decodeEventMessage, encodeEventComments, encodeEventData, encodeEventMessage, experimental_HibernationEventIterator, flattenHeader, generateContentDisposition, getEventMeta, getFilenameFromContentDisposition, isEventIteratorHeaders, mergeStandardHeaders, replicateStandardLazyResponse, withEventMeta };
+export { ErrorEvent, EventDecoder, EventDecoderError, EventDecoderStream, EventEncoderError, HibernationEventIterator, assertEventComment, assertEventId, assertEventName, assertEventRetry, decodeEventMessage, encodeEventComments, encodeEventData, encodeEventMessage, flattenHeader, generateContentDisposition, getEventMeta, getFilenameFromContentDisposition, isEventIteratorHeaders, mergeStandardHeaders, replicateStandardLazyResponse, withEventMeta };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@orpc/standard-server",
   "type": "module",
-  "version": "0.0.0-next.fd1ee2a",
+  "version": "0.0.0-next.fdd2389",
   "license": "MIT",
   "homepage": "https://unnoq.com",
   "repository": {
@@ -28,7 +28,7 @@
     "dist"
   ],
   "dependencies": {
-    "@orpc/shared": "0.0.0-next.fd1ee2a"
+    "@orpc/shared": "0.0.0-next.fdd2389"
   },
   "scripts": {
     "build": "unbuild",