@fern-api/fern-api-dev 4.53.1 → 4.54.0

package/cli.cjs

@@ -473739,11 +473739,34 @@ var OAuthAccessTokenResponseProperties = schemas_exports3.objectWithoutOptionalP
   refreshToken: ResponseProperty.optional()
 });
 
+// ../../ir-sdk/lib/sdk/serialization/resources/types/types/Literal.js
+var Literal2 = schemas_exports3.union("type", {
+  string: schemas_exports3.object({
+    string: schemas_exports3.string()
+  }),
+  boolean: schemas_exports3.object({
+    boolean: schemas_exports3.boolean()
+  })
+}).transform({
+  transform: (value) => {
+    switch (value.type) {
+      case "string":
+        return Literal.string(value.string);
+      case "boolean":
+        return Literal.boolean(value.boolean);
+      default:
+        return value;
+    }
+  },
+  untransform: ({ _visit, ...value }) => value
+});
+
 // ../../ir-sdk/lib/sdk/serialization/resources/http/types/QueryParameter.js
 var QueryParameter = schemas_exports3.objectWithoutOptionalProperties({
   name: NameAndWireValue,
   valueType: schemas_exports3.lazy(() => TypeReference3),
   allowMultiple: schemas_exports3.boolean(),
+  clientDefault: Literal2.optional(),
   v2Examples: V2SchemaExamples.optional(),
   explode: schemas_exports3.boolean().optional()
 }).extend(Declaration);
@@ -475069,6 +475092,7 @@ var HttpHeader = schemas_exports3.objectWithoutOptionalProperties({
   name: NameAndWireValue,
   valueType: schemas_exports3.lazy(() => TypeReference3),
   env: schemas_exports3.string().optional(),
+  clientDefault: Literal2.optional(),
   v2Examples: V2SchemaExamples.optional()
 }).extend(Declaration);
 
@@ -476491,6 +476515,7 @@ var PathParameter = schemas_exports3.objectWithoutOptionalProperties({
   valueType: schemas_exports3.lazy(() => TypeReference3),
   location: PathParameterLocation2,
   variable: VariableId.optional(),
+  clientDefault: Literal2.optional(),
   v2Examples: V2SchemaExamples.optional(),
   explode: schemas_exports3.boolean().optional()
 }).extend(WithDocs);
@@ -477902,28 +477927,6 @@ __export(types_exports6, {
   UuidType: () => UuidType
 });
 
