fern-api 0.39.16 → 0.39.17

package/bundle.cjs

@@ -1192625,7 +1192625,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "0.39.16",
+          version: "0.39.17",
           usingAccessToken: true
         }
       });
@@ -1192687,7 +1192687,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "0.39.16",
+        version: "0.39.17",
         ...event,
         ...event.properties
       }
@@ -1197750,10 +1197750,10 @@ var CliContext = class {
     return "fern-api";
   }
   getPackageVersion() {
-    if ("0.39.16" == null) {
+    if ("0.39.17" == null) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "0.39.16";
+    return "0.39.17";
   }
   getCliName() {
     if ("fern" == null) {
@@ -1223078,6 +1223078,125 @@ async function getOrganziation({
   }
 }
 
+// src/commands/upgrade/upgradeGenerator.ts
+var import_promises32 = require("fs/promises");
+var import_path27 = __toESM(require("path"), 1);
+var semver3 = __toESM(require_semver2(), 1);
+var import_yaml = __toESM(require_dist5(), 1);
+async function loadAndUpdateGenerators({
+  absolutePathToWorkspace,
+  context,
+  generatorFilter,
+  groupFilter,
+  includeMajor
+}) {
+  const filepath = generators_yml_exports.getPathToGeneratorsConfiguration({ absolutePathToWorkspace });
+  if (!await doesPathExist(filepath)) {
+    context.failAndThrow("Generators configuration file was not found, no generators to upgrade.");
+    return void 0;
+  }
+  const contents = await (0, import_promises32.readFile)(filepath);
+  context.logger.debug(`Found generators: ${contents.toString()}`);
+  const parsedDocument = import_yaml.default.parseDocument(contents.toString());
+  const generatorGroups = parsedDocument.get("groups");
+  if (generatorGroups == null) {
+    context.failAndThrow("No groups were found within the generators configuration, no generators to upgrade.");
+    return void 0;
+  }
+  if (!import_yaml.default.isMap(generatorGroups)) {
+    context.failAndThrow(`Expected 'groups' to be a map in ${import_path27.default.relative(process.cwd(), filepath)}`);
+    return void 0;
+  }
+  context.logger.debug(`Groups found: ${generatorGroups.toString()}`);
+  for (const groupBlock of generatorGroups.items) {
+    const groupName = groupBlock.key;
+    const group = groupBlock.value;
+    if (!import_yaml.default.isMap(group)) {
+      context.failAndThrow(
+        `Expected group ${groupName} to be a map in ${import_path27.default.relative(process.cwd(), filepath)}`
+      );
+      continue;
+    }
+    if (groupFilter != null && group.get("name") !== groupName) {
+      continue;
+    }
+    const generators = group.get("generators");
+    if (!import_yaml.default.isSeq(generators)) {
+      context.failAndThrow(
+        `Expected group ${groupName} to have a 'generators' key in ${import_path27.default.relative(process.cwd(), filepath)}`
+      );
+      continue;
+    }
+    context.logger.debug(`Generators found: ${generators.toString()}`);
+    for (const generator of generators.items) {
+      if (!import_yaml.default.isMap(generator)) {
+        context.failAndThrow(
+          `Expected generator in group ${groupName} to be a map in ${import_path27.default.relative(process.cwd(), filepath)}`
+        );
+      }
+      if (generatorFilter != null && generator.get("name") !== generatorFilter) {
+        continue;
+      }
+      const generatorName = generator.get("name");
+      const normalizedGeneratorName = generators_yml_exports.getGeneratorNameOrThrow(generatorName, context);
+      const currentVersion = generator.get("version");
+      const latestVersion2 = await generators_yml_exports.getLatestGeneratorVersion(normalizedGeneratorName, context);
+      context.logger.debug(`${generatorName}, ${currentVersion}, ${latestVersion2}`);
+      if (latestVersion2 == null) {
+        continue;
+      }
+      const currentMajor = semver3.major(currentVersion);
+      const latestMajor = semver3.major(latestVersion2);
+      if (currentMajor === latestMajor || includeMajor) {
+        generator.set("version", latestVersion2);
+        context.logger.info(source_default.green(`${generatorName} has been upgraded to latest in group: ${groupName}`));
+      }
+    }
+  }
+  return parsedDocument.toString();
+}
+async function upgradeGenerator2({
+  cliContext,
+  generator,
+  group,
+  project: { apiWorkspaces },
+  includeMajor
+}) {
+  await Promise.all(
+    apiWorkspaces.map(async (workspace) => {
+      await cliContext.runTaskForWorkspace(workspace, async (context) => {
+        var _a6;
+        const generatorsConfiguration = await generators_yml_exports.loadRawGeneratorsConfiguration({
+          absolutePathToWorkspace: workspace.absoluteFilepath,
+          context
+        }) ?? {};
+        if (generatorsConfiguration == null || generatorsConfiguration.groups == null) {
+          context.failAndThrow(
+            "No groups were found within the generators configuration, no generators to upgrade."
+          );
+          return;
+        }
+        context.logger.info(`Upgrading generators in workspace: ${workspace.workspaceName}`);
+        const updatedConfiguration = await loadAndUpdateGenerators({
+          absolutePathToWorkspace: workspace.absoluteFilepath,
+          context,
+          generatorFilter: generator,
+          groupFilter: group,
+          includeMajor
+        });
+        if (updatedConfiguration != null) {
+          await (0, import_promises32.writeFile)(
+            ((_a6 = workspace.generatorsConfiguration) == null ? void 0 : _a6.absolutePathToConfiguration) ?? generators_yml_exports.getPathToGeneratorsConfiguration({
+              absolutePathToWorkspace: workspace.absoluteFilepath
+            }),
+            updatedConfiguration
+          );
+        }
+      });
+    })
+  );
+}
+
 // src/cliV2.ts
 function addGetOrganizationCommand(cli, cliContext) {
   cli.command(
@@ -1223106,55 +1223225,96 @@ function addGetOrganizationCommand(cli, cliContext) {
     }
   );
 }
-function addGeneratorListCommand(cli, cliContext) {
-  cli.command(
-    "generator list",
-    false,
-    (yargs) => yargs.option("output", {
-      string: true,
-      alias: "o",
-      description: "The location to output the list as a text file, defaults to standard out."
-    }).option("generators", {
-      string: true,
-      type: "array",
-      description: "The type of generator to include in the list, ex: `fern-typescript-node-sdk`. If omitted, all generators will be listed."
-    }).option("groups", {
-      type: "array",
-      string: true,
-      description: "The groups to include generators from, if group is not specified, the all generators of the specified type will be listed."
-    }).option("apis", {
-      type: "array",
-      string: true,
-      description: "The APIs to list the generators for. If not specified, the generator will be upgraded for all APIs."
-    }).option("api-fallback", {
-      string: true,
-      description: "The APIs to list the generators for. If not specified, the generator will be upgraded for all APIs."
-    }),
-    async (argv) => {
-      cliContext.instrumentPostHogEvent({
-        command: "fern generator list",
-        properties: {
+function addGeneratorCommands(cli, cliContext) {
+  cli.command("generator", "Operate on the generators within your Fern configuration", (yargs) => {
+    yargs.command(
+      "list",
+      false,
+      (yargs2) => yargs2.option("output", {
+        string: true,
+        alias: "o",
+        description: "The location to output the list as a text file, defaults to standard out."
+      }).option("generators", {
+        string: true,
+        type: "array",
+        description: "The type of generator to include in the list, ex: `fern-typescript-node-sdk`. If omitted, all generators will be listed."
+      }).option("groups", {
+        type: "array",
+        string: true,
+        description: "The groups to include generators from, if group is not specified, the all generators of the specified type will be listed."
+      }).option("apis", {
+        type: "array",
+        string: true,
+        description: "The APIs to list the generators for. If not specified, the generator will be upgraded for all APIs."
+      }).option("api-fallback", {
+        string: true,
+        description: "The APIs to list the generators for. If not specified, the generator will be upgraded for all APIs."
+      }),
+      async (argv) => {
+        cliContext.instrumentPostHogEvent({
+          command: "fern generator list",
+          properties: {
+            outputLocation: argv.output
+          }
+        });
+        await getGeneratorList({
+          project: await loadProjectAndRegisterWorkspacesWithContext(cliContext, {
+            commandLineApiWorkspace: void 0,
+            defaultToAllApiWorkspaces: true
+          }),
+          generatorFilter: argv.generators ? new Set(argv.generators) : void 0,
+          groupFilter: argv.groups ? new Set(argv.groups) : void 0,
+          apiFilter: argv.apis ? new Set(argv.apis) : void 0,
+          apiKeyFallback: argv.apiFallback,
+          cliContext,
           outputLocation: argv.output
-        }
-      });
-      await getGeneratorList({
-        project: await loadProjectAndRegisterWorkspacesWithContext(cliContext, {
-          commandLineApiWorkspace: void 0,
-          defaultToAllApiWorkspaces: true
-        }),
-        generatorFilter: argv.generators ? new Set(argv.generators) : void 0,
-        groupFilter: argv.groups ? new Set(argv.groups) : void 0,
-        apiFilter: argv.apis ? new Set(argv.apis) : void 0,
-        apiKeyFallback: argv.apiFallback,
-        cliContext,
-        outputLocation: argv.output
-      });
-    }
-  );
+        });
+      }
+    ).command(
+      "upgrade",
+      `Upgrades the specified generator in ${GENERATORS_CONFIGURATION_FILENAME} to the latest stable version.`,
+      (yargs2) => yargs2.option("generator", {
+        string: true,
+        description: "The type of generator to upgrade, ex: `fern-typescript-node-sdk`."
+      }).option("group", {
+        string: true,
+        description: "The group in which the generator is located, if group is not specified, the all generators of the specified type will be upgraded."
+      }).option("api", {
+        string: true,
+        description: "The API to upgrade the generator for. If not specified, the generator will be upgraded for all APIs."
+      }).option("include-major", {
+        boolean: true,
+        default: false,
+        description: "Whether or not to include major versions within the upgrade. Defaults to false, meaning major versions will be skipped."
+      }),
+      async (argv) => {
+        cliContext.instrumentPostHogEvent({
+          command: "fern generator upgrade",
+          properties: {
+            generator: argv.generator,
+            version: argv.version,
+            api: argv.api,
+            group: argv.group,
+            includeMajor: argv.includeMajor
+          }
+        });
+        await upgradeGenerator2({
+          cliContext,
+          generator: argv.generator,
+          group: argv.group,
+          project: await loadProjectAndRegisterWorkspacesWithContext(cliContext, {
+            commandLineApiWorkspace: argv.api,
+            defaultToAllApiWorkspaces: true
+          }),
+          includeMajor: argv.includeMajor
+        });
+      }
+    );
+  });
 }
 
 // src/commands/add-generator/addGeneratorToWorkspaces.ts
-var import_promises32 = require("fs/promises");
+var import_promises33 = require("fs/promises");
 async function addGeneratorToWorkspaces({
   project: { apiWorkspaces },
   generatorName,
@@ -1223175,7 +1223335,7 @@ async function addGeneratorToWorkspaces({
           groupName,
           context
         });
-        await (0, import_promises32.writeFile)(
+        await (0, import_promises33.writeFile)(
           ((_a6 = workspace.generatorsConfiguration) == null ? void 0 : _a6.absolutePathToConfiguration) ?? generators_yml_exports.getPathToGeneratorsConfiguration({
             absolutePathToWorkspace: workspace.absoluteFilepath
           }),
@@ -1232597,10 +1232757,10 @@ function visitFrontmatterImages(data2, keys7, mapImage) {
 }
 
 // ../docs-markdown-utils/lib/replaceReferencedMarkdown.js
-var import_promises33 = require("fs/promises");
+var import_promises34 = require("fs/promises");
 var import_gray_matter2 = __toESM(require_gray_matter(), 1);
 async function defaultMarkdownLoader(filepath) {
-  const { content: content3 } = (0, import_gray_matter2.default)(await (0, import_promises33.readFile)(filepath));
+  const { content: content3 } = (0, import_gray_matter2.default)(await (0, import_promises34.readFile)(filepath));
   return content3;
 }
 async function replaceReferencedMarkdown({
@@ -1232637,9 +1232797,9 @@ async function replaceReferencedMarkdown({
 }
 
 // ../docs-markdown-utils/lib/replaceReferencedCode.js
-var import_promises34 = require("fs/promises");
+var import_promises35 = require("fs/promises");
 async function defaultFileLoader(filepath) {
-  const file = await (0, import_promises34.readFile)(filepath);
+  const file = await (0, import_promises35.readFile)(filepath);
   return file.toString();
 }
 async function replaceReferencedCode({
@@ -1237724,12 +1237884,12 @@ function stringifyFernFilepath(fernFilepath) {
 }
 
 // ../generation/ir-generator/lib/utils/convertToFernFilepath.js
-var import_path27 = __toESM(require("path"), 1);
+var import_path28 = __toESM(require("path"), 1);
 function convertToFernFilepath({ relativeFilepath, casingsGenerator }) {
   const pathToPackage = dirname(relativeFilepath);
-  const filename = (0, import_path27.basename)(relativeFilepath);
-  const packagePath = pathToPackage === "." ? [] : pathToPackage.split(import_path27.default.sep).map((part) => casingsGenerator.generateName(part));
-  const file = filename !== FERN_PACKAGE_MARKER_FILENAME ? casingsGenerator.generateName(import_path27.default.parse(filename).name) : void 0;
+  const filename = (0, import_path28.basename)(relativeFilepath);
+  const packagePath = pathToPackage === "." ? [] : pathToPackage.split(import_path28.default.sep).map((part) => casingsGenerator.generateName(part));
+  const file = filename !== FERN_PACKAGE_MARKER_FILENAME ? casingsGenerator.generateName(import_path28.default.parse(filename).name) : void 0;
   const allParts = [];
   allParts.push(...packagePath);
   if (file != null) {
@@ -1239674,7 +1239834,7 @@ function convertObject4({ typeName, rawObject, example, fileContainingType, file
     throw new Error(`Example is not an object. Got: ${JSON.stringify(example)}`);
   }
   return ExampleTypeShape.object({
-    properties: rawObject.properties != null ? Object.entries(example).reduce((exampleProperties, [wireKey, propertyExample]) => {
+    properties: rawObject.properties != null || rawObject.extends != null ? Object.entries(example).reduce((exampleProperties, [wireKey, propertyExample]) => {
       const originalTypeDeclaration = getOriginalTypeDeclarationForProperty({
         typeName,
         wirePropertyKey: wireKey,
@@ -1244298,10 +1244458,10 @@ var PropertyResolverImpl = class {
 };
 
 // ../generation/ir-generator/lib/parsers/ProtobufParser.js
-var import_promises35 = require("fs/promises");
+var import_promises36 = require("fs/promises");
 var ProtobufParser = class {
   async parse({ absoluteFilePath }) {
-    const content3 = await (0, import_promises35.readFile)(absoluteFilePath, "utf-8");
+    const content3 = await (0, import_promises36.readFile)(absoluteFilePath, "utf-8");
     const csharpNamespaceMatch = content3.match(/option\s+csharp_namespace\s*=\s*"([^"]+)";/);
     const packageNameMatch = content3.match(/package\s+([a-zA-Z_][\w.]*);/);
     const serviceNameMatch = content3.match(/service\s+([a-zA-Z_]\w*)\s*{/);
@@ -1245096,7 +1245256,7 @@ function filterServiceTypeReferenceInfoForAudiences(serviceTypeReferenceInfo, fi
 // ../docs-resolver/lib/DocsDefinitionResolver.js
 var import_dayjs3 = __toESM(require_dayjs_min(), 1);
 var import_utc3 = __toESM(require_utc(), 1);
-var import_promises36 = require("fs/promises");
+var import_promises37 = require("fs/promises");
 var import_gray_matter3 = __toESM(require_gray_matter(), 1);
 
 // ../docs-resolver/lib/utils/isSubpackage.js
@@ -1247303,7 +1247463,7 @@ var DocsDefinitionResolver = class {
       const jsFilePaths = /* @__PURE__ */ new Set();
       await Promise.all(this._parsedDocsConfig.experimental.mdxComponents.map(async (filepath) => {
         const absoluteFilePath = resolve(this.docsWorkspace.absoluteFilepath, filepath);
-        const stats = await (0, import_promises36.stat)(absoluteFilePath);
+        const stats = await (0, import_promises37.stat)(absoluteFilePath);
         if (stats.isDirectory()) {
           const files = await listFiles(absoluteFilePath, "{js,ts,jsx,tsx}");
           files.forEach((file) => {
@@ -1247315,7 +1247475,7 @@ var DocsDefinitionResolver = class {
       }));
       jsFiles = Object.fromEntries(await Promise.all([...jsFilePaths].map(async (filePath) => {
         const relativeFilePath = this.toRelativeFilepath(filePath);
-        const contents = (await (0, import_promises36.readFile)(filePath)).toString();
+        const contents = (await (0, import_promises37.readFile)(filePath)).toString();
         return [relativeFilePath, contents];
       })));
     }
@@ -1247735,7 +1247895,7 @@ function convertAvailability5(availability) {
 var import_cors = __toESM(require_lib20(), 1);
 var import_express = __toESM(require_express3(), 1);
 var import_http2 = __toESM(require("http"), 1);
-var import_path29 = __toESM(require("path"), 1);
+var import_path30 = __toESM(require("path"), 1);
 
 // ../../../node_modules/.pnpm/watcher@2.3.1/node_modules/watcher/dist/watcher.js
 var import_node_events = require("events");
@@ -1249392,10 +1249552,10 @@ var import_websocket_server = __toESM(require_websocket_server(), 1);
 // ../docs-preview/lib/downloadLocalDocsBundle.js
 var import_decompress = __toESM(require_decompress(), 1);
 var import_fs7 = require("fs");
-var import_promises37 = require("fs/promises");
+var import_promises38 = require("fs/promises");
 var import_os4 = require("os");
-var import_path28 = __toESM(require("path"), 1);
-var import_promises38 = require("stream/promises");
+var import_path29 = __toESM(require("path"), 1);
+var import_promises39 = require("stream/promises");
 var import_tmp_promise5 = __toESM(require_tmp_promise(), 1);
 var import_xml2js = __toESM(require_xml2js(), 1);
 var ETAG_FILENAME = "etag";
@@ -1249426,7 +1249586,7 @@ async function downloadBundle({ bucketUrl, logger, preferCached }) {
     let currentETag = void 0;
     if (currentETagExists) {
       logger.debug("Reading existing ETag");
-      currentETag = (await (0, import_promises37.readFile)(eTagFilepath)).toString();
+      currentETag = (await (0, import_promises38.readFile)(eTagFilepath)).toString();
     }
     if (currentETag != null && currentETag === eTag) {
       logger.debug("ETag matches. Using already downloaded bundle");
@@ -1249440,7 +1249600,7 @@ async function downloadBundle({ bucketUrl, logger, preferCached }) {
   const dir = await import_tmp_promise5.default.dir({ prefix: "fern" });
   const absoluteDirectoryToTmpDir = AbsoluteFilePath.of(dir.path);
   logger.debug(`Created tmp directory ${absoluteDirectoryToTmpDir}`);
-  const docsBundleZipResponse = await fetch(`${import_path28.default.join(bucketUrl, key)}`);
+  const docsBundleZipResponse = await fetch(`${import_path29.default.join(bucketUrl, key)}`);
   const outputZipPath = join(absoluteDirectoryToTmpDir, RelativeFilePath.of("output.zip"));
   const contents = docsBundleZipResponse.body;
   if (contents == null) {
@@ -1249448,18 +1249608,18 @@ async function downloadBundle({ bucketUrl, logger, preferCached }) {
       type: "failure"
     };
   }
-  await (0, import_promises38.pipeline)(contents, (0, import_fs7.createWriteStream)(outputZipPath));
+  await (0, import_promises39.pipeline)(contents, (0, import_fs7.createWriteStream)(outputZipPath));
   logger.debug(`Wrote output.zip to ${outputZipPath}`);
   const absolutePathToPreviewFolder = getPathToPreviewFolder();
   if (await doesPathExist(absolutePathToPreviewFolder)) {
-    await (0, import_promises37.rm)(absolutePathToPreviewFolder, { recursive: true });
+    await (0, import_promises38.rm)(absolutePathToPreviewFolder, { recursive: true });
   }
-  await (0, import_promises37.mkdir)(absolutePathToPreviewFolder, { recursive: true });
+  await (0, import_promises38.mkdir)(absolutePathToPreviewFolder, { recursive: true });
   logger.debug(`rm -rf ${absolutePathToPreviewFolder}`);
   const absolutePathToBundleFolder = getPathToBundleFolder();
-  await (0, import_promises37.mkdir)(absolutePathToBundleFolder, { recursive: true });
+  await (0, import_promises38.mkdir)(absolutePathToBundleFolder, { recursive: true });
   await (0, import_decompress.default)(outputZipPath, absolutePathToBundleFolder);
-  await (0, import_promises37.writeFile)(eTagFilepath, eTag);
+  await (0, import_promises38.writeFile)(eTagFilepath, eTag);
   logger.debug(`Downloaded bundle to ${absolutePathToBundleFolder}`);
   return {
     type: "success"
@@ -1249653,9 +1249813,9 @@ async function runPreviewServer({ initialProject, reloadProject, validateProject
     }
     return next2();
   });
-  app.use("/_next", import_express.default.static(import_path29.default.join(getPathToBundleFolder(), "/_next")));
+  app.use("/_next", import_express.default.static(import_path30.default.join(getPathToBundleFolder(), "/_next")));
   app.use("*", async (_req, res) => {
-    return res.sendFile(import_path29.default.join(getPathToBundleFolder(), "/[[...slug]].html"));
+    return res.sendFile(import_path30.default.join(getPathToBundleFolder(), "/[[...slug]].html"));
   });
   app.listen(port);
   context.logger.info(`Running server on http://localhost:${port}`);
@@ -1250400,7 +1250560,7 @@ function convertRequestWrapperPropertyToString(property5) {
 }
 
 // ../yaml/validator/lib/rules/no-duplicate-declarations/no-duplicate-declarations.js
-var import_path30 = __toESM(require("path"), 1);
+var import_path31 = __toESM(require("path"), 1);
 var NoDuplicateDeclarationsRule = {
   name: "no-duplicate-declarations",
   create: async ({ workspace, logger }) => {
@@ -1250408,7 +1250568,7 @@ var NoDuplicateDeclarationsRule = {
     const seenTypes = {};
     const getRuleViolations = ({ declaredName, relativeFilepath }) => {
       var _a6;
-      const relativeDirectoryPath = import_path30.default.dirname(relativeFilepath);
+      const relativeDirectoryPath = import_path31.default.dirname(relativeFilepath);
       const declarationsForName = (_a6 = declarations[relativeDirectoryPath]) == null ? void 0 : _a6[declaredName];
       if (declarationsForName == null) {
         logger.error(`Could not find declarations for name: ${declaredName}. This is an error in the Fern validator.`);
@@ -1250445,7 +1250605,7 @@ var NoDuplicateDeclarationsRule = {
 async function getDeclarations(workspace) {
   const declarations = {};
   await visitAllDefinitionFiles(workspace, async (relativeFilepath, file) => {
-    const relativeDirectoryPath = import_path30.default.dirname(relativeFilepath);
+    const relativeDirectoryPath = import_path31.default.dirname(relativeFilepath);
     const declarationsForDirectory = declarations[relativeDirectoryPath] ?? (declarations[relativeDirectoryPath] = {});
     const addDeclaration = (declaredName) => {
       (declarationsForDirectory[declaredName] ?? (declarationsForDirectory[declaredName] = [])).push(relativeFilepath);
@@ -1252060,7 +1252220,7 @@ var ValidFieldNamesRule = {
 };
 
 // ../yaml/validator/lib/rules/valid-navigation/valid-navigation.js
-var import_path31 = __toESM(require("path"), 1);
+var import_path32 = __toESM(require("path"), 1);
 var ValidNavigationRule = {
   name: "valid-navigation",
   create: ({ workspace }) => {
@@ -1252069,7 +1252229,7 @@ var ValidNavigationRule = {
     const directoryToChildren = allNamedDefinitionFilepaths.reduce((acc, definitionFilepath) => {
       var _a6;
       const children2 = acc[_a6 = dirname(definitionFilepath)] ?? (acc[_a6] = /* @__PURE__ */ new Set());
-      children2.add(import_path31.default.basename(definitionFilepath));
+      children2.add(import_path32.default.basename(definitionFilepath));
       return acc;
     }, {});
     return {
@@ -1265862,7 +1266022,7 @@ function compile(vfileCompatible, compileOptions) {
 }
 
 // ../../../node_modules/.pnpm/vfile-matter@5.0.0/node_modules/vfile-matter/lib/index.js
-var import_yaml = __toESM(require_dist5(), 1);
+var import_yaml2 = __toESM(require_dist5(), 1);
 var regex3 = /^---(?:\r?\n|\r)(?:([\s\S]*?)(?:\r?\n|\r))?---(?:\r?\n|\r|$)/;
 function matter2(file, options2) {
   const options_ = options2 || {};
@@ -1265871,7 +1266031,7 @@ function matter2(file, options2) {
   let doc = String(file);
   const match = regex3.exec(doc);
   if (match) {
-    file.data.matter = import_yaml.default.parse(match[1], yamlOptions);
+    file.data.matter = import_yaml2.default.parse(match[1], yamlOptions);
     if (strip) {
       doc = doc.slice(match[0].length);
       file.value = file.value && typeof file.value === "object" ? new TextEncoder().encode(doc) : doc;
@@ -1267639,7 +1267799,7 @@ var domain = {
   tokenize: tokenizeDomain,
   partial: true
 };
-var path32 = {
+var path33 = {
   tokenize: tokenizePath,
   partial: true
 };
@@ -1267747,7 +1267907,7 @@ function tokenizeWwwAutolink(effects, ok4, nok) {
     }
     effects.enter("literalAutolink");
     effects.enter("literalAutolinkWww");
-    return effects.check(wwwPrefix, effects.attempt(domain, effects.attempt(path32, wwwAfter), nok), nok)(code4);
+    return effects.check(wwwPrefix, effects.attempt(domain, effects.attempt(path33, wwwAfter), nok), nok)(code4);
   }
   function wwwAfter(code4) {
     effects.exit("literalAutolinkWww");
@@ -1267797,7 +1267957,7 @@ function tokenizeProtocolAutolink(effects, ok4, nok) {
     return nok(code4);
   }
   function afterProtocol(code4) {
-    return code4 === null || asciiControl(code4) || markdownLineEndingOrSpace(code4) || unicodeWhitespace(code4) || unicodePunctuation(code4) ? nok(code4) : effects.attempt(domain, effects.attempt(path32, protocolAfter), nok)(code4);
+    return code4 === null || asciiControl(code4) || markdownLineEndingOrSpace(code4) || unicodeWhitespace(code4) || unicodePunctuation(code4) ? nok(code4) : effects.attempt(domain, effects.attempt(path33, protocolAfter), nok)(code4);
   }
   function protocolAfter(code4) {
     effects.exit("literalAutolinkHttp");
@@ -1269832,7 +1269992,7 @@ var innerPath = function innerPath2(name2, height2) {
       return "";
   }
 };
-var path33 = {
+var path34 = {
   doubleleftarrow: "M262 157\nl10-10c34-36 62.7-77 86-123 3.3-8 5-13.3 5-16 0-5.3-6.7-8-20-8-7.3\n 0-12.2.5-14.5 1.5-2.3 1-4.8 4.5-7.5 10.5-49.3 97.3-121.7 169.3-217 216-28\n 14-57.3 25-88 33-6.7 2-11 3.8-13 5.5-2 1.7-3 4.2-3 7.5s1 5.8 3 7.5\nc2 1.7 6.3 3.5 13 5.5 68 17.3 128.2 47.8 180.5 91.5 52.3 43.7 93.8 96.2 124.5\n 157.5 9.3 8 15.3 12.3 18 13h6c12-.7 18-4 18-10 0-2-1.7-7-5-15-23.3-46-52-87\n-86-123l-10-10h399738v-40H218c328 0 0 0 0 0l-10-8c-26.7-20-65.7-43-117-69 2.7\n-2 6-3.7 10-5 36.7-16 72.3-37.3 107-64l10-8h399782v-40z\nm8 0v40h399730v-40zm0 194v40h399730v-40z",
   doublerightarrow: "M399738 392l\n-10 10c-34 36-62.7 77-86 123-3.3 8-5 13.3-5 16 0 5.3 6.7 8 20 8 7.3 0 12.2-.5\n 14.5-1.5 2.3-1 4.8-4.5 7.5-10.5 49.3-97.3 121.7-169.3 217-216 28-14 57.3-25 88\n-33 6.7-2 11-3.8 13-5.5 2-1.7 3-4.2 3-7.5s-1-5.8-3-7.5c-2-1.7-6.3-3.5-13-5.5-68\n-17.3-128.2-47.8-180.5-91.5-52.3-43.7-93.8-96.2-124.5-157.5-9.3-8-15.3-12.3-18\n-13h-6c-12 .7-18 4-18 10 0 2 1.7 7 5 15 23.3 46 52 87 86 123l10 10H0v40h399782\nc-328 0 0 0 0 0l10 8c26.7 20 65.7 43 117 69-2.7 2-6 3.7-10 5-36.7 16-72.3 37.3\n-107 64l-10 8H0v40zM0 157v40h399730v-40zm0 194v40h399730v-40z",
   leftarrow: "M400000 241H110l3-3c68.7-52.7 113.7-120\n 135-202 4-14.7 6-23 6-25 0-7.3-7-11-21-11-8 0-13.2.8-15.5 2.5-2.3 1.7-4.2 5.8\n-5.5 12.5-1.3 4.7-2.7 10.3-4 17-12 48.7-34.8 92-68.5 130S65.3 228.3 18 247\nc-10 4-16 7.7-18 11 0 8.7 6 14.3 18 17 47.3 18.7 87.8 47 121.5 85S196 441.3 208\n 490c.7 2 1.3 5 2 9s1.2 6.7 1.5 8c.3 1.3 1 3.3 2 6s2.2 4.5 3.5 5.5c1.3 1 3.3\n 1.8 6 2.5s6 1 10 1c14 0 21-3.7 21-11 0-2-2-10.3-6-25-20-79.3-65-146.7-135-202\n l-3-3h399890zM100 241v40h399900v-40z",
@@ -1272739,7 +1272899,7 @@ var PathNode = class {
     if (this.alternate) {
       node2.setAttribute("d", this.alternate);
     } else {
-      node2.setAttribute("d", path33[this.pathName]);
+      node2.setAttribute("d", path34[this.pathName]);
     }
     return node2;
   }
@@ -1272747,7 +1272907,7 @@ var PathNode = class {
     if (this.alternate) {
       return '<path d="' + utils.escape(this.alternate) + '"/>';
     } else {
-      return '<path d="' + utils.escape(path33[this.pathName]) + '"/>';
+      return '<path d="' + utils.escape(path34[this.pathName]) + '"/>';
     }
   }
 };
@@ -1292050,8 +1292210,8 @@ function createDocsConfigFileAstVisitorForRules({ relativeFilepath, allRuleVisit
 }
 
 // ../yaml/docs-validator/lib/docsAst/visitDocsConfigFileAst.js
-var import_promises39 = require("fs/promises");
-var import_path32 = __toESM(require("path"), 1);
+var import_promises40 = require("fs/promises");
+var import_path33 = __toESM(require("path"), 1);
 async function visitDocsConfigFileYamlAst(contents, visitor, absoluteFilepathToConfiguration, absolutePathToFernFolder, context, loadAPIWorkspace2) {
   var _a6, _b4, _c4, _d2, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p;
   await ((_a6 = visitor.file) == null ? void 0 : _a6.call(visitor, {
@@ -1292090,7 +1292250,7 @@ async function visitDocsConfigFileYamlAst(contents, visitor, absoluteFilepathToC
     for (const filepath of filepaths) {
       await ((_b4 = visitor.filepath) == null ? void 0 : _b4.call(visitor, {
         absoluteFilepath: filepath,
-        value: import_path32.default.relative(absolutePathToFernFolder, filepath),
+        value: import_path33.default.relative(absolutePathToFernFolder, filepath),
         willBeUploaded: true
       }, [relativePath]));
     }
@@ -1292251,7 +1292411,7 @@ async function visitDocsConfigFileYamlAst(contents, visitor, absoluteFilepathToC
         willBeUploaded: false
       });
       const absoluteFilepath = resolve(dirname(absoluteFilepathToConfiguration), version3.path);
-      const content3 = js_yaml_default.load((await (0, import_promises39.readFile)(absoluteFilepath)).toString());
+      const content3 = js_yaml_default.load((await (0, import_promises40.readFile)(absoluteFilepath)).toString());
       if (await doesPathExist(absoluteFilepath)) {
         await ((_a7 = visitor.versionFile) == null ? void 0 : _a7.call(visitor, {
           path: version3.path,
@@ -1292322,7 +1292482,7 @@ async function visitNavigationItem({ navigationItem, visitor, nodePath, absolute
     });
     const absoluteFilepath = resolve(dirname(absoluteFilepathToConfiguration), navigationItem.path);
     if (await doesPathExist(absoluteFilepath)) {
-      const content3 = (await (0, import_promises39.readFile)(absoluteFilepath)).toString();
+      const content3 = (await (0, import_promises40.readFile)(absoluteFilepath)).toString();
       await ((_a6 = visitor.markdownPage) == null ? void 0 : _a6.call(visitor, {
         title: navigationItem.page,
         content: content3,
@@ -1294751,8 +1294911,8 @@ var supportedExtensions = new Set(extensions);
 var supportedMimeTypes = new Set(mimeTypes);
 
 // ../yaml/docs-validator/lib/rules/valid-file-types/valid-file-types.js
-var import_promises40 = require("fs/promises");
-var import_path33 = __toESM(require("path"), 1);
+var import_promises41 = require("fs/promises");
+var import_path34 = __toESM(require("path"), 1);
 var ALLOWED_FILE_TYPES = /* @__PURE__ */ new Set([
   "image/jpeg",
   "image/png",
@@ -1294828,7 +1294988,7 @@ var ValidFileTypes = {
   }
 };
 var getViolationsForFile = async (absoluteFilepath) => {
-  const file = await (0, import_promises40.readFile)(absoluteFilepath);
+  const file = await (0, import_promises41.readFile)(absoluteFilepath);
   const fileType = await fileTypeFromBuffer(file);
   if (fileType != null) {
     if (ALLOWED_FILE_TYPES.has(fileType.mime)) {
@@ -1294842,7 +1295002,7 @@ var getViolationsForFile = async (absoluteFilepath) => {
       ];
     }
   }
-  let extension2 = import_path33.default.extname(absoluteFilepath).toLowerCase();
+  let extension2 = import_path34.default.extname(absoluteFilepath).toLowerCase();
   if (extension2.startsWith(".")) {
     extension2 = extension2.substring(1);
   }
@@ -1295029,8 +1295189,8 @@ async function formatWorkspaces({
 }
 
 // src/commands/generate-fdr/generateFdrApiDefinitionForWorkspaces.ts
-var import_promises41 = require("fs/promises");
-var import_path34 = __toESM(require("path"), 1);
+var import_promises42 = require("fs/promises");
+var import_path35 = __toESM(require("path"), 1);
 
 // src/commands/generate-ir/generateIrForFernWorkspace.ts
 async function generateIrForFernWorkspace({
@@ -1295083,8 +1295243,8 @@ async function generateFdrApiDefinitionForWorkspaces({
           ir,
           snippetsConfig: {}
         });
-        const resolvedOutputFilePath = import_path34.default.resolve(outputFilepath);
-        await (0, import_promises41.writeFile)(resolvedOutputFilePath, await stringifyLargeObject(apiDefinition, { pretty: true }));
+        const resolvedOutputFilePath = import_path35.default.resolve(outputFilepath);
+        await (0, import_promises42.writeFile)(resolvedOutputFilePath, await stringifyLargeObject(apiDefinition, { pretty: true }));
         context.logger.info(`Wrote FDR API definition to ${resolvedOutputFilePath}`);
       });
     })
@@ -1305599,8 +1305759,8 @@ function migrateIntermediateRepresentationThroughVersion({ intermediateRepresent
 }
 
 // src/commands/generate-ir/generateIrForWorkspaces.ts
-var import_promises42 = require("fs/promises");
-var import_path35 = __toESM(require("path"), 1);
+var import_promises43 = require("fs/promises");
+var import_path36 = __toESM(require("path"), 1);
 async function generateIrForWorkspaces({
   project,
   irFilepath,
@@ -1305628,8 +1305788,8 @@ async function generateIrForWorkspaces({
           version: version3,
           readme
         });
-        const irOutputFilePath = import_path35.default.resolve(irFilepath);
-        await (0, import_promises42.writeFile)(
+        const irOutputFilePath = import_path36.default.resolve(irFilepath);
+        await (0, import_promises43.writeFile)(
           irOutputFilePath,
           await stringifyLargeObject(intermediateRepresentation, { pretty: true })
         );
@@ -1305672,8 +1305832,8 @@ async function getIntermediateRepresentation({
 }
 
 // src/commands/generate-openapi-ir/generateOpenAPIIrForWorkspaces.ts
-var import_promises43 = require("fs/promises");
-var import_path36 = __toESM(require("path"), 1);
+var import_promises44 = require("fs/promises");
+var import_path37 = __toESM(require("path"), 1);
 async function generateOpenAPIIrForWorkspaces({
   project,
   irFilepath,
@@ -1305693,11 +1305853,11 @@ async function generateOpenAPIIrForWorkspaces({
           specs: openAPISpecs,
           taskContext: context
         });
-        const irOutputFilePath = import_path36.default.resolve(irFilepath);
+        const irOutputFilePath = import_path37.default.resolve(irFilepath);
         const openApiIrJson = await serialization_exports3.OpenApiIntermediateRepresentation.jsonOrThrow(openAPIIr, {
           skipValidation: true
         });
-        await (0, import_promises43.writeFile)(irOutputFilePath, await stringifyLargeObject(openApiIrJson, { pretty: true }));
+        await (0, import_promises44.writeFile)(irOutputFilePath, await stringifyLargeObject(openApiIrJson, { pretty: true }));
         context.logger.info(`Wrote IR to ${irOutputFilePath}`);
       });
     })
@@ -1305705,7 +1305865,7 @@ async function generateOpenAPIIrForWorkspaces({
 }
 
 // src/commands/generate-overrides/writeOverridesForWorkspaces.ts
-var import_promises44 = require("fs/promises");
+var import_promises45 = require("fs/promises");
 async function writeOverridesForWorkspaces({
   project,
   includeModels,
@@ -1305730,7 +1305890,7 @@ async function writeOverridesForWorkspaces({
 async function readExistingOverrides(overridesFilepath, context) {
   let parsedOverrides = null;
   try {
-    const contents = (await (0, import_promises44.readFile)(overridesFilepath, "utf8")).toString();
+    const contents = (await (0, import_promises45.readFile)(overridesFilepath, "utf8")).toString();
     try {
       parsedOverrides = JSON.parse(contents);
     } catch (err) {
@@ -1305788,7 +1305948,7 @@ async function writeDefinitionForOpenAPIWorkspace({
       }
     }
     const components = { schemas };
-    await (0, import_promises44.writeFile)(
+    await (0, import_promises45.writeFile)(
       join(dirname(spec.absoluteFilepath), RelativeFilePath.of("openapi-overrides.yml")),
       js_yaml_default.dump({ paths, components })
     );
@@ -1305806,15 +1305966,15 @@ var import_generator_exec_sdk = __toESM(require_generator_exec_sdk(), 1);
 var import_api3 = __toESM(require_api35(), 1);
 
 // ../generation/local-generation/local-workspace-runner/lib/constants.js
-var import_path37 = __toESM(require("path"), 1);
+var import_path38 = __toESM(require("path"), 1);
 var DOCKER_FERN_DIRECTORY = "/fern";
-var DOCKER_CODEGEN_OUTPUT_DIRECTORY = import_path37.default.join(DOCKER_FERN_DIRECTORY, "output");
-var DOCKER_GENERATOR_CONFIG_PATH = import_path37.default.join(DOCKER_FERN_DIRECTORY, "config.json");
-var DOCKER_PATH_TO_IR = import_path37.default.join(DOCKER_FERN_DIRECTORY, "ir.json");
-var DOCKER_PATH_TO_SNIPPET = import_path37.default.join(DOCKER_FERN_DIRECTORY, "snippet.json");
-var DOCKER_PATH_TO_SNIPPET_TEMPLATES = import_path37.default.join(DOCKER_FERN_DIRECTORY, "snippet-templates.json");
-var DOCKER_GENERATORS_DIRECTORY = import_path37.default.join(DOCKER_FERN_DIRECTORY, "generators");
-var DOCKER_SOURCES_DIRECTORY = import_path37.default.join(DOCKER_FERN_DIRECTORY, "sources");
+var DOCKER_CODEGEN_OUTPUT_DIRECTORY = import_path38.default.join(DOCKER_FERN_DIRECTORY, "output");
+var DOCKER_GENERATOR_CONFIG_PATH = import_path38.default.join(DOCKER_FERN_DIRECTORY, "config.json");
+var DOCKER_PATH_TO_IR = import_path38.default.join(DOCKER_FERN_DIRECTORY, "ir.json");
+var DOCKER_PATH_TO_SNIPPET = import_path38.default.join(DOCKER_FERN_DIRECTORY, "snippet.json");
+var DOCKER_PATH_TO_SNIPPET_TEMPLATES = import_path38.default.join(DOCKER_FERN_DIRECTORY, "snippet-templates.json");
+var DOCKER_GENERATORS_DIRECTORY = import_path38.default.join(DOCKER_FERN_DIRECTORY, "generators");
+var DOCKER_SOURCES_DIRECTORY = import_path38.default.join(DOCKER_FERN_DIRECTORY, "sources");
 
 // ../generation/local-generation/local-workspace-runner/lib/getGeneratorConfig.js
 var DEFAULT_OUTPUT_VERSION = "0.0.1";
@@ -1306061,7 +1306221,7 @@ async function getIntermediateRepresentation2({ workspace, audiences, generatorI
 
 // ../generation/local-generation/docker-utils/lib/runDocker.js
 var import_dockerode2 = __toESM(require_docker(), 1);
-var import_promises45 = require("fs/promises");
+var import_promises46 = require("fs/promises");
 var import_stream3 = require("stream");
 var import_tmp_promise6 = __toESM(require_tmp_promise(), 1);
 async function runDocker({ imageName, args, binds, writeLogsToFile = true, removeAfterCompletion = false }) {
@@ -1306100,7 +1306260,7 @@ async function tryRunDocker({ docker, imageName, args, binds, removeAfterComplet
   if (status.StatusCode !== 0) {
     if (writeLogsToFile) {
       const tmpFile = await import_tmp_promise6.default.file();
-      await (0, import_promises45.writeFile)(tmpFile.path, logs);
+      await (0, import_promises46.writeFile)(tmpFile.path, logs);
       throw new Error(`Docker exited with a non-zero exit code. Logs here: ${tmpFile.path}`);
     } else {
       throw new Error("Docker exited with a non-zero exit code.");
@@ -1306122,12 +1306282,12 @@ async function pullImage(docker, imageName) {
 
 // ../generation/local-generation/local-workspace-runner/lib/runGenerator.js
 var FernGeneratorExecParsing = __toESM(require_serialization33(), 1);
-var import_promises47 = require("fs/promises");
+var import_promises48 = require("fs/promises");
 var import_tmp_promise8 = __toESM(require_tmp_promise(), 1);
 
 // ../generation/local-generation/local-workspace-runner/lib/LocalTaskHandler.js
 var import_decompress2 = __toESM(require_decompress(), 1);
-var import_promises46 = require("fs/promises");
+var import_promises47 = require("fs/promises");
 var import_tmp_promise7 = __toESM(require_tmp_promise(), 1);
 var LocalTaskHandler = class {
   context;
@@ -1306173,7 +1306333,7 @@ var LocalTaskHandler = class {
     const tmpOutputResolutionDir = AbsoluteFilePath.of((await import_tmp_promise7.default.dir({})).path);
     const absolutePathToFernignore = AbsoluteFilePath.of(join(this.absolutePathToLocalOutput, RelativeFilePath.of(FERNIGNORE_FILENAME)));
     const fernIngnorePaths = await getFernIgnorePaths({ absolutePathToFernignore });
-    await (0, import_promises46.cp)(this.absolutePathToLocalOutput, tmpOutputResolutionDir, { recursive: true });
+    await (0, import_promises47.cp)(this.absolutePathToLocalOutput, tmpOutputResolutionDir, { recursive: true });
     await this.runGitCommand(["init"], tmpOutputResolutionDir);
     await this.runGitCommand(["add", "."], tmpOutputResolutionDir);
     const response = await this.runGitCommand(["config", "--list"], tmpOutputResolutionDir);
@@ -1306186,16 +1306346,16 @@ var LocalTaskHandler = class {
     await this.copyGeneratedFilesToDirectory(tmpOutputResolutionDir);
     await this.runGitCommand(["reset", "--", ...fernIngnorePaths], tmpOutputResolutionDir);
     await this.runGitCommand(["restore", "."], tmpOutputResolutionDir);
-    await (0, import_promises46.rmdir)(this.absolutePathToLocalOutput, { recursive: true });
-    await (0, import_promises46.cp)(tmpOutputResolutionDir, this.absolutePathToLocalOutput, { recursive: true });
+    await (0, import_promises47.rmdir)(this.absolutePathToLocalOutput, { recursive: true });
+    await (0, import_promises47.cp)(tmpOutputResolutionDir, this.absolutePathToLocalOutput, { recursive: true });
   }
   async copyGeneratedFilesNoFernIgnore() {
     this.context.logger.debug(`rm -rf ${this.absolutePathToLocalOutput}`);
-    await (0, import_promises46.rm)(this.absolutePathToLocalOutput, { force: true, recursive: true });
+    await (0, import_promises47.rm)(this.absolutePathToLocalOutput, { force: true, recursive: true });
     await this.copyGeneratedFilesToDirectory(this.absolutePathToLocalOutput);
   }
   async copyGeneratedFilesToDirectory(outputPath) {
-    const [firstLocalOutputItem, ...remaininglocalOutputItems] = await (0, import_promises46.readdir)(this.absolutePathToTmpOutputDirectory);
+    const [firstLocalOutputItem, ...remaininglocalOutputItems] = await (0, import_promises47.readdir)(this.absolutePathToTmpOutputDirectory);
     if (firstLocalOutputItem == null) {
       return;
     }
@@ -1306203,15 +1306363,15 @@ var LocalTaskHandler = class {
     if (firstLocalOutputItem.endsWith(".zip")) {
       await (0, import_decompress2.default)(join(this.absolutePathToTmpOutputDirectory, RelativeFilePath.of(firstLocalOutputItem)), outputPath);
       for (const localOutputItem of remaininglocalOutputItems) {
-        await (0, import_promises46.cp)(join(this.absolutePathToTmpOutputDirectory, RelativeFilePath.of(localOutputItem)), join(outputPath, RelativeFilePath.of(localOutputItem)), { recursive: true });
+        await (0, import_promises47.cp)(join(this.absolutePathToTmpOutputDirectory, RelativeFilePath.of(localOutputItem)), join(outputPath, RelativeFilePath.of(localOutputItem)), { recursive: true });
       }
     } else {
-      await (0, import_promises46.cp)(this.absolutePathToTmpOutputDirectory, outputPath, { recursive: true });
+      await (0, import_promises47.cp)(this.absolutePathToTmpOutputDirectory, outputPath, { recursive: true });
     }
   }
   async copySnippetJSON({ absolutePathToTmpSnippetJSON, absolutePathToLocalSnippetJSON }) {
     this.context.logger.debug(`Copying generated snippets to ${absolutePathToLocalSnippetJSON}`);
-    await (0, import_promises46.cp)(absolutePathToTmpSnippetJSON, absolutePathToLocalSnippetJSON);
+    await (0, import_promises47.cp)(absolutePathToTmpSnippetJSON, absolutePathToLocalSnippetJSON);
   }
   async runGitCommand(options2, cwd2) {
     const response = await loggingExeca(this.context.logger, "git", options2, {
@@ -1306223,7 +1306383,7 @@ var LocalTaskHandler = class {
 };
 var NEW_LINE_REGEX = /\r?\n/;
 async function getFernIgnorePaths({ absolutePathToFernignore }) {
-  const fernIgnoreFileContents = (await (0, import_promises46.readFile)(absolutePathToFernignore)).toString();
+  const fernIgnoreFileContents = (await (0, import_promises47.readFile)(absolutePathToFernignore)).toString();
   return [
     FERNIGNORE_FILENAME,
     ...fernIgnoreFileContents.trim().split(NEW_LINE_REGEX).filter((line) => !line.startsWith("#") && line.length > 0)
@@ -1306316,7 +1306476,7 @@ async function writeIrToFile({ workspace, audiences, generatorInvocation, worksp
     tmpdir: workspaceTempDir.path
   });
   const absolutePathToIr = AbsoluteFilePath.of(irFile.path);
-  await (0, import_promises47.writeFile)(absolutePathToIr, JSON.stringify(intermediateRepresentation, void 0, 4));
+  await (0, import_promises48.writeFile)(absolutePathToIr, JSON.stringify(intermediateRepresentation, void 0, 4));
   context.logger.debug(`Wrote IR to ${absolutePathToIr}`);
   return absolutePathToIr;
 }
@@ -1306348,7 +1306508,7 @@ async function runGenerator({ workspaceName, organization, outputVersion, absolu
   if (!parsedConfig.ok) {
     throw new Error(`Failed to parse config.json into ${absolutePathToWriteConfigJson}`);
   }
-  await (0, import_promises47.writeFile)(absolutePathToWriteConfigJson, JSON.stringify(parsedConfig.value, void 0, 4));
+  await (0, import_promises48.writeFile)(absolutePathToWriteConfigJson, JSON.stringify(parsedConfig.value, void 0, 4));
   const doesConfigJsonExist = await waitUntilPathExists(absolutePathToWriteConfigJson, 5e3);
   if (!doesConfigJsonExist) {
     throw new Error(`Failed to create ${absolutePathToWriteConfigJson}`);
@@ -1306379,7 +1306539,7 @@ function getDockerDestinationForSource(source) {
 
 // ../generation/local-generation/local-workspace-runner/lib/runLocalGenerationForWorkspace.js
 var import_os5 = __toESM(require("os"), 1);
-var import_path38 = __toESM(require("path"), 1);
+var import_path39 = __toESM(require("path"), 1);
 var import_tmp_promise9 = __toESM(require_tmp_promise(), 1);
 async function runLocalGenerationForWorkspace({ projectConfig, workspace, generatorGroup, keepDocker, context }) {
   const workspaceTempDir = await getWorkspaceTempDir();
@@ -1306422,7 +1306582,7 @@ async function runLocalGenerationForWorkspace({ projectConfig, workspace, genera
 }
 async function getWorkspaceTempDir() {
   return import_tmp_promise9.default.dir({
-    tmpdir: import_os5.default.platform() === "darwin" ? import_path38.default.join("/private", import_os5.default.tmpdir()) : void 0,
+    tmpdir: import_os5.default.platform() === "darwin" ? import_path39.default.join("/private", import_os5.default.tmpdir()) : void 0,
     prefix: "fern"
   });
 }
@@ -1306433,8 +1306593,8 @@ var import_fiddle_sdk5 = __toESM(require_fiddle_sdk(), 1);
 // ../generation/remote-generation/remote-workspace-runner/lib/downloadSnippetsForTask.js
 var import_axios5 = __toESM(require_axios4(), 1);
 var import_fs8 = require("fs");
-var import_promises48 = require("fs/promises");
-var import_promises49 = require("stream/promises");
+var import_promises49 = require("fs/promises");
+var import_promises50 = require("stream/promises");
 async function downloadSnippetsForTask({ snippetsS3PreSignedReadUrl, absolutePathToLocalSnippetJSON, context }) {
   try {
     await downloadFileForTask({
@@ -1306451,18 +1306611,18 @@ async function downloadFileForTask({ s3PreSignedReadUrl, absolutePathToLocalOutp
     responseType: "stream"
   });
   if (await doesPathExist(absolutePathToLocalOutput)) {
-    await (0, import_promises48.rm)(absolutePathToLocalOutput, { recursive: true });
+    await (0, import_promises49.rm)(absolutePathToLocalOutput, { recursive: true });
   }
-  await (0, import_promises48.mkdir)(dirname(absolutePathToLocalOutput), { recursive: true });
-  await (0, import_promises49.pipeline)(request.data, (0, import_fs8.createWriteStream)(absolutePathToLocalOutput));
+  await (0, import_promises49.mkdir)(dirname(absolutePathToLocalOutput), { recursive: true });
+  await (0, import_promises50.pipeline)(request.data, (0, import_fs8.createWriteStream)(absolutePathToLocalOutput));
 }
 
 // ../generation/remote-generation/remote-workspace-runner/lib/createAndStartJob.js
 var import_fiddle_sdk4 = __toESM(require_fiddle_sdk(), 1);
 var import_axios6 = __toESM(require_axios4(), 1);
 var import_form_data2 = __toESM(require_form_data(), 1);
-var import_promises50 = require("fs/promises");
-var import_path39 = require("path");
+var import_promises51 = require("fs/promises");
+var import_path40 = require("path");
 var import_tar2 = __toESM(require_tar(), 1);
 var import_tmp_promise10 = __toESM(require_tmp_promise(), 1);
 async function createAndStartJob({ projectConfig, workspace, organization, intermediateRepresentation, generatorInvocation, version: version3, context, shouldLogS3Url, token, whitelabel, irVersionOverride, absolutePathToPreview }) {
@@ -1306502,23 +1306662,23 @@ async function createJob({ projectConfig, workspace, organization, generatorInvo
       context.logger.debug(`Writing mock fern definition to ${absolutePathToTmpDir}`);
       const absolutePathToTmpFernDirectory = join(absolutePathToTmpDir, RelativeFilePath.of(FERN_DIRECTORY));
       const absolutePathToTmpDefinitionDirectory = join(absolutePathToTmpFernDirectory, RelativeFilePath.of(DEFINITION_DIRECTORY));
-      await (0, import_promises50.mkdir)(absolutePathToTmpDefinitionDirectory, { recursive: true });
+      await (0, import_promises51.mkdir)(absolutePathToTmpDefinitionDirectory, { recursive: true });
       const absolutePathToApiYml = join(absolutePathToTmpDefinitionDirectory, RelativeFilePath.of(ROOT_API_FILENAME));
-      await (0, import_promises50.writeFile)(absolutePathToApiYml, js_yaml_default.dump(workspace.definition.rootApiFile.contents));
+      await (0, import_promises51.writeFile)(absolutePathToApiYml, js_yaml_default.dump(workspace.definition.rootApiFile.contents));
       await writeFernDefinition({
         absolutePathToDefinitionDirectory: absolutePathToTmpDefinitionDirectory,
         definition: workspace.definition
       });
       const absolutePathToFernConfigJson = join(absolutePathToTmpFernDirectory, RelativeFilePath.of(PROJECT_CONFIG_FILENAME));
-      await (0, import_promises50.writeFile)(absolutePathToFernConfigJson, JSON.stringify(projectConfig.rawConfig, void 0, 2));
+      await (0, import_promises51.writeFile)(absolutePathToFernConfigJson, JSON.stringify(projectConfig.rawConfig, void 0, 2));
       try {
         const sources = workspace.getSources();
         for (const source of sources) {
-          const sourceContents = await (0, import_promises50.readFile)(source.absoluteFilePath);
-          const relativeLocation = (0, import_path39.relative)(workspace.absoluteFilepath, source.absoluteFilePath);
+          const sourceContents = await (0, import_promises51.readFile)(source.absoluteFilePath);
+          const relativeLocation = (0, import_path40.relative)(workspace.absoluteFilepath, source.absoluteFilePath);
           const absolutePathToSourceFile = join(absolutePathToTmpFernDirectory, RelativeFilePath.of(relativeLocation));
-          await (0, import_promises50.mkdir)(dirname(absolutePathToSourceFile), { recursive: true });
-          await (0, import_promises50.writeFile)(absolutePathToSourceFile, sourceContents);
+          await (0, import_promises51.mkdir)(dirname(absolutePathToSourceFile), { recursive: true });
+          await (0, import_promises51.writeFile)(absolutePathToSourceFile, sourceContents);
         }
       } catch (error) {
         context.logger.debug(`Failed to write source files to disk, continuing: ${error}`);
@@ -1306541,7 +1306701,7 @@ async function createJob({ projectConfig, workspace, organization, generatorInvo
         }
       } else {
         context.logger.debug("Uploading definition...");
-        await import_axios6.default.put(definitionUploadUrlRequest.body.s3Url, await (0, import_promises50.readFile)(tarPath));
+        await import_axios6.default.put(definitionUploadUrlRequest.body.s3Url, await (0, import_promises51.readFile)(tarPath));
         fernDefinitionMetadata = {
           definitionS3DownloadUrl: definitionUploadUrlRequest.body.s3Url,
           outputPath: ".mock",
@@ -1306603,14 +1306763,14 @@ async function createJob({ projectConfig, workspace, organization, generatorInvo
 async function writeFernDefinition({ absolutePathToDefinitionDirectory, definition: definition3 }) {
   for (const [relativePath, definitionFile] of Object.entries(definition3.namedDefinitionFiles)) {
     const absolutePathToDefinitionFile = join(absolutePathToDefinitionDirectory, RelativeFilePath.of(relativePath));
-    await (0, import_promises50.mkdir)(dirname(absolutePathToDefinitionFile), { recursive: true });
-    await (0, import_promises50.writeFile)(absolutePathToDefinitionFile, js_yaml_default.dump(definitionFile.contents));
+    await (0, import_promises51.mkdir)(dirname(absolutePathToDefinitionFile), { recursive: true });
+    await (0, import_promises51.writeFile)(absolutePathToDefinitionFile, js_yaml_default.dump(definitionFile.contents));
   }
   for (const [relativePath, packageMarker] of Object.entries(definition3.packageMarkers)) {
     if (packageMarker.contents.export == null) {
       const absolutePathToPackageMarker = join(absolutePathToDefinitionDirectory, RelativeFilePath.of(relativePath));
-      await (0, import_promises50.mkdir)(dirname(absolutePathToPackageMarker), { recursive: true });
-      await (0, import_promises50.writeFile)(absolutePathToPackageMarker, js_yaml_default.dump(packageMarker.contents));
+      await (0, import_promises51.mkdir)(dirname(absolutePathToPackageMarker), { recursive: true });
+      await (0, import_promises51.writeFile)(absolutePathToPackageMarker, js_yaml_default.dump(packageMarker.contents));
     }
   }
   for (const [relativePath, importedDefinition] of Object.entries(definition3.importedDefinitions)) {
@@ -1306726,9 +1306886,9 @@ function pollJobAndReportStatus({ job, taskId, taskHandler, context }) {
 var import_axios7 = __toESM(require_axios4(), 1);
 var import_decompress3 = __toESM(require_decompress(), 1);
 var import_fs9 = require("fs");
-var import_promises51 = require("fs/promises");
-var import_path40 = __toESM(require("path"), 1);
-var import_promises52 = require("stream/promises");
+var import_promises52 = require("fs/promises");
+var import_path41 = __toESM(require("path"), 1);
+var import_promises53 = require("stream/promises");
 var import_tmp_promise11 = __toESM(require_tmp_promise(), 1);
 var _isFinished, _createdSnippets, _snippetsS3PreSignedReadUrl;
 var RemoteTaskHandler = class {
@@ -1306812,7 +1306972,7 @@ var RemoteTaskHandler = class {
     } : void 0;
   }
   getAbsolutePathToLocalOutput() {
-    return this.absolutePathToPreview != null ? join(this.absolutePathToPreview, RelativeFilePath.of(import_path40.default.basename(this.generatorInvocation.name))) : this.generatorInvocation.absolutePathToLocalOutput;
+    return this.absolutePathToPreview != null ? join(this.absolutePathToPreview, RelativeFilePath.of(import_path41.default.basename(this.generatorInvocation.name))) : this.generatorInvocation.absolutePathToLocalOutput;
   }
   get isFinished() {
     return __privateGet(this, _isFinished);
@@ -1306843,12 +1307003,12 @@ async function downloadZipForTask({ s3PreSignedReadUrl, absolutePathToLocalOutpu
     responseType: "stream"
   });
   const tmpDir = await import_tmp_promise11.default.dir({ prefix: "fern", unsafeCleanup: true });
-  const outputZipPath = import_path40.default.join(tmpDir.path, "output.zip");
-  await (0, import_promises52.pipeline)(request.data, (0, import_fs9.createWriteStream)(outputZipPath));
+  const outputZipPath = import_path41.default.join(tmpDir.path, "output.zip");
+  await (0, import_promises53.pipeline)(request.data, (0, import_fs9.createWriteStream)(outputZipPath));
   if (await doesPathExist(absolutePathToLocalOutput)) {
-    await (0, import_promises51.rm)(absolutePathToLocalOutput, { recursive: true });
+    await (0, import_promises52.rm)(absolutePathToLocalOutput, { recursive: true });
   }
-  await (0, import_promises51.mkdir)(absolutePathToLocalOutput, { recursive: true });
+  await (0, import_promises52.mkdir)(absolutePathToLocalOutput, { recursive: true });
   await (0, import_decompress3.default)(outputZipPath, absolutePathToLocalOutput);
 }
 function convertLogLevel(logLevel) {
@@ -1306867,7 +1307027,7 @@ function convertLogLevel(logLevel) {
 }
 
 // ../generation/remote-generation/remote-workspace-runner/lib/SourceUploader.js
-var import_promises53 = require("fs/promises");
+var import_promises54 = require("fs/promises");
 var import_tmp_promise12 = __toESM(require_tmp_promise(), 1);
 var PROTOBUF_ZIP_FILENAME = "proto.zip";
 var SourceUploader = class {
@@ -1306888,7 +1307048,7 @@ var SourceUploader = class {
   }
   async uploadSource(source, uploadURL) {
     const uploadCommand = await this.getUploadCommand(source);
-    const fileData = await (0, import_promises53.readFile)(uploadCommand.absoluteFilePath);
+    const fileData = await (0, import_promises54.readFile)(uploadCommand.absoluteFilePath);
     const response = await fetch(uploadURL, {
       method: "PUT",
       body: fileData,
@@ -1306908,7 +1307068,7 @@ var SourceUploader = class {
         absoluteFilePath,
         cleanup: async () => {
           this.context.logger.debug(`Removing ${absoluteFilePath}`);
-          await (0, import_promises53.unlink)(absoluteFilePath);
+          await (0, import_promises54.unlink)(absoluteFilePath);
         }
       };
     }
@@ -1307153,7 +1307313,7 @@ async function runRemoteGenerationForAPIWorkspace({ projectConfig, organization,
 
 // ../generation/remote-generation/remote-workspace-runner/lib/publishDocs.js
 var import_axios8 = __toESM(require_axios4(), 1);
-var import_promises54 = require("fs/promises");
+var import_promises55 = require("fs/promises");
 var mime = __toESM(require_mime_types(), 1);
 
 // ../generation/remote-generation/remote-workspace-runner/lib/measureImageSizes.js
@@ -1307308,7 +1307468,7 @@ async function uploadFiles(filesToUpload, docsWorkspacePath, context, batchSize)
       const absoluteFilePath = resolve(docsWorkspacePath, relativeFilePath);
       try {
         const mimeType = mime.lookup(absoluteFilePath);
-        await import_axios8.default.put(uploadUrl, await (0, import_promises54.readFile)(absoluteFilePath), {
+        await import_axios8.default.put(uploadUrl, await (0, import_promises55.readFile)(absoluteFilePath), {
           headers: {
             "Content-Type": mimeType === false ? "application/octet-stream" : mimeType
           }
@@ -1307928,8 +1308088,8 @@ async function mockServer({
 // src/commands/register/registerWorkspacesV1.ts
 var import_fiddle_sdk6 = __toESM(require_fiddle_sdk(), 1);
 var import_axios9 = __toESM(require_axios4(), 1);
-var import_promises55 = require("fs/promises");
-var import_path41 = __toESM(require("path"), 1);
+var import_promises56 = require("fs/promises");
+var import_path42 = __toESM(require("path"), 1);
 var import_tar3 = __toESM(require_tar(), 1);
 var import_tmp_promise13 = __toESM(require_tmp_promise(), 1);
 async function registerWorkspacesV1({
@@ -1307974,11 +1308134,11 @@ async function registerWorkspacesV1({
           return;
         }
         const tmpDir = await import_tmp_promise13.default.dir();
-        const tarPath = import_path41.default.join(tmpDir.path, "definition.tgz");
+        const tarPath = import_path42.default.join(tmpDir.path, "definition.tgz");
         context.logger.debug(`Compressing definition at ${tmpDir.path}`);
         await import_tar3.default.create({ file: tarPath, cwd: resolvedWorkspace.absoluteFilepath }, ["."]);
         context.logger.info("Uploading definition...");
-        await import_axios9.default.put(registerApiResponse.body.definitionS3UploadUrl, await (0, import_promises55.readFile)(tarPath));
+        await import_axios9.default.put(registerApiResponse.body.definitionS3UploadUrl, await (0, import_promises56.readFile)(tarPath));
         context.logger.info(
           `Registered @${project.config.organization}/${resolvedWorkspace.definition.rootApiFile.contents.name}:${registerApiResponse.body.version}`
         );
@@ -1308105,20 +1308265,20 @@ async function generateToken({
 
 // src/commands/upgrade/updateApiSpec.ts
 var fs7 = __toESM(require("fs"), 1);
-var import_promises56 = require("fs/promises");
+var import_promises57 = require("fs/promises");
 var import_stream4 = require("stream");
-var import_promises57 = require("stream/promises");
+var import_promises58 = require("stream/promises");
 async function fetchAndWriteFile(url, path45, logger) {
   const resp = await fetch(url);
   if (resp.ok && resp.body) {
     logger.debug("Origin successfully fetched, writing to file");
     const fileStream = fs7.createWriteStream(path45);
-    await (0, import_promises57.finished)(import_stream4.Readable.fromWeb(resp.body).pipe(fileStream));
-    const fileContents = await (0, import_promises56.readFile)(path45, "utf8");
+    await (0, import_promises58.finished)(import_stream4.Readable.fromWeb(resp.body).pipe(fileStream));
+    const fileContents = await (0, import_promises57.readFile)(path45, "utf8");
     try {
-      await (0, import_promises56.writeFile)(path45, JSON.stringify(JSON.parse(fileContents), void 0, 2), "utf8");
+      await (0, import_promises57.writeFile)(path45, JSON.stringify(JSON.parse(fileContents), void 0, 2), "utf8");
     } catch (e) {
-      await (0, import_promises56.writeFile)(path45, js_yaml_default.dump(js_yaml_default.load(fileContents)), "utf8");
+      await (0, import_promises57.writeFile)(path45, js_yaml_default.dump(js_yaml_default.load(fileContents)), "utf8");
     }
     logger.debug("File written successfully");
   }
@@ -1308206,7 +1308366,7 @@ async function updateApiSpec({
 }
 
 // ../yaml/yaml-migrations/lib/migrations/0.0.191/discriminant/migration.js
-var import_promises58 = require("fs/promises");
+var import_promises59 = require("fs/promises");
 
 // ../yaml/yaml-migrations/lib/migrations/0.0.191/discriminant/getAllYamlFiles.js
 var import_glob_promise2 = __toESM(require_lib(), 1);
@@ -1308240,7 +1308400,7 @@ var migration = {
       try {
         const fileContents = await getFileContents(yamlFilepath);
         const newContents = addDiscriminantToFile(fileContents);
-        await (0, import_promises58.writeFile)(yamlFilepath, newContents);
+        await (0, import_promises59.writeFile)(yamlFilepath, newContents);
       } catch (error) {
         context.failAndThrow("Failed to migrate " + yamlFilepath, error);
       }
@@ -1308248,7 +1308408,7 @@ var migration = {
   }
 };
 async function getFileContents(filepath) {
-  const buffer = await (0, import_promises58.readFile)(filepath);
+  const buffer = await (0, import_promises59.readFile)(filepath);
   return buffer.toString();
 }
 var UNION_REGEX = /^(\s{2,})union:\s*$/gm;
@@ -1308277,8 +1308437,8 @@ var versionMigrations = {
 var __default = versionMigrations;
 
 // ../yaml/yaml-migrations/lib/migrations/0.0.203/union-single-property-key/migration.js
-var import_promises59 = require("fs/promises");
-var import_yaml2 = __toESM(require_dist5(), 1);
+var import_promises60 = require("fs/promises");
+var import_yaml3 = __toESM(require_dist5(), 1);
 
 // ../yaml/yaml-migrations/lib/migrations/0.0.203/union-single-property-key/getAllYamlFiles.js
 var import_glob_promise3 = __toESM(require_lib(), 1);
@@ -1308318,39 +1308478,39 @@ var migration2 = {
   }
 };
 async function migrateFile(filepath, context) {
-  const contents = await (0, import_promises59.readFile)(filepath);
-  const parsedDocument = import_yaml2.default.parseDocument(contents.toString());
+  const contents = await (0, import_promises60.readFile)(filepath);
+  const parsedDocument = import_yaml3.default.parseDocument(contents.toString());
   const types3 = parsedDocument.get("types");
   if (types3 == null) {
     return;
   }
-  if (!import_yaml2.default.isMap(types3)) {
+  if (!import_yaml3.default.isMap(types3)) {
     context.failWithoutThrowing(`"types" is not a map in ${filepath}`);
     return;
   }
   for (const typeDeclaration of types3.items) {
-    if (import_yaml2.default.isMap(typeDeclaration.value)) {
+    if (import_yaml3.default.isMap(typeDeclaration.value)) {
       const union4 = typeDeclaration.value.get("union");
       if (union4 == null) {
         continue;
       }
-      if (!import_yaml2.default.isMap(union4)) {
+      if (!import_yaml3.default.isMap(union4)) {
         context.failWithoutThrowing(`"union" is not a map in ${filepath}`);
         continue;
       }
       for (const singleUnionType of union4.items) {
-        if (import_yaml2.default.isScalar(singleUnionType.value)) {
+        if (import_yaml3.default.isScalar(singleUnionType.value)) {
           singleUnionType.value = {
             type: singleUnionType.value,
             key: singleUnionType.key
           };
-        } else if (import_yaml2.default.isMap(singleUnionType.value)) {
-          singleUnionType.value.add(new import_yaml2.default.Pair("key", singleUnionType.key));
+        } else if (import_yaml3.default.isMap(singleUnionType.value)) {
+          singleUnionType.value.add(new import_yaml3.default.Pair("key", singleUnionType.key));
         }
       }
     }
   }
-  await (0, import_promises59.writeFile)(filepath, parsedDocument.toString());
+  await (0, import_promises60.writeFile)(filepath, parsedDocument.toString());
 }
 
 // ../yaml/yaml-migrations/lib/migrations/0.0.203/index.js
@@ -1308361,8 +1308521,8 @@ var versionMigrations2 = {
 var __default2 = versionMigrations2;
 
 // ../yaml/yaml-migrations/lib/migrations/0.0.207/add-mode-to-draft-generators/migration.js
-var import_promises60 = require("fs/promises");
-var import_yaml3 = __toESM(require_dist5(), 1);
+var import_promises61 = require("fs/promises");
+var import_yaml4 = __toESM(require_dist5(), 1);
 
 // ../yaml/yaml-migrations/lib/migrations/0.0.207/add-mode-to-draft-generators/getAllGeneratorYamlFiles.js
 var import_glob_promise4 = __toESM(require_lib(), 1);
@@ -1308402,18 +1308562,18 @@ var migration3 = {
   }
 };
 async function migrateGeneratorsYml(filepath, context) {
-  const contents = await (0, import_promises60.readFile)(filepath);
-  const parsedDocument = import_yaml3.default.parseDocument(contents.toString());
+  const contents = await (0, import_promises61.readFile)(filepath);
+  const parsedDocument = import_yaml4.default.parseDocument(contents.toString());
   const draftGenerators = parsedDocument.get("draft");
   if (draftGenerators == null) {
     return;
   }
-  if (!import_yaml3.default.isSeq(draftGenerators)) {
+  if (!import_yaml4.default.isSeq(draftGenerators)) {
     context.failWithoutThrowing(`draft generators are not a list in ${filepath}`);
     return;
   }
   draftGenerators.items.forEach((draftGenerator) => {
-    if (!import_yaml3.default.isMap(draftGenerator)) {
+    if (!import_yaml4.default.isMap(draftGenerator)) {
       context.failWithoutThrowing(`draft generator is not an object in ${filepath}`);
       return;
     }
@@ -1308429,7 +1308589,7 @@ async function migrateGeneratorsYml(filepath, context) {
       draftGenerator.set("output-path", name2.value.includes("openapi") ? "./generated-openapi" : name2.value.includes("postman") ? "./generated-postman" : localOutput);
     }
   });
-  await (0, import_promises60.writeFile)(filepath, parsedDocument.toString());
+  await (0, import_promises61.writeFile)(filepath, parsedDocument.toString());
 }
 
 // ../yaml/yaml-migrations/lib/migrations/0.0.207/index.js
@@ -1308440,8 +1308600,8 @@ var versionMigrations3 = {
 var __default3 = versionMigrations3;
 
 // ../yaml/yaml-migrations/lib/migrations/0.0.210/remove-inline-error-declarations/migration.js
-var import_promises61 = require("fs/promises");
-var import_yaml4 = __toESM(require_dist5(), 1);
+var import_promises62 = require("fs/promises");
+var import_yaml5 = __toESM(require_dist5(), 1);
 
 // ../yaml/yaml-migrations/lib/migrations/0.0.210/remove-inline-error-declarations/getAllYamlFiles.js
 var import_glob_promise5 = __toESM(require_lib(), 1);
@@ -1308481,15 +1308641,15 @@ var migration4 = {
   }
 };
 async function migrateFile2(filepath, context) {
-  const contents = await (0, import_promises61.readFile)(filepath);
-  const parsedDocument = import_yaml4.default.parseDocument(contents.toString());
+  const contents = await (0, import_promises62.readFile)(filepath);
+  const parsedDocument = import_yaml5.default.parseDocument(contents.toString());
   const addType = (typeName, typeDeclaration) => {
     const types3 = parsedDocument.get("types");
     if (types3 == null) {
       parsedDocument.set("types", {
         [typeName]: typeDeclaration
       });
-    } else if (!import_yaml4.default.isMap(types3)) {
+    } else if (!import_yaml5.default.isMap(types3)) {
       context.failWithoutThrowing(`"types" is not a map in ${filepath}`);
     } else {
       types3.set(typeName, typeDeclaration);
@@ -1308499,12 +1308659,12 @@ async function migrateFile2(filepath, context) {
   if (errors2 == null) {
     return;
   }
-  if (!import_yaml4.default.isMap(errors2)) {
+  if (!import_yaml5.default.isMap(errors2)) {
     context.failWithoutThrowing(`"errors" is not a map in ${filepath}`);
     return;
   }
   for (const errorDeclaration of errors2.items) {
-    if (!import_yaml4.default.isMap(errorDeclaration.value)) {
+    if (!import_yaml5.default.isMap(errorDeclaration.value)) {
       context.failWithoutThrowing(`Error "${errorDeclaration.key}" is not a map in ${filepath}`);
       continue;
     }
@@ -1308516,7 +1308676,7 @@ async function migrateFile2(filepath, context) {
     }
     const httpSection = errorDeclaration.value.get("http");
     if (httpSection != null) {
-      if (!import_yaml4.default.isMap(httpSection)) {
+      if (!import_yaml5.default.isMap(httpSection)) {
         context.failWithoutThrowing(`http in "${errorDeclaration.key}" is not a map in ${filepath}`);
       } else {
         const statusCode = httpSection.get("statusCode", true);
@@ -1308525,7 +1308685,7 @@ async function migrateFile2(filepath, context) {
       }
     }
   }
-  await (0, import_promises61.writeFile)(filepath, parsedDocument.toString());
+  await (0, import_promises62.writeFile)(filepath, parsedDocument.toString());
 }
 
 // ../yaml/yaml-migrations/lib/migrations/0.0.210/index.js
@@ -1308536,8 +1308696,8 @@ var versionMigrations4 = {
 var __default4 = versionMigrations4;
 
 // ../yaml/yaml-migrations/lib/migrations/0.0.212/add-publishing-to-release-generators/migration.js
-var import_promises62 = require("fs/promises");
-var import_yaml5 = __toESM(require_dist5(), 1);
+var import_promises63 = require("fs/promises");
+var import_yaml6 = __toESM(require_dist5(), 1);
 
 // ../yaml/yaml-migrations/lib/migrations/0.0.212/add-publishing-to-release-generators/getAllGeneratorYamlFiles.js
 var import_glob_promise6 = __toESM(require_lib(), 1);
@@ -1308577,37 +1308737,37 @@ var migration5 = {
   }
 };
 async function migrateGeneratorsYml2(filepath, context) {
-  const contents = await (0, import_promises62.readFile)(filepath);
-  const parsedDocument = import_yaml5.default.parseDocument(contents.toString());
+  const contents = await (0, import_promises63.readFile)(filepath);
+  const parsedDocument = import_yaml6.default.parseDocument(contents.toString());
   const releaseGenerators = parsedDocument.get("release");
   if (releaseGenerators == null) {
     return;
   }
-  if (!import_yaml5.default.isSeq(releaseGenerators)) {
+  if (!import_yaml6.default.isSeq(releaseGenerators)) {
     context.failWithoutThrowing(`release generators are not a list in ${filepath}`);
     return;
   }
   releaseGenerators.items.forEach((releaseGenerator) => {
-    if (!import_yaml5.default.isMap(releaseGenerator)) {
+    if (!import_yaml6.default.isMap(releaseGenerator)) {
       context.failWithoutThrowing(`release generator is not an object in ${filepath}`);
       return;
     }
     const outputs = releaseGenerator.get("outputs");
-    if (!import_yaml5.default.isMap(outputs)) {
+    if (!import_yaml6.default.isMap(outputs)) {
       context.failWithoutThrowing(`outputs is not an object in ${filepath}`);
       return;
     }
     const githubOutput = outputs.get("github");
-    if (import_yaml5.default.isMap(githubOutput) && githubOutput.has("repository")) {
+    if (import_yaml6.default.isMap(githubOutput) && githubOutput.has("repository")) {
       releaseGenerator.set("github", githubOutput);
     }
     const publishing = {};
     const npmOutput = outputs.get("npm");
-    if (import_yaml5.default.isMap(npmOutput)) {
+    if (import_yaml6.default.isMap(npmOutput)) {
       publishing.npm = npmOutput;
     }
     const mavenOutput = outputs.get("maven");
-    if (import_yaml5.default.isMap(mavenOutput)) {
+    if (import_yaml6.default.isMap(mavenOutput)) {
       publishing.maven = mavenOutput;
     }
     if (Object.keys(publishing).length > 0) {
@@ -1308615,7 +1308775,7 @@ async function migrateGeneratorsYml2(filepath, context) {
     }
     releaseGenerator.delete("outputs");
   });
-  await (0, import_promises62.writeFile)(filepath, parsedDocument.toString());
+  await (0, import_promises63.writeFile)(filepath, parsedDocument.toString());
 }
 
 // ../yaml/yaml-migrations/lib/migrations/0.0.212/index.js
@@ -1308626,7 +1308786,7 @@ var versionMigrations5 = {
 var __default5 = versionMigrations5;
 
 // ../yaml/yaml-migrations/lib/migrations/0.0.220/rename-alias-key-to-type/migration.js
-var import_promises63 = require("fs/promises");
+var import_promises64 = require("fs/promises");
 
 // ../yaml/yaml-migrations/lib/migrations/0.0.220/rename-alias-key-to-type/getAllYamlFiles.js
 var import_glob_promise7 = __toESM(require_lib(), 1);
@@ -1308657,9 +1308817,9 @@ var migration6 = {
   run: async ({ context }) => {
     const yamlFiles = await getAllYamlFiles4(context);
     for (const filepath of yamlFiles) {
-      const contents = await (0, import_promises63.readFile)(filepath);
+      const contents = await (0, import_promises64.readFile)(filepath);
       const newContents = contents.toString().replaceAll(" alias:", " type:");
-      await (0, import_promises63.writeFile)(filepath, newContents);
+      await (0, import_promises64.writeFile)(filepath, newContents);
     }
   }
 };
@@ -1308672,7 +1308832,7 @@ var versionMigrations6 = {
 var __default6 = versionMigrations6;
 
 // ../yaml/yaml-migrations/lib/migrations/0.0.221/add-error-discriminant/migration.js
-var import_promises64 = require("fs/promises");
+var import_promises65 = require("fs/promises");
 
 // ../yaml/yaml-migrations/lib/migrations/0.0.221/add-error-discriminant/getAllRootApiYamlFiles.js
 var import_glob_promise8 = __toESM(require_lib(), 1);
@@ -1308703,9 +1308863,9 @@ var migration7 = {
   run: async ({ context }) => {
     const yamlFiles = await getAllRootApiYamlFiles(context);
     for (const filepath of yamlFiles) {
-      const contents = await (0, import_promises64.readFile)(filepath);
+      const contents = await (0, import_promises65.readFile)(filepath);
       const newContents = contents.toString() + "\nerror-discriminant: error";
-      await (0, import_promises64.writeFile)(filepath, newContents);
+      await (0, import_promises65.writeFile)(filepath, newContents);
     }
   }
 };
@@ -1308718,7 +1308878,7 @@ var versionMigrations7 = {
 var __default7 = versionMigrations7;
 
 // ../yaml/yaml-migrations/lib/migrations/0.0.241/add-generator-groups/migration.js
-var import_promises65 = require("fs/promises");
+var import_promises66 = require("fs/promises");
 
 // ../yaml/yaml-migrations/lib/migrations/0.0.241/add-generator-groups/getAllGeneratorYamlFiles.js
 var import_glob_promise9 = __toESM(require_lib(), 1);
@@ -1308825,7 +1308985,7 @@ var migration8 = {
   }
 };
 async function migrateGeneratorsYml3(filepath) {
-  const contentsStr = await (0, import_promises65.readFile)(filepath);
+  const contentsStr = await (0, import_promises66.readFile)(filepath);
   const contents = js_yaml_default.load(contentsStr.toString());
   const oldGeneratorsConfiguration = GeneratorsConfigurationSchema2.parse(contents);
   let newGeneratorsConfiguration = {};
@@ -1308843,7 +1309003,7 @@ async function migrateGeneratorsYml3(filepath) {
       generators: oldGeneratorsConfiguration.release.map((releaseGeneratorInvocation) => convertReleaseGeneratorInvocation(releaseGeneratorInvocation))
     };
   }
-  await (0, import_promises65.writeFile)(filepath, js_yaml_default.dump(newGeneratorsConfiguration));
+  await (0, import_promises66.writeFile)(filepath, js_yaml_default.dump(newGeneratorsConfiguration));
 }
 function convertDraftGeneratorInvocation(draftGeneratorInvocation) {
   const newSchema = {
@@ -1308918,8 +1309078,8 @@ var versionMigrations8 = {
 var __default8 = versionMigrations8;
 
 // ../yaml/yaml-migrations/lib/migrations/0.0.248/add-error-discrimination-config/migration.js
-var import_promises66 = require("fs/promises");
-var import_yaml6 = __toESM(require_dist5(), 1);
+var import_promises67 = require("fs/promises");
+var import_yaml7 = __toESM(require_dist5(), 1);
 
 // ../yaml/yaml-migrations/lib/migrations/0.0.248/add-error-discrimination-config/getAllRootApiYamlFiles.js
 var import_glob_promise10 = __toESM(require_lib(), 1);
@@ -1308959,10 +1309119,10 @@ var migration9 = {
   }
 };
 async function migrateRootApiFile(filepath) {
-  const contents = await (0, import_promises66.readFile)(filepath);
-  const parsedDocument = import_yaml6.default.parseDocument(contents.toString());
+  const contents = await (0, import_promises67.readFile)(filepath);
+  const parsedDocument = import_yaml7.default.parseDocument(contents.toString());
   const errorDiscriminant = parsedDocument.get("error-discriminant", true);
-  if (errorDiscriminant == null || !import_yaml6.default.isScalar(errorDiscriminant) || typeof errorDiscriminant.value !== "string") {
+  if (errorDiscriminant == null || !import_yaml7.default.isScalar(errorDiscriminant) || typeof errorDiscriminant.value !== "string") {
     return;
   }
   parsedDocument.set("error-discrimination", {
@@ -1308970,7 +1309130,7 @@ async function migrateRootApiFile(filepath) {
     "property-name": errorDiscriminant.value
   });
   parsedDocument.delete("error-discriminant");
-  await (0, import_promises66.writeFile)(filepath, parsedDocument.toString());
+  await (0, import_promises67.writeFile)(filepath, parsedDocument.toString());
 }
 
 // ../yaml/yaml-migrations/lib/migrations/0.0.248/index.js
@@ -1308981,8 +1309141,8 @@ var versionMigrations9 = {
 var __default9 = versionMigrations9;
 
 // ../yaml/yaml-migrations/lib/migrations/0.1.3-rc3/add-inline-requests/migration.js
-var import_promises67 = require("fs/promises");
-var import_yaml7 = __toESM(require_dist5(), 1);
+var import_promises68 = require("fs/promises");
+var import_yaml8 = __toESM(require_dist5(), 1);
 
 // ../yaml/yaml-migrations/lib/migrations/0.1.3-rc3/add-inline-requests/getAllYamlFiles.js
 var import_glob_promise11 = __toESM(require_lib(), 1);
@@ -1309022,24 +1309182,24 @@ var migration10 = {
   }
 };
 async function migrateYamlFile(filepath, context) {
-  const contents = await (0, import_promises67.readFile)(filepath);
-  const parsedDocument = import_yaml7.default.parseDocument(contents.toString());
+  const contents = await (0, import_promises68.readFile)(filepath);
+  const parsedDocument = import_yaml8.default.parseDocument(contents.toString());
   const services = parsedDocument.get("services");
   if (services == null) {
     return;
   }
-  if (!import_yaml7.default.isMap(services)) {
+  if (!import_yaml8.default.isMap(services)) {
     throw new Error("'services' is not a map");
   }
   const httpServices = services.get("http");
   if (httpServices == null) {
     return;
   }
-  if (!import_yaml7.default.isMap(httpServices)) {
+  if (!import_yaml8.default.isMap(httpServices)) {
     throw new Error("'http' is not a map");
   }
   for (const service of httpServices.items) {
-    if (!import_yaml7.default.isMap(service.value)) {
+    if (!import_yaml8.default.isMap(service.value)) {
       context.failWithoutThrowing(`Service '${service.key}' is not a map`);
       continue;
     }
@@ -1309047,12 +1309207,12 @@ async function migrateYamlFile(filepath, context) {
     if (endpoints == null) {
       continue;
     }
-    if (!import_yaml7.default.isMap(endpoints)) {
+    if (!import_yaml8.default.isMap(endpoints)) {
       context.failWithoutThrowing(`Endpoints are not a map in service '${service.key}'`);
       continue;
     }
     for (const endpoint of endpoints.items) {
-      if (!import_yaml7.default.isMap(endpoint.value)) {
+      if (!import_yaml8.default.isMap(endpoint.value)) {
         context.failWithoutThrowing(`Endpoint ${endpoint.key} is not a map in service '${service.key}'`);
         continue;
       }
@@ -1309062,14 +1309222,14 @@ async function migrateYamlFile(filepath, context) {
         context.failWithoutThrowing("Failed to convert endpoint", e);
       }
     }
-    await (0, import_promises67.writeFile)(filepath, parsedDocument.toString());
+    await (0, import_promises68.writeFile)(filepath, parsedDocument.toString());
   }
 }
 function convertEndpoint18({ document: document4, endpoint }) {
-  const newRequest = new import_yaml7.default.YAMLMap();
+  const newRequest = new import_yaml8.default.YAMLMap();
   const parsedRequestBody = parseRequestBody(endpoint);
   if (parsedRequestBody != null) {
-    let newBody = new import_yaml7.default.YAMLMap();
+    let newBody = new import_yaml8.default.YAMLMap();
     const { requestBodyType, docs: originalRequestDocs } = parsedRequestBody;
     if (originalRequestDocs != null) {
       newBody.set("docs", originalRequestDocs);
@@ -1309077,11 +1309237,11 @@ function convertEndpoint18({ document: document4, endpoint }) {
     newBody.set("type", requestBodyType);
     const documentTypes = document4.get("types");
     if (documentTypes != null) {
-      if (!import_yaml7.default.isMap(documentTypes)) {
+      if (!import_yaml8.default.isMap(documentTypes)) {
         throw new Error("types are not a map");
       }
       const maybeTypeDeclarationForRequest = documentTypes.get(requestBodyType);
-      if (maybeTypeDeclarationForRequest != null && import_yaml7.default.isMap(maybeTypeDeclarationForRequest)) {
+      if (maybeTypeDeclarationForRequest != null && import_yaml8.default.isMap(maybeTypeDeclarationForRequest)) {
         const objectExtends = maybeTypeDeclarationForRequest.get("extends");
         const objectProperties = maybeTypeDeclarationForRequest.get("properties");
         if (objectExtends != null || objectProperties != null) {
@@ -1309116,7 +1309276,7 @@ function parseRequestBody(endpoint) {
   if (typeof requestBody === "string") {
     return { requestBodyType: requestBody, docs: void 0 };
   }
-  if (import_yaml7.default.isMap(requestBody)) {
+  if (import_yaml8.default.isMap(requestBody)) {
     const type2 = requestBody.get("type");
     if (type2 == null) {
       throw new Error("request type does not exist");
@@ -1309146,10 +1309306,10 @@ var import_legacy_docs_config = __toESM(require_legacy_docs_config(), 1);
 var LegacyDocsSerializers = __toESM(require_serialization34(), 1);
 
 // ../yaml/yaml-migrations/lib/migrations/0.15.0-rc0/update-directory-structure/docs-config/loadRawDocsConfiguration.js
-var import_promises68 = require("fs/promises");
+var import_promises69 = require("fs/promises");
 async function loadRawDocsConfiguration2({ absolutePathToWorkspace }) {
   const filepath = getAbsolutePathToDocsYaml({ absolutePathToWorkspace });
-  const contentsStr = await (0, import_promises68.readFile)(filepath);
+  const contentsStr = await (0, import_promises69.readFile)(filepath);
   const contentsParsed = js_yaml_default.load(contentsStr.toString());
   const result = await LegacyDocsSerializers.DocsConfiguration.parse(contentsParsed);
   if (result.ok) {
@@ -1309167,7 +1309327,7 @@ function getAbsolutePathToDocsFolder({ absolutePathToWorkspace }) {
 }
 
 // ../yaml/yaml-migrations/lib/migrations/0.15.0-rc0/update-directory-structure/migrateDocsAndMultipleAPIs.js
-var import_promises70 = require("fs/promises");
+var import_promises71 = require("fs/promises");
 
 // ../yaml/yaml-migrations/lib/migrations/0.15.0-rc0/update-directory-structure/docs-config/convertLegacyDocsConfig.js
 function convertLegacyDocsConfig({ docsConfiguration, docsURLs, apiName }) {
@@ -1309348,10 +1309508,10 @@ __export(legacy_exports, {
 });
 
 // ../yaml/yaml-migrations/lib/migrations/0.15.0-rc0/update-directory-structure/generators-configuration/loadRawGeneratorsConfiguration.js
-var import_promises69 = require("fs/promises");
+var import_promises70 = require("fs/promises");
 async function loadRawGeneratorsConfiguration2({ absolutePathToWorkspace }) {
   const filepath = getAbsolutePathToGeneratorsConfiguration({ absolutePathToWorkspace });
-  const contentsStr = await (0, import_promises69.readFile)(filepath);
+  const contentsStr = await (0, import_promises70.readFile)(filepath);
   const contentsParsed = js_yaml_default.load(contentsStr.toString());
   const result = await legacy_exports.GeneratorsConfigurationSchema.safeParseAsync(contentsParsed);
   if (result.success) {
@@ -1309381,7 +1309541,7 @@ function migrateDocsInstances(docsURLs) {
 var APIS_DIRECTORY2 = "apis";
 async function migrateDocsAndMultipleAPIs({ absolutePathToFernDirectory, workspaces, workspaceContainingDocs }) {
   const absolutePathToApisDirectory = join(absolutePathToFernDirectory, RelativeFilePath.of(APIS_DIRECTORY2));
-  await (0, import_promises70.mkdir)(absolutePathToApisDirectory);
+  await (0, import_promises71.mkdir)(absolutePathToApisDirectory);
   for (const workspace of workspaces) {
     const absolutePathToWorkspace = join(absolutePathToFernDirectory, RelativeFilePath.of(workspace));
     const docsURLs = await migrateAndWriteGeneratorsYml({ absolutePathToWorkspace });
@@ -1309389,11 +1309549,11 @@ async function migrateDocsAndMultipleAPIs({ absolutePathToFernDirectory, workspa
       await migrateAndWriteDocsYml({ absolutePathToWorkspace, docsURLs, apiName: workspaceContainingDocs });
       const absolutePathToDocsFolder = getAbsolutePathToDocsFolder({ absolutePathToWorkspace });
       await moveFolder({ src: absolutePathToDocsFolder, dest: absolutePathToFernDirectory });
-      await (0, import_promises70.rm)(absolutePathToDocsFolder, { recursive: true });
+      await (0, import_promises71.rm)(absolutePathToDocsFolder, { recursive: true });
     }
     const absolutePathToNestedWorkspace = join(absolutePathToApisDirectory, RelativeFilePath.of(workspace));
     await moveFolder({ src: absolutePathToWorkspace, dest: absolutePathToNestedWorkspace });
-    await (0, import_promises70.rm)(absolutePathToWorkspace, { recursive: true });
+    await (0, import_promises71.rm)(absolutePathToWorkspace, { recursive: true });
   }
 }
 async function migrateAndWriteGeneratorsYml({ absolutePathToWorkspace }) {
@@ -1309406,7 +1309566,7 @@ async function migrateAndWriteGeneratorsYml({ absolutePathToWorkspace }) {
     generatorsConfiguration,
     pathModificationStrategy: PathModificationStrategy.Nest
   });
-  await (0, import_promises70.writeFile)(absolutePathToGeneratorsConfiguration, js_yaml_default.dump(convertedResponse.value));
+  await (0, import_promises71.writeFile)(absolutePathToGeneratorsConfiguration, js_yaml_default.dump(convertedResponse.value));
   return convertedResponse.docsURLs;
 }
 async function migrateAndWriteDocsYml({ absolutePathToWorkspace, docsURLs, apiName }) {
@@ -1309420,19 +1309580,19 @@ async function migrateAndWriteDocsYml({ absolutePathToWorkspace, docsURLs, apiNa
     apiName
   });
   const absolutePathToDocsConfig = getAbsolutePathToDocsYaml({ absolutePathToWorkspace });
-  await (0, import_promises70.writeFile)(absolutePathToDocsConfig, js_yaml_default.dump(convertedDocsConfig));
+  await (0, import_promises71.writeFile)(absolutePathToDocsConfig, js_yaml_default.dump(convertedDocsConfig));
 }
 
 // ../yaml/yaml-migrations/lib/migrations/0.15.0-rc0/update-directory-structure/migrateDocsAndSingleAPI.js
-var import_promises71 = require("fs/promises");
+var import_promises72 = require("fs/promises");
 async function migrateDocsAndSingleAPI({ absolutePathToFernDirectory, absolutePathToWorkspace }) {
   const docsURLs = await migrateAndWriteGeneratorsYml2({ absolutePathToWorkspace });
   await migrateAndWriteDocsYml2({ absolutePathToWorkspace, docsURLs });
   const absolutePathToDocsFolder = getAbsolutePathToDocsFolder({ absolutePathToWorkspace });
   await moveFolder({ src: absolutePathToDocsFolder, dest: absolutePathToFernDirectory });
   await moveFolder({ src: absolutePathToWorkspace, dest: absolutePathToFernDirectory });
-  await (0, import_promises71.rm)(absolutePathToDocsFolder, { recursive: true });
-  await (0, import_promises71.rm)(absolutePathToWorkspace, { recursive: true });
+  await (0, import_promises72.rm)(absolutePathToDocsFolder, { recursive: true });
+  await (0, import_promises72.rm)(absolutePathToWorkspace, { recursive: true });
 }
 async function migrateAndWriteDocsYml2({ absolutePathToWorkspace, docsURLs }) {
   const docsConfiguration = await loadRawDocsConfiguration2({ absolutePathToWorkspace });
@@ -1309445,7 +1309605,7 @@ async function migrateAndWriteDocsYml2({ absolutePathToWorkspace, docsURLs }) {
     apiName: void 0
   });
   const absolutePathToDocsConfig = getAbsolutePathToDocsYaml({ absolutePathToWorkspace });
-  await (0, import_promises71.writeFile)(absolutePathToDocsConfig, js_yaml_default.dump(convertedDocsConfig));
+  await (0, import_promises72.writeFile)(absolutePathToDocsConfig, js_yaml_default.dump(convertedDocsConfig));
 }
 async function migrateAndWriteGeneratorsYml2({ absolutePathToWorkspace }) {
   const generatorsConfiguration = await loadRawGeneratorsConfiguration2({ absolutePathToWorkspace });
@@ -1309457,22 +1309617,22 @@ async function migrateAndWriteGeneratorsYml2({ absolutePathToWorkspace }) {
     generatorsConfiguration,
     pathModificationStrategy: "MoveUp"
   });
-  await (0, import_promises71.writeFile)(absolutePathToGeneratorsConfiguration, js_yaml_default.dump(convertedResponse.value));
+  await (0, import_promises72.writeFile)(absolutePathToGeneratorsConfiguration, js_yaml_default.dump(convertedResponse.value));
   return convertedResponse.docsURLs;
 }
 
 // ../yaml/yaml-migrations/lib/migrations/0.15.0-rc0/update-directory-structure/migrateOnlyMultipleAPIs.js
-var import_promises72 = require("fs/promises");
+var import_promises73 = require("fs/promises");
 var APIS_DIRECTORY3 = "apis";
 async function migrateOnlyMultipleAPIs({ absolutePathToFernDirectory, workspaces }) {
   const absolutePathToApisDirectory = join(absolutePathToFernDirectory, RelativeFilePath.of(APIS_DIRECTORY3));
-  await (0, import_promises72.mkdir)(absolutePathToApisDirectory);
+  await (0, import_promises73.mkdir)(absolutePathToApisDirectory);
   for (const workspace of workspaces) {
     const absolutePathToWorkspace = join(absolutePathToFernDirectory, RelativeFilePath.of(workspace));
     await migrateAndWriteGeneratorsYml3({ absolutePathToWorkspace });
     const absolutePathToNestedWorkspace = join(absolutePathToApisDirectory, RelativeFilePath.of(workspace));
     await moveFolder({ src: absolutePathToWorkspace, dest: absolutePathToNestedWorkspace });
-    await (0, import_promises72.rm)(absolutePathToWorkspace, { recursive: true });
+    await (0, import_promises73.rm)(absolutePathToWorkspace, { recursive: true });
   }
 }
 async function migrateAndWriteGeneratorsYml3({ absolutePathToWorkspace }) {
@@ -1309485,15 +1309645,15 @@ async function migrateAndWriteGeneratorsYml3({ absolutePathToWorkspace }) {
     generatorsConfiguration,
     pathModificationStrategy: PathModificationStrategy.Nest
   });
-  await (0, import_promises72.writeFile)(absolutePathToGeneratorsConfiguration, js_yaml_default.dump(convertedResponse.value));
+  await (0, import_promises73.writeFile)(absolutePathToGeneratorsConfiguration, js_yaml_default.dump(convertedResponse.value));
 }
 
 // ../yaml/yaml-migrations/lib/migrations/0.15.0-rc0/update-directory-structure/migrateOnlySingleAPI.js
-var import_promises73 = require("fs/promises");
+var import_promises74 = require("fs/promises");
 async function migrateOnlySingleAPI({ absolutePathToFernDirectory, absolutePathToWorkspace }) {
   await migrateAndWriteGeneratorsYml4({ absolutePathToWorkspace });
   await moveFolder({ src: absolutePathToWorkspace, dest: absolutePathToFernDirectory });
-  await (0, import_promises73.rmdir)(absolutePathToWorkspace, { recursive: true });
+  await (0, import_promises74.rmdir)(absolutePathToWorkspace, { recursive: true });
 }
 async function migrateAndWriteGeneratorsYml4({ absolutePathToWorkspace }) {
   const generatorsConfiguration = await loadRawGeneratorsConfiguration2({ absolutePathToWorkspace });
@@ -1309505,7 +1309665,7 @@ async function migrateAndWriteGeneratorsYml4({ absolutePathToWorkspace }) {
     generatorsConfiguration,
     pathModificationStrategy: "MoveUp"
   });
-  await (0, import_promises73.writeFile)(absolutePathToGeneratorsConfiguration, js_yaml_default.dump(convertedResponse.value));
+  await (0, import_promises74.writeFile)(absolutePathToGeneratorsConfiguration, js_yaml_default.dump(convertedResponse.value));
 }
 
 // ../yaml/yaml-migrations/lib/migrations/0.15.0-rc0/update-directory-structure/migration.js
@@ -1309582,8 +1309742,8 @@ var versionMigrations11 = {
 var __default11 = versionMigrations11;
 
 // ../yaml/yaml-migrations/lib/migrations/0.3.0-rc12/add-value-key-to-type-examples/migration.js
-var import_promises74 = require("fs/promises");
-var import_yaml8 = __toESM(require_dist5(), 1);
+var import_promises75 = require("fs/promises");
+var import_yaml9 = __toESM(require_dist5(), 1);
 
 // ../yaml/yaml-migrations/lib/migrations/0.3.0-rc12/add-value-key-to-type-examples/getAllYamlFiles.js
 var import_glob_promise12 = __toESM(require_lib(), 1);
@@ -1309623,24 +1309783,24 @@ var migration12 = {
   }
 };
 async function migrateYamlFile2(filepath, context) {
-  const contents = await (0, import_promises74.readFile)(filepath);
-  const parsedDocument = import_yaml8.default.parseDocument(contents.toString());
+  const contents = await (0, import_promises75.readFile)(filepath);
+  const parsedDocument = import_yaml9.default.parseDocument(contents.toString());
   const types3 = parsedDocument.get("types");
   if (types3 == null) {
     return;
   }
-  if (!import_yaml8.default.isMap(types3)) {
+  if (!import_yaml9.default.isMap(types3)) {
     throw new Error("'types' is not a map");
   }
   for (const type2 of types3.items) {
-    if (!import_yaml8.default.isMap(type2.value)) {
+    if (!import_yaml9.default.isMap(type2.value)) {
       continue;
     }
     const examples = type2.value.get("examples");
     if (examples == null) {
       continue;
     }
-    if (!import_yaml8.default.isSeq(examples)) {
+    if (!import_yaml9.default.isSeq(examples)) {
       context.failWithoutThrowing("'examples' are not a list");
       continue;
     }
@@ -1309649,7 +1309809,7 @@ async function migrateYamlFile2(filepath, context) {
       examples.set(i2, { value });
     }
   }
-  await (0, import_promises74.writeFile)(filepath, parsedDocument.toString());
+  await (0, import_promises75.writeFile)(filepath, parsedDocument.toString());
 }
 
 // ../yaml/yaml-migrations/lib/migrations/0.3.0-rc12/index.js
@@ -1309660,8 +1309820,8 @@ var versionMigrations12 = {
 var __default12 = versionMigrations12;
 
 // ../yaml/yaml-migrations/lib/migrations/0.3.23/change-services-key-to-service/migration.js
-var import_promises75 = require("fs/promises");
-var import_yaml9 = __toESM(require_dist5(), 1);
+var import_promises76 = require("fs/promises");
+var import_yaml10 = __toESM(require_dist5(), 1);
 
 // ../yaml/yaml-migrations/lib/migrations/0.3.23/change-services-key-to-service/getAllYamlFiles.js
 var import_glob_promise13 = __toESM(require_lib(), 1);
@@ -1309701,14 +1309861,14 @@ var migration13 = {
   }
 };
 async function migrateYamlFile3(filepath, context) {
-  const contents = await (0, import_promises75.readFile)(filepath);
-  const parsedDocument = import_yaml9.default.parseDocument(contents.toString());
-  if (!import_yaml9.default.isMap(parsedDocument.contents)) {
+  const contents = await (0, import_promises76.readFile)(filepath);
+  const parsedDocument = import_yaml10.default.parseDocument(contents.toString());
+  if (!import_yaml10.default.isMap(parsedDocument.contents)) {
     return context.failAndThrow("File is not a map");
   }
   for (const pair of parsedDocument.contents.items) {
-    if (import_yaml9.default.isScalar(pair.key) && pair.key.value === "services") {
-      if (!import_yaml9.default.isMap(pair.value)) {
+    if (import_yaml10.default.isScalar(pair.key) && pair.key.value === "services") {
+      if (!import_yaml10.default.isMap(pair.value)) {
         return context.failAndThrow("Services are not a map");
       }
       const httpServices = pair.value.get("http");
@@ -1309716,7 +1309876,7 @@ async function migrateYamlFile3(filepath, context) {
         parsedDocument.contents.delete("services");
         return;
       }
-      if (!import_yaml9.default.isMap(httpServices)) {
+      if (!import_yaml10.default.isMap(httpServices)) {
         return context.failAndThrow("http is not a map");
       }
       const [firstService, ...remainingServices] = httpServices.items;
@@ -1309731,7 +1309891,7 @@ async function migrateYamlFile3(filepath, context) {
       pair.value = firstService.value;
     }
   }
-  await (0, import_promises75.writeFile)(filepath, parsedDocument.toString());
+  await (0, import_promises76.writeFile)(filepath, parsedDocument.toString());
 }
 
 // ../yaml/yaml-migrations/lib/migrations/0.3.23/index.js
@@ -1309742,8 +1309902,8 @@ var versionMigrations13 = {
 var __default13 = versionMigrations13;
 
 // ../yaml/yaml-migrations/lib/migrations/0.5.4/move-service-docs-to-top-level/migration.js
-var import_promises76 = require("fs/promises");
-var import_yaml10 = __toESM(require_dist5(), 1);
+var import_promises77 = require("fs/promises");
+var import_yaml11 = __toESM(require_dist5(), 1);
 
 // ../yaml/yaml-migrations/lib/migrations/0.5.4/move-service-docs-to-top-level/getAllYamlFiles.js
 var import_glob_promise14 = __toESM(require_lib(), 1);
@@ -1309783,26 +1309943,26 @@ var migration14 = {
   }
 };
 async function migrateYamlFile4(filepath, context) {
-  const contents = await (0, import_promises76.readFile)(filepath);
-  const parsedDocument = import_yaml10.default.parseDocument(contents.toString());
-  if (!import_yaml10.default.isMap(parsedDocument.contents)) {
+  const contents = await (0, import_promises77.readFile)(filepath);
+  const parsedDocument = import_yaml11.default.parseDocument(contents.toString());
+  if (!import_yaml11.default.isMap(parsedDocument.contents)) {
     return context.failAndThrow("File is not a map");
   }
   const service = parsedDocument.contents.get("service");
   if (service == null) {
     return;
   }
-  if (!import_yaml10.default.isMap(service)) {
+  if (!import_yaml11.default.isMap(service)) {
     return context.failAndThrow("service is not a map");
   }
-  const indexOfServiceDocsPair = service.items.findIndex((item) => import_yaml10.default.isScalar(item.key) && item.key.value === "docs");
+  const indexOfServiceDocsPair = service.items.findIndex((item) => import_yaml11.default.isScalar(item.key) && item.key.value === "docs");
   const docsPair = service.items[indexOfServiceDocsPair];
   if (docsPair == null) {
     return;
   }
   service.items.splice(indexOfServiceDocsPair, 1);
   parsedDocument.contents.items.unshift(docsPair);
-  await (0, import_promises76.writeFile)(filepath, parsedDocument.toString());
+  await (0, import_promises77.writeFile)(filepath, parsedDocument.toString());
 }
 
 // ../yaml/yaml-migrations/lib/migrations/0.5.4/index.js
@@ -1309813,7 +1309973,7 @@ var versionMigrations14 = {
 var __default14 = versionMigrations14;
 
 // ../yaml/yaml-migrations/lib/migrations/0.9.10/add-suffix-to-docs-domain/migration.js
-var import_promises77 = require("fs/promises");
+var import_promises78 = require("fs/promises");
 
 // ../yaml/yaml-migrations/lib/migrations/0.9.10/add-suffix-to-docs-domain/getAllGeneratorYamlFiles.js
 var import_glob_promise15 = __toESM(require_lib(), 1);
@@ -1309853,14 +1310013,14 @@ var migration15 = {
   }
 };
 async function migrateYamlFile5(filepath) {
-  const contents = await (0, import_promises77.readFile)(filepath);
+  const contents = await (0, import_promises78.readFile)(filepath);
   const domainSuffix = process.env.DOMAIN_SUFFIX ?? "docs.buildwithfern.com";
   const regex4 = /(docs:\s*domain:\s*)"([^"]*)"/g;
   const updatedSnapshot = contents.toString().replace(regex4, (_match, _prefix, domain2) => {
     return `docs:
       domain: "${domain2}.${domainSuffix}"`;
   });
-  await (0, import_promises77.writeFile)(filepath, updatedSnapshot.toString());
+  await (0, import_promises78.writeFile)(filepath, updatedSnapshot.toString());
 }
 
 // ../yaml/yaml-migrations/lib/migrations/0.9.10/index.js
@@ -1309961,7 +1310121,7 @@ ${source_default.dim(migration16.summary)}`
 }
 
 // src/commands/upgrade/upgrade.ts
-var import_promises78 = require("fs/promises");
+var import_promises79 = require("fs/promises");
 
 // ../../../node_modules/.pnpm/immer@9.0.15/node_modules/immer/dist/immer.esm.mjs
 function n(n2) {
@@ -1310450,7 +1310610,7 @@ async function upgrade({
     const newProjectConfig = immer_esm_default(projectConfig.rawConfig, (draft) => {
       draft.version = fernCliUpgradeInfo.latestVersion;
     });
-    await (0, import_promises78.writeFile)(projectConfig._absolutePath, JSON.stringify(newProjectConfig, void 0, 2));
+    await (0, import_promises79.writeFile)(projectConfig._absolutePath, JSON.stringify(newProjectConfig, void 0, 2));
     cliContext.logger.info(
       `Upgrading from ${source_default.dim(cliContext.environment.packageVersion)} \u2192 ${source_default.green(
         fernCliUpgradeInfo.latestVersion
@@ -1310471,125 +1310631,6 @@ async function upgrade({
   }
 }
 
-// src/commands/upgrade/upgradeGenerator.ts
-var import_promises79 = require("fs/promises");
-var import_path42 = __toESM(require("path"), 1);
-var semver3 = __toESM(require_semver2(), 1);
-var import_yaml11 = __toESM(require_dist5(), 1);
-async function loadAndUpdateGenerators({
-  absolutePathToWorkspace,
-  context,
-  generatorFilter,
-  groupFilter,
-  includeMajor
-}) {
-  const filepath = generators_yml_exports.getPathToGeneratorsConfiguration({ absolutePathToWorkspace });
-  if (!await doesPathExist(filepath)) {
-    context.failAndThrow("Generators configuration file was not found, no generators to upgrade.");
-    return void 0;
-  }
-  const contents = await (0, import_promises79.readFile)(filepath);
-  context.logger.debug(`Found generators: ${contents.toString()}`);
-  const parsedDocument = import_yaml11.default.parseDocument(contents.toString());
-  const generatorGroups = parsedDocument.get("groups");
-  if (generatorGroups == null) {
-    context.failAndThrow("No groups were found within the generators configuration, no generators to upgrade.");
-    return void 0;
-  }
-  if (!import_yaml11.default.isMap(generatorGroups)) {
-    context.failAndThrow(`Expected 'groups' to be a map in ${import_path42.default.relative(process.cwd(), filepath)}`);
-    return void 0;
-  }
-  context.logger.debug(`Groups found: ${generatorGroups.toString()}`);
-  for (const groupBlock of generatorGroups.items) {
-    const groupName = groupBlock.key;
-    const group = groupBlock.value;
-    if (!import_yaml11.default.isMap(group)) {
-      context.failAndThrow(
-        `Expected group ${groupName} to be a map in ${import_path42.default.relative(process.cwd(), filepath)}`
-      );
-      continue;
-    }
-    if (groupFilter != null && group.get("name") !== groupName) {
-      continue;
-    }
-    const generators = group.get("generators");
-    if (!import_yaml11.default.isSeq(generators)) {
-      context.failAndThrow(
-        `Expected group ${groupName} to have a 'generators' key in ${import_path42.default.relative(process.cwd(), filepath)}`
-      );
-      continue;
-    }
-    context.logger.debug(`Generators found: ${generators.toString()}`);
-    for (const generator of generators.items) {
-      if (!import_yaml11.default.isMap(generator)) {
-        context.failAndThrow(
-          `Expected generator in group ${groupName} to be a map in ${import_path42.default.relative(process.cwd(), filepath)}`
-        );
-      }
-      if (generatorFilter != null && generator.get("name") !== generatorFilter) {
-        continue;
-      }
-      const generatorName = generator.get("name");
-      const normalizedGeneratorName = generators_yml_exports.getGeneratorNameOrThrow(generatorName, context);
-      const currentVersion = generator.get("version");
-      const latestVersion2 = await generators_yml_exports.getLatestGeneratorVersion(normalizedGeneratorName, context);
-      context.logger.debug(`${generatorName}, ${currentVersion}, ${latestVersion2}`);
-      if (latestVersion2 == null) {
-        continue;
-      }
-      const currentMajor = semver3.major(currentVersion);
-      const latestMajor = semver3.major(latestVersion2);
-      if (currentMajor === latestMajor || includeMajor) {
-        generator.set("version", latestVersion2);
-        context.logger.info(source_default.green(`${generatorName} has been upgraded to latest in group: ${groupName}`));
-      }
-    }
-  }
-  return parsedDocument.toString();
-}
-async function upgradeGenerator2({
-  cliContext,
-  generator,
-  group,
-  project: { apiWorkspaces },
-  includeMajor
-}) {
-  await Promise.all(
-    apiWorkspaces.map(async (workspace) => {
-      await cliContext.runTaskForWorkspace(workspace, async (context) => {
-        var _a6;
-        const generatorsConfiguration = await generators_yml_exports.loadRawGeneratorsConfiguration({
-          absolutePathToWorkspace: workspace.absoluteFilepath,
-          context
-        }) ?? {};
-        if (generatorsConfiguration == null || generatorsConfiguration.groups == null) {
-          context.failAndThrow(
-            "No groups were found within the generators configuration, no generators to upgrade."
-          );
-          return;
-        }
-        context.logger.info(`Upgrading generators in workspace: ${workspace.workspaceName}`);
-        const updatedConfiguration = await loadAndUpdateGenerators({
-          absolutePathToWorkspace: workspace.absoluteFilepath,
-          context,
-          generatorFilter: generator,
-          groupFilter: group,
-          includeMajor
-        });
-        if (updatedConfiguration != null) {
-          await (0, import_promises79.writeFile)(
-            ((_a6 = workspace.generatorsConfiguration) == null ? void 0 : _a6.absolutePathToConfiguration) ?? generators_yml_exports.getPathToGeneratorsConfiguration({
-              absolutePathToWorkspace: workspace.absoluteFilepath
-            }),
-            updatedConfiguration
-          );
-        }
-      });
-    })
-  );
-}
-
 // src/commands/validate/validateWorkspaces.ts
 async function validateWorkspaces({
   project,
@@ -1310795,7 +1310836,6 @@ async function tryRunCli(cliContext) {
   addWriteOverridesCommand(cli, cliContext);
   addTestCommand(cli, cliContext);
   addUpdateApiSpecCommand(cli, cliContext);
-  addUpgradeGeneratorCommand(cli, cliContext);
   addUpgradeCommand({
     cli,
     cliContext,
@@ -1310804,7 +1310844,7 @@ async function tryRunCli(cliContext) {
     }
   });
   addGetOrganizationCommand(cli, cliContext);
-  addGeneratorListCommand(cli, cliContext);
+  addGeneratorCommands(cli, cliContext);
   cli.middleware(async (argv) => {
     cliContext.setLogLevel(argv["log-level"]);
     cliContext.logDebugInfo();
@@ -1311238,48 +1311278,6 @@ function addUpgradeCommand({
     }
   );
 }
-function addUpgradeGeneratorCommand(cli, cliContext) {
-  cli.command(
-    "generator upgrade",
-    `Upgrades the specified generator in ${GENERATORS_CONFIGURATION_FILENAME} to the latest stable version.`,
-    (yargs) => yargs.option("generator", {
-      string: true,
-      description: "The type of generator to upgrade, ex: `fern-typescript-node-sdk`."
-    }).option("group", {
-      string: true,
-      description: "The group in which the generator is located, if group is not specified, the all generators of the specified type will be upgraded."
-    }).option("api", {
-      string: true,
-      description: "The API to upgrade the generator for. If not specified, the generator will be upgraded for all APIs."
-    }).option("include-major", {
-      boolean: true,
-      default: false,
-      description: "Whether or not to include major versions within the upgrade. Defaults to false, meaning major versions will be skipped."
-    }),
-    async (argv) => {
-      cliContext.instrumentPostHogEvent({
-        command: "fern generator upgrade",
-        properties: {
-          generator: argv.generator,
-          version: argv.version,
-          api: argv.api,
-          group: argv.group,
-          includeMajor: argv.includeMajor
-        }
-      });
-      await upgradeGenerator2({
-        cliContext,
-        generator: argv.generator,
-        group: argv.group,
-        project: await loadProjectAndRegisterWorkspacesWithContext(cliContext, {
-          commandLineApiWorkspace: argv.api,
-          defaultToAllApiWorkspaces: true
-        }),
-        includeMajor: argv.includeMajor
-      });
-    }
-  );
-}
 function addUpdateApiSpecCommand(cli, cliContext) {
   cli.command(
     "api update",