@orpc/client 0.0.0-next.e361acd → 0.0.0-next.eb37cbe

package/dist/fetch.js

@@ -0,0 +1,87 @@
+// src/adapters/fetch/orpc-link.ts
+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.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));
+    };
+  }
+  async call(path, input, options) {
+    const clientContext = options.context;
+    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);
+    const decoded = await this.payloadCodec.decode(response);
+    if (!response.ok) {
+      const error = ORPCError.fromJSON(decoded) ?? new ORPCError({
+        status: response.status,
+        code: "INTERNAL_SERVER_ERROR",
+        message: "Internal server error",
+        cause: decoded
+      });
+      throw error;
+    }
+    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
+};
+//# sourceMappingURL=fetch.js.map

package/dist/index.js

@@ -1,83 +1,39 @@
-// src/procedure-fetch-client.ts
-import { ORPC_PROTOCOL_HEADER, ORPC_PROTOCOL_VALUE, trim } from "@orpc/shared";
-import { ORPCError } from "@orpc/shared/error";
-import { ORPCDeserializer, ORPCSerializer } from "@orpc/transformer";
-var serializer = new ORPCSerializer();
-var deserializer = new ORPCDeserializer();
-function createProcedureFetchClient(options) {
-  const client = async (...[input, callerOptions]) => {
-    const fetchClient = options.fetch ?? fetch;
-    const url = `${trim(options.baseURL, "/")}/${options.path.map(encodeURIComponent).join("/")}`;
-    const headers = new Headers({
-      [ORPC_PROTOCOL_HEADER]: ORPC_PROTOCOL_VALUE
-    });
-    let customHeaders = await options.headers?.(input);
-    customHeaders = customHeaders instanceof Headers ? customHeaders : new Headers(customHeaders);
-    for (const [key, value] of customHeaders.entries()) {
-      headers.append(key, value);
-    }
-    const serialized = serializer.serialize(input);
-    for (const [key, value] of serialized.headers.entries()) {
-      headers.append(key, value);
-    }
-    const response = await fetchClient(url, {
-      method: "POST",
-      headers,
-      body: serialized.body,
-      signal: callerOptions?.signal
-    });
-    const json = await (async () => {
-      try {
-        return await deserializer.deserialize(response);
-      } catch (e) {
-        throw new ORPCError({
-          code: "INTERNAL_SERVER_ERROR",
-          message: "Cannot parse response.",
-          cause: e
-        });
+// src/client.ts
+function createORPCClient(link, options) {
+  const path = options?.path ?? [];
+  const procedureClient = async (...[input, options2]) => {
+    return await link.call(path, input, options2 ?? {});
+  };
+  const recursive = new Proxy(procedureClient, {
+    get(target, key) {
+      if (typeof key !== "string") {
+        return Reflect.get(target, key);
       }
-    })();
-    if (!response.ok) {
-      throw ORPCError.fromJSON(json) ?? new ORPCError({
-        status: response.status,
-        code: "INTERNAL_SERVER_ERROR",
-        message: "Internal server error"
+      return createORPCClient(link, {
+        ...options,
+        path: [...path, key]
       });
     }
-    return json;
-  };
-  return client;
+  });
+  return recursive;
 }
 
-// src/router-fetch-client.ts
-function createRouterFetchClient(options) {
-  const path = options?.path ?? [];
-  const client = new Proxy(
-    createProcedureFetchClient({
-      ...options,
-      path
-    }),
-    {
-      get(target, key) {
-        if (typeof key !== "string") {
-          return Reflect.get(target, key);
-        }
-        return createRouterFetchClient({
-          ...options,
-          path: [...path, key]
-        });
-      }
-    }
-  );
-  return client;
-}
+// src/dynamic-link.ts
+var DynamicLink = class {
+  constructor(linkResolver) {
+    this.linkResolver = linkResolver;
+  }
+  async call(path, input, options) {
+    const resolvedLink = await this.linkResolver(path, input, options.context);
+    const output = await resolvedLink.call(path, input, options);
+    return output;
+  }
+};
 
 // src/index.ts
 export * from "@orpc/shared/error";
-var createORPCFetchClient = createRouterFetchClient;
 export {
-  createORPCFetchClient,
-  createProcedureFetchClient,
-  createRouterFetchClient
+  DynamicLink,
+  createORPCClient
 };
 //# sourceMappingURL=index.js.map

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

@@ -0,0 +1,3 @@
+export * from './orpc-link';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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;
+    /**
+     * 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 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/adapters/fetch/types.d.ts

@@ -0,0 +1,4 @@
+export interface FetchWithContext<TClientContext> {
+    (input: RequestInfo | URL, init: RequestInit | undefined, context: TClientContext): Promise<Response>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/client.d.ts

@@ -0,0 +1,11 @@
+import type { ContractRouter } from '@orpc/contract';
+import type { ANY_ROUTER, RouterClient } from '@orpc/server';
+import type { ClientLink } from './types';
+export interface createORPCClientOptions {
+    /**
+     * Use as base path for all procedure, useful when you only want to call a subset of the procedure.
+     */
+    path?: string[];
+}
+export declare function createORPCClient<TRouter extends ANY_ROUTER | ContractRouter, TClientContext = unknown>(link: ClientLink<TClientContext>, options?: createORPCClientOptions): RouterClient<TRouter, TClientContext>;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1,13 @@
+import type { ProcedureClientOptions } from '@orpc/server';
+import type { Promisable } from '@orpc/shared';
+import type { ClientLink } from './types';
+/**
+ * DynamicLink provides a way to dynamically resolve and delegate calls to other ClientLinks
+ * based on the request path, input, and context.
+ */
+export declare class DynamicLink<TClientContext> implements ClientLink<TClientContext> {
+    private readonly linkResolver;
+    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/dist/src/index.d.ts

@@ -1,7 +1,6 @@
 /** unnoq */
-import { createRouterFetchClient } from './router-fetch-client';
-export * from './procedure-fetch-client';
-export * from './router-fetch-client';
+export * from './client';
+export * from './dynamic-link';
+export * from './types';
 export * from '@orpc/shared/error';
-export declare const createORPCFetchClient: typeof createRouterFetchClient;
 //# sourceMappingURL=index.d.ts.map

package/dist/src/types.d.ts

@@ -0,0 +1,5 @@
+import type { ProcedureClientOptions } from '@orpc/server';
+export interface ClientLink<TClientContext> {
+    call: (path: readonly string[], input: unknown, options: ProcedureClientOptions<TClientContext>) => Promise<unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@orpc/client",
   "type": "module",
-  "version": "0.0.0-next.e361acd",
+  "version": "0.0.0-next.eb37cbe",
   "license": "MIT",
   "homepage": "https://orpc.unnoq.com",
   "repository": {
@@ -19,6 +19,11 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./fetch": {
+      "types": "./dist/src/adapters/fetch/index.d.ts",
+      "import": "./dist/fetch.js",
+      "default": "./dist/fetch.js"
+    },
     "./🔒/*": {
       "types": "./dist/src/*.d.ts"
     }
@@ -29,19 +34,18 @@
     "dist"
   ],
   "peerDependencies": {
-    "@orpc/contract": "0.0.0-next.e361acd",
-    "@orpc/server": "0.0.0-next.e361acd"
+    "@orpc/contract": "0.0.0-next.eb37cbe"
   },
   "dependencies": {
-    "@orpc/transformer": "0.0.0-next.e361acd",
-    "@orpc/shared": "0.0.0-next.e361acd"
+    "@orpc/server": "0.0.0-next.eb37cbe",
+    "@orpc/shared": "0.0.0-next.eb37cbe"
   },
   "devDependencies": {
     "zod": "^3.24.1",
-    "@orpc/openapi": "0.0.0-next.e361acd"
+    "@orpc/openapi": "0.0.0-next.eb37cbe"
   },
   "scripts": {
-    "build": "tsup --clean --sourcemap --entry.index=src/index.ts --format=esm --onSuccess='tsc -b --noCheck'",
+    "build": "tsup --clean --sourcemap --entry.index=src/index.ts --entry.fetch=src/adapters/fetch/index.ts --format=esm --onSuccess='tsc -b --noCheck'",
     "build:watch": "pnpm run build --watch",
     "type:check": "tsc -b"
   }

package/dist/src/procedure-fetch-client.d.ts

@@ -1,24 +0,0 @@
-import type { ProcedureClient } from '@orpc/server';
-import type { Promisable } from '@orpc/shared';
-export interface CreateProcedureClientOptions {
-    /**
-     * The base url of the server.
-     */
-    baseURL: string;
-    /**
-     * The fetch function used to make the request.
-     * @default global fetch
-     */
-    fetch?: typeof fetch;
-    /**
-     * The headers used to make the request.
-     * Invoked before the request is made.
-     */
-    headers?: (input: unknown) => Promisable<Headers | Record<string, string>>;
-    /**
-     * The path of the procedure on server.
-     */
-    path: string[];
-}
-export declare function createProcedureFetchClient<TInput, TOutput>(options: CreateProcedureClientOptions): ProcedureClient<TInput, TOutput>;
-//# sourceMappingURL=procedure-fetch-client.d.ts.map

package/dist/src/router-fetch-client.d.ts

@@ -1,6 +0,0 @@
-import type { ContractRouter } from '@orpc/contract';
-import type { ANY_ROUTER, RouterClient } from '@orpc/server';
-import type { SetOptional } from '@orpc/shared';
-import type { CreateProcedureClientOptions } from './procedure-fetch-client';
-export declare function createRouterFetchClient<T extends ANY_ROUTER | ContractRouter>(options: SetOptional<CreateProcedureClientOptions, 'path'>): RouterClient<T>;
-//# sourceMappingURL=router-fetch-client.d.ts.map