@scalar/cli 1.9.9 → 2.0.0

package/index.js

@@ -6890,14 +6890,14 @@ var require_parser = __commonJS({
             case "scalar":
             case "single-quoted-scalar":
             case "double-quoted-scalar": {
-              const fs21 = this.flowScalar(this.type);
+              const fs22 = this.flowScalar(this.type);
               if (atNextItem || it.value) {
-                map2.items.push({ start, key: fs21, sep: [] });
+                map2.items.push({ start, key: fs22, sep: [] });
                 this.onKeyLine = true;
               } else if (it.sep) {
-                this.stack.push(fs21);
+                this.stack.push(fs22);
               } else {
-                Object.assign(it, { key: fs21, sep: [] });
+                Object.assign(it, { key: fs22, sep: [] });
                 this.onKeyLine = true;
               }
               return;
@@ -7025,13 +7025,13 @@ var require_parser = __commonJS({
             case "scalar":
             case "single-quoted-scalar":
             case "double-quoted-scalar": {
-              const fs21 = this.flowScalar(this.type);
+              const fs22 = this.flowScalar(this.type);
               if (!it || it.value)
-                fc.items.push({ start: [], key: fs21, sep: [] });
+                fc.items.push({ start: [], key: fs22, sep: [] });
               else if (it.sep)
-                this.stack.push(fs21);
+                this.stack.push(fs22);
               else
-                Object.assign(it, { key: fs21, sep: [] });
+                Object.assign(it, { key: fs22, sep: [] });
               return;
             }
             case "flow-map-end":
@@ -11822,7 +11822,7 @@ var require_parse2 = __commonJS({
 var require_gray_matter = __commonJS({
   "../../node_modules/.pnpm/gray-matter@4.0.3/node_modules/gray-matter/index.js"(exports2, module2) {
     "use strict";
-    var fs21 = __require("fs");
+    var fs22 = __require("fs");
     var sections = require_section_matter();
     var defaults = require_defaults();
     var stringify = require_stringify3();
@@ -11906,7 +11906,7 @@ var require_gray_matter = __commonJS({
       return stringify(file2, data, options2);
     };
     matter2.read = function(filepath, options2) {
-      const str2 = fs21.readFileSync(filepath, "utf8");
+      const str2 = fs22.readFileSync(filepath, "utf8");
       const file2 = matter2(str2, options2);
       file2.path = filepath;
       return file2;
@@ -69163,18 +69163,18 @@ Visit https://nodejs.org to download the latest version.`
 }
 
 // src/program.ts
-import { Command as Command50 } from "commander";
+import { Command as Command51 } from "commander";
 
 // package.json
 var name = "@scalar/cli";
-var version = "1.9.9";
+var version = "2.0.0";
 var bin = {
   scalar: "./dist/index.js",
   "scalar-cli": "./dist/index.js"
 };
 
 // src/domains/schema/index.ts
-import { Command as Command6 } from "commander";
+import { Command as Command7 } from "commander";
 
 // src/domains/schema/delete.ts
 import { select } from "@clack/prompts";
@@ -86697,6 +86697,9 @@ var siteDeploySchema = entitySchema.extend({
   projectUid: nanoidSchema,
   subpaths: subpathSchema.array().default([])
 }).meta({ id: "site-deploy" });
+var searchConfigResponseSchema = external_exports.object({
+  subpaths: subpathSchema.array()
+}).meta({ id: "search-config-response" });
 
 // ../../packages/entities/dist/login-portals/customization.js
 var loginPortalEmailSchema = external_exports.object({
@@ -87724,11 +87727,22 @@ var docsProjectRepositorySchema = external_exports.discriminatedUnion("provider"
   githubRepositorySchema,
   bitbucketRepositorySchema
 ]);
+var remoteActivitySchema = external_exports.object({
+  at: timestampSchema,
+  branch: external_exports.string().nullable(),
+  sha: external_exports.string().nullable(),
+  actorName: external_exports.string().nullable()
+}).meta({ id: "docs-project-remote-activity" });
 var docsProjectSchema = sharedProjectSchema.extend({
   slug: slugSchema,
   publishStatus: external_exports.string().default(""),
   publishMessage: external_exports.string().default(""),
-  repository: docsProjectRepositorySchema
+  repository: docsProjectRepositorySchema,
+  /**
+   * `.catch(undefined)` so a malformed bump degrades to "no signal" instead
+   * of failing the schema parse inside every subscribed dashboard.
+   */
+  remoteActivity: remoteActivitySchema.optional().catch(void 0)
 }).meta({ id: "docs-project" });
 function isGithubBackedDocsProject(project) {
   return project.repository.provider === "github";
@@ -87785,13 +87799,13 @@ var signupDataSchema = external_exports.object({
   yjsReferences: external_exports.record(external_exports.string(), external_exports.string())
 }).meta({ id: "signup-data" });
 
+// ../../packages/entities/dist/sdk/helpers.js
+import semver3 from "semver";
+
 // ../../packages/entities/dist/sdk/scalar-config.js
 var import_yaml = __toESM(require_dist(), 1);
 import semver4 from "semver";
 
-// ../../packages/entities/dist/sdk/helpers.js
-import semver3 from "semver";
-
 // ../../packages/entities/dist/sdk/schema.js
 var SdkLanguage;
 (function(SdkLanguage2) {
@@ -88157,7 +88171,8 @@ var billingInfoSchema = external_exports.preprocess((arg) => {
   billingId: nanoidSchema.optional(),
   email: emailSchema,
   plan: billingPlanSchema,
-  expires: external_exports.number().optional()
+  expires: external_exports.number().optional(),
+  sdkTrialReminderSentAt: external_exports.number().optional()
 })).meta({ id: "billing-info" });
 var invoiceStatusSchema = external_exports.enum(["open", "paid", "draft", "void", "uncollectible"]).meta({ id: "invoice-status" });
 var billingInvoiceSchema = external_exports.object({
@@ -89493,6 +89508,16 @@ function sdksApiFactory(requestService) {
       schema: external_exports.unknown()
     });
   }
+  async function transformConfig(data) {
+    return await requestService.request({
+      url: "sdk-generator/transform-config",
+      method: "post",
+      data,
+      schema: external_exports.object({
+        config: external_exports.string().nullable()
+      })
+    });
+  }
   async function del(uid) {
     return await requestService.request({
       url: `core/v1/sdks/${uid}`,
@@ -89594,6 +89619,7 @@ function sdksApiFactory(requestService) {
     fromConfig,
     createVersion,
     previewCodeSamples,
+    transformConfig,
     update,
     delete: del,
     discardDraft,
@@ -89792,12 +89818,13 @@ function formatApiResponse(data, status, headers) {
     error: false
   };
 }
-function formatApiError(message, status, error48 = null) {
+function formatApiError(message, status, error48 = null, code) {
   return {
     status,
     message,
     error: true,
-    originalError: error48
+    originalError: error48,
+    code
   };
 }
 function requestServiceFactory(baseUrl, getAuthToken) {
@@ -89832,8 +89859,10 @@ function requestServiceFactory(baseUrl, getAuthToken) {
     }).then(async (response) => {
       const isJson = response.headers.get("content-type")?.includes("application/json");
       if (!response.ok) {
-        const message = isJson ? String((await response.json().catch(() => ({ message: "Invalid response" }))).message) || "Unknown Error" : await response.text().catch(() => "Invalid response");
-        return formatApiError(message, response.status);
+        const body = isJson ? await response.json().catch(() => ({ message: "Invalid response" })) : { message: await response.text().catch(() => "Invalid response") };
+        const message = String(body.message ?? "") || "Unknown Error";
+        const code = typeof body.code === "string" ? body.code : void 0;
+        return formatApiError(message, response.status, null, code);
       }
       if (stream2)
         return response.body ?? new ReadableStream();
@@ -90730,13 +90759,14 @@ function publishApiFactory(requestService) {
       })
     });
   }
-  async function unpublish(projectUid, githubProjectUid) {
+  async function unpublish(projectUid, githubProjectUid, unifiedProjectUid) {
     return await requestService.request({
       url: "core/unpublish",
       method: "delete",
       data: {
         projectUid,
-        githubProjectUid
+        githubProjectUid,
+        unifiedProjectUid
       },
       schema: external_exports.null()
     });
@@ -91258,7 +91288,7 @@ var config2 = {
     }
   },
   cdnUrl: process.env.CDN_URL ?? "https://cdn.scalar.com",
-  ssgDocsIsolateVersion: process.env.SSG_DOCS_ISOLATE_VERSION ?? "1.4.4"
+  ssgDocsIsolateVersion: process.env.SSG_DOCS_ISOLATE_VERSION ?? "1.4.5"
 };
 
 // src/domains/auth/login/helpers/personal-token-generate-access.ts
@@ -91890,71 +91920,9 @@ var DeleteSchemaCommand = () => {
   return cmd2;
 };
 
-// src/domains/schema/list.ts
-import as2 from "ansis";
+// src/domains/schema/get.ts
+import fs3 from "node:fs/promises";
 import { Command as Command2 } from "commander";
-var ListSchemaCommand = () => {
-  const cmd2 = new Command2("list");
-  cmd2.description("List all schemas for a team namespace");
-  cmd2.option("--namespace <namespace>", "Team namespace");
-  cmd2.action(async (args) => {
-    const { error: error48, data } = external_exports.object({
-      namespace: namespaceSchema.optional()
-    }).safeParse({
-      namespace: args.namespace
-    });
-    if (error48)
-      return output.error().title("Invalid input").message(error48.issues[0].message).exit("error");
-    const auth = await getAuthData();
-    auth.addEventListener((state) => Object.assign(auth, state));
-    const client = await getDatabaseClient();
-    const team = await client.getOne({
-      collectionPath: BaseCollections.Teams,
-      query: {
-        uid: auth.teamUid
-      },
-      schema: teamSchema
-    });
-    if (team.error)
-      return output.error().title("An error occurred when fetching your team.").message(team.message).exit("error");
-    const namespace = data.namespace || team.data.namespaces.at(0);
-    if (!namespace) {
-      return output.error().title("Missing namespace").message(
-        "Could not find a valid namespace for your API. Please specify a namespace or contact support."
-      ).exit("error");
-    }
-    const apiClient = await apiService();
-    const schemas = await apiClient.managedSchemas.getSchemas(namespace);
-    if (schemas.error)
-      return output.error().title(schemas.message).exit("error");
-    output.info().table(
-      [
-        [
-          as2.underline.bold("Slug"),
-          as2.underline.bold("Title"),
-          as2.underline.bold("Version")
-        ],
-        ...schemas.data.map((schema) => {
-          return [
-            as2.blue(schema.slug),
-            as2.blue(schema.title),
-            schema.isPrivate ? as2.green("Private") : as2.yellow("Public")
-          ];
-        })
-      ],
-      { padding: 2 }
-    ).print();
-  });
-  return cmd2;
-};
-
-// src/domains/schema/publish.ts
-import { text } from "@clack/prompts";
-import as6 from "ansis";
-import { Command as Command4 } from "commander";
-import { bundle as bundle2 } from "@scalar/json-magic/bundle";
-import { fetchUrls as fetchUrls2, readFiles as readFiles2 } from "@scalar/json-magic/bundle/plugins/node";
-import { parseJsonOrYaml } from "@scalar/oas-utils/helpers";
 
 // ../../packages/urls/dist/publish/full.js
 function getPublishUrl(domain2, subpath) {
@@ -92047,14 +92015,184 @@ function registry2(teamNamespace) {
   };
 }
 
+// src/domains/registry/helpers/links.ts
+function registryUrl(path13) {
+  return `${config2.projects.registry}/${path13}`;
+}
+function dashboardUrl(asset, uid) {
+  return `${config2.projects.dashboard}/registry/${asset}/${uid}`;
+}
+
+// src/domains/registry/helpers/fetch.ts
+async function fetchFromRegistry(path13, accessToken) {
+  let response;
+  try {
+    response = await fetch(registryUrl(path13), {
+      headers: {
+        "x-scalar-auth": accessToken
+      },
+      // Should always error on redirect
+      redirect: "error"
+    });
+  } catch (error48) {
+    return {
+      error: true,
+      message: error48 instanceof Error && error48.message.length > 0 ? error48.message : "Registry request failed before a response was received."
+    };
+  }
+  if (!response.ok) {
+    const message = await response.text();
+    return {
+      error: true,
+      message: message.length ? message : `Registry request failed with status ${response.status}.`
+    };
+  }
+  return {
+    error: false,
+    data: await response.text()
+  };
+}
+
+// src/domains/schema/get.ts
+var versionSchema3 = external_exports.union([docVersionSchema, external_exports.literal("latest")]);
+var GetSchemaCommand = () => {
+  const cmd2 = new Command2("get");
+  cmd2.description("Get a schema document version from the Scalar registry");
+  cmd2.argument("[namespace]", "Team namespace");
+  cmd2.argument("[slug]", "Schema slug");
+  cmd2.option("--version <version>", "Schema version (defaults to latest)");
+  cmd2.option("--format <format>", "Output format (json or yaml)", "json");
+  cmd2.option("-o, --output <file>", "Output file (defaults to stdout)");
+  cmd2.action(async (namespace, slug, args) => {
+    if (!namespace) {
+      output.error().title("Invalid input").message("Please provide namespace of the schema").exit("error");
+      return;
+    }
+    if (!slug) {
+      output.error().title("Invalid input").message("Please provide slug of the schema").exit("error");
+      return;
+    }
+    const result = external_exports.object({
+      version: versionSchema3,
+      format: external_exports.enum(["json", "yaml"]),
+      output: external_exports.string().min(1).optional()
+    }).safeParse({
+      version: args.version ?? "latest",
+      format: args.format,
+      output: args.output
+    });
+    if (result.error) {
+      output.error().title("Invalid input").message(result.error.issues[0].message).exit("error");
+      return;
+    }
+    const auth = await getAuthData();
+    auth.addEventListener((state) => Object.assign(auth, state));
+    const fetchResult = await fetchFromRegistry(
+      registry2(namespace).schemas(slug).url({
+        version: result.data.version,
+        format: result.data.format
+      }),
+      auth.accessToken
+    );
+    if (fetchResult.error) {
+      output.error().title("Unable to download schema").message(fetchResult.message).exit("error");
+      return;
+    }
+    const document2 = fetchResult.data;
+    const withTrailingNewline = document2.endsWith("\n") ? document2 : `${document2}
+`;
+    if (result.data.output) {
+      try {
+        await fs3.writeFile(result.data.output, withTrailingNewline, "utf8");
+      } catch (error48) {
+        const message = error48 instanceof Error && error48.message.length > 0 ? error48.message : `Could not write to ${result.data.output}.`;
+        output.error().title("Unable to write schema to file").message(message).exit("error");
+        return;
+      }
+      output.info().line(
+        `Downloaded ${namespace}/${slug}@${result.data.version} (${result.data.format})`
+      ).line(`Written to ${result.data.output}`).print();
+      return;
+    }
+    process.stdout.write(withTrailingNewline);
+  });
+  return cmd2;
+};
+
+// src/domains/schema/list.ts
+import as2 from "ansis";
+import { Command as Command3 } from "commander";
+var ListSchemaCommand = () => {
+  const cmd2 = new Command3("list");
+  cmd2.description("List all schemas for a team namespace");
+  cmd2.option("--namespace <namespace>", "Team namespace");
+  cmd2.action(async (args) => {
+    const { error: error48, data } = external_exports.object({
+      namespace: namespaceSchema.optional()
+    }).safeParse({
+      namespace: args.namespace
+    });
+    if (error48)
+      return output.error().title("Invalid input").message(error48.issues[0].message).exit("error");
+    const auth = await getAuthData();
+    auth.addEventListener((state) => Object.assign(auth, state));
+    const client = await getDatabaseClient();
+    const team = await client.getOne({
+      collectionPath: BaseCollections.Teams,
+      query: {
+        uid: auth.teamUid
+      },
+      schema: teamSchema
+    });
+    if (team.error)
+      return output.error().title("An error occurred when fetching your team.").message(team.message).exit("error");
+    const namespace = data.namespace || team.data.namespaces.at(0);
+    if (!namespace) {
+      return output.error().title("Missing namespace").message(
+        "Could not find a valid namespace for your API. Please specify a namespace or contact support."
+      ).exit("error");
+    }
+    const apiClient = await apiService();
+    const schemas = await apiClient.managedSchemas.getSchemas(namespace);
+    if (schemas.error)
+      return output.error().title(schemas.message).exit("error");
+    output.info().table(
+      [
+        [
+          as2.underline.bold("Slug"),
+          as2.underline.bold("Title"),
+          as2.underline.bold("Version")
+        ],
+        ...schemas.data.map((schema) => {
+          return [
+            as2.blue(schema.slug),
+            as2.blue(schema.title),
+            schema.isPrivate ? as2.green("Private") : as2.yellow("Public")
+          ];
+        })
+      ],
+      { padding: 2 }
+    ).print();
+  });
+  return cmd2;
+};
+
+// src/domains/schema/publish.ts
+import { text } from "@clack/prompts";
+import as6 from "ansis";
+import { Command as Command5 } from "commander";
+import { bundle as bundle2 } from "@scalar/json-magic/bundle";
+import { fetchUrls as fetchUrls2, readFiles as readFiles2 } from "@scalar/json-magic/bundle/plugins/node";
+import { parseJsonOrYaml } from "@scalar/oas-utils/helpers";
+
 // src/domains/document/bundle/index.ts
 var import_yaml2 = __toESM(require_dist(), 1);
-import fs4 from "node:fs/promises";
+import fs5 from "node:fs/promises";
 import path3 from "node:path";
 import { cwd } from "node:process";
 import { confirm } from "@clack/prompts";
 import as5 from "ansis";
-import { Command as Command3 } from "commander";
+import { Command as Command4 } from "commander";
 import { bundle } from "@scalar/json-magic/bundle";
 import { fetchUrls, readFiles } from "@scalar/json-magic/bundle/plugins/node";
 
@@ -92076,7 +92214,7 @@ var printSpecificationBanner = (result) => {
 };
 
 // src/domains/document/helpers/imports.ts
-import fs3 from "node:fs";
+import fs4 from "node:fs";
 import as4 from "ansis";
 import { load, validate } from "@scalar/openapi-parser";
 var getFileOrUrl = async (input) => {
@@ -92087,10 +92225,10 @@ var getFileOrUrl = async (input) => {
     }
     return await response.text();
   }
-  if (!fs3.existsSync(input)) {
+  if (!fs4.existsSync(input)) {
     return output.error().title("Could not read file.").exit("error");
   }
-  return fs3.readFileSync(input, "utf-8");
+  return fs4.readFileSync(input, "utf-8");
 };
 var loadOpenApiFile = async (input) => {
   const specification = await getFileOrUrl(input);
@@ -92137,7 +92275,7 @@ async function measureTime(fn) {
 // src/domains/document/bundle/index.ts
 var DEFAULT_FETCH_CONCURRENCY = 5;
 function BundleCommand() {
-  const cmd2 = new Command3("bundle");
+  const cmd2 = new Command4("bundle");
   cmd2.description(
     "Bundle an OpenAPI specification by resolving all references and external dependencies"
   );
@@ -92192,7 +92330,7 @@ function BundleCommand() {
           urlMap: !!urlMap
         })
       );
-      await fs4.writeFile(
+      await fs5.writeFile(
         outputFilePath ?? input,
         isYaml ? import_yaml2.default.stringify(result) : JSON.stringify(result),
         "utf8"
@@ -92205,17 +92343,9 @@ function BundleCommand() {
   return cmd2;
 }
 
-// src/domains/registry/helpers/links.ts
-function registryUrl(path13) {
-  return `${config2.projects.registry}/${path13}`;
-}
-function dashboardUrl(asset, uid) {
-  return `${config2.projects.dashboard}/registry/${asset}/${uid}`;
-}
-
 // src/domains/schema/publish.ts
 var PublishSchemaCommand = () => {
-  const cmd2 = new Command4("publish");
+  const cmd2 = new Command5("publish");
   cmd2.description("Publish a shared schema to the Scalar registry");
   cmd2.argument("[file]", "OpenAPI file to upload");
   cmd2.option(
@@ -92306,7 +92436,9 @@ var PublishSchemaCommand = () => {
     const matchingSchema = namespaceSchemaRes.data.find(
       (schema2) => schema2.slug === slug
     );
-    const title = matchingSchema || data.title ? data.title : (await text({
+    const documentTitle = result?.info?.title;
+    const providedTitle = data.title ?? documentTitle;
+    const title = matchingSchema || providedTitle ? providedTitle : (await text({
       message: "Please provide a title for your schema",
       validate(value) {
         if (value.length === 0) return "Title is required.";
@@ -92361,9 +92493,9 @@ var PublishSchemaCommand = () => {
 
 // src/domains/schema/update.ts
 import { select as select2 } from "@clack/prompts";
-import { Command as Command5 } from "commander";
+import { Command as Command6 } from "commander";
 var UpdateSchemaCommand = () => {
-  const cmd2 = new Command5("update");
+  const cmd2 = new Command6("update");
   cmd2.description("Update schema metadata.");
   cmd2.option("-s, --slug <slug>", "Schema slug");
   cmd2.option("-n, --namespace <namespace>", "Team namespace");
@@ -92431,21 +92563,22 @@ var schemaCommands = [
   DeleteSchemaCommand,
   UpdateSchemaCommand,
   ListSchemaCommand,
+  GetSchemaCommand,
   PublishSchemaCommand
 ];
-var schemaDomain = new Command6("schema");
+var schemaDomain = new Command7("schema");
 schemaDomain.description("Manage your Scalar schemas");
-schemaCommands.forEach((command) => schemaDomain.addCommand(command()));
+schemaCommands.forEach((command) => void schemaDomain.addCommand(command()));
 var schema_default = schemaDomain;
 
 // src/domains/sdk/index.ts
-import { Command as Command12 } from "commander";
+import { Command as Command13 } from "commander";
 
 // src/domains/sdk/build.ts
 import { select as select3 } from "@clack/prompts";
-import { Command as Command7 } from "commander";
+import { Command as Command8 } from "commander";
 var BuildSdkCommand = () => {
-  const cmd2 = new Command7("build");
+  const cmd2 = new Command8("build");
   cmd2.description("Create an SDK build.");
   cmd2.option("-s, --slug <slug>", "SDK slug");
   cmd2.option("-n, --namespace <namespace>", "Team namespace");
@@ -92518,9 +92651,9 @@ var BuildSdkCommand = () => {
 // src/domains/sdk/create.ts
 import { select as select4, text as text2 } from "@clack/prompts";
 import as7 from "ansis";
-import { Command as Command8, Option } from "commander";
+import { Command as Command9, Option } from "commander";
 var CreateSdkCommand = () => {
-  const cmd2 = new Command8("create");
+  const cmd2 = new Command9("create");
   cmd2.description("Create a new SDK.");
   cmd2.option("-a, --api <api>", "Registry API slug");
   cmd2.option("-n, --namespace <namespace>", "Team namespace");
@@ -92596,9 +92729,9 @@ var CreateSdkCommand = () => {
 
 // src/domains/sdk/delete.ts
 import { select as select5 } from "@clack/prompts";
-import { Command as Command9 } from "commander";
+import { Command as Command10 } from "commander";
 var DeleteSdkCommand = () => {
-  const cmd2 = new Command9("delete");
+  const cmd2 = new Command10("delete");
   cmd2.description("Delete an SDK.");
   cmd2.option("-s, --slug <slug>", "SDK slug");
   cmd2.option("-n, --namespace <namespace>", "Team namespace");
@@ -92658,9 +92791,9 @@ var DeleteSdkCommand = () => {
 
 // src/domains/sdk/update.ts
 import { select as select6 } from "@clack/prompts";
-import { Command as Command10 } from "commander";
+import { Command as Command11 } from "commander";
 var UpdateSdkCommand = () => {
-  const cmd2 = new Command10("update");
+  const cmd2 = new Command11("update");
   cmd2.description("Update SDK metadata.");
   cmd2.option("-s, --slug <slug>", "SDK slug");
   cmd2.option("-n, --namespace <namespace>", "Team namespace");
@@ -92727,9 +92860,9 @@ var UpdateSdkCommand = () => {
 
 // src/domains/sdk/list.ts
 import as8 from "ansis";
-import { Command as Command11 } from "commander";
+import { Command as Command12 } from "commander";
 var ListSdkCommand = () => {
-  const cmd2 = new Command11("list");
+  const cmd2 = new Command12("list");
   cmd2.description("List all SDKs for a team namespace");
   cmd2.option("--namespace <namespace>", "Team namespace");
   cmd2.action(async (args) => {
@@ -92797,17 +92930,17 @@ var sdkCommands = [
   DeleteSdkCommand,
   BuildSdkCommand
 ];
-var sdkDomain = new Command12("sdk");
+var sdkDomain = new Command13("sdk");
 sdkDomain.description("Manage your Scalar SDKs (Enterprise Only)");
 sdkCommands.forEach((command) => sdkDomain.addCommand(command()));
 var sdk_default = sdkDomain;
 
 // src/domains/auth/index.ts
-import { Command as Command16 } from "commander";
+import { Command as Command17 } from "commander";
 
 // src/domains/auth/login/index.ts
 import as10 from "ansis";
-import { Command as Command13 } from "commander";
+import { Command as Command14 } from "commander";
 
 // ../../packages/mongobase-client/dist/auth/node/exchange-callback-server.js
 import getPort from "get-port";
@@ -92951,7 +93084,7 @@ var emailPasswordAuth = async ({
 
 // src/domains/auth/login/index.ts
 var LoginCommand = () => {
-  const cmd2 = new Command13("login");
+  const cmd2 = new Command14("login");
   cmd2.description("Login to scalar");
   cmd2.option("--email <email>", "Email");
   cmd2.option("--password <password>", "Password");
@@ -93012,9 +93145,9 @@ var LoginCommand = () => {
 };
 
 // src/domains/auth/logout/index.ts
-import { Command as Command14 } from "commander";
+import { Command as Command15 } from "commander";
 var LogoutCommand = () => {
-  const cmd2 = new Command14("logout");
+  const cmd2 = new Command15("logout");
   cmd2.description("Logout from scalar");
   cmd2.action(async () => {
     await clearAuthData();
@@ -93025,9 +93158,9 @@ var LogoutCommand = () => {
 
 // src/domains/auth/whoami/index.ts
 import as11 from "ansis";
-import { Command as Command15 } from "commander";
+import { Command as Command16 } from "commander";
 var WhoAmICommand = () => {
-  const cmd2 = new Command15("whoami");
+  const cmd2 = new Command16("whoami");
   cmd2.description("Display the current user");
   cmd2.action(async () => {
     const auth = await getAuthData({ skipRefresh: true });
@@ -93040,19 +93173,19 @@ var WhoAmICommand = () => {
 
 // src/domains/auth/index.ts
 var authCommands = [LoginCommand, WhoAmICommand, LogoutCommand];
-var authDomain = new Command16("auth");
+var authDomain = new Command17("auth");
 authDomain.description("Manage authorization on scalar platform");
 authCommands.forEach((command) => authDomain.addCommand(command()));
 var auth_default = authDomain;
 
 // src/domains/document/index.ts
-import { Command as Command29 } from "commander";
+import { Command as Command30 } from "commander";
 
 // src/domains/document/join/index.ts
 var import_yaml3 = __toESM(require_dist(), 1);
-import fs5 from "node:fs/promises";
+import fs6 from "node:fs/promises";
 import as12 from "ansis";
-import { Command as Command17 } from "commander";
+import { Command as Command18 } from "commander";
 import { join, normalize as normalize2 } from "@scalar/openapi-parser";
 
 // src/domains/document/join/helpers.ts
@@ -93088,7 +93221,7 @@ var formatErrorMessage = (conflicts) => {
   });
 };
 function JoinCommand() {
-  const cmd2 = new Command17("join");
+  const cmd2 = new Command18("join");
   cmd2.description(
     "Merge multiple OpenAPI documents into a single unified document"
   );
@@ -93112,7 +93245,7 @@ function JoinCommand() {
         optsError.issues.map((e) => `${e.message} property: '${e.path}'`).join("\n")
       ).line("").exit("error");
     }
-    const files = (await Promise.all(input.map((file2) => fs5.readFile(file2, "utf-8")))).map((it) => normalize2(it));
+    const files = (await Promise.all(input.map((file2) => fs6.readFile(file2, "utf-8")))).map((it) => normalize2(it));
     const prefixes = opts.prefixComponentsWithPathValue ? getPrefixes(files, opts.prefixComponentsWithPathValue) : [];
     const { executionTimeMs, result } = await measureTime(
       () => join(files, { prefixComponents: prefixes })
@@ -93122,7 +93255,7 @@ function JoinCommand() {
 ${formatErrorMessage(result.conflicts).join("\n")}`).line().exit("error");
     }
     const isYaml = isYamlFileName(opts.output);
-    await fs5.writeFile(
+    await fs6.writeFile(
       opts.output,
       isYaml ? import_yaml3.default.stringify(result.document) : JSON.stringify(result.document, null, 2),
       "utf8"
@@ -93135,18 +93268,18 @@ ${formatErrorMessage(result.conflicts).join("\n")}`).line().exit("error");
 }
 
 // src/domains/document/split/index.ts
-import fs6 from "node:fs/promises";
+import fs7 from "node:fs/promises";
 import path4 from "node:path";
 import { text as text3 } from "@clack/prompts";
 import as13 from "ansis";
-import { Command as Command18 } from "commander";
+import { Command as Command19 } from "commander";
 import { normalize as normalize3 } from "@scalar/openapi-parser";
 import {
   createServerWorkspaceStore,
   WORKSPACE_FILE_NAME
 } from "@scalar/workspace-store/server";
 function SplitCommand() {
-  const cmd2 = new Command18("split");
+  const cmd2 = new Command19("split");
   cmd2.description("Split your OpenAPI documents on small chunks");
   cmd2.argument("[file|url]", "Path to OpenAPI file or URL to split");
   cmd2.option("-o, --output <path>", "Path to save the chunks");
@@ -93186,13 +93319,13 @@ function SplitCommand() {
       await store.generateWorkspaceChunks();
       const workspaceFilePath = path4.join(outputPath, WORKSPACE_FILE_NAME);
       const sparseDocument = JSON.parse(
-        await fs6.readFile(workspaceFilePath, { encoding: "utf-8" })
+        await fs7.readFile(workspaceFilePath, { encoding: "utf-8" })
       );
-      await fs6.writeFile(
+      await fs7.writeFile(
         path4.join(outputPath, "out.json"),
         JSON.stringify(sparseDocument.documents[documentName])
       );
-      await fs6.rm(workspaceFilePath);
+      await fs7.rm(workspaceFilePath);
     });
     output.info().line().title(as13.green("Document Split Successfully! \u{1F389}")).line().message(`\u2728 Chunks have been generated at: ${as13.blue(outputPath)}`).line(`\u23F1\uFE0F Split completed in ${as13.yellow(executionTimeMs.toFixed(2))}ms`).line("").print();
   });
@@ -93200,12 +93333,12 @@ function SplitCommand() {
 }
 
 // src/domains/document/format/index.ts
-import fs7 from "node:fs";
+import fs8 from "node:fs";
 import as14 from "ansis";
-import { Command as Command19 } from "commander";
+import { Command as Command20 } from "commander";
 import { normalize as normalize4, toJson, toYaml } from "@scalar/openapi-parser";
 function FormatCommand() {
-  const cmd2 = new Command19("format");
+  const cmd2 = new Command20("format");
   cmd2.description("Format an OpenAPI file");
   cmd2.argument("[file|url]", "File or URL to format");
   cmd2.option("-o, --output <file>", "Output file");
@@ -93218,9 +93351,9 @@ function FormatCommand() {
       const specification = await getFileOrUrl(inputArgument);
       const newContent = isYamlFileName(outputPath || inputArgument) ? toYaml(normalize4(specification)) : toJson(normalize4(specification));
       if (outputPath) {
-        fs7.writeFileSync(outputPath, newContent, "utf8");
+        fs8.writeFileSync(outputPath, newContent, "utf8");
       } else if (!isUrl(inputArgument)) {
-        fs7.writeFileSync(inputArgument, newContent, "utf8");
+        fs8.writeFileSync(inputArgument, newContent, "utf8");
       } else {
         return output.error().title("Invalid argument").message().message(
           "Output file is required for URLs. Try passing --output file flag."
@@ -93240,7 +93373,7 @@ function FormatCommand() {
 // src/domains/document/lint/index.ts
 import spectralCore from "@stoplight/spectral-core";
 import as15 from "ansis";
-import { Command as Command20 } from "commander";
+import { Command as Command21 } from "commander";
 
 // src/domains/document/lint/helpers.ts
 import { bundleAndLoadRuleset } from "@stoplight/spectral-ruleset-bundler/with-loader";
@@ -93272,7 +93405,7 @@ var severityToLabel = (severity) => {
 var { Spectral } = spectralCore;
 var spectral = new Spectral();
 function LintCommand() {
-  const cmd2 = new Command20("lint");
+  const cmd2 = new Command21("lint");
   cmd2.description("Lint your OpenAPI file using spectral rules");
   cmd2.argument("[file|url]", "OpenAPI file path or url");
   cmd2.option("-r, --rule <file|url>", "Rule path or url");
@@ -93308,12 +93441,12 @@ function LintCommand() {
 }
 
 // src/domains/document/markdown/index.ts
-import fs8 from "node:fs";
+import fs9 from "node:fs";
 import as16 from "ansis";
-import { Command as Command21 } from "commander";
+import { Command as Command22 } from "commander";
 import { createMarkdownFromOpenApi } from "@scalar/openapi-to-markdown";
 function MarkdownCommand() {
-  const cmd2 = new Command21("markdown");
+  const cmd2 = new Command22("markdown");
   cmd2.description("Generate Markdown from an OpenAPI file");
   cmd2.argument("[file|url]", "OpenAPI file path or URL to convert");
   cmd2.option("-o, --output <file>", "Output file (defaults to stdout)");
@@ -93326,7 +93459,7 @@ function MarkdownCommand() {
       const specification = await getFileOrUrl(inputArgument);
       const markdown = await createMarkdownFromOpenApi(specification);
       if (outputPath) {
-        fs8.writeFileSync(outputPath, markdown, "utf8");
+        fs9.writeFileSync(outputPath, markdown, "utf8");
         const endTime = performance.now();
         output.info().line(
           `${as16.green("Markdown generated")} ${as16.grey(
@@ -93343,7 +93476,7 @@ function MarkdownCommand() {
 
 // src/domains/document/mock/index.ts
 import as18 from "ansis";
-import { Command as Command22 } from "commander";
+import { Command as Command23 } from "commander";
 
 // src/domains/document/mock/helpers.ts
 import { serve } from "@hono/node-server";
@@ -93413,7 +93546,7 @@ function getMethodColor(method) {
 
 // src/domains/document/mock/index.ts
 function MockCommand() {
-  const cmd2 = new Command22("mock");
+  const cmd2 = new Command23("mock");
   cmd2.description("Mock an API from an OpenAPI file");
   cmd2.argument("[file|url]", "OpenAPI file or URL to mock the server for");
   cmd2.option("-w, --watch", "watch the file for changes");
@@ -93473,12 +93606,12 @@ function MockCommand() {
 
 // src/domains/document/postman/index.ts
 var import_yaml4 = __toESM(require_dist(), 1);
-import fs9 from "node:fs";
+import fs10 from "node:fs";
 import as19 from "ansis";
-import { Command as Command23 } from "commander";
+import { Command as Command24 } from "commander";
 import { convert } from "@scalar/postman-to-openapi";
 function ConvertCommand() {
-  const cmd2 = new Command23("convert");
+  const cmd2 = new Command24("convert");
   cmd2.description("Convert a Postman collection to an OpenAPI document");
   cmd2.argument("[file|url]", "Postman collection file path or URL to convert");
   cmd2.option("-o, --output <file>", "Output file (defaults to stdout)");
@@ -93506,7 +93639,7 @@ function ConvertCommand() {
       }
       const openApiDocument = outputPath ? isYamlFileName(outputPath) ? import_yaml4.default.stringify(specification) : JSON.stringify(specification, null, 2) : JSON.stringify(specification, null, 2);
       if (outputPath) {
-        fs9.writeFileSync(outputPath, openApiDocument, "utf8");
+        fs10.writeFileSync(outputPath, openApiDocument, "utf8");
         const endTime = performance.now();
         output.info().line(
           `${as19.green("OpenAPI document generated")} ${as19.grey(
@@ -93525,11 +93658,11 @@ function ConvertCommand() {
 // src/domains/document/serve/index.ts
 import { serve as serve2 } from "@hono/node-server";
 import as20 from "ansis";
-import { Command as Command24 } from "commander";
+import { Command as Command25 } from "commander";
 import { Hono } from "hono";
 import { stream } from "hono/streaming";
 function ServeCommand() {
-  const cmd2 = new Command24("serve");
+  const cmd2 = new Command25("serve");
   cmd2.description("Serve an API Reference from an OpenAPI file");
   cmd2.argument("[file|url]", "OpenAPI file or URL to show the reference for");
   cmd2.option("-w, --watch", "watch the file for changes");
@@ -93648,9 +93781,9 @@ var getHtmlDocument = (specification, watch = false) => {
 
 // src/domains/document/share/index.ts
 import as21 from "ansis";
-import { Command as Command25 } from "commander";
+import { Command as Command26 } from "commander";
 function ShareCommand() {
-  const cmd2 = new Command25("share");
+  const cmd2 = new Command26("share");
   cmd2.description("Share an OpenAPI file");
   cmd2.argument("[file]", "file to share");
   cmd2.option(
@@ -93709,13 +93842,13 @@ function ShareCommand() {
 
 // src/domains/document/upgrade/index.ts
 var import_yaml5 = __toESM(require_dist(), 1);
-import fs10 from "node:fs/promises";
+import fs11 from "node:fs/promises";
 import { confirm as confirm2 } from "@clack/prompts";
 import as22 from "ansis";
-import { Command as Command26 } from "commander";
+import { Command as Command27 } from "commander";
 import { normalize as normalize5, upgrade } from "@scalar/openapi-parser";
 function UpgradeCommand() {
-  const cmd2 = new Command26("upgrade");
+  const cmd2 = new Command27("upgrade");
   cmd2.description("Upgrade OpenAPI document to version 3.1");
   cmd2.argument("[file|url]", "File or URL to validate");
   cmd2.option("-o, --output <file>", "Path to save the upgraded output file");
@@ -93744,7 +93877,7 @@ function UpgradeCommand() {
       () => upgrade(document2)
     );
     const isYaml = isYamlFileName(outputFileName);
-    await fs10.writeFile(
+    await fs11.writeFile(
       outputFileName,
       isYaml ? import_yaml5.default.stringify(result.specification) : JSON.stringify(result.specification, null, 2)
     );
@@ -93757,13 +93890,13 @@ function UpgradeCommand() {
 
 // src/domains/document/validate/index.ts
 import as23 from "ansis";
-import { Command as Command27 } from "commander";
+import { Command as Command28 } from "commander";
 import prettyjson from "prettyjson";
 import { bundle as bundle3 } from "@scalar/json-magic/bundle";
 import { fetchUrls as fetchUrls3, readFiles as readFiles3 } from "@scalar/json-magic/bundle/plugins/node";
 import { validate as validate2 } from "@scalar/openapi-parser";
 function ValidateCommand() {
-  const cmd2 = new Command27("validate");
+  const cmd2 = new Command28("validate");
   cmd2.description("Validate an OpenAPI file");
   cmd2.argument("[file|url]", "File or URL to validate");
   cmd2.action(async (inputArgument) => {
@@ -93810,10 +93943,10 @@ function ValidateCommand() {
 // src/domains/document/void/index.ts
 import { serve as serve3 } from "@hono/node-server";
 import as24 from "ansis";
-import { Command as Command28 } from "commander";
+import { Command as Command29 } from "commander";
 import { createVoidServer } from "@scalar/void-server";
 function VoidCommand() {
-  const cmd2 = new Command28("void");
+  const cmd2 = new Command29("void");
   cmd2.description("Boot a server to mirror HTTP requests");
   cmd2.option("-o, --once", "run the server only once and exit after that");
   cmd2.option("-p, --port <port>", "set the HTTP port for the mock server");
@@ -93870,23 +94003,23 @@ var documentCommands = [
   LintCommand,
   UpgradeCommand
 ];
-var documentDomain = new Command29("document");
+var documentDomain = new Command30("document");
 documentDomain.description("Manage local openapi file");
 documentCommands.forEach((command) => documentDomain.addCommand(command()));
 var document_default = documentDomain;
 
 // src/domains/project/index.ts
-import { Command as Command37 } from "commander";
+import { Command as Command38 } from "commander";
 
 // src/domains/project/preview/index.ts
 import { text as text4 } from "@clack/prompts";
 import as27 from "ansis";
-import { Command as Command32 } from "commander";
+import { Command as Command33 } from "commander";
 
 // src/domains/project/check-config/index.ts
-import fs12 from "node:fs";
+import fs13 from "node:fs";
 import as25 from "ansis";
-import { Command as Command30 } from "commander";
+import { Command as Command31 } from "commander";
 
 // ../../packages/helpers/dist/parse/parse.js
 var import_json5 = __toESM(require_lib(), 1);
@@ -94517,6 +94650,9 @@ var linkSchema2 = zod_default.object({
 var headerSpacerSchema = zod_default.object({
   type: zod_default.literal("spacer")
 });
+var headerVersionSelectorSchema = zod_default.object({
+  type: zod_default.literal("version-selector").describe("Renders the version selector dropdown at this position in the header")
+});
 var headerItem = zod_default.discriminatedUnion("type", [
   linkSchema2,
   headerSpacerSchema
@@ -94529,7 +94665,8 @@ var headerGroupSchema = zod_default.object({
 });
 var headerItemSchema = zod_default.discriminatedUnion("type", [
   headerItem,
-  headerGroupSchema
+  headerGroupSchema,
+  headerVersionSelectorSchema
 ]);
 
 // ../../packages/scalar-config/dist/schema/navigation/navigation.js
@@ -95162,7 +95299,7 @@ function generateGuideHeader({ header, guides, invalidRefs, references, isGroup
           invalidRefs,
           references,
           isGroup: true
-        }).filter((item2) => item2.type !== "group")
+        }).filter((item2) => item2.type !== "group" && item2.type !== "version-selector")
       });
     }
     if (item.type === "guide") {
@@ -95197,6 +95334,11 @@ function generateGuideHeader({ header, guides, invalidRefs, references, isGroup
         type: "spacer"
       });
     }
+    if (item.type === "version-selector") {
+      headerItems.push({
+        type: "version-selector"
+      });
+    }
   });
   if (!isGroup && !headerItems.some((item) => item.type === "spacer")) {
     headerItems.push({
@@ -95441,7 +95583,7 @@ var wysiwygProjectToV2 = n.safeFn(({ project, invalidRefs, theme }) => {
 }, (originalError) => createError("FAILED_TO_CONVERT_WYSIWYG_TO_V2", originalError));
 
 // src/domains/project/helpers.ts
-import fs11 from "node:fs";
+import fs12 from "node:fs";
 import path5 from "node:path";
 var DEFAULT_MARKDOWN_FILE_NAME = "docs-quickstart.md";
 var DEFAULT_OPENAPI_FILE_NAME = "docs-openapi.json";
@@ -95453,7 +95595,7 @@ function findConfig(searchPath) {
     return searchInDirectory(process.cwd());
   }
   const searchPathResolved = path5.resolve(searchPath);
-  const stat = fs11.statSync(searchPathResolved, { throwIfNoEntry: false });
+  const stat = fs12.statSync(searchPathResolved, { throwIfNoEntry: false });
   if (!stat) {
     return null;
   }
@@ -95470,7 +95612,7 @@ function getCurrentFolderName() {
 }
 function searchInDirectory(directory) {
   try {
-    const entries = fs11.readdirSync(directory);
+    const entries = fs12.readdirSync(directory);
     for (const entry of entries) {
       if (entry === CONFIG_FILE_NAME || entry.startsWith(`${CONFIG_FILE_NAME}.`)) {
         return path5.join(directory, entry);
@@ -95496,7 +95638,7 @@ function readAndParseConfig(configPath) {
       }
     };
   }
-  const fileContent = fs12.readFileSync(file2, "utf-8");
+  const fileContent = fs13.readFileSync(file2, "utf-8");
   const parseConfigResult = parseConfig(fileContent);
   if (!parseConfigResult.success) {
     return {
@@ -95516,7 +95658,7 @@ function readAndParseConfig(configPath) {
   };
 }
 function CheckConfigCommand() {
-  const cmd2 = new Command30("check-config");
+  const cmd2 = new Command31("check-config");
   cmd2.description("Check a Scalar Configuration file");
   cmd2.argument("[file]", "File to check");
   cmd2.action(async (inputArgument) => {
@@ -95562,12 +95704,12 @@ import path7 from "node:path";
 
 // src/domains/project/download-isolate/index.ts
 import { execFile } from "node:child_process";
-import fs13 from "node:fs/promises";
+import fs14 from "node:fs/promises";
 import os2 from "node:os";
 import path6 from "node:path";
 import { Readable } from "node:stream";
 import zlib from "node:zlib";
-import { Command as Command31 } from "commander";
+import { Command as Command32 } from "commander";
 import tar from "tar-fs";
 
 // src/helpers/run-command.ts
@@ -95591,7 +95733,7 @@ var ISOLATE_EXTRACTION_DIR = path6.join(os2.homedir(), ".scalar");
 var ISOLATE_DIR = path6.join(ISOLATE_EXTRACTION_DIR, "isolate");
 async function getExistingIsolateVersion() {
   try {
-    const packageJsonString = await fs13.readFile(
+    const packageJsonString = await fs14.readFile(
       path6.join(ISOLATE_DIR, "package.json"),
       "utf8"
     );
@@ -95646,7 +95788,7 @@ Remove-Item $tempFile
 async function downloadIsolate() {
   const existingIsolateVersion = await getExistingIsolateVersion();
   if (config2.ssgDocsIsolateVersion === existingIsolateVersion) return;
-  await fs13.rm(ISOLATE_EXTRACTION_DIR, { force: true, recursive: true });
+  await fs14.rm(ISOLATE_EXTRACTION_DIR, { force: true, recursive: true });
   const logger = output.info({ animate: true }).loader("Downloading docs isolate. This may take a minute...");
   const ISOLATE_URL = `${config2.cdnUrl}/isolates/${config2.ssgDocsIsolateVersion}-isolate.tar.gz`;
   if (process.platform === "win32") {
@@ -95663,7 +95805,7 @@ async function downloadIsolate() {
   logger.finish();
 }
 var DownloadIsolateCommand = () => {
-  const cmd2 = new Command31("download-isolate");
+  const cmd2 = new Command32("download-isolate");
   cmd2.description("Download the docs isolate");
   cmd2.action(async () => {
     await downloadIsolate();
@@ -95721,7 +95863,7 @@ async function previewV2Project({
 
 // src/domains/project/preview/index.ts
 var PreviewCommand = () => {
-  const cmd2 = new Command32("preview");
+  const cmd2 = new Command33("preview");
   cmd2.description("Preview scalar guides");
   cmd2.argument(
     "[config]",
@@ -95814,9 +95956,9 @@ var PreviewCommand = () => {
 // src/domains/project/create/index.ts
 import { text as text5 } from "@clack/prompts";
 import as28 from "ansis";
-import { Command as Command33 } from "commander";
+import { Command as Command34 } from "commander";
 var CreateCommand = () => {
-  const cmd2 = new Command33("create");
+  const cmd2 = new Command34("create");
   cmd2.description(
     "Create a new project that is not linked to a github project."
   );
@@ -95861,11 +96003,11 @@ Project slug: ${as28.cyan(response.data.slug)}`
 };
 
 // src/domains/project/init/index.ts
-import fs14 from "node:fs/promises";
+import fs15 from "node:fs/promises";
 import path8 from "node:path";
 import { cancel, confirm as confirm3, isCancel, text as text6 } from "@clack/prompts";
 import as29 from "ansis";
-import { Command as Command34 } from "commander";
+import { Command as Command35 } from "commander";
 
 // ../../node_modules/.pnpm/@scalar+galaxy@0.6.7/node_modules/@scalar/galaxy/dist/3.1.json
 var __default = {
@@ -97823,14 +97965,14 @@ We're here to help:
 // src/domains/project/init/index.ts
 async function fileExists2(path13) {
   try {
-    await fs14.access(path13, fs14.constants.F_OK);
+    await fs15.access(path13, fs15.constants.F_OK);
     return true;
   } catch {
     return false;
   }
 }
 var InitCommand = () => {
-  const cmd2 = new Command34("init");
+  const cmd2 = new Command35("init");
   cmd2.description("Create a new Scalar Docs project.");
   cmd2.option("-s, --subdomain [url]", "subdomain to publish on");
   cmd2.option("--force", "override existing configuration");
@@ -97919,12 +98061,12 @@ var InitCommand = () => {
     }
     configuration.siteConfig.subdomain = subdomain.trim();
     const content = JSON.stringify(configuration, null, 2);
-    await fs14.writeFile(configFile, content);
-    await fs14.writeFile(
+    await fs15.writeFile(configFile, content);
+    await fs15.writeFile(
       path8.join(currentDir, DEFAULT_MARKDOWN_FILE_NAME),
       quickstartMarkdown
     );
-    await fs14.writeFile(
+    await fs15.writeFile(
       path8.join(currentDir, DEFAULT_OPENAPI_FILE_NAME),
       JSON.stringify(__default, null, 2)
     );
@@ -97941,12 +98083,12 @@ var InitCommand = () => {
 };
 
 // src/domains/project/publish/index.ts
-import fs16 from "node:fs";
+import fs17 from "node:fs";
 import { dirname } from "node:path";
-import { Command as Command35 } from "commander";
+import { Command as Command36 } from "commander";
 
 // src/domains/project/publish/publish.ts
-import fs15 from "node:fs";
+import fs16 from "node:fs";
 import path9 from "node:path";
 import { Readable as Readable2 } from "node:stream";
 import ignore from "ignore";
@@ -97957,7 +98099,7 @@ function isErrnoException(error48) {
 }
 async function readGitIgnore(configDir) {
   try {
-    const gitignore = await fs15.promises.readFile(
+    const gitignore = await fs16.promises.readFile(
       path9.resolve(configDir, ".gitignore"),
       "utf8"
     );
@@ -98069,7 +98211,7 @@ var sleep = (ms) => {
 
 // src/domains/project/publish/index.ts
 var PublishCommand = () => {
-  const cmd2 = new Command35("publish");
+  const cmd2 = new Command36("publish");
   cmd2.description(
     "Publish new build for a github sync project that is not linked."
   );
@@ -98150,10 +98292,10 @@ var PublishCommand = () => {
       });
     }
     const configPath = configPathOption ?? findConfig();
-    if (!configPath || !fs16.existsSync(configPath)) {
+    if (!configPath || !fs17.existsSync(configPath)) {
       return output.error().title("Invalid configuration file").message("Could not find the Scalar Configuration file:").message(configPath ?? "").exit("error");
     }
-    const rawConfig = fs16.readFileSync(configPath, "utf-8");
+    const rawConfig = fs17.readFileSync(configPath, "utf-8");
     const configParseResult = parseConfig(rawConfig);
     if (!configParseResult.success) {
       return output.error().title("Invalid configuration file").line(
@@ -98237,11 +98379,11 @@ async function getDeployStatus({
 }
 
 // src/domains/project/upgrade/index.ts
-import fs17 from "node:fs/promises";
+import fs18 from "node:fs/promises";
 import path10 from "node:path";
 import { text as text7 } from "@clack/prompts";
 import as30 from "ansis";
-import { Command as Command36 } from "commander";
+import { Command as Command37 } from "commander";
 import { n as n2 } from "neverpanic";
 
 // src/errors.ts
@@ -98270,7 +98412,7 @@ function displayError(error48, fallback = "Unknown error occurred. Please contac
 
 // src/domains/project/upgrade/index.ts
 var UpgradeCommand2 = () => {
-  const cmd2 = new Command36("upgrade");
+  const cmd2 = new Command37("upgrade");
   cmd2.description("Upgrade scalar project");
   cmd2.argument(
     "[config]",
@@ -98326,7 +98468,7 @@ var UpgradeCommand2 = () => {
     const { upgradedConfig, legacyTheme, legacyFooter, legacyScript } = upgradedConfigResult.data;
     if (legacyTheme) {
       const writeUpgradedThemeResult = await n2.fromUnsafe(
-        () => fs17.writeFile(
+        () => fs18.writeFile(
           path10.resolve(
             path10.dirname(parseConfigResult.filePath),
             config3.root ?? "./",
@@ -98342,7 +98484,7 @@ var UpgradeCommand2 = () => {
     }
     if (legacyFooter) {
       const writeUpgradedFooterResult = await n2.fromUnsafe(
-        () => fs17.writeFile(
+        () => fs18.writeFile(
           path10.resolve(
             path10.dirname(parseConfigResult.filePath),
             config3.root ?? "./",
@@ -98358,7 +98500,7 @@ var UpgradeCommand2 = () => {
     }
     if (legacyScript) {
       const writeUpgradedScriptResult = await n2.fromUnsafe(
-        () => fs17.writeFile(
+        () => fs18.writeFile(
           path10.resolve(
             path10.dirname(parseConfigResult.filePath),
             config3.root ?? "./",
@@ -98373,7 +98515,7 @@ var UpgradeCommand2 = () => {
       }
     }
     const writeUpgradedConfigResult = await n2.fromUnsafe(
-      () => fs17.writeFile(
+      () => fs18.writeFile(
         parseConfigResult.filePath,
         JSON.stringify(upgradedConfig, null, 2)
       ),
@@ -98396,22 +98538,22 @@ var projectCommands = [
   PublishCommand,
   UpgradeCommand2
 ];
-var projectDomain = new Command37("project");
+var projectDomain = new Command38("project");
 projectDomain.description("Manage scalar project");
 projectCommands.forEach((command) => projectDomain.addCommand(command()));
 projectDomain.addCommand(DownloadIsolateCommand(), { hidden: true });
 var project_default = projectDomain;
 
 // src/domains/readme/index.ts
-import { Command as Command39 } from "commander";
+import { Command as Command40 } from "commander";
 
 // src/domains/readme/generate.ts
 import { text as text8 } from "@clack/prompts";
 import as31 from "ansis";
-import { Command as Command38 } from "commander";
+import { Command as Command39 } from "commander";
 
 // src/helpers/documentation/index.ts
-import fs18 from "node:fs/promises";
+import fs19 from "node:fs/promises";
 import path11 from "node:path";
 var generateDocs = (command, depth = 0) => {
   if (command._hidden) return [];
@@ -98441,13 +98583,13 @@ ${docs.content}${codeBlock}`);
 };
 var generateDocumentationFile = async (outputPath) => {
   const commandDocumentation = generateCommandDocumentation(getProgram());
-  const template = await fs18.readFile(
+  const template = await fs19.readFile(
     path11.join(import.meta.dirname, "template.md"),
     {
       encoding: "utf-8"
     }
   );
-  await fs18.writeFile(
+  await fs19.writeFile(
     outputPath,
     template.replace("<COMMANDS>", commandDocumentation)
   );
@@ -98455,7 +98597,7 @@ var generateDocumentationFile = async (outputPath) => {
 
 // src/domains/readme/generate.ts
 function GenerateReadmeCommand() {
-  const cmd2 = new Command38("generate");
+  const cmd2 = new Command39("generate");
   cmd2.description("Self generate documentation for the cli");
   cmd2.option(
     "-o, --output [file]",
@@ -98488,12 +98630,12 @@ function GenerateReadmeCommand() {
 }
 
 // src/domains/readme/serve.ts
-import fs19 from "node:fs/promises";
+import fs20 from "node:fs/promises";
 import path12 from "node:path";
 import as32 from "ansis";
 var fileExists3 = async (filePath) => {
   try {
-    await fs19.access(filePath);
+    await fs20.access(filePath);
     return true;
   } catch {
     return false;
@@ -98518,23 +98660,23 @@ function ServeReadmeCommand(cmd2) {
 }
 
 // src/domains/readme/index.ts
-var readmeDomain = new Command39("readme");
+var readmeDomain = new Command40("readme");
 readmeDomain.addCommand(GenerateReadmeCommand());
 ServeReadmeCommand(readmeDomain);
 var readme_default = readmeDomain;
 
 // src/domains/registry/index.ts
-import { Command as Command45 } from "commander";
+import { Command as Command46 } from "commander";
 
 // src/domains/registry/publish/index.ts
 import { text as text9 } from "@clack/prompts";
 import as33 from "ansis";
-import { Command as Command40 } from "commander";
+import { Command as Command41 } from "commander";
 import { bundle as bundle4 } from "@scalar/json-magic/bundle";
 import { fetchUrls as fetchUrls4, readFiles as readFiles4 } from "@scalar/json-magic/bundle/plugins/node";
 import { parseJsonOrYaml as parseJsonOrYaml2 } from "@scalar/oas-utils/helpers";
 var PublishCommand2 = () => {
-  const cmd2 = new Command40("publish");
+  const cmd2 = new Command41("publish");
   cmd2.description("Publish an OpenAPI document to the Scalar registry");
   cmd2.argument("[file]", "OpenAPI file to upload");
   cmd2.option(
@@ -98677,9 +98819,9 @@ var PublishCommand2 = () => {
 };
 
 // src/domains/registry/delete/index.ts
-import { Command as Command41 } from "commander";
+import { Command as Command42 } from "commander";
 var DeleteCommand = () => {
-  const cmd2 = new Command41("delete");
+  const cmd2 = new Command42("delete");
   cmd2.description("Delete a document from scalar registry");
   cmd2.argument("[namespace]", "Team namespace");
   cmd2.argument("[slug]", "Managed doc slug");
@@ -98696,11 +98838,11 @@ var DeleteCommand = () => {
 };
 
 // src/domains/registry/get/index.ts
-import fs20 from "node:fs";
-import { Command as Command42 } from "commander";
-var versionSchema3 = external_exports.union([docVersionSchema, external_exports.literal("latest")]);
+import fs21 from "node:fs/promises";
+import { Command as Command43 } from "commander";
+var versionSchema4 = external_exports.union([docVersionSchema, external_exports.literal("latest")]);
 var GetCommand = () => {
-  const cmd2 = new Command42("get");
+  const cmd2 = new Command43("get");
   cmd2.description("Get a document version from scalar registry");
   cmd2.argument("[namespace]", "Team namespace");
   cmd2.argument("[slug]", "Managed doc slug");
@@ -98717,7 +98859,7 @@ var GetCommand = () => {
       return;
     }
     const result = external_exports.object({
-      version: versionSchema3,
+      version: versionSchema4,
       format: external_exports.enum(["json", "yaml"]),
       output: external_exports.string().min(1).optional()
     }).safeParse({
@@ -98731,38 +98873,28 @@ var GetCommand = () => {
     }
     const auth = await getAuthData();
     auth.addEventListener((state) => Object.assign(auth, state));
-    const registryDocumentUrl = registryUrl(
+    const fetchResult = await fetchFromRegistry(
       registry2(namespace).apis(slug).url({
         version: result.data.version,
         format: result.data.format
-      })
+      }),
+      auth.accessToken
     );
-    let getDocument;
-    try {
-      getDocument = await fetch(registryDocumentUrl, {
-        headers: {
-          "x-scalar-auth": auth.accessToken
-        },
-        // Should always error on redirect
-        redirect: "error"
-      });
-    } catch (error48) {
-      const message = error48 instanceof Error && error48.message.length > 0 ? error48.message : "Registry request failed before a response was received.";
-      output.error().title("Unable to download document").message(message).exit("error");
-      return;
-    }
-    if (!getDocument.ok) {
-      const message = await getDocument.text();
-      output.error().title("Unable to download document").message(
-        message.length ? message : `Registry request failed with status ${getDocument.status}.`
-      ).exit("error");
+    if (fetchResult.error) {
+      output.error().title("Unable to download document").message(fetchResult.message).exit("error");
       return;
     }
-    const document2 = await getDocument.text();
+    const document2 = fetchResult.data;
     const withTrailingNewline = document2.endsWith("\n") ? document2 : `${document2}
 `;
     if (result.data.output) {
-      fs20.writeFileSync(result.data.output, withTrailingNewline, "utf8");
+      try {
+        await fs21.writeFile(result.data.output, withTrailingNewline, "utf8");
+      } catch (error48) {
+        const message = error48 instanceof Error && error48.message.length > 0 ? error48.message : `Could not write to ${result.data.output}.`;
+        output.error().title("Unable to write document to file").message(message).exit("error");
+        return;
+      }
       output.info().line(
         `Downloaded ${namespace}/${slug}@${result.data.version} (${result.data.format})`
       ).line(`Written to ${result.data.output}`).print();
@@ -98775,9 +98907,9 @@ var GetCommand = () => {
 
 // src/domains/registry/list/index.ts
 import as34 from "ansis";
-import { Command as Command43 } from "commander";
+import { Command as Command44 } from "commander";
 var ListCommand = () => {
-  const cmd2 = new Command43("list");
+  const cmd2 = new Command44("list");
   cmd2.description("List all registry APIs for a team namespace");
   cmd2.option("--namespace <namespace>", "Team namespace");
   cmd2.action(async (args) => {
@@ -98836,9 +98968,9 @@ var ListCommand = () => {
 // src/domains/registry/update/index.ts
 import { text as text10 } from "@clack/prompts";
 import as35 from "ansis";
-import { Command as Command44 } from "commander";
+import { Command as Command45 } from "commander";
 var UpdateCommand = () => {
-  const cmd2 = new Command44("update");
+  const cmd2 = new Command45("update");
   cmd2.description("Update document metadata on scalar registry");
   cmd2.argument("[namespace]", "namespace of document you want to update");
   cmd2.argument("[slug]", "slug of document you want to update");
@@ -98892,17 +99024,17 @@ var registryCommands = [
   ListCommand,
   GetCommand
 ];
-var registryDomain = new Command45("registry");
+var registryDomain = new Command46("registry");
 registryDomain.description("Manage your scalar registry");
 registryCommands.forEach((command) => registryDomain.addCommand(command()));
 var registry_default = registryDomain;
 
 // src/domains/team/index.ts
-import { Command as Command48 } from "commander";
+import { Command as Command49 } from "commander";
 
 // src/domains/team/list/index.ts
 import as36 from "ansis";
-import { Command as Command46 } from "commander";
+import { Command as Command47 } from "commander";
 
 // src/domains/team/helpers.ts
 var getUserTeams = async (client, email3) => {
@@ -98917,7 +99049,7 @@ var getUserTeams = async (client, email3) => {
 
 // src/domains/team/list/index.ts
 var ListCommand2 = () => {
-  const cmd2 = new Command46("list");
+  const cmd2 = new Command47("list");
   cmd2.description("List all teams current user is part of");
   cmd2.action(async () => {
     const auth = await getAuthData();
@@ -98943,9 +99075,9 @@ var ListCommand2 = () => {
 // src/domains/team/set/index.ts
 import { select as select7 } from "@clack/prompts";
 import as37 from "ansis";
-import { Command as Command47 } from "commander";
+import { Command as Command48 } from "commander";
 var SetCommand = () => {
-  const cmd2 = new Command47("set");
+  const cmd2 = new Command48("set");
   cmd2.description("Set current active team for the user");
   cmd2.option("--team <team>", "Team uid");
   cmd2.action(async ({ team }) => {
@@ -98985,7 +99117,7 @@ var SetCommand = () => {
 
 // src/domains/team/index.ts
 var teamCommands = [ListCommand2, SetCommand];
-var teamDomain = new Command48("team");
+var teamDomain = new Command49("team");
 teamDomain.description("Manage user teams");
 teamCommands.forEach((command) => teamDomain.addCommand(command()));
 var team_default = teamDomain;
@@ -98993,7 +99125,7 @@ var team_default = teamDomain;
 // src/domains/upgrade/index.ts
 import { execSync } from "node:child_process";
 import as39 from "ansis";
-import { Command as Command49 } from "commander";
+import { Command as Command50 } from "commander";
 
 // src/helpers/upgrade.ts
 import as38 from "ansis";
@@ -99049,7 +99181,7 @@ async function checkUpgrade() {
 }
 
 // src/domains/upgrade/index.ts
-var cmd = new Command49("upgrade");
+var cmd = new Command50("upgrade");
 cmd.description("Upgrade current version of your cli");
 cmd.action(async () => {
   const upgradeStatus = await getUpgradeInformation();
@@ -99087,7 +99219,7 @@ var domains_default = domains;
 
 // src/program.ts
 var getProgram = () => {
-  const program2 = new Command50();
+  const program2 = new Command51();
   program2.enablePositionalOptions().name(Object.keys(bin)[0]).description("CLI to work with your OpenAPI files").version(version, "-v, --version");
   program2.showHelpAfterError();
   domains_default.forEach((domain2) => program2.addCommand(domain2));