@lukoweb/apitogo 0.1.121 → 0.1.126

package/dist/cli/cli.js

@@ -212,7 +212,9 @@ function mergeLimitsSource(prior, patch) {
   return planForConfig(merged);
 }
 function planLimitsForPlatform(plan) {
-  return stringifyGatewayLimits(coerceGatewayLimits(plan));
+  return stringifyGatewayLimits(
+    coerceGatewayLimits(plan)
+  );
 }
 function validateLimitsField(value, field) {
   if (value == null || value === "") {
@@ -1176,8 +1178,8 @@ async function readEffectiveManifest(rootDir, _env) {
 var BillingPeriodSchema, GatewayLimitsSchema, PriceCurrencySchema, ALLOWED_RUNTIME_VERSIONS, ManifestPlanInputSchema, DevPortalLocalManifestSchema;
 var init_local_manifest = __esm({
   "src/config/local-manifest.ts"() {
-    init_gateway_limits();
     init_apitogo_config_loader();
+    init_gateway_limits();
     init_landing_manifest();
     BillingPeriodSchema = z4.enum(["month", "year", "monthly", "annual"]);
     GatewayLimitsSchema = z4.object({
@@ -1503,10 +1505,7 @@ var init_resolve_modules = __esm({
             codeExample: content?.hero?.codeExample ?? defaults.hero?.codeExample,
             titleAccent: content?.hero?.titleAccent ?? (content?.hero?.title ? void 0 : defaults.hero?.titleAccent)
           },
-          featuresSection: mergeLandingSection(
-            defaults.featuresSection,
-            content?.featuresSection
-          ),
+          featuresSection: defaults.featuresSection || content?.featuresSection ? { ...defaults.featuresSection, ...content?.featuresSection } : void 0,
           features: content?.features ?? defaults.features,
           primaryAction: content?.primaryAction ?? defaults.primaryAction,
           secondaryAction: content?.secondaryAction ?? defaults.secondaryAction,
@@ -1534,7 +1533,7 @@ var init_resolve_modules = __esm({
           ...content.hero,
           title: content.hero?.title ?? siteTitle
         },
-        featuresSection: content.featuresSection ? mergeLandingSection(void 0, content.featuresSection) : void 0,
+        featuresSection: content.featuresSection,
         features: content.features,
         primaryAction: content.primaryAction,
         secondaryAction: content.secondaryAction,
@@ -5063,7 +5062,7 @@ async function loadZudokuConfigWithMeta(rootDir) {
       dependencies,
       configPath
     },
-    __resolvedModules: resolveModulesConfig(config2, { rootDir })
+    __resolvedModules: resolveModulesConfig(config2)
   };
   return configWithMetadata;
 }
@@ -5094,9 +5093,7 @@ function isWatchableConfigDependency(depPath) {
   return !depPath.startsWith("\0virtual:") && !depPath.startsWith("virtual:");
 }
 function getWatchableConfigDependencies(config2) {
-  const manifestEnv = resolveManifestEnv(
-    config2.__meta.mode === "production" ? "production" : "development"
-  );
+  const manifestEnv = resolveManifestEnv("development");
   const { watchPaths } = manifestPathsForEnv(
     config2.__meta.rootDir,
     manifestEnv
@@ -5175,9 +5172,7 @@ async function loadZudokuConfig(configEnv, rootDir) {
         ...transformedConfig.__meta,
         ...configWithManifestMeta.__meta
       },
-      __resolvedModules: resolveModulesConfig(transformedConfig, {
-        rootDir: transformedConfig.__meta.rootDir
-      })
+      __resolvedModules: resolveModulesConfig(transformedConfig)
     };
     if (!process.env.APITOGO_JSON_ONLY) {
       logger.info(
@@ -5802,7 +5797,7 @@ import {
 // package.json
 var package_default = {
   name: "@lukoweb/apitogo",
-  version: "0.1.121",
+  version: "0.1.126",
   type: "module",
   sideEffects: [
     "**/*.css",
@@ -9864,10 +9859,6 @@ function vitePlugin() {
 }
 
 // src/vite/config.ts
-var browserConfigLoaderPath2 = path26.join(
-  getZudokuRootDir(),
-  "src/config/apitogo-config-loader.browser.ts"
-);
 var resolveMergedPublicDir = (rootDir, merged) => {
   if (merged.publicDir === false) return void 0;
   const rel = typeof merged.publicDir === "string" ? merged.publicDir : "public";
@@ -9925,22 +9916,6 @@ async function getViteConfig(dir, configEnv) {
         "@mdx-js/react": import.meta.resolve("@mdx-js/react")
       }
     },
-    environments: {
-      client: {
-        resolve: {
-          alias: {
-            [path26.join(
-              getZudokuRootDir(),
-              "src/config/apitogo-config-loader.node.ts"
-            )]: browserConfigLoaderPath2,
-            [path26.join(
-              getZudokuRootDir(),
-              "src/config/apitogo-config-loader.node.js"
-            )]: browserConfigLoaderPath2
-          }
-        }
-      }
-    },
     define: {
       "process.env.ZUDOKU_VERSION": JSON.stringify(package_default.version),
       "process.env.IS_ZUPLO": ZuploEnv.isZuplo,
@@ -10689,7 +10664,9 @@ async function build(argv) {
   const packageJson3 = getZudokuPackageJson();
   const jsonOnly = argv.jsonOnly === true || process.env.APITOGO_JSON_ONLY === "1";
   if (!jsonOnly) {
-    printDiagnosticsToConsole(`Starting API ToGo build v${packageJson3.version}`);
+    printDiagnosticsToConsole(
+      `Starting API ToGo build v${packageJson3.version}`
+    );
     printDiagnosticsToConsole("");
     printDiagnosticsToConsole("");
   }
@@ -11795,11 +11772,16 @@ function applyManifestToConfig(config2, manifest) {
     const site = next.site ?? {};
     site.title = title;
     if (manifest.branding?.logoUrl) {
+      const existingLogo = site.logo ?? {};
+      const existingSrc = existingLogo.src ?? {};
       site.logo = {
-        ...site.logo ?? {},
+        ...existingLogo,
+        // Platform branding only stores a single logo — only override the
+        // light slot so an existing dark-mode asset (e.g. logo-dark.svg)
+        // isn't clobbered.
         src: {
-          light: manifest.branding.logoUrl,
-          dark: manifest.branding.logoUrl
+          ...existingSrc,
+          light: manifest.branding.logoUrl
         }
       };
     }
@@ -12176,7 +12158,14 @@ async function writeManifest(siteDirectory, manifest) {
 }
 
 // src/cli/platform/helpers/dev-portal-secrets.ts
-import { access as access2, appendFile, mkdir as mkdir7, readFile as readFile7, unlink, writeFile as writeFile8 } from "node:fs/promises";
+import {
+  access as access2,
+  appendFile,
+  mkdir as mkdir7,
+  readFile as readFile7,
+  unlink,
+  writeFile as writeFile8
+} from "node:fs/promises";
 import path37 from "node:path";
 var ENV_FILENAME = ".env";
 var COLLAPSED_UPPERCASE_ALIASES2 = {
@@ -12236,7 +12225,7 @@ function parseEnvValue2(raw) {
   return trimmed;
 }
 function resolveExistingKey2(target, key) {
-  if (Object.prototype.hasOwnProperty.call(target, key)) {
+  if (Object.hasOwn(target, key)) {
     return key;
   }
   const lower = key.toLowerCase();
@@ -12299,7 +12288,10 @@ async function loadSiteEnv(siteDirectory) {
   const resolvedDirectory = path37.resolve(siteDirectory);
   const merged = { ...process.env };
   for (const fileName of [ENV_FILENAME, ".env.local"]) {
-    Object.assign(merged, await readEnvFile(path37.join(resolvedDirectory, fileName)));
+    Object.assign(
+      merged,
+      await readEnvFile(path37.join(resolvedDirectory, fileName))
+    );
   }
   return merged;
 }
@@ -12385,7 +12377,11 @@ function getSecretsStatus(siteDirectory, manifest, secrets, envExists) {
   };
 }
 function validateSecretsForPublish(manifest, secrets, emailOptions) {
-  const prerequisites = getPublishPrerequisites(manifest, secrets, emailOptions);
+  const prerequisites = getPublishPrerequisites(
+    manifest,
+    secrets,
+    emailOptions
+  );
   if (prerequisites.readyToPublish) {
     return;
   }
@@ -12411,7 +12407,11 @@ async function resolvePublishConfig(siteDirectory, emailOptions) {
   const env = await loadSiteEnv(resolvedDirectory);
   const secrets = readAuthenticationSecretsFromEnv(env);
   const envExists = await siteEnvFileHasEntries(resolvedDirectory);
-  const publishPrerequisites = getPublishPrerequisites(manifestRaw, secrets, emailOptions);
+  const publishPrerequisites = getPublishPrerequisites(
+    manifestRaw,
+    secrets,
+    emailOptions
+  );
   const secretsStatus = getSecretsStatus(
     resolvedDirectory,
     manifestRaw,
@@ -12487,13 +12487,15 @@ var writeScaffoldSecretsArtifacts = writeScaffoldEnv;
 var SECRETS_COLLECTION_INSTRUCTION = "For go-live, plans must already be in apitogo.config.json \u2014 ask the user what plans they want before calling update_dev_portal_manifest; never add Free+Pro defaults unless they explicitly request them. The user must save auth secrets (OIDC provider secrets, and Stripe if paid plans) in .env using APITOGO_CONFIG_AUTHENTICATION__* keys. Native auth email is provisioned by the platform \u2014 do not ask for an ACS connection string. Share .env and required fields from publishPrerequisites.missingFields. Never ask for or accept secret values in chat. When the user confirms secrets are saved locally, call check_dev_portal_publish_readiness, then publish_dev_portal.";
 
 // src/cli/platform/helpers/dev-portal-site-validation.ts
+init_gateway_limits();
 import { readFile as readFile8 } from "node:fs/promises";
 import { createRequire as createRequire2 } from "node:module";
 import path38 from "node:path";
-init_gateway_limits();
 var cachedFallbackTs;
 async function loadTypeScriptForSite(sourceDirectory) {
-  const require2 = createRequire2(path38.join(path38.resolve(sourceDirectory), "package.json"));
+  const require2 = createRequire2(
+    path38.join(path38.resolve(sourceDirectory), "package.json")
+  );
   try {
     return require2("typescript");
   } catch {
@@ -12520,11 +12522,12 @@ function checkTsxSyntax(ts, fileName, content) {
     }
   });
   return (result.diagnostics ?? []).filter((diagnostic) => diagnostic.category === ts.DiagnosticCategory.Error).map((diagnostic) => {
-    const message = ts.flattenDiagnosticMessageText(diagnostic.messageText, " ");
+    const message = ts.flattenDiagnosticMessageText(
+      diagnostic.messageText,
+      " "
+    );
     if (diagnostic.file && diagnostic.start !== void 0) {
-      const { line, character } = diagnostic.file.getLineAndCharacterOfPosition(
-        diagnostic.start
-      );
+      const { line, character } = diagnostic.file.getLineAndCharacterOfPosition(diagnostic.start);
       return `${message} (line ${line + 1}, column ${character + 1})`;
     }
     return message;
@@ -12537,7 +12540,9 @@ async function referencedFileExists(sourceDirectory, reference) {
   if (/^https?:\/\//i.test(reference)) {
     return true;
   }
-  return pathExists(path38.resolve(sourceDirectory, reference.replace(/^\.\//, "")));
+  return pathExists(
+    path38.resolve(sourceDirectory, reference.replace(/^\.\//, ""))
+  );
 }
 async function validateSiteConfigStructure(config2, sourceDirectory) {
   const errors = [];
@@ -12561,7 +12566,9 @@ async function validateSiteConfigStructure(config2, sourceDirectory) {
         if (!item) {
           errors.push(`"navigation[${index}]" must be an object.`);
         } else if (typeof item.type !== "string" || !item.type.trim()) {
-          errors.push(`"navigation[${index}].type" must be a non-empty string.`);
+          errors.push(
+            `"navigation[${index}].type" must be a non-empty string.`
+          );
         }
       });
     }
@@ -12580,7 +12587,9 @@ async function validateSiteConfigStructure(config2, sourceDirectory) {
       if (typeof api.input !== "string" || !api.input.trim()) {
         errors.push(`"apis[${index}].input" must be a non-empty string.`);
       } else if (api.type === "file" && !await referencedFileExists(sourceDirectory, api.input)) {
-        errors.push(`"apis[${index}].input" points to a missing file: ${api.input}`);
+        errors.push(
+          `"apis[${index}].input" points to a missing file: ${api.input}`
+        );
       }
       if (typeof api.path !== "string" || !api.path.trim()) {
         errors.push(`"apis[${index}].path" must be a non-empty string.`);
@@ -12593,7 +12602,9 @@ async function validateSiteConfigStructure(config2, sourceDirectory) {
   const modules = asRecord2(root.modules);
   const landing = asRecord2(modules?.landing);
   if (typeof landing?.page === "string" && landing.page.trim() && !await referencedFileExists(sourceDirectory, landing.page)) {
-    errors.push(`"modules.landing.page" points to a missing file: ${landing.page}`);
+    errors.push(
+      `"modules.landing.page" points to a missing file: ${landing.page}`
+    );
   }
   const plansModule = asRecord2(asRecord2(modules?.userPanel)?.plans);
   if (plansModule?.items !== void 0) {
@@ -12603,7 +12614,9 @@ async function validateSiteConfigStructure(config2, sourceDirectory) {
       plansModule.items.forEach((entry, index) => {
         const plan = asRecord2(entry);
         if (!plan) {
-          errors.push(`"modules.userPanel.plans.items[${index}]" must be an object.`);
+          errors.push(
+            `"modules.userPanel.plans.items[${index}]" must be an object.`
+          );
           return;
         }
         if (typeof plan.sku !== "string" || !plan.sku.trim()) {
@@ -12662,7 +12675,10 @@ async function validateDevPortalSiteConfig(sourceDirectory, options) {
       });
     }
     if (!parseFailed) {
-      const structureErrors = await validateSiteConfigStructure(parsed, resolvedDir);
+      const structureErrors = await validateSiteConfigStructure(
+        parsed,
+        resolvedDir
+      );
       issues.push(
         ...structureErrors.map((message) => ({
           file: APITOGO_CONFIG_FILENAME2,
@@ -12689,7 +12705,10 @@ async function validateDevPortalSiteConfig(sourceDirectory, options) {
     } else {
       for (const relativeFile of existingTsxFiles) {
         checkedFiles.push(relativeFile);
-        const content = await readFile8(path38.join(resolvedDir, relativeFile), "utf8");
+        const content = await readFile8(
+          path38.join(resolvedDir, relativeFile),
+          "utf8"
+        );
         issues.push(
           ...checkTsxSyntax(ts, relativeFile, content).map((message) => ({
             file: relativeFile,
@@ -12745,7 +12764,9 @@ function parseNodeMajor(version) {
 function assertNodeVersion(required) {
   const major = parseNodeMajor(process.version);
   if (Number.isNaN(major) || major < MIN_NODE_MAJOR) {
-    throw new Error(`Node.js ${MIN_NODE_MAJOR}+ is required (current: ${process.version}).`);
+    throw new Error(
+      `Node.js ${MIN_NODE_MAJOR}+ is required (current: ${process.version}).`
+    );
   }
   if (required) {
     const requiredMajor = parseNodeMajor(required);
@@ -13011,7 +13032,9 @@ function normalizeRuntime(runtime) {
   if (raw === "dotnet" || raw === ".net" || raw === "net") return "dotnet";
   if (raw === "nodejs" || raw === "node") return "nodejs";
   if (raw === "python") return "python";
-  throw new Error(`runtime must be one of: dotnet, nodejs, python; got '${runtime}'.`);
+  throw new Error(
+    `runtime must be one of: dotnet, nodejs, python; got '${runtime}'.`
+  );
 }
 function normalizePlanForGatewayApi(plan) {
   return {
@@ -13069,7 +13092,10 @@ function normalizeManifestForPlatform(manifest) {
           }
         }
         if (backend.runtimeVersion) {
-          const slug = normalizeRuntimeVersionSlug(backend.runtime, backend.runtimeVersion);
+          const slug = normalizeRuntimeVersionSlug(
+            backend.runtime,
+            backend.runtimeVersion
+          );
           if (slug !== backend.runtimeVersion) {
             corrections.push({
               field: "backend.runtimeVersion",
@@ -13094,7 +13120,10 @@ function validateManifestForPlatformPublish(manifest) {
   } else {
     for (const [index, plan] of manifest.plans.entries()) {
       if (!plan.sku?.trim()) {
-        issues.push({ field: `plans[${index}].sku`, message: "sku is required." });
+        issues.push({
+          field: `plans[${index}].sku`,
+          message: "sku is required."
+        });
       }
       if (!plan.displayName?.trim()) {
         issues.push({
@@ -13110,7 +13139,10 @@ function validateManifestForPlatformPublish(manifest) {
       }
       const currencyResult = tryNormalizePriceCurrency(plan.priceCurrency);
       if (!currencyResult.ok) {
-        issues.push({ field: `plans[${index}].priceCurrency`, message: currencyResult.message });
+        issues.push({
+          field: `plans[${index}].priceCurrency`,
+          message: currencyResult.message
+        });
       } else if ((plan.priceCurrency ?? "usd") !== currencyResult.value) {
         corrections.push({
           field: `plans[${index}].priceCurrency`,
@@ -13152,7 +13184,10 @@ function validateManifestForPlatformPublish(manifest) {
         manifest.backend.runtimeVersion
       );
       if (!runtimeResult.ok) {
-        issues.push({ field: "backend.runtimeVersion", message: runtimeResult.message });
+        issues.push({
+          field: "backend.runtimeVersion",
+          message: runtimeResult.message
+        });
       } else if (runtimeResult.value !== manifest.backend.runtimeVersion) {
         corrections.push({
           field: "backend.runtimeVersion",
@@ -13320,9 +13355,143 @@ import path52 from "node:path";
 import { stdin as input2 } from "node:process";
 import { glob as glob5 } from "glob";
 
+// src/cli/platform/helpers/openapi-action-keys.ts
+import { existsSync as existsSync5, readFileSync as readFileSync3 } from "node:fs";
+import path42 from "node:path";
+import YAML from "yaml";
+var HTTP_METHODS = [
+  "get",
+  "post",
+  "put",
+  "patch",
+  "delete",
+  "head",
+  "options"
+];
+function normalizeOpenApiPathTemplate(pathTemplate) {
+  if (!pathTemplate.trim()) {
+    return "/";
+  }
+  let value = pathTemplate.trim();
+  if (!value.startsWith("/")) {
+    value = `/${value}`;
+  }
+  if (value.length > 1 && value.endsWith("/")) {
+    value = value.replace(/\/+$/, "");
+  }
+  return value;
+}
+function resolveRelativeServerBasePath(document) {
+  const serverUrl = document.servers?.[0]?.url;
+  if (!serverUrl || serverUrl === "/") {
+    return null;
+  }
+  return serverUrl.startsWith("/") ? serverUrl.replace(/\/+$/, "") : null;
+}
+function combineBasePath(basePath, pathKey) {
+  const normalizedPath = normalizeOpenApiPathTemplate(pathKey);
+  if (!basePath || basePath === "/") {
+    return normalizedPath;
+  }
+  const baseNorm = normalizeOpenApiPathTemplate(basePath);
+  if (normalizedPath === "/") {
+    return baseNorm;
+  }
+  return `${baseNorm.replace(/\/+$/, "")}${normalizedPath}`;
+}
+function extractGatewayActionKeysFromOpenApiDocument(document) {
+  if (!document || typeof document !== "object") {
+    return [];
+  }
+  const spec = document;
+  if (!spec.paths || typeof spec.paths !== "object") {
+    return [];
+  }
+  const basePath = resolveRelativeServerBasePath(spec);
+  const keys = /* @__PURE__ */ new Set();
+  for (const [pathKey, pathItem] of Object.entries(spec.paths)) {
+    if (!pathItem || typeof pathItem !== "object") {
+      continue;
+    }
+    const pathTemplate = combineBasePath(basePath, pathKey);
+    for (const method of HTTP_METHODS) {
+      if (!pathItem[method] || typeof pathItem[method] !== "object") {
+        continue;
+      }
+      keys.add(`${method}:${pathTemplate}`);
+    }
+  }
+  return [...keys].sort((a, b) => a.localeCompare(b));
+}
+function extractGatewayActionKeysFromOpenApiFile(filePath) {
+  try {
+    const raw = readFileSync3(filePath, "utf8");
+    const ext = path42.extname(filePath).toLowerCase();
+    const parsed = ext === ".json" ? JSON.parse(raw) : YAML.parse(raw);
+    return extractGatewayActionKeysFromOpenApiDocument(parsed);
+  } catch {
+    return [];
+  }
+}
+function resolveConfigOpenApiFilePath(siteDirectory, config2) {
+  const backend = config2.backend;
+  const candidates = [];
+  if (typeof backend?.openApiPath === "string" && backend.openApiPath.trim()) {
+    candidates.push(backend.openApiPath.trim());
+  }
+  const apis = config2.apis;
+  const entries = Array.isArray(apis) ? apis : apis ? [apis] : [];
+  for (const entry of entries) {
+    if (entry && typeof entry === "object" && entry.type === "file" && typeof entry.input === "string") {
+      candidates.push(entry.input);
+    }
+  }
+  for (const candidate of candidates) {
+    const resolved = path42.isAbsolute(candidate) ? candidate : path42.resolve(siteDirectory, candidate);
+    if (existsSync5(resolved)) {
+      return resolved;
+    }
+  }
+  return void 0;
+}
+function loadOpenApiActionKeysForSite(siteDirectory, config2) {
+  const filePath = resolveConfigOpenApiFilePath(siteDirectory, config2);
+  if (!filePath) {
+    return [];
+  }
+  return extractGatewayActionKeysFromOpenApiFile(filePath);
+}
+function loadOpenApiActionKeysFromSiteDirectory(siteDirectory) {
+  const configPath = path42.join(siteDirectory, "apitogo.config.json");
+  if (!existsSync5(configPath)) {
+    return [];
+  }
+  try {
+    const parsed = JSON.parse(readFileSync3(configPath, "utf8"));
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+      return [];
+    }
+    return loadOpenApiActionKeysForSite(
+      siteDirectory,
+      parsed
+    );
+  } catch {
+    return [];
+  }
+}
+function withDefaultIncludedActionKeys(plan, actionKeys) {
+  if (plan.includedActionKeys && plan.includedActionKeys.length > 0) {
+    return plan;
+  }
+  if (actionKeys.length === 0) {
+    return plan;
+  }
+  return { ...plan, includedActionKeys: actionKeys };
+}
+
 // src/cli/scaffold/dev-portal-config-pages.ts
 import { access as access4, readFile as readFile10, rename as rename2, rm as rm3, writeFile as writeFile9 } from "node:fs/promises";
-import path42 from "node:path";
+import path43 from "node:path";
 async function writeConfigAtomically(filePath, content) {
   const temporaryPath = `${filePath}.${process.pid}.${Date.now()}.tmp`;
   try {
@@ -13335,7 +13504,7 @@ async function writeConfigAtomically(filePath, content) {
 }
 async function resolveApitogoConfigPath(sourceDirectory) {
   for (const filename of ["apitogo.config.tsx", "apitogo.config.jsx"]) {
-    const configPath = path42.join(sourceDirectory, filename);
+    const configPath = path43.join(sourceDirectory, filename);
     try {
       await access4(configPath);
       return configPath;
@@ -13391,7 +13560,7 @@ function inlineMarkdownToJsx(text) {
       const link = /^\[([^\]]+)\]\(([^)]+)\)$/.exec(token);
       if (link) {
         parts.push(
-          `<a href={${JSON.stringify(link[2])}} className="text-primary underline">${jsxTextExpr(link[1])}</a>`
+          `<a href={${JSON.stringify(link[2])}} className="text-primary underline">${jsxTextExpr(link[1] ?? "")}</a>`
         );
       } else {
         parts.push(jsxTextExpr(token));
@@ -13476,9 +13645,9 @@ ${indent}</Callout>`
     }
     const tipQuote = /^>\s*\*\*(Tip|Note|Info|Caution|Danger):\*\*\s*(.*)$/i.exec(line.trim());
     if (tipQuote) {
-      const rawType = tipQuote[1].toLowerCase();
+      const rawType = (tipQuote[1] ?? "").toLowerCase();
       const type = CALLOUT_TYPES.has(rawType) ? rawType : "tip";
-      const rest = tipQuote[2].trim();
+      const rest = (tipQuote[2] ?? "").trim();
       i += 1;
       const more = rest ? [rest] : [];
       while (i < lines.length && /^>\s*/.test(lines[i] ?? "")) {
@@ -13514,10 +13683,10 @@ ${indent}</pre>`
     }
     const heading = /^(#{1,3})\s+(.+)$/.exec(line);
     if (heading) {
-      const level = heading[1].length;
+      const level = (heading[1] ?? "").length;
       const className = level === 1 ? "text-foreground" : level === 2 ? "text-foreground" : "text-foreground";
       blocks.push(
-        `${indent}<Heading level={${level}} className="${className}">${inlineMarkdownToJsx(heading[2].trim())}</Heading>`
+        `${indent}<Heading level={${level}} className="${className}">${inlineMarkdownToJsx((heading[2] ?? "").trim())}</Heading>`
       );
       i += 1;
       continue;
@@ -13619,7 +13788,7 @@ function splitMarkdownByH2(content) {
       if (current) {
         sections.push(current);
       }
-      current = { title: h2[1].trim(), body: "" };
+      current = { title: (h2[1] ?? "").trim(), body: "" };
       continue;
     }
     if (current) {
@@ -13901,7 +14070,10 @@ function appendEntryToArrayRange(content, range, entry) {
   const after = content.slice(range.close);
   const trimmedBefore = before.trimEnd();
   const needsComma = !trimmedBefore.endsWith("[") && !trimmedBefore.endsWith(",");
-  const closeIndent = range.indent.slice(0, Math.max(0, range.indent.length - 2));
+  const closeIndent = range.indent.slice(
+    0,
+    Math.max(0, range.indent.length - 2)
+  );
   return `${trimmedBefore}${needsComma ? "," : ""}
 ${entry}
 ${closeIndent}${after}`;
@@ -13909,7 +14081,10 @@ ${closeIndent}${after}`;
 function prependEntryToArrayRange(content, range, entry) {
   const inner = content.slice(range.open + 1, range.close);
   const trimmedInner = inner.trim();
-  const closeIndent = range.indent.slice(0, Math.max(0, range.indent.length - 2));
+  const closeIndent = range.indent.slice(
+    0,
+    Math.max(0, range.indent.length - 2)
+  );
   const normalizedEntry = entry.trimEnd().endsWith(",") ? entry.trimEnd() : `${entry.trimEnd()},`;
   if (!trimmedInner) {
     return `${content.slice(0, range.open + 1)}
@@ -14027,7 +14202,11 @@ function appendCustomPageToNavigation(content, slug, label, _options) {
   if (content.includes(`path: ${pagePath}`)) {
     return content;
   }
-  const rewrittenBuildExport = appendCustomPageToDirectBuildExport(content, slug, label);
+  const rewrittenBuildExport = appendCustomPageToDirectBuildExport(
+    content,
+    slug,
+    label
+  );
   if (rewrittenBuildExport) {
     return rewrittenBuildExport;
   }
@@ -14035,12 +14214,24 @@ function appendCustomPageToNavigation(content, slug, label, _options) {
   if (!range) {
     return content;
   }
-  const docsItems = findDocumentationCategoryItemsRange(content, range.open, range.close);
+  const docsItems = findDocumentationCategoryItemsRange(
+    content,
+    range.open,
+    range.close
+  );
   if (docsItems) {
-    const entry = formatCustomPageNavigationEntry(slug, label, docsItems.indent);
+    const entry = formatCustomPageNavigationEntry(
+      slug,
+      label,
+      docsItems.indent
+    );
     return appendEntryToArrayRange(content, docsItems, entry);
   }
-  const category = formatDocumentationCategoryWithPage(slug, label, `${range.indent}  `);
+  const category = formatDocumentationCategoryWithPage(
+    slug,
+    label,
+    `${range.indent}  `
+  );
   return prependEntryToArrayRange(
     content,
     { open: range.open, close: range.close, indent: `${range.indent}  ` },
@@ -14048,7 +14239,12 @@ function appendCustomPageToNavigation(content, slug, label, _options) {
   );
 }
 function patchApitogoConfigForNewPage(content, slug, label, options) {
-  const withNavigation = appendCustomPageToNavigation(content, slug, label, options);
+  const withNavigation = appendCustomPageToNavigation(
+    content,
+    slug,
+    label,
+    options
+  );
   if (withNavigation === content) {
     return content;
   }
@@ -14072,17 +14268,17 @@ async function wireNewDevPortalPageInConfig(sourceDirectory, slug, label) {
 
 // src/cli/scaffold/wire-openapi.ts
 import { access as access6, readFile as readFile12, writeFile as writeFile11 } from "node:fs/promises";
-import path47 from "node:path";
+import path48 from "node:path";
 
 // src/cli/platform/helpers/openapi.ts
 import { promises as fs6 } from "node:fs";
-import path44 from "node:path";
+import path45 from "node:path";
 import SwaggerParser from "@apidevtools/swagger-parser";
-import YAML from "yaml";
+import YAML2 from "yaml";
 
 // src/cli/scaffold/discover-openapi-files.ts
 import { promises as fs5 } from "node:fs";
-import path43 from "node:path";
+import path44 from "node:path";
 var OPENAPI_BASENAMES = [
   "openapi.yaml",
   "openapi.yml",
@@ -14104,13 +14300,13 @@ var SKIP_OPENAPI_SEARCH_DIRS = /* @__PURE__ */ new Set([
   ".apitogo"
 ]);
 async function collectFromDir(dir, searchedDirectories, candidates) {
-  const resolved = path43.resolve(dir);
+  const resolved = path44.resolve(dir);
   if (searchedDirectories.includes(resolved)) {
     return;
   }
   searchedDirectories.push(resolved);
   for (const name of OPENAPI_BASENAMES) {
-    const candidate = path43.join(resolved, name);
+    const candidate = path44.join(resolved, name);
     try {
       await fs5.access(candidate);
       candidates.push(candidate);
@@ -14125,8 +14321,8 @@ async function collectSiteOpenApiFiles(siteDirectory) {
   return { candidates: [...new Set(candidates)], searchedDirectories };
 }
 async function collectNearbyOpenApiFiles(siteDirectory) {
-  const site = path43.resolve(siteDirectory);
-  const parent = path43.dirname(site);
+  const site = path44.resolve(siteDirectory);
+  const parent = path44.dirname(site);
   const searchedDirectories = [];
   const candidates = [];
   if (parent && parent !== site) {
@@ -14137,8 +14333,8 @@ async function collectNearbyOpenApiFiles(siteDirectory) {
         if (!entry.isDirectory() || SKIP_OPENAPI_SEARCH_DIRS.has(entry.name)) {
           continue;
         }
-        const sibling = path43.join(parent, entry.name);
-        if (path43.resolve(sibling) === site) {
+        const sibling = path44.join(parent, entry.name);
+        if (path44.resolve(sibling) === site) {
           continue;
         }
         await collectFromDir(sibling, searchedDirectories, candidates);
@@ -14166,7 +14362,7 @@ function parseOpenApiObject(doc) {
   };
 }
 function liteParseOpenApi(content, filePath) {
-  const ext = path43.extname(filePath).toLowerCase();
+  const ext = path44.extname(filePath).toLowerCase();
   if (ext === ".json") {
     try {
       const parsed = JSON.parse(content);
@@ -14231,12 +14427,12 @@ async function discoverNearbyOpenApi(siteDirectory) {
   };
 }
 async function validateOpenApiFile(filePath) {
-  const resolved = path44.resolve(filePath);
+  const resolved = path45.resolve(filePath);
   const content = await fs6.readFile(resolved, "utf8");
-  const ext = path44.extname(resolved).toLowerCase();
+  const ext = path45.extname(resolved).toLowerCase();
   let parsed;
   try {
-    parsed = ext === ".json" ? JSON.parse(content) : YAML.parse(content);
+    parsed = ext === ".json" ? JSON.parse(content) : YAML2.parse(content);
   } catch (err) {
     return {
       valid: false,
@@ -14276,12 +14472,7 @@ async function validateOpenApiFile(filePath) {
 
 // src/cli/scaffold/scaffold-dev-portal-site.ts
 import { mkdir as mkdir8, readFile as readFile11, writeFile as writeFile10 } from "node:fs/promises";
-import path46 from "node:path";
-
-// src/cli/scaffold/create-apitogo-cli.ts
-import { spawn as spawn2 } from "node:child_process";
-import { access as access5, rm as rm4 } from "node:fs/promises";
-import path45 from "node:path";
+import path47 from "node:path";
 
 // src/cli/scaffold/apitogo-npm-packages.ts
 var DEFAULT_CREATE_APITOGO_PACKAGE2 = "@lukoweb/create-apitogo@latest";
@@ -14367,6 +14558,9 @@ var DOC_TOOL_LOCAL_PACKAGE_PATHS = {
 };
 
 // src/cli/scaffold/create-apitogo-cli.ts
+import { spawn as spawn2 } from "node:child_process";
+import { access as access5, rm as rm4 } from "node:fs/promises";
+import path46 from "node:path";
 var CreateApitogoCliError = class extends Error {
   exitCode;
   log;
@@ -14382,9 +14576,9 @@ function resolveDocToolPath(explicit) {
   return value || void 0;
 }
 function splitOutputDirectory(outputDirectory) {
-  const resolvedOutputDirectory = path45.resolve(outputDirectory);
-  const projectName = path45.basename(resolvedOutputDirectory);
-  const parentDirectory = path45.dirname(resolvedOutputDirectory);
+  const resolvedOutputDirectory = path46.resolve(outputDirectory);
+  const projectName = path46.basename(resolvedOutputDirectory);
+  const parentDirectory = path46.dirname(resolvedOutputDirectory);
   if (!projectName || projectName === "." || projectName === "..") {
     throw new Error(
       "outputDirectory must be a named folder (e.g. ./dev-portal-site), not the current directory."
@@ -14410,7 +14604,7 @@ async function directoryHasEntries(dir) {
   }
 }
 function resolveLocalCreateApitogoEntry(docToolPath) {
-  return path45.resolve(docToolPath, "packages/create-zudoku/dist/index.js");
+  return path46.resolve(docToolPath, "packages/create-zudoku/dist/index.js");
 }
 async function resolveCreateApitogoInvocation(options) {
   const docToolPath = resolveDocToolPath(options.docToolPath);
@@ -14492,7 +14686,7 @@ async function runCreateApitogoDevPortal(options) {
       result.exitCode
     );
   }
-  if (!await pathExists3(path45.join(resolvedOutputDirectory, "package.json"))) {
+  if (!await pathExists3(path46.join(resolvedOutputDirectory, "package.json"))) {
     throw new CreateApitogoCliError(
       `create-apitogo completed but package.json was not found at ${resolvedOutputDirectory}`,
       result.output,
@@ -14541,14 +14735,17 @@ function ensureRequiredApitogoModules(pkg, options) {
   const moduleAliasVersion = resolveApitogoModuleVersionFromCore(coreVersion);
   for (const [moduleName, localPath] of [
     [landing, DOC_TOOL_LOCAL_PACKAGE_PATHS["@lukoweb/apitogo-module-landing"]],
-    [userPanel, DOC_TOOL_LOCAL_PACKAGE_PATHS["@lukoweb/apitogo-module-user-panel"]],
+    [
+      userPanel,
+      DOC_TOOL_LOCAL_PACKAGE_PATHS["@lukoweb/apitogo-module-user-panel"]
+    ],
     [
       billing,
       DOC_TOOL_LOCAL_PACKAGE_PATHS["@lukoweb/apitogo-plugin-dev-portal-billing"]
     ]
   ]) {
     if (options.docToolPath) {
-      deps[moduleName] = `file:${path46.join(options.docToolPath, localPath)}`;
+      deps[moduleName] = `file:${path47.join(options.docToolPath, localPath)}`;
       continue;
     }
     deps[moduleName] = `npm:${moduleName}@${moduleAliasVersion}`;
@@ -14575,9 +14772,11 @@ function rewritePackageJson(raw, options) {
     for (const section of ["dependencies", "devDependencies"]) {
       const deps = pkg[section];
       if (!deps) continue;
-      for (const [dep, relativePath] of Object.entries(DOC_TOOL_LOCAL_PACKAGE_PATHS)) {
+      for (const [dep, relativePath] of Object.entries(
+        DOC_TOOL_LOCAL_PACKAGE_PATHS
+      )) {
         if (dep in deps) {
-          deps[dep] = `file:${path46.join(options.docToolPath, relativePath)}`;
+          deps[dep] = `file:${path47.join(options.docToolPath, relativePath)}`;
           linkedWorkspacePackage = true;
         }
       }
@@ -14634,7 +14833,10 @@ function patchApisConfig(content, config2) {
     return insertApisConfig(content, config2);
   }
   const asArray = match[0].includes("apis: [");
-  return content.replace(APIS_CONFIG_PATTERN, renderApisConfig(config2, asArray));
+  return content.replace(
+    APIS_CONFIG_PATTERN,
+    renderApisConfig(config2, asArray)
+  );
 }
 function patchApitogoConfigOpenApiToFile(content, input5 = "./openapi.json") {
   return patchApisConfig(content, {
@@ -14674,23 +14876,23 @@ function patchDashboardPageConfig(content) {
   );
 }
 async function ensureAccountPlansPage(outputDirectory) {
-  const pagePath = path46.join(outputDirectory, ACCOUNT_PLANS_PAGE_PATH);
+  const pagePath = path47.join(outputDirectory, ACCOUNT_PLANS_PAGE_PATH);
   try {
     await readFile11(pagePath, "utf8");
     return void 0;
   } catch {
-    await mkdir8(path46.dirname(pagePath), { recursive: true });
+    await mkdir8(path47.dirname(pagePath), { recursive: true });
     await writeFile10(pagePath, ACCOUNT_PLANS_PAGE);
     return ACCOUNT_PLANS_PAGE_PATH;
   }
 }
 async function ensureDashboardPage(outputDirectory) {
-  const pagePath = path46.join(outputDirectory, DASHBOARD_PAGE_PATH);
+  const pagePath = path47.join(outputDirectory, DASHBOARD_PAGE_PATH);
   try {
     await readFile11(pagePath, "utf8");
     return void 0;
   } catch {
-    await mkdir8(path46.dirname(pagePath), { recursive: true });
+    await mkdir8(path47.dirname(pagePath), { recursive: true });
     await writeFile10(pagePath, DASHBOARD_PAGE);
     return DASHBOARD_PAGE_PATH;
   }
@@ -14716,13 +14918,20 @@ function patchApitogoConfig(content, options) {
     });
   }
   if (options.logoUrl) {
-    if (/logo:\s*\{/.test(patched)) {
-      patched = patched.replace(/logo:\s*\{[\s\S]*?\},/m, `logo: {
+    const logoBlockRegex = /logo:\s*\{[\s\S]*?\},/m;
+    const existingBlock = patched.match(logoBlockRegex)?.[0];
+    if (existingBlock) {
+      const darkMatch = existingBlock.match(/dark:\s*"([^"]*)"/);
+      const darkLine = darkMatch ? `
+        dark: "${darkMatch[1]}",` : "";
+      patched = patched.replace(
+        logoBlockRegex,
+        `logo: {
       src: {
-        light: "${options.logoUrl}",
-        dark: "${options.logoUrl}",
+        light: "${options.logoUrl}",${darkLine}
       },
-    },`);
+    },`
+      );
     } else {
       patched = patched.replace(
         /site:\s*\{/,
@@ -14730,7 +14939,6 @@ function patchApitogoConfig(content, options) {
     logo: {
       src: {
         light: "${options.logoUrl}",
-        dark: "${options.logoUrl}",
       },
     },`
       );
@@ -14741,7 +14949,7 @@ function patchApitogoConfig(content, options) {
 async function patchScaffoldedSite(outputDirectory, options) {
   const title = options.branding?.title ?? options.siteName;
   const filesWritten = [];
-  const packageJsonPath = path46.join(outputDirectory, "package.json");
+  const packageJsonPath = path47.join(outputDirectory, "package.json");
   if (options.patchPackageJson !== false) {
     const packageJson3 = await readFile11(packageJsonPath, "utf8");
     await writeFile10(
@@ -14754,7 +14962,7 @@ async function patchScaffoldedSite(outputDirectory, options) {
     );
     filesWritten.push("package.json");
   }
-  const configPath = path46.join(outputDirectory, "apitogo.config.tsx");
+  const configPath = path47.join(outputDirectory, "apitogo.config.tsx");
   const configContent = await readFile11(configPath, "utf8");
   await writeFile10(
     configPath,
@@ -14849,8 +15057,8 @@ async function discoverOpenApiByMode(siteDirectory, mode) {
   return discoverNearbyOpenApi(siteDirectory);
 }
 async function wireDevPortalOpenApi(sourceDirectory, openApiPath) {
-  const resolvedSource = path47.resolve(sourceDirectory);
-  const resolvedOpenApi = path47.resolve(openApiPath);
+  const resolvedSource = path48.resolve(sourceDirectory);
+  const resolvedOpenApi = path48.resolve(openApiPath);
   const input5 = toSiteRelativeOpenApiInput(resolvedSource, resolvedOpenApi);
   const validation = await validateOpenApiFile(resolvedOpenApi);
   if (!validation.valid) {
@@ -14875,7 +15083,7 @@ async function wireDevPortalOpenApi(sourceDirectory, openApiPath) {
       "utf8"
     );
   } else {
-    const tsxConfigPath = path47.join(resolvedSource, "apitogo.config.tsx");
+    const tsxConfigPath = path48.join(resolvedSource, "apitogo.config.tsx");
     const configContent = await readFile12(tsxConfigPath, "utf8");
     try {
       const patched = patchApitogoConfigOpenApiToFile(configContent, input5);
@@ -14961,12 +15169,12 @@ async function discoverAndWireOpenApi(siteDirectory, mode) {
 }
 
 // src/cli/make-config/interactive.ts
-import { createInterface } from "node:readline/promises";
+import path50 from "node:path";
 import { stdin as input, stdout as output } from "node:process";
-import path49 from "node:path";
+import { createInterface } from "node:readline/promises";
 
 // src/cli/make-config/json-config.ts
-import path48 from "node:path";
+import path49 from "node:path";
 
 // src/cli/make-config/branding-assets.ts
 var LOGO_LIGHT = '<svg xmlns="http://www.w3.org/2000/svg" width="201.57" height="72.66" viewBox="-0.09 -46.99 201.57 72.66">\n  <path d="M13.5 0.39Q8.03 0.39 4.76 -2.09Q1.48 -4.57 1.41 -9.61H8.03Q8.14 -7.48 9.6 -6.41Q11.05 -5.33 13.42 -5.33Q15.57 -5.33 16.8 -6.2Q18.03 -7.07 18.03 -8.46Q18.03 -9.71 16.87 -10.44Q15.7 -11.17 13.32 -11.72L10.23 -12.44Q6.46 -13.3 4.32 -15.25Q2.17 -17.21 2.17 -20.49Q2.17 -23.18 3.62 -25.21Q5.08 -27.23 7.64 -28.36Q10.2 -29.49 13.5 -29.49Q16.88 -29.49 19.36 -28.35Q21.84 -27.21 23.2 -25.17Q24.57 -23.12 24.61 -20.43H17.99Q17.85 -22.01 16.7 -22.89Q15.55 -23.77 13.48 -23.77Q11.41 -23.77 10.35 -22.97Q9.3 -22.17 9.3 -20.96Q9.3 -19.61 10.47 -18.88Q11.64 -18.14 13.59 -17.71L16.11 -17.13Q20.33 -16.19 22.67 -14.06Q25 -11.93 25 -8.44Q25 -4.3 21.95 -1.95Q18.91 0.39 13.5 0.39Z M32.97 0.39Q29.82 0.39 27.8 -1.21Q25.78 -2.81 25.78 -6.05Q25.78 -8.48 26.89 -9.9Q28 -11.33 29.85 -12.01Q31.7 -12.7 33.9 -12.89Q36.68 -13.12 37.88 -13.47Q39.08 -13.81 39.08 -14.82V-14.9Q39.08 -16.04 38.29 -16.65Q37.5 -17.27 36.11 -17.27Q34.68 -17.27 33.77 -16.66Q32.85 -16.05 32.58 -15.02L26.4 -15.82Q27.05 -18.61 29.56 -20.36Q32.07 -22.11 36.17 -22.11Q38.88 -22.11 41.08 -21.27Q43.28 -20.43 44.58 -18.8Q45.88 -17.17 45.88 -14.82V0H39.47V-3.07H39.29Q37.48 0.39 32.97 0.39ZM35.04 -4.12Q36.75 -4.12 37.95 -5.14Q39.14 -6.15 39.14 -7.77V-9.86Q38.55 -9.55 37.44 -9.34Q36.33 -9.12 35.37 -8.96Q32.22 -8.5 32.22 -6.37Q32.22 -5.27 33.01 -4.7Q33.81 -4.12 35.04 -4.12Z M48.59 0V-21.84H54.86L55.17 -17.5Q56.07 -19.96 57.78 -21.04Q59.49 -22.13 61.46 -22.13Q63.53 -22.13 64.91 -20.94Q66.28 -19.75 67.08 -17.07Q68.08 -19.77 70.02 -20.95Q71.97 -22.13 74.17 -22.13Q77.24 -22.13 79.2 -20.16Q81.17 -18.18 81.17 -14.73V0H74.37V-13.18Q74.37 -14.84 73.5 -15.7Q72.63 -16.56 71.28 -16.56Q69.84 -16.56 69 -15.62Q68.16 -14.67 68.16 -13.11V0H61.61V-13.28Q61.61 -14.79 60.77 -15.67Q59.92 -16.56 58.57 -16.56Q57.18 -16.56 56.29 -15.62Q55.4 -14.69 55.4 -12.97V0Z M83.88 8.16V-21.84H90.62V-18.09H90.85Q91.26 -19.06 92.04 -19.99Q92.82 -20.92 94.05 -21.51Q95.28 -22.11 97.02 -22.11Q99.33 -22.11 101.31 -20.9Q103.29 -19.69 104.51 -17.21Q105.73 -14.73 105.73 -10.9Q105.73 -7.19 104.55 -4.7Q103.37 -2.21 101.39 -0.95Q99.4 0.31 96.98 0.31Q94.48 0.31 92.99 -0.87Q91.49 -2.05 90.85 -3.54H90.69V8.16ZM94.66 -5Q96.63 -5 97.68 -6.62Q98.72 -8.24 98.72 -10.9Q98.72 -13.55 97.68 -15.17Q96.63 -16.78 94.66 -16.78Q92.71 -16.78 91.62 -15.2Q90.54 -13.61 90.54 -10.9Q90.54 -8.22 91.62 -6.61Q92.71 -5 94.66 -5Z M114.4 -29.1V0H107.59V-29.1Z M127.29 0.41Q122.15 0.41 119.21 -2.59Q116.27 -5.59 116.27 -10.84Q116.27 -14.2 117.59 -16.74Q118.91 -19.28 121.33 -20.69Q123.75 -22.11 127.04 -22.11Q130.1 -22.11 132.47 -20.83Q134.85 -19.55 136.21 -17.06Q137.56 -14.57 137.56 -10.98V-9.26H122.97Q123.07 -6.89 124.27 -5.71Q125.47 -4.53 127.41 -4.53Q128.77 -4.53 129.77 -5.11Q130.77 -5.68 131.18 -6.78L137.25 -5.78Q136.43 -2.95 133.84 -1.27Q131.25 0.41 127.29 0.41ZM123.01 -13.22H131.1Q130.9 -15.08 129.89 -16.12Q128.87 -17.17 127.09 -17.17Q125.3 -17.17 124.25 -16.1Q123.21 -15.04 123.01 -13.22Z" fill="#202633"/>\n  <path d="M138.48 0 148.19 -29.1H157.43L167.43 0H159.69L157.72 -6.19H148.03L146.14 0ZM149.65 -11.46H156.04L155.65 -12.71Q154.89 -15.21 154.16 -17.95Q153.44 -20.68 152.74 -23.61Q152.07 -20.66 151.42 -17.93Q150.77 -15.2 150.04 -12.71Z M168.81 0V-29.1H180.72Q184 -29.1 186.39 -27.83Q188.77 -26.56 190.05 -24.3Q191.33 -22.03 191.33 -19.04Q191.33 -16.04 190.02 -13.8Q188.71 -11.56 186.29 -10.32Q183.87 -9.08 180.53 -9.08H175.7V0ZM175.7 -14.53H179.28Q181.7 -14.53 182.94 -15.77Q184.18 -17.01 184.18 -19.04Q184.18 -21.09 182.93 -22.3Q181.68 -23.52 179.26 -23.52H175.7Z M199.98 -29.1V0H193.08V-29.1Z" fill="#008A7D"/>\n</svg>\n';
@@ -15345,9 +15553,9 @@ function openapiInputForConfig(specRelativePosix) {
   return `./${specRelativePosix}`;
 }
 function toRelativeOpenApiInput(projectDir, inputPath) {
-  const resolved = path48.isAbsolute(inputPath) ? inputPath : path48.resolve(projectDir, inputPath);
-  const relative = path48.relative(projectDir, resolved);
-  const posix = relative.split(path48.sep).join(path48.posix.sep);
+  const resolved = path49.isAbsolute(inputPath) ? inputPath : path49.resolve(projectDir, inputPath);
+  const relative = path49.relative(projectDir, resolved);
+  const posix = relative.split(path49.sep).join(path49.posix.sep);
   if (!posix) {
     throw new Error("OpenAPI path must point to a file.");
   }
@@ -15550,11 +15758,11 @@ ${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`
+    `Page created: ${relativePath} (route ${routePath})`
   );
+  printDiagnosticsToConsole("Edit that file to change the content.");
+  printDiagnosticsToConsole(`Predefined components: ${DOCS}/docs/components`);
 }
 function printPlanAddedHint(displayName) {
   printDiagnosticsToConsole(
@@ -15584,9 +15792,13 @@ function printInteractiveWrapUp(hasPaidPlans) {
   printDiagnosticsToConsole("");
   printDiagnosticsToConsole("Configure more:");
   printDiagnosticsToConsole(`- Overview: ${DOCS}/docs/configuration/overview`);
-  printDiagnosticsToConsole(`- Gateway plans: ${DOCS}/docs/configuration/plans`);
+  printDiagnosticsToConsole(
+    `- Gateway plans: ${DOCS}/docs/configuration/plans`
+  );
   printDiagnosticsToConsole(`- Custom pages: ${DOCS}/docs/guides/custom-pages`);
-  printDiagnosticsToConsole(`- API reference: ${DOCS}/docs/configuration/api-reference`);
+  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`);
@@ -15672,9 +15884,7 @@ async function promptMakeConfigInteractive(options) {
           );
           runtimeVersion = parseRuntimeVersion(runtime, versionRaw);
           if (!runtimeVersion) {
-            printDiagnosticsToConsole(
-              `Choose one of: ${versions.join(", ")}.`
-            );
+            printDiagnosticsToConsole(`Choose one of: ${versions.join(", ")}.`);
           }
         }
         const backend = {
@@ -15720,7 +15930,7 @@ async function promptMakeConfigInteractive(options) {
           continue;
         }
         const routePath = `/${slug}`;
-        const relativePath = path49.posix.join(options.pagesDir, `${slug}.tsx`);
+        const relativePath = path50.posix.join(options.pagesDir, `${slug}.tsx`);
         const page = {
           slug,
           title: pageTitle.trim(),
@@ -15813,7 +16023,7 @@ export default function ${componentName}() {
 init_package_json();
 import { constants } from "node:fs";
 import { access as access7, mkdir as mkdir9, readFile as readFile13, writeFile as writeFile12 } from "node:fs/promises";
-import path50 from "node:path";
+import path51 from "node:path";
 import { glob as glob4 } from "glob";
 
 // src/cli/make-config/favicon-png.ts
@@ -15828,9 +16038,9 @@ var OPENAPI_GLOBS = [
   "openapi.yaml",
   "openapi.yml"
 ];
-var toPosix = (p) => p.split(path50.sep).join("/");
+var toPosix = (p) => p.split(path51.sep).join("/");
 var sanitizePackageName = (dir) => {
-  const base = path50.basename(path50.resolve(dir));
+  const base = path51.basename(path51.resolve(dir));
   const s = base.toLowerCase().replace(/[^a-z0-9-_.]/g, "-").replace(/^-+|-+$/g, "");
   return s || "apitogo-site";
 };
@@ -15840,7 +16050,7 @@ var apitogoVersionRange = () => {
 };
 async function findOpenApiSpecPath(dir) {
   for (const rel of OPENAPI_GLOBS) {
-    const full = path50.join(dir, rel);
+    const full = path51.join(dir, rel);
     try {
       await access7(full, constants.R_OK);
       return toPosix(rel);
@@ -15855,7 +16065,7 @@ async function findOpenApiSpecPath(dir) {
   return extra[0] ? toPosix(extra[0]) : null;
 }
 async function ensurePackageJson(dir) {
-  const pkgPath = path50.join(dir, "package.json");
+  const pkgPath = path51.join(dir, "package.json");
   const apitogoVer = apitogoVersionRange();
   const baseDeps = {
     react: ">=19.0.0",
@@ -15922,7 +16132,7 @@ async function ensurePackageJson(dir) {
   return false;
 }
 async function ensureTsconfigJson(dir) {
-  const tsPath = path50.join(dir, "tsconfig.json");
+  const tsPath = path51.join(dir, "tsconfig.json");
   try {
     await access7(tsPath, constants.R_OK);
     return false;
@@ -15971,40 +16181,40 @@ var fileExists2 = async (filePath) => {
   }
 };
 async function ensurePortalStubFiles(dir) {
-  const landingPath = path50.join(dir, "landing", "LandingPage.tsx");
+  const landingPath = path51.join(dir, "landing", "LandingPage.tsx");
   if (!await fileExists2(landingPath)) {
-    await mkdir9(path50.join(dir, "landing"), { recursive: true });
+    await mkdir9(path51.join(dir, "landing"), { recursive: true });
     await writeFile12(landingPath, LANDING_PAGE_SOURCE, "utf8");
   }
-  const plansPath = path50.join(dir, "user-panel", "AccountPlansPage.tsx");
+  const plansPath = path51.join(dir, "user-panel", "AccountPlansPage.tsx");
   if (!await fileExists2(plansPath)) {
-    await mkdir9(path50.join(dir, "user-panel"), { recursive: true });
+    await mkdir9(path51.join(dir, "user-panel"), { recursive: true });
     await writeFile12(plansPath, ACCOUNT_PLANS_PAGE_SOURCE, "utf8");
   }
-  const dashboardPath = path50.join(dir, "user-panel", "DashboardPage.tsx");
+  const dashboardPath = path51.join(dir, "user-panel", "DashboardPage.tsx");
   if (!await fileExists2(dashboardPath)) {
-    await mkdir9(path50.join(dir, "user-panel"), { recursive: true });
+    await mkdir9(path51.join(dir, "user-panel"), { recursive: true });
     await writeFile12(dashboardPath, DASHBOARD_PAGE_SOURCE, "utf8");
   }
   await ensurePublicBrandingFiles(dir);
 }
 async function ensurePublicBrandingFiles(dir) {
-  const destDir = path50.join(dir, "public");
+  const destDir = path51.join(dir, "public");
   await mkdir9(destDir, { recursive: true });
   for (const { name, content } of BRANDING_ASSETS) {
-    const dest = path50.join(destDir, name);
+    const dest = path51.join(destDir, name);
     if (await fileExists2(dest)) {
       continue;
     }
     await writeFile12(dest, content, "utf8");
   }
-  const faviconDest = path50.join(destDir, "Icon.png");
+  const faviconDest = path51.join(destDir, "Icon.png");
   if (!await fileExists2(faviconDest)) {
     await writeFile12(faviconDest, Buffer.from(FAVICON_PNG_BASE64, "base64"));
   }
 }
 async function ensureThinConfigTsx(dir) {
-  const tsxPath = path50.join(dir, "apitogo.config.tsx");
+  const tsxPath = path51.join(dir, "apitogo.config.tsx");
   if (await fileExists2(tsxPath)) {
     return false;
   }
@@ -16012,137 +16222,6 @@ async function ensureThinConfigTsx(dir) {
   return true;
 }
 
-// src/cli/platform/helpers/openapi-action-keys.ts
-import { existsSync as existsSync5, readFileSync as readFileSync3 } from "node:fs";
-import path51 from "node:path";
-import YAML2 from "yaml";
-var HTTP_METHODS = [
-  "get",
-  "post",
-  "put",
-  "patch",
-  "delete",
-  "head",
-  "options"
-];
-function normalizeOpenApiPathTemplate(pathTemplate) {
-  if (!pathTemplate.trim()) {
-    return "/";
-  }
-  let value = pathTemplate.trim();
-  if (!value.startsWith("/")) {
-    value = `/${value}`;
-  }
-  if (value.length > 1 && value.endsWith("/")) {
-    value = value.replace(/\/+$/, "");
-  }
-  return value;
-}
-function resolveRelativeServerBasePath(document) {
-  const serverUrl = document.servers?.[0]?.url;
-  if (!serverUrl || serverUrl === "/") {
-    return null;
-  }
-  return serverUrl.startsWith("/") ? serverUrl.replace(/\/+$/, "") : null;
-}
-function combineBasePath(basePath, pathKey) {
-  const normalizedPath = normalizeOpenApiPathTemplate(pathKey);
-  if (!basePath || basePath === "/") {
-    return normalizedPath;
-  }
-  const baseNorm = normalizeOpenApiPathTemplate(basePath);
-  if (normalizedPath === "/") {
-    return baseNorm;
-  }
-  return `${baseNorm.replace(/\/+$/, "")}${normalizedPath}`;
-}
-function extractGatewayActionKeysFromOpenApiDocument(document) {
-  if (!document || typeof document !== "object") {
-    return [];
-  }
-  const spec = document;
-  if (!spec.paths || typeof spec.paths !== "object") {
-    return [];
-  }
-  const basePath = resolveRelativeServerBasePath(spec);
-  const keys = /* @__PURE__ */ new Set();
-  for (const [pathKey, pathItem] of Object.entries(spec.paths)) {
-    if (!pathItem || typeof pathItem !== "object") {
-      continue;
-    }
-    const pathTemplate = combineBasePath(basePath, pathKey);
-    for (const method of HTTP_METHODS) {
-      if (!pathItem[method] || typeof pathItem[method] !== "object") {
-        continue;
-      }
-      keys.add(`${method}:${pathTemplate}`);
-    }
-  }
-  return [...keys].sort((a, b) => a.localeCompare(b));
-}
-function extractGatewayActionKeysFromOpenApiFile(filePath) {
-  try {
-    const raw = readFileSync3(filePath, "utf8");
-    const ext = path51.extname(filePath).toLowerCase();
-    const parsed = ext === ".json" ? JSON.parse(raw) : YAML2.parse(raw);
-    return extractGatewayActionKeysFromOpenApiDocument(parsed);
-  } catch {
-    return [];
-  }
-}
-function resolveConfigOpenApiFilePath(siteDirectory, config2) {
-  const backend = config2.backend;
-  const candidates = [];
-  if (typeof backend?.openApiPath === "string" && backend.openApiPath.trim()) {
-    candidates.push(backend.openApiPath.trim());
-  }
-  const apis = config2.apis;
-  const entries = Array.isArray(apis) ? apis : apis ? [apis] : [];
-  for (const entry of entries) {
-    if (entry && typeof entry === "object" && entry.type === "file" && typeof entry.input === "string") {
-      candidates.push(entry.input);
-    }
-  }
-  for (const candidate of candidates) {
-    const resolved = path51.isAbsolute(candidate) ? candidate : path51.resolve(siteDirectory, candidate);
-    if (existsSync5(resolved)) {
-      return resolved;
-    }
-  }
-  return void 0;
-}
-function loadOpenApiActionKeysForSite(siteDirectory, config2) {
-  const filePath = resolveConfigOpenApiFilePath(siteDirectory, config2);
-  if (!filePath) {
-    return [];
-  }
-  return extractGatewayActionKeysFromOpenApiFile(filePath);
-}
-function loadOpenApiActionKeysFromSiteDirectory(siteDirectory) {
-  const configPath = path51.join(siteDirectory, "apitogo.config.json");
-  if (!existsSync5(configPath)) {
-    return [];
-  }
-  try {
-    const parsed = JSON.parse(readFileSync3(configPath, "utf8"));
-    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-      return [];
-    }
-    return loadOpenApiActionKeysForSite(siteDirectory, parsed);
-  } catch {
-    return [];
-  }
-}
-function withDefaultIncludedActionKeys(plan, actionKeys) {
-  if (plan.includedActionKeys && plan.includedActionKeys.length > 0) {
-    return plan;
-  }
-  if (actionKeys.length === 0) {
-    return plan;
-  }
-  return { ...plan, includedActionKeys: actionKeys };
-}
-
 // src/cli/make-config/handler.ts
 var toPosixPath2 = (value) => value.split(path52.sep).join(path52.posix.sep);
 var fileExists3 = async (filePath) => {
@@ -16272,7 +16351,10 @@ async function makeConfig(argv) {
     const flagPatches = {
       site: parseJsonObjectFlag(argv.site, "site"),
       theme: parseJsonObjectFlag(argv.theme, "theme"),
-      authentication: parseJsonObjectFlag(argv.authentication, "authentication"),
+      authentication: parseJsonObjectFlag(
+        argv.authentication,
+        "authentication"
+      ),
       title: argv.title
     };
     const persistCtx = {
@@ -16747,7 +16829,9 @@ async function sha256File(filePath) {
 }
 async function hashDirectoryContents(rootDirectory) {
   const resolved = path54.resolve(rootDirectory);
-  const files = (await collectPackageableFiles(resolved)).sort((a, b) => a.localeCompare(b));
+  const files = (await collectPackageableFiles(resolved)).sort(
+    (a, b) => a.localeCompare(b)
+  );
   const hash2 = createHash2("sha256");
   for (const rel of files) {
     hash2.update(rel);
@@ -16820,7 +16904,9 @@ async function syncDevPortalPlanCatalog(options) {
         signal: controller.signal
       });
       if (!response.ok) {
-        throw new Error(`GET /api/v1/plans?refresh=true&force=true returned ${response.status}.`);
+        throw new Error(
+          `GET /api/v1/plans?refresh=true&force=true returned ${response.status}.`
+        );
       }
       const catalog = await response.json();
       if (options.expectedPlanCount !== void 0 && catalog.plans.length < options.expectedPlanCount) {
@@ -16954,7 +17040,10 @@ function arraysEquivalentForAuth(existing, desired) {
   if (isPlatformManagedAuthMode(desired.authMode)) {
     return true;
   }
-  return (existing.oidcMetadataUrl ?? "").trim() === (desired.oidcMetadataUrl ?? "").trim() && sameStringList(existing.oidcAllowedIssuers, desired.oidcAllowedIssuers ?? void 0) && sameStringList(existing.oidcAudiences, desired.oidcAudiences ?? void 0);
+  return (existing.oidcMetadataUrl ?? "").trim() === (desired.oidcMetadataUrl ?? "").trim() && sameStringList(
+    existing.oidcAllowedIssuers,
+    desired.oidcAllowedIssuers ?? void 0
+  ) && sameStringList(existing.oidcAudiences, desired.oidcAudiences ?? void 0);
 }
 async function ensureGatewayAuthConfigured(client, projectId, desired) {
   let existing = null;
@@ -17003,7 +17092,7 @@ function normalizeActionKey(actionKey) {
   if (trimmed.includes(":")) {
     const [method2, ...pathParts] = trimmed.split(":");
     const path73 = pathParts.join(":").trim();
-    return `${method2.toLowerCase()}:${path73.startsWith("/") ? path73 : `/${path73}`}`;
+    return `${method2?.toLowerCase()}:${path73.startsWith("/") ? path73 : `/${path73}`}`;
   }
   const spaceIndex = trimmed.indexOf(" ");
   if (spaceIndex <= 0) {
@@ -17024,12 +17113,16 @@ async function applyGatewayPublicRoutes(client, projectId, routes, options) {
   }
   let knownKeys = null;
   if (options?.knownActions) {
-    knownKeys = new Set(options.knownActions.map((action) => action.actionKey.toLowerCase()));
+    knownKeys = new Set(
+      options.knownActions.map((action) => action.actionKey.toLowerCase())
+    );
   } else {
     try {
       const listed = await listAllGatewayActions(client, projectId);
       if (listed.length > 0) {
-        knownKeys = new Set(listed.map((action) => action.actionKey.toLowerCase()));
+        knownKeys = new Set(
+          listed.map((action) => action.actionKey.toLowerCase())
+        );
       }
     } catch {
       knownKeys = null;
@@ -17054,7 +17147,11 @@ async function applyGatewayPublicRoutes(client, projectId, routes, options) {
       continue;
     }
     try {
-      const action = await client.setGatewayActionPublic(projectId, actionKey, true);
+      const action = await client.setGatewayActionPublic(
+        projectId,
+        actionKey,
+        true
+      );
       applied.push(action);
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
@@ -17170,7 +17267,11 @@ async function handleConfigureGatewayBaseline(client, config2, args) {
       oidcAudiences: args.oidcAudiences ?? null
     };
     try {
-      ensured = await ensureGatewayAuthConfigured(client, projectId, desiredAuth);
+      ensured = await ensureGatewayAuthConfigured(
+        client,
+        projectId,
+        desiredAuth
+      );
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
       if (/EntraGateway|not configured|Graph permissions/i.test(message)) {
@@ -17197,7 +17298,11 @@ async function handleConfigureGatewayBaseline(client, config2, args) {
         });
         auth = entraWait.auth;
       } else if (provisionStatus2 === "failed") {
-        ensured = await ensureGatewayAuthConfigured(client, projectId, desiredAuth);
+        ensured = await ensureGatewayAuthConfigured(
+          client,
+          projectId,
+          desiredAuth
+        );
         entraWait = await waitForGatewayEntraProvision(client, projectId, {
           timeoutMs: args.timeoutMs,
           pollIntervalMs: args.pollIntervalMs
@@ -17247,13 +17352,21 @@ async function handleConfigureGatewayBaseline(client, config2, args) {
   if (normalizeLimits(settings.limitsJson) === normalizeLimits(limitsJson)) {
     skippedSettings = true;
   } else {
-    settingsUpdated = await client.updateGatewaySettings(projectId, { limitsJson });
+    settingsUpdated = await client.updateGatewaySettings(projectId, {
+      limitsJson
+    });
   }
   const healthKey = args.publicHealthActionKey ?? "get:/health";
   const publicRoutes = [
-    ...new Set([...args.publicRoutes ?? [], healthKey].map((route) => route.trim()).filter(Boolean))
+    ...new Set(
+      [...args.publicRoutes ?? [], healthKey].map((route) => route.trim()).filter(Boolean)
+    )
   ];
-  const publicRoutesResult = await applyGatewayPublicRoutes(client, projectId, publicRoutes);
+  const publicRoutesResult = await applyGatewayPublicRoutes(
+    client,
+    projectId,
+    publicRoutes
+  );
   const healthAction = publicRoutesResult.applied.find(
     (action) => action.actionKey.toLowerCase() === normalizeActionKey(healthKey).toLowerCase()
   ) ?? null;
@@ -17291,7 +17404,9 @@ async function handleConfigureGatewayBaseline(client, config2, args) {
 // src/cli/platform/helpers/gateway-plan-sync.ts
 function resolveIncludedActionKeysForUpsert(manifestPlan, existingPlan) {
   if (manifestPlan.includedActionKeys !== void 0) {
-    return manifestPlan.includedActionKeys.map((key) => normalizeActionKey(key));
+    return manifestPlan.includedActionKeys.map(
+      (key) => normalizeActionKey(key)
+    );
   }
   if (existingPlan) {
     return existingPlan.includedActions.map((action) => action.actionKey);
@@ -17299,7 +17414,10 @@ function resolveIncludedActionKeysForUpsert(manifestPlan, existingPlan) {
   return [];
 }
 async function resolveActionKeysOrAllProjectActions(manifestPlan, existingPlan, getAllKeys) {
-  const resolved = resolveIncludedActionKeysForUpsert(manifestPlan, existingPlan);
+  const resolved = resolveIncludedActionKeysForUpsert(
+    manifestPlan,
+    existingPlan
+  );
   if (resolved.length > 0) {
     return resolved;
   }
@@ -17313,7 +17431,9 @@ function buildGatewayPlanSortTargetsFromIds(manifestPlans, planIdsBySku, skuById
     const key = input5.sku.toLowerCase();
     const planId = planIdsBySku.get(key);
     if (!planId) {
-      throw new Error(`Gateway plan '${input5.sku}' was not found; upsert plans before reordering.`);
+      throw new Error(
+        `Gateway plan '${input5.sku}' was not found; upsert plans before reordering.`
+      );
     }
     const sku = skuById?.get(key)?.sku ?? input5.sku;
     targets.push({ planId, sku, sortOrder: index });
@@ -17399,7 +17519,11 @@ async function upsertGatewayPlansFromManifest(client, config2, projectId, plans,
           projectActionKeys
         );
       }
-      const patchedJson = await handlePatchGatewayPlan(client, config2, patchArgs);
+      const patchedJson = await handlePatchGatewayPlan(
+        client,
+        config2,
+        patchArgs
+      );
       results.push(JSON.parse(patchedJson));
       planIdsBySku.set(input5.sku.toLowerCase(), found.id);
       continue;
@@ -17415,7 +17539,11 @@ async function upsertGatewayPlansFromManifest(client, config2, projectId, plans,
       priceCurrency: input5.priceCurrency ?? "usd",
       billingPeriod: normalizeBillingPeriod2(input5.billingPeriod),
       limitsJson: planLimitsForPlatform(input5),
-      includedActionKeys: options?.deferActionKeys ? [] : await resolveActionKeysOrAllProjectActions(input5, void 0, projectActionKeys),
+      includedActionKeys: options?.deferActionKeys ? [] : await resolveActionKeysOrAllProjectActions(
+        input5,
+        void 0,
+        projectActionKeys
+      ),
       skipDefaultActions: true,
       sortOrder: index
     });
@@ -17426,8 +17554,17 @@ async function upsertGatewayPlansFromManifest(client, config2, projectId, plans,
     results.push(created);
   }
   if (!options?.syncActionsOnly && plans.length > 0 && plans.every((plan) => planIdsBySku.has(plan.sku.toLowerCase()))) {
-    const sortTargets = buildGatewayPlanSortTargetsFromIds(plans, planIdsBySku, bySku);
-    const sortResults = await applyGatewayPlanSortOrders(client, config2, projectId, sortTargets);
+    const sortTargets = buildGatewayPlanSortTargetsFromIds(
+      plans,
+      planIdsBySku,
+      bySku
+    );
+    const sortResults = await applyGatewayPlanSortOrders(
+      client,
+      config2,
+      projectId,
+      sortTargets
+    );
     results.push(...sortResults);
   }
   return results;
@@ -17482,12 +17619,19 @@ async function materializePublishOpenApiWithGateway(siteDirectory, sourceOpenApi
   const doc = await readOpenApiDocument(source);
   const rewritten = withGatewayServers(doc, gatewayUrl);
   await mkdir11(path55.dirname(outputPath), { recursive: true });
-  await writeFile14(outputPath, `${JSON.stringify(rewritten, null, 2)}
-`, "utf8");
+  await writeFile14(
+    outputPath,
+    `${JSON.stringify(rewritten, null, 2)}
+`,
+    "utf8"
+  );
   return { outputPath, relativeInput };
 }
 async function pointSiteApisAtPublishOpenApi(siteDirectory, relativeInput) {
-  const configPath = path55.join(path55.resolve(siteDirectory), APITOGO_CONFIG_FILENAME2);
+  const configPath = path55.join(
+    path55.resolve(siteDirectory),
+    APITOGO_CONFIG_FILENAME2
+  );
   const raw = await readFile15(configPath, "utf8");
   const config2 = JSON.parse(raw);
   const previousApis = config2.apis;
@@ -17517,20 +17661,30 @@ async function pointSiteApisAtPublishOpenApi(siteDirectory, relativeInput) {
       } else {
         current.backend = previousBackend;
       }
-      await writeFile14(configPath, `${JSON.stringify(current, null, 2)}
-`, "utf8");
+      await writeFile14(
+        configPath,
+        `${JSON.stringify(current, null, 2)}
+`,
+        "utf8"
+      );
     }
   };
 }
 async function prepareOpenApiServersForGatewayBuild(options) {
   const siteDirectory = path55.resolve(options.siteDirectory);
-  let openApiPath = resolveBackendOpenApiPath(options.manifest?.backend?.openApiPath, {
-    siteDirectory,
-    backendSourceDirectory: options.manifest?.backend?.sourceDirectory
-  });
+  let openApiPath = resolveBackendOpenApiPath(
+    options.manifest?.backend?.openApiPath,
+    {
+      siteDirectory,
+      backendSourceDirectory: options.manifest?.backend?.sourceDirectory
+    }
+  );
   if (!openApiPath) {
     try {
-      const raw = await readFile15(path55.join(siteDirectory, APITOGO_CONFIG_FILENAME2), "utf8");
+      const raw = await readFile15(
+        path55.join(siteDirectory, APITOGO_CONFIG_FILENAME2),
+        "utf8"
+      );
       const config2 = JSON.parse(raw);
       const input5 = Array.isArray(config2.apis) ? config2.apis[0]?.input?.trim() : void 0;
       openApiPath = resolveBackendOpenApiPath(input5, { siteDirectory });
@@ -17545,7 +17699,10 @@ async function prepareOpenApiServersForGatewayBuild(options) {
     openApiPath,
     options.gatewayUrl
   );
-  const { restore } = await pointSiteApisAtPublishOpenApi(siteDirectory, relativeInput);
+  const { restore } = await pointSiteApisAtPublishOpenApi(
+    siteDirectory,
+    relativeInput
+  );
   return { relativeInput, outputPath, restore };
 }
 
@@ -17880,7 +18037,9 @@ async function validateDevPortalReadiness(client, projectId, options) {
     })
   );
   checks.push(checkSwaAlignment(options.project, urls.swaUrl));
-  checks.push(await checkGatewayPlans(client, projectId, options.postDeploy ?? false));
+  checks.push(
+    await checkGatewayPlans(client, projectId, options.postDeploy ?? false)
+  );
   checks.push({
     name: "oidc_redirect_uri",
     severity: "info",
@@ -18154,10 +18313,10 @@ async function createProjectWithWarmPoolRetry(client, body, options) {
 }
 
 // src/cli/platform/helpers/backend-packaging.ts
+import { spawn as spawn3 } from "node:child_process";
 import { mkdtemp, readdir, rm as rm5 } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import path57 from "node:path";
-import { spawn as spawn3 } from "node:child_process";
 async function directoryHasRuntimeConfig(dir) {
   if (!await pathExists(dir)) {
     return false;
@@ -18224,7 +18383,9 @@ async function prepareBackendPackagingDirectory(args) {
   if (!csproj) {
     return { directory: sourceDirectory, packagingMode: "source" };
   }
-  const tempRoot = await mkdtemp(path57.join(tmpdir(), "apitogo-dotnet-publish-"));
+  const tempRoot = await mkdtemp(
+    path57.join(tmpdir(), "apitogo-dotnet-publish-")
+  );
   const outputDir = path57.join(tempRoot, "publish");
   const result = await runDotnetPublish(sourceDirectory, outputDir);
   if (result.exitCode !== 0) {
@@ -18288,7 +18449,9 @@ async function packageBackendDirectory(sourceDirectory) {
     output4.on("error", reject);
     archive.pipe(output4);
     for (const rel of files) {
-      archive.append(createReadStream2(path58.join(resolved, rel)), { name: rel.split(path58.sep).join("/") });
+      archive.append(createReadStream2(path58.join(resolved, rel)), {
+        name: rel.split(path58.sep).join("/")
+      });
     }
     void archive.finalize();
   });
@@ -18494,7 +18657,10 @@ async function handleWaitForJob(client, config2, args, progress) {
           return client.getDevPortalDeployStatus(projectId, args.jobId);
         }
         if (args.jobId) {
-          return client.getAzureInfrastructureDeployStatus(projectId, args.jobId);
+          return client.getAzureInfrastructureDeployStatus(
+            projectId,
+            args.jobId
+          );
         }
         return client.getLatestAzureInfrastructureStatus(projectId);
       },
@@ -18531,7 +18697,10 @@ async function handleDeployBackend(client, config2, args, progress) {
   const projectId = resolveProjectId(args.projectId, config2);
   const deployProgress = progress?.child("Backend deployment");
   const runtime = normalizeRuntime(args.runtime);
-  const runtimeVersion = normalizeRuntimeVersionSlug(runtime, args.runtimeVersion);
+  const runtimeVersion = normalizeRuntimeVersionSlug(
+    runtime,
+    args.runtimeVersion
+  );
   const resolvedOpenApiPath = resolveDeployBackendOpenApiPath({
     openApiPath: args.openApiPath,
     sourceDirectory: args.sourceDirectory,
@@ -18541,7 +18710,9 @@ async function handleDeployBackend(client, config2, args, progress) {
     await deployProgress?.onStep("Validating OpenAPI");
     const validation = await validateOpenApiFile(resolvedOpenApiPath);
     if (!validation.valid) {
-      throw new Error(`OpenAPI validation failed: ${validation.errors.join("; ")}`);
+      throw new Error(
+        `OpenAPI validation failed: ${validation.errors.join("; ")}`
+      );
     }
   }
   await deployProgress?.onStep("Packaging backend source");
@@ -18711,6 +18882,20 @@ 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 = [
   {
@@ -18946,7 +19131,11 @@ async function handleEnsurePlatformPlan(client, config2, args, progress) {
     projectId = resolved.projectId;
   } else {
     projectId = resolveProjectId(projectId, config2);
-    steps.push({ step: "resolve_project", status: "succeeded", detail: { projectId } });
+    steps.push({
+      step: "resolve_project",
+      status: "succeeded",
+      detail: { projectId }
+    });
   }
   const existingSubscription = await client.getSubscription(projectId);
   if (isPlatformPlanReady(existingSubscription)) {
@@ -19140,18 +19329,6 @@ async function assertPaidGatewayPlansAllowedForPublish(client, projectId, plans)
   };
 }
 
-// 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/tools/projects.ts
 function tenantDisplayName(tenant) {
   return tenant.displayName ?? tenant.name ?? tenant.userName ?? tenant.email;
@@ -19202,10 +19379,14 @@ async function handleGetProject(client, config2, args) {
   if (args.includeInfrastructureStatus !== false) {
     for (let i = 0; i < enrichedModules.length; i++) {
       const mod = enrichedModules[i];
+      if (!mod) continue;
       const statusLower = mod.status.toLowerCase();
       if (statusLower === "pending" || statusLower === "provisioning") {
         try {
-          const infra = await client.getInfrastructureStatus(projectId, mod.type);
+          const infra = await client.getInfrastructureStatus(
+            projectId,
+            mod.type
+          );
           enrichedModules[i] = {
             ...mod,
             status: `${mod.status} (infra: ${infra.status})`
@@ -19317,7 +19498,11 @@ async function resolveBootstrapProjectId(client, args, steps) {
     });
     const created = JSON.parse(createdJson);
     const projectId = created.project.id;
-    steps.push({ step: "create_project", status: "succeeded", detail: { projectId } });
+    steps.push({
+      step: "create_project",
+      status: "succeeded",
+      detail: { projectId }
+    });
     return { projectId, resumed: false };
   } catch (error) {
     if (!(error instanceof PlatformApiError) || error.status !== 409) {
@@ -19338,7 +19523,9 @@ var READY_MODULE_STATUSES = /* @__PURE__ */ new Set(["provisioned", "configured"
 function moduleTypesPendingActivation(project, requestedModules) {
   return requestedModules.filter((moduleType) => {
     const normalized = normalizeModuleType(moduleType);
-    const mod = project.modules.find((m) => normalizeModuleType(m.type) === normalized);
+    const mod = project.modules.find(
+      (m) => normalizeModuleType(m.type) === normalized
+    );
     if (!mod?.status) {
       return true;
     }
@@ -19352,11 +19539,15 @@ async function handleBootstrapProject(client, config2, args, progress) {
   const selectFreePlan = args.selectFreePlan === true;
   const bootstrapProgress = progress?.child("Bootstrap project");
   await bootstrapProgress?.onStep("Creating project");
-  const { projectId, resumed } = await resolveBootstrapProjectId(client, {
-    name: args.name,
-    description: args.description,
-    modules
-  }, steps);
+  const { projectId, resumed } = await resolveBootstrapProjectId(
+    client,
+    {
+      name: args.name,
+      description: args.description,
+      modules
+    },
+    steps
+  );
   if (selectFreePlan && !resumed) {
     await bootstrapProgress?.onStep("Selecting free plan");
     const freeResult = await handleSelectFreePlan(
@@ -19370,7 +19561,11 @@ async function handleBootstrapProject(client, config2, args, progress) {
     }
     steps.push({ step: "select_free_plan", status: "succeeded" });
   } else if (selectFreePlan && resumed) {
-    steps.push({ step: "select_free_plan", status: "skipped", detail: { reason: "project resumed" } });
+    steps.push({
+      step: "select_free_plan",
+      status: "skipped",
+      detail: { reason: "project resumed" }
+    });
   }
   const projectBeforeModules = await client.getProject(projectId);
   const planSelected = !isPlatformPlanUnselected(projectBeforeModules.planTier);
@@ -19444,7 +19639,11 @@ async function handleBootstrapProject(client, config2, args, progress) {
       })
     );
     for (const { moduleType, activated } of activations) {
-      steps.push({ step: `activate_${moduleType}`, status: "pending", detail: activated });
+      steps.push({
+        step: `activate_${moduleType}`,
+        status: "pending",
+        detail: activated
+      });
     }
     if (wait) {
       const waits = await Promise.all(
@@ -19468,7 +19667,11 @@ async function handleBootstrapProject(client, config2, args, progress) {
         })
       );
       for (const { moduleType, waited } of waits) {
-        steps.push({ step: `wait_${moduleType}`, status: waited.status, detail: waited });
+        steps.push({
+          step: `wait_${moduleType}`,
+          status: waited.status,
+          detail: waited
+        });
         if (waited.status === "failed") {
           return JSON.stringify(
             {
@@ -19749,7 +19952,10 @@ var PLACEHOLDER_HOST_MARKERS = [
   "dp-example.azurecontainerapps.io",
   "your-dev-portal-api.example.com"
 ];
-var ENV_LINE_GLOBAL_RE = new RegExp(`^#?\\s*${SITE_API_BASE_URL_ENV_KEY}=(.*)$`, "gm");
+var ENV_LINE_GLOBAL_RE = new RegExp(
+  `^#?\\s*${SITE_API_BASE_URL_ENV_KEY}=(.*)$`,
+  "gm"
+);
 function isPlaceholderDevPortalApiUrl(apiBaseUrl) {
   if (!apiBaseUrl?.trim()) {
     return true;
@@ -19902,51 +20108,6 @@ async function assertDeployableDistHasLiveApiBaseUrl(distDirectory, expectedApiB
 import { promises as fs11 } from "node:fs";
 import path61 from "node:path";
 
-// src/cli/platform/helpers/tarball.ts
-import { createReadStream as createReadStream3, createWriteStream as createWriteStream3, promises as fs10 } from "node:fs";
-import { tmpdir as tmpdir3 } from "node:os";
-import path60 from "node:path";
-import { TarArchive } from "archiver";
-var DEV_PORTAL_DEPLOY_ARCHIVE_ROOT = "dist";
-function normalizeArchiveRoot(archiveRoot) {
-  const trimmed = archiveRoot.trim().replace(/^\/+|\/+$/g, "");
-  if (!trimmed) {
-    throw new Error("archiveRoot must not be empty.");
-  }
-  return `${trimmed}/`;
-}
-async function packageDirectoryAsTarGz(sourceDirectory, options) {
-  const resolved = path60.resolve(sourceDirectory);
-  const files = await collectPackageableFiles(resolved);
-  const entryPrefix = options?.archiveRoot ? normalizeArchiveRoot(options.archiveRoot) : "";
-  const archivePath = path60.join(
-    tmpdir3(),
-    `apitogo-docs-${Date.now()}-${Math.random().toString(36).slice(2)}.tgz`
-  );
-  await new Promise((resolve, reject) => {
-    const output4 = createWriteStream3(archivePath);
-    const archive = new TarArchive({ gzip: true, gzipOptions: { level: 6 } });
-    output4.on("close", () => resolve());
-    archive.on("error", reject);
-    output4.on("error", reject);
-    archive.pipe(output4);
-    for (const rel of files) {
-      const entryName = entryPrefix + rel.split(path60.sep).join("/");
-      archive.append(createReadStream3(path60.join(resolved, rel)), { name: entryName });
-    }
-    void archive.finalize();
-  });
-  const { size } = await fs10.stat(archivePath);
-  return { archivePath, byteSize: size };
-}
-async function cleanupArchive(archivePath) {
-  await fs10.unlink(archivePath).catch(() => void 0);
-}
-function isTarGzPath(filePath) {
-  const normalized = filePath.toLowerCase();
-  return normalized.endsWith(".tgz") || normalized.endsWith(".tar.gz");
-}
-
 // src/cli/platform/helpers/dev-portal-backend-job.ts
 var DEV_PORTAL_BACKEND_UPDATE_RESOURCE_TYPE = "DevPortalBackendUpdate";
 var ACTIVE_JOB_STATUSES = /* @__PURE__ */ new Set(["Pending", "InProgress"]);
@@ -20049,16 +20210,65 @@ async function pollBackendUpdateJobStatus(client, projectId, jobId, options) {
 }
 async function snapshotBackendUpdateJobIds(client, projectId) {
   const result = await client.listProvisioningJobs(projectId);
-  return new Set(
-    result.jobs.filter(isBackendUpdateJob).map((job) => job.id)
+  return new Set(result.jobs.filter(isBackendUpdateJob).map((job) => job.id));
+}
+
+// src/cli/platform/helpers/tarball.ts
+import { createReadStream as createReadStream3, createWriteStream as createWriteStream3, promises as fs10 } from "node:fs";
+import { tmpdir as tmpdir3 } from "node:os";
+import path60 from "node:path";
+import { TarArchive } from "archiver";
+var DEV_PORTAL_DEPLOY_ARCHIVE_ROOT = "dist";
+function normalizeArchiveRoot(archiveRoot) {
+  const trimmed = archiveRoot.trim().replace(/^\/+|\/+$/g, "");
+  if (!trimmed) {
+    throw new Error("archiveRoot must not be empty.");
+  }
+  return `${trimmed}/`;
+}
+async function packageDirectoryAsTarGz(sourceDirectory, options) {
+  const resolved = path60.resolve(sourceDirectory);
+  const files = await collectPackageableFiles(resolved);
+  const entryPrefix = options?.archiveRoot ? normalizeArchiveRoot(options.archiveRoot) : "";
+  const archivePath = path60.join(
+    tmpdir3(),
+    `apitogo-docs-${Date.now()}-${Math.random().toString(36).slice(2)}.tgz`
   );
+  await new Promise((resolve, reject) => {
+    const output4 = createWriteStream3(archivePath);
+    const archive = new TarArchive({ gzip: true, gzipOptions: { level: 6 } });
+    output4.on("close", () => resolve());
+    archive.on("error", reject);
+    output4.on("error", reject);
+    archive.pipe(output4);
+    for (const rel of files) {
+      const entryName = entryPrefix + rel.split(path60.sep).join("/");
+      archive.append(createReadStream3(path60.join(resolved, rel)), {
+        name: entryName
+      });
+    }
+    void archive.finalize();
+  });
+  const { size } = await fs10.stat(archivePath);
+  return { archivePath, byteSize: size };
+}
+async function cleanupArchive(archivePath) {
+  await fs10.unlink(archivePath).catch(() => void 0);
+}
+function isTarGzPath(filePath) {
+  const normalized = filePath.toLowerCase();
+  return normalized.endsWith(".tgz") || normalized.endsWith(".tar.gz");
 }
 
 // src/cli/platform/tools/dev-portal.ts
 async function handleGetDevPortalBackend(client, config2, args) {
   const projectId = resolveProjectId(args.projectId, config2);
   const backend = await client.getDevPortalBackend(projectId);
-  return JSON.stringify(formatDevPortalBackendResponse(projectId, backend), null, 2);
+  return JSON.stringify(
+    formatDevPortalBackendResponse(projectId, backend),
+    null,
+    2
+  );
 }
 async function upsertDevPortalSettings(client, config2, projectId, body, waitOptions, progress) {
   const baselineJobIds = waitOptions.wait ? await snapshotBackendUpdateJobIds(client, projectId) : void 0;