@orpc/server 1.10.0 → 1.10.2

package/dist/adapters/fastify/index.d.mts

@@ -0,0 +1,53 @@
+import { Interceptor, MaybeOptionalOptions } from '@orpc/shared';
+import { FastifyRequest, FastifyReply, SendStandardResponseOptions } from '@orpc/standard-server-fastify';
+import { C as Context, R as Router } from '../../shared/server.B4BGqy3Y.mjs';
+import { b as StandardHandleOptions, f as StandardHandler } from '../../shared/server.DBCUJijK.mjs';
+import { F as FriendlyStandardHandleOptions } from '../../shared/server.CVKCo60T.mjs';
+import { S as StandardRPCHandlerOptions } from '../../shared/server.Ck-gOLzq.mjs';
+import '@orpc/client';
+import '@orpc/contract';
+import '@orpc/standard-server';
+import '@orpc/client/standard';
+import '../../shared/server.DzV1hr3z.mjs';
+
+type FastifyHandleResult = {
+    matched: true;
+} | {
+    matched: false;
+};
+interface FastifyInterceptorOptions<T extends Context> extends StandardHandleOptions<T> {
+    request: FastifyRequest;
+    reply: FastifyReply;
+    sendStandardResponseOptions: SendStandardResponseOptions;
+}
+interface FastifyHandlerOptions<T extends Context> extends SendStandardResponseOptions {
+    adapterInterceptors?: Interceptor<FastifyInterceptorOptions<T>, Promise<FastifyHandleResult>>[];
+}
+declare class FastifyHandler<T extends Context> {
+    private readonly standardHandler;
+    private readonly sendStandardResponseOptions;
+    private readonly adapterInterceptors;
+    constructor(standardHandler: StandardHandler<T>, options?: NoInfer<FastifyHandlerOptions<T>>);
+    handle(request: FastifyRequest, reply: FastifyReply, ...rest: MaybeOptionalOptions<FriendlyStandardHandleOptions<T>>): Promise<FastifyHandleResult>;
+}
+
+interface RPCHandlerOptions<T extends Context> extends FastifyHandlerOptions<T>, StandardRPCHandlerOptions<T> {
+    /**
+     * Enables or disables the StrictGetMethodPlugin.
+     *
+     * @default true
+     */
+    strictGetMethodPluginEnabled?: boolean;
+}
+/**
+ * RPC Handler for Fastify Server
+ *
+ * @see {@link https://orpc.unnoq.com/docs/rpc-handler RPC Handler Docs}
+ * @see {@link https://orpc.unnoq.com/docs/adapters/http HTTP Adapter Docs}
+ */
+declare class RPCHandler<T extends Context> extends FastifyHandler<T> {
+    constructor(router: Router<any, T>, options?: NoInfer<RPCHandlerOptions<T>>);
+}
+
+export { FastifyHandler, RPCHandler };
+export type { FastifyHandleResult, FastifyHandlerOptions, FastifyInterceptorOptions, RPCHandlerOptions };

package/dist/adapters/fastify/index.d.ts

