@celljs/grpc 0.0.0-stage → 4.4.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 (187) hide show
  1. package/README.md +121 -2
  2. package/cell.schema.json +32 -0
  3. package/cell.yml +9 -0
  4. package/esm/node/call/async-queue.d.ts +31 -0
  5. package/esm/node/call/async-queue.js +80 -0
  6. package/esm/node/call/async-queue.js.map +1 -0
  7. package/esm/node/call/grpc-status.d.ts +33 -0
  8. package/esm/node/call/grpc-status.js +48 -0
  9. package/esm/node/call/grpc-status.js.map +1 -0
  10. package/esm/node/call/message-framer.d.ts +24 -0
  11. package/esm/node/call/message-framer.js +105 -0
  12. package/esm/node/call/message-framer.js.map +1 -0
  13. package/esm/node/call/metadata.d.ts +15 -0
  14. package/esm/node/call/metadata.js +81 -0
  15. package/esm/node/call/metadata.js.map +1 -0
  16. package/esm/node/client/grpc-channel.d.ts +64 -0
  17. package/esm/node/client/grpc-channel.js +285 -0
  18. package/esm/node/client/grpc-channel.js.map +1 -0
  19. package/esm/node/codec/proto-reader.d.ts +26 -0
  20. package/esm/node/codec/proto-reader.js +153 -0
  21. package/esm/node/codec/proto-reader.js.map +1 -0
  22. package/esm/node/codec/proto-writer.d.ts +29 -0
  23. package/esm/node/codec/proto-writer.js +150 -0
  24. package/esm/node/codec/proto-writer.js.map +1 -0
  25. package/esm/node/index.d.ts +15 -0
  26. package/esm/node/index.js +16 -0
  27. package/esm/node/index.js.map +1 -0
  28. package/esm/node/module.d.ts +3 -0
  29. package/esm/node/module.js +4 -0
  30. package/esm/node/module.js.map +1 -0
  31. package/esm/node/proto/proto-ast.d.ts +46 -0
  32. package/esm/node/proto/proto-ast.js +2 -0
  33. package/esm/node/proto/proto-ast.js.map +1 -0
  34. package/esm/node/proto/proto-parser.d.ts +45 -0
  35. package/esm/node/proto/proto-parser.js +451 -0
  36. package/esm/node/proto/proto-parser.js.map +1 -0
  37. package/esm/node/proto/proto-types.d.ts +76 -0
  38. package/esm/node/proto/proto-types.js +444 -0
  39. package/esm/node/proto/proto-types.js.map +1 -0
  40. package/esm/node/proto/proto.d.ts +57 -0
  41. package/esm/node/proto/proto.js +174 -0
  42. package/esm/node/proto/proto.js.map +1 -0
  43. package/esm/node/proto/well-known.d.ts +5 -0
  44. package/esm/node/proto/well-known.js +41 -0
  45. package/esm/node/proto/well-known.js.map +1 -0
  46. package/esm/node/server/grpc-server-lifecycle.d.ts +21 -0
  47. package/esm/node/server/grpc-server-lifecycle.js +65 -0
  48. package/esm/node/server/grpc-server-lifecycle.js.map +1 -0
  49. package/esm/node/server/grpc-server.d.ts +60 -0
  50. package/esm/node/server/grpc-server.js +312 -0
  51. package/esm/node/server/grpc-server.js.map +1 -0
  52. package/esm/node/server/grpc-service.d.ts +24 -0
  53. package/esm/node/server/grpc-service.js +38 -0
  54. package/esm/node/server/grpc-service.js.map +1 -0
  55. package/esm/node/test/proto-loader.d.ts +2 -0
  56. package/esm/node/test/proto-loader.js +13 -0
  57. package/esm/node/test/proto-loader.js.map +1 -0
  58. package/esm/node/test/test-protos.d.ts +28 -0
  59. package/esm/node/test/test-protos.js +145 -0
  60. package/esm/node/test/test-protos.js.map +1 -0
  61. package/esm/package.json +3 -0
  62. package/lib/node/call/async-queue.d.ts +32 -0
  63. package/lib/node/call/async-queue.d.ts.map +1 -0
  64. package/lib/node/call/async-queue.js +84 -0
  65. package/lib/node/call/async-queue.js.map +1 -0
  66. package/lib/node/call/grpc-status.d.ts +34 -0
  67. package/lib/node/call/grpc-status.d.ts.map +1 -0
  68. package/lib/node/call/grpc-status.js +52 -0
  69. package/lib/node/call/grpc-status.js.map +1 -0
  70. package/lib/node/call/message-framer.d.ts +25 -0
  71. package/lib/node/call/message-framer.d.ts.map +1 -0
  72. package/lib/node/call/message-framer.js +109 -0
  73. package/lib/node/call/message-framer.js.map +1 -0
  74. package/lib/node/call/metadata.d.ts +16 -0
  75. package/lib/node/call/metadata.d.ts.map +1 -0
  76. package/lib/node/call/metadata.js +84 -0
  77. package/lib/node/call/metadata.js.map +1 -0
  78. package/lib/node/client/grpc-channel.d.ts +65 -0
  79. package/lib/node/client/grpc-channel.d.ts.map +1 -0
  80. package/lib/node/client/grpc-channel.js +289 -0
  81. package/lib/node/client/grpc-channel.js.map +1 -0
  82. package/lib/node/codec/proto-reader.d.ts +27 -0
  83. package/lib/node/codec/proto-reader.d.ts.map +1 -0
  84. package/lib/node/codec/proto-reader.js +157 -0
  85. package/lib/node/codec/proto-reader.js.map +1 -0
  86. package/lib/node/codec/proto-writer.d.ts +30 -0
  87. package/lib/node/codec/proto-writer.d.ts.map +1 -0
  88. package/lib/node/codec/proto-writer.js +154 -0
  89. package/lib/node/codec/proto-writer.js.map +1 -0
  90. package/lib/node/grpc.spec.d.ts +2 -0
  91. package/lib/node/grpc.spec.d.ts.map +1 -0
  92. package/lib/node/grpc.spec.js +148 -0
  93. package/lib/node/grpc.spec.js.map +1 -0
  94. package/lib/node/index.d.ts +16 -0
  95. package/lib/node/index.d.ts.map +1 -0
  96. package/lib/node/index.js +32 -0
  97. package/lib/node/index.js.map +1 -0
  98. package/lib/node/interop.spec.d.ts +2 -0
  99. package/lib/node/interop.spec.d.ts.map +1 -0
  100. package/lib/node/interop.spec.js +194 -0
  101. package/lib/node/interop.spec.js.map +1 -0
  102. package/lib/node/module.d.ts +4 -0
  103. package/lib/node/module.d.ts.map +1 -0
  104. package/lib/node/module.js +6 -0
  105. package/lib/node/module.js.map +1 -0
  106. package/lib/node/proto/proto-ast.d.ts +47 -0
  107. package/lib/node/proto/proto-ast.d.ts.map +1 -0
  108. package/lib/node/proto/proto-ast.js +3 -0
  109. package/lib/node/proto/proto-ast.js.map +1 -0
  110. package/lib/node/proto/proto-parser.d.ts +46 -0
  111. package/lib/node/proto/proto-parser.d.ts.map +1 -0
  112. package/lib/node/proto/proto-parser.js +455 -0
  113. package/lib/node/proto/proto-parser.js.map +1 -0
  114. package/lib/node/proto/proto-parser.spec.d.ts +2 -0
  115. package/lib/node/proto/proto-parser.spec.d.ts.map +1 -0
  116. package/lib/node/proto/proto-parser.spec.js +95 -0
  117. package/lib/node/proto/proto-parser.spec.js.map +1 -0
  118. package/lib/node/proto/proto-types.d.ts +77 -0
  119. package/lib/node/proto/proto-types.d.ts.map +1 -0
  120. package/lib/node/proto/proto-types.js +449 -0
  121. package/lib/node/proto/proto-types.js.map +1 -0
  122. package/lib/node/proto/proto-types.spec.d.ts +2 -0
  123. package/lib/node/proto/proto-types.spec.d.ts.map +1 -0
  124. package/lib/node/proto/proto-types.spec.js +120 -0
  125. package/lib/node/proto/proto-types.spec.js.map +1 -0
  126. package/lib/node/proto/proto.d.ts +58 -0
  127. package/lib/node/proto/proto.d.ts.map +1 -0
  128. package/lib/node/proto/proto.js +178 -0
  129. package/lib/node/proto/proto.js.map +1 -0
  130. package/lib/node/proto/well-known.d.ts +6 -0
  131. package/lib/node/proto/well-known.d.ts.map +1 -0
  132. package/lib/node/proto/well-known.js +44 -0
  133. package/lib/node/proto/well-known.js.map +1 -0
  134. package/lib/node/server/grpc-server-lifecycle.d.ts +22 -0
  135. package/lib/node/server/grpc-server-lifecycle.d.ts.map +1 -0
  136. package/lib/node/server/grpc-server-lifecycle.js +68 -0
  137. package/lib/node/server/grpc-server-lifecycle.js.map +1 -0
  138. package/lib/node/server/grpc-server-lifecycle.spec.d.ts +2 -0
  139. package/lib/node/server/grpc-server-lifecycle.spec.d.ts.map +1 -0
  140. package/lib/node/server/grpc-server-lifecycle.spec.js +100 -0
  141. package/lib/node/server/grpc-server-lifecycle.spec.js.map +1 -0
  142. package/lib/node/server/grpc-server.d.ts +61 -0
  143. package/lib/node/server/grpc-server.d.ts.map +1 -0
  144. package/lib/node/server/grpc-server.js +316 -0
  145. package/lib/node/server/grpc-server.js.map +1 -0
  146. package/lib/node/server/grpc-service.d.ts +25 -0
  147. package/lib/node/server/grpc-service.d.ts.map +1 -0
  148. package/lib/node/server/grpc-service.js +42 -0
  149. package/lib/node/server/grpc-service.js.map +1 -0
  150. package/lib/node/test/proto-loader.d.ts +3 -0
  151. package/lib/node/test/proto-loader.d.ts.map +1 -0
  152. package/lib/node/test/proto-loader.js +16 -0
  153. package/lib/node/test/proto-loader.js.map +1 -0
  154. package/lib/node/test/test-protos.d.ts +29 -0
  155. package/lib/node/test/test-protos.d.ts.map +1 -0
  156. package/lib/node/test/test-protos.js +150 -0
  157. package/lib/node/test/test-protos.js.map +1 -0
  158. package/lib/package.spec.d.ts +2 -0
  159. package/lib/package.spec.d.ts.map +1 -0
  160. package/lib/package.spec.js +7 -0
  161. package/lib/package.spec.js.map +1 -0
  162. package/package.json +70 -4
  163. package/src/node/call/async-queue.ts +79 -0
  164. package/src/node/call/grpc-status.ts +49 -0
  165. package/src/node/call/message-framer.ts +109 -0
  166. package/src/node/call/metadata.ts +85 -0
  167. package/src/node/client/grpc-channel.ts +327 -0
  168. package/src/node/codec/proto-reader.ts +172 -0
  169. package/src/node/codec/proto-writer.ts +170 -0
  170. package/src/node/grpc.spec.ts +160 -0
  171. package/src/node/index.ts +15 -0
  172. package/src/node/interop.spec.ts +174 -0
  173. package/src/node/module.ts +4 -0
  174. package/src/node/proto/proto-ast.ts +48 -0
  175. package/src/node/proto/proto-parser.spec.ts +104 -0
  176. package/src/node/proto/proto-parser.ts +477 -0
  177. package/src/node/proto/proto-types.spec.ts +128 -0
  178. package/src/node/proto/proto-types.ts +497 -0
  179. package/src/node/proto/proto.ts +218 -0
  180. package/src/node/proto/well-known.ts +40 -0
  181. package/src/node/server/grpc-server-lifecycle.spec.ts +88 -0
  182. package/src/node/server/grpc-server-lifecycle.ts +56 -0
  183. package/src/node/server/grpc-server.ts +368 -0
  184. package/src/node/server/grpc-service.ts +40 -0
  185. package/src/node/test/proto-loader.ts +13 -0
  186. package/src/node/test/test-protos.ts +159 -0
  187. package/src/package.spec.ts +5 -0
