@ecopages/core 0.2.0-alpha.4 → 0.2.0-alpha.6

package/src/adapters/bun/hmr-manager.d.ts

@@ -1,85 +0,0 @@
-import type { WebSocketHandler } from 'bun';
-import type { DefaultHmrContext, EcoPagesAppConfig, IHmrManager } from '../../internal-types';
-import type { EcoBuildPlugin } from '../../build/build-types.js';
-import type { HmrStrategy } from '../../hmr/hmr-strategy';
-import type { ClientBridge } from './client-bridge';
-import type { ClientBridgeEvent } from '../../public-types';
-type BunSocketHandler = WebSocketHandler<unknown>;
-export interface HmrManagerParams {
-    appConfig: EcoPagesAppConfig;
-    bridge: ClientBridge;
-}
-export declare class HmrManager implements IHmrManager {
-    readonly appConfig: EcoPagesAppConfig;
-    private readonly bridge;
-    /** Keep track of watchers */
-    private watchers;
-    /** entrypoint -> output path */
-    private watchedFiles;
-    /** bare specifier -> runtime URL (e.g., 'react' -> '/assets/vendors/react.js') */
-    private specifierMap;
-    private distDir;
-    private plugins;
-    private enabled;
-    private strategies;
-    private wsHandler;
-    constructor({ appConfig, bridge }: HmrManagerParams);
-    /**
-     * Ensures the HMR output directory exists.
-     *
-     * This must not remove the directory because multiple app processes
-     * can share the same dist path during e2e runs.
-     */
-    private cleanDistDir;
-    /**
-     * Initializes core HMR strategies.
-     * Strategies are evaluated in priority order (highest first).
-     */
-    private initializeStrategies;
-    /**
-     * Registers a custom HMR strategy.
-     * Used by integrations to provide framework-specific HMR handling.
-     * @param strategy - The HMR strategy to register
-     */
-    registerStrategy(strategy: HmrStrategy): void;
-    setPlugins(plugins: EcoBuildPlugin[]): void;
-    setEnabled(enabled: boolean): void;
-    isEnabled(): boolean;
-    /**
-     * Registers a mapping from bare specifiers to vendor URLs.
-     * Used by integrations to provide their module resolution mappings.
-     * @param map - Object mapping bare specifiers to vendor URLs
-     */
-    registerSpecifierMap(map: Record<string, string>): void;
-    getWebSocketHandler(): BunSocketHandler;
-    /**
-     * Builds the client-side HMR runtime script.
-     */
-    buildRuntime(): Promise<void>;
-    getRuntimePath(): string;
-    broadcast(event: ClientBridgeEvent): void;
-    canHandleFileChange(filePath: string): boolean;
-    /**
-     * Handles file changes using registered HMR strategies.
-     * Strategies are evaluated in priority order until one matches.
-     * @param filePath - Absolute path to the changed file
-     */
-    handleFileChange(filePath: string): Promise<void>;
-    /**
-     * Registers a client entrypoint to be built and watched by Bun.
-     */
-    getOutputUrl(entrypointPath: string): string | undefined;
-    getWatchedFiles(): Map<string, string>;
-    getSpecifierMap(): Map<string, string>;
-    getDistDir(): string;
-    getPlugins(): EcoBuildPlugin[];
-    getDefaultContext(): DefaultHmrContext;
-    registerEntrypoint(entrypointPath: string): Promise<string>;
-    /**
-     * Encodes dynamic route segments (brackets) in file paths.
-     * Converts `[slug]` to `_slug_` to avoid filesystem/URL issues.
-     */
-    private encodeDynamicSegments;
-    stop(): void;
-}
-export {};

package/src/adapters/bun/hmr-manager.js

