@spine-event-engine/server 2.0.0-snapshot.25 → 2.0.0-snapshot.28

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 (207) hide show
  1. package/README.md +104 -16
  2. package/REFERENCE.md +486 -57
  3. package/dist/agent/agent-history.d.ts +19 -3
  4. package/dist/agent/agent-history.d.ts.map +1 -1
  5. package/dist/agent/agent-history.js +41 -10
  6. package/dist/agent/agent-history.js.map +1 -1
  7. package/dist/agent/agent-live-ai-runtime.d.ts +1 -1
  8. package/dist/agent/agent-live-ai-runtime.js +1 -1
  9. package/dist/agent/agent-live-budget.d.ts +1 -1
  10. package/dist/agent/agent-live-budget.js +1 -1
  11. package/dist/agent/agent-live-read-runtime.d.ts +13 -2
  12. package/dist/agent/agent-live-read-runtime.d.ts.map +1 -1
  13. package/dist/agent/agent-live-read-runtime.js +6 -5
  14. package/dist/agent/agent-live-read-runtime.js.map +1 -1
  15. package/dist/browser/browser-admission.d.ts +47 -0
  16. package/dist/browser/browser-admission.d.ts.map +1 -0
  17. package/dist/browser/browser-admission.js +200 -0
  18. package/dist/browser/browser-admission.js.map +1 -0
  19. package/dist/browser/browser-server.d.ts +171 -1
  20. package/dist/browser/browser-server.d.ts.map +1 -1
  21. package/dist/browser/browser-server.js +1027 -303
  22. package/dist/browser/browser-server.js.map +1 -1
  23. package/dist/browser/durable-subscription-bindings.d.ts +5 -0
  24. package/dist/browser/durable-subscription-bindings.d.ts.map +1 -1
  25. package/dist/browser/durable-subscription-bindings.js +226 -38
  26. package/dist/browser/durable-subscription-bindings.js.map +1 -1
  27. package/dist/browser/index.d.ts +1 -1
  28. package/dist/browser/index.d.ts.map +1 -1
  29. package/dist/browser/options.d.ts +53 -2
  30. package/dist/browser/options.d.ts.map +1 -1
  31. package/dist/bus/command-bus.d.ts +9 -1
  32. package/dist/bus/command-bus.d.ts.map +1 -1
  33. package/dist/bus/command-bus.js +75 -10
  34. package/dist/bus/command-bus.js.map +1 -1
  35. package/dist/bus/command-errors.d.ts +20 -4
  36. package/dist/bus/command-errors.d.ts.map +1 -1
  37. package/dist/bus/command-errors.js +47 -7
  38. package/dist/bus/command-errors.js.map +1 -1
  39. package/dist/bus/event-bus.d.ts +9 -1
  40. package/dist/bus/event-bus.d.ts.map +1 -1
  41. package/dist/bus/event-bus.js +136 -9
  42. package/dist/bus/event-bus.js.map +1 -1
  43. package/dist/context/bounded-context.d.ts +59 -39
  44. package/dist/context/bounded-context.d.ts.map +1 -1
  45. package/dist/context/bounded-context.js +277 -262
  46. package/dist/context/bounded-context.js.map +1 -1
  47. package/dist/context/entity-inbox.d.ts +12 -17
  48. package/dist/context/entity-inbox.d.ts.map +1 -1
  49. package/dist/context/entity-inbox.js +106 -119
  50. package/dist/context/entity-inbox.js.map +1 -1
  51. package/dist/context/local-inbox-handoff.d.ts +13 -13
  52. package/dist/context/local-inbox-handoff.d.ts.map +1 -1
  53. package/dist/context/local-inbox-handoff.js +60 -32
  54. package/dist/context/local-inbox-handoff.js.map +1 -1
  55. package/dist/context/persistent-tenant-index.d.ts +81 -0
  56. package/dist/context/persistent-tenant-index.d.ts.map +1 -0
  57. package/dist/context/persistent-tenant-index.js +270 -0
  58. package/dist/context/persistent-tenant-index.js.map +1 -0
  59. package/dist/context/projection-handoff.d.ts +9 -9
  60. package/dist/context/projection-handoff.d.ts.map +1 -1
  61. package/dist/context/projection-handoff.js +31 -23
  62. package/dist/context/projection-handoff.js.map +1 -1
  63. package/dist/context/tenant-index.d.ts +7 -6
  64. package/dist/context/tenant-index.d.ts.map +1 -1
  65. package/dist/context/tenant-index.js +2 -188
  66. package/dist/context/tenant-index.js.map +1 -1
  67. package/dist/context/tenant-unknown-error.d.ts +2 -2
  68. package/dist/context/tenant-unknown-error.d.ts.map +1 -1
  69. package/dist/context/tenant-unknown-error.js +4 -1
  70. package/dist/context/tenant-unknown-error.js.map +1 -1
  71. package/dist/delivery/delivery-supervisor.d.ts.map +1 -1
  72. package/dist/delivery/delivery-supervisor.js +12 -3
  73. package/dist/delivery/delivery-supervisor.js.map +1 -1
  74. package/dist/delivery/delivery.d.ts +4 -3
  75. package/dist/delivery/delivery.d.ts.map +1 -1
  76. package/dist/delivery/delivery.js +82 -34
  77. package/dist/delivery/delivery.js.map +1 -1
  78. package/dist/delivery/reception-observation.d.ts +3 -3
  79. package/dist/delivery/reception-observation.js +2 -2
  80. package/dist/entity/entity.d.ts +59 -0
  81. package/dist/entity/entity.d.ts.map +1 -1
  82. package/dist/entity/entity.js +60 -0
  83. package/dist/entity/entity.js.map +1 -1
  84. package/dist/handler/app-query-handler.d.ts +60 -0
  85. package/dist/handler/app-query-handler.d.ts.map +1 -0
  86. package/dist/handler/app-query-handler.js +23 -0
  87. package/dist/handler/app-query-handler.js.map +1 -0
  88. package/dist/handler/generated-registry-discovery.d.ts +6 -0
  89. package/dist/handler/generated-registry-discovery.d.ts.map +1 -1
  90. package/dist/handler/generated-registry-discovery.js +71 -2
  91. package/dist/handler/generated-registry-discovery.js.map +1 -1
  92. package/dist/handler/handler-decorators.d.ts +8 -29
  93. package/dist/handler/handler-decorators.d.ts.map +1 -1
  94. package/dist/handler/handler-decorators.js +33 -210
  95. package/dist/handler/handler-decorators.js.map +1 -1
  96. package/dist/handler/spine-metadata-inventory.d.ts +99 -0
  97. package/dist/handler/spine-metadata-inventory.d.ts.map +1 -0
  98. package/dist/handler/spine-metadata-inventory.js +162 -0
  99. package/dist/handler/spine-metadata-inventory.js.map +1 -0
  100. package/dist/index.d.ts +9 -4
  101. package/dist/index.d.ts.map +1 -1
  102. package/dist/index.js +6 -2
  103. package/dist/index.js.map +1 -1
  104. package/dist/repository/command-routing.d.ts +1 -1
  105. package/dist/repository/command-routing.js +1 -1
  106. package/dist/repository/event-routing.d.ts +1 -1
  107. package/dist/repository/event-routing.js +1 -1
  108. package/dist/repository/repository.d.ts +61 -26
  109. package/dist/repository/repository.d.ts.map +1 -1
  110. package/dist/repository/repository.js +612 -306
  111. package/dist/repository/repository.js.map +1 -1
  112. package/dist/repository/state-update-routing.d.ts +1 -1
  113. package/dist/repository/state-update-routing.js +1 -1
  114. package/dist/runtime/signal-publisher.d.ts +23 -8
  115. package/dist/runtime/signal-publisher.d.ts.map +1 -1
  116. package/dist/runtime/signal-publisher.js +11 -8
  117. package/dist/runtime/signal-publisher.js.map +1 -1
  118. package/dist/server/managed-server-application.d.ts +12 -11
  119. package/dist/server/managed-server-application.d.ts.map +1 -1
  120. package/dist/server/managed-server-application.js +41 -25
  121. package/dist/server/managed-server-application.js.map +1 -1
  122. package/dist/server/node-coordinator.d.ts +18 -5
  123. package/dist/server/node-coordinator.d.ts.map +1 -1
  124. package/dist/server/node-coordinator.js +744 -108
  125. package/dist/server/node-coordinator.js.map +1 -1
  126. package/dist/server/reserved-spine-rpc-paths.json +1 -0
  127. package/dist/server/server-environment.d.ts +23 -5
  128. package/dist/server/server-environment.d.ts.map +1 -1
  129. package/dist/server/server-environment.js +89 -24
  130. package/dist/server/server-environment.js.map +1 -1
  131. package/dist/server/server.d.ts +45 -0
  132. package/dist/server/server.d.ts.map +1 -1
  133. package/dist/server/server.js +112 -3
  134. package/dist/server/server.js.map +1 -1
  135. package/dist/services/app-query-execution.d.ts +53 -0
  136. package/dist/services/app-query-execution.d.ts.map +1 -0
  137. package/dist/services/app-query-execution.js +408 -0
  138. package/dist/services/app-query-execution.js.map +1 -0
  139. package/dist/services/native-operation.d.ts +34 -0
  140. package/dist/services/native-operation.d.ts.map +1 -0
  141. package/dist/services/native-operation.js +77 -0
  142. package/dist/services/native-operation.js.map +1 -0
  143. package/dist/services/query-reader.d.ts +32 -7
  144. package/dist/services/query-reader.d.ts.map +1 -1
  145. package/dist/services/query-reader.js +22 -2
  146. package/dist/services/query-reader.js.map +1 -1
  147. package/dist/services/read-request-status.d.ts +65 -0
  148. package/dist/services/read-request-status.d.ts.map +1 -0
  149. package/dist/services/read-request-status.js +151 -0
  150. package/dist/services/read-request-status.js.map +1 -0
  151. package/dist/services/spine-services.d.ts +42 -7
  152. package/dist/services/spine-services.d.ts.map +1 -1
  153. package/dist/services/spine-services.js +1005 -175
  154. package/dist/services/spine-services.js.map +1 -1
  155. package/dist/services/trusted-reader-ingress.d.ts +110 -0
  156. package/dist/services/trusted-reader-ingress.d.ts.map +1 -0
  157. package/dist/services/trusted-reader-ingress.js +102 -0
  158. package/dist/services/trusted-reader-ingress.js.map +1 -0
  159. package/dist/spi/handler-registry.d.ts +2 -0
  160. package/dist/spi/handler-registry.d.ts.map +1 -1
  161. package/dist/spi/handler-registry.js +1 -1
  162. package/dist/spi/handler-registry.js.map +1 -1
  163. package/dist/stand/read-side-filter-engine.d.ts +46 -0
  164. package/dist/stand/read-side-filter-engine.d.ts.map +1 -0
  165. package/dist/stand/read-side-filter-engine.js +356 -0
  166. package/dist/stand/read-side-filter-engine.js.map +1 -0
  167. package/dist/stand/read-side-filter.d.ts +247 -0
  168. package/dist/stand/read-side-filter.d.ts.map +1 -0
  169. package/dist/stand/read-side-filter.js +39 -0
  170. package/dist/stand/read-side-filter.js.map +1 -0
  171. package/dist/stand/read-side-message.d.ts +66 -0
  172. package/dist/stand/read-side-message.d.ts.map +1 -0
  173. package/dist/stand/read-side-message.js +167 -0
  174. package/dist/stand/read-side-message.js.map +1 -0
  175. package/dist/stand/stand-direct-delivery.d.ts +161 -0
  176. package/dist/stand/stand-direct-delivery.d.ts.map +1 -0
  177. package/dist/stand/stand-direct-delivery.js +210 -0
  178. package/dist/stand/stand-direct-delivery.js.map +1 -0
  179. package/dist/stand/stand.d.ts +81 -43
  180. package/dist/stand/stand.d.ts.map +1 -1
  181. package/dist/stand/stand.js +411 -55
  182. package/dist/stand/stand.js.map +1 -1
  183. package/dist/stand/subscription-observer.d.ts.map +1 -1
  184. package/dist/stand/subscription-observer.js +103 -0
  185. package/dist/stand/subscription-observer.js.map +1 -1
  186. package/dist/stand/subscription-read-filters.d.ts +40 -0
  187. package/dist/stand/subscription-read-filters.d.ts.map +1 -0
  188. package/dist/stand/subscription-read-filters.js +91 -0
  189. package/dist/stand/subscription-read-filters.js.map +1 -0
  190. package/dist/stand/subscription-reader-binding.d.ts +20 -0
  191. package/dist/stand/subscription-reader-binding.d.ts.map +1 -0
  192. package/dist/stand/subscription-reader-binding.js +56 -0
  193. package/dist/stand/subscription-reader-binding.js.map +1 -0
  194. package/dist/stand/subscription-records.d.ts +30 -3
  195. package/dist/stand/subscription-records.d.ts.map +1 -1
  196. package/dist/stand/subscription-records.js +61 -16
  197. package/dist/stand/subscription-records.js.map +1 -1
  198. package/dist/stand/subscription-registry.d.ts +49 -14
  199. package/dist/stand/subscription-registry.d.ts.map +1 -1
  200. package/dist/stand/subscription-registry.js +150 -31
  201. package/dist/stand/subscription-registry.js.map +1 -1
  202. package/dist/stand/subscription-runtime.d.ts +7 -2
  203. package/dist/stand/subscription-runtime.d.ts.map +1 -1
  204. package/dist/stand/subscription-runtime.js +131 -25
  205. package/dist/stand/subscription-runtime.js.map +1 -1
  206. package/dist/tsconfig.tsbuildinfo +1 -1
  207. package/package.json +16 -14
