@orpc/standard-server-peer 0.0.0-next.0021fba

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 oRPC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,77 @@
+<div align="center">
+  <image align="center" src="https://orpc.unnoq.com/logo.webp" width=280 alt="oRPC logo" />
+</div>
+
+<h1></h1>
+
+<div align="center">
+  <a href="https://codecov.io/gh/unnoq/orpc">
+    <img alt="codecov" src="https://codecov.io/gh/unnoq/orpc/branch/main/graph/badge.svg">
+  </a>
+  <a href="https://www.npmjs.com/package/@orpc/standard-server-peer">
+    <img alt="weekly downloads" src="https://img.shields.io/npm/dw/%40orpc%2Fstandard-server-peer?logo=npm" />
+  </a>
+  <a href="https://github.com/unnoq/orpc/blob/main/LICENSE">
+    <img alt="MIT License" src="https://img.shields.io/github/license/unnoq/orpc?logo=open-source-initiative" />
+  </a>
+  <a href="https://discord.gg/TXEbwRBvQn">
+    <img alt="Discord" src="https://img.shields.io/discord/1308966753044398161?color=7389D8&label&logo=discord&logoColor=ffffff" />
+  </a>
+</div>
+
+<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
+
+---
+
+## Highlights
+
+- **🔗 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.
+- **🔍 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.
+- **⏱️ 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.
+
+## Documentation
+
+You can find the full documentation [here](https://orpc.unnoq.com).
+
+## Packages
+
+- [@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/tanstack-query](https://www.npmjs.com/package/@orpc/tanstack-query): [TanStack Query](https://tanstack.com/query/latest) 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.
+- [@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/).
+
+## `@orpc/standard-server-peer`
+
+Provides a standard interface for oRPC server adapters to interact with connected peers across various transports (e.g., WebSocket, IPC).
+
+## Sponsors
+
+<p align="center">
+  <a href="https://cdn.jsdelivr.net/gh/unnoq/unnoq/sponsors.svg">
+    <img src='https://cdn.jsdelivr.net/gh/unnoq/unnoq/sponsors.svg'/>
+  </a>
+</p>
+
+## License
+
+Distributed under the MIT License. See [LICENSE](https://github.com/unnoq/orpc/blob/main/LICENSE) for more information.

package/dist/index.d.mts

@@ -0,0 +1,134 @@
+import { Promisable, AsyncIdQueueCloseOptions as AsyncIdQueueCloseOptions$1, SetSpanErrorOptions, AsyncIteratorClassCleanupFn, AsyncIteratorClass } from '@orpc/shared';
+import { StandardRequest, StandardResponse, EventMeta } from '@orpc/standard-server';
+
+type EncodedMessage = string | ArrayBufferLike | Uint8Array;
+interface EncodedMessageSendFn {
+    (message: EncodedMessage): Promisable<void>;
+}
+
+interface ClientPeerCloseOptions extends AsyncIdQueueCloseOptions$1 {
+    /**
+     * Should abort or not?
+     *
+     * @default true
+     */
+    abort?: boolean;
+}
+declare class ClientPeer {
+    private readonly idGenerator;
+    /**
+     * Queue of responses sent from server, awaiting consumption
+     */
+    private readonly responseQueue;
+    /**
+     * Queue of event iterator messages sent from server, awaiting consumption
+     */
+    private readonly serverEventIteratorQueue;
+    /**
+     * Controllers used to signal that the client should stop sending event iterator messages
+     */
+    private readonly serverControllers;
+    /**
+     * Cleanup functions invoked when the request/response is closed
+     */
+    private readonly cleanupFns;
+    private readonly send;
+    constructor(send: EncodedMessageSendFn);
+    get length(): number;
+    open(id: string): AbortController;
+    request(request: StandardRequest): Promise<StandardResponse>;
+    message(raw: EncodedMessage): Promise<void>;
+    close(options?: AsyncIdQueueCloseOptions$1): void;
+}
+
+declare enum MessageType {
+    REQUEST = 1,
+    RESPONSE = 2,
+    EVENT_ITERATOR = 3,
+    ABORT_SIGNAL = 4
+}
+type EventIteratorEvent = 'message' | 'error' | 'done';
+interface EventIteratorPayload {
+    event: EventIteratorEvent;
+    data: unknown;
+    meta?: EventMeta;
+}
+interface RequestMessageMap {
+    [MessageType.REQUEST]: Omit<StandardRequest, 'signal'>;
+    [MessageType.EVENT_ITERATOR]: EventIteratorPayload;
+    [MessageType.ABORT_SIGNAL]: void;
+}
+interface ResponseMessageMap {
+    [MessageType.RESPONSE]: StandardResponse;
+    [MessageType.EVENT_ITERATOR]: EventIteratorPayload;
+    [MessageType.ABORT_SIGNAL]: void;
+}
+type DecodedMessageUnion<TMap extends RequestMessageMap | ResponseMessageMap> = {
+    [K in keyof TMap]: [id: string, type: K, payload: TMap[K]];
+}[keyof TMap];
+type DecodedRequestMessage = DecodedMessageUnion<RequestMessageMap>;
+type DecodedResponseMessage = DecodedMessageUnion<ResponseMessageMap>;
+declare function encodeRequestMessage<T extends keyof RequestMessageMap>(id: string, type: T, payload: RequestMessageMap[T]): Promise<EncodedMessage>;
+declare function decodeRequestMessage(raw: EncodedMessage): Promise<DecodedRequestMessage>;
+declare function encodeResponseMessage<T extends keyof ResponseMessageMap>(id: string, type: T, payload: ResponseMessageMap[T]): Promise<EncodedMessage>;
+declare function decodeResponseMessage(raw: EncodedMessage): Promise<DecodedResponseMessage>;
+
+interface AsyncIdQueueCloseOptions {
+    id?: string;
+    reason?: unknown;
+}
+declare class AsyncIdQueue<T> {
+    private readonly openIds;
+    private readonly items;
+    private readonly pendingPulls;
+    get length(): number;
+    open(id: string): void;
+    isOpen(id: string): boolean;
+    push(id: string, item: T): void;
+    pull(id: string): Promise<T>;
+    close({ id, reason }?: AsyncIdQueueCloseOptions): void;
+    assertOpen(id: string): void;
+}
+
+interface ToEventIteratorOptions extends SetSpanErrorOptions {
+}
+declare function toEventIterator(queue: AsyncIdQueue<EventIteratorPayload>, id: string, cleanup: AsyncIteratorClassCleanupFn, options?: ToEventIteratorOptions): AsyncIteratorClass<unknown>;
+declare function resolveEventIterator(iterator: AsyncIterator<any>, callback: (payload: EventIteratorPayload) => Promise<'next' | 'abort'>): Promise<void>;
+
+interface ServerPeerHandleRequestFn {
+    (request: StandardRequest): Promise<StandardResponse>;
+}
+interface ServerPeerCloseOptions extends AsyncIdQueueCloseOptions$1 {
+    /**
+     * Should abort or not?
+     *
+     * @default true
+     */
+    abort?: boolean;
+}
+declare class ServerPeer {
+    /**
+     * Queue of event iterator messages sent from client, awaiting consumption
+     */
+    private readonly clientEventIteratorQueue;
+    /**
+     * Map of active client request controllers, should be synced to request signal
+     */
+    private readonly clientControllers;
+    private readonly send;
+    constructor(send: EncodedMessageSendFn);
+    get length(): number;
+    open(id: string): AbortController;
+    /**
+     * @todo This method will return Promise<void> in the next major version.
+     */
+    message(raw: EncodedMessage, handleRequest?: ServerPeerHandleRequestFn): Promise<[id: string, StandardRequest | undefined]>;
+    /**
+     * @deprecated Please pass the `handleRequest` (second arg) function to the `message` method instead.
+     */
+    response(id: string, response: StandardResponse): Promise<void>;
+    close({ abort, ...options }?: ServerPeerCloseOptions): void;
+}
+
+export { ClientPeer, MessageType, ServerPeer, decodeRequestMessage, decodeResponseMessage, encodeRequestMessage, encodeResponseMessage, resolveEventIterator, toEventIterator };
+export type { ClientPeerCloseOptions, DecodedRequestMessage, DecodedResponseMessage, EncodedMessage, EncodedMessageSendFn, EventIteratorEvent, EventIteratorPayload, RequestMessageMap, ResponseMessageMap, ServerPeerCloseOptions, ServerPeerHandleRequestFn, ToEventIteratorOptions };

package/dist/index.d.ts

@@ -0,0 +1,134 @@
+import { Promisable, AsyncIdQueueCloseOptions as AsyncIdQueueCloseOptions$1, SetSpanErrorOptions, AsyncIteratorClassCleanupFn, AsyncIteratorClass } from '@orpc/shared';
+import { StandardRequest, StandardResponse, EventMeta } from '@orpc/standard-server';
+
+type EncodedMessage = string | ArrayBufferLike | Uint8Array;
+interface EncodedMessageSendFn {
+    (message: EncodedMessage): Promisable<void>;
+}
+
+interface ClientPeerCloseOptions extends AsyncIdQueueCloseOptions$1 {
+    /**
+     * Should abort or not?
+     *
+     * @default true
+     */
+    abort?: boolean;
+}
+declare class ClientPeer {
+    private readonly idGenerator;
+    /**
+     * Queue of responses sent from server, awaiting consumption
+     */
+    private readonly responseQueue;
+    /**
+     * Queue of event iterator messages sent from server, awaiting consumption
+     */
+    private readonly serverEventIteratorQueue;
+    /**
+     * Controllers used to signal that the client should stop sending event iterator messages
+     */
+    private readonly serverControllers;
+    /**
+     * Cleanup functions invoked when the request/response is closed
+     */
+    private readonly cleanupFns;
+    private readonly send;
+    constructor(send: EncodedMessageSendFn);
+    get length(): number;
+    open(id: string): AbortController;
+    request(request: StandardRequest): Promise<StandardResponse>;
+    message(raw: EncodedMessage): Promise<void>;
+    close(options?: AsyncIdQueueCloseOptions$1): void;
+}
+
+declare enum MessageType {
+    REQUEST = 1,
+    RESPONSE = 2,
+    EVENT_ITERATOR = 3,
+    ABORT_SIGNAL = 4
+}
+type EventIteratorEvent = 'message' | 'error' | 'done';
+interface EventIteratorPayload {
+    event: EventIteratorEvent;
+    data: unknown;
+    meta?: EventMeta;
+}
+interface RequestMessageMap {
+    [MessageType.REQUEST]: Omit<StandardRequest, 'signal'>;
+    [MessageType.EVENT_ITERATOR]: EventIteratorPayload;
+    [MessageType.ABORT_SIGNAL]: void;
+}
+interface ResponseMessageMap {
+    [MessageType.RESPONSE]: StandardResponse;
+    [MessageType.EVENT_ITERATOR]: EventIteratorPayload;
+    [MessageType.ABORT_SIGNAL]: void;
+}
+type DecodedMessageUnion<TMap extends RequestMessageMap | ResponseMessageMap> = {
+    [K in keyof TMap]: [id: string, type: K, payload: TMap[K]];
+}[keyof TMap];
+type DecodedRequestMessage = DecodedMessageUnion<RequestMessageMap>;
+type DecodedResponseMessage = DecodedMessageUnion<ResponseMessageMap>;
+declare function encodeRequestMessage<T extends keyof RequestMessageMap>(id: string, type: T, payload: RequestMessageMap[T]): Promise<EncodedMessage>;
+declare function decodeRequestMessage(raw: EncodedMessage): Promise<DecodedRequestMessage>;
+declare function encodeResponseMessage<T extends keyof ResponseMessageMap>(id: string, type: T, payload: ResponseMessageMap[T]): Promise<EncodedMessage>;
+declare function decodeResponseMessage(raw: EncodedMessage): Promise<DecodedResponseMessage>;
+
+interface AsyncIdQueueCloseOptions {
+    id?: string;
+    reason?: unknown;
+}
+declare class AsyncIdQueue<T> {
+    private readonly openIds;
+    private readonly items;
+    private readonly pendingPulls;
+    get length(): number;
+    open(id: string): void;
+    isOpen(id: string): boolean;
+    push(id: string, item: T): void;
+    pull(id: string): Promise<T>;
+    close({ id, reason }?: AsyncIdQueueCloseOptions): void;
+    assertOpen(id: string): void;
+}
+
+interface ToEventIteratorOptions extends SetSpanErrorOptions {
+}
+declare function toEventIterator(queue: AsyncIdQueue<EventIteratorPayload>, id: string, cleanup: AsyncIteratorClassCleanupFn, options?: ToEventIteratorOptions): AsyncIteratorClass<unknown>;
+declare function resolveEventIterator(iterator: AsyncIterator<any>, callback: (payload: EventIteratorPayload) => Promise<'next' | 'abort'>): Promise<void>;
+
+interface ServerPeerHandleRequestFn {
+    (request: StandardRequest): Promise<StandardResponse>;
+}
+interface ServerPeerCloseOptions extends AsyncIdQueueCloseOptions$1 {
+    /**
+     * Should abort or not?
+     *
+     * @default true
+     */
+    abort?: boolean;
+}
+declare class ServerPeer {
+    /**
+     * Queue of event iterator messages sent from client, awaiting consumption
+     */
+    private readonly clientEventIteratorQueue;
+    /**
+     * Map of active client request controllers, should be synced to request signal
+     */
+    private readonly clientControllers;
+    private readonly send;
+    constructor(send: EncodedMessageSendFn);
+    get length(): number;
+    open(id: string): AbortController;
+    /**
+     * @todo This method will return Promise<void> in the next major version.
+     */
+    message(raw: EncodedMessage, handleRequest?: ServerPeerHandleRequestFn): Promise<[id: string, StandardRequest | undefined]>;
+    /**
+     * @deprecated Please pass the `handleRequest` (second arg) function to the `message` method instead.
+     */
+    response(id: string, response: StandardResponse): Promise<void>;
+    close({ abort, ...options }?: ServerPeerCloseOptions): void;
+}
+
+export { ClientPeer, MessageType, ServerPeer, decodeRequestMessage, decodeResponseMessage, encodeRequestMessage, encodeResponseMessage, resolveEventIterator, toEventIterator };
+export type { ClientPeerCloseOptions, DecodedRequestMessage, DecodedResponseMessage, EncodedMessage, EncodedMessageSendFn, EventIteratorEvent, EventIteratorPayload, RequestMessageMap, ResponseMessageMap, ServerPeerCloseOptions, ServerPeerHandleRequestFn, ToEventIteratorOptions };

package/dist/index.mjs

@@ -0,0 +1,569 @@
+import { isAsyncIteratorObject, stringifyJSON, readAsBuffer, AsyncIteratorClass, startSpan, runInSpanContext, isTypescriptObject, setSpanError, runWithSpan, SequentialIdGenerator, AsyncIdQueue, getGlobalOtelConfig, clone, AbortError } from '@orpc/shared';
+import { generateContentDisposition, flattenHeader, getFilenameFromContentDisposition, withEventMeta, ErrorEvent, getEventMeta, isEventIteratorHeaders, HibernationEventIterator } from '@orpc/standard-server';
+
+var MessageType = /* @__PURE__ */ ((MessageType2) => {
+  MessageType2[MessageType2["REQUEST"] = 1] = "REQUEST";
+  MessageType2[MessageType2["RESPONSE"] = 2] = "RESPONSE";
+  MessageType2[MessageType2["EVENT_ITERATOR"] = 3] = "EVENT_ITERATOR";
+  MessageType2[MessageType2["ABORT_SIGNAL"] = 4] = "ABORT_SIGNAL";
+  return MessageType2;
+})(MessageType || {});
+async function encodeRequestMessage(id, type, payload) {
+  if (type === 3 /* EVENT_ITERATOR */) {
+    const eventPayload = payload;
+    const serializedPayload2 = {
+      e: eventPayload.event,
+      d: eventPayload.data,
+      m: eventPayload.meta
+    };
+    return encodeRawMessage({ i: id, t: type, p: serializedPayload2 });
+  }
+  if (type === 4 /* ABORT_SIGNAL */) {
+    return encodeRawMessage({ i: id, t: type, p: payload });
+  }
+  const request = payload;
+  const { body: processedBody, headers: processedHeaders } = await serializeBodyAndHeaders(
+    request.body,
+    request.headers
+  );
+  const serializedPayload = {
+    u: request.url.toString().replace(/^orpc:\//, "/"),
+    b: processedBody instanceof Blob ? void 0 : processedBody,
+    h: Object.keys(processedHeaders).length > 0 ? processedHeaders : void 0,
+    m: request.method === "POST" ? void 0 : request.method
+  };
+  const baseMessage = {
+    i: id,
+    p: serializedPayload
+  };
+  if (processedBody instanceof Blob) {
+    return encodeRawMessage(baseMessage, processedBody);
+  }
+  return encodeRawMessage(baseMessage);
+}
+async function decodeRequestMessage(raw) {
+  const { json: message, buffer } = await decodeRawMessage(raw);
+  const id = message.i;
+  const type = message.t;
+  if (type === 3 /* EVENT_ITERATOR */) {
+    const payload2 = message.p;
+    return [id, type, { event: payload2.e, data: payload2.d, meta: payload2.m }];
+  }
+  if (type === 4 /* ABORT_SIGNAL */) {
+    return [id, type, message.p];
+  }
+  const payload = message.p;
+  const headers = payload.h ?? {};
+  const body = await deserializeBody(headers, payload.b, buffer);
+  return [id, 1 /* REQUEST */, { url: new URL(payload.u, "orpc:/"), headers, method: payload.m ?? "POST", body }];
+}
+async function encodeResponseMessage(id, type, payload) {
+  if (type === 3 /* EVENT_ITERATOR */) {
+    const eventPayload = payload;
+    const serializedPayload2 = {
+      e: eventPayload.event,
+      d: eventPayload.data,
+      m: eventPayload.meta
+    };
+    return encodeRawMessage({ i: id, t: type, p: serializedPayload2 });
+  }
+  if (type === 4 /* ABORT_SIGNAL */) {
+    return encodeRawMessage({ i: id, t: type, p: void 0 });
+  }
+  const response = payload;
+  const { body: processedBody, headers: processedHeaders } = await serializeBodyAndHeaders(
+    response.body,
+    response.headers
+  );
+  const serializedPayload = {
+    s: response.status === 200 ? void 0 : response.status,
+    h: Object.keys(processedHeaders).length > 0 ? processedHeaders : void 0,
+    b: processedBody instanceof Blob ? void 0 : processedBody
+  };
+  const baseMessage = {
+    i: id,
+    p: serializedPayload
+  };
+  if (processedBody instanceof Blob) {
+    return encodeRawMessage(baseMessage, processedBody);
+  }
+  return encodeRawMessage(baseMessage);
+}
+async function decodeResponseMessage(raw) {
+  const { json: message, buffer } = await decodeRawMessage(raw);
+  const id = message.i;
+  const type = message.t;
+  if (type === 3 /* EVENT_ITERATOR */) {
+    const payload2 = message.p;
+    return [id, type, { event: payload2.e, data: payload2.d, meta: payload2.m }];
+  }
+  if (type === 4 /* ABORT_SIGNAL */) {
+    return [id, type, message.p];
+  }
+  const payload = message.p;
+  const headers = payload.h ?? {};
+  const body = await deserializeBody(headers, payload.b, buffer);
+  return [id, 2 /* RESPONSE */, { status: payload.s ?? 200, headers, body }];
+}
+async function serializeBodyAndHeaders(body, originalHeaders) {
+  const headers = { ...originalHeaders };
+  const originalContentDisposition = headers["content-disposition"];
+  delete headers["content-type"];
+  delete headers["content-disposition"];
+  if (body instanceof Blob) {
+    headers["content-type"] = body.type;
+    headers["content-disposition"] = originalContentDisposition ?? generateContentDisposition(
+      body instanceof File ? body.name : "blob"
+    );
+    return { body, headers };
+  }
+  if (body instanceof FormData) {
+    const tempRes = new Response(body);
+    headers["content-type"] = tempRes.headers.get("content-type");
+    const formDataBlob = await tempRes.blob();
+    return { body: formDataBlob, headers };
+  }
+  if (body instanceof URLSearchParams) {
+    headers["content-type"] = "application/x-www-form-urlencoded";
+    return { body: body.toString(), headers };
+  }
+  if (isAsyncIteratorObject(body)) {
+    headers["content-type"] = "text/event-stream";
+    return { body: void 0, headers };
+  }
+  return { body, headers };
+}
+async function deserializeBody(headers, body, buffer) {
+  const contentType = flattenHeader(headers["content-type"]);
+  const contentDisposition = flattenHeader(headers["content-disposition"]);
+  if (typeof contentDisposition === "string") {
+    const filename = getFilenameFromContentDisposition(contentDisposition) ?? "blob";
+    return new File(buffer === void 0 ? [] : [buffer], filename, { type: contentType });
+  }
+  if (contentType?.startsWith("multipart/form-data")) {
+    const tempRes = new Response(buffer, { headers: { "content-type": contentType } });
+    return tempRes.formData();
+  }
+  if (contentType?.startsWith("application/x-www-form-urlencoded") && typeof body === "string") {
+    return new URLSearchParams(body);
+  }
+  return body;
+}
+const JSON_AND_BINARY_DELIMITER = 255;
+async function encodeRawMessage(data, blob) {
+  const json = stringifyJSON(data);
+  if (blob === void 0 || blob.size === 0) {
+    return json;
+  }
+  return readAsBuffer(new Blob([
+    new TextEncoder().encode(json),
+    new Uint8Array([JSON_AND_BINARY_DELIMITER]),
+    blob
+  ]));
+}
+async function decodeRawMessage(raw) {
+  if (typeof raw === "string") {
+    return { json: JSON.parse(raw) };
+  }
+  const buffer = raw instanceof Uint8Array ? raw : new Uint8Array(raw);
+  const delimiterIndex = buffer.indexOf(JSON_AND_BINARY_DELIMITER);
+  if (delimiterIndex === -1) {
+    const jsonPart2 = new TextDecoder().decode(buffer);
+    return { json: JSON.parse(jsonPart2) };
+  }
+  const jsonPart = new TextDecoder().decode(buffer.subarray(0, delimiterIndex));
+  const bufferPart = buffer.subarray(delimiterIndex + 1);
+  return {
+    json: JSON.parse(jsonPart),
+    buffer: bufferPart
+  };
+}
+
+function toEventIterator(queue, id, cleanup, options = {}) {
+  let span;
+  return new AsyncIteratorClass(async () => {
+    span ??= startSpan("consume_event_iterator_stream");
+    try {
+      const item = await runInSpanContext(span, () => queue.pull(id));
+      switch (item.event) {
+        case "message": {
+          let data = item.data;
+          if (item.meta && isTypescriptObject(data)) {
+            data = withEventMeta(data, item.meta);
+          }
+          span?.addEvent("message");
+          return { value: data, done: false };
+        }
+        case "error": {
+          let error = new ErrorEvent({
+            data: item.data
+          });
+          if (item.meta) {
+            error = withEventMeta(error, item.meta);
+          }
+          span?.addEvent("error");
+          throw error;
+        }
+        case "done": {
+          let data = item.data;
+          if (item.meta && isTypescriptObject(data)) {
+            data = withEventMeta(data, item.meta);
+          }
+          span?.addEvent("done");
+          return { value: data, done: true };
+        }
+      }
+    } catch (e) {
+      if (!(e instanceof ErrorEvent)) {
+        setSpanError(span, e, options);
+      }
+      throw e;
+    }
+  }, async (reason) => {
+    try {
+      if (reason !== "next") {
+        span?.addEvent("cancelled");
+      }
+      await runInSpanContext(span, () => cleanup(reason));
+    } catch (e) {
+      setSpanError(span, e, options);
+      throw e;
+    } finally {
+      span?.end();
+    }
+  });
+}
+function resolveEventIterator(iterator, callback) {
+  return runWithSpan(
+    { name: "stream_event_iterator" },
+    async (span) => {
+      while (true) {
+        const payload = await (async () => {
+          try {
+            const { value, done } = await iterator.next();
+            if (done) {
+              span?.addEvent("done");
+              return { event: "done", data: value, meta: getEventMeta(value) };
+            }
+            span?.addEvent("message");
+            return { event: "message", data: value, meta: getEventMeta(value) };
+          } catch (err) {
+            if (err instanceof ErrorEvent) {
+              span?.addEvent("error");
+              return {
+                event: "error",
+                data: err.data,
+                meta: getEventMeta(err)
+              };
+            } else {
+              try {
+                await callback({ event: "error", data: void 0 });
+              } catch (err2) {
+                setSpanError(span, err);
+                throw err2;
+              }
+              throw err;
+            }
+          }
+        })();
+        let isInvokeCleanupFn = false;
+        try {
+          const direction = await callback(payload);
+          if (payload.event === "done" || payload.event === "error") {
+            return;
+          }
+          if (direction === "abort") {
+            isInvokeCleanupFn = true;
+            await iterator.return?.();
+            return;
+          }
+        } catch (err) {
+          if (!isInvokeCleanupFn) {
+            try {
+              await iterator.return?.();
+            } catch (err2) {
+              setSpanError(span, err);
+              throw err2;
+            }
+          }
+          throw err;
+        }
+      }
+    }
+  );
+}
+
+class ClientPeer {
+  idGenerator = new SequentialIdGenerator();
+  /**
+   * Queue of responses sent from server, awaiting consumption
+   */
+  responseQueue = new AsyncIdQueue();
+  /**
+   * Queue of event iterator messages sent from server, awaiting consumption
+   */
+  serverEventIteratorQueue = new AsyncIdQueue();
+  /**
+   * Controllers used to signal that the client should stop sending event iterator messages
+   */
+  serverControllers = /* @__PURE__ */ new Map();
+  /**
+   * Cleanup functions invoked when the request/response is closed
+   */
+  cleanupFns = /* @__PURE__ */ new Map();
+  send;
+  constructor(send) {
+    this.send = async (id, ...rest) => encodeRequestMessage(id, ...rest).then(async (raw) => {
+      if (this.serverControllers.has(id)) {
+        await send(raw);
+      }
+    });
+  }
+  get length() {
+    return (+this.responseQueue.length + this.serverEventIteratorQueue.length + this.serverControllers.size + this.cleanupFns.size) / 4;
+  }
+  open(id) {
+    this.serverEventIteratorQueue.open(id);
+    this.responseQueue.open(id);
+    const controller = new AbortController();
+    this.serverControllers.set(id, controller);
+    this.cleanupFns.set(id, []);
+    return controller;
+  }
+  async request(request) {
+    const signal = request.signal;
+    return runWithSpan(
+      { name: "send_peer_request", signal },
+      async () => {
+        if (signal?.aborted) {
+          throw signal.reason;
+        }
+        const id = this.idGenerator.generate();
+        const serverController = this.open(id);
+        try {
+          const otelConfig = getGlobalOtelConfig();
+          if (otelConfig) {
+            const headers = clone(request.headers);
+            otelConfig.propagation.inject(otelConfig.context.active(), headers);
+            request = { ...request, headers };
+          }
+          await this.send(id, MessageType.REQUEST, request);
+          if (signal?.aborted) {
+            await this.send(id, MessageType.ABORT_SIGNAL, void 0);
+            throw signal.reason;
+          }
+          let abortListener;
+          signal?.addEventListener("abort", abortListener = async () => {
+            await this.send(id, MessageType.ABORT_SIGNAL, void 0);
+            this.close({ id, reason: signal.reason });
+          }, { once: true });
+          this.cleanupFns.get(id)?.push(() => {
+            signal?.removeEventListener("abort", abortListener);
+          });
+          if (isAsyncIteratorObject(request.body)) {
+            const iterator = request.body;
+            void resolveEventIterator(iterator, async (payload) => {
+              if (serverController.signal.aborted) {
+                return "abort";
+              }
+              await this.send(id, MessageType.EVENT_ITERATOR, payload);
+              return "next";
+            });
+          }
+          const response = await this.responseQueue.pull(id);
+          if (isEventIteratorHeaders(response.headers)) {
+            const iterator = toEventIterator(
+              this.serverEventIteratorQueue,
+              id,
+              async (reason) => {
+                try {
+                  if (reason !== "next") {
+                    await this.send(id, MessageType.ABORT_SIGNAL, void 0);
+                  }
+                } finally {
+                  this.close({ id });
+                }
+              },
+              { signal }
+            );
+            return {
+              ...response,
+              body: iterator
+            };
+          }
+          this.close({ id });
+          return response;
+        } catch (err) {
+          this.close({ id, reason: err });
+          throw err;
+        }
+      }
+    );
+  }
+  async message(raw) {
+    const [id, type, payload] = await decodeResponseMessage(raw);
+    if (type === MessageType.ABORT_SIGNAL) {
+      this.serverControllers.get(id)?.abort();
+      return;
+    }
+    if (type === MessageType.EVENT_ITERATOR) {
+      if (this.serverEventIteratorQueue.isOpen(id)) {
+        this.serverEventIteratorQueue.push(id, payload);
+      }
+      return;
+    }
+    if (!this.responseQueue.isOpen(id)) {
+      return;
+    }
+    this.responseQueue.push(id, payload);
+  }
+  close(options = {}) {
+    if (options.id !== void 0) {
+      this.serverControllers.get(options.id)?.abort(options.reason);
+      this.serverControllers.delete(options.id);
+      this.cleanupFns.get(options.id)?.forEach((fn) => fn());
+      this.cleanupFns.delete(options.id);
+    } else {
+      this.serverControllers.forEach((c) => c.abort(options.reason));
+      this.serverControllers.clear();
+      this.cleanupFns.forEach((fns) => fns.forEach((fn) => fn()));
+      this.cleanupFns.clear();
+    }
+    this.responseQueue.close(options);
+    this.serverEventIteratorQueue.close(options);
+  }
+}
+
+class ServerPeer {
+  /**
+   * Queue of event iterator messages sent from client, awaiting consumption
+   */
+  clientEventIteratorQueue = new AsyncIdQueue();
+  /**
+   * Map of active client request controllers, should be synced to request signal
+   */
+  clientControllers = /* @__PURE__ */ new Map();
+  send;
+  constructor(send) {
+    this.send = (id, ...rest) => encodeResponseMessage(id, ...rest).then(async (raw) => {
+      if (this.clientControllers.has(id)) {
+        await send(raw);
+      }
+    });
+  }
+  get length() {
+    return (this.clientEventIteratorQueue.length + this.clientControllers.size) / 2;
+  }
+  open(id) {
+    this.clientEventIteratorQueue.open(id);
+    const controller = new AbortController();
+    this.clientControllers.set(id, controller);
+    return controller;
+  }
+  /**
+   * @todo This method will return Promise<void> in the next major version.
+   */
+  async message(raw, handleRequest) {
+    const [id, type, payload] = await decodeRequestMessage(raw);
+    if (type === MessageType.ABORT_SIGNAL) {
+      this.close({ id, reason: new AbortError("Client aborted the request") });
+      return [id, void 0];
+    }
+    if (type === MessageType.EVENT_ITERATOR) {
+      if (this.clientEventIteratorQueue.isOpen(id)) {
+        this.clientEventIteratorQueue.push(id, payload);
+      }
+      return [id, void 0];
+    }
+    const clientController = this.open(id);
+    const signal = clientController.signal;
+    const request = {
+      ...payload,
+      signal,
+      body: isEventIteratorHeaders(payload.headers) ? toEventIterator(
+        this.clientEventIteratorQueue,
+        id,
+        async (reason) => {
+          if (reason !== "next") {
+            await this.send(id, MessageType.ABORT_SIGNAL, void 0);
+          }
+        },
+        { signal }
+      ) : payload.body
+    };
+    if (handleRequest) {
+      let context;
+      const otelConfig = getGlobalOtelConfig();
+      if (otelConfig) {
+        context = otelConfig.propagation.extract(otelConfig.context.active(), request.headers);
+      }
+      await runWithSpan(
+        { name: "receive_peer_request", context },
+        async () => {
+          const response = await runWithSpan(
+            { name: "handle_request" },
+            async () => {
+              try {
+                return await handleRequest(request);
+              } catch (reason) {
+                this.close({ id, reason, abort: false });
+                throw reason;
+              }
+            }
+          );
+          await runWithSpan(
+            { name: "send_peer_response" },
+            () => this.response(id, response)
+          );
+        }
+      );
+    }
+    return [id, request];
+  }
+  /**
+   * @deprecated Please pass the `handleRequest` (second arg) function to the `message` method instead.
+   */
+  async response(id, response) {
+    const signal = this.clientControllers.get(id)?.signal;
+    if (!signal || signal.aborted) {
+      return;
+    }
+    try {
+      await this.send(id, MessageType.RESPONSE, response);
+      if (!signal.aborted && isAsyncIteratorObject(response.body)) {
+        if (response.body instanceof HibernationEventIterator) {
+          response.body.hibernationCallback?.(id);
+        } else {
+          const iterator = response.body;
+          await resolveEventIterator(iterator, async (payload) => {
+            if (signal.aborted) {
+              return "abort";
+            }
+            await this.send(id, MessageType.EVENT_ITERATOR, payload);
+            return "next";
+          });
+        }
+      }
+      this.close({ id, abort: false });
+    } catch (reason) {
+      this.close({ id, reason, abort: false });
+      throw reason;
+    }
+  }
+  close({ abort = true, ...options } = {}) {
+    if (options.id === void 0) {
+      if (abort) {
+        this.clientControllers.forEach((c) => c.abort(options.reason));
+      }
+      this.clientControllers.clear();
+    } else {
+      if (abort) {
+        this.clientControllers.get(options.id)?.abort(options.reason);
+      }
+      this.clientControllers.delete(options.id);
+    }
+    this.clientEventIteratorQueue.close(options);
+  }
+}
+
+export { ClientPeer, MessageType, ServerPeer, decodeRequestMessage, decodeResponseMessage, encodeRequestMessage, encodeResponseMessage, resolveEventIterator, toEventIterator };

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@orpc/standard-server-peer",
+  "type": "module",
+  "version": "0.0.0-next.0021fba",
+  "license": "MIT",
+  "homepage": "https://unnoq.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/unnoq/orpc.git",
+    "directory": "packages/standard-server-peer"
+  },
+  "keywords": [
+    "orpc"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@orpc/shared": "0.0.0-next.0021fba",
+    "@orpc/standard-server": "0.0.0-next.0021fba"
+  },
+  "scripts": {
+    "build": "unbuild",
+    "build:watch": "pnpm run build --watch",
+    "type:check": "tsc -b"
+  }
+}