@@ -0,0 +1,53 @@
+import { Interceptor, MaybeOptionalOptions } from '@orpc/shared';
+import { FastifyRequest, FastifyReply, SendStandardResponseOptions } from '@orpc/standard-server-fastify';
+import { C as Context, R as Router } from '../../shared/server.B4BGqy3Y.js';
+import { b as StandardHandleOptions, f as StandardHandler } from '../../shared/server.DPIFWpxG.js';
+import { F as FriendlyStandardHandleOptions } from '../../shared/server.DNtJ-p60.js';
+import { S as StandardRPCHandlerOptions } from '../../shared/server.COL12UTb.js';
+import '@orpc/client';
+import '@orpc/contract';
+import '@orpc/standard-server';
+import '@orpc/client/standard';
+import '../../shared/server.Cb6yD7DZ.js';
+
+type FastifyHandleResult = {
+    matched: true;
+} | {
+    matched: false;
+};
+interface FastifyInterceptorOptions<T extends Context> extends StandardHandleOptions<T> {
+    request: FastifyRequest;
+    reply: FastifyReply;
+    sendStandardResponseOptions: SendStandardResponseOptions;
+}
+interface FastifyHandlerOptions<T extends Context> extends SendStandardResponseOptions {
+    adapterInterceptors?: Interceptor<FastifyInterceptorOptions<T>, Promise<FastifyHandleResult>>[];
+}
+declare class FastifyHandler<T extends Context> {
+    private readonly standardHandler;
+    private readonly sendStandardResponseOptions;
+    private readonly adapterInterceptors;
+    constructor(standardHandler: StandardHandler<T>, options?: NoInfer<FastifyHandlerOptions<T>>);
+    handle(request: FastifyRequest, reply: FastifyReply, ...rest: MaybeOptionalOptions<FriendlyStandardHandleOptions<T>>): Promise<FastifyHandleResult>;
+}
+
+interface RPCHandlerOptions<T extends Context> extends FastifyHandlerOptions<T>, StandardRPCHandlerOptions<T> {
+    /**
+     * Enables or disables the StrictGetMethodPlugin.
+     *
+     * @default true
+     */
+    strictGetMethodPluginEnabled?: boolean;
+}
+/**
+ * RPC Handler for Fastify Server
+ *
+ * @see {@link https://orpc.unnoq.com/docs/rpc-handler RPC Handler Docs}
+ * @see {@link https://orpc.unnoq.com/docs/adapters/http HTTP Adapter Docs}
+ */
+declare class RPCHandler<T extends Context> extends FastifyHandler<T> {
+    constructor(router: Router<any, T>, options?: NoInfer<RPCHandlerOptions<T>>);
+}
+
+export { FastifyHandler, RPCHandler };
+export type { FastifyHandleResult, FastifyHandlerOptions, FastifyInterceptorOptions, RPCHandlerOptions };

package/dist/adapters/fastify/index.mjs

@@ -0,0 +1,54 @@
+import { toArray, intercept, resolveMaybeOptionalOptions } from '@orpc/shared';
+import { toStandardLazyRequest, sendStandardResponse } from '@orpc/standard-server-fastify';
+import { r as resolveFriendlyStandardHandleOptions } from '../../shared/server.DZ5BIITo.mjs';
+import '@orpc/standard-server';
+import '@orpc/standard-server/batch';
+import '@orpc/standard-server-fetch';
+import '@orpc/client';
+import { S as StrictGetMethodPlugin } from '../../shared/server.TEVCLCFC.mjs';
+import '@orpc/contract';
+import { b as StandardRPCHandler } from '../../shared/server.Bxx6tqNe.mjs';
+import '@orpc/client/standard';
+import '../../shared/server.Ds4HPpvH.mjs';
+
+class FastifyHandler {
+  constructor(standardHandler, options = {}) {
+    this.standardHandler = standardHandler;
+    this.adapterInterceptors = toArray(options.adapterInterceptors);
+    this.sendStandardResponseOptions = options;
+  }
+  sendStandardResponseOptions;
+  adapterInterceptors;
+  async handle(request, reply, ...rest) {
+    return intercept(
+      this.adapterInterceptors,
+      {
+        ...resolveFriendlyStandardHandleOptions(resolveMaybeOptionalOptions(rest)),
+        request,
+        reply,
+        sendStandardResponseOptions: this.sendStandardResponseOptions
+      },
+      async ({ request: request2, reply: reply2, sendStandardResponseOptions, ...options }) => {
+        const standardRequest = toStandardLazyRequest(request2, reply2);
+        const result = await this.standardHandler.handle(standardRequest, options);
+        if (!result.matched) {
+          return { matched: false };
+        }
+        await sendStandardResponse(reply2, result.response, sendStandardResponseOptions);
+        return { matched: true };
+      }
+    );
+  }
+}
+
+class RPCHandler extends FastifyHandler {
+  constructor(router, options = {}) {
+    if (options.strictGetMethodPluginEnabled ?? true) {
+      options.plugins ??= [];
+      options.plugins.push(new StrictGetMethodPlugin());
+    }
+    super(new StandardRPCHandler(router, options), options);
+  }
+}
+
+export { FastifyHandler, RPCHandler };

package/dist/adapters/message-port/index.d.mts

@@ -1,5 +1,6 @@
 import { SupportedMessagePort } from '@orpc/client/message-port';
