@orpc/client 0.0.0-next.fd13879 → 0.0.0-next.fd1ee2a

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -30,7 +30,7 @@
30
30
  - **🔗 End-to-End Type Safety**: Ensure type-safe inputs, outputs, and errors from client to server.
31
31
  - **📘 First-Class OpenAPI**: Built-in support that fully adheres to the OpenAPI standard.
32
32
  - **📝 Contract-First Development**: Optionally define your API contract before implementation.
33
- - **⚙️ Framework Integrations**: Seamlessly integrate with TanStack Query (React, Vue, Solid, Svelte), Pinia Colada, and more.
33
+ - **⚙️ Framework Integrations**: Seamlessly integrate with TanStack Query (React, Vue, Solid, Svelte, Angular), Pinia Colada, and more.
34
34
  - **🚀 Server Actions**: Fully compatible with React Server Actions on Next.js, TanStack Start, and other platforms.
35
35
  - **🔠 Standard Schema Support**: Works out of the box with Zod, Valibot, ArkType, and other schema validators.
36
36
  - **🗃️ Native Types**: Supports native types like Date, File, Blob, BigInt, URL, and more.
@@ -49,14 +49,12 @@ You can find the full documentation [here](https://orpc.unnoq.com).
49
49
  - [@orpc/contract](https://www.npmjs.com/package/@orpc/contract): Build your API contract.
50
50
  - [@orpc/server](https://www.npmjs.com/package/@orpc/server): Build your API or implement API contract.
51
51
  - [@orpc/client](https://www.npmjs.com/package/@orpc/client): Consume your API on the client with type-safety.
52
- - [@orpc/nest](https://www.npmjs.com/package/@orpc/nest): Deeply integrate oRPC with NestJS.
52
+ - [@orpc/openapi](https://www.npmjs.com/package/@orpc/openapi): Generate OpenAPI specs and handle OpenAPI requests.
53
+ - [@orpc/nest](https://www.npmjs.com/package/@orpc/nest): Deeply integrate oRPC with [NestJS](https://nestjs.com/).
53
54
  - [@orpc/react](https://www.npmjs.com/package/@orpc/react): Utilities for integrating oRPC with React and React Server Actions.
54
- - [@orpc/react-query](https://www.npmjs.com/package/@orpc/react-query): Integration with [React Query](https://tanstack.com/query/latest/docs/framework/react/overview).
55
- - [@orpc/vue-query](https://www.npmjs.com/package/@orpc/vue-query): Integration with [Vue Query](https://tanstack.com/query/latest/docs/framework/vue/overview).
56
- - [@orpc/solid-query](https://www.npmjs.com/package/@orpc/solid-query): Integration with [Solid Query](https://tanstack.com/query/latest/docs/framework/solid/overview).
57
- - [@orpc/svelte-query](https://www.npmjs.com/package/@orpc/svelte-query): Integration with [Svelte Query](https://tanstack.com/query/latest/docs/framework/svelte/overview).
55
+ - [@orpc/tanstack-query](https://www.npmjs.com/package/@orpc/tanstack-query): [TanStack Query](https://tanstack.com/query/latest) integration.
58
56
  - [@orpc/vue-colada](https://www.npmjs.com/package/@orpc/vue-colada): Integration with [Pinia Colada](https://pinia-colada.esm.dev/).
59
- - [@orpc/openapi](https://www.npmjs.com/package/@orpc/openapi): Generate OpenAPI specs and handle OpenAPI requests.
57
+ - [@orpc/hey-api](https://www.npmjs.com/package/@orpc/hey-api): [Hey API](https://heyapi.dev/) integration.
60
58
  - [@orpc/zod](https://www.npmjs.com/package/@orpc/zod): More schemas that [Zod](https://zod.dev/) doesn't support yet.
61
59
  - [@orpc/valibot](https://www.npmjs.com/package/@orpc/valibot): OpenAPI spec generation from [Valibot](https://valibot.dev/).
62
60
  - [@orpc/arktype](https://www.npmjs.com/package/@orpc/arktype): OpenAPI spec generation from [ArkType](https://arktype.io/).
@@ -1,8 +1,8 @@
1
1
  import { StandardRequest, StandardLazyResponse } from '@orpc/standard-server';
2
2
  import { ToFetchRequestOptions } from '@orpc/standard-server-fetch';
3
- import { a as ClientContext, b as ClientOptions } from '../../shared/client.4TS_0JaO.mjs';
4
- import { f as StandardLinkClient } from '../../shared/client.ds1abV85.mjs';
5
- import { f as StandardRPCLinkOptions, g as StandardRPCLink } from '../../shared/client.ClwIM_ku.mjs';
3
+ import { b as ClientContext, c as ClientOptions } from '../../shared/client.BOYsZIRq.mjs';
4
+ import { f as StandardLinkClient } from '../../shared/client.C4VxIexA.mjs';
5
+ import { f as StandardRPCLinkOptions, g as StandardRPCLink } from '../../shared/client.aTp4sII-.mjs';
6
6
  import '@orpc/shared';
7
7
 
8
8
  interface LinkFetchClientOptions<T extends ClientContext> extends ToFetchRequestOptions {
@@ -1,8 +1,8 @@
1
1
  import { StandardRequest, StandardLazyResponse } from '@orpc/standard-server';
2
2
  import { ToFetchRequestOptions } from '@orpc/standard-server-fetch';
3
- import { a as ClientContext, b as ClientOptions } from '../../shared/client.4TS_0JaO.js';
4
- import { f as StandardLinkClient } from '../../shared/client.7ZYxJok_.js';
5
- import { f as StandardRPCLinkOptions, g as StandardRPCLink } from '../../shared/client.B2432-Lu.js';
3
+ import { b as ClientContext, c as ClientOptions } from '../../shared/client.BOYsZIRq.js';
4
+ import { f as StandardLinkClient } from '../../shared/client.CXXEPIbK.js';
5
+ import { f as StandardRPCLinkOptions, g as StandardRPCLink } from '../../shared/client.WCinBImJ.js';
6
6
  import '@orpc/shared';
7
7
 
8
8
  interface LinkFetchClientOptions<T extends ClientContext> extends ToFetchRequestOptions {
@@ -1,8 +1,8 @@
1
1
  import { toFetchRequest, toStandardLazyResponse } from '@orpc/standard-server-fetch';
2
2
  import '@orpc/shared';
3
- import { c as StandardRPCLink } from '../../shared/client.DpICn1BD.mjs';
3
+ import { c as StandardRPCLink } from '../../shared/client.BvXDSBF5.mjs';
4
4
  import '@orpc/standard-server';
5
- import '../../shared/client.CRWEpqLB.mjs';
5
+ import '../../shared/client.BngOL3Ai.mjs';
6
6
 
7
7
  class LinkFetchClient {
8
8
  fetch;
@@ -0,0 +1,59 @@
1
+ import { StandardRequest, StandardLazyResponse } from '@orpc/standard-server';
2
+ import { b as ClientContext, c as ClientOptions } from '../../shared/client.BOYsZIRq.mjs';
3
+ import { f as StandardLinkClient } from '../../shared/client.C4VxIexA.mjs';
4
+ import { f as StandardRPCLinkOptions, g as StandardRPCLink } from '../../shared/client.aTp4sII-.mjs';
5
+ import '@orpc/shared';
6
+
7
+ /**
8
+ * The message port used by electron in main process
9
+ */
10
+ interface MessagePortMainLike {
11
+ on: <T extends string>(event: T, callback: (event?: {
12
+ data: any;
13
+ }) => void) => void;
14
+ postMessage: (data: any) => void;
15
+ }
16
+ /**
17
+ * The message port used by browser extension
18
+ */
19
+ interface BrowserPortLike {
20
+ onMessage: {
21
+ addListener: (callback: (data: any) => void) => void;
22
+ };
23
+ onDisconnect: {
24
+ addListener: (callback: () => void) => void;
25
+ };
26
+ postMessage: (data: any) => void;
27
+ }
28
+ type SupportedMessagePort = Pick<MessagePort, 'addEventListener' | 'postMessage'> | MessagePortMainLike | BrowserPortLike;
29
+ /**
30
+ * Message port can support [The structured clone algorithm](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm)
31
+ */
32
+ type SupportedMessagePortData = string | ArrayBufferLike | Uint8Array;
33
+ declare function postMessagePortMessage(port: SupportedMessagePort, data: SupportedMessagePortData): void;
34
+ declare function onMessagePortMessage(port: SupportedMessagePort, callback: (data: SupportedMessagePortData) => void): void;
35
+ declare function onMessagePortClose(port: SupportedMessagePort, callback: () => void): void;
36
+
37
+ interface LinkMessagePortClientOptions {
38
+ port: SupportedMessagePort;
39
+ }
40
+ declare class LinkMessagePortClient<T extends ClientContext> implements StandardLinkClient<T> {
41
+ private readonly peer;
42
+ constructor(options: LinkMessagePortClientOptions);
43
+ call(request: StandardRequest, _options: ClientOptions<T>, _path: readonly string[], _input: unknown): Promise<StandardLazyResponse>;
44
+ }
45
+
46
+ interface RPCLinkOptions<T extends ClientContext> extends Omit<StandardRPCLinkOptions<T>, 'url' | 'headers' | 'method' | 'fallbackMethod' | 'maxUrlLength'>, LinkMessagePortClientOptions {
47
+ }
48
+ /**
49
+ * The RPC Link for common message port implementations.
50
+ *
51
+ * @see {@link https://orpc.unnoq.com/docs/client/rpc-link RPC Link Docs}
52
+ * @see {@link https://orpc.unnoq.com/docs/adapters/message-port Message Port Adapter Docs}
53
+ */
54
+ declare class RPCLink<T extends ClientContext> extends StandardRPCLink<T> {
55
+ constructor(options: RPCLinkOptions<T>);
56
+ }
57
+
58
+ export { LinkMessagePortClient, RPCLink, onMessagePortClose, onMessagePortMessage, postMessagePortMessage };
59
+ export type { BrowserPortLike, LinkMessagePortClientOptions, MessagePortMainLike, RPCLinkOptions, SupportedMessagePort, SupportedMessagePortData };
@@ -0,0 +1,59 @@
1
+ import { StandardRequest, StandardLazyResponse } from '@orpc/standard-server';
2
+ import { b as ClientContext, c as ClientOptions } from '../../shared/client.BOYsZIRq.js';
3
+ import { f as StandardLinkClient } from '../../shared/client.CXXEPIbK.js';
4
+ import { f as StandardRPCLinkOptions, g as StandardRPCLink } from '../../shared/client.WCinBImJ.js';
5
+ import '@orpc/shared';
6
+
7
+ /**
8
+ * The message port used by electron in main process
9
+ */
10
+ interface MessagePortMainLike {
11
+ on: <T extends string>(event: T, callback: (event?: {
12
+ data: any;
13
+ }) => void) => void;
14
+ postMessage: (data: any) => void;
15
+ }
16
+ /**
17
+ * The message port used by browser extension
18
+ */
19
+ interface BrowserPortLike {
20
+ onMessage: {
21
+ addListener: (callback: (data: any) => void) => void;
22
+ };
23
+ onDisconnect: {
24
+ addListener: (callback: () => void) => void;
25
+ };
26
+ postMessage: (data: any) => void;
27
+ }
28
+ type SupportedMessagePort = Pick<MessagePort, 'addEventListener' | 'postMessage'> | MessagePortMainLike | BrowserPortLike;
29
+ /**
30
+ * Message port can support [The structured clone algorithm](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm)
31
+ */
32
+ type SupportedMessagePortData = string | ArrayBufferLike | Uint8Array;
33
+ declare function postMessagePortMessage(port: SupportedMessagePort, data: SupportedMessagePortData): void;
34
+ declare function onMessagePortMessage(port: SupportedMessagePort, callback: (data: SupportedMessagePortData) => void): void;
35
+ declare function onMessagePortClose(port: SupportedMessagePort, callback: () => void): void;
36
+
37
+ interface LinkMessagePortClientOptions {
38
+ port: SupportedMessagePort;
39
+ }
40
+ declare class LinkMessagePortClient<T extends ClientContext> implements StandardLinkClient<T> {
41
+ private readonly peer;
42
+ constructor(options: LinkMessagePortClientOptions);
43
+ call(request: StandardRequest, _options: ClientOptions<T>, _path: readonly string[], _input: unknown): Promise<StandardLazyResponse>;
44
+ }
45
+
46
+ interface RPCLinkOptions<T extends ClientContext> extends Omit<StandardRPCLinkOptions<T>, 'url' | 'headers' | 'method' | 'fallbackMethod' | 'maxUrlLength'>, LinkMessagePortClientOptions {
47
+ }
48
+ /**
49
+ * The RPC Link for common message port implementations.
50
+ *
51
+ * @see {@link https://orpc.unnoq.com/docs/client/rpc-link RPC Link Docs}
52
+ * @see {@link https://orpc.unnoq.com/docs/adapters/message-port Message Port Adapter Docs}
53
+ */
54
+ declare class RPCLink<T extends ClientContext> extends StandardRPCLink<T> {
55
+ constructor(options: RPCLinkOptions<T>);
56
+ }
57
+
58
+ export { LinkMessagePortClient, RPCLink, onMessagePortClose, onMessagePortMessage, postMessagePortMessage };
59
+ export type { BrowserPortLike, LinkMessagePortClientOptions, MessagePortMainLike, RPCLinkOptions, SupportedMessagePort, SupportedMessagePortData };
@@ -0,0 +1,71 @@
1
+ import { ClientPeer } from '@orpc/standard-server-peer';
2
+ import '@orpc/shared';
3
+ import { c as StandardRPCLink } from '../../shared/client.BvXDSBF5.mjs';
4
+ import '@orpc/standard-server';
5
+ import '../../shared/client.BngOL3Ai.mjs';
6
+
7
+ function postMessagePortMessage(port, data) {
8
+ port.postMessage(data);
9
+ }
10
+ function onMessagePortMessage(port, callback) {
11
+ if ("addEventListener" in port) {
12
+ port.addEventListener("message", (event) => {
13
+ callback(event.data);
14
+ });
15
+ } else if ("on" in port) {
16
+ port.on("message", (event) => {
17
+ callback(event?.data);
18
+ });
19
+ } else if ("onMessage" in port) {
20
+ port.onMessage.addListener((data) => {
21
+ callback(data);
22
+ });
23
+ } else {
24
+ throw new Error("Cannot find a addEventListener/on/onMessage method on the port");
25
+ }
26
+ }
27
+ function onMessagePortClose(port, callback) {
28
+ if ("addEventListener" in port) {
29
+ port.addEventListener("close", async () => {
30
+ callback();
31
+ });
32
+ } else if ("on" in port) {
33
+ port.on("close", async () => {
34
+ callback();
35
+ });
36
+ } else if ("onDisconnect" in port) {
37
+ port.onDisconnect.addListener(() => {
38
+ callback();
39
+ });
40
+ } else {
41
+ throw new Error("Cannot find a addEventListener/on/onDisconnect method on the port");
42
+ }
43
+ }
44
+
45
+ class LinkMessagePortClient {
46
+ peer;
47
+ constructor(options) {
48
+ this.peer = new ClientPeer((message) => {
49
+ return postMessagePortMessage(options.port, message);
50
+ });
51
+ onMessagePortMessage(options.port, async (message) => {
52
+ await this.peer.message(message);
53
+ });
54
+ onMessagePortClose(options.port, () => {
55
+ this.peer.close();
56
+ });
57
+ }
58
+ async call(request, _options, _path, _input) {
59
+ const response = await this.peer.request(request);
60
+ return { ...response, body: () => Promise.resolve(response.body) };
61
+ }
62
+ }
63
+
64
+ class RPCLink extends StandardRPCLink {
65
+ constructor(options) {
66
+ const linkClient = new LinkMessagePortClient(options);
67
+ super(linkClient, { ...options, url: "orpc:/" });
68
+ }
69
+ }
70
+
71
+ export { LinkMessagePortClient, RPCLink, onMessagePortClose, onMessagePortMessage, postMessagePortMessage };
@@ -1,6 +1,6 @@
1
- export { C as CompositeStandardLinkPlugin, d as StandardLink, f as StandardLinkClient, S as StandardLinkClientInterceptorOptions, e as StandardLinkCodec, c as StandardLinkInterceptorOptions, b as StandardLinkOptions, a as StandardLinkPlugin } from '../../shared/client.ds1abV85.mjs';
2
- export { S as STANDARD_RPC_JSON_SERIALIZER_BUILT_IN_TYPES, c as StandardRPCCustomJsonSerializer, b as StandardRPCJsonSerialized, a as StandardRPCJsonSerializedMetaItem, e as StandardRPCJsonSerializer, d as StandardRPCJsonSerializerOptions, g as StandardRPCLink, i as StandardRPCLinkCodec, h as StandardRPCLinkCodecOptions, f as StandardRPCLinkOptions, j as StandardRPCSerializer } from '../../shared/client.ClwIM_ku.mjs';
3
- import { H as HTTPPath } from '../../shared/client.4TS_0JaO.mjs';
1
+ export { C as CompositeStandardLinkPlugin, d as StandardLink, f as StandardLinkClient, S as StandardLinkClientInterceptorOptions, e as StandardLinkCodec, c as StandardLinkInterceptorOptions, b as StandardLinkOptions, a as StandardLinkPlugin } from '../../shared/client.C4VxIexA.mjs';
2
+ export { S as STANDARD_RPC_JSON_SERIALIZER_BUILT_IN_TYPES, c as StandardRPCCustomJsonSerializer, b as StandardRPCJsonSerialized, a as StandardRPCJsonSerializedMetaItem, e as StandardRPCJsonSerializer, d as StandardRPCJsonSerializerOptions, g as StandardRPCLink, i as StandardRPCLinkCodec, h as StandardRPCLinkCodecOptions, f as StandardRPCLinkOptions, j as StandardRPCSerializer } from '../../shared/client.aTp4sII-.mjs';
3
+ import { H as HTTPPath } from '../../shared/client.BOYsZIRq.mjs';
4
4
  import '@orpc/shared';
5
5
  import '@orpc/standard-server';
6
6
 
@@ -1,6 +1,6 @@
1
- export { C as CompositeStandardLinkPlugin, d as StandardLink, f as StandardLinkClient, S as StandardLinkClientInterceptorOptions, e as StandardLinkCodec, c as StandardLinkInterceptorOptions, b as StandardLinkOptions, a as StandardLinkPlugin } from '../../shared/client.7ZYxJok_.js';
2
- export { S as STANDARD_RPC_JSON_SERIALIZER_BUILT_IN_TYPES, c as StandardRPCCustomJsonSerializer, b as StandardRPCJsonSerialized, a as StandardRPCJsonSerializedMetaItem, e as StandardRPCJsonSerializer, d as StandardRPCJsonSerializerOptions, g as StandardRPCLink, i as StandardRPCLinkCodec, h as StandardRPCLinkCodecOptions, f as StandardRPCLinkOptions, j as StandardRPCSerializer } from '../../shared/client.B2432-Lu.js';
3
- import { H as HTTPPath } from '../../shared/client.4TS_0JaO.js';
1
+ export { C as CompositeStandardLinkPlugin, d as StandardLink, f as StandardLinkClient, S as StandardLinkClientInterceptorOptions, e as StandardLinkCodec, c as StandardLinkInterceptorOptions, b as StandardLinkOptions, a as StandardLinkPlugin } from '../../shared/client.CXXEPIbK.js';
2
+ export { S as STANDARD_RPC_JSON_SERIALIZER_BUILT_IN_TYPES, c as StandardRPCCustomJsonSerializer, b as StandardRPCJsonSerialized, a as StandardRPCJsonSerializedMetaItem, e as StandardRPCJsonSerializer, d as StandardRPCJsonSerializerOptions, g as StandardRPCLink, i as StandardRPCLinkCodec, h as StandardRPCLinkCodecOptions, f as StandardRPCLinkOptions, j as StandardRPCSerializer } from '../../shared/client.WCinBImJ.js';
3
+ import { H as HTTPPath } from '../../shared/client.BOYsZIRq.js';
4
4
  import '@orpc/shared';
5
5
  import '@orpc/standard-server';
6
6
 
@@ -1,4 +1,4 @@
1
- export { C as CompositeStandardLinkPlugin, a as STANDARD_RPC_JSON_SERIALIZER_BUILT_IN_TYPES, S as StandardLink, b as StandardRPCJsonSerializer, c as StandardRPCLink, d as StandardRPCLinkCodec, e as StandardRPCSerializer, g as getMalformedResponseErrorCode, t as toHttpPath } from '../../shared/client.DpICn1BD.mjs';
1
+ export { C as CompositeStandardLinkPlugin, a as STANDARD_RPC_JSON_SERIALIZER_BUILT_IN_TYPES, S as StandardLink, b as StandardRPCJsonSerializer, c as StandardRPCLink, d as StandardRPCLinkCodec, e as StandardRPCSerializer, g as getMalformedResponseErrorCode, t as toHttpPath } from '../../shared/client.BvXDSBF5.mjs';
2
2
  import '@orpc/shared';
3
3
  import '@orpc/standard-server';
4
- import '../../shared/client.CRWEpqLB.mjs';
4
+ import '../../shared/client.BngOL3Ai.mjs';
@@ -1,19 +1,19 @@
1
1
  import { StandardRequest, StandardLazyResponse } from '@orpc/standard-server';
2
- import { a as ClientContext, b as ClientOptions } from '../../shared/client.4TS_0JaO.mjs';
3
- import { f as StandardLinkClient } from '../../shared/client.ds1abV85.mjs';
4
- import { f as StandardRPCLinkOptions, g as StandardRPCLink } from '../../shared/client.ClwIM_ku.mjs';
2
+ import { b as ClientContext, c as ClientOptions } from '../../shared/client.BOYsZIRq.mjs';
3
+ import { f as StandardLinkClient } from '../../shared/client.C4VxIexA.mjs';
4
+ import { f as StandardRPCLinkOptions, g as StandardRPCLink } from '../../shared/client.aTp4sII-.mjs';
5
5
  import '@orpc/shared';
6
6
 
7
- interface experimental_LinkWebsocketClientOptions {
8
- websocket: Pick<WebSocket, 'addEventListener' | 'send'>;
7
+ interface LinkWebsocketClientOptions {
8
+ websocket: Pick<WebSocket, 'addEventListener' | 'send' | 'readyState'>;
9
9
  }
10
- declare class experimental_LinkWebsocketClient<T extends ClientContext> implements StandardLinkClient<T> {
10
+ declare class LinkWebsocketClient<T extends ClientContext> implements StandardLinkClient<T> {
11
11
  private readonly peer;
12
- constructor(options: experimental_LinkWebsocketClientOptions);
12
+ constructor(options: LinkWebsocketClientOptions);
13
13
  call(request: StandardRequest, _options: ClientOptions<T>, _path: readonly string[], _input: unknown): Promise<StandardLazyResponse>;
14
14
  }
15
15
 
16
- interface experimental_RPCLinkOptions<T extends ClientContext> extends Omit<StandardRPCLinkOptions<T>, 'url' | 'headers' | 'method' | 'fallbackMethod' | 'maxUrlLength'>, experimental_LinkWebsocketClientOptions {
16
+ interface RPCLinkOptions<T extends ClientContext> extends Omit<StandardRPCLinkOptions<T>, 'url' | 'headers' | 'method' | 'fallbackMethod' | 'maxUrlLength'>, LinkWebsocketClientOptions {
17
17
  }
18
18
  /**
19
19
  * The RPC Link communicates with the server using the RPC protocol over WebSocket.
@@ -21,9 +21,9 @@ interface experimental_RPCLinkOptions<T extends ClientContext> extends Omit<Stan
21
21
  * @see {@link https://orpc.unnoq.com/docs/client/rpc-link RPC Link Docs}
22
22
  * @see {@link https://orpc.unnoq.com/docs/adapters/websocket WebSocket Adapter Docs}
23
23
  */
24
- declare class experimental_RPCLink<T extends ClientContext> extends StandardRPCLink<T> {
25
- constructor(options: experimental_RPCLinkOptions<T>);
24
+ declare class RPCLink<T extends ClientContext> extends StandardRPCLink<T> {
25
+ constructor(options: RPCLinkOptions<T>);
26
26
  }
27
27
 
28
- export { experimental_LinkWebsocketClient, experimental_RPCLink };
29
- export type { experimental_LinkWebsocketClientOptions, experimental_RPCLinkOptions };
28
+ export { LinkWebsocketClient, RPCLink };
29
+ export type { LinkWebsocketClientOptions, RPCLinkOptions };
@@ -1,19 +1,19 @@
1
1
  import { StandardRequest, StandardLazyResponse } from '@orpc/standard-server';
2
- import { a as ClientContext, b as ClientOptions } from '../../shared/client.4TS_0JaO.js';
3
- import { f as StandardLinkClient } from '../../shared/client.7ZYxJok_.js';
4
- import { f as StandardRPCLinkOptions, g as StandardRPCLink } from '../../shared/client.B2432-Lu.js';
2
+ import { b as ClientContext, c as ClientOptions } from '../../shared/client.BOYsZIRq.js';
3
+ import { f as StandardLinkClient } from '../../shared/client.CXXEPIbK.js';
4
+ import { f as StandardRPCLinkOptions, g as StandardRPCLink } from '../../shared/client.WCinBImJ.js';
5
5
  import '@orpc/shared';
6
6
 
7
- interface experimental_LinkWebsocketClientOptions {
8
- websocket: Pick<WebSocket, 'addEventListener' | 'send'>;
7
+ interface LinkWebsocketClientOptions {
8
+ websocket: Pick<WebSocket, 'addEventListener' | 'send' | 'readyState'>;
9
9
  }
10
- declare class experimental_LinkWebsocketClient<T extends ClientContext> implements StandardLinkClient<T> {
10
+ declare class LinkWebsocketClient<T extends ClientContext> implements StandardLinkClient<T> {
11
11
  private readonly peer;
12
- constructor(options: experimental_LinkWebsocketClientOptions);
12
+ constructor(options: LinkWebsocketClientOptions);
13
13
  call(request: StandardRequest, _options: ClientOptions<T>, _path: readonly string[], _input: unknown): Promise<StandardLazyResponse>;
14
14
  }
15
15
 
16
- interface experimental_RPCLinkOptions<T extends ClientContext> extends Omit<StandardRPCLinkOptions<T>, 'url' | 'headers' | 'method' | 'fallbackMethod' | 'maxUrlLength'>, experimental_LinkWebsocketClientOptions {
16
+ interface RPCLinkOptions<T extends ClientContext> extends Omit<StandardRPCLinkOptions<T>, 'url' | 'headers' | 'method' | 'fallbackMethod' | 'maxUrlLength'>, LinkWebsocketClientOptions {
17
17
  }
18
18
  /**
19
19
  * The RPC Link communicates with the server using the RPC protocol over WebSocket.
@@ -21,9 +21,9 @@ interface experimental_RPCLinkOptions<T extends ClientContext> extends Omit<Stan
21
21
  * @see {@link https://orpc.unnoq.com/docs/client/rpc-link RPC Link Docs}
22
22
  * @see {@link https://orpc.unnoq.com/docs/adapters/websocket WebSocket Adapter Docs}
23
23
  */
24
- declare class experimental_RPCLink<T extends ClientContext> extends StandardRPCLink<T> {
25
- constructor(options: experimental_RPCLinkOptions<T>);
24
+ declare class RPCLink<T extends ClientContext> extends StandardRPCLink<T> {
25
+ constructor(options: RPCLinkOptions<T>);
26
26
  }
27
27
 
28
- export { experimental_LinkWebsocketClient, experimental_RPCLink };
29
- export type { experimental_LinkWebsocketClientOptions, experimental_RPCLinkOptions };
28
+ export { LinkWebsocketClient, RPCLink };
29
+ export type { LinkWebsocketClientOptions, RPCLinkOptions };
@@ -1,15 +1,28 @@
1
+ import { readAsBuffer } from '@orpc/shared';
1
2
  import { ClientPeer } from '@orpc/standard-server-peer';
2
- import '@orpc/shared';
3
- import { c as StandardRPCLink } from '../../shared/client.DpICn1BD.mjs';
3
+ import { c as StandardRPCLink } from '../../shared/client.BvXDSBF5.mjs';
4
4
  import '@orpc/standard-server';
5
- import '../../shared/client.CRWEpqLB.mjs';
5
+ import '../../shared/client.BngOL3Ai.mjs';
6
6
 
7
- class experimental_LinkWebsocketClient {
7
+ class LinkWebsocketClient {
8
8
  peer;
9
9
  constructor(options) {
10
- this.peer = new ClientPeer(options.websocket.send.bind(options.websocket));
11
- options.websocket.addEventListener("message", (event) => {
12
- this.peer.message(event.data);
10
+ const untilOpen = new Promise((resolve) => {
11
+ if (options.websocket.readyState === 0) {
12
+ options.websocket.addEventListener("open", () => {
13
+ resolve();
14
+ }, { once: true });
15
+ } else {
16
+ resolve();
17
+ }
18
+ });
19
+ this.peer = new ClientPeer(async (message) => {
20
+ await untilOpen;
21
+ return options.websocket.send(message);
22
+ });
23
+ options.websocket.addEventListener("message", async (event) => {
24
+ const message = event.data instanceof Blob ? await readAsBuffer(event.data) : event.data;
25
+ this.peer.message(message);
13
26
  });
14
27
  options.websocket.addEventListener("close", () => {
15
28
  this.peer.close();
@@ -21,11 +34,11 @@ class experimental_LinkWebsocketClient {
21
34
  }
22
35
  }
23
36
 
24
- class experimental_RPCLink extends StandardRPCLink {
37
+ class RPCLink extends StandardRPCLink {
25
38
  constructor(options) {
26
- const linkClient = new experimental_LinkWebsocketClient(options);
39
+ const linkClient = new LinkWebsocketClient(options);
27
40
  super(linkClient, { ...options, url: "orpc:/" });
28
41
  }
29
42
  }
30
43
 
31
- export { experimental_LinkWebsocketClient, experimental_RPCLink };
44
+ export { LinkWebsocketClient, RPCLink };
package/dist/index.d.mts CHANGED
@@ -1,14 +1,14 @@
1
- import { N as NestedClient, C as ClientLink, I as InferClientContext, a as ClientContext, b as ClientOptions, c as ClientPromiseResult, F as FriendlyClientOptions } from './shared/client.4TS_0JaO.mjs';
2
- export { f as Client, e as ClientRest, d as HTTPMethod, H as HTTPPath } from './shared/client.4TS_0JaO.mjs';
3
- import { Promisable, MaybeOptionalOptions, ThrowableError } from '@orpc/shared';
4
- export { Registry, ThrowableError, onError, onFinish, onStart, onSuccess } from '@orpc/shared';
1
+ import { N as NestedClient, C as ClientLink, I as InferClientContext, a as ClientPromiseResult, b as ClientContext, F as FriendlyClientOptions, c as ClientOptions, d as Client, e as ClientRest } from './shared/client.BOYsZIRq.mjs';
2
+ export { f as HTTPMethod, H as HTTPPath } from './shared/client.BOYsZIRq.mjs';
3
+ import { MaybeOptionalOptions, ThrowableError, Promisable, AsyncIteratorClass } from '@orpc/shared';
4
+ export { EventPublisher, EventPublisherOptions, EventPublisherSubscribeIteratorOptions, Registry, ThrowableError, asyncIteratorToStream as eventIteratorToStream, onError, onFinish, onStart, onSuccess, streamToAsyncIteratorClass as streamToEventIterator } from '@orpc/shared';
5
5
  export { ErrorEvent } from '@orpc/standard-server';
6
6
 
7
7
  interface createORPCClientOptions {
8
8
  /**
9
9
  * Use as base path for all procedure, useful when you only want to call a subset of the procedure.
10
10
  */
11
- path?: string[];
11
+ path?: readonly string[];
12
12
  }
13
13
  /**
14
14
  * Create a oRPC client-side client from a link.
@@ -17,18 +17,6 @@ interface createORPCClientOptions {
17
17
  */
18
18
  declare function createORPCClient<T extends NestedClient<any>>(link: ClientLink<InferClientContext<T>>, options?: createORPCClientOptions): T;
19
19
 
20
- /**
21
- * DynamicLink provides a way to dynamically resolve and delegate calls to other ClientLinks
22
- * based on the request path, input, and context.
23
- *
24
- * @see {@link https://orpc.unnoq.com/docs/client/dynamic-link Dynamic Link Docs}
25
- */
26
- declare class DynamicLink<TClientContext extends ClientContext> implements ClientLink<TClientContext> {
27
- private readonly linkResolver;
28
- constructor(linkResolver: (options: ClientOptions<TClientContext>, path: readonly string[], input: unknown) => Promisable<ClientLink<TClientContext>>);
29
- call(path: readonly string[], input: unknown, options: ClientOptions<TClientContext>): Promise<unknown>;
30
- }
31
-
32
20
  declare const COMMON_ORPC_ERROR_DEFS: {
33
21
  readonly BAD_REQUEST: {
34
22
  readonly status: 400;
@@ -125,7 +113,7 @@ declare class ORPCError<TCode extends ORPCErrorCode, TData> extends Error {
125
113
  readonly code: TCode;
126
114
  readonly status: number;
127
115
  readonly data: TData;
128
- constructor(code: TCode, ...[options]: MaybeOptionalOptions<ORPCErrorOptions<TData>>);
116
+ constructor(code: TCode, ...rest: MaybeOptionalOptions<ORPCErrorOptions<TData>>);
129
117
  toJSON(): ORPCErrorJSON<TCode, TData>;
130
118
  }
131
119
  type ORPCErrorJSON<TCode extends string, TData> = Pick<ORPCError<TCode, TData>, 'defined' | 'code' | 'status' | 'message' | 'data'>;
@@ -135,11 +123,6 @@ declare function isORPCErrorStatus(status: number): boolean;
135
123
  declare function isORPCErrorJson(json: unknown): json is ORPCErrorJSON<ORPCErrorCode, unknown>;
136
124
  declare function createORPCErrorFromJson<TCode extends ORPCErrorCode, TData>(json: ORPCErrorJSON<TCode, TData>, options?: ErrorOptions): ORPCError<TCode, TData>;
137
125
 
138
- declare function mapEventIterator<TYield, TReturn, TNext, TMap = TYield | TReturn>(iterator: AsyncIterator<TYield, TReturn, TNext>, maps: {
139
- value: (value: NoInfer<TYield | TReturn>, done: boolean | undefined) => Promise<TMap>;
140
- error: (error: unknown) => Promise<unknown>;
141
- }): AsyncGenerator<TMap, TMap, TNext>;
142
-
143
126
  type SafeResult<TOutput, TError> = [error: null, data: TOutput, isDefined: false, isSuccess: true] & {
144
127
  error: null;
145
128
  data: TOutput;
@@ -165,5 +148,38 @@ type SafeResult<TOutput, TError> = [error: null, data: TOutput, isDefined: false
165
148
  declare function safe<TOutput, TError = ThrowableError>(promise: ClientPromiseResult<TOutput, TError>): Promise<SafeResult<TOutput, TError>>;
166
149
  declare function resolveFriendlyClientOptions<T extends ClientContext>(options: FriendlyClientOptions<T>): ClientOptions<T>;
167
150
 
168
- export { COMMON_ORPC_ERROR_DEFS, ClientContext, ClientLink, ClientOptions, ClientPromiseResult, DynamicLink, FriendlyClientOptions, InferClientContext, NestedClient, ORPCError, createORPCClient, createORPCErrorFromJson, fallbackORPCErrorMessage, fallbackORPCErrorStatus, isDefinedError, isORPCErrorJson, isORPCErrorStatus, mapEventIterator, resolveFriendlyClientOptions, safe, toORPCError };
169
- export type { CommonORPCErrorCode, ORPCErrorCode, ORPCErrorJSON, ORPCErrorOptions, SafeResult, createORPCClientOptions };
151
+ type SafeClient<T extends NestedClient<any>> = T extends Client<infer UContext, infer UInput, infer UOutput, infer UError> ? (...rest: ClientRest<UContext, UInput>) => Promise<SafeResult<UOutput, UError>> : {
152
+ [K in keyof T]: T[K] extends NestedClient<any> ? SafeClient<T[K]> : never;
153
+ };
154
+ /**
155
+ * Create a safe client that automatically wraps all procedure calls with the `safe` util.
156
+ *
157
+ * @example
158
+ * ```ts
159
+ * const safeClient = createSafeClient(client)
160
+ * const { error, data, isDefined } = await safeClient.doSomething({ id: '123' })
161
+ * ```
162
+ *
163
+ * @see {@link https://orpc.unnoq.com/docs/client/error-handling#using-createsafeclient Safe Client Docs}
164
+ */
165
+ declare function createSafeClient<T extends NestedClient<any>>(client: T): SafeClient<T>;
166
+
167
+ /**
168
+ * DynamicLink provides a way to dynamically resolve and delegate calls to other ClientLinks
169
+ * based on the request path, input, and context.
170
+ *
171
+ * @see {@link https://orpc.unnoq.com/docs/client/dynamic-link Dynamic Link Docs}
172
+ */
173
+ declare class DynamicLink<TClientContext extends ClientContext> implements ClientLink<TClientContext> {
174
+ private readonly linkResolver;
175
+ constructor(linkResolver: (options: ClientOptions<TClientContext>, path: readonly string[], input: unknown) => Promisable<ClientLink<TClientContext>>);
176
+ call(path: readonly string[], input: unknown, options: ClientOptions<TClientContext>): Promise<unknown>;
177
+ }
178
+
179
+ declare function mapEventIterator<TYield, TReturn, TNext, TMap = TYield | TReturn>(iterator: AsyncIterator<TYield, TReturn, TNext>, maps: {
180
+ value: (value: NoInfer<TYield | TReturn>, done: boolean | undefined) => Promise<TMap>;
181
+ error: (error: unknown) => Promise<unknown>;
182
+ }): AsyncIteratorClass<TMap, TMap, TNext>;
183
+
184
+ export { COMMON_ORPC_ERROR_DEFS, Client, ClientContext, ClientLink, ClientOptions, ClientPromiseResult, ClientRest, DynamicLink, FriendlyClientOptions, InferClientContext, NestedClient, ORPCError, createORPCClient, createORPCErrorFromJson, createSafeClient, fallbackORPCErrorMessage, fallbackORPCErrorStatus, isDefinedError, isORPCErrorJson, isORPCErrorStatus, mapEventIterator, resolveFriendlyClientOptions, safe, toORPCError };
185
+ export type { CommonORPCErrorCode, ORPCErrorCode, ORPCErrorJSON, ORPCErrorOptions, SafeClient, SafeResult, createORPCClientOptions };