@fern-api/fern-api-dev 4.53.2 → 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.2",
+          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.2",
+        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.2";
+  const version7 = "4.54.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -837362,7 +837443,7 @@ var LegacyDocsPublisher = class {
         previewId: void 0,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "4.53.2"
+        cliVersion: "4.54.0"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
         return { success: false };
@@ -910504,7 +910585,7 @@ var CliContext = class {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "4.53.2";
+    return "4.54.0";
   }
   getCliName() {
     if (false) {

package/package.json

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