@lukoweb/apitogo 0.2.30 → 0.2.34

package/dist/declarations/app/entry.server.d.ts

@@ -1,7 +1,7 @@
 import { type RouteObject } from "react-router";
 import "vite/modulepreload-polyfill";
-import { getRoutesByConfig } from "./main.js";
-export { getRoutesByConfig };
+import type { ApitogoConfig } from "../config/config.js";
+export declare const getRoutesByConfig: (config: ApitogoConfig) => RouteObject[];
 export declare const handleRequest: ({ template, request, routes, basePath, bypassProtection, }: {
     template: string;
     request: Request;

package/dist/declarations/app/main.d.ts

@@ -2,6 +2,7 @@ import type { RouteObject } from "react-router";
 import type { HighlighterCore } from "shiki";
 import "virtual:zudoku-theme.css";
 import type { ApitogoConfig } from "../config/config.js";
+import type { ResolvedModulesConfig } from "../config/validators/ModulesSchema.js";
 import "./main.css";
 import "./polyfills.js";
 import type { ZudokuContextOptions } from "../lib/core/ZudokuContext.js";
@@ -99,4 +100,5 @@ export declare const getRoutesByOptions: (options: ZudokuContextOptions, enableS
         ErrorBoundary?: (() => Promise<import("react").ComponentType<{}> | null | undefined>) | undefined;
     }) | import("react-router").LazyRouteFunction<RouteObject>;
 })[];
-export declare const getRoutesByConfig: (config: ApitogoConfig) => RouteObject[];
+export type ModulesResolver = (config: ApitogoConfig) => ResolvedModulesConfig;
+export declare const getRoutesByConfig: (config: ApitogoConfig, resolveModules: ModulesResolver) => RouteObject[];

package/dist/declarations/cli/platform/client/platform-api.d.ts

