@orpc/client 0.20.0 → 0.22.0

package/dist/fetch.js

@@ -3,27 +3,32 @@ import { ORPCPayloadCodec } from "@orpc/server/fetch";
 import { ORPC_HANDLER_HEADER, ORPC_HANDLER_VALUE, trim } from "@orpc/shared";
 import { ORPCError } from "@orpc/shared/error";
 var ORPCLink = class {
+  fetch;
+  payloadCodec;
+  maxURLLength;
+  fallbackMethod;
+  getMethod;
+  getHeaders;
+  url;
   constructor(options) {
-    this.options = options;
     this.fetch = options.fetch ?? globalThis.fetch.bind(globalThis);
     this.payloadCodec = options.payloadCodec ?? new ORPCPayloadCodec();
+    this.maxURLLength = options.maxURLLength ?? 2083;
+    this.fallbackMethod = options.fallbackMethod ?? "POST";
+    this.url = options.url;
+    this.getMethod = async (path, input, context) => {
+      return await options.method?.(path, input, context) ?? this.fallbackMethod;
+    };
+    this.getHeaders = async (path, input, context) => {
+      return new Headers(await options.headers?.(path, input, context));
+    };
   }
-  fetch;
-  payloadCodec;
   async call(path, input, options) {
-    const url = `${trim(this.options.url, "/")}/${path.map(encodeURIComponent).join("/")}`;
-    const encoded = this.payloadCodec.encode(input);
-    const headers = new Headers(encoded.headers);
-    headers.append(ORPC_HANDLER_HEADER, ORPC_HANDLER_VALUE);
     const clientContext = options.context;
-    let customHeaders = await this.options.headers?.(input, clientContext);
-    customHeaders = customHeaders instanceof Headers ? customHeaders : new Headers(customHeaders);
-    for (const [key, value] of customHeaders.entries()) {
-      headers.append(key, value);
-    }
-    const response = await this.fetch(url, {
-      method: "POST",
-      headers,
+    const encoded = await this.encode(path, input, options);
+    const response = await this.fetch(encoded.url, {
+      method: encoded.method,
+      headers: encoded.headers,
       body: encoded.body,
       signal: options.signal
     }, clientContext);
@@ -39,6 +44,42 @@ var ORPCLink = class {
     }
     return decoded;
   }
+  async encode(path, input, options) {
+    const clientContext = options.context;
+    const expectMethod = await this.getMethod(path, input, clientContext);
+    const methods = /* @__PURE__ */ new Set([expectMethod, this.fallbackMethod]);
+    const baseHeaders = await this.getHeaders(path, input, clientContext);
+    const baseUrl = new URL(`${trim(this.url, "/")}/${path.map(encodeURIComponent).join("/")}`);
+    baseHeaders.append(ORPC_HANDLER_HEADER, ORPC_HANDLER_VALUE);
+    for (const method of methods) {
+      const url = new URL(baseUrl);
+      const headers = new Headers(baseHeaders);
+      const encoded = this.payloadCodec.encode(input, method, this.fallbackMethod);
+      if (encoded.query) {
+        for (const [key, value] of encoded.query.entries()) {
+          url.searchParams.append(key, value);
+        }
+      }
+      if (url.toString().length > this.maxURLLength) {
+        continue;
+      }
+      if (encoded.headers) {
+        for (const [key, value] of encoded.headers.entries()) {
+          headers.append(key, value);
+        }
+      }
+      return {
+        url,
+        headers,
+        method: encoded.method,
+        body: encoded.body
+      };
+    }
+    throw new ORPCError({
+      code: "BAD_REQUEST",
+      message: "Cannot encode the request, please check the url length or payload."
+    });
+  }
 };
 export {
   ORPCLink

package/dist/index.js

@@ -24,7 +24,7 @@ var DynamicLink = class {
     this.linkResolver = linkResolver;
   }
   async call(path, input, options) {
-    const resolvedLink = await this.linkResolver(path, input, options);
+    const resolvedLink = await this.linkResolver(path, input, options.context);
     const output = await resolvedLink.call(path, input, options);
     return output;
   }

package/dist/src/adapters/fetch/orpc-link.d.ts

@@ -1,19 +1,47 @@
+import type { HTTPMethod } from '@orpc/contract';
 import type { ProcedureClientOptions } from '@orpc/server';
 import type { Promisable } from '@orpc/shared';
 import type { ClientLink } from '../../types';
 import type { FetchWithContext } from './types';
 import { type PublicORPCPayloadCodec } from '@orpc/server/fetch';
 export interface ORPCLinkOptions<TClientContext> {
+    /**
+     * Base url for all requests.
+     */
     url: string;
-    headers?: (input: unknown, context: TClientContext) => Promisable<Headers | Record<string, string>>;
+    /**
+     * The maximum length of the URL.
+     *
+     * @default 2083
+     */
+    maxURLLength?: number;
+    /**
+     * The method used to make the request.
+     *
+     * @default 'POST'
+     */
+    method?: (path: readonly string[], input: unknown, context: TClientContext) => Promisable<HTTPMethod | undefined>;
+    /**
+     * The method to use when the payload cannot safely pass to the server with method return from method function.
+     * Do not use GET as fallback method, it's very dangerous.
+     *
+     * @default 'POST'
+     */
+    fallbackMethod?: HTTPMethod;
+    headers?: (path: readonly string[], input: unknown, context: TClientContext) => Promisable<Headers | Record<string, string>>;
     fetch?: FetchWithContext<TClientContext>;
     payloadCodec?: PublicORPCPayloadCodec;
 }
 export declare class ORPCLink<TClientContext> implements ClientLink<TClientContext> {
-    private readonly options;
     private readonly fetch;
     private readonly payloadCodec;
+    private readonly maxURLLength;
+    private readonly fallbackMethod;
+    private readonly getMethod;
+    private readonly getHeaders;
+    private readonly url;
     constructor(options: ORPCLinkOptions<TClientContext>);
     call(path: readonly string[], input: unknown, options: ProcedureClientOptions<TClientContext>): Promise<unknown>;
+    private encode;
 }
 //# sourceMappingURL=orpc-link.d.ts.map

package/dist/src/dynamic-link.d.ts

@@ -7,9 +7,7 @@ import type { ClientLink } from './types';
  */
 export declare class DynamicLink<TClientContext> implements ClientLink<TClientContext> {
     private readonly linkResolver;
-    constructor(linkResolver: (path: readonly string[], input: unknown, options: ProcedureClientOptions<TClientContext> & {
-        context: TClientContext;
-    }) => Promisable<ClientLink<TClientContext>>);
+    constructor(linkResolver: (path: readonly string[], input: unknown, context: TClientContext) => Promisable<ClientLink<TClientContext>>);
     call(path: readonly string[], input: unknown, options: ProcedureClientOptions<TClientContext>): Promise<unknown>;
 }
 //# sourceMappingURL=dynamic-link.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@orpc/client",
   "type": "module",
-  "version": "0.20.0",
+  "version": "0.22.0",
   "license": "MIT",
   "homepage": "https://orpc.unnoq.com",
   "repository": {
@@ -34,15 +34,15 @@
     "dist"
   ],
   "peerDependencies": {
-    "@orpc/contract": "0.20.0"
+    "@orpc/contract": "0.22.0"
   },
   "dependencies": {
-    "@orpc/server": "0.20.0",
-    "@orpc/shared": "0.20.0"
+    "@orpc/shared": "0.22.0",
+    "@orpc/server": "0.22.0"
   },
   "devDependencies": {
     "zod": "^3.24.1",
-    "@orpc/openapi": "0.20.0"
+    "@orpc/openapi": "0.22.0"
   },
   "scripts": {
     "build": "tsup --clean --sourcemap --entry.index=src/index.ts --entry.fetch=src/adapters/fetch/index.ts --format=esm --onSuccess='tsc -b --noCheck'",