src/hooks/module-loader.ts

import { pathToFileURL } from "node:url";

type ModuleNamespace = Record<string, unknown>;
type GenericFunction = (...args: never[]) => unknown;

export function resolveFileModuleUrl(params: {
  modulePath: string;
  cacheBust?: boolean;
  nowMs?: number;
}): string {
  const url = pathToFileURL(params.modulePath).href;
  if (!params.cacheBust) {
    return url;
  }
  const ts = params.nowMs ?? Date.now();
  return `${url}?t=${ts}`;
}

export async function importFileModule(params: {
  modulePath: string;
  cacheBust?: boolean;
  nowMs?: number;
}): Promise<ModuleNamespace> {
  const specifier = resolveFileModuleUrl(params);
  return (await import(specifier)) as ModuleNamespace;
}

export function resolveFunctionModuleExport<T extends GenericFunction>(params: {
  mod: ModuleNamespace;
  exportName?: string;
  fallbackExportNames?: string[];
}): T | undefined {
  const explicitExport = params.exportName?.trim();
  if (explicitExport) {
    const candidate = params.mod[explicitExport];
    return typeof candidate === "function" ? (candidate as T) : undefined;
  }
  const fallbacks = params.fallbackExportNames ?? ["default"];
  for (const exportName of fallbacks) {
    const candidate = params.mod[exportName];
    if (typeof candidate === "function") {
      return candidate as T;
    }
  }
  return undefined;
}