refactor(security): unify hook rate-limit and hook module loading

src/hooks/module-loader.ts

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