@lukoweb/apitogo 0.2.22 → 0.2.24

package/docs/mcp/tools.md

@@ -1,102 +1,102 @@
----
-title: MCP tools
-description: APItoGo MCP tool catalog by category and hand-edit exceptions.
-sidebar_icon: wrench
----
-
-Tools are exposed by the APItoGo MCP server. Prefer **`apply_product_intent`** for create / shape /
-go-live. Use granular tools for advanced edits, debugging, or CI.
-
-## Lifecycle (prefer these)
-
-| Tool                                 | Role                                           |
-| ------------------------------------ | ---------------------------------------------- |
-| `apply_product_intent`               | Shape or goLive from a product intent          |
-| `create_dev_portal`                  | Scaffold site (+ optional project bootstrap)   |
-| `check_dev_portal_publish_readiness` | Pre-publish checklist                          |
-| `publish_dev_portal`                 | Publish portal + plans (+ optional backend)    |
-| `verify_dev_portal_live`             | Post-publish verification                      |
-| `bootstrap_dev_portal`               | CI one-shot provision + deploy                 |
-| `bootstrap_project`                  | Create platform project only (plan unselected) |
-| `teardown_project`                   | Tear down a project                            |
-
-## Site shaping
-
-| Tool                               | Role                                                                      |
-| ---------------------------------- | ------------------------------------------------------------------------- |
-| `update_dev_portal_manifest`       | Plans, branding, backend, projectId                                       |
-| `set_dev_portal_openapi`           | OpenAPI / API reference                                                   |
-| `set_dev_portal_theme`             | Colors and fonts                                                          |
-| `add_dev_portal_page`              | Add a TSX docs page (site components; `template`: docs\|guide\|marketing) |
-| `update_dev_portal_page`           | Edit a docs page                                                          |
-| `scaffold_dev_portal_landing_page` | Scaffold missing landing file                                             |
-| `get_dev_portal_landing_guide`     | Landing component catalog                                                 |
-| `preview_dev_portal_site`          | Start / restart local preview                                             |
-| `build_dev_portal_site`            | Production build                                                          |
-
-Hosted page CRUD also exists (`list/create/delete/rename/reorder_dev_portal_pages`) for the platform
-API surface.
-
-## Projects and platform billing
-
-| Tool                                        | Role                                  |
-| ------------------------------------------- | ------------------------------------- |
-| `whoami`, `list_projects`, `get_project`, … | Tenant / project CRUD                 |
-| `list_platform_plans`                       | Free / Starter / Professional + quota |
-| `ensure_platform_plan`                      | Select or checkout platform plan      |
-| `wait_for_platform_plan`                    | Poll until active                     |
-| `get_subscription`                          | Current subscription                  |
-| `select_free_plan`                          | Free hosting                          |
-| `create_checkout_session`                   | Stripe checkout for paid hosting      |
-
-## Backend and OpenAPI
-
-| Tool                    | Role                     |
-| ----------------------- | ------------------------ |
-| `validate_openapi`      | Validate OpenAPI         |
-| `update_openapi`        | Update stored OpenAPI    |
-| `package_backend`       | Package backend artifact |
-| `deploy_backend`        | Deploy API hub           |
-| `get_backend_summary`   | Backend status           |
-| `get_deployment_status` | Deployment job status    |
-| `get_gateway_readiness` | Gateway readiness        |
-
-## Gateway
-
-| Tool                                                               | Role                     |
-| ------------------------------------------------------------------ | ------------------------ |
-| `list/get/create/update/patch_gateway_plan`                        | Plan CRUD                |
-| `add_actions_to_gateway_plan` / `remove_actions_from_gateway_plan` | Attach ops               |
-| `set_action_public`                                                | Public routes            |
-| `upsert_entitlement`                                               | Entitlements             |
-| `configure_gateway_baseline`                                       | Baseline policies        |
-| `get/update_gateway_settings`                                      | Settings                 |
-| `get/update_gateway_auth`                                          | Gateway auth             |
-| `sync_gateway_plans_from_manifest`                                 | Post-publish action sync |
-| `reorder_gateway_plans_from_manifest`                              | Plan order               |
-
-## Infrastructure and deploy
-
-| Tool                                                   | Role             |
-| ------------------------------------------------------ | ---------------- |
-| `activate_module`                                      | Activate modules |
-| `get_infrastructure_status` / Azure variants           | Infra status     |
-| `list_provisioning_jobs`, `wait_for_job`               | Jobs             |
-| `get_deployment_token`                                 | CLI deploy token |
-| `get/set/delete_custom_domain`                         | Custom domain    |
-| `get_dev_portal_deploy_config`, `deploy_dev_portal`, … | SWA deploy       |
-
-## Hand-edit exceptions
-
-| Change            | Where                                                    |
-| ----------------- | -------------------------------------------------------- |
-| Home page content | `landing/LandingPage.tsx`                                |
-| Site footer       | `apitogo.config.json` → `modules.landing.content.footer` |
-
-There is **no** `update_dev_portal_landing` tool for arbitrary home content.
-
-## Related
-
-- [Overview](./overview.md)
-- [Shape](./shape.md)
-- [Go live](./go-live.md)
+---
+title: MCP tools
+description: APItoGo MCP tool catalog by category and hand-edit exceptions.
+sidebar_icon: wrench
+---
+
+Tools are exposed by the APItoGo MCP server. Prefer **`apply_product_intent`** for create / shape /
+go-live. Use granular tools for advanced edits, debugging, or CI.
+
+## Lifecycle (prefer these)
+
+| Tool                                 | Role                                           |
+| ------------------------------------ | ---------------------------------------------- |
+| `apply_product_intent`               | Shape or goLive from a product intent          |
+| `create_dev_portal`                  | Scaffold site (+ optional project bootstrap)   |
+| `check_dev_portal_publish_readiness` | Pre-publish checklist                          |
+| `publish_dev_portal`                 | Publish portal + plans (+ optional backend)    |
+| `verify_dev_portal_live`             | Post-publish verification                      |
+| `bootstrap_dev_portal`               | CI one-shot provision + deploy                 |
+| `bootstrap_project`                  | Create platform project only (plan unselected) |
+| `teardown_project`                   | Tear down a project                            |
+
+## Site shaping
+
+| Tool                               | Role                                                                      |
+| ---------------------------------- | ------------------------------------------------------------------------- |
+| `update_dev_portal_manifest`       | Plans, branding, backend, projectId                                       |
+| `set_dev_portal_openapi`           | OpenAPI / API reference                                                   |
+| `set_dev_portal_theme`             | Colors and fonts                                                          |
+| `add_dev_portal_page`              | Add a TSX docs page (site components; `template`: docs\|guide\|marketing) |
+| `update_dev_portal_page`           | Edit a docs page                                                          |
+| `scaffold_dev_portal_landing_page` | Scaffold missing landing file                                             |
+| `get_dev_portal_landing_guide`     | Landing component catalog                                                 |
+| `preview_dev_portal_site`          | Start / restart local preview                                             |
+| `build_dev_portal_site`            | Production build                                                          |
+
+Hosted page CRUD also exists (`list/create/delete/rename/reorder_dev_portal_pages`) for the platform
+API surface.
+
+## Projects and platform billing
+
+| Tool                                        | Role                                  |
+| ------------------------------------------- | ------------------------------------- |
+| `whoami`, `list_projects`, `get_project`, … | Tenant / project CRUD                 |
+| `list_platform_plans`                       | Free / Starter / Professional + quota |
+| `ensure_platform_plan`                      | Select or checkout platform plan      |
+| `wait_for_platform_plan`                    | Poll until active                     |
+| `get_subscription`                          | Current subscription                  |
+| `select_free_plan`                          | Free hosting                          |
+| `create_checkout_session`                   | Stripe checkout for paid hosting      |
+
+## Backend and OpenAPI
+
+| Tool                    | Role                     |
+| ----------------------- | ------------------------ |
+| `validate_openapi`      | Validate OpenAPI         |
+| `update_openapi`        | Update stored OpenAPI    |
+| `package_backend`       | Package backend artifact |
+| `deploy_backend`        | Deploy API hub           |
+| `get_backend_summary`   | Backend status           |
+| `get_deployment_status` | Deployment job status    |
+| `get_gateway_readiness` | Gateway readiness        |
+
+## Gateway
+
+| Tool                                                               | Role                     |
+| ------------------------------------------------------------------ | ------------------------ |
+| `list/get/create/update/patch_gateway_plan`                        | Plan CRUD                |
+| `add_actions_to_gateway_plan` / `remove_actions_from_gateway_plan` | Attach ops               |
+| `set_action_public`                                                | Public routes            |
+| `upsert_entitlement`                                               | Entitlements             |
+| `configure_gateway_baseline`                                       | Baseline policies        |
+| `get/update_gateway_settings`                                      | Settings                 |
+| `get/update_gateway_auth`                                          | Gateway auth             |
+| `sync_gateway_plans_from_manifest`                                 | Post-publish action sync |
+| `reorder_gateway_plans_from_manifest`                              | Plan order               |
+
+## Infrastructure and deploy
+
+| Tool                                                   | Role             |
+| ------------------------------------------------------ | ---------------- |
+| `activate_module`                                      | Activate modules |
+| `get_infrastructure_status` / Azure variants           | Infra status     |
+| `list_provisioning_jobs`, `wait_for_job`               | Jobs             |
+| `get_deployment_token`                                 | CLI deploy token |
+| `get/set/delete_custom_domain`                         | Custom domain    |
+| `get_dev_portal_deploy_config`, `deploy_dev_portal`, … | SWA deploy       |
+
+## Hand-edit exceptions
+
+| Change            | Where                                                    |
+| ----------------- | -------------------------------------------------------- |
+| Home page content | `landing/LandingPage.tsx`                                |
+| Site footer       | `apitogo.config.json` → `modules.landing.content.footer` |
+
+There is **no** `update_dev_portal_landing` tool for arbitrary home content.
+
+## Related
+
+- [Overview](./overview.md)
+- [Shape](./shape.md)
+- [Go live](./go-live.md)

