@ecopages/core 0.2.0-beta.30 → 0.2.0-beta.32

package/src/build/cache/server-entry-build-cache.js

@@ -1,165 +1,153 @@
-import path from "node:path";
-import { fileSystem } from "@ecopages/file-system";
-import { resolveServerAppBuildPlugins } from "../runtime/build-request-policy.js";
-import { createBuildInputsFingerprint } from "./build-input-fingerprint.js";
-import {
-  isProductionCacheManifestCurrent,
-  matchesProductionCacheBuildKey,
-  matchesProductionCacheFingerprint,
-  readProductionCacheManifest,
-  writeProductionCacheManifest
-} from "./production-build-cache.js";
-import { createPluginCacheKey, getCorePackageVersion } from "./cache-keys.js";
-import {
-  RouteModuleDependencyHasher,
-  createRouteModuleDependencyHashes
-} from "../../services/module-loading/route-module-dependency-hasher.js";
-import { resolveInternalExecutionDir } from "../../utils/resolve-work-dir.js";
-import { SERVER_BUNDLE_DIR, SERVER_BUNDLE_FILENAME } from "../../utils/resolve-entry-file.js";
-import { SERVER_ENTRY_BUILD_CACHE_FILENAME } from "./cache-constants.js";
-import { SERVER_ENTRY_BUILD_CACHE_FILENAME as SERVER_ENTRY_BUILD_CACHE_FILENAME2 } from "./cache-constants.js";
-const SERVER_BUNDLE_MANIFEST_FILENAME = "manifest.json";
+import path from 'node:path';
+import { fileSystem } from '@ecopages/file-system';
+import { resolveServerAppBuildPlugins } from '../runtime/build-request-policy.js';
+import { createBuildInputsFingerprint } from './build-input-fingerprint.js';
+import { isProductionCacheManifestCurrent, matchesProductionCacheBuildKey, matchesProductionCacheFingerprint, readProductionCacheManifest, writeProductionCacheManifest, } from './production-build-cache.js';
+import { createPluginCacheKey, getCorePackageVersion } from './cache-keys.js';
+import { RouteModuleDependencyHasher, createRouteModuleDependencyHashes, } from '../../services/module-loading/route-module-dependency-hasher.js';
+import { resolveInternalExecutionDir } from '../../utils/resolve-work-dir.js';
+import { SERVER_BUNDLE_DIR, SERVER_BUNDLE_FILENAME } from '../../utils/resolve-entry-file.js';
+import { SERVER_ENTRY_BUILD_CACHE_FILENAME } from './cache-constants.js';
+export { SERVER_ENTRY_BUILD_CACHE_FILENAME } from './cache-constants.js';
+export const SERVER_BUNDLE_MANIFEST_FILENAME = 'manifest.json';
 function getServerEntryCacheDir(appConfig) {
-  return path.join(resolveInternalExecutionDir(appConfig), ".server-entry");
+    return path.join(resolveInternalExecutionDir(appConfig), '.server-entry');
 }
 function getServerEntryCacheManifestPath(appConfig) {
-  return path.join(getServerEntryCacheDir(appConfig), SERVER_ENTRY_BUILD_CACHE_FILENAME);
+    return path.join(getServerEntryCacheDir(appConfig), SERVER_ENTRY_BUILD_CACHE_FILENAME);
 }
 function hashDependencyGraph(entryPath, dependencyGraph, hasher, rootDir) {
-  if (!dependencyGraph) {
-    return { [path.resolve(entryPath)]: fileSystem.hash(entryPath) };
-  }
-  return createRouteModuleDependencyHashes(hasher, { dependencyGraph }, entryPath, rootDir);
+    if (!dependencyGraph) {
+        return { [path.resolve(entryPath)]: fileSystem.hash(entryPath) };
+    }
+    return createRouteModuleDependencyHashes(hasher, { dependencyGraph }, entryPath, rootDir);
 }
