@fern-api/fern-api-dev 5.109.1 → 5.109.3

package/cli.cjs

@@ -347311,6 +347311,9 @@ var init_ErrorCollector = __esm({
 });
 
 // ../api-importers/v3-importer-commons/lib/AbstractConverterContext.js
+function isMarkedDeprecated(node4) {
+  return "deprecated" in node4 && node4.deprecated === true;
+}
 var AbstractConverterContext;
 var init_AbstractConverterContext = __esm({
   "../api-importers/v3-importer-commons/lib/AbstractConverterContext.js"() {
@@ -347733,13 +347736,30 @@ var init_AbstractConverterContext = __esm({
         return converted.audiences;
       }
       getAvailability({ node: node4, breadcrumbs }) {
+        const visitedReferences = /* @__PURE__ */ new Set();
         while (this.isReferenceObject(node4)) {
+          const declared = this.getDeclaredAvailability({ node: node4, breadcrumbs });
+          if (declared != null) {
+            return declared;
+          }
+          if (visitedReferences.has(node4.$ref)) {
+            return void 0;
+          }
+          visitedReferences.add(node4.$ref);
           const resolved = this.resolveReference({ reference: node4 });
           if (!resolved.resolved) {
             return void 0;
           }
           node4 = resolved.value;
         }
+        return this.getDeclaredAvailability({ node: node4, breadcrumbs });
+      }
+      /**
+       * Reads the availability declared directly on a node, without resolving references.
+       * Annotations written alongside a `$ref` describe that particular usage, so callers
+       * consult them before falling back to the referenced schema.
+       */
+      getDeclaredAvailability({ node: node4, breadcrumbs }) {
         const availabilityExtension = new extensions_exports.FernAvailabilityExtension({
           node: node4,
           breadcrumbs,
@@ -347752,7 +347772,7 @@ var init_AbstractConverterContext = __esm({
             message: void 0
           };
         }
-        if (node4.deprecated === true) {
+        if (isMarkedDeprecated(node4)) {
           return {
             status: AvailabilityStatus.Deprecated,
             message: void 0
@@ -352364,7 +352384,11 @@ var init_SchemaOrReferenceConverter = __esm({
           if (response.ok) {
             return {
               type: this.wrapTypeReference(response.reference),
-              inlinedTypes: response.inlinedTypes ?? {}
+              inlinedTypes: response.inlinedTypes ?? {},
+              availability: this.context.getAvailability({
+                node: schemaOrReference,
+                breadcrumbs: this.breadcrumbs
+              })
             };
           }
         }
@@ -352384,7 +352408,8 @@ var init_SchemaOrReferenceConverter = __esm({
             if (response.ok) {
               return {
                 type: this.wrapTypeReference(response.reference),
-                inlinedTypes: response.inlinedTypes ?? {}
+                inlinedTypes: response.inlinedTypes ?? {},
+                availability: this.getAvailabilityOfSelfOrReference(allOfReference)
               };
             }
           }
@@ -352406,13 +352431,39 @@ var init_SchemaOrReferenceConverter = __esm({
             if (response.ok) {
               return {
                 type: this.wrapTypeReference(response.reference),
-                inlinedTypes: response.inlinedTypes ?? {}
+                inlinedTypes: response.inlinedTypes ?? {},
+                availability: this.getAvailabilityOfSelfOrReference(singleRef)
               };
             }
           }
         }
         return void 0;
       }
+      /**
+       * Availability declared alongside the `allOf` takes precedence over the availability
+       * of the referenced schema, since the outer schema is the more specific declaration.
+       * Inline `allOf` siblings are consulted next: when the sibling carries nothing but
+       * metadata we short-circuit to the `$ref`, so a `deprecated` written there would
+       * otherwise be dropped.
+       */
+      getAvailabilityOfSelfOrReference(reference4) {
+        for (const node4 of [...this.getSelfAndInlineAllOfElements(), reference4]) {
+          const availability = this.context.getAvailability({ node: node4, breadcrumbs: this.breadcrumbs });
+          if (availability != null) {
+            return availability;
+          }
+        }
+        return void 0;
+      }
+      getSelfAndInlineAllOfElements() {
+        if (this.context.isReferenceObject(this.schemaOrReference) || this.schemaOrReference.allOf == null) {
+          return [this.schemaOrReference];
+        }
+        return [
+          this.schemaOrReference,
+          ...this.schemaOrReference.allOf.filter((element4) => !this.context.isReferenceObject(element4))
+        ];
+      }
       convertSchemaObject({ schema }) {
         const schemaId = this.schemaIdOverride ?? this.context.convertBreadcrumbsToName(this.breadcrumbs);
         const namespacedSchemaId = this.context.getNamespacedSchemaId(schemaId);
@@ -373999,6 +374050,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 +374238,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 +705279,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.109.1",
+          version: "5.109.3",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -705279,7 +705345,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.109.1",
+        version: "5.109.3",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -886953,7 +887019,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.1";
+  const version7 = "5.109.3";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -913917,7 +913983,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.109.1",
+        cliVersion: "5.109.3",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -980837,7 +980903,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.1"
+    cli_version: "5.109.3"
   };
 }
 function isAutomationMode() {
@@ -981669,7 +981735,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.109.1";
+    return "5.109.3";
   }
   getCliName() {
     if (false) {

package/package.json

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