@@ -1,11 +1,13 @@
1
1
  import * as http from "node:http";
2
2
  import type { AddressInfo } from "node:net";
3
3
  import { TransportFacts } from "@spine-event-engine/auth";
4
+ import { type ContextValues } from "@connectrpc/connect";
4
5
  import { Http2SessionManager } from "@connectrpc/connect-node";
5
6
  import { ApplicationNode } from "@spine-event-engine/deployment";
6
7
  import type { RunningServer } from "../server/server.js";
7
8
  import { Server } from "../server/server.js";
8
- import type { BrowserAuthRoute, BrowserServerOptions, StandaloneBrowserServerOptions } from "./options.js";
9
+ import type { BrowserAuthRoute, BrowserCredentialReader, BrowserServerOptions, StandaloneBrowserServerOptions } from "./options.js";
10
+ import { BrowserAdmissionPolicy } from "./browser-admission.js";
9
11
  /**
10
12
  * Holds fully normalized options while a browser listener is being assembled.
11
13
  *
@@ -17,6 +19,9 @@ type BrowserHostOptions = BrowserServerOptions & {
17
19
  readonly readMaxBytes: number;
18
20
  readonly writeMaxBytes: number;
19
21
  readonly production: boolean;
22
+ readonly credentialReader: BrowserCredentialReader;
23
+ readonly admissionPolicy: BrowserAdmissionPolicy;
24
+ readonly authRouteMap: ReadonlyMap<string, BrowserAuthRoute>;
20
25
  readonly dynamicManagerFactory?: (node: ApplicationNode) => Http2SessionManager;
21
26
  };
22
27
  /**
@@ -31,35 +36,148 @@ type BrowserServerTestOptions = BrowserServerOptions & Partial<BrowserHostOption
31
36
  * Hosts browser-facing Spine gateway routes independently from native server assembly.
32
37
  */
