@fern-api/fern-api-dev 5.7.6 → 5.7.7

package/cli.cjs

@@ -535141,7 +535141,7 @@ var ExampleTypeFactory = class _ExampleTypeFactory {
         if (example != null) {
           const allowed = schema2.values.map((v9) => v9.value);
           const exampleStr = _ExampleTypeFactory.truncateExample(example);
-          this.context.logger.warn(`Example value ${exampleStr} is not a valid enum value${options2.name != null ? ` for '${options2.name}'` : ""}. Allowed values: [${allowed.join(", ")}]. Using fallback value instead.`);
+          this.context.logger.debug(`Example value ${exampleStr} is not a valid enum value${options2.name != null ? ` for '${options2.name}'` : ""}. Allowed values: [${allowed.join(", ")}]. Using fallback value instead.`);
         }
         return schema2.values[0] != null ? FullExample.enum(schema2.values[0]?.value) : void 0;
       case "literal":
@@ -535973,7 +535973,7 @@ var ExampleTypeFactory = class _ExampleTypeFactory {
     const fieldDesc = options2.name != null ? ` for '${options2.name}'` : "";
     const actualType = typeof example;
     const exampleStr = _ExampleTypeFactory.truncateExample(example);
-    this.context.logger.warn(`Invalid example${fieldDesc}: expected ${expected} but got ${actualType} (${exampleStr}). The provided example does not match the '${schemaType}' schema and will be replaced with a generated value.`);
+    this.context.logger.debug(`Invalid example${fieldDesc}: expected ${expected} but got ${actualType} (${exampleStr}). The provided example does not match the '${schemaType}' schema and will be replaced with a generated value.`);
   }
   static truncateExample(example, maxLength = 100) {
     const str3 = JSON.stringify(example);
@@ -541476,7 +541476,6 @@ function replaceWithSchemaReference({ openapi, replaceReference, schemaReference
 // ../api-importers/openapi/openapi-ir-parser/lib/openapi/v3/generateIr.js
 function generateIr({ openApi, taskContext, options: options2, source: source2, namespace }) {
   openApi = runResolutions({ openapi: openApi });
-  validateOpenApiSpecForDocsCompat({ openApi, taskContext });
   resetTitleCollisionTracker();
   const tempContext = new OpenAPIV3ParserContext({
     document: openApi,
@@ -541911,35 +541910,6 @@ function getAllParentSchemaIds({ schema: schema2, schemas }) {
 function distinct(array3) {
   return [...new Set(array3)];
 }
-var NON_ASCII_REGEX = new RegExp("[^\\x00-\\x7F]");
-var FRONTMATTER_DELIMITER_REGEX = /(?:^|\n)\s*---\s*(?:\n|$)/;
-function validateOpenApiSpecForDocsCompat({ openApi, taskContext }) {
-  for (const tag2 of openApi.tags ?? []) {
-    if (NON_ASCII_REGEX.test(tag2.name)) {
-      const nonAsciiChars = [...tag2.name].filter((c5) => NON_ASCII_REGEX.test(c5));
-      taskContext.logger.error(`Tag name "${tag2.name}" contains non-ASCII characters: ${nonAsciiChars.join(", ")}. Non-ASCII characters in tag names will be included in URL paths and HTTP headers, which only support ASCII characters. This will cause runtime errors (ERR_INVALID_CHAR). Remove non-ASCII characters from the tag name.`);
-    }
-  }
-  for (const [path106, pathItem] of Object.entries(openApi.paths ?? {})) {
-    if (pathItem == null) {
-      continue;
-    }
-    for (const method8 of ["get", "post", "put", "delete", "patch", "options", "head", "trace"]) {
-      const operation = pathItem[method8];
-      if (operation?.description != null && FRONTMATTER_DELIMITER_REGEX.test(operation.description)) {
-        taskContext.logger.error(`Description at paths.${path106}.${method8} contains "---" frontmatter delimiters which will cause YAML parsing failures in the generated docs site. Remove the "---" delimiters from the description.`);
-      }
-      if (operation?.tags != null && (openApi.tags == null || openApi.tags.length === 0)) {
-        for (const tag2 of operation.tags) {
-          if (NON_ASCII_REGEX.test(tag2)) {
-            const nonAsciiChars = [...tag2].filter((c5) => NON_ASCII_REGEX.test(c5));
-            taskContext.logger.error(`Tag name "${tag2}" at paths.${path106}.${method8} contains non-ASCII characters: ${nonAsciiChars.join(", ")}. Remove non-ASCII characters from the tag name.`);
-          }
-        }
-      }
-    }
-  }
-}
 function getAudiences({ operation }) {
   let endpointAudiences = [];
   switch (operation.type) {
@@ -607103,23 +607073,23 @@ var ExampleValidator = class {
 };
 
 // ../api-importers/v3-importer-commons/lib/OpenApiSpecValidations.js
-var NON_ASCII_REGEX2 = new RegExp("[^\\x00-\\x7F]");
-var FRONTMATTER_DELIMITER_REGEX2 = /(?:^|\n)\s*---\s*(?:\n|$)/;
+var NON_ASCII_REGEX = new RegExp("[^\\x00-\\x7F]");
+var FRONTMATTER_DELIMITER_REGEX = /(?:^|\n)\s*---\s*(?:\n|$)/;
 function validateTagNames({ tags, errorCollector }) {
   for (const tag2 of tags) {
-    if (NON_ASCII_REGEX2.test(tag2.name)) {
-      const nonAsciiChars = [...tag2.name].filter((c5) => NON_ASCII_REGEX2.test(c5));
+    if (NON_ASCII_REGEX.test(tag2.name)) {
+      const nonAsciiChars = [...tag2.name].filter((c5) => NON_ASCII_REGEX.test(c5));
       errorCollector.collect({
         level: APIErrorLevel.ERROR,
         message: `Tag name "${tag2.name}" contains non-ASCII characters: ${nonAsciiChars.join(", ")}. Non-ASCII characters in tag names will be included in URL paths and HTTP headers, which only support ASCII characters. This will cause runtime errors (ERR_INVALID_CHAR).`,
         path: ["tags", tag2.name],
-        resolution: `Remove non-ASCII characters from the tag name. For example, rename "${tag2.name}" to "${tag2.name.replace(NON_ASCII_REGEX2, "").trim()}".`
+        resolution: `Remove non-ASCII characters from the tag name. For example, rename "${tag2.name}" to "${tag2.name.replace(NON_ASCII_REGEX, "").trim()}".`
       });
     }
   }
 }
 function validateDescription({ description, path: path106, errorCollector }) {
-  if (FRONTMATTER_DELIMITER_REGEX2.test(description)) {
+  if (FRONTMATTER_DELIMITER_REGEX.test(description)) {
     errorCollector.collect({
       level: APIErrorLevel.ERROR,
       message: `Description contains "---" frontmatter delimiters which will cause YAML parsing failures in the generated docs site. The docs renderer interprets content between "---" delimiters as YAML frontmatter, which will fail if the content is not valid YAML.`,
@@ -607156,14 +607126,14 @@ function validateOpenApiSpec({ spec, errorCollector }) {
         }
         if (Array.isArray(op4.tags) && !Array.isArray(spec.tags)) {
           for (const tag2 of op4.tags) {
-            if (typeof tag2 === "string" && !seenTags.has(tag2) && NON_ASCII_REGEX2.test(tag2)) {
+            if (typeof tag2 === "string" && !seenTags.has(tag2) && NON_ASCII_REGEX.test(tag2)) {
               seenTags.add(tag2);
-              const nonAsciiChars = [...tag2].filter((c5) => NON_ASCII_REGEX2.test(c5));
+              const nonAsciiChars = [...tag2].filter((c5) => NON_ASCII_REGEX.test(c5));
               errorCollector.collect({
                 level: APIErrorLevel.ERROR,
                 message: `Tag name "${tag2}" contains non-ASCII characters: ${nonAsciiChars.join(", ")}. Non-ASCII characters in tag names will be included in URL paths and HTTP headers, which only support ASCII characters. This will cause runtime errors (ERR_INVALID_CHAR).`,
                 path: ["paths", path106, method8, "tags"],
-                resolution: `Remove non-ASCII characters from the tag name. For example, rename "${tag2}" to "${tag2.replace(NON_ASCII_REGEX2, "").trim()}".`
+                resolution: `Remove non-ASCII characters from the tag name. For example, rename "${tag2}" to "${tag2.replace(NON_ASCII_REGEX, "").trim()}".`
               });
             }
           }
@@ -614844,7 +614814,7 @@ function audiencesIntersect(a3, b8) {
 
 // ../workspace/oss-validator/lib/rules/no-invalid-tag-names-or-frontmatter/no-invalid-tag-names-or-frontmatter.js
 init_lib6();
-var NON_ASCII_REGEX3 = new RegExp("[^\\x00-\\x7F]");
+var NON_ASCII_REGEX2 = new RegExp("[^\\x00-\\x7F]");
 var FRONTMATTER_REGEX = /(?:^|\n)\s*---\s*(?:\n|$)/;
 var HTTP_METHODS = ["get", "post", "put", "delete", "patch", "options", "head", "trace"];
 var NoInvalidTagNamesOrFrontmatterRule = {
@@ -614865,8 +614835,8 @@ var NoInvalidTagNamesOrFrontmatterRule = {
       if (Array.isArray(apiDoc.tags)) {
         for (const tag2 of apiDoc.tags) {
           if (typeof tag2 === "object" && tag2 != null && typeof tag2.name === "string") {
-            if (NON_ASCII_REGEX3.test(tag2.name)) {
-              const nonAsciiChars = [...tag2.name].filter((c5) => NON_ASCII_REGEX3.test(c5));
+            if (NON_ASCII_REGEX2.test(tag2.name)) {
+              const nonAsciiChars = [...tag2.name].filter((c5) => NON_ASCII_REGEX2.test(c5));
               violations.push({
                 name: "no-invalid-tag-names-or-frontmatter",
                 severity: "error",
@@ -614902,9 +614872,9 @@ var NoInvalidTagNamesOrFrontmatterRule = {
             }
             if (Array.isArray(op4.tags) && !Array.isArray(apiDoc.tags)) {
               for (const tag2 of op4.tags) {
-                if (typeof tag2 === "string" && !seenInlineTags.has(tag2) && NON_ASCII_REGEX3.test(tag2)) {
+                if (typeof tag2 === "string" && !seenInlineTags.has(tag2) && NON_ASCII_REGEX2.test(tag2)) {
                   seenInlineTags.add(tag2);
-                  const nonAsciiChars = [...tag2].filter((c5) => NON_ASCII_REGEX3.test(c5));
+                  const nonAsciiChars = [...tag2].filter((c5) => NON_ASCII_REGEX2.test(c5));
                   violations.push({
                     name: "no-invalid-tag-names-or-frontmatter",
                     severity: "error",
@@ -622607,7 +622577,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.7.6",
+          version: "5.7.7",
           usingAccessToken: true
         }
       });
@@ -622661,7 +622631,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.7.6",
+        version: "5.7.7",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -847021,7 +846991,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 = "5.7.6";
+  const version7 = "5.7.7";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -859637,7 +859607,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.7.6",
+        cliVersion: "5.7.7",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -904967,6 +904937,11 @@ var Expression2 = class extends AstNode8 {
       case "string-literal":
         writer2.write(this.internalExpression.escape ? `"${escapeSwiftStringLiteralContent(this.internalExpression.value)}"` : `"${this.internalExpression.value}"`);
         break;
+      case "raw-multi-line-string-literal":
+        writer2.write(`#"""
+${this.internalExpression.value}
+"""#`);
+        break;
       case "number-literal":
         writer2.write(this.internalExpression.value.toString());
         break;
@@ -905115,6 +905090,18 @@ var Expression2 = class extends AstNode8 {
   static escapedStringLiteral(value2) {
     return new this({ type: "string-literal", value: value2, escape: true });
   }
+  /**
+   * Emits `value` as a Swift raw multi-line string literal (`#"""..."""#`).
+   * Inside a raw string literal, escape sequences such as `\n` are NOT
+   * interpreted by the Swift compiler -- they remain as literal
+   * backslash-n characters at runtime. Use this when `value` already
+   * contains escape sequences that must survive verbatim into the
+   * runtime `String` (e.g. JSON payloads where `\n` must reach the
+   * JSON parser as `\n`, not as a real newline).
+   */
+  static rawMultiLineStringLiteral(value2) {
+    return new this({ type: "raw-multi-line-string-literal", value: value2 });
+  }
   static numberLiteral(value2) {
     return new this({ type: "number-literal", value: value2 });
   }
@@ -934062,7 +934049,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.7.6";
+    return "5.7.7";
   }
   getCliName() {
     if (false) {
@@ -949155,6 +949142,7 @@ async function formatWorkspaces({
 // src/commands/generate/generateDocsWorkspace.ts
 init_lib4();
 init_js();
+init_lib6();
 
 // src/utils/environment.ts
 function detectCISource() {
@@ -949358,22 +949346,21 @@ ${source_default.yellow("?")} Are you sure you want to continue?`,
     const skippedWorkspacePaths = /* @__PURE__ */ new Set();
     const ossWorkspacesForValidation = await filterOssWorkspaces(project);
     for (const ossWorkspace of ossWorkspacesForValidation) {
+      const apiName = ossWorkspace.workspaceName ?? basename3(ossWorkspace.absoluteFilePath);
       try {
         const violations = await validateOSSWorkspace(ossWorkspace, context3);
         const errors4 = violations.filter((v9) => v9.severity === "fatal" || v9.severity === "error");
         if (errors4.length > 0) {
-          for (const error50 of errors4) {
-            context3.logger.warn(`${error50.relativeFilepath}: ${error50.message}`);
-          }
-          context3.logger.warn(
-            `Skipping API workspace at ${ossWorkspace.absoluteFilePath} due to ${errors4.length} validation error${errors4.length !== 1 ? "s" : ""}. Run fern check for details.`
+          const reasons = summarizeValidationErrors(errors4);
+          const reasonList = reasons.map((r5) => `  - ${r5}`).join("\n");
+          context3.logger.error(
+            `Skipping API ${apiName} due to ${errors4.length} validation error${errors4.length !== 1 ? "s" : ""}:
+${reasonList}`
           );
           skippedWorkspacePaths.add(ossWorkspace.absoluteFilePath);
         }
       } catch (error50) {
-        context3.logger.warn(
-          `Skipping API workspace at ${ossWorkspace.absoluteFilePath}: ${extractErrorMessage(error50)}`
-        );
+        context3.logger.error(`Skipping API ${apiName}: ${extractErrorMessage(error50)}`);
         skippedWorkspacePaths.add(ossWorkspace.absoluteFilePath);
       }
     }
@@ -949413,6 +949400,37 @@ function getExcludeRules(brokenLinks, strictBrokenLinks) {
   }
   return excludeRules;
 }
+function summarizeValidationErrors(errors4) {
+  const summaries = [];
+  const frontmatterEndpoints = [];
+  const nonAsciiTags = [];
+  const otherErrors = [];
+  for (const error50 of errors4) {
+    if (error50.message.includes("---") && error50.message.includes("frontmatter")) {
+      const methodPathMatch = error50.message.match(/for ((?:GET|POST|PUT|DELETE|PATCH|OPTIONS|HEAD|TRACE) \S+)/);
+      frontmatterEndpoints.push(methodPathMatch?.[1] ?? error50.nodePath.join("."));
+    } else if (error50.message.includes("non-ASCII")) {
+      const tagMatch = error50.message.match(/Tag name "([^"]+)"/);
+      nonAsciiTags.push(tagMatch?.[1] ?? "unknown");
+    } else {
+      otherErrors.push(error50);
+    }
+  }
+  if (frontmatterEndpoints.length > 0) {
+    summaries.push(
+      `${frontmatterEndpoints.length} endpoint${frontmatterEndpoints.length !== 1 ? "s" : ""} contain "---" frontmatter delimiters that will cause 500 errors on the docs site`
+    );
+  }
+  if (nonAsciiTags.length > 0) {
+    summaries.push(
+      `${nonAsciiTags.length} tag${nonAsciiTags.length !== 1 ? "s" : ""} contain non-ASCII characters: ${nonAsciiTags.join(", ")}`
+    );
+  }
+  for (const error50 of otherErrors) {
+    summaries.push(`${error50.relativeFilepath}: ${error50.message}`);
+  }
+  return summaries;
+}
 
 // src/commands/generate-dynamic-ir/generateDynamicIrForWorkspaces.ts
 init_lib6();

package/package.json

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