@spine-event-engine/server 2.0.0-snapshot.11

package/dist/browser/browser-server.d.ts

@@ -0,0 +1,95 @@
+import * as http from "node:http";
+import type { AddressInfo } from "node:net";
+import { TransportFacts } from "@spine-event-engine/auth";
+import { Http2SessionManager } from "@connectrpc/connect-node";
+import { ApplicationNode } from "@spine-event-engine/deployment";
+import type { RunningServer } from "../server/server.js";
+import { Server } from "../server/server.js";
+import type { BrowserAuthRoute, BrowserServerOptions, StandaloneBrowserServerOptions } from "./options.js";
+/**
+ * Holds fully normalized options while a browser listener is being assembled.
+ *
+ * @internal
+ */
+type BrowserHostOptions = BrowserServerOptions & {
+    readonly host: string;
+    readonly port: number;
+    readonly readMaxBytes: number;
+    readonly writeMaxBytes: number;
+    readonly production: boolean;
+    readonly dynamicManagerFactory?: (node: ApplicationNode) => Http2SessionManager;
+};
+/**
+ * Accepts options used only through the browser-server white-box seam.
+ *
+ * @internal
+ */
+type BrowserServerTestOptions = BrowserServerOptions & Partial<BrowserHostOptions>;
+/**
+ * Runs the private native endpoint behind one admitted browser listener.
+ *
+ * Hosts browser-facing Spine gateway routes independently from native server assembly.
+ */
+export declare const browserServerImplementation: Readonly<{
+    open(native: RunningServer, options: BrowserServerOptions): Promise<RunningServer>;
+    open(native: string | readonly string[] | undefined, options: StandaloneBrowserServerOptions): Promise<RunningServer>;
+    run(options: StandaloneBrowserServerOptions): Promise<RunningServer>;
+    run(native: Server, options: BrowserServerOptions): Promise<RunningServer>;
+    requests(options: BrowserServerOptions): {
+        credential(context: {
+            readonly requestHeader: Headers;
+        }): {
+            readonly kind: "bearer" | "cookie";
+            readonly value: string;
+        } | undefined;
+        transport(context: {
+            readonly requestHeader: Headers;
+        }): ReturnType<typeof TransportFacts.from>;
+    };
+    origins(origins: readonly string[]): ReadonlySet<string>;
+    backendUrl(value: string): string;
+    backendUrls(values: readonly string[]): readonly string[];
+    dynamicTransportOptions(node: ApplicationNode): {
+        readonly baseUrl: string;
+        readonly nodeOptions?: {
+            readonly servername: string;
+        };
+    };
+    requireDurableBindings(options: BrowserServerOptions, production: boolean): void;
+    authRoutes(routes: readonly BrowserAuthRoute[] | undefined): ReadonlyMap<string, BrowserAuthRoute>;
+    dispatchAuth(request: http.IncomingMessage, response: http.ServerResponse, route: BrowserAuthRoute, active: Set<AbortController>, writeMaxBytes: number): Promise<void>;
+    listen(server: http.Server, host: string, port: number): Promise<AddressInfo>;
+    closeListener(server: http.Server): Promise<void>;
+    preflight(mode: "combined" | "standalone", options: BrowserServerOptions): BrowserHostOptions;
+}>;
+/**
+ * Exposes white-box browser-host operations to source-level behavior tests.
+ *
+ * @internal
+ */
+type BrowserServerTestAccess = Omit<typeof browserServerImplementation, "open" | "run" | "requests" | "requireDurableBindings" | "preflight"> & {
+    open(native: RunningServer | string | readonly string[] | undefined, options: BrowserServerTestOptions): Promise<RunningServer>;
+    run(options: BrowserServerTestOptions): Promise<RunningServer>;
+    run(native: Server, options: BrowserServerTestOptions): Promise<RunningServer>;
+    requests(options: BrowserServerTestOptions): {
+        credential(context: {
+            readonly requestHeader: Headers;
+        }): {
+            readonly kind: "bearer" | "cookie";
+            readonly value: string;
+        } | undefined;
+        transport(context: {
+            readonly requestHeader: Headers;
+        }): ReturnType<typeof TransportFacts.from>;
+    };
+    requireDurableBindings(options: BrowserServerTestOptions, production: boolean): void;
+    preflight(mode: "combined" | "standalone", options: BrowserServerTestOptions): BrowserHostOptions;
+};
+/**
+ * Provides the internal white-box browser-host seam for source-level behavior tests.
+ *
+ * @internal
+ */
+export declare const browserServerTestAccess: BrowserServerTestAccess;
+export {};
+//# sourceMappingURL=browser-server.d.ts.map

package/dist/browser/browser-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-server.d.ts","sourceRoot":"","sources":["../../src/browser/browser-server.ts"],"names":[],"mappings":"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"}