@lukoweb/apitogo 0.2.31 → 0.2.34

package/src/config/resolve-modules.ts

@@ -1,354 +1,331 @@
-import { DEFAULT_LANDING_CONTENT } from "./default-landing-content.js";
-import {
-  type ResolvedModulesConfig,
-  ModulesSchema,
-  type LandingContentConfig,
-  type ResolvedLandingContent,
-  type DashboardContentConfig,
-  type ProfileContentConfig,
-  type PlansContentConfig,
-  type ResolvedDashboardContent,
-  type ResolvedProfileContent,
-  type ResolvedPlansContent,
-} from "./validators/ModulesSchema.js";
-import type { ZudokuConfig } from "./validators/ZudokuConfig.js";
-
-const DEFAULT_DOCS_FILES = "/pages/**/*.{md,mdx}";
-
-const hasExplicitModules = (config: ZudokuConfig) =>
-  config.modules !== undefined;
-
-export const joinPanelPath = (basePath: string, routePath: string): string => {
-  if (routePath.startsWith("/")) {
-    return routePath.replace(/\/+$/, "") || "/";
-  }
-
-  const base = basePath.replace(/\/+$/, "");
-  const route = routePath.replace(/^\/+/, "");
-
-  if (!base) {
-    return `/${route}`;
-  }
-
-  return `/${`${base}/${route}`.replace(/^\/+/, "")}`;
-};
-
-const mergeLandingSection = <T extends { enabled?: boolean }>(
-  defaults: T | undefined,
-  override: T | undefined,
-): T | undefined => {
-  if (override?.enabled === false) {
-    return undefined;
-  }
-
-  if (!defaults && !override) {
-    return undefined;
-  }
-
-  return { ...defaults, ...override } as T;
-};
-
-const buildDefaultLandingContent = (
-  config: ZudokuConfig,
-): ResolvedLandingContent => {
-  const siteTitle =
-    config.metadata?.applicationName ?? config.site?.title ?? "API ToGo";
-
-  return {
-    ...DEFAULT_LANDING_CONTENT,
-    hero: {
-      ...DEFAULT_LANDING_CONTENT.hero,
-      title: `${siteTitle} APIs that ship`,
-    },
-    primaryAction: {
-      ...DEFAULT_LANDING_CONTENT.primaryAction,
-      href: "/introduction",
-      label: "Get started",
-    },
-    secondaryAction: {
-      ...DEFAULT_LANDING_CONTENT.secondaryAction,
-      href: "/api",
-      label: "API Reference",
-    },
-    pricingCta: DEFAULT_LANDING_CONTENT.pricingCta
-      ? {
-          ...DEFAULT_LANDING_CONTENT.pricingCta,
-          primaryAction: {
-            label: "Get started",
-            href: "/introduction",
-          },
-          secondaryAction: {
-            label: "See pricing",
-            href: "/pricing",
-          },
-        }
-      : undefined,
-  };
-};
-
-export const resolveLandingContent = (
-  config: ZudokuConfig,
-  content?: LandingContentConfig,
-  options?: { useDefaults?: boolean },
-): ResolvedLandingContent => {
-  const siteTitle =
-    config.metadata?.applicationName ?? config.site?.title ?? "API ToGo";
-
-  if (options?.useDefaults === true) {
-    const defaults = buildDefaultLandingContent(config);
-    const footer = mergeLandingSection(defaults.footer, content?.footer);
-
-    return {
-      hero: {
-        ...defaults.hero,
-        ...content?.hero,
-        title: content?.hero?.title ?? defaults.hero?.title,
-        description:
-          content?.hero?.description ??
-          config.metadata?.description ??
-          defaults.hero?.description,
-        codeExample: content?.hero?.codeExample ?? defaults.hero?.codeExample,
-        titleAccent:
-          content?.hero?.titleAccent ??
-          (content?.hero?.title ? undefined : defaults.hero?.titleAccent),
-      },
-      featuresSection:
-        defaults.featuresSection || content?.featuresSection
-          ? { ...defaults.featuresSection, ...content?.featuresSection }
-          : undefined,
-      features: content?.features ?? defaults.features,
-      primaryAction: content?.primaryAction ?? defaults.primaryAction,
-      secondaryAction: content?.secondaryAction ?? defaults.secondaryAction,
-      // A configured footer replaces the "Built with API ToGo" powered-by line.
-      showPoweredBy:
-        content?.showPoweredBy ?? (footer ? false : defaults.showPoweredBy),
-      trust: mergeLandingSection(defaults.trust, content?.trust),
-      apiShowcase: mergeLandingSection(
-        defaults.apiShowcase,
-        content?.apiShowcase,
-      ),
-      pricingCta: mergeLandingSection(defaults.pricingCta, content?.pricingCta),
-      footer,
-    };
-  }
-
-  const hasContent = content !== undefined && Object.keys(content).length > 0;
-
-  if (!hasContent) {
-    return {
-      hero: { title: siteTitle },
-      showPoweredBy: true,
-    };
-  }
-
-  const footer = content.footer
-    ? mergeLandingSection(undefined, content.footer)
-    : undefined;
-
-  return {
-    hero: {
-      ...content.hero,
-      title: content.hero?.title ?? siteTitle,
-    },
-    featuresSection: content.featuresSection,
-    features: content.features,
-    primaryAction: content.primaryAction,
-    secondaryAction: content.secondaryAction,
-    // A configured footer replaces the "Built with API ToGo" powered-by line.
-    showPoweredBy: content.showPoweredBy ?? !footer,
-    trust: content.trust
-      ? mergeLandingSection(undefined, content.trust)
-      : undefined,
-    apiShowcase: content.apiShowcase
-      ? mergeLandingSection(undefined, content.apiShowcase)
-      : undefined,
-    pricingCta: content.pricingCta
-      ? mergeLandingSection(undefined, content.pricingCta)
-      : undefined,
-    footer,
-  };
-};
-
-const DEFAULT_DASHBOARD_QUICK_LINKS: ResolvedDashboardContent["quickLinks"] = [
-  { label: "Documentation", href: "/introduction" },
-  { label: "API Reference", href: "/api" },
-];
-
-export const resolveDashboardContent = (
-  content?: DashboardContentConfig,
-): ResolvedDashboardContent => ({
-  title: content?.title ?? "Dashboard",
-  subtitle: content?.subtitle ?? "Account",
-  description:
-    content?.description ??
-    "Overview of your account activity, documentation shortcuts, and next steps.",
-  quickLinks: content?.quickLinks ?? DEFAULT_DASHBOARD_QUICK_LINKS,
-});
-
-export const resolveProfileContent = (
-  content?: ProfileContentConfig,
-): ResolvedProfileContent => ({
-  title: content?.title ?? "Profile",
-  description:
-    content?.description ??
-    "View your account details and manage profile settings.",
-});
-
-export const resolvePlansContent = (
-  content?: PlansContentConfig,
-): ResolvedPlansContent => ({
-  title: content?.title ?? "Plans & billing",
-  description:
-    content?.description ??
-    "Manage subscription tiers, billing details, and usage limits.",
-  tiers: content?.tiers,
-});
-
-export const resolveModulesConfig = (
-  config: ZudokuConfig,
-): ResolvedModulesConfig => {
-  const parsedModules = ModulesSchema.parse(config.modules);
-  const modules = parsedModules ?? {};
-  const explicit = hasExplicitModules(config);
-
-  const docsModule = modules.docs;
-  const docsEnabled = explicit ? (docsModule?.enabled ?? true) : true;
-
-  const landingModule = modules.landing;
-  const landingEnabled = landingModule?.enabled ?? false;
-
-  const userPanelModule = modules.userPanel;
-  const dashboardConfig = userPanelModule?.dashboard;
-  const userManagementConfig = userPanelModule?.userManagement;
-  const apiKeysModuleConfig = userPanelModule?.apiKeys;
-  const plansConfig = userPanelModule?.plans;
-
-  const dashboardEnabled = dashboardConfig?.enabled ?? false;
-
-  const userManagementEnabled = explicit
-    ? (userManagementConfig?.enabled ?? !!config.authentication)
-    : !!config.authentication;
-
-  const apiKeysEnabled = explicit
-    ? (apiKeysModuleConfig?.enabled ?? false)
-    : false;
-
-  const billingEnabled =
-    (config as { __meta?: { pricingEnabled?: boolean } }).__meta
-      ?.pricingEnabled === true || plansConfig?.enabled === true;
-
-  const plansEnabled = billingEnabled;
-
-  const userPanelEnabled =
-    userPanelModule?.enabled ??
-    (dashboardEnabled ||
-      userManagementEnabled ||
-      apiKeysEnabled ||
-      plansEnabled);
-
-  const basePath = userPanelModule?.basePath ?? "/account";
-
-  return {
-    docs: {
-      enabled: docsEnabled,
-      files: docsModule?.files,
-      publishMarkdown: docsModule?.publishMarkdown,
-      defaultOptions: docsModule?.defaultOptions,
-      llms: docsModule?.llms,
-    },
-    landing: {
-      enabled: landingEnabled,
-      path: landingModule?.path ?? "/",
-      component: landingModule?.component,
-      layout: landingModule?.layout ?? "landing",
-      content: resolveLandingContent(config, landingModule?.content, {
-        useDefaults: landingModule?.useDefaults === true,
-      }),
-    },
-    userPanel: {
-      enabled: userPanelEnabled,
-      basePath,
-      dashboard: {
-        enabled: dashboardEnabled,
-        path: joinPanelPath(basePath, dashboardConfig?.path ?? "dashboard"),
-        content: resolveDashboardContent(dashboardConfig?.content),
-      },
-      userManagement: {
-        enabled: userManagementEnabled,
-        routes: {
-          login: userManagementConfig?.routes?.login ?? "/signin",
-          register: userManagementConfig?.routes?.register ?? "/signup",
-          profile: joinPanelPath(
-            basePath,
-            userManagementConfig?.routes?.profile ?? "profile",
-          ),
-          logout: userManagementConfig?.routes?.logout ?? "/signout",
-        },
-        content: resolveProfileContent(userManagementConfig?.content),
-      },
-      apiKeys: {
-        enabled: apiKeysEnabled,
-        path: joinPanelPath(
-          basePath,
-          apiKeysModuleConfig?.path ?? "settings/api-keys",
-        ),
-      },
-      plans: {
-        enabled: plansEnabled,
-        path: joinPanelPath(basePath, plansConfig?.path ?? "plans"),
-        content: resolvePlansContent(plansConfig?.content),
-        items: plansConfig?.items,
-      },
-    },
-  };
-};
-
-export const getEffectiveRedirects = (
-  config: ZudokuConfig,
-  resolved: ResolvedModulesConfig,
-) => {
-  const redirects = config.redirects ?? [];
-
-  if (!resolved.landing.enabled) {
-    return redirects;
-  }
-
-  const landingPath = normalizePath(resolved.landing.path);
-
-  return redirects.filter(
-    (redirect) => normalizePath(redirect.from) !== landingPath,
-  );
-};
-
-const normalizePath = (path: string) => {
-  if (path === "/") {
-    return "/";
-  }
-
-  return path.replace(/\/+$/, "") || "/";
-};
-
-export const getEffectiveDocsConfig = (
-  _config: ZudokuConfig,
-  resolved: ResolvedModulesConfig,
-) => {
-  if (!resolved.docs.enabled) {
-    return undefined;
-  }
-
-  return {
-    files: resolved.docs.files ?? [DEFAULT_DOCS_FILES],
-    publishMarkdown: resolved.docs.publishMarkdown ?? false,
-    defaultOptions: resolved.docs.defaultOptions,
-    llms: resolved.docs.llms,
-  };
-};
-
-export const isDocsModuleEnabled = (config: ZudokuConfig) =>
-  resolveModulesConfig(config).docs.enabled;
-
-export const isLandingModuleEnabled = (config: ZudokuConfig) =>
-  resolveModulesConfig(config).landing.enabled;
-
-export const isUserPanelModuleEnabled = (config: ZudokuConfig) =>
-  resolveModulesConfig(config).userPanel.enabled;
+import { DEFAULT_LANDING_CONTENT } from "./default-landing-content.js";
+import {
+  type ResolvedModulesConfig,
+  ModulesSchema,
+  type LandingContentConfig,
+  type ResolvedLandingContent,
+  type DashboardContentConfig,
+  type ProfileContentConfig,
+  type PlansContentConfig,
+  type ResolvedDashboardContent,
+  type ResolvedProfileContent,
+  type ResolvedPlansContent,
+} from "./validators/ModulesSchema.js";
+import type { ZudokuConfig } from "./validators/ZudokuConfig.js";
+
+const DEFAULT_DOCS_FILES = "/pages/**/*.{md,mdx}";
+
+const hasExplicitModules = (config: ZudokuConfig) =>
+  config.modules !== undefined;
+
+export const joinPanelPath = (basePath: string, routePath: string): string => {
+  if (routePath.startsWith("/")) {
+    return routePath.replace(/\/+$/, "") || "/";
+  }
+
+  const base = basePath.replace(/\/+$/, "");
+  const route = routePath.replace(/^\/+/, "");
+
+  if (!base) {
+    return `/${route}`;
+  }
+
+  return `/${`${base}/${route}`.replace(/^\/+/, "")}`;
+};
+
+const mergeLandingSection = <T extends { enabled?: boolean }>(
+  defaults: T | undefined,
+  override: T | undefined,
+): T | undefined => {
+  if (override?.enabled === false) {
+    return undefined;
+  }
+
+  if (!defaults && !override) {
+    return undefined;
+  }
+
+  return { ...defaults, ...override } as T;
+};
+
+const buildDefaultLandingContent = (
+  config: ZudokuConfig,
+): ResolvedLandingContent => {
+  const siteTitle =
+    config.metadata?.applicationName ?? config.site?.title ?? "API ToGo";
+
+  return {
+    ...DEFAULT_LANDING_CONTENT,
+    hero: {
+      ...DEFAULT_LANDING_CONTENT.hero,
+      title: `${siteTitle} APIs that ship`,
+    },
+    primaryAction: {
+      ...DEFAULT_LANDING_CONTENT.primaryAction,
+      href: "/introduction",
+      label: "Get started",
+    },
+    secondaryAction: {
+      ...DEFAULT_LANDING_CONTENT.secondaryAction,
+      href: "/api",
+      label: "API Reference",
+    },
+    pricingCta: DEFAULT_LANDING_CONTENT.pricingCta
+      ? {
+          ...DEFAULT_LANDING_CONTENT.pricingCta,
+          primaryAction: {
+            label: "Get started",
+            href: "/introduction",
+          },
+          secondaryAction: {
+            label: "See pricing",
+            href: "/pricing",
+          },
+        }
+      : undefined,
+  };
+};
+
+export const resolveLandingContent = (
+  config: ZudokuConfig,
+  content?: LandingContentConfig,
+  options?: { useDefaults?: boolean },
+): ResolvedLandingContent => {
+  const siteTitle =
+    config.metadata?.applicationName ?? config.site?.title ?? "API ToGo";
+
+  if (options?.useDefaults === true) {
+    const defaults = buildDefaultLandingContent(config);
+    const footer = mergeLandingSection(defaults.footer, content?.footer);
+
+    return {
+      hero: {
+        ...defaults.hero,
+        ...content?.hero,
+        title: content?.hero?.title ?? defaults.hero?.title,
+        description:
+          content?.hero?.description ??
+          config.metadata?.description ??
+          defaults.hero?.description,
+        codeExample: content?.hero?.codeExample ?? defaults.hero?.codeExample,
+        titleAccent:
+          content?.hero?.titleAccent ??
+          (content?.hero?.title ? undefined : defaults.hero?.titleAccent),
+      },
+      featuresSection:
+        defaults.featuresSection || content?.featuresSection
+          ? { ...defaults.featuresSection, ...content?.featuresSection }
+          : undefined,
+      features: content?.features ?? defaults.features,
+      primaryAction: content?.primaryAction ?? defaults.primaryAction,
+      secondaryAction: content?.secondaryAction ?? defaults.secondaryAction,
+      // A configured footer replaces the "Built with API ToGo" powered-by line.
+      showPoweredBy:
+        content?.showPoweredBy ?? (footer ? false : defaults.showPoweredBy),
+      trust: mergeLandingSection(defaults.trust, content?.trust),
+      apiShowcase: mergeLandingSection(
+        defaults.apiShowcase,
+        content?.apiShowcase,
+      ),
+      pricingCta: mergeLandingSection(defaults.pricingCta, content?.pricingCta),
+      footer,
+    };
+  }
+
+  const hasContent = content !== undefined && Object.keys(content).length > 0;
+
+  if (!hasContent) {
+    return {
+      hero: { title: siteTitle },
+      showPoweredBy: true,
+    };
+  }
+
+  const footer = content.footer
+    ? mergeLandingSection(undefined, content.footer)
+    : undefined;
+
+  return {
+    hero: {
+      ...content.hero,
+      title: content.hero?.title ?? siteTitle,
+    },
+    featuresSection: content.featuresSection,
+    features: content.features,
+    primaryAction: content.primaryAction,
+    secondaryAction: content.secondaryAction,
+    // A configured footer replaces the "Built with API ToGo" powered-by line.
+    showPoweredBy: content.showPoweredBy ?? !footer,
+    trust: content.trust
+      ? mergeLandingSection(undefined, content.trust)
+      : undefined,
+    apiShowcase: content.apiShowcase
+      ? mergeLandingSection(undefined, content.apiShowcase)
+      : undefined,
+    pricingCta: content.pricingCta
+      ? mergeLandingSection(undefined, content.pricingCta)
+      : undefined,
+    footer,
+  };
+};
+
+const DEFAULT_DASHBOARD_QUICK_LINKS: ResolvedDashboardContent["quickLinks"] = [
+  { label: "Documentation", href: "/introduction" },
+  { label: "API Reference", href: "/api" },
+];
+
+export const resolveDashboardContent = (
+  content?: DashboardContentConfig,
+): ResolvedDashboardContent => ({
+  title: content?.title ?? "Dashboard",
+  subtitle: content?.subtitle ?? "Account",
+  description:
+    content?.description ??
+    "Overview of your account activity, documentation shortcuts, and next steps.",
+  quickLinks: content?.quickLinks ?? DEFAULT_DASHBOARD_QUICK_LINKS,
+});
+
+export const resolveProfileContent = (
+  content?: ProfileContentConfig,
+): ResolvedProfileContent => ({
+  title: content?.title ?? "Profile",
+  description:
+    content?.description ??
+    "View your account details and manage profile settings.",
+});
+
+export const resolvePlansContent = (
+  content?: PlansContentConfig,
+): ResolvedPlansContent => ({
+  title: content?.title ?? "Plans & billing",
+  description:
+    content?.description ??
+    "Manage subscription tiers, billing details, and usage limits.",
+  tiers: content?.tiers,
+});
+
+export const resolveModulesConfig = (
+  config: ZudokuConfig,
+): ResolvedModulesConfig => {
+  const parsedModules = ModulesSchema.parse(config.modules);
+  const modules = parsedModules ?? {};
+  const explicit = hasExplicitModules(config);
+
+  const docsModule = modules.docs;
+  const docsEnabled = explicit ? (docsModule?.enabled ?? true) : true;
+
+  const landingModule = modules.landing;
+  const landingEnabled = landingModule?.enabled ?? false;
+
+  const userPanelModule = modules.userPanel;
+  const dashboardConfig = userPanelModule?.dashboard;
+  const userManagementConfig = userPanelModule?.userManagement;
+  const apiKeysModuleConfig = userPanelModule?.apiKeys;
+  const plansConfig = userPanelModule?.plans;
+
+  const dashboardEnabled = dashboardConfig?.enabled ?? false;
+
+  const userManagementEnabled = explicit
+    ? (userManagementConfig?.enabled ?? !!config.authentication)
+    : !!config.authentication;
+
+  const apiKeysEnabled = explicit
+    ? (apiKeysModuleConfig?.enabled ?? false)
+    : false;
+
+  const billingEnabled =
+    (config as { __meta?: { pricingEnabled?: boolean } }).__meta
+      ?.pricingEnabled === true || plansConfig?.enabled === true;
+
+  const plansEnabled = billingEnabled;
+
+  const userPanelEnabled =
+    userPanelModule?.enabled ??
+    (dashboardEnabled ||
+      userManagementEnabled ||
+      apiKeysEnabled ||
+      plansEnabled);
+
+  const basePath = userPanelModule?.basePath ?? "/account";
+
+  return {
+    docs: {
+      enabled: docsEnabled,
+      files: docsModule?.files,
+      publishMarkdown: docsModule?.publishMarkdown,
+      defaultOptions: docsModule?.defaultOptions,
+      llms: docsModule?.llms,
+    },
+    landing: {
+      enabled: landingEnabled,
+      path: landingModule?.path ?? "/",
+      component: landingModule?.component,
+      layout: landingModule?.layout ?? "landing",
+      content: resolveLandingContent(config, landingModule?.content, {
+        useDefaults: landingModule?.useDefaults === true,
+      }),
+    },
+    userPanel: {
+      enabled: userPanelEnabled,
+      basePath,
+      dashboard: {
+        enabled: dashboardEnabled,
+        path: joinPanelPath(basePath, dashboardConfig?.path ?? "dashboard"),
+        content: resolveDashboardContent(dashboardConfig?.content),
+      },
+      userManagement: {
+        enabled: userManagementEnabled,
+        routes: {
+          login: userManagementConfig?.routes?.login ?? "/signin",
+          register: userManagementConfig?.routes?.register ?? "/signup",
+          profile: joinPanelPath(
+            basePath,
+            userManagementConfig?.routes?.profile ?? "profile",
+          ),
+          logout: userManagementConfig?.routes?.logout ?? "/signout",
+        },
+        content: resolveProfileContent(userManagementConfig?.content),
+      },
+      apiKeys: {
+        enabled: apiKeysEnabled,
+        path: joinPanelPath(
+          basePath,
+          apiKeysModuleConfig?.path ?? "settings/api-keys",
+        ),
+      },
+      plans: {
+        enabled: plansEnabled,
+        path: joinPanelPath(basePath, plansConfig?.path ?? "plans"),
+        content: resolvePlansContent(plansConfig?.content),
+        items: plansConfig?.items,
+      },
+    },
+  };
+};
+
+export { getEffectiveRedirects } from "./effective-redirects.js";
+
+export const getEffectiveDocsConfig = (
+  _config: ZudokuConfig,
+  resolved: ResolvedModulesConfig,
+) => {
+  if (!resolved.docs.enabled) {
+    return undefined;
+  }
+
+  return {
+    files: resolved.docs.files ?? [DEFAULT_DOCS_FILES],
+    publishMarkdown: resolved.docs.publishMarkdown ?? false,
+    defaultOptions: resolved.docs.defaultOptions,
+    llms: resolved.docs.llms,
+  };
+};
+
+export const isDocsModuleEnabled = (config: ZudokuConfig) =>
+  resolveModulesConfig(config).docs.enabled;
+
+export const isLandingModuleEnabled = (config: ZudokuConfig) =>
+  resolveModulesConfig(config).landing.enabled;
+
+export const isUserPanelModuleEnabled = (config: ZudokuConfig) =>
+  resolveModulesConfig(config).userPanel.enabled;