@lukoweb/apitogo 0.1.55 → 0.1.57

package/dist/flat-config.d.ts

@@ -64,7 +64,7 @@ export type _Schema15 = boolean
 /**
  * Gateway plan catalog for /pricing preview and publish (canonical storage).
  */
-export type _Schema35 = {
+export type _Schema37 = {
   sku: string
   displayName: string
   priceAmount?: number
@@ -73,31 +73,31 @@ export type _Schema35 = {
   limitsJson?: string
   includedActionKeys?: string[]
 }[]
-export type _Schema36 = ({
+export type _Schema38 = ({
   type: "url"
-  input: (string | _Schema37[])
-  server?: _Schema38
-  path?: _Schema39
-  categories?: _Schema40
-  options?: _Schema42
+  input: (string | _Schema39[])
+  server?: _Schema40
+  path?: _Schema41
+  categories?: _Schema42
+  options?: _Schema44
 } | {
   type: "file"
-  input: (string | (string | _Schema37)[])
-  server?: _Schema38
-  path?: _Schema39
-  categories?: _Schema40
-  options?: _Schema42
+  input: (string | (string | _Schema39)[])
+  server?: _Schema40
+  path?: _Schema41
+  categories?: _Schema42
+  options?: _Schema44
 } | {
   type: "raw"
   input: string
-  server?: _Schema38
-  path?: _Schema39
-  categories?: _Schema40
-  options?: _Schema42
+  server?: _Schema40
+  path?: _Schema41
+  categories?: _Schema42
+  options?: _Schema44
 })
-export type _Schema38 = string
-export type _Schema39 = string
-export type _Schema40 = {
+export type _Schema40 = string
+export type _Schema41 = string
+export type _Schema42 = {
   label: string
   tags: string[]
 }[]
@@ -396,10 +396,10 @@ export interface FlatZudokuConfig {
   modules?: {
     docs?: _Schema14
     landing?: _Schema16
-    userPanel?: _Schema23
+    userPanel?: _Schema25
   }
-  apis?: (_Schema36 | _Schema36[])
-  catalogs?: (_Schema43 | _Schema43[])
+  apis?: (_Schema38 | _Schema38[])
+  catalogs?: (_Schema45 | _Schema45[])
   apiKeys?: {
     enabled: boolean
     getConsumers?: unknown
@@ -427,7 +427,7 @@ export interface FlatZudokuConfig {
   }
   enableStatusPages?: boolean
   defaults?: {
-    apis: _Schema42
+    apis: _Schema44
     examplesLanguage?: string
   }
   __pluginDirs?: string[]
@@ -525,6 +525,10 @@ export interface _Schema16 {
    */
   layout?: ("default" | "landing" | "none")
   content?: _Schema21
+  /**
+   * When true, merge DEFAULT_LANDING_CONTENT for unset sections. When false or omitted, only configured sections are shown.
+   */
+  useDefaults?: boolean
 }
 /**
  * Default landing page content when no custom component is provided.
@@ -532,6 +536,10 @@ export interface _Schema16 {
 export interface _Schema21 {
   hero?: {
     title?: string
+    /**
+     * Accent-colored word or phrase shown on a new line after the title.
+     */
+    titleAccent?: string
     subtitle?: string
     description?: string
     badge?: string
@@ -542,13 +550,18 @@ export interface _Schema21 {
       code: string
     }
   }
+  featuresSection?: {
+    label?: string
+    title?: string
+    description?: string
+  }
   features?: {
     title: string
     description: string
     icon?: string
   }[]
-  primaryAction?: _Schema22
-  secondaryAction?: _Schema22
+  primaryAction?: _Schema23
+  secondaryAction?: _Schema23
   ticker?: {
     enabled?: boolean
     items?: {
@@ -581,19 +594,19 @@ export interface _Schema21 {
     enabled?: boolean
     title?: string
     description?: string
-    primaryAction?: _Schema22
-    secondaryAction?: _Schema22
+    primaryAction?: _Schema23
+    secondaryAction?: _Schema23
   }
   showPoweredBy?: boolean
 }
-export interface _Schema22 {
+export interface _Schema23 {
   label: string
   href: string
 }
 /**
  * User panel module — authenticated user area with sub-modules.
  */
-export interface _Schema23 {
+export interface _Schema25 {
   enabled?: _Schema15
   /**
    * Base path prefix for user panel routes.
@@ -615,7 +628,7 @@ export interface _Schema23 {
     component?: {
       [k: string]: unknown
     }
-    content?: _Schema30
+    content?: _Schema32
   }
   userManagement?: {
     enabled?: _Schema15
@@ -635,7 +648,7 @@ export interface _Schema23 {
     component?: {
       [k: string]: unknown
     }
-    content?: _Schema31
+    content?: _Schema33
   }
   apiKeys?: {
     enabled?: _Schema15
@@ -660,30 +673,30 @@ export interface _Schema23 {
     component?: {
       [k: string]: unknown
     }
-    content?: _Schema34
-    items?: _Schema35
+    content?: _Schema36
+    items?: _Schema37
   }
 }
 /**
  * Default dashboard page content when no custom component is provided.
  */
-export interface _Schema30 {
+export interface _Schema32 {
   title?: string
   subtitle?: string
   description?: string
-  quickLinks?: _Schema22[]
+  quickLinks?: _Schema23[]
 }
 /**
  * Default profile page content when no custom component is provided.
  */
-export interface _Schema31 {
+export interface _Schema33 {
   title?: string
   description?: string
 }
 /**
  * Default plans page content when no custom component is provided.
  */
-export interface _Schema34 {
+export interface _Schema36 {
   title?: string
   description?: string
   tiers?: {
@@ -692,12 +705,12 @@ export interface _Schema34 {
     description?: string
   }[]
 }
-export interface _Schema37 {
+export interface _Schema39 {
   path: string
   input: string
   label?: string
 }
-export interface _Schema42 {
+export interface _Schema44 {
   examplesLanguage?: string
   supportedLanguages?: {
     value: string
@@ -714,7 +727,7 @@ export interface _Schema42 {
   transformExamples?: unknown
   generateCodeSnippet?: unknown
 }
-export interface _Schema43 {
+export interface _Schema45 {
   path: string
   label: string
   items?: string[]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lukoweb/apitogo",
-  "version": "0.1.55",
+  "version": "0.1.57",
   "type": "module",
   "sideEffects": [
     "**/*.css",

package/src/config/default-landing-content.ts

@@ -0,0 +1,154 @@
+import type { ResolvedLandingContent } from "./validators/ModulesSchema.js";
+
+/** Default landing sections aligned with webapp-template/APIToGo.dc.html */
+export const DEFAULT_LANDING_CONTENT: ResolvedLandingContent = {
+  hero: {
+    badge: "99.98% uptime",
+    subtitle: "Production-ready APIs, one endpoint away",
+    title: "Developer APIs that ship",
+    titleAccent: "today.",
+    description:
+      "Documentation, interactive API reference, auth, and billing — sub-40ms responses, one API key, generous free tier.",
+    highlights: ["No credit card", "10k requests free", "SDKs for 6 languages"],
+    codeExample: {
+      filename: "example.sh",
+      language: "bash",
+      code: `$ curl https://api.example.com/v1/items \\
+  -H "Authorization: Bearer YOUR_API_KEY" \\
+  -d "limit=10"
+
+{
+  "items": [
+    { "id": "item_1", "name": "Widget", "status": "active" },
+    { "id": "item_2", "name": "Gadget", "status": "active" }
+  ]
+} // 28ms`,
+    },
+  },
+  primaryAction: { label: "Get your API key", href: "/register" },
+  secondaryAction: { label: "Read the docs", href: "/introduction" },
+  ticker: {
+    items: [
+      { label: "GET", value: "/v1/items", change: "28ms" },
+      { label: "POST", value: "/v1/items", change: "34ms" },
+      { label: "GET", value: "/v1/users", change: "19ms" },
+      { label: "PATCH", value: "/v1/users/{id}", change: "41ms" },
+      { label: "GET", value: "/v1/health", change: "16ms" },
+      { label: "DELETE", value: "/v1/items/{id}", change: "22ms" },
+      { label: "GET", value: "/v1/search", change: "47ms" },
+      { label: "POST", value: "/v1/auth/token", change: "52ms" },
+    ],
+  },
+  trust: {
+    title: "Trusted by teams shipping production APIs",
+    logos: ["Acme Corp", "BuildFast", "DataFlow", "ShipKit", "DevStack", "LaunchPad"],
+  },
+  featuresSection: {
+    label: "// why us",
+    title: "Everything you need to build on your API",
+    description:
+      "Skip the infra. We handle docs, auth, keys, and billing so you can focus on your product.",
+  },
+  features: [
+    {
+      icon: "gauge",
+      title: "Sub-40ms responses",
+      description:
+        "Edge-cached and globally distributed, so your app feels instant anywhere.",
+    },
+    {
+      icon: "radio",
+      title: "Real-time streams",
+      description:
+        "WebSocket feeds with automatic reconnection for live data and events.",
+    },
+    {
+      icon: "blocks",
+      title: "Unified schema",
+      description:
+        "One consistent API design — no per-endpoint glue code or custom adapters.",
+    },
+    {
+      icon: "shield-check",
+      title: "99.98% uptime",
+      description:
+        "Redundant infra with a public status page and an SLA on paid plans.",
+    },
+    {
+      icon: "code",
+      title: "SDKs for 6 languages",
+      description:
+        "Typed clients for JS, Python, Go, Rust, Ruby and PHP. Copy, paste, ship.",
+    },
+    {
+      icon: "webhook",
+      title: "Webhooks & alerts",
+      description:
+        "Push events and threshold alerts straight to your endpoints.",
+    },
+  ],
+  apiShowcase: {
+    title: "Production APIs. One key.",
+    browseAllLabel: "Browse all APIs",
+    browseAllHref: "/api",
+    autoFromOpenApi: true,
+    items: [
+      {
+        name: "List resources",
+        path: "/v1/items",
+        icon: "boxes",
+        latency: "28ms",
+      },
+      {
+        name: "Create resource",
+        path: "/v1/items",
+        icon: "badge-dollar-sign",
+        latency: "34ms",
+      },
+      {
+        name: "Get resource",
+        path: "/v1/items/{id}",
+        icon: "layers",
+        latency: "19ms",
+      },
+      {
+        name: "Search",
+        path: "/v1/search",
+        icon: "arrow-left-right",
+        latency: "41ms",
+      },
+      {
+        name: "User profile",
+        path: "/v1/users/me",
+        icon: "wallet",
+        latency: "52ms",
+      },
+      {
+        name: "Health check",
+        path: "/v1/health",
+        icon: "activity",
+        latency: "16ms",
+      },
+      {
+        name: "Metadata",
+        path: "/v1/meta",
+        icon: "coins",
+        latency: "22ms",
+      },
+      {
+        name: "Rate limits",
+        path: "/v1/limits",
+        icon: "gauge",
+        latency: "16ms",
+      },
+    ],
+  },
+  pricingCta: {
+    title: "Start free. Scale when you do.",
+    description:
+      "10,000 requests a month, free forever. Upgrade only when your app takes off.",
+    primaryAction: { label: "Create free account", href: "/register" },
+    secondaryAction: { label: "See pricing", href: "/pricing" },
+  },
+  showPoweredBy: true,
+};

package/src/config/resolve-modules.ts

@@ -1,3 +1,4 @@
+import { DEFAULT_LANDING_CONTENT } from "./default-landing-content.js";
 import {
   type ResolvedModulesConfig,
   ModulesSchema,
@@ -32,72 +33,137 @@ 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";
 
-  const resolved: ResolvedLandingContent = {
+  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.",
-      badge: content?.hero?.badge,
-      highlights: content?.hero?.highlights,
-      codeExample: content?.hero?.codeExample,
+      ...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",
     },
-    showPoweredBy: content?.showPoweredBy,
+    pricingCta: DEFAULT_LANDING_CONTENT.pricingCta
+      ? {
+          ...DEFAULT_LANDING_CONTENT.pricingCta,
+          primaryAction: {
+            label: "Get started",
+            href: "/introduction",
+          },
+          secondaryAction: {
+            label: "See pricing",
+            href: "/pricing",
+          },
+        }
+      : undefined,
   };
+};
 
-  if (content?.ticker && content.ticker.enabled !== false) {
-    resolved.ticker = content.ticker;
-  }
+export const resolveLandingContent = (
+  config: ZudokuConfig,
+  content?: LandingContentConfig,
+  options?: { useDefaults?: boolean },
+): ResolvedLandingContent => {
+  const siteTitle =
+    config.metadata?.applicationName ?? config.site?.title ?? "APIToGo";
 
-  if (content?.trust && content.trust.enabled !== false) {
-    resolved.trust = content.trust;
+  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),
+    };
   }
 
-  if (content?.apiShowcase && content.apiShowcase.enabled !== false) {
-    resolved.apiShowcase = content.apiShowcase;
-  }
+  const hasContent =
+    content !== undefined && Object.keys(content).length > 0;
 
-  if (content?.pricingCta && content.pricingCta.enabled !== false) {
-    resolved.pricingCta = content.pricingCta;
+  if (!hasContent) {
+    return {
+      hero: { title: siteTitle },
+      showPoweredBy: true,
+    };
   }
 
-  return resolved;
+  return {
+    hero: {
+      ...content.hero,
+      title: content.hero?.title ?? siteTitle,
+    },
+    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,
+  };
 };
 
 const DEFAULT_DASHBOARD_QUICK_LINKS: ResolvedDashboardContent["quickLinks"] = [
@@ -193,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

@@ -58,6 +58,10 @@ export const LandingCodeExampleSchema = z
 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(),
@@ -66,6 +70,14 @@ export const LandingHeroSchema = z
   })
   .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(),
@@ -120,6 +132,7 @@ export const LandingPricingCtaSchema = z
 export const LandingContentSchema = z
   .object({
     hero: LandingHeroSchema,
+    featuresSection: LandingFeaturesSectionSchema,
     features: z.array(LandingFeatureSchema).optional(),
     primaryAction: LandingLinkSchema.optional(),
     secondaryAction: LandingLinkSchema.optional(),
@@ -195,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({
@@ -326,12 +345,18 @@ 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;

package/src/lib/authentication/providers/dev-portal-utils.ts

@@ -66,6 +66,15 @@ export function buildDevPortalOidcChallengeUrl(
   return url.toString();
 }
 
+export function buildDevPortalLoginUrl(
+  apiBaseUrl: string,
+  returnUrl: string,
+): string {
+  const url = new URL("/api/v1/auth/login", apiBaseUrl);
+  url.searchParams.set("returnUrl", toAbsoluteReturnUrl(returnUrl));
+  return url.toString();
+}
+
 export function buildDevPortalLogoutUrl(
   apiBaseUrl: string,
   returnUrl: string,