@lukoweb/apitogo 0.1.138 → 0.1.140

package/dist/cli/cli.js

@@ -5809,7 +5809,7 @@ import {
 // package.json
 var package_default = {
   name: "@lukoweb/apitogo",
-  version: "0.1.138",
+  version: "0.1.140",
   type: "module",
   sideEffects: [
     "**/*.css",
@@ -16326,7 +16326,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      {/* 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 LANDING_PAGE_SOURCE = 'import {\n  ApiShowcaseSection,\n  FeaturesSection,\n  HeroSection,\n  LandingShell,\n  PlansPreviewSection,\n  PricingCtaSection,\n  StepsSection,\n} from "@lukoweb/apitogo-module-landing";\nimport { usePlansPreview } from "@lukoweb/apitogo-plugin-dev-portal-billing";\n\nexport default function LandingPage() {\n  // Plans from modules.userPanel.plans.items (or the live dev portal backend).\n  const plans = usePlansPreview();\n\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 plans={plans} />\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";
@@ -19048,6 +19048,20 @@ async function isBackendDeploymentHealthy(client, projectId) {
   return summary.lastDeploymentStatus?.toLowerCase() === "healthy";
 }
 
+// src/cli/platform/helpers/project-name.ts
+function normalizeProjectName(name) {
+  return name.trim().split(/\s+/).filter(Boolean).join(" ").toLowerCase();
+}
+function findProjectByNormalizedName(projects, name) {
+  const needle = normalizeProjectName(name);
+  if (!needle) {
+    return void 0;
+  }
+  return projects.find(
+    (project) => normalizeProjectName(project.name) === needle
+  );
+}
+
 // src/cli/platform/helpers/platform-plan.ts
 var UNSELECTED_TIER = "unselected";
 var FREE_TIER = "free";
@@ -19120,20 +19134,6 @@ function parseToolJsonResult(result) {
   }
 }
 
-// src/cli/platform/helpers/project-name.ts
-function normalizeProjectName(name) {
-  return name.trim().split(/\s+/).filter(Boolean).join(" ").toLowerCase();
-}
-function findProjectByNormalizedName(projects, name) {
-  const needle = normalizeProjectName(name);
-  if (!needle) {
-    return void 0;
-  }
-  return projects.find(
-    (project) => normalizeProjectName(project.name) === needle
-  );
-}
-
 // src/cli/platform/helpers/platform-plan-catalog.ts
 var PLATFORM_PLAN_CATALOG = [
   {
@@ -20155,6 +20155,27 @@ async function resolveProjectIdForPublish(client, config2, args, wait, progress,
   if (!args.projectName?.trim()) {
     throw new Error("projectName is required when projectId is not provided.");
   }
+  if (!args.reuseExistingByName) {
+    const projectName = args.projectName.trim();
+    const existing = findProjectByNormalizedName(
+      await client.listProjects(),
+      projectName
+    );
+    if (existing) {
+      return {
+        blocked: true,
+        payload: {
+          status: "blocked",
+          reason: "project_name_exists",
+          projectId: existing.id,
+          projectName,
+          userMessage: `The config has no projectId, but a project named "${projectName}" already exists on your account.`,
+          nextStep: "reuse_or_rename_project",
+          hint: "Re-run with a different --project-name to create a new project, or set projectId in the config to deploy to the existing one."
+        }
+      };
+    }
+  }
   await progress?.onStep("Creating project and provisioning modules");
   const bootstrapJson = await handleBootstrapProject(
     client,
@@ -21108,7 +21129,8 @@ async function runApplyFromSiteDirectory(client, config2, args, progress) {
         config2,
         {
           projectId: args.createNewProject ? void 0 : args.projectId ?? manifest.projectId,
-          projectName: args.projectName ?? resolveProjectDisplayName(manifest)
+          projectName: args.projectName ?? resolveProjectDisplayName(manifest),
+          reuseExistingByName: args.reuseExistingProject
         },
         wait,
         publishProgress,
@@ -21983,6 +22005,16 @@ function formatBlockedOrFailedResultForHuman(parsed) {
     );
     return lines;
   }
+  if (status2 === "blocked" && parsed.reason === "project_name_exists") {
+    const projectId = typeof parsed.projectId === "string" ? parsed.projectId : void 0;
+    return [
+      typeof parsed.userMessage === "string" ? parsed.userMessage : "Deploy is blocked: a project with this name already exists.",
+      "",
+      "To fix this:",
+      `  Deploy to the existing project: set "projectId"${projectId ? ` to "${projectId}"` : ""} in apitogo.config.json`,
+      "  Or create a new project: re-run `apitogo deploy --project-name <new-name>`"
+    ];
+  }
   if (status2 === "blocked" && parsed.reason === "project_not_found") {
     const projectId = typeof parsed.projectId === "string" ? parsed.projectId : void 0;
     const lines = [
@@ -22226,6 +22258,34 @@ async function resolveProjectNotFoundInteractively(payload, defaultProjectName)
     rl.close();
   }
 }
+async function resolveProjectNameExistsInteractively(payload, defaultProjectName) {
+  const existingName = typeof payload.projectName === "string" ? payload.projectName : defaultProjectName;
+  const projectId = typeof payload.projectId === "string" ? payload.projectId : "";
+  printWarningToConsole(
+    `This site has no projectId, but a project named "${existingName}"${projectId ? ` (${projectId})` : ""} already exists on your account.`
+  );
+  printDiagnosticsToConsole("");
+  const rl = createInterface3({ input: input4, output: output3 });
+  try {
+    const choice = (await rl.question(
+      "[c] Create a new project  [u] Use the existing project  [x] Cancel (default c): "
+    )).trim().toLowerCase();
+    if (choice === "x" || choice === "cancel") {
+      return null;
+    }
+    if (choice === "u" || choice === "use") {
+      return { action: "reuse" };
+    }
+    for (; ; ) {
+      const nameAnswer = (await rl.question("New project name: ")).trim();
+      if (nameAnswer) {
+        return { action: "create", projectName: nameAnswer };
+      }
+    }
+  } finally {
+    rl.close();
+  }
+}
 
 // src/cli/apply/handler.ts
 function normalizeOnly(only) {
@@ -22277,6 +22337,7 @@ async function apply(argv) {
   let effectiveProjectId = argv.projectId?.trim();
   let effectiveProjectName = argv.projectName?.trim();
   let createNewProject = false;
+  let reuseExistingProject = false;
   const runOnce = (plan) => runApplyFromSiteDirectory(
     client,
     config2,
@@ -22289,7 +22350,8 @@ async function apply(argv) {
       force: argv.force,
       resumeFromStep: argv.resumeFrom?.trim(),
       wait: argv.wait !== false,
-      createNewProject
+      createNewProject,
+      reuseExistingProject
     },
     progress
   );
@@ -22324,6 +22386,30 @@ async function apply(argv) {
       parsed = safeParseResult(result);
     }
   }
+  while (canPromptInteractively && parsed?.status === "blocked" && parsed.reason === "project_name_exists") {
+    const resolution = await resolveProjectNameExistsInteractively(
+      parsed,
+      effectiveProjectName ?? path63.basename(sourceDirectory)
+    );
+    if (!resolution) {
+      break;
+    }
+    if (resolution.action === "reuse") {
+      reuseExistingProject = true;
+    } else {
+      effectiveProjectName = resolution.projectName;
+      createNewProject = true;
+    }
+    try {
+      result = await runOnce(platformPlan);
+    } catch (error) {
+      await printCriticalFailureToConsoleAndExit(
+        error instanceof Error ? error.message : String(error)
+      );
+      return;
+    }
+    parsed = safeParseResult(result);
+  }
   if (canPromptInteractively && parsed?.status === "blocked" && parsed.reason === "platform_plan_unselected") {
     const blockedProjectId = typeof parsed.projectId === "string" ? parsed.projectId : void 0;
     const resolved = await resolvePlatformPlanInteractively(

package/dist/declarations/cli/platform/tools/dev-portal-bootstrap-shared.d.ts

@@ -27,4 +27,5 @@ export type ResolveProjectIdResult = {
 export declare function resolveProjectIdForPublish(client: PlatformApiClient, config: ApitogoConfig, args: {
     projectId?: string;
     projectName?: string;
+    reuseExistingByName?: boolean;
 }, wait: boolean, progress?: ProgressReporter, timeoutMs?: number, pollIntervalMs?: number): Promise<ResolveProjectIdResult>;

package/dist/declarations/cli/platform/tools/dev-portal-publish.d.ts

@@ -24,6 +24,7 @@ export interface PublishDevPortalArgs {
     force?: boolean;
     resumeFromStep?: PublishStepId;
     createNewProject?: boolean;
+    reuseExistingProject?: boolean;
 }
 export type ApplyFromSiteDirectoryArgs = PublishDevPortalArgs;
 export declare function validateManifestForPublish(manifest: DevPortalLocalManifest, secrets: DevPortalLocalSecrets, emailOptions?: {

package/docs/customization/landing-page.md

@@ -157,3 +157,32 @@ to the gateway if they must not be discoverable.
   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.
+
+## Plans preview
+
+`PlansPreviewSection` shows the same plans as `/pricing`. The scaffold loads them with the
+`usePlansPreview` hook from the billing plugin, so you only maintain plans in one place —
+`modules.userPanel.plans.items` in `apitogo.config.json`:
+
+```tsx
+import { usePlansPreview } from "@lukoweb/apitogo-plugin-dev-portal-billing";
+
+export default function LandingPage() {
+  const plans = usePlansPreview();
+
+  return (
+    <LandingShell title="…">
+      {/* … */}
+      <PlansPreviewSection plans={plans} />
+    </LandingShell>
+  );
+}
+```
+
+In a live portal the plans come from your dev portal backend (`GET /api/v1/plans`); in local
+preview, and while the live catalog loads, they come from `apitogo.config.json`. Each card shows the
+plan's `displayName`, price and billing period, and its first two feature lines (`features`, or
+lines derived from `limits`). The highlighted card matches the "Popular" plan on `/pricing`.
+
+To write the cards by hand instead, pass a static array of `{ name, price, unit, blurb, featured }`
+objects to `plans`.

package/package.json

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