@lukoweb/apitogo 0.1.53 → 0.1.55

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";
@@ -55,8 +59,29 @@ export const DevPortalLocalManifestSchema = z.object({
   authentication: z
     .object({
       enabled: z.boolean().optional(),
-      type: z.string().optional(),
       apiBaseUrl: z.string().optional(),
+      native: z
+        .object({
+          enabled: z.boolean().optional(),
+        })
+        .optional(),
+      email: z
+        .object({
+          provider: z.string().optional(),
+          from: z.string().optional(),
+        })
+        .optional(),
+      providers: z
+        .array(
+          z.object({
+            id: z.string().min(1),
+            displayName: z.string().optional(),
+            authority: z.string().optional(),
+            clientId: z.string().optional(),
+            scopes: z.string().optional(),
+          }),
+        )
+        .optional(),
     })
     .optional(),
   plans: z.array(ManifestPlanInputSchema).optional(),
@@ -81,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;
@@ -116,6 +148,16 @@ export function isAuthenticationEnabled(
   return manifest?.authentication?.enabled === true;
 }
 
+export function isNativeAuthEnabledInManifest(
+  manifest: DevPortalLocalManifest | null | undefined,
+): boolean {
+  if (!isAuthenticationEnabled(manifest)) {
+    return false;
+  }
+
+  return manifest?.authentication?.native?.enabled !== false;
+}
+
 export function manifestToPreviewCatalog(
   manifest: DevPortalLocalManifest | null | undefined,
 ): DevPortalPreviewPlanCatalog {
@@ -182,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,
@@ -209,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;
 }
@@ -246,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

@@ -57,7 +57,7 @@ export const resolveLandingContent = (
   const siteTitle =
     config.metadata?.applicationName ?? config.site?.title ?? "APIToGo";
 
-  return {
+  const resolved: ResolvedLandingContent = {
     hero: {
       title: content?.hero?.title ?? siteTitle,
       subtitle: content?.hero?.subtitle ?? "Developer portal",
@@ -65,6 +65,9 @@ export const resolveLandingContent = (
         content?.hero?.description ??
         config.metadata?.description ??
         "Ship beautiful API documentation and developer experiences with APIToGo.",
+      badge: content?.hero?.badge,
+      highlights: content?.hero?.highlights,
+      codeExample: content?.hero?.codeExample,
     },
     features: content?.features ?? DEFAULT_LANDING_FEATURES,
     primaryAction: content?.primaryAction ?? {
@@ -77,6 +80,24 @@ export const resolveLandingContent = (
     },
     showPoweredBy: content?.showPoweredBy,
   };
+
+  if (content?.ticker && content.ticker.enabled !== false) {
+    resolved.ticker = content.ticker;
+  }
+
+  if (content?.trust && content.trust.enabled !== false) {
+    resolved.trust = content.trust;
+  }
+
+  if (content?.apiShowcase && content.apiShowcase.enabled !== false) {
+    resolved.apiShowcase = content.apiShowcase;
+  }
+
+  if (content?.pricingCta && content.pricingCta.enabled !== false) {
+    resolved.pricingCta = content.pricingCta;
+  }
+
+  return resolved;
 };
 
 const DEFAULT_DASHBOARD_QUICK_LINKS: ResolvedDashboardContent["quickLinks"] = [

package/src/config/validators/ModulesSchema.ts

@@ -44,13 +44,76 @@ 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(),
     subtitle: z.string().optional(),
     description: z.string().optional(),
+    badge: z.string().optional(),
+    highlights: z.array(z.string()).optional(),
+    codeExample: LandingCodeExampleSchema,
+  })
+  .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();
 
@@ -60,6 +123,10 @@ export const LandingContentSchema = z
     features: z.array(LandingFeatureSchema).optional(),
     primaryAction: LandingLinkSchema.optional(),
     secondaryAction: LandingLinkSchema.optional(),
+    ticker: LandingTickerSchema,
+    trust: LandingTrustSchema,
+    apiShowcase: LandingApiShowcaseSchema,
+    pricingCta: LandingPricingCtaSchema,
     showPoweredBy: z.boolean().optional(),
   })
   .optional();
@@ -246,15 +313,32 @@ 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;
     subtitle?: string;
     description?: string;
+    badge?: string;
+    highlights?: string[];
+    codeExample?: NonNullable<LandingCodeExampleConfig>;
   };
   features?: LandingFeatureConfig[];
   primaryAction?: LandingLinkConfig;
   secondaryAction?: LandingLinkConfig;
+  ticker?: LandingTickerConfig;
+  trust?: LandingTrustConfig;
+  apiShowcase?: LandingApiShowcaseConfig;
+  pricingCta?: LandingPricingCtaConfig;
   showPoweredBy?: boolean;
 };
 

package/src/config/validators/ZudokuConfig.ts

@@ -492,8 +492,32 @@ const AuthenticationSchema = z.discriminatedUnion("type", [
     redirectToAfterSignOut: z.string().optional(),
   }),
   z.object({
-    type: z.literal("dev-portal"),
+    type: z.literal("dev-portal").optional().default("dev-portal"),
     apiBaseUrl: z.string().optional(),
+    native: z
+      .object({
+        enabled: z.boolean().optional(),
+      })
+      .optional(),
+    email: z
+      .object({
+        provider: z.string().optional(),
+        from: z.string().optional(),
+        connectionString: z.string().optional(),
+      })
+      .optional(),
+    providers: z
+      .array(
+        z.object({
+          id: z.string().min(1),
+          displayName: z.string().optional(),
+          authority: z.string().optional(),
+          clientId: z.string().optional(),
+          clientSecret: z.string().optional(),
+          scopes: z.string().optional(),
+        }),
+      )
+      .optional(),
     redirectToAfterSignUp: z.string().optional(),
     redirectToAfterSignIn: z.string().optional(),
     redirectToAfterSignOut: z.string().optional(),
@@ -558,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),
+  );
+}