@ecopages/core 0.2.0-beta.11 → 0.2.0-beta.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecopages/core",
-  "version": "0.2.0-beta.11",
+  "version": "0.2.0-beta.12",
   "description": "Core package for Ecopages",
   "keywords": [
     "ecopages",
@@ -17,7 +17,7 @@
     "directory": "packages/core"
   },
   "dependencies": {
-    "@ecopages/file-system": "0.2.0-beta.11",
+    "@ecopages/file-system": "0.2.0-beta.12",
     "@ecopages/logger": "^0.2.3",
     "@ecopages/scripts-injector": "^0.1.5",
     "@oxc-project/runtime": "0.134.0",

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

@@ -165,7 +165,7 @@ class BunServerAdapter extends SharedServerAdapter {
       staticSiteGenerator: this.staticSiteGenerator,
       serveOptions: this.serveOptions,
       runtimeOrigin: this.runtimeOrigin,
-      apiHandlers: this.apiHandlers,
+      needsServerBundle: this.apiHandlers.length > 0 || this.websocketHandlers.size > 0,
       hmrManager: this.hmrManager,
       onRuntimePlugin: (plugin) => {
         this.registerBunRuntimePlugin(plugin);

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

@@ -131,7 +131,7 @@ class NodeServerAdapter extends SharedServerAdapter {
       staticSiteGenerator: this.staticSiteGenerator,
       serveOptions: this.serveOptions,
       runtimeOrigin: this.runtimeOrigin,
-      apiHandlers: this.apiHandlers,
+      needsServerBundle: this.apiHandlers.length > 0 || this.websocketHandlers.size > 0,
       hmrManager: this.hmrManager ?? void 0
     });
     this.initialized = true;

package/src/adapters/shared/server-static-builder.d.ts

@@ -1,6 +1,6 @@
 import type { EcoPagesAppConfig, IHmrManager } from '../../types/internal-types.js';
 import type { EcoBuildPlugin } from '../../build/build-types.js';
-import type { ApiHandler, StaticRoute } from '../../types/public-types.js';
+import type { StaticRoute } from '../../types/public-types.js';
 import type { RouteRegistry } from '../../router/server/route-registry.js';
 import type { StaticSiteGenerator } from '../../static-site-generator/static-site-generator.js';
 import type { StaticGenerationRendererResolver } from '../../route-renderer/route-renderer.js';
@@ -17,7 +17,12 @@ export interface ServerStaticBuilderParams {
     staticSiteGenerator: StaticSiteGenerator;
     serveOptions: ServeOptions;
     runtimeOrigin: string;
-    apiHandlers?: ApiHandler[];
+    /**
+     * Whether the app requires a server entry bundle for production use.
+     * When `true`, the build step bundles the server entry file for `ecopages start`.
+     * Defaults to `false` (static-only build, no server needed).
+     */
+    needsServerBundle?: boolean;
     logger?: ServerStaticBuilderLogger;
     entryFile?: string;
     hmrManager?: IHmrManager;
@@ -39,21 +44,22 @@ export declare class ServerStaticBuilder {
     private readonly staticSiteGenerator;
     private readonly serveOptions;
     private readonly runtimeOrigin;
-    private readonly apiHandlers;
+    private readonly needsServerBundle;
     private readonly logger;
     private readonly entryFile;
     private readonly hmrManager?;
     private readonly onRuntimePlugin?;
-    constructor({ appConfig, staticSiteGenerator, serveOptions, runtimeOrigin, apiHandlers, logger, entryFile, hmrManager, onRuntimePlugin, }: ServerStaticBuilderParams);
+    constructor({ appConfig, staticSiteGenerator, serveOptions, runtimeOrigin, needsServerBundle, logger, entryFile, hmrManager, onRuntimePlugin, }: ServerStaticBuilderParams);
     private prepareExportDirectory;
     private refreshRuntimeAssets;
     /**
      * Bundles the server entry file for production use.
      *
      * @remarks
-     * Every production build emits a runnable server entry for `ecopages start`,
-     * including static-only and websocket-only apps. Incremental builds may skip
-     * Rolldown when the `.eco/.server-entry` cache is still valid.
+     * Only invoked when the app requires a runtime server (API handlers,
+     * websocket handlers, etc.). Static-only apps skip this step entirely.
+     * Incremental builds may skip Rolldown when the `.eco/.server-entry`
+     * cache is still valid.
      *
      * Package imports remain external so native addons and runtime-owned
      * dependencies continue to load through the app's installed

package/src/adapters/shared/server-static-builder.js

@@ -21,7 +21,7 @@ class ServerStaticBuilder {
   staticSiteGenerator;
   serveOptions;
   runtimeOrigin;
-  apiHandlers;
+  needsServerBundle;
   logger;
   entryFile;
   hmrManager;
@@ -31,7 +31,7 @@ class ServerStaticBuilder {
     staticSiteGenerator,
     serveOptions,
     runtimeOrigin,
-    apiHandlers,
+    needsServerBundle,
     logger,
     entryFile,
     hmrManager,
@@ -41,7 +41,7 @@ class ServerStaticBuilder {
     this.staticSiteGenerator = staticSiteGenerator;
     this.serveOptions = serveOptions;
     this.runtimeOrigin = runtimeOrigin;
-    this.apiHandlers = apiHandlers ?? [];
+    this.needsServerBundle = needsServerBundle ?? false;
     this.logger = logger ?? appLogger;
     this.entryFile = resolveEntryFile({ entryFile });
     this.hmrManager = hmrManager;
@@ -87,9 +87,10 @@ class ServerStaticBuilder {
    * Bundles the server entry file for production use.
    *
    * @remarks
-   * Every production build emits a runnable server entry for `ecopages start`,
-   * including static-only and websocket-only apps. Incremental builds may skip
-   * Rolldown when the `.eco/.server-entry` cache is still valid.
+   * Only invoked when the app requires a runtime server (API handlers,
+   * websocket handlers, etc.). Static-only apps skip this step entirely.
+   * Incremental builds may skip Rolldown when the `.eco/.server-entry`
+   * cache is still valid.
    *
    * Package imports remain external so native addons and runtime-owned
    * dependencies continue to load through the app's installed
@@ -166,7 +167,9 @@ ${errorMessages}`);
     const baseUrl = explicitBaseUrl ?? `http://${this.serveOptions.hostname || DEFAULT_ECOPAGES_HOSTNAME}:${this.serveOptions.port || DEFAULT_ECOPAGES_PORT}`;
     const preserveExportDirectory = this.prepareExportDirectory(force);
     await this.refreshRuntimeAssets();
-    await this.bundleServerEntry({ force });
+    if (this.needsServerBundle) {
+      await this.bundleServerEntry({ force });
+    }
     await this.staticSiteGenerator.run({
       router: dependencies.router,
       baseUrl,