@ecopages/core 0.2.0-alpha.52 → 0.2.0-alpha.54

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

@@ -1,5 +0,0 @@
-class AbstractRouterAdapter {
-}
-export {
-  AbstractRouterAdapter
-};

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

@@ -1,69 +0,0 @@
-/**
- * This file contains the abstract server adapter class and its related types.
- * It is designed to be extended by specific server adapters for different runtimes.
- * The class provides methods for initializing the server, creating server options,
- * building static files, and handling HTTP requests.
- *
- * @module ServerAdapter
- */
-import type { EcoPagesAppConfig } from '../../types/internal-types.js';
-import type { ApiHandler } from '../../types/public-types.js';
-/**
- * Configuration options for all server adapters
- */
-export interface ServerAdapterOptions {
-    appConfig: EcoPagesAppConfig;
-    apiHandlers?: ApiHandler<string, any>[];
-    options?: {
-        watch?: boolean;
-        [key: string]: any;
-    };
-    serveOptions?: Record<string, any>;
-    runtimeOrigin: string;
-}
-/**
- * Base adapter result containing common functionalities
- * across different runtime implementations
- */
-export interface ServerAdapterResult {
-    getServerOptions: (options?: {
-        enableHmr?: boolean;
-    }) => any;
-    buildStatic: (options?: {
-        preview?: boolean;
-    }) => Promise<void>;
-}
-/**
- * Abstract base class for server adapters across different runtimes
- */
-export declare abstract class AbstractServerAdapter<TOptions extends ServerAdapterOptions = ServerAdapterOptions, TResult extends ServerAdapterResult = ServerAdapterResult> {
-    protected appConfig: EcoPagesAppConfig;
-    protected options: TOptions['options'];
-    protected serveOptions: TOptions['serveOptions'];
-    protected runtimeOrigin: string;
-    constructor(options: TOptions);
-    /**
-     * Initialize the server adapter
-     */
-    abstract initialize(): Promise<void>;
-    /**
-     * Create server options specific to the runtime
-     */
-    abstract getServerOptions(options?: {
-        enableHmr?: boolean;
-    }): any;
-    /**
-     * Build static files for the application
-     */
-    abstract buildStatic(options?: {
-        preview?: boolean;
-    }): Promise<void>;
-    /**
-     * Factory method to create a server adapter with runtime-specific functionality
-     */
-    abstract createAdapter(): Promise<TResult>;
-    /**
-     * Handle HTTP requests
-     */
-    abstract handleRequest(request: Request): Promise<Response>;
-}

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

@@ -1,15 +0,0 @@
-class AbstractServerAdapter {
-  appConfig;
-  options;
-  serveOptions;
-  runtimeOrigin;
-  constructor(options) {
-    this.appConfig = options.appConfig;
-    this.options = options.options || {};
-    this.serveOptions = options.serveOptions || {};
-    this.runtimeOrigin = options.runtimeOrigin;
-  }
-}
-export {
-  AbstractServerAdapter
-};

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

@@ -1,34 +0,0 @@
-import type { ServerWebSocket } from 'bun';
-import type { ClientBridgeEvent, IClientBridge } from '../../types/public-types.js';
-type BunSocket = ServerWebSocket<unknown>;
-/**
- * Manages WebSocket subscribers and broadcasts development events.
- * Bridges the gap between the server and the development client.
- */
-export declare class ClientBridge implements IClientBridge {
-    private subscribers;
-    subscribe(ws: BunSocket): void;
-    unsubscribe(ws: BunSocket): void;
-    /**
-     * Broadcast a raw event to all connected clients.
-     */
-    broadcast(event: ClientBridgeEvent): void;
-    /**
-     * Trigger a full page reload on all connected clients.
-     */
-    reload(): void;
-    /**
-     * Broadcast a CSS update for hot stylesheet reload.
-     */
-    cssUpdate(path: string): void;
-    /**
-     * Broadcast a JS module update for hot module replacement.
-     */
-    update(path: string): void;
-    /**
-     * Broadcast an error message to connected clients.
-     */
-    error(message: string): void;
-    get subscriberCount(): number;
-}
-export {};

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

