@ecopages/core 0.2.0-beta.1 → 0.2.0-beta.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecopages/core",
-  "version": "0.2.0-beta.1",
+  "version": "0.2.0-beta.10",
   "description": "Core package for Ecopages",
   "keywords": [
     "ecopages",
@@ -13,11 +13,11 @@
   "sideEffects": false,
   "repository": {
     "type": "git",
-    "url": "https://github.com/ecopages/ecopages.git",
+    "url": "git+https://github.com/ecopages/ecopages.git",
     "directory": "packages/core"
   },
   "dependencies": {
-    "@ecopages/file-system": "0.2.0-beta.1",
+    "@ecopages/file-system": "0.2.0-beta.10",
     "@ecopages/logger": "^0.2.3",
     "@ecopages/scripts-injector": "^0.1.5",
     "@oxc-project/runtime": "0.134.0",
@@ -45,11 +45,23 @@
       "types": "./src/route-renderer/orchestration/integration-renderer.d.ts",
       "default": "./src/route-renderer/orchestration/integration-renderer.js"
     },
+    "./route-renderer/string-markup-renderer": {
+      "types": "./src/route-renderer/orchestration/string-markup-renderer.d.ts",
+      "default": "./src/route-renderer/orchestration/string-markup-renderer.js"
+    },
+    "./route-renderer/route-renderer": {
+      "types": "./src/route-renderer/route-renderer.d.ts",
+      "default": "./src/route-renderer/route-renderer.js"
+    },
     "./route-renderer/component-render-context": {
       "import": "./src/route-renderer/orchestration/component-render-context.js",
       "types": "./src/route-renderer/orchestration/component-render-context.d.ts",
       "default": "./src/route-renderer/orchestration/component-render-context.js"
     },
+    "./route-renderer/orchestration/foreign-subtree-execution.service": {
+      "types": "./src/route-renderer/orchestration/foreign-subtree-execution.service.d.ts",
+      "default": "./src/route-renderer/orchestration/foreign-subtree-execution.service.js"
+    },
     "./router/navigation-coordinator": {
       "types": "./src/router/client/navigation-coordinator.d.ts",
       "default": "./src/router/client/navigation-coordinator.js"
@@ -93,6 +105,14 @@
       "types": "./src/dev/host-runtime.d.ts",
       "default": "./src/dev/host-runtime.js"
     },
+    "./dev/client-bridge-registry": {
+      "types": "./src/dev/client-bridge-registry.d.ts",
+      "default": "./src/dev/client-bridge-registry.js"
+    },
+    "./dev/dev-client-ownership": {
+      "types": "./src/dev/dev-client-ownership.d.ts",
+      "default": "./src/dev/dev-client-ownership.js"
+    },
     "./services/asset-processing-service": {
       "types": "./src/services/assets/asset-processing-service/index.d.ts",
       "default": "./src/services/assets/asset-processing-service/index.js"
@@ -105,6 +125,10 @@
       "types": "./src/plugins/integration-plugin.d.ts",
       "default": "./src/plugins/integration-plugin.js"
     },
+    "./plugins/define-integration": {
+      "types": "./src/plugins/define-integration.d.ts",
+      "default": "./src/plugins/define-integration.js"
+    },
     "./plugins/source-transform": {
       "types": "./src/plugins/source-transform.d.ts",
       "default": "./src/plugins/source-transform.js"
@@ -117,6 +141,26 @@
       "types": "./src/build/build-adapter.d.ts",
       "default": "./src/build/build-adapter.js"
     },
+    "./build/runtime-build-executor": {
+      "types": "./src/build/runtime-build-executor.d.ts",
+      "default": "./src/build/runtime-build-executor.js"
+    },
+    "./build/build-runtime": {
+      "types": "./src/build/build-runtime.d.ts",
+      "default": "./src/build/build-runtime.js"
+    },
+    "./build/build-contracts": {
+      "types": "./src/build/build-contracts.d.ts",
+      "default": "./src/build/build-contracts.js"
+    },
+    "./build/production-build-cache": {
+      "types": "./src/build/production-build-cache.d.ts",
+      "default": "./src/build/production-build-cache.js"
+    },
+    "./build/server-entry-build-cache": {
+      "types": "./src/build/server-entry-build-cache.d.ts",
+      "default": "./src/build/server-entry-build-cache.js"
+    },
     "./build/runtime-build-output-normalizer": {
       "types": "./src/build/runtime-build-output-normalizer.d.ts",
       "default": "./src/build/runtime-build-output-normalizer.js"
@@ -129,6 +173,10 @@
       "types": "./src/build/browser-runtime-plugin.d.ts",
       "default": "./src/build/browser-runtime-plugin.js"
     },
+    "./build/jsx-ownership-plugins": {
+      "types": "./src/build/jsx-ownership-plugins.d.ts",
+      "default": "./src/build/jsx-ownership-plugins.js"
+    },
     "./cache": {
       "types": "./src/cache/index.d.ts",
       "default": "./src/cache/index.js"
@@ -137,6 +185,10 @@
       "types": "./src/plugins/foreign-jsx-override-plugin.d.ts",
       "default": "./src/plugins/foreign-jsx-override-plugin.js"
     },
+    "./plugins/jsx-import-source.utils": {
+      "types": "./src/plugins/jsx-import-source.utils.d.ts",
+      "default": "./src/plugins/jsx-import-source.utils.js"
+    },
     "./html": {
       "import": "./src/utils/html.js",
       "default": "./src/utils/html.js",
@@ -174,11 +226,23 @@
       "types": "./src/route-renderer/orchestration/integration-renderer.d.ts",
       "default": "./src/route-renderer/orchestration/integration-renderer.js"
     },
+    "./route-renderer/string-markup-renderer.ts": {
+      "types": "./src/route-renderer/orchestration/string-markup-renderer.d.ts",
+      "default": "./src/route-renderer/orchestration/string-markup-renderer.js"
+    },
+    "./route-renderer/route-renderer.ts": {
+      "types": "./src/route-renderer/route-renderer.d.ts",
+      "default": "./src/route-renderer/route-renderer.js"
+    },
     "./route-renderer/component-render-context.ts": {
       "import": "./src/route-renderer/orchestration/component-render-context.js",
       "types": "./src/route-renderer/orchestration/component-render-context.d.ts",
       "default": "./src/route-renderer/orchestration/component-render-context.js"
     },
+    "./route-renderer/orchestration/foreign-subtree-execution.service.ts": {
+      "types": "./src/route-renderer/orchestration/foreign-subtree-execution.service.d.ts",
+      "default": "./src/route-renderer/orchestration/foreign-subtree-execution.service.js"
+    },
     "./router/navigation-coordinator.ts": {
       "types": "./src/router/client/navigation-coordinator.d.ts",
       "default": "./src/router/client/navigation-coordinator.js"
@@ -222,6 +286,14 @@
       "types": "./src/dev/host-runtime.d.ts",
       "default": "./src/dev/host-runtime.js"
     },
+    "./dev/client-bridge-registry.ts": {
+      "types": "./src/dev/client-bridge-registry.d.ts",
+      "default": "./src/dev/client-bridge-registry.js"
+    },
+    "./dev/dev-client-ownership.ts": {
+      "types": "./src/dev/dev-client-ownership.d.ts",
+      "default": "./src/dev/dev-client-ownership.js"
+    },
     "./services/asset-processing-service.ts": {
       "types": "./src/services/assets/asset-processing-service/index.d.ts",
       "default": "./src/services/assets/asset-processing-service/index.js"
@@ -234,6 +306,10 @@
       "types": "./src/plugins/integration-plugin.d.ts",
       "default": "./src/plugins/integration-plugin.js"
     },
+    "./plugins/define-integration.ts": {
+      "types": "./src/plugins/define-integration.d.ts",
+      "default": "./src/plugins/define-integration.js"
+    },
     "./plugins/source-transform.ts": {
       "types": "./src/plugins/source-transform.d.ts",
       "default": "./src/plugins/source-transform.js"
@@ -246,6 +322,26 @@
       "types": "./src/build/build-adapter.d.ts",
       "default": "./src/build/build-adapter.js"
     },
+    "./build/runtime-build-executor.ts": {
+      "types": "./src/build/runtime-build-executor.d.ts",
+      "default": "./src/build/runtime-build-executor.js"
+    },
+    "./build/build-runtime.ts": {
+      "types": "./src/build/build-runtime.d.ts",
+      "default": "./src/build/build-runtime.js"
+    },
+    "./build/build-contracts.ts": {
+      "types": "./src/build/build-contracts.d.ts",
+      "default": "./src/build/build-contracts.js"
+    },
+    "./build/production-build-cache.ts": {
+      "types": "./src/build/production-build-cache.d.ts",
+      "default": "./src/build/production-build-cache.js"
+    },
+    "./build/server-entry-build-cache.ts": {
+      "types": "./src/build/server-entry-build-cache.d.ts",
+      "default": "./src/build/server-entry-build-cache.js"
+    },
     "./build/runtime-build-output-normalizer.ts": {
       "types": "./src/build/runtime-build-output-normalizer.d.ts",
       "default": "./src/build/runtime-build-output-normalizer.js"
@@ -258,6 +354,10 @@
       "types": "./src/build/browser-runtime-plugin.d.ts",
       "default": "./src/build/browser-runtime-plugin.js"
     },
+    "./build/jsx-ownership-plugins.ts": {
+      "types": "./src/build/jsx-ownership-plugins.d.ts",
+      "default": "./src/build/jsx-ownership-plugins.js"
+    },
     "./cache.ts": {
       "types": "./src/cache/index.d.ts",
       "default": "./src/cache/index.js"
@@ -266,6 +366,10 @@
       "types": "./src/plugins/foreign-jsx-override-plugin.d.ts",
       "default": "./src/plugins/foreign-jsx-override-plugin.js"
     },
+    "./plugins/jsx-import-source.utils.ts": {
+      "types": "./src/plugins/jsx-import-source.utils.d.ts",
+      "default": "./src/plugins/jsx-import-source.utils.js"
+    },
     "./html.ts": {
       "import": "./src/utils/html.js",
       "default": "./src/utils/html.js",

package/src/adapters/abstract/application-adapter.d.ts

@@ -9,6 +9,7 @@
 import type { SourceModuleLoader } from '../../services/module-loading/module-loading-types.js';
 import type { EcoPagesAppConfig } from '../../types/internal-types.js';
 import type { ApiHandler, ApiHandlerContext, ErrorHandler, Middleware, RouteOptions, StaticRoute, ViewLoader } from '../../types/public-types.js';
+import type { EcopagesWebSocketHandler } from '../../types/public-types.js';
 import { type ReturnParseCliArgs } from '../../utils/parse-cli-args.js';
 /**
  * Runtime bootstrap options layered on top of the app config.
@@ -25,6 +26,21 @@ export interface ApplicationRuntimeOptions {
      * adapter auto-detects a host module loader from the global scope.
      */
     embedded?: boolean;
+    /**
+     * When true, full-page reload signaling is owned by the host dev server
+     * (for example Vite's `full-reload` websocket event) instead of the Ecopages
+     * client bridge.
+     *
+     * @deprecated Prefer `devClientOwner: 'host'`.
+     */
+    delegateBrowserReloadToHost?: boolean;
+    /**
+     * Selects which layer injects browser dev-client bootstrap (HMR runtime, reload).
+     *
+     * `host` disables core injection and reload signaling so embedded hosts like
+     * Vite own the full dev-client surface.
+     */
+    devClientOwner?: 'core' | 'host';
     /**
      * Explicit source module loader for request-time imports.
      *
@@ -49,8 +65,9 @@ export interface ApplicationAdapterOptions {
 /**
  * Common interface for application adapters
  */
-export interface ApplicationAdapter<T = any> {
+export interface ApplicationAdapter<T = any> extends AsyncDisposable {
     start(): Promise<T | void>;
+    stop(force?: boolean): Promise<void>;
 }
 /**
  * Handler function type for route handlers
@@ -72,6 +89,11 @@ export declare abstract class AbstractApplicationAdapter<TOptions extends Applic
     protected apiHandlers: ApiHandler[];
     protected staticRoutes: StaticRoute[];
     protected errorHandler?: ErrorHandler;
+    /**
+     * App-level WebSocket handlers keyed by URL path pattern (e.g. '/ws/chat/:id').
+     * Both Bun and Node adapters read this map to register upgrade routes.
+     */
+    protected websocketHandlers: Map<string, EcopagesWebSocketHandler<any, any>>;
     constructor(options: TOptions);
     private clearDistFolder;
     /**
@@ -160,6 +182,46 @@ export declare abstract class AbstractApplicationAdapter<TOptions extends Applic
      * Get all registered static routes
      */
     getStaticRoutes(): StaticRoute[];
+    /**
+     * Register a WebSocket handler for the given path pattern.
+     *
+     * The runtime adapter handles the HTTP→WebSocket upgrade for this path
+     * and routes lifecycle events to `handler`.
+     *
+     * Supports dynamic segments via `:param` syntax. The handler receives
+     * typed `params` and `search` fields, and a typed `context` produced by
+     * the optional `context()` factory.
+     *
+     * One pattern registration matches infinite path variations. For example,
+     * `app.websocket('/ws/chat/:roomId', handler)` matches `/ws/chat/abc`,
+     * `/ws/chat/xyz`, etc. Each connection receives its own `params.roomId`.
+     *
+     * Works across both Bun and Node runtimes — no runtime-specific imports needed.
+     *
+     * @example
+     * ```typescript
+     * app.websocket<ChatContext, { roomId: string }>('/ws/chat/:roomId', {
+     *   async context({ params, search }) {
+     *     return { username: search.username ?? 'anonymous', roomId: params.roomId };
+     *   },
+     *   onConnect(socket) {
+     *     socket.send(`Welcome to room ${socket.context.roomId}`);
+     *   },
+     *   onMessage(socket, message) {
+     *     if (message.kind === 'text') {
+     *       socket.send(message.text);
+     *     }
+     *   },
+     * });
+     * ```
+     */
+    websocket<TContext = unknown, TParams extends Record<string, string> = Record<string, string>>(path: string, handler: EcopagesWebSocketHandler<TContext, TParams>): this;
+    /**
+     * Get the registered WebSocket handlers map.
+     *
+     * @returns The map of WebSocket route patterns to handlers
+     */
+    getWebsocketHandlers(): Map<string, EcopagesWebSocketHandler<any, any>>;
     /**
      * Register a global error handler for all routes.
      * Useful for logging, monitoring integration, and custom error formatting.
@@ -185,6 +247,16 @@ export declare abstract class AbstractApplicationAdapter<TOptions extends Applic
      * Start the application server
      */
     abstract start(): Promise<TServer | void>;
+    /**
+     * Stops the application server and releases runtime resources.
+     *
+     * @remarks
+     * Subclasses override this to shut down bound servers, watchers, and other
+     * dev-time resources. The default implementation is a no-op so embedded
+     * adapters that never call `start()` can still be used with `await using`.
+     */
+    stop(_force?: boolean): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
     /**
      * Handles a standard Web request without requiring a bound network server.
      * This is the primary interoperability surface for embedding Ecopages inside

package/src/adapters/abstract/application-adapter.js

@@ -15,10 +15,21 @@ class AbstractApplicationAdapter {
   apiHandlers = [];
   staticRoutes = [];
   errorHandler;
+  /**
+   * App-level WebSocket handlers keyed by URL path pattern (e.g. '/ws/chat/:id').
+   * Both Bun and Node adapters read this map to register upgrade routes.
+   */
+  websocketHandlers = /* @__PURE__ */ new Map();
   constructor(options) {
     this.appConfig = options.appConfig;
     this.serverOptions = options.serverOptions || {};
     this.runtimeOptions = options.runtime ?? {};
+    if (options.runtime) {
+      this.appConfig.runtime = {
+        ...this.appConfig.runtime ?? {},
+        ...options.runtime
+      };
+    }
     this.cliArgs = parseCliArgs({ embeddedRuntime: this.runtimeOptions.embedded });
     const hostModuleLoader = this.runtimeOptions.hostModuleLoader ?? (this.runtimeOptions.embedded ? getHostModuleLoader() : void 0);
     if (hostModuleLoader) {
@@ -93,6 +104,71 @@ class AbstractApplicationAdapter {
   getStaticRoutes() {
     return this.staticRoutes;
   }
+  /**
+   * Register a WebSocket handler for the given path pattern.
+   *
+   * The runtime adapter handles the HTTP→WebSocket upgrade for this path
+   * and routes lifecycle events to `handler`.
+   *
+   * Supports dynamic segments via `:param` syntax. The handler receives
+   * typed `params` and `search` fields, and a typed `context` produced by
+   * the optional `context()` factory.
+   *
+   * One pattern registration matches infinite path variations. For example,
+   * `app.websocket('/ws/chat/:roomId', handler)` matches `/ws/chat/abc`,
+   * `/ws/chat/xyz`, etc. Each connection receives its own `params.roomId`.
+   *
+   * Works across both Bun and Node runtimes — no runtime-specific imports needed.
+   *
+   * @example
+   * ```typescript
+   * app.websocket<ChatContext, { roomId: string }>('/ws/chat/:roomId', {
+   *   async context({ params, search }) {
+   *     return { username: search.username ?? 'anonymous', roomId: params.roomId };
+   *   },
+   *   onConnect(socket) {
+   *     socket.send(`Welcome to room ${socket.context.roomId}`);
+   *   },
+   *   onMessage(socket, message) {
+   *     if (message.kind === 'text') {
+   *       socket.send(message.text);
+   *     }
+   *   },
+   * });
+   * ```
+   */
+  websocket(path, handler) {
+    invariant(
+      typeof path === "string" && path.startsWith("/"),
+      `app.websocket(): path must be a string starting with "/", got "${path}".`
+    );
+    const segments = path.split("/").filter(Boolean);
+    const paramNames = /* @__PURE__ */ new Set();
+    for (const segment of segments) {
+      if (segment.startsWith(":")) {
+        const paramName = segment.slice(1);
+        invariant(
+          paramName.length > 0,
+          `app.websocket(): invalid pattern "${path}" \u2014 empty param name in segment ":${paramName}".`
+        );
+        invariant(
+          !paramNames.has(paramName),
+          `app.websocket(): invalid pattern "${path}" \u2014 duplicate param name ":${paramName}".`
+        );
+        paramNames.add(paramName);
+      }
+    }
+    this.websocketHandlers.set(path, handler);
+    return this;
+  }
+  /**
+   * Get the registered WebSocket handlers map.
+   *
+   * @returns The map of WebSocket route patterns to handlers
+   */
+  getWebsocketHandlers() {
+    return this.websocketHandlers;
+  }
   /**
    * Register a global error handler for all routes.
    * Useful for logging, monitoring integration, and custom error formatting.
@@ -115,6 +191,19 @@ class AbstractApplicationAdapter {
   getErrorHandler() {
     return this.errorHandler;
   }
+  /**
+   * Stops the application server and releases runtime resources.
+   *
+   * @remarks
+   * Subclasses override this to shut down bound servers, watchers, and other
+   * dev-time resources. The default implementation is a no-op so embedded
+   * adapters that never call `start()` can still be used with `await using`.
+   */
+  async stop(_force = true) {
+  }
+  async [Symbol.asyncDispose]() {
+    await this.stop(true);
+  }
 }
 export {
   AbstractApplicationAdapter

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

@@ -31,7 +31,9 @@ export interface ServerAdapterResult {
     }) => any;
     buildStatic: (options?: {
         preview?: boolean;
+        force?: boolean;
     }) => Promise<void>;
+    dispose(): Promise<void>;
 }
 /**
  * Abstract base class for server adapters across different runtimes
@@ -57,6 +59,7 @@ export declare abstract class AbstractServerAdapter<TOptions extends ServerAdapt
      */
     abstract buildStatic(options?: {
         preview?: boolean;
+        force?: boolean;
     }): Promise<void>;
     /**
      * Factory method to create a server adapter with runtime-specific functionality

package/src/adapters/abstract/ws-pattern-matcher.d.ts

@@ -0,0 +1,60 @@
+import type { EcopagesWebSocketHandler } from '../../types/public-types.js';
+/**
+ * Pattern matcher for WebSocket route paths.
+ *
+ * Supports dynamic segments via `:param` syntax. Matches are exact on literal
+ * segments and capture dynamic segments into a params object.
+ *
+ * @example
+ * ```ts
+ * matchWebSocketPath('/ws/chat/:id', '/ws/chat/abc123')
+ * // Returns: { id: 'abc123' }
+ *
+ * matchWebSocketPath('/ws/chat/:id', '/ws/chat/abc123/messages')
+ * // Returns: null (length mismatch)
+ *
+ * matchWebSocketPath('/ws/chat', '/ws/chat')
+ * // Returns: {} (no params)
+ * ```
+ *
+ * @remarks
+ * This is a minimal segment-based matcher. It does not support wildcards,
+ * optional segments, or catch-all patterns. Those are future concerns.
+ *
+ * @param pattern - The registered route pattern (e.g. '/ws/chat/:id')
+ * @param pathname - The actual request pathname (e.g. '/ws/chat/abc123')
+ * @returns A params object if the pattern matches, or null if it does not
+ */
+export declare function matchWebSocketPath(pattern: string, pathname: string): Record<string, string> | null;
+/**
+ * Represents a matched WebSocket route.
+ */
+export type WebSocketRouteMatch = {
+    handler: EcopagesWebSocketHandler<any, any>;
+    params: Record<string, string>;
+    kind: string;
+};
+/**
+ * Scores a pattern for specificity ordering.
+ *
+ * Higher scores win. Rules, in order:
+ * 1. More literal segments beats more dynamic segments.
+ * 2. Fewer dynamic segments beats more dynamic segments.
+ * 3. Longer route (more segments) beats shorter route.
+ *
+ * @param pattern - The registered route pattern
+ * @returns A numeric specificity score
+ */
+export declare function scoreWebSocketPattern(pattern: string): number;
+/**
+ * Find the registered WebSocket handler that best matches a pathname.
+ *
+ * Iterates through the provided handlers map, computes each pattern's
+ * specificity score, and returns the highest-scoring match. Ties resolve
+ * to the earliest-registered pattern.
+ *
+ * @param handlers - The map of registered WebSocket handlers
+ * @param pathname - The actual request pathname
+ * @returns The best match, or null if no pattern matches
+ */
+export declare function findWebSocketRoute(handlers: Map<string, EcopagesWebSocketHandler<any, any>>, pathname: string): WebSocketRouteMatch | null;

package/src/adapters/abstract/ws-pattern-matcher.js

@@ -0,0 +1,61 @@
+function matchWebSocketPath(pattern, pathname) {
+  const patternSegments = pattern.split("/").filter(Boolean);
+  const pathSegments = pathname.split("/").filter(Boolean);
+  if (patternSegments.length !== pathSegments.length) {
+    return null;
+  }
+  const params = {};
+  for (let i = 0; i < patternSegments.length; i++) {
+    const patternSegment = patternSegments[i];
+    const pathSegment = pathSegments[i];
+    if (!patternSegment || !pathSegment) {
+      return null;
+    }
+    if (patternSegment.startsWith(":")) {
+      const paramName = patternSegment.slice(1);
+      if (!paramName) {
+        return null;
+      }
+      params[paramName] = pathSegment;
+    } else if (patternSegment !== pathSegment) {
+      return null;
+    }
+  }
+  return params;
+}
+function scoreWebSocketPattern(pattern) {
+  const segments = pattern.split("/").filter(Boolean);
+  let literals = 0;
+  let dynamics = 0;
+  for (const segment of segments) {
+    if (segment.startsWith(":")) {
+      dynamics += 1;
+    } else {
+      literals += 1;
+    }
+  }
+  return literals * 100 - dynamics * 10 + segments.length;
+}
+function findWebSocketRoute(handlers, pathname) {
+  let best = null;
+  let index = 0;
+  for (const [pattern, handler] of handlers) {
+    const params = matchWebSocketPath(pattern, pathname);
+    if (params === null) {
+      index += 1;
+      continue;
+    }
+    const score = scoreWebSocketPattern(pattern);
+    const match = { handler, params, kind: pattern };
+    if (best === null || score > best.score || score === best.score && index < best.index) {
+      best = { score, match, index };
+    }
+    index += 1;
+  }
+  return best?.match ?? null;
+}
+export {
+  findWebSocketRoute,
+  matchWebSocketPath,
+  scoreWebSocketPattern
+};

package/src/adapters/bun/client-bridge.d.ts

@@ -30,5 +30,6 @@ export declare class ClientBridge implements IClientBridge {
      */
     error(message: string): void;
     get subscriberCount(): number;
+    destroy(): void;
 }
 export {};

package/src/adapters/bun/client-bridge.js

@@ -42,6 +42,9 @@ class ClientBridge {
   get subscriberCount() {
     return this.subscribers.size;
   }
+  destroy() {
+    this.subscribers.clear();
+  }
 }
 export {
   ClientBridge

package/src/adapters/bun/create-app.d.ts

@@ -11,7 +11,6 @@ import type { Server } from 'bun';
 import type { ApiHandlerContext, RouteGroupBuilder } from '../../types/public-types.js';
 import { SharedApplicationAdapter } from '../shared/application-adapter.js';
 import type { RuntimeHost } from '../shared/runtime-host.js';
-import type { StaticPreviewHost } from '../shared/static-preview-host.js';
 import type { EcopagesAppOptions } from '../create-app.js';
 import { type BunServerAdapterResult } from './server-adapter.js';
 /**
@@ -31,13 +30,15 @@ export type BunRouteGroupBuilder<WebSocketData = undefined, TContext extends Api
 export declare class BunEcopagesApp<WebSocketData = undefined> extends SharedApplicationAdapter<EcopagesAppOptions, Server<WebSocketData>, Request> {
     serverAdapter: BunServerAdapterResult | undefined;
     private server;
+    private stopped;
     private readonly runtimeHost;
-    private readonly previewHost;
     constructor(options: EcopagesAppOptions, dependencies: {
         runtimeHost: RuntimeHost<Server<WebSocketData>, Bun.Serve.Options<WebSocketData>>;
-        previewHost: StaticPreviewHost;
     });
     fetch(request: Request): Promise<Response>;
+    attachWebSocketUpgrades(httpServer: import('node:http').Server, options?: {
+        passthroughUnmatched?: boolean;
+    }): Promise<void>;
     /**
      * Complete the initialization of the server adapter by processing dynamic routes
      * @param server The Bun server instance
@@ -53,6 +54,7 @@ export declare class BunEcopagesApp<WebSocketData = undefined> extends SharedApp
      * @param options.autoCompleteInitialization Whether to automatically complete initialization with dynamic routes after server start (defaults to true)
      */
     start(): Promise<Server<WebSocketData> | void>;
+    stop(force?: boolean): Promise<void>;
 }
 /**
  * Factory function to create a Bun application