@ecopages/core 0.2.0-beta.9 → 0.2.0-rc.0

package/src/adapters/bun/server-adapter.d.ts

@@ -2,9 +2,9 @@ import type { Server as NodeHttpServer } from 'node:http';
 import type { Server, WebSocketHandler } from 'bun';
 import type { EcoPagesAppConfig } from '../../types/internal-types.js';
 import type { ApiHandler, ErrorHandler, StaticRoute, EcopagesWebSocketHandler } from '../../types/public-types.js';
-import { SharedServerAdapter } from '../shared/server-adapter.js';
+import { SharedServerAdapter } from '../shared/runtime/server-adapter.js';
 import type { ServerAdapterResult } from '../abstract/server-adapter.js';
-import type { StaticPreviewHost } from '../shared/static-preview-host.js';
+import type { StaticPreviewHost } from '../shared/runtime/static-preview-host.js';
 import { ClientBridge } from './client-bridge.js';
 import { HmrManager } from './hmr-manager.js';
 type BunServerInstance = Server<unknown>;
@@ -37,6 +37,9 @@ export interface BunServerAdapterParams {
     options?: {
         watch?: boolean;
     };
+    hostOwnsDevClient?: boolean;
+    deferRuntimeAssetSetup?: boolean;
+    allowPortFallback?: boolean;
     hmrManager?: HmrManager;
     bridge?: ClientBridge;
     previewHost?: StaticPreviewHost;
@@ -48,7 +51,8 @@ export interface BunServerAdapterResult extends ServerAdapterResult {
     buildStatic: (options?: {
         preview?: boolean;
         force?: boolean;
-    }) => Promise<void>;
+    }) => Promise<string | undefined>;
+    servePreviewOnly: () => Promise<string | undefined>;
     completeInitialization: (server?: BunServerInstance | null) => Promise<void>;
     handleRequest: (request: Request) => Promise<Response>;
     attachUserWebSocketUpgrades: (server: NodeHttpServer, options?: {
@@ -80,6 +84,8 @@ export declare class BunServerAdapter extends SharedServerAdapter<BunServerAdapt
     serverInstance: BunServerInstance | null;
     private projectWatcher;
     private adapterDisposed;
+    private readonly deferRuntimeAssetSetup;
+    private readonly allowPortFallback;
     private readonly previewHost;
     /**
      * Reference to the application-level WebSocket handlers map.
@@ -90,20 +96,7 @@ export declare class BunServerAdapter extends SharedServerAdapter<BunServerAdapt
      * WebSocket upgrades for user-registered patterns.
      */
     protected websocketHandlers: Map<string, EcopagesWebSocketHandler<any, any>>;
-    /**
-     * Adapts a Bun ServerWebSocket to the public EcopagesSocket interface.
-     *
-     * @remarks
-     * This is the single source of truth for the Bun→public type adaptation.
-     * Both the HMR and production branches use this helper to ensure consistency.
-     *
-     * @param ws - The raw Bun ServerWebSocket
-     * @param kind - The registered route pattern
-     * @param params - Dynamic path parameters
-     * @param search - Query string parameters
-     * @param context - The resolved per-connection context
-     * @returns An EcopagesSocket view
-     */
+    private registerBunRuntimePlugin;
     private adaptBunWebSocket;
     /**
      * Resolves the per-connection context for a Bun user connection.
@@ -131,7 +124,7 @@ export declare class BunServerAdapter extends SharedServerAdapter<BunServerAdapt
      * is constructed, those collaborators are mandatory because the adapter cannot
      * initialize Bun HMR or preview flows without them.
      */
-    constructor({ appConfig, runtimeOrigin, serveOptions, apiHandlers, staticRoutes, errorHandler, websocketHandlers, options, hmrManager, bridge, previewHost, }: BunServerAdapterParams & {
+    constructor({ appConfig, runtimeOrigin, serveOptions, apiHandlers, staticRoutes, errorHandler, websocketHandlers, options, hostOwnsDevClient, deferRuntimeAssetSetup, allowPortFallback, hmrManager, bridge, previewHost, }: BunServerAdapterParams & {
         hmrManager: HmrManager;
         bridge: ClientBridge;
         previewHost: StaticPreviewHost;
@@ -142,34 +135,10 @@ export declare class BunServerAdapter extends SharedServerAdapter<BunServerAdapt
     attachUserWebSocketUpgrades(server: NodeHttpServer, options?: {
         passthroughUnmatched?: boolean;
     }): void;
-    /**
-     * Returns whether adapter-level HTML responses still need HMR runtime injection.
-     *
-     * @remarks
-     * Filesystem-routed pages are wrapped later in the shared route layer. This
-     * adapter-level check exists for explicit API handlers that return HTML and
-     * would otherwise bypass the route wrapper entirely.
-     */
-    private shouldInjectHmrScript;
-    /**
-     * Delegates the HTML-response test to the shared response helper used by both
-     * adapters.
-     */
-    private isHtmlResponse;
-    /**
-     * Injects HMR script into HTML responses in development mode.
-     * Ensures explicit API handlers that return HTML get auto-reload capability.
-     */
-    private maybeInjectHmrScript;
     /**
      * Initializes the server adapter's core runtime components.
      */
     initialize(): Promise<void>;
-    /**
-     * Copies the source `public` directory into the runtime output and ensures the
-     * HMR assets directory exists before any runtime bundles are emitted.
-     */
-    private prepareRuntimePublicDir;
     /**
      * Registers runtime plugins and propagates the final HMR manager into each
      * integration.
@@ -201,13 +170,21 @@ export declare class BunServerAdapter extends SharedServerAdapter<BunServerAdapt
     getServerOptions({ enableHmr }?: {
         enableHmr?: boolean | undefined;
     }): BunServeOptions;
+    private createBunUserLifecycle;
     /**
-     * Helper method to retrieve and parse the request body.
-     * Handles JSON and plain text content types.
-     * For FormData (multipart/form-data, x-www-form-urlencoded), use ctx.request.formData() directly.
-     * Returns undefined for unsupported content types.
+     * @remarks
+     * HMR and user sockets share one Bun `websocket` handler. Upgrade tags HMR
+     * connections with `kind: '__hmr__'`; everything else routes to the user lifecycle.
+     */
+    private createHmrAwareWebSocketHandler;
+    /**
+     * @remarks
+     * When `serveHmrEndpoints` is set, `/_hmr` is checked before user websocket
+     * patterns so HMR upgrades are never captured by app routes. Runtime assets are
+     * served by `SharedServerAdapter.handleSharedRequest` via `tryHandleAssetRequest`.
+     * Production mode with only user handlers skips the HMR branch entirely.
      */
-    private retrieveBodyFromRequest;
+    private wrapFetchWithWebSocketUpgrades;
     /**
      * Composes the base Bun server settings that all runtime modes build from.
      *
@@ -224,7 +201,13 @@ export declare class BunServerAdapter extends SharedServerAdapter<BunServerAdapt
     buildStatic(options?: {
         preview?: boolean;
         force?: boolean;
-    }): Promise<void>;
+    }): Promise<string | undefined>;
+    /**
+     * Serves an existing static export without running SSG. Used by e2e preview
+     * launchers after a shared prewarm build.
+     */
+    servePreviewOnly(): Promise<string | undefined>;
+    private startPreviewServer;
     /**
      * Initializes the server with dynamic routes after server creation.
      * Must be called before handling any requests.
@@ -257,11 +240,9 @@ export declare class BunServerAdapter extends SharedServerAdapter<BunServerAdapt
      * Handles HTTP requests by passing them securely to the shared core router adapter.
      *
      * @remarks
-     * Filesystem page responses are wrapped by `ServerRouteHandler`. This
-     * adapter-level pass only covers HTML returned by explicit API handlers,
-     * which bypass that route-layer wrapper and would otherwise miss the
-     * dev HMR runtime — so the HMR script injection happens here, after
-     * the shared handler runs.
+     * HMR HTML injection for API and page responses is owned by
+     * `SharedServerAdapter.handleSharedRequest`. This method only maps the
+     * request into the shared pipeline.
      */
     handleRequest(request: Request): Promise<Response>;
     /**