@zyrab/domo-ssg/src/route-handler.js

A Static Site Generator (SSG) for Domo-based projects.

// src/route-handler.js
import Router from "@zyrab/domo-router";
import { getConfig } from "./config.js";
import { writeHTML } from "./file-utils.js";
import { writeJs } from "./event-utils.js";
import { normalizeAssets, tryGenerateOgImage } from "./utils.js";

/**
 * Helper to join URL path segments correctly.
 * @param {...string} segments - Path segments to join.
 * @returns {string} The normalized joined path.
 */
export function joinPaths(...segments) {
  let pathStr = segments
    .filter(Boolean)
    .map((s) => String(s).replace(/(^\/+|\/+$)/g, ""))
    .join("/");

  return "/" + pathStr.replace(/\/+/g, "/");
}
/**
 * Handles the rendering and writing of a single route's HTML file.
 * @param {object} routeConfig - Configuration for the current route.
 * @param {string} routeConfig.path - The full URL path for this route (e.g., "/about", "/blog/post-1").
 * @param {object} routeConfig.props - Properties to pass to the component.
 * @param {Function} routeConfig.component - The component function that returns an HTMLElement or string.
 * @param {string} [routeConfig.script] - Optional script to include in the layout.
 * @param {object} [routeConfig.meta={}] - Optional metadata for the page (title, description).
 * @param {Function} renderLayout - The layout rendering function from the user's config.
 * @returns {Promise<void>}
 */

export async function handleRoute(params, renderLayout) {
  const { outDir, baseUrl, lang, author, theme, assets = {} } = getConfig();
  const { path, props = {}, component, scripts = [], styles = [], fonts = [], meta = {} } = params;
  try {
    Router.setInfo(path, props);

    // Render the component content
    const content = await component(props);

    const bundlePath = await writeJs(content, outDir);
    const ogImage = await tryGenerateOgImage(meta, outDir, path);

    // Merge order: route-specific first, then global assets.
    // normalizeAssets deduplicates by href so overlap is safe.
    const fontPaths = normalizeAssets(fonts, assets.fonts);
    const stylePaths = normalizeAssets(styles, assets.styles);
    const scriptPaths = normalizeAssets(bundlePath, scripts, assets.scripts);
    const html = await renderLayout(content, {
      scripts: scriptPaths,
      styles: stylePaths,
      fonts: fontPaths,
      favicon: assets?.favicon,
      baseUrl,
      lang,
      author,
      theme,
      ...meta,
      ogImage: ogImage || meta.ogImage,
    });

    // Write the generated HTML to a file
    writeHTML(outDir, path, html);
  } catch (e) {
    console.warn(`[Domo-SSG] Error rendering ${path}:\n${e.stack}`);
  }
}