@orpc/server 2.0.0-beta.2 → 2.0.0-beta.21

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.
Files changed (46) hide show
  1. package/README.md +32 -21
  2. package/dist/adapters/crossws/index.d.mts +11 -8
  3. package/dist/adapters/crossws/index.d.ts +11 -8
  4. package/dist/adapters/crossws/index.mjs +10 -7
  5. package/dist/adapters/fetch/index.d.mts +8 -56
  6. package/dist/adapters/fetch/index.d.ts +8 -56
  7. package/dist/adapters/fetch/index.mjs +6 -136
  8. package/dist/adapters/message-port/index.d.mts +11 -13
  9. package/dist/adapters/message-port/index.d.ts +11 -13
  10. package/dist/adapters/message-port/index.mjs +28 -32
  11. package/dist/adapters/node/index.d.mts +7 -37
  12. package/dist/adapters/node/index.d.ts +7 -37
  13. package/dist/adapters/node/index.mjs +6 -112
  14. package/dist/adapters/standard/index.d.mts +6 -6
  15. package/dist/adapters/standard/index.d.ts +6 -6
  16. package/dist/adapters/standard/index.mjs +3 -3
  17. package/dist/adapters/standard-peer/index.d.mts +2 -2
  18. package/dist/adapters/standard-peer/index.d.ts +2 -2
  19. package/dist/adapters/websocket/index.d.mts +36 -26
  20. package/dist/adapters/websocket/index.d.ts +36 -26
  21. package/dist/adapters/websocket/index.mjs +33 -25
  22. package/dist/extensions/callable.d.mts +1 -1
  23. package/dist/extensions/callable.d.ts +1 -1
  24. package/dist/extensions/callable.mjs +2 -2
  25. package/dist/helpers/index.d.mts +3 -3
  26. package/dist/helpers/index.d.ts +3 -3
  27. package/dist/helpers/index.mjs +13 -5
  28. package/dist/index.d.mts +19 -16
  29. package/dist/index.d.ts +19 -16
  30. package/dist/index.mjs +36 -22
  31. package/dist/plugins/index.d.mts +136 -5
  32. package/dist/plugins/index.d.ts +136 -5
  33. package/dist/plugins/index.mjs +394 -6
  34. package/dist/shared/{server.BsNNjG5J.d.mts → server.15O7oC1p.d.mts} +1 -1
  35. package/dist/shared/{server.B_U9y00a.d.mts → server.B4BnEWWm.d.mts} +6 -5
  36. package/dist/shared/{server.EOHJ3NJr.d.ts → server.BhsVw7m7.d.ts} +2 -2
  37. package/dist/shared/{server.BwHnWUuN.mjs → server.BoiFpNT7.mjs} +4 -2
  38. package/dist/shared/{server.GDpX6Df8.mjs → server.COPVXhDG.mjs} +3 -3
  39. package/dist/shared/{server.BL22TloH.d.mts → server.CcR4kgje.d.mts} +25 -3
  40. package/dist/shared/{server.BL22TloH.d.ts → server.CcR4kgje.d.ts} +25 -3
  41. package/dist/shared/{server.T9F3bzZx.d.ts → server.CnN50DHH.d.ts} +6 -5
  42. package/dist/shared/{server.CjOb6ItT.mjs → server.DBs0rrf9.mjs} +1 -1
  43. package/dist/shared/{server.BB_Ik9Ph.d.mts → server.DDFizwfU.d.mts} +2 -2
  44. package/dist/shared/{server.CrlKQucM.mjs → server.DofEOwf-.mjs} +11 -7
  45. package/dist/shared/{server.Pa0F03f_.d.ts → server.m3szVJGU.d.ts} +1 -1
  46. package/package.json +9 -10
@@ -1,11 +1,11 @@
1
1
  import { SupportedMessagePort } from '@orpc/client/message-port';
2
2
  import { Value, Promisable, MaybeOptionalOptions } from '@orpc/shared';
3
3
  import { ServerPeer, EncodePeerMessageOptions, DecodePeerMessageOptions } from '@standardserver/peer';
4
- import { C as Context } from '../../shared/server.BL22TloH.mjs';
5
- import { S as StandardHandler, a as StandardHandlerOptions } from '../../shared/server.BB_Ik9Ph.mjs';
4
+ import { C as Context } from '../../shared/server.CcR4kgje.mjs';
5
+ import { S as StandardHandler, a as StandardHandlerOptions } from '../../shared/server.DDFizwfU.mjs';
6
6
  import { StandardPeerRequestHandlerOptions } from '../standard-peer/index.mjs';
7
- import { R as Router } from '../../shared/server.BsNNjG5J.mjs';
8
- import { R as RPCHandlerCodecOptions } from '../../shared/server.B_U9y00a.mjs';
7
+ import { R as Router } from '../../shared/server.15O7oC1p.mjs';
8
+ import { R as RPCHandlerCodecOptions } from '../../shared/server.B4BnEWWm.mjs';
9
9
  import '@orpc/client';
10
10
  import '@orpc/contract';
11
11
  import '@standardserver/core';
