@teamscala/service-boot 0.23.284 → 0.23.285

package/src/ui-service.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @system ui-service-boot
+ * @status handwritten
+ * @edit edit directly
+ *
+ * Boots a `kind: "ui"` service. Reads the service_install registry row and
+ * orchestrates a fixed pipeline of single-purpose stages onto one Hono app
+ * served by @teamscala/service-runtime/serve (one Bun.serve in dev and prod).
+ */
+import { Hono } from "hono";
+import type { ServiceInstallConfig } from "./load-service-install-row.ts";
+export interface ResolvedBlock {
+    slug: string;
+    packagePath: string;
+}
+export interface UiServiceBootResult {
+    kind: "ui";
+    blocks: ResolvedBlock[];
+    routes: string[];
+    port: number;
+    app: Hono;
+}
+/**
+ * Page-server symbols injected by the caller. service-boot is tier 4
+ * (server) and must not import from tier 2 (`@teamscala/service-runtime`)
+ * per `installer-and-runtime` Rule 1. The runtime's bin entrypoint
+ * boot pipeline imports these from `page-server/` (same package —
+ * legal) and passes them down here.
+ */
+export interface PageServerDeps {
+    createPageHandler: import("./types.ts").CreatePageHandler;
+}
+/**
+ * Boots a UI service using two-phase boot for fast availability.
+ *
+ * Phase 1 (fast): Build and serve minimal tool-only app (ORPC, data routes,
+ * auth gates). This becomes available within ~10s, enabling the MCP tool
+ * surface to accept requests immediately after restart.
+ *
+ * Phase 2 (background): Build full app (pages, hydration) and atomically swap
+ * it in. The readiness gate flips to ready after Phase 1, not Phase 2.
+ *
+ * The interim mitigation (503 + gateway retry + circuit breaker) remains in
+ * place and is NOT undone.
+ */
+export declare function bootUiService(config: ServiceInstallConfig, serviceSlug: string, deps: PageServerDeps, databaseUrl: string): Promise<UiServiceBootResult>;

package/src/ws-boot-self-test.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @system server-boot
+ * @status handwritten
+ * @edit edit directly
+ *
+ * Post-listen WebSocket self-test. Runs after serveStart binds the port.
+ * For each declared websocket_routes path, opens a synthetic WebSocket
+ * connection and asserts 101 upgrade. Non-101 → BootFatalError.
+ *
+ * This catches the class of bugs where:
+ * - WS route registered after ORPC catch-all (order-dependent 404)
+ * - fetchWithPeerPort clones the Request on WS upgrade (breaks Bun.upgrade identity)
+ * - websocket_routes config row is stale / missing a handler
+ *
+ * Runs synchronously after serveStart so the boot aborts before the service
+ * reports healthy.
+ */
+import type { ServiceInstallConfig } from "@teamscala/db/registry/loader/load-service-install-row";
+export declare function runWsBootSelfTest(config: ServiceInstallConfig, serviceSlug: string, port: number): Promise<void>;