@fern-api/fern-api-dev 3.57.1 → 3.58.0

package/cli.cjs

@@ -1659007,6 +1659007,7 @@ var DocsDefinitionResolver = class {
   markdownFilesToSidebarTitle = /* @__PURE__ */ new Map();
   markdownFilesToNoIndex = /* @__PURE__ */ new Map();
   markdownFilesToTags = /* @__PURE__ */ new Map();
+  markdownFilesToAvailability = /* @__PURE__ */ new Map();
   rawMarkdownFiles = {};
   referencedMarkdownFiles = [];
   async resolve() {
@@ -1659222,7 +1659223,7 @@ var DocsDefinitionResolver = class {
     return relative3(this.docsWorkspace.absoluteFilePath, filepath);
   }
   /**
-   * Extracts all frontmatter data (slug, sidebar-title, noindex, tags) from pages in a single pass.
+   * Extracts all frontmatter data (slug, sidebar-title, noindex, tags, availability) from pages in a single pass.
    * This is more efficient than parsing frontmatter multiple times for each field.
    * @param pages - the pages to extract frontmatter from
    */
@@ -1659253,6 +1659254,38 @@ var DocsDefinitionResolver = class {
       } else if (Array.isArray(tags)) {
         this.markdownFilesToTags.set(absolutePath, tags);
       }
+      const availability = frontmatter.data.availability;
+      if (typeof availability === "string") {
+        const parsedAvailability = this.parseAvailabilityFromFrontmatter(availability);
+        if (parsedAvailability != null) {
+          this.markdownFilesToAvailability.set(absolutePath, parsedAvailability);
+        }
+      }
+    }
+  }
+  /**
+   * Parses an availability string from frontmatter into the Availability enum value.
+   * @param value - the availability string from frontmatter
+   * @returns the Availability enum value, or undefined if the value is not valid
+   */
+  parseAvailabilityFromFrontmatter(value) {
+    const normalizedValue = value.toLowerCase().trim();
+    switch (normalizedValue) {
+      case "stable":
+        return "stable";
+      case "generally-available":
+        return "generally-available";
+      case "in-development":
+        return "in-development";
+      case "pre-release":
+        return "pre-release";
+      case "deprecated":
+        return "deprecated";
+      case "beta":
+        return "beta";
+      default:
+        this.taskContext.logger.warn(`Invalid availability value "${value}" in frontmatter. Valid values are: stable, generally-available, in-development, pre-release, deprecated, beta`);
+        return void 0;
     }
   }
   /**
@@ -1659907,6 +1659940,7 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
       fullSlug: this.markdownFilesToFullSlugs.get(item.absolutePath)?.split("/")
     });
     const id2 = this.#idgen.get(pageId);
+    const frontmatterAvailability = this.markdownFilesToAvailability.get(item.absolutePath);
     return {
       id: id2,
       type: "page",
@@ -1659920,7 +1659954,7 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
       authed: void 0,
       noindex: item.noindex || this.markdownFilesToNoIndex.get(item.absolutePath),
       featureFlags: item.featureFlags,
-      availability: item.availability ?? parentAvailability
+      availability: frontmatterAvailability ?? item.availability ?? parentAvailability
     };
   }
   async toSectionNode({ prefix: prefix2, item, parentSlug, hideChildren, parentAvailability }) {
@@ -1659933,6 +1659967,7 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
       skipUrlSlug: item.skipUrlSlug
     });
     const noindex = item.overviewAbsolutePath != null ? this.markdownFilesToNoIndex.get(item.overviewAbsolutePath) : void 0;
+    const frontmatterAvailability = item.overviewAbsolutePath != null ? this.markdownFilesToAvailability.get(item.overviewAbsolutePath) : void 0;
     const hiddenSection = hideChildren || item.hidden;
     const children2 = await Promise.all(item.contents.map((child) => this.toNavigationChild({
       prefix: id2,
@@ -1659964,7 +1659999,7 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
       pointsTo: void 0,
       noindex,
       featureFlags: item.featureFlags,
-      availability: item.availability ?? parentAvailability
+      availability: frontmatterAvailability ?? item.availability ?? parentAvailability
     };
   }
   async convertTabbedNavigation(prefix2, items, parentSlug) {
@@ -1678733,7 +1678768,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "3.57.1",
+          version: "3.58.0",
           usingAccessToken: true
         }
       });
@@ -1678783,7 +1678818,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "3.57.1",
+        version: "3.58.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -1710705,7 +1710740,7 @@ var CliContext = class {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "3.57.1";
+    return "3.58.0";
   }
   getCliName() {
     if (false) {
@@ -1713819,7 +1713854,7 @@ var import_path56 = __toESM(require("path"), 1);
 var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 function getCliSource() {
-  const version7 = "3.57.1";
+  const version7 = "3.58.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {

package/package.json

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