package/docs/plugins.md

@@ -1,24 +1,24 @@
----
-title: APIToGo Plugins
----
-
-APIToGo is extended with **plugins** registered in your site config. JSON cannot hold React or
-functions.
-
-Common uses:
-
-- Search (Pagefind built-in; Algolia / Inkeep plugins) — [Search](./configuration/search.md)
-- Billing UI — `@lukoweb/apitogo-plugin-dev-portal-billing` with `buildApitogoConfig`
-- Custom behavior — [Custom plugins](./custom-plugins.md)
-- Config transforms — `transformConfig` on a plugin (slots, syntax highlighting, etc.)
-
-```tsx title=config
-import { buildApitogoConfig } from "@lukoweb/apitogo";
-import { devPortalBillingPlugin } from "@lukoweb/apitogo-plugin-dev-portal-billing";
-
-export default buildApitogoConfig({
-  plugins: [devPortalBillingPlugin()],
-});
-```
-
-See also [Extending / events](./extending/events.md) and [Slots](./configuration/slots.mdx).
+---
+title: APIToGo Plugins
+---
+
+APIToGo is extended with **plugins** registered in your site config. JSON cannot hold React or
+functions.
+
+Common uses:
+
+- Search (Pagefind built-in; Algolia / Inkeep plugins) — [Search](./configuration/search.md)
+- Billing UI — `@lukoweb/apitogo-plugin-dev-portal-billing` with `buildApitogoConfig`
+- Custom behavior — [Custom plugins](./custom-plugins.md)
+- Config transforms — `transformConfig` on a plugin (slots, syntax highlighting, etc.)
+
+```tsx title=config
+import { buildApitogoConfig } from "@lukoweb/apitogo";
+import { devPortalBillingPlugin } from "@lukoweb/apitogo-plugin-dev-portal-billing";
+
+export default buildApitogoConfig({
+  plugins: [devPortalBillingPlugin()],
+});
+```
+
+See also [Extending / events](./extending/events.md) and [Slots](./configuration/slots.mdx).