@@ -1,240 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { RESOLVED_ASSETS_DIR } from "../../constants";
-import { defaultBuildAdapter } from "../../build/build-adapter.js";
-import { fileSystem } from "@ecopages/file-system";
-import { HmrStrategyType } from "../../hmr/hmr-strategy";
-import { DefaultHmrStrategy } from "../../hmr/strategies/default-hmr-strategy";
-import { JsHmrStrategy } from "../../hmr/strategies/js-hmr-strategy";
-import { appLogger } from "../../global/app-logger";
-class HmrManager {
-  appConfig;
-  bridge;
-  /** Keep track of watchers */
-  watchers = /* @__PURE__ */ new Map();
-  /** entrypoint -> output path */
-  watchedFiles = /* @__PURE__ */ new Map();
-  /** bare specifier -> runtime URL (e.g., 'react' -> '/assets/vendors/react.js') */
-  specifierMap = /* @__PURE__ */ new Map();
-  distDir;
-  plugins = [];
-  enabled = true;
-  strategies = [];
-  wsHandler;
-  constructor({ appConfig, bridge }) {
-    this.appConfig = appConfig;
-    this.bridge = bridge;
-    this.distDir = path.join(this.appConfig.absolutePaths.distDir, RESOLVED_ASSETS_DIR, "_hmr");
-    this.cleanDistDir();
-    this.initializeStrategies();
-  }
-  /**
-   * Ensures the HMR output directory exists.
-   *
-   * This must not remove the directory because multiple app processes
-   * can share the same dist path during e2e runs.
-   */
-  cleanDistDir() {
-    fileSystem.ensureDir(this.distDir);
-  }
-  /**
-   * Initializes core HMR strategies.
-   * Strategies are evaluated in priority order (highest first).
-   */
-  initializeStrategies() {
-    const jsContext = {
-      getWatchedFiles: () => this.watchedFiles,
-      getSpecifierMap: () => this.specifierMap,
-      getDistDir: () => this.distDir,
-      getPlugins: () => this.plugins,
-      getSrcDir: () => this.appConfig.absolutePaths.srcDir
-    };
-    this.strategies = [new JsHmrStrategy(jsContext), new DefaultHmrStrategy()];
-  }
-  /**
-   * Registers a custom HMR strategy.
-   * Used by integrations to provide framework-specific HMR handling.
-   * @param strategy - The HMR strategy to register
-   */
-  registerStrategy(strategy) {
-    this.strategies.push(strategy);
-  }
-  setPlugins(plugins) {
-    this.plugins = [...plugins];
-  }
-  setEnabled(enabled) {
-    this.enabled = enabled;
-  }
-  isEnabled() {
-    return this.enabled;
-  }
-  /**
-   * Registers a mapping from bare specifiers to vendor URLs.
-   * Used by integrations to provide their module resolution mappings.
-   * @param map - Object mapping bare specifiers to vendor URLs
-   */
-  registerSpecifierMap(map) {
-    for (const [specifier, url] of Object.entries(map)) {
-      this.specifierMap.set(specifier, url);
-    }
-  }
-  getWebSocketHandler() {
-    const open = (ws) => {
-      this.bridge.subscribe(ws);
-      appLogger.debug(`[HmrManager] Connection opened. Subscribers: ${this.bridge.subscriberCount}`);
-    };
-    const close = (ws) => {
-      this.bridge.unsubscribe(ws);
-      appLogger.debug(`[HmrManager] Connection closed. Subscribers: ${this.bridge.subscriberCount}`);
-    };
-    this.wsHandler = { open, close };
-    return {
-      open: this.wsHandler.open,
-      close: this.wsHandler.close,
-      message: (_ws, message) => {
-        appLogger.debug("[HMR] Received message from client:", message);
-      }
-    };
-  }
-  /**
-   * Builds the client-side HMR runtime script.
-   */
-  async buildRuntime() {
-    const runtimeSource = path.resolve(import.meta.dirname, "../../hmr/client/hmr-runtime.js");
-    const result = await defaultBuildAdapter.build({
-      entrypoints: [runtimeSource],
-      outdir: this.distDir,
-      naming: "_hmr_runtime.js",
-      minify: false,
-      ...defaultBuildAdapter.getTranspileOptions("hmr-runtime"),
-      plugins: this.plugins
-    });
-    if (!result.success) {
-      appLogger.error("[HMR] Failed to build runtime script:", result.logs);
-    }
-  }
-  getRuntimePath() {
-    return path.join(this.distDir, "_hmr_runtime.js");
-  }
-  broadcast(event) {
-    appLogger.debug(
-      `[HMR] Broadcasting ${event.type} event, path=${event.path || "all"}, subscribers=${this.bridge.subscriberCount}`
-    );
-    this.bridge.broadcast(event);
-  }
-  canHandleFileChange(filePath) {
-    const sorted = [...this.strategies].sort((a, b) => b.priority - a.priority);
-    const strategy = sorted.find((candidate) => {
-      try {
-        return candidate.matches(filePath);
-      } catch (err) {
-        appLogger.error(`[HmrManager] Error checking match for ${candidate.constructor.name}:`, err);
-        return false;
-      }
-    });
-    return strategy !== void 0 && strategy.type !== HmrStrategyType.FALLBACK;
-  }
-  /**
-   * Handles file changes using registered HMR strategies.
-   * Strategies are evaluated in priority order until one matches.
-   * @param filePath - Absolute path to the changed file
-   */
-  async handleFileChange(filePath) {
-    const sorted = [...this.strategies].sort((a, b) => b.priority - a.priority);
-    const strategy = sorted.find((s) => {
-      try {
-        return s.matches(filePath);
-      } catch (err) {
-        appLogger.error(`[HmrManager] Error checking match for ${s.constructor.name}:`, err);
-        return false;
-      }
-    });
-    if (!strategy) {
-      appLogger.warn(`[HMR] No strategy found for ${filePath}`);
-      return;
-    }
-    appLogger.debug(`[HmrManager] Selected strategy: ${strategy.constructor.name}`);
-    const action = await strategy.process(filePath);
-    if (action.type === "broadcast") {
-      if (action.events) {
-        for (const event of action.events) {
-          this.broadcast(event);
-        }
-      }
-    }
-  }
-  /**
-   * Registers a client entrypoint to be built and watched by Bun.
-   */
-  getOutputUrl(entrypointPath) {
-    return this.watchedFiles.get(entrypointPath);
-  }
-  getWatchedFiles() {
-    return this.watchedFiles;
-  }
-  getSpecifierMap() {
-    return this.specifierMap;
-  }
-  getDistDir() {
-    return this.distDir;
-  }
-  getPlugins() {
-    return this.plugins;
-  }
-  getDefaultContext() {
-    return {
-      getWatchedFiles: () => this.watchedFiles,
-      getSpecifierMap: () => this.specifierMap,
-      getDistDir: () => this.distDir,
-      getPlugins: () => this.plugins,
-      getSrcDir: () => this.appConfig.absolutePaths.srcDir,
-      getLayoutsDir: () => this.appConfig.absolutePaths.layoutsDir,
-      getPagesDir: () => this.appConfig.absolutePaths.pagesDir
-    };
-  }
-  async registerEntrypoint(entrypointPath) {
-    if (this.watchedFiles.has(entrypointPath)) {
-      return this.watchedFiles.get(entrypointPath);
-    }
-    const srcDir = this.appConfig.absolutePaths.srcDir;
-    const relativePath = path.relative(srcDir, entrypointPath);
-    const relativePathJs = relativePath.replace(/\.(tsx?|jsx?|mdx?)$/, ".js");
-    const encodedPathJs = this.encodeDynamicSegments(relativePathJs);
-    const urlPath = encodedPathJs.split(path.sep).join("/");
-    const outputUrl = `/${path.join(RESOLVED_ASSETS_DIR, "_hmr", urlPath)}`;
-    const outputPath = path.join(this.distDir, urlPath);
-    this.watchedFiles.set(entrypointPath, outputUrl);
-    await this.handleFileChange(entrypointPath);
-    if (!fileSystem.exists(outputPath)) {
-      const fallback = await defaultBuildAdapter.build({
-        entrypoints: [entrypointPath],
-        outdir: this.distDir,
-        naming: encodedPathJs,
-        minify: false,
-        external: Array.from(this.specifierMap.keys()),
-        ...defaultBuildAdapter.getTranspileOptions("hmr-entrypoint"),
-        plugins: this.plugins
-      });
-      if (!fallback.success) {
-        appLogger.error(`[HMR] Fallback build failed for ${entrypointPath}:`, fallback.logs);
-      }
-    }
-    return outputUrl;
-  }
-  /**
-   * Encodes dynamic route segments (brackets) in file paths.
-   * Converts `[slug]` to `_slug_` to avoid filesystem/URL issues.
-   */
-  encodeDynamicSegments(filepath) {
-    return filepath.replace(/\[([^\]]+)\]/g, "_$1_");
-  }
-  stop() {
-    for (const watcher of this.watchers.values()) {
-      watcher.close();
-    }
-    this.watchers.clear();
-  }
-}
-export {
-  HmrManager
-};

