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

package/cli.cjs

@@ -346934,7 +346934,14 @@ var require_pushSignedCommit = __commonJS({
       return typeof err === "object" && err != null && "status" in err && typeof err.status === "number";
     }
     function isNotFoundError(err) {
-      return hasNumericStatus(err) && err.status === 404;
+      if (hasNumericStatus(err) && err.status === 404) {
+        return true;
+      }
+      if (hasNumericStatus(err) && err.status === 422) {
+        const message = (0, core_utils_1.extractErrorMessage)(err).toLowerCase();
+        return message.includes("reference does not exist");
+      }
+      return false;
     }
     function isNonFastForwardError(err) {
       if (!hasNumericStatus(err) || err.status !== 422) {
@@ -510181,6 +510188,7 @@ __export(DocsYmlSchemas_exports, {
   ThemeConfig: () => ThemeConfig,
   TitleSource: () => TitleSource,
   TranslationConfig: () => TranslationConfig,
+  TranslationConfigObject: () => TranslationConfigObject,
   TwitterCardSetting: () => TwitterCardSetting,
   UntabbedNavigationConfig: () => UntabbedNavigationConfig,
   VersionAvailability: () => VersionAvailability,
@@ -510189,7 +510197,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 +510862,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 +510895,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 +511328,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 +511339,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 +511360,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 +511644,7 @@ __export(serialization_exports3, {
   ThemeConfig: () => ThemeConfig2,
   TitleSource: () => TitleSource3,
   TranslationConfig: () => TranslationConfig2,
+  TranslationConfigObject: () => TranslationConfigObject2,
   TwitterCardSetting: () => TwitterCardSetting3,
   UntabbedNavigationConfig: () => UntabbedNavigationConfig2,
   VersionAvailability: () => VersionAvailability3,
@@ -511772,6 +511798,7 @@ __export(docs_exports2, {
   ThemeConfig: () => ThemeConfig2,
   TitleSource: () => TitleSource3,
   TranslationConfig: () => TranslationConfig2,
+  TranslationConfigObject: () => TranslationConfigObject2,
   TwitterCardSetting: () => TwitterCardSetting3,
   UntabbedNavigationConfig: () => UntabbedNavigationConfig2,
   VersionAvailability: () => VersionAvailability3,
@@ -511808,6 +511835,7 @@ __export(schemas_exports6, {
   object: () => object4,
   objectWithoutOptionalProperties: () => objectWithoutOptionalProperties3,
   optional: () => optional4,
+  partialRecord: () => partialRecord2,
   property: () => property4,
   record: () => record4,
   set: () => set6,
@@ -511906,22 +511934,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 +512977,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 +514190,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 +541996,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 +542090,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 +543264,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 +620985,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "4.103.1",
+          version: "4.105.0",
           usingAccessToken: true
         }
       });
@@ -620971,7 +621039,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "4.103.1",
+        version: "4.105.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -798491,13 +798559,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 +806154,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 +832335,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.105.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -832624,7 +832694,7 @@ var STANDALONE_FOLDER_NAME = "standalone";
 var LOCAL_STORAGE_FOLDER5 = ".fern-dev";
 var INSTRUMENTATION_PATH = "packages/fern-docs/bundle/.next/server/instrumentation.js";
 var COREPACK_MISSING_KEYID_ERROR_MESSAGE = 'Cannot find matching keyid: {"signatures":';
-function warnIfLongPathsDisabled(logger4) {
+function assertLongPathsEnabled(logger4) {
   try {
     const output2 = (0, import_child_process6.execSync)('reg query "HKLM\\SYSTEM\\CurrentControlSet\\Control\\FileSystem" /v LongPathsEnabled', { encoding: "utf-8", timeout: 5e3 });
     const match3 = output2.match(/LongPathsEnabled\s+REG_DWORD\s+0x(\d+)/i);
@@ -832634,7 +832704,11 @@ function warnIfLongPathsDisabled(logger4) {
   } catch (error50) {
     logger4.debug(`Registry query for LongPathsEnabled failed: ${error50}`);
   }
-  logger4.warn(source_default.yellow.bold("\n\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557\n\u2551  WARNING: Windows long path support is NOT enabled.                     \u2551\n\u2551                                                                         \u2551\n\u2551  The docs bundle contains deeply nested .pnpm paths that may exceed     \u2551\n\u2551  the 260-character MAX_PATH limit. Extraction may silently truncate     \u2551\n\u2551  paths and produce a broken bundle.                                     \u2551\n\u2551                                                                         \u2551\n\u2551  To fix, run this in an elevated PowerShell:                             \u2551\n\u2551                                                                         \u2551\n\u2551    New-ItemProperty -Path                                                \u2551\n\u2551      'HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem'           \u2551\n\u2551      -Name 'LongPathsEnabled' -Value 1 -PropertyType DWORD -Force       \u2551\n\u2551                                                                         \u2551\n\u2551  Then restart your terminal.                                             \u2551\n\u2551                                                                         \u2551\n\u2551  For more details, see:                                                  \u2551\n\u2551  https://learn.microsoft.com/en-us/windows/win32/fileio/                 \u2551\n\u2551  maximum-file-path-limitation                                            \u2551\n\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D\n"));
+  throw new CliError({
+    message: "Windows long path support is not enabled. The docs bundle contains deeply nested .pnpm paths that exceed the 260-character MAX_PATH limit.\n\nTo fix, run this in an elevated PowerShell:\n\n  New-ItemProperty -Path 'HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem' -Name 'LongPathsEnabled' -Value 1 -PropertyType DWORD -Force\n\nThen restart your terminal.",
+    code: CliError.Code.EnvironmentError,
+    docsLink: "https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation"
+  });
 }
 function isWithinOutputDir(resolvedPath, outputDir) {
   const rel2 = import_path57.default.relative(outputDir, resolvedPath);
@@ -832863,7 +832937,7 @@ async function downloadBundle({ bucketUrl, logger: logger4, preferCached, app =
       }, 50);
     }
     if (PLATFORM_IS_WINDOWS) {
-      warnIfLongPathsDisabled(logger4);
+      assertLongPathsEnabled(logger4);
     }
     const collectedSymlinks = [];
     try {
@@ -840270,7 +840344,7 @@ var definitions6 = {
       "tr"
     ]
   },
-  "docs.TranslationConfig": {
+  "docs.TranslationConfigObject": {
     type: "object",
     properties: {
       lang: {
@@ -840292,6 +840366,16 @@ var definitions6 = {
     ],
     additionalProperties: false
   },
+  "docs.TranslationConfig": {
+    anyOf: [
+      {
+        $ref: "#/definitions/docs.Language"
+      },
+      {
+        $ref: "#/definitions/docs.TranslationConfigObject"
+      }
+    ]
+  },
   "docs.AIChatModel": {
     type: "string",
     enum: [
@@ -843913,7 +843997,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 +844706,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "4.103.1",
+        cliVersion: "4.105.0",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -892754,14 +892839,24 @@ var EndpointSnippetGenerator9 = class {
     const filePropertyInfo = this.getFilePropertyInfo({ request: request7, snippet: snippet2 });
     this.context.errors.unscope();
     if (request7.body != null) {
-      args.push(swift_exports.functionArgument({
-        label: "request",
-        value: this.getInlinedRequestArg({
-          request: request7,
-          snippet: snippet2,
-          filePropertyInfo
-        })
-      }));
+      if (request7.body.type === "referenced") {
+        args.push(swift_exports.functionArgument({
+          label: "request",
+          value: this.getReferencedRequestBodyPropertyTypeLiteral({
+            body: request7.body.bodyType,
+            value: snippet2.requestBody
+          })
+        }));
+      } else {
+        args.push(swift_exports.functionArgument({
+          label: "request",
+          value: this.getInlinedRequestArg({
+            request: request7,
+            snippet: snippet2,
+            filePropertyInfo
+          })
+        }));
+      }
     }
     return args;
   }
@@ -918712,7 +918807,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "4.103.1";
+    return "4.105.0";
   }
   getCliName() {
     if (false) {

package/package.json

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