@orpc/server 1.14.5 → 2.0.0-beta.1

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

@@ -1,68 +1,78 @@
-import { C as Context, R as Router } from '../../shared/server.qKsRrdxW.mjs';
+import { C as Context } from '../../shared/server.BL22TloH.mjs';
 import { Interceptor, MaybeOptionalOptions } from '@orpc/shared';
-import { ToFetchResponseOptions } from '@orpc/standard-server-fetch';
-import { F as FriendlyStandardHandleOptions } from '../../shared/server.B8gYOD5g.mjs';
-import { g as StandardHandlerPlugin, C as CompositeStandardHandlerPlugin, b as StandardHandleOptions, f as StandardHandler } from '../../shared/server.BqadksTP.mjs';
-import { S as StandardRPCHandlerOptions } from '../../shared/server.ChUyt5-i.mjs';
+import { ToFetchResponseOptions } from '@standardserver/fetch';
+import { e as StandardHandlerPlugin, b as StandardHandlerHandleOptions, S as StandardHandler, a as StandardHandlerOptions } from '../../shared/server.BB_Ik9Ph.mjs';
+import { FriendlyStandardHandlerHandleOptions } from '../standard/index.mjs';
+import { R as Router } from '../../shared/server.BsNNjG5J.mjs';
+import { R as RPCHandlerCodecOptions } from '../../shared/server.B_U9y00a.mjs';
 import '@orpc/client';
 import '@orpc/contract';
-import '@orpc/standard-server';
-import '@orpc/client/standard';
-import '../../shared/server.C8_sRzQB.mjs';
+import '@standardserver/core';
 
 interface FetchHandlerPlugin<T extends Context> extends StandardHandlerPlugin<T> {
-    initRuntimeAdapter?(options: FetchHandlerOptions<T>): void;
+    /**
+     * Initializes the plugin and returns new fetch handler options.
+     * Called once per plugin instance during composition.
+     *
+     * This method allows plugins to wrap, extend, or transform fetch handler options
+     * such as fetch interceptors, or fetch configuration.
+     *
+     * @param options - The current handler options from previous plugins or base configuration
+     * @returns Transformed handler options with plugin's modifications applied
+     *
+     * @example
+     * ```ts
+     * initFetchHandlerOptions(options) {
+     *   return {
+     *     ...options,
+     *     interceptors: [...(options.interceptors || []), myInterceptor]
+     *   }
+     * }
+     * ```
+     */
+    initFetchHandlerOptions?(options: FetchHandlerOptions<T>): FetchHandlerOptions<T>;
 }
