@orpc/client 0.0.0-next.ee0aeaf → 0.0.0-next.f22c7ec

Sign up to get free protection for your applications and to get access to all the features.
package/dist/fetch.js ADDED
@@ -0,0 +1,89 @@
1
+ // src/adapters/fetch/orpc-link.ts
2
+ import { ORPCError } from "@orpc/contract";
3
+ import { ORPCPayloadCodec } from "@orpc/server/fetch";
4
+ import { ORPC_HANDLER_HEADER, ORPC_HANDLER_VALUE, trim } from "@orpc/shared";
5
+ var RPCLink = class {
6
+ fetch;
7
+ payloadCodec;
8
+ maxURLLength;
9
+ fallbackMethod;
10
+ getMethod;
11
+ getHeaders;
12
+ url;
13
+ constructor(options) {
14
+ this.fetch = options.fetch ?? globalThis.fetch.bind(globalThis);
15
+ this.payloadCodec = options.payloadCodec ?? new ORPCPayloadCodec();
16
+ this.maxURLLength = options.maxURLLength ?? 2083;
17
+ this.fallbackMethod = options.fallbackMethod ?? "POST";
18
+ this.url = options.url;
19
+ this.getMethod = async (path, input, context) => {
20
+ return await options.method?.(path, input, context) ?? this.fallbackMethod;
21
+ };
22
+ this.getHeaders = async (path, input, context) => {
23
+ return new Headers(await options.headers?.(path, input, context));
24
+ };
25
+ }
26
+ async call(path, input, options) {
27
+ const clientContext = options.context;
28
+ const encoded = await this.encode(path, input, options);
29
+ const response = await this.fetch(encoded.url, {
30
+ method: encoded.method,
31
+ headers: encoded.headers,
32
+ body: encoded.body,
33
+ signal: options.signal
34
+ }, clientContext);
35
+ const decoded = await this.payloadCodec.decode(response);
36
+ if (!response.ok) {
37
+ if (ORPCError.isValidJSON(decoded)) {
38
+ throw new ORPCError(decoded);
39
+ }
40
+ throw new ORPCError({
41
+ status: response.status,
42
+ code: "INTERNAL_SERVER_ERROR",
43
+ message: "Internal server error",
44
+ cause: decoded
45
+ });
46
+ }
47
+ return decoded;
48
+ }
49
+ async encode(path, input, options) {
50
+ const clientContext = options.context;
51
+ const expectMethod = await this.getMethod(path, input, clientContext);
52
+ const methods = /* @__PURE__ */ new Set([expectMethod, this.fallbackMethod]);
53
+ const baseHeaders = await this.getHeaders(path, input, clientContext);
54
+ const baseUrl = new URL(`${trim(this.url, "/")}/${path.map(encodeURIComponent).join("/")}`);
55
+ baseHeaders.append(ORPC_HANDLER_HEADER, ORPC_HANDLER_VALUE);
56
+ for (const method of methods) {
57
+ const url = new URL(baseUrl);
58
+ const headers = new Headers(baseHeaders);
59
+ const encoded = this.payloadCodec.encode(input, method, this.fallbackMethod);
60
+ if (encoded.query) {
61
+ for (const [key, value] of encoded.query.entries()) {
62
+ url.searchParams.append(key, value);
63
+ }
64
+ }
65
+ if (url.toString().length > this.maxURLLength) {
66
+ continue;
67
+ }
68
+ if (encoded.headers) {
69
+ for (const [key, value] of encoded.headers.entries()) {
70
+ headers.append(key, value);
71
+ }
72
+ }
73
+ return {
74
+ url,
75
+ headers,
76
+ method: encoded.method,
77
+ body: encoded.body
78
+ };
79
+ }
80
+ throw new ORPCError({
81
+ code: "BAD_REQUEST",
82
+ message: "Cannot encode the request, please check the url length or payload."
83
+ });
84
+ }
85
+ };
86
+ export {
87
+ RPCLink
88
+ };
89
+ //# sourceMappingURL=fetch.js.map
package/dist/index.js CHANGED
@@ -1,86 +1,42 @@
1
- // src/procedure.ts
2
- import { ORPC_PROTOCOL_HEADER, ORPC_PROTOCOL_VALUE, trim } from "@orpc/shared";
3
- import { ORPCError } from "@orpc/shared/error";
4
- import { ORPCDeserializer, ORPCSerializer } from "@orpc/transformer";
5
- var serializer = new ORPCSerializer();
6
- var deserializer = new ORPCDeserializer();
7
- function createProcedureClient(options) {
8
- const client = async (...args) => {
9
- const [input, callerOptions] = args;
10
- const fetch_ = options.fetch ?? fetch;
11
- const url = `${trim(options.baseURL, "/")}/${options.path.map(encodeURIComponent).join("/")}`;
12
- const headers = new Headers({
13
- [ORPC_PROTOCOL_HEADER]: ORPC_PROTOCOL_VALUE
14
- });
15
- let customHeaders = await options.headers?.(input);
16
- customHeaders = customHeaders instanceof Headers ? customHeaders : new Headers(customHeaders);
17
- for (const [key, value] of customHeaders.entries()) {
18
- headers.append(key, value);
19
- }
20
- const serialized = serializer.serialize(input);
21
- for (const [key, value] of serialized.headers.entries()) {
22
- headers.append(key, value);
23
- }
24
- const response = await fetch_(url, {
25
- method: "POST",
26
- headers,
27
- body: serialized.body,
28
- signal: callerOptions?.signal
29
- });
30
- const json = await (async () => {
31
- try {
32
- return await deserializer.deserialize(response);
33
- } catch (e) {
34
- throw new ORPCError({
35
- code: "INTERNAL_SERVER_ERROR",
36
- message: "Cannot parse response.",
37
- cause: e
38
- });
1
+ // src/client.ts
2
+ function createORPCClient(link, options) {
3
+ const path = options?.path ?? [];
4
+ const procedureClient = async (...[input, options2]) => {
5
+ return await link.call(path, input, options2 ?? {});
6
+ };
7
+ const recursive = new Proxy(procedureClient, {
8
+ get(target, key) {
9
+ if (typeof key !== "string") {
10
+ return Reflect.get(target, key);
39
11
  }
40
- })();
41
- if (!response.ok) {
42
- throw ORPCError.fromJSON(json) ?? new ORPCError({
43
- status: response.status,
44
- code: "INTERNAL_SERVER_ERROR",
45
- message: "Internal server error"
12
+ return createORPCClient(link, {
13
+ ...options,
14
+ path: [...path, key]
46
15
  });
47
16
  }
48
- return json;
49
- };
50
- return client;
17
+ });
18
+ return recursive;
51
19
  }
52
20
 
53
- // src/router.ts
54
- function createRouterClient(options) {
55
- const path = options?.path ?? [];
56
- const client = new Proxy(
57
- createProcedureClient({
58
- baseURL: options.baseURL,
59
- fetch: options.fetch,
60
- headers: options.headers,
61
- path
62
- }),
63
- {
64
- get(target, key) {
65
- if (typeof key !== "string") {
66
- return Reflect.get(target, key);
67
- }
68
- return createRouterClient({
69
- ...options,
70
- path: [...path, key]
71
- });
72
- }
73
- }
74
- );
75
- return client;
76
- }
21
+ // src/dynamic-link.ts
22
+ var DynamicLink = class {
23
+ constructor(linkResolver) {
24
+ this.linkResolver = linkResolver;
25
+ }
26
+ async call(path, input, options) {
27
+ const resolvedLink = await this.linkResolver(path, input, options.context);
28
+ const output = await resolvedLink.call(path, input, options);
29
+ return output;
30
+ }
31
+ };
77
32
 
78
33
  // src/index.ts
79
- export * from "@orpc/shared/error";
80
- var createORPCClient = createRouterClient;
34
+ import { isDefinedError, ORPCError, safe } from "@orpc/contract";
81
35
  export {
36
+ DynamicLink,
37
+ ORPCError,
82
38
  createORPCClient,
83
- createProcedureClient,
84
- createRouterClient
39
+ isDefinedError,
40
+ safe
85
41
  };
86
42
  //# sourceMappingURL=index.js.map
@@ -0,0 +1,3 @@
1
+ export * from './orpc-link';
2
+ export * from './types';
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1,46 @@
1
+ import type { ClientOptions, HTTPMethod } from '@orpc/contract';
2
+ import type { Promisable } from '@orpc/shared';
3
+ import type { ClientLink } from '../../types';
4
+ import type { FetchWithContext } from './types';
5
+ import { type PublicORPCPayloadCodec } from '@orpc/server/fetch';
6
+ export interface RPCLinkOptions<TClientContext> {
7
+ /**
8
+ * Base url for all requests.
9
+ */
10
+ url: string;
11
+ /**
12
+ * The maximum length of the URL.
13
+ *
14
+ * @default 2083
15
+ */
16
+ maxURLLength?: number;
17
+ /**
18
+ * The method used to make the request.
19
+ *
20
+ * @default 'POST'
21
+ */
22
+ method?: (path: readonly string[], input: unknown, context: TClientContext) => Promisable<HTTPMethod | undefined>;
23
+ /**
24
+ * The method to use when the payload cannot safely pass to the server with method return from method function.
25
+ * Do not use GET as fallback method, it's very dangerous.
26
+ *
27
+ * @default 'POST'
28
+ */
29
+ fallbackMethod?: HTTPMethod;
30
+ headers?: (path: readonly string[], input: unknown, context: TClientContext) => Promisable<Headers | Record<string, string>>;
31
+ fetch?: FetchWithContext<TClientContext>;
32
+ payloadCodec?: PublicORPCPayloadCodec;
33
+ }
34
+ export declare class RPCLink<TClientContext> implements ClientLink<TClientContext> {
35
+ private readonly fetch;
36
+ private readonly payloadCodec;
37
+ private readonly maxURLLength;
38
+ private readonly fallbackMethod;
39
+ private readonly getMethod;
40
+ private readonly getHeaders;
41
+ private readonly url;
42
+ constructor(options: RPCLinkOptions<TClientContext>);
43
+ call(path: readonly string[], input: unknown, options: ClientOptions<TClientContext>): Promise<unknown>;
44
+ private encode;
45
+ }
46
+ //# sourceMappingURL=orpc-link.d.ts.map
@@ -0,0 +1,4 @@
1
+ export interface FetchWithContext<TClientContext> {
2
+ (input: RequestInfo | URL, init: RequestInit | undefined, context: TClientContext): Promise<Response>;
3
+ }
4
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1,11 @@
1
+ import type { ContractRouter, ContractRouterClient } from '@orpc/contract';
2
+ import type { ANY_ROUTER, RouterClient } from '@orpc/server';
3
+ import type { ClientLink } from './types';
4
+ export interface createORPCClientOptions {
5
+ /**
6
+ * Use as base path for all procedure, useful when you only want to call a subset of the procedure.
7
+ */
8
+ path?: string[];
9
+ }
10
+ export declare function createORPCClient<TRouter extends ANY_ROUTER | ContractRouter<any>, TClientContext = unknown>(link: ClientLink<TClientContext>, options?: createORPCClientOptions): TRouter extends ContractRouter<any> ? ContractRouterClient<TRouter, TClientContext> : TRouter extends ANY_ROUTER ? RouterClient<TRouter, TClientContext> : never;
11
+ //# sourceMappingURL=client.d.ts.map
@@ -0,0 +1,13 @@
1
+ import type { ClientOptions } from '@orpc/contract';
2
+ import type { Promisable } from '@orpc/shared';
3
+ import type { ClientLink } from './types';
4
+ /**
5
+ * DynamicLink provides a way to dynamically resolve and delegate calls to other ClientLinks
6
+ * based on the request path, input, and context.
7
+ */
8
+ export declare class DynamicLink<TClientContext> implements ClientLink<TClientContext> {
9
+ private readonly linkResolver;
10
+ constructor(linkResolver: (path: readonly string[], input: unknown, context: TClientContext) => Promisable<ClientLink<TClientContext>>);
11
+ call(path: readonly string[], input: unknown, options: ClientOptions<TClientContext>): Promise<unknown>;
12
+ }
13
+ //# sourceMappingURL=dynamic-link.d.ts.map
@@ -1,7 +1,6 @@
1
1
  /** unnoq */
2
- import { createRouterClient } from './router';
3
- export * from './procedure';
4
- export * from './router';
5
- export * from '@orpc/shared/error';
6
- export declare const createORPCClient: typeof createRouterClient;
2
+ export * from './client';
3
+ export * from './dynamic-link';
4
+ export * from './types';
5
+ export { isDefinedError, ORPCError, safe } from '@orpc/contract';
7
6
  //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1,5 @@
1
+ import type { ClientOptions } from '@orpc/contract';
2
+ export interface ClientLink<TClientContext> {
3
+ call: (path: readonly string[], input: unknown, options: ClientOptions<TClientContext>) => Promise<unknown>;
4
+ }
5
+ //# sourceMappingURL=types.d.ts.map
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@orpc/client",
3
3
  "type": "module",
4
- "version": "0.0.0-next.ee0aeaf",
4
+ "version": "0.0.0-next.f22c7ec",
5
5
  "license": "MIT",
6
6
  "homepage": "https://orpc.unnoq.com",
7
7
  "repository": {
@@ -19,6 +19,11 @@
19
19
  "import": "./dist/index.js",
20
20
  "default": "./dist/index.js"
21
21
  },
22
+ "./fetch": {
23
+ "types": "./dist/src/adapters/fetch/index.d.ts",
24
+ "import": "./dist/fetch.js",
25
+ "default": "./dist/fetch.js"
26
+ },
22
27
  "./🔒/*": {
23
28
  "types": "./dist/src/*.d.ts"
24
29
  }
@@ -28,20 +33,17 @@
28
33
  "!**/*.tsbuildinfo",
29
34
  "dist"
30
35
  ],
31
- "peerDependencies": {
32
- "@orpc/contract": "0.0.0-next.ee0aeaf",
33
- "@orpc/server": "0.0.0-next.ee0aeaf"
34
- },
35
36
  "dependencies": {
36
- "@orpc/shared": "0.0.0-next.ee0aeaf",
37
- "@orpc/transformer": "0.0.0-next.ee0aeaf"
37
+ "@orpc/contract": "0.0.0-next.f22c7ec",
38
+ "@orpc/server": "0.0.0-next.f22c7ec",
39
+ "@orpc/shared": "0.0.0-next.f22c7ec"
38
40
  },
39
41
  "devDependencies": {
40
42
  "zod": "^3.24.1",
41
- "@orpc/openapi": "0.0.0-next.ee0aeaf"
43
+ "@orpc/openapi": "0.0.0-next.f22c7ec"
42
44
  },
43
45
  "scripts": {
44
- "build": "tsup --clean --sourcemap --entry.index=src/index.ts --format=esm --onSuccess='tsc -b --noCheck'",
46
+ "build": "tsup --clean --sourcemap --entry.index=src/index.ts --entry.fetch=src/adapters/fetch/index.ts --format=esm --onSuccess='tsc -b --noCheck'",
45
47
  "build:watch": "pnpm run build --watch",
46
48
  "type:check": "tsc -b"
47
49
  }
@@ -1,24 +0,0 @@
1
- import type { Caller } from '@orpc/server';
2
- import type { Promisable } from '@orpc/shared';
3
- export interface CreateProcedureClientOptions {
4
- /**
5
- * The base url of the server.
6
- */
7
- baseURL: string;
8
- /**
9
- * The fetch function used to make the request.
10
- * @default global fetch
11
- */
12
- fetch?: typeof fetch;
13
- /**
14
- * The headers used to make the request.
15
- * Invoked before the request is made.
16
- */
17
- headers?: (input: unknown) => Promisable<Headers | Record<string, string>>;
18
- /**
19
- * The path of the procedure on server.
20
- */
21
- path: string[];
22
- }
23
- export declare function createProcedureClient<TInput, TOutput>(options: CreateProcedureClientOptions): Caller<TInput, TOutput>;
24
- //# sourceMappingURL=procedure.d.ts.map
@@ -1,9 +0,0 @@
1
- import type { ContractProcedure, ContractRouter, SchemaInput, SchemaOutput } from '@orpc/contract';
2
- import type { Caller, Lazy, Procedure, Router } from '@orpc/server';
3
- import type { SetOptional } from '@orpc/shared';
4
- import type { CreateProcedureClientOptions } from './procedure';
5
- export type RouterClient<T extends Router<any> | ContractRouter> = {
6
- [K in keyof T]: T[K] extends ContractProcedure<infer UInputSchema, infer UOutputSchema> | Procedure<any, any, infer UInputSchema, infer UOutputSchema, infer UFuncOutput> | Lazy<Procedure<any, any, infer UInputSchema, infer UOutputSchema, infer UFuncOutput>> ? Caller<SchemaInput<UInputSchema>, SchemaOutput<UOutputSchema, UFuncOutput>> : T[K] extends Router<any> | ContractRouter ? RouterClient<T[K]> : never;
7
- };
8
- export declare function createRouterClient<T extends Router<any> | ContractRouter>(options: SetOptional<CreateProcedureClientOptions, 'path'>): RouterClient<T>;
9
- //# sourceMappingURL=router.d.ts.map