@lukoweb/apitogo 0.1.127 → 0.1.130

package/dist/cli/cli.js

@@ -836,7 +836,7 @@ import { stat } from "node:fs/promises";
 var fileExists;
 var init_file_exists = __esm({
   "src/config/file-exists.ts"() {
-    fileExists = (path72) => stat(path72).then(() => true).catch(() => false);
+    fileExists = (path73) => stat(path73).then(() => true).catch(() => false);
   }
 });
 
@@ -5809,7 +5809,7 @@ import {
 // package.json
 var package_default = {
   name: "@lukoweb/apitogo",
-  version: "0.1.127",
+  version: "0.1.130",
   type: "module",
   sideEffects: [
     "**/*.css",
@@ -6588,14 +6588,14 @@ var flattenAllOf = (schema2) => {
 };
 
 // src/lib/util/traverse.ts
-var traverse = (specification, transform, path72 = []) => {
-  const transformed = transform(specification, path72);
+var traverse = (specification, transform, path73 = []) => {
+  const transformed = transform(specification, path73);
   if (typeof transformed !== "object" || transformed === null) {
     return transformed;
   }
   const result = Array.isArray(transformed) ? [] : {};
   for (const [key, value] of Object.entries(transformed)) {
-    const currentPath = [...path72, key];
+    const currentPath = [...path73, key];
     if (Array.isArray(value)) {
       result[key] = value.map(
         (item, index) => typeof item === "object" && item != null ? traverse(item, transform, [...currentPath, index.toString()]) : item
@@ -6623,9 +6623,9 @@ var resolveLocalRef = (schema2, ref) => {
   if (schemaCache?.has(ref)) {
     return schemaCache.get(ref);
   }
-  const path72 = ref.split("/").slice(1);
+  const path73 = ref.split("/").slice(1);
   let current = schema2;
-  for (const segment of path72) {
+  for (const segment of path73) {
     if (!current || typeof current !== "object") {
       current = null;
     }
@@ -6644,7 +6644,7 @@ var dereference = async (schema2, resolvers = []) => {
   }
   const cloned = structuredClone(schema2);
   const visited = /* @__PURE__ */ new Set();
-  const resolve = async (current, path72) => {
+  const resolve = async (current, path73) => {
     if (isIndexableObject(current)) {
       if (visited.has(current)) {
         return CIRCULAR_REF;
@@ -6652,7 +6652,7 @@ var dereference = async (schema2, resolvers = []) => {
       visited.add(current);
       if (Array.isArray(current)) {
         for (let index = 0; index < current.length; index++) {
-          current[index] = await resolve(current[index], `${path72}/${index}`);
+          current[index] = await resolve(current[index], `${path73}/${index}`);
         }
       } else {
         if ("$ref" in current && typeof current.$ref === "string") {
@@ -6663,13 +6663,13 @@ var dereference = async (schema2, resolvers = []) => {
           for (const resolver of resolvers) {
             const resolved = await resolver($ref);
             if (resolved) {
-              result2 = await resolve(resolved, path72);
+              result2 = await resolve(resolved, path73);
               break;
             }
           }
           if (result2 === void 0) {
             const resolved = await resolveLocalRef(cloned, $ref);
-            result2 = await resolve(resolved, path72);
+            result2 = await resolve(resolved, path73);
           }
           if (hasSiblings) {
             if (result2 === CIRCULAR_REF) {
@@ -6682,7 +6682,7 @@ var dereference = async (schema2, resolvers = []) => {
           return result2;
         }
         for (const key in current) {
-          current[key] = await resolve(current[key], `${path72}/${key}`);
+          current[key] = await resolve(current[key], `${path73}/${key}`);
         }
       }
       visited.delete(current);
@@ -6721,9 +6721,9 @@ var upgradeSchema = (schema2) => {
     }
     return sub;
   });
-  schema2 = traverse(schema2, (sub, path72) => {
+  schema2 = traverse(schema2, (sub, path73) => {
     if (sub.example !== void 0) {
-      if (isSchemaPath(path72 ?? [])) {
+      if (isSchemaPath(path73 ?? [])) {
         sub.examples = [sub.example];
       } else {
         sub.examples = {
@@ -6736,11 +6736,11 @@ var upgradeSchema = (schema2) => {
     }
     return sub;
   });
-  schema2 = traverse(schema2, (schema3, path72) => {
+  schema2 = traverse(schema2, (schema3, path73) => {
     if (schema3.type === "object" && schema3.properties !== void 0) {
-      const parentPath = path72?.slice(0, -1);
+      const parentPath = path73?.slice(0, -1);
       const isMultipart = parentPath?.some((segment, index) => {
-        return segment === "content" && path72?.[index + 1] === "multipart/form-data";
+        return segment === "content" && path73?.[index + 1] === "multipart/form-data";
       });
       if (isMultipart) {
         const entries = Object.entries(schema3.properties);
@@ -6754,8 +6754,8 @@ var upgradeSchema = (schema2) => {
     }
     return schema3;
   });
-  schema2 = traverse(schema2, (schema3, path72) => {
-    if (path72?.includes("content") && path72.includes("application/octet-stream")) {
+  schema2 = traverse(schema2, (schema3, path73) => {
+    if (path73?.includes("content") && path73.includes("application/octet-stream")) {
       return {};
     }
     if (schema3.type === "string" && schema3.format === "binary") {
@@ -6781,11 +6781,11 @@ var upgradeSchema = (schema2) => {
     }
     return sub;
   });
-  schema2 = traverse(schema2, (schema3, path72) => {
+  schema2 = traverse(schema2, (schema3, path73) => {
     if (schema3.type === "string" && schema3.format === "byte") {
-      const parentPath = path72?.slice(0, -1);
+      const parentPath = path73?.slice(0, -1);
       const contentMediaType = parentPath?.find(
-        (_, index) => path72?.[index - 1] === "content"
+        (_, index) => path73?.[index - 1] === "content"
       );
       return {
         type: "string",
@@ -6797,7 +6797,7 @@ var upgradeSchema = (schema2) => {
   });
   return schema2;
 };
-function isSchemaPath(path72) {
+function isSchemaPath(path73) {
   const schemaLocations = [
     ["components", "schemas"],
     "properties",
@@ -6810,10 +6810,10 @@ function isSchemaPath(path72) {
   ];
   return schemaLocations.some((location) => {
     if (Array.isArray(location)) {
-      return location.every((segment, index) => path72[index] === segment);
+      return location.every((segment, index) => path73[index] === segment);
     }
-    return path72.includes(location);
-  }) || path72.includes("schema") || path72.some((segment) => segment.endsWith("Schema"));
+    return path73.includes(location);
+  }) || path73.includes("schema") || path73.some((segment) => segment.endsWith("Schema"));
 }
 
 // src/lib/oas/parser/index.ts
@@ -6895,13 +6895,13 @@ var OPENAPI_PROPS = /* @__PURE__ */ new Set([
   "anyOf",
   "oneOf"
 ]);
-var handleCircularRefs = (obj, currentPath = /* @__PURE__ */ new WeakSet(), refs = /* @__PURE__ */ new WeakMap(), path72 = [], currentRefPaths = /* @__PURE__ */ new Set()) => {
+var handleCircularRefs = (obj, currentPath = /* @__PURE__ */ new WeakSet(), refs = /* @__PURE__ */ new WeakMap(), path73 = [], currentRefPaths = /* @__PURE__ */ new Set()) => {
   if (obj === null || typeof obj !== "object") return obj;
   const refPath = obj.__$ref;
   const isCircular = currentPath.has(obj) || typeof refPath === "string" && currentRefPaths.has(refPath);
   if (isCircular) {
     if (typeof refPath === "string") return SCHEMA_REF_PREFIX + refPath;
-    const circularProp = path72.find((p) => !OPENAPI_PROPS.has(p)) || path72[0];
+    const circularProp = path73.find((p) => !OPENAPI_PROPS.has(p)) || path73[0];
     return [CIRCULAR_REF, circularProp].filter(Boolean).join(":");
   }
   if (refs.has(obj)) return refs.get(obj);
@@ -6911,7 +6911,7 @@ var handleCircularRefs = (obj, currentPath = /* @__PURE__ */ new WeakSet(), refs
     value,
     currentPath,
     refs,
-    [...path72, key],
+    [...path73, key],
     currentRefPaths
   );
   const result = Array.isArray(obj) ? obj.map((item, i) => recurse(item, i.toString())) : Object.fromEntries(
@@ -6946,7 +6946,7 @@ var resolveExtensions = (obj) => Object.fromEntries(
 var getAllTags = (schema2) => {
   const rootTags = schema2.tags ?? [];
   const operations = Object.values(schema2.paths ?? {}).flatMap(
-    (path72) => HttpMethods.map((k) => path72?.[k]).filter((op) => op != null)
+    (path73) => HttpMethods.map((k) => path73?.[k]).filter((op) => op != null)
   );
   const operationTags = new Set(operations.flatMap((op) => op.tags ?? []));
   const hasUntaggedOperations = operations.some(
@@ -7001,7 +7001,7 @@ var getAllSlugs = (ops, schemaTags = []) => {
 var getOperationSlugKey = (op) => [op.path, op.method, op.operationId, op.summary].filter(Boolean).join("-");
 var getAllOperations = (paths) => {
   const operations = Object.entries(paths ?? {}).flatMap(
-    ([path72, value]) => HttpMethods.flatMap((method) => {
+    ([path73, value]) => HttpMethods.flatMap((method) => {
       if (!value?.[method]) return [];
       const operation = value[method];
       const pathParameters = value.parameters ?? [];
@@ -7021,7 +7021,7 @@ var getAllOperations = (paths) => {
       return {
         ...operation,
         method,
-        path: path72,
+        path: path73,
         parameters,
         servers,
         tags: operation.tags ?? []
@@ -7379,8 +7379,8 @@ var Schema = builder.objectRef("Schema").implement({
     }),
     paths: t.field({
       type: [PathItem],
-      resolve: (root) => Object.entries(root.paths ?? {}).map(([path72, value]) => ({
-        path: path72,
+      resolve: (root) => Object.entries(root.paths ?? {}).map(([path73, value]) => ({
+        path: path73,
         // biome-ignore lint/style/noNonNullAssertion: value is guaranteed to be defined
         methods: Object.keys(value)
       }))
@@ -7545,7 +7545,7 @@ init_joinUrl();
 
 // src/vite/api/schema-codegen.ts
 var unescapeJsonPointer = (uri) => decodeURIComponent(uri.replace(/~1/g, "/").replace(/~0/g, "~"));
-var getSegmentsFromPath = (path72) => path72.split("/").slice(1).map(unescapeJsonPointer);
+var getSegmentsFromPath = (path73) => path73.split("/").slice(1).map(unescapeJsonPointer);
 var createLocalRefMap = (obj) => {
   const refMap = /* @__PURE__ */ new Map();
   const siblingsMap = /* @__PURE__ */ new Map();
@@ -7576,16 +7576,16 @@ var replaceMarkers = (code, mergedRefs) => code.replace(/"__refMap:(.*?)"/g, '__
   /"__refMap\+Siblings:(.*?)"/g,
   (_, key) => mergedRefs.get(key) ?? `__refMap["${key}"]`
 );
-var lookup = (schema2, path72, filePath) => {
-  const parts = getSegmentsFromPath(path72);
+var lookup = (schema2, path73, filePath) => {
+  const parts = getSegmentsFromPath(path73);
   let val = schema2;
   for (const part of parts) {
     while (val.$ref?.startsWith("#/")) {
-      val = val.$ref === path72 ? val : lookup(schema2, val.$ref, filePath);
+      val = val.$ref === path73 ? val : lookup(schema2, val.$ref, filePath);
     }
     if (val[part] === void 0) {
       throw new Error(
-        `Error in ${filePath ?? "code generation"}: Could not find path segment ${part} in path: ${path72}`
+        `Error in ${filePath ?? "code generation"}: Could not find path segment ${part} in path: ${path73}`
       );
     }
     val = val[part];
@@ -7830,8 +7830,8 @@ var SchemaManager = class {
       }
     }
   };
-  getLatestSchema = (path72) => this.processedSchemas[path72]?.at(0);
-  getSchemasForPath = (path72) => this.processedSchemas[path72];
+  getLatestSchema = (path73) => this.processedSchemas[path73]?.at(0);
+  getSchemasForPath = (path73) => this.processedSchemas[path73];
   getSchemaImports = () => Object.values(this.processedSchemas).flat().filter((s) => s.importKey);
   getUrlToFilePathMap = () => {
     const map = /* @__PURE__ */ new Map();
@@ -10269,14 +10269,14 @@ async function generateSitemap({
 
 // src/vite/prerender/utils.ts
 init_joinUrl();
-var resolveRoutePath = (path72) => {
-  const segments = path72.split("/");
+var resolveRoutePath = (path73) => {
+  const segments = path73.split("/");
   if (segments.some((s) => s.startsWith(":") && !s.endsWith("?"))) {
     return void 0;
   }
   return segments.filter((s) => !s.startsWith(":")).join("/") || void 0;
 };
-var isSkipped = (path72) => path72.includes("*") || /^\d+$/.test(path72);
+var isSkipped = (path73) => path73.includes("*") || /^\d+$/.test(path73);
 var resolveRoutes = (routes, parentPath = "") => routes.flatMap((route) => {
   if (route.path && isSkipped(route.path)) return [];
   const routePath = route.path ? resolveRoutePath(route.path) : void 0;
@@ -10908,8 +10908,8 @@ var PlatformApiClient = class {
   constructor(config2) {
     this.config = config2;
   }
-  url(path72) {
-    return `${this.config.apiUrl}${path72.startsWith("/") ? path72 : `/${path72}`}`;
+  url(path73) {
+    return `${this.config.apiUrl}${path73.startsWith("/") ? path73 : `/${path73}`}`;
   }
   headers(extra) {
     return {
@@ -10919,9 +10919,9 @@ var PlatformApiClient = class {
       ...extra
     };
   }
-  async request(method, path72, init4) {
+  async request(method, path73, init4) {
     const response = await fetchWithRetry(
-      this.url(path72),
+      this.url(path73),
       {
         method,
         ...init4,
@@ -11133,15 +11133,15 @@ var PlatformApiClient = class {
       }
     );
   }
-  deleteDevPortalPage(projectId, path72) {
-    const query = new URLSearchParams({ path: path72 });
+  deleteDevPortalPage(projectId, path73) {
+    const query = new URLSearchParams({ path: path73 });
     return this.request(
       "DELETE",
       `/api/v1/projects/${projectId}/dev-portal/pages/files?${query.toString()}`
     );
   }
-  renameDevPortalPage(projectId, path72, newName) {
-    const query = new URLSearchParams({ path: path72 });
+  renameDevPortalPage(projectId, path73, newName) {
+    const query = new URLSearchParams({ path: path73 });
     return this.request(
       "POST",
       `/api/v1/projects/${projectId}/dev-portal/pages/files/rename?${query.toString()}`,
@@ -16205,7 +16205,7 @@ async function ensureTsconfigJson(dir) {
     return true;
   }
 }
-var LANDING_PAGE_SOURCE = 'import {\n  ApiShowcaseSection,\n  FeaturesSection,\n  HeroSection,\n  LandingShell,\n  PlansPreviewSection,\n  PricingCtaSection,\n  StepsSection,\n} from "@lukoweb/apitogo-module-landing";\n\nexport default function LandingPage() {\n  return (\n    <LandingShell\n      title="Test against a real API before you build one"\n      description="Sample API gives you realistic endpoints, authentication, rate limits, and webhooks \u2014 a fully working backend for prototypes, demos, and QA."\n    >\n      <HeroSection\n        hero={{\n          badge: "SANDBOX API",\n          title: "Test against a real API before you build one",\n          description:\n            "Sample API gives you realistic endpoints, authentication, rate limits, and webhooks \u2014 a fully working backend for prototypes, demos, and QA. No setup, no infrastructure.",\n        }}\n        primaryAction={{ label: "Start for free", href: "/signup" }}\n        secondaryAction={{ label: "Read the docs", href: "/introduction" }}\n        codeExamples={[\n          {\n            filename: "Create a key",\n            language: "bash",\n            code: `$ curl -X POST https://api.sampleapi.dev/v1/keys\n# sk_live_9f2c7a1e...`,\n          },\n          {\n            filename: "Call an endpoint",\n            language: "bash",\n            code: `$ curl https://api.sampleapi.dev/v1/users/42 \\\\\n  -H "Authorization: Bearer sk_live_9f2c..."\n# { "id": 42, "name": "Priya Shah", "plan": "pro" }`,\n          },\n        ]}\n      />\n      <FeaturesSection\n        section={{\n          label: "Everything a real API has",\n          title: "Built for testing, not just browsing",\n          description:\n            "Realistic data, live auth, rate limits, and webhooks \u2014 so you can ship with confidence.",\n        }}\n        features={[\n          {\n            title: "Realistic mock data",\n            description:\n              "Users, orders, products, and posts with relationships and pagination, not lorem ipsum.",\n            icon: "boxes",\n          },\n          {\n            title: "Real auth flow",\n            description:\n              "Every request checks a live API key, so you can test error handling and expiry.",\n            icon: "shield-check",\n          },\n          {\n            title: "Rate limiting",\n            description:\n              "Per-plan request limits and 429 responses, so you can build and test backoff logic.",\n            icon: "gauge",\n          },\n          {\n            title: "Webhooks",\n            description:\n              "Trigger test events and inspect delivered payloads and retries.",\n            icon: "webhook",\n          },\n          {\n            title: "OpenAPI & docs",\n            description:\n              "A full OpenAPI spec and reference docs for every endpoint.",\n            icon: "book-open",\n          },\n          {\n            title: "Usage analytics",\n            description:\n              "Track requests, latency, and errors per key from your dashboard.",\n            icon: "activity",\n          },\n        ]}\n      />\n      <StepsSection\n        steps={[\n          {\n            step: "01",\n            title: "Create an account",\n            description:\n              "Sign up and land straight in your dashboard \u2014 no approval queue.",\n          },\n          {\n            step: "02",\n            title: "Generate a key",\n            description:\n              "Every key is scoped and rate-limited to your plan from the moment it\'s created.",\n          },\n          {\n            step: "03",\n            title: "Call any endpoint",\n            description:\n              "Users, orders, products, posts, and webhooks \u2014 all documented, all live.",\n          },\n        ]}\n      />\n      <ApiShowcaseSection\n        apiShowcase={{\n          title: "Sample endpoints",\n          subtitle:\n            "A slice of what\'s available \u2014 see the full reference in the docs.",\n          browseAllHref: "/api",\n          browseAllLabel: "Browse all APIs",\n          layout: "list",\n          items: [\n            {\n              name: "List paginated users",\n              path: "/v1/users",\n              method: "GET",\n              summary: "List paginated users",\n            },\n            {\n              name: "Create a mock order",\n              path: "/v1/orders",\n              method: "POST",\n              summary: "Create a mock order",\n            },\n            {\n              name: "Fetch one product",\n              path: "/v1/products/{id}",\n              method: "GET",\n              summary: "Fetch one product",\n            },\n            {\n              name: "List posts with comments",\n              path: "/v1/posts",\n              method: "GET",\n              summary: "List posts with comments",\n            },\n            {\n              name: "Fire a test webhook event",\n              path: "/v1/webhooks/test",\n              method: "POST",\n              summary: "Fire a test webhook event",\n            },\n            {\n              name: "Delete a mock order",\n              path: "/v1/orders/{id}",\n              method: "DELETE",\n              summary: "Delete a mock order",\n            },\n          ],\n        }}\n      />\n      <PlansPreviewSection\n        plans={[\n          {\n            name: "Free",\n            price: "$0",\n            unit: "per month",\n            blurb: "1,000 requests/mo.",\n          },\n          {\n            name: "Developer",\n            price: "$19",\n            unit: "per month",\n            blurb: "50,000 requests/mo, webhooks included.",\n            featured: true,\n          },\n          {\n            name: "Team",\n            price: "$79",\n            unit: "per month",\n            blurb: "500,000 requests/mo, 5 team seats.",\n          },\n          {\n            name: "Enterprise",\n            price: "$299",\n            unit: "per month",\n            blurb: "Unlimited requests, SSO, SLA.",\n          },\n        ]}\n      />\n      <PricingCtaSection\n        variant="banner"\n        pricingCta={{\n          title: "Start testing in minutes",\n          description:\n            "Free tier includes 1,000 requests a month \u2014 no card required.",\n          primaryAction: { label: "Start for free", href: "/signup" },\n        }}\n      />\n    </LandingShell>\n  );\n}\n';
+var LANDING_PAGE_SOURCE = 'import {\n  ApiShowcaseSection,\n  FeaturesSection,\n  HeroSection,\n  LandingShell,\n  PlansPreviewSection,\n  PricingCtaSection,\n  StepsSection,\n} from "@lukoweb/apitogo-module-landing";\n\nexport default function LandingPage() {\n  return (\n    <LandingShell\n      title="Test against a real API before you build one"\n      description="Sample API gives you realistic endpoints, authentication, rate limits, and webhooks \u2014 a fully working backend for prototypes, demos, and QA."\n    >\n      <HeroSection\n        hero={{\n          badge: "SANDBOX API",\n          title: "Test against a real API before you build one",\n          description:\n            "Sample API gives you realistic endpoints, authentication, rate limits, and webhooks \u2014 a fully working backend for prototypes, demos, and QA. No setup, no infrastructure.",\n        }}\n        primaryAction={{ label: "Start for free", href: "/signup" }}\n        secondaryAction={{ label: "Read the docs", href: "/introduction" }}\n        codeExamples={[\n          {\n            filename: "Create a key",\n            language: "bash",\n            code: `$ curl -X POST https://api.sampleapi.dev/v1/keys\n# sk_live_9f2c7a1e...`,\n          },\n          {\n            filename: "Call an endpoint",\n            language: "bash",\n            code: `$ curl https://api.sampleapi.dev/v1/users/42 \\\\\n  -H "Authorization: Bearer sk_live_9f2c..."\n# { "id": 42, "name": "Priya Shah", "plan": "pro" }`,\n          },\n        ]}\n      />\n      <FeaturesSection\n        section={{\n          label: "Everything a real API has",\n          title: "Built for testing, not just browsing",\n          description:\n            "Realistic data, live auth, rate limits, and webhooks \u2014 so you can ship with confidence.",\n        }}\n        features={[\n          {\n            title: "Realistic mock data",\n            description:\n              "Users, orders, products, and posts with relationships and pagination, not lorem ipsum.",\n            icon: "boxes",\n          },\n          {\n            title: "Real auth flow",\n            description:\n              "Every request checks a live API key, so you can test error handling and expiry.",\n            icon: "shield-check",\n          },\n          {\n            title: "Rate limiting",\n            description:\n              "Per-plan request limits and 429 responses, so you can build and test backoff logic.",\n            icon: "gauge",\n          },\n          {\n            title: "Webhooks",\n            description:\n              "Trigger test events and inspect delivered payloads and retries.",\n            icon: "webhook",\n          },\n          {\n            title: "OpenAPI & docs",\n            description:\n              "A full OpenAPI spec and reference docs for every endpoint.",\n            icon: "book-open",\n          },\n          {\n            title: "Usage analytics",\n            description:\n              "Track requests, latency, and errors per key from your dashboard.",\n            icon: "activity",\n          },\n        ]}\n      />\n      <StepsSection\n        steps={[\n          {\n            step: "01",\n            title: "Create an account",\n            description:\n              "Sign up and land straight in your dashboard \u2014 no approval queue.",\n          },\n          {\n            step: "02",\n            title: "Generate a key",\n            description:\n              "Every key is scoped and rate-limited to your plan from the moment it\'s created.",\n          },\n          {\n            step: "03",\n            title: "Call any endpoint",\n            description:\n              "Users, orders, products, posts, and webhooks \u2014 all documented, all live.",\n          },\n        ]}\n      />\n      {/* Static sample list. To show your real API operations from the dev portal\n          backend instead, see https://docs.apitogo.com/docs/customization/landing-page#live-apis */}\n      <ApiShowcaseSection\n        apiShowcase={{\n          title: "Sample endpoints",\n          subtitle:\n            "A slice of what\'s available \u2014 see the full reference in the docs.",\n          browseAllHref: "/api",\n          browseAllLabel: "Browse all APIs",\n          layout: "list",\n          items: [\n            {\n              name: "List paginated users",\n              path: "/v1/users",\n              method: "GET",\n              summary: "List paginated users",\n            },\n            {\n              name: "Create a mock order",\n              path: "/v1/orders",\n              method: "POST",\n              summary: "Create a mock order",\n            },\n            {\n              name: "Fetch one product",\n              path: "/v1/products/{id}",\n              method: "GET",\n              summary: "Fetch one product",\n            },\n            {\n              name: "List posts with comments",\n              path: "/v1/posts",\n              method: "GET",\n              summary: "List posts with comments",\n            },\n            {\n              name: "Fire a test webhook event",\n              path: "/v1/webhooks/test",\n              method: "POST",\n              summary: "Fire a test webhook event",\n            },\n            {\n              name: "Delete a mock order",\n              path: "/v1/orders/{id}",\n              method: "DELETE",\n              summary: "Delete a mock order",\n            },\n          ],\n        }}\n      />\n      <PlansPreviewSection\n        plans={[\n          {\n            name: "Free",\n            price: "$0",\n            unit: "per month",\n            blurb: "1,000 requests/mo.",\n          },\n          {\n            name: "Developer",\n            price: "$19",\n            unit: "per month",\n            blurb: "50,000 requests/mo, webhooks included.",\n            featured: true,\n          },\n          {\n            name: "Team",\n            price: "$79",\n            unit: "per month",\n            blurb: "500,000 requests/mo, 5 team seats.",\n          },\n          {\n            name: "Enterprise",\n            price: "$299",\n            unit: "per month",\n            blurb: "Unlimited requests, SSO, SLA.",\n          },\n        ]}\n      />\n      <PricingCtaSection\n        variant="banner"\n        pricingCta={{\n          title: "Start testing in minutes",\n          description:\n            "Free tier includes 1,000 requests a month \u2014 no card required.",\n          primaryAction: { label: "Start for free", href: "/signup" },\n        }}\n      />\n    </LandingShell>\n  );\n}\n';
 var ACCOUNT_PLANS_PAGE_SOURCE = `export { AccountPlansPage as default } from "@lukoweb/apitogo-plugin-dev-portal-billing";
 `;
 var DASHBOARD_PAGE_SOURCE = `export { OverviewDashboardPage as default } from "@lukoweb/apitogo-plugin-dev-portal-billing";
@@ -17129,8 +17129,8 @@ function normalizeActionKey(actionKey) {
   const trimmed = actionKey.trim();
   if (trimmed.includes(":")) {
     const [method2, ...pathParts] = trimmed.split(":");
-    const path73 = pathParts.join(":").trim();
-    return `${method2?.toLowerCase()}:${path73.startsWith("/") ? path73 : `/${path73}`}`;
+    const path74 = pathParts.join(":").trim();
+    return `${method2?.toLowerCase()}:${path74.startsWith("/") ? path74 : `/${path74}`}`;
   }
   const spaceIndex = trimmed.indexOf(" ");
   if (spaceIndex <= 0) {
@@ -17139,8 +17139,8 @@ function normalizeActionKey(actionKey) {
     );
   }
   const method = trimmed.slice(0, spaceIndex).trim().toLowerCase();
-  const path72 = trimmed.slice(spaceIndex + 1).trim();
-  return `${method}:${path72.startsWith("/") ? path72 : `/${path72}`}`;
+  const path73 = trimmed.slice(spaceIndex + 1).trim();
+  return `${method}:${path73.startsWith("/") ? path73 : `/${path73}`}`;
 }
 async function applyGatewayPublicRoutes(client, projectId, routes, options) {
   const applied = [];
@@ -17758,8 +17758,8 @@ function normalizeActionKeyFormat(actionKey) {
   const trimmed = actionKey.trim();
   if (trimmed.includes(":")) {
     const [method2, ...pathParts] = trimmed.split(":");
-    const path73 = pathParts.join(":").trim();
-    return `${method2.toLowerCase()}:${path73.startsWith("/") ? path73 : `/${path73}`}`;
+    const path74 = pathParts.join(":").trim();
+    return `${method2.toLowerCase()}:${path74.startsWith("/") ? path74 : `/${path74}`}`;
   }
   const spaceIndex = trimmed.indexOf(" ");
   if (spaceIndex <= 0) {
@@ -17768,8 +17768,8 @@ function normalizeActionKeyFormat(actionKey) {
     );
   }
   const method = trimmed.slice(0, spaceIndex).trim().toLowerCase();
-  const path72 = trimmed.slice(spaceIndex + 1).trim();
-  return `${method}:${path72.startsWith("/") ? path72 : `/${path72}`}`;
+  const path73 = trimmed.slice(spaceIndex + 1).trim();
+  return `${method}:${path73.startsWith("/") ? path73 : `/${path73}`}`;
 }
 function normalizePublicRoute(route) {
   const trimmed = route.trim();
@@ -18273,17 +18273,14 @@ function isWarmPoolInfrastructureTerminal(project) {
   return status2 === "ready" || status2 === "failed" || status2 === "deleting";
 }
 function shouldSkipColdModuleInfrastructureWait(project, infraStatus) {
-  if (isWarmPoolInfrastructureReady(project)) {
-    return true;
-  }
   const resourceType = infraStatus?.resourceType;
-  if (resourceType === "WarmPoolBinding") {
-    return true;
-  }
   if (resourceType && COLD_MODULE_INFRA_RESOURCE_TYPES.has(resourceType)) {
     return false;
   }
-  return false;
+  if (resourceType === "WarmPoolBinding") {
+    return true;
+  }
+  return isWarmPoolInfrastructureReady(project);
 }
 function resolvePortalBackendFqdn(project) {
   const portalApiUrl = project.portalApiUrl?.trim();
@@ -22812,8 +22809,8 @@ import readline from "node:readline/promises";
 import open2 from "open";
 
 // src/cli/platform/device-auth.ts
-function url(apiUrl, path72) {
-  return `${apiUrl}${path72.startsWith("/") ? path72 : `/${path72}`}`;
+function url(apiUrl, path73) {
+  return `${apiUrl}${path73.startsWith("/") ? path73 : `/${path73}`}`;
 }
 async function requestDeviceCode(apiUrl) {
   const response = await fetchWithRetry(
@@ -23730,8 +23727,79 @@ function createApitogoCli(argv) {
   }).middleware(warnPackageVersionMismatch).command(command(init_default)).command(command(config_default)).command(command(run_default)).command(command(build_default)).command(command(check_default)).command(command(project_create_default)).command(command(deploy_default)).command(command(status_default)).command(command(teardown_default)).command(command(login_default)).command(command(logout_default)).demandCommand().strictCommands().version(packageJson?.version).fail(false).help();
 }
 
+// src/cli/local-handoff.ts
+import { spawn as spawn4 } from "node:child_process";
+import { existsSync as existsSync6, realpathSync } from "node:fs";
+import path72 from "node:path";
+var LOCAL_HANDOFF_ENV = "APITOGO_LOCAL_CLI";
+var PACKAGE_NAME = "@lukoweb/apitogo";
+var resolveProjectDir = (argv, cwd) => {
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    const next = argv[i + 1];
+    if (arg === "--dir" && next) return path72.resolve(cwd, next);
+    if (arg?.startsWith("--dir=")) {
+      return path72.resolve(cwd, arg.slice("--dir=".length));
+    }
+  }
+  return cwd;
+};
+var findLocalCli = (projectDir, runningRoot) => {
+  let dir = path72.resolve(projectDir);
+  let localPackageRoot;
+  while (!localPackageRoot) {
+    const candidate = path72.join(dir, "node_modules", PACKAGE_NAME);
+    if (existsSync6(path72.join(candidate, "package.json"))) {
+      localPackageRoot = candidate;
+    } else if (dir === path72.dirname(dir)) {
+      return void 0;
+    } else {
+      dir = path72.dirname(dir);
+    }
+  }
+  const localRoot = realpathSync(localPackageRoot);
+  if (localRoot === realpathSync(runningRoot)) return void 0;
+  return path72.join(localRoot, "cli.js");
+};
+var handoffToLocalCli = async (argv, runningRoot) => {
+  if (process.env[LOCAL_HANDOFF_ENV] || process.env.ZUDOKU_ENV === "internal") {
+    return void 0;
+  }
+  const localCli = findLocalCli(
+    resolveProjectDir(argv, process.cwd()),
+    runningRoot
+  );
+  if (!localCli) return void 0;
+  printDiagnosticsToConsole(
+    `Using the project's local ${PACKAGE_NAME} (${path72.dirname(localCli)})`
+  );
+  const child = spawn4(process.execPath, [localCli, ...argv], {
+    stdio: "inherit",
+    env: { ...process.env, [LOCAL_HANDOFF_ENV]: "1" }
+  });
+  process.on("SIGINT", () => {
+  });
+  process.on("SIGTERM", () => child.kill("SIGTERM"));
+  return new Promise((resolve) => {
+    child.on("error", (err) => {
+      printDiagnosticsToConsole(
+        `Failed to start local ${PACKAGE_NAME}: ${err.message}`
+      );
+      resolve(1);
+    });
+    child.on("exit", (code, signal) => resolve(code ?? (signal ? 1 : 0)));
+  });
+};
+
 // src/cli/cli.ts
 process.env.ZUDOKU_ENV = process.env.ZUDOKU_INTERNAL_DEV ? "internal" : "module";
+var handoffExitCode = await handoffToLocalCli(
+  hideBin(process.argv),
+  getZudokuRootDir()
+);
+if (handoffExitCode !== void 0) {
+  process.exit(handoffExitCode);
+}
 var packageJson2 = getZudokuPackageJson();
 if (SENTRY_DSN) {
   Sentry2.init({

package/dist/declarations/cli/platform/helpers/dev-portal-landing.d.ts

@@ -34,6 +34,7 @@ export type LandingTrustInput = {
 export type LandingApiShowcaseItemInput = {
     name: string;
     path: string;
+    method?: string;
     icon?: string;
     latency?: string;
     summary?: string;

package/docs/customization/landing-page.md

@@ -0,0 +1,159 @@
+---
+sidebar_icon: house
+title: Landing Page
+description:
+  Customize your dev portal home page and show your real API operations in the API showcase, loaded
+  live from your dev portal backend.
+---
+
+A scaffolded dev portal home page lives in `landing/LandingPage.tsx`. It composes section components
+from `@lukoweb/apitogo-module-landing` inside a `LandingShell`:
+
+| Component             | Purpose                                       |
+| --------------------- | --------------------------------------------- |
+| `HeroSection`         | Headline, description, CTAs and code examples |
+| `TrustSection`        | Logos or social proof                         |
+| `FeaturesSection`     | Feature grid                                  |
+| `StepsSection`        | Numbered "how it works" steps                 |
+| `ApiShowcaseSection`  | Grid or method + path list of your API        |
+| `PlansPreviewSection` | Short plan comparison linking to `/pricing`   |
+| `PricingCtaSection`   | Closing call to action                        |
+
+Edit the file directly to add, remove or reorder sections. The site footer is configured separately
+in `apitogo.config.json` under `modules.landing.content.footer` (see
+[Footer](/docs/configuration/footer)).
+
+## API showcase
+
+`ApiShowcaseSection` renders the items you pass it. The scaffold ships with a **static sample
+list**:
+
+```tsx
+<ApiShowcaseSection
+  apiShowcase={{
+    title: "Sample endpoints",
+    layout: "list", // or "grid"
+    browseAllHref: "/api",
+    items: [
+      { name: "List users", path: "/v1/users", method: "GET", summary: "List paginated users" },
+    ],
+  }}
+/>
+```
+
+Each item accepts `name`, `path`, and optionally `method`, `summary`, `icon` and `latency`.
+
+## Live APIs
+
+Instead of maintaining the list by hand, you can load your API's real operations. Your dev portal
+backend syncs the **gateway actions** of your project (every operation discovered from the OpenAPI
+spec you deployed) and serves them publicly at `GET /api/v1/actions`. The `useGatewayActions()` hook
+fetches that list; you decide what to show and pass the result to `ApiShowcaseSection`.
+
+```tsx
+import {
+  ApiShowcaseSection,
+  LandingShell,
+  toApiShowcaseItems,
+  useGatewayActions,
+} from "@lukoweb/apitogo-module-landing";
+
+const staticItems = [
+  { name: "List users", path: "/v1/users", method: "GET", summary: "List paginated users" },
+];
+
+// Optional friendly labels, keyed by action key (`method:path`, lower-case method).
+const labels: Record<string, string> = {
+  "get:/v1/users": "List paginated users",
+  "post:/v1/orders": "Create an order",
+};
+
+export default function LandingPage() {
+  const { data } = useGatewayActions({ inPlan: true });
+
+  const liveItems = toApiShowcaseItems(
+    (data?.actions ?? []).filter((action) => action.path.startsWith("/v1/")).slice(0, 6),
+    labels,
+  );
+
+  return (
+    <LandingShell title="My API">
+      <ApiShowcaseSection
+        apiShowcase={{
+          title: "Our APIs",
+          layout: "list",
+          browseAllHref: "/api",
+          items: liveItems.length > 0 ? liveItems : staticItems,
+        }}
+      />
+    </LandingShell>
+  );
+}
+```
+
+### Filters
+
+`useGatewayActions()` accepts server-side filters. All filters are combined:
+
+| Option       | Type      | Description                                            |
+| ------------ | --------- | ------------------------------------------------------ |
+| `inPlan`     | `boolean` | Only actions included in at least one active plan      |
+| `plan`       | `string`  | Only actions included in the plan with this SKU        |
+| `isPublic`   | `boolean` | Only actions callable without an API key (or only not) |
+| `method`     | `string`  | HTTP method, e.g. `GET`                                |
+| `pathPrefix` | `string`  | Path prefix, e.g. `/v1/orders`                         |
+| `limit`      | `number`  | Maximum number of actions (server cap: 500)            |
+| `enabled`    | `boolean` | Set to `false` to skip the request                     |
+
+Anything else — sorting, renaming, grouping, picking a hand-curated subset — is up to you in plain
+TypeScript before you build the items.
+
+Each action has this shape:
+
+```ts
+type GatewayAction = {
+  actionKey: string; // e.g. "get:/orders/{id}"
+  method: string; // e.g. "GET"
+  path: string; // e.g. "/orders/{id}"
+  isPublic: boolean; // callable without an API key
+};
+```
+
+Actions only carry the method and path. Use the `summaries` argument of `toApiShowcaseItems()` (or
+your own mapping) to add human-friendly names.
+
+### Always keep a fallback
+
+The hook runs in the browser only, so the prerendered HTML never contains a stale list. `data` is
+`undefined`:
+
+- while the request is loading,
+- if the request fails,
+- in preview and demo mode, or when no dev portal backend URL is configured (for example in
+  `npm run dev` before your portal is provisioned).
+
+`ApiShowcaseSection` renders nothing for an empty list, so pass a static fallback as shown above.
+
+### What becomes public
+
+`GET /api/v1/actions` is anonymous: **every operation in the OpenAPI spec deployed to your gateway
+is listable**, including ones you may not document in the portal. Use `inPlan: true` to limit the
+list to operations your plans actually sell, and remove internal operations from the spec you deploy
+to the gateway if they must not be discoverable.
+
+### Freshness and limits
+
+- The backend syncs actions at startup and on the plan sync interval (15 minutes by default). A new
+  release shows up after the next sync.
+- Responses are cacheable for 5 minutes (`Cache-Control: public, max-age=300`).
+- The endpoint is rate limited per client IP (60 requests per minute).
+
+### Troubleshooting
+
+- **The list is always the fallback:** check that `authentication.apiBaseUrl` (or
+  `VITE_APITOGO_AUTHENTICATION_API_BASE_URL`) points at your dev portal backend and is not the
+  placeholder URL.
+- **CORS errors:** the backend only allows the portal's configured frontend URL. Serving the site
+  from another domain requires adding it to the backend's allowed origins.
+- **Empty list on a new portal:** the portal is not activated yet, or the gateway has no release.
+  Deploy your backend, then wait for the next sync.

package/package.json

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