-import { MaybeOptionalOptions } from '@orpc/shared';
+import { Value, Promisable, MaybeOptionalOptions } from '@orpc/shared';
+import { DecodedResponseMessage } from '@orpc/standard-server-peer';
 import { C as Context, R as Router } from '../../shared/server.B4BGqy3Y.mjs';
 import { f as StandardHandler } from '../../shared/server.DBCUJijK.mjs';
 import { HandleStandardServerPeerMessageOptions } from '../standard-peer/index.mjs';
@@ -7,17 +8,41 @@ import { S as StandardRPCHandlerOptions } from '../../shared/server.Ck-gOLzq.mjs
 import '@orpc/client';
 import '@orpc/contract';
 import '@orpc/standard-server';
-import '@orpc/standard-server-peer';
 import '../../shared/server.CVKCo60T.mjs';
 import '@orpc/client/standard';
 import '../../shared/server.DzV1hr3z.mjs';
 
+interface MessagePortHandlerOptions<_T extends Context> {
+    /**
+     * By default, oRPC serializes request/response messages to string/binary data before sending over message port.
+     * If needed, you can define the this option to utilize full power of [MessagePort: postMessage() method](https://developer.mozilla.org/en-US/docs/Web/API/MessagePort/postMessage),
+     * such as transferring ownership of objects to the other side or support unserializable objects like `OffscreenCanvas`.
+     *
+     * @remarks
+     * - return null | undefined to disable this feature
+     *
+     * @warning Make sure your message port supports `transfer` before using this feature.
+     * @example
+     * ```ts
+     * experimental_transfer: (message, port) => {
+     *   const transfer = deepFindTransferableObjects(message) // implement your own logic
+     *   return transfer.length ? transfer : null // only enable when needed
+     * }
+     * ```
+     *
+     * @see {@link https://orpc.unnoq.com/docs/adapters/message-port#transfer Message Port Transfer Docs}
+     */
+    experimental_transfer?: Value<Promisable<object[] | null | undefined>, [message: DecodedResponseMessage, port: SupportedMessagePort]>;
+}
 declare class MessagePortHandler<T extends Context> {
     private readonly standardHandler;
-    constructor(standardHandler: StandardHandler<T>);
+    private readonly transfer;
+    constructor(standardHandler: StandardHandler<T>, options?: NoInfer<MessagePortHandlerOptions<T>>);
     upgrade(port: SupportedMessagePort, ...rest: MaybeOptionalOptions<HandleStandardServerPeerMessageOptions<T>>): void;
 }
 
+interface RPCHandlerOptions<T extends Context> extends StandardRPCHandlerOptions<T>, MessagePortHandlerOptions<T> {
+}
 /**
  * RPC Handler for common message port implementations.
  *
@@ -25,7 +50,8 @@ declare class MessagePortHandler<T extends Context> {
  * @see {@link https://orpc.unnoq.com/docs/adapters/message-port Message Port Adapter Docs}
  */
 declare class RPCHandler<T extends Context> extends MessagePortHandler<T> {
-    constructor(router: Router<any, T>, options?: NoInfer<StandardRPCHandlerOptions<T>>);
+    constructor(router: Router<any, T>, options?: NoInfer<RPCHandlerOptions<T>>);
 }
 
 export { MessagePortHandler, RPCHandler };
+export type { MessagePortHandlerOptions, RPCHandlerOptions };

package/dist/adapters/message-port/index.d.ts

@@ -1,5 +1,6 @@
 import { SupportedMessagePort } from '@orpc/client/message-port';
-import { MaybeOptionalOptions } from '@orpc/shared';
+import { Value, Promisable, MaybeOptionalOptions } from '@orpc/shared';
+import { DecodedResponseMessage } from '@orpc/standard-server-peer';
 import { C as Context, R as Router } from '../../shared/server.B4BGqy3Y.js';
 import { f as StandardHandler } from '../../shared/server.DPIFWpxG.js';
 import { HandleStandardServerPeerMessageOptions } from '../standard-peer/index.js';
@@ -7,17 +8,41 @@ import { S as StandardRPCHandlerOptions } from '../../shared/server.COL12UTb.js'
 import '@orpc/client';
 import '@orpc/contract';
 import '@orpc/standard-server';
-import '@orpc/standard-server-peer';
 import '../../shared/server.DNtJ-p60.js';
 import '@orpc/client/standard';
 import '../../shared/server.Cb6yD7DZ.js';
 