-// ../../ir-sdk/lib/sdk/serialization/resources/types/types/Literal.js
-var Literal2 = schemas_exports3.union("type", {
-  string: schemas_exports3.object({
-    string: schemas_exports3.string()
-  }),
-  boolean: schemas_exports3.object({
-    boolean: schemas_exports3.boolean()
-  })
-}).transform({
-  transform: (value) => {
-    switch (value.type) {
-      case "string":
-        return Literal.string(value.string);
-      case "boolean":
-        return Literal.boolean(value.boolean);
-      default:
-        return value;
-    }
-  },
-  untransform: ({ _visit, ...value }) => value
-});
-
 // ../../ir-sdk/lib/sdk/serialization/resources/types/types/ContainerType.js
 var ContainerType2 = schemas_exports3.union(schemas_exports3.discriminant("type", "_type"), {
   list: schemas_exports3.object({
@@ -506954,7 +506957,8 @@ var Header = schemas_exports9.objectWithoutOptionalProperties({
   name: schemas_exports9.string(),
   schema: schemas_exports9.lazy(() => Schema2),
   env: schemas_exports9.string().optional(),
-  parameterNameOverride: schemas_exports9.string().optional()
+  parameterNameOverride: schemas_exports9.string().optional(),
+  clientDefault: schemas_exports9.unknown().optional()
 }).extend(WithDescription).extend(WithAvailability3).extend(WithSource);
 
 // ../api-importers/openapi/openapi-ir/lib/sdk/serialization/resources/finalIr/types/HttpEndpointServer.js
@@ -507032,7 +507036,8 @@ var PathParameter2 = schemas_exports9.objectWithoutOptionalProperties({
   name: schemas_exports9.string(),
   schema: schemas_exports9.lazy(() => Schema2),
   variableReference: schemas_exports9.string().optional(),
-  parameterNameOverride: schemas_exports9.string().optional()
+  parameterNameOverride: schemas_exports9.string().optional(),
+  clientDefault: schemas_exports9.unknown().optional()
 }).extend(WithDescription).extend(WithAvailability3).extend(WithSource);
 
 // ../api-importers/openapi/openapi-ir/lib/sdk/serialization/resources/finalIr/types/QueryParameter.js
@@ -507040,7 +507045,8 @@ var QueryParameter2 = schemas_exports9.objectWithoutOptionalProperties({
   name: schemas_exports9.string(),
   schema: schemas_exports9.lazy(() => Schema2),
   parameterNameOverride: schemas_exports9.string().optional(),
-  explode: schemas_exports9.boolean().optional()
+  explode: schemas_exports9.boolean().optional(),
+  clientDefault: schemas_exports9.unknown().optional()
 }).extend(WithDescription).extend(WithAvailability3).extend(WithSource);
 
 // ../api-importers/openapi/openapi-ir/lib/sdk/serialization/resources/finalIr/types/FormUrlEncodedRequest.js
@@ -507742,7 +507748,8 @@ var HeaderWithExample = schemas_exports9.objectWithoutOptionalProperties({
   name: schemas_exports9.string(),
   schema: schemas_exports9.lazy(() => SchemaWithExample2),
   env: schemas_exports9.string().optional(),
-  parameterNameOverride: schemas_exports9.string().optional()
+  parameterNameOverride: schemas_exports9.string().optional(),
+  clientDefault: schemas_exports9.unknown().optional()
 }).extend(WithDescription).extend(WithAvailability3).extend(WithSource);
 
 // ../api-importers/openapi/openapi-ir/lib/sdk/serialization/resources/parseIr/types/NamedFullExample.js
@@ -507764,7 +507771,8 @@ var PathParameterWithExample = schemas_exports9.objectWithoutOptionalProperties(
   schema: schemas_exports9.lazy(() => SchemaWithExample2),
   variableReference: schemas_exports9.string().optional(),
   parameterNameOverride: schemas_exports9.string().optional(),
-  explode: schemas_exports9.boolean().optional()
+  explode: schemas_exports9.boolean().optional(),
+  clientDefault: schemas_exports9.unknown().optional()
 }).extend(WithDescription).extend(WithAvailability3).extend(WithSource);
 
 // ../api-importers/openapi/openapi-ir/lib/sdk/serialization/resources/parseIr/types/QueryParameterWithExample.js
@@ -507772,7 +507780,8 @@ var QueryParameterWithExample = schemas_exports9.objectWithoutOptionalProperties
   name: schemas_exports9.string(),
   schema: schemas_exports9.lazy(() => SchemaWithExample2),
   parameterNameOverride: schemas_exports9.string().optional(),
-  explode: schemas_exports9.boolean().optional()
+  explode: schemas_exports9.boolean().optional(),
+  clientDefault: schemas_exports9.unknown().optional()
 }).extend(WithDescription).extend(WithAvailability3).extend(WithSource);
 
 // ../api-importers/openapi/openapi-ir/lib/sdk/serialization/resources/parseIr/types/JsonRequestWithExample.js
@@ -509969,7 +509978,7 @@ function buildHeader({ header, context: context3, fileContainingReference, names
   const headerType = getTypeFromTypeReference(typeReference2);
   const headerWithoutXPrefix = header.name.replace(/^x-|^X-/, "");
   const headerVariableName = header.parameterNameOverride != null ? header.parameterNameOverride : camelCase_default(headerWithoutXPrefix);
-  if (header.description == null && header.name === headerVariableName && header.env == null && header.availability == null) {
+  if (header.description == null && header.name === headerVariableName && header.env == null && header.availability == null && header.clientDefault == null) {
     return headerType;
   }
   const headerSchema = {
@@ -509987,6 +509996,9 @@ function buildHeader({ header, context: context3, fileContainingReference, names
   if (header.availability != null) {
     headerSchema.availability = convertAvailability(header.availability);
   }
+  if (header.clientDefault != null) {
+    headerSchema.default = header.clientDefault;
+  }
   return headerSchema;
 }
 
@@ -509999,7 +510011,7 @@ function buildPathParameter({ pathParameter, context: context3, fileContainingRe
     namespace,
     declarationDepth: 0
   });
-  if (pathParameter.variableReference == null && pathParameter.description == null && pathParameter.availability == null) {
+  if (pathParameter.variableReference == null && pathParameter.description == null && pathParameter.availability == null && pathParameter.clientDefault == null) {
     return getTypeFromTypeReference(typeReference2);
   }
   const pathParameterSchema = pathParameter.variableReference != null ? {
@@ -510013,6 +510025,9 @@ function buildPathParameter({ pathParameter, context: context3, fileContainingRe
   if (pathParameter.availability != null) {
     pathParameterSchema.availability = convertAvailability(pathParameter.availability);
   }
+  if (pathParameter.clientDefault != null && "type" in pathParameterSchema) {
+    pathParameterSchema.default = pathParameter.clientDefault;
+  }
   return pathParameterSchema;
 }
 
@@ -510038,7 +510053,9 @@ function buildQueryParameter({ queryParameter, context: context3, fileContaining
   const queryParameterSchema = {
     type: queryParameterType
   };
-  if (queryParameterDefault != null) {
+  if (queryParameter.clientDefault != null) {
+    queryParameterSchema.default = queryParameter.clientDefault;
+  } else if (queryParameterDefault != null) {
     queryParameterSchema.default = queryParameterDefault;
   }
   if (typeReference2.allowMultiple) {
@@ -511456,7 +511473,8 @@ function buildIdempotencyHeaders(context3) {
         parameterNameOverride: void 0,
         description: void 0,
         availability: void 0,
-        source: void 0
+        source: void 0,
+        clientDefault: void 0
       },
       fileContainingReference: RelativeFilePath.of(ROOT_API_FILENAME),
       context: context3,
@@ -517389,7 +517407,23 @@ var FernOpenAPIExtension = {
    *         - $ref: '#/components/schemas/CompletionEvent'
    *         - $ref: '#/components/schemas/ErrorEvent'
    */
-  DISCRIMINATOR_CONTEXT: "x-fern-discriminator-context"
+  DISCRIMINATOR_CONTEXT: "x-fern-discriminator-context",
+  /**
+   * Used to specify a client-side default value for a parameter (path, header, or query).
+   * When present, the parameter becomes optional in the generated SDK, and the
+   * default value is sent when the user doesn't provide one.
+   *
+   * Supports string and boolean literal values.
+   *
+   * Example usage:
+   *   parameters:
+   *     - name: X-API-Version
+   *       in: header
+   *       schema:
+   *         type: string
+   *       x-fern-default: "2024-02-08"
+   */
+  FERN_DEFAULT: "x-fern-default"
 };
 
 // ../api-importers/openapi/openapi-ir-parser/lib/options.js
@@ -523731,7 +523765,8 @@ function parseAsyncAPIV2({ context: context3, breadcrumbs, source: source2, asyn
           variableReference: void 0,
           availability: convertAvailability2(parameter6),
           source: source2,
-          explode: void 0
+          explode: void 0,
+          clientDefault: void 0
         });
       }
     }
@@ -523752,7 +523787,8 @@ function parseAsyncAPIV2({ context: context3, breadcrumbs, source: source2, asyn
               parameterNameOverride: void 0,
               env: void 0,
               availability: convertAvailability2(resolvedSchema),
-              source: source2
+              source: source2,
+              clientDefault: void 0
             });
             continue;
           }
@@ -523765,7 +523801,8 @@ function parseAsyncAPIV2({ context: context3, breadcrumbs, source: source2, asyn
             parameterNameOverride: void 0,
             env: void 0,
             availability: convertAvailability2(schema2),
-            source: source2
+            source: source2,
+            clientDefault: void 0
           });
         }
       }
@@ -523783,7 +523820,8 @@ function parseAsyncAPIV2({ context: context3, breadcrumbs, source: source2, asyn
               parameterNameOverride: void 0,
               availability: convertAvailability2(resolvedSchema),
               source: source2,
-              explode: void 0
+              explode: void 0,
+              clientDefault: void 0
             });
             continue;
           }
@@ -523796,7 +523834,8 @@ function parseAsyncAPIV2({ context: context3, breadcrumbs, source: source2, asyn
             parameterNameOverride: void 0,
             availability: convertAvailability2(schema2),
             source: source2,
-            explode: void 0
+            explode: void 0,
+            clientDefault: void 0
           });
         }
       }
@@ -524277,7 +524316,8 @@ function parseAsyncAPIV3({ context: context3, breadcrumbs, source: source2, asyn
           variableReference: void 0,
           availability: convertAvailability2(parameter6),
           source: source2,
-          explode: void 0
+          explode: void 0,
+          clientDefault: void 0
         };
         if (type8 === "header") {
           headers2.push({
@@ -524309,7 +524349,8 @@ function parseAsyncAPIV3({ context: context3, breadcrumbs, source: source2, asyn
             parameterNameOverride: void 0,
             availability: convertAvailability2(resolvedSchema),
             source: source2,
-            explode: void 0
+            explode: void 0,
+            clientDefault: void 0
           });
           continue;
         }
@@ -524322,7 +524363,8 @@ function parseAsyncAPIV3({ context: context3, breadcrumbs, source: source2, asyn
           parameterNameOverride: void 0,
           availability: convertAvailability2(schema2),
           source: source2,
-          explode: void 0
+          explode: void 0,
+          clientDefault: void 0
         });
       }
     }
@@ -524344,7 +524386,8 @@ function parseAsyncAPIV3({ context: context3, breadcrumbs, source: source2, asyn
             parameterNameOverride: void 0,
             env: void 0,
             availability: convertAvailability2(resolvedSchema),
-            source: source2
+            source: source2,
+            clientDefault: void 0
           });
           continue;
         }
@@ -524357,7 +524400,8 @@ function parseAsyncAPIV3({ context: context3, breadcrumbs, source: source2, asyn
           parameterNameOverride: void 0,
           env: void 0,
           availability: convertAvailability2(schema2),
-          source: source2
+          source: source2,
+          clientDefault: void 0
         });
       }
     }
@@ -529548,13 +529592,15 @@ function convertParameters({ path: path97, httpMethod, parameters: parameters2,
         });
       }
     }
+    const clientDefault = getExtension(parameter6, FernOpenAPIExtension.FERN_DEFAULT) ?? getExtension(resolvedParameter, FernOpenAPIExtension.FERN_DEFAULT);
     const convertedParameter = {
       name: resolvedParameter.name,
       schema: schema2,
       description: resolvedParameter.description,
       parameterNameOverride: getParameterName(resolvedParameter),
       availability,
-      source: source2
+      source: source2,
+      clientDefault
     };
     if (resolvedParameter.in === "query") {
       convertedParameters.queryParameters.push({
@@ -530292,7 +530338,8 @@ function convertHttpOperation({ operationContext, context: context3, responseSta
                 title: void 0
               }),
               description: void 0,
-              explode: void 0
+              explode: void 0,
+              clientDefault: void 0
             });
           }
         }
