@ecopages/core 0.2.0-alpha.1

package/src/route-renderer/dependency-resolver.js

@@ -0,0 +1,428 @@
+import path from "node:path";
+import { readFileSync } from "node:fs";
+import { rapidhash } from "../utils/hash.js";
+import { AssetFactory } from "../services/asset-processing-service/index.js";
+import { normalizeModuleDeclarations } from "../eco/module-dependencies.js";
+import { parseSync } from "oxc-parser";
+const DEPENDENCY_ERRORS = {
+  INVALID_STYLESHEET_ENTRY: "Invalid stylesheet dependency entry: expected src or content",
+  INVALID_SCRIPT_ENTRY: "Invalid script dependency entry: expected src or content",
+  LAZY_SCRIPT_MISSING_SRC: "Lazy script dependency entry in dependencies.scripts requires a src value"
+};
+function extractEcopagesVirtualImports(file) {
+  let source;
+  try {
+    source = readFileSync(file, "utf-8");
+  } catch {
+    return [];
+  }
+  let result;
+  try {
+    result = parseSync(file, source, { sourceType: "module" });
+  } catch {
+    return [];
+  }
+  const found = /* @__PURE__ */ new Map();
+  for (const node of result.program.body ?? []) {
+    if (node.type !== "ImportDeclaration") continue;
+    if (node.importKind === "type") continue;
+    const specifier = node.source?.value ?? "";
+    if (!specifier.startsWith("ecopages:")) continue;
+    if (found.get(specifier) === null) {
+      continue;
+    }
+    const namedImports = [];
+    for (const spec of node.specifiers ?? []) {
+      if (spec.type === "ImportSpecifier") {
+        const importedName = spec.imported?.type === "Identifier" ? spec.imported.name : spec.imported?.type === "Literal" ? spec.imported.value : spec.local?.name;
+        namedImports.push(importedName);
+      }
+    }
+    if (namedImports.length === 0) {
+      found.set(specifier, null);
+      continue;
+    }
+    const existing = found.get(specifier);
+    if (!existing) {
+      found.set(specifier, new Set(namedImports));
+      continue;
+    }
+    for (const imported of namedImports) {
+      existing.add(imported);
+    }
+  }
+  return Array.from(found.entries()).map(([from, importsSet]) => ({
+    from,
+    imports: importsSet ? Array.from(importsSet) : void 0
+  }));
+}
+function createModuleScriptName(from, imports) {
+  const normalizedImports = imports ? [...imports].sort().join(",") : "*";
+  const hash = rapidhash(`${from}|${normalizedImports}`).toString(16);
+  return `module-${hash}`;
+}
+function createNamedImportModuleSource(from, imports) {
+  const namedImports = imports.join(", ");
+  return `export { ${namedImports} } from '${from}';`;
+}
+function createNamespaceImportModuleSource(from) {
+  return `export * from '${from}';`;
+}
+function resolveDependencyPath(componentDir, pathUrl) {
+  return path.join(componentDir, pathUrl);
+}
+function isDependencyEntryObject(entry) {
+  return typeof entry === "object" && entry !== null;
+}
+function getDependencyEntrySrc(entry) {
+  return isDependencyEntryObject(entry) ? entry.src : entry;
+}
+function getDependencyEntryContent(entry) {
+  return isDependencyEntryObject(entry) ? entry.content : void 0;
+}
+function getDependencyEntryAttributes(entry) {
+  return isDependencyEntryObject(entry) ? entry.attributes : void 0;
+}
+function getDependencyEntrySrcOrThrow(entry, errorMessage) {
+  const src = getDependencyEntrySrc(entry);
+  if (!src) {
+    throw new Error(errorMessage);
+  }
+  return src;
+}
+function getLazyTriggerKey(lazy) {
+  if ("on:idle" in lazy) {
+    return "on:idle";
+  }
+  if ("on:interaction" in lazy) {
+    return `on:interaction:${lazy["on:interaction"]}`;
+  }
+  if ("on:visible" in lazy) {
+    const value = lazy["on:visible"];
+    return `on:visible:${value === true ? "true" : value}`;
+  }
+  return JSON.stringify(lazy);
+}
+function resolveLazyScripts(appConfig, componentDir, scripts) {
+  const getSafeFileName = (filepath) => {
+    const EXTENSIONS_TO_JS = ["ts", "tsx"];
+    const safe = filepath.replace(new RegExp(`\\.(${EXTENSIONS_TO_JS.join("|")})$`), ".js");
+    return safe.startsWith("./") ? safe.slice(2) : safe;
+  };
+  const baseDir = componentDir.split(appConfig.srcDir)[1] ?? "";
+  const resolvedPaths = scripts.map((script) => {
+    const relativePath = [AssetFactory.RESOLVED_ASSETS_DIR, baseDir, getSafeFileName(script)].filter(Boolean).join("/").replace(/\/+/g, "/");
+    return `/${relativePath.replace(/^\/+/, "")}`;
+  });
+  return resolvedPaths.join(",");
+}
+function buildResolvedLazyTriggers(config, groups) {
+  if (groups.length === 0) return [];
+  const componentFile = config.__eco?.file ?? "";
+  const sortedUrls = groups.flatMap((group) => group.scripts).sort().join(",");
+  const triggerId = `eco-trigger-${rapidhash(`${componentFile}:${sortedUrls}`).toString(16)}`;
+  const rules = groups.map((group) => {
+    const { scripts, lazy } = group;
+    if ("on:idle" in lazy) {
+      return { "on:idle": { scripts } };
+    }
+    if ("on:interaction" in lazy) {
+      return { "on:interaction": { value: lazy["on:interaction"], scripts } };
+    }
+    if ("on:visible" in lazy) {
+      const visibleSelector = lazy["on:visible"];
+      if (visibleSelector === true) return { "on:visible": { scripts } };
+      return { "on:visible": { value: String(visibleSelector), scripts } };
+    }
+    throw new Error(`Unknown lazy trigger kind: ${JSON.stringify(lazy)}`);
+  });
+  return [{ triggerId, rules }];
+}
+class DependencyResolverService {
+  constructor(appConfig, assetProcessingService) {
+    this.appConfig = appConfig;
+    this.assetProcessingService = assetProcessingService;
+  }
+  resolveDependencyPath(componentDir, pathUrl) {
+    return resolveDependencyPath(componentDir, pathUrl);
+  }
+  /**
+   * Maps lazy script source entries to deterministic fallback public URLs
+   * used when bundling output URLs are unavailable.
+   */
+  resolveLazyScripts(componentDir, scripts) {
+    return resolveLazyScripts(this.appConfig, componentDir, scripts);
+  }
+  /**
+   * Collects and processes component dependencies (styles, scripts, modules, lazy scripts).
+   * Lazy dependencies are always resolved into global-injector trigger maps.
+   */
+  async processComponentDependencies(components, integrationName) {
+    if (!this.assetProcessingService?.processDependencies) return [];
+    const dependencies = [];
+    const lazyScriptsByConfig = /* @__PURE__ */ new Map();
+    const lazyDependencyKeys = /* @__PURE__ */ new Set();
+    for (const component of components) {
+      const componentFile = component.config?.__eco?.file;
+      if (!componentFile) continue;
+      const stylesheetDependencyKeys = /* @__PURE__ */ new Set();
+      const scriptDependencyKeys = /* @__PURE__ */ new Set();
+      const modulesMap = /* @__PURE__ */ new Map();
+      const collect = (config) => {
+        if (!config) return;
+        const file = config.__eco?.file;
+        if (!file) return;
+        const dir = path.dirname(file);
+        const dependenciesConfig = config.dependencies;
+        const registerLazyScript = ({
+          lazy,
+          lazyKey,
+          fallbackUrl
+        }) => {
+          let grouped = lazyScriptsByConfig.get(config);
+          if (!grouped) {
+            grouped = /* @__PURE__ */ new Map();
+            lazyScriptsByConfig.set(config, grouped);
+          }
+          const triggerKey = getLazyTriggerKey(lazy);
+          const existing = grouped.get(triggerKey) ?? { lazy, scripts: [] };
+          existing.scripts.push({ lazyKey, fallbackUrl });
+          grouped.set(triggerKey, existing);
+        };
+        if (dependenciesConfig?.stylesheets) {
+          for (const style of dependenciesConfig.stylesheets) {
+            const content = getDependencyEntryContent(style);
+            const src = getDependencyEntrySrc(style);
+            const attributes = getDependencyEntryAttributes(style);
+            if (content) {
+              const depKey2 = `style:content:${content}:${JSON.stringify(attributes ?? {})}`;
+              if (stylesheetDependencyKeys.has(depKey2)) {
+                continue;
+              }
+              stylesheetDependencyKeys.add(depKey2);
+              dependencies.push(
+                AssetFactory.createContentStylesheet({
+                  content,
+                  position: "head",
+                  attributes
+                })
+              );
+              continue;
+            }
+            if (!src) {
+              throw new Error(DEPENDENCY_ERRORS.INVALID_STYLESHEET_ENTRY);
+            }
+            const resolvedPath = resolveDependencyPath(dir, src);
+            const depKey = `style:file:${resolvedPath}:${JSON.stringify(attributes ?? {})}`;
+            if (stylesheetDependencyKeys.has(depKey)) {
+              continue;
+            }
+            stylesheetDependencyKeys.add(depKey);
+            dependencies.push(
+              AssetFactory.createFileStylesheet({
+                filepath: resolvedPath,
+                position: "head",
+                attributes: {
+                  rel: "stylesheet",
+                  ...attributes
+                }
+              })
+            );
+          }
+        }
+        if (dependenciesConfig?.scripts) {
+          for (const script of dependenciesConfig.scripts) {
+            if (isDependencyEntryObject(script) && script.lazy) {
+              continue;
+            }
+            const content = getDependencyEntryContent(script);
+            const src = getDependencyEntrySrc(script);
+            const attributes = getDependencyEntryAttributes(script);
+            if (content) {
+              const depKey2 = `script:content:${content}:${JSON.stringify(attributes ?? {})}`;
+              if (scriptDependencyKeys.has(depKey2)) {
+                continue;
+              }
+              scriptDependencyKeys.add(depKey2);
+              dependencies.push(
+                AssetFactory.createContentScript({
+                  position: "head",
+                  content,
+                  attributes: {
+                    type: "module",
+                    defer: "",
+                    ...attributes
+                  }
+                })
+              );
+              continue;
+            }
+            if (!src) {
+              throw new Error(DEPENDENCY_ERRORS.INVALID_SCRIPT_ENTRY);
+            }
+            const resolvedPath = resolveDependencyPath(dir, src);
+            const depKey = `script:file:${resolvedPath}:${JSON.stringify(attributes ?? {})}`;
+            if (scriptDependencyKeys.has(depKey)) {
+              continue;
+            }
+            scriptDependencyKeys.add(depKey);
+            dependencies.push(
+              AssetFactory.createFileScript({
+                filepath: resolvedPath,
+                position: "head",
+                attributes: {
+                  type: "module",
+                  defer: "",
+                  ...attributes
+                }
+              })
+            );
+          }
+        }
+        const normalizedModules = normalizeModuleDeclarations(dependenciesConfig?.modules);
+        for (const declaration of normalizedModules) {
+          const existing = modulesMap.get(declaration.from);
+          if (!declaration.imports || declaration.imports.length === 0) {
+            modulesMap.set(declaration.from, null);
+            continue;
+          }
+          if (existing === null) {
+            continue;
+          }
+          const merged = existing ?? /* @__PURE__ */ new Set();
+          for (const imported of declaration.imports) {
+            merged.add(imported);
+          }
+          modulesMap.set(declaration.from, merged);
+        }
+        for (const [index, scriptEntry] of (dependenciesConfig?.scripts ?? []).entries()) {
+          if (!isDependencyEntryObject(scriptEntry) || !scriptEntry.lazy) {
+            continue;
+          }
+          const lazy = scriptEntry.lazy;
+          const content = scriptEntry.content;
+          const src = scriptEntry.src;
+          const attributes = scriptEntry.attributes;
+          if (content) {
+            const lazyKey2 = `lazy:${rapidhash(`${file}:entry:${index}:${content}`).toString(16)}`;
+            const depKey2 = `lazy:entry:content:${getLazyTriggerKey(lazy)}:${content}:${JSON.stringify(attributes ?? {})}`;
+            if (!lazyDependencyKeys.has(depKey2)) {
+              lazyDependencyKeys.add(depKey2);
+              dependencies.push(
+                AssetFactory.createContentScript({
+                  position: "head",
+                  content,
+                  excludeFromHtml: true,
+                  attributes: {
+                    type: "module",
+                    defer: "",
+                    "data-eco-lazy-key": lazyKey2,
+                    ...attributes
+                  }
+                })
+              );
+            }
+            registerLazyScript({
+              lazy,
+              lazyKey: lazyKey2
+            });
+            continue;
+          }
+          const script = src ?? getDependencyEntrySrcOrThrow(scriptEntry, DEPENDENCY_ERRORS.LAZY_SCRIPT_MISSING_SRC);
+          const resolvedPath = this.resolveDependencyPath(dir, script);
+          const fallbackUrl = this.resolveLazyScripts(dir, [script]).split(",")[0] ?? "";
+          const lazyKey = `lazy:${rapidhash(`${resolvedPath}:${getLazyTriggerKey(lazy)}`).toString(16)}`;
+          const depKey = `lazy:entry:file:${getLazyTriggerKey(lazy)}:${resolvedPath}:${JSON.stringify(attributes ?? {})}`;
+          if (!lazyDependencyKeys.has(depKey)) {
+            lazyDependencyKeys.add(depKey);
+            dependencies.push(
+              AssetFactory.createFileScript({
+                filepath: resolvedPath,
+                position: "head",
+                excludeFromHtml: true,
+                attributes: {
+                  type: "module",
+                  defer: "",
+                  "data-eco-lazy-key": lazyKey,
+                  ...attributes
+                }
+              })
+            );
+          }
+          registerLazyScript({
+            lazy,
+            lazyKey,
+            fallbackUrl
+          });
+        }
+        if (dependenciesConfig?.components) {
+          for (const nestedComponent of dependenciesConfig.components) {
+            if (nestedComponent.config) {
+              collect(nestedComponent.config);
+            }
+          }
+        }
+        const autoVirtualImports = extractEcopagesVirtualImports(file);
+        for (const { from, imports } of autoVirtualImports) {
+          const existing = modulesMap.get(from);
+          if (!imports || imports.length === 0) {
+            if (existing !== null) modulesMap.set(from, null);
+            continue;
+          }
+          if (existing === null) continue;
+          const merged = existing ?? /* @__PURE__ */ new Set();
+          for (const imported of imports) merged.add(imported);
+          modulesMap.set(from, merged);
+        }
+      };
+      collect(component.config);
+      dependencies.push(
+        ...Array.from(modulesMap.entries()).map(([from, importsSet]) => {
+          const imports = importsSet ? Array.from(importsSet) : void 0;
+          return AssetFactory.createContentScript({
+            position: "head",
+            name: createModuleScriptName(from, imports),
+            content: imports && imports.length > 0 ? createNamedImportModuleSource(from, imports) : createNamespaceImportModuleSource(from),
+            attributes: {
+              type: "module",
+              defer: ""
+            }
+          });
+        })
+      );
+    }
+    const hasLazyDependencies = dependencies.some((dep) => dep.kind === "script" && dep.excludeFromHtml === true);
+    const processedDependencies = await this.assetProcessingService.processDependencies(
+      dependencies,
+      integrationName
+    );
+    const lazyKeyToOutputUrl = /* @__PURE__ */ new Map();
+    for (const dependency of processedDependencies) {
+      if (dependency.kind === "script" && dependency.srcUrl) {
+        const lazyKey = dependency.attributes?.["data-eco-lazy-key"];
+        if (lazyKey) {
+          lazyKeyToOutputUrl.set(lazyKey, dependency.srcUrl);
+        }
+      }
+    }
+    for (const [config, lazyGroupsMap] of lazyScriptsByConfig.entries()) {
+      const rawGroups = [];
+      for (const group of lazyGroupsMap.values()) {
+        const resolvedUrls = group.scripts.map(({ lazyKey, fallbackUrl }) => lazyKeyToOutputUrl.get(lazyKey) ?? fallbackUrl).filter((url) => Boolean(url && url.length > 0));
+        if (resolvedUrls.length === 0) {
+          continue;
+        }
+        rawGroups.push({ lazy: group.lazy, scripts: Array.from(new Set(resolvedUrls)) });
+      }
+      if (hasLazyDependencies) {
+        config._resolvedLazyTriggers = buildResolvedLazyTriggers(config, rawGroups);
+        config._resolvedLazyScripts = void 0;
+      }
+    }
+    return processedDependencies;
+  }
+}
+export {
+  DEPENDENCY_ERRORS,
+  DependencyResolverService
+};