@fern-api/fern-api-dev 4.103.1 → 4.104.0

package/cli.cjs

@@ -510181,6 +510181,7 @@ __export(DocsYmlSchemas_exports, {
   ThemeConfig: () => ThemeConfig,
   TitleSource: () => TitleSource,
   TranslationConfig: () => TranslationConfig,
+  TranslationConfigObject: () => TranslationConfigObject,
   TwitterCardSetting: () => TwitterCardSetting,
   UntabbedNavigationConfig: () => UntabbedNavigationConfig,
   VersionAvailability: () => VersionAvailability,
@@ -510189,7 +510190,8 @@ __export(DocsYmlSchemas_exports, {
   VersionedSnippetLanguageConfiguration: () => VersionedSnippetLanguageConfiguration,
   WithFeatureFlags: () => WithFeatureFlags,
   WithPermissions: () => WithPermissions,
-  WithViewers: () => WithViewers
+  WithViewers: () => WithViewers,
+  normalizeTranslationConfig: () => normalizeTranslationConfig
 });
 var TabId = external_exports.string();
 var ChangelogFolderRelativePath = external_exports.string();
@@ -510853,10 +510855,17 @@ var ProductFileConfig = external_exports.object({
   "landing-page": PageConfiguration.optional(),
   navigation: NavigationConfig
 });
-var TranslationConfig = external_exports.object({
+var TranslationConfigObject = external_exports.object({
   lang: Language,
   default: external_exports.boolean().optional()
 });
+var TranslationConfig = external_exports.union([Language, TranslationConfigObject]);
+function normalizeTranslationConfig(config5) {
+  if (typeof config5 === "string") {
+    return { lang: config5 };
+  }
+  return config5;
+}
 var DocsConfiguration = external_exports.object({
   instances: external_exports.array(DocsInstance),
   title: external_exports.string().optional(),
@@ -510879,7 +510888,8 @@ var DocsConfiguration = external_exports.object({
     if (translations == null) {
       return;
     }
-    const defaultCount = translations.filter((t3) => t3.default === true).length;
+    const normalizedTranslations = translations.map(normalizeTranslationConfig);
+    const defaultCount = normalizedTranslations.filter((t3) => t3.default === true).length;
     if (defaultCount > 1) {
       ctx.addIssue({
         code: external_exports.ZodIssueCode.custom,
@@ -511311,7 +511321,8 @@ var FernDocsConfigError = class extends Error {
   statusCode;
   body;
   rawResponse;
-  constructor({ message, statusCode, body, rawResponse }) {
+  cause;
+  constructor({ message, statusCode, body, rawResponse, cause }) {
     super(buildMessage2({ message, statusCode, body }));
     Object.setPrototypeOf(this, new.target.prototype);
     if (Error.captureStackTrace) {
@@ -511321,6 +511332,9 @@ var FernDocsConfigError = class extends Error {
     this.statusCode = statusCode;
     this.body = body;
     this.rawResponse = rawResponse;
+    if (cause != null) {
+      this.cause = cause;
+    }
   }
 };
 function buildMessage2({ message, statusCode, body }) {
@@ -511339,13 +511353,17 @@ function buildMessage2({ message, statusCode, body }) {
 
 // ../configuration/lib/docs-yml/schemas/sdk/errors/FernDocsConfigTimeoutError.js
 var FernDocsConfigTimeoutError = class extends Error {
-  constructor(message) {
+  cause;
+  constructor(message, opts) {
     super(message);
     Object.setPrototypeOf(this, new.target.prototype);
     if (Error.captureStackTrace) {
       Error.captureStackTrace(this, this.constructor);
     }
     this.name = this.constructor.name;
+    if (opts?.cause != null) {
+      this.cause = opts.cause;
+    }
   }
 };
 
@@ -511619,6 +511637,7 @@ __export(serialization_exports3, {
   ThemeConfig: () => ThemeConfig2,
   TitleSource: () => TitleSource3,
   TranslationConfig: () => TranslationConfig2,
+  TranslationConfigObject: () => TranslationConfigObject2,
   TwitterCardSetting: () => TwitterCardSetting3,
   UntabbedNavigationConfig: () => UntabbedNavigationConfig2,
   VersionAvailability: () => VersionAvailability3,
@@ -511772,6 +511791,7 @@ __export(docs_exports2, {
   ThemeConfig: () => ThemeConfig2,
   TitleSource: () => TitleSource3,
   TranslationConfig: () => TranslationConfig2,
+  TranslationConfigObject: () => TranslationConfigObject2,
   TwitterCardSetting: () => TwitterCardSetting3,
   UntabbedNavigationConfig: () => UntabbedNavigationConfig2,
   VersionAvailability: () => VersionAvailability3,
@@ -511808,6 +511828,7 @@ __export(schemas_exports6, {
   object: () => object4,
   objectWithoutOptionalProperties: () => objectWithoutOptionalProperties3,
   optional: () => optional4,
+  partialRecord: () => partialRecord2,
   property: () => property4,
   record: () => record4,
   set: () => set6,
@@ -511906,22 +511927,24 @@ function stringifyValidationError3(error50) {
 }
 
 // ../configuration/lib/docs-yml/schemas/sdk/core/schemas/builders/schema-utils/JsonError.js
-var JsonError3 = class _JsonError extends Error {
+var JsonError3 = class extends Error {
   errors;
   constructor(errors4) {
     super(errors4.map(stringifyValidationError3).join("; "));
     this.errors = errors4;
-    Object.setPrototypeOf(this, _JsonError.prototype);
+    Object.setPrototypeOf(this, new.target.prototype);
+    this.name = this.constructor.name;
   }
 };
 
 // ../configuration/lib/docs-yml/schemas/sdk/core/schemas/builders/schema-utils/ParseError.js
-var ParseError3 = class _ParseError extends Error {
+var ParseError3 = class extends Error {
   errors;
   constructor(errors4) {
     super(errors4.map(stringifyValidationError3).join("; "));
     this.errors = errors4;
-    Object.setPrototypeOf(this, _ParseError.prototype);
+    Object.setPrototypeOf(this, new.target.prototype);
+    this.name = this.constructor.name;
   }
 };
 
@@ -512947,6 +512970,45 @@ function record4(keySchema, valueSchema) {
     ...getSchemaUtils3(baseSchema)
   };
 }
+function partialRecord2(keySchema, valueSchema) {
+  const baseSchema = {
+    parse: (raw, opts) => {
+      return validateAndTransformRecord3({
+        value: raw,
+        isKeyNumeric: keySchema.getType() === SchemaType3.NUMBER,
+        transformKey: (key2) => keySchema.parse(key2, {
+          ...opts,
+          breadcrumbsPrefix: [...opts?.breadcrumbsPrefix ?? [], `${key2} (key)`]
+        }),
+        transformValue: (value2, key2) => valueSchema.parse(value2, {
+          ...opts,
+          breadcrumbsPrefix: [...opts?.breadcrumbsPrefix ?? [], `${key2}`]
+        }),
+        breadcrumbsPrefix: opts?.breadcrumbsPrefix
+      });
+    },
+    json: (parsed, opts) => {
+      return validateAndTransformRecord3({
+        value: parsed,
+        isKeyNumeric: keySchema.getType() === SchemaType3.NUMBER,
+        transformKey: (key2) => keySchema.json(key2, {
+          ...opts,
+          breadcrumbsPrefix: [...opts?.breadcrumbsPrefix ?? [], `${key2} (key)`]
+        }),
+        transformValue: (value2, key2) => valueSchema.json(value2, {
+          ...opts,
+          breadcrumbsPrefix: [...opts?.breadcrumbsPrefix ?? [], `${key2}`]
+        }),
+        breadcrumbsPrefix: opts?.breadcrumbsPrefix
+      });
+    },
+    getType: () => SchemaType3.RECORD
+  };
+  return {
+    ...maybeSkipValidation3(baseSchema),
+    ...getSchemaUtils3(baseSchema)
+  };
+}
 function validateAndTransformRecord3({ value: value2, isKeyNumeric, transformKey, transformValue, breadcrumbsPrefix = [] }) {
   if (!isPlainObject10(value2)) {
     return {
@@ -514121,12 +514183,15 @@ var ThemeConfig2 = schemas_exports6.object({
   productSwitcher: schemas_exports6.property("product-switcher", ProductSwitcherThemeConfig3.optional())
 });
 
-// ../configuration/lib/docs-yml/schemas/sdk/serialization/resources/docs/types/TranslationConfig.js
-var TranslationConfig2 = schemas_exports6.object({
+// ../configuration/lib/docs-yml/schemas/sdk/serialization/resources/docs/types/TranslationConfigObject.js
+var TranslationConfigObject2 = schemas_exports6.object({
   lang: Language3,
   default: schemas_exports6.boolean().optional()
 });
 
+// ../configuration/lib/docs-yml/schemas/sdk/serialization/resources/docs/types/TranslationConfig.js
+var TranslationConfig2 = schemas_exports6.undiscriminatedUnion([Language3, TranslationConfigObject2]);
+
 // ../configuration/lib/docs-yml/schemas/sdk/serialization/resources/docs/types/DocsConfiguration.js
 var DocsConfiguration2 = schemas_exports6.object({
   instances: schemas_exports6.list(DocsInstance2),
@@ -541924,7 +541989,7 @@ async function parseDocsConfiguration({ rawDocsConfiguration, absolutePathToFern
     rawPath: agents?.llmsFullTxt,
     absoluteFilepathToDocsConfig
   });
-  const defaultLocale = rawDocsConfiguration.translations?.find((t3) => t3.default === true)?.lang ?? rawDocsConfiguration.translations?.[0]?.lang;
+  const defaultLocale = rawDocsConfiguration.translations?.map((t3) => docs_yml_exports.DocsYmlSchemas.normalizeTranslationConfig(t3)).find((t3) => t3.default === true)?.lang ?? (rawDocsConfiguration.translations?.[0] != null ? docs_yml_exports.DocsYmlSchemas.normalizeTranslationConfig(rawDocsConfiguration.translations[0]).lang : void 0);
   const translationPagesPromise = pagesPromise.then((resolvedPages) => loadTranslationPages({
     translations: rawDocsConfiguration.translations,
     defaultLocale,
@@ -542018,12 +542083,7 @@ async function parseDocsConfiguration({ rawDocsConfiguration, absolutePathToFern
       heap: void 0
     },
     /* integrations */
-    integrations: {
-      ...integrations,
-      // context7 is handled separately via context7File (resolved to AbsoluteFilePath)
-      context7: void 0,
-      intercom: integrations?.intercom ? integrations.intercom : void 0
-    },
+    integrations: integrations != null ? { intercom: integrations.intercom ?? void 0 } : void 0,
     /* scripts */
     css,
     js: js7,
@@ -543197,7 +543257,8 @@ async function loadTranslationPages({ translations, defaultLocale, pages, absolu
   }
   const translationsRootDir = import_path22.default.join(absolutePathToFernFolder, "translations");
   const result = {};
-  await Promise.all(translations.map(async ({ lang }) => {
+  const normalizedTranslations = translations.map((t3) => docs_yml_exports.DocsYmlSchemas.normalizeTranslationConfig(t3));
+  await Promise.all(normalizedTranslations.map(async ({ lang }) => {
     if (lang === defaultLocale) {
       return;
     }
@@ -620917,7 +620978,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "4.103.1",
+          version: "4.104.0",
           usingAccessToken: true
         }
       });
@@ -620971,7 +621032,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "4.103.1",
+        version: "4.104.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -798491,13 +798552,14 @@ var DocsDefinitionResolver = class {
     if (translations == null || translations.length === 0) {
       return void 0;
     }
-    const defaultTranslation = translations.find((translation) => translation.default === true) ?? translations[0];
+    const normalizedTranslations = translations.map((t3) => docs_yml_exports.DocsYmlSchemas.normalizeTranslationConfig(t3));
+    const defaultTranslation = normalizedTranslations.find((translation) => translation.default === true) ?? normalizedTranslations[0];
     if (defaultTranslation == null) {
       return void 0;
     }
     return {
       defaultLocale: defaultTranslation.lang,
-      translations: translations.map((translation) => translation.lang)
+      translations: normalizedTranslations.map((translation) => translation.lang)
     };
   }
   collectedFileIds = /* @__PURE__ */ new Map();
@@ -806085,11 +806147,12 @@ var TranslationDirectoriesExistRule = {
         if (translations == null || translations.length === 0) {
           return violations;
         }
-        const defaultLocale = (translations.find((t3) => t3.default === true) ?? translations[0])?.lang;
+        const normalizedTranslations = translations.map((t3) => docs_yml_exports.DocsYmlSchemas.normalizeTranslationConfig(t3));
+        const defaultLocale = (normalizedTranslations.find((t3) => t3.default === true) ?? normalizedTranslations[0])?.lang;
         const translationsDir = join8(workspace.absoluteFilePath, RelativeFilePath2.of("translations"));
         const translationsDirExists = await doesPathExist(translationsDir);
         const missingDirs = [];
-        for (const translation of translations) {
+        for (const translation of normalizedTranslations) {
           if (translation.lang === defaultLocale) {
             continue;
           }
@@ -832265,7 +832328,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.103.1";
+  const version7 = "4.104.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -840270,7 +840333,7 @@ var definitions6 = {
       "tr"
     ]
   },
-  "docs.TranslationConfig": {
+  "docs.TranslationConfigObject": {
     type: "object",
     properties: {
       lang: {
@@ -840292,6 +840355,16 @@ var definitions6 = {
     ],
     additionalProperties: false
   },
+  "docs.TranslationConfig": {
+    anyOf: [
+      {
+        $ref: "#/definitions/docs.Language"
+      },
+      {
+        $ref: "#/definitions/docs.TranslationConfigObject"
+      }
+    ]
+  },
   "docs.AIChatModel": {
     type: "string",
     enum: [
@@ -843913,7 +843986,8 @@ ${JSON.stringify(errorDetails, void 0, 2)}`);
               root: updatedRoot
             }
           };
-          context3.logger.info(`Sending translation for locale "${locale}": pages=${JSON.stringify(Object.keys(localePages))}`);
+          const pageCount2 = Object.keys(localePages).length;
+          context3.logger.debug(`Sending translation for locale "${locale}" (${pageCount2} page${pageCount2 === 1 ? "" : "s"})`);
           const translationResponse = await fetch(`${fdrOrigin}/v2/registry/docs/translations/register`, {
             method: "POST",
             headers: {
@@ -844621,7 +844695,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "4.103.1",
+        cliVersion: "4.104.0",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -918712,7 +918786,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "4.103.1";
+    return "4.104.0";
   }
   getCliName() {
     if (false) {

package/package.json

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