@xdcobra/react-native-grpc 1.1.0 → 2.0.0

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 (114) hide show
  1. package/LICENSE.md +22 -22
  2. package/README.md +302 -284
  3. package/android/build.gradle +31 -127
  4. package/android/src/main/AndroidManifest.xml +3 -3
  5. package/android/src/main/java/com/reactnativegrpc/GrpcMarshaller.java +27 -27
  6. package/android/src/main/java/com/reactnativegrpc/GrpcModule.java +730 -730
  7. package/android/src/main/java/com/reactnativegrpc/GrpcPackage.java +27 -27
  8. package/android/src/main/java/com/reactnativegrpc/SpkiPinTrustManager.java +101 -101
  9. package/android/src/main/java/com/reactnativegrpc/TrustManagers.java +51 -51
  10. package/ios/Grpc.h +22 -22
  11. package/ios/Grpc.m +627 -625
  12. package/ios/SpkiPinning.h +22 -22
  13. package/ios/SpkiPinning.m +162 -114
  14. package/lib/commonjs/bidi-streaming.js.map +1 -1
  15. package/lib/commonjs/channel.js +9 -9
  16. package/lib/commonjs/channel.js.map +1 -1
  17. package/lib/commonjs/client-streaming.js +3 -3
  18. package/lib/commonjs/client-streaming.js.map +1 -1
  19. package/lib/commonjs/client.js +24 -24
  20. package/lib/commonjs/client.js.map +1 -1
  21. package/lib/commonjs/create-client.js +5 -5
  22. package/lib/commonjs/create-client.js.map +1 -1
  23. package/lib/commonjs/errors.js.map +1 -1
  24. package/lib/commonjs/index.js.map +1 -1
  25. package/lib/commonjs/interceptors.js +3 -3
  26. package/lib/commonjs/interceptors.js.map +1 -1
  27. package/lib/commonjs/native.js.map +1 -1
  28. package/lib/commonjs/retry.js.map +1 -1
  29. package/lib/commonjs/server-streaming.js.map +1 -1
  30. package/lib/commonjs/status.js.map +1 -1
  31. package/lib/commonjs/types.js +5 -5
  32. package/lib/commonjs/types.js.map +1 -1
  33. package/lib/commonjs/unary.js.map +1 -1
  34. package/lib/module/bidi-streaming.js.map +1 -1
  35. package/lib/module/channel.js +9 -9
  36. package/lib/module/channel.js.map +1 -1
  37. package/lib/module/client-streaming.js +3 -3
  38. package/lib/module/client-streaming.js.map +1 -1
  39. package/lib/module/client.js +24 -24
  40. package/lib/module/client.js.map +1 -1
  41. package/lib/module/create-client.js +5 -5
  42. package/lib/module/create-client.js.map +1 -1
  43. package/lib/module/errors.js.map +1 -1
  44. package/lib/module/index.js.map +1 -1
  45. package/lib/module/interceptors.js +3 -3
  46. package/lib/module/interceptors.js.map +1 -1
  47. package/lib/module/native.js.map +1 -1
  48. package/lib/module/retry.js.map +1 -1
  49. package/lib/module/server-streaming.js.map +1 -1
  50. package/lib/module/status.js.map +1 -1
  51. package/lib/module/types.js +5 -5
  52. package/lib/module/types.js.map +1 -1
  53. package/lib/module/unary.js.map +1 -1
  54. package/lib/typescript/src/bidi-streaming.d.ts.map +1 -0
  55. package/lib/typescript/src/channel.d.ts.map +1 -0
  56. package/lib/typescript/src/client-streaming.d.ts.map +1 -0
  57. package/lib/typescript/src/client.d.ts.map +1 -0
  58. package/lib/typescript/src/create-client.d.ts.map +1 -0
  59. package/lib/typescript/src/errors.d.ts.map +1 -0
  60. package/lib/typescript/src/index.d.ts.map +1 -0
  61. package/lib/typescript/src/interceptors.d.ts.map +1 -0
  62. package/lib/typescript/src/native.d.ts.map +1 -0
  63. package/lib/typescript/src/retry.d.ts.map +1 -0
  64. package/lib/typescript/src/server-streaming.d.ts.map +1 -0
  65. package/lib/typescript/src/status.d.ts.map +1 -0
  66. package/lib/typescript/src/types.d.ts.map +1 -0
  67. package/lib/typescript/src/unary.d.ts.map +1 -0
  68. package/lib/typescript/test/app/App.d.ts +3 -0
  69. package/lib/typescript/test/app/App.d.ts.map +1 -0
  70. package/package.json +209 -210
  71. package/react-native-grpc.podspec +33 -29
  72. package/src/bidi-streaming.ts +78 -78
  73. package/src/channel.ts +110 -110
  74. package/src/client-streaming.ts +106 -106
  75. package/src/client.ts +1046 -1046
  76. package/src/create-client.ts +391 -391
  77. package/src/errors.ts +11 -11
  78. package/src/index.ts +28 -28
  79. package/src/interceptors.ts +167 -167
  80. package/src/native.ts +99 -99
  81. package/src/retry.ts +208 -208
  82. package/src/server-streaming.ts +105 -105
  83. package/src/status.ts +50 -50
  84. package/src/types.ts +171 -171
  85. package/src/unary.ts +71 -71
  86. package/android/gradle.properties +0 -4
  87. package/lib/typescript/bidi-streaming.d.ts.map +0 -1
  88. package/lib/typescript/channel.d.ts.map +0 -1
  89. package/lib/typescript/client-streaming.d.ts.map +0 -1
  90. package/lib/typescript/client.d.ts.map +0 -1
  91. package/lib/typescript/create-client.d.ts.map +0 -1
  92. package/lib/typescript/errors.d.ts.map +0 -1
  93. package/lib/typescript/index.d.ts.map +0 -1
  94. package/lib/typescript/interceptors.d.ts.map +0 -1
  95. package/lib/typescript/native.d.ts.map +0 -1
  96. package/lib/typescript/retry.d.ts.map +0 -1
  97. package/lib/typescript/server-streaming.d.ts.map +0 -1
  98. package/lib/typescript/status.d.ts.map +0 -1
  99. package/lib/typescript/types.d.ts.map +0 -1
  100. package/lib/typescript/unary.d.ts.map +0 -1
  101. /package/lib/typescript/{bidi-streaming.d.ts → src/bidi-streaming.d.ts} +0 -0
  102. /package/lib/typescript/{channel.d.ts → src/channel.d.ts} +0 -0
  103. /package/lib/typescript/{client-streaming.d.ts → src/client-streaming.d.ts} +0 -0
  104. /package/lib/typescript/{client.d.ts → src/client.d.ts} +0 -0
  105. /package/lib/typescript/{create-client.d.ts → src/create-client.d.ts} +0 -0
  106. /package/lib/typescript/{errors.d.ts → src/errors.d.ts} +0 -0
  107. /package/lib/typescript/{index.d.ts → src/index.d.ts} +0 -0
  108. /package/lib/typescript/{interceptors.d.ts → src/interceptors.d.ts} +0 -0
  109. /package/lib/typescript/{native.d.ts → src/native.d.ts} +0 -0
  110. /package/lib/typescript/{retry.d.ts → src/retry.d.ts} +0 -0
  111. /package/lib/typescript/{server-streaming.d.ts → src/server-streaming.d.ts} +0 -0
  112. /package/lib/typescript/{status.d.ts → src/status.d.ts} +0 -0
  113. /package/lib/typescript/{types.d.ts → src/types.d.ts} +0 -0
  114. /package/lib/typescript/{unary.d.ts → src/unary.d.ts} +0 -0
