@fern-api/fern-api-dev 5.109.0 → 5.109.2

package/cli.cjs

@@ -373999,6 +373999,17 @@ async function getAuthFromOverrideFiles(specs) {
   }
   return void 0;
 }
+function getOrphanedAuthSchemeWarning(api2) {
+  if (api2?.auth != null) {
+    return void 0;
+  }
+  const names2 = Object.keys(api2?.["auth-schemes"] ?? {});
+  const first3 = names2[0];
+  if (first3 == null) {
+    return void 0;
+  }
+  return `generators.yml declares auth-schemes (${names2.join(", ")}) but no \`api.auth\`, so the entire auth-schemes block is ignored \u2014 including any \`env:\` overrides. Add \`auth: ${first3}\` under \`api\`` + (names2.length > 1 ? ", or list them all under an `auth.any` key" : "") + ". Without it, auth is re-derived from the spec's securitySchemes and each generator falls back to its own default environment variable name.";
+}
 var import_promises41, OSSWorkspace;
 var init_OSSWorkspace = __esm({
   "../workspace/lazy-fern-workspace/lib/OSSWorkspace.js"() {
@@ -374176,6 +374187,10 @@ var init_OSSWorkspace = __esm({
         const specs = await this.getOpenAPISpecsCached({ context: context3 });
         const documents = await this.loader.loadDocuments({ context: context3, specs });
         let authOverrides = this.generatorsConfiguration?.api?.auth != null ? { ...this.generatorsConfiguration?.api } : void 0;
+        const orphanedAuthSchemeWarning = getOrphanedAuthSchemeWarning(this.generatorsConfiguration?.api);
+        if (orphanedAuthSchemeWarning != null) {
+          context3.logger.warn(orphanedAuthSchemeWarning);
+        }
         if (authOverrides == null) {
           authOverrides = await getAuthFromOverrideFiles(specs);
         }
@@ -705213,7 +705228,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.109.0",
+          version: "5.109.2",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -705279,7 +705294,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.109.0",
+        version: "5.109.2",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -881625,9 +881640,54 @@ function createDocsResolverValidationContext() {
 function isV1RootNode2(value2) {
   return "type" in value2 && value2.type === "root";
 }
+async function getIntermediateRepresentation({ apiWorkspace, ossWorkspaces, useOpenApiParserV3, audiences, logger: logger4 }) {
+  const ossWorkspace = useOpenApiParserV3 ? ossWorkspaces.find((ossWorkspace2) => ossWorkspace2 === apiWorkspace) : void 0;
+  if (ossWorkspace != null) {
+    try {
+      return await ossWorkspace.getIntermediateRepresentation({
+        context: NOOP_CONTEXT,
+        audiences,
+        enableUniqueErrorsPerEndpoint: true,
+        generateV1Examples: false,
+        logWarnings: false
+      });
+    } catch (error50) {
+      logger4.debug(`Failed to load API definition with the OpenAPI parser: ${error50}`);
+    }
+  }
+  try {
+    const fernWorkspace = await apiWorkspace.toFernWorkspace({ context: NOOP_CONTEXT }, {
+      enableUniqueErrorsPerEndpoint: true,
+      detectGlobalHeaders: false,
+      objectQueryParameters: true,
+      preserveSchemaIds: true
+    });
+    return generateIntermediateRepresentation({
+      workspace: fernWorkspace,
+      audiences,
+      generationLanguage: void 0,
+      keywords: void 0,
+      smartCasing: false,
+      exampleGeneration: {
+        disabled: false,
+        skipAutogenerationIfManualExamplesExist: true,
+        skipErrorAutogenerationIfManualErrorExamplesExist: true
+      },
+      readme: void 0,
+      version: void 0,
+      packageName: void 0,
+      context: NOOP_CONTEXT,
+      sourceResolver: new SourceResolverImpl(NOOP_CONTEXT, fernWorkspace)
+    });
+  } catch (error50) {
+    logger4.debug(`Failed to load API definition; skipping link validation for it: ${error50}`);
+    return void 0;
+  }
+}
 var ValidMarkdownLinks = {
   name: "valid-markdown-links",
-  create: async ({ workspace, apiWorkspaces, ossWorkspaces }) => {
+  create: async ({ workspace, apiWorkspaces, ossWorkspaces, logger: logger4 }) => {
+    const useOpenApiParserV3 = workspace.config.experimental?.openapiParserV3 !== false;
     const instanceUrls = getInstanceUrls(workspace);
     const url3 = instanceUrls[0] ?? "http://localhost";
     const baseUrl = toBaseUrl(instanceUrls[0] ?? "http://localhost");
@@ -881737,23 +881797,20 @@ var ValidMarkdownLinks = {
         return [...violations, ...pathToCheckViolations.flat()];
       },
       apiSection: async ({ workspace: apiWorkspace, config: config5 }) => {
-        const fernWorkspace = await apiWorkspace.toFernWorkspace({ context: NOOP_CONTEXT }, { enableUniqueErrorsPerEndpoint: true, detectGlobalHeaders: false });
-        const ir3 = generateIntermediateRepresentation({
-          workspace: fernWorkspace,
-          audiences: config5.audiences ? {
-            type: "select",
-            audiences: Array.isArray(config5.audiences) ? config5.audiences : [config5.audiences]
-          } : { type: "all" },
-          generationLanguage: void 0,
-          keywords: void 0,
-          smartCasing: false,
-          exampleGeneration: { disabled: false },
-          readme: void 0,
-          version: void 0,
-          packageName: void 0,
-          context: NOOP_CONTEXT,
-          sourceResolver: new SourceResolverImpl(NOOP_CONTEXT, fernWorkspace)
+        const audiences = config5.audiences ? {
+          type: "select",
+          audiences: Array.isArray(config5.audiences) ? config5.audiences : [config5.audiences]
+        } : { type: "all" };
+        const ir3 = await getIntermediateRepresentation({
+          apiWorkspace,
+          ossWorkspaces,
+          useOpenApiParserV3,
+          audiences,
+          logger: logger4
         });
+        if (ir3 == null) {
+          return [];
+        }
         const api2 = toLatest(convertIrToApiDefinition({ ir: ir3, apiDefinitionId: (0, import_crypto9.randomUUID)(), context: NOOP_CONTEXT }));
         const uniqueDescriptions = collectUniqueDescriptions(api2);
         const violations = [];
@@ -882430,8 +882487,22 @@ function createDocsConfigFileAstVisitorForRules({ relativeFilepath, allRulesWith
       for (const { ruleName, visitor } of allRulesWithVisitors) {
         const visitFromRule = visitor[nodeType];
         if (visitFromRule != null) {
-          const ruleViolations = await visitFromRule(node4);
           const severityOverride = severityOverrides?.get(ruleName);
+          let ruleViolations;
+          try {
+            ruleViolations = await visitFromRule(node4);
+          } catch (error50) {
+            addViolations([
+              {
+                name: ruleName,
+                severity: severityOverride ?? "fatal",
+                relativeFilepath: RelativeFilePath2.of(""),
+                nodePath,
+                message: `Rule "${ruleName}" failed to run: ${formatInitError(error50)}`
+              }
+            ]);
+            continue;
+          }
           addViolations(ruleViolations.map((violation) => ({
             name: violation.name ?? ruleName,
             severity: severityOverride ?? violation.severity,
@@ -886897,7 +886968,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.109.0";
+  const version7 = "5.109.2";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -913861,7 +913932,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.109.0",
+        cliVersion: "5.109.2",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -967278,7 +967349,7 @@ init_lib17();
 init_lib36();
 init_lib27();
 init_lib23();
-async function getIntermediateRepresentation({ workspace, audiences, generatorInvocation, context: context3, irVersionOverride, version: version7, packageName, userAgentTemplate, organization, sourceConfig, includeOptionalRequestPropertyExamples, ir: ir3 }) {
+async function getIntermediateRepresentation2({ workspace, audiences, generatorInvocation, context: context3, irVersionOverride, version: version7, packageName, userAgentTemplate, organization, sourceConfig, includeOptionalRequestPropertyExamples, ir: ir3 }) {
   const resolvedUserAgentTemplate = userAgentTemplate ?? getUserAgentTemplateFromGeneratorConfig(generatorInvocation);
   const idempotencyKeyGeneration = getIdempotencyKeyGenerationFromGeneratorConfig(generatorInvocation);
   const intermediateRepresentation = ir3 ?? generateIntermediateRepresentation({
@@ -968448,7 +968519,7 @@ function extractLicenseFilePath(generatorInvocation, absolutePathToFernConfig) {
 async function writeFilesToDiskAndRunGenerator({ organization, absolutePathToFernConfig, workspace, generatorInvocation, absolutePathToLocalOutput, absolutePathToLocalSnippetJSON, absolutePathToLocalSnippetTemplateJSON, audiences, version: version7, workspaceTempDir, keepDocker, context: context3, irVersionOverride, outputVersionOverride, writeUnitTests, generateOauthClients, generatePaginatedClients, includeOptionalRequestPropertyExamples, inspect: inspect6, executionEnvironment, runner, whiteLabel, publishToRegistry, ir: ir3, ai: ai2, autoVersioningCache, absolutePathToSpecRepo, skipFernignore, disableTelemetry, rawApiSpecs }) {
   const irVersion = version7 ?? outputVersionOverride;
   const effectiveIrVersion = irVersion != null && (0, import_autoversion4.isAutoVersion)(irVersion) ? import_autoversion4.MAGIC_VERSION : irVersion;
-  const { latest: latest2, migrated } = await getIntermediateRepresentation({
+  const { latest: latest2, migrated } = await getIntermediateRepresentation2({
     workspace,
     audiences,
     generatorInvocation,
@@ -980781,7 +980852,7 @@ function getAutomationContextFromEnv() {
     config_branch: process.env.FERN_CONFIG_BRANCH,
     config_pr_number: process.env.FERN_CONFIG_PR_NUMBER,
     trigger: process.env.GITHUB_EVENT_NAME,
-    cli_version: "5.109.0"
+    cli_version: "5.109.2"
   };
 }
 function isAutomationMode() {
@@ -981613,7 +981684,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.109.0";
+    return "5.109.2";
   }
   getCliName() {
     if (false) {
@@ -993853,7 +993924,7 @@ async function generateIrForWorkspaces({
     project.apiWorkspaces.map(async (workspace) => {
       await cliContext.runTaskForWorkspace(workspace, async (context3) => {
         cliContext.logger.info(`Generating IR for workspace ${workspace.workspaceName ?? "api"}`);
-        const intermediateRepresentation = await getIntermediateRepresentation2({
+        const intermediateRepresentation = await getIntermediateRepresentation3({
           workspace,
           context: context3,
           generationLanguage,
@@ -993872,7 +993943,7 @@ async function generateIrForWorkspaces({
     })
   );
 }
-async function getIntermediateRepresentation2({
+async function getIntermediateRepresentation3({
   workspace,
   context: context3,
   generationLanguage,

package/package.json

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