@@ -41,25 +41,23 @@ declare class MessagePortHandler<T extends Context> {
41
41
  private readonly decodePeerMessageOptions;
42
42
  constructor(handler: StandardHandler<T>, options?: NoInfer<MessagePortHandlerOptions<T>>);
43
43
  /**
44
- * Attaches necessary event listeners to a message port to handle incoming messages and peer management.
44
+ * Attaches message and close listeners to a message port.
45
+ *
46
+ * Prefer this over calling `.message()` and `.close()` manually.
45
47
  */
46
48
  upgrade(port: SupportedMessagePort, ...rest: MaybeOptionalOptions<StandardPeerRequestHandlerOptions<T>>): void;
47
49
  /**
48
50
  * Handles a single message received from a message port.
49
51
  *
50
- * @warning AVOID calling this method directly if `.upgrade()` is used, as `.upgrade()` already sets up necessary event listeners to call this method for incoming messages and manage peer lifecycle.
51
- *
52
- * @param port The message port instance, require consistent instance across messages for proper peer management
52
+ * @param port The message port instance. Use the same instance for all messages.
53
53
  */
54
- message(port: SupportedMessagePort, data: any, ...rest: MaybeOptionalOptions<StandardPeerRequestHandlerOptions<T>>): Promise<{
54
+ message(port: SupportedMessagePort, data: unknown, ...rest: MaybeOptionalOptions<StandardPeerRequestHandlerOptions<T>>): Promise<{
55
55
  matched: boolean;
56
56
  }>;
57
57
  /**
58
- * Called when a message port is closed, to clean up any associated peer state.
59
- *
60
- * @warning AVOID calling this method directly if `.upgrade()` is used, as `.upgrade()` already sets up necessary event listeners to call this method for incoming messages and manage peer lifecycle.
58
+ * Cleans up peer state for a closed message port.
61
59
  *
62
- * @param port The message port instance to clean up, must be the same instance used in `.message()` calls to properly clean up
60
+ * @param port The same message port instance passed to `.message()`.
63
61
  */
64
62
  close(port: SupportedMessagePort): Promise<void>;
65
63
  }
@@ -1,11 +1,11 @@
1
1
  import { SupportedMessagePort } from '@orpc/client/message-port';
2
2
  import { Value, Promisable, MaybeOptionalOptions } from '@orpc/shared';
3
3
  import { ServerPeer, EncodePeerMessageOptions, DecodePeerMessageOptions } from '@standardserver/peer';
4
- import { C as Context } from '../../shared/server.BL22TloH.js';
5
- import { S as StandardHandler, a as StandardHandlerOptions } from '../../shared/server.EOHJ3NJr.js';
4
+ import { C as Context } from '../../shared/server.CcR4kgje.js';
5
+ import { S as StandardHandler, a as StandardHandlerOptions } from '../../shared/server.BhsVw7m7.js';
6
6
  import { StandardPeerRequestHandlerOptions } from '../standard-peer/index.js';
7
- import { R as Router } from '../../shared/server.Pa0F03f_.js';
8
- import { R as RPCHandlerCodecOptions } from '../../shared/server.T9F3bzZx.js';
7
+ import { R as Router } from '../../shared/server.m3szVJGU.js';
8
+ import { R as RPCHandlerCodecOptions } from '../../shared/server.CnN50DHH.js';
9
9
  import '@orpc/client';
10
10
  import '@orpc/contract';
11
11
  import '@standardserver/core';
@@ -41,25 +41,23 @@ declare class MessagePortHandler<T extends Context> {
41
41
  private readonly decodePeerMessageOptions;
42
42
  constructor(handler: StandardHandler<T>, options?: NoInfer<MessagePortHandlerOptions<T>>);
43
43
  /**
44
- * Attaches necessary event listeners to a message port to handle incoming messages and peer management.
44
+ * Attaches message and close listeners to a message port.
45
+ *
46
+ * Prefer this over calling `.message()` and `.close()` manually.
45
47
  */
46
48
  upgrade(port: SupportedMessagePort, ...rest: MaybeOptionalOptions<StandardPeerRequestHandlerOptions<T>>): void;
47
49
  /**
48
50
  * Handles a single message received from a message port.
49
51
  *
50
- * @warning AVOID calling this method directly if `.upgrade()` is used, as `.upgrade()` already sets up necessary event listeners to call this method for incoming messages and manage peer lifecycle.
51
- *
52
- * @param port The message port instance, require consistent instance across messages for proper peer management
52
+ * @param port The message port instance. Use the same instance for all messages.
53
53
  */
54
- message(port: SupportedMessagePort, data: any, ...rest: MaybeOptionalOptions<StandardPeerRequestHandlerOptions<T>>): Promise<{
54
+ message(port: SupportedMessagePort, data: unknown, ...rest: MaybeOptionalOptions<StandardPeerRequestHandlerOptions<T>>): Promise<{
55
55
  matched: boolean;
56
56
  }>;
57
57
  /**
58
- * Called when a message port is closed, to clean up any associated peer state.
59
- *
60
- * @warning AVOID calling this method directly if `.upgrade()` is used, as `.upgrade()` already sets up necessary event listeners to call this method for incoming messages and manage peer lifecycle.
58
+ * Cleans up peer state for a closed message port.
61
59
  *
62
- * @param port The message port instance to clean up, must be the same instance used in `.message()` calls to properly clean up
60
+ * @param port The same message port instance passed to `.message()`.
63
61
  */
64
62
  close(port: SupportedMessagePort): Promise<void>;
65
63
  }
@@ -1,13 +1,13 @@
1
1
  import { onMessagePortMessage, onMessagePortClose, postMessagePortMessage } from '@orpc/client/message-port';
2
- import { value, isPlainObject, resolveMaybeOptionalOptions, toStringOrBytes } from '@orpc/shared';
3
- import { ServerPeer, encodePeerMessage, decodePeerMessage, isClientPeerSendMessage } from '@standardserver/peer';
2
+ import { value, resolveMaybeOptionalOptions } from '@orpc/shared';
3
+ import { ServerPeer, encodePeerMessage, decodePeerMessage, isClientPeerSendMessage, isPeerMessage } from '@standardserver/peer';
4
4
  import { c as createStandardPeerRequestHandler } from '../../shared/server.CX4vUnDk.mjs';
5
- import { R as RPCHandlerCodec, S as StandardHandler } from '../../shared/server.GDpX6Df8.mjs';
5
+ import { R as RPCHandlerCodec, S as StandardHandler } from '../../shared/server.COPVXhDG.mjs';
6
6
  import '@orpc/client';
7
7
  import '@standardserver/core';
8
- import '../../shared/server.CrlKQucM.mjs';
8
+ import '../../shared/server.DofEOwf-.mjs';
9
9
  import '@orpc/contract';
10
- import '../../shared/server.BwHnWUuN.mjs';
10
+ import '../../shared/server.BoiFpNT7.mjs';
11
11
 
12
12
  class MessagePortHandler {
13
13
  constructor(handler, options = {}) {
@@ -21,7 +21,9 @@ class MessagePortHandler {
21
21
  encodePeerMessageOptions;
22
22
  decodePeerMessageOptions;
23
23
  /**
24
- * Attaches necessary event listeners to a message port to handle incoming messages and peer management.
24
+ * Attaches message and close listeners to a message port.
25
+ *
26
+ * Prefer this over calling `.message()` and `.close()` manually.
25
27
  */
26
28
  upgrade(port, ...rest) {
27
29
  onMessagePortMessage(port, (message) => this.message(port, message, ...rest));
@@ -30,51 +32,45 @@ class MessagePortHandler {
30
32
  /**
31
33
  * Handles a single message received from a message port.
32
34
  *
33
- * @warning AVOID calling this method directly if `.upgrade()` is used, as `.upgrade()` already sets up necessary event listeners to call this method for incoming messages and manage peer lifecycle.
34
- *
35
- * @param port The message port instance, require consistent instance across messages for proper peer management
35
+ * @param port The message port instance. Use the same instance for all messages.
36
36
  */
37
37
  async message(port, data, ...rest) {
38
38
  let peer = this.peers.get(port);
39
39
  if (!peer) {
40
- this.peers.set(port, peer = new ServerPeer(async (message2) => {
41
- const transfer = await value(this.transfer, message2, port);
40
+ this.peers.set(port, peer = new ServerPeer(async (message) => {
41
+ const transfer = await value(this.transfer, message, port);
42
42
  if (transfer) {
43
- postMessagePortMessage(port, message2, transfer);
43
+ postMessagePortMessage(port, message, transfer);
44
44
  } else {
45
- postMessagePortMessage(port, await encodePeerMessage(message2, this.encodePeerMessageOptions));
45
+ postMessagePortMessage(port, await encodePeerMessage(message, this.encodePeerMessageOptions));
46
46
  }
47
47
  }));
48
48
  }
49
- if (isPlainObject(data)) {
50
- await peer.message(
51
- data,
52
- createStandardPeerRequestHandler(this.handler, resolveMaybeOptionalOptions(rest))
53
- );
54
- return { matched: true };
49
+ let peerMessage;
50
+ if (typeof data === "string" || data instanceof Uint8Array) {
51
+ const result = decodePeerMessage(data, this.decodePeerMessageOptions);
52
+ if (result.matched && isClientPeerSendMessage(result.message)) {
53
+ peerMessage = result.message;
54
+ }
55
+ } else if (isPeerMessage(data) && isClientPeerSendMessage(data)) {
56
+ peerMessage = data;
55
57
  }
56
- const message = await toStringOrBytes(data);
57
- const result = decodePeerMessage(message, this.decodePeerMessageOptions);
58
- if (result.matched && isClientPeerSendMessage(result.message)) {
59
- await peer.message(
60
- result.message,
61
- createStandardPeerRequestHandler(this.handler, resolveMaybeOptionalOptions(rest))
62
- );
58
+ if (peerMessage === void 0) {
59
+ return { matched: false };
63
60
  }
64
- return result;
61
+ await peer.message(peerMessage, createStandardPeerRequestHandler(this.handler, resolveMaybeOptionalOptions(rest)));
62
+ return { matched: true };
65
63
  }
66
64
  /**
67
- * Called when a message port is closed, to clean up any associated peer state.
68
- *
69
- * @warning AVOID calling this method directly if `.upgrade()` is used, as `.upgrade()` already sets up necessary event listeners to call this method for incoming messages and manage peer lifecycle.
65
+ * Cleans up peer state for a closed message port.
70
66
  *
71
- * @param port The message port instance to clean up, must be the same instance used in `.message()` calls to properly clean up
67
+ * @param port The same message port instance passed to `.message()`.
72
68
  */
73
69
  async close(port) {
74
70
  const peer = this.peers.get(port);
75
71
  if (peer) {
76
- await peer.close();
77
72
  this.peers.delete(port);
73
+ await peer.close();
78
74
  }
79
75
  }
80
76
  }
@@ -1,11 +1,10 @@
1
- import { SendStandardResponseOptions, NodeHttpRequest, NodeHttpResponse } from '@standardserver/node';
2
- import { C as Context } from '../../shared/server.BL22TloH.mjs';
3
1
  import { Interceptor, MaybeOptionalOptions } from '@orpc/shared';
4
- import { e as StandardHandlerPlugin, b as StandardHandlerHandleOptions, S as StandardHandler, a as StandardHandlerOptions } from '../../shared/server.BB_Ik9Ph.mjs';
2
+ import { SendStandardResponseOptions, NodeHttpRequest, NodeHttpResponse } from '@standardserver/node';
3
+ import { C as Context } from '../../shared/server.CcR4kgje.mjs';
4
+ import { e as StandardHandlerPlugin, b as StandardHandlerHandleOptions, S as StandardHandler, a as StandardHandlerOptions } from '../../shared/server.DDFizwfU.mjs';
5
5
  import { FriendlyStandardHandlerHandleOptions } from '../standard/index.mjs';
6
- import compression from '@orpc/interop/compression';
7
- import { R as Router } from '../../shared/server.BsNNjG5J.mjs';
8
- import { R as RPCHandlerCodecOptions } from '../../shared/server.B_U9y00a.mjs';
6
+ import { R as Router } from '../../shared/server.15O7oC1p.mjs';
7
+ import { R as RPCHandlerCodecOptions } from '../../shared/server.B4BnEWWm.mjs';
9
8
  import '@orpc/client';
10
9
  import '@orpc/contract';
11
10
  import '@standardserver/core';
@@ -71,35 +70,6 @@ declare class NodeHttpHandler<T extends Context> {
71
70
  handle(request: NodeHttpRequest, response: NodeHttpResponse, ...rest: MaybeOptionalOptions<FriendlyStandardHandlerHandleOptions<T>>): Promise<NodeHttpHandlerHandleResult>;
72
71
  }
73
72
 
74
- interface BodyCompressionHandlerPluginOptions extends compression.CompressionOptions {
75
- /**
76
- * Override the default content-type filter used to determine which responses should be compressed.
77
- *
78
- * @warning Event stream responses are never compressed, regardless of this filter's return value.
79
- * @default only responses with compressible content types are compressed.
80
- */
81
- filter?: (request: NodeHttpRequest, response: NodeHttpResponse) => boolean;
82
- }
83
- declare class BodyCompressionHandlerPlugin<T extends Context> implements NodeHttpHandlerPlugin<T> {
84
- name: string;
85
- private readonly compressionHandler;
86
- constructor(options?: BodyCompressionHandlerPluginOptions);
87
- initNodeHttpHandlerOptions(options: NodeHttpHandlerOptions<T>): NodeHttpHandlerOptions<T>;
88
- }
89
-
90
- interface BodyLimitHandlerPluginOptions {
91
- /**
92
- * The maximum size of the body in bytes.
93
- */
94
- maxBodySize: number;
95
- }
96
- declare class BodyLimitHandlerPlugin<T extends Context> implements NodeHttpHandlerPlugin<T> {
97
- name: string;
98
- private readonly maxBodySize;
99
- constructor(options: BodyLimitHandlerPluginOptions);
100
- initNodeHttpHandlerOptions(options: NodeHttpHandlerOptions<T>): NodeHttpHandlerOptions<T>;
101
- }
102
-
103
73
  interface RPCHandlerOptions<T extends Context> extends NodeHttpHandlerOptions<T>, Omit<StandardHandlerOptions<T>, 'plugins'>, RPCHandlerCodecOptions<T> {
104
74
  /**
105
75
  * Configuration for {@link CSRFGuardHandlerPlugin}, which is enabled by default for `RPCHandler` over HTTP.
@@ -117,5 +87,5 @@ declare class RPCHandler<T extends Context> extends NodeHttpHandler<T> {
117
87
  constructor(router: Router<T>, options?: NoInfer<RPCHandlerOptions<T>>);
118
88
  }
119
89
 
120
- export { BodyCompressionHandlerPlugin, BodyLimitHandlerPlugin, CompositeNodeHttpHandlerPlugin, NodeHttpHandler, RPCHandler };
121
- export type { BodyCompressionHandlerPluginOptions, BodyLimitHandlerPluginOptions, NodeHttpHandlerHandleResult, NodeHttpHandlerNodeHttpInterceptor, NodeHttpHandlerNodeHttpInterceptorOptions, NodeHttpHandlerOptions, NodeHttpHandlerPlugin, RPCHandlerOptions };
90
+ export { CompositeNodeHttpHandlerPlugin, NodeHttpHandler, RPCHandler };
91
+ export type { NodeHttpHandlerHandleResult, NodeHttpHandlerNodeHttpInterceptor, NodeHttpHandlerNodeHttpInterceptorOptions, NodeHttpHandlerOptions, NodeHttpHandlerPlugin, RPCHandlerOptions };
@@ -1,11 +1,10 @@
1
- import { SendStandardResponseOptions, NodeHttpRequest, NodeHttpResponse } from '@standardserver/node';
2
- import { C as Context } from '../../shared/server.BL22TloH.js';
3
1
  import { Interceptor, MaybeOptionalOptions } from '@orpc/shared';
4
- import { e as StandardHandlerPlugin, b as StandardHandlerHandleOptions, S as StandardHandler, a as StandardHandlerOptions } from '../../shared/server.EOHJ3NJr.js';
2
+ import { SendStandardResponseOptions, NodeHttpRequest, NodeHttpResponse } from '@standardserver/node';
3
+ import { C as Context } from '../../shared/server.CcR4kgje.js';
4
+ import { e as StandardHandlerPlugin, b as StandardHandlerHandleOptions, S as StandardHandler, a as StandardHandlerOptions } from '../../shared/server.BhsVw7m7.js';
5
5
  import { FriendlyStandardHandlerHandleOptions } from '../standard/index.js';
6
- import compression from '@orpc/interop/compression';
7
- import { R as Router } from '../../shared/server.Pa0F03f_.js';
8
- import { R as RPCHandlerCodecOptions } from '../../shared/server.T9F3bzZx.js';
6
+ import { R as Router } from '../../shared/server.m3szVJGU.js';
7
+ import { R as RPCHandlerCodecOptions } from '../../shared/server.CnN50DHH.js';
9
8
  import '@orpc/client';
10
9
  import '@orpc/contract';
11
10
  import '@standardserver/core';
@@ -71,35 +70,6 @@ declare class NodeHttpHandler<T extends Context> {
71
70
  handle(request: NodeHttpRequest, response: NodeHttpResponse, ...rest: MaybeOptionalOptions<FriendlyStandardHandlerHandleOptions<T>>): Promise<NodeHttpHandlerHandleResult>;
72
71
  }
73
72
 
74
- interface BodyCompressionHandlerPluginOptions extends compression.CompressionOptions {
75
- /**
76
- * Override the default content-type filter used to determine which responses should be compressed.
77
- *
78
- * @warning Event stream responses are never compressed, regardless of this filter's return value.
79
- * @default only responses with compressible content types are compressed.
80
- */
81
- filter?: (request: NodeHttpRequest, response: NodeHttpResponse) => boolean;
82
- }
83
- declare class BodyCompressionHandlerPlugin<T extends Context> implements NodeHttpHandlerPlugin<T> {
84
- name: string;
85
- private readonly compressionHandler;
86
- constructor(options?: BodyCompressionHandlerPluginOptions);
87
- initNodeHttpHandlerOptions(options: NodeHttpHandlerOptions<T>): NodeHttpHandlerOptions<T>;
88
- }
89
-
90
- interface BodyLimitHandlerPluginOptions {
91
- /**
92
- * The maximum size of the body in bytes.
93
- */
94
- maxBodySize: number;
95
- }
96
- declare class BodyLimitHandlerPlugin<T extends Context> implements NodeHttpHandlerPlugin<T> {
97
- name: string;
98
- private readonly maxBodySize;
99
- constructor(options: BodyLimitHandlerPluginOptions);
100
- initNodeHttpHandlerOptions(options: NodeHttpHandlerOptions<T>): NodeHttpHandlerOptions<T>;
101
- }
102
-
103
73
  interface RPCHandlerOptions<T extends Context> extends NodeHttpHandlerOptions<T>, Omit<StandardHandlerOptions<T>, 'plugins'>, RPCHandlerCodecOptions<T> {
104
74
  /**
105
75
  * Configuration for {@link CSRFGuardHandlerPlugin}, which is enabled by default for `RPCHandler` over HTTP.
@@ -117,5 +87,5 @@ declare class RPCHandler<T extends Context> extends NodeHttpHandler<T> {
117
87
  constructor(router: Router<T>, options?: NoInfer<RPCHandlerOptions<T>>);
118
88
  }
119
89
 
120
- export { BodyCompressionHandlerPlugin, BodyLimitHandlerPlugin, CompositeNodeHttpHandlerPlugin, NodeHttpHandler, RPCHandler };
121
- export type { BodyCompressionHandlerPluginOptions, BodyLimitHandlerPluginOptions, NodeHttpHandlerHandleResult, NodeHttpHandlerNodeHttpInterceptor, NodeHttpHandlerNodeHttpInterceptorOptions, NodeHttpHandlerOptions, NodeHttpHandlerPlugin, RPCHandlerOptions };
90
+ export { CompositeNodeHttpHandlerPlugin, NodeHttpHandler, RPCHandler };
91
+ export type { NodeHttpHandlerHandleResult, NodeHttpHandlerNodeHttpInterceptor, NodeHttpHandlerNodeHttpInterceptorOptions, NodeHttpHandlerOptions, NodeHttpHandlerPlugin, RPCHandlerOptions };
@@ -1,119 +1,13 @@
1
- import compression from '@orpc/interop/compression';
2
- import { toArray, sortPlugins, intercept, resolveMaybeOptionalOptions } from '@orpc/shared';
3
- import { ORPCError } from '@orpc/client';
1
+ import { sortPlugins, intercept, resolveMaybeOptionalOptions, toArray } from '@orpc/shared';
4
2
  import { toStandardLazyRequest, sendStandardResponse } from '@standardserver/node';
5
3
  import { r as resolveFriendlyStandardHandlerHandleOptions } from '../../shared/server.W91HSRkE.mjs';
6
4
  import { C as CSRFGuardHandlerPlugin } from '../../shared/server.D_QauotT.mjs';
7
- import { R as RPCHandlerCodec, S as StandardHandler } from '../../shared/server.GDpX6Df8.mjs';
5
+ import { R as RPCHandlerCodec, S as StandardHandler } from '../../shared/server.COPVXhDG.mjs';
6
+ import '@orpc/client';
8
7
  import '@standardserver/core';
9
- import '../../shared/server.CrlKQucM.mjs';
8
+ import '../../shared/server.DofEOwf-.mjs';
10
9
  import '@orpc/contract';
11
- import '../../shared/server.BwHnWUuN.mjs';
12
-
13
- class BodyCompressionHandlerPlugin {
14
- name = "~body-compression";
15
- compressionHandler;
16
- constructor(options = {}) {
17
- this.compressionHandler = compression({
18
- ...options,
19
- filter: (request, response) => {
20
- const hasContentDisposition = response.hasHeader("content-disposition");
21
- const contentType = response.getHeader("content-type")?.toString();
22
- if (!hasContentDisposition && contentType?.startsWith("text/event-stream")) {
23
- return false;
24
- }
25
- return options.filter ? options.filter(request, response) : compression.filter(request, response);
26
- }
27
- });
28
- }
29
- initNodeHttpHandlerOptions(options) {
30
- return {
31
- ...options,
32
- nodeHttpInterceptors: [
33
- async (interceptorOptions) => {
34
- let resolve;
35
- let reject;
36
- const promise = new Promise((res, rej) => {
37
- resolve = res;
38
- reject = rej;
39
- });
40
- const originalWrite = interceptorOptions.response.write;
41
- const originalEnd = interceptorOptions.response.end;
42
- const originalOn = interceptorOptions.response.on;
43
- this.compressionHandler(
44
- interceptorOptions.request,
45
- interceptorOptions.response,
46
- async (error) => {
47
- if (error) {
48
- reject(error);
49
- } else {
50
- try {
51
- resolve(await interceptorOptions.next(interceptorOptions));
52
- } catch (nextError) {
53
- reject(nextError);
54
- }
55
- }
56
- }
57
- );
58
- try {
59
- return await promise;
60
- } finally {
61
- interceptorOptions.response.write = originalWrite;
62
- interceptorOptions.response.end = originalEnd;
63
- interceptorOptions.response.on = originalOn;
64
- }
65
- },
66
- ...toArray(options.nodeHttpInterceptors)
67
- ]
68
- };
69
- }
70
- }
71
-
72
- class BodyLimitHandlerPlugin {
73
- name = "~body-limit";
74
- maxBodySize;
75
- constructor(options) {
76
- this.maxBodySize = options.maxBodySize;
77
- }
78
- initNodeHttpHandlerOptions(options) {
79
- return {
80
- ...options,
81
- nodeHttpInterceptors: [
82
- async (interceptorOptions) => {
83
- let isHeaderChecked = false;
84
- const checkHeader = () => {
85
- if (isHeaderChecked) {
86
- return;
87
- }
88
- isHeaderChecked = true;
89
- const contentLength = interceptorOptions.request.headers["content-length"];
90
- if (contentLength && Number(contentLength) > this.maxBodySize) {
91
- throw new ORPCError("PAYLOAD_TOO_LARGE");
92
- }
93
- };
94
- const originalEmit = interceptorOptions.request.emit;
95
- let currentBodySize = 0;
96
- interceptorOptions.request.emit = (event, ...args) => {
97
- if (event === "data") {
98
- checkHeader();
99
- currentBodySize += args[0]?.length ?? 0;
100
- if (currentBodySize > this.maxBodySize) {
101
- throw new ORPCError("PAYLOAD_TOO_LARGE");
102
- }
103
- }
104
- return originalEmit.call(interceptorOptions.request, event, ...args);
105
- };
106
- try {
107
- return await interceptorOptions.next(interceptorOptions);
108
- } finally {
109
- interceptorOptions.request.emit = originalEmit;
110
- }
111
- },
112
- ...toArray(options.nodeHttpInterceptors)
113
- ]
114
- };
115
- }
116
- }
10
+ import '../../shared/server.BoiFpNT7.mjs';
117
11
 
118
12
  class CompositeNodeHttpHandlerPlugin {
119
13
  name = "~composite/node-http-handler";
@@ -176,4 +70,4 @@ class RPCHandler extends NodeHttpHandler {
176
70
  }
177
71
  }
178
72
 
179
- export { BodyCompressionHandlerPlugin, BodyLimitHandlerPlugin, CompositeNodeHttpHandlerPlugin, NodeHttpHandler, RPCHandler };
73
+ export { CompositeNodeHttpHandlerPlugin, NodeHttpHandler, RPCHandler };
@@ -1,12 +1,12 @@
1
- import { b as StandardHandlerHandleOptions } from '../../shared/server.BB_Ik9Ph.mjs';
2
- export { C as CompositeStandardHandlerPlugin, O as OtelHandlerPlugin, S as StandardHandler, c as StandardHandlerCodec, d as StandardHandlerCodecResolvedProcedure, g as StandardHandlerHandleResult, h as StandardHandlerInterceptor, i as StandardHandlerInterceptorOptions, a as StandardHandlerOptions, e as StandardHandlerPlugin, j as StandardHandlerRoutingInterceptor, f as StandardHandlerRoutingInterceptorOptions } from '../../shared/server.BB_Ik9Ph.mjs';
3
- export { a as RPCHandlerCodec, R as RPCHandlerCodecOptions, b as RPCMatcher, c as RPCMatcherOptions } from '../../shared/server.B_U9y00a.mjs';
4
- import { C as Context } from '../../shared/server.BL22TloH.mjs';
1
+ import { b as StandardHandlerHandleOptions } from '../../shared/server.DDFizwfU.mjs';
2
+ export { C as CompositeStandardHandlerPlugin, O as OtelHandlerPlugin, S as StandardHandler, c as StandardHandlerCodec, d as StandardHandlerCodecResolvedProcedure, h as StandardHandlerHandleResult, i as StandardHandlerInterceptor, g as StandardHandlerInterceptorOptions, a as StandardHandlerOptions, e as StandardHandlerPlugin, j as StandardHandlerRoutingInterceptor, f as StandardHandlerRoutingInterceptorOptions } from '../../shared/server.DDFizwfU.mjs';
3
+ export { a as RPCHandlerCodec, R as RPCHandlerCodecOptions, b as RPCMatcher, c as RPCMatcherOptions } from '../../shared/server.B4BnEWWm.mjs';
4
+ import { C as Context } from '../../shared/server.CcR4kgje.mjs';
5
+ export { StandardBody, StandardBodyHint, StandardHeaders, StandardLazyRequest, StandardLazyResponse, StandardMethod, StandardRequest, StandardResponse, StandardUrl } from '@standardserver/core';
5
6
  import '@orpc/client';
6
7
  import '@orpc/shared';
7
- import '@standardserver/core';
8
8
  import '@orpc/contract';
9
- import '../../shared/server.BsNNjG5J.mjs';
9
+ import '../../shared/server.15O7oC1p.mjs';
10
10
 
11
11
  type FriendlyStandardHandlerHandleOptions<T extends Context> = Omit<StandardHandlerHandleOptions<T>, 'context'> & (object extends T ? {
12
12
  context?: T;
@@ -1,12 +1,12 @@
1
- import { b as StandardHandlerHandleOptions } from '../../shared/server.EOHJ3NJr.js';
2
- export { C as CompositeStandardHandlerPlugin, O as OtelHandlerPlugin, S as StandardHandler, c as StandardHandlerCodec, d as StandardHandlerCodecResolvedProcedure, g as StandardHandlerHandleResult, h as StandardHandlerInterceptor, i as StandardHandlerInterceptorOptions, a as StandardHandlerOptions, e as StandardHandlerPlugin, j as StandardHandlerRoutingInterceptor, f as StandardHandlerRoutingInterceptorOptions } from '../../shared/server.EOHJ3NJr.js';
3
- export { a as RPCHandlerCodec, R as RPCHandlerCodecOptions, b as RPCMatcher, c as RPCMatcherOptions } from '../../shared/server.T9F3bzZx.js';
4
- import { C as Context } from '../../shared/server.BL22TloH.js';
1
+ import { b as StandardHandlerHandleOptions } from '../../shared/server.BhsVw7m7.js';
2
+ export { C as CompositeStandardHandlerPlugin, O as OtelHandlerPlugin, S as StandardHandler, c as StandardHandlerCodec, d as StandardHandlerCodecResolvedProcedure, h as StandardHandlerHandleResult, i as StandardHandlerInterceptor, g as StandardHandlerInterceptorOptions, a as StandardHandlerOptions, e as StandardHandlerPlugin, j as StandardHandlerRoutingInterceptor, f as StandardHandlerRoutingInterceptorOptions } from '../../shared/server.BhsVw7m7.js';
3
+ export { a as RPCHandlerCodec, R as RPCHandlerCodecOptions, b as RPCMatcher, c as RPCMatcherOptions } from '../../shared/server.CnN50DHH.js';
4
+ import { C as Context } from '../../shared/server.CcR4kgje.js';
5
+ export { StandardBody, StandardBodyHint, StandardHeaders, StandardLazyRequest, StandardLazyResponse, StandardMethod, StandardRequest, StandardResponse, StandardUrl } from '@standardserver/core';
5
6
  import '@orpc/client';
6
7
  import '@orpc/shared';
7
- import '@standardserver/core';
8
8
  import '@orpc/contract';
9
- import '../../shared/server.Pa0F03f_.js';
9
+ import '../../shared/server.m3szVJGU.js';
10
10
 
11
11
  type FriendlyStandardHandlerHandleOptions<T extends Context> = Omit<StandardHandlerHandleOptions<T>, 'context'> & (object extends T ? {
12
12
  context?: T;
@@ -1,8 +1,8 @@
1
- export { C as CompositeStandardHandlerPlugin, O as OtelHandlerPlugin, R as RPCHandlerCodec, a as RPCMatcher, S as StandardHandler } from '../../shared/server.GDpX6Df8.mjs';
1
+ export { C as CompositeStandardHandlerPlugin, O as OtelHandlerPlugin, R as RPCHandlerCodec, a as RPCMatcher, S as StandardHandler } from '../../shared/server.COPVXhDG.mjs';
2
2
  export { r as resolveFriendlyStandardHandlerHandleOptions } from '../../shared/server.W91HSRkE.mjs';
3
3
  import '@orpc/client';
4
4
  import '@orpc/shared';
5
5
  import '@standardserver/core';
6
- import '../../shared/server.CrlKQucM.mjs';
6
+ import '../../shared/server.DofEOwf-.mjs';
7
7
  import '@orpc/contract';
8
- import '../../shared/server.BwHnWUuN.mjs';
8
+ import '../../shared/server.BoiFpNT7.mjs';
@@ -1,7 +1,7 @@
1
1
  import { Value, Promisable } from '@orpc/shared';
2
2
  import { StandardLazyRequest, StandardResponse } from '@standardserver/core';
3
- import { C as Context } from '../../shared/server.BL22TloH.mjs';
4
- import { b as StandardHandlerHandleOptions, S as StandardHandler } from '../../shared/server.BB_Ik9Ph.mjs';
3
+ import { C as Context } from '../../shared/server.CcR4kgje.mjs';
4
+ import { b as StandardHandlerHandleOptions, S as StandardHandler } from '../../shared/server.DDFizwfU.mjs';
5
5
  import '@orpc/client';
6
6
  import '@orpc/contract';
7
7
 
@@ -1,7 +1,7 @@
1
1
  import { Value, Promisable } from '@orpc/shared';
2
2
  import { StandardLazyRequest, StandardResponse } from '@standardserver/core';
3
- import { C as Context } from '../../shared/server.BL22TloH.js';
4
- import { b as StandardHandlerHandleOptions, S as StandardHandler } from '../../shared/server.EOHJ3NJr.js';
3
+ import { C as Context } from '../../shared/server.CcR4kgje.js';
4
+ import { b as StandardHandlerHandleOptions, S as StandardHandler } from '../../shared/server.BhsVw7m7.js';
5
5
  import '@orpc/client';
6
6
  import '@orpc/contract';
7
7
 
@@ -1,16 +1,22 @@
1
- import { MaybeOptionalOptions } from '@orpc/shared';
1
+ import { Arrayable, MaybeOptionalOptions } from '@orpc/shared';
2
2
  import { EncodePeerMessageOptions, DecodePeerMessageOptions } from '@standardserver/peer';
3
- import { C as Context } from '../../shared/server.BL22TloH.mjs';
4
- import { S as StandardHandler, a as StandardHandlerOptions } from '../../shared/server.BB_Ik9Ph.mjs';
3
+ import { C as Context } from '../../shared/server.CcR4kgje.mjs';
4
+ import { S as StandardHandler, a as StandardHandlerOptions } from '../../shared/server.DDFizwfU.mjs';
5
5
  import { StandardPeerRequestHandlerOptions } from '../standard-peer/index.mjs';
6
- import { R as Router } from '../../shared/server.BsNNjG5J.mjs';
7
- import { R as RPCHandlerCodecOptions } from '../../shared/server.B_U9y00a.mjs';
6
+ import { R as Router } from '../../shared/server.15O7oC1p.mjs';
7
+ import { R as RPCHandlerCodecOptions } from '../../shared/server.B4BnEWWm.mjs';
8
8
  import '@orpc/client';
9
9
  import '@orpc/contract';
10
10
  import '@standardserver/core';
11
11
 
12
- type WebsocketLike = Pick<WebSocket, 'addEventListener' | 'removeEventListener' | 'send'>;
13
- interface WebsocketHandlerOptions<_T extends Context> {
12
+ /**
13
+ * Supports standard WebSocket instances, Bun ServerWebSocket, "ws" ServerWebSocket,
14
+ * Cloudflare WebSocket Hibernation, and similar implementations.
15
+ */
16
+ type WebSocketLike = {
17
+ send: (data: string | Uint8Array<ArrayBuffer>) => unknown;
18
+ };
19
+ interface WebSocketHandlerOptions<_T extends Context> {
14
20
  /**
15
21
  * Options for encoding peer messages. such as `prefix` for distinguishing messages on the same channel..
16
22
  */
@@ -20,42 +26,46 @@ interface WebsocketHandlerOptions<_T extends Context> {
20
26
  */
21
27
  decodePeerMessage?: DecodePeerMessageOptions | undefined;
22
28
  }
23
- declare class WebsocketHandler<T extends Context> {
29
+ declare class WebSocketHandler<T extends Context> {
24
30
  private readonly handler;
25
31
  private readonly peers;
26
32
  private readonly encodePeerMessageOptions;
27
33
  private readonly decodePeerMessageOptions;
28
- constructor(handler: StandardHandler<T>, options?: NoInfer<WebsocketHandlerOptions<T>>);
34
+ constructor(handler: StandardHandler<T>, options?: NoInfer<WebSocketHandlerOptions<T>>);
29
35
  /**
30
- * Attaches necessary event listeners to a WebSocket to handle incoming messages and peer management.
31
- */
32
- upgrade(ws: WebsocketLike, ...rest: MaybeOptionalOptions<StandardPeerRequestHandlerOptions<T>>): void;
33
- /**
34
- * Handles a single message received from a WebSocket.
36
+ * Handles a single WebSocket message.
37
+ *
38
+ * Message order matters. Call this immediately after receiving a message,
39
+ * before any other async work, to preserve ordering.
35
40
  *
36
- * @warning AVOID calling this method, if `.upgrade()` is used, as `.upgrade()` already sets up necessary event listeners to call this method for incoming messages and manage peer lifecycle.
41
+ * To avoid async Blob reads, configure `ws.binaryType` to return binary data
42
+ * directly (for example, `arraybuffer`).
37
43
  *
38
- * @param ws The WebSocket instance, require consistent instance across messages for proper peer management
39
- * @param data The message data received from the WebSocket, can be string, ArrayBuffer, Blob, ...
44
+ * @param ws The WebSocket instance. Use the same instance for all messages.
45
+ * @param data The received message. Binary data should already be loaded (not a `Blob`).
40
46
  */
41
- message(ws: WebsocketLike, data: string | ArrayBuffer | Blob | Exclude<ConstructorParameters<typeof Blob>[0], undefined>[0][] | Pick<Uint8Array<ArrayBuffer>, 'buffer' | 'byteOffset' | 'byteLength'>, ...rest: MaybeOptionalOptions<StandardPeerRequestHandlerOptions<T>>): Promise<{
47
+ message(ws: WebSocketLike, data: Arrayable<string | ArrayBuffer | Pick<Uint8Array<ArrayBuffer>, 'buffer' | 'byteOffset' | 'byteLength'>>, ...rest: MaybeOptionalOptions<StandardPeerRequestHandlerOptions<T>>): Promise<{
42
48
  matched: boolean;
43
49
  }>;
44
50
  /**
45
- * Called when a websocket is closed, to clean up any associated peer state.
51
+ * Cleans up peer state for a closed WebSocket.
46
52
  *
47
- * @warning AVOID calling this method, if `.upgrade()` is used, as `.upgrade()` already sets up necessary event listeners to call this method for incoming messages and manage peer lifecycle.
53
+ * @param ws The same WebSocket instance passed to `.message()`.
54
+ */
55
+ close(ws: WebSocketLike): Promise<void>;
56
+ /**
57
+ * Attaches message and close event listeners to a WebSocket.
48
58
  *
49
- * @param ws The WebSocket instance to clean up, must be the same instance used in `.message()` calls to properly clean up
59
+ * Prefer this over calling `.message()` and `.close()` manually.
50
60
  */
51
- close(ws: WebsocketLike): Promise<void>;
61
+ upgrade(ws: Pick<WebSocket, 'send' | 'addEventListener' | 'removeEventListener'>, ...rest: MaybeOptionalOptions<StandardPeerRequestHandlerOptions<T>>): void;
52
62
  }
53
63
 
54
- interface RPCHandlerOptions<T extends Context> extends StandardHandlerOptions<T>, RPCHandlerCodecOptions<T>, WebsocketHandlerOptions<T> {
64
+ interface RPCHandlerOptions<T extends Context> extends StandardHandlerOptions<T>, RPCHandlerCodecOptions<T>, WebSocketHandlerOptions<T> {
55
65
  }
56
- declare class RPCHandler<T extends Context> extends WebsocketHandler<T> {
66
+ declare class RPCHandler<T extends Context> extends WebSocketHandler<T> {
57
67
  constructor(router: Router<T>, options?: NoInfer<RPCHandlerOptions<T>>);
58
68
  }
59
69
 
60
- export { RPCHandler, WebsocketHandler };
61
- export type { RPCHandlerOptions, WebsocketHandlerOptions, WebsocketLike };
70
+ export { RPCHandler, WebSocketHandler };
71
+ export type { RPCHandlerOptions, WebSocketHandlerOptions, WebSocketLike };