@@ -1,391 +1,391 @@
1
- import type {
2
- DescMessage,
3
- DescMethod,
4
- DescService,
5
- MessageShape,
6
- } from '@bufbuild/protobuf';
7
- import { fromBinary, toBinary } from '@bufbuild/protobuf';
8
- import type {
9
- GenService,
10
- GenServiceMethods,
11
- } from '@bufbuild/protobuf/codegenv2';
12
- import type { GrpcCallApi } from './client';
13
- import type {
14
- GrpcCallOptions,
15
- GrpcMetadata,
16
- GrpcServerOutputStream,
17
- RemoveListener,
18
- ServerOutputEvent,
19
- ServerOutputEventCallback,
20
- } from './types';
21
-
22
- /** Channel or singleton client that exposes the raw byte RPC surface. */
23
- export type GrpcTransport = Pick<
24
- GrpcCallApi,
25
- 'unaryCall' | 'serverStreamCall' | 'clientStreamCall' | 'bidiStreamCall'
26
- >;
27
-
28
- function makePath(service: DescService, method: DescMethod): string {
29
- return `/${service.typeName}/${method.name}`;
30
- }
31
-
32
- function decodeOutputStream<O extends DescMessage>(
33
- schema: O,
34
- stream: GrpcServerOutputStream
35
- ): TypedServerOutputStream<MessageShape<O>> {
36
- return {
37
- on(event, callback) {
38
- if (event === 'data') {
39
- return stream.on('data', (data) => {
40
- (callback as (message: MessageShape<O>) => void)(
41
- fromBinary(schema, data)
42
- );
43
- });
44
- }
45
- return stream.on(
46
- event,
47
- callback as ServerOutputEventCallback<typeof event>
48
- );
49
- },
50
- };
51
- }
52
-
53
- function toAsyncIterable<O>(
54
- stream: TypedServerOutputStream<O>,
55
- trailers: Promise<GrpcMetadata>
56
- ): AsyncIterable<O> {
57
- return {
58
- [Symbol.asyncIterator](): AsyncIterator<O> {
59
- const queue: O[] = [];
60
- let pending:
61
- | {
62
- resolve: (r: IteratorResult<O>) => void;
63
- reject: (e: unknown) => void;
64
- }
65
- | undefined;
66
- let done = false;
67
- let error: unknown;
68
-
69
- const flush = () => {
70
- if (!pending) {
71
- return;
72
- }
73
- if (error !== undefined) {
74
- const { reject } = pending;
75
- pending = undefined;
76
- reject(error);
77
- return;
78
- }
79
- if (queue.length > 0) {
80
- const { resolve } = pending;
81
- pending = undefined;
82
- resolve({ value: queue.shift() as O, done: false });
83
- return;
84
- }
85
- if (done) {
86
- const { resolve } = pending;
87
- pending = undefined;
88
- resolve({ value: undefined, done: true });
89
- }
90
- };
91
-
92
- stream.on('data', (message) => {
93
- queue.push(message);
94
- flush();
95
- });
96
- stream.on('error', (reason) => {
97
- error = reason;
98
- flush();
99
- });
100
- stream.on('complete', () => {
101
- done = true;
102
- flush();
103
- });
104
- // Ensure we observe trailers rejection as stream failure.
105
- trailers.catch((reason) => {
106
- error = reason;
107
- flush();
108
- });
109
-
110
- return {
111
- next(): Promise<IteratorResult<O>> {
112
- if (error !== undefined) {
113
- return Promise.reject(error);
114
- }
115
- if (queue.length > 0) {
116
- return Promise.resolve({
117
- value: queue.shift() as O,
118
- done: false,
119
- });
120
- }
121
- if (done) {
122
- return Promise.resolve({ value: undefined, done: true });
123
- }
124
- return new Promise<IteratorResult<O>>((resolve, reject) => {
125
- pending = { resolve, reject };
126
- });
127
- },
128
- };
129
- },
130
- };
131
- }
132
-
133
- export type TypedServerOutputStream<O> = {
134
- on<T extends ServerOutputEvent>(
135
- event: T,
136
- callback: T extends 'data'
137
- ? (message: O) => void
138
- : ServerOutputEventCallback<T>
139
- ): RemoveListener;
140
- };
141
-
142
- export type UnaryMethod<I extends DescMessage, O extends DescMessage> = (
143
- request: MessageShape<I>,
144
- headers?: GrpcMetadata,
145
- options?: GrpcCallOptions
146
- ) => Promise<MessageShape<O>>;
147
-
148
- export type ServerStreamingMethod<
149
- I extends DescMessage,
150
- O extends DescMessage
151
- > = (
152
- request: MessageShape<I>,
153
- headers?: GrpcMetadata,
154
- options?: GrpcCallOptions
155
- ) => ServerStreamingCall<MessageShape<O>>;
156
-
157
- export type ServerStreamingCall<O> = AsyncIterable<O> & {
158
- readonly headers: Promise<GrpcMetadata>;
159
- readonly responses: TypedServerOutputStream<O>;
160
- readonly trailers: Promise<GrpcMetadata>;
161
- cancel(): void;
162
- };
163
-
164
- export type ClientStreamingMethod<
165
- I extends DescMessage,
166
- O extends DescMessage
167
- > = (
168
- headers?: GrpcMetadata,
169
- options?: GrpcCallOptions
170
- ) => ClientStreamingCall<MessageShape<I>, MessageShape<O>>;
171
-
172
- export type ClientStreamingCall<I, O> = {
173
- send(message: I): Promise<void>;
174
- complete(): Promise<void>;
175
- readonly response: Promise<O>;
176
- readonly headers: Promise<GrpcMetadata>;
177
- readonly trailers: Promise<GrpcMetadata>;
178
- cancel(): void;
179
- };
180
-
181
- export type BidiStreamingMethod<
182
- I extends DescMessage,
183
- O extends DescMessage
184
- > = (
185
- headers?: GrpcMetadata,
186
- options?: GrpcCallOptions
187
- ) => BidiStreamingCall<MessageShape<I>, MessageShape<O>>;
188
-
189
- export type BidiStreamingCall<I, O> = {
190
- send(message: I): Promise<void>;
191
- complete(): Promise<void>;
192
- readonly responses: TypedServerOutputStream<O>;
193
- readonly headers: Promise<GrpcMetadata>;
194
- readonly trailers: Promise<GrpcMetadata>;
195
- cancel(): void;
196
- } & AsyncIterable<O>;
197
-
198
- type ClientMethod<M> = M extends {
199
- methodKind: 'unary';
200
- input: infer I;
201
- output: infer O;
202
- }
203
- ? I extends DescMessage
204
- ? O extends DescMessage
205
- ? UnaryMethod<I, O>
206
- : never
207
- : never
208
- : M extends {
209
- methodKind: 'server_streaming';
210
- input: infer I;
211
- output: infer O;
212
- }
213
- ? I extends DescMessage
214
- ? O extends DescMessage
215
- ? ServerStreamingMethod<I, O>
216
- : never
217
- : never
218
- : M extends {
219
- methodKind: 'client_streaming';
220
- input: infer I;
221
- output: infer O;
222
- }
223
- ? I extends DescMessage
224
- ? O extends DescMessage
225
- ? ClientStreamingMethod<I, O>
226
- : never
227
- : never
228
- : M extends {
229
- methodKind: 'bidi_streaming';
230
- input: infer I;
231
- output: infer O;
232
- }
233
- ? I extends DescMessage
234
- ? O extends DescMessage
235
- ? BidiStreamingMethod<I, O>
236
- : never
237
- : never
238
- : never;
239
-
240
- /** Typed RPC client for a Protobuf-ES `GenService` schema. */
241
- export type Client<Desc extends DescService> = {
242
- [K in keyof Desc['method']]: ClientMethod<Desc['method'][K]>;
243
- };
244
-
245
- function createUnaryMethod<I extends DescMessage, O extends DescMessage>(
246
- transport: GrpcTransport,
247
- service: DescService,
248
- method: DescMethod
249
- ): UnaryMethod<I, O> {
250
- const path = makePath(service, method);
251
- const input = method.input as I;
252
- const output = method.output as O;
253
- return async (request, headers, options) => {
254
- const call = transport.unaryCall(
255
- path,
256
- toBinary(input, request),
257
- headers,
258
- options
259
- );
260
- const bytes = await call.response;
261
- return fromBinary(output, bytes);
262
- };
263
- }
264
-
265
- function createServerStreamingMethod<
266
- I extends DescMessage,
267
- O extends DescMessage
268
- >(
269
- transport: GrpcTransport,
270
- service: DescService,
271
- method: DescMethod
272
- ): ServerStreamingMethod<I, O> {
273
- const path = makePath(service, method);
274
- const input = method.input as I;
275
- const output = method.output as O;
276
- return (request, headers, options) => {
277
- const call = transport.serverStreamCall(
278
- path,
279
- toBinary(input, request),
280
- headers,
281
- options
282
- );
283
- const responses = decodeOutputStream(output, call.responses);
284
- const iterable = toAsyncIterable(responses, call.trailers);
285
- return {
286
- headers: call.headers,
287
- responses,
288
- trailers: call.trailers,
289
- cancel: () => call.cancel(),
290
- [Symbol.asyncIterator]: () => iterable[Symbol.asyncIterator](),
291
- };
292
- };
293
- }
294
-
295
- function createClientStreamingMethod<
296
- I extends DescMessage,
297
- O extends DescMessage
298
- >(
299
- transport: GrpcTransport,
300
- service: DescService,
301
- method: DescMethod
302
- ): ClientStreamingMethod<I, O> {
303
- const path = makePath(service, method);
304
- const input = method.input as I;
305
- const output = method.output as O;
306
- return (headers, options) => {
307
- const call = transport.clientStreamCall(path, headers, options);
308
- return {
309
- send: (message) => call.requests.send(toBinary(input, message)),
310
- complete: () => call.requests.complete(),
311
- response: call.response.then((bytes) => fromBinary(output, bytes)),
312
- headers: call.headers,
313
- trailers: call.trailers,
314
- cancel: () => call.cancel(),
315
- };
316
- };
317
- }
318
-
319
- function createBidiStreamingMethod<
320
- I extends DescMessage,
321
- O extends DescMessage
322
- >(
323
- transport: GrpcTransport,
324
- service: DescService,
325
- method: DescMethod
326
- ): BidiStreamingMethod<I, O> {
327
- const path = makePath(service, method);
328
- const input = method.input as I;
329
- const output = method.output as O;
330
- return (headers, options) => {
331
- const call = transport.bidiStreamCall(path, headers, options);
332
- const responses = decodeOutputStream(output, call.responses);
333
- const iterable = toAsyncIterable(responses, call.trailers);
334
- return {
335
- send: (message) => call.requests.send(toBinary(input, message)),
336
- complete: () => call.requests.complete(),
337
- responses,
338
- headers: call.headers,
339
- trailers: call.trailers,
340
- cancel: () => call.cancel(),
341
- [Symbol.asyncIterator]: () => iterable[Symbol.asyncIterator](),
342
- };
343
- };
344
- }
345
-
346
- /**
347
- * Create a typed client for a Protobuf-ES service schema (`protoc-gen-es`).
348
- *
349
- * Requires peer dependency `@bufbuild/protobuf`. Maps RPCs onto
350
- * {@link GrpcTransport} (`GrpcClient` or a `GrpcChannel`).
351
- */
352
- export function createClient<T extends GenServiceMethods>(
353
- service: GenService<T>,
354
- transport: GrpcTransport
355
- ): Client<GenService<T>> {
356
- const client = {} as Client<GenService<T>>;
357
- for (const method of service.methods) {
358
- const key = method.localName as keyof Client<GenService<T>>;
359
- switch (method.methodKind) {
360
- case 'unary':
361
- client[key] = createUnaryMethod(transport, service, method) as Client<
362
- GenService<T>
363
- >[typeof key];
364
- break;
365
- case 'server_streaming':
366
- client[key] = createServerStreamingMethod(
367
- transport,
368
- service,
369
- method
370
- ) as Client<GenService<T>>[typeof key];
371
- break;
372
- case 'client_streaming':
373
- client[key] = createClientStreamingMethod(
374
- transport,
375
- service,
376
- method
377
- ) as Client<GenService<T>>[typeof key];
378
- break;
379
- case 'bidi_streaming':
380
- client[key] = createBidiStreamingMethod(
381
- transport,
382
- service,
383
- method
384
- ) as Client<GenService<T>>[typeof key];
385
- break;
386
- default:
387
- break;
388
- }
389
- }
390
- return client;
391
- }
1
+ import type {
2
+ DescMessage,
3
+ DescMethod,
4
+ DescService,
5
+ MessageShape,
6
+ } from '@bufbuild/protobuf';
7
+ import { fromBinary, toBinary } from '@bufbuild/protobuf';
8
+ import type {
9
+ GenService,
10
+ GenServiceMethods,
11
+ } from '@bufbuild/protobuf/codegenv2';
12
+ import type { GrpcCallApi } from './client';
13
+ import type {
14
+ GrpcCallOptions,
15
+ GrpcMetadata,
16
+ GrpcServerOutputStream,
17
+ RemoveListener,
18
+ ServerOutputEvent,
19
+ ServerOutputEventCallback,
20
+ } from './types';
21
+
22
+ /** Channel or singleton client that exposes the raw byte RPC surface. */
23
+ export type GrpcTransport = Pick<
24
+ GrpcCallApi,
25
+ 'unaryCall' | 'serverStreamCall' | 'clientStreamCall' | 'bidiStreamCall'
26
+ >;
27
+
28
+ function makePath(service: DescService, method: DescMethod): string {
29
+ return `/${service.typeName}/${method.name}`;
30
+ }
31
+
32
+ function decodeOutputStream<O extends DescMessage>(
33
+ schema: O,
34
+ stream: GrpcServerOutputStream
35
+ ): TypedServerOutputStream<MessageShape<O>> {
36
+ return {
37
+ on(event, callback) {
38
+ if (event === 'data') {
39
+ return stream.on('data', (data) => {
40
+ (callback as (message: MessageShape<O>) => void)(
41
+ fromBinary(schema, data)
42
+ );
43
+ });
44
+ }
45
+ return stream.on(
46
+ event,
47
+ callback as ServerOutputEventCallback<typeof event>
48
+ );
49
+ },
50
+ };
51
+ }
52
+
53
+ function toAsyncIterable<O>(
54
+ stream: TypedServerOutputStream<O>,
55
+ trailers: Promise<GrpcMetadata>
56
+ ): AsyncIterable<O> {
57
+ return {
58
+ [Symbol.asyncIterator](): AsyncIterator<O> {
59
+ const queue: O[] = [];
60
+ let pending:
61
+ | {
62
+ resolve: (r: IteratorResult<O>) => void;
63
+ reject: (e: unknown) => void;
64
+ }
65
+ | undefined;
66
+ let done = false;
67
+ let error: unknown;
68
+
69
+ const flush = () => {
70
+ if (!pending) {
71
+ return;
72
+ }
73
+ if (error !== undefined) {
74
+ const { reject } = pending;
75
+ pending = undefined;
76
+ reject(error);
77
+ return;
78
+ }
79
+ if (queue.length > 0) {
80
+ const { resolve } = pending;
81
+ pending = undefined;
82
+ resolve({ value: queue.shift() as O, done: false });
83
+ return;
84
+ }
85
+ if (done) {
86
+ const { resolve } = pending;
87
+ pending = undefined;
88
+ resolve({ value: undefined, done: true });
89
+ }
90
+ };
91
+
92
+ stream.on('data', (message) => {
93
+ queue.push(message);
94
+ flush();
95
+ });
96
+ stream.on('error', (reason) => {
97
+ error = reason;
98
+ flush();
99
+ });
100
+ stream.on('complete', () => {
101
+ done = true;
102
+ flush();
103
+ });
104
+ // Ensure we observe trailers rejection as stream failure.
105
+ trailers.catch((reason) => {
106
+ error = reason;
107
+ flush();
108
+ });
109
+
110
+ return {
111
+ next(): Promise<IteratorResult<O>> {
112
+ if (error !== undefined) {
113
+ return Promise.reject(error);
114
+ }
115
+ if (queue.length > 0) {
116
+ return Promise.resolve({
117
+ value: queue.shift() as O,
118
+ done: false,
119
+ });
120
+ }
121
+ if (done) {
122
+ return Promise.resolve({ value: undefined, done: true });
123
+ }
124
+ return new Promise<IteratorResult<O>>((resolve, reject) => {
125
+ pending = { resolve, reject };
126
+ });
127
+ },
128
+ };
129
+ },
130
+ };
131
+ }
132
+
133
+ export type TypedServerOutputStream<O> = {
134
+ on<T extends ServerOutputEvent>(
135
+ event: T,
136
+ callback: T extends 'data'
137
+ ? (message: O) => void
138
+ : ServerOutputEventCallback<T>
139
+ ): RemoveListener;
140
+ };
141
+
142
+ export type UnaryMethod<I extends DescMessage, O extends DescMessage> = (
143
+ request: MessageShape<I>,
144
+ headers?: GrpcMetadata,
145
+ options?: GrpcCallOptions
146
+ ) => Promise<MessageShape<O>>;
147
+
148
+ export type ServerStreamingMethod<
149
+ I extends DescMessage,
150
+ O extends DescMessage
151
+ > = (
152
+ request: MessageShape<I>,
153
+ headers?: GrpcMetadata,
154
+ options?: GrpcCallOptions
155
+ ) => ServerStreamingCall<MessageShape<O>>;
156
+
157
+ export type ServerStreamingCall<O> = AsyncIterable<O> & {
158
+ readonly headers: Promise<GrpcMetadata>;
159
+ readonly responses: TypedServerOutputStream<O>;
160
+ readonly trailers: Promise<GrpcMetadata>;
161
+ cancel(): void;
162
+ };
163
+
164
+ export type ClientStreamingMethod<
165
+ I extends DescMessage,
166
+ O extends DescMessage
167
+ > = (
168
+ headers?: GrpcMetadata,
169
+ options?: GrpcCallOptions
170
+ ) => ClientStreamingCall<MessageShape<I>, MessageShape<O>>;
171
+
172
+ export type ClientStreamingCall<I, O> = {
173
+ send(message: I): Promise<void>;
174
+ complete(): Promise<void>;
175
+ readonly response: Promise<O>;
176
+ readonly headers: Promise<GrpcMetadata>;
177
+ readonly trailers: Promise<GrpcMetadata>;
178
+ cancel(): void;
179
+ };
180
+
181
+ export type BidiStreamingMethod<
182
+ I extends DescMessage,
183
+ O extends DescMessage
184
+ > = (
185
+ headers?: GrpcMetadata,
186
+ options?: GrpcCallOptions
187
+ ) => BidiStreamingCall<MessageShape<I>, MessageShape<O>>;
188
+
189
+ export type BidiStreamingCall<I, O> = {
190
+ send(message: I): Promise<void>;
191
+ complete(): Promise<void>;
192
+ readonly responses: TypedServerOutputStream<O>;
193
+ readonly headers: Promise<GrpcMetadata>;
194
+ readonly trailers: Promise<GrpcMetadata>;
195
+ cancel(): void;
196
+ } & AsyncIterable<O>;
197
+
198
+ type ClientMethod<M> = M extends {
199
+ methodKind: 'unary';
200
+ input: infer I;
201
+ output: infer O;
202
+ }
203
+ ? I extends DescMessage
204
+ ? O extends DescMessage
205
+ ? UnaryMethod<I, O>
206
+ : never
207
+ : never
208
+ : M extends {
209
+ methodKind: 'server_streaming';
210
+ input: infer I;
211
+ output: infer O;
212
+ }
213
+ ? I extends DescMessage
214
+ ? O extends DescMessage
215
+ ? ServerStreamingMethod<I, O>
216
+ : never
217
+ : never
218
+ : M extends {
219
+ methodKind: 'client_streaming';
220
+ input: infer I;
221
+ output: infer O;
222
+ }
223
+ ? I extends DescMessage
224
+ ? O extends DescMessage
225
+ ? ClientStreamingMethod<I, O>
226
+ : never
227
+ : never
228
+ : M extends {
229
+ methodKind: 'bidi_streaming';
230
+ input: infer I;
231
+ output: infer O;
232
+ }
233
+ ? I extends DescMessage
234
+ ? O extends DescMessage
235
+ ? BidiStreamingMethod<I, O>
236
+ : never
237
+ : never
238
+ : never;
239
+
240
+ /** Typed RPC client for a Protobuf-ES `GenService` schema. */
241
+ export type Client<Desc extends DescService> = {
242
+ [K in keyof Desc['method']]: ClientMethod<Desc['method'][K]>;
243
+ };
244
+
245
+ function createUnaryMethod<I extends DescMessage, O extends DescMessage>(
246
+ transport: GrpcTransport,
247
+ service: DescService,
248
+ method: DescMethod
249
+ ): UnaryMethod<I, O> {
250
+ const path = makePath(service, method);
251
+ const input = method.input as I;
252
+ const output = method.output as O;
253
+ return async (request, headers, options) => {
254
+ const call = transport.unaryCall(
255
+ path,
256
+ toBinary(input, request),
257
+ headers,
258
+ options
259
+ );
260
+ const bytes = await call.response;
261
+ return fromBinary(output, bytes);
262
+ };
263
+ }
264
+
265
+ function createServerStreamingMethod<
266
+ I extends DescMessage,
267
+ O extends DescMessage
268
+ >(
269
+ transport: GrpcTransport,
270
+ service: DescService,
271
+ method: DescMethod
272
+ ): ServerStreamingMethod<I, O> {
273
+ const path = makePath(service, method);
274
+ const input = method.input as I;
275
+ const output = method.output as O;
276
+ return (request, headers, options) => {
277
+ const call = transport.serverStreamCall(
278
+ path,
279
+ toBinary(input, request),
280
+ headers,
281
+ options
282
+ );
283
+ const responses = decodeOutputStream(output, call.responses);
284
+ const iterable = toAsyncIterable(responses, call.trailers);
285
+ return {
286
+ headers: call.headers,
287
+ responses,
288
+ trailers: call.trailers,
289
+ cancel: () => call.cancel(),
290
+ [Symbol.asyncIterator]: () => iterable[Symbol.asyncIterator](),
291
+ };
292
+ };
293
+ }
294
+
295
+ function createClientStreamingMethod<
296
+ I extends DescMessage,
297
+ O extends DescMessage
298
+ >(
299
+ transport: GrpcTransport,
300
+ service: DescService,
301
+ method: DescMethod
302
+ ): ClientStreamingMethod<I, O> {
303
+ const path = makePath(service, method);
304
+ const input = method.input as I;
305
+ const output = method.output as O;
306
+ return (headers, options) => {
307
+ const call = transport.clientStreamCall(path, headers, options);
308
+ return {
309
+ send: (message) => call.requests.send(toBinary(input, message)),
310
+ complete: () => call.requests.complete(),
311
+ response: call.response.then((bytes) => fromBinary(output, bytes)),
312
+ headers: call.headers,
313
+ trailers: call.trailers,
314
+ cancel: () => call.cancel(),
315
+ };
316
+ };
317
+ }
318
+
319
+ function createBidiStreamingMethod<
320
+ I extends DescMessage,
321
+ O extends DescMessage
322
+ >(
323
+ transport: GrpcTransport,
324
+ service: DescService,
325
+ method: DescMethod
326
+ ): BidiStreamingMethod<I, O> {
327
+ const path = makePath(service, method);
328
+ const input = method.input as I;
329
+ const output = method.output as O;
330
+ return (headers, options) => {
331
+ const call = transport.bidiStreamCall(path, headers, options);
332
+ const responses = decodeOutputStream(output, call.responses);
333
+ const iterable = toAsyncIterable(responses, call.trailers);
334
+ return {
335
+ send: (message) => call.requests.send(toBinary(input, message)),
336
+ complete: () => call.requests.complete(),
337
+ responses,
338
+ headers: call.headers,
339
+ trailers: call.trailers,
340
+ cancel: () => call.cancel(),
341
+ [Symbol.asyncIterator]: () => iterable[Symbol.asyncIterator](),
342
+ };
343
+ };
344
+ }
345
+
346
+ /**
347
+ * Create a typed client for a Protobuf-ES service schema (`protoc-gen-es`).
348
+ *
349
+ * Requires peer dependency `@bufbuild/protobuf`. Maps RPCs onto
350
+ * {@link GrpcTransport} (`GrpcClient` or a `GrpcChannel`).
351
+ */
352
+ export function createClient<T extends GenServiceMethods>(
353
+ service: GenService<T>,
354
+ transport: GrpcTransport
355
+ ): Client<GenService<T>> {
356
+ const client = {} as Client<GenService<T>>;
357
+ for (const method of service.methods) {
358
+ const key = method.localName as keyof Client<GenService<T>>;
359
+ switch (method.methodKind) {
360
+ case 'unary':
361
+ client[key] = createUnaryMethod(transport, service, method) as Client<
362
+ GenService<T>
363
+ >[typeof key];
364
+ break;
365
+ case 'server_streaming':
366
+ client[key] = createServerStreamingMethod(
367
+ transport,
368
+ service,
369
+ method
370
+ ) as Client<GenService<T>>[typeof key];
371
+ break;
372
+ case 'client_streaming':
373
+ client[key] = createClientStreamingMethod(
374
+ transport,
375
+ service,
376
+ method
377
+ ) as Client<GenService<T>>[typeof key];
378
+ break;
379
+ case 'bidi_streaming':
380
+ client[key] = createBidiStreamingMethod(
381
+ transport,
382
+ service,
383
+ method
384
+ ) as Client<GenService<T>>[typeof key];
385
+ break;
386
+ default:
387
+ break;
388
+ }
389
+ }
390
+ return client;
391
+ }