package/src/adapters/bun/index.d.ts

@@ -1,3 +0,0 @@
-export { EcopagesApp, createApp } from './create-app.js';
-export { defineApiHandler, defineGroupHandler } from './define-api-handler.js';
-export type { GroupHandler } from './define-api-handler.js';

package/src/adapters/bun/index.js

@@ -1,8 +0,0 @@
-import { EcopagesApp, createApp } from "./create-app.js";
-import { defineApiHandler, defineGroupHandler } from "./define-api-handler.js";
-export {
-  EcopagesApp,
-  createApp,
-  defineApiHandler,
-  defineGroupHandler
-};

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

@@ -1,155 +0,0 @@
-import type { Server, WebSocketHandler } from 'bun';
-import type { EcoPagesAppConfig } from '../../internal-types.js';
-import type { ApiHandler, ErrorHandler, StaticRoute } from '../../public-types.js';
-import { SharedServerAdapter } from '../shared/server-adapter.js';
-import type { ServerAdapterResult } from '../abstract/server-adapter.js';
-import { ServerRouteHandler, type ServerRouteHandlerParams } from '../shared/server-route-handler.js';
-import { ServerStaticBuilder, type ServerStaticBuilderParams } from '../shared/server-static-builder';
-import { ClientBridge } from './client-bridge';
-import { HmrManager } from './hmr-manager';
-import { ServerLifecycle } from './server-lifecycle.js';
-type BunServerInstance = Server<unknown>;
-type BunNativeServeOptions = Bun.Serve.Options<unknown>;
-export type BunServerRoutes = Bun.Serve.Routes<unknown, string>;
-export type BunServeAdapterServerOptions = Partial<Omit<BunNativeServeOptions, 'fetch'> & {
-    fetch(this: BunServerInstance, request: Request): Promise<void | Response>;
-}>;
-export type BunServeOptions = Omit<BunNativeServeOptions, 'fetch'> & {
-    fetch?: (this: BunServerInstance, request: Request, server: BunServerInstance) => Promise<void | Response>;
-    websocket?: WebSocketHandler<unknown>;
-};
-export interface BunServerAdapterParams {
-    appConfig: EcoPagesAppConfig;
-    runtimeOrigin: string;
-    serveOptions: BunServeAdapterServerOptions;
-    apiHandlers?: ApiHandler<string, Request, BunServerInstance>[];
-    staticRoutes?: StaticRoute[];
-    errorHandler?: ErrorHandler;
-    options?: {
-        watch?: boolean;
-    };
-    lifecycle?: ServerLifecycle;
-    staticBuilderFactory?: (params: ServerStaticBuilderParams) => ServerStaticBuilder;
-    routeHandlerFactory?: (params: ServerRouteHandlerParams) => ServerRouteHandler;
-    hmrManager?: HmrManager;
-    bridge?: ClientBridge;
-}
-export interface BunServerAdapterResult extends ServerAdapterResult {
-    getServerOptions: (options?: {
-        enableHmr?: boolean;
-    }) => BunServeOptions;
-    buildStatic: (options?: {
-        preview?: boolean;
-    }) => Promise<void>;
-    completeInitialization: (server?: BunServerInstance | null) => Promise<void>;
-    handleRequest: (request: Request) => Promise<Response>;
-}
-export declare class BunServerAdapter extends SharedServerAdapter<BunServerAdapterParams, BunServerAdapterResult> {
-    appConfig: EcoPagesAppConfig;
-    options: BunServerAdapterParams['options'];
-    serveOptions: BunServeAdapterServerOptions;
-    protected apiHandlers: ApiHandler<string, Request, BunServerInstance>[];
-    protected staticRoutes: StaticRoute[];
-    protected errorHandler?: ErrorHandler;
-    private bridge;
-    private lifecycle;
-    hmrManager: HmrManager;
-    private initializationPromise;
-    private fullyInitialized;
-    serverInstance: BunServerInstance | null;
-    private readonly lifecycleFactory?;
-    private readonly staticBuilderFactory?;
-    private readonly routeHandlerFactory?;
-    private readonly hmrManagerFactory?;
-    private readonly bridgeFactory?;
-    constructor({ appConfig, runtimeOrigin, serveOptions, apiHandlers, staticRoutes, errorHandler, options, lifecycle, staticBuilderFactory, routeHandlerFactory, hmrManager, bridge, }: BunServerAdapterParams);
-    /**
-     * Determines if HMR script should be injected.
-     * Only injects in watch mode when HMR manager is enabled.
-     */
-    private shouldInjectHmrScript;
-    /**
-     * Checks if a response contains HTML content.
-     */
-    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 components.
-     * Delegates to ServerLifecycle for setup.
-     */
-    initialize(): Promise<void>;
-    /**
-     * Refreshes the router routes during watch mode.
-     */
-    private refreshRouterRoutes;
-    private watch;
-    /**
-     * Retrieves the current server options, optionally enabling HMR.
-     * If HMR is enabled, modifies fetch to handle WebSocket upgrades and serve HMR runtime.
-     * Ensures original fetch logic is preserved and called for non-HMR requests.
-     * @param options.enableHmr Whether to enable Hot Module Replacement
-     */
-    getServerOptions({ enableHmr }?: {
-        enableHmr?: boolean | undefined;
-    }): BunServeOptions;
-    /**
-     * 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.
-     */
-    private retrieveBodyFromRequest;
-    /**
-     * Creates complete server configuration with request handling.
-     * @returns Server options ready for Bun.serve()
-     */
-    private buildServerSettings;
-    /**
-     * Generates a static build of the site for deployment.
-     * @param options.preview - If true, starts a preview server after build
-     */
-    buildStatic(options?: {
-        preview?: boolean;
-    }): Promise<void>;
-    /**
-     * Initializes the server with dynamic routes after server creation.
-     * Must be called before handling any requests.
-     * @param server - The Bun server instance
-     */
-    completeInitialization(server?: BunServerInstance | null): Promise<void>;
-    /**
-     * Performs complete server setup including routing, watchers, and HMR.
-     */
-    private _performInitialization;
-    /**
-     * Creates and initializes the Bun server adapter.
-     * @returns Configured adapter with server methods
-     */
-    createAdapter(): Promise<BunServerAdapterResult>;
-    /**
-     * Handles HTTP requests by passing them securely to the shared core router adapter.
-     */
-    handleRequest(request: Request): Promise<Response>;
-    /**
-     * Ensures server initialization completes before request handling.
-     * Prevents race conditions during startup.
-     */
-    private waitForInitialization;
-    /**
-     * Handles HTTP requests from the router adapter.
-     */
-    handleResponse(request: Request): Promise<Response>;
-    /**
-     * Handles requests that do not match any routes.
-     */
-    private handleNoMatch;
-}
-/**
- * Factory function to create a Bun server adapter
- */
-export declare function createBunServerAdapter(params: BunServerAdapterParams): Promise<BunServerAdapterResult>;
-export {};