@ecopages/core 0.2.0-beta.31 → 0.2.0-beta.33

package/src/watchers/project-watcher.test-helpers.js

@@ -1,52 +1,47 @@
-import { vi } from "vitest";
-const createMockHmrManager = () => ({
-  handleFileChange: vi.fn(async () => {
-  }),
-  broadcast: vi.fn(() => {
-  }),
-  setEnabled: vi.fn(() => {
-  }),
-  registerEntrypoint: vi.fn(async () => ""),
-  registerScriptEntrypoint: vi.fn(async () => ({
-    sourcePath: "",
-    outputPath: "",
-    outputUrl: ""
-  })),
-  registerStrategy: vi.fn(() => {
-  }),
-  isEnabled: vi.fn(() => true),
-  getOutputUrl: vi.fn(() => void 0),
-  getWatchedFiles: vi.fn(() => /* @__PURE__ */ new Map()),
-  getDistDir: vi.fn(() => ""),
-  getDefaultContext: vi.fn(() => ({
-    getWatchedFiles: () => /* @__PURE__ */ new Map(),
-    getDistDir: () => "",
-    getSrcDir: () => "",
-    getLayoutsDir: () => "",
-    getPagesDir: () => "",
-    getBuildExecutor: () => ({ build: vi.fn(async () => ({ success: true, logs: [], outputs: [] })) }),
-    getBrowserBundleService: () => ({ bundle: vi.fn(async () => ({ success: true, logs: [], outputs: [] })) }),
-    importServerModule: vi.fn(async () => ({}))
-  }))
+import { vi } from 'vitest';
+export const createMockHmrManager = () => ({
+    handleFileChange: vi.fn(async () => { }),
+    broadcast: vi.fn(() => { }),
+    setEnabled: vi.fn(() => { }),
+    registerEntrypoint: vi.fn(async () => ''),
+    registerDevTransformContributor: vi.fn(() => { }),
+    registerScriptEntrypoint: vi.fn(async () => ({
+        sourcePath: '',
+        outputPath: '',
+        outputUrl: '',
+        role: 'script',
+    })),
+    registerStrategy: vi.fn(() => { }),
+    isEnabled: vi.fn(() => true),
+    getOutputUrl: vi.fn(() => undefined),
+    getWatchedFiles: vi.fn(() => new Map()),
+    getRegisteredEntrypoints: vi.fn(() => new Map()),
+    getRuntimeWorkDir: vi.fn(() => ''),
+    getRuntimePath: vi.fn(() => ''),
+    tryHandleAssetRequest: vi.fn(() => null),
+    getDefaultContext: vi.fn(() => ({
+        getWatchedFiles: () => new Map(),
+        getRegisteredEntrypoints: () => new Map(),
+        getSrcDir: () => '',
+        getLayoutsDir: () => '',
+        getPagesDir: () => '',
+        getEntrypointDependencyGraph: () => ({
+            supportsSelectiveInvalidation: () => false,
+            getDependencyEntrypoints: () => new Set(),
+            setEntrypointDependencies: () => { },
+            clearEntrypointDependencies: () => { },
+            reset: () => { },
+        }),
+        importServerModule: vi.fn(async () => ({})),
+    })),
 });
-const createMockBridge = () => ({
-  reload: vi.fn(() => {
-  }),
-  error: vi.fn(() => {
-  }),
-  cssUpdate: vi.fn(() => {
-  }),
-  update: vi.fn(() => {
-  }),
-  subscribe: vi.fn(() => {
-  }),
-  unsubscribe: vi.fn(() => {
-  }),
-  broadcast: vi.fn(() => {
-  }),
-  subscriberCount: 0
+export const createMockBridge = () => ({
+    reload: vi.fn(() => { }),
+    error: vi.fn(() => { }),
+    cssUpdate: vi.fn(() => { }),
+    update: vi.fn(() => { }),
+    subscribe: vi.fn(() => { }),
+    unsubscribe: vi.fn(() => { }),
+    broadcast: vi.fn(() => { }),
+    subscriberCount: 0,
 });
-export {
-  createMockBridge,
-  createMockHmrManager
-};

package/src/adapters/shared/hmr/hmr-entrypoint-registrar.d.ts

@@ -1,56 +0,0 @@
-import { type ResolvedHmrEntrypoint } from '../../../hmr/hmr-entrypoint-output.js';
-/**
- * Runtime-specific hooks required to materialize a single HMR entrypoint.
- */
-export interface HmrEntrypointRegistrationOptions {
-    /**
-     * Emits the browser-consumable HMR artifact for an entrypoint.
-     */
-    emit(entrypointPath: string, outputPath: string): Promise<void>;
-    /**
-     * Creates the runtime-specific error raised when the emit hook completes without producing output.
-     */
-    getMissingOutputError(entrypointPath: string, outputPath: string): Error;
-}
-export interface HmrEntrypointRegistrarOptions {
-    /** Absolute source directory used to derive the emitted HMR path. */
-    srcDir: string;
-    /** Absolute distribution directory where HMR outputs are written. */
-    distDir: string;
-    /** Runtime-specific cleanup invoked when an entrypoint registration fails. */
-    clearFailedRegistration?: (entrypointPath: string) => void;
-}
-/**
- * Coordinates the shared HMR entrypoint registration lifecycle for both Node and Bun managers.
- *
- * @remarks
- * The registrar owns in-flight deduplication and the registered entrypoint table.
- * A source path is committed only after emit succeeds and the expected output exists on disk.
- */
-export declare class HmrEntrypointRegistrar {
-    private readonly options;
-    private readonly inFlight;
-    private readonly registered;
-    constructor(options: HmrEntrypointRegistrarOptions);
-    getRegistered(): ReadonlyMap<string, ResolvedHmrEntrypoint>;
-    getWatchedFiles(): Map<string, string>;
-    clearRegistration(entrypointPath: string): void;
-    /**
-     * Registers an already-materialized HMR entrypoint without running the emit hook.
-     *
-     * @remarks
-     * Cold dev batches build entrypoints in grouped Rolldown passes and then seed
-     * the registrar so the first SSR can resolve the artifact without rebuilding.
-     * The source path is committed verbatim so `getResolvedScriptOutput()` and the
-     * file watcher see it as a regular watched entrypoint.
-     */
-    seedResolvedEntrypoint(resolved: ResolvedHmrEntrypoint): void;
-    clearAll(): void;
-    /**
-     * Registers a single source entrypoint and returns its verified HMR artifact.
-     *
-     * Concurrent requests for the same normalized entrypoint share the same in-flight promise.
-     */
-    registerEntrypoint(entrypointPath: string, registrationOptions: HmrEntrypointRegistrationOptions): Promise<ResolvedHmrEntrypoint>;
-    private registerEntrypointInternal;
-}

package/src/adapters/shared/hmr/hmr-entrypoint-registrar.js

@@ -1,106 +0,0 @@
-import path from "node:path";
-import { fileSystem } from "@ecopages/file-system";
-import {
-  removeStaleHmrEntrypointOutput,
-  resolveHmrEntrypointOutputPaths
-} from "../../../hmr/hmr-entrypoint-output.js";
-class HmrEntrypointRegistrar {
-  options;
-  inFlight = /* @__PURE__ */ new Map();
-  registered = /* @__PURE__ */ new Map();
-  constructor(options) {
-    this.options = options;
-  }
-  getRegistered() {
-    return this.registered;
-  }
-  getWatchedFiles() {
-    const watchedFiles = /* @__PURE__ */ new Map();
-    for (const [sourcePath, entrypoint] of this.registered) {
-      watchedFiles.set(sourcePath, entrypoint.outputUrl);
-    }
-    return watchedFiles;
-  }
-  clearRegistration(entrypointPath) {
-    this.registered.delete(path.resolve(entrypointPath));
-  }
-  /**
-   * Registers an already-materialized HMR entrypoint without running the emit hook.
-   *
-   * @remarks
-   * Cold dev batches build entrypoints in grouped Rolldown passes and then seed
-   * the registrar so the first SSR can resolve the artifact without rebuilding.
-   * The source path is committed verbatim so `getResolvedScriptOutput()` and the
-   * file watcher see it as a regular watched entrypoint.
-   */
-  seedResolvedEntrypoint(resolved) {
-    this.registered.set(path.resolve(resolved.sourcePath), {
-      sourcePath: resolved.sourcePath,
-      outputPath: resolved.outputPath,
-      outputUrl: resolved.outputUrl
-    });
-  }
-  clearAll() {
-    this.inFlight.clear();
-    this.registered.clear();
-  }
-  /**
-   * Registers a single source entrypoint and returns its verified HMR artifact.
-   *
-   * Concurrent requests for the same normalized entrypoint share the same in-flight promise.
-   */
-  async registerEntrypoint(entrypointPath, registrationOptions) {
-    const normalizedEntrypoint = path.resolve(entrypointPath);
-    const existing = this.registered.get(normalizedEntrypoint);
-    if (existing && fileSystem.exists(existing.outputPath)) {
-      return existing;
-    }
-    const existingRegistration = this.inFlight.get(normalizedEntrypoint);
-    if (existingRegistration) {
-      return await existingRegistration;
-    }
-    const registration = this.registerEntrypointInternal(normalizedEntrypoint, registrationOptions);
-    this.inFlight.set(normalizedEntrypoint, registration);
-    try {
-      return await registration;
-    } catch (error) {
-      this.options.clearFailedRegistration?.(normalizedEntrypoint);
-      this.registered.delete(normalizedEntrypoint);
-      throw error;
-    } finally {
-      if (this.inFlight.get(normalizedEntrypoint) === registration) {
-        this.inFlight.delete(normalizedEntrypoint);
-      }
-    }
-  }
-  async registerEntrypointInternal(entrypointPath, registrationOptions) {
-    const previous = this.registered.get(entrypointPath);
-    const { outputPath, outputUrl } = resolveHmrEntrypointOutputPaths(
-      this.options.srcDir,
-      this.options.distDir,
-      entrypointPath
-    );
-    removeStaleHmrEntrypointOutput(outputPath, "HMR");
-    try {
-      await registrationOptions.emit(entrypointPath, outputPath);
-      if (!fileSystem.exists(outputPath)) {
-        throw registrationOptions.getMissingOutputError(entrypointPath, outputPath);
-      }
-      const resolved = {
-        sourcePath: entrypointPath,
-        outputPath,
-        outputUrl
-      };
-      this.registered.set(entrypointPath, resolved);
-      return resolved;
-    } catch (error) {
-      if (previous && fileSystem.exists(previous.outputPath)) {
-        this.registered.set(entrypointPath, previous);
-      }
-      throw error;
-    }
-  }
-}
-export {
-  HmrEntrypointRegistrar
-};

package/src/build/cache/dev-browser-script-cache.d.ts

@@ -1,34 +0,0 @@
-import type { EcoPagesAppConfig } from '../../types/internal-types.js';
-import type { ProcessedAsset } from '../../services/assets/asset-processing-service/assets.types.js';
-export declare const DEV_BROWSER_SCRIPT_CACHE_DIR = ".browser-script-bundles";
-export declare const DEV_BROWSER_SCRIPT_CACHE_FILENAME = ".build-cache.json";
-/** Output path restored from the dev disk cache before dependency metadata is merged. */
-export type DevBrowserScriptCacheHit = {
-    filepath: string;
-};
-/**
- * @remarks
- * Dev asset caching spans three scopes that should not be conflated:
- * - request dedupe (`request-build-dedupe.ts`) — one in-flight build per request key
- * - in-memory service cache (`AssetProcessingService`) — per-process reuse within one dev server
- * - this disk manifest (`.eco/.browser-script-bundles`) — cross-request reuse of content-script bundles
- *
- * Disk entries intentionally store only output file paths. Declarative fields such as
- * `groupedBundle`, `attributes`, and `packageRole` live on the originating
- * `ContentScriptAsset` and are merged via `materializeContentScriptAsset()` on lookup.
- */
-export interface DevBrowserScriptCacheEntry {
-    filepath: string;
-    builtAt: number;
-}
-export interface DevBrowserScriptCacheManifest {
-    invalidationVersion: string;
-    buildInputsFingerprint: string;
-    entries: Record<string, DevBrowserScriptCacheEntry>;
-}
-/** Returns whether dev-only cross-request content-script bundle cache is active. */
-export declare function shouldUseDevBrowserScriptCache(): boolean;
-/** Looks up one persisted dev content-script output path by dependency cache key. */
-export declare function getDevBrowserScriptCacheEntry(appConfig: EcoPagesAppConfig, depKey: string): DevBrowserScriptCacheHit | null;
-/** Persists one dev content-script bundle output for cross-request reuse. */
-export declare function setDevBrowserScriptCacheEntry(appConfig: EcoPagesAppConfig, depKey: string, asset: ProcessedAsset): void;

package/src/build/cache/dev-browser-script-cache.js

@@ -1,90 +0,0 @@
-import path from "node:path";
-import { fileSystem } from "@ecopages/file-system";
-import { getAppBrowserBuildPlugins } from "../build-adapter.js";
-import { createBuildInputsFingerprint, hashAppConfigFile } from "./build-input-fingerprint.js";
-import {
-  readProductionCacheManifest,
-  writeProductionCacheManifest,
-  isProductionCacheManifestCurrent,
-  matchesProductionCacheFingerprint
-} from "./production-build-cache.js";
-import { getCorePackageVersion } from "./cache-keys.js";
-import { resolveInternalExecutionDir } from "../../utils/resolve-work-dir.js";
-import { isDevelopmentRuntime } from "../../utils/runtime.js";
-const DEV_BROWSER_SCRIPT_CACHE_DIR = ".browser-script-bundles";
-const DEV_BROWSER_SCRIPT_CACHE_FILENAME = ".build-cache.json";
-function getDevBrowserScriptCacheDir(appConfig) {
-  return path.join(resolveInternalExecutionDir(appConfig), DEV_BROWSER_SCRIPT_CACHE_DIR);
-}
-function getDevBrowserScriptCacheManifestPath(appConfig) {
-  return path.join(getDevBrowserScriptCacheDir(appConfig), DEV_BROWSER_SCRIPT_CACHE_FILENAME);
-}
-function createBrowserBuildKey(appConfig) {
-  try {
-    const pluginNames = getAppBrowserBuildPlugins(appConfig).map((plugin) => plugin.name).sort().join("|");
-    return pluginNames || "default";
-  } catch {
-    return "default";
-  }
-}
-function createDevBrowserScriptCacheInvalidationVersion(appConfig) {
-  return [getCorePackageVersion(), hashAppConfigFile(appConfig), createBrowserBuildKey(appConfig)].join("::");
-}
-function readManifest(appConfig) {
-  const manifest = readProductionCacheManifest(
-    getDevBrowserScriptCacheManifestPath(appConfig)
-  );
-  if (!manifest) {
-    return void 0;
-  }
-  const invalidationVersion = createDevBrowserScriptCacheInvalidationVersion(appConfig);
-  const buildInputsFingerprint = createBuildInputsFingerprint(appConfig);
-  if (!isProductionCacheManifestCurrent(manifest, invalidationVersion) || !matchesProductionCacheFingerprint(manifest, buildInputsFingerprint)) {
-    return void 0;
-  }
-  return manifest;
-}
-function writeManifest(appConfig, manifest) {
-  writeProductionCacheManifest(getDevBrowserScriptCacheManifestPath(appConfig), manifest);
-}
-function shouldUseDevBrowserScriptCache() {
-  return isDevelopmentRuntime();
-}
-function getDevBrowserScriptCacheEntry(appConfig, depKey) {
-  if (!shouldUseDevBrowserScriptCache()) {
-    return null;
-  }
-  const manifest = readManifest(appConfig);
-  const entry = manifest?.entries[depKey];
-  if (!entry?.filepath || !fileSystem.exists(entry.filepath)) {
-    return null;
-  }
-  return { filepath: entry.filepath };
-}
-function setDevBrowserScriptCacheEntry(appConfig, depKey, asset) {
-  if (!shouldUseDevBrowserScriptCache() || !asset.filepath) {
-    return;
-  }
-  const invalidationVersion = createDevBrowserScriptCacheInvalidationVersion(appConfig);
-  const buildInputsFingerprint = createBuildInputsFingerprint(appConfig);
-  const existing = readManifest(appConfig);
-  const manifest = existing ?? {
-    invalidationVersion,
-    buildInputsFingerprint,
-    entries: {}
-  };
-  manifest.invalidationVersion = invalidationVersion;
-  manifest.buildInputsFingerprint = buildInputsFingerprint;
-  manifest.entries[depKey] = {
-    filepath: asset.filepath,
-    builtAt: Date.now()
-  };
-  writeManifest(appConfig, manifest);
-}
-export {
-  DEV_BROWSER_SCRIPT_CACHE_DIR,
-  DEV_BROWSER_SCRIPT_CACHE_FILENAME,
-  getDevBrowserScriptCacheEntry,
-  setDevBrowserScriptCacheEntry,
-  shouldUseDevBrowserScriptCache
-};