@fern-api/fern-api-dev 5.16.0-2-g8c4df38ae6a → 5.16.0-3-g504bbfdb500

package/cli.cjs

@@ -660824,7 +660824,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.16.0-2-g8c4df38ae6a",
+          version: "5.16.0-3-g504bbfdb500",
           usingAccessToken: true
         }
       });
@@ -660878,7 +660878,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.16.0-2-g8c4df38ae6a",
+        version: "5.16.0-3-g504bbfdb500",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -824006,15 +824006,31 @@ var CHANGELOG_FEED_ALLOWED_SLUGS = [
   "whatsnew"
 ];
 var DEFAULT_CHANGELOG_TITLE3 = "Changelog";
-function getEffectiveChangelogSlugLastSegment(config5) {
+function getEffectiveChangelogSlugSegments(config5) {
   const raw = config5.slug ?? kebabCase_default(config5.title ?? DEFAULT_CHANGELOG_TITLE3);
-  const segments = raw.split("/").filter((s9) => s9.length > 0);
+  return splitSegments(raw);
+}
+function getEffectiveChangelogSlugLastSegment(config5) {
+  const segments = getEffectiveChangelogSlugSegments(config5);
   return segments[segments.length - 1] ?? "";
 }
-function isAllowedChangelogSlug(lastSegment) {
-  return CHANGELOG_FEED_ALLOWED_SLUGS.includes(lastSegment);
+function isAllowedChangelogSlug(segment) {
+  return CHANGELOG_FEED_ALLOWED_SLUGS.includes(segment);
+}
+function hasAllowedChangelogSegment(segments) {
+  return segments.some((segment) => isAllowedChangelogSlug(segment));
+}
+function ancestorSlugSegments(opts) {
+  if (opts.skipSlug) {
+    return [];
+  }
+  const raw = opts.slug ?? kebabCase_default(opts.displayName ?? "");
+  return splitSegments(raw);
 }
-function collectChangelogLocations(items, breadcrumb) {
+function splitSegments(raw) {
+  return raw.split("/").filter((segment) => segment.length > 0);
+}
+function collectChangelogLocations(items, breadcrumb, ancestorSegments) {
   if (items == null) {
     return [];
   }
@@ -824024,18 +824040,24 @@ function collectChangelogLocations(items, breadcrumb) {
       out.push({
         where: `${breadcrumb} > changelog (${item.changelog})`,
         slug: item.slug,
-        title: item.title
+        title: item.title,
+        ancestorSegments
       });
       continue;
     }
     if (isSection3(item)) {
       const next2 = `${breadcrumb} > section "${item.section}"`;
-      out.push(...collectChangelogLocations(item.contents, next2));
+      const sectionSegments = ancestorSlugSegments({
+        slug: item.slug,
+        displayName: item.section,
+        skipSlug: item.skipSlug
+      });
+      out.push(...collectChangelogLocations(item.contents, next2, [...ancestorSegments, ...sectionSegments]));
     }
   }
   return out;
 }
-function collectFromTabs(tabs, breadcrumb) {
+function collectFromTabs(tabs, breadcrumb, ancestorSegments) {
   if (tabs == null) {
     return [];
   }
@@ -824045,13 +824067,14 @@ function collectFromTabs(tabs, breadcrumb) {
       out.push({
         where: `${breadcrumb} > tab "${tabId}" (changelog: ${tab2.changelog})`,
         slug: tab2.slug,
-        title: tab2.displayName
+        title: tab2.displayName,
+        ancestorSegments
       });
     }
   }
   return out;
 }
-function collectFromNavigation(navigation2, breadcrumb) {
+function collectFromNavigation(navigation2, tabs, breadcrumb, ancestorSegments) {
   if (navigation2 == null || !Array.isArray(navigation2) || navigation2.length === 0) {
     return [];
   }
@@ -824059,32 +824082,49 @@ function collectFromNavigation(navigation2, breadcrumb) {
     const out = [];
     for (const item of navigation2) {
       const next2 = `${breadcrumb} > tab "${item.tab}"`;
+      const tabConfig = tabs?.[item.tab];
+      const tabSegments = ancestorSlugSegments({
+        slug: tabConfig?.slug,
+        displayName: tabConfig?.displayName ?? item.tab,
+        skipSlug: tabConfig?.skipSlug
+      });
+      const tabAncestors = [...ancestorSegments, ...tabSegments];
       if ("layout" in item && Array.isArray(item.layout)) {
-        out.push(...collectChangelogLocations(item.layout, next2));
+        out.push(...collectChangelogLocations(item.layout, next2, tabAncestors));
       }
       if ("variants" in item && Array.isArray(item.variants)) {
         for (const variant of item.variants) {
           const variantBreadcrumb = `${next2} > variant "${variant.title}"`;
-          out.push(...collectChangelogLocations(variant.layout, variantBreadcrumb));
+          const variantSegments = ancestorSlugSegments({
+            slug: variant.slug,
+            displayName: variant.title,
+            skipSlug: variant.skipSlug
+          });
+          out.push(...collectChangelogLocations(variant.layout, variantBreadcrumb, [
+            ...tabAncestors,
+            ...variantSegments
+          ]));
         }
       }
     }
     return out;
   }
-  return collectChangelogLocations(navigation2, breadcrumb);
+  return collectChangelogLocations(navigation2, breadcrumb, ancestorSegments);
 }
 function violationsForLocations(locations) {
   const violations = [];
   for (const loc of locations) {
-    const lastSegment = getEffectiveChangelogSlugLastSegment(loc);
-    if (lastSegment === "" || isAllowedChangelogSlug(lastSegment)) {
+    const ownSegments = getEffectiveChangelogSlugSegments(loc);
+    const allSegments = [...loc.ancestorSegments, ...ownSegments];
+    if (allSegments.length === 0 || hasAllowedChangelogSegment(allSegments)) {
       continue;
     }
     const allowed = CHANGELOG_FEED_ALLOWED_SLUGS.join(", ");
     const sourceField = loc.slug != null ? `slug: "${loc.slug}"` : `title: "${loc.title ?? DEFAULT_CHANGELOG_TITLE3}"`;
+    const fullPath = "/" + allSegments.join("/");
     violations.push({
       severity: "error",
-      message: `Changelog at ${loc.where} resolves to URL segment "${lastSegment}" (from ${sourceField}). The docs server only serves changelog feeds (.rss, .atom, .json) when the final URL segment is one of: ${allowed}. Rename the changelog's title or set an explicit slug to one of these values, otherwise subscribers will get a 404 when they request the feed.`
+      message: `Changelog at ${loc.where} resolves to URL path "${fullPath}" (from ${sourceField}). The docs server only serves changelog feeds (.rss, .atom, .json) when at least one segment of the URL is one of: ${allowed}. Rename the changelog (or one of its parent tabs/sections), or set an explicit slug to one of these values, otherwise subscribers will get a 404 when they request the feed.`
     });
   }
   return violations;
@@ -824095,8 +824135,8 @@ var ValidChangelogSlugRule = {
     return {
       file: async ({ config: config5 }) => {
         const locations = [
-          ...collectFromNavigation(config5.navigation, "navigation"),
-          ...collectFromTabs(config5.tabs, "tabs")
+          ...collectFromNavigation(config5.navigation, config5.tabs, "navigation", []),
+          ...collectFromTabs(config5.tabs, "tabs", [])
         ];
         return violationsForLocations(locations);
       },
@@ -824107,8 +824147,8 @@ var ValidChangelogSlugRule = {
         }
         const versionConfig = parseResult.contents;
         const locations = [
-          ...collectFromNavigation(versionConfig.navigation, `version "${path106}" navigation`),
-          ...collectFromTabs(versionConfig.tabs, `version "${path106}" tabs`)
+          ...collectFromNavigation(versionConfig.navigation, versionConfig.tabs, `version "${path106}" navigation`, []),
+          ...collectFromTabs(versionConfig.tabs, `version "${path106}" tabs`, [])
         ];
         return violationsForLocations(locations);
       },
@@ -824119,8 +824159,8 @@ var ValidChangelogSlugRule = {
         }
         const productConfig = parseResult.contents;
         const locations = [
-          ...collectFromNavigation(productConfig.navigation, `product "${path106}" navigation`),
-          ...collectFromTabs(productConfig.tabs, `product "${path106}" tabs`)
+          ...collectFromNavigation(productConfig.navigation, productConfig.tabs, `product "${path106}" navigation`, []),
+          ...collectFromTabs(productConfig.tabs, `product "${path106}" tabs`, [])
         ];
         return violationsForLocations(locations);
       }
@@ -851819,7 +851859,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.16.0-2-g8c4df38ae6a";
+  const version7 = "5.16.0-3-g504bbfdb500";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -864628,7 +864668,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.16.0-2-g8c4df38ae6a",
+        cliVersion: "5.16.0-3-g504bbfdb500",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -939206,7 +939246,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.16.0-2-g8c4df38ae6a";
+    return "5.16.0-3-g504bbfdb500";
   }
   getCliName() {
     if (false) {

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "5.16.0-2-g8c4df38ae6a",
+  "version": "5.16.0-3-g504bbfdb500",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",