33
38
  export declare const browserServerImplementation: Readonly<{
39
+ /**
40
+ * Starts a browser listener against the supplied native backend.
41
+ *
42
+ * @param native The native backend to expose through this browser host.
43
+ * @param options Browser listener, admission, and backend configuration.
44
+ * @returns The listening browser endpoint with coordinated native-backend cleanup.
45
+ */
34
46
  open(native: RunningServer, options: BrowserServerOptions): Promise<RunningServer>;
47
+ /**
48
+ * Starts a browser listener against the supplied native backend.
49
+ *
50
+ * @param native The native backend to expose through this browser host.
51
+ * @param options Browser listener, admission, and backend configuration.
52
+ * @returns The listening browser endpoint with coordinated native-backend cleanup.
53
+ */
35
54
  open(native: string | readonly string[] | undefined, options: StandaloneBrowserServerOptions): Promise<RunningServer>;
55
+ /**
56
+ * Starts the browser host and registers it for process-level shutdown.
57
+ *
58
+ * @param options Browser listener, admission, and backend configuration.
59
+ * @returns The running host registered with the process coordinator.
60
+ */
36
61
  run(options: StandaloneBrowserServerOptions): Promise<RunningServer>;
62
+ /**
63
+ * Starts the browser host and registers it for process-level shutdown.
64
+ *
65
+ * @param native The native backend to expose through this browser host.
66
+ * @param options Browser listener, admission, and backend configuration.
67
+ * @returns The running host registered with the process coordinator.
68
+ */
37
69
  run(native: Server, options: BrowserServerOptions): Promise<RunningServer>;
70
+ /**
71
+ * Builds credential extraction and transport-fact adapters for browser requests.
72
+ *
73
+ * @param options Browser listener, admission, and backend configuration.
74
+ * @returns Adapters that the gateway uses to admit each incoming request.
75
+ */
38
76
  requests(options: BrowserServerOptions): {
77
+ /**
78
+ * Reads the credential admitted into this Connect call's context values.
79
+ *
80
+ * @param context Connect context values carrying the reader's result.
81
+ * @returns The admitted credential, or undefined when the reader found none.
82
+ */
39
83
  credential(context: {
40
84
  readonly requestHeader: Headers;
85
+ readonly values?: ContextValues;
41
86
  }): {
42
87
  readonly kind: "bearer" | "cookie";
43
88
  readonly value: string;
44
89
  } | undefined;
90
+ /**
91
+ * Captures browser request headers and origin for admission policy.
92
+ *
93
+ * @param context Incoming request headers; these do not establish authenticated identity.
94
+ * @returns Transport facts containing the browser origin and request headers.
95
+ */
45
96
  transport(context: {
46
97
  readonly requestHeader: Headers;
47
98
  }): ReturnType<typeof TransportFacts.from>;
48
99
  };
100
+ /**
101
+ * Validates a nonempty set of unique canonical HTTP(S) origins.
102
+ *
103
+ * @param origins Canonical browser origins permitted to access the listener.
104
+ * @returns The validated origins for exact admission checks.
105
+ */
49
106
  origins(origins: readonly string[]): ReadonlySet<string>;
107
+ /**
108
+ * Rejects backend URLs containing paths, credentials, queries, or fragments.
109
+ *
110
+ * @param value The backend origin to validate.
111
+ * @returns The original canonical backend origin.
112
+ */
50
113
  backendUrl(value: string): string;
114
+ /**
115
+ * Validates a nonempty list of distinct native backend origins.
116
+ *
117
+ * @param values Native backend origins in routing order.
118
+ * @returns The validated backend origins in their configured order.
119
+ */
51
120
  backendUrls(values: readonly string[]): readonly string[];
121
+ /**
122
+ * Selects the node endpoint and its configured TLS server name.
123
+ *
124
+ * @param node The application node whose native transport is being configured.
125
+ * @returns Transport settings preserving the node's TLS server-name override.
126
+ */
52
127
  dynamicTransportOptions(node: ApplicationNode): {
53
128
  readonly baseUrl: string;
54
129
  readonly nodeOptions?: {
55
130
  readonly servername: string;
56
131
  };
57
132
  };
133
+ /**
134
+ * Checks admission ports and production subscription-persistence requirements.
135
+ *
136
+ * @param options Browser listener, admission, and backend configuration.
137
+ * @param production Whether production persistence requirements must be enforced.
138
+ */
58
139
  requireDurableBindings(options: BrowserServerOptions, production: boolean): void;
140
+ /**
141
+ * Validates authentication routes and rejects duplicate or reserved RPC paths.
142
+ *
143
+ * @param routes Optional HTTP authentication endpoints to validate and index.
144
+ * @returns Validated routes indexed by their exact HTTP path.
145
+ */
59
146
  authRoutes(routes: readonly BrowserAuthRoute[] | undefined): ReadonlyMap<string, BrowserAuthRoute>;
147
+ /**
148
+ * Executes an authentication route within its configured origin, size, and time bounds.
149
+ *
150
+ * @param request The incoming HTTP request.
151
+ * @param response The HTTP response to complete with the route outcome.
152
+ * @param route The matched authentication endpoint and its admission constraints.
153
+ * @param active Controllers tracked so shutdown can abort active authentication requests.
154
+ * @param writeMaxBytes The existing transport bound for the authentication response body.
155
+ * @returns Completion after the HTTP response and request cleanup settle.
156
+ */
60
157
  dispatchAuth(request: http.IncomingMessage, response: http.ServerResponse, route: BrowserAuthRoute, active: Set<AbortController>, writeMaxBytes: number): Promise<void>;
158
+ /**
159
+ * Binds the HTTP listener and propagates startup errors.
160
+ *
161
+ * @param server The HTTP listener being started or stopped.
162
+ * @param host The interface address on which to bind the listener.
163
+ * @param port The requested listener port; zero requests an ephemeral port.
164
+ * @returns The actual bound address, including an allocated ephemeral port.
165
+ */
61
166
  listen(server: http.Server, host: string, port: number): Promise<AddressInfo>;
167
+ /**
168
+ * Stops accepting connections and drains the HTTP listener.
169
+ *
170
+ * @param server The HTTP listener being started or stopped.
171
+ * @returns Completion after the listener closes; rejects on a close error.
172
+ */
62
173
  closeListener(server: http.Server): Promise<void>;
174
+ /**
175
+ * Applies listener defaults and checks browser admission configuration before startup.
176
+ *
177
+ * @param mode Whether a native server is started locally or supplied as a separate backend.
178
+ * @param options Browser listener, admission, and backend configuration.
179
+ * @returns Normalized listener options after all preflight checks pass.
180
+ */
63
181
  preflight(mode: "combined" | "standalone", options: BrowserServerOptions): BrowserHostOptions;
64
182
  }>;
