@lukoweb/apitogo 0.1.3 → 0.1.5

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 = (path30) => stat(path30).then(() => true).catch(() => false);
+    fileExists = (path31) => stat(path31).then(() => true).catch(() => false);
   }
 });
 
@@ -3816,7 +3816,7 @@ import {
 // package.json
 var package_default = {
   name: "@lukoweb/apitogo",
-  version: "0.1.2",
+  version: "0.1.4",
   type: "module",
   sideEffects: [
     "**/*.css",
@@ -3890,7 +3890,6 @@ var package_default = {
     "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",
-    postpublish: "git checkout -- package.json",
     clean: "rm -rf dist",
     codegen: "graphql-codegen --config ./src/codegen.ts"
   },
@@ -4001,9 +4000,9 @@ var package_default = {
     shiki: "3.23.0",
     sitemap: "9.0.1",
     "strip-ansi": "7.2.0",
+    tar: "7.5.10",
     "tailwind-merge": "3.5.0",
     tailwindcss: "4.2.1",
-    tar: "7.5.10",
     "tw-animate-css": "1.4.0",
     unified: "11.0.5",
     "unist-util-visit": "5.1.0",
@@ -4067,6 +4066,127 @@ var package_default = {
     mermaid: {
       optional: true
     }
+  },
+  publishConfig: {
+    exports: {
+      ".": {
+        types: "./dist/declarations/index.d.ts",
+        default: "./src/index.ts"
+      },
+      "./package.json": "./package.json",
+      "./ui/*": {
+        types: "./dist/declarations/lib/ui/*.d.ts",
+        default: "./src/lib/ui/*.tsx"
+      },
+      "./ui/*.js": {
+        types: "./dist/declarations/lib/ui/*.d.ts",
+        default: "./src/lib/ui/*.tsx"
+      },
+      "./client": {
+        types: "./client.d.ts"
+      },
+      "./auth/clerk": {
+        types: "./dist/declarations/lib/authentication/providers/clerk.d.ts",
+        default: "./src/lib/authentication/providers/clerk.tsx"
+      },
+      "./auth/auth0": {
+        types: "./dist/declarations/lib/authentication/providers/auth0.d.ts",
+        default: "./src/lib/authentication/providers/auth0.tsx"
+      },
+      "./auth/openid": {
+        types: "./dist/declarations/lib/authentication/providers/openid.d.ts",
+        default: "./src/lib/authentication/providers/openid.tsx"
+      },
+      "./auth/supabase": {
+        types: "./dist/declarations/lib/authentication/providers/supabase.d.ts",
+        default: "./src/lib/authentication/providers/supabase.tsx"
+      },
+      "./auth/azureb2c": {
+        types: "./dist/declarations/lib/authentication/providers/azureb2c.d.ts",
+        default: "./src/lib/authentication/providers/azureb2c.tsx"
+      },
+      "./auth/firebase": {
+        types: "./dist/declarations/lib/authentication/providers/firebase.d.ts",
+        default: "./src/lib/authentication/providers/firebase.tsx"
+      },
+      "./plugins": {
+        types: "./dist/declarations/lib/core/plugins.d.ts",
+        default: "./src/lib/core/plugins.ts"
+      },
+      "./plugins/api-keys": {
+        types: "./dist/declarations/lib/plugins/api-keys/index.d.ts",
+        default: "./src/lib/plugins/api-keys/index.tsx"
+      },
+      "./plugins/markdown": {
+        types: "./dist/declarations/lib/plugins/markdown/index.d.ts",
+        default: "./src/lib/plugins/markdown/index.tsx"
+      },
+      "./plugins/openapi": {
+        types: "./dist/declarations/lib/plugins/openapi/index.d.ts",
+        default: "./src/lib/plugins/openapi/index.tsx"
+      },
+      "./plugins/custom-pages": {
+        types: "./dist/declarations/lib/plugins/custom-pages/index.d.ts",
+        default: "./src/lib/plugins/custom-pages/index.tsx"
+      },
+      "./plugins/search-inkeep": {
+        types: "./dist/declarations/lib/plugins/search-inkeep/index.d.ts",
+        default: "./src/lib/plugins/search-inkeep/index.tsx"
+      },
+      "./plugins/search-pagefind": {
+        types: "./dist/declarations/lib/plugins/search-pagefind/index.d.ts",
+        default: "./src/lib/plugins/search-pagefind/index.tsx"
+      },
+      "./plugins/api-catalog": {
+        types: "./dist/declarations/lib/plugins/api-catalog/index.d.ts",
+        default: "./src/lib/plugins/api-catalog/index.tsx"
+      },
+      "./components": {
+        types: "./dist/declarations/lib/components/index.d.ts",
+        default: "./src/lib/components/index.ts"
+      },
+      "./mermaid": {
+        types: "./dist/declarations/lib/components/Mermaid.d.ts",
+        default: "./src/lib/components/Mermaid.tsx"
+      },
+      "./router": {
+        types: "./dist/declarations/lib/core/router.d.ts",
+        default: "./src/lib/core/router.ts"
+      },
+      "./react-query": {
+        types: "./dist/declarations/lib/core/react-query.d.ts",
+        default: "./src/lib/core/react-query.ts"
+      },
+      "./icons": {
+        types: "./dist/declarations/lib/icons.d.ts",
+        default: "./src/lib/icons.ts"
+      },
+      "./vite": {
+        types: "./dist/declarations/vite/index.d.ts",
+        default: "./src/vite/index.ts"
+      },
+      "./app/*": {
+        types: "./dist/declarations/app/*.d.ts",
+        default: "./src/app/*"
+      },
+      "./hooks": {
+        types: "./dist/declarations/lib/hooks/index.d.ts",
+        default: "./src/lib/hooks/index.ts"
+      },
+      "./main.css": "./src/app/main.css",
+      "./processors/*": {
+        types: "./dist/declarations/lib/plugins/openapi/processors/*.d.ts",
+        default: "./src/lib/plugins/openapi/processors/*.ts"
+      },
+      "./with-zuplo": {
+        types: "./dist/declarations/zuplo/with-zuplo.d.ts",
+        default: "./src/zuplo/with-zuplo.ts"
+      },
+      "./testing": {
+        types: "./dist/declarations/lib/testing/index.d.ts",
+        default: "./src/lib/testing/index.tsx"
+      }
+    }
   }
 };
 
@@ -4407,14 +4527,14 @@ var flattenAllOf = (schema2) => {
 };
 
 // src/lib/util/traverse.ts
-var traverse = (specification, transform, path30 = []) => {
-  const transformed = transform(specification, path30);
+var traverse = (specification, transform, path31 = []) => {
+  const transformed = transform(specification, path31);
   if (typeof transformed !== "object" || transformed === null) {
     return transformed;
   }
   const result = Array.isArray(transformed) ? [] : {};
   for (const [key, value] of Object.entries(transformed)) {
-    const currentPath = [...path30, key];
+    const currentPath = [...path31, key];
     if (Array.isArray(value)) {
       result[key] = value.map(
         (item, index) => typeof item === "object" && item != null ? traverse(item, transform, [...currentPath, index.toString()]) : item
@@ -4442,9 +4562,9 @@ var resolveLocalRef = (schema2, ref) => {
   if (schemaCache?.has(ref)) {
     return schemaCache.get(ref);
   }
-  const path30 = ref.split("/").slice(1);
+  const path31 = ref.split("/").slice(1);
   let current = schema2;
-  for (const segment of path30) {
+  for (const segment of path31) {
     if (!current || typeof current !== "object") {
       current = null;
     }
@@ -4463,7 +4583,7 @@ var dereference = async (schema2, resolvers = []) => {
   }
   const cloned = structuredClone(schema2);
   const visited = /* @__PURE__ */ new Set();
-  const resolve = async (current, path30) => {
+  const resolve = async (current, path31) => {
     if (isIndexableObject(current)) {
       if (visited.has(current)) {
         return CIRCULAR_REF;
@@ -4471,7 +4591,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], `${path30}/${index}`);
+          current[index] = await resolve(current[index], `${path31}/${index}`);
         }
       } else {
         if ("$ref" in current && typeof current.$ref === "string") {
@@ -4482,13 +4602,13 @@ var dereference = async (schema2, resolvers = []) => {
           for (const resolver of resolvers) {
             const resolved = await resolver($ref);
             if (resolved) {
-              result2 = await resolve(resolved, path30);
+              result2 = await resolve(resolved, path31);
               break;
             }
           }
           if (result2 === void 0) {
             const resolved = await resolveLocalRef(cloned, $ref);
-            result2 = await resolve(resolved, path30);
+            result2 = await resolve(resolved, path31);
           }
           if (hasSiblings) {
             if (result2 === CIRCULAR_REF) {
@@ -4501,7 +4621,7 @@ var dereference = async (schema2, resolvers = []) => {
           return result2;
         }
         for (const key in current) {
-          current[key] = await resolve(current[key], `${path30}/${key}`);
+          current[key] = await resolve(current[key], `${path31}/${key}`);
         }
       }
       visited.delete(current);
@@ -4540,9 +4660,9 @@ var upgradeSchema = (schema2) => {
     }
     return sub;
   });
-  schema2 = traverse(schema2, (sub, path30) => {
+  schema2 = traverse(schema2, (sub, path31) => {
     if (sub.example !== void 0) {
-      if (isSchemaPath(path30 ?? [])) {
+      if (isSchemaPath(path31 ?? [])) {
         sub.examples = [sub.example];
       } else {
         sub.examples = {
@@ -4555,11 +4675,11 @@ var upgradeSchema = (schema2) => {
     }
     return sub;
   });
-  schema2 = traverse(schema2, (schema3, path30) => {
+  schema2 = traverse(schema2, (schema3, path31) => {
     if (schema3.type === "object" && schema3.properties !== void 0) {
-      const parentPath = path30?.slice(0, -1);
+      const parentPath = path31?.slice(0, -1);
       const isMultipart = parentPath?.some((segment, index) => {
-        return segment === "content" && path30?.[index + 1] === "multipart/form-data";
+        return segment === "content" && path31?.[index + 1] === "multipart/form-data";
       });
       if (isMultipart) {
         const entries = Object.entries(schema3.properties);
@@ -4573,8 +4693,8 @@ var upgradeSchema = (schema2) => {
     }
     return schema3;
   });
-  schema2 = traverse(schema2, (schema3, path30) => {
-    if (path30?.includes("content") && path30.includes("application/octet-stream")) {
+  schema2 = traverse(schema2, (schema3, path31) => {
+    if (path31?.includes("content") && path31.includes("application/octet-stream")) {
       return {};
     }
     if (schema3.type === "string" && schema3.format === "binary") {
@@ -4600,11 +4720,11 @@ var upgradeSchema = (schema2) => {
     }
     return sub;
   });
-  schema2 = traverse(schema2, (schema3, path30) => {
+  schema2 = traverse(schema2, (schema3, path31) => {
     if (schema3.type === "string" && schema3.format === "byte") {
-      const parentPath = path30?.slice(0, -1);
+      const parentPath = path31?.slice(0, -1);
       const contentMediaType = parentPath?.find(
-        (_, index) => path30?.[index - 1] === "content"
+        (_, index) => path31?.[index - 1] === "content"
       );
       return {
         type: "string",
@@ -4616,7 +4736,7 @@ var upgradeSchema = (schema2) => {
   });
   return schema2;
 };
-function isSchemaPath(path30) {
+function isSchemaPath(path31) {
   const schemaLocations = [
     ["components", "schemas"],
     "properties",
@@ -4629,10 +4749,10 @@ function isSchemaPath(path30) {
   ];
   return schemaLocations.some((location) => {
     if (Array.isArray(location)) {
-      return location.every((segment, index) => path30[index] === segment);
+      return location.every((segment, index) => path31[index] === segment);
     }
-    return path30.includes(location);
-  }) || path30.includes("schema") || path30.some((segment) => segment.endsWith("Schema"));
+    return path31.includes(location);
+  }) || path31.includes("schema") || path31.some((segment) => segment.endsWith("Schema"));
 }
 
 // src/lib/oas/parser/index.ts
@@ -4714,13 +4834,13 @@ var OPENAPI_PROPS = /* @__PURE__ */ new Set([
   "anyOf",
   "oneOf"
 ]);
-var handleCircularRefs = (obj, currentPath = /* @__PURE__ */ new WeakSet(), refs = /* @__PURE__ */ new WeakMap(), path30 = [], currentRefPaths = /* @__PURE__ */ new Set()) => {
+var handleCircularRefs = (obj, currentPath = /* @__PURE__ */ new WeakSet(), refs = /* @__PURE__ */ new WeakMap(), path31 = [], 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 = path30.find((p) => !OPENAPI_PROPS.has(p)) || path30[0];
+    const circularProp = path31.find((p) => !OPENAPI_PROPS.has(p)) || path31[0];
     return [CIRCULAR_REF, circularProp].filter(Boolean).join(":");
   }
   if (refs.has(obj)) return refs.get(obj);
@@ -4730,7 +4850,7 @@ var handleCircularRefs = (obj, currentPath = /* @__PURE__ */ new WeakSet(), refs
     value,
     currentPath,
     refs,
-    [...path30, key],
+    [...path31, key],
     currentRefPaths
   );
   const result = Array.isArray(obj) ? obj.map((item, i) => recurse(item, i.toString())) : Object.fromEntries(
@@ -4765,7 +4885,7 @@ var resolveExtensions = (obj) => Object.fromEntries(
 var getAllTags = (schema2) => {
   const rootTags = schema2.tags ?? [];
   const operations = Object.values(schema2.paths ?? {}).flatMap(
-    (path30) => HttpMethods.map((k) => path30?.[k]).filter((op) => op != null)
+    (path31) => HttpMethods.map((k) => path31?.[k]).filter((op) => op != null)
   );
   const operationTags = new Set(operations.flatMap((op) => op.tags ?? []));
   const hasUntaggedOperations = operations.some(
@@ -4820,7 +4940,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(
-    ([path30, value]) => HttpMethods.flatMap((method) => {
+    ([path31, value]) => HttpMethods.flatMap((method) => {
       if (!value?.[method]) return [];
       const operation = value[method];
       const pathParameters = value.parameters ?? [];
@@ -4840,7 +4960,7 @@ var getAllOperations = (paths) => {
       return {
         ...operation,
         method,
-        path: path30,
+        path: path31,
         parameters,
         servers,
         tags: operation.tags ?? []
@@ -5198,8 +5318,8 @@ var Schema = builder.objectRef("Schema").implement({
     }),
     paths: t.field({
       type: [PathItem],
-      resolve: (root) => Object.entries(root.paths ?? {}).map(([path30, value]) => ({
-        path: path30,
+      resolve: (root) => Object.entries(root.paths ?? {}).map(([path31, value]) => ({
+        path: path31,
         // biome-ignore lint/style/noNonNullAssertion: value is guaranteed to be defined
         methods: Object.keys(value)
       }))
@@ -5346,7 +5466,7 @@ init_joinUrl();
 
 // src/vite/api/schema-codegen.ts
 var unescapeJsonPointer = (uri) => decodeURIComponent(uri.replace(/~1/g, "/").replace(/~0/g, "~"));
-var getSegmentsFromPath = (path30) => path30.split("/").slice(1).map(unescapeJsonPointer);
+var getSegmentsFromPath = (path31) => path31.split("/").slice(1).map(unescapeJsonPointer);
 var createLocalRefMap = (obj) => {
   const refMap = /* @__PURE__ */ new Map();
   const siblingsMap = /* @__PURE__ */ new Map();
@@ -5377,16 +5497,16 @@ var replaceMarkers = (code, mergedRefs) => code.replace(/"__refMap:(.*?)"/g, '__
   /"__refMap\+Siblings:(.*?)"/g,
   (_, key) => mergedRefs.get(key) ?? `__refMap["${key}"]`
 );
-var lookup = (schema2, path30, filePath) => {
-  const parts = getSegmentsFromPath(path30);
+var lookup = (schema2, path31, filePath) => {
+  const parts = getSegmentsFromPath(path31);
   let val = schema2;
   for (const part of parts) {
     while (val.$ref?.startsWith("#/")) {
-      val = val.$ref === path30 ? val : lookup(schema2, val.$ref, filePath);
+      val = val.$ref === path31 ? 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: ${path30}`
+        `Error in ${filePath ?? "code generation"}: Could not find path segment ${part} in path: ${path31}`
       );
     }
     val = val[part];
@@ -5631,8 +5751,8 @@ var SchemaManager = class {
       }
     }
   };
-  getLatestSchema = (path30) => this.processedSchemas[path30]?.at(0);
-  getSchemasForPath = (path30) => this.processedSchemas[path30];
+  getLatestSchema = (path31) => this.processedSchemas[path31]?.at(0);
+  getSchemasForPath = (path31) => this.processedSchemas[path31];
   getSchemaImports = () => Object.values(this.processedSchemas).flat().filter((s) => s.importKey);
   getUrlToFilePathMap = () => {
     const map = /* @__PURE__ */ new Map();
@@ -7721,14 +7841,14 @@ async function generateSitemap({
 
 // src/vite/prerender/utils.ts
 init_joinUrl();
-var resolveRoutePath = (path30) => {
-  const segments = path30.split("/");
+var resolveRoutePath = (path31) => {
+  const segments = path31.split("/");
   if (segments.some((s) => s.startsWith(":") && !s.endsWith("?"))) {
     return void 0;
   }
   return segments.filter((s) => !s.startsWith(":")).join("/") || void 0;
 };
-var isSkipped = (path30) => path30.includes("*") || /^\d+$/.test(path30);
+var isSkipped = (path31) => path31.includes("*") || /^\d+$/.test(path31);
 var resolveRoutes = (routes, parentPath = "") => routes.flatMap((route) => {
   if (route.path && isSkipped(route.path)) return [];
   const routePath = route.path ? resolveRoutePath(route.path) : void 0;
@@ -8309,16 +8429,109 @@ var build_default = {
   }
 };
 
+// src/cli/deploy/handler.ts
+import { access, readFile as readFile4 } from "node:fs/promises";
+import path25 from "node:path";
+import { create as createTar } from "tar";
+var DEPLOY_ENDPOINT = "http://localhost:3000/deploy";
+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);
+  await createTar(
+    {
+      cwd: dir,
+      file: archivePath,
+      gzip: true,
+      portable: true
+    },
+    ["dist"]
+  );
+  return archivePath;
+};
+async function deploy(argv) {
+  await build({ ...argv, preview: void 0 });
+  const dir = path25.resolve(process.cwd(), argv.dir);
+  const deploymentToken = argv.deploymentToken?.trim();
+  try {
+    if (!deploymentToken) {
+      throw new Error("A deployment token is required.");
+    }
+    printDiagnosticsToConsole("Creating deployment archive...");
+    const archivePath = await createDeploymentArchive(dir);
+    printDiagnosticsToConsole(`Uploading ${path25.basename(archivePath)}...`);
+    const archiveBuffer = await readFile4(archivePath);
+    const formData = new FormData();
+    formData.append(
+      "file",
+      new Blob([archiveBuffer], { type: "application/gzip" }),
+      path25.basename(archivePath)
+    );
+    formData.append("deploymentToken", deploymentToken);
+    const response = await fetch(DEPLOY_ENDPOINT, {
+      method: "POST",
+      body: formData
+    });
+    const responseText = await response.text();
+    if (!response.ok) {
+      throw new Error(
+        `Deploy failed with ${response.status}: ${JSON.stringify(textOrJson(responseText))}`
+      );
+    }
+    printResultToConsole(`Deployment uploaded to ${DEPLOY_ENDPOINT}`);
+    if (responseText.trim()) {
+      printDiagnosticsToConsole(
+        JSON.stringify(textOrJson(responseText), null, 2)
+      );
+    }
+  } catch (error) {
+    await printCriticalFailureToConsoleAndExit(
+      error instanceof Error ? error.message : String(error)
+    );
+  }
+}
+
+// src/cli/cmds/deploy.ts
+var deploy_default = {
+  desc: "Build, archive, and deploy",
+  command: "deploy [deploymentToken]",
+  builder: (yargs2) => yargs2.positional("deploymentToken", {
+    type: "string",
+    describe: "Deployment token sent to the deploy endpoint"
+  }).option("dir", {
+    type: "string",
+    describe: "The directory containing your project",
+    default: ".",
+    normalize: true,
+    hidden: true
+  }).option("experimental-ssr", {
+    type: "boolean",
+    describe: "Build for server-side rendering (experimental)",
+    default: false
+  }).option("adapter", {
+    type: "string",
+    describe: "SSR adapter (node, cloudflare, vercel)",
+    choices: ["node", "cloudflare", "vercel"],
+    default: "node"
+  }),
+  handler: async (argv) => {
+    process.env.NODE_ENV = "production";
+    await captureEvent({ argv, event: "apitogo deploy" });
+    await deploy(argv);
+  }
+};
+
 // src/cli/dev/handler.ts
 init_joinUrl();
-import path27 from "node:path";
+import path28 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 path26 from "node:path";
+import path27 from "node:path";
 import { createHttpTerminator } from "http-terminator";
 import {
   createServer as createViteServer,
@@ -8351,7 +8564,7 @@ init_loader();
 // src/vite/pagefind-dev-index.ts
 init_invariant();
 init_joinUrl();
-import path25 from "node:path";
+import path26 from "node:path";
 import { createIndex as createIndex2 } from "pagefind";
 import { isRunnableDevEnvironment } from "vite";
 async function* buildPagefindDevIndex(vite, config2) {
@@ -8404,7 +8617,7 @@ async function* buildPagefindDevIndex(vite, config2) {
       path: urlPath
     };
   }
-  const outputPath = path25.join(vite.config.publicDir, "pagefind");
+  const outputPath = path26.join(vite.config.publicDir, "pagefind");
   await pagefindIndex.writeFiles({ outputPath });
   yield { type: "complete", success: true, indexed };
 }
@@ -8423,9 +8636,9 @@ var DevServer = class {
     this.protocol = "https";
     const { dir } = this.options;
     const [key, cert, ca] = await Promise.all([
-      fs3.readFile(path26.resolve(dir, config2.https.key)),
-      fs3.readFile(path26.resolve(dir, config2.https.cert)),
-      config2.https.ca ? fs3.readFile(path26.resolve(dir, config2.https.ca)) : void 0
+      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
     ]);
     return https.createServer({ key, cert, ca });
   }
@@ -8452,7 +8665,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 = path26.posix.join(
+            const entryPath = path27.posix.join(
               server2.config.base,
               "/__z/entry.client.tsx"
             );
@@ -8525,13 +8738,13 @@ var DevServer = class {
       `Server-side rendering ${this.options.ssr ? "enabled" : "disabled"}`
     );
     if (config2.search?.type === "pagefind") {
-      const pagefindPath = path26.join(
+      const pagefindPath = path27.join(
         vite.config.publicDir,
         "pagefind/pagefind.js"
       );
       const exists = await fs3.stat(pagefindPath).catch(() => false);
       if (!exists) {
-        await fs3.mkdir(path26.dirname(pagefindPath), { recursive: true });
+        await fs3.mkdir(path27.dirname(pagefindPath), { recursive: true });
         await fs3.writeFile(pagefindPath, 'throw new Error("NOT_BUILT_YET");');
       }
     }
@@ -8625,7 +8838,7 @@ init_package_json();
 async function dev(argv) {
   const packageJson2 = getZudokuPackageJson();
   process.env.NODE_ENV = "development";
-  const dir = path27.resolve(process.cwd(), argv.dir);
+  const dir = path28.resolve(process.cwd(), argv.dir);
   const server = new DevServer({
     dir,
     argPort: argv.port,
@@ -8707,55 +8920,261 @@ var dev_default = {
   }
 };
 
-// src/cli/deploy/handler.ts
-import { access, readFile as readFile4 } from "node:fs/promises";
-import path28 from "node:path";
-import { create as createTar } from "tar";
-var DEPLOY_ENDPOINT = "http://localhost:3000/deploy";
-var ARCHIVE_NAME = "dist.tgz";
-var createDeploymentArchive = async (dir) => {
-  const distDir = path28.join(dir, "dist");
-  await access(distDir);
-  const archivePath = path28.join(dir, ARCHIVE_NAME);
-  await createTar(
-    {
-      cwd: dir,
-      file: archivePath,
-      gzip: true,
-      portable: true
-    },
-    ["dist"]
+// 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";
+import { glob as glob4 } from "glob";
+var CONFIG_FILENAMES = [
+  "apitogo.config.tsx",
+  "apitogo.config.ts",
+  "apitogo.config.jsx",
+  "apitogo.config.js",
+  "apitogo.config.mjs",
+  "zudoku.config.tsx",
+  "zudoku.config.ts",
+  "zudoku.config.jsx",
+  "zudoku.config.js",
+  "zudoku.config.mjs"
+];
+var createTreeNode = () => ({ docs: [], children: /* @__PURE__ */ new Map() });
+var toPosixPath2 = (value) => value.split(path29.sep).join(path29.posix.sep);
+var toRoutePath = (relativeFile, pagesDir) => {
+  const relativeNoExt = relativeFile.replace(/\.mdx?$/, "");
+  const withoutPagesPrefix = relativeNoExt.replace(
+    new RegExp(`^${pagesDir.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}/?`),
+    ""
   );
-  return archivePath;
+  const normalized = withoutPagesPrefix.replace(/\/index$/, "");
+  return `/${normalized || "index"}`;
 };
-async function deploy(argv) {
-  await build({ ...argv, preview: void 0 });
-  const dir = path28.resolve(process.cwd(), argv.dir);
+var titleCase = (value) => value.split(/[-_\s]+/).filter(Boolean).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ");
+var docSortRank = (docPath) => {
+  const lastSegment = docPath.split("/").at(-1) ?? docPath;
+  if (lastSegment === "introduction") return 0;
+  if (lastSegment === "getting-started") return 1;
+  if (lastSegment === "index") return 2;
+  return 3;
+};
+var sortDocPaths = (docPaths) => [...docPaths].sort((a, b) => {
+  const rankDiff = docSortRank(a) - docSortRank(b);
+  if (rankDiff !== 0) return rankDiff;
+  return a.localeCompare(b);
+});
+var sortDirectoryNames = (names) => [...names].sort((a, b) => a.localeCompare(b));
+var buildTree = (routePaths) => {
+  const root = createTreeNode();
+  for (const routePath of routePaths) {
+    const segments = routePath.replace(/^\//, "").split("/").filter(Boolean);
+    const directorySegments = segments.slice(0, -1);
+    let current = root;
+    for (const segment of directorySegments) {
+      let child = current.children.get(segment);
+      if (!child) {
+        child = createTreeNode();
+        current.children.set(segment, child);
+      }
+      current = child;
+    }
+    current.docs.push(routePath);
+  }
+  return root;
+};
+var treeToNavigationItems = (node) => {
+  const docs = sortDocPaths(node.docs);
+  const categories = sortDirectoryNames([...node.children.keys()]).map((directoryName) => {
+    const childNode = node.children.get(directoryName);
+    if (!childNode) {
+      throw new Error(`Missing child node for directory '${directoryName}'.`);
+    }
+    return {
+      type: "category",
+      label: titleCase(directoryName),
+      items: treeToNavigationItems(childNode)
+    };
+  });
+  return [...docs, ...categories];
+};
+var formatNavigationItem = (item, indentLevel) => {
+  const indent = "  ".repeat(indentLevel);
+  if (typeof item === "string") {
+    return `${indent}"${item}"`;
+  }
+  const items = item.items.map((subItem) => formatNavigationItem(subItem, indentLevel + 2));
+  return [
+    `${indent}{`,
+    `${indent}  type: "category",`,
+    `${indent}  label: "${item.label}",`,
+    `${indent}  items: [`,
+    items.join(",\n"),
+    `${indent}  ],`,
+    `${indent}}`
+  ].join("\n");
+};
+var buildNavigationCode = (items) => {
+  const docsItems = items.map((item) => formatNavigationItem(item, 3));
+  const documentationItems = [
+    ...docsItems,
+    [
+      "      {",
+      '        type: "category",',
+      '        label: "Useful Links",',
+      "        collapsible: false,",
+      '        icon: "link",',
+      "        items: [",
+      "          {",
+      '            type: "link",',
+      '            icon: "book",',
+      '            label: "APIToGo",',
+      '            to: "https://apitogo.com",',
+      "          },",
+      "        ],",
+      "      },"
+    ].join("\n")
+  ];
+  return [
+    "[",
+    "  {",
+    '    type: "category",',
+    '    label: "Documentation",',
+    "    items: [",
+    documentationItems.join(",\n"),
+    "    ],",
+    "  },",
+    "  {",
+    '    type: "link",',
+    '    to: "/api",',
+    '    label: "API Reference",',
+    "  },",
+    "]"
+  ].join("\n");
+};
+var buildRedirectsCode = (firstDocPath) => `[{ from: "/", to: "${firstDocPath}" }]`;
+var findMatchingBracket = (source, startIndex) => {
+  let depth = 0;
+  let inSingleQuote = false;
+  let inDoubleQuote = false;
+  let inTemplate = false;
+  let inLineComment = false;
+  let inBlockComment = false;
+  for (let index = startIndex; index < source.length; index++) {
+    const char = source[index];
+    const next = source[index + 1];
+    const prev = source[index - 1];
+    if (inLineComment) {
+      if (char === "\n") inLineComment = false;
+      continue;
+    }
+    if (inBlockComment) {
+      if (prev === "*" && char === "/") inBlockComment = false;
+      continue;
+    }
+    if (!inSingleQuote && !inDoubleQuote && !inTemplate) {
+      if (char === "/" && next === "/") {
+        inLineComment = true;
+        index++;
+        continue;
+      }
+      if (char === "/" && next === "*") {
+        inBlockComment = true;
+        index++;
+        continue;
+      }
+    }
+    if (!inDoubleQuote && !inTemplate && char === "'" && prev !== "\\") {
+      inSingleQuote = !inSingleQuote;
+      continue;
+    }
+    if (!inSingleQuote && !inTemplate && char === '"' && prev !== "\\") {
+      inDoubleQuote = !inDoubleQuote;
+      continue;
+    }
+    if (!inSingleQuote && !inDoubleQuote && char === "`" && prev !== "\\") {
+      inTemplate = !inTemplate;
+      continue;
+    }
+    if (inSingleQuote || inDoubleQuote || inTemplate) continue;
+    if (char === "[") depth++;
+    if (char === "]") depth--;
+    if (depth === 0) return index;
+  }
+  throw new Error("Could not find matching closing bracket.");
+};
+var replaceArrayProperty = (source, propertyName, replacement) => {
+  const propertyIndex = source.indexOf(`${propertyName}:`);
+  if (propertyIndex === -1) {
+    throw new Error(`Could not find '${propertyName}' in config file.`);
+  }
+  const arrayStart = source.indexOf("[", propertyIndex);
+  if (arrayStart === -1) {
+    throw new Error(`Could not find array start for '${propertyName}'.`);
+  }
+  const arrayEnd = findMatchingBracket(source, arrayStart);
+  return `${source.slice(0, arrayStart)}${replacement}${source.slice(arrayEnd + 1)}`;
+};
+var findConfigPath = async (dir) => {
+  for (const filename of CONFIG_FILENAMES) {
+    const fullPath = path29.join(dir, filename);
+    try {
+      await readFile5(fullPath, "utf8");
+      return fullPath;
+    } catch {
+    }
+  }
+  throw new Error("No APIToGo config file found in the project root.");
+};
+async function syncConfig(argv) {
+  const dir = path29.resolve(process.cwd(), argv.dir);
+  const pagesDir = toPosixPath2(argv.pagesDir.replace(/^[./]+/, "").replace(/\/+$/, ""));
   try {
-    printDiagnosticsToConsole("Creating deployment archive...");
-    const archivePath = await createDeploymentArchive(dir);
-    printDiagnosticsToConsole(`Uploading ${path28.basename(archivePath)}...`);
-    const archiveBuffer = await readFile4(archivePath);
-    const formData = new FormData();
-    formData.append(
-      "file",
-      new Blob([archiveBuffer], { type: "application/gzip" }),
-      path28.basename(archivePath)
-    );
-    const response = await fetch(DEPLOY_ENDPOINT, {
-      method: "POST",
-      body: formData
+    const configPath = await findConfigPath(dir);
+    const pageFiles = await glob4(`${pagesDir}/**/*.{md,mdx}`, {
+      cwd: dir,
+      ignore: ["**/node_modules/**", "**/.git/**", "**/dist/**"],
+      posix: true
     });
-    const responseText = await response.text();
-    if (!response.ok) {
-      throw new Error(
-        `Deploy failed with ${response.status}: ${JSON.stringify(textOrJson(responseText))}`
-      );
-    }
-    printResultToConsole(`Deployment uploaded to ${DEPLOY_ENDPOINT}`);
-    if (responseText.trim()) {
-      printDiagnosticsToConsole(JSON.stringify(textOrJson(responseText), null, 2));
+    const routePaths = sortDocPaths(
+      pageFiles.map((file) => toRoutePath(file, pagesDir))
+    );
+    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");
+    const withNavigation = replaceArrayProperty(
+      originalConfig,
+      "navigation",
+      buildNavigationCode(navigationItems)
+    );
+    const withRedirects = replaceArrayProperty(
+      withNavigation,
+      "redirects",
+      buildRedirectsCode(routePaths[0])
+    );
+    await writeFile6(configPath, withRedirects, "utf8");
+    printResultToConsole(`Updated ${path29.basename(configPath)} from ${pagesDir}/`);
   } catch (error) {
     await printCriticalFailureToConsoleAndExit(
       error instanceof Error ? error.message : String(error)
@@ -8763,58 +9182,30 @@ async function deploy(argv) {
   }
 }
 
-// src/cli/cmds/deploy.ts
-var deploy_default = {
-  desc: "Build, archive, and deploy",
-  command: "deploy",
+// src/cli/cmds/sync-config.ts
+var sync_config_default = {
+  desc: "Regenerate navigation from the pages folder",
+  command: "sync-config",
   builder: (yargs2) => yargs2.option("dir", {
     type: "string",
     describe: "The directory containing your project",
     default: ".",
     normalize: true,
     hidden: true
-  }).option("experimental-ssr", {
-    type: "boolean",
-    describe: "Build for server-side rendering (experimental)",
-    default: false
-  }).option("adapter", {
+  }).option("pages-dir", {
     type: "string",
-    describe: "SSR adapter (node, cloudflare, vercel)",
-    choices: ["node", "cloudflare", "vercel"],
-    default: "node"
+    describe: "Directory to scan for md/mdx pages",
+    default: "pages"
   }),
   handler: async (argv) => {
-    process.env.NODE_ENV = "production";
-    await captureEvent({ argv, event: "apitogo deploy" });
-    await deploy(argv);
+    await captureEvent({ argv, event: "apitogo sync-config" });
+    await syncConfig(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 readFile5, writeFile as writeFile6 } from "node:fs/promises";
+import { readFile as readFile6, writeFile as writeFile7 } from "node:fs/promises";
 import { join } from "node:path";
 import colors10 from "picocolors";
 import { gt } from "semver";
@@ -8864,12 +9255,12 @@ function box(message, {
 
 // src/cli/common/xdg/lib.ts
 import { homedir } from "node:os";
-import path29 from "node:path";
+import path30 from "node:path";
 function defineDirectoryWithFallback(xdgName, fallback) {
   if (process.env[xdgName]) {
     return process.env[xdgName];
   } else {
-    return path29.join(homedir(), fallback);
+    return path30.join(homedir(), fallback);
   }
 }
 var XDG_CONFIG_HOME = defineDirectoryWithFallback(
@@ -8884,15 +9275,15 @@ var XDG_STATE_HOME = defineDirectoryWithFallback(
   "XDG_DATA_HOME",
   ".local/state"
 );
-var ZUDOKU_XDG_CONFIG_HOME = path29.join(
+var ZUDOKU_XDG_CONFIG_HOME = path30.join(
   XDG_CONFIG_HOME,
   CLI_XDG_FOLDER_NAME
 );
-var ZUDOKU_XDG_DATA_HOME = path29.join(
+var ZUDOKU_XDG_DATA_HOME = path30.join(
   XDG_DATA_HOME,
   CLI_XDG_FOLDER_NAME
 );
-var ZUDOKU_XDG_STATE_HOME = path29.join(
+var ZUDOKU_XDG_STATE_HOME = path30.join(
   XDG_STATE_HOME,
   CLI_XDG_FOLDER_NAME
 );
@@ -8941,7 +9332,7 @@ async function getVersionCheckInfo() {
   let versionCheckInfo;
   if (existsSync2(versionCheckPath)) {
     try {
-      versionCheckInfo = await readFile5(versionCheckPath, "utf-8").then(
+      versionCheckInfo = await readFile6(versionCheckPath, "utf-8").then(
         JSON.parse
       );
     } catch {
@@ -8966,7 +9357,7 @@ async function getVersionCheckInfo() {
       lastCheck: Date.now(),
       latestVersion
     };
-    await writeFile6(
+    await writeFile7(
       versionCheckPath,
       JSON.stringify(versionCheckInfo),
       "utf-8"
@@ -9046,7 +9437,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).demandCommand().strictCommands().version(packageJson?.version).fail(false).help();
+}).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();
 try {
   void warnIfOutdatedVersion(packageJson?.version);
   await cli.argv;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lukoweb/apitogo",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "type": "module",
   "sideEffects": [
     "**/*.css",
@@ -252,9 +252,9 @@
     "shiki": "3.23.0",
     "sitemap": "9.0.1",
     "strip-ansi": "7.2.0",
+    "tar": "7.5.10",
     "tailwind-merge": "3.5.0",
     "tailwindcss": "4.2.1",
-    "tar": "7.5.10",
     "tw-animate-css": "1.4.0",
     "unified": "11.0.5",
     "unist-util-visit": "5.1.0",