@orpc/standard-server 0.0.0-next.de766b3 → 0.0.0-next.dea79a3

package/README.md

@@ -30,7 +30,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), 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 +39,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,6 +50,7 @@ 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.

package/dist/index.d.mts

@@ -1,3 +1,4 @@
+import { AsyncIteratorClass } from '@orpc/shared';
 import { S as StandardHeaders, a as StandardLazyResponse } from './shared/standard-server.BD8Sg1A5.mjs';
 export { b as StandardBody, d as StandardLazyRequest, c as StandardRequest, e as StandardResponse } from './shared/standard-server.BD8Sg1A5.mjs';
 
@@ -52,11 +53,23 @@ 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 HibernationEventIteratorCallback {
+    (id: string): void;
+}
+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?: HibernationEventIteratorCallback;
+    constructor(hibernationCallback: HibernationEventIteratorCallback);
+}
+
 declare function generateContentDisposition(filename: string): string;
 declare function getFilenameFromContentDisposition(contentDisposition: string): string | undefined;
 declare function mergeStandardHeaders(a: StandardHeaders, b: StandardHeaders): StandardHeaders;
 declare function flattenHeader(header: string | readonly string[] | undefined): 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, flattenHeader, generateContentDisposition, getEventMeta, getFilenameFromContentDisposition, mergeStandardHeaders, replicateStandardLazyResponse, withEventMeta };
-export type { ErrorEventOptions, EventDecoderOptions, EventMessage, EventMeta };
+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

@@ -1,3 +1,4 @@
+import { AsyncIteratorClass } from '@orpc/shared';
 import { S as StandardHeaders, a as StandardLazyResponse } from './shared/standard-server.BD8Sg1A5.js';
 export { b as StandardBody, d as StandardLazyRequest, c as StandardRequest, e as StandardResponse } from './shared/standard-server.BD8Sg1A5.js';
 
@@ -52,11 +53,23 @@ 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 HibernationEventIteratorCallback {
+    (id: string): void;
+}
+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?: HibernationEventIteratorCallback;
+    constructor(hibernationCallback: HibernationEventIteratorCallback);
+}
+
 declare function generateContentDisposition(filename: string): string;
 declare function getFilenameFromContentDisposition(contentDisposition: string): string | undefined;
 declare function mergeStandardHeaders(a: StandardHeaders, b: StandardHeaders): StandardHeaders;
 declare function flattenHeader(header: string | readonly string[] | undefined): 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, flattenHeader, generateContentDisposition, getEventMeta, getFilenameFromContentDisposition, mergeStandardHeaders, replicateStandardLazyResponse, withEventMeta };
-export type { ErrorEventOptions, EventDecoderOptions, EventMessage, EventMeta };
+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, toArray, once, isAsyncIteratorObject, replicateAsyncIterator } from '@orpc/shared';
+import { isTypescriptObject, AsyncIteratorClass, tryDecodeURIComponent, toArray, once, isAsyncIteratorObject, replicateAsyncIterator } from '@orpc/shared';
 
 class EventEncoderError extends TypeError {
 }
@@ -182,6 +182,23 @@ function getEventMeta(container) {
   return isTypescriptObject(container) ? Reflect.get(container, EVENT_SOURCE_META_SYMBOL) : void 0;
 }
 
+class HibernationEventIterator extends AsyncIteratorClass {
+  /**
+   * this property is not transferred to the client, so it should be optional for type safety
+   */
+  hibernationCallback;
+  constructor(hibernationCallback) {
+    super(async () => {
+      throw new Error("Cannot iterate over hibernating iterator directly");
+    }, async (reason) => {
+      if (reason !== "next") {
+        throw new Error("Cannot cleanup hibernating iterator directly");
+      }
+    });
+    this.hibernationCallback = hibernationCallback;
+  }
+}
+
 function generateContentDisposition(filename) {
   const escapedFileName = filename.replace(/"/g, '\\"');
   const encodedFilenameStar = encodeURIComponent(filename).replace(/['()*]/g, (c) => `%${c.charCodeAt(0).toString(16).toUpperCase()}`).replace(/%(7C|60|5E)/g, (str, hex) => String.fromCharCode(Number.parseInt(hex, 16)));
@@ -190,7 +207,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") {
@@ -245,5 +262,8 @@ function replicateStandardLazyResponse(response, count) {
   }
   return replicated;
 }
+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, flattenHeader, generateContentDisposition, getEventMeta, getFilenameFromContentDisposition, 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.de766b3",
+  "version": "0.0.0-next.dea79a3",
   "license": "MIT",
   "homepage": "https://unnoq.com",
   "repository": {
@@ -28,7 +28,7 @@
     "dist"
   ],
   "dependencies": {
-    "@orpc/shared": "0.0.0-next.de766b3"
+    "@orpc/shared": "0.0.0-next.dea79a3"
   },
   "scripts": {
     "build": "unbuild",