@@ -1,48 +0,0 @@
-class ClientBridge {
-  subscribers = /* @__PURE__ */ new Set();
-  subscribe(ws) {
-    this.subscribers.add(ws);
-  }
-  unsubscribe(ws) {
-    this.subscribers.delete(ws);
-  }
-  /**
-   * Broadcast a raw event to all connected clients.
-   */
-  broadcast(event) {
-    const payload = JSON.stringify(event);
-    for (const ws of this.subscribers) {
-      ws.send(payload);
-    }
-  }
-  /**
-   * Trigger a full page reload on all connected clients.
-   */
-  reload() {
-    this.broadcast({ type: "reload" });
-  }
-  /**
-   * Broadcast a CSS update for hot stylesheet reload.
-   */
-  cssUpdate(path) {
-    this.broadcast({ type: "css-update", path, timestamp: Date.now() });
-  }
-  /**
-   * Broadcast a JS module update for hot module replacement.
-   */
-  update(path) {
-    this.broadcast({ type: "update", path, timestamp: Date.now() });
-  }
-  /**
-   * Broadcast an error message to connected clients.
-   */
-  error(message) {
-    this.broadcast({ type: "error", message });
-  }
-  get subscriberCount() {
-    return this.subscribers.size;
-  }
-}
-export {
-  ClientBridge
-};

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

@@ -1,60 +0,0 @@
-/**
- * This file contains the implementation of the Bun application adapter for EcoPages.
- * It extends the AbstractApplicationAdapter class and provides methods for handling
- * HTTP requests, initializing the server adapter, and starting the Bun application server.
- * The adapter is designed to work with the Bun runtime and provides a way to create
- * EcoPages applications using Bun's features.
- *
- * @module EcopagesApp
- */
-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';
-/**
- * Bun-specific route group builder that properly infers route params from path patterns.
- * When you define a route like `/posts/:slug`, the handler context will have
- * `ctx.params.slug` typed as `string`.
- *
- * @typeParam WebSocketData - WebSocket data type for the server
- * @typeParam TContext - Extended context type from middleware (e.g., `{ user: User }`)
- */
-export type BunRouteGroupBuilder<WebSocketData = undefined, TContext extends ApiHandlerContext<Request, Server<WebSocketData>> = ApiHandlerContext<Request, Server<WebSocketData>>> = RouteGroupBuilder<Request, Server<WebSocketData>, TContext>;
-/**
- * Bun-specific application adapter implementation
- * This class extends the {@link AbstractApplicationAdapter}
- * and provides methods for handling HTTP requests and managing the server.
- */
-export declare class BunEcopagesApp<WebSocketData = undefined> extends SharedApplicationAdapter<EcopagesAppOptions, Server<WebSocketData>, Request> {
-    serverAdapter: BunServerAdapterResult | undefined;
-    private server;
-    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>;
-    /**
-     * Complete the initialization of the server adapter by processing dynamic routes
-     * @param server The Bun server instance
-     */
-    completeInitialization(server: Server<WebSocketData>): Promise<void>;
-    /**
-     * Initialize the Bun server adapter
-     */
-    protected initializeServerAdapter(): Promise<BunServerAdapterResult>;
-    /**
-     * Start the Bun application server
-     * @param options Optional settings
-     * @param options.autoCompleteInitialization Whether to automatically complete initialization with dynamic routes after server start (defaults to true)
-     */
-    start(): Promise<Server<WebSocketData> | void>;
-}
-/**
- * Factory function to create a Bun application
- */
-export declare function createApp<WebSocketData = undefined>(options: EcopagesAppOptions): Promise<BunEcopagesApp<WebSocketData>>;

package/src/adapters/bun/create-app.js