+interface MessagePortHandlerOptions<_T extends Context> {
+    /**
+     * By default, oRPC serializes request/response messages to string/binary data before sending over message port.
+     * If needed, you can define the this option to utilize full power of [MessagePort: postMessage() method](https://developer.mozilla.org/en-US/docs/Web/API/MessagePort/postMessage),
+     * such as transferring ownership of objects to the other side or support unserializable objects like `OffscreenCanvas`.
+     *
+     * @remarks
+     * - return null | undefined to disable this feature
+     *
+     * @warning Make sure your message port supports `transfer` before using this feature.
+     * @example
+     * ```ts
+     * experimental_transfer: (message, port) => {
+     *   const transfer = deepFindTransferableObjects(message) // implement your own logic
+     *   return transfer.length ? transfer : null // only enable when needed
+     * }
+     * ```
+     *
+     * @see {@link https://orpc.unnoq.com/docs/adapters/message-port#transfer Message Port Transfer Docs}
+     */
+    experimental_transfer?: Value<Promisable<object[] | null | undefined>, [message: DecodedResponseMessage, port: SupportedMessagePort]>;
+}
 declare class MessagePortHandler<T extends Context> {
     private readonly standardHandler;
-    constructor(standardHandler: StandardHandler<T>);
+    private readonly transfer;
+    constructor(standardHandler: StandardHandler<T>, options?: NoInfer<MessagePortHandlerOptions<T>>);
     upgrade(port: SupportedMessagePort, ...rest: MaybeOptionalOptions<HandleStandardServerPeerMessageOptions<T>>): void;
 }
 
+interface RPCHandlerOptions<T extends Context> extends StandardRPCHandlerOptions<T>, MessagePortHandlerOptions<T> {
+}
 /**
  * RPC Handler for common message port implementations.
  *
@@ -25,7 +50,8 @@ declare class MessagePortHandler<T extends Context> {
  * @see {@link https://orpc.unnoq.com/docs/adapters/message-port Message Port Adapter Docs}
  */
 declare class RPCHandler<T extends Context> extends MessagePortHandler<T> {
-    constructor(router: Router<any, T>, options?: NoInfer<StandardRPCHandlerOptions<T>>);
+    constructor(router: Router<any, T>, options?: NoInfer<RPCHandlerOptions<T>>);
 }
 
 export { MessagePortHandler, RPCHandler };
+export type { MessagePortHandlerOptions, RPCHandlerOptions };

package/dist/adapters/message-port/index.mjs

@@ -1,6 +1,6 @@
 import { postMessagePortMessage, onMessagePortMessage, onMessagePortClose } from '@orpc/client/message-port';
-import { resolveMaybeOptionalOptions } from '@orpc/shared';
-import { ServerPeer } from '@orpc/standard-server-peer';
+import { value, resolveMaybeOptionalOptions, isObject } from '@orpc/shared';
+import { experimental_ServerPeerWithoutCodec, serializeResponseMessage, encodeResponseMessage, deserializeRequestMessage, decodeRequestMessage } from '@orpc/standard-server-peer';
 import { c as createServerPeerHandleRequestFn } from '../../shared/server.UVMTOWrk.mjs';
 import '@orpc/client';
 import '@orpc/standard-server';
