@lukoweb/apitogo 0.1.54 → 0.1.56

package/src/config/loader.ts

@@ -18,6 +18,7 @@ import {
   loadApitogoConfig,
   readPlanCatalogItems,
 } from "./apitogo-config-loader.js";
+import { buildApitogoConfig } from "./build-apitogo-config.js";
 import { fileExists } from "./file-exists.js";
 import {
   isAuthenticationEnabled,
@@ -117,7 +118,18 @@ async function loadZudokuConfigWithMeta(
     },
   });
 
-  const config = module.default;
+  const importedConfig = module.default;
+
+  let config: ZudokuConfig;
+  try {
+    const fileConfig = loadApitogoConfig(rootDir);
+    config = buildApitogoConfig({
+      ...fileConfig,
+      plugins: importedConfig.plugins,
+    });
+  } catch {
+    config = importedConfig;
+  }
 
   validateConfig(config, configPath);
 
@@ -130,7 +142,7 @@ async function loadZudokuConfigWithMeta(
       dependencies,
       configPath,
     },
-    __resolvedModules: resolveModulesConfig(config),
+    __resolvedModules: resolveModulesConfig(config, { rootDir }),
   };
 
   return configWithMetadata;
@@ -288,7 +300,9 @@ export async function loadZudokuConfig(
         ...transformedConfig.__meta,
         ...configWithManifestMeta.__meta,
       },
-      __resolvedModules: resolveModulesConfig(transformedConfig),
+      __resolvedModules: resolveModulesConfig(transformedConfig, {
+        rootDir: transformedConfig.__meta.rootDir,
+      }),
     };
 
     if (!process.env.APITOGO_JSON_ONLY) {

package/src/config/local-manifest.ts

@@ -1,4 +1,4 @@
-import { access, readFile } from "node:fs/promises";
+import { readFile } from "node:fs/promises";
 import path from "node:path";
 import { z } from "zod";
 import {
@@ -8,6 +8,10 @@ import {
   loadApitogoConfig,
   readPlanCatalogItems,
 } from "./apitogo-config-loader.js";
+import {
+  type LandingManifestInput,
+  LandingManifestContentSchema,
+} from "./landing-manifest.js";
 
 /** @deprecated Legacy manifest filenames — apitogo.config.json is the only supported source. */
 export const APITOGO_MANIFEST_BASE_FILENAME = "apitogo.json";
@@ -102,12 +106,19 @@ export const DevPortalLocalManifestSchema = z.object({
     })
     .optional(),
   projectId: z.string().optional(),
+  landing: z
+    .object({
+      enabled: z.boolean().optional(),
+      content: LandingManifestContentSchema,
+    })
+    .optional(),
 });
 
 export type ManifestPlanInput = z.infer<typeof ManifestPlanInputSchema>;
 export type DevPortalLocalManifest = z.infer<
   typeof DevPortalLocalManifestSchema
 >;
