fern-api 0.19.2 → 0.19.4

package/bundle.cjs

@@ -797931,7 +797931,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "0.19.2",
+          version: "0.19.4",
           usingAccessToken: true
         }
       });
@@ -797993,7 +797993,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "0.19.2",
+        version: "0.19.4",
         ...event,
         ...event.properties
       }
@@ -814391,6 +814391,11 @@ var DummyOpenAPIV3ParserContext = class extends AbstractOpenAPIV3ParserContext {
   getErrors() {
     return {};
   }
+  excludeSchema(_schemaId) {
+  }
+  isSchemaExcluded(_schemaId) {
+    return false;
+  }
 };
 
 // pnp:/home/circleci/project/packages/cli/openapi-parser/lib/openapi/v3/extensions/getFernAvailability.js
@@ -814836,6 +814841,9 @@ function convertStreamingOperation({ operationContext, context, streamingExtensi
         streamingExtension,
         isStreaming: true
       });
+      if ((streamingRequestBody == null ? void 0 : streamingRequestBody.schemaReference) != null) {
+        context.excludeSchema(getSchemaIdFromReference(streamingRequestBody.schemaReference));
+      }
       const streamingResponses = getResponses({
         operation: operationContext.operation,
         response: streamingExtension.responseStream
@@ -814849,7 +814857,7 @@ function convertStreamingOperation({ operationContext, context, streamingExtensi
           } : void 0,
           operation: {
             ...operationContext.operation,
-            requestBody: streamingRequestBody,
+            requestBody: streamingRequestBody == null ? void 0 : streamingRequestBody.requestBody,
             responses: streamingResponses
           },
           baseBreadcrumbs: [...operationContext.baseBreadcrumbs, STREAM_SUFFIX]
@@ -814873,7 +814881,7 @@ function convertStreamingOperation({ operationContext, context, streamingExtensi
           ...operationContext,
           operation: {
             ...operationContext.operation,
-            requestBody: nonStreamingRequestBody,
+            requestBody: nonStreamingRequestBody == null ? void 0 : nonStreamingRequestBody.requestBody,
             responses: nonStreamingResponses
           }
         },
@@ -814916,14 +814924,18 @@ function getRequestBody2({ context, operation, streamingExtension, isStreaming }
         ...streamingProperty ?? {}
       }
     },
+    title: void 0,
     required: [...resolvedRequstBodySchema.required ?? [], streamingExtension.streamConditionProperty]
   };
   return {
-    content: {
-      "application/json": {
-        schema: requestBodySchemaWithLiteralProperty
+    requestBody: {
+      content: {
+        "application/json": {
+          schema: requestBodySchemaWithLiteralProperty
+        }
       }
-    }
+    },
+    schemaReference: isReferenceObject(jsonMediaObject.schema) ? jsonMediaObject.schema : void 0
   };
 }
 function getResponses({ operation, response }) {
@@ -815355,6 +815367,7 @@ var OpenAPIV3ParserContext = class extends AbstractOpenAPIV3ParserContext {
   singleRequestReferencedSchemas = /* @__PURE__ */ new Set();
   discrminatedUnionReferences = {};
   errorBodies = {};
+  schemasToExclude = /* @__PURE__ */ new Set();
   constructor({ document: document4, taskContext, authHeaders }) {
     super({ document: document4, taskContext, authHeaders });
   }
@@ -815414,6 +815427,12 @@ var OpenAPIV3ParserContext = class extends AbstractOpenAPIV3ParserContext {
     });
     return errors;
   }
+  excludeSchema(schemaId) {
+    this.schemasToExclude.add(schemaId);
+  }
+  isSchemaExcluded(schemaId) {
+    return this.schemasToExclude.has(schemaId);
+  }
 };
 
 // pnp:/home/circleci/project/packages/cli/openapi-parser/lib/openapi/v3/extensions/getFernResolutions.js
@@ -815621,11 +815640,15 @@ function generateIr({ openApi, taskContext, disableExamples }) {
       examples
     };
   });
