@fern-api/fern-api-dev 4.100.2 → 4.101.0

package/cli.cjs

@@ -510425,7 +510425,8 @@ var DocsSettingsConfig = external_exports.object({
   "disable-analytics": external_exports.boolean().optional(),
   language: Language.optional(),
   "folder-title-source": TitleSource.optional(),
-  "substitute-env-vars": external_exports.boolean().optional()
+  "substitute-env-vars": external_exports.boolean().optional(),
+  "websocket-oneof-display": external_exports.enum(["flat", "grouped"]).optional()
 });
 var ColorsConfiguration = external_exports.object({
   "accent-primary": ColorConfig.optional(),
@@ -510965,6 +510966,7 @@ __export(schemas_exports7, {
   TitleSource: () => TitleSource2,
   TwitterCardSetting: () => TwitterCardSetting2,
   VersionAvailability: () => VersionAvailability2,
+  WebSocketOneofDisplay: () => WebSocketOneofDisplay,
   docs: () => docs_exports,
   logging: () => logging,
   serialization: () => serialization_exports3
@@ -511006,6 +511008,7 @@ __export(api_exports2, {
   TitleSource: () => TitleSource2,
   TwitterCardSetting: () => TwitterCardSetting2,
   VersionAvailability: () => VersionAvailability2,
+  WebSocketOneofDisplay: () => WebSocketOneofDisplay,
   docs: () => docs_exports
 });
 
@@ -511044,7 +511047,8 @@ __export(docs_exports, {
   Target: () => Target2,
   TitleSource: () => TitleSource2,
   TwitterCardSetting: () => TwitterCardSetting2,
-  VersionAvailability: () => VersionAvailability2
+  VersionAvailability: () => VersionAvailability2,
+  WebSocketOneofDisplay: () => WebSocketOneofDisplay
 });
 
 // ../configuration/lib/docs-yml/schemas/sdk/api/resources/docs/types/AiChatLocation.js
@@ -511307,6 +511311,12 @@ var VersionAvailability2 = {
   Beta: "beta"
 };
 
+// ../configuration/lib/docs-yml/schemas/sdk/api/resources/docs/types/WebSocketOneofDisplay.js
+var WebSocketOneofDisplay = {
+  Flat: "flat",
+  Grouped: "grouped"
+};
+
 // ../configuration/lib/docs-yml/schemas/sdk/core/json.js
 var toJson2 = (value2, replacer, space2) => {
   return JSON.stringify(value2, replacer, space2);
@@ -511631,6 +511641,7 @@ __export(serialization_exports3, {
   VersionConfig: () => VersionConfig2,
   VersionFileConfig: () => VersionFileConfig2,
   VersionedSnippetLanguageConfiguration: () => VersionedSnippetLanguageConfiguration2,
+  WebSocketOneofDisplay: () => WebSocketOneofDisplay2,
   WithFeatureFlags: () => WithFeatureFlags2,
   WithPermissions: () => WithPermissions2,
   WithViewers: () => WithViewers2,
@@ -511783,6 +511794,7 @@ __export(docs_exports2, {
   VersionConfig: () => VersionConfig2,
   VersionFileConfig: () => VersionFileConfig2,
   VersionedSnippetLanguageConfiguration: () => VersionedSnippetLanguageConfiguration2,
+  WebSocketOneofDisplay: () => WebSocketOneofDisplay2,
   WithFeatureFlags: () => WithFeatureFlags2,
   WithPermissions: () => WithPermissions2,
   WithViewers: () => WithViewers2
@@ -513652,6 +513664,9 @@ var Language3 = schemas_exports6.enum_([
 // ../configuration/lib/docs-yml/schemas/sdk/serialization/resources/docs/types/TitleSource.js
 var TitleSource3 = schemas_exports6.enum_(["frontmatter", "filename"]);
 
+// ../configuration/lib/docs-yml/schemas/sdk/serialization/resources/docs/types/WebSocketOneofDisplay.js
+var WebSocketOneofDisplay2 = schemas_exports6.enum_(["flat", "grouped"]);
+
 // ../configuration/lib/docs-yml/schemas/sdk/serialization/resources/docs/types/DocsSettingsConfig.js
 var DocsSettingsConfig2 = schemas_exports6.object({
   searchText: schemas_exports6.property("search-text", schemas_exports6.string().optional()),
@@ -513666,7 +513681,8 @@ var DocsSettingsConfig2 = schemas_exports6.object({
   disableAnalytics: schemas_exports6.property("disable-analytics", schemas_exports6.boolean().optional()),
   language: Language3.optional(),
   folderTitleSource: schemas_exports6.property("folder-title-source", TitleSource3.optional()),
-  substituteEnvVars: schemas_exports6.property("substitute-env-vars", schemas_exports6.boolean().optional())
+  substituteEnvVars: schemas_exports6.property("substitute-env-vars", schemas_exports6.boolean().optional()),
+  websocketOneofDisplay: schemas_exports6.property("websocket-oneof-display", WebSocketOneofDisplay2.optional())
 });
 
 // ../configuration/lib/docs-yml/schemas/sdk/serialization/resources/docs/types/FontStyle.js
@@ -542192,7 +542208,8 @@ function convertSettingsConfig(settings) {
     useJavascriptAsTypescript: settings.useJavascriptAsTypescript ?? false,
     disableExplorerProxy: settings.disableExplorerProxy ?? false,
     disableEnvironmentEditing: settings.disableEnvironmentEditing ?? false,
-    disableAnalytics: settings.disableAnalytics ?? false
+    disableAnalytics: settings.disableAnalytics ?? false,
+    websocketOneofDisplay: settings.websocketOneofDisplay ?? void 0
   };
 }
 async function parseTextFile({ rawPath, absoluteFilepathToDocsConfig }) {
@@ -620916,7 +620933,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "4.100.2",
+          version: "4.101.0",
           usingAccessToken: true
         }
       });
@@ -620970,7 +620987,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "4.100.2",
+        version: "4.101.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -805103,6 +805120,7 @@ __export(rules_exports, {
   NoCircularRedirectsRule: () => NoCircularRedirectsRule,
   OnlyVersionedNavigation: () => OnlyVersionedNavigation,
   TabWithHrefRule: () => TabWithHrefRule,
+  TranslationDirectoriesExistRule: () => TranslationDirectoriesExistRule,
   ValidDocsEndpoints: () => ValidDocsEndpoints,
   ValidFileTypes: () => ValidFileTypes,
   ValidFrontmatter: () => ValidFrontmatter,
@@ -806069,6 +806087,74 @@ function tabbedNavigationItemHasVariants4(item) {
   return "variants" in item && Array.isArray(item.variants);
 }
 
+// ../yaml/docs-validator/lib/rules/translation-directories-exist/translation-directories-exist.js
+init_lib6();
+var TranslationDirectoriesExistRule = {
+  name: "translation-directories-exist",
+  create: ({ workspace }) => {
+    return {
+      file: async ({ config: config5 }) => {
+        const violations = [];
+        const translations = config5.translations;
+        if (translations == null || translations.length === 0) {
+          return violations;
+        }
+        const defaultLocale = translations.find((t3) => t3.default === true)?.lang;
+        const translationsDir = join8(workspace.absoluteFilePath, RelativeFilePath2.of("translations"));
+        const translationsDirExists = await doesPathExist(translationsDir);
+        const missingDirs = [];
+        for (const translation of translations) {
+          if (translation.lang === defaultLocale) {
+            continue;
+          }
+          const langDir = join8(translationsDir, RelativeFilePath2.of(translation.lang));
+          if (!await doesPathExist(langDir)) {
+            missingDirs.push(translation.lang);
+          }
+        }
+        if (missingDirs.length > 0) {
+          const expectedTree = buildExpectedDirectoryTree({
+            translationsDirExists,
+            missingDirs,
+            fernFolderPath: workspace.absoluteFilePath
+          });
+          const pad3 = "            ";
+          const indentedTree = expectedTree.split("\n").map((line) => `${pad3}${line}`).join("\n");
+          violations.push({
+            severity: "error",
+            message: `Missing translation ${missingDirs.length === 1 ? "directory" : "directories"} for ${missingDirs.length === 1 ? "locale" : "locales"}: ${missingDirs.join(", ")}
+
+${pad3}Expected directory structure:
+
+${indentedTree}
+
+${pad3}Each translation directory should mirror the same page paths used in your
+${pad3}docs.yml navigation. For example, if your navigation references
+${pad3}"pages/getting-started.mdx", create a translated version at
+${pad3}"translations/${missingDirs[0]}/pages/getting-started.mdx".`
+          });
+        }
+        return violations;
+      }
+    };
+  }
+};
+function buildExpectedDirectoryTree({ translationsDirExists, missingDirs, fernFolderPath }) {
+  const fernDirName = fernFolderPath.split("/").pop() ?? "fern";
+  const lines = [];
+  lines.push(`  ${fernDirName}/`);
+  lines.push(`  ${translationsDirExists ? "\u251C" : "\u2514"}\u2500\u2500 translations/`);
+  for (let i9 = 0; i9 < missingDirs.length; i9++) {
+    const isLast = i9 === missingDirs.length - 1;
+    const connector = isLast ? "\u2514" : "\u251C";
+    const prefix2 = translationsDirExists ? "\u2502" : " ";
+    lines.push(`  ${prefix2}   ${connector}\u2500\u2500 ${missingDirs[i9]}/`);
+    lines.push(`  ${prefix2}   ${isLast ? " " : "\u2502"}   \u2514\u2500\u2500 pages/`);
+    lines.push(`  ${prefix2}   ${isLast ? " " : "\u2502"}       \u2514\u2500\u2500 ... (translated .mdx files)`);
+  }
+  return lines.join("\n");
+}
+
 // ../yaml/docs-validator/lib/rules/valid-docs-endpoints/valid-docs-endpoints.js
 var ValidDocsEndpoints = {
   name: "valid-docs-endpoints",
@@ -828162,7 +828248,8 @@ var allRules = [
   ValidFileTypes,
   ValidDocsEndpoints,
   AllRolesMustBeDeclaredRule,
-  ValidFrontmatter
+  ValidFrontmatter,
+  TranslationDirectoriesExistRule
   // ValidMarkdownFileReferences
 ];
 function getAllRules3(exclusions) {
@@ -832192,7 +832279,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 = "4.100.2";
+  const version7 = "4.101.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -841533,6 +841620,13 @@ var definitions6 = {
       }
     ]
   },
+  "docs.WebSocketOneofDisplay": {
+    type: "string",
+    enum: [
+      "flat",
+      "grouped"
+    ]
+  },
   "docs.DocsSettingsConfig": {
     type: "object",
     properties: {
@@ -841665,6 +841759,16 @@ var definitions6 = {
             type: "null"
           }
         ]
+      },
+      "websocket-oneof-display": {
+        oneOf: [
+          {
+            $ref: "#/definitions/docs.WebSocketOneofDisplay"
+          },
+          {
+            type: "null"
+          }
+        ]
       }
     },
     additionalProperties: false
@@ -843768,7 +843872,8 @@ ${JSON.stringify(errorDetails, void 0, 2)}`);
     const publishTime = performance.now() - publishStart;
     context3.logger.debug(`Docs published to FDR in ${publishTime.toFixed(0)}ms`);
     const translationPages = resolver2.getTranslationPages();
-    if (!preview && translationPages != null && Object.keys(translationPages).length > 0) {
+    const translationDomain = preview ? urlToOutput : domain3;
+    if (translationPages != null && Object.keys(translationPages).length > 0) {
       context3.logger.info(`Registering translations for ${Object.keys(translationPages).length} locale(s)...`);
       await Promise.all(Object.entries(translationPages).map(async ([locale, localePages]) => {
         try {
@@ -843832,7 +843937,7 @@ ${JSON.stringify(errorDetails, void 0, 2)}`);
               // Include telemetry headers (X-CLI-Version, X-CI-Source, etc.)
             },
             body: JSON.stringify({
-              domain: domain3,
+              domain: translationDomain,
               orgId: organization,
               locale,
               docsDefinition: translatedDefinition
@@ -844530,7 +844635,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "4.100.2",
+        cliVersion: "4.101.0",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -918621,7 +918726,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "4.100.2";
+    return "4.101.0";
   }
   getCliName() {
     if (false) {

package/package.json

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