@fern-api/fern-api-dev 4.94.3 → 4.95.0-2-gee509e0a248

package/cli.cjs

@@ -477487,7 +477487,8 @@ var WithEnvironmentVariable = schemas_exports.object({
 
 // ../fern-definition/schema/lib/schemas/serialization/resources/auth/types/AuthVariable.js
 var AuthVariable = schemas_exports.object({
-  omit: schemas_exports.boolean().optional()
+  omit: schemas_exports.boolean().optional(),
+  placeholder: schemas_exports.string().optional()
 }).extend(WithEnvironmentVariable).extend(WithName);
 
 // ../fern-definition/schema/lib/schemas/serialization/resources/auth/types/BasicAuthSchemeSchema.js
@@ -477533,7 +477534,8 @@ var BearerAuthSchemeSchema = schemas_exports.undiscriminatedUnion([TokenBearerAu
 var HeaderAuthSchemeSchema = schemas_exports.object({
   header: schemas_exports.string(),
   type: schemas_exports.string().optional(),
-  prefix: schemas_exports.string().optional()
+  prefix: schemas_exports.string().optional(),
+  placeholder: schemas_exports.string().optional()
 }).extend(WithEnvironmentVariable).extend(WithName).extend(WithDocsSchema);
 
 // ../fern-definition/schema/lib/schemas/serialization/resources/auth/types/AuthScope.js
@@ -478304,6 +478306,7 @@ var SingleUndiscriminatedUnionTypeSchema = schemas_exports.undiscriminatedUnion(
 // ../fern-definition/schema/lib/schemas/serialization/resources/types/types/UndiscriminatedUnionSchema.js
 var UndiscriminatedUnionSchema = schemas_exports.object({
   discriminated: schemas_exports.booleanLiteral(false),
+  "base-properties": schemas_exports.record(schemas_exports.string(), TypeReferenceSchema).optional(),
   union: schemas_exports.list(SingleUndiscriminatedUnionTypeSchema)
 }).extend(BaseTypeDeclarationSchema);
 
@@ -485456,15 +485459,18 @@ var BasicAuthScheme = schemas_exports3.objectWithoutOptionalProperties({
   username: NameOrString,
   usernameEnvVar: EnvironmentVariable.optional(),
   usernameOmit: schemas_exports3.boolean().optional(),
+  usernamePlaceholder: schemas_exports3.string().optional(),
   password: NameOrString,
   passwordEnvVar: EnvironmentVariable.optional(),
-  passwordOmit: schemas_exports3.boolean().optional()
+  passwordOmit: schemas_exports3.boolean().optional(),
+  passwordPlaceholder: schemas_exports3.string().optional()
 }).extend(BaseAuthScheme);
 
 // ../../ir-sdk/lib/sdk/serialization/resources/auth/types/BearerAuthScheme.js
 var BearerAuthScheme = schemas_exports3.objectWithoutOptionalProperties({
   token: NameOrString,
-  tokenEnvVar: EnvironmentVariable.optional()
+  tokenEnvVar: EnvironmentVariable.optional(),
+  tokenPlaceholder: schemas_exports3.string().optional()
 }).extend(BaseAuthScheme);
 
 // ../../ir-sdk/lib/sdk/serialization/resources/commons/types/NameAndWireValue.js
@@ -485481,7 +485487,8 @@ var HeaderAuthScheme = schemas_exports3.objectWithoutOptionalProperties({
   name: NameAndWireValueOrString,
   valueType: schemas_exports3.lazy(() => TypeReference3),
   prefix: schemas_exports3.string().optional(),
-  headerEnvVar: EnvironmentVariable.optional()
+  headerEnvVar: EnvironmentVariable.optional(),
+  headerPlaceholder: schemas_exports3.string().optional()
 }).extend(BaseAuthScheme);
 
 // ../../ir-sdk/lib/sdk/serialization/resources/commons/types/EndpointId.js
@@ -489201,7 +489208,8 @@ var UndiscriminatedUnionMember = schemas_exports3.objectWithoutOptionalPropertie
 
 // ../../ir-sdk/lib/sdk/serialization/resources/types/types/UndiscriminatedUnionTypeDeclaration.js
 var UndiscriminatedUnionTypeDeclaration = schemas_exports3.objectWithoutOptionalProperties({
-  members: schemas_exports3.list(UndiscriminatedUnionMember)
+  members: schemas_exports3.list(UndiscriminatedUnionMember),
+  baseProperties: schemas_exports3.list(ObjectProperty).optional()
 });
 
 // ../../ir-sdk/lib/sdk/serialization/resources/types/types/SingleUnionTypeProperty.js
@@ -491581,6 +491589,7 @@ function visitTypeDeclaration({ typeName, declaration, visitor, nodePathForType
       visitObject(union22, {
         docs: createDocsVisitor(visitor, nodePathForType),
         discriminated: noop2,
+        "base-properties": noop2,
         union: (unionMembers) => {
           for (const [index3, unionMember] of unionMembers.entries()) {
             const nodePathForUnionType = [...nodePathForType, `union[${index3}]`];
@@ -518325,14 +518334,17 @@ function transformAndValidateUnion5({ value: value2, discriminant: discriminant2
 var BasicSecurityScheme = schemas_exports9.objectWithoutOptionalProperties({
   usernameVariableName: schemas_exports9.string().optional(),
   usernameEnvVar: schemas_exports9.string().optional(),
+  usernamePlaceholder: schemas_exports9.string().optional(),
   passwordVariableName: schemas_exports9.string().optional(),
-  passwordEnvVar: schemas_exports9.string().optional()
+  passwordEnvVar: schemas_exports9.string().optional(),
+  passwordPlaceholder: schemas_exports9.string().optional()
 });
 
 // ../api-importers/openapi/openapi-ir/lib/sdk/serialization/resources/commons/types/BearerSecurityScheme.js
 var BearerSecurityScheme = schemas_exports9.objectWithoutOptionalProperties({
   tokenVariableName: schemas_exports9.string().optional(),
-  tokenEnvVar: schemas_exports9.string().optional()
+  tokenEnvVar: schemas_exports9.string().optional(),
+  tokenPlaceholder: schemas_exports9.string().optional()
 });
 
 // ../api-importers/openapi/openapi-ir/lib/sdk/serialization/resources/commons/types/ProtobufEncoding.js
@@ -518360,7 +518372,8 @@ var HeaderSecurityScheme = schemas_exports9.objectWithoutOptionalProperties({
   headerName: schemas_exports9.string(),
   prefix: schemas_exports9.string().optional(),
   headerVariableName: schemas_exports9.string().optional(),
-  headerEnvVar: schemas_exports9.string().optional()
+  headerEnvVar: schemas_exports9.string().optional(),
+  headerPlaceholder: schemas_exports9.string().optional()
 });
 
 // ../api-importers/openapi/openapi-ir/lib/sdk/serialization/resources/commons/types/Namespace.js
@@ -519789,6 +519802,7 @@ var Schema2 = schemas_exports9.union("type", {
 
 // ../api-importers/openapi/openapi-ir/lib/sdk/serialization/resources/finalIr/types/UnDiscriminatedOneOfSchema.js
 var UnDiscriminatedOneOfSchema = schemas_exports9.objectWithoutOptionalProperties({
+  commonProperties: schemas_exports9.list(schemas_exports9.lazyObject(() => CommonProperty)).optional(),
   schemas: schemas_exports9.list(schemas_exports9.lazy(() => Schema2))
 }).extend(WithSdkGroupName).extend(WithNamespace).extend(WithName3).extend(WithDescription).extend(WithAvailability3).extend(WithEncoding).extend(WithSource).extend(WithTitle).extend(WithInline);
 
@@ -520276,6 +520290,7 @@ var SchemaWithExample2 = schemas_exports9.union("type", {
 
 // ../api-importers/openapi/openapi-ir/lib/sdk/serialization/resources/parseIr/types/UnDiscriminatedOneOfSchemaWithExample.js
 var UnDiscriminatedOneOfSchemaWithExample = schemas_exports9.objectWithoutOptionalProperties({
+  commonProperties: schemas_exports9.list(schemas_exports9.lazyObject(() => CommonPropertyWithExample)).optional(),
   schemas: schemas_exports9.list(schemas_exports9.lazy(() => SchemaWithExample2))
 }).extend(WithSdkGroupName).extend(WithNamespace).extend(WithName3).extend(WithDescription).extend(WithAvailability3).extend(WithEncoding).extend(WithSource).extend(WithTitle).extend(WithInline);
 
@@ -521853,9 +521868,9 @@ function buildLiteralTypeDeclaration(schema2, nameOverride, generatedName) {
 function buildOneOfTypeDeclaration({ schema: schema2, context: context3, declarationFile, namespace, declarationDepth, variant }) {
   const encoding = schema2.encoding != null ? convertToEncodingSchema(schema2.encoding) : void 0;
   if (schema2.type === "discriminated") {
-    const baseProperties = {};
+    const baseProperties2 = {};
     for (const property23 of schema2.commonProperties) {
-      baseProperties[property23.key] = buildTypeReference({
+      baseProperties2[property23.key] = buildTypeReference({
         schema: property23.schema,
         fileContainingReference: declarationFile,
         context: context3,
@@ -521887,7 +521902,7 @@ function buildOneOfTypeDeclaration({ schema: schema2, context: context3, declara
             context: schema2.discriminatorContext
           }
         } : schema2.discriminantProperty,
-        "base-properties": baseProperties,
+        "base-properties": baseProperties2,
         docs: schema2.description ?? void 0,
         availability: schema2.availability != null ? convertAvailability(schema2.availability) : void 0,
         union: union23,
@@ -521908,10 +521923,22 @@ function buildOneOfTypeDeclaration({ schema: schema2, context: context3, declara
       variant
     }));
   }
+  const baseProperties = schema2.commonProperties != null && schema2.commonProperties.length > 0 ? Object.fromEntries(schema2.commonProperties.map((property23) => [
+    property23.key,
+    buildTypeReference({
+      schema: property23.schema,
+      fileContainingReference: declarationFile,
+      context: context3,
+      namespace,
+      declarationDepth: declarationDepth + 1,
+      variant
+    })
+  ])) : void 0;
   return {
     name: schema2.nameOverride ?? schema2.generatedName,
     schema: {
       discriminated: false,
+      "base-properties": baseProperties,
       docs: schema2.description ?? void 0,
       union: union22,
       encoding,
@@ -522011,6 +522038,15 @@ function buildAuthSchemes(context3) {
           basicAuthScheme.username.env = securityScheme.usernameEnvVar;
         }
       }
+      if (securityScheme.usernamePlaceholder != null) {
+        if (basicAuthScheme.username === void 0) {
+          basicAuthScheme.username = {
+            placeholder: securityScheme.usernamePlaceholder
+          };
+        } else {
+          basicAuthScheme.username.placeholder = securityScheme.usernamePlaceholder;
+        }
+      }
       if (securityScheme.passwordVariableName != null) {
         if (basicAuthScheme.password === void 0) {
           basicAuthScheme.password = {
@@ -522029,6 +522065,15 @@ function buildAuthSchemes(context3) {
           basicAuthScheme.password.env = securityScheme.passwordEnvVar;
         }
       }
+      if (securityScheme.passwordPlaceholder != null) {
+        if (basicAuthScheme.password === void 0) {
+          basicAuthScheme.password = {
+            placeholder: securityScheme.passwordPlaceholder
+          };
+        } else {
+          basicAuthScheme.password.placeholder = securityScheme.passwordPlaceholder;
+        }
+      }
       context3.builder.addAuthScheme({
         name: id,
         schema: basicAuthScheme
@@ -522059,6 +522104,15 @@ function buildAuthSchemes(context3) {
           bearerAuthScheme.token.env = securityScheme.tokenEnvVar;
         }
       }
+      if (securityScheme.tokenPlaceholder != null) {
+        if (bearerAuthScheme.token === void 0) {
+          bearerAuthScheme.token = {
+            placeholder: securityScheme.tokenPlaceholder
+          };
+        } else {
+          bearerAuthScheme.token.placeholder = securityScheme.tokenPlaceholder;
+        }
+      }
       context3.builder.addAuthScheme({
         name: id,
         schema: bearerAuthScheme
@@ -522080,6 +522134,9 @@ function buildAuthSchemes(context3) {
         if (securityScheme.prefix != null) {
           schema2.prefix = securityScheme.prefix;
         }
+        if (securityScheme.headerPlaceholder != null) {
+          schema2.placeholder = securityScheme.headerPlaceholder;
+        }
         context3.builder.addAuthScheme({
           name: id,
           schema: schema2
@@ -528744,6 +528801,12 @@ function convertToOneOf(oneOfSchema) {
         generatedName: oneOfSchema.generatedName,
         title: oneOfSchema.title,
         nameOverride: oneOfSchema.nameOverride,
+        commonProperties: oneOfSchema.commonProperties?.map((commonProperty) => {
+          return {
+            key: commonProperty.key,
+            schema: convertSchemaWithExampleToSchema(commonProperty.schema)
+          };
+        }),
         schemas: oneOfSchema.schemas.map((oneOfSchema2) => convertSchemaWithExampleToSchema(oneOfSchema2)),
         namespace: oneOfSchema.namespace,
         groupName: oneOfSchema.groupName,
@@ -529136,7 +529199,7 @@ function getAllProperties({ schema: schema2, context: context3, breadcrumbs, sou
 
 // ../api-importers/openapi/openapi-ir-parser/lib/schema/convertUndiscriminatedOneOf.js
 init_lodash();
-function convertUndiscriminatedOneOf({ nameOverride, generatedName, title: title2, breadcrumbs, description, availability, wrapAsOptional, wrapAsNullable, context: context3, subtypes, namespace, groupName, encoding, source: source2, subtypeSuffixOverrides }) {
+function convertUndiscriminatedOneOf({ nameOverride, generatedName, title: title2, breadcrumbs, description, availability, wrapAsOptional, wrapAsNullable, context: context3, subtypes, namespace, groupName, encoding, source: source2, subtypeSuffixOverrides, properties: properties7, required: required6 }) {
   const derivedSubtypeSuffixes = getUniqueSubTypeNames({ schemas: subtypes });
   const convertedSubtypes = subtypes.flatMap((schema2, index3) => {
     if (!isReferenceObject(schema2) && schema2.enum != null && context3.options.coerceEnumsToLiterals && schema2.type === "string") {
@@ -529164,6 +529227,14 @@ function convertUndiscriminatedOneOf({ nameOverride, generatedName, title: title
       convertSchema2(schema2, false, false, context3, [...breadcrumbs, subtypeSuffix ?? `${index3}`], source2, namespace)
     ];
   });
+  const convertedCommonProperties = properties7 != null && Object.keys(properties7).length > 0 ? Object.entries(properties7).map(([propertyName, propertySchema]) => {
+    const isRequired = required6 != null && required6.includes(propertyName);
+    const [isOptional, isNullable] = context3.options.coerceOptionalSchemasToNullable ? [false, !isRequired] : [!isRequired, false];
+    return {
+      key: propertyName,
+      schema: convertSchema2(propertySchema, isOptional, isNullable, context3, [...breadcrumbs, propertyName], source2, namespace)
+    };
+  }) : void 0;
   const uniqueSubtypes = deduplicateSubtypes(convertedSubtypes);
   return processSubtypes({
     uniqueSubtypes,
@@ -529178,7 +529249,8 @@ function convertUndiscriminatedOneOf({ nameOverride, generatedName, title: title
     groupName,
     context: context3,
     encoding,
-    source: source2
+    source: source2,
+    commonProperties: convertedCommonProperties
   });
 }
 function deduplicateSubtypes(subtypes) {
@@ -529199,11 +529271,12 @@ function deduplicateSubtypes(subtypes) {
   }
   return uniqueSubtypes;
 }
-function processSubtypes({ uniqueSubtypes, nameOverride, generatedName, title: title2, wrapAsOptional, wrapAsNullable, description, availability, namespace, groupName, context: context3, encoding, source: source2 }) {
+function processSubtypes({ uniqueSubtypes, nameOverride, generatedName, title: title2, wrapAsOptional, wrapAsNullable, description, availability, namespace, groupName, context: context3, encoding, source: source2, commonProperties }) {
+  const hasCommonProperties = commonProperties != null && commonProperties.length > 0;
   const everySubTypeIsLiteral = Object.entries(uniqueSubtypes).every(([_7, schema2]) => {
     return schema2.type === "literal";
   });
-  if (everySubTypeIsLiteral) {
+  if (everySubTypeIsLiteral && !hasCommonProperties) {
     const enumDescriptions = {};
     const enumValues = [];
     Object.entries(uniqueSubtypes).forEach(([_7, schema2]) => {
@@ -529235,7 +529308,7 @@ function processSubtypes({ uniqueSubtypes, nameOverride, generatedName, title: t
       inline: void 0
     });
   }
-  if (uniqueSubtypes.length === 1 && uniqueSubtypes[0] != null && !context3.options.preserveSingleSchemaOneOf) {
+  if (uniqueSubtypes.length === 1 && uniqueSubtypes[0] != null && !context3.options.preserveSingleSchemaOneOf && !hasCommonProperties) {
     let result = uniqueSubtypes[0];
     if (wrapAsNullable) {
       result = SchemaWithExample.nullable({
@@ -529277,7 +529350,8 @@ function processSubtypes({ uniqueSubtypes, nameOverride, generatedName, title: t
     namespace,
     groupName,
     encoding,
-    source: source2
+    source: source2,
+    commonProperties
   });
 }
 function convertUndiscriminatedOneOfWithDiscriminant({ nameOverride, generatedName, title: title2, description, availability, wrapAsOptional, wrapAsNullable, context: context3, namespace, groupName, discriminator, encoding, source: source2 }) {
@@ -529405,13 +529479,14 @@ function getUniqueSubTypeNames({ schemas }) {
   });
   return prefixes;
 }
-function wrapUndiscriminatedOneOf({ nameOverride, generatedName, title: title2, wrapAsOptional, wrapAsNullable, description, availability, subtypes, namespace, groupName, encoding, source: source2 }) {
+function wrapUndiscriminatedOneOf({ nameOverride, generatedName, title: title2, wrapAsOptional, wrapAsNullable, description, availability, subtypes, namespace, groupName, encoding, source: source2, commonProperties }) {
   let result = SchemaWithExample.oneOf(OneOfSchemaWithExample.undiscriminated({
     description,
     availability,
     nameOverride,
     generatedName,
     title: title2,
+    commonProperties: commonProperties != null && commonProperties.length > 0 ? commonProperties : void 0,
     schemas: subtypes,
     namespace,
     groupName,
@@ -530338,7 +530413,9 @@ function convertSchemaObject(schema2, wrapAsOptional, wrapAsNullable, context3,
           encoding,
           namespace,
           groupName,
-          source: source2
+          source: source2,
+          properties: schema2.properties,
+          required: schema2.required
         });
       }
     }
@@ -530404,7 +530481,9 @@ function convertSchemaObject(schema2, wrapAsOptional, wrapAsNullable, context3,
         encoding,
         namespace,
         groupName,
-        source: source2
+        source: source2,
+        properties: schema2.properties,
+        required: schema2.required
       });
     }
     if (schema2.discriminator?.mapping != null && Object.keys(schema2.discriminator.mapping).length > 0 && schema2.oneOf == null && schema2.anyOf == null) {
@@ -532259,6 +532338,12 @@ function convertToOneOf2(oneOfSchema) {
         generatedName: oneOfSchema.generatedName,
         nameOverride: oneOfSchema.nameOverride,
         title: oneOfSchema.title,
+        commonProperties: oneOfSchema.commonProperties?.map((commonProperty) => {
+          return {
+            key: commonProperty.key,
+            schema: convertSchemaToSchemaWithExample(commonProperty.schema)
+          };
+        }),
         schemas: oneOfSchema.schemas.map((oneOfSchema2) => convertSchemaToSchemaWithExample(oneOfSchema2)),
         namespace: oneOfSchema.namespace,
         groupName: oneOfSchema.groupName,
@@ -537177,13 +537262,15 @@ function convertSecuritySchemeHelper(securityScheme, source2, taskContext) {
         headerName: securityScheme.name,
         prefix: bearerFormat != null ? "Bearer" : headerNames?.prefix,
         headerVariableName: headerNames?.name ?? getExtension(securityScheme, FernOpenAPIExtension.HEADER_VARIABLE_NAME),
-        headerEnvVar: headerNames?.env
+        headerEnvVar: headerNames?.env,
+        headerPlaceholder: headerNames?.placeholder
       });
     } else if (securityScheme.type === "http" && securityScheme.scheme?.toLowerCase() === "bearer") {
       const bearerNames = getExtension(securityScheme, FernOpenAPIExtension.FERN_BEARER_TOKEN);
       return SecurityScheme.bearer({
         tokenVariableName: bearerNames?.name ?? getExtension(securityScheme, FernOpenAPIExtension.BEARER_TOKEN_VARIABLE_NAME),
-        tokenEnvVar: bearerNames?.env
+        tokenEnvVar: bearerNames?.env,
+        tokenPlaceholder: bearerNames?.placeholder
       });
     } else if (securityScheme.type === "http" && securityScheme.scheme?.toLowerCase() === "basic") {
       const basicSecuritySchemeNamingAndEnvvar = getBasicSecuritySchemeNameAndEnvvar(securityScheme);
@@ -537191,13 +537278,16 @@ function convertSecuritySchemeHelper(securityScheme, source2, taskContext) {
       return SecurityScheme.basic({
         usernameVariableName: basicSecuritySchemeNamingAndEnvvar?.username?.name ?? basicSecuritySchemeNaming.usernameVariable,
         usernameEnvVar: basicSecuritySchemeNamingAndEnvvar?.username?.env,
+        usernamePlaceholder: basicSecuritySchemeNamingAndEnvvar?.username?.placeholder,
         passwordVariableName: basicSecuritySchemeNamingAndEnvvar?.password?.name ?? basicSecuritySchemeNaming.passwordVariable,
-        passwordEnvVar: basicSecuritySchemeNamingAndEnvvar?.password?.env
+        passwordEnvVar: basicSecuritySchemeNamingAndEnvvar?.password?.env,
+        passwordPlaceholder: basicSecuritySchemeNamingAndEnvvar?.password?.placeholder
       });
     } else if (securityScheme.type === "openIdConnect") {
       return SecurityScheme.bearer({
         tokenVariableName: void 0,
-        tokenEnvVar: void 0
+        tokenEnvVar: void 0,
+        tokenPlaceholder: void 0
       });
     } else if (securityScheme.type === "oauth2") {
       return SecurityScheme.oauth({
@@ -548765,7 +548855,8 @@ function convertSchemeReference({ reference: reference4, authSchemeDeclarations,
           v2: PrimitiveTypeV2.string({ default: void 0, validation: void 0 })
         }),
         prefix: rawHeader.prefix,
-        headerEnvVar: rawHeader.env
+        headerEnvVar: rawHeader.env,
+        headerPlaceholder: rawHeader.placeholder
       }),
       basic: (rawScheme) => generateBasicAuth({
         key: reference5,
@@ -548821,7 +548912,8 @@ function generateBearerAuth({ key: key2, casingsGenerator, docs: docs2, rawSchem
     key: key2,
     docs: docs2,
     token: casingsGenerator.generateName(rawScheme?.token?.name ?? "token"),
-    tokenEnvVar: rawScheme?.token?.env
+    tokenEnvVar: rawScheme?.token?.env,
+    tokenPlaceholder: rawScheme?.token?.placeholder
   });
 }
 function generateBasicAuth({ key: key2, casingsGenerator, docs: docs2, rawScheme }) {
@@ -548831,9 +548923,11 @@ function generateBasicAuth({ key: key2, casingsGenerator, docs: docs2, rawScheme
     username: casingsGenerator.generateName(rawScheme?.username?.name ?? "username"),
     usernameEnvVar: rawScheme?.username?.env,
     usernameOmit: rawScheme?.username?.omit,
+    usernamePlaceholder: rawScheme?.username?.placeholder,
     password: casingsGenerator.generateName(rawScheme?.password?.name ?? "password"),
     passwordEnvVar: rawScheme?.password?.env,
-    passwordOmit: rawScheme?.password?.omit
+    passwordOmit: rawScheme?.password?.omit,
+    passwordPlaceholder: rawScheme?.password?.placeholder
   });
 }
 
@@ -559131,16 +559225,16 @@ var DynamicSnippetsConverter = class {
     switch (scheme.type) {
       case "bearer":
         return dynamic_exports.AuthValues.bearer({
-          token: "<token>"
+          token: scheme.tokenPlaceholder ?? "<token>"
         });
       case "basic":
         return dynamic_exports.AuthValues.basic({
-          username: scheme.usernameOmit ? "" : "<username>",
-          password: scheme.passwordOmit ? "" : "<password>"
+          username: scheme.usernameOmit ? "" : scheme.usernamePlaceholder ?? "<username>",
+          password: scheme.passwordOmit ? "" : scheme.passwordPlaceholder ?? "<password>"
         });
       case "header":
         return dynamic_exports.AuthValues.header({
-          value: "<value>"
+          value: scheme.headerPlaceholder ?? "<value>"
         });
       case "oauth":
         return dynamic_exports.AuthValues.oauth({
@@ -559777,7 +559871,8 @@ function convertSchemeReference2({ reference: reference4, authSchemeDeclarations
         }),
         valueType: file4.parseTypeReference(rawHeader.type ?? "string"),
         prefix: rawHeader.prefix,
-        headerEnvVar: rawHeader.env
+        headerEnvVar: rawHeader.env,
+        headerPlaceholder: rawHeader.placeholder
       }),
       basic: (rawScheme) => generateBasicAuth2({
         key: reference5,
@@ -559845,7 +559940,8 @@ function generateBearerAuth2({ key: key2, file: file4, docs: docs2, rawScheme })
     key: key2,
     docs: docs2,
     token: file4.casingsGenerator.generateName(rawScheme?.token?.name ?? "token"),
-    tokenEnvVar: rawScheme?.token?.env
+    tokenEnvVar: rawScheme?.token?.env,
+    tokenPlaceholder: rawScheme?.token?.placeholder
   });
 }
 function generateBasicAuth2({ key: key2, file: file4, docs: docs2, rawScheme }) {
@@ -559855,9 +559951,11 @@ function generateBasicAuth2({ key: key2, file: file4, docs: docs2, rawScheme })
     username: file4.casingsGenerator.generateName(rawScheme?.username?.name ?? "username"),
     usernameEnvVar: rawScheme?.username?.env,
     usernameOmit: rawScheme?.username?.omit,
+    usernamePlaceholder: rawScheme?.username?.placeholder,
     password: file4.casingsGenerator.generateName(rawScheme?.password?.name ?? "password"),
     passwordEnvVar: rawScheme?.password?.env,
-    passwordOmit: rawScheme?.password?.omit
+    passwordOmit: rawScheme?.password?.omit,
+    passwordPlaceholder: rawScheme?.password?.placeholder
   });
 }
 function generateOAuth({ key: key2, file: file4, docs: docs2, rawScheme, propertyResolver, endpointResolver, typeResolver }) {
@@ -561109,6 +561207,19 @@ function convertUndiscriminatedUnionTypeDeclaration({ union: union22, file: file
     }) === currentIndex;
   });
   return Type.undiscriminatedUnion({
+    baseProperties: union22["base-properties"] != null ? Object.entries(union22["base-properties"]).map(([propertyKey, propertyDefinition]) => ({
+      ...convertDeclaration(propertyDefinition),
+      name: file4.casingsGenerator.generateNameAndWireValue({
+        wireValue: propertyKey,
+        name: getPropertyName({ propertyKey, property: propertyDefinition }).name
+      }),
+      valueType: file4.parseTypeReference(propertyDefinition),
+      propertyAccess: getPropertyAccess2({ property: propertyDefinition }),
+      v2Examples: {
+        userSpecifiedExamples: {},
+        autogeneratedExamples: {}
+      }
+    })) : void 0,
     members: uniqueMembers.map((member) => {
       const parsedType2 = file4.parseTypeReference(typeof member === "string" ? member : member.type);
       const typeWithDisplayName = parsedType2.type === "named" ? {
@@ -561173,13 +561284,18 @@ function getReferencedTypesFromRawDeclaration({ typeDeclaration: typeDeclaration
       return types4;
     },
     undiscriminatedUnion: (unionDeclaration) => {
-      return Object.values(unionDeclaration.union).reduce((types4, unionMember) => {
+      const types4 = [];
+      if (unionDeclaration["base-properties"] != null) {
+        types4.push(...Object.values(unionDeclaration["base-properties"]).map((property23) => typeof property23 === "string" ? property23 : property23.type));
+      }
+      types4.push(...Object.values(unionDeclaration.union).reduce((memberTypes, unionMember) => {
         const rawType = typeof unionMember === "string" ? unionMember : unionMember.type;
         if (typeof rawType === "string") {
-          types4.push(rawType);
+          memberTypes.push(rawType);
         }
-        return types4;
-      }, []);
+        return memberTypes;
+      }, []));
+      return types4;
     },
     enum: () => []
   });
@@ -588538,6 +588654,19 @@ var definitions2 = {
       discriminated: {
         const: false
       },
+      "base-properties": {
+        oneOf: [
+          {
+            type: "object",
+            additionalProperties: {
+              $ref: "#/definitions/types.TypeReferenceSchema"
+            }
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
       union: {
         type: "array",
         items: {
@@ -592749,6 +592878,19 @@ var definitions3 = {
       discriminated: {
         const: false
       },
+      "base-properties": {
+        oneOf: [
+          {
+            type: "object",
+            additionalProperties: {
+              $ref: "#/definitions/types.TypeReferenceSchema"
+            }
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
       union: {
         type: "array",
         items: {
@@ -600433,7 +600575,8 @@ var OneOfSchemaConverter = class extends AbstractConverter {
         }
         continue;
       }
-      const extendedSubSchema = this.extendSubSchema(subSchema);
+      const hasSiblingProperties = Object.keys(this.schema.properties ?? {}).length > 0;
+      const extendedSubSchema = hasSiblingProperties ? void 0 : this.extendSubSchema(subSchema);
       const schemaId = this.context.convertBreadcrumbsToName([`${this.id}_${index3}`]);
       const displayName = subSchema.title;
       const schemaConverter = new SchemaConverter({
@@ -600476,12 +600619,29 @@ var OneOfSchemaConverter = class extends AbstractConverter {
         });
       }
     }
+    const { convertedProperties: siblingProperties, referencedTypes: siblingReferencedTypes, inlinedTypesFromProperties: siblingInlinedTypes } = convertProperties({
+      properties: this.schema.properties ?? {},
+      required: this.schema.required ?? [],
+      breadcrumbs: this.breadcrumbs,
+      context: this.context,
+      errorCollector: this.context.errorCollector
+    });
+    for (const typeId of Object.keys(siblingInlinedTypes)) {
+      referencedTypes.add(typeId);
+    }
+    for (const ref2 of siblingReferencedTypes) {
+      referencedTypes.add(ref2);
+    }
     return {
       type: Type.undiscriminatedUnion({
-        members: unionTypes
+        members: unionTypes,
+        baseProperties: siblingProperties.length > 0 ? siblingProperties : void 0
       }),
       referencedTypes,
-      inlinedTypes
+      inlinedTypes: {
+        ...inlinedTypes,
+        ...siblingInlinedTypes
+      }
     };
   }
   shouldConvertAsNullableSchemaOrReference() {
@@ -603774,6 +603934,7 @@ var AsyncAPIConverter = class extends AbstractSpecConverter {
             key: schemeId,
             token: this.context.casingsGenerator.generateName("token"),
             tokenEnvVar: void 0,
+            tokenPlaceholder: void 0,
             docs: securityScheme.description
           });
         }
@@ -603786,6 +603947,8 @@ var AsyncAPIConverter = class extends AbstractSpecConverter {
             passwordEnvVar: void 0,
             usernameOmit: false,
             passwordOmit: false,
+            usernamePlaceholder: void 0,
+            passwordPlaceholder: void 0,
             docs: securityScheme.description
           });
         }
@@ -603802,6 +603965,7 @@ var AsyncAPIConverter = class extends AbstractSpecConverter {
             valueType: AbstractConverter.OPTIONAL_STRING,
             prefix: void 0,
             headerEnvVar: void 0,
+            headerPlaceholder: void 0,
             docs: securityScheme.description
           });
         }
@@ -603812,6 +603976,7 @@ var AsyncAPIConverter = class extends AbstractSpecConverter {
           key: schemeId,
           token: this.context.casingsGenerator.generateName("token"),
           tokenEnvVar: void 0,
+          tokenPlaceholder: void 0,
           docs: securityScheme.description
         });
       }
@@ -607061,10 +607226,12 @@ var SecuritySchemeConverter = class extends AbstractConverter {
           const bearerExtension = this.getExtension("x-fern-bearer");
           const tokenName = bearerExtension?.name ?? "token";
           const tokenEnvVar = bearerExtension?.env;
+          const tokenPlaceholder = bearerExtension?.placeholder;
           return AuthScheme.bearer({
             key: this.schemeId,
             token: this.context.casingsGenerator.generateName(tokenName),
             tokenEnvVar,
+            tokenPlaceholder,
             docs: this.securityScheme.description
           });
         }
@@ -607074,6 +607241,8 @@ var SecuritySchemeConverter = class extends AbstractConverter {
           const passwordName = basicExtension?.password?.name ?? "password";
           const usernameEnvVar = basicExtension?.username?.env;
           const passwordEnvVar = basicExtension?.password?.env;
+          const usernamePlaceholder = basicExtension?.username?.placeholder;
+          const passwordPlaceholder = basicExtension?.password?.placeholder;
           return AuthScheme.basic({
             key: this.schemeId,
             username: this.context.casingsGenerator.generateName(usernameName),
@@ -607082,6 +607251,8 @@ var SecuritySchemeConverter = class extends AbstractConverter {
             passwordEnvVar,
             usernameOmit: false,
             passwordOmit: false,
+            usernamePlaceholder,
+            passwordPlaceholder,
             docs: this.securityScheme.description
           });
         }
@@ -607093,6 +607264,7 @@ var SecuritySchemeConverter = class extends AbstractConverter {
           const headerName = headerExtension?.name ?? "apiKey";
           const headerEnvVar = headerExtension?.env;
           const prefix2 = headerExtension?.prefix;
+          const headerPlaceholder = headerExtension?.placeholder;
           return AuthScheme.header({
             key: this.schemeId,
             name: {
@@ -607102,6 +607274,7 @@ var SecuritySchemeConverter = class extends AbstractConverter {
             valueType: AbstractConverter.OPTIONAL_STRING,
             prefix: prefix2,
             headerEnvVar,
+            headerPlaceholder,
             docs: this.securityScheme.description
           });
         }
@@ -607112,6 +607285,7 @@ var SecuritySchemeConverter = class extends AbstractConverter {
           key: this.schemeId,
           token: this.context.casingsGenerator.generateName("token"),
           tokenEnvVar: void 0,
+          tokenPlaceholder: void 0,
           docs: this.securityScheme.description
         });
       }
@@ -618017,7 +618191,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "4.94.3",
+          version: "4.95.0-2-gee509e0a248",
           usingAccessToken: true
         }
       });
@@ -618071,7 +618245,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "4.94.3",
+        version: "4.95.0-2-gee509e0a248",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -829195,7 +829369,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.94.3";
+  const version7 = "4.95.0-2-gee509e0a248";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -841158,7 +841332,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "4.94.3",
+        cliVersion: "4.95.0-2-gee509e0a248",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -911807,7 +911981,8 @@ var OneOfFieldConverter = class extends AbstractConverter {
     }
     return {
       type: Type.undiscriminatedUnion({
-        members: unionTypes
+        members: unionTypes,
+        baseProperties: void 0
       }),
       referencedTypes: /* @__PURE__ */ new Set(),
       inlinedTypes: {},
@@ -915650,7 +915825,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "4.94.3";
+    return "4.95.0-2-gee509e0a248";
   }
   getCliName() {
     if (false) {

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "4.94.3",
+  "version": "4.95.0-2-gee509e0a248",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",