-  const schemas = Object.fromEntries(Object.entries(schemasWithExample).map(([key2, schemaWithExample]) => {
-    taskContext.logger.debug(`Converting schema ${key2}`);
+  const schemas = {};
+  for (const [key2, schemaWithExample] of Object.entries(schemasWithExample)) {
     const schema2 = convertSchemaWithExampleToSchema(schemaWithExample);
-    return [key2, schema2];
-  }));
+    if (context.isSchemaExcluded(key2)) {
+      continue;
+    }
+    schemas[key2] = schema2;
+    taskContext.logger.debug(`Converted schema ${key2}`);
+  }
   const ir = {
     title: openApi.info.title,
     description: openApi.info.description,
@@ -824771,10 +824794,10 @@ var CliContext = class {
     return "fern-api";
   }
   getPackageVersion() {
-    if ("0.19.2" == null) {
+    if ("0.19.4" == null) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "0.19.2";
+    return "0.19.4";
   }
   getCliName() {
     if ("fern" == null) {
@@ -841003,10 +841026,6 @@ async function runRemoteGenerationForAPIWorkspace({ organization, workspace, con
   };
 }
 
-// pnp:/home/circleci/project/packages/cli/config-management/docs-configuration/lib/parseDocsConfiguration.js
-var import_fdr_sdk3 = __toESM(require_dist());
-var import_promises40 = require("fs/promises");
-
 // pnp:/home/circleci/project/.yarn/cache/tinycolor2-npm-1.6.0-8df41252c6-6df4d07fce.zip/node_modules/tinycolor2/esm/tinycolor.js
 function _typeof2(obj) {
   "@babel/helpers - typeof";
@@ -841986,6 +842005,7 @@ function validateWCAG2Parms(parms) {
 
 // pnp:/home/circleci/project/packages/cli/config-management/docs-configuration/lib/convertColorsConfiguration.js
 function convertColorsConfiguration(rawConfig, context) {
+  rawConfig.accentPrimary = rawConfig.accentPrimary ?? rawConfig.accentPrimaryDeprecated;
   const colorType = getColorType(rawConfig);
   switch (colorType) {
     case "dark":
@@ -842041,74 +842061,46 @@ function getColorType({ background, accentPrimary, accentPrimaryDeprecated }) {
 }
 function convertThemedColorConfig(rawConfig, context, theme) {
   var _a2, _b2, _c2, _d;
-  let accentPrimaryColor = getColorInstanceFromRawConfig(rawConfig.accentPrimary, context, "accent-primary", theme) ?? tinycolor.random();
-  let backgroundColor = getColorInstanceFromRawConfig(rawConfig.background, context, "background", theme);
-  if (backgroundColor != null) {
-    const newBackgroundColor = enforceBackgroundTheme(tinycolor(backgroundColor.toString()), theme);
-    if (newBackgroundColor.toHexString() !== backgroundColor.toHexString()) {
-      context.logger.warn(`The chosen shade, 'colors.background' in ${theme} mode, fails to meet minimum contrast requirements. The brightness is ${backgroundColor.getBrightness()}. To enhance accessibility and ensure content readability, Fern will adjust from ${backgroundColor.toHexString()} to a more contrast-rich ${newBackgroundColor.toHexString()}.`);
-      backgroundColor = newBackgroundColor;
-    }
-  }
-  if (accentPrimaryColor != null) {
-    const backgroundColorWithFallback = backgroundColor ?? tinycolor(theme === "dark" ? "#000" : "#FFF");
-    const newAccentPrimaryColor = increaseForegroundContrast(tinycolor(accentPrimaryColor.toString()), backgroundColorWithFallback);
-    if (newAccentPrimaryColor.toHexString() !== accentPrimaryColor.toHexString()) {
-      const ratio = tinycolor.readability(accentPrimaryColor, backgroundColorWithFallback);
-      context.logger.warn(`The chosen shade, 'colors.accent-primary' in ${theme} mode, fails to meet minimum contrast requirements. The contrast ratio is ${ratio}, which is below WCAG AA requirements (4.5:1). To enhance accessibility and ensure content readability, Fern will adjust from ${accentPrimaryColor.toHexString()} to a more contrast-rich ${newAccentPrimaryColor.toHexString()}.`);
-      accentPrimaryColor = newAccentPrimaryColor;
-    }
-  }
+  const accentPrimaryColor = getColorInstanceFromRawConfigOrThrow(rawConfig.accentPrimary ?? rawConfig.accentPrimaryDeprecated, context, "accent-primary", theme) ?? tinycolor.random();
+  const backgroundColor = getColorInstanceFromRawConfigOrThrow(rawConfig.background, context, "background", theme);
   return {
     accentPrimary: accentPrimaryColor.toRgb(),
     background: backgroundColor == null ? void 0 : backgroundColor.toRgb(),
-    border: (_a2 = getColorInstanceFromRawConfig(rawConfig.border, context, "border", theme)) == null ? void 0 : _a2.toRgb(),
-    sidebarBackground: (_b2 = getColorInstanceFromRawConfig(rawConfig.sidebarBackground, context, "sidebar-background", theme)) == null ? void 0 : _b2.toRgb(),
-    headerBackground: (_c2 = getColorInstanceFromRawConfig(rawConfig.headerBackground, context, "header-background", theme)) == null ? void 0 : _c2.toRgb(),
-    cardBackground: (_d = getColorInstanceFromRawConfig(rawConfig.cardBackground, context, "card-background", theme)) == null ? void 0 : _d.toRgb()
+    border: (_a2 = getColorInstanceFromRawConfigOrThrow(rawConfig.border, context, "border", theme)) == null ? void 0 : _a2.toRgb(),
+    sidebarBackground: (_b2 = getColorInstanceFromRawConfigOrThrow(rawConfig.sidebarBackground, context, "sidebar-background", theme)) == null ? void 0 : _b2.toRgb(),
+    headerBackground: (_c2 = getColorInstanceFromRawConfigOrThrow(rawConfig.headerBackground, context, "header-background", theme)) == null ? void 0 : _c2.toRgb(),
+    cardBackground: (_d = getColorInstanceFromRawConfigOrThrow(rawConfig.cardBackground, context, "card-background", theme)) == null ? void 0 : _d.toRgb()
   };
 }
-function increaseForegroundContrast(foregroundColor, backgroundColor) {
-  let newForgroundColor = foregroundColor;
-  const dark = backgroundColor.isDark();
-  while (!tinycolor.isReadable(newForgroundColor, backgroundColor)) {
-    if (dark ? newForgroundColor.getBrightness() === 255 : newForgroundColor.getBrightness() === 0) {
-      break;
-    }
-    newForgroundColor = dark ? newForgroundColor.lighten(1) : newForgroundColor.darken(1);
+function getColorFromRawConfig(raw, key2, theme) {
+  if (raw == null) {
+    return void 0;
   }
-  return newForgroundColor;
-}
-function enforceBackgroundTheme(color3, theme) {
-  if (theme === "dark" && color3.isDark()) {
-    return color3;
-  } else if (theme === "light" && color3.isLight()) {
-    return color3;
+  let rawColor = typeof raw === "string" ? raw : raw[theme];
+  if (rawColor == null && key2 === "accent-primary" && typeof raw !== "string") {
+    rawColor = raw[theme === "dark" ? "light" : "dark"];
   }
-  return getOppositeBrightness(color3);
-}
-function getOppositeBrightness(color3) {
-  if (color3 == null) {
+  if (rawColor == null) {
     return void 0;
   }
-  const { h: h3, s: s2, v: v2 } = color3.toHsv();
-  return tinycolor({ h: h3, s: s2, v: 1 - v2 });
+  return rawColor;
 }
-function getColorInstanceFromRawConfig(raw, context, key2, theme) {
-  if (raw == null) {
-    return void 0;
-  }
-  const rawColor = typeof raw === "string" ? raw : raw[theme];
-  if (rawColor == null) {
+function getColorInstanceFromRawConfigOrThrow(raw, context, key2, theme) {
+  const color3 = getColorFromRawConfig(raw, key2, theme);
+  if (color3 == null) {
     return void 0;
   }
-  const color3 = tinycolor(rawColor);
-  if (!color3.isValid()) {
+  const instance = tinycolor(color3);
+  if (!instance.isValid()) {
     context.failAndThrow(`'${typeof raw === "string" ? key2 : `colors.${key2}.${theme}`}' should be a hex color of the format #FFFFFF`);
   }
-  return color3;
+  return instance;
 }
 
+// pnp:/home/circleci/project/packages/cli/config-management/docs-configuration/lib/parseDocsConfiguration.js
+var import_fdr_sdk3 = __toESM(require_dist());
+var import_promises40 = require("fs/promises");
+
 // pnp:/home/circleci/project/packages/cli/config-management/docs-configuration/lib/getAllPages.js
 var import_promises39 = require("fs/promises");
 async function getAllPages({ navigation, absolutePathToFernFolder }) {
@@ -843441,6 +843433,95 @@ function createDocsConfigFileAstVisitorForRules({ relativeFilepath, allRuleVisit
   };
 }
 
+// pnp:/home/circleci/project/packages/cli/yaml/docs-validator/lib/rules/accent-color-contrast/index.js
+var AccentColorContrastRule = {
+  name: "accent-color-contrast",
+  create: () => {
+    return {
+      file: async ({ config }) => {
+        if (config.colors == null) {
+          return [];
+        }
+        const colorType = getColorType(config.colors);
+        if (colorType === "dark") {
+          return validateTheme(config.colors, "dark");
+        } else if (colorType === "light") {
+          return validateTheme(config.colors, "light");
+        } else if (colorType === "darkAndLight") {
+          return [...validateTheme(config.colors, "dark"), ...validateTheme(config.colors, "light")];
+        }
+        return [];
+      }
+    };
+  }
+};
+function validateTheme(colors, theme) {
+  const accentPrimaryColor = getColorFromRawConfig(colors.accentPrimary ?? colors.accentPrimaryDeprecated, "accent-primary", theme);
+  let backgroundColor = getColorFromRawConfig(colors.background, "background", theme) ?? (theme === "dark" ? "#000" : "#FFF");
+  const ruleViolations = [];
+  if (!tinycolor(backgroundColor).isValid()) {
+    ruleViolations.push({
+      severity: "error",
+      message: `Invalid background color provided for colors.background.${theme}: ${backgroundColor}.`
+    });
+  } else {
+    const newBackground = enforceBackgroundTheme(tinycolor(backgroundColor), theme);
+    if (tinycolor(backgroundColor).toHexString() !== newBackground.toHexString()) {
+      ruleViolations.push({
+        severity: "warning",
+        message: `The provided background color for ${theme} mode is not ${theme} enough. It will be adjusted to ${newBackground.toHexString()}.`
+      });
+    }
+    backgroundColor = newBackground.toHexString();
+  }
+  if (accentPrimaryColor == null) {
+    ruleViolations.push({
+      severity: "warning",
+      message: `No accent-color provided for ${theme} mode. A random color will be used.`
+    });
+  } else if (!tinycolor(accentPrimaryColor).isValid()) {
+    ruleViolations.push({
+      severity: "error",
+      message: `Invalid accent-color provided for colors.accent-primary.${theme}: ${accentPrimaryColor}.`
+    });
+  } else {
+    const ratio = tinycolor.readability(accentPrimaryColor, backgroundColor);
+    const readableRatio = `${ratio.toFixed(2)}:1`;
+    if (ratio < 3) {
+      ruleViolations.push({
+        severity: "warning",
+        message: `The contrast ratio between the accent color and the background color for ${theme} mode is ${readableRatio}. It should be at least 3:1.`
+      });
+    } else if (ratio < 4.5) {
+      ruleViolations.push({
+        severity: "warning",
+        message: `The contrast ratio between the accent color and the background color for ${theme} mode is ${readableRatio}. Fern will adjust the color to meet the minimum contrast ratio of 4.5:1 for WCAG AA and 7:1 for WCAG AAA.`
+      });
+    } else if (ratio < 7) {
+      ruleViolations.push({
+        severity: "warning",
+        message: `The contrast ratio between the accent color and the background color for ${theme} mode is ${readableRatio}. Fern will adjust the color to meet the minimum contrast ratio of 7:1 for WCAG AAA.`
+      });
+    }
+  }
+  return ruleViolations;
+}
+function enforceBackgroundTheme(color3, theme) {
+  if (theme === "dark" && color3.isDark()) {
+    return color3;
+  } else if (theme === "light" && color3.isLight()) {
+    return color3;
+  }
+  return getOppositeBrightness(color3);
+}
+function getOppositeBrightness(color3) {
+  if (color3 == null) {
+    return void 0;
+  }
+  const { h: h3, s: s2, v: v2 } = color3.toHsv();
+  return tinycolor({ h: h3, s: s2, v: 1 - v2 });
+}
+
 // pnp:/home/circleci/project/packages/cli/yaml/docs-validator/lib/rules/filepaths-exist/filepaths-exist.js
 var FilepathsExistRule = {
   name: "filepaths-exist",
@@ -868868,7 +868949,13 @@ var ValidateVersionFileRule = {
 
 // pnp:/home/circleci/project/packages/cli/yaml/docs-validator/lib/getAllRules.js
 function getAllRules2() {
-  return [FilepathsExistRule, ValidMarkdownRule, OnlyVersionedNavigation, ValidateVersionFileRule];
+  return [
+    FilepathsExistRule,
+    ValidMarkdownRule,
+    OnlyVersionedNavigation,
+    ValidateVersionFileRule,
+    AccentColorContrastRule
+  ];
 }
 
 // pnp:/home/circleci/project/packages/cli/yaml/docs-validator/lib/validateDocsWorkspace.js

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fern-api",
-  "version": "0.19.2",
+  "version": "0.19.4",
   "repository": {
     "type": "git",
     "url": "https://github.com/fern-api/fern.git",