@@ -530334,7 +530381,8 @@ function convertHttpOperation({ operationContext, context: context3, responseSta
                   title: void 0
                 }),
                 description: void 0,
-                explode: void 0
+                explode: void 0,
+                clientDefault: void 0
               });
             }
           }
@@ -530587,7 +530635,8 @@ function convertAsyncSyncOperation({ operationContext, context: context3, asyncE
       parameterNameOverride: void 0,
       env: void 0,
       availability: void 0,
-      source: source2
+      source: source2,
+      clientDefault: void 0
     });
   });
   return {
@@ -531901,7 +531950,8 @@ function generateIr({ openApi, taskContext, options: options2, source: source2,
           parameterNameOverride: queryParameter.parameterNameOverride,
           explode: queryParameter.explode,
           availability: queryParameter.availability,
-          source: queryParameter.source
+          source: queryParameter.source,
+          clientDefault: queryParameter.clientDefault
         };
       }),
       pathParameters: endpointWithExample.pathParameters.map((pathParameter) => {
@@ -531912,7 +531962,8 @@ function generateIr({ openApi, taskContext, options: options2, source: source2,
           parameterNameOverride: pathParameter.parameterNameOverride,
           variableReference: pathParameter.variableReference,
           availability: pathParameter.availability,
-          source: pathParameter.source
+          source: pathParameter.source,
+          clientDefault: pathParameter.clientDefault
         };
       }),
       headers: endpointWithExample.headers.map((header) => {
@@ -531923,7 +531974,8 @@ function generateIr({ openApi, taskContext, options: options2, source: source2,
           parameterNameOverride: header.parameterNameOverride,
           env: header.env,
           availability: header.availability,
-          source: header.source
+          source: header.source,
+          clientDefault: header.clientDefault
         };
       }),
       examples,
@@ -542315,6 +542367,20 @@ function removeSdkAlias(sdk) {
   }
 }
 
+// ../generation/ir-generator/lib/converters/services/convertDefaultToLiteral.js
+function convertDefaultToLiteral(defaultValue) {
+  if (defaultValue == null) {
+    return void 0;
+  }
+  if (typeof defaultValue === "string") {
+    return Literal.string(defaultValue);
+  }
+  if (typeof defaultValue === "boolean") {
+    return Literal.boolean(defaultValue);
+  }
+  return void 0;
+}
+
 // ../generation/ir-generator/lib/converters/services/convertExampleEndpointCall.js
 init_lib4();
 var import_url_join6 = __toESM(require_url_join(), 1);
@@ -544972,6 +545038,7 @@ function convertSingleUnionType({ rawValueType, rawSingleUnionType, fileContaini
 function convertQueryParameter({ file: file4, queryParameterKey, queryParameter }) {
   const { name: name2 } = getQueryParameterName({ queryParameterKey, queryParameter });
   const valueType = file4.parseTypeReference(queryParameter);
+  const defaultValue = typeof queryParameter !== "string" ? queryParameter.default : void 0;
   return {
     ...convertDeclaration(queryParameter),
     name: file4.casingsGenerator.generateNameAndWireValue({
@@ -544980,6 +545047,7 @@ function convertQueryParameter({ file: file4, queryParameterKey, queryParameter
     }),
     valueType,
     allowMultiple: typeof queryParameter !== "string" && queryParameter["allow-multiple"] != null ? queryParameter["allow-multiple"] : false,
+    clientDefault: convertDefaultToLiteral(defaultValue),
     v2Examples: {
       userSpecifiedExamples: {},
       autogeneratedExamples: {}
@@ -546002,12 +546070,14 @@ function convertPathParameters2({ pathParameters, location: location2, file: fil
   }));
 }
 function convertPathParameter({ parameterName, parameter: parameter6, location: location2, file: file4, variableResolver }) {
+  const defaultValue = typeof parameter6 !== "string" && "type" in parameter6 ? parameter6.default : void 0;
   return {
     ...convertDeclaration(parameter6),
     name: file4.casingsGenerator.generateName(parameterName),
     valueType: getPathParameterType({ parameter: parameter6, variableResolver, file: file4 }),
     location: location2,
     variable: isVariablePathParameter(parameter6) ? variableResolver.getVariableIdOrThrow(typeof parameter6 === "string" ? parameter6 : parameter6.variable) : void 0,
+    clientDefault: convertDefaultToLiteral(defaultValue),
     v2Examples: {
       userSpecifiedExamples: {},
       autogeneratedExamples: {}
@@ -546073,6 +546143,7 @@ function convertHttpMethod(method8) {
 }
 function convertHttpHeader({ headerKey, header, file: file4 }) {
   const { name: name2 } = getHeaderName3({ headerKey, header });
+  const defaultValue = typeof header !== "string" ? header.default : void 0;
   return {
     ...convertDeclaration(header),
     name: file4.casingsGenerator.generateNameAndWireValue({
@@ -546081,6 +546152,7 @@ function convertHttpHeader({ headerKey, header, file: file4 }) {
     }),
     valueType: file4.parseTypeReference(header),
     env: typeof header === "string" ? void 0 : header.env,
+    clientDefault: convertDefaultToLiteral(defaultValue),
     v2Examples: {
       userSpecifiedExamples: {},
       autogeneratedExamples: {}
@@ -547543,7 +547615,8 @@ function convertChannel({ channel: channel3, typeResolver, exampleResolver, vari
           userSpecifiedExamples: {},
           autogeneratedExamples: {}
         },
-        explode: void 0
+        explode: void 0,
+        clientDefault: void 0
       };
     }) : [],
     messages: Object.values(messages2),
@@ -585752,7 +585825,8 @@ var AbstractParameterConverter = class extends AbstractConverter {
               schema: parameterSchemaWithExampleOverride ?? schema2
             }),
             availability,
-            explode: this.getExplodeForQueryParameter()
+            explode: this.getExplodeForQueryParameter(),
+            clientDefault: void 0
           },
           inlinedTypes
         };
@@ -585770,7 +585844,8 @@ var AbstractParameterConverter = class extends AbstractConverter {
             v2Examples: this.convertParameterExamples({
               schema: parameterSchemaWithExampleOverride ?? schema2
             }),
-            availability
+            availability,
+            clientDefault: void 0
           },
           inlinedTypes
         };
@@ -585786,7 +585861,8 @@ var AbstractParameterConverter = class extends AbstractConverter {
             v2Examples: this.convertParameterExamples({
               schema: parameterSchemaWithExampleOverride ?? schema2
             }),
-            explode: this.getExplodeForPathParameter()
+            explode: this.getExplodeForPathParameter(),
+            clientDefault: void 0
           },
           inlinedTypes
         };
@@ -588048,7 +588124,8 @@ function convertGlobalHeadersExtension({ globalHeaders, context: context3 }) {
     env: header.env,
     v2Examples: header.optional ? void 0 : constructGlobalHeaderExample({ header, context: context3 }),
     availability: void 0,
-    docs: void 0
+    docs: void 0,
+    clientDefault: void 0
   }));
 }
 function constructGlobalHeaderExample({ header, context: context3 }) {
@@ -588599,7 +588676,8 @@ var AbstractOperationConverter = class extends AbstractConverter {
             [exampleName]: this.generateStringParameterExample({ example: param })
           }
         },
-        explode: void 0
+        explode: void 0,
+        clientDefault: void 0
       });
     }
   }