package/README.md CHANGED
@@ -1,3 +1,122 @@
1
- # Temporary Holding Version
1
+ # Cell - gRPC Component
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ gRPC servers and clients for Cell on `node:http2`, with a built-in `.proto` parser and protobuf codec: no third-party dependency, no code generation. Unary, server-streaming, client-streaming and bidirectional methods; interoperable with other gRPC implementations (tested against `@grpc/grpc-js` in both directions).
4
+
5
+ ## Define the service
6
+
7
+ Keep the `.proto` file in the sources and parse it once. With Vite (`cell build`, `cell dev`, `createTestApp()`), a `?raw` import bundles its text:
8
+
9
+ ```ts
10
+ // src/greeter.ts
11
+ import { Proto, type UnaryCall, type ServerStreamCall } from '@celljs/grpc';
12
+ import source from './greeter.proto?raw'; // declare module '*?raw' once, see examples/grpc-app/src/raw.d.ts
13
+
14
+ export const Greeter = Proto.parse(source).service('helloworld.Greeter');
15
+ ```
16
+
17
+ `Proto.parse(...sources)` takes every file the service needs (imports are resolved by type name across the sources); the `google/protobuf` well-known types (`empty`, `timestamp`, `duration`, `wrappers`, `struct`, `any`, `field_mask`) are built in. Names are full (`helloworld.Greeter`) or short when unambiguous. `proto.message('HelloRequest')` gives a message type with `encode()` / `decode()` for protobuf without gRPC.
18
+
19
+ ## Serve it
20
+
21
+ ```ts
22
+ import { GrpcError, GrpcService, GrpcStatus, type ServerCall } from '@celljs/grpc';
23
+ import { Greeter } from './greeter';
24
+
25
+ @GrpcService(Greeter)
26
+ export class GreeterService {
27
+
28
+ @Autowired(UserService) // a component like any other
29
+ protected readonly users: UserService;
30
+
31
+ // rpc SayHello (HelloRequest) returns (HelloReply)
32
+ sayHello({ name }: HelloRequest, call: ServerCall): HelloReply {
33
+ if (!name) {
34
+ throw new GrpcError(GrpcStatus.INVALID_ARGUMENT, 'name is required');
35
+ }
36
+ return { message: `Hello ${name}` };
37
+ }
38
+
39
+ // rpc SayHelloStream (HelloRequest) returns (stream HelloReply)
40
+ async *sayHelloStream({ name }: HelloRequest): AsyncIterable<HelloReply> {
41
+ yield { message: `Hello ${name}` };
42
+ }
43
+
44
+ // rpc SayHelloToAll (stream HelloRequest) returns (HelloReply)
45
+ async sayHelloToAll(requests: AsyncIterable<HelloRequest>): Promise<HelloReply> { ... }
46
+
47
+ // rpc Chat (stream HelloRequest) returns (stream HelloReply)
48
+ async *chat(requests: AsyncIterable<HelloRequest>): AsyncIterable<HelloReply> { ... }
49
+ }
50
+ ```
51
+
52
+ Import the file from a DI module (`src/module.ts`). When the application starts with at least one `@GrpcService`, `GrpcServerLifecycle` starts the gRPC server (`gRPC serve 127.0.0.1:50051` in the log); it closes when the application stops. Methods are the `.proto` methods in lowerCamelCase (`SayHello` → `sayHello`); a method without implementation answers `UNIMPLEMENTED`. The types `UnaryHandler`, `ServerStreamHandler`, `ClientStreamHandler` and `BidiStreamHandler` describe the four signatures.
53
+
54
+ The last argument, `call: ServerCall`, has the request `metadata` (lowercase keys), a `signal` aborted when the client cancels or the deadline passes, the `deadline`, `setHeader(key, value)` (before the first response) and `setTrailer(key, value)`.
55
+
56
+ Errors: throw a `GrpcError(code, details, metadata?)` to answer that status. Any other error answers `UNKNOWN` with the error's message and is logged.
57
+
58
+ ```yaml
59
+ grpc:
60
+ server:
61
+ enabled: true # false: no server even with @GrpcService components
62
+ port: 50051 # CELL_GRPC__SERVER__PORT; 0 takes a free port
63
+ host: 127.0.0.1 # CELL_GRPC__SERVER__HOST=0.0.0.0 in containers
64
+ maxReceiveMessageSize: 4194304
65
+ ```
66
+
67
+ The gRPC server is a second port next to the HTTP one of `@celljs/express-adapter`; an application without HTTP needs no adapter (`cell build` then warns that no component provides the `http` entry, which is expected). Outside a Cell application, `new GrpcServer(options).addService(Greeter, impl).listen(port, host)` does the same, and `server.handleStream(stream, headers)` serves the streams of an HTTP/2 server of your own (e.g. `http2.createSecureServer()` for TLS).
68
+
69
+ ## Call it
70
+
71
+ ```ts
72
+ import { GrpcChannel } from '@celljs/grpc';
73
+
74
+ export interface GreeterClient {
75
+ sayHello: UnaryCall<Partial<HelloRequest>, HelloReply>;
76
+ sayHelloStream: ServerStreamCall<Partial<HelloRequest>, HelloReply>;
77
+ }
78
+
79
+ const channel = new GrpcChannel('localhost:50051', { metadata: { authorization: 'Bearer ...' }, timeout: 5000 });
80
+ const greeter = channel.createClient<GreeterClient>(Greeter);
81
+
82
+ const { message } = await greeter.sayHello({ name: 'Cell' });
83
+ for await (const reply of greeter.sayHelloStream({ name: 'Cell' })) { ... } // break cancels the call
84
+ await greeter.sayHelloToAll([{ name: 'a' }, { name: 'b' }]); // any (async) iterable
85
+ await greeter.sayHello({ name: 'Cell' }, { timeout: 1000, signal, metadata: { 'x-trace-bin': bytes } });
86
+ channel.close();
87
+ ```
88
+
89
+ A channel is one HTTP/2 connection, opened on the first call and reopened when lost; share it between clients of the same server. An idle channel does not keep the process alive. Failed calls reject with a `GrpcError` (`code`, `details`, trailing `metadata`): `UNAVAILABLE` when the server cannot be reached, `DEADLINE_EXCEEDED`, `CANCELLED`... A request that cannot be encoded rejects with a `TypeError` naming the field, before anything is sent.
90
+
91
+ ## Values
92
+
93
+ | Protobuf | JavaScript |
94
+ | --- | --- |
95
+ | field `user_id` | property `userId` (encoding also takes `user_id`) |
96
+ | `int32`, `uint32`, `sint32`, `fixed32`, `sfixed32`, `float`, `double` | `number` |
97
+ | `int64`, `uint64`, `sint64`, `fixed64`, `sfixed64` | decimal `string` (encoding also takes `number` and `bigint`) |
98
+ | `bool`, `string` | `boolean`, `string` |
99
+ | `bytes` | `Uint8Array` (encoding also takes base64) |
100
+ | enum | value name (encoding also takes the number; unknown numbers decode as numbers) |
101
+ | message | object; `google.protobuf.Timestamp` is `{ seconds: '…', nanos: 0 }` |
102
+ | `repeated` / `map<K, V>` | array / plain object with string keys |
103
+ | `oneof kind` | the set member, and `kind: 'memberName'` |
104
+
105
+ Decoded messages have every field without explicit presence at its default (`0`, `''`, `false`, first enum value, `[]`, `{}`); message fields, `optional` fields and oneof members are left out when not set. Unknown fields are skipped.
106
+
107
+ ## Testing
108
+
109
+ In `cell.test.yml`, `backend.grpc.server.port: 0` gives the test application a free port; read it from the lifecycle the application loaded:
110
+
111
+ ```ts
112
+ const app = await createTestApp();
113
+ const { GrpcServerLifecycle } = await app.import('@celljs/grpc');
114
+ const channel = new GrpcChannel(`127.0.0.1:${app.get(GrpcServerLifecycle).port}`);
115
+ ```
116
+
117
+ ## Limits
118
+
119
+ - Runtimes: Node.js >= 18 and Deno 2 for servers and clients; Bun as a client, and as a server from 1.4 (the HTTP/2 cleartext server of earlier versions answers Bun clients only). Not on Cloudflare Workers or FaaS presets: the server needs a long-running process with its own port.
120
+ - The server speaks cleartext HTTP/2 (h2c); terminate TLS in front of it, or serve `handleStream()` from your own TLS server.
121
+ - Received messages may be compressed with gzip or deflate; sent messages are not compressed.
122
+ - `.proto`: proto2 and proto3. Options, `reserved`, extensions and `extend` are read and ignored; groups and editions are rejected. No server reflection, health service or gRPC-Web.
@@ -0,0 +1,32 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "properties": {
4
+ "grpc": {
5
+ "type": "object",
6
+ "description": "gRPC.",
7
+ "properties": {
8
+ "server": {
9
+ "type": "object",
10
+ "properties": {
11
+ "enabled": {
12
+ "type": "boolean",
13
+ "description": "Start the gRPC server when there are @GrpcService components."
14
+ },
15
+ "port": {
16
+ "type": "integer",
17
+ "description": "Override with CELL_GRPC__SERVER__PORT."
18
+ },
19
+ "host": {
20
+ "type": "string",
21
+ "description": "0.0.0.0 in containers."
22
+ },
23
+ "maxReceiveMessageSize": {
24
+ "type": "integer",
25
+ "description": "Largest request message, in bytes."
26
+ }
27
+ }
28
+ }
29
+ }
30
+ }
31
+ }
32
+ }
package/cell.yml ADDED
@@ -0,0 +1,9 @@
1
+ grpc:
2
+ server:
3
+ # The gRPC server starts with the application when it has @GrpcService components.
4
+ enabled: true
5
+ # Override with CELL_GRPC__SERVER__PORT / CELL_GRPC__SERVER__HOST (0.0.0.0 in containers).
6
+ port: 50051
7
+ host: 127.0.0.1
8
+ # Largest request message accepted, in bytes (gRPC's default is 4 MiB).
9
+ maxReceiveMessageSize: 4194304
@@ -0,0 +1,31 @@
1
+ /**
2
+ * The messages of a stream as an async iterable. `pause` is called when `highWaterMark` messages are
3
+ * waiting, `resume` once the consumer has taken them all; `onReturn` when the consumer stops early.
4
+ */
5
+ export declare class AsyncQueue<T> implements AsyncIterable<T> {
6
+ protected readonly options: {
7
+ highWaterMark?: number;
8
+ pause?: () => void;
9
+ resume?: () => void;
10
+ onReturn?: () => void;
11
+ };
12
+ protected readonly items: T[];
13
+ protected waiter?: {
14
+ resolve: (result: IteratorResult<T>) => void;
15
+ reject: (error: unknown) => void;
16
+ };
17
+ protected ended: boolean;
18
+ protected error: unknown;
19
+ protected paused: boolean;
20
+ constructor(options?: {
21
+ highWaterMark?: number;
22
+ pause?: () => void;
23
+ resume?: () => void;
24
+ onReturn?: () => void;
25
+ });
26
+ push(item: T): void;
27
+ /** Ends the iteration, with `error` thrown to the consumer once the waiting messages are taken. */
28
+ end(error?: unknown): void;
29
+ next(): Promise<IteratorResult<T>>;
30
+ [Symbol.asyncIterator](): AsyncIterator<T>;
31
+ }
@@ -0,0 +1,80 @@
1
+ /**
2
+ * The messages of a stream as an async iterable. `pause` is called when `highWaterMark` messages are
3
+ * waiting, `resume` once the consumer has taken them all; `onReturn` when the consumer stops early.
4
+ */
5
+ export class AsyncQueue {
6
+ constructor(options = {}) {
7
+ this.options = options;
8
+ this.items = [];
9
+ this.ended = false;
10
+ this.paused = false;
11
+ }
12
+ push(item) {
13
+ var _a, _b;
14
+ var _c;
15
+ if (this.ended) {
16
+ return;
17
+ }
18
+ if (this.waiter) {
19
+ const { resolve } = this.waiter;
20
+ this.waiter = undefined;
21
+ resolve({ value: item, done: false });
22
+ return;
23
+ }
24
+ this.items.push(item);
25
+ if (!this.paused && this.items.length >= ((_c = this.options.highWaterMark) !== null && _c !== void 0 ? _c : 16)) {
26
+ this.paused = true;
27
+ (_b = (_a = this.options).pause) === null || _b === void 0 ? void 0 : _b.call(_a);
28
+ }
29
+ }
30
+ /** Ends the iteration, with `error` thrown to the consumer once the waiting messages are taken. */
31
+ end(error) {
32
+ if (this.ended) {
33
+ return;
34
+ }
35
+ this.ended = true;
36
+ this.error = error;
37
+ if (this.waiter) {
38
+ const { resolve, reject } = this.waiter;
39
+ this.waiter = undefined;
40
+ if (error) {
41
+ reject(error);
42
+ }
43
+ else {
44
+ resolve({ value: undefined, done: true });
45
+ }
46
+ }
47
+ }
48
+ next() {
49
+ var _a, _b;
50
+ if (this.items.length > 0) {
51
+ const value = this.items.shift();
52
+ if (this.paused && this.items.length === 0) {
53
+ this.paused = false;
54
+ (_b = (_a = this.options).resume) === null || _b === void 0 ? void 0 : _b.call(_a);
55
+ }
56
+ return Promise.resolve({ value, done: false });
57
+ }
58
+ if (this.ended) {
59
+ return this.error ? Promise.reject(this.error) : Promise.resolve({ value: undefined, done: true });
60
+ }
61
+ return new Promise((resolve, reject) => {
62
+ this.waiter = { resolve, reject };
63
+ });
64
+ }
65
+ [Symbol.asyncIterator]() {
66
+ return {
67
+ next: () => this.next(),
68
+ return: async () => {
69
+ var _a, _b;
70
+ this.items.length = 0;
71
+ if (!this.ended) {
72
+ this.ended = true;
73
+ (_b = (_a = this.options).onReturn) === null || _b === void 0 ? void 0 : _b.call(_a);
74
+ }
75
+ return { value: undefined, done: true };
76
+ },
77
+ };
78
+ }
79
+ }
80
+ //# sourceMappingURL=async-queue.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"async-queue.js","sourceRoot":"","sources":["../../../src/node/call/async-queue.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,33 @@
1
+ import type { Metadata } from './metadata.js';
2
+ /** gRPC status codes. */
3
+ export declare enum GrpcStatus {
4
+ OK = 0,
5
+ CANCELLED = 1,
6
+ UNKNOWN = 2,
7
+ INVALID_ARGUMENT = 3,
8
+ DEADLINE_EXCEEDED = 4,
9
+ NOT_FOUND = 5,
10
+ ALREADY_EXISTS = 6,
11
+ PERMISSION_DENIED = 7,
12
+ RESOURCE_EXHAUSTED = 8,
13
+ FAILED_PRECONDITION = 9,
14
+ ABORTED = 10,
15
+ OUT_OF_RANGE = 11,
16
+ UNIMPLEMENTED = 12,
17
+ INTERNAL = 13,
18
+ UNAVAILABLE = 14,
19
+ DATA_LOSS = 15,
20
+ UNAUTHENTICATED = 16
21
+ }
22
+ /**
23
+ * A call that ended with a status other than OK. Throw it from a service method to answer with that
24
+ * status; clients reject with it. Errors of other types become `UNKNOWN` with the error's message.
25
+ */
26
+ export declare class GrpcError extends Error {
27
+ readonly code: GrpcStatus;
28
+ readonly details: string;
29
+ readonly metadata: Metadata;
30
+ constructor(code: GrpcStatus, details?: string, metadata?: Metadata);
31
+ /** The status of any error: a `GrpcError`, or one with a numeric gRPC `code` as @grpc/grpc-js throws them. */
32
+ static from(error: unknown): GrpcError;
33
+ }
@@ -0,0 +1,48 @@
1
+ /** gRPC status codes. */
2
+ export var GrpcStatus;
3
+ (function (GrpcStatus) {
4
+ GrpcStatus[GrpcStatus["OK"] = 0] = "OK";
5
+ GrpcStatus[GrpcStatus["CANCELLED"] = 1] = "CANCELLED";
6
+ GrpcStatus[GrpcStatus["UNKNOWN"] = 2] = "UNKNOWN";
7
+ GrpcStatus[GrpcStatus["INVALID_ARGUMENT"] = 3] = "INVALID_ARGUMENT";
8
+ GrpcStatus[GrpcStatus["DEADLINE_EXCEEDED"] = 4] = "DEADLINE_EXCEEDED";
9
+ GrpcStatus[GrpcStatus["NOT_FOUND"] = 5] = "NOT_FOUND";
10
+ GrpcStatus[GrpcStatus["ALREADY_EXISTS"] = 6] = "ALREADY_EXISTS";
11
+ GrpcStatus[GrpcStatus["PERMISSION_DENIED"] = 7] = "PERMISSION_DENIED";
12
+ GrpcStatus[GrpcStatus["RESOURCE_EXHAUSTED"] = 8] = "RESOURCE_EXHAUSTED";
13
+ GrpcStatus[GrpcStatus["FAILED_PRECONDITION"] = 9] = "FAILED_PRECONDITION";
14
+ GrpcStatus[GrpcStatus["ABORTED"] = 10] = "ABORTED";
15
+ GrpcStatus[GrpcStatus["OUT_OF_RANGE"] = 11] = "OUT_OF_RANGE";
16
+ GrpcStatus[GrpcStatus["UNIMPLEMENTED"] = 12] = "UNIMPLEMENTED";
17
+ GrpcStatus[GrpcStatus["INTERNAL"] = 13] = "INTERNAL";
18
+ GrpcStatus[GrpcStatus["UNAVAILABLE"] = 14] = "UNAVAILABLE";
19
+ GrpcStatus[GrpcStatus["DATA_LOSS"] = 15] = "DATA_LOSS";
20
+ GrpcStatus[GrpcStatus["UNAUTHENTICATED"] = 16] = "UNAUTHENTICATED";
21
+ })(GrpcStatus || (GrpcStatus = {}));
22
+ /**
23
+ * A call that ended with a status other than OK. Throw it from a service method to answer with that
24
+ * status; clients reject with it. Errors of other types become `UNKNOWN` with the error's message.
25
+ */
26
+ export class GrpcError extends Error {
27
+ constructor(code, details = '', metadata = {}) {
28
+ var _a, _b;
29
+ super(details ? `${(_a = GrpcStatus[code]) !== null && _a !== void 0 ? _a : code}: ${details}` : ((_b = GrpcStatus[code]) !== null && _b !== void 0 ? _b : String(code)));
30
+ this.code = code;
31
+ this.details = details;
32
+ this.metadata = metadata;
33
+ this.name = 'GrpcError';
34
+ }
35
+ /** The status of any error: a `GrpcError`, or one with a numeric gRPC `code` as @grpc/grpc-js throws them. */
36
+ static from(error) {
37
+ var _a, _b;
38
+ if (error instanceof GrpcError) {
39
+ return error;
40
+ }
41
+ const e = error;
42
+ if (typeof (e === null || e === void 0 ? void 0 : e.code) === 'number' && GrpcStatus[e.code] !== undefined) {
43
+ return new GrpcError(e.code, String((_b = (_a = e.details) !== null && _a !== void 0 ? _a : e.message) !== null && _b !== void 0 ? _b : ''));
44
+ }
45
+ return new GrpcError(GrpcStatus.UNKNOWN, error instanceof Error ? error.message : String(error));
46
+ }
47
+ }
48
+ //# sourceMappingURL=grpc-status.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"grpc-status.js","sourceRoot":"","sources":["../../../src/node/call/grpc-status.ts"],"names":[],"mappings":"AAEA,yBAAyB;AACzB,MAAM,CAAN,IAAY,UAkBX;AAlBD,WAAY,UAAU;IAClB,uCAAM,CAAA;IACN,qDAAa,CAAA;IACb,iDAAW,CAAA;IACX,mEAAoB,CAAA;IACpB,qEAAqB,CAAA;IACrB,qDAAa,CAAA;IACb,+DAAkB,CAAA;IAClB,qEAAqB,CAAA;IACrB,uEAAsB,CAAA;IACtB,yEAAuB,CAAA;IACvB,kDAAY,CAAA;IACZ,4DAAiB,CAAA;IACjB,8DAAkB,CAAA;IAClB,oDAAa,CAAA;IACb,0DAAgB,CAAA;IAChB,sDAAc,CAAA;IACd,kEAAoB,CAAA;AACxB,CAAC,EAlBW,UAAU,KAAV,UAAU,QAkBrB;AAED;;;GAGG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAChC,YACa,IAAgB,EAChB,OAAO,GAAG,EAAE,EACZ,QAAQ,GAAa,EAAE;;QAEhC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,MAAA,UAAU,CAAC,IAAI,CAAC,mCAAI,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,OAAC,UAAU,CAAC,IAAI,CAAC,mCAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;oBAJvF,IAAI;uBACJ,OAAO;wBACP,QAAQ;QAGjB,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC5B,CAAC;IAED,8GAA8G;IAC9G,MAAM,CAAC,IAAI,CAAC,KAAc;;QACtB,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;YAC7B,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,MAAM,CAAC,GAAG,KAAiE,CAAC;QAC5E,IAAI,QAAO,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,IAAI,CAAA,KAAK,QAAQ,IAAI,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YAClE,OAAO,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,aAAC,CAAC,CAAC,OAAO,mCAAI,CAAC,CAAC,OAAO,mCAAI,EAAE,CAAC,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,IAAI,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACrG,CAAC;CACJ"}
@@ -0,0 +1,24 @@
1
+ /** Default limit of a received message: 4 MiB, as in other gRPC implementations. */
2
+ export declare const DEFAULT_MAX_RECEIVE_MESSAGE_SIZE: number;
3
+ /** The encodings messages may be compressed with, for `grpc-accept-encoding`. */
4
+ export declare const ACCEPT_ENCODING = "identity,deflate,gzip";
5
+ export declare namespace MessageFramer {
6
+ /** A message prefixed with gRPC's 5-byte header (uncompressed flag, big-endian length). */
7
+ function frame(message: Uint8Array): Uint8Array;
8
+ }
9
+ /** Splits the DATA of an HTTP/2 stream into gRPC messages, decompressing them when flagged. */
10
+ export declare class MessageDeframer {
11
+ protected readonly encoding: string;
12
+ protected readonly maxMessageSize: number;
13
+ protected chunks: Uint8Array[];
14
+ protected buffered: number;
15
+ protected expected: number;
16
+ protected compressed: boolean;
17
+ constructor(encoding: string, maxMessageSize?: number);
18
+ /** The complete messages once `chunk` is added. */
19
+ push(chunk: Uint8Array): Uint8Array[];
20
+ /** Whether a message was cut off by the end of the stream. */
21
+ get pending(): boolean;
22
+ protected decompress(message: Uint8Array): Uint8Array;
23
+ protected take(count: number): Uint8Array;
24
+ }
@@ -0,0 +1,105 @@
1
+ import { gunzipSync, inflateSync } from 'node:zlib';
2
+ import { GrpcError, GrpcStatus } from './grpc-status.js';
3
+ /** Default limit of a received message: 4 MiB, as in other gRPC implementations. */
4
+ export const DEFAULT_MAX_RECEIVE_MESSAGE_SIZE = 4 * 1024 * 1024;
5
+ /** The encodings messages may be compressed with, for `grpc-accept-encoding`. */
6
+ export const ACCEPT_ENCODING = 'identity,deflate,gzip';
7
+ export var MessageFramer;
8
+ (function (MessageFramer) {
9
+ /** A message prefixed with gRPC's 5-byte header (uncompressed flag, big-endian length). */
10
+ function frame(message) {
11
+ const framed = new Uint8Array(message.length + 5);
12
+ new DataView(framed.buffer).setUint32(1, message.length);
13
+ framed.set(message, 5);
14
+ return framed;
15
+ }
16
+ MessageFramer.frame = frame;
17
+ })(MessageFramer || (MessageFramer = {}));
18
+ /** Splits the DATA of an HTTP/2 stream into gRPC messages, decompressing them when flagged. */
19
+ export class MessageDeframer {
20
+ constructor(encoding, maxMessageSize = DEFAULT_MAX_RECEIVE_MESSAGE_SIZE) {
21
+ this.encoding = encoding;
22
+ this.maxMessageSize = maxMessageSize;
23
+ this.chunks = [];
24
+ this.buffered = 0;
25
+ this.expected = -1;
26
+ this.compressed = false;
27
+ if (!['identity', 'gzip', 'deflate'].includes(encoding)) {
28
+ throw new GrpcError(GrpcStatus.UNIMPLEMENTED, `Unsupported message encoding '${encoding}' (supported: ${ACCEPT_ENCODING})`);
29
+ }
30
+ }
31
+ /** The complete messages once `chunk` is added. */
32
+ push(chunk) {
33
+ this.chunks.push(chunk);
34
+ this.buffered += chunk.length;
35
+ const messages = [];
36
+ for (;;) {
37
+ if (this.expected < 0) {
38
+ if (this.buffered < 5) {
39
+ break;
40
+ }
41
+ const head = this.take(5);
42
+ this.compressed = head[0] === 1;
43
+ this.expected = new DataView(head.buffer, head.byteOffset, 5).getUint32(1);
44
+ if (this.expected > this.maxMessageSize) {
45
+ throw new GrpcError(GrpcStatus.RESOURCE_EXHAUSTED, `Received message larger than max (${this.expected} vs. ${this.maxMessageSize})`);
46
+ }
47
+ }
48
+ if (this.buffered < this.expected) {
49
+ break;
50
+ }
51
+ const message = this.take(this.expected);
52
+ this.expected = -1;
53
+ messages.push(this.compressed ? this.decompress(message) : message);
54
+ }
55
+ return messages;
56
+ }
57
+ /** Whether a message was cut off by the end of the stream. */
58
+ get pending() {
59
+ return this.buffered > 0 || this.expected >= 0;
60
+ }
61
+ decompress(message) {
62
+ if (this.encoding === 'identity') {
63
+ throw new GrpcError(GrpcStatus.INTERNAL, 'Received a compressed message without grpc-encoding');
64
+ }
65
+ try {
66
+ const options = { maxOutputLength: this.maxMessageSize };
67
+ return this.encoding === 'gzip' ? gunzipSync(message, options) : inflateSync(message, options);
68
+ }
69
+ catch (error) {
70
+ if (error.code === 'ERR_BUFFER_TOO_LARGE') {
71
+ throw new GrpcError(GrpcStatus.RESOURCE_EXHAUSTED, `Received message larger than max (${this.maxMessageSize}) once decompressed`);
72
+ }
73
+ throw new GrpcError(GrpcStatus.INTERNAL, `Could not decompress a message: ${error.message}`);
74
+ }
75
+ }
76
+ take(count) {
77
+ this.buffered -= count;
78
+ const first = this.chunks[0];
79
+ if (first && first.length >= count) {
80
+ if (first.length === count) {
81
+ this.chunks.shift();
82
+ }
83
+ else {
84
+ this.chunks[0] = first.subarray(count);
85
+ }
86
+ return first.subarray(0, count);
87
+ }
88
+ const result = new Uint8Array(count);
89
+ let offset = 0;
90
+ while (offset < count) {
91
+ const chunk = this.chunks[0];
92
+ const n = Math.min(chunk.length, count - offset);
93
+ result.set(chunk.subarray(0, n), offset);
94
+ offset += n;
95
+ if (n === chunk.length) {
96
+ this.chunks.shift();
97
+ }
98
+ else {
99
+ this.chunks[0] = chunk.subarray(n);
100
+ }
101
+ }
102
+ return result;
103
+ }
104
+ }
105
+ //# sourceMappingURL=message-framer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"message-framer.js","sourceRoot":"","sources":["../../../src/node/call/message-framer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,15 @@
1
+ import type { IncomingHttpHeaders, OutgoingHttpHeaders } from 'node:http2';
2
+ /** A metadata value: a string, or bytes for keys ending in `-bin`. */
3
+ export type MetadataValue = string | Uint8Array;
4
+ /** gRPC metadata: HTTP/2 headers and trailers with lowercase keys. */
5
+ export type Metadata = Record<string, MetadataValue | MetadataValue[]>;
6
+ export declare namespace MetadataUtil {
7
+ function toHeaders(metadata: Metadata | undefined, headers?: OutgoingHttpHeaders): OutgoingHttpHeaders;
8
+ function fromHeaders(headers: IncomingHttpHeaders): Metadata;
9
+ /** `grpc-message` is percent-encoded UTF-8. */
10
+ function encodeMessage(message: string): string;
11
+ function decodeMessage(value: unknown): string;
12
+ /** Parses `grpc-timeout` (`100m`, `5S`...) to milliseconds. */
13
+ function parseTimeout(value: unknown): number | undefined;
14
+ function formatTimeout(milliseconds: number): string;
15
+ }
@@ -0,0 +1,81 @@
1
+ /** Headers that carry the protocol, not metadata. */
2
+ const RESERVED = new Set(['content-type', 'te', 'grpc-timeout', 'grpc-encoding', 'grpc-accept-encoding', 'grpc-status', 'grpc-message', 'content-length']);
3
+ const KEY = /^[0-9a-z_.-]+$/;
4
+ /** Milliseconds per unit of `grpc-timeout`. */
5
+ const TIMEOUT_UNITS = { H: 3600000, M: 60000, S: 1000, m: 1, u: 0.001, n: 0.000001 };
6
+ export var MetadataUtil;
7
+ (function (MetadataUtil) {
8
+ function toHeaders(metadata, headers = {}) {
9
+ if (!metadata) {
10
+ return headers;
11
+ }
12
+ for (const [name, value] of Object.entries(metadata)) {
13
+ const key = name.toLowerCase();
14
+ if (!KEY.test(key) || key.startsWith('grpc-') || RESERVED.has(key)) {
15
+ throw new TypeError(`'${name}' is not a valid metadata key: use lowercase letters, digits, '_', '.' and '-', not reserved names.`);
16
+ }
17
+ const binary = key.endsWith('-bin');
18
+ const encode = (v) => {
19
+ if (binary) {
20
+ return Buffer.from(typeof v === 'string' ? Buffer.from(v) : v).toString('base64');
21
+ }
22
+ if (typeof v !== 'string') {
23
+ throw new TypeError(`The metadata value of '${key}' is binary; binary keys end in '-bin'.`);
24
+ }
25
+ return v;
26
+ };
27
+ headers[key] = Array.isArray(value) ? value.map(encode) : encode(value);
28
+ }
29
+ return headers;
30
+ }
31
+ MetadataUtil.toHeaders = toHeaders;
32
+ function fromHeaders(headers) {
33
+ const metadata = {};
34
+ for (const [key, value] of Object.entries(headers)) {
35
+ if (value === undefined || key.startsWith(':') || RESERVED.has(key)) {
36
+ continue;
37
+ }
38
+ if (key.endsWith('-bin')) {
39
+ // Several binary values may arrive joined by commas.
40
+ const values = (Array.isArray(value) ? value : String(value).split(',')).map(v => new Uint8Array(Buffer.from(v.trim(), 'base64')));
41
+ metadata[key] = values.length === 1 ? values[0] : values;
42
+ }
43
+ else {
44
+ metadata[key] = Array.isArray(value) ? value : String(value);
45
+ }
46
+ }
47
+ return metadata;
48
+ }
49
+ MetadataUtil.fromHeaders = fromHeaders;
50
+ /** `grpc-message` is percent-encoded UTF-8. */
51
+ function encodeMessage(message) {
52
+ return message.replace(/[^\x20-\x24\x26-\x7e]+/g, s => encodeURIComponent(s));
53
+ }
54
+ MetadataUtil.encodeMessage = encodeMessage;
55
+ function decodeMessage(value) {
56
+ const text = Array.isArray(value) ? value.join(',') : String(value !== null && value !== void 0 ? value : '');
57
+ try {
58
+ return decodeURIComponent(text);
59
+ }
60
+ catch (_a) {
61
+ return text;
62
+ }
63
+ }
64
+ MetadataUtil.decodeMessage = decodeMessage;
65
+ /** Parses `grpc-timeout` (`100m`, `5S`...) to milliseconds. */
66
+ function parseTimeout(value) {
67
+ const match = /^(\d{1,8})([HMSmun])$/.exec(String(value !== null && value !== void 0 ? value : ''));
68
+ if (!match) {
69
+ return undefined;
70
+ }
71
+ const unit = TIMEOUT_UNITS[match[2]];
72
+ return Number(match[1]) * unit;
73
+ }
74
+ MetadataUtil.parseTimeout = parseTimeout;
75
+ function formatTimeout(milliseconds) {
76
+ const ms = Math.max(0, Math.ceil(milliseconds));
77
+ return ms < 1e8 ? `${ms}m` : `${Math.min(99999999, Math.ceil(ms / 1000))}S`;
78
+ }
79
+ MetadataUtil.formatTimeout = formatTimeout;
80
+ })(MetadataUtil || (MetadataUtil = {}));
81
+ //# sourceMappingURL=metadata.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../src/node/call/metadata.ts"],"names":[],"mappings":"AAQA,qDAAqD;AACrD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,IAAI,EAAE,cAAc,EAAE,eAAe,EAAE,sBAAsB,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAC3J,MAAM,GAAG,GAAG,gBAAgB,CAAC;AAC7B,+CAA+C;AAC/C,MAAM,aAAa,GAA2B,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC;AAE7G,MAAM,KAAW,YAAY,CAsE5B;AAtED,WAAiB,YAAY;IACzB,SAAgB,SAAS,CAAC,QAA8B,EAAE,OAAO,GAAwB,EAAE;QACvF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,OAAO,OAAO,CAAC;QACnB,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnD,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAC/B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACjE,MAAM,IAAI,SAAS,CAAC,IAAI,IAAI,qGAAqG,CAAC,CAAC;YACvI,CAAC;YACD,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACpC,MAAM,MAAM,GAAG,CAAC,CAAgB,EAAE,EAAE;gBAChC,IAAI,MAAM,EAAE,CAAC;oBACT,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBACtF,CAAC;gBACD,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;oBACxB,MAAM,IAAI,SAAS,CAAC,0BAA0B,GAAG,yCAAyC,CAAC,CAAC;gBAChG,CAAC;gBACD,OAAO,CAAC,CAAC;YACb,CAAC,CAAC;YACF,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO,OAAO,CAAC;IACnB,CAAC;IAtBe,aAAA,SAAS,YAsBxB,CAAA;IAED,SAAgB,WAAW,CAAC,OAA4B;QACpD,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACjD,IAAI,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClE,SAAS;YACb,CAAC;YACD,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACvB,qDAAqD;gBACrD,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;gBACnI,QAAQ,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YAC7D,CAAC;iBAAM,CAAC;gBACJ,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACjE,CAAC;QACL,CAAC;QACD,OAAO,QAAQ,CAAC;IACpB,CAAC;IAfe,aAAA,WAAW,cAe1B,CAAA;IAED,+CAA+C;IAC/C,SAAgB,aAAa,CAAC,OAAe;QACzC,OAAO,OAAO,CAAC,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IAClF,CAAC;IAFe,aAAA,aAAa,gBAE5B,CAAA;IAED,SAAgB,aAAa,CAAC,KAAc;QACxC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,EAAE,CAAC,CAAC;QAC1E,IAAI,CAAC;YACD,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;mBAAO,CAAC;YACL,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAPe,aAAA,aAAa,gBAO5B,CAAA;IAED,+DAA+D;IAC/D,SAAgB,YAAY,CAAC,KAAc;QACvC,MAAM,KAAK,GAAG,uBAAuB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,EAAE,CAAC,CAAC,CAAC;QAChE,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,OAAO,SAAS,CAAC;QACrB,CAAC;QACD,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACnC,CAAC;IAPe,aAAA,YAAY,eAO3B,CAAA;IAED,SAAgB,aAAa,CAAC,YAAoB;QAC9C,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;QAChD,OAAO,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC;IAChF,CAAC;IAHe,aAAA,aAAa,gBAG5B,CAAA;AACL,CAAC,EAtEgB,YAAY,KAAZ,YAAY,QAsE5B"}