@ecopages/core 0.2.0-alpha.3 → 0.2.0-alpha.31

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

@@ -1,428 +0,0 @@
-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
-};