+/**
+ * Fingerprints the app-owned output-affecting server request policy.
+ *
+ * @remarks
+ * Includes ordered server plugins and JSX ownership plugins via
+ * {@link resolveServerAppBuildPlugins}. The versioned prefix intentionally
+ * invalidates manifests written before server requests included JSX ownership.
+ */
 function createServerEntryBuildKey(appConfig) {
-  try {
-    return [
-      "server-entry-request-v2",
-      "node",
-      "esm",
-      "external-packages",
-      createPluginCacheKey(resolveServerAppBuildPlugins(appConfig))
-    ].join("::");
-  } catch {
-    return "server-entry-request-v2::node::esm::external-packages";
-  }
+    try {
+        return [
+            'server-entry-request-v2',
+            'node',
+            'esm',
+            'external-packages',
+            createPluginCacheKey(resolveServerAppBuildPlugins(appConfig)),
+        ].join('::');
+    }
+    catch {
+        return 'server-entry-request-v2::node::esm::external-packages';
+    }
 }
-function getServerBundleOutputPaths(appConfig) {
-  const distDir = appConfig.absolutePaths?.distDir ?? path.join(appConfig.rootDir, appConfig.distDir);
-  const serverOutdir = path.join(distDir, SERVER_BUNDLE_DIR);
-  const serverEntryPath = path.join(serverOutdir, SERVER_BUNDLE_FILENAME);
-  const manifestPath = path.join(serverOutdir, SERVER_BUNDLE_MANIFEST_FILENAME);
-  return { distDir, serverOutdir, serverEntryPath, manifestPath };
+export function getServerBundleOutputPaths(appConfig) {
+    const distDir = appConfig.absolutePaths?.distDir ?? path.join(appConfig.rootDir, appConfig.distDir);
+    const serverOutdir = path.join(distDir, SERVER_BUNDLE_DIR);
+    const serverEntryPath = path.join(serverOutdir, SERVER_BUNDLE_FILENAME);
+    const manifestPath = path.join(serverOutdir, SERVER_BUNDLE_MANIFEST_FILENAME);
+    return { distDir, serverOutdir, serverEntryPath, manifestPath };
 }
-function readServerEntryBuildCacheManifest(appConfig) {
-  return readProductionCacheManifest(getServerEntryCacheManifestPath(appConfig));
+export function readServerEntryBuildCacheManifest(appConfig) {
+    return readProductionCacheManifest(getServerEntryCacheManifestPath(appConfig));
 }
 function writeServerEntryBuildCacheManifest(appConfig, manifest) {
-  writeProductionCacheManifest(
-    path.join(getServerEntryCacheDir(appConfig), SERVER_ENTRY_BUILD_CACHE_FILENAME),
-    manifest
-  );
+    writeProductionCacheManifest(path.join(getServerEntryCacheDir(appConfig), SERVER_ENTRY_BUILD_CACHE_FILENAME), manifest);
 }
-function writeServerBundleDeployManifest(appConfig, serverEntryPath) {
-  const { distDir, manifestPath } = getServerBundleOutputPaths(appConfig);
-  fileSystem.ensureDir(path.dirname(manifestPath));
-  const payload = {
-    serverEntry: path.relative(path.dirname(manifestPath), serverEntryPath) || SERVER_BUNDLE_FILENAME,
-    distDir,
-    builtAt: Date.now()
-  };
-  fileSystem.write(manifestPath, `${JSON.stringify(payload, null, "	")}
-`);
+export function writeServerBundleDeployManifest(appConfig, serverEntryPath) {
+    const { distDir, manifestPath } = getServerBundleOutputPaths(appConfig);
+    fileSystem.ensureDir(path.dirname(manifestPath));
+    const payload = {
+        serverEntry: path.relative(path.dirname(manifestPath), serverEntryPath) || SERVER_BUNDLE_FILENAME,
+        distDir,
+        builtAt: Date.now(),
+    };
+    fileSystem.write(manifestPath, `${JSON.stringify(payload, null, '\t')}\n`);
 }
-function lookupServerEntryBuildCache(options) {
-  if (options.force) {
-    return void 0;
-  }
-  if (process.env.NODE_ENV !== "production") {
-    return void 0;
-  }
-  const entryPath = path.resolve(options.entryPath);
-  const entryHash = fileSystem.hash(entryPath);
-  const buildInputsFingerprint = createBuildInputsFingerprint(options.appConfig);
-  const buildKey = createServerEntryBuildKey(options.appConfig);
-  const manifest = readServerEntryBuildCacheManifest(options.appConfig);
-  if (!manifest) {
-    return void 0;
-  }
-  if (!isProductionCacheManifestCurrent(manifest, getCorePackageVersion())) {
-    return void 0;
-  }
-  if (manifest.entryPath !== entryPath || manifest.entryHash !== entryHash || !matchesProductionCacheFingerprint(manifest, buildInputsFingerprint) || !matchesProductionCacheBuildKey(manifest, buildKey)) {
-    return void 0;
-  }
-  const hasher = new RouteModuleDependencyHasher();
-  if (!hasher.matchesStoredHashes(manifest.dependencyHashes, entryPath, entryHash)) {
-    return void 0;
-  }
-  const existingOutputs = manifest.outputPaths.filter((outputPath) => fileSystem.exists(outputPath));
-  if (existingOutputs.length === 0) {
-    return void 0;
-  }
-  return {
-    manifest,
-    outputPaths: existingOutputs
-  };
+export function lookupServerEntryBuildCache(options) {
+    if (options.force) {
+        return undefined;
+    }
+    if (process.env.NODE_ENV !== 'production') {
+        return undefined;
+    }
+    const entryPath = path.resolve(options.entryPath);
+    const entryHash = fileSystem.hash(entryPath);
+    const buildInputsFingerprint = createBuildInputsFingerprint(options.appConfig);
+    const buildKey = createServerEntryBuildKey(options.appConfig);
+    const manifest = readServerEntryBuildCacheManifest(options.appConfig);
+    if (!manifest) {
+        return undefined;
+    }
+    if (!isProductionCacheManifestCurrent(manifest, getCorePackageVersion())) {
+        return undefined;
+    }
+    if (manifest.entryPath !== entryPath ||
+        manifest.entryHash !== entryHash ||
+        !matchesProductionCacheFingerprint(manifest, buildInputsFingerprint) ||
+        !matchesProductionCacheBuildKey(manifest, buildKey)) {
+        return undefined;
+    }
+    const hasher = new RouteModuleDependencyHasher();
+    if (!hasher.matchesStoredHashes(manifest.dependencyHashes, entryPath, entryHash)) {
+        return undefined;
+    }
+    const existingOutputs = manifest.outputPaths.filter((outputPath) => fileSystem.exists(outputPath));
+    if (existingOutputs.length === 0) {
+        return undefined;
+    }
+    return {
+        manifest,
+        outputPaths: existingOutputs,
+    };
 }
-function recordServerEntryBuildCache(options) {
-  if (process.env.NODE_ENV !== "production") {
-    return;
-  }
-  const entryPath = path.resolve(options.entryPath);
-  const entryHash = fileSystem.hash(entryPath);
-  const hasher = new RouteModuleDependencyHasher();
-  const dependencyHashes = hashDependencyGraph(
-    entryPath,
-    options.buildResult.dependencyGraph,
-    hasher,
-    options.appConfig.rootDir
-  );
-  const manifest = {
-    invalidationVersion: getCorePackageVersion(),
-    entryPath,
-    entryHash,
-    buildInputsFingerprint: createBuildInputsFingerprint(options.appConfig),
-    buildKey: createServerEntryBuildKey(options.appConfig),
-    outputPaths: options.outputPaths,
-    dependencyHashes,
-    builtAt: Date.now()
-  };
-  writeServerEntryBuildCacheManifest(options.appConfig, manifest);
+export function recordServerEntryBuildCache(options) {
+    if (process.env.NODE_ENV !== 'production') {
+        return;
+    }
+    const entryPath = path.resolve(options.entryPath);
+    const entryHash = fileSystem.hash(entryPath);
+    const hasher = new RouteModuleDependencyHasher();
+    const dependencyHashes = hashDependencyGraph(entryPath, options.buildResult.dependencyGraph, hasher, options.appConfig.rootDir);
+    const manifest = {
+        invalidationVersion: getCorePackageVersion(),
+        entryPath,
+        entryHash,
+        buildInputsFingerprint: createBuildInputsFingerprint(options.appConfig),
+        buildKey: createServerEntryBuildKey(options.appConfig),
+        outputPaths: options.outputPaths,
+        dependencyHashes,
+        builtAt: Date.now(),
+    };
+    writeServerEntryBuildCacheManifest(options.appConfig, manifest);
 }
-function resolveProductionServerEntry(cwd = process.cwd()) {
-  const manifestPath = path.join(cwd, "dist", SERVER_BUNDLE_DIR, SERVER_BUNDLE_MANIFEST_FILENAME);
-  if (fileSystem.exists(manifestPath)) {
-    try {
-      const parsed = JSON.parse(fileSystem.readFileSync(manifestPath));
-      if (parsed?.serverEntry) {
-        const fromManifest = path.isAbsolute(parsed.serverEntry) ? parsed.serverEntry : path.join(path.dirname(manifestPath), parsed.serverEntry);
-        if (fileSystem.exists(fromManifest)) {
-          return fromManifest;
+export function resolveProductionServerEntry(cwd = process.cwd()) {
+    const manifestPath = path.join(cwd, 'dist', SERVER_BUNDLE_DIR, SERVER_BUNDLE_MANIFEST_FILENAME);
+    if (fileSystem.exists(manifestPath)) {
+        try {
+            const parsed = JSON.parse(fileSystem.readFileSync(manifestPath));
+            if (parsed?.serverEntry) {
+                const fromManifest = path.isAbsolute(parsed.serverEntry)
+                    ? parsed.serverEntry
+                    : path.join(path.dirname(manifestPath), parsed.serverEntry);
+                if (fileSystem.exists(fromManifest)) {
+                    return fromManifest;
+                }
+            }
+            if (parsed?.distDir) {
+                const fromDistDir = path.join(parsed.distDir, SERVER_BUNDLE_DIR, SERVER_BUNDLE_FILENAME);
+                if (fileSystem.exists(fromDistDir)) {
+                    return fromDistDir;
+                }
+            }
         }
-      }
-      if (parsed?.distDir) {
-        const fromDistDir = path.join(parsed.distDir, SERVER_BUNDLE_DIR, SERVER_BUNDLE_FILENAME);
-        if (fileSystem.exists(fromDistDir)) {
-          return fromDistDir;
+        catch {
+            // fall through to legacy path
         }
-      }
-    } catch {
     }
-  }
-  const legacyPath = path.join(cwd, "dist", SERVER_BUNDLE_DIR, SERVER_BUNDLE_FILENAME);
-  return fileSystem.exists(legacyPath) ? legacyPath : void 0;
+    const legacyPath = path.join(cwd, 'dist', SERVER_BUNDLE_DIR, SERVER_BUNDLE_FILENAME);
+    return fileSystem.exists(legacyPath) ? legacyPath : undefined;
 }
-export {
-  SERVER_BUNDLE_MANIFEST_FILENAME,
-  SERVER_ENTRY_BUILD_CACHE_FILENAME2 as SERVER_ENTRY_BUILD_CACHE_FILENAME,
-  getServerBundleOutputPaths,
-  lookupServerEntryBuildCache,
-  readServerEntryBuildCacheManifest,
-  recordServerEntryBuildCache,
-  resolveProductionServerEntry,
-  writeServerBundleDeployManifest
-};

package/src/build/contracts/build-contracts.d.ts

@@ -33,9 +33,9 @@ export interface BuildResult {
  * Options accepted by every `BuildAdapter.build` call.
  *
  * @remarks
- * Fields that the adapter can forward are honored; fields that cannot
- * (currently `splitting`, `bundle`, and `outbase`) are accepted so
- * call-sites compile, but the adapter ignores them.
+ * Fields that the adapter can forward are honored. `splitting: false` disables
+ * Rolldown code splitting for single-entrypoint builds. `bundle` and `outbase`
+ * are accepted for call-site compatibility but ignored.
  */
 export interface BuildOptions {
     entrypoints: string[] | Record<string, string>;
@@ -57,7 +57,7 @@ export interface BuildOptions {
     target?: string;
     format?: string;
     sourcemap?: string;
-    /** @deprecated Accepted for call-site compatibility only. */
+    /** When `false` with a single entrypoint, inlines dynamic imports into one output file. */
     splitting?: boolean;
     root?: string;
     /** @deprecated Accepted for call-site compatibility only. */

package/src/build/contracts/build-contracts.js

@@ -0,0 +1 @@
+export {};

package/src/build/contracts/build-manifest.js

@@ -1,49 +1,64 @@
-import { createBrowserRuntimePlugin, DEFAULT_BROWSER_RUNTIME_PLUGIN_NAME } from "../browser/browser-runtime-plugin.js";
-import {
-  createBrowserRuntimeManifest,
-  mergeBrowserRuntimeManifests
-} from "../browser/browser-runtime-manifest.js";
-function mergeEcoBuildPlugins(...pluginLists) {
-  const byName = /* @__PURE__ */ new Map();
-  for (const plugins of pluginLists) {
-    for (const plugin of plugins ?? []) {
-      if (!byName.has(plugin.name)) {
-        byName.set(plugin.name, plugin);
-      }
+import { createBrowserRuntimePlugin, DEFAULT_BROWSER_RUNTIME_PLUGIN_NAME } from '../browser/browser-runtime-plugin.js';
+import { createBrowserRuntimeManifest, mergeBrowserRuntimeManifests, } from '../browser/browser-runtime-manifest.js';
+/**
+ * Merges plugin lists while preserving first-registration precedence by name.
+ *
+ * @remarks
+ * Build manifests treat plugin names as stable identities. The first plugin
+ * with a given name wins so config-time assembly stays deterministic across
+ * loader, runtime, and browser buckets.
+ */
+export function mergeEcoBuildPlugins(...pluginLists) {
+    const byName = new Map();
+    for (const plugins of pluginLists) {
+        for (const plugin of plugins ?? []) {
+            if (!byName.has(plugin.name)) {
+                byName.set(plugin.name, plugin);
+            }
+        }
     }
-  }
-  return Array.from(byName.values());
+    return Array.from(byName.values());
 }
-function createAppBuildManifest(input) {
-  return {
-    loaderPlugins: mergeEcoBuildPlugins(input?.loaderPlugins),
-    runtimePlugins: mergeEcoBuildPlugins(input?.runtimePlugins),
-    browserBundlePlugins: mergeEcoBuildPlugins(input?.browserBundlePlugins),
-    browserRuntimeManifest: mergeBrowserRuntimeManifests(input?.browserRuntimeManifest)
-  };
+/**
+ * Creates one app-owned build manifest from the supplied plugin buckets.
+ */
+export function createAppBuildManifest(input) {
+    return {
+        loaderPlugins: mergeEcoBuildPlugins(input?.loaderPlugins),
+        runtimePlugins: mergeEcoBuildPlugins(input?.runtimePlugins),
+        browserBundlePlugins: mergeEcoBuildPlugins(input?.browserBundlePlugins),
+        browserRuntimeManifest: mergeBrowserRuntimeManifests(input?.browserRuntimeManifest),
+    };
 }
-function getBrowserRuntimeManifest(manifest) {
-  return manifest.browserRuntimeManifest ?? createBrowserRuntimeManifest();
+/**
+ * Returns the shared browser runtime asset manifest sealed into the app build manifest.
+ */
+export function getBrowserRuntimeManifest(manifest) {
+    return manifest.browserRuntimeManifest ?? createBrowserRuntimeManifest();
 }
-function getServerBuildPlugins(manifest) {
-  return mergeEcoBuildPlugins(manifest.loaderPlugins, manifest.runtimePlugins);
+/**
+ * Returns the plugin list used for server-oriented builds.
+ *
+ * @remarks
+ * Merges `loaderPlugins` then `runtimePlugins`. Browser-only buckets and the
+ * synthesized browser-runtime rewrite plugin are excluded.
+ */
+export function getServerBuildPlugins(manifest) {
+    return mergeEcoBuildPlugins(manifest.loaderPlugins, manifest.runtimePlugins);
 }
-function getBrowserBuildPlugins(manifest) {
-  const runtimeRewritePlugin = createBrowserRuntimePlugin({
-    name: DEFAULT_BROWSER_RUNTIME_PLUGIN_NAME,
-    manifest: getBrowserRuntimeManifest(manifest)
-  });
-  return mergeEcoBuildPlugins(
-    manifest.loaderPlugins,
-    manifest.runtimePlugins,
-    runtimeRewritePlugin ? [runtimeRewritePlugin] : [],
-    manifest.browserBundlePlugins
-  );
+/**
+ * Returns the plugin list used for browser-oriented builds.
+ *
+ * @remarks
+ * Merges, in order: `loaderPlugins`, `runtimePlugins`, a synthesized
+ * `browser-runtime-plugin` when `browserRuntimeManifest` has entries, then
+ * `browserBundlePlugins`. Plugin names dedupe with first-registration wins via
+ * {@link mergeEcoBuildPlugins}.
+ */
+export function getBrowserBuildPlugins(manifest) {
+    const runtimeRewritePlugin = createBrowserRuntimePlugin({
+        name: DEFAULT_BROWSER_RUNTIME_PLUGIN_NAME,
+        manifest: getBrowserRuntimeManifest(manifest),
+    });
+    return mergeEcoBuildPlugins(manifest.loaderPlugins, manifest.runtimePlugins, runtimeRewritePlugin ? [runtimeRewritePlugin] : [], manifest.browserBundlePlugins);
 }
-export {
-  createAppBuildManifest,
-  getBrowserBuildPlugins,
-  getBrowserRuntimeManifest,
-  getServerBuildPlugins,
-  mergeEcoBuildPlugins
-};

package/src/build/contracts/build-types.js

@@ -0,0 +1 @@
+export {};

package/src/build/rolldown/rolldown-adapter-helpers.d.ts

@@ -29,6 +29,15 @@ export declare function transpileProfileToOptions(profile: BuildTranspileProfile
  * See {@link https://rolldown.rs/in-depth/external-modules | Rolldown external modules}.
  */
 export declare function createNodeBuiltinExternalPlugin(): RolldownPlugin;
+/**
+ * Rejects Node builtins in browser-target builds before Rolldown externalizes them.
+ *
+ * @remarks
+ * With `platform: 'browser'`, Rolldown leaves `node:*` imports in the output as
+ * bare specifiers. This plugin fails the build instead so server-only graphs
+ * cannot reach the browser as silent CORS errors.
+ */
+export declare function createBrowserNodeBuiltinGuardPlugin(): RolldownPlugin;
 export declare function extractDependencyGraph(chunks: Array<{
     facadeModuleId: string | null;
     moduleIds: string[];