@lukoweb/apitogo 0.1.14 → 0.1.16

package/dist/cli/cli.js

@@ -131,7 +131,7 @@ import { stat } from "node:fs/promises";
 var fileExists;
 var init_file_exists = __esm({
   "src/config/file-exists.ts"() {
-    fileExists = (path31) => stat(path31).then(() => true).catch(() => false);
+    fileExists = (path32) => stat(path32).then(() => true).catch(() => false);
   }
 });
 
@@ -3822,7 +3822,7 @@ import {
 // package.json
 var package_default = {
   name: "@lukoweb/apitogo",
-  version: "0.1.11",
+  version: "0.1.16",
   type: "module",
   sideEffects: [
     "**/*.css",
@@ -3895,7 +3895,7 @@ var package_default = {
     typecheck: "tsc --project tsconfig.app.json --noEmit",
     "generate:types": "tsx scripts/generate-types.js && tsx scripts/generate-flat-config.js",
     "build:standalone": "vite build --mode standalone --config vite.standalone.config.ts --log-level=error",
-    prepublishOnly: "tsx scripts/generate-publish-exports.ts",
+    prepack: "npm run build && tsx scripts/generate-publish-exports.ts",
     clean: "rm -rf dist",
     codegen: "graphql-codegen --config ./src/codegen.ts"
   },
@@ -4533,14 +4533,14 @@ var flattenAllOf = (schema2) => {
 };
 
 // src/lib/util/traverse.ts
-var traverse = (specification, transform, path31 = []) => {
-  const transformed = transform(specification, path31);
+var traverse = (specification, transform, path32 = []) => {
+  const transformed = transform(specification, path32);
   if (typeof transformed !== "object" || transformed === null) {
     return transformed;
   }
   const result = Array.isArray(transformed) ? [] : {};
   for (const [key, value] of Object.entries(transformed)) {
-    const currentPath = [...path31, key];
+    const currentPath = [...path32, key];
     if (Array.isArray(value)) {
       result[key] = value.map(
         (item, index) => typeof item === "object" && item != null ? traverse(item, transform, [...currentPath, index.toString()]) : item
@@ -4568,9 +4568,9 @@ var resolveLocalRef = (schema2, ref) => {
   if (schemaCache?.has(ref)) {
     return schemaCache.get(ref);
   }
-  const path31 = ref.split("/").slice(1);
+  const path32 = ref.split("/").slice(1);
   let current = schema2;
-  for (const segment of path31) {
+  for (const segment of path32) {
     if (!current || typeof current !== "object") {
       current = null;
     }
@@ -4589,7 +4589,7 @@ var dereference = async (schema2, resolvers = []) => {
   }
   const cloned = structuredClone(schema2);
   const visited = /* @__PURE__ */ new Set();
-  const resolve = async (current, path31) => {
+  const resolve = async (current, path32) => {
     if (isIndexableObject(current)) {
       if (visited.has(current)) {
         return CIRCULAR_REF;
@@ -4597,7 +4597,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], `${path31}/${index}`);
+          current[index] = await resolve(current[index], `${path32}/${index}`);
         }
       } else {
         if ("$ref" in current && typeof current.$ref === "string") {
@@ -4608,13 +4608,13 @@ var dereference = async (schema2, resolvers = []) => {
           for (const resolver of resolvers) {
             const resolved = await resolver($ref);
             if (resolved) {
-              result2 = await resolve(resolved, path31);
+              result2 = await resolve(resolved, path32);
               break;
             }
           }
           if (result2 === void 0) {
             const resolved = await resolveLocalRef(cloned, $ref);
-            result2 = await resolve(resolved, path31);
+            result2 = await resolve(resolved, path32);
           }
           if (hasSiblings) {
             if (result2 === CIRCULAR_REF) {
@@ -4627,7 +4627,7 @@ var dereference = async (schema2, resolvers = []) => {
           return result2;
         }
         for (const key in current) {
-          current[key] = await resolve(current[key], `${path31}/${key}`);
+          current[key] = await resolve(current[key], `${path32}/${key}`);
         }
       }
       visited.delete(current);
@@ -4666,9 +4666,9 @@ var upgradeSchema = (schema2) => {
     }
     return sub;
   });
-  schema2 = traverse(schema2, (sub, path31) => {
+  schema2 = traverse(schema2, (sub, path32) => {
     if (sub.example !== void 0) {
-      if (isSchemaPath(path31 ?? [])) {
+      if (isSchemaPath(path32 ?? [])) {
         sub.examples = [sub.example];
       } else {
         sub.examples = {
@@ -4681,11 +4681,11 @@ var upgradeSchema = (schema2) => {
     }
     return sub;
   });
-  schema2 = traverse(schema2, (schema3, path31) => {
+  schema2 = traverse(schema2, (schema3, path32) => {
     if (schema3.type === "object" && schema3.properties !== void 0) {
-      const parentPath = path31?.slice(0, -1);
+      const parentPath = path32?.slice(0, -1);
       const isMultipart = parentPath?.some((segment, index) => {
-        return segment === "content" && path31?.[index + 1] === "multipart/form-data";
+        return segment === "content" && path32?.[index + 1] === "multipart/form-data";
       });
       if (isMultipart) {
         const entries = Object.entries(schema3.properties);
@@ -4699,8 +4699,8 @@ var upgradeSchema = (schema2) => {
     }
     return schema3;
   });
-  schema2 = traverse(schema2, (schema3, path31) => {
-    if (path31?.includes("content") && path31.includes("application/octet-stream")) {
+  schema2 = traverse(schema2, (schema3, path32) => {
+    if (path32?.includes("content") && path32.includes("application/octet-stream")) {
       return {};
     }
     if (schema3.type === "string" && schema3.format === "binary") {
@@ -4726,11 +4726,11 @@ var upgradeSchema = (schema2) => {
     }
     return sub;
   });
-  schema2 = traverse(schema2, (schema3, path31) => {
+  schema2 = traverse(schema2, (schema3, path32) => {
     if (schema3.type === "string" && schema3.format === "byte") {
-      const parentPath = path31?.slice(0, -1);
+      const parentPath = path32?.slice(0, -1);
       const contentMediaType = parentPath?.find(
-        (_, index) => path31?.[index - 1] === "content"
+        (_, index) => path32?.[index - 1] === "content"
       );
       return {
         type: "string",
@@ -4742,7 +4742,7 @@ var upgradeSchema = (schema2) => {
   });
   return schema2;
 };
-function isSchemaPath(path31) {
+function isSchemaPath(path32) {
   const schemaLocations = [
     ["components", "schemas"],
     "properties",
@@ -4755,10 +4755,10 @@ function isSchemaPath(path31) {
   ];
   return schemaLocations.some((location) => {
     if (Array.isArray(location)) {
-      return location.every((segment, index) => path31[index] === segment);
+      return location.every((segment, index) => path32[index] === segment);
     }
-    return path31.includes(location);
-  }) || path31.includes("schema") || path31.some((segment) => segment.endsWith("Schema"));
+    return path32.includes(location);
+  }) || path32.includes("schema") || path32.some((segment) => segment.endsWith("Schema"));
 }
 
 // src/lib/oas/parser/index.ts
@@ -4840,13 +4840,13 @@ var OPENAPI_PROPS = /* @__PURE__ */ new Set([
   "anyOf",
   "oneOf"
 ]);
-var handleCircularRefs = (obj, currentPath = /* @__PURE__ */ new WeakSet(), refs = /* @__PURE__ */ new WeakMap(), path31 = [], currentRefPaths = /* @__PURE__ */ new Set()) => {
+var handleCircularRefs = (obj, currentPath = /* @__PURE__ */ new WeakSet(), refs = /* @__PURE__ */ new WeakMap(), path32 = [], 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 = path31.find((p) => !OPENAPI_PROPS.has(p)) || path31[0];
+    const circularProp = path32.find((p) => !OPENAPI_PROPS.has(p)) || path32[0];
     return [CIRCULAR_REF, circularProp].filter(Boolean).join(":");
   }
   if (refs.has(obj)) return refs.get(obj);
@@ -4856,7 +4856,7 @@ var handleCircularRefs = (obj, currentPath = /* @__PURE__ */ new WeakSet(), refs
     value,
     currentPath,
     refs,
-    [...path31, key],
+    [...path32, key],
     currentRefPaths
   );
   const result = Array.isArray(obj) ? obj.map((item, i) => recurse(item, i.toString())) : Object.fromEntries(
@@ -4891,7 +4891,7 @@ var resolveExtensions = (obj) => Object.fromEntries(
 var getAllTags = (schema2) => {
   const rootTags = schema2.tags ?? [];
   const operations = Object.values(schema2.paths ?? {}).flatMap(
-    (path31) => HttpMethods.map((k) => path31?.[k]).filter((op) => op != null)
+    (path32) => HttpMethods.map((k) => path32?.[k]).filter((op) => op != null)
   );
   const operationTags = new Set(operations.flatMap((op) => op.tags ?? []));
   const hasUntaggedOperations = operations.some(
@@ -4946,7 +4946,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(
-    ([path31, value]) => HttpMethods.flatMap((method) => {
+    ([path32, value]) => HttpMethods.flatMap((method) => {
       if (!value?.[method]) return [];
       const operation = value[method];
       const pathParameters = value.parameters ?? [];
@@ -4966,7 +4966,7 @@ var getAllOperations = (paths) => {
       return {
         ...operation,
         method,
-        path: path31,
+        path: path32,
         parameters,
         servers,
         tags: operation.tags ?? []
@@ -5324,8 +5324,8 @@ var Schema = builder.objectRef("Schema").implement({
     }),
     paths: t.field({
       type: [PathItem],
-      resolve: (root) => Object.entries(root.paths ?? {}).map(([path31, value]) => ({
-        path: path31,
+      resolve: (root) => Object.entries(root.paths ?? {}).map(([path32, value]) => ({
+        path: path32,
         // biome-ignore lint/style/noNonNullAssertion: value is guaranteed to be defined
         methods: Object.keys(value)
       }))
@@ -5472,7 +5472,7 @@ init_joinUrl();
 
 // src/vite/api/schema-codegen.ts
 var unescapeJsonPointer = (uri) => decodeURIComponent(uri.replace(/~1/g, "/").replace(/~0/g, "~"));
-var getSegmentsFromPath = (path31) => path31.split("/").slice(1).map(unescapeJsonPointer);
+var getSegmentsFromPath = (path32) => path32.split("/").slice(1).map(unescapeJsonPointer);
 var createLocalRefMap = (obj) => {
   const refMap = /* @__PURE__ */ new Map();
   const siblingsMap = /* @__PURE__ */ new Map();
@@ -5503,16 +5503,16 @@ var replaceMarkers = (code, mergedRefs) => code.replace(/"__refMap:(.*?)"/g, '__
   /"__refMap\+Siblings:(.*?)"/g,
   (_, key) => mergedRefs.get(key) ?? `__refMap["${key}"]`
 );
-var lookup = (schema2, path31, filePath) => {
-  const parts = getSegmentsFromPath(path31);
+var lookup = (schema2, path32, filePath) => {
+  const parts = getSegmentsFromPath(path32);
   let val = schema2;
   for (const part of parts) {
     while (val.$ref?.startsWith("#/")) {
-      val = val.$ref === path31 ? val : lookup(schema2, val.$ref, filePath);
+      val = val.$ref === path32 ? 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: ${path31}`
+        `Error in ${filePath ?? "code generation"}: Could not find path segment ${part} in path: ${path32}`
       );
     }
     val = val[part];
@@ -5757,8 +5757,8 @@ var SchemaManager = class {
       }
     }
   };
-  getLatestSchema = (path31) => this.processedSchemas[path31]?.at(0);
-  getSchemasForPath = (path31) => this.processedSchemas[path31];
+  getLatestSchema = (path32) => this.processedSchemas[path32]?.at(0);
+  getSchemasForPath = (path32) => this.processedSchemas[path32];
   getSchemaImports = () => Object.values(this.processedSchemas).flat().filter((s) => s.importKey);
   getUrlToFilePathMap = () => {
     const map = /* @__PURE__ */ new Map();
@@ -7847,14 +7847,14 @@ async function generateSitemap({
 
 // src/vite/prerender/utils.ts
 init_joinUrl();
-var resolveRoutePath = (path31) => {
-  const segments = path31.split("/");
+var resolveRoutePath = (path32) => {
+  const segments = path32.split("/");
   if (segments.some((s) => s.startsWith(":") && !s.endsWith("?"))) {
     return void 0;
   }
   return segments.filter((s) => !s.startsWith(":")).join("/") || void 0;
 };
-var isSkipped = (path31) => path31.includes("*") || /^\d+$/.test(path31);
+var isSkipped = (path32) => path32.includes("*") || /^\d+$/.test(path32);
 var resolveRoutes = (routes, parentPath = "") => routes.flatMap((route) => {
   if (route.path && isSkipped(route.path)) return [];
   const routePath = route.path ? resolveRoutePath(route.path) : void 0;
@@ -8006,7 +8006,9 @@ var prerender = async ({
     }
     if (pagefindWriteResult?.outputPath) {
       logger.info(
-        colors7.blue(`\u2713 pagefind index built: ${pagefindWriteResult.outputPath}`)
+        colors7.blue(
+          `\u2713 pagefind index built: ${pagefindWriteResult.outputPath}`
+        )
       );
     }
   }
@@ -8454,6 +8456,146 @@ var build_default = {
   }
 };
 
+// src/cli/configure-github-workflow/handler.ts
+import { constants } from "node:fs";
+import { access, mkdir as mkdir6, writeFile as writeFile6 } from "node:fs/promises";
+import path25 from "node:path";
+var APITOGO_DEPLOY_WORKFLOW_YAML = `name: Build and Deploy
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  preview:
+    if: github.event_name == 'pull_request'
+    runs-on: ubuntu-latest
+
+    environment:
+      name: preview
+      url: \${{ steps.deploy.outputs.url }}
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Install APIToGo CLI
+        run: npm install -g @lukoweb/apitogo@latest
+
+      - name: Check APIToGo version
+        run: apitogo --version
+
+      - name: Deploy preview
+        id: deploy
+        env:
+          APITOGO_TOKEN: \${{ secrets.APITOGO_TOKEN }}
+        shell: bash
+        run: |
+          ENV_NAME=preview-pr-\${{ github.event.pull_request.number }}
+
+          OUTPUT=$(apitogo deploy --deployment-token="$APITOGO_TOKEN" --env=$ENV_NAME --json-only)
+
+          echo "$OUTPUT"
+
+          URL=$(echo "$OUTPUT" | jq -r '.url')
+
+          if [ -z "$URL" ] || [ "$URL" = "null" ]; then
+            echo "Failed to extract preview URL"
+            exit 1
+          fi
+
+          echo "url=$URL" >> "$GITHUB_OUTPUT"
+
+  production:
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+
+    environment:
+      name: production
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Install APIToGo CLI
+        run: npm install -g @lukoweb/apitogo@latest
+
+      - name: Check APIToGo version
+        run: apitogo --version
+
+      - name: Deploy production
+        env:
+          APITOGO_TOKEN: \${{ secrets.APITOGO_TOKEN }}
+        run: apitogo deploy --deployment-token="$APITOGO_TOKEN" --json-only
+`;
+async function configureGithubWorkflow(argv) {
+  const dir = path25.resolve(process.cwd(), argv.dir);
+  const workflowDir = path25.join(dir, ".github", "workflows");
+  const workflowPath = path25.join(workflowDir, "apitogo-deploy.yml");
+  try {
+    try {
+      await access(workflowPath, constants.F_OK);
+      if (!argv.force) {
+        await printCriticalFailureToConsoleAndExit(
+          `Workflow file already exists: ${workflowPath}. Pass --force to overwrite.`
+        );
+      }
+    } catch {
+    }
+    await mkdir6(workflowDir, { recursive: true });
+    await writeFile6(workflowPath, APITOGO_DEPLOY_WORKFLOW_YAML, "utf8");
+    printResultToConsole("Wrote .github/workflows/apitogo-deploy.yml");
+  } catch (error) {
+    await printCriticalFailureToConsoleAndExit(
+      error instanceof Error ? error.message : String(error)
+    );
+  }
+}
+
+// src/cli/cmds/configure-github-workflow.ts
+var configure_github_workflow_default = {
+  desc: "Add a GitHub Actions workflow for APIToGo preview and production deploys",
+  command: "configure-github-workflow",
+  builder: (yargs2) => yargs2.option("dir", {
+    type: "string",
+    describe: "The directory containing your project",
+    default: ".",
+    normalize: true,
+    hidden: true
+  }).option("force", {
+    type: "boolean",
+    describe: "Overwrite .github/workflows/apitogo-deploy.yml if it already exists",
+    default: false
+  }),
+  handler: async (argv) => {
+    await captureEvent({ argv, event: "apitogo configure-github-workflow" });
+    await configureGithubWorkflow(argv);
+  }
+};
+
 // src/cli/common/json-only-deploy.ts
 init_logger();
 function isDeployJsonOnlyArgv() {
@@ -8462,9 +8604,7 @@ function isDeployJsonOnlyArgv() {
   if (deployIdx === -1) {
     return false;
   }
-  return args.slice(deployIdx).some(
-    (a) => a === "--json-only" || a.startsWith("--json-only=")
-  );
+  return args.slice(deployIdx).some((a) => a === "--json-only" || a.startsWith("--json-only="));
 }
 function isJsonOnlyDeployEnv() {
   return process.env.APITOGO_JSON_ONLY === "1";
@@ -8479,16 +8619,16 @@ function applyJsonOnlyDeployQuietMode() {
 }
 
 // src/cli/deploy/handler.ts
-import { access, readFile as readFile4 } from "node:fs/promises";
-import path25 from "node:path";
+import { access as access2, readFile as readFile4 } from "node:fs/promises";
+import path26 from "node:path";
 import { create as createTar } from "tar";
 var DEPLOY_ENDPOINT = "https://deployserver.apitogo.com/deploy";
 var DEPLOY_API_KEY = "qRVLTP22TFStdN6";
 var ARCHIVE_NAME = "dist.tgz";
 var createDeploymentArchive = async (dir) => {
-  const distDir = path25.join(dir, "dist");
-  await access(distDir);
-  const archivePath = path25.join(dir, ARCHIVE_NAME);
+  const distDir = path26.join(dir, "dist");
+  await access2(distDir);
+  const archivePath = path26.join(dir, ARCHIVE_NAME);
   await createTar(
     {
       cwd: dir,
@@ -8502,7 +8642,7 @@ var createDeploymentArchive = async (dir) => {
 };
 async function deploy(argv) {
   await build({ ...argv, preview: void 0 });
-  const dir = path25.resolve(process.cwd(), argv.dir);
+  const dir = path26.resolve(process.cwd(), argv.dir);
   const deploymentToken = argv.deploymentToken?.trim() || process.env.npm_config_deployment_token?.trim();
   const env = argv.env?.trim() || process.env.npm_config_env?.trim() || "production";
   try {
@@ -8515,7 +8655,7 @@ async function deploy(argv) {
     const archivePath = await createDeploymentArchive(dir);
     if (!isJsonOnlyDeployEnv()) {
       printDiagnosticsToConsole(
-        `Uploading ${path25.basename(archivePath)} to ${env}...`
+        `Uploading ${path26.basename(archivePath)} to ${env}...`
       );
     }
     const archiveBuffer = await readFile4(archivePath);
@@ -8523,7 +8663,7 @@ async function deploy(argv) {
     formData.append(
       "file",
       new Blob([archiveBuffer], { type: "application/gzip" }),
-      path25.basename(archivePath)
+      path26.basename(archivePath)
     );
     formData.append("deploymentToken", deploymentToken);
     formData.append("env", env);
@@ -8574,7 +8714,7 @@ var deploy_default = {
     describe: "Deployment token sent to the deploy endpoint"
   }).option("env", {
     type: "string",
-    describe: "Deployment environment name",
+    describe: "Target environment name sent to the deploy API (e.g. production, preview, preview-a, preview-b)",
     default: "production"
   }).option("dir", {
     type: "string",
@@ -8608,14 +8748,14 @@ var deploy_default = {
 
 // src/cli/dev/handler.ts
 init_joinUrl();
-import path28 from "node:path";
+import path29 from "node:path";
 
 // src/vite/dev-server.ts
 init_logger();
 import fs3 from "node:fs/promises";
 import http from "node:http";
 import https from "node:https";
-import path27 from "node:path";
+import path28 from "node:path";
 import { createHttpTerminator } from "http-terminator";
 import {
   createServer as createViteServer,
@@ -8648,7 +8788,7 @@ init_loader();
 // src/vite/pagefind-dev-index.ts
 init_invariant();
 init_joinUrl();
-import path26 from "node:path";
+import path27 from "node:path";
 import { createIndex as createIndex2 } from "pagefind";
 import { isRunnableDevEnvironment } from "vite";
 async function* buildPagefindDevIndex(vite, config2) {
@@ -8701,7 +8841,7 @@ async function* buildPagefindDevIndex(vite, config2) {
       path: urlPath
     };
   }
-  const outputPath = path26.join(vite.config.publicDir, "pagefind");
+  const outputPath = path27.join(vite.config.publicDir, "pagefind");
   await pagefindIndex.writeFiles({ outputPath });
   yield { type: "complete", success: true, indexed };
 }
@@ -8720,9 +8860,9 @@ var DevServer = class {
     this.protocol = "https";
     const { dir } = this.options;
     const [key, cert, ca] = await Promise.all([
-      fs3.readFile(path27.resolve(dir, config2.https.key)),
-      fs3.readFile(path27.resolve(dir, config2.https.cert)),
-      config2.https.ca ? fs3.readFile(path27.resolve(dir, config2.https.ca)) : void 0
+      fs3.readFile(path28.resolve(dir, config2.https.key)),
+      fs3.readFile(path28.resolve(dir, config2.https.cert)),
+      config2.https.ca ? fs3.readFile(path28.resolve(dir, config2.https.ca)) : void 0
     ]);
     return https.createServer({ key, cert, ca });
   }
@@ -8749,7 +8889,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 = path27.posix.join(
+            const entryPath = path28.posix.join(
               server2.config.base,
               "/__z/entry.client.tsx"
             );
@@ -8822,13 +8962,13 @@ var DevServer = class {
       `Server-side rendering ${this.options.ssr ? "enabled" : "disabled"}`
     );
     if (config2.search?.type === "pagefind") {
-      const pagefindPath = path27.join(
+      const pagefindPath = path28.join(
         vite.config.publicDir,
         "pagefind/pagefind.js"
       );
       const exists = await fs3.stat(pagefindPath).catch(() => false);
       if (!exists) {
-        await fs3.mkdir(path27.dirname(pagefindPath), { recursive: true });
+        await fs3.mkdir(path28.dirname(pagefindPath), { recursive: true });
         await fs3.writeFile(pagefindPath, 'throw new Error("NOT_BUILT_YET");');
       }
     }
@@ -8922,7 +9062,7 @@ init_package_json();
 async function dev(argv) {
   const packageJson2 = getZudokuPackageJson();
   process.env.NODE_ENV = "development";
-  const dir = path28.resolve(process.cwd(), argv.dir);
+  const dir = path29.resolve(process.cwd(), argv.dir);
   const server = new DevServer({
     dir,
     argPort: argv.port,
@@ -9004,31 +9144,9 @@ var dev_default = {
   }
 };
 
-// src/cli/cmds/preview.ts
-var previewCommand = {
-  desc: "Preview production build",
-  command: "preview",
-  builder: (yargs2) => yargs2.option("dir", {
-    type: "string",
-    describe: "The directory containing your project",
-    default: ".",
-    normalize: true,
-    hidden: true
-  }).option("port", {
-    type: "number",
-    describe: "The port to run the local server on"
-  }),
-  handler: async (argv) => {
-    process.env.NODE_ENV = "production";
-    await captureEvent({ argv, event: "apitogo preview" });
-    await preview(argv);
-  }
-};
-var preview_default = previewCommand;
-
-// src/cli/sync-config/handler.ts
-import { readFile as readFile5, writeFile as writeFile6 } from "node:fs/promises";
-import path29 from "node:path";
+// src/cli/make-config/handler.ts
+import { readFile as readFile5, writeFile as writeFile7 } from "node:fs/promises";
+import path30 from "node:path";
 import { glob as glob4 } from "glob";
 var CONFIG_FILENAMES = [
   "apitogo.config.tsx",
@@ -9042,8 +9160,9 @@ var CONFIG_FILENAMES = [
   "zudoku.config.js",
   "zudoku.config.mjs"
 ];
+var DEFAULT_NEW_CONFIG_FILENAME = "apitogo.config.tsx";
 var createTreeNode = () => ({ docs: [], children: /* @__PURE__ */ new Map() });
-var toPosixPath2 = (value) => value.split(path29.sep).join(path29.posix.sep);
+var toPosixPath2 = (value) => value.split(path30.sep).join(path30.posix.sep);
 var toRoutePath = (relativeFile, pagesDir) => {
   const relativeNoExt = relativeFile.replace(/\.mdx?$/, "");
   const withoutPagesPrefix = relativeNoExt.replace(
@@ -9209,36 +9328,102 @@ var findMatchingBracket = (source, startIndex) => {
   }
   throw new Error("Could not find matching closing bracket.");
 };
-var replaceArrayProperty = (source, propertyName, replacement) => {
-  const propertyIndex = source.indexOf(`${propertyName}:`);
-  if (propertyIndex === -1) {
+var findPropertyArrayBounds = (source, propertyName) => {
+  const re = new RegExp(`\\b${propertyName}\\s*:`);
+  const match = source.match(re);
+  if (!match || match.index === void 0) {
     throw new Error(`Could not find '${propertyName}' in config file.`);
   }
-  const arrayStart = source.indexOf("[", propertyIndex);
+  const arrayStart = source.indexOf("[", match.index);
   if (arrayStart === -1) {
-    throw new Error(`Could not find array start for '${propertyName}'.`);
+    throw new Error(
+      `Could not find array value for '${propertyName}' (expected [...]).`
+    );
   }
   const arrayEnd = findMatchingBracket(source, arrayStart);
+  return { arrayStart, arrayEnd };
+};
+var replaceArrayProperty = (source, propertyName, replacement) => {
+  const { arrayStart, arrayEnd } = findPropertyArrayBounds(
+    source,
+    propertyName
+  );
   return `${source.slice(0, arrayStart)}${replacement}${source.slice(arrayEnd + 1)}`;
 };
-var findConfigPath = async (dir) => {
+var insertNavigationAndRedirectsKeys = (source) => {
+  const m = source.match(/(const\s+config\s*:\s*ApitogoConfig\s*=\s*\{)/);
+  if (!m || m.index === void 0) {
+    throw new Error(
+      "Could not find 'const config: ApitogoConfig = {' \u2014 add navigation and redirects arrays manually."
+    );
+  }
+  const insertAt = m.index + m[0].length;
+  return `${source.slice(0, insertAt)}
+  navigation: [],
+  redirects: [],${source.slice(insertAt)}`;
+};
+var insertRedirectsAfterNavigation = (source) => {
+  if (/\bredirects\s*:/.test(source)) return source;
+  const { arrayEnd } = findPropertyArrayBounds(source, "navigation");
+  let i = arrayEnd + 1;
+  while (i < source.length && /\s/.test(source[i])) i++;
+  if (source[i] === ",") {
+    return `${source.slice(0, i + 1)}
+  redirects: [],${source.slice(i + 1)}`;
+  }
+  return `${source.slice(0, arrayEnd + 1)},
+  redirects: [],${source.slice(arrayEnd + 1)}`;
+};
+var ensureNavigationAndRedirectsForUpdate = (source) => {
+  const hasNav = /\bnavigation\s*:/.test(source);
+  const hasRedirects = /\bredirects\s*:/.test(source);
+  if (hasNav && hasRedirects) return source;
+  if (!hasNav && !hasRedirects) return insertNavigationAndRedirectsKeys(source);
+  if (hasNav && !hasRedirects) return insertRedirectsAfterNavigation(source);
+  throw new Error(
+    "Found 'redirects' but not 'navigation'. Add a navigation: [...] array manually."
+  );
+};
+var buildNewConfigContents = (pagesDir) => {
+  const filesGlob = `/${pagesDir}/**/*.mdx`;
+  return `import type { ApitogoConfig } from "@lukoweb/apitogo";
+
+const config: ApitogoConfig = {
+  docs: {
+    files: "${filesGlob}",
+  },
+  navigation: [],
+  redirects: [],
+};
+
+export default config;
+`;
+};
+var findExistingConfigPath = async (dir) => {
   for (const filename of CONFIG_FILENAMES) {
-    const fullPath = path29.join(dir, filename);
+    const fullPath = path30.join(dir, filename);
     try {
       await readFile5(fullPath, "utf8");
       return fullPath;
     } catch {
     }
   }
-  throw new Error("No APIToGo config file found in the project root.");
+  return null;
 };
-async function syncConfig(argv) {
-  const dir = path29.resolve(process.cwd(), argv.dir);
+async function makeConfig(argv) {
+  const dir = path30.resolve(process.cwd(), argv.dir);
   const pagesDir = toPosixPath2(
     argv.pagesDir.replace(/^[./]+/, "").replace(/\/+$/, "")
   );
   try {
-    const configPath = await findConfigPath(dir);
+    let configPath = await findExistingConfigPath(dir);
+    let createdNew = false;
+    if (!configPath) {
+      configPath = path30.join(dir, DEFAULT_NEW_CONFIG_FILENAME);
+      await writeFile7(configPath, buildNewConfigContents(pagesDir), "utf8");
+      createdNew = true;
+      printDiagnosticsToConsole(`Created ${DEFAULT_NEW_CONFIG_FILENAME}`);
+    }
     const pageFiles = await glob4(`${pagesDir}/**/*.{md,mdx}`, {
       cwd: dir,
       ignore: ["**/node_modules/**", "**/.git/**", "**/dist/**"],
@@ -9250,22 +9435,22 @@ async function syncConfig(argv) {
     if (routePaths.length === 0) {
       throw new Error(`No .md or .mdx files found under '${pagesDir}'.`);
     }
-    const tree = buildTree(routePaths);
-    const navigationItems = treeToNavigationItems(tree);
-    const originalConfig = await readFile5(configPath, "utf8");
+    let originalConfig = await readFile5(configPath, "utf8");
+    originalConfig = ensureNavigationAndRedirectsForUpdate(originalConfig);
     const withNavigation = replaceArrayProperty(
       originalConfig,
       "navigation",
-      buildNavigationCode(navigationItems)
+      buildNavigationCode(treeToNavigationItems(buildTree(routePaths)))
     );
     const withRedirects = replaceArrayProperty(
       withNavigation,
       "redirects",
       buildRedirectsCode(routePaths[0])
     );
-    await writeFile6(configPath, withRedirects, "utf8");
+    await writeFile7(configPath, withRedirects, "utf8");
+    const action = createdNew ? "Initialized" : "Updated";
     printResultToConsole(
-      `Updated ${path29.basename(configPath)} from ${pagesDir}/`
+      `${action} ${path30.basename(configPath)} from ${pagesDir}/ (navigation and redirects only; other settings unchanged)`
     );
   } catch (error) {
     await printCriticalFailureToConsoleAndExit(
@@ -9274,10 +9459,10 @@ async function syncConfig(argv) {
   }
 }
 
-// src/cli/cmds/sync-config.ts
-var sync_config_default = {
-  desc: "Regenerate navigation from the pages folder",
-  command: "sync-config",
+// src/cli/cmds/make-config.ts
+var make_config_default = {
+  desc: "Create or update config navigation from the pages folder (other settings preserved)",
+  command: "make-config",
   builder: (yargs2) => yargs2.option("dir", {
     type: "string",
     describe: "The directory containing your project",
@@ -9290,14 +9475,36 @@ var sync_config_default = {
     default: "pages"
   }),
   handler: async (argv) => {
-    await captureEvent({ argv, event: "apitogo sync-config" });
-    await syncConfig(argv);
+    await captureEvent({ argv, event: "apitogo make-config" });
+    await makeConfig(argv);
+  }
+};
+
+// src/cli/cmds/preview.ts
+var previewCommand = {
+  desc: "Preview production build",
+  command: "preview",
+  builder: (yargs2) => yargs2.option("dir", {
+    type: "string",
+    describe: "The directory containing your project",
+    default: ".",
+    normalize: true,
+    hidden: true
+  }).option("port", {
+    type: "number",
+    describe: "The port to run the local server on"
+  }),
+  handler: async (argv) => {
+    process.env.NODE_ENV = "production";
+    await captureEvent({ argv, event: "apitogo preview" });
+    await preview(argv);
   }
 };
+var preview_default = previewCommand;
 
 // src/cli/common/outdated.ts
 import { existsSync as existsSync2, mkdirSync } from "node:fs";
-import { readFile as readFile6, writeFile as writeFile7 } from "node:fs/promises";
+import { readFile as readFile6, writeFile as writeFile8 } from "node:fs/promises";
 import { join } from "node:path";
 import colors10 from "picocolors";
 import { gt } from "semver";
@@ -9347,12 +9554,12 @@ function box(message, {
 
 // src/cli/common/xdg/lib.ts
 import { homedir } from "node:os";
-import path30 from "node:path";
+import path31 from "node:path";
 function defineDirectoryWithFallback(xdgName, fallback) {
   if (process.env[xdgName]) {
     return process.env[xdgName];
   } else {
-    return path30.join(homedir(), fallback);
+    return path31.join(homedir(), fallback);
   }
 }
 var XDG_CONFIG_HOME = defineDirectoryWithFallback(
@@ -9367,15 +9574,15 @@ var XDG_STATE_HOME = defineDirectoryWithFallback(
   "XDG_DATA_HOME",
   ".local/state"
 );
-var ZUDOKU_XDG_CONFIG_HOME = path30.join(
+var ZUDOKU_XDG_CONFIG_HOME = path31.join(
   XDG_CONFIG_HOME,
   CLI_XDG_FOLDER_NAME
 );
-var ZUDOKU_XDG_DATA_HOME = path30.join(
+var ZUDOKU_XDG_DATA_HOME = path31.join(
   XDG_DATA_HOME,
   CLI_XDG_FOLDER_NAME
 );
-var ZUDOKU_XDG_STATE_HOME = path30.join(
+var ZUDOKU_XDG_STATE_HOME = path31.join(
   XDG_STATE_HOME,
   CLI_XDG_FOLDER_NAME
 );
@@ -9452,7 +9659,7 @@ async function getVersionCheckInfo() {
       lastCheck: Date.now(),
       latestVersion
     };
-    await writeFile7(
+    await writeFile8(
       versionCheckPath,
       JSON.stringify(versionCheckInfo),
       "utf-8"
@@ -9539,7 +9746,7 @@ var cli = yargs(hideBin(process.argv)).option("zuplo", {
     process.env.ZUPLO = "1";
     printDiagnosticsToConsole("Running in Zuplo mode");
   }
-}).middleware(warnPackageVersionMismatch).command(build_default).command(dev_default).command(deploy_default).command(preview_default).command(sync_config_default).demandCommand().strictCommands().version(packageJson?.version).fail(false).help();
+}).middleware(warnPackageVersionMismatch).command(build_default).command(configure_github_workflow_default).command(dev_default).command(deploy_default).command(preview_default).command(make_config_default).demandCommand().strictCommands().version(packageJson?.version).fail(false).help();
 try {
   void warnIfOutdatedVersion(packageJson?.version);
   await cli.argv;