@fern-api/fern-api-dev 4.107.1 → 4.107.2-1-g488c64ae1ff

package/cli.cjs

@@ -477450,7 +477450,8 @@ var USER_ENVIRONMENT_ERRNOS = /* @__PURE__ */ new Set([
   "EROFS",
   "EMFILE",
   "ENFILE",
-  "EBUSY"
+  "EBUSY",
+  "EADDRINUSE"
 ]);
 var NETWORK_ERRNOS = /* @__PURE__ */ new Set([
   "ENOTFOUND",
@@ -543610,6 +543611,7 @@ function parseVariantOverlays(variants) {
 }
 
 // ../configuration-loader/lib/fern-config-json/loadProjectConfig.js
+init_lib4();
 init_lib6();
 var import_promises15 = require("fs/promises");
 
@@ -543624,7 +543626,15 @@ var ProjectConfigSchema = external_exports2.strictObject({
 async function loadProjectConfig({ directory, context: context3 }) {
   const pathToConfig = join8(directory, RelativeFilePath2.of(PROJECT_CONFIG_FILENAME));
   const projectConfigStr = await (0, import_promises15.readFile)(pathToConfig);
-  const projectConfigParsed = JSON.parse(projectConfigStr.toString());
+  let projectConfigParsed;
+  try {
+    projectConfigParsed = JSON.parse(projectConfigStr.toString());
+  } catch (error50) {
+    throw new CliError({
+      message: `Failed to parse ${PROJECT_CONFIG_FILENAME}: ${extractErrorMessage(error50)}`,
+      code: CliError.Code.ParseError
+    });
+  }
   const rawProjectConfig = await validateSchema({
     schema: ProjectConfigSchema,
     value: projectConfigParsed,
@@ -599508,6 +599518,9 @@ async function parseOpenAPI({ absolutePathToOpenAPI, absolutePathToOpenAPIOverri
           `Continuing without full reference resolution.`
         ].join("\n"));
       }
+      if (circularRefs.length > 0) {
+        breakCircularRefCycles(document4, circularRefs);
+      }
       return document4;
     }
     throw error50;
@@ -599521,6 +599534,50 @@ async function readAndParseFile2(absoluteFilePath) {
   }
   return jsYaml.load(contents);
 }
+function breakCircularRefCycles(document4, circularRefs) {
+  if (typeof document4 !== "object" || document4 == null) {
+    return;
+  }
+  const backEdgeRefs = /* @__PURE__ */ new Set();
+  for (const info of circularRefs) {
+    if (info.ref.startsWith("#/")) {
+      backEdgeRefs.add(info.ref);
+    }
+  }
+  replaceCircularRefs(document4, backEdgeRefs);
+}
+function replaceCircularRefs(obj, targets2) {
+  if (typeof obj !== "object" || obj == null) {
+    return;
+  }
+  if (Array.isArray(obj)) {
+    for (let i9 = 0; i9 < obj.length; i9++) {
+      const item = obj[i9];
+      if (isCircularRefObject(item, targets2)) {
+        obj[i9] = { type: "object", "x-fern-circular-ref": true };
+      } else {
+        replaceCircularRefs(item, targets2);
+      }
+    }
+    return;
+  }
+  const record22 = obj;
+  for (const key2 of Object.keys(record22)) {
+    const value2 = record22[key2];
+    if (isCircularRefObject(value2, targets2)) {
+      record22[key2] = { type: "object", "x-fern-circular-ref": true };
+    } else {
+      replaceCircularRefs(value2, targets2);
+    }
+  }
+}
+function isCircularRefObject(value2, targets2) {
+  if (typeof value2 !== "object" || value2 == null || Array.isArray(value2)) {
+    return false;
+  }
+  const record22 = value2;
+  return typeof record22.$ref === "string" && targets2.has(record22.$ref);
+}
 
 // ../workspace/lazy-fern-workspace/lib/utils/resolveDescriptionMarkdownRefs.js
 init_lib4();
@@ -612723,6 +612780,16 @@ function collapseSpecBooleanSetting(specs, getter) {
   }
   return values2.every((v9) => v9 == null || v9 === true);
 }
+function toRelativePath(raw, field5) {
+  try {
+    return RelativeFilePath2.of(raw);
+  } catch {
+    throw new CliError({
+      message: `"${field5}: ${raw}" must be a relative path, not an absolute one.`,
+      code: CliError.Code.ConfigError
+    });
+  }
+}
 function convertRemoveDiscriminantsFromSchemas(specs) {
   if (specs.every((spec) => spec.settings?.removeDiscriminantsFromSchemas === generators_yml_exports.RemoveDiscriminantsFromSchemas.Never)) {
     return generators_yml_exports.RemoveDiscriminantsFromSchemas.Never;
@@ -613118,20 +613185,20 @@ var OSSWorkspace = class _OSSWorkspace extends BaseOpenAPIWorkspace {
     const specs = [];
     for (const spec of specsOverride) {
       if (generators_yml_exports.isOpenApiSpecSchema(spec)) {
-        const absoluteFilepath = join8(this.absoluteFilePath, RelativeFilePath2.of(spec.openapi));
+        const absoluteFilepath = join8(this.absoluteFilePath, toRelativePath(spec.openapi, "openapi"));
         let absoluteFilepathToOverrides;
         const specOverridePaths = [];
         if (spec.overrides != null) {
           if (Array.isArray(spec.overrides)) {
-            specOverridePaths.push(...spec.overrides.map((override) => join8(this.absoluteFilePath, RelativeFilePath2.of(override))));
+            specOverridePaths.push(...spec.overrides.map((override) => join8(this.absoluteFilePath, toRelativePath(override, "overrides"))));
           } else {
-            specOverridePaths.push(join8(this.absoluteFilePath, RelativeFilePath2.of(spec.overrides)));
+            specOverridePaths.push(join8(this.absoluteFilePath, toRelativePath(spec.overrides, "overrides")));
           }
         }
         if (specOverridePaths.length > 0) {
           absoluteFilepathToOverrides = specOverridePaths.length === 1 ? specOverridePaths[0] : specOverridePaths;
         }
-        const absoluteFilepathToOverlays = spec.overlays ? join8(this.absoluteFilePath, RelativeFilePath2.of(spec.overlays)) : void 0;
+        const absoluteFilepathToOverlays = spec.overlays ? join8(this.absoluteFilePath, toRelativePath(spec.overlays, "overlays")) : void 0;
         const openApiSpec = {
           type: "openapi",
           absoluteFilepath,
@@ -621305,7 +621372,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "4.107.1",
+          version: "4.107.2-1-g488c64ae1ff",
           usingAccessToken: true
         }
       });
@@ -621359,7 +621426,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "4.107.1",
+        version: "4.107.2-1-g488c64ae1ff",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -799353,7 +799420,10 @@ var DocsDefinitionResolver = class {
         }
       } catch (error50) {
         this.taskContext.logger.error(`Failed to parse ${relativePath}: ${extractErrorMessage(error50)}`);
-        throw error50;
+        throw new CliError({
+          message: `Failed to parse markdown file ${relativePath}: ${extractErrorMessage(error50)}`,
+          code: CliError.Code.ParseError
+        });
       }
     }
     const imageParseTime = performance.now() - imageParseStart;
@@ -833002,7 +833072,7 @@ var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 var MAX_LOGS_DIR_SIZE_BYTES = 100 * 1024 * 1024;
 function getCliSource() {
-  const version7 = "4.107.1";
+  const version7 = "4.107.2-1-g488c64ae1ff";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -834025,10 +834095,19 @@ async function getPreviewDocsDefinition({ domain: domain3, project, context: con
         absolutePathToFernFolder: docsWorkspace.absoluteFilePath,
         absolutePathToMarkdownFile: absoluteFilePath
       });
-      const { markdown: markdownWithAbsPaths, filepaths } = parseImagePaths(markdownReplacedMdAndCode, {
-        absolutePathToFernFolder: docsWorkspace.absoluteFilePath,
-        absolutePathToMarkdownFile: absoluteFilePath
-      });
+      let markdownWithAbsPaths;
+      let filepaths;
+      try {
+        ({ markdown: markdownWithAbsPaths, filepaths } = parseImagePaths(markdownReplacedMdAndCode, {
+          absolutePathToFernFolder: docsWorkspace.absoluteFilePath,
+          absolutePathToMarkdownFile: absoluteFilePath
+        }));
+      } catch (error50) {
+        throw new CliError({
+          message: `Failed to parse markdown in ${absoluteFilePath}: ${extractErrorMessage(error50)}`,
+          code: CliError.Code.ParseError
+        });
+      }
       if (previousDocsDefinition.filesV2 == null) {
         previousDocsDefinition.filesV2 = {};
       }
@@ -845411,7 +845490,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "4.107.1",
+        cliVersion: "4.107.2-1-g488c64ae1ff",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -881496,7 +881575,8 @@ var Comment6 = class extends AstNode6 {
       this.docs.split("\n").forEach((line) => {
         const wrappedLines = this.wrapLine(line, writer2);
         wrappedLines.forEach((wrappedLine) => {
-          writer2.writeLine(`# ${wrappedLine}`);
+          const trimmed2 = wrappedLine.trimEnd();
+          writer2.writeLine(trimmed2 === "" ? "#" : `# ${trimmed2}`);
         });
       });
     }
@@ -919528,10 +919608,15 @@ function processGeneratorGroups(groups2, maybeApiName, logger4) {
   for (const [groupName, group] of Object.entries(groups2)) {
     for (const [generatorName, generatorVersions] of Object.entries(group)) {
       logger4.debug(`Checking if ${generatorName} in group ${groupName} has an upgrade available...`);
-      const isUpgradeAvailable = isVersionAhead(
-        generatorVersions.latestVersion,
-        generatorVersions.previousVersion
-      );
+      let isUpgradeAvailable;
+      try {
+        isUpgradeAvailable = isVersionAhead(generatorVersions.latestVersion, generatorVersions.previousVersion);
+      } catch {
+        throw new CliError({
+          message: `Generator "${generatorName}" has an invalid version "${generatorVersions.previousVersion}" in generators.yml. Use an exact version like 1.2.3.`,
+          code: CliError.Code.ConfigError
+        });
+      }
       logger4.debug(
         `Latest version: ${generatorVersions.latestVersion}. ` + (isUpgradeAvailable ? "Upgrade available." : "No upgrade available.")
       );
@@ -919640,7 +919725,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "4.107.1";
+    return "4.107.2-1-g488c64ae1ff";
   }
   getCliName() {
     if (false) {
@@ -928173,7 +928258,9 @@ async function resolvePreviewUrlFromId({
   const fernDirectory = await getFernDirectory();
   if (fernDirectory == null) {
     return cliContext.failAndThrow(
-      "No fern directory found. The --id flag requires a Fern project to resolve the organization.\nRun this command from within a Fern project directory, or use the URL argument instead."
+      "No fern directory found. The --id flag requires a Fern project to resolve the organization.\nRun this command from within a Fern project directory, or use the URL argument instead.",
+      void 0,
+      { code: CliError.Code.ValidationError }
     );
   }
   const projectConfig = await cliContext.runTask(

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "4.107.1",
+  "version": "4.107.2-1-g488c64ae1ff",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",