@@ -11,18 +11,34 @@ import '../../shared/server.DZ5BIITo.mjs';
 import '../../shared/server.Ds4HPpvH.mjs';
 
 class MessagePortHandler {
-  constructor(standardHandler) {
+  constructor(standardHandler, options = {}) {
     this.standardHandler = standardHandler;
+    this.transfer = options.experimental_transfer;
   }
+  transfer;
   upgrade(port, ...rest) {
-    const peer = new ServerPeer((message) => {
-      return postMessagePortMessage(port, message);
+    const peer = new experimental_ServerPeerWithoutCodec(async (message) => {
+      const [id, type, payload] = message;
+      const transfer = await value(this.transfer, message, port);
+      if (transfer) {
+        postMessagePortMessage(port, serializeResponseMessage(id, type, payload), transfer);
+      } else {
+        postMessagePortMessage(port, await encodeResponseMessage(id, type, payload));
+      }
     });
     onMessagePortMessage(port, async (message) => {
-      await peer.message(
-        message,
-        createServerPeerHandleRequestFn(this.standardHandler, resolveMaybeOptionalOptions(rest))
-      );
+      const handleFn = createServerPeerHandleRequestFn(this.standardHandler, resolveMaybeOptionalOptions(rest));
+      if (isObject(message)) {
+        await peer.message(
+          deserializeRequestMessage(message),
+          handleFn
+        );
+      } else {
+        await peer.message(
+          await decodeRequestMessage(message),
+          handleFn
+        );
+      }
     });
     onMessagePortClose(port, () => {
       peer.close();
@@ -32,7 +48,7 @@ class MessagePortHandler {
 
 class RPCHandler extends MessagePortHandler {
   constructor(router, options = {}) {
-    super(new StandardRPCHandler(router, options));
+    super(new StandardRPCHandler(router, options), options);
   }
 }
 

package/dist/adapters/node/index.d.mts

@@ -32,7 +32,7 @@ interface NodeHttpHandlerOptions<T extends Context> extends SendStandardResponse
     adapterInterceptors?: Interceptor<NodeHttpHandlerInterceptorOptions<T>, Promise<NodeHttpHandleResult>>[];
     plugins?: NodeHttpHandlerPlugin<T>[];
 }
-declare class NodeHttpHandler<T extends Context> implements NodeHttpHandler<T> {
+declare class NodeHttpHandler<T extends Context> {
     private readonly standardHandler;
     private readonly sendStandardResponseOptions;
     private readonly adapterInterceptors;

package/dist/adapters/node/index.d.ts

@@ -32,7 +32,7 @@ interface NodeHttpHandlerOptions<T extends Context> extends SendStandardResponse
     adapterInterceptors?: Interceptor<NodeHttpHandlerInterceptorOptions<T>, Promise<NodeHttpHandleResult>>[];
     plugins?: NodeHttpHandlerPlugin<T>[];
 }
-declare class NodeHttpHandler<T extends Context> implements NodeHttpHandler<T> {
+declare class NodeHttpHandler<T extends Context> {
     private readonly standardHandler;
     private readonly sendStandardResponseOptions;
     private readonly adapterInterceptors;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@orpc/server",
   "type": "module",
-  "version": "1.10.0",
+  "version": "1.10.2",
   "license": "MIT",
   "homepage": "https://orpc.unnoq.com",
   "repository": {
@@ -54,6 +54,11 @@
       "import": "./dist/adapters/node/index.mjs",
       "default": "./dist/adapters/node/index.mjs"
     },
+    "./fastify": {
+      "types": "./dist/adapters/fastify/index.d.mts",
+      "import": "./dist/adapters/fastify/index.mjs",
+      "default": "./dist/adapters/fastify/index.mjs"
+    },
     "./aws-lambda": {
       "types": "./dist/adapters/aws-lambda/index.d.mts",
       "import": "./dist/adapters/aws-lambda/index.mjs",
@@ -102,20 +107,22 @@
   },
   "dependencies": {
     "cookie": "^1.0.2",
-    "@orpc/client": "1.10.0",
-    "@orpc/contract": "1.10.0",
-    "@orpc/shared": "1.10.0",
-    "@orpc/interop": "1.10.0",
-    "@orpc/standard-server": "1.10.0",
-    "@orpc/standard-server-aws-lambda": "1.10.0",
-    "@orpc/standard-server-fetch": "1.10.0",
-    "@orpc/standard-server-node": "1.10.0",
-    "@orpc/standard-server-peer": "1.10.0"
+    "@orpc/client": "1.10.2",
+    "@orpc/contract": "1.10.2",
+    "@orpc/shared": "1.10.2",
+    "@orpc/standard-server": "1.10.2",
+    "@orpc/standard-server-fastify": "1.10.2",
+    "@orpc/standard-server-aws-lambda": "1.10.2",
+    "@orpc/interop": "1.10.2",
+    "@orpc/standard-server-fetch": "1.10.2",
+    "@orpc/standard-server-node": "1.10.2",
+    "@orpc/standard-server-peer": "1.10.2"
   },
   "devDependencies": {
-    "@tanstack/router-core": "^1.133.3",
+    "@tanstack/router-core": "^1.133.20",
     "@types/ws": "^8.18.1",
     "crossws": "^0.4.1",
+    "fastify": "^5.6.1",
     "next": "^15.5.6",
     "supertest": "^7.1.4",
     "ws": "^8.18.3",