@ecopages/core 0.2.0-beta.22 → 0.2.0-beta.24

package/src/plugins/processor.js

@@ -155,5 +155,6 @@ class Processor {
 export {
   PROCESSOR_ERRORS,
   Processor,
-  mergeProcessorOptions
+  mergeProcessorOptions,
+  resolveGeneratedPath
 };

package/src/route-renderer/orchestration/page-browser-graph.service.js

@@ -103,6 +103,9 @@ class PageBrowserGraphService {
         );
         continue;
       }
+      if (this.isHmrEnabled()) {
+        continue;
+      }
       if (!contribution?.dependencies?.length) {
         continue;
       }
@@ -130,15 +133,18 @@ class PageBrowserGraphService {
     );
     const groupedAssetsByRoute = /* @__PURE__ */ new Map();
     for (const [routeFile, groupedAssetKeys] of groupedAssetKeysByRoute) {
-      groupedAssetsByRoute.set(
-        routeFile,
-        processedGroupedDependencies.filter((asset) => {
-          if (!asset.groupedBundle) {
-            return false;
-          }
-          return groupedAssetKeys.has(getGroupedBundleAssetKey(asset.groupedBundle));
-        })
-      );
+      const matchedAssets = processedGroupedDependencies.filter((asset) => {
+        if (!asset.groupedBundle) {
+          return false;
+        }
+        return groupedAssetKeys.has(getGroupedBundleAssetKey(asset.groupedBundle));
+      });
+      if (groupedAssetKeys.size > 0 && matchedAssets.length === 0) {
+        appLogger.warn(
+          `Grouped page-browser assets for ${routeFile} are missing groupedBundle metadata after processing. Hydration scripts may be omitted from HTML.`
+        );
+      }
+      groupedAssetsByRoute.set(routeFile, matchedAssets);
     }
     return {
       assetsByRoute: groupedAssetsByRoute,

package/src/route-renderer/page-loading/ecopages-virtual-imports.d.ts

@@ -2,6 +2,12 @@ export type EcopagesVirtualImport = {
     from: string;
     imports: string[] | undefined;
 };
+/**
+ * @remarks
+ * Content server modules static-import every MDX entry. They must never become
+ * browser module-script dependencies discovered from page or component sources.
+ */
+export declare function isBrowserEcopagesVirtualImport(specifier: string): boolean;
 /**
  * Extracts runtime `ecopages:` virtual-module imports from a component source file.
  *

package/src/route-renderer/page-loading/ecopages-virtual-imports.js

@@ -1,5 +1,9 @@
 import { readFileSync } from "node:fs";
 import { parseSync } from "oxc-parser";
+const CONTENT_SERVER_VIRTUAL_MODULE_PATTERN = /^ecopages:content\/[a-z][a-z0-9-]+\/server$/;
+function isBrowserEcopagesVirtualImport(specifier) {
+  return specifier.startsWith("ecopages:") && !CONTENT_SERVER_VIRTUAL_MODULE_PATTERN.test(specifier);
+}
 function extractEcopagesVirtualImports(file) {
   let source;
   try {
@@ -18,7 +22,7 @@ function extractEcopagesVirtualImports(file) {
     if (node.type !== "ImportDeclaration") continue;
     if (node.importKind === "type") continue;
     const specifier = node.source?.value ?? "";
-    if (!specifier.startsWith("ecopages:")) continue;
+    if (!isBrowserEcopagesVirtualImport(specifier)) continue;
     if (found.get(specifier) === null) {
       continue;
     }
@@ -53,5 +57,6 @@ function extractEcopagesVirtualImports(file) {
   }));
 }
 export {
-  extractEcopagesVirtualImports
+  extractEcopagesVirtualImports,
+  isBrowserEcopagesVirtualImport
 };

package/src/route-renderer/page-loading/module-declaration-aggregation.js

@@ -1,4 +1,5 @@
 import { normalizeModuleDeclarations } from "../../eco/module-dependencies.js";
+import { isBrowserEcopagesVirtualImport } from "./ecopages-virtual-imports.js";
 function getDeclaredModules(value) {
   if (!Array.isArray(value)) {
     return void 0;
@@ -22,6 +23,9 @@ function mergeModuleDeclaration(modulesMap, declaration) {
 }
 function collectModuleDeclarations(modulesMap, declaredModules, autoVirtualImports) {
   for (const declaration of normalizeModuleDeclarations(getDeclaredModules(declaredModules))) {
+    if (declaration.from.startsWith("ecopages:") && !isBrowserEcopagesVirtualImport(declaration.from)) {
+      continue;
+    }
     mergeModuleDeclaration(modulesMap, declaration);
   }
   for (const declaration of autoVirtualImports) {

package/src/services/assets/asset-processing-service/asset-processing.service.d.ts

@@ -42,6 +42,7 @@ export declare class AssetProcessingService {
      * entries.
      */
     processDependencies(deps: AssetDefinition[], key: string): Promise<ProcessedAsset[]>;
+    private prepareDependenciesForProcessing;
     /**
      * Processes deduplicated dependencies grouped by processor type.
      *
@@ -80,6 +81,8 @@ export declare class AssetProcessingService {
      * Returns the cached processed asset for a dependency key when available.
      */
     private getCachedAsset;
+    private getCachedContentScriptAsset;
+    private resolveCachedContentScriptFilepath;
     /**
      * Stores one processed asset in the dependency cache.
      */

package/src/services/assets/asset-processing-service/asset-processing.service.js

@@ -4,12 +4,19 @@ import { appLogger } from "../../../global/app-logger.js";
 import { fileSystem } from "@ecopages/file-system";
 import { deduplicateAssetDependencies, getAssetDependencyKey } from "./asset-dependency-keys.js";
 import {
+  ensureGroupedContentScriptsBundle,
   partitionGroupedContentScriptDependencies,
   processGroupedDependencyBundles
 } from "./grouped-content-bundles.js";
+import { resolveIntegrationPluginForProcessingKey } from "./resolve-integration-plugin.js";
 import { isHmrAware } from "./processor.interface.js";
 import { ProcessorRegistry } from "./processor.registry.js";
 import { processUngroupedDependency } from "./ungrouped-dependency-processing.js";
+import { materializeContentScriptAsset } from "./materialize-content-script-asset.js";
+import {
+  getDevBrowserScriptCacheEntry,
+  setDevBrowserScriptCacheEntry
+} from "../../../build/dev-browser-script-cache.js";
 import {
   ContentScriptProcessor,
   ContentStylesheetProcessor,
@@ -68,10 +75,16 @@ class AssetProcessingService {
     const depsDir = path.join(this.config.absolutePaths.distDir, RESOLVED_ASSETS_DIR);
     fileSystem.ensureDir(depsDir);
     const dedupedDeps = deduplicateAssetDependencies(deps);
-    const results = await this.processDependenciesParallel(dedupedDeps, key);
+    const preparedDeps = this.prepareDependenciesForProcessing(dedupedDeps, key);
+    ensureGroupedContentScriptsBundle(preparedDeps);
+    const results = await this.processDependenciesParallel(preparedDeps);
     await this.optimizeDependencies(results);
     return results;
   }
+  prepareDependenciesForProcessing(deps, processingKey) {
+    const plugin = resolveIntegrationPluginForProcessingKey(this.config, processingKey);
+    return plugin?.prepareAssetDependencies?.(deps) ?? deps;
+  }
   /**
    * Processes deduplicated dependencies grouped by processor type.
    *
@@ -80,14 +93,13 @@ class AssetProcessingService {
    * pair, while still allowing the overall dependency set to resolve in
    * parallel.
    */
-  async processDependenciesParallel(deps, key) {
+  async processDependenciesParallel(deps) {
     const grouped = this.groupDependenciesByType(deps);
     const groupPromises = Object.entries(grouped).map(async ([, typeDeps]) => {
       const { groupedBundleDeps, ungroupedDeps } = partitionGroupedContentScriptDependencies(typeDeps);
       const typePromises = ungroupedDeps.map(
         (dep) => processUngroupedDependency({
           dep,
-          key,
           depKey: getAssetDependencyKey(dep),
           getCachedAsset: (assetDep, depKey) => this.getCachedAsset(assetDep, depKey),
           getProcessor: (assetDep) => this.registry.getProcessor(assetDep.kind, assetDep.source),
@@ -109,7 +121,6 @@ class AssetProcessingService {
       );
       const groupedResults = await processGroupedDependencyBundles({
         bundles: Array.from(groupedBundleDeps.values()),
-        key,
         getCachedAsset: (dep, depKey) => this.getCachedAsset(dep, depKey),
         getDependencyKey: getAssetDependencyKey,
         getGroupedProcessor: () => this.registry.getProcessor("script", "content"),
@@ -229,6 +240,9 @@ class AssetProcessingService {
     if (process.env.NODE_ENV !== "production" && dep.source === "file" && dep.kind === "stylesheet") {
       return null;
     }
+    if (dep.kind === "script" && dep.source === "content") {
+      return this.getCachedContentScriptAsset(dep, depKey);
+    }
     const cached = this.cache.get(depKey);
     if (!cached) {
       return null;
@@ -239,11 +253,34 @@ class AssetProcessingService {
     }
     return cached.asset;
   }
+  getCachedContentScriptAsset(dep, depKey) {
+    const filepath = this.resolveCachedContentScriptFilepath(depKey) ?? getDevBrowserScriptCacheEntry(this.config, depKey)?.filepath;
+    if (!filepath) {
+      return null;
+    }
+    const materialized = materializeContentScriptAsset(dep, filepath);
+    this.cache.set(depKey, { asset: materialized });
+    return materialized;
+  }
+  resolveCachedContentScriptFilepath(depKey) {
+    const cached = this.cache.get(depKey);
+    if (!cached?.asset.filepath) {
+      return void 0;
+    }
+    if (!fileSystem.exists(cached.asset.filepath)) {
+      this.cache.delete(depKey);
+      return void 0;
+    }
+    return cached.asset.filepath;
+  }
   /**
    * Stores one processed asset in the dependency cache.
    */
   setCachedAsset(dep, depKey, asset) {
     this.cache.set(depKey, { asset });
+    if (dep.kind === "script" && dep.source === "content") {
+      setDevBrowserScriptCacheEntry(this.config, depKey, asset);
+    }
   }
   /**
    * Clears all cached processed assets.

package/src/services/assets/asset-processing-service/finalize-processed-asset.d.ts

@@ -0,0 +1,3 @@
+import type { ProcessedAsset } from './assets.types.js';
+/** Applies the public source URL to one processed asset when available. */
+export declare function finalizeProcessedAsset(processed: ProcessedAsset, resolveProcessedAssetSrcUrl: (processed: ProcessedAsset) => string | undefined): ProcessedAsset;

package/src/services/assets/asset-processing-service/finalize-processed-asset.js

@@ -0,0 +1,7 @@
+function finalizeProcessedAsset(processed, resolveProcessedAssetSrcUrl) {
+  const srcUrl = resolveProcessedAssetSrcUrl(processed);
+  return srcUrl ? { ...processed, srcUrl } : processed;
+}
+export {
+  finalizeProcessedAsset
+};

package/src/services/assets/asset-processing-service/grouped-content-bundles.d.ts

@@ -1,4 +1,6 @@
 import type { AssetDefinition, ProcessedAsset } from './assets.types.js';
+/** Forces grouped content scripts to run through the bundler in production builds. */
+export declare function ensureGroupedContentScriptsBundle(dependencies: AssetDefinition[]): void;
 /**
  * Splits grouped content-script dependencies from ordinary dependencies so callers can
  * route them through `processGrouped` without changing ordering for the remaining assets.
@@ -12,7 +14,6 @@ type GroupedBundleProcessor = {
 };
 type ProcessGroupedDependencyBundlesOptions = {
     bundles: AssetDefinition[][];
-    key: string;
     getCachedAsset: (dep: AssetDefinition, depKey: string) => ProcessedAsset | null;
     getDependencyKey: (dep: AssetDefinition) => string;
     getGroupedProcessor: () => GroupedBundleProcessor | undefined;

package/src/services/assets/asset-processing-service/grouped-content-bundles.js

@@ -1,3 +1,18 @@
+import { isDevelopmentRuntime } from "../../../utils/runtime.js";
+import { finalizeProcessedAsset } from "./finalize-processed-asset.js";
+function ensureGroupedContentScriptsBundle(dependencies) {
+  if (isDevelopmentRuntime()) {
+    return;
+  }
+  for (const dependency of dependencies) {
+    if (dependency.kind !== "script" || dependency.source !== "content" || !dependency.groupedBundle?.id) {
+      continue;
+    }
+    if (dependency.bundle === false) {
+      dependency.bundle = true;
+    }
+  }
+}
 function partitionGroupedContentScriptDependencies(typeDeps) {
   const groupedBundleDeps = /* @__PURE__ */ new Map();
   const ungroupedDeps = [];
@@ -18,7 +33,6 @@ function partitionGroupedContentScriptDependencies(typeDeps) {
 async function processGroupedDependencyBundles(options) {
   const {
     bundles,
-    key,
     getCachedAsset,
     getDependencyKey,
     getGroupedProcessor,
@@ -29,7 +43,7 @@ async function processGroupedDependencyBundles(options) {
   const groupedPromises = bundles.map(async (bundleDeps) => {
     const cachedResults = bundleDeps.map((dep) => {
       const cached = getCachedAsset(dep, getDependencyKey(dep));
-      return cached ? { key, ...cached } : null;
+      return cached ? finalizeProcessedAsset(cached, resolveProcessedAssetSrcUrl) : null;
     });
     if (cachedResults.every((result) => result !== null)) {
       return cachedResults.filter((result) => result !== null);
@@ -43,14 +57,9 @@ async function processGroupedDependencyBundles(options) {
       return processedResults.map((processed, index) => {
         const dep = bundleDeps[index];
         const depKey = getDependencyKey(dep);
-        const srcUrl = resolveProcessedAssetSrcUrl(processed);
-        const processedWithKey = {
-          key,
-          ...processed,
-          srcUrl
-        };
-        setCachedAsset(dep, depKey, processedWithKey);
-        return processedWithKey;
+        const finalized = finalizeProcessedAsset(processed, resolveProcessedAssetSrcUrl);
+        setCachedAsset(dep, depKey, finalized);
+        return finalized;
       });
     } catch (error) {
       logError(error);
@@ -60,6 +69,7 @@ async function processGroupedDependencyBundles(options) {
   return (await Promise.all(groupedPromises)).flat();
 }
 export {
+  ensureGroupedContentScriptsBundle,
   partitionGroupedContentScriptDependencies,
   processGroupedDependencyBundles
 };

package/src/services/assets/asset-processing-service/index.d.ts

@@ -1,4 +1,5 @@
 export * from './asset.factory.js';
+export * from './grouped-content-bundles.js';
 export * from './page-package.js';
 export * from './asset-processing.service.js';
 export * from './assets.types.js';

package/src/services/assets/asset-processing-service/index.js

@@ -1,4 +1,5 @@
 export * from "./asset.factory.js";
+export * from "./grouped-content-bundles.js";
 export * from "./page-package.js";
 export * from "./asset-processing.service.js";
 export * from "./assets.types.js";

package/src/services/assets/asset-processing-service/materialize-content-script-asset.d.ts

@@ -0,0 +1,11 @@
+import type { ContentScriptAsset, ProcessedAsset } from './assets.types.js';
+/**
+ * Builds a processed content-script asset from one dependency declaration and a
+ * previously emitted output file.
+ *
+ * @remarks
+ * Dev disk cache entries store only output paths. Callers must materialize the
+ * full processed asset from the originating dependency so HTML and page-browser
+ * graph assembly receive grouped-bundle metadata and script attributes.
+ */
+export declare function materializeContentScriptAsset(dep: ContentScriptAsset, filepath: string): ProcessedAsset;

package/src/services/assets/asset-processing-service/materialize-content-script-asset.js

@@ -0,0 +1,17 @@
+function materializeContentScriptAsset(dep, filepath) {
+  return {
+    filepath,
+    kind: "script",
+    inline: dep.inline ?? false,
+    content: dep.inline ? dep.content : void 0,
+    position: dep.position,
+    attributes: dep.attributes,
+    excludeFromHtml: dep.excludeFromHtml,
+    packageRole: dep.packageRole,
+    groupedBundle: dep.groupedBundle,
+    bundledSourceFilepaths: dep.bundledSourceFilepaths
+  };
+}
+export {
+  materializeContentScriptAsset
+};

package/src/services/assets/asset-processing-service/processors/script/content-script.processor.d.ts

@@ -1,6 +1,13 @@
 import type { ContentScriptAsset, ProcessedAsset } from '../../assets.types.js';
 import { BaseScriptProcessor } from '../base/base-script-processor.js';
 export declare class ContentScriptProcessor extends BaseScriptProcessor<ContentScriptAsset> {
+    private getContentScriptEntryDir;
+    private getContentScriptEntryPath;
+    private createBundleConfigHash;
+    private createContentScriptCacheKey;
+    private toProcessedAsset;
+    private removeContentScriptEntry;
     processGrouped(deps: ContentScriptAsset[]): Promise<ProcessedAsset[]>;
+    private getGroupedBundlerOptions;
     process(dep: ContentScriptAsset): Promise<ProcessedAsset>;
 }

package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js

@@ -1,7 +1,50 @@
 import path from "node:path";
 import { fileSystem } from "@ecopages/file-system";
+import { shouldUseDevBrowserScriptCache } from "../../../../../build/dev-browser-script-cache.js";
 import { BaseScriptProcessor } from "../base/base-script-processor.js";
 class ContentScriptProcessor extends BaseScriptProcessor {
+  getContentScriptEntryDir() {
+    const dir = path.join(this.appConfig.absolutePaths.workDir, "content-script-entries");
+    fileSystem.ensureDir(dir);
+    return dir;
+  }
+  getContentScriptEntryPath(contentHash) {
+    return path.join(this.getContentScriptEntryDir(), `${contentHash}.js`);
+  }
+  createBundleConfigHash(dep, shouldBundle) {
+    return this.generateHash(
+      JSON.stringify({
+        bundle: shouldBundle,
+        minify: shouldBundle && this.isProduction,
+        opts: dep.bundleOptions
+      })
+    );
+  }
+  createContentScriptCacheKey(dep, shouldBundle) {
+    const contentHash = this.generateHash(dep.content);
+    const configHash = this.createBundleConfigHash(dep, shouldBundle);
+    return `${this.buildCacheKey(`content-script:${contentHash}`, contentHash, dep)}:${configHash}`;
+  }
+  toProcessedAsset(dep, filepath, inlineContent) {
+    return {
+      filepath,
+      content: dep.inline ? inlineContent : void 0,
+      kind: "script",
+      position: dep.position,
+      attributes: dep.attributes,
+      inline: dep.inline,
+      excludeFromHtml: dep.excludeFromHtml,
+      packageRole: dep.packageRole,
+      groupedBundle: dep.groupedBundle,
+      bundledSourceFilepaths: dep.bundledSourceFilepaths
+    };
+  }
+  removeContentScriptEntry(contentHash) {
+    if (shouldUseDevBrowserScriptCache()) {
+      return;
+    }
+    fileSystem.remove(this.getContentScriptEntryPath(contentHash));
+  }
   async processGrouped(deps) {
     if (deps.length === 0) {
       return [];
@@ -10,109 +53,92 @@ class ContentScriptProcessor extends BaseScriptProcessor {
     if (!shouldBundle || deps.some((dep) => dep.inline)) {
       return Promise.all(deps.map((dep) => this.process(dep)));
     }
-    const tempDir = path.join(
-      this.appConfig.absolutePaths.distDir,
-      `grouped-script-entries-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}`
-    );
-    fileSystem.ensureDir(tempDir);
+    let tempEntries = [];
     try {
-      const tempEntries = deps.map((dep, index) => {
-        const entryName = dep.groupedBundle?.entryName ?? dep.name ?? `grouped-script-${index}`;
-        const tempFilepath = path.join(tempDir, `${entryName}.js`);
+      tempEntries = deps.map((dep) => {
+        const contentHash = this.generateHash(dep.content);
+        const tempFilepath = this.getContentScriptEntryPath(contentHash);
         fileSystem.write(tempFilepath, dep.content);
         return {
           dep,
-          entryName,
+          contentHash,
           tempFilepath
         };
       });
-      const primaryDep = deps[0];
       const outputPaths = await this.bundleScripts({
-        ...this.getBundlerOptions(primaryDep),
-        entries: tempEntries.map(({ entryName, tempFilepath }) => ({
-          entryName,
+        ...this.getGroupedBundlerOptions(deps),
+        entries: tempEntries.map(({ dep, contentHash, tempFilepath }) => ({
+          entryName: dep.groupedBundle?.entryName ?? dep.name ?? contentHash,
           entrypoint: tempFilepath
         })),
         outdir: this.getAssetsDir(),
         minify: this.isProduction,
         naming: "[name]-[hash].[ext]"
       });
-      return tempEntries.map(({ dep, entryName }) => {
+      return tempEntries.map(({ dep, contentHash }) => {
+        const entryName = dep.groupedBundle?.entryName ?? dep.name ?? contentHash;
         const bundledFilePath = outputPaths.get(entryName);
         if (!bundledFilePath) {
           throw new Error(`Missing grouped bundle output for ${entryName}`);
         }
-        return {
-          filepath: bundledFilePath,
-          content: dep.inline ? fileSystem.readFileSync(bundledFilePath).toString() : void 0,
-          kind: "script",
-          position: dep.position,
-          attributes: dep.attributes,
-          inline: dep.inline,
-          excludeFromHtml: dep.excludeFromHtml,
-          packageRole: dep.packageRole,
-          groupedBundle: dep.groupedBundle,
-          bundledSourceFilepaths: dep.bundledSourceFilepaths
-        };
+        return this.toProcessedAsset(
+          dep,
+          bundledFilePath,
+          dep.inline ? fileSystem.readFileSync(bundledFilePath).toString() : void 0
+        );
       });
     } finally {
-      fileSystem.remove(tempDir);
+      for (const { contentHash } of tempEntries) {
+        this.removeContentScriptEntry(contentHash);
+      }
     }
   }
-  async process(dep) {
-    const hash = this.generateHash(dep.content);
-    const filename = dep.name ? `${dep.name}.js` : `script-${hash}.js`;
-    const shouldBundle = this.shouldBundle(dep);
-    const filepath = path.join(this.getAssetsDir(), "scripts", filename);
-    if (!shouldBundle) {
-      if (!dep.inline) fileSystem.write(filepath, dep.content);
-      const unbundledProcessedAsset = {
-        filepath,
-        content: dep.inline ? dep.content : void 0,
-        kind: "script",
-        position: dep.position,
-        attributes: dep.attributes,
-        inline: dep.inline,
-        excludeFromHtml: dep.excludeFromHtml,
-        packageRole: dep.packageRole,
-        groupedBundle: dep.groupedBundle,
-        bundledSourceFilepaths: dep.bundledSourceFilepaths
-      };
-      this.writeCacheFile(filename, unbundledProcessedAsset);
-      return unbundledProcessedAsset;
-    }
-    if (dep.content) {
-      const tempDir = this.appConfig.absolutePaths.distDir;
-      fileSystem.ensureDir(tempDir);
-      const tempFileName = path.join(
-        tempDir,
-        `${path.parse(filename).name}.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2)}.tmp.js`
-      );
-      fileSystem.write(tempFileName, dep.content);
-      const bundledFilePath = await this.bundleScript({
-        entrypoint: tempFileName,
-        outdir: this.getAssetsDir(),
-        minify: this.isProduction,
-        naming: `${path.parse(filename).name}-[hash].[ext]`,
-        ...this.getBundlerOptions(dep)
-      });
-      const processedAsset = {
-        filepath: bundledFilePath,
-        content: dep.inline ? fileSystem.readFileSync(bundledFilePath).toString() : void 0,
-        kind: "script",
-        position: dep.position,
-        attributes: dep.attributes,
-        inline: dep.inline,
-        excludeFromHtml: dep.excludeFromHtml,
-        packageRole: dep.packageRole,
-        groupedBundle: dep.groupedBundle,
-        bundledSourceFilepaths: dep.bundledSourceFilepaths
+  getGroupedBundlerOptions(deps) {
+    const primaryDep = deps[0];
+    const options = this.getBundlerOptions(primaryDep);
+    if (deps.some((dep) => dep.bundleOptions?.splitting === false)) {
+      return {
+        ...options,
+        splitting: false
       };
-      fileSystem.remove(tempFileName);
-      this.writeCacheFile(filename, processedAsset);
-      return processedAsset;
     }
-    throw new Error("No content found for script asset");
+    return options;
+  }
+  async process(dep) {
+    const shouldBundle = this.shouldBundle(dep);
+    const cacheKey = this.createContentScriptCacheKey(dep, shouldBundle);
+    return this.getOrProcess(cacheKey, async () => {
+      const hash = this.generateHash(dep.content);
+      const filename = dep.name ? `${dep.name}.js` : `script-${hash}.js`;
+      const filepath = path.join(this.getAssetsDir(), "scripts", filename);
+      if (!shouldBundle) {
+        if (!dep.inline) {
+          fileSystem.write(filepath, dep.content);
+        }
+        return this.toProcessedAsset(dep, filepath, dep.inline ? dep.content : void 0);
+      }
+      if (!dep.content) {
+        throw new Error("No content found for script asset");
+      }
+      const entryPath = this.getContentScriptEntryPath(hash);
+      fileSystem.write(entryPath, dep.content);
+      try {
+        const bundledFilePath = await this.bundleScript({
+          entrypoint: entryPath,
+          outdir: this.getAssetsDir(),
+          minify: this.isProduction,
+          naming: `${path.parse(filename).name}-[hash].[ext]`,
+          ...this.getBundlerOptions(dep)
+        });
+        return this.toProcessedAsset(
+          dep,
+          bundledFilePath,
+          dep.inline ? fileSystem.readFileSync(bundledFilePath).toString() : void 0
+        );
+      } finally {
+        this.removeContentScriptEntry(hash);
+      }
+    });
   }
 }
 export {

package/src/services/assets/asset-processing-service/resolve-integration-plugin.d.ts

@@ -0,0 +1,4 @@
+import type { AnyIntegrationPlugin } from '../../../plugins/integration-plugin.js';
+import type { EcoPagesAppConfig } from '../../../types/internal-types.js';
+/** Resolves the integration plugin that owns one asset-processing batch key. */
+export declare function resolveIntegrationPluginForProcessingKey(appConfig: EcoPagesAppConfig, processingKey: string): AnyIntegrationPlugin | undefined;

package/src/services/assets/asset-processing-service/resolve-integration-plugin.js

@@ -0,0 +1,17 @@
+function resolveIntegrationPluginForProcessingKey(appConfig, processingKey) {
+  if (!appConfig.integrations?.length) {
+    return void 0;
+  }
+  const exactMatch = appConfig.integrations.find((integration) => integration.name === processingKey);
+  if (exactMatch) {
+    return exactMatch;
+  }
+  const baseName = processingKey.split(":")[0];
+  if (!baseName || baseName === processingKey) {
+    return void 0;
+  }
+  return appConfig.integrations.find((integration) => integration.name === baseName);
+}
+export {
+  resolveIntegrationPluginForProcessingKey
+};

package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.d.ts

@@ -2,7 +2,6 @@ import type { AssetProcessor } from './processor.interface.js';
 import type { AssetDefinition, ProcessedAsset } from './assets.types.js';
 type ProcessUngroupedDependencyOptions = {
     dep: AssetDefinition;
-    key: string;
     depKey: string;
     getCachedAsset: (dep: AssetDefinition, depKey: string) => ProcessedAsset | null;
     getProcessor: (dep: AssetDefinition) => AssetProcessor | undefined;