@@ -589675,7 +589753,8 @@ var ResponseBodyConverter = class extends converters_exports.AbstractConverters.
         valueType,
         env: void 0,
         v2Examples,
-        availability: void 0
+        availability: void 0,
+        clientDefault: void 0
       });
     }
     return headers2;
@@ -589949,7 +590028,8 @@ var ResponseErrorConverter = class extends converters_exports.AbstractConverters
         valueType,
         env: void 0,
         v2Examples,
-        availability: void 0
+        availability: void 0,
+        clientDefault: void 0
       });
     }
     return headers2;
@@ -590452,7 +590532,8 @@ var OperationConverter = class _OperationConverter extends AbstractOperationConv
         availability: void 0,
         docs: void 0,
         env: void 0,
-        v2Examples: void 0
+        v2Examples: void 0,
+        clientDefault: void 0
       };
       switch (authScheme.type) {
         case "bearer":
@@ -602380,7 +602461,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "4.53.1",
+          version: "4.54.0",
           usingAccessToken: true
         }
       });
@@ -602431,7 +602512,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "4.53.1",
+        version: "4.54.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -826304,7 +826385,7 @@ var import_path54 = __toESM(require("path"), 1);
 var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 function getCliSource() {
-  const version7 = "4.53.1";
+  const version7 = "4.54.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -836528,7 +836609,7 @@ async function publishDocs({ token, organization, docsWorkspace, domain: domain3
             }
             return convertToFilePathPairs(startDocsRegisterResponse.body.uploadUrls, docsWorkspace.absoluteFilePath, sanitizedToAbsoluteMap);
           } else {
-            return await startDocsRegisterFailed(startDocsRegisterResponse.error, context3, organization);
+            return await startDocsRegisterFailed(startDocsRegisterResponse.error, context3, organization, domain3);
           }
         } else {
           const startDocsRegisterResponse = await fdr.docs.v2.write.startDocsRegister({
@@ -836564,7 +836645,7 @@ async function publishDocs({ token, organization, docsWorkspace, domain: domain3
             }
             return convertToFilePathPairs(startDocsRegisterResponse.body.uploadUrls, docsWorkspace.absoluteFilePath, sanitizedToAbsoluteMap);
           } else {
-            return startDocsRegisterFailed(startDocsRegisterResponse.error, context3, organization);
+            return startDocsRegisterFailed(startDocsRegisterResponse.error, context3, organization, domain3);
           }
         }
       },
@@ -836768,19 +836849,22 @@ function convertToFilePathPairs(uploadUrls, docsWorkspacePath, sanitizedToAbsolu
   }
   return toRet;
 }