65
183
  /**
@@ -68,21 +186,73 @@ export declare const browserServerImplementation: Readonly<{
68
186
  * @internal
69
187
  */
70
188
  type BrowserServerTestAccess = Omit<typeof browserServerImplementation, "open" | "run" | "requests" | "requireDurableBindings" | "preflight"> & {
189
+ /**
190
+ * Starts a browser listener against the supplied native backend.
191
+ *
192
+ * @param native The native backend to expose through this browser host.
193
+ * @param options Browser listener, admission, and backend configuration.
194
+ * @returns The listening browser endpoint with coordinated native-backend cleanup.
195
+ */
71
196
  open(native: RunningServer | string | readonly string[] | undefined, options: BrowserServerTestOptions): Promise<RunningServer>;
197
+ /**
198
+ * Starts the browser host and registers it for process-level shutdown.
199
+ *
200
+ * @param options Browser listener, admission, and backend configuration.
201
+ * @returns The running host registered with the process coordinator.
202
+ */
72
203
  run(options: BrowserServerTestOptions): Promise<RunningServer>;
204
+ /**
205
+ * Starts the browser host and registers it for process-level shutdown.
206
+ *
207
+ * @param native The native backend to expose through this browser host.
208
+ * @param options Browser listener, admission, and backend configuration.
209
+ * @returns The running host registered with the process coordinator.
210
+ */
73
211
  run(native: Server, options: BrowserServerTestOptions): Promise<RunningServer>;
212
+ /**
213
+ * Builds credential extraction and transport-fact adapters for browser requests.
214
+ *
215
+ * @param options Browser listener, admission, and backend configuration.
216
+ * @returns Adapters that the gateway uses to admit each incoming request.
217
+ */
74
218
  requests(options: BrowserServerTestOptions): {
219
+ /**
220
+ * Reads the credential admitted into this Connect call's context values.
221
+ *
222
+ * @param context Connect context values carrying the reader's result.
223
+ * @returns The admitted credential, or undefined when the reader found none.
224
+ */
75
225
  credential(context: {
76
226
  readonly requestHeader: Headers;
227
+ readonly values?: ContextValues;
77
228
  }): {
78
229
  readonly kind: "bearer" | "cookie";
79
230
  readonly value: string;
80
231
  } | undefined;
232
+ /**
233
+ * Captures browser request headers and origin for admission policy.
234
+ *
235
+ * @param context Incoming request headers; these do not establish authenticated identity.
236
+ * @returns Transport facts containing the browser origin and request headers.
237
+ */
81
238
  transport(context: {
82
239
  readonly requestHeader: Headers;
83
240
  }): ReturnType<typeof TransportFacts.from>;
84
241
  };
242
+ /**
243
+ * Checks admission ports and production subscription-persistence requirements.
244
+ *
245
+ * @param options Browser listener, admission, and backend configuration.
246
+ * @param production Whether production persistence requirements must be enforced.
247
+ */
85
248
  requireDurableBindings(options: BrowserServerTestOptions, production: boolean): void;
249
+ /**
250
+ * Applies listener defaults and checks browser admission configuration before startup.
251
+ *
252
+ * @param mode Whether a native server is started locally or supplied as a separate backend.
253
+ * @param options Browser listener, admission, and backend configuration.
254
+ * @returns Normalized listener options after all preflight checks pass.
255
+ */
86
256
  preflight(mode: "combined" | "standalone", options: BrowserServerTestOptions): BrowserHostOptions;
87
257
  };
