@lukoweb/apitogo 0.1.127 → 0.1.129

package/dist/cli/cli.js

@@ -5809,7 +5809,7 @@ import {
 // package.json
 var package_default = {
   name: "@lukoweb/apitogo",
-  version: "0.1.127",
+  version: "0.1.129",
   type: "module",
   sideEffects: [
     "**/*.css",
@@ -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";
@@ -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();

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.129",
   "type": "module",
   "sideEffects": [
     "**/*.css",