@@ -1,140 +0,0 @@
-import { DEFAULT_ECOPAGES_HOSTNAME, DEFAULT_ECOPAGES_PORT } from "../../config/constants.js";
-import { appLogger } from "../../global/app-logger.js";
-import { SharedApplicationAdapter } from "../shared/application-adapter.js";
-import { resolveRuntimeBinding, resolveStaticRuntimeMode } from "../shared/runtime-app-bootstrap.js";
-import { createBunServerAdapter } from "./server-adapter.js";
-import { BunStaticPreviewHost } from "./static-preview-host.js";
-import { BunRuntimeHost } from "./runtime-host.js";
-class BunEcopagesApp extends SharedApplicationAdapter {
-  serverAdapter;
-  server = null;
-  runtimeHost;
-  previewHost;
-  constructor(options, dependencies) {
-    super(options);
-    this.runtimeHost = dependencies.runtimeHost;
-    this.previewHost = dependencies.previewHost;
-  }
-  async fetch(request) {
-    if (!this.serverAdapter) {
-      this.serverAdapter = await this.initializeServerAdapter();
-    }
-    await this.serverAdapter.completeInitialization(this.server);
-    return this.serverAdapter.handleRequest(request);
-  }
-  /**
-   * Complete the initialization of the server adapter by processing dynamic routes
-   * @param server The Bun server instance
-   */
-  async completeInitialization(server) {
-    if (!this.serverAdapter) {
-      throw new Error("Server adapter not initialized. Call start() first.");
-    }
-    await this.serverAdapter.completeInitialization(server);
-  }
-  /**
-   * Initialize the Bun server adapter
-   */
-  async initializeServerAdapter() {
-    const binding = resolveRuntimeBinding({
-      cliArgs: this.cliArgs,
-      serverOptions: this.serverOptions
-    });
-    appLogger.debug("initializeServerAdapter", {
-      dev: this.cliArgs.dev,
-      cliPort: this.cliArgs.port,
-      cliHostname: this.cliArgs.hostname,
-      envPort: process.env.ECOPAGES_PORT,
-      envHostname: process.env.ECOPAGES_HOSTNAME,
-      preferredPort: binding.preferredPort,
-      preferredHostname: binding.preferredHostname,
-      composedUrl: binding.runtimeOrigin
-    });
-    return await createBunServerAdapter({
-      runtimeOrigin: binding.runtimeOrigin,
-      appConfig: this.appConfig,
-      apiHandlers: this.apiHandlers,
-      staticRoutes: this.staticRoutes,
-      errorHandler: this.errorHandler,
-      options: { watch: binding.watch },
-      serveOptions: binding.serveOptions
-    });
-  }
-  /**
-   * Start the Bun application server
-   * @param options Optional settings
-   * @param options.autoCompleteInitialization Whether to automatically complete initialization with dynamic routes after server start (defaults to true)
-   */
-  async start() {
-    if (!this.serverAdapter) {
-      this.serverAdapter = await this.initializeServerAdapter();
-    }
-    const { dev, preview, build } = this.cliArgs;
-    const staticRuntimeMode = resolveStaticRuntimeMode({
-      appConfig: this.appConfig,
-      cliArgs: this.cliArgs
-    });
-    if (staticRuntimeMode.canBuildWithoutRuntimeServer) {
-      appLogger.debugTime("Building static pages");
-      await this.serverAdapter.buildStatic({ preview });
-      appLogger.debugTimeEnd("Building static pages");
-      if (build) {
-        process.exit(0);
-      }
-      return;
-    }
-    const enableHmr = dev || !preview && !build;
-    const serverOptions = this.serverAdapter.getServerOptions({ enableHmr });
-    const configuredHostname = String(serverOptions.hostname ?? DEFAULT_ECOPAGES_HOSTNAME);
-    const configuredPort = Number(serverOptions.port ?? DEFAULT_ECOPAGES_PORT);
-    const runtimeServerOptions = (preview || build) && staticRuntimeMode.requiresFetchRuntime ? {
-      ...serverOptions,
-      port: 0
-    } : serverOptions;
-    this.server = await this.runtimeHost.start({
-      serveOptions: runtimeServerOptions,
-      handleRequest: async () => new Response(null, { status: 500 }),
-      onError: async () => {
-      }
-    });
-    await this.serverAdapter.completeInitialization(this.server).catch((error) => {
-      appLogger.error(`Failed to complete initialization: ${error}`);
-    });
-    if (!this.server) {
-      throw new Error("Server failed to start");
-    }
-    appLogger.info(
-      `Server running at ${this.runtimeHost.getOrigin(this.server, runtimeServerOptions)}`
-    );
-    if (build || preview) {
-      appLogger.debugTime("Building static pages");
-      await this.serverAdapter.buildStatic({ preview: false });
-      await this.runtimeHost.stop(this.server, { force: true });
-      if (preview) {
-        const previewPort = await this.previewHost.start({
-          appConfig: this.appConfig,
-          hostname: configuredHostname,
-          port: configuredPort
-        });
-        if (previewPort) {
-          appLogger.info(`Preview running at http://${configuredHostname}:${previewPort}`);
-        }
-      }
-      appLogger.debugTimeEnd("Building static pages");
-      if (build) {
-        process.exit(0);
-      }
-    }
-    return this.server;
-  }
-}
-async function createApp(options) {
-  return new BunEcopagesApp(options, {
-    runtimeHost: new BunRuntimeHost(),
-    previewHost: new BunStaticPreviewHost()
-  });
-}
-export {
-  BunEcopagesApp,
-  createApp
-};

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