-async function startDocsRegisterFailed(error50, context3, organization) {
+async function startDocsRegisterFailed(error50, context3, organization, domain3) {
   await context3.instrumentPostHogEvent({
     command: "docs-generation",
     properties: {
       error: JSON.stringify(error50)
     }
   });
+  const errorDetails = extractErrorDetails(error50);
+  context3.logger.debug(`startDocsRegister failed for domain '${domain3}', org '${organization}'. Error details:
+${JSON.stringify(errorDetails, void 0, 2)}`);
   const errorObj = error50;
   const errorContent = errorObj?.content;
   if (errorContent?.reason === "status-code" && errorContent?.statusCode === 409) {
     throw new DocsPublishConflictError();
   }
-  const authErrorMessage = getAuthenticationErrorMessage(error50, organization);
+  const authErrorMessage = getAuthenticationErrorMessage(error50, organization, domain3);
   if (authErrorMessage != null) {
     return context3.failAndThrow(authErrorMessage);
   }
@@ -836790,9 +836874,7 @@ async function startDocsRegisterFailed(error50, context3, organization) {
     case "InvalidDomainError":
       return context3.failAndThrow("Please make sure that none of your custom domains are not overlapping (i.e. one is a substring of another)");
     case "UnauthorizedError":
-      return context3.failAndThrow(`You do not have permission to publish docs to organization '${organization}'. Please run 'fern login' to ensure you are logged in with the correct account.
-
-Please ensure you have membership at https://dashboard.buildwithfern.com, and ask a team member for an invite if not.`);
+      return context3.failAndThrow(buildAuthFailureMessage(domain3, organization, errorContent));
     case "UserNotInOrgError":
       return context3.failAndThrow(`You do not belong to organization '${organization}'. Please run 'fern login' to ensure you are logged in with the correct account.
 
@@ -836803,21 +836885,66 @@ Please ensure you have membership at https://dashboard.buildwithfern.com, and as
       return context3.failAndThrow("Failed to publish docs.", error50);
   }
 }
-function getAuthenticationErrorMessage(error50, organization) {
+function getAuthenticationErrorMessage(error50, organization, domain3) {
   const errorObj = error50;
   const content5 = errorObj?.content;
   if (content5?.reason === "status-code") {
     const statusCode = content5.statusCode;
     if (statusCode === 401 || statusCode === 403) {
-      const baseMessage = `You do not have permission to publish docs to organization '${organization}'. Please run 'fern login' to ensure you are logged in with the correct account.`;
-      const contactMessage = "Please ensure you have membership at https://dashboard.buildwithfern.com, and ask a team member for an invite if not.";
-      return `${baseMessage}
-
-${contactMessage}`;
+      return buildAuthFailureMessage(domain3, organization, content5);
     }
   }
   return void 0;
 }
+function buildAuthFailureMessage(domain3, organization, errorContent) {
+  const { code: code5, message } = extractServerError(errorContent);
+  switch (code5) {
+    case "FORBIDDEN":
+      return buildForbiddenMessage(domain3, organization, message);
+    case "UNAUTHORIZED":
+      return buildUnauthorizedMessage(organization, message);
+    case "INTERNAL_SERVER_ERROR":
+      return `An internal server error occurred while publishing docs to '${domain3}'. Please try again or reach out to support@buildwithfern.com for assistance.`;
+    default:
+      if (message != null) {
+        return message;
+      }
+      return `Failed to publish docs to '${domain3}'. Please reach out to support@buildwithfern.com for assistance.`;
+  }
+}
+var FORBIDDEN_ORG_MEMBERSHIP_PATTERNS = ["does not belong to organization", "User does not belong"];
+function buildForbiddenMessage(domain3, organization, message) {
+  if (message == null) {
+    return `You do not have permission to publish docs to '${domain3}' under organization '${organization}'.`;
+  }
+  if (FORBIDDEN_ORG_MEMBERSHIP_PATTERNS.some((pattern) => message.includes(pattern))) {
+    return `You are not a member of organization '${organization}'. Please run 'fern login' to ensure you are logged in with the correct account.
+
+Please ensure you have membership at https://dashboard.buildwithfern.com, and ask a team member for an invite if not.`;
+  }
+  return message;
+}
+function buildUnauthorizedMessage(organization, message) {
+  if (message != null && message.includes("Invalid authorization token")) {
+    return "Your authentication token is invalid or expired. Please run 'fern login' to re-authenticate.";
+  }
+  return `You are not authorized to publish docs under organization '${organization}'. Please run 'fern login' to ensure you are logged in with the correct account.
+
+Please ensure you have membership at https://dashboard.buildwithfern.com, and ask a team member for an invite if not.`;
+}
+function extractServerError(content5) {
+  if (content5 == null) {
+    return { code: void 0, message: void 0 };
+  }
+  const body = content5.body;
+  if (body != null && typeof body === "object") {
+    const code5 = typeof body.code === "string" ? body.code : void 0;
+    const message2 = typeof body.message === "string" ? body.message : void 0;
+    return { code: code5, message: message2 };
+  }
+  const message = typeof body === "string" && body.length > 0 ? body : typeof content5.errorMessage === "string" ? content5.errorMessage : typeof content5.message === "string" ? content5.message : void 0;
+  return { code: void 0, message };
+}
 function parseBasePath(domain3) {
   try {
     return new URL(wrapWithHttps(domain3)).pathname;
@@ -837316,7 +837443,7 @@ var LegacyDocsPublisher = class {
         previewId: void 0,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "4.53.1"
+        cliVersion: "4.54.0"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
         return { success: false };
@@ -875310,6 +875437,28 @@ var RustFilenameRegistry = class _RustFilenameRegistry {
       baseTypeName
     ]);
   }
+  /**
+   * Register filename for bytes request body types
+   * @param endpointId - Unique endpoint ID from IR
+   * @param baseFilename - Base filename in snake_case (without .rs extension)
+   * @returns The registered unique filename (without .rs extension)
+   */
+  registerBytesRequestFilename(endpointId, baseFilename) {
+    return this.filenameRegistry.registerSymbol(this.getBytesRequestFilenameId(endpointId), [
+      baseFilename,
+      `${baseFilename}_request`,
+      `${baseFilename}_bytes`
+    ]);
+  }
+  /**
+   * Register type name for bytes request body
+   * @param endpointId - Unique endpoint ID from IR
+   * @param baseTypeName - Base type name in PascalCase
+   * @returns The registered unique type name
+   */
+  registerBytesRequestTypeName(endpointId, baseTypeName) {
+    return this.typenameRegistry.registerSymbol(this.getBytesRequestTypeNameId(endpointId), [baseTypeName]);
+  }
   /**
    * Register client name for a subpackage or root client
    * @param clientId - Unique identifier for the client (subpackage ID or "root")
@@ -875451,6 +875600,28 @@ var RustFilenameRegistry = class _RustFilenameRegistry {
     assertDefined(typename, `Type name not found for referenced request with query ${endpointId}`);
     return typename;
   }
+  /**
+   * Get registered filename for bytes request body
+   * @param endpointId - Unique endpoint ID from IR
+   * @returns Filename with .rs extension
+   * @throws Error if filename not registered
+   */
+  getBytesRequestFilenameOrThrow(endpointId) {
+    const filename = this.filenameRegistry.getSymbolNameById(this.getBytesRequestFilenameId(endpointId));
+    assertDefined(filename, `Filename not found for bytes request ${endpointId}`);
+    return `${filename}.rs`;
+  }
+  /**
+   * Get registered type name for bytes request body
+   * @param endpointId - Unique endpoint ID from IR
+   * @returns The unique type name
+   * @throws Error if type name not registered
+   */
+  getBytesRequestTypeNameOrThrow(endpointId) {
+    const typename = this.typenameRegistry.getSymbolNameById(this.getBytesRequestTypeNameId(endpointId));
+    assertDefined(typename, `Type name not found for bytes request ${endpointId}`);
+    return typename;
+  }
   // =====================================
   // Private Helper Methods
   // =====================================
@@ -875487,6 +875658,12 @@ var RustFilenameRegistry = class _RustFilenameRegistry {
   getReferencedRequestWithQueryTypeNameId(endpointId) {
     return `${TYPENAME_ID_PREFIX}referenced_request_with_query_${endpointId}`;
   }
+  getBytesRequestFilenameId(endpointId) {
+    return `${FILENAME_ID_PREFIX}bytes_request_${endpointId}`;
+  }
+  getBytesRequestTypeNameId(endpointId) {
+    return `${TYPENAME_ID_PREFIX}bytes_request_${endpointId}`;
+  }
 };
 
 // ../../../generators/rust/base/lib/utils/index.js
@@ -879814,10 +879991,7 @@ var EndpointSnippetGenerator8 = class {
     const hasBody = request7.body != null;
     const body = request7.body;
     const isReferencedBodyOnly = body != null && !hasQueryParams && body.type === "referenced";
-    const isBytesWithQueryParams = hasQueryParams && body != null && body.type === "referenced" && body.bodyType.type === "bytes";
-    if (isBytesWithQueryParams) {
-      args.push(...this.getBytesEndpointArgs({ request: request7, snippet: snippet2 }));
-    } else if (isReferencedBodyOnly && body.type === "referenced") {
+    if (isReferencedBodyOnly && body.type === "referenced") {
       const bodyExpr = this.getReferencedRequestBodyPropertyExpression({
         body: body.bodyType,
         value: snippet2.requestBody
@@ -879834,34 +880008,6 @@ var EndpointSnippetGenerator8 = class {
     }
     return args;
   }
-  getBytesEndpointArgs({ request: request7, snippet: snippet2 }) {
-    const args = [];
-    const queryParameters = this.context.associateQueryParametersByWireValue({
-      parameters: request7.queryParameters ?? [],
-      values: snippet2.queryParameters ?? {}
-    });
-    const providedValues = /* @__PURE__ */ new Map();
-    for (const qp4 of queryParameters) {
-      const fieldName = this.context.getPropertyName(qp4.name.name);
-      providedValues.set(fieldName, this.context.dynamicTypeLiteralMapper.convert(qp4));
-    }
-    const allQueryParams = request7.queryParameters ?? [];
-    for (const param of allQueryParams) {
-      const fieldName = this.context.getPropertyName(param.name.name);
-      const value = providedValues.get(fieldName);
-      if (value != null) {
-        args.push(rust_exports.Expression.referenceOf(value));
-      } else {
-        args.push(rust_exports.Expression.referenceOf(rust_exports.Expression.raw("None")));
-      }
-    }
-    if (snippet2.requestBody != null && typeof snippet2.requestBody === "string" && snippet2.requestBody !== "") {
-      args.push(rust_exports.Expression.referenceOf(rust_exports.Expression.raw(`"${snippet2.requestBody}".as_bytes().to_vec()`)));
-    } else {
-      args.push(rust_exports.Expression.referenceOf(rust_exports.Expression.raw("vec![]")));
-    }
-    return args;
-  }
   getBodyRequestArg({ body, value }) {
     switch (body.type) {
       case "bytes":
@@ -879873,6 +880019,9 @@ var EndpointSnippetGenerator8 = class {
     }
   }
   getBytesBodyRequestArg({ value }) {
+    if (value == null) {
+      return rust_exports.Expression.raw("vec![]");
+    }
     if (typeof value !== "string") {
       this.context.errors.add({
         severity: Severity.Critical,
@@ -910436,7 +910585,7 @@ var CliContext = class {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "4.53.1";
+    return "4.54.0";
   }
   getCliName() {
     if (false) {

package/package.json

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