package/docs/quickstart.md

@@ -1,72 +1,72 @@
----
-title: Quickstart
-description: Get started with APIToGo MCP — connect your agent, shape a portal, and preview locally.
-sidebar_icon: circle-play
----
-
-Build an API product (developer portal, plans, gateway, backend) with an AI agent and the **APItoGo
-MCP** server. Works with Cursor, Claude, Codex, and other MCP hosts.
-
-## Prerequisites
-
-- **Node.js 20+** on the agent machine
-- An MCP-capable agent (Cursor, Claude Desktop / Claude Code, Codex, …)
-- Platform API keys from [apitogo.com](https://apitogo.com)
-
-## Get started
-
-<Stepper>
-
-1. **Create API credentials**
-
-   In the [APItoGo dashboard](https://apitogo.com), create an API key and copy the **key id** and
-   **secret**.
-
-1. **Configure MCP in your agent**
-
-   Wire `@lukoweb/apitogo-mcp` with your keys. Paste-ready snippets for **Cursor**, **Claude
-   Desktop**, **Claude Code**, **Codex**, and other hosts:
-
-   → **[Configure MCP in your agent](./mcp/setup.md)**
-
-   Verify with `whoami` or by listing APItoGo tools.
-
-1. **Shape a product**
-
-   Ask your agent something like:
-
-   > Create a portal in `./dev-portal` for my API in `./api` with Free (100/min) and Pro (1000/min);
-   > make `/health` public.
-
-   The agent should call `apply_product_intent` with `mode: "shape"` (or `create_dev_portal` for a
-   default scaffold). See [Shape](./mcp/shape.md).
-
-1. **Preview locally**
-
-   ```bash
-   cd ./dev-portal
-   npx apitogo run
-   ```
-
-   Open `http://localhost:3000`. Iterate with MCP tools (pages, OpenAPI, theme, plans). Customize
-   the home page in `landing/LandingPage.tsx` when you have real copy.
-
-1. **Go live when ready**
-
-   Save OIDC (and Stripe if you have paid plans) in the site `.env`, then ask the agent to publish —
-   see [Go live](./mcp/go-live.md). Never paste secrets into chat.
-
-</Stepper>
-
-## What's next
-
-- [Configure MCP](./mcp/setup.md) — agent-specific install
-- [MCP overview](./mcp/overview.md) — what the server does
-- [Shape](./mcp/shape.md) · [Go live](./mcp/go-live.md) · [Tools](./mcp/tools.md)
-- [Manifest](./configuration/manifest.md) · [Authentication](./configuration/authentication.md)
-
-## Without an agent (CLI)
-
-Prefer the terminal? Use the **`apitogo`** CLI for the same config-first workflow:
-
-→ **[Install the CLI](./cli/setup.md)** · [Shape](./cli/shape.md) · [Go live](./cli/go-live.md)
+---
+title: Quickstart
+description: Get started with APIToGo MCP — connect your agent, shape a portal, and preview locally.
+sidebar_icon: circle-play
+---
+
+Build an API product (developer portal, plans, gateway, backend) with an AI agent and the **APItoGo
+MCP** server. Works with Cursor, Claude, Codex, and other MCP hosts.
+
+## Prerequisites
+
+- **Node.js 20+** on the agent machine
+- An MCP-capable agent (Cursor, Claude Desktop / Claude Code, Codex, …)
+- Platform API keys from [apitogo.com](https://apitogo.com)
+
+## Get started
+
+<Stepper>
+
+1. **Create API credentials**
+
+   In the [APItoGo dashboard](https://apitogo.com), create an API key and copy the **key id** and
+   **secret**.
+
+1. **Configure MCP in your agent**
+
+   Wire `@lukoweb/apitogo-mcp` with your keys. Paste-ready snippets for **Cursor**, **Claude
+   Desktop**, **Claude Code**, **Codex**, and other hosts:
+
+   → **[Configure MCP in your agent](./mcp/setup.md)**
+
+   Verify with `whoami` or by listing APItoGo tools.
+
+1. **Shape a product**
+
+   Ask your agent something like:
+
+   > Create a portal in `./dev-portal` for my API in `./api` with Free (100/min) and Pro (1000/min);
+   > make `/health` public.
+
+   The agent should call `apply_product_intent` with `mode: "shape"` (or `create_dev_portal` for a
+   default scaffold). See [Shape](./mcp/shape.md).
+
+1. **Preview locally**
+
+   ```bash
+   cd ./dev-portal
+   npx apitogo run
+   ```
+
+   Open `http://localhost:3000`. Iterate with MCP tools (pages, OpenAPI, theme, plans). Customize
+   the home page in `landing/LandingPage.tsx` when you have real copy.
+
+1. **Go live when ready**
+
+   Save OIDC (and Stripe if you have paid plans) in the site `.env`, then ask the agent to publish —
+   see [Go live](./mcp/go-live.md). Never paste secrets into chat.
+
+</Stepper>
+
+## What's next
+
+- [Configure MCP](./mcp/setup.md) — agent-specific install
+- [MCP overview](./mcp/overview.md) — what the server does
+- [Shape](./mcp/shape.md) · [Go live](./mcp/go-live.md) · [Tools](./mcp/tools.md)
+- [Manifest](./configuration/manifest.md) · [Authentication](./configuration/authentication.md)
+
+## Without an agent (CLI)
+
+Prefer the terminal? Use the **`apitogo`** CLI for the same config-first workflow:
+
+→ **[Install the CLI](./cli/setup.md)** · [Shape](./cli/shape.md) · [Go live](./cli/go-live.md)

package/docs/writing.mdx

@@ -1,72 +1,72 @@
----
-title: Writing
-sidebar_icon: book-open-text
-description: A guide to writing documentation in APIToGo using Markdown and MDX.
----
-
-Get started with creating rich documentation in APIToGo using Markdown and MDX. This guide covers
-the essentials to help you begin documenting your project.
-
-## Quick Start
-
-1. **Create a markdown file** in your `pages` directory
-2. **Add frontmatter** with title and metadata
-3. **Configure navigation** to make it discoverable
-4. **Write content** using Markdown or MDX
-
-### Basic Document Structure
-
-```md
----
-title: My Document
-sidebar_icon: file-text
----
-
-Your content goes here using standard Markdown syntax.
-```
-
-## Adding to Navigation
-
-To make your documentation discoverable, add it to the navigation configuration. Documents are
-referenced by their file path:
-
-```ts title="config"
-const config = {
-  navigation: [
-    {
-      type: "doc",
-      file: "my-document",
-      label: "My Document",
-    },
-  ],
-};
-```
-
-Learn more about configuring navigation at
-[Navigation → Documents](/docs/configuration/navigation#type-doc).
-
-## File Organization
-
-Organize your documentation files in logical directories:
-
-```
-pages/
-├── getting-started/
-│   ├── installation.md
-│   └── quick-start.md
-├── guides/
-│   ├── authentication.md
-│   └── deployment.md
-└── api/
-    └── reference.md
-```
-
-## What's Next?
-
-Explore the detailed guides to enhance your documentation:
-
-- **[Markdown Overview](/docs/markdown/overview)** - Complete markdown syntax reference
-- **[Frontmatter](/docs/markdown/frontmatter)** - Document metadata and configuration
-- **[MDX](/docs/markdown/mdx)** - Interactive components in markdown
-- **[Admonitions](/docs/markdown/admonitions)** - Callouts and alerts
-- **[Code Blocks](/docs/markdown/code-blocks)** - Syntax highlighting and features
+---
+title: Writing
+sidebar_icon: book-open-text
+description: A guide to writing documentation in APIToGo using Markdown and MDX.
+---
+
+Get started with creating rich documentation in APIToGo using Markdown and MDX. This guide covers
+the essentials to help you begin documenting your project.
+
+## Quick Start
+
+1. **Create a markdown file** in your `pages` directory
+2. **Add frontmatter** with title and metadata
+3. **Configure navigation** to make it discoverable
+4. **Write content** using Markdown or MDX
+
+### Basic Document Structure
+
+```md
+---
+title: My Document
+sidebar_icon: file-text
+---
+
+Your content goes here using standard Markdown syntax.
+```
+
+## Adding to Navigation
+
+To make your documentation discoverable, add it to the navigation configuration. Documents are
+referenced by their file path:
+
+```ts title="config"
+const config = {
+  navigation: [
+    {
+      type: "doc",
+      file: "my-document",
+      label: "My Document",
+    },
+  ],
+};
+```
+
+Learn more about configuring navigation at
+[Navigation → Documents](/docs/configuration/navigation#type-doc).
+
+## File Organization
+
+Organize your documentation files in logical directories:
+
+```
+pages/
+├── getting-started/
+│   ├── installation.md
+│   └── quick-start.md
+├── guides/
+│   ├── authentication.md
+│   └── deployment.md
+└── api/
+    └── reference.md
+```
+
+## What's Next?
+
+Explore the detailed guides to enhance your documentation:
+
+- **[Markdown Overview](/docs/markdown/overview)** - Complete markdown syntax reference
+- **[Frontmatter](/docs/markdown/frontmatter)** - Document metadata and configuration
+- **[MDX](/docs/markdown/mdx)** - Interactive components in markdown
+- **[Admonitions](/docs/markdown/admonitions)** - Callouts and alerts
+- **[Code Blocks](/docs/markdown/code-blocks)** - Syntax highlighting and features

package/package.json

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

package/src/app/ZuploBuildConfig.ts

@@ -1,36 +1,36 @@
-import { z } from "zod/mini";
-
-const EntitlementsSchema = z.object({
-  devPortalZuploBranding: z.boolean(),
-  numberOfProjects: z.number(),
-  numberOfUsers: z.number(),
-  egressGbPerMonth: z.number(),
-  requestsPerMonth: z.number(),
-  numberOfApiKeys: z.number(),
-  customDomains: z.number(),
-  advancedAnalyticsEnabled: z.boolean(),
-  devPortalAnalyticsEnabled: z.boolean(),
-  premiumSupport: z.boolean(),
-  emergencyPhoneSupport: z.boolean(),
-  rbacEnabled: z.boolean(),
-  onPremEnabled: z.boolean(),
-  largeBuildRunners: z.boolean(),
-});
-
-const BuildConfigSchema = z.object({
-  entitlements: EntitlementsSchema,
-  environmentType: z.optional(z.string()),
-  deploymentName: z.string(),
-  deploymentUrl: z.optional(z.string()),
-  projectId: z.optional(z.string()),
-  projectType: z.optional(z.string()),
-  sourceType: z.optional(z.string()),
-  accountName: z.optional(z.string()),
-  projectName: z.optional(z.string()),
-});
-
-export type BuildConfig = z.infer<typeof BuildConfigSchema>;
-export type Entitlements = z.infer<typeof EntitlementsSchema>;
-
-export const parseBuildConfig = (value: unknown): BuildConfig =>
-  BuildConfigSchema.parse(value);
+import { z } from "zod/mini";
+
+const EntitlementsSchema = z.object({
+  devPortalZuploBranding: z.boolean(),
+  numberOfProjects: z.number(),
+  numberOfUsers: z.number(),
+  egressGbPerMonth: z.number(),
+  requestsPerMonth: z.number(),
+  numberOfApiKeys: z.number(),
+  customDomains: z.number(),
+  advancedAnalyticsEnabled: z.boolean(),
+  devPortalAnalyticsEnabled: z.boolean(),
+  premiumSupport: z.boolean(),
+  emergencyPhoneSupport: z.boolean(),
+  rbacEnabled: z.boolean(),
+  onPremEnabled: z.boolean(),
+  largeBuildRunners: z.boolean(),
+});
+
+const BuildConfigSchema = z.object({
+  entitlements: EntitlementsSchema,
+  environmentType: z.optional(z.string()),
+  deploymentName: z.string(),
+  deploymentUrl: z.optional(z.string()),
+  projectId: z.optional(z.string()),
+  projectType: z.optional(z.string()),
+  sourceType: z.optional(z.string()),
+  accountName: z.optional(z.string()),
+  projectName: z.optional(z.string()),
+});
+
+export type BuildConfig = z.infer<typeof BuildConfigSchema>;
+export type Entitlements = z.infer<typeof EntitlementsSchema>;
+
+export const parseBuildConfig = (value: unknown): BuildConfig =>
+  BuildConfigSchema.parse(value);