@@ -1,47 +0,0 @@
-import type { WebSocketHandler } from 'bun';
-import type { EcoPagesAppConfig } from '../../types/internal-types.js';
-import type { ClientBridge } from './client-bridge.js';
-import { InMemoryEntrypointDependencyGraph, type EntrypointDependencyGraph } from '../../services/runtime-state/entrypoint-dependency-graph.service.js';
-import { SharedHmrManager } from '../shared/shared-hmr-manager.js';
-type BunSocketHandler = WebSocketHandler<unknown>;
-export interface HmrManagerParams {
-    appConfig: EcoPagesAppConfig;
-    bridge: ClientBridge;
-}
-/**
- * Bun development HMR manager.
- *
- * @remarks
- * Bun shares the same public contract as the Node manager: page entrypoints are
- * strict integration-owned registrations, while generic script assets use their
- * own explicit registration path.
- */
-export declare class HmrManager extends SharedHmrManager {
-    private wsHandler;
-    /**
-     * Creates the Bun HMR manager around the shared HMR orchestration pipeline.
-     *
-     * @remarks
-     * Bun delegates route watching, rebuild dispatch, and runtime bundle
-     * generation to `SharedHmrManager`. The Bun subclass only supplies the
-     * transport-specific dependency graph policy and websocket hook surface.
-     */
-    constructor({ appConfig, bridge }: HmrManagerParams);
-    /**
-     * Reuses the shared in-memory dependency graph when possible and otherwise
-     * creates the Bun-compatible default graph implementation.
-     */
-    protected createEntrypointDependencyGraph(existingEntrypointDependencyGraph: EntrypointDependencyGraph): InMemoryEntrypointDependencyGraph;
-    /**
-     * Returns the Bun websocket hooks that attach and detach live HMR subscribers.
-     *
-     * @remarks
-     * `SharedHmrManager` stores the bridge behind the transport-agnostic
-     * `IClientBridge` contract because most HMR coordination only needs broadcast
-     * behavior. Bun connection lifecycle wiring is the point where that abstraction
-     * intentionally narrows back to the concrete Bun bridge so websocket instances
-     * can be tracked directly.
-     */
-    getWebSocketHandler(): BunSocketHandler;
-}
-export {};

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

