@lukoweb/apitogo 0.1.78 → 0.1.80

package/dist/cli/cli.js

@@ -744,7 +744,7 @@ import { stat } from "node:fs/promises";
 var fileExists;
 var init_file_exists = __esm({
   "src/config/file-exists.ts"() {
-    fileExists = (path43) => stat(path43).then(() => true).catch(() => false);
+    fileExists = (path45) => stat(path45).then(() => true).catch(() => false);
   }
 });
 
@@ -5633,7 +5633,7 @@ import {
 // package.json
 var package_default = {
   name: "@lukoweb/apitogo",
-  version: "0.1.78",
+  version: "0.1.80",
   type: "module",
   sideEffects: [
     "**/*.css",
@@ -6402,14 +6402,14 @@ var flattenAllOf = (schema2) => {
 };
 
 // src/lib/util/traverse.ts
-var traverse = (specification, transform, path43 = []) => {
-  const transformed = transform(specification, path43);
+var traverse = (specification, transform, path45 = []) => {
+  const transformed = transform(specification, path45);
   if (typeof transformed !== "object" || transformed === null) {
     return transformed;
   }
   const result = Array.isArray(transformed) ? [] : {};
   for (const [key, value] of Object.entries(transformed)) {
-    const currentPath = [...path43, key];
+    const currentPath = [...path45, key];
     if (Array.isArray(value)) {
       result[key] = value.map(
         (item, index) => typeof item === "object" && item != null ? traverse(item, transform, [...currentPath, index.toString()]) : item
@@ -6437,9 +6437,9 @@ var resolveLocalRef = (schema2, ref) => {
   if (schemaCache?.has(ref)) {
     return schemaCache.get(ref);
   }
-  const path43 = ref.split("/").slice(1);
+  const path45 = ref.split("/").slice(1);
   let current = schema2;
-  for (const segment of path43) {
+  for (const segment of path45) {
     if (!current || typeof current !== "object") {
       current = null;
     }
@@ -6458,7 +6458,7 @@ var dereference = async (schema2, resolvers = []) => {
   }
   const cloned = structuredClone(schema2);
   const visited = /* @__PURE__ */ new Set();
-  const resolve = async (current, path43) => {
+  const resolve = async (current, path45) => {
     if (isIndexableObject(current)) {
       if (visited.has(current)) {
         return CIRCULAR_REF;
@@ -6466,7 +6466,7 @@ var dereference = async (schema2, resolvers = []) => {
       visited.add(current);
       if (Array.isArray(current)) {
         for (let index = 0; index < current.length; index++) {
-          current[index] = await resolve(current[index], `${path43}/${index}`);
+          current[index] = await resolve(current[index], `${path45}/${index}`);
         }
       } else {
         if ("$ref" in current && typeof current.$ref === "string") {
@@ -6477,13 +6477,13 @@ var dereference = async (schema2, resolvers = []) => {
           for (const resolver of resolvers) {
             const resolved = await resolver($ref);
             if (resolved) {
-              result2 = await resolve(resolved, path43);
+              result2 = await resolve(resolved, path45);
               break;
             }
           }
           if (result2 === void 0) {
             const resolved = await resolveLocalRef(cloned, $ref);
-            result2 = await resolve(resolved, path43);
+            result2 = await resolve(resolved, path45);
           }
           if (hasSiblings) {
             if (result2 === CIRCULAR_REF) {
@@ -6496,7 +6496,7 @@ var dereference = async (schema2, resolvers = []) => {
           return result2;
         }
         for (const key in current) {
-          current[key] = await resolve(current[key], `${path43}/${key}`);
+          current[key] = await resolve(current[key], `${path45}/${key}`);
         }
       }
       visited.delete(current);
@@ -6535,9 +6535,9 @@ var upgradeSchema = (schema2) => {
     }
     return sub;
   });
-  schema2 = traverse(schema2, (sub, path43) => {
+  schema2 = traverse(schema2, (sub, path45) => {
     if (sub.example !== void 0) {
-      if (isSchemaPath(path43 ?? [])) {
+      if (isSchemaPath(path45 ?? [])) {
         sub.examples = [sub.example];
       } else {
         sub.examples = {
@@ -6550,11 +6550,11 @@ var upgradeSchema = (schema2) => {
     }
     return sub;
   });
-  schema2 = traverse(schema2, (schema3, path43) => {
+  schema2 = traverse(schema2, (schema3, path45) => {
     if (schema3.type === "object" && schema3.properties !== void 0) {
-      const parentPath = path43?.slice(0, -1);
+      const parentPath = path45?.slice(0, -1);
       const isMultipart = parentPath?.some((segment, index) => {
-        return segment === "content" && path43?.[index + 1] === "multipart/form-data";
+        return segment === "content" && path45?.[index + 1] === "multipart/form-data";
       });
       if (isMultipart) {
         const entries = Object.entries(schema3.properties);
@@ -6568,8 +6568,8 @@ var upgradeSchema = (schema2) => {
     }
     return schema3;
   });
-  schema2 = traverse(schema2, (schema3, path43) => {
-    if (path43?.includes("content") && path43.includes("application/octet-stream")) {
+  schema2 = traverse(schema2, (schema3, path45) => {
+    if (path45?.includes("content") && path45.includes("application/octet-stream")) {
       return {};
     }
     if (schema3.type === "string" && schema3.format === "binary") {
@@ -6595,11 +6595,11 @@ var upgradeSchema = (schema2) => {
     }
     return sub;
   });
-  schema2 = traverse(schema2, (schema3, path43) => {
+  schema2 = traverse(schema2, (schema3, path45) => {
     if (schema3.type === "string" && schema3.format === "byte") {
-      const parentPath = path43?.slice(0, -1);
+      const parentPath = path45?.slice(0, -1);
       const contentMediaType = parentPath?.find(
-        (_, index) => path43?.[index - 1] === "content"
+        (_, index) => path45?.[index - 1] === "content"
       );
       return {
         type: "string",
@@ -6611,7 +6611,7 @@ var upgradeSchema = (schema2) => {
   });
   return schema2;
 };
-function isSchemaPath(path43) {
+function isSchemaPath(path45) {
   const schemaLocations = [
     ["components", "schemas"],
     "properties",
@@ -6624,10 +6624,10 @@ function isSchemaPath(path43) {
   ];
   return schemaLocations.some((location) => {
     if (Array.isArray(location)) {
-      return location.every((segment, index) => path43[index] === segment);
+      return location.every((segment, index) => path45[index] === segment);
     }
-    return path43.includes(location);
-  }) || path43.includes("schema") || path43.some((segment) => segment.endsWith("Schema"));
+    return path45.includes(location);
+  }) || path45.includes("schema") || path45.some((segment) => segment.endsWith("Schema"));
 }
 
 // src/lib/oas/parser/index.ts
@@ -6709,13 +6709,13 @@ var OPENAPI_PROPS = /* @__PURE__ */ new Set([
   "anyOf",
   "oneOf"
 ]);
-var handleCircularRefs = (obj, currentPath = /* @__PURE__ */ new WeakSet(), refs = /* @__PURE__ */ new WeakMap(), path43 = [], currentRefPaths = /* @__PURE__ */ new Set()) => {
+var handleCircularRefs = (obj, currentPath = /* @__PURE__ */ new WeakSet(), refs = /* @__PURE__ */ new WeakMap(), path45 = [], currentRefPaths = /* @__PURE__ */ new Set()) => {
   if (obj === null || typeof obj !== "object") return obj;
   const refPath = obj.__$ref;
   const isCircular = currentPath.has(obj) || typeof refPath === "string" && currentRefPaths.has(refPath);
   if (isCircular) {
     if (typeof refPath === "string") return SCHEMA_REF_PREFIX + refPath;
-    const circularProp = path43.find((p) => !OPENAPI_PROPS.has(p)) || path43[0];
+    const circularProp = path45.find((p) => !OPENAPI_PROPS.has(p)) || path45[0];
     return [CIRCULAR_REF, circularProp].filter(Boolean).join(":");
   }
   if (refs.has(obj)) return refs.get(obj);
@@ -6725,7 +6725,7 @@ var handleCircularRefs = (obj, currentPath = /* @__PURE__ */ new WeakSet(), refs
     value,
     currentPath,
     refs,
-    [...path43, key],
+    [...path45, key],
     currentRefPaths
   );
   const result = Array.isArray(obj) ? obj.map((item, i) => recurse(item, i.toString())) : Object.fromEntries(
@@ -6760,7 +6760,7 @@ var resolveExtensions = (obj) => Object.fromEntries(
 var getAllTags = (schema2) => {
   const rootTags = schema2.tags ?? [];
   const operations = Object.values(schema2.paths ?? {}).flatMap(
-    (path43) => HttpMethods.map((k) => path43?.[k]).filter((op) => op != null)
+    (path45) => HttpMethods.map((k) => path45?.[k]).filter((op) => op != null)
   );
   const operationTags = new Set(operations.flatMap((op) => op.tags ?? []));
   const hasUntaggedOperations = operations.some(
@@ -6815,7 +6815,7 @@ var getAllSlugs = (ops, schemaTags = []) => {
 var getOperationSlugKey = (op) => [op.path, op.method, op.operationId, op.summary].filter(Boolean).join("-");
 var getAllOperations = (paths) => {
   const operations = Object.entries(paths ?? {}).flatMap(
-    ([path43, value]) => HttpMethods.flatMap((method) => {
+    ([path45, value]) => HttpMethods.flatMap((method) => {
       if (!value?.[method]) return [];
       const operation = value[method];
       const pathParameters = value.parameters ?? [];
@@ -6835,7 +6835,7 @@ var getAllOperations = (paths) => {
       return {
         ...operation,
         method,
-        path: path43,
+        path: path45,
         parameters,
         servers,
         tags: operation.tags ?? []
@@ -7193,8 +7193,8 @@ var Schema = builder.objectRef("Schema").implement({
     }),
     paths: t.field({
       type: [PathItem],
-      resolve: (root) => Object.entries(root.paths ?? {}).map(([path43, value]) => ({
-        path: path43,
+      resolve: (root) => Object.entries(root.paths ?? {}).map(([path45, value]) => ({
+        path: path45,
         // biome-ignore lint/style/noNonNullAssertion: value is guaranteed to be defined
         methods: Object.keys(value)
       }))
@@ -7359,7 +7359,7 @@ init_joinUrl();
 
 // src/vite/api/schema-codegen.ts
 var unescapeJsonPointer = (uri) => decodeURIComponent(uri.replace(/~1/g, "/").replace(/~0/g, "~"));
-var getSegmentsFromPath = (path43) => path43.split("/").slice(1).map(unescapeJsonPointer);
+var getSegmentsFromPath = (path45) => path45.split("/").slice(1).map(unescapeJsonPointer);
 var createLocalRefMap = (obj) => {
   const refMap = /* @__PURE__ */ new Map();
   const siblingsMap = /* @__PURE__ */ new Map();
@@ -7390,16 +7390,16 @@ var replaceMarkers = (code, mergedRefs) => code.replace(/"__refMap:(.*?)"/g, '__
   /"__refMap\+Siblings:(.*?)"/g,
   (_, key) => mergedRefs.get(key) ?? `__refMap["${key}"]`
 );
-var lookup = (schema2, path43, filePath) => {
-  const parts = getSegmentsFromPath(path43);
+var lookup = (schema2, path45, filePath) => {
+  const parts = getSegmentsFromPath(path45);
   let val = schema2;
   for (const part of parts) {
     while (val.$ref?.startsWith("#/")) {
-      val = val.$ref === path43 ? val : lookup(schema2, val.$ref, filePath);
+      val = val.$ref === path45 ? val : lookup(schema2, val.$ref, filePath);
     }
     if (val[part] === void 0) {
       throw new Error(
-        `Error in ${filePath ?? "code generation"}: Could not find path segment ${part} in path: ${path43}`
+        `Error in ${filePath ?? "code generation"}: Could not find path segment ${part} in path: ${path45}`
       );
     }
     val = val[part];
@@ -7644,8 +7644,8 @@ var SchemaManager = class {
       }
     }
   };
-  getLatestSchema = (path43) => this.processedSchemas[path43]?.at(0);
-  getSchemasForPath = (path43) => this.processedSchemas[path43];
+  getLatestSchema = (path45) => this.processedSchemas[path45]?.at(0);
+  getSchemasForPath = (path45) => this.processedSchemas[path45];
   getSchemaImports = () => Object.values(this.processedSchemas).flat().filter((s) => s.importKey);
   getUrlToFilePathMap = () => {
     const map = /* @__PURE__ */ new Map();
@@ -10046,14 +10046,14 @@ async function generateSitemap({
 
 // src/vite/prerender/utils.ts
 init_joinUrl();
-var resolveRoutePath = (path43) => {
-  const segments = path43.split("/");
+var resolveRoutePath = (path45) => {
+  const segments = path45.split("/");
   if (segments.some((s) => s.startsWith(":") && !s.endsWith("?"))) {
     return void 0;
   }
   return segments.filter((s) => !s.startsWith(":")).join("/") || void 0;
 };
-var isSkipped = (path43) => path43.includes("*") || /^\d+$/.test(path43);
+var isSkipped = (path45) => path45.includes("*") || /^\d+$/.test(path45);
 var resolveRoutes = (routes, parentPath = "") => routes.flatMap((route) => {
   if (route.path && isSkipped(route.path)) return [];
   const routePath = route.path ? resolveRoutePath(route.path) : void 0;
@@ -10518,103 +10518,17 @@ var build_default = {
 
 // src/cli/make-config/handler.ts
 import { constants as constants2 } from "node:fs";
-import { access as access3, readFile as readFile5, writeFile as writeFile7 } from "node:fs/promises";
-import path34 from "node:path";
+import { access as access3, mkdir as mkdir7, readFile as readFile5, writeFile as writeFile7 } from "node:fs/promises";
+import path36 from "node:path";
 import { glob as glob5 } from "glob";
 
 // src/cli/make-config/interactive.ts
 import { createInterface } from "node:readline/promises";
 import { stdin as input, stdout as output } from "node:process";
-var ask = async (rl, question, defaultValue) => {
-  const suffix = defaultValue ? ` [${defaultValue}]` : "";
-  const answer = (await rl.question(`${question}${suffix}: `)).trim();
-  return answer || defaultValue || "";
-};
-var askYesNo = async (rl, question, defaultYes) => {
-  const hint = defaultYes ? "Y/n" : "y/N";
-  const answer = (await rl.question(`${question} (${hint}): `)).trim().toLowerCase();
-  if (!answer) {
-    return defaultYes;
-  }
-  return answer === "y" || answer === "yes";
-};
-async function promptMakeConfigInteractive(defaults) {
-  const rl = createInterface({ input, output });
-  try {
-    const title = await ask(rl, "Site title", defaults.title);
-    const logoAlt = await ask(rl, "Logo alt text", defaults.logoAlt);
-    const authEnabled = await askYesNo(
-      rl,
-      "Enable authentication",
-      defaults.authEnabled
-    );
-    let apiBaseUrl = defaults.apiBaseUrl ?? "";
-    if (authEnabled) {
-      apiBaseUrl = await ask(
-        rl,
-        "Auth API base URL (optional; secrets stay in .env)",
-        apiBaseUrl
-      );
-    }
-    const sans = await ask(rl, "Sans font", defaults.sans ?? "IBM Plex Sans");
-    const mono = await ask(
-      rl,
-      "Mono font",
-      defaults.mono ?? "JetBrains Mono"
-    );
-    const lightPrimary = await ask(
-      rl,
-      "Light primary color",
-      defaults.lightPrimary ?? "#E11D2A"
-    );
-    const darkPrimary = await ask(
-      rl,
-      "Dark primary color",
-      defaults.darkPrimary ?? "#F23645"
-    );
-    let openApiPath;
-    if (defaults.discoveredOpenApi) {
-      const useDiscovered = await askYesNo(
-        rl,
-        `Wire OpenAPI at ${defaults.discoveredOpenApi}`,
-        true
-      );
-      openApiPath = useDiscovered ? defaults.discoveredOpenApi : null;
-    } else {
-      const entered = await ask(
-        rl,
-        "OpenAPI file path (leave empty to skip)",
-        ""
-      );
-      openApiPath = entered || null;
-    }
-    const authentication = {
-      enabled: authEnabled,
-      type: "dev-portal"
-    };
-    if (apiBaseUrl) {
-      authentication.apiBaseUrl = apiBaseUrl;
-    }
-    return {
-      title,
-      site: {
-        title,
-        logo: { alt: logoAlt }
-      },
-      theme: {
-        fonts: { sans, mono },
-        light: { primary: lightPrimary },
-        dark: { primary: darkPrimary }
-      },
-      authentication,
-      openApiPath
-    };
-  } finally {
-    rl.close();
-  }
-}
+import path34 from "node:path";
 
 // src/cli/make-config/json-config.ts
+import path33 from "node:path";
 var APITOGO_JSON_FILENAME = "apitogo.config.json";
 var DOCUMENTATION_NAV_LABEL = "Documentation";
 var API_REFERENCE_PATH = "/api";
@@ -10665,7 +10579,7 @@ function createDefaultApitogoJsonConfig(options) {
       }
     },
     authentication: {
-      enabled: false,
+      enabled: true,
       type: "dev-portal",
       redirectToAfterSignIn: "/account/dashboard",
       redirectToAfterSignUp: "/account/dashboard"
@@ -10895,6 +10809,67 @@ function openapiInputForConfig(specRelativePosix) {
   }
   return `./${specRelativePosix}`;
 }
+function toRelativeOpenApiInput(projectDir, inputPath) {
+  const resolved = path33.isAbsolute(inputPath) ? inputPath : path33.resolve(projectDir, inputPath);
+  const relative = path33.relative(projectDir, resolved);
+  const posix = relative.split(path33.sep).join(path33.posix.sep);
+  if (!posix) {
+    throw new Error("OpenAPI path must point to a file.");
+  }
+  return openapiInputForConfig(posix);
+}
+function normalizePageSlug(pathOrSlug) {
+  return pathOrSlug.replace(/^\/+/, "").replace(/\/+$/, "").replace(/\.(mdx?|tsx|jsx)$/i, "");
+}
+function slugifyPlanSku(displayName) {
+  const sku = displayName.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  return sku || "plan";
+}
+function buildLimitsJson(rateLimitCalls, monthlyQuota) {
+  return JSON.stringify({
+    rateLimit: { calls: rateLimitCalls, renewalPeriodSeconds: 60 },
+    quota: { calls: monthlyQuota, renewalPeriodDays: 30 }
+  });
+}
+function buildPlanItemFromWizard(input2) {
+  const sku = input2.sku ?? slugifyPlanSku(input2.displayName);
+  const item = {
+    sku,
+    displayName: input2.displayName,
+    priceAmount: input2.priceAmount,
+    limitsJson: buildLimitsJson(input2.rateLimitCalls, input2.monthlyQuota)
+  };
+  if (input2.priceAmount > 0) {
+    item.priceCurrency = "usd";
+    item.billingPeriod = "month";
+  }
+  return item;
+}
+function applyPlansToJsonConfig(config2, planItems) {
+  if (planItems.length === 0) {
+    return config2;
+  }
+  const modules = isPlainObject2(config2.modules) ? { ...config2.modules } : {};
+  const userPanel = isPlainObject2(modules.userPanel) ? { ...modules.userPanel } : {};
+  const plans = isPlainObject2(userPanel.plans) ? { ...userPanel.plans } : {};
+  const existing = Array.isArray(plans.items) ? [...plans.items] : [];
+  for (const item of planItems) {
+    const sku = item.sku;
+    const index = typeof sku === "string" ? existing.findIndex((plan) => plan.sku === sku) : -1;
+    if (index >= 0) {
+      existing[index] = { ...existing[index], ...item };
+    } else {
+      existing.push(item);
+    }
+  }
+  userPanel.plans = {
+    ...plans,
+    enabled: true,
+    items: existing
+  };
+  modules.userPanel = userPanel;
+  return { ...config2, modules };
+}
 function toRoutePath(relativeFile, pagesDir) {
   const relativeNoExt = relativeFile.replace(/\.(mdx?|tsx|jsx)$/i, "");
   const escaped = pagesDir.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -10981,11 +10956,233 @@ ${customPages}
 `;
 }
 
+// src/cli/make-config/wrap-up.ts
+var DOCS = "https://docs.apitogo.com";
+function printPageAddedHint(relativePath, routePath) {
+  printDiagnosticsToConsole(`Page created: ${relativePath} (route ${routePath})`);
+  printDiagnosticsToConsole("Edit that file to change the content.");
+  printDiagnosticsToConsole(
+    `Predefined components: ${DOCS}/docs/components`
+  );
+}
+function printPlanAddedHint(displayName) {
+  printDiagnosticsToConsole(
+    `Plan "${displayName}" added to modules.userPanel.plans.items in apitogo.config.json.`
+  );
+  printDiagnosticsToConsole(
+    "Configure includedActionKeys, billing, and Stripe in the manifest before publish."
+  );
+  printDiagnosticsToConsole(`Docs: ${DOCS}/docs/configuration/plans`);
+}
+function printPaidPlanPlatformWarning() {
+  printDiagnosticsToConsole(
+    "Paid API plans require Starter or Professional platform hosting. Free cannot publish paid gateway plans."
+  );
+}
+function printInteractiveWrapUp(hasPaidPlans) {
+  printDiagnosticsToConsole("");
+  printDiagnosticsToConsole("Configuration saved. Next steps:");
+  printDiagnosticsToConsole("- Preview locally: npm run dev");
+  if (hasPaidPlans) {
+    printPaidPlanPlatformWarning();
+  } else {
+    printDiagnosticsToConsole(
+      "Platform note: Free hosting does not support paid API plans or custom domains \u2014 use Starter or Professional for those."
+    );
+  }
+  printDiagnosticsToConsole("");
+  printDiagnosticsToConsole("Configure more:");
+  printDiagnosticsToConsole(`- Overview: ${DOCS}/docs/configuration/overview`);
+  printDiagnosticsToConsole(`- Gateway plans: ${DOCS}/docs/configuration/plans`);
+  printDiagnosticsToConsole(`- Custom pages: ${DOCS}/docs/guides/custom-pages`);
+  printDiagnosticsToConsole(`- API reference: ${DOCS}/docs/configuration/api-reference`);
+  printDiagnosticsToConsole(`- Theme: ${DOCS}/docs/customization/colors-theme`);
+  printDiagnosticsToConsole(`- Fonts: ${DOCS}/docs/customization/fonts`);
+  printDiagnosticsToConsole(`- CLI shape: ${DOCS}/docs/cli/shape`);
+}
+
+// src/cli/make-config/interactive.ts
+var ask = async (rl, question, defaultValue) => {
+  const suffix = defaultValue ? ` [${defaultValue}]` : "";
+  const answer = (await rl.question(`${question}${suffix}: `)).trim();
+  return answer || defaultValue || "";
+};
+var askNonNegativeNumber = async (rl, question, defaultValue) => {
+  while (true) {
+    const answer = await ask(rl, question, String(defaultValue));
+    const parsed = Number.parseFloat(answer);
+    if (!Number.isNaN(parsed) && parsed >= 0) {
+      return parsed;
+    }
+    printDiagnosticsToConsole("Enter a non-negative number.");
+  }
+};
+var parseLoopChoice = (raw) => {
+  const value = raw.trim().toLowerCase();
+  if (!value || value === "done") {
+    return "done";
+  }
+  if (value === "openapi" || value === "page" || value === "plan") {
+    return value;
+  }
+  return null;
+};
+async function promptMakeConfigInteractive(defaults) {
+  const rl = createInterface({ input, output });
+  const customPages = [];
+  const planItems = [];
+  let hasPaidPlans = false;
+  let openApiPath;
+  try {
+    const title = await ask(rl, "Site title", defaults.title);
+    while (true) {
+      const choiceRaw = await ask(
+        rl,
+        "Add OpenAPI, a custom page, or a plan? (openapi / page / plan / done)",
+        "done"
+      );
+      const choice = parseLoopChoice(choiceRaw);
+      if (!choice) {
+        printDiagnosticsToConsole("Choose openapi, page, plan, or done.");
+        continue;
+      }
+      if (choice === "done") {
+        break;
+      }
+      if (choice === "openapi") {
+        const entered = await ask(
+          rl,
+          "OpenAPI file path (leave empty to skip)",
+          defaults.discoveredOpenApi ?? ""
+        );
+        openApiPath = entered ? entered : null;
+        if (openApiPath) {
+          printDiagnosticsToConsole(
+            `OpenAPI will be linked as a relative path in apitogo.config.json.`
+          );
+        }
+        continue;
+      }
+      if (choice === "page") {
+        const pageTitle = await ask(rl, "Page title");
+        if (!pageTitle.trim()) {
+          printDiagnosticsToConsole("Page title is required.");
+          continue;
+        }
+        const address = await ask(
+          rl,
+          "Page URL path (e.g. /guides/getting-started)"
+        );
+        const slug = normalizePageSlug(address);
+        if (!slug) {
+          printDiagnosticsToConsole("Page URL path is required.");
+          continue;
+        }
+        const routePath = `/${slug}`;
+        const relativePath = path34.posix.join(defaults.pagesDir, `${slug}.tsx`);
+        const page = {
+          slug,
+          title: pageTitle.trim(),
+          routePath,
+          relativePath
+        };
+        customPages.push(page);
+        printPageAddedHint(relativePath, routePath);
+        continue;
+      }
+      const displayName = await ask(rl, "Plan title");
+      if (!displayName.trim()) {
+        printDiagnosticsToConsole("Plan title is required.");
+        continue;
+      }
+      const priceAmount = await askNonNegativeNumber(
+        rl,
+        "Price (USD/month, 0 for free)",
+        0
+      );
+      const rateLimitCalls = await askNonNegativeNumber(
+        rl,
+        "Rate limit (calls per minute)",
+        100
+      );
+      const monthlyQuota = await askNonNegativeNumber(
+        rl,
+        "Monthly quota (calls per 30 days)",
+        5e4
+      );
+      const planItem = buildPlanItemFromWizard({
+        displayName: displayName.trim(),
+        priceAmount,
+        rateLimitCalls,
+        monthlyQuota
+      });
+      planItems.push(planItem);
+      if (priceAmount > 0) {
+        hasPaidPlans = true;
+        printPaidPlanPlatformWarning();
+      }
+      printPlanAddedHint(displayName.trim());
+    }
+    return {
+      title,
+      site: { title },
+      authentication: {
+        enabled: true,
+        type: "dev-portal"
+      },
+      openApiPath,
+      customPages,
+      planItems,
+      hasPaidPlans
+    };
+  } finally {
+    rl.close();
+  }
+}
+
+// src/cli/make-config/page-scaffold.ts
+function buildStarterDocsPageTsx(slug, title) {
+  const componentName = pageComponentName(slug);
+  const safeTitle = title.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+  return `import { Callout, Heading, Typography } from "@lukoweb/apitogo/components";
+
+export default function ${componentName}() {
+  return (
+    <section className="mx-auto max-w-screen-xl px-4 py-12 pt-(--padding-content-top)">
+      <Typography>
+        <Heading level={1}>${safeTitle}</Heading>
+        <p className="mt-4 text-muted-foreground">
+          Edit this page in <code>pages/${slug}.tsx</code>.
+        </p>
+        <Callout type="info" title="Components">
+          APIToGo ships predefined UI components for docs pages. See{" "}
+          <a
+            href="https://docs.apitogo.com/docs/guides/custom-pages"
+            className="text-primary underline"
+          >
+            custom pages
+          </a>{" "}
+          and the{" "}
+          <a
+            href="https://docs.apitogo.com/docs/components/callout"
+            className="text-primary underline"
+          >
+            component catalog
+          </a>
+          .
+        </Callout>
+      </Typography>
+    </section>
+  );
+}
+`;
+}
+
 // src/cli/make-config/scaffold-project.ts
 init_package_json();
 import { constants } from "node:fs";
 import { access as access2, mkdir as mkdir6, readFile as readFile4, writeFile as writeFile6 } from "node:fs/promises";
-import path33 from "node:path";
+import path35 from "node:path";
 import { glob as glob4 } from "glob";
 var OPENAPI_GLOBS = [
   "apis/openapi.json",
@@ -10995,9 +11192,9 @@ var OPENAPI_GLOBS = [
   "openapi.yaml",
   "openapi.yml"
 ];
-var toPosix = (p) => p.split(path33.sep).join("/");
+var toPosix = (p) => p.split(path35.sep).join("/");
 var sanitizePackageName = (dir) => {
-  const base = path33.basename(path33.resolve(dir));
+  const base = path35.basename(path35.resolve(dir));
   const s = base.toLowerCase().replace(/[^a-z0-9-_.]/g, "-").replace(/^-+|-+$/g, "");
   return s || "apitogo-site";
 };
@@ -11007,7 +11204,7 @@ var apitogoVersionRange = () => {
 };
 async function findOpenApiSpecPath(dir) {
   for (const rel of OPENAPI_GLOBS) {
-    const full = path33.join(dir, rel);
+    const full = path35.join(dir, rel);
     try {
       await access2(full, constants.R_OK);
       return toPosix(rel);
@@ -11022,7 +11219,7 @@ async function findOpenApiSpecPath(dir) {
   return extra[0] ? toPosix(extra[0]) : null;
 }
 async function ensurePackageJson(dir) {
-  const pkgPath = path33.join(dir, "package.json");
+  const pkgPath = path35.join(dir, "package.json");
   const apitogoVer = apitogoVersionRange();
   const baseDeps = {
     react: ">=19.0.0",
@@ -11089,7 +11286,7 @@ async function ensurePackageJson(dir) {
   return false;
 }
 async function ensureTsconfigJson(dir) {
-  const tsPath = path33.join(dir, "tsconfig.json");
+  const tsPath = path35.join(dir, "tsconfig.json");
   try {
     await access2(tsPath, constants.R_OK);
     return false;
@@ -11179,19 +11376,19 @@ var fileExists2 = async (filePath) => {
   }
 };
 async function ensurePortalStubFiles(dir) {
-  const landingPath = path33.join(dir, "landing", "LandingPage.tsx");
+  const landingPath = path35.join(dir, "landing", "LandingPage.tsx");
   if (!await fileExists2(landingPath)) {
-    await mkdir6(path33.join(dir, "landing"), { recursive: true });
+    await mkdir6(path35.join(dir, "landing"), { recursive: true });
     await writeFile6(landingPath, LANDING_PAGE_SOURCE, "utf8");
   }
-  const plansPath = path33.join(dir, "user-panel", "AccountPlansPage.tsx");
+  const plansPath = path35.join(dir, "user-panel", "AccountPlansPage.tsx");
   if (!await fileExists2(plansPath)) {
-    await mkdir6(path33.join(dir, "user-panel"), { recursive: true });
+    await mkdir6(path35.join(dir, "user-panel"), { recursive: true });
     await writeFile6(plansPath, ACCOUNT_PLANS_PAGE_SOURCE, "utf8");
   }
 }
 async function ensureThinConfigTsx(dir) {
-  const tsxPath = path33.join(dir, "apitogo.config.tsx");
+  const tsxPath = path35.join(dir, "apitogo.config.tsx");
   if (await fileExists2(tsxPath)) {
     return false;
   }
@@ -11200,7 +11397,7 @@ async function ensureThinConfigTsx(dir) {
 }
 
 // src/cli/make-config/handler.ts
-var toPosixPath2 = (value) => value.split(path34.sep).join(path34.posix.sep);
+var toPosixPath2 = (value) => value.split(path36.sep).join(path36.posix.sep);
 var fileExists3 = async (filePath) => {
   try {
     await access3(filePath, constants2.F_OK);
@@ -11218,7 +11415,7 @@ var readJsonConfig = async (filePath) => {
   return parsed;
 };
 async function makeConfig(argv) {
-  const dir = path34.resolve(process.cwd(), argv.dir);
+  const dir = path36.resolve(process.cwd(), argv.dir);
   const pagesDir = toPosixPath2(
     argv.pagesDir.replace(/^[./]+/, "").replace(/\/+$/, "")
   );
@@ -11235,14 +11432,14 @@ async function makeConfig(argv) {
       printDiagnosticsToConsole("Created tsconfig.json.");
     }
     await ensurePortalStubFiles(dir);
-    const jsonPath = path34.join(dir, APITOGO_JSON_FILENAME);
+    const jsonPath = path36.join(dir, APITOGO_JSON_FILENAME);
     let createdJson = false;
     let config2;
     if (await fileExists3(jsonPath)) {
       config2 = await readJsonConfig(jsonPath);
     } else {
       config2 = createDefaultApitogoJsonConfig({
-        title: titleFromDirectoryName(path34.basename(dir)),
+        title: titleFromDirectoryName(path36.basename(dir)),
         pagesDir
       });
       createdJson = true;
@@ -11259,27 +11456,27 @@ async function makeConfig(argv) {
       title: argv.title
     };
     let openApiOverride;
+    let interactiveHasPaidPlans = false;
     if (argv.interactive) {
       const site = isPlainObject2(config2.site) ? config2.site : {};
-      const logo = isPlainObject2(site.logo) ? site.logo : {};
-      const theme = isPlainObject2(config2.theme) ? config2.theme : {};
-      const fonts = isPlainObject2(theme.fonts) ? theme.fonts : {};
-      const light = isPlainObject2(theme.light) ? theme.light : {};
-      const dark = isPlainObject2(theme.dark) ? theme.dark : {};
-      const authentication = isPlainObject2(config2.authentication) ? config2.authentication : {};
       const prompted = await promptMakeConfigInteractive({
-        title: flagPatches.title ?? (typeof site.title === "string" ? site.title : titleFromDirectoryName(path34.basename(dir))),
-        logoAlt: typeof logo.alt === "string" ? logo.alt : "APIToGo",
-        authEnabled: authentication.enabled === true,
-        apiBaseUrl: typeof authentication.apiBaseUrl === "string" ? authentication.apiBaseUrl : void 0,
-        sans: typeof fonts.sans === "string" ? fonts.sans : void 0,
-        mono: typeof fonts.mono === "string" ? fonts.mono : void 0,
-        lightPrimary: typeof light.primary === "string" ? light.primary : void 0,
-        darkPrimary: typeof dark.primary === "string" ? dark.primary : void 0,
-        discoveredOpenApi
+        title: flagPatches.title ?? (typeof site.title === "string" ? site.title : titleFromDirectoryName(path36.basename(dir))),
+        discoveredOpenApi,
+        pagesDir
       });
       openApiOverride = prompted.openApiPath;
+      interactiveHasPaidPlans = prompted.hasPaidPlans;
       config2 = applyConfigPatches(config2, prompted);
+      config2 = applyPlansToJsonConfig(config2, prompted.planItems);
+      for (const page of prompted.customPages) {
+        const pagePath = path36.join(dir, page.relativePath);
+        await mkdir7(path36.dirname(pagePath), { recursive: true });
+        await writeFile7(
+          pagePath,
+          buildStarterDocsPageTsx(page.slug, page.title),
+          "utf8"
+        );
+      }
     }
     config2 = applyConfigPatches(config2, flagPatches);
     const pageFiles = await glob5(`${pagesDir}/**/*.{md,mdx,tsx,jsx}`, {
@@ -11305,14 +11502,12 @@ async function makeConfig(argv) {
     );
     const openApiRel = openApiOverride === void 0 ? discoveredOpenApi : openApiOverride;
     if (openApiRel) {
-      config2 = applyOpenApiToJsonConfig(
-        config2,
-        openapiInputForConfig(openApiRel)
-      );
+      const openApiInput = argv.interactive ? toRelativeOpenApiInput(dir, openApiRel) : openapiInputForConfig(openApiRel);
+      config2 = applyOpenApiToJsonConfig(config2, openApiInput);
     }
     await writeFile7(jsonPath, `${JSON.stringify(config2, null, 2)}
 `, "utf8");
-    const tsxPath = path34.join(dir, "apitogo.config.tsx");
+    const tsxPath = path36.join(dir, "apitogo.config.tsx");
     if (await fileExists3(tsxPath) && tsxRoutes.length > 0) {
       const tsxSource = await readFile5(tsxPath, "utf8");
       if (isThinConfigWrapper(tsxSource)) {
@@ -11325,13 +11520,16 @@ async function makeConfig(argv) {
     }
     const action = createdJson ? "Initialized" : "Updated";
     printResultToConsole(
-      `${action} ${APITOGO_JSON_FILENAME} (site/theme/auth/navigation/OpenAPI as applicable; redirects unchanged).`
+      `${action} ${APITOGO_JSON_FILENAME} (site/auth/navigation/OpenAPI/plans as applicable; redirects unchanged).`
     );
     if (createdPackageJson) {
       printDiagnosticsToConsole(
         "Next: run npm install (or pnpm install / yarn) in this directory, then npm run dev."
       );
     }
+    if (argv.interactive) {
+      printInteractiveWrapUp(interactiveHasPaidPlans);
+    }
   } catch (error) {
     await printCriticalFailureToConsoleAndExit(
       error instanceof Error ? error.message : String(error)
@@ -11357,7 +11555,7 @@ var config_default = {
   }).option("interactive", {
     alias: "i",
     type: "boolean",
-    describe: "Prompt for site, theme, authentication, and OpenAPI",
+    describe: "Interactive wizard: site title, OpenAPI path, custom pages, and gateway plans",
     default: false
   }).option("site", {
     type: "string",
@@ -11411,14 +11609,14 @@ var deploy_default = {
 
 // src/cli/dev/handler.ts
 init_joinUrl();
-import path37 from "node:path";
+import path39 from "node:path";
 
 // src/vite/dev-server.ts
 init_logger();
 import fs4 from "node:fs/promises";
 import http from "node:http";
 import https from "node:https";
-import path36 from "node:path";
+import path38 from "node:path";
 import { createHttpTerminator } from "http-terminator";
 import {
   createServer as createViteServer,
@@ -11451,7 +11649,7 @@ init_loader();
 // src/vite/pagefind-dev-index.ts
 init_invariant();
 init_joinUrl();
-import path35 from "node:path";
+import path37 from "node:path";
 import { createIndex as createIndex2 } from "pagefind";
 import { isRunnableDevEnvironment } from "vite";
 async function* buildPagefindDevIndex(vite, config2) {
@@ -11504,7 +11702,7 @@ async function* buildPagefindDevIndex(vite, config2) {
       path: urlPath
     };
   }
-  const outputPath = path35.join(vite.config.publicDir, "pagefind");
+  const outputPath = path37.join(vite.config.publicDir, "pagefind");
   await pagefindIndex.writeFiles({ outputPath });
   yield { type: "complete", success: true, indexed };
 }
@@ -11523,9 +11721,9 @@ var DevServer = class {
     this.protocol = "https";
     const { dir } = this.options;
     const [key, cert, ca] = await Promise.all([
-      fs4.readFile(path36.resolve(dir, config2.https.key)),
-      fs4.readFile(path36.resolve(dir, config2.https.cert)),
-      config2.https.ca ? fs4.readFile(path36.resolve(dir, config2.https.ca)) : void 0
+      fs4.readFile(path38.resolve(dir, config2.https.key)),
+      fs4.readFile(path38.resolve(dir, config2.https.cert)),
+      config2.https.ca ? fs4.readFile(path38.resolve(dir, config2.https.ca)) : void 0
     ]);
     return https.createServer({ key, cert, ca });
   }
@@ -11542,7 +11740,7 @@ var DevServer = class {
     );
     const server = await this.createNodeServer(config2);
     if (config2.search?.type === "pagefind" && viteConfig.publicDir !== false) {
-      const publicRoot = path36.resolve(
+      const publicRoot = path38.resolve(
         this.options.dir,
         typeof viteConfig.publicDir === "string" ? viteConfig.publicDir : "public"
       );
@@ -11559,7 +11757,7 @@ var DevServer = class {
           // built-in transform middleware which would treat the path as a static asset.
           name: "apitogo:entry-client",
           configureServer(server2) {
-            const entryPath = path36.posix.join(
+            const entryPath = path38.posix.join(
               server2.config.base,
               "/__z/entry.client.tsx"
             );
@@ -11724,7 +11922,7 @@ init_package_json();
 async function dev(argv) {
   const packageJson2 = getZudokuPackageJson();
   process.env.NODE_ENV = "development";
-  const dir = path37.resolve(process.cwd(), argv.dir);
+  const dir = path39.resolve(process.cwd(), argv.dir);
   const server = new DevServer({
     dir,
     argPort: argv.port,
@@ -11807,9 +12005,9 @@ var dev_default = {
 };
 
 // src/cli/init/handler.ts
-import path38 from "node:path";
+import path40 from "node:path";
 async function init2(argv) {
-  const dir = path38.resolve(process.cwd(), argv.dir ?? ".");
+  const dir = path40.resolve(process.cwd(), argv.dir ?? ".");
   try {
     const createdPackageJson = await ensurePackageJson(dir);
     const createdTsconfig = await ensureTsconfigJson(dir);
@@ -11881,12 +12079,12 @@ var remove_default = {
 };
 
 // src/cli/status/handler.ts
-import path40 from "node:path";
+import path42 from "node:path";
 
 // src/cli/common/mcp-cli.ts
 import { access as access4 } from "node:fs/promises";
 import { spawn as spawn2 } from "node:child_process";
-import path39 from "node:path";
+import path41 from "node:path";
 async function pathExists2(candidate) {
   try {
     await access4(candidate);
@@ -11899,7 +12097,7 @@ async function resolveApitogoMcpCliCommand(binary) {
   const binName = `apitogo-${binary}`;
   const mcpPath = process.env.APITOGO_MCP_PATH?.trim();
   if (mcpPath) {
-    const scriptJs = path39.join(mcpPath, "dist", "cli", `${binary}.js`);
+    const scriptJs = path41.join(mcpPath, "dist", "cli", `${binary}.js`);
     if (await pathExists2(scriptJs)) {
       return {
         command: process.execPath,
@@ -11957,7 +12155,7 @@ async function runApitogoMcpCli(binary, childArgs, options = {}) {
 
 // src/cli/status/handler.ts
 async function status(argv) {
-  const dir = path40.resolve(process.cwd(), argv.dir);
+  const dir = path42.resolve(process.cwd(), argv.dir);
   const args = [dir];
   if (argv.projectId?.trim()) {
     args.push("--project-id", argv.projectId.trim());
@@ -11999,7 +12197,7 @@ var status_default = {
 };
 
 // src/cli/teardown/handler.ts
-import path41 from "node:path";
+import path43 from "node:path";
 async function teardown(argv) {
   if (!argv.yes) {
     await printCriticalFailureToConsoleAndExit(
@@ -12007,7 +12205,7 @@ async function teardown(argv) {
     );
     return;
   }
-  const dir = path41.resolve(process.cwd(), argv.dir);
+  const dir = path43.resolve(process.cwd(), argv.dir);
   const args = [dir, "--yes"];
   if (argv.projectId?.trim()) {
     args.push("--project-id", argv.projectId.trim());
@@ -12122,12 +12320,12 @@ function box(message, {
 
 // src/cli/common/xdg/lib.ts
 import { homedir } from "node:os";
-import path42 from "node:path";
+import path44 from "node:path";
 function defineDirectoryWithFallback(xdgName, fallback) {
   if (process.env[xdgName]) {
     return process.env[xdgName];
   } else {
-    return path42.join(homedir(), fallback);
+    return path44.join(homedir(), fallback);
   }
 }
 var XDG_CONFIG_HOME = defineDirectoryWithFallback(
@@ -12142,15 +12340,15 @@ var XDG_STATE_HOME = defineDirectoryWithFallback(
   "XDG_DATA_HOME",
   ".local/state"
 );
-var ZUDOKU_XDG_CONFIG_HOME = path42.join(
+var ZUDOKU_XDG_CONFIG_HOME = path44.join(
   XDG_CONFIG_HOME,
   CLI_XDG_FOLDER_NAME
 );
-var ZUDOKU_XDG_DATA_HOME = path42.join(
+var ZUDOKU_XDG_DATA_HOME = path44.join(
   XDG_DATA_HOME,
   CLI_XDG_FOLDER_NAME
 );
-var ZUDOKU_XDG_STATE_HOME = path42.join(
+var ZUDOKU_XDG_STATE_HOME = path44.join(
   XDG_STATE_HOME,
   CLI_XDG_FOLDER_NAME
 );