@lukoweb/apitogo 0.2.54 → 0.2.56

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

@@ -246,6 +246,27 @@ export interface DevPortalEmailDnsRecordDto {
     value: string;
     ttlSeconds?: number | null;
 }
+export interface PlatformPlanDto {
+    id: string;
+    displayName: string;
+    tagline: string;
+    priceAmount: string;
+    pricePeriod: string;
+    ctaLabel: string;
+    sortOrder: number;
+    highlights: string[];
+    entitlements: {
+        featureKey: string;
+        valueType: string;
+        value: string;
+    }[];
+}
+export interface BillingWebhookStatusDto {
+    webhookSecretConfigured: boolean;
+    lastEventAtUtc: string | null;
+    lastEventType: string | null;
+    eventCount: number;
+}
 export interface DevPortalBackendDto {
     fqdn: string | null;
     containerAppName: string;
@@ -573,6 +594,8 @@ export declare class PlatformApiClient {
         cancelUrl?: string;
     }): Promise<DevPortalBillingDto>;
     linkDevPortalIdentity(projectId: string): Promise<DevPortalIdentityLinkDto>;
+    listPlatformPlans(): Promise<PlatformPlanDto[]>;
+    getBillingWebhookStatus(projectId: string): Promise<BillingWebhookStatusDto | null>;
     getDevPortalBackend(projectId: string): Promise<DevPortalBackendDto | null>;
     getDevPortalSetupStatus(projectId: string): Promise<DevPortalSetupStatusDto>;
     getDevPortalSettings(projectId: string): Promise<DevPortalSettingsDto | null>;

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

@@ -1,3 +1,4 @@
+import type { PlatformPlanDto } from "../client/platform-api.js";
 import type { FreeProjectsQuota } from "./free-projects-quota.js";
 export type PlatformPlanId = "free" | "starter" | "professional";
 export interface PlatformPlanOption {
@@ -12,6 +13,11 @@ export interface PlatformPlanOption {
     limitations: string[];
 }
 export declare const PLATFORM_PLAN_CATALOG: PlatformPlanOption[];
+export type PlatformPlanDisplay = Pick<PlatformPlanOption, "displayName" | "priceLabel" | "summary" | "features" | "limitations"> & {
+    id: string;
+};
+export declare function toPlanDisplays(plans: readonly PlatformPlanDto[]): PlatformPlanDisplay[];
+export declare function loadPlanDisplays(listPlatformPlans: () => Promise<PlatformPlanDto[]>): Promise<PlatformPlanDisplay[]>;
 export declare const PLATFORM_PLAN_USER_PROMPT = "Which API ToGo platform plan do you want for this project \u2014 Free, Starter, or Professional?";
 export declare function formatFreeProjectsQuotaHint(quota: FreeProjectsQuota): string;
 export declare function buildPlatformPlanSelectionAgentInstruction(quota?: FreeProjectsQuota | null): string;

package/docs/cli/walkthrough.md

@@ -49,7 +49,7 @@ npx apitogo add plans --template free
 `--create-spec` writes a small OpenAPI file with one `GET /health` operation, so the gateway has
 something to expose. For a real API, point `gateway.specs` at your own OpenAPI file instead.
 
-The Free template in `plans.json` allows 3 calls per minute and 1000 calls per 30 days. Change the
+The Free template in `plans.json` allows 60 calls per minute and 1000 calls per 30 days. Change the
 numbers in `plans.json` and deploy again to change the limits.
 
 With plans in the project, customers call the gateway with their API key alone. Their login token is

package/package.json

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

package/src/config/v2/services.ts

@@ -249,21 +249,23 @@ const PLAN_TEMPLATES: Record<
       displayName: "Free",
       default: true,
       limits: {
-        // The platform's Free tier allows at most 3 calls per 60 seconds per plan; a higher number is refused.
-        rateLimit: { calls: 3, periodSeconds: 60 },
+        // The platform's Free tier allows at most 60 calls per minute per plan (its rate_limit_per_minute ceiling).
+        rateLimit: { calls: 60, periodSeconds: 60 },
         quota: { calls: 1000, periodDays: 30 },
       },
     },
   ],
-  // Sample plans for the starter: a free plan and two with a price on request, so they show on the pricing page and
-  // the home page and still deploy on a Free project (a plan with a price needs a paid platform plan and billing).
+  // Sample plans for the full template: a free plan and one paid example (API-124). The example's price is in the file
+  // but it is a contact-us plan, so the first deploy works on a Free project (a plan with a price needs Starter or
+  // Professional and billing). `apitogo plan` names the command that starts selling it. It has no limits of its own,
+  // so it stays within any project's ceiling until the tenant sets them.
   starter: [
     {
       sku: "free",
       displayName: "Free",
       default: true,
       limits: {
-        rateLimit: { calls: 3, periodSeconds: 60 },
+        rateLimit: { calls: 60, periodSeconds: 60 },
         quota: { calls: 1000, periodDays: 30 },
       },
     },
@@ -272,12 +274,9 @@ const PLAN_TEMPLATES: Record<
       displayName: "Pro",
       pricingModel: "custom",
       priceLabel: "Contact us",
-    },
-    {
-      sku: "enterprise",
-      displayName: "Enterprise",
-      pricingModel: "custom",
-      priceLabel: "Contact us",
+      priceAmount: 19,
+      priceCurrency: "usd",
+      billingInterval: "month",
     },
   ],
   tiered: [
@@ -286,8 +285,8 @@ const PLAN_TEMPLATES: Record<
       displayName: "Free",
       default: true,
       limits: {
-        // The platform's Free tier allows at most 3 calls per 60 seconds per plan; a higher number is refused.
-        rateLimit: { calls: 3, periodSeconds: 60 },
+        // The platform's Free tier allows at most 60 calls per minute per plan (its rate_limit_per_minute ceiling).
+        rateLimit: { calls: 60, periodSeconds: 60 },
         quota: { calls: 1000, periodDays: 30 },
       },
     },

package/src/config/v2/wrapper.ts

@@ -94,6 +94,8 @@ export type PortalPlan = {
     keyHeader?: string;
     /** The gateway's address, for code samples on the portal's pages. */
     gatewayBaseUrl?: string;
+    /** The plan shown as "Popular": only the one the tenant marked `featured` in plans.json (API-124). */
+    featuredPlanSku?: string;
   };
   /** Account pages. */
   userPanel: boolean;
@@ -685,6 +687,18 @@ export async function preparePortal(
   for (const page of tsxPages)
     if (page.order !== undefined && !pageOrders.has(page.route))
       pageOrders.set(page.route, page.order);
+  // "Popular" is the tenant's choice, never guessed (API-124).
+  if (plan.plansPlugin) {
+    const featured = (await readDemoPlans(resolved.plans?.file))?.find(
+      (item): item is { sku: string } =>
+        typeof item === "object" &&
+        item !== null &&
+        (item as { featured?: unknown }).featured === true &&
+        typeof (item as { sku?: unknown }).sku === "string",
+    );
+    if (featured)
+      plan.plansPlugin.featuredPlanSku = featured.sku.trim().toLowerCase();
+  }
   // The account pages' "Documentation" link goes to a page the portal really has, or is left out.
   if (plan.plansPlugin && plan.docs) {
     const landing = hostedDocRoutes.some(