@@ -1,58 +0,0 @@
-import { appLogger } from "../../global/app-logger.js";
-import {
-  InMemoryEntrypointDependencyGraph
-} from "../../services/runtime-state/entrypoint-dependency-graph.service.js";
-import { SharedHmrManager } from "../shared/shared-hmr-manager.js";
-class HmrManager extends SharedHmrManager {
-  wsHandler;
-  /**
-   * Creates the Bun HMR manager around the shared HMR orchestration pipeline.
-   *
-   * @remarks
-   * Bun delegates route watching, rebuild dispatch, and runtime bundle
-   * generation to `SharedHmrManager`. The Bun subclass only supplies the
-   * transport-specific dependency graph policy and websocket hook surface.
-   */
-  constructor({ appConfig, bridge }) {
-    super({ appConfig, bridge });
-  }
-  /**
-   * Reuses the shared in-memory dependency graph when possible and otherwise
-   * creates the Bun-compatible default graph implementation.
-   */
-  createEntrypointDependencyGraph(existingEntrypointDependencyGraph) {
-    return existingEntrypointDependencyGraph instanceof InMemoryEntrypointDependencyGraph ? existingEntrypointDependencyGraph : new InMemoryEntrypointDependencyGraph();
-  }
-  /**
-   * Returns the Bun websocket hooks that attach and detach live HMR subscribers.
-   *
-   * @remarks
-   * `SharedHmrManager` stores the bridge behind the transport-agnostic
-   * `IClientBridge` contract because most HMR coordination only needs broadcast
-   * behavior. Bun connection lifecycle wiring is the point where that abstraction
-   * intentionally narrows back to the concrete Bun bridge so websocket instances
-   * can be tracked directly.
-   */
-  getWebSocketHandler() {
-    const bridge = this.bridge;
-    const open = (ws) => {
-      bridge.subscribe(ws);
-      appLogger.debug(`[HmrManager] Connection opened. Subscribers: ${bridge.subscriberCount}`);
-    };
-    const close = (ws) => {
-      bridge.unsubscribe(ws);
-      appLogger.debug(`[HmrManager] Connection closed. Subscribers: ${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);
-      }
-    };
-  }
-}
-export {
-  HmrManager
-};

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

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

package/src/adapters/bun/index.js

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

package/src/adapters/bun/runtime-host.d.ts

@@ -1,52 +0,0 @@
-import type { Server } from 'bun';
-import type { RuntimeHost, RuntimeHostStartOptions } from '../shared/runtime-host.js';
-type BunRuntimeProvider = {
-    serve(options: Bun.Serve.Options<unknown>): Server<unknown>;
-};
-/**
- * Bun runtime host that adapts the shared runtime lifecycle contract onto
- * `Bun.serve()`.
- *
- * @remarks
- * The injected runtime provider exists so tests and non-Bun call sites can
- * construct the host without assuming `globalThis.Bun` is present. The provider
- * returns `null` instead of `undefined` to keep that absence explicit at the
- * host boundary.
- */
-export declare class BunRuntimeHost<WebSocketData = undefined> implements RuntimeHost<Server<WebSocketData>, Bun.Serve.Options<WebSocketData>> {
-    private readonly runtimeProvider;
-    /**
-     * Creates a Bun runtime host with an injectable runtime lookup.
-     *
-     * @remarks
-     * Production code uses the default `getBunRuntime()` lookup. Tests may inject a
-     * fake provider that either supplies a `serve()` implementation or returns
-     * `null` to verify the runtime-required failure path.
-     */
-    constructor(runtimeProvider?: () => BunRuntimeProvider | null);
-    /**
-     * Starts the Bun server using the already-composed serve options from the
-     * shared application bootstrap.
-     */
-    start(options: RuntimeHostStartOptions<Bun.Serve.Options<WebSocketData>>): Promise<Server<WebSocketData>>;
-    /**
-     * Stops the active Bun server immediately.
-     *
-     * @remarks
-     * The shared runtime-host contract accepts optional stop options, but Bun's
-     * server API already models the shutdown behavior directly. This host always
-     * uses Bun's forceful stop path so preview and embedded runtime shutdowns do
-     * not linger on open connections.
-     */
-    stop(server: Server<WebSocketData>): Promise<void>;
-    /**
-     * Resolves the externally reported runtime origin from the active server.
-     *
-     * @remarks
-     * Bun may finalize the hostname or port differently from the requested serve
-     * options. This method prefers the live server binding and only falls back to
-     * the requested options when Bun leaves a field unset.
-     */
-    getOrigin(server: Server<WebSocketData>, fallbackServeOptions: Bun.Serve.Options<WebSocketData>): string;
-}
-export {};

package/src/adapters/bun/runtime-host.js

@@ -1,56 +0,0 @@
-import { getBunRuntime } from "../../utils/runtime.js";
-import { resolveServeRuntimeOrigin } from "../shared/runtime-app-bootstrap.js";
-class BunRuntimeHost {
-  /**
-   * Creates a Bun runtime host with an injectable runtime lookup.
-   *
-   * @remarks
-   * Production code uses the default `getBunRuntime()` lookup. Tests may inject a
-   * fake provider that either supplies a `serve()` implementation or returns
-   * `null` to verify the runtime-required failure path.
-   */
-  constructor(runtimeProvider = () => getBunRuntime() ?? null) {
-    this.runtimeProvider = runtimeProvider;
-  }
-  runtimeProvider;
-  /**
-   * Starts the Bun server using the already-composed serve options from the
-   * shared application bootstrap.
-   */
-  async start(options) {
-    const bun = this.runtimeProvider();
-    if (!bun) {
-      throw new Error("Bun runtime is required for the Bun adapter");
-    }
-    return bun.serve(options.serveOptions);
-  }
-  /**
-   * Stops the active Bun server immediately.
-   *
-   * @remarks
-   * The shared runtime-host contract accepts optional stop options, but Bun's
-   * server API already models the shutdown behavior directly. This host always
-   * uses Bun's forceful stop path so preview and embedded runtime shutdowns do
-   * not linger on open connections.
-   */
-  async stop(server) {
-    server.stop(true);
-  }
-  /**
-   * Resolves the externally reported runtime origin from the active server.
-   *
-   * @remarks
-   * Bun may finalize the hostname or port differently from the requested serve
-   * options. This method prefers the live server binding and only falls back to
-   * the requested options when Bun leaves a field unset.
-   */
-  getOrigin(server, fallbackServeOptions) {
-    return resolveServeRuntimeOrigin({
-      hostname: server.hostname ?? fallbackServeOptions.hostname,
-      port: server.port ?? fallbackServeOptions.port
-    });
-  }
-}
-export {
-  BunRuntimeHost
-};