+export type { LandingManifestInput };
 
 export type DevPortalPreviewPlan = {
   sku: string;
@@ -213,6 +224,105 @@ export function mergePlansBySku(
   return Array.from(bySku.values());
 }
 
+export function mergeLandingContent(
+  existing: LandingManifestInput["content"] | undefined,
+  patch: LandingManifestInput["content"] | undefined,
+): LandingManifestInput["content"] | undefined {
+  if (!patch) {
+    return existing;
+  }
+  if (!existing) {
+    return patch;
+  }
+
+  const merged = { ...existing, ...patch };
+
+  if (patch.hero) {
+    merged.hero = { ...existing.hero, ...patch.hero };
+    if (patch.hero.codeExample) {
+      merged.hero = {
+        ...merged.hero,
+        codeExample: {
+          ...existing.hero?.codeExample,
+          ...patch.hero.codeExample,
+        },
+      };
+    }
+  }
+
+  if (patch.features) {
+    const byTitle = new Map(
+      (existing.features ?? []).map((feature) => [feature.title, feature]),
+    );
+    for (const feature of patch.features) {
+      const prior = byTitle.get(feature.title);
+      byTitle.set(feature.title, prior ? { ...prior, ...feature } : feature);
+    }
+    merged.features = Array.from(byTitle.values());
+  }
+
+  if (patch.ticker) {
+    merged.ticker = { ...existing.ticker, ...patch.ticker };
+    if (patch.ticker.items) {
+      merged.ticker.items = patch.ticker.items;
+    }
+  }
+
+  if (patch.trust) {
+    merged.trust = { ...existing.trust, ...patch.trust };
+    if (patch.trust.logos) {
+      merged.trust.logos = patch.trust.logos;
+    }
+  }
+
+  if (patch.apiShowcase) {
+    merged.apiShowcase = { ...existing.apiShowcase, ...patch.apiShowcase };
+    if (patch.apiShowcase.items) {
+      const byPath = new Map(
+        (existing.apiShowcase?.items ?? []).map((item) => [item.path, item]),
+      );
+      for (const item of patch.apiShowcase.items) {
+        const prior = byPath.get(item.path);
+        byPath.set(item.path, prior ? { ...prior, ...item } : item);
+      }
+      merged.apiShowcase.items = Array.from(byPath.values());
+    }
+  }
+
+  if (patch.pricingCta) {
+    merged.pricingCta = { ...existing.pricingCta, ...patch.pricingCta };
+  }
+
+  if (patch.primaryAction) {
+    merged.primaryAction = { ...existing.primaryAction, ...patch.primaryAction };
+  }
+  if (patch.secondaryAction) {
+    merged.secondaryAction = {
+      ...existing.secondaryAction,
+      ...patch.secondaryAction,
+    };
+  }
+
+  return merged;
+}
+
+export function mergeLandingManifest(
+  existing: LandingManifestInput | undefined,
+  patch: LandingManifestInput | undefined,
+): LandingManifestInput | undefined {
+  if (!patch) {
+    return existing;
+  }
+  if (!existing) {
+    return patch;
+  }
+
+  return {
+    enabled: patch.enabled ?? existing.enabled,
+    content: mergeLandingContent(existing.content, patch.content),
+  };
+}
+
 export function mergeManifest(
   base: DevPortalLocalManifest,
   override: DevPortalLocalManifest,
@@ -240,6 +350,9 @@ export function mergeManifest(
   if (override.plans) {
     merged.plans = mergePlansBySku(base.plans, override.plans);
   }
+  if (override.landing) {
+    merged.landing = mergeLandingManifest(base.landing, override.landing);
+  }
 
   return merged;
 }
@@ -277,15 +390,6 @@ export function parseLocalManifestJson(
   }
 }
 
-async function fileExists(filePath: string): Promise<boolean> {
-  try {
-    await access(filePath);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
 export async function readManifestFile(
   rootDir: string,
   filename: string,

package/src/config/resolve-modules.ts

@@ -1,3 +1,4 @@
+import { DEFAULT_LANDING_CONTENT } from "./default-landing-content.js";
 import {
   type ResolvedModulesConfig,
   ModulesSchema,
@@ -32,50 +33,136 @@ export const joinPanelPath = (basePath: string, routePath: string): string => {
   return `/${`${base}/${route}`.replace(/^\/+/, "")}`;
 };
 
-const DEFAULT_LANDING_FEATURES: ResolvedLandingContent["features"] = [
-  {
-    title: "Documentation",
-    description:
-      "Write guides and references in Markdown or MDX with full navigation and search.",
-  },
-  {
-    title: "API Reference",
-    description:
-      "Publish interactive OpenAPI docs with a built-in playground and code samples.",
-  },
-  {
-    title: "Developer Portal",
-    description:
-      "Extend with landing pages, authentication, API keys, and subscription modules.",
-  },
-];
+const mergeLandingSection = <T extends { enabled?: boolean }>(
+  defaults: T | undefined,
+  override: T | undefined,
+): T | undefined => {
+  if (override?.enabled === false) {
+    return undefined;
+  }
 
-export const resolveLandingContent = (
+  if (!defaults && !override) {
+    return undefined;
+  }
+
+  return { ...defaults, ...override } as T;
+};
+
+const buildDefaultLandingContent = (
   config: ZudokuConfig,
-  content?: LandingContentConfig,
 ): ResolvedLandingContent => {
   const siteTitle =
     config.metadata?.applicationName ?? config.site?.title ?? "APIToGo";
 
   return {
+    ...DEFAULT_LANDING_CONTENT,
     hero: {
-      title: content?.hero?.title ?? siteTitle,
-      subtitle: content?.hero?.subtitle ?? "Developer portal",
-      description:
-        content?.hero?.description ??
-        config.metadata?.description ??
-        "Ship beautiful API documentation and developer experiences with APIToGo.",
+      ...DEFAULT_LANDING_CONTENT.hero,
+      title: `${siteTitle} APIs that ship`,
     },
-    features: content?.features ?? DEFAULT_LANDING_FEATURES,
-    primaryAction: content?.primaryAction ?? {
-      label: "Get started",
+    primaryAction: {
+      ...DEFAULT_LANDING_CONTENT.primaryAction,
       href: "/introduction",
+      label: "Get started",
     },
-    secondaryAction: content?.secondaryAction ?? {
-      label: "API Reference",
+    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 ?? "APIToGo";
+
+  if (options?.useDefaults === true) {
+    const defaults = buildDefaultLandingContent(config);
+
+    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: mergeLandingSection(
+        defaults.featuresSection,
+        content?.featuresSection,
+      ),
+      features: content?.features ?? defaults.features,
+      primaryAction: content?.primaryAction ?? defaults.primaryAction,
+      secondaryAction: content?.secondaryAction ?? defaults.secondaryAction,
+      showPoweredBy: content?.showPoweredBy ?? defaults.showPoweredBy,
+      ticker: mergeLandingSection(defaults.ticker, content?.ticker),
+      trust: mergeLandingSection(defaults.trust, content?.trust),
+      apiShowcase: mergeLandingSection(
+        defaults.apiShowcase,
+        content?.apiShowcase,
+      ),
+      pricingCta: mergeLandingSection(defaults.pricingCta, content?.pricingCta),
+    };
+  }
+
+  const hasContent =
+    content !== undefined && Object.keys(content).length > 0;
+
+  if (!hasContent) {
+    return {
+      hero: { title: siteTitle },
+      showPoweredBy: true,
+    };
+  }
+
+  return {
+    hero: {
+      ...content.hero,
+      title: content.hero?.title ?? siteTitle,
     },
-    showPoweredBy: content?.showPoweredBy,
+    featuresSection: content.featuresSection
+      ? mergeLandingSection(undefined, content.featuresSection)
+      : undefined,
+    features: content.features,
+    primaryAction: content.primaryAction,
+    secondaryAction: content.secondaryAction,
+    showPoweredBy: content.showPoweredBy ?? true,
+    ticker: content.ticker
+      ? mergeLandingSection(undefined, content.ticker)
+      : undefined,
+    trust: content.trust
+      ? mergeLandingSection(undefined, content.trust)
+      : undefined,
+    apiShowcase: content.apiShowcase
+      ? mergeLandingSection(undefined, content.apiShowcase)
+      : undefined,
+    pricingCta: content.pricingCta
+      ? mergeLandingSection(undefined, content.pricingCta)
+      : undefined,
   };
 };
 
@@ -172,7 +259,9 @@ export const resolveModulesConfig = (
       path: landingModule?.path ?? "/",
       component: landingModule?.component,
       layout: landingModule?.layout ?? "landing",
-      content: resolveLandingContent(config, landingModule?.content),
+      content: resolveLandingContent(config, landingModule?.content, {
+        useDefaults: landingModule?.useDefaults === true,
+      }),
     },
     userPanel: {
       enabled: userPanelEnabled,

package/src/config/validators/ModulesSchema.ts

@@ -44,22 +44,102 @@ export const LandingLinkSchema = z.object({
 export const LandingFeatureSchema = z.object({
   title: z.string(),
   description: z.string(),
+  icon: z.string().optional(),
 });
 
+export const LandingCodeExampleSchema = z
+  .object({
+    filename: z.string().optional(),
+    language: z.string().optional(),
+    code: z.string(),
+  })
+  .optional();
+
 export const LandingHeroSchema = z
   .object({
     title: z.string().optional(),
+    titleAccent: z
+      .string()
+      .optional()
+      .describe("Accent-colored word or phrase shown on a new line after the title."),
     subtitle: z.string().optional(),
     description: z.string().optional(),
+    badge: z.string().optional(),
+    highlights: z.array(z.string()).optional(),
+    codeExample: LandingCodeExampleSchema,
+  })
+  .optional();
+
+export const LandingFeaturesSectionSchema = z
+  .object({
+    label: z.string().optional(),
+    title: z.string().optional(),
+    description: z.string().optional(),
+  })
+  .optional();
+
+export const LandingTickerItemSchema = z.object({
+  label: z.string(),
+  value: z.string(),
+  change: z.string().optional(),
+});
+
+export const LandingTickerSchema = z
+  .object({
+    enabled: z.boolean().optional(),
+    items: z.array(LandingTickerItemSchema).optional(),
+  })
+  .optional();
+
+export const LandingTrustSchema = z
+  .object({
+    enabled: z.boolean().optional(),
+    title: z.string().optional(),
+    logos: z.array(z.string()).optional(),
+  })
+  .optional();
+
+export const LandingApiShowcaseItemSchema = z.object({
+  name: z.string(),
+  path: z.string(),
+  icon: z.string().optional(),
+  latency: z.string().optional(),
+  summary: z.string().optional(),
+});
+
+export const LandingApiShowcaseSchema = z
+  .object({
+    enabled: z.boolean().optional(),
+    title: z.string().optional(),
+    subtitle: z.string().optional(),
+    browseAllHref: z.string().optional(),
+    browseAllLabel: z.string().optional(),
+    autoFromOpenApi: z.boolean().optional(),
+    items: z.array(LandingApiShowcaseItemSchema).optional(),
+  })
+  .optional();
+
+export const LandingPricingCtaSchema = z
+  .object({
+    enabled: z.boolean().optional(),
+    title: z.string().optional(),
+    description: z.string().optional(),
+    primaryAction: LandingLinkSchema.optional(),
+    secondaryAction: LandingLinkSchema.optional(),
   })
   .optional();
 
 export const LandingContentSchema = z
   .object({
     hero: LandingHeroSchema,
+    featuresSection: LandingFeaturesSectionSchema,
     features: z.array(LandingFeatureSchema).optional(),
     primaryAction: LandingLinkSchema.optional(),
     secondaryAction: LandingLinkSchema.optional(),
+    ticker: LandingTickerSchema,
+    trust: LandingTrustSchema,
+    apiShowcase: LandingApiShowcaseSchema,
+    pricingCta: LandingPricingCtaSchema,
     showPoweredBy: z.boolean().optional(),
   })
   .optional();
@@ -128,6 +208,12 @@ export const LandingModuleSchema = ModuleToggleSchema.extend({
   content: LandingContentSchema.describe(
     "Default landing page content when no custom component is provided.",
   ),
+  useDefaults: z
+    .boolean()
+    .optional()
+    .describe(
+      "When true, merge DEFAULT_LANDING_CONTENT for unset sections. When false or omitted, only configured sections are shown.",
+    ),
 });
 
 export const UserManagementModuleSchema = ModuleToggleSchema.extend({
@@ -246,15 +332,38 @@ export type ProfileContentConfig = z.infer<typeof ProfileContentSchema>;
 export type PlansContentConfig = z.infer<typeof PlansContentSchema>;
 export type PlanTierConfig = z.infer<typeof PlanTierSchema>;
 
+export type LandingCodeExampleConfig = z.infer<typeof LandingCodeExampleSchema>;
+export type LandingTickerItemConfig = z.infer<typeof LandingTickerItemSchema>;
+export type LandingTickerConfig = z.infer<typeof LandingTickerSchema>;
+export type LandingTrustConfig = z.infer<typeof LandingTrustSchema>;
+export type LandingApiShowcaseItemConfig = z.infer<
+  typeof LandingApiShowcaseItemSchema
+>;
+export type LandingApiShowcaseConfig = z.infer<typeof LandingApiShowcaseSchema>;
+export type LandingPricingCtaConfig = z.infer<typeof LandingPricingCtaSchema>;
+
 export type ResolvedLandingContent = {
   hero?: {
     title?: string;
+    titleAccent?: string;
     subtitle?: string;
     description?: string;
+    badge?: string;
+    highlights?: string[];
+    codeExample?: NonNullable<LandingCodeExampleConfig>;
+  };
+  featuresSection?: {
+    label?: string;
+    title?: string;
+    description?: string;
   };
   features?: LandingFeatureConfig[];
   primaryAction?: LandingLinkConfig;
   secondaryAction?: LandingLinkConfig;
+  ticker?: LandingTickerConfig;
+  trust?: LandingTrustConfig;
+  apiShowcase?: LandingApiShowcaseConfig;
+  pricingCta?: LandingPricingCtaConfig;
   showPoweredBy?: boolean;
 };
 

package/src/config/validators/ZudokuConfig.ts

@@ -582,6 +582,7 @@ const ThemeConfigSchema = z.object({
 const SiteSchema = z
   .object({
     title: z.string(),
+    showTitleInHeader: z.boolean().optional(),
     logoUrl: z.string(),
     dir: z.enum(["ltr", "rtl"]).optional(),
     logo: LogoSchema,

package/src/lib/authentication/auth-header-nav.ts

@@ -27,22 +27,12 @@ export function applyAuthenticationHeaderNav<T extends ZudokuConfig>(
   const authNavEnabled = config.__meta?.authenticationEnabled === true;
   const navigation = config.header?.navigation ?? [];
 
-  if (!authNavEnabled) {
-    const filtered = withoutLoginNavigation(navigation);
-    if (filtered.length === navigation.length) {
-      return config;
-    }
-
-    return {
-      ...config,
-      header: {
-        ...config.header,
-        navigation: filtered,
-      },
-    };
+  if (authNavEnabled) {
+    return config;
   }
 
-  if (navigation.some((item) => "to" in item && item.to === LOGIN_NAV_PATH)) {
+  const filtered = withoutLoginNavigation(navigation);
+  if (filtered.length === navigation.length) {
     return config;
   }
 
@@ -50,7 +40,7 @@ export function applyAuthenticationHeaderNav<T extends ZudokuConfig>(
     ...config,
     header: {
       ...config.header,
-      navigation: [...navigation, LOGIN_HEADER_NAV_ITEM],
+      navigation: filtered,
     },
   };
 }

package/src/lib/authentication/header-nav-filter.ts

@@ -0,0 +1,36 @@
+import type { HeaderNavigation } from "../../config/validators/HeaderNavigationSchema.js";
+import { LOGIN_NAV_PATH } from "./auth-header-nav.js";
+
+const AUTH_HEADER_PATHS = new Set([
+  LOGIN_NAV_PATH,
+  "/signin",
+  "/login",
+  "/signup",
+  "/register",
+]);
+
+const PRICING_HEADER_PATHS = new Set(["/pricing"]);
+
+export function withoutAuthHeaderNavigation(
+  navigation: HeaderNavigation,
+): HeaderNavigation {
+  return navigation.filter(
+    (item) => !("to" in item) || !AUTH_HEADER_PATHS.has(item.to),
+  );
+}
+
+export function withoutPricingHeaderNavigation(
+  navigation: HeaderNavigation,
+): HeaderNavigation {
+  return navigation.filter(
+    (item) => !("to" in item) || !PRICING_HEADER_PATHS.has(item.to),
+  );
+}
+
+export function withoutMarketingCtaHeaderNavigation(
+  navigation: HeaderNavigation,
+): HeaderNavigation {
+  return withoutPricingHeaderNavigation(
+    withoutAuthHeaderNavigation(navigation),
+  );
+}