@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.
- package/README.md +104 -16
- package/REFERENCE.md +486 -57
- package/dist/agent/agent-history.d.ts +19 -3
- package/dist/agent/agent-history.d.ts.map +1 -1
- package/dist/agent/agent-history.js +41 -10
- package/dist/agent/agent-history.js.map +1 -1
- package/dist/agent/agent-live-ai-runtime.d.ts +1 -1
- package/dist/agent/agent-live-ai-runtime.js +1 -1
- package/dist/agent/agent-live-budget.d.ts +1 -1
- package/dist/agent/agent-live-budget.js +1 -1
- package/dist/agent/agent-live-read-runtime.d.ts +13 -2
- package/dist/agent/agent-live-read-runtime.d.ts.map +1 -1
- package/dist/agent/agent-live-read-runtime.js +6 -5
- package/dist/agent/agent-live-read-runtime.js.map +1 -1
- package/dist/browser/browser-admission.d.ts +47 -0
- package/dist/browser/browser-admission.d.ts.map +1 -0
- package/dist/browser/browser-admission.js +200 -0
- package/dist/browser/browser-admission.js.map +1 -0
- package/dist/browser/browser-server.d.ts +171 -1
- package/dist/browser/browser-server.d.ts.map +1 -1
- package/dist/browser/browser-server.js +1027 -303
- package/dist/browser/browser-server.js.map +1 -1
- package/dist/browser/durable-subscription-bindings.d.ts +5 -0
- package/dist/browser/durable-subscription-bindings.d.ts.map +1 -1
- package/dist/browser/durable-subscription-bindings.js +226 -38
- package/dist/browser/durable-subscription-bindings.js.map +1 -1
- package/dist/browser/index.d.ts +1 -1
- package/dist/browser/index.d.ts.map +1 -1
- package/dist/browser/options.d.ts +53 -2
- package/dist/browser/options.d.ts.map +1 -1
- package/dist/bus/command-bus.d.ts +9 -1
- package/dist/bus/command-bus.d.ts.map +1 -1
- package/dist/bus/command-bus.js +75 -10
- package/dist/bus/command-bus.js.map +1 -1
- package/dist/bus/command-errors.d.ts +20 -4
- package/dist/bus/command-errors.d.ts.map +1 -1
- package/dist/bus/command-errors.js +47 -7
- package/dist/bus/command-errors.js.map +1 -1
- package/dist/bus/event-bus.d.ts +9 -1
- package/dist/bus/event-bus.d.ts.map +1 -1
- package/dist/bus/event-bus.js +136 -9
- package/dist/bus/event-bus.js.map +1 -1
- package/dist/context/bounded-context.d.ts +59 -39
- package/dist/context/bounded-context.d.ts.map +1 -1
- package/dist/context/bounded-context.js +277 -262
- package/dist/context/bounded-context.js.map +1 -1
- package/dist/context/entity-inbox.d.ts +12 -17
- package/dist/context/entity-inbox.d.ts.map +1 -1
- package/dist/context/entity-inbox.js +106 -119
- package/dist/context/entity-inbox.js.map +1 -1
- package/dist/context/local-inbox-handoff.d.ts +13 -13
- package/dist/context/local-inbox-handoff.d.ts.map +1 -1
- package/dist/context/local-inbox-handoff.js +60 -32
- package/dist/context/local-inbox-handoff.js.map +1 -1
- package/dist/context/persistent-tenant-index.d.ts +81 -0
- package/dist/context/persistent-tenant-index.d.ts.map +1 -0
- package/dist/context/persistent-tenant-index.js +270 -0
- package/dist/context/persistent-tenant-index.js.map +1 -0
- package/dist/context/projection-handoff.d.ts +9 -9
- package/dist/context/projection-handoff.d.ts.map +1 -1
- package/dist/context/projection-handoff.js +31 -23
- package/dist/context/projection-handoff.js.map +1 -1
- package/dist/context/tenant-index.d.ts +7 -6
- package/dist/context/tenant-index.d.ts.map +1 -1
- package/dist/context/tenant-index.js +2 -188
- package/dist/context/tenant-index.js.map +1 -1
- package/dist/context/tenant-unknown-error.d.ts +2 -2
- package/dist/context/tenant-unknown-error.d.ts.map +1 -1
- package/dist/context/tenant-unknown-error.js +4 -1
- package/dist/context/tenant-unknown-error.js.map +1 -1
- package/dist/delivery/delivery-supervisor.d.ts.map +1 -1
- package/dist/delivery/delivery-supervisor.js +12 -3
- package/dist/delivery/delivery-supervisor.js.map +1 -1
- package/dist/delivery/delivery.d.ts +4 -3
- package/dist/delivery/delivery.d.ts.map +1 -1
- package/dist/delivery/delivery.js +82 -34
- package/dist/delivery/delivery.js.map +1 -1
- package/dist/delivery/reception-observation.d.ts +3 -3
- package/dist/delivery/reception-observation.js +2 -2
- package/dist/entity/entity.d.ts +59 -0
- package/dist/entity/entity.d.ts.map +1 -1
- package/dist/entity/entity.js +60 -0
- package/dist/entity/entity.js.map +1 -1
- package/dist/handler/app-query-handler.d.ts +60 -0
- package/dist/handler/app-query-handler.d.ts.map +1 -0
- package/dist/handler/app-query-handler.js +23 -0
- package/dist/handler/app-query-handler.js.map +1 -0
- package/dist/handler/generated-registry-discovery.d.ts +6 -0
- package/dist/handler/generated-registry-discovery.d.ts.map +1 -1
- package/dist/handler/generated-registry-discovery.js +71 -2
- package/dist/handler/generated-registry-discovery.js.map +1 -1
- package/dist/handler/handler-decorators.d.ts +8 -29
- package/dist/handler/handler-decorators.d.ts.map +1 -1
- package/dist/handler/handler-decorators.js +33 -210
- package/dist/handler/handler-decorators.js.map +1 -1
- package/dist/handler/spine-metadata-inventory.d.ts +99 -0
- package/dist/handler/spine-metadata-inventory.d.ts.map +1 -0
- package/dist/handler/spine-metadata-inventory.js +162 -0
- package/dist/handler/spine-metadata-inventory.js.map +1 -0
- package/dist/index.d.ts +9 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +6 -2
- package/dist/index.js.map +1 -1
- package/dist/repository/command-routing.d.ts +1 -1
- package/dist/repository/command-routing.js +1 -1
- package/dist/repository/event-routing.d.ts +1 -1
- package/dist/repository/event-routing.js +1 -1
- package/dist/repository/repository.d.ts +61 -26
- package/dist/repository/repository.d.ts.map +1 -1
- package/dist/repository/repository.js +612 -306
- package/dist/repository/repository.js.map +1 -1
- package/dist/repository/state-update-routing.d.ts +1 -1
- package/dist/repository/state-update-routing.js +1 -1
- package/dist/runtime/signal-publisher.d.ts +23 -8
- package/dist/runtime/signal-publisher.d.ts.map +1 -1
- package/dist/runtime/signal-publisher.js +11 -8
- package/dist/runtime/signal-publisher.js.map +1 -1
- package/dist/server/managed-server-application.d.ts +12 -11
- package/dist/server/managed-server-application.d.ts.map +1 -1
- package/dist/server/managed-server-application.js +41 -25
- package/dist/server/managed-server-application.js.map +1 -1
- package/dist/server/node-coordinator.d.ts +18 -5
- package/dist/server/node-coordinator.d.ts.map +1 -1
- package/dist/server/node-coordinator.js +744 -108
- package/dist/server/node-coordinator.js.map +1 -1
- package/dist/server/reserved-spine-rpc-paths.json +1 -0
- package/dist/server/server-environment.d.ts +23 -5
- package/dist/server/server-environment.d.ts.map +1 -1
- package/dist/server/server-environment.js +89 -24
- package/dist/server/server-environment.js.map +1 -1
- package/dist/server/server.d.ts +45 -0
- package/dist/server/server.d.ts.map +1 -1
- package/dist/server/server.js +112 -3
- package/dist/server/server.js.map +1 -1
- package/dist/services/app-query-execution.d.ts +53 -0
- package/dist/services/app-query-execution.d.ts.map +1 -0
- package/dist/services/app-query-execution.js +408 -0
- package/dist/services/app-query-execution.js.map +1 -0
- package/dist/services/native-operation.d.ts +34 -0
- package/dist/services/native-operation.d.ts.map +1 -0
- package/dist/services/native-operation.js +77 -0
- package/dist/services/native-operation.js.map +1 -0
- package/dist/services/query-reader.d.ts +32 -7
- package/dist/services/query-reader.d.ts.map +1 -1
- package/dist/services/query-reader.js +22 -2
- package/dist/services/query-reader.js.map +1 -1
- package/dist/services/read-request-status.d.ts +65 -0
- package/dist/services/read-request-status.d.ts.map +1 -0
- package/dist/services/read-request-status.js +151 -0
- package/dist/services/read-request-status.js.map +1 -0
- package/dist/services/spine-services.d.ts +42 -7
- package/dist/services/spine-services.d.ts.map +1 -1
- package/dist/services/spine-services.js +1005 -175
- package/dist/services/spine-services.js.map +1 -1
- package/dist/services/trusted-reader-ingress.d.ts +110 -0
- package/dist/services/trusted-reader-ingress.d.ts.map +1 -0
- package/dist/services/trusted-reader-ingress.js +102 -0
- package/dist/services/trusted-reader-ingress.js.map +1 -0
- package/dist/spi/handler-registry.d.ts +2 -0
- package/dist/spi/handler-registry.d.ts.map +1 -1
- package/dist/spi/handler-registry.js +1 -1
- package/dist/spi/handler-registry.js.map +1 -1
- package/dist/stand/read-side-filter-engine.d.ts +46 -0
- package/dist/stand/read-side-filter-engine.d.ts.map +1 -0
- package/dist/stand/read-side-filter-engine.js +356 -0
- package/dist/stand/read-side-filter-engine.js.map +1 -0
- package/dist/stand/read-side-filter.d.ts +247 -0
- package/dist/stand/read-side-filter.d.ts.map +1 -0
- package/dist/stand/read-side-filter.js +39 -0
- package/dist/stand/read-side-filter.js.map +1 -0
- package/dist/stand/read-side-message.d.ts +66 -0
- package/dist/stand/read-side-message.d.ts.map +1 -0
- package/dist/stand/read-side-message.js +167 -0
- package/dist/stand/read-side-message.js.map +1 -0
- package/dist/stand/stand-direct-delivery.d.ts +161 -0
- package/dist/stand/stand-direct-delivery.d.ts.map +1 -0
- package/dist/stand/stand-direct-delivery.js +210 -0
- package/dist/stand/stand-direct-delivery.js.map +1 -0
- package/dist/stand/stand.d.ts +81 -43
- package/dist/stand/stand.d.ts.map +1 -1
- package/dist/stand/stand.js +411 -55
- package/dist/stand/stand.js.map +1 -1
- package/dist/stand/subscription-observer.d.ts.map +1 -1
- package/dist/stand/subscription-observer.js +103 -0
- package/dist/stand/subscription-observer.js.map +1 -1
- package/dist/stand/subscription-read-filters.d.ts +40 -0
- package/dist/stand/subscription-read-filters.d.ts.map +1 -0
- package/dist/stand/subscription-read-filters.js +91 -0
- package/dist/stand/subscription-read-filters.js.map +1 -0
- package/dist/stand/subscription-reader-binding.d.ts +20 -0
- package/dist/stand/subscription-reader-binding.d.ts.map +1 -0
- package/dist/stand/subscription-reader-binding.js +56 -0
- package/dist/stand/subscription-reader-binding.js.map +1 -0
- package/dist/stand/subscription-records.d.ts +30 -3
- package/dist/stand/subscription-records.d.ts.map +1 -1
- package/dist/stand/subscription-records.js +61 -16
- package/dist/stand/subscription-records.js.map +1 -1
- package/dist/stand/subscription-registry.d.ts +49 -14
- package/dist/stand/subscription-registry.d.ts.map +1 -1
- package/dist/stand/subscription-registry.js +150 -31
- package/dist/stand/subscription-registry.js.map +1 -1
- package/dist/stand/subscription-runtime.d.ts +7 -2
- package/dist/stand/subscription-runtime.d.ts.map +1 -1
- package/dist/stand/subscription-runtime.js +131 -25
- package/dist/stand/subscription-runtime.js.map +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- 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;
|
|
1
|
+
{"version":3,"file":"browser-server.d.ts","sourceRoot":"","sources":["../../src/browser/browser-server.ts"],"names":[],"mappings":"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"}
|