-declare class CompositeFetchHandlerPlugin<T extends Context, TPlugin extends FetchHandlerPlugin<T>> extends CompositeStandardHandlerPlugin<T, TPlugin> implements FetchHandlerPlugin<T> {
-    initRuntimeAdapter(options: FetchHandlerOptions<T>): void;
+declare class CompositeFetchHandlerPlugin<T extends Context> implements FetchHandlerPlugin<T> {
+    readonly name = "~composite/fetch-handler";
+    protected readonly plugins: FetchHandlerPlugin<T>[];
+    constructor(plugins?: FetchHandlerPlugin<T>[]);
+    initFetchHandlerOptions(options: FetchHandlerOptions<T>): FetchHandlerOptions<T>;
 }
 
-type FetchHandleResult = {
+type FetchHandlerHandleResult = {
     matched: true;
     response: Response;
 } | {
     matched: false;
-    response: undefined;
+    response?: undefined;
 };
-interface FetchHandlerInterceptorOptions<T extends Context> extends StandardHandleOptions<T> {
+interface FetchHandlerFetchInterceptorOptions<T extends Context> extends StandardHandlerHandleOptions<T> {
     request: Request;
-    toFetchResponseOptions: ToFetchResponseOptions;
+    toFetchResponseOptions: ToFetchResponseOptions | undefined;
 }
-interface FetchHandlerOptions<T extends Context> extends ToFetchResponseOptions {
-    adapterInterceptors?: Interceptor<FetchHandlerInterceptorOptions<T>, Promise<FetchHandleResult>>[];
-    plugins?: FetchHandlerPlugin<T>[];
+type FetchHandlerFetchInterceptor<T extends Context> = Interceptor<FetchHandlerFetchInterceptorOptions<T>, Promise<FetchHandlerHandleResult>>;
+interface FetchHandlerOptions<T extends Context> {
+    /**
+     * Custom options for `toFetchResponse`, used to map a `Standard Response` to a `Fetch Response`.
+     */
+    toFetchResponse?: ToFetchResponseOptions;
+    /**
+     * Interceptors that run before the mapping between the Standard API and Fetch API,
+     * useful for customizing the mapping behavior (e.g. extending the body parser).
+     */
+    fetchInterceptors?: FetchHandlerFetchInterceptor<T>[] | undefined;
+    plugins?: FetchHandlerPlugin<T>[] | undefined;
 }
 declare class FetchHandler<T extends Context> {
     private readonly standardHandler;
     private readonly toFetchResponseOptions;
-    private readonly adapterInterceptors;
+    private readonly fetchInterceptors;
     constructor(standardHandler: StandardHandler<T>, options?: NoInfer<FetchHandlerOptions<T>>);
-    handle(request: Request, ...rest: MaybeOptionalOptions<FriendlyStandardHandleOptions<T>>): Promise<FetchHandleResult>;
+    handle(request: Request, ...rest: MaybeOptionalOptions<FriendlyStandardHandlerHandleOptions<T>>): Promise<FetchHandlerHandleResult>;
 }
 
-interface BodyLimitPluginOptions {
-    /**
-     * The maximum size of the body in bytes.
-     */
-    maxBodySize: number;
-}
-/**
- * The Body Limit Plugin restricts the size of the request body for the Fetch Server.
- *
- * @see {@link https://orpc.dev/docs/plugins/body-limit Body Limit Plugin Docs}
- */
-declare class BodyLimitPlugin<T extends Context> implements FetchHandlerPlugin<T> {
-    private readonly maxBodySize;
-    constructor(options: BodyLimitPluginOptions);
-    initRuntimeAdapter(options: FetchHandlerOptions<T>): void;
-}
-
-/**
- * This plugin is heavily inspired by the [Hono Compression Plugin](https://github.com/honojs/hono/blob/main/src/middleware/compress/index.ts)
- */
-
 declare const ORDERED_SUPPORTED_ENCODINGS: readonly ["gzip", "deflate"];
-interface CompressionPluginOptions {
+interface BodyCompressionHandlerPluginOptions {
     /**
      * The compression schemes to use for response compression.
      * Schemes are prioritized by their order in this array and
@@ -82,43 +92,49 @@ interface CompressionPluginOptions {
     /**
      * Override the default content-type filter used to determine which responses should be compressed.
      *
-     * @warning [Event Iterator](https://orpc.dev/docs/event-iterator) responses are never compressed, regardless of this filter's return value.
+     * @warning Event stream responses are never compressed, regardless of this filter's return value.
      * @default only responses with compressible content types are compressed.
      */
     filter?: (request: Request, response: Response) => boolean;
 }
-/**
- * The Compression Plugin adds response compression to the Fetch Server.
- * Build on top of [CompressionStream](https://developer.mozilla.org/en-US/docs/Web/API/CompressionStream)
- * You might need to polyfill it if your environment does not support it.
- *
- * @see {@link https://orpc.dev/docs/plugins/compression Compression Plugin Docs}
- */
-declare class CompressionPlugin<T extends Context> implements FetchHandlerPlugin<T> {
+declare class BodyCompressionHandlerPlugin<T extends Context> implements FetchHandlerPlugin<T> {
+    name: string;
     private readonly encodings;
     private readonly threshold;
     private readonly filter;
-    constructor(options?: CompressionPluginOptions);
-    initRuntimeAdapter(options: FetchHandlerOptions<T>): void;
+    constructor(options?: BodyCompressionHandlerPluginOptions);
+    initFetchHandlerOptions(options: FetchHandlerOptions<T>): FetchHandlerOptions<T>;
 }
 
-interface RPCHandlerOptions<T extends Context> extends FetchHandlerOptions<T>, Omit<StandardRPCHandlerOptions<T>, 'plugins'> {
+interface BodyLimitHandlerPluginOptions {
     /**
-     * Enables or disables the StrictGetMethodPlugin.
-     *
-     * @default true
+     * The maximum size of the body in bytes.
+     */
+    maxBodySize: number;
+}
+declare class BodyLimitHandlerPlugin<T extends Context> implements FetchHandlerPlugin<T> {
+    name: string;
+    private readonly maxBodySize;
+    constructor(options: BodyLimitHandlerPluginOptions);
+    initFetchHandlerOptions(options: FetchHandlerOptions<T>): FetchHandlerOptions<T>;
+}
+
+interface RPCHandlerOptions<T extends Context> extends FetchHandlerOptions<T>, Omit<StandardHandlerOptions<T>, 'plugins'>, RPCHandlerCodecOptions<T> {
+    /**
+     * Configuration for {@link CSRFGuardHandlerPlugin}, which is enabled by default for `RPCHandler` over HTTP.
      */
-    strictGetMethodPluginEnabled?: boolean;
+    csrfGuardHandlerPlugin?: {
+        /**
+         * If `false`, this plugin is disabled.
+         *
+         * @default true
+         */
+        enabled?: boolean;
+    };
 }
-/**
- * RPC Handler for Fetch Server
- *
- * @see {@link https://orpc.dev/docs/rpc-handler RPC Handler Docs}
- * @see {@link https://orpc.dev/docs/adapters/http HTTP Adapter Docs}
- */
 declare class RPCHandler<T extends Context> extends FetchHandler<T> {
-    constructor(router: Router<any, T>, options?: NoInfer<RPCHandlerOptions<T>>);
+    constructor(router: Router<T>, options?: NoInfer<RPCHandlerOptions<T>>);
 }
 
-export { BodyLimitPlugin, CompositeFetchHandlerPlugin, CompressionPlugin, FetchHandler, RPCHandler };
-export type { BodyLimitPluginOptions, CompressionPluginOptions, FetchHandleResult, FetchHandlerInterceptorOptions, FetchHandlerOptions, FetchHandlerPlugin, RPCHandlerOptions };
+export { BodyCompressionHandlerPlugin, BodyLimitHandlerPlugin, CompositeFetchHandlerPlugin, FetchHandler, RPCHandler };
+export type { BodyCompressionHandlerPluginOptions, BodyLimitHandlerPluginOptions, FetchHandlerFetchInterceptor, FetchHandlerFetchInterceptorOptions, FetchHandlerHandleResult, FetchHandlerOptions, FetchHandlerPlugin, RPCHandlerOptions };

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

@@ -1,68 +1,78 @@
-import { C as Context, R as Router } from '../../shared/server.qKsRrdxW.js';
+import { C as Context } from '../../shared/server.BL22TloH.js';
 import { Interceptor, MaybeOptionalOptions } from '@orpc/shared';
-import { ToFetchResponseOptions } from '@orpc/standard-server-fetch';
-import { F as FriendlyStandardHandleOptions } from '../../shared/server.EfTOZ2Q7.js';
-import { g as StandardHandlerPlugin, C as CompositeStandardHandlerPlugin, b as StandardHandleOptions, f as StandardHandler } from '../../shared/server.7cEtMB30.js';
-import { S as StandardRPCHandlerOptions } from '../../shared/server.yoEB3Fx4.js';
+import { ToFetchResponseOptions } from '@standardserver/fetch';
+import { e as StandardHandlerPlugin, b as StandardHandlerHandleOptions, S as StandardHandler, a as StandardHandlerOptions } from '../../shared/server.EOHJ3NJr.js';
+import { FriendlyStandardHandlerHandleOptions } from '../standard/index.js';
+import { R as Router } from '../../shared/server.Pa0F03f_.js';
+import { R as RPCHandlerCodecOptions } from '../../shared/server.T9F3bzZx.js';
 import '@orpc/client';
 import '@orpc/contract';
-import '@orpc/standard-server';
-import '@orpc/client/standard';
-import '../../shared/server.ChyoA9XY.js';
+import '@standardserver/core';
 
 interface FetchHandlerPlugin<T extends Context> extends StandardHandlerPlugin<T> {
-    initRuntimeAdapter?(options: FetchHandlerOptions<T>): void;
+    /**
+     * Initializes the plugin and returns new fetch handler options.
+     * Called once per plugin instance during composition.
+     *
+     * This method allows plugins to wrap, extend, or transform fetch handler options
+     * such as fetch interceptors, or fetch configuration.
+     *
+     * @param options - The current handler options from previous plugins or base configuration
+     * @returns Transformed handler options with plugin's modifications applied
+     *
+     * @example
+     * ```ts
+     * initFetchHandlerOptions(options) {
+     *   return {
+     *     ...options,
+     *     interceptors: [...(options.interceptors || []), myInterceptor]
+     *   }
+     * }
+     * ```
+     */
+    initFetchHandlerOptions?(options: FetchHandlerOptions<T>): FetchHandlerOptions<T>;
 }
-declare class CompositeFetchHandlerPlugin<T extends Context, TPlugin extends FetchHandlerPlugin<T>> extends CompositeStandardHandlerPlugin<T, TPlugin> implements FetchHandlerPlugin<T> {
-    initRuntimeAdapter(options: FetchHandlerOptions<T>): void;
+declare class CompositeFetchHandlerPlugin<T extends Context> implements FetchHandlerPlugin<T> {
+    readonly name = "~composite/fetch-handler";
+    protected readonly plugins: FetchHandlerPlugin<T>[];
+    constructor(plugins?: FetchHandlerPlugin<T>[]);
+    initFetchHandlerOptions(options: FetchHandlerOptions<T>): FetchHandlerOptions<T>;
 }
 
-type FetchHandleResult = {
+type FetchHandlerHandleResult = {
     matched: true;
     response: Response;
 } | {
     matched: false;
-    response: undefined;
+    response?: undefined;
 };
-interface FetchHandlerInterceptorOptions<T extends Context> extends StandardHandleOptions<T> {
+interface FetchHandlerFetchInterceptorOptions<T extends Context> extends StandardHandlerHandleOptions<T> {
     request: Request;
-    toFetchResponseOptions: ToFetchResponseOptions;
+    toFetchResponseOptions: ToFetchResponseOptions | undefined;
 }
-interface FetchHandlerOptions<T extends Context> extends ToFetchResponseOptions {
-    adapterInterceptors?: Interceptor<FetchHandlerInterceptorOptions<T>, Promise<FetchHandleResult>>[];
-    plugins?: FetchHandlerPlugin<T>[];
+type FetchHandlerFetchInterceptor<T extends Context> = Interceptor<FetchHandlerFetchInterceptorOptions<T>, Promise<FetchHandlerHandleResult>>;
+interface FetchHandlerOptions<T extends Context> {
+    /**
+     * Custom options for `toFetchResponse`, used to map a `Standard Response` to a `Fetch Response`.
+     */
+    toFetchResponse?: ToFetchResponseOptions;
+    /**
+     * Interceptors that run before the mapping between the Standard API and Fetch API,
+     * useful for customizing the mapping behavior (e.g. extending the body parser).
+     */
+    fetchInterceptors?: FetchHandlerFetchInterceptor<T>[] | undefined;
+    plugins?: FetchHandlerPlugin<T>[] | undefined;
 }
 declare class FetchHandler<T extends Context> {
     private readonly standardHandler;
     private readonly toFetchResponseOptions;
-    private readonly adapterInterceptors;
+    private readonly fetchInterceptors;
     constructor(standardHandler: StandardHandler<T>, options?: NoInfer<FetchHandlerOptions<T>>);
-    handle(request: Request, ...rest: MaybeOptionalOptions<FriendlyStandardHandleOptions<T>>): Promise<FetchHandleResult>;
+    handle(request: Request, ...rest: MaybeOptionalOptions<FriendlyStandardHandlerHandleOptions<T>>): Promise<FetchHandlerHandleResult>;
 }
 
-interface BodyLimitPluginOptions {
-    /**
-     * The maximum size of the body in bytes.
-     */
-    maxBodySize: number;
-}
-/**
- * The Body Limit Plugin restricts the size of the request body for the Fetch Server.
- *
- * @see {@link https://orpc.dev/docs/plugins/body-limit Body Limit Plugin Docs}
- */
-declare class BodyLimitPlugin<T extends Context> implements FetchHandlerPlugin<T> {
-    private readonly maxBodySize;
-    constructor(options: BodyLimitPluginOptions);
-    initRuntimeAdapter(options: FetchHandlerOptions<T>): void;
-}
-
-/**
- * This plugin is heavily inspired by the [Hono Compression Plugin](https://github.com/honojs/hono/blob/main/src/middleware/compress/index.ts)
- */
-
 declare const ORDERED_SUPPORTED_ENCODINGS: readonly ["gzip", "deflate"];
-interface CompressionPluginOptions {
+interface BodyCompressionHandlerPluginOptions {
     /**
      * The compression schemes to use for response compression.
      * Schemes are prioritized by their order in this array and
@@ -82,43 +92,49 @@ interface CompressionPluginOptions {
     /**
      * Override the default content-type filter used to determine which responses should be compressed.
      *
-     * @warning [Event Iterator](https://orpc.dev/docs/event-iterator) responses are never compressed, regardless of this filter's return value.
+     * @warning Event stream responses are never compressed, regardless of this filter's return value.
      * @default only responses with compressible content types are compressed.
      */
     filter?: (request: Request, response: Response) => boolean;
 }
-/**
- * The Compression Plugin adds response compression to the Fetch Server.
- * Build on top of [CompressionStream](https://developer.mozilla.org/en-US/docs/Web/API/CompressionStream)
- * You might need to polyfill it if your environment does not support it.
- *
- * @see {@link https://orpc.dev/docs/plugins/compression Compression Plugin Docs}
- */
-declare class CompressionPlugin<T extends Context> implements FetchHandlerPlugin<T> {
+declare class BodyCompressionHandlerPlugin<T extends Context> implements FetchHandlerPlugin<T> {
+    name: string;
     private readonly encodings;
     private readonly threshold;
     private readonly filter;
-    constructor(options?: CompressionPluginOptions);
-    initRuntimeAdapter(options: FetchHandlerOptions<T>): void;
+    constructor(options?: BodyCompressionHandlerPluginOptions);
+    initFetchHandlerOptions(options: FetchHandlerOptions<T>): FetchHandlerOptions<T>;
 }
 
-interface RPCHandlerOptions<T extends Context> extends FetchHandlerOptions<T>, Omit<StandardRPCHandlerOptions<T>, 'plugins'> {
+interface BodyLimitHandlerPluginOptions {
     /**
-     * Enables or disables the StrictGetMethodPlugin.
-     *
-     * @default true
+     * The maximum size of the body in bytes.
+     */
+    maxBodySize: number;
+}
+declare class BodyLimitHandlerPlugin<T extends Context> implements FetchHandlerPlugin<T> {
+    name: string;
+    private readonly maxBodySize;
+    constructor(options: BodyLimitHandlerPluginOptions);
+    initFetchHandlerOptions(options: FetchHandlerOptions<T>): FetchHandlerOptions<T>;
+}
+
+interface RPCHandlerOptions<T extends Context> extends FetchHandlerOptions<T>, Omit<StandardHandlerOptions<T>, 'plugins'>, RPCHandlerCodecOptions<T> {
+    /**
+     * Configuration for {@link CSRFGuardHandlerPlugin}, which is enabled by default for `RPCHandler` over HTTP.
      */
-    strictGetMethodPluginEnabled?: boolean;
+    csrfGuardHandlerPlugin?: {
+        /**
+         * If `false`, this plugin is disabled.
+         *
+         * @default true
+         */
+        enabled?: boolean;
+    };
 }
-/**
- * RPC Handler for Fetch Server
- *
- * @see {@link https://orpc.dev/docs/rpc-handler RPC Handler Docs}
- * @see {@link https://orpc.dev/docs/adapters/http HTTP Adapter Docs}
- */
 declare class RPCHandler<T extends Context> extends FetchHandler<T> {
-    constructor(router: Router<any, T>, options?: NoInfer<RPCHandlerOptions<T>>);
+    constructor(router: Router<T>, options?: NoInfer<RPCHandlerOptions<T>>);
 }
 
-export { BodyLimitPlugin, CompositeFetchHandlerPlugin, CompressionPlugin, FetchHandler, RPCHandler };
-export type { BodyLimitPluginOptions, CompressionPluginOptions, FetchHandleResult, FetchHandlerInterceptorOptions, FetchHandlerOptions, FetchHandlerPlugin, RPCHandlerOptions };
+export { BodyCompressionHandlerPlugin, BodyLimitHandlerPlugin, CompositeFetchHandlerPlugin, FetchHandler, RPCHandler };
+export type { BodyCompressionHandlerPluginOptions, BodyLimitHandlerPluginOptions, FetchHandlerFetchInterceptor, FetchHandlerFetchInterceptorOptions, FetchHandlerHandleResult, FetchHandlerOptions, FetchHandlerPlugin, RPCHandlerOptions };