@@ -203,10 +203,8 @@ export interface ProjectSubscriptionDto {
     availableCurrencies: string[];
 }
 export interface CheckoutSessionResponse {
-    url: string;
-}
-export interface DeploymentTokenResponse {
-    token: string;
+    url: string | null;
+    granted?: boolean;
 }
 export interface ProvisioningJobListItemDto {
     id: string;
@@ -443,6 +441,12 @@ export interface ProjectIdentityRequestBody {
     portalRedirectUris: string[];
     nativeSignup?: boolean;
 }
+export interface DevPortalBillingDto {
+    jobId: string;
+    mode: string;
+    webhookUrl: string;
+    hasWebhookSecret: boolean;
+}
 export interface DevPortalIdentityLinkDto {
     jobId: string;
 }
@@ -525,12 +529,12 @@ export declare class PlatformApiClient {
     createCheckoutSession(projectId: string, body: {
         planSlug: string;
         currency?: string;
+        skipPayment?: boolean;
     }): Promise<CheckoutSessionResponse>;
     getLatestAzureInfrastructureStatus(projectId: string): Promise<DeployStatusResponse>;
     retryAzureInfrastructure(projectId: string): Promise<StartDeployResponse>;
     getAzureInfrastructureDeployStatus(projectId: string, jobId: string): Promise<DeployStatusResponse>;
     listProvisioningJobs(projectId: string): Promise<ProvisioningJobListResponse>;
-    getDeploymentToken(projectId: string, regenerate?: boolean): Promise<DeploymentTokenResponse>;
     uploadStaticWebDeployment(projectId: string, archivePath: string, env?: string): Promise<StaticWebSiteDeploymentDto>;
     listSecrets(projectId: string): Promise<ProjectSecretListResponse>;
     setSecret(projectId: string, name: string, value: string): Promise<SetProjectSecretResponse>;
@@ -560,6 +564,13 @@ export declare class PlatformApiClient {
     deleteProjectIdentityConnection(projectId: string, connectionId: string): Promise<void>;
     getProjectIdentity(projectId: string): Promise<ProjectIdentityDto | null>;
     deleteProjectIdentity(projectId: string): Promise<ProjectIdentityDto | null>;
+    putDevPortalBilling(projectId: string, body: {
+        provider: "stripe" | "none";
+        apiKey?: string;
+        webhookSecret?: string;
+        successUrl?: string;
+        cancelUrl?: string;
+    }): Promise<DevPortalBillingDto>;
     linkDevPortalIdentity(projectId: string): Promise<DevPortalIdentityLinkDto>;
     getDevPortalBackend(projectId: string): Promise<DevPortalBackendDto | null>;
     getDevPortalSetupStatus(projectId: string): Promise<DevPortalSetupStatusDto>;

package/dist/declarations/cli/platform/helpers/deploy-artifact-hash.d.ts

@@ -1,6 +1,6 @@
 export declare function sha256File(filePath: string): Promise<string>;
 export declare function sha256Buffer(data: Buffer | string): Promise<string>;
-export declare function hashDirectoryContents(rootDirectory: string): Promise<string>;
+export declare function hashDirectoryContents(rootDirectory: string, extraExcludes?: readonly string[]): Promise<string>;
 export declare function hashDevPortalSiteSources(siteDirectory: string, options?: {
     gatewayUrl?: string | null;
 }): Promise<string>;

package/dist/declarations/cli/platform/helpers/package-files.d.ts

@@ -1 +1 @@
-export declare function collectPackageableFiles(sourceDirectory: string): Promise<string[]>;
+export declare function collectPackageableFiles(sourceDirectory: string, extraExcludes?: readonly string[]): Promise<string[]>;

package/dist/declarations/cli/platform/helpers/platform-plan.d.ts

@@ -3,7 +3,7 @@ import type { ProgressReporter } from "./progress.js";
 export declare function isPlatformPlanUnselected(planTier: string | undefined | null): boolean;
 export declare function isPlatformPlanSelected(subscription: ProjectSubscriptionDto): boolean;
 export declare function isPaidPlanTier(planTier: string): boolean;
-export declare function isPaidPlanActive(subscription: ProjectSubscriptionDto): boolean;
+export declare function isPaidPlanActive(subscription: Pick<ProjectSubscriptionDto, "planTier" | "subscriptionLifecycle">): boolean;
 export declare function isPlatformPlanReady(subscription: ProjectSubscriptionDto): boolean;
 export interface PlatformPlanWaitResult {
     status: "succeeded" | "timeout" | "failed";

package/dist/declarations/cli/platform/helpers/zip.d.ts

@@ -2,5 +2,5 @@ export interface PackageBackendResult {
     zipPath: string;
     byteSize: number;
 }
-export declare function packageBackendDirectory(sourceDirectory: string): Promise<PackageBackendResult>;
+export declare function packageBackendDirectory(sourceDirectory: string, extraExcludes?: readonly string[]): Promise<PackageBackendResult>;
 export declare function cleanupZip(zipPath: string): Promise<void>;

package/dist/declarations/cli/platform/tools/infrastructure.d.ts

@@ -21,10 +21,6 @@ export declare function handleRetryAzureInfrastructure(client: PlatformApiClient
 export declare function handleListProvisioningJobs(client: PlatformApiClient, config: ApitogoConfig, args: {
     projectId?: string;
 }): Promise<string>;
-export declare function handleGetDeploymentToken(client: PlatformApiClient, config: ApitogoConfig, args: {
-    projectId?: string;
-    regenerate?: boolean;
-}): Promise<string>;
 export declare function handleGetCustomDomain(client: PlatformApiClient, config: ApitogoConfig, args: {
     projectId?: string;
 }): Promise<string>;

package/dist/declarations/config/effective-redirects.d.ts

@@ -0,0 +1,6 @@
+import type { ResolvedModulesConfig } from "./validators/ModulesSchema.js";
+import type { ZudokuConfig } from "./validators/ZudokuConfig.js";
+export declare const getEffectiveRedirects: (config: ZudokuConfig, resolved: ResolvedModulesConfig) => {
+    from: string;
+    to: string;
+}[];

package/dist/declarations/config/header-navigation-guard.d.ts

@@ -0,0 +1,2 @@
+import type { HeaderNavGroup, HeaderNavItem, HeaderNavLinkItem } from "./validators/HeaderNavigationSchema.js";
+export declare const isHeaderNavGroup: (item: HeaderNavItem | HeaderNavLinkItem | HeaderNavGroup) => item is HeaderNavGroup;

package/dist/declarations/config/resolve-modules.d.ts

@@ -8,10 +8,7 @@ export declare const resolveDashboardContent: (content?: DashboardContentConfig)
 export declare const resolveProfileContent: (content?: ProfileContentConfig) => ResolvedProfileContent;
 export declare const resolvePlansContent: (content?: PlansContentConfig) => ResolvedPlansContent;
 export declare const resolveModulesConfig: (config: ZudokuConfig) => ResolvedModulesConfig;
-export declare const getEffectiveRedirects: (config: ZudokuConfig, resolved: ResolvedModulesConfig) => {
-    from: string;
-    to: string;
-}[];
+export { getEffectiveRedirects } from "./effective-redirects.js";
 export declare const getEffectiveDocsConfig: (_config: ZudokuConfig, resolved: ResolvedModulesConfig) => {
     files: string | string[];
     publishMarkdown: boolean;

package/dist/declarations/config/validators/HeaderNavigationSchema.d.ts

@@ -15800,9 +15800,8 @@ export declare const HeaderNavigationSchema: z.ZodArray<z.ZodUnion<readonly [z.Z
         }, z.core.$strip>>;
     }, z.core.$strip>]>>;
 }, z.core.$strip>]>>;
-export declare const isHeaderNavGroup: (item: HeaderNavItem | HeaderNavLinkItem | HeaderNavGroup) => item is HeaderNavGroup;
+export { isHeaderNavGroup } from "../header-navigation-guard.js";
 export type HeaderNavLinkItem = z.infer<typeof HeaderNavLinkItemSchema>;
 export type HeaderNavGroup = z.infer<typeof HeaderNavGroupSchema>;
 export type HeaderNavItem = z.infer<typeof HeaderNavItemSchema>;
 export type HeaderNavigation = z.infer<typeof HeaderNavigationSchema>;
-export {};

package/docs/cli/commands.md

@@ -1,75 +1,151 @@
----
-title: CLI commands
-description: APItoGo CLI command catalog by category.
-sidebar_icon: wrench
----
-
-Commands are exposed by the **`apitogo`** binary (`@lukoweb/apitogo`). The CLI is the **source of
-truth** for init, config, deploy, status, teardown, project create, and check. MCP tools spawn these
-same commands so agents and humans get identical behavior.
-
-## Lifecycle (prefer these)
-
-| Command          | Role                                                                  |
-| ---------------- | --------------------------------------------------------------------- |
-| `init`           | Scaffold portal (default `./dev-portal`; OpenAPI discovery + secrets) |
-| `config`         | Write or update `apitogo.config.json` (interactive or flags)          |
-| `run`            | Local preview server                                                  |
-| `build`          | Production build (`--preview` to serve locally)                       |
-| `check`          | Publish readiness (secrets, manifest, site validation)                |
-| `project create` | Create a platform project (plan unselected)                           |
-| `deploy`         | Publish config to platform (apihub + portal)                          |
-| `status`         | Account, project, and live readiness                                  |
-| `teardown --yes` | Delete the linked platform project                                    |
-
-## Scaffold and config
-
-| Command      | Role                                                                                                        |
-| ------------ | ----------------------------------------------------------------------------------------------------------- |
-| `init [dir]` | Folder (default `dev-portal`); `--name`, `--install` (default), `--overwrite`, `--json`, `--openapi-search` |
-| `config`     | Interactive on TTY; flags: `--openapi`, `--page-*`, `--plan`, `--backend`, `--theme`, `--patch`, `--json`   |
-
-`npx @lukoweb/apitogo@latest init` auto-wires nearby OpenAPI and `docs/`/`doc/` markdown after
-scaffold. See [Install the CLI](./setup.md#scaffold-options).
-
-See [Make config (CLI)](../configuration/make-config.mdx) for all `config` flags.
-
-## Local development
-
-| Command           | Role                                                      |
-| ----------------- | --------------------------------------------------------- |
-| `run`             | Run the local portal server (`--port`, `--open`, `--ssr`) |
-| `build`           | Production static build                                   |
-| `build --preview` | Build then serve locally                                  |
-
-## Platform (requires API credentials)
-
-| Command                    | Role                                                           |
-| -------------------------- | -------------------------------------------------------------- |
-| `project create --name`    | Create platform project only                                   |
-| `check`                    | Dry-run publish readiness                                      |
-| `deploy`                   | Full publish — project, plans, apihub, portal backend/frontend |
-| `deploy --only <resource>` | Limit to `apihub`, `portal-backend`, or `portal-frontend`      |
-| `deploy --force`           | Redeploy selected resources even when healthy                  |
-| `deploy --platform-plan`   | Select Free / Starter / Professional hosting                   |
-| `deploy --resume-from`     | Resume interrupted publish                                     |
-| `status`                   | Whoami + project + live verification                           |
-| `teardown --yes`           | Delete platform project (confirmation required)                |
-
-Env: `APITOGO_API_KEY_ID`, `APITOGO_API_SECRET`. Optional: `APITOGO_API_URL`.
-
-## Hand-edit exceptions
-
-| Change            | Where                                                    |
-| ----------------- | -------------------------------------------------------- |
-| Home page content | `landing/LandingPage.tsx`                                |
-| Site footer       | `apitogo.config.json` → `modules.landing.content.footer` |
-
-There is no CLI command for arbitrary home page content.
-
-## Related
-
-- [Overview](./overview.md)
-- [Shape](./shape.md)
-- [Go live](./go-live.md)
-- [MCP tools](../mcp/tools.md) — agent tool catalog (spawn the CLI)
+---
+title: CLI commands
+description: APItoGo CLI command catalog by category.
+sidebar_icon: wrench
+---
+
+Commands are exposed by the **`apitogo`** binary (`@lukoweb/apitogo`). The CLI is the **source of
+truth** for init, config, deploy, status, teardown, project create, and check. MCP tools spawn these
+same commands so agents and humans get identical behavior.
+
+## Lifecycle (prefer these)
+
+| Command          | Role                                                                     |
+| ---------------- | ------------------------------------------------------------------------ |
+| `init`           | Scaffold portal (default `./dev-portal`; OpenAPI discovery + secrets)    |
+| `config`         | Write or update `apitogo.config.json` (interactive or flags)             |
+| `run`            | Local preview server                                                     |
+| `build`          | Production build (`--preview` to serve locally)                          |
+| `check`          | Publish readiness (secrets, manifest, site validation)                   |
+| `project create` | Create the platform project (Free plan in version 2) and link the folder |
+| `deploy`         | Publish config to platform (apihub + portal)                             |
+| `status`         | Account, project, and live readiness                                     |
+| `teardown --yes` | Delete the linked platform project                                       |
+
+## Scaffold and config
+
+| Command      | Role                                                                                                        |
+| ------------ | ----------------------------------------------------------------------------------------------------------- |
+| `init [dir]` | Folder (default `dev-portal`); `--name`, `--install` (default), `--overwrite`, `--json`, `--openapi-search` |
+| `config`     | Interactive on TTY; flags: `--openapi`, `--page-*`, `--plan`, `--backend`, `--theme`, `--patch`, `--json`   |
+
+`npx @lukoweb/apitogo@latest init` auto-wires nearby OpenAPI and `docs/`/`doc/` markdown after
+scaffold. See [Install the CLI](./setup.md#scaffold-options).
+
+See [Make config (CLI)](../configuration/make-config.mdx) for all `config` flags.
+
+## Local development
+
+| Command           | Role                                                      |
+| ----------------- | --------------------------------------------------------- |
+| `run`             | Run the local portal server (`--port`, `--open`, `--ssr`) |
+| `build`           | Production static build                                   |
+| `build --preview` | Build then serve locally                                  |
+
+## Platform (requires API credentials)
+
+| Command                    | Role                                                                                                     |
+| -------------------------- | -------------------------------------------------------------------------------------------------------- |
+| `project create`           | Create the platform project only; version 2 also selects Free, waits for hosting and writes `project.id` |
+| `check`                    | Dry-run publish readiness                                                                                |
+| `deploy`                   | Full publish — project, plans, apihub, portal backend/frontend                                           |
+| `deploy --only <resource>` | Limit to `apihub`, `portal-backend`, or `portal-frontend`                                                |
+| `deploy --force`           | Redeploy selected resources even when healthy                                                            |
+| `deploy --platform-plan`   | Select Free / Starter / Professional hosting                                                             |
+| `deploy --resume-from`     | Resume interrupted publish                                                                               |
+| `status`                   | Whoami + project + live verification                                                                     |
+| `teardown --yes`           | Delete platform project (confirmation required)                                                          |
+
+Env: `APITOGO_API_KEY_ID`, `APITOGO_API_SECRET`. Optional: `APITOGO_API_URL`.
+
+## Config version 2: add a service
+
+```bash
+npx apitogo add gateway
+```
+
+`add` puts one service (`portal`, `gateway`, `identity` or `plans`) into `apitogo.config.json`. In a
+terminal it **asks** for what you did not pass as a flag: for the gateway how it reaches your API
+(an address you host, or code the platform runs, with the folder, runtime and version) and which
+OpenAPI file to use. For an OIDC identity it asks for the issuer, and for external docs the address
+of the docs site. It shows the change and asks before it writes.
+
+Some services need another one. `plans` needs the gateway and an identity source, and a portal that
+requires login needs an identity source. `add` then offers to add the missing service first, asks
+for its values, and goes on with the one you named.
+
+With `--yes`, `--json` or without a terminal it never asks: a missing value is an error that names
+the flag to pass, and `--dry-run` shows the change without writing it.
+
+## Config version 2: create the project, then deploy
+
+```bash
+npx apitogo project create
+npx apitogo deploy
+```
+
+`project create` makes the platform project, selects the **Free** plan (or the plan from `--plan`),
+waits for the hosting that the enabled services need, and writes `project.id` into
+`apitogo.config.json`. `deploy` then publishes each service. It needs the project id from
+`project.id`, from `--project-id`, or from `APITOGO_DEFAULT_PROJECT_ID`, and says so when it has
+none.
+
+| `project create` option | In version 2                                                       |
+| ----------------------- | ------------------------------------------------------------------ |
+| `--name`                | Optional. Defaults to `project.name`                               |
+| `--description`         | Optional                                                           |
+| `--plan`                | `free` (default), `starter` or `professional`. See below           |
+| `--no-open`             | Print the checkout link of a paid plan and do not open the browser |
+| `--modules`             | Ignored. The modules come from the config (the portal needs one)   |
+| `--no-wait`             | Return before the hosting is ready                                 |
+| `--json`                | Print raw JSON only                                                |
+
+| `deploy` option   | In version 2                                               |
+| ----------------- | ---------------------------------------------------------- |
+| `--only`          | `portal`, `gateway`, `identity`, `plans` (comma-separated) |
+| `--env`           | Static Web App environment (default: production)           |
+| `--force`         | Redeploy even when nothing changed                         |
+| `--resume-from`   | Resume the publish ledger from a step id                   |
+| `--no-wait`       | Do not wait for long-running jobs                          |
+| `--platform-plan` | Ignored. The plan is chosen by `project create --plan`     |
+| `--project-name`  | Ignored. The name is `project.name`                        |
+
+### Selling paid plans needs Starter or Professional
+
+A project on the **Free** platform plan can only publish free plans, and its limits are capped. To
+charge your customers, create the project on a paid platform plan:
+
+```bash
+npx apitogo project create --plan starter
+```
+
+The command makes the project, then prints a link to the platform's own checkout (and opens it in
+your browser). You pay there, and the command waits until the payment is confirmed (up to 15
+minutes) before it waits for the hosting. If it stops early, run the same command again: it
+continues the same project and does not start a second checkout. With `--json` the command prints
+the link and exits, and a later run continues.
+
+Only a **new** project can be created on a paid plan. A project that is already on the Free plan, or
+on the other paid plan, is not moved: create a new project in a new folder, or change the plan in
+the web app.
+
+This is what you pay APItoGo for hosting. What your customers pay you for your plans is separate
+(see `plans.billing` in the config).
+
+See [Walkthrough: from an empty folder to a customer's first call](./walkthrough.md).
+
+## Hand-edit exceptions
+
+| Change            | Where                                                    |
+| ----------------- | -------------------------------------------------------- |
+| Home page content | `landing/LandingPage.tsx`                                |
+| Site footer       | `apitogo.config.json` → `modules.landing.content.footer` |
+
+There is no CLI command for arbitrary home page content.
+
+## Related
+
+- [Overview](./overview.md)
+- [Shape](./shape.md)
+- [Go live](./go-live.md)
+- [MCP tools](../mcp/tools.md) — agent tool catalog (spawn the CLI)