88
258
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"browser-server.d.ts","sourceRoot":"","sources":["../../src/browser/browser-server.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,OAAO,EAOL,cAAc,EAMf,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAGL,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,eAAe,EAAsB,MAAM,gCAAgC,CAAC;AAOrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,MAAM,EAAuB,MAAM,qBAAqB,CAAC;AAClE,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EACpB,8BAA8B,EAC/B,MAAM,cAAc,CAAC;AAqBtB;;;;GAIG;AACH,KAAK,kBAAkB,GAAG,oBAAoB,GAAG;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,mBAAmB,CAAC;CACjF,CAAC;AAEF;;;;GAIG;AACH,KAAK,wBAAwB,GAAG,oBAAoB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAEnF;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAAC;IACjD,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACnF,IAAI,CACF,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,EAC9C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1B,GAAG,CAAC,OAAO,EAAE,8BAA8B,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACrE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC3E,QAAQ,CAAC,OAAO,EAAE,oBAAoB,GAAG;QACvC,UAAU,CAAC,OAAO,EAAE;YAAE,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;SAAE,GACnD;YACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;YACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;SACxB,GACD,SAAS,CAAC;QACd,SAAS,CAAC,OAAO,EAAE;YAAE,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;SAAE,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;KACjG,CAAC;IACF,OAAO,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACzD,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,CAAC;IAC1D,uBAAuB,CAAC,IAAI,EAAE,eAAe,GAAG;QAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,WAAW,CAAC,EAAE;YAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC;KACxD,CAAC;IACF,sBAAsB,CAAC,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;IACjF,UAAU,CACR,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAAG,SAAS,GAC9C,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACzC,YAAY,CACV,OAAO,EAAE,IAAI,CAAC,eAAe,EAC7B,QAAQ,EAAE,IAAI,CAAC,cAAc,EAC7B,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE,GAAG,CAAC,eAAe,CAAC,EAC5B,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9E,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,EAAE,OAAO,EAAE,oBAAoB,GAAG,kBAAkB,CAAC;CAC/F,CA6kBC,CAAC;AAEH;;;;GAIG;AACH,KAAK,uBAAuB,GAAG,IAAI,CACjC,OAAO,2BAA2B,EAClC,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,wBAAwB,GAAG,WAAW,CACrE,GAAG;IACF,IAAI,CACF,MAAM,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,EAC9D,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1B,GAAG,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC/D,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC/E,QAAQ,CAAC,OAAO,EAAE,wBAAwB,GAAG;QAC3C,UAAU,CAAC,OAAO,EAAE;YAClB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;SACjC,GAAG;YAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;YAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;SAAE,GAAG,SAAS,CAAC;QAC/E,SAAS,CAAC,OAAO,EAAE;YAAE,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;SAAE,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;KACjG,CAAC;IACF,sBAAsB,CAAC,OAAO,EAAE,wBAAwB,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;IACrF,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,EAAE,OAAO,EAAE,wBAAwB,GAAG,kBAAkB,CAAC;CACnG,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,uBAEpC,CAAC"}
1
+ {"version":3,"file":"browser-server.d.ts","sourceRoot":"","sources":["../../src/browser/browser-server.ts"],"names":[],"mappings":"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"}