fern-api 0.31.25-rc0 → 0.32.0

package/bundle.cjs

@@ -355192,6 +355192,39 @@ var init_PlatformHeaders = __esm({
   }
 });
 
+// pnp:/home/runner/work/fern/fern/packages/ir-sdk/lib/sdk/api/resources/ir/types/ApiVersionScheme.js
+var ApiVersionScheme;
+var init_ApiVersionScheme = __esm({
+  "pnp:/home/runner/work/fern/fern/packages/ir-sdk/lib/sdk/api/resources/ir/types/ApiVersionScheme.js"() {
+    init_api();
+    ApiVersionScheme = {
+      header: (value) => {
+        return {
+          ...value,
+          type: "header",
+          _visit: function(visitor) {
+            return ApiVersionScheme._visit(this, visitor);
+          }
+        };
+      },
+      _visit: (value, visitor) => {
+        switch (value.type) {
+          case "header":
+            return visitor.header(value);
+          default:
+            return visitor._other(value);
+        }
+      }
+    };
+  }
+});
+
+// pnp:/home/runner/work/fern/fern/packages/ir-sdk/lib/sdk/api/resources/ir/types/HeaderApiVersionScheme.js
+var init_HeaderApiVersionScheme = __esm({
+  "pnp:/home/runner/work/fern/fern/packages/ir-sdk/lib/sdk/api/resources/ir/types/HeaderApiVersionScheme.js"() {
+  }
+});
+
 // pnp:/home/runner/work/fern/fern/packages/ir-sdk/lib/sdk/api/resources/ir/types/ErrorDiscriminationStrategy.js
 var ErrorDiscriminationStrategy;
 var init_ErrorDiscriminationStrategy = __esm({
@@ -355266,6 +355299,8 @@ var init_types8 = __esm({
     init_ReadmeConfig();
     init_SdkConfig();
     init_PlatformHeaders();
+    init_ApiVersionScheme();
+    init_HeaderApiVersionScheme();
     init_ErrorDiscriminationStrategy();
     init_ErrorDiscriminationByPropertyStrategy();
     init_Package();
@@ -355278,6 +355313,7 @@ var init_types8 = __esm({
 // pnp:/home/runner/work/fern/fern/packages/ir-sdk/lib/sdk/api/resources/ir/index.js
 var ir_exports = {};
 __export(ir_exports, {
+  ApiVersionScheme: () => ApiVersionScheme,
   ErrorDiscriminationStrategy: () => ErrorDiscriminationStrategy
 });
 var init_ir = __esm({
@@ -356805,6 +356841,7 @@ var init_resources2 = __esm({
 // pnp:/home/runner/work/fern/fern/packages/ir-sdk/lib/sdk/api/index.js
 var api_exports7 = {};
 __export(api_exports7, {
+  ApiVersionScheme: () => ApiVersionScheme,
   AuthScheme: () => AuthScheme,
   AuthSchemesRequirement: () => AuthSchemesRequirement,
   AvailabilityStatus: () => AvailabilityStatus,
@@ -360327,6 +360364,7 @@ var init_IntermediateRepresentation2 = __esm({
   "pnp:/home/runner/work/fern/fern/packages/ir-sdk/lib/sdk/serialization/resources/ir/types/IntermediateRepresentation.js"() {
     init_core2();
     IntermediateRepresentation = schemas_exports4.objectWithoutOptionalProperties({
+      apiVersion: schemas_exports4.lazy(async () => (await Promise.resolve().then(() => (init_serialization2(), serialization_exports2))).ApiVersionScheme).optional(),
       apiName: schemas_exports4.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization2(), serialization_exports2))).Name),
       apiDisplayName: schemas_exports4.string().optional(),
       apiDocs: schemas_exports4.string().optional(),
@@ -360396,6 +360434,40 @@ var init_PlatformHeaders2 = __esm({
   }
 });
 
+// pnp:/home/runner/work/fern/fern/packages/ir-sdk/lib/sdk/serialization/resources/ir/types/ApiVersionScheme.js
+var ApiVersionScheme2;
+var init_ApiVersionScheme2 = __esm({
+  "pnp:/home/runner/work/fern/fern/packages/ir-sdk/lib/sdk/serialization/resources/ir/types/ApiVersionScheme.js"() {
+    init_api();
+    init_core2();
+    ApiVersionScheme2 = schemas_exports4.union("type", {
+      header: schemas_exports4.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization2(), serialization_exports2))).HeaderApiVersionScheme)
+    }).transform({
+      transform: (value) => {
+        switch (value.type) {
+          case "header":
+            return ApiVersionScheme.header(value);
+          default:
+            return value;
+        }
+      },
+      untransform: ({ _visit, ...value }) => value
+    });
+  }
+});
+
+// pnp:/home/runner/work/fern/fern/packages/ir-sdk/lib/sdk/serialization/resources/ir/types/HeaderApiVersionScheme.js
+var HeaderApiVersionScheme;
+var init_HeaderApiVersionScheme2 = __esm({
+  "pnp:/home/runner/work/fern/fern/packages/ir-sdk/lib/sdk/serialization/resources/ir/types/HeaderApiVersionScheme.js"() {
+    init_core2();
+    HeaderApiVersionScheme = schemas_exports4.objectWithoutOptionalProperties({
+      header: schemas_exports4.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization2(), serialization_exports2))).HttpHeader),
+      value: schemas_exports4.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization2(), serialization_exports2))).EnumTypeDeclaration)
+    });
+  }
+});
+
 // pnp:/home/runner/work/fern/fern/packages/ir-sdk/lib/sdk/serialization/resources/ir/types/ErrorDiscriminationStrategy.js
 var ErrorDiscriminationStrategy2;
 var init_ErrorDiscriminationStrategy2 = __esm({
@@ -360493,6 +360565,8 @@ var init_types20 = __esm({
     init_ReadmeConfig2();
     init_SdkConfig2();
     init_PlatformHeaders2();
+    init_ApiVersionScheme2();
+    init_HeaderApiVersionScheme2();
     init_ErrorDiscriminationStrategy2();
     init_ErrorDiscriminationByPropertyStrategy2();
     init_Package2();
@@ -360505,8 +360579,10 @@ var init_types20 = __esm({
 // pnp:/home/runner/work/fern/fern/packages/ir-sdk/lib/sdk/serialization/resources/ir/index.js
 var ir_exports2 = {};
 __export(ir_exports2, {
+  ApiVersionScheme: () => ApiVersionScheme2,
   ErrorDiscriminationByPropertyStrategy: () => ErrorDiscriminationByPropertyStrategy,
   ErrorDiscriminationStrategy: () => ErrorDiscriminationStrategy2,
+  HeaderApiVersionScheme: () => HeaderApiVersionScheme,
   IntermediateRepresentation: () => IntermediateRepresentation,
   Package: () => Package,
   PackageNavigationConfig: () => PackageNavigationConfig,
@@ -360657,6 +360733,7 @@ var init_EnumTypeDeclaration2 = __esm({
   "pnp:/home/runner/work/fern/fern/packages/ir-sdk/lib/sdk/serialization/resources/types/types/EnumTypeDeclaration.js"() {
     init_core2();
     EnumTypeDeclaration = schemas_exports4.objectWithoutOptionalProperties({
+      default: schemas_exports4.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization2(), serialization_exports2))).EnumValue).optional(),
       values: schemas_exports4.list(schemas_exports4.lazyObject(async () => (await Promise.resolve().then(() => (init_serialization2(), serialization_exports2))).EnumValue))
     });
   }
@@ -361985,6 +362062,7 @@ var serialization_exports2 = {};
 __export(serialization_exports2, {
   AliasTypeDeclaration: () => AliasTypeDeclaration,
   ApiAuth: () => ApiAuth,
+  ApiVersionScheme: () => ApiVersionScheme2,
   AuthScheme: () => AuthScheme2,
   AuthSchemesRequirement: () => AuthSchemesRequirement2,
   AutogeneratedEndpointExample: () => AutogeneratedEndpointExample,
@@ -362066,6 +362144,7 @@ __export(serialization_exports2, {
   FilePropertySingle: () => FilePropertySingle,
   FileUploadRequest: () => FileUploadRequest,
   FileUploadRequestProperty: () => FileUploadRequestProperty2,
+  HeaderApiVersionScheme: () => HeaderApiVersionScheme,
   HeaderAuthScheme: () => HeaderAuthScheme,
   HttpEndpoint: () => HttpEndpoint,
   HttpHeader: () => HttpHeader,
@@ -372274,6 +372353,7 @@ var init_OpenApiIntermediateRepresentation2 = __esm({
   "pnp:/home/runner/work/fern/fern/packages/cli/openapi-ir-sdk/lib/sdk/serialization/resources/finalIr/types/OpenApiIntermediateRepresentation.js"() {
     init_core3();
     OpenApiIntermediateRepresentation = schemas_exports5.objectWithoutOptionalProperties({
+      apiVersion: schemas_exports5.unknown().optional(),
       title: schemas_exports5.string().optional(),
       description: schemas_exports5.string().optional(),
       basePath: schemas_exports5.string().optional(),
@@ -1122319,7 +1122399,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "0.31.25-rc0",
+          version: "0.32.0",
           usingAccessToken: true
         }
       });
@@ -1122381,7 +1122461,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "0.31.25-rc0",
+        version: "0.32.0",
         ...event,
         ...event.properties
       }
@@ -1124913,6 +1124993,7 @@ async function visitTypeDeclaration({ typeName, declaration, visitor, nodePathFo
         },
         availability: noop,
         audiences: noop,
+        default: noop,
         examples: visitExamples
       });
     }
@@ -1125148,6 +1125229,7 @@ async function visitRootApiFileYamlAst(contents, visitor) {
   var _a5;
   await ((_a5 = visitor.file) == null ? void 0 : _a5.call(visitor, contents, []));
   await visitObject(contents, {
+    version: noop,
     name: noop,
     "display-name": noop,
     imports: noop,
@@ -1134469,7 +1134551,7 @@ function parseImagePaths(markdown, metadata) {
   return { filepaths: [...filepaths], markdown: import_gray_matter.default.stringify(replacedContent, data2) };
 }
 function resolvePath(pathToImage, { absolutePathToFernFolder, absolutePathToMdx }) {
-  if (pathToImage == null || isExternalUrl(pathToImage)) {
+  if (pathToImage == null || isExternalUrl(pathToImage) || isDataUrl(pathToImage)) {
     return void 0;
   }
   const filepath = resolve(pathToImage.startsWith("/") ? absolutePathToFernFolder : dirname(absolutePathToMdx), RelativeFilePath.of(pathToImage.replace(/^\//, "")));
@@ -1134478,6 +1134560,9 @@ function resolvePath(pathToImage, { absolutePathToFernFolder, absolutePathToMdx
 function isExternalUrl(url) {
   return /^(https?:)?\/\//.test(url);
 }
+function isDataUrl(url) {
+  return url.startsWith("data:");
+}
 function replaceImagePathsAndUrls(markdown, fileIdsMap, markdownFilesToPathName, metadata, context) {
   const { content: content5, data: data2 } = (0, import_gray_matter.default)(markdown);
   let replacedContent = content5;
@@ -1134494,7 +1134579,7 @@ function replaceImagePathsAndUrls(markdown, fileIdsMap, markdownFilesToPathName,
     const original = replacedContent.slice(start4 + offset2, start4 + offset2 + length);
     let replaced = original;
     function replaceSrc(src) {
-      if (src != null && !isExternalUrl(src)) {
+      if (src != null && !isExternalUrl(src) && !isDataUrl(src)) {
         try {
           const fileId = fileIdsMap.get(AbsoluteFilePath.of(src));
           if (fileId != null) {
@@ -1135036,6 +1135121,9 @@ __export(schemas_exports3, {
   UndiscriminatedUnionSchema: () => UndiscriminatedUnionSchema,
   ValidationSchema: () => ValidationSchema,
   VariableDeclarationSchema: () => VariableDeclarationSchema,
+  VersionDeclarationHeaderObjectSchema: () => VersionDeclarationHeaderObjectSchema,
+  VersionDeclarationHeaderSchema: () => VersionDeclarationHeaderSchema,
+  VersionDeclarationSchema: () => VersionDeclarationSchema,
   WebSocketChannelInlinedMessageSchema: () => WebSocketChannelInlinedMessageSchema,
   WebSocketChannelMessageBodySchema: () => WebSocketChannelMessageBodySchema,
   WebSocketChannelMessageSchema: () => WebSocketChannelMessageSchema,
@@ -1135298,6 +1135386,7 @@ var EnumValueSchema = WithNameAndDocsSchema.extend({
 
 // pnp:/home/runner/work/fern/fern/packages/cli/yaml/yaml-schema/lib/schemas/EnumSchema.js
 var EnumSchema = BaseTypeDeclarationSchema.extend({
+  default: z.string().optional(),
   enum: z.array(z.union([z.string(), EnumValueSchema]))
 });
 
@@ -1135682,6 +1135771,23 @@ var PackageMarkerFileSchema = DefinitionFileSchema.extend({
 // pnp:/home/runner/work/fern/fern/packages/cli/yaml/yaml-schema/lib/schemas/VariableDeclarationSchema.js
 var VariableDeclarationSchema = TypeReferenceWithDocsSchema;
 
+// pnp:/home/runner/work/fern/fern/packages/cli/yaml/yaml-schema/lib/schemas/VersionDeclarationHeaderObjectSchema.js
+var VersionDeclarationHeaderObjectSchema = z.strictObject({
+  name: z.string().optional().describe("The name of the parameter used to represent the header"),
+  env: z.string().optional().describe("The environment variable to read the header value from (if any)"),
+  value: z.string().describe("The wire representation of the header (e.g. X-API-Version)")
+});
+
+// pnp:/home/runner/work/fern/fern/packages/cli/yaml/yaml-schema/lib/schemas/VersionDeclarationHeaderSchema.js
+var VersionDeclarationHeaderSchema = z.union([z.string(), VersionDeclarationHeaderObjectSchema]);
+
+// pnp:/home/runner/work/fern/fern/packages/cli/yaml/yaml-schema/lib/schemas/VersionDeclarationSchema.js
+var VersionDeclarationSchema = z.strictObject({
+  header: z.union([z.string(), VersionDeclarationHeaderSchema]),
+  default: z.string().optional(),
+  values: z.array(z.union([z.string(), EnumValueSchema]))
+});
+
 // pnp:/home/runner/work/fern/fern/packages/cli/yaml/yaml-schema/lib/schemas/file-schemas/RootApiFileSchema.js
 var RootApiFileSchema = z.strictObject({
   name: z.string(),
@@ -1135697,10 +1135803,11 @@ var RootApiFileSchema = z.strictObject({
   docs: z.optional(z.string()),
   errors: z.optional(z.array(z.string())),
   "base-path": z.optional(z.string()),
-  ["path-parameters"]: z.optional(z.record(HttpPathParameterSchema)),
+  "path-parameters": z.optional(z.record(HttpPathParameterSchema)),
   "idempotency-headers": z.optional(z.record(z.string(), HttpHeaderSchema)),
   variables: z.optional(z.record(VariableDeclarationSchema)),
-  pagination: z.optional(PaginationSchema)
+  pagination: z.optional(PaginationSchema),
+  version: z.optional(VersionDeclarationSchema)
 });
 
 // pnp:/home/runner/work/fern/fern/packages/cli/yaml/yaml-schema/lib/utils/getRequestBody.js
@@ -1137524,7 +1137631,8 @@ var FernOpenAPIExtension = {
   FERN_IDEMPOTENCY_HEADERS: "x-fern-idempotency-headers",
   IDEMPOTENT: "x-fern-idempotent",
   FERN_PROPERTY_NAME: "x-fern-property-name",
-  IS_UNDISCRIMINATED: "x-fern-undiscriminated"
+  IS_UNDISCRIMINATED: "x-fern-undiscriminated",
+  FERN_VERSION: "x-fern-version"
 };
 
 // pnp:/home/runner/work/fern/fern/packages/cli/openapi-parser/lib/openapi/v3/extensions/getFernEnum.js
@@ -1142076,6 +1142184,48 @@ var RedoclyCodeSampleSchema = z.object({
 });
 var RedoclyCodeSampleArraySchema = z.array(RedoclyCodeSampleSchema);
 
+// pnp:/home/runner/work/fern/fern/packages/cli/openapi-parser/lib/openapi/v3/extensions/readmeExtensions.js
+var ReadmeOpenAPIExtension = {
+  README_EXT: "x-readme"
+};
+
+// pnp:/home/runner/work/fern/fern/packages/cli/openapi-parser/lib/openapi/v3/extensions/getReadmeCodeSamples.js
+function isReadMeCodeSamples(maybeCodeSamples) {
+  if (!Array.isArray(maybeCodeSamples)) {
+    return false;
+  }
+  for (const maybeCodeSample of maybeCodeSamples) {
+    if (!isPlainObject(maybeCodeSample)) {
+      return false;
+    }
+    if (typeof maybeCodeSample.language !== "string" || typeof maybeCodeSample.code !== "string") {
+      return false;
+    }
+  }
+  return true;
+}
+function getRawReadmeCodeSamples(operationObject) {
+  const readme = getExtension(operationObject, ReadmeOpenAPIExtension.README_EXT);
+  if (!isPlainObject(readme)) {
+    return [];
+  }
+  const readmeCodeSamples = readme["code-samples"];
+  if (!isReadMeCodeSamples(readmeCodeSamples)) {
+    return [];
+  }
+  const customCodeSamples = [];
+  for (const codeSample of readmeCodeSamples) {
+    customCodeSamples.push({
+      name: codeSample.name,
+      language: codeSample.language,
+      code: codeSample.code,
+      install: codeSample.install,
+      docs: void 0
+    });
+  }
+  return customCodeSamples;
+}
+
 // pnp:/home/runner/work/fern/fern/packages/cli/openapi-parser/lib/openapi/v3/extensions/getExamplesFromExtension.js
 function getExamplesFromExtension(operationContext, operationObject, context) {
   const exampleEndpointCalls = getExtensionAndValidate(operationObject, FernOpenAPIExtension.EXAMPLES, schemas_exports3.ExampleEndpointCallArraySchema, context, [...operationContext.baseBreadcrumbs, `${operationContext.method} ${operationContext.path}`]) ?? [];
@@ -1142096,6 +1142246,12 @@ function getExamplesFromExtension(operationContext, operationObject, context) {
       }))
     });
   }
+  const readmeCodeSamples = getRawReadmeCodeSamples(operationObject);
+  if (readmeCodeSamples.length > 0) {
+    exampleEndpointCalls.push({
+      "code-samples": readmeCodeSamples
+    });
+  }
   return exampleEndpointCalls.map(EndpointExample.unknown);
 }
 
@@ -1142690,7 +1142846,7 @@ function convertHttpOperation({ operationContext, context, responseStatusCode, s
     responseStatusCode
   });
   const availability = getFernAvailability(operation);
-  const examples = [...getExamplesFromExtension(operationContext, operation, context)];
+  const examples = getExamplesFromExtension(operationContext, operation, context);
   return {
     summary: operation.summary,
     internal: getExtension(operation, OpenAPIExtension.INTERNAL),
@@ -1143296,6 +1143452,11 @@ function getFernGroups({ document: document6, context }) {
   return getExtensionAndValidate(document6, FernOpenAPIExtension.GROUPS, XFernGroupsSchema, context);
 }
 
+// pnp:/home/runner/work/fern/fern/packages/cli/openapi-parser/lib/openapi/v3/extensions/getFernVersion.js
+function getFernVersion({ context, document: document6 }) {
+  return getExtensionAndValidate(document6, FernOpenAPIExtension.FERN_VERSION, schemas_exports3.VersionDeclarationSchema, context) ?? void 0;
+}
+
 // pnp:/home/runner/work/fern/fern/packages/cli/openapi-parser/lib/openapi/v3/extensions/getGlobalHeaders.js
 function getGlobalHeaders(document6) {
   const globalHeaders = getExtension(document6, FernOpenAPIExtension.FERN_GLOBAL_HEADERS);
@@ -1143708,6 +1143869,10 @@ function generateIr({ openApi, taskContext, options: options2 }) {
   });
   const groupInfo = getFernGroups({ document: openApi, context });
   const ir = {
+    apiVersion: getFernVersion({
+      context,
+      document: openApi
+    }),
     basePath: getFernBasePath(openApi),
     title: openApi.info.title,
     description: openApi.info.description,
@@ -1143876,6 +1144041,7 @@ var DEFAULT_PARSE_OPENAPI_SETTINGS = {
 // pnp:/home/runner/work/fern/fern/packages/cli/openapi-parser/lib/parse.js
 async function parse4({ specs, taskContext, optionOverrides }) {
   let ir = {
+    apiVersion: void 0,
     title: void 0,
     description: void 0,
     basePath: void 0,
@@ -1143958,6 +1144124,7 @@ function getParseOptions({ specSettings, overrides }) {
 }
 function merge3(ir1, ir2) {
   return {
+    apiVersion: ir1.apiVersion ?? ir2.apiVersion,
     title: ir1.title ?? ir2.title,
     description: ir1.description ?? ir2.description,
     basePath: ir1.basePath ?? ir2.basePath,
@@ -1145597,6 +1145764,9 @@ function getDeclarationFileFromGroupName(groupName) {
 var EXTERNAL_AUDIENCE = "external";
 var ERROR_DECLARATIONS_FILENAME = RelativeFilePath.of(FERN_PACKAGE_MARKER_FILENAME);
 function buildFernDefinition(context) {
+  if (context.ir.apiVersion != null) {
+    context.builder.setApiVersion(context.ir.apiVersion);
+  }
   buildEnvironments(context);
   buildGlobalHeaders(context);
   buildIdempotencyHeaders(context);
@@ -1145708,6 +1145878,9 @@ var FernDefinitionBuilderImpl = class {
   setBasePath(basePath) {
     this.basePath = basePath;
   }
+  setApiVersion(apiVersionScheme) {
+    this.rootApiFile.version = apiVersionScheme;
+  }
   getEnvironmentType() {
     const environmentEntry = Object.entries(this.rootApiFile.environments ?? {})[0];
     if (environmentEntry == null) {
@@ -1149999,10 +1150172,10 @@ var CliContext = class {
     return "fern-api";
   }
   getPackageVersion() {
-    if ("0.31.25-rc0" == null) {
+    if ("0.32.0" == null) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "0.31.25-rc0";
+    return "0.32.0";
   }
   getCliName() {
     if ("fern" == null) {
@@ -1152377,20 +1152550,29 @@ function areLiteralTypesEquivalent({ expected, actual }) {
 
 // pnp:/home/runner/work/fern/fern/packages/cli/generation/ir-generator/lib/converters/type-declarations/convertEnumTypeDeclaration.js
 async function convertEnumTypeDeclaration({ _enum, file }) {
-  return Type2.enum({
-    values: await Promise.all(_enum.enum.map(async (value) => {
-      return {
-        ...await convertDeclaration(value),
-        name: file.casingsGenerator.generateNameAndWireValue({
-          wireValue: typeof value === "string" ? value : value.value,
-          name: getEnumName(value).name,
-          opts: {
-            casingOverrides: typeof value !== "string" ? value.casing : void 0
-          }
-        })
-      };
-    }))
-  });
+  const values3 = await Promise.all(_enum.enum.map(async (value) => {
+    return {
+      ...await convertDeclaration(value),
+      name: file.casingsGenerator.generateNameAndWireValue({
+        wireValue: typeof value === "string" ? value : value.value,
+        name: getEnumName(value).name,
+        opts: {
+          casingOverrides: typeof value !== "string" ? value.casing : void 0
+        }
+      })
+    };
+  }));
+  let defaultValue;
+  if (_enum.default != null) {
+    defaultValue = values3.find((enumValue) => enumValue.name.wireValue === _enum.default);
+    if (defaultValue == null) {
+      throw new Error(`Default value ${_enum.default} not found in enum values`);
+    }
+  }
+  return {
+    default: defaultValue,
+    values: values3
+  };
 }
 function getEnumNameFromEnumValue(enumValue, _enum) {
   const maybeEnumDefintion = _enum.enum.find((value) => typeof value === "string" ? false : value.value === enumValue);
@@ -1154054,6 +1154236,52 @@ async function generateOAuth({ file, docs, rawScheme, propertyResolver, endpoint
   }
 }
 
+// pnp:/home/runner/work/fern/fern/packages/cli/generation/ir-generator/lib/converters/convertApiVersionScheme.js
+async function convertApiVersionScheme({ file, rawApiFileSchema }) {
+  if (rawApiFileSchema.version == null) {
+    return void 0;
+  }
+  return ApiVersionScheme.header({
+    header: await convertHeader({
+      file,
+      header: rawApiFileSchema.version.header
+    }),
+    value: await convertEnum2({
+      file,
+      versionDeclaration: rawApiFileSchema.version
+    })
+  });
+}
+async function convertHeader({ file, header }) {
+  if (typeof header === "string") {
+    return await convertHttpHeader({
+      file,
+      headerKey: header,
+      header: {
+        type: "string"
+      }
+    });
+  }
+  return await convertHttpHeader({
+    file,
+    headerKey: header.value,
+    header: {
+      type: "string",
+      name: header.name,
+      env: header.env
+    }
+  });
+}
+async function convertEnum2({ file, versionDeclaration }) {
+  return await convertEnumTypeDeclaration({
+    _enum: {
+      default: versionDeclaration.default,
+      enum: versionDeclaration.values
+    },
+    file
+  });
+}
+
 // pnp:/home/runner/work/fern/fern/packages/cli/generation/ir-generator/lib/converters/convertChannel.js
 async function convertChannel({ channel, typeResolver, exampleResolver, variableResolver, file, workspace }) {
   const messages2 = [];
@@ -1154836,7 +1155064,7 @@ async function convertType({ typeDeclaration, file, typeResolver }) {
     object: (object4) => convertObjectTypeDeclaration({ object: object4, file }),
     discriminatedUnion: (union5) => convertDiscriminatedUnionTypeDeclaration({ union: union5, file, typeResolver }),
     undiscriminatedUnion: (union5) => convertUndiscriminatedUnionTypeDeclaration({ union: union5, file }),
-    enum: (enum_4) => convertEnumTypeDeclaration({ _enum: enum_4, file })
+    enum: async (enum_4) => Type2.enum(await convertEnumTypeDeclaration({ _enum: enum_4, file }))
   });
 }
 
@@ -1157113,6 +1157341,10 @@ async function generateIntermediateRepresentation({ workspace, generationLanguag
   const exampleResolver = new ExampleResolverImpl(typeResolver);
   const variableResolver = new VariableResolverImpl();
   const intermediateRepresentation = {
+    apiVersion: await convertApiVersionScheme({
+      file: rootApiFileContext,
+      rawApiFileSchema: workspace.definition.rootApiFile.contents
+    }),
     apiName: casingsGenerator.generateName(workspace.definition.rootApiFile.contents.name),
     apiDisplayName: workspace.definition.rootApiFile.contents["display-name"],
     apiDocs: await formatDocs(workspace.definition.rootApiFile.contents.docs),
@@ -1191116,6 +1191348,38 @@ function isRawStringValidation(validation) {
   return maybeStringValidation2.minLength != null || maybeStringValidation2.maxLength != null || maybeStringValidation2.pattern != null || maybeStringValidation2.format != null;
 }
 
+// pnp:/home/runner/work/fern/fern/packages/cli/yaml/validator/lib/rules/valid-version/valid-version.js
+var ValidVersionRule = {
+  name: "valid-version",
+  create: ({ workspace }) => {
+    const typeResolver = new TypeResolverImpl(workspace);
+    return {
+      rootApiFile: {
+        file: (root4) => {
+          return validateApiVersionSchema({
+            root: root4,
+            typeResolver
+          });
+        }
+      }
+    };
+  }
+};
+function validateApiVersionSchema({ root: root4, typeResolver }) {
+  const violations = [];
+  if (root4.version == null || root4.version.default == null) {
+    return [];
+  }
+  const enumValues = new Set(root4.version.values.map((enumValue) => typeof enumValue === "string" ? enumValue : enumValue.value));
+  if (!enumValues.has(root4.version.default)) {
+    violations.push({
+      severity: "error",
+      message: `Default version "${root4.version.default}" not found in version values`
+    });
+  }
+  return violations;
+}
+
 // pnp:/home/runner/work/fern/fern/packages/cli/yaml/validator/lib/getAllRules.js
 function getAllRules2() {
   return [
@@ -1191157,7 +1191421,8 @@ function getAllRules2() {
     ValidPaginationRule,
     ValidExampleErrorRule,
     ValidTypeReferenceWithDefaultAndValidationRule,
-    ValidStreamConditionRule
+    ValidStreamConditionRule,
+    ValidVersionRule
   ];
 }
 function getAllEnabledRules() {
@@ -1191817,11 +1192082,11 @@ function convertAuth3(auth) {
       if (scheme._type !== "header") {
         return scheme;
       }
-      return IrVersions_exports.V13.auth.AuthScheme.header(convertHeader(scheme));
+      return IrVersions_exports.V13.auth.AuthScheme.header(convertHeader2(scheme));
     })
   };
 }
-function convertHeader(header) {
+function convertHeader2(header) {
   return {
     docs: header.docs,
     prefix: header.prefix,
@@ -1192144,11 +1192409,11 @@ function convertAuth4(auth) {
       if (scheme._type !== "header") {
         return scheme;
       }
-      return IrVersions_exports.V14.auth.AuthScheme.header(convertHeader2(scheme));
+      return IrVersions_exports.V14.auth.AuthScheme.header(convertHeader3(scheme));
     })
   };
 }
-function convertHeader2(header) {
+function convertHeader3(header) {
   return {
     docs: header.docs,
     prefix: header.prefix,
@@ -1193107,7 +1193372,7 @@ var V23_TO_V22_MIGRATION = {
       v22Services[serviceId] = {
         ...service,
         endpoints: v22Endpoints,
-        headers: service.headers.map((header) => convertHeader3(header)),
+        headers: service.headers.map((header) => convertHeader4(header)),
         pathParameters: service.pathParameters.map((pathParameter) => convertPathParameter5(pathParameter))
       };
     }
@@ -1193125,7 +1193390,7 @@ var V23_TO_V22_MIGRATION = {
         ...v23.auth,
         schemes: v23.auth.schemes.map((scheme) => convertAuthScheme2(scheme))
       },
-      headers: v23.headers.map((header) => convertHeader3(header)),
+      headers: v23.headers.map((header) => convertHeader4(header)),
       types: mapValues_default2(v23.types, (type2) => convertType2(type2)),
       services: v22Services,
       errors: mapValues_default2(v23.errors, (error) => convertError(error)),
@@ -1193145,7 +1193410,7 @@ function convertEndpoint8(endpoint) {
   }
   return {
     ...endpoint,
-    headers: endpoint.headers.map((header) => convertHeader3(header)),
+    headers: endpoint.headers.map((header) => convertHeader4(header)),
     pathParameters: endpoint.pathParameters.map((pathParameter) => convertPathParameter5(pathParameter)),
     allPathParameters: endpoint.allPathParameters.map((pathParameter) => convertPathParameter5(pathParameter)),
     queryParameters: endpoint.queryParameters.map((queryParameter) => convertQueryParameter4(queryParameter)),
@@ -1193181,7 +1193446,7 @@ function convertRequestBody4(requestBody) {
       assertNever(requestBody);
   }
 }
-function convertHeader3(header) {
+function convertHeader4(header) {
   return {
     ...header,
     valueType: convertTypeReference4(header.valueType)
@@ -1193785,7 +1194050,7 @@ var V26_TO_V25_MIGRATION = {
       types: Object.fromEntries(Object.entries(v26.types).map(([key2, val]) => {
         return [key2, convertTypeDeclaration3(val)];
       })),
-      headers: v26.headers.map((header) => convertHeader4(header)),
+      headers: v26.headers.map((header) => convertHeader5(header)),
       webhookGroups: Object.fromEntries(Object.entries(v26.webhookGroups).map(([key2, val]) => {
         return [key2, val.map((webhook) => convertWebhook(webhook))];
       })),
@@ -1193798,7 +1194063,7 @@ var V26_TO_V25_MIGRATION = {
 function convertWebhook(val) {
   return {
     ...val,
-    headers: val.headers.map((header) => convertHeader4(header)),
+    headers: val.headers.map((header) => convertHeader5(header)),
     availability: val.availability == null ? {
       status: IrVersions_exports.V25.AvailabilityStatus.GeneralAvailability,
       message: void 0
@@ -1193809,7 +1194074,7 @@ function convertHttpService4(val) {
   return {
     ...val,
     endpoints: val.endpoints.map((endpoint) => convertEndpoint9(endpoint)),
-    headers: val.headers.map((header) => convertHeader4(header)),
+    headers: val.headers.map((header) => convertHeader5(header)),
     availability: val.availability == null ? {
       status: IrVersions_exports.V25.AvailabilityStatus.GeneralAvailability,
       message: void 0
@@ -1193819,7 +1194084,7 @@ function convertHttpService4(val) {
 function convertEndpoint9(val) {
   return {
     ...val,
-    headers: val.headers.map((header) => convertHeader4(header)),
+    headers: val.headers.map((header) => convertHeader5(header)),
     queryParameters: val.queryParameters.map((query) => convertQueryParameter5(query)),
     availability: val.availability == null ? {
       status: IrVersions_exports.V25.AvailabilityStatus.GeneralAvailability,
@@ -1193827,7 +1194092,7 @@ function convertEndpoint9(val) {
     } : val.availability
   };
 }
-function convertHeader4(val) {
+function convertHeader5(val) {
   return {
     ...val,
     availability: val.availability == null ? {
@@ -1196813,14 +1197078,14 @@ function convertAuth6(auth) {
         case "bearer":
           return IrVersions_exports.V44.auth.AuthScheme.bearer(scheme);
         case "header":
-          return IrVersions_exports.V44.auth.AuthScheme.header(convertHeader5(scheme));
+          return IrVersions_exports.V44.auth.AuthScheme.header(convertHeader6(scheme));
         case "oauth":
           return IrVersions_exports.V44.auth.AuthScheme.oauth(convertOAuth(scheme));
       }
     })
   };
 }
-function convertHeader5(header) {
+function convertHeader6(header) {
   return {
     ...header,
     valueType: convertTypeReference5(header.valueType)
@@ -1197799,7 +1198064,7 @@ function convertTypeReference6(typeReference) {
 }
 
 // pnp:/home/runner/work/fern/fern/packages/cli/generation/ir-migrations/lib/migrations/v5-to-v4/convertHeader.js
-function convertHeader6(header) {
+function convertHeader7(header) {
   return {
     name: convertNameAndWireValueToV1(header.name),
     nameV2: convertNameAndWireValueToV2(header.name),
@@ -1197821,7 +1198086,7 @@ function convertAuthScheme6(scheme) {
   return IrVersions_exports.V5.auth.AuthScheme._visit(scheme, {
     basic: IrVersions_exports.V4.auth.AuthScheme.basic,
     bearer: IrVersions_exports.V4.auth.AuthScheme.bearer,
-    header: (header) => IrVersions_exports.V4.auth.AuthScheme.header(convertHeader6(header)),
+    header: (header) => IrVersions_exports.V4.auth.AuthScheme.header(convertHeader7(header)),
     _unknown: () => {
       throw new Error("Unknown AuthScheme: " + scheme._type);
     }
@@ -1197961,7 +1198226,7 @@ function convertService7({ service, errorResolver }) {
     basePath: convertBasePathToString(service.basePath),
     basePathV2: service.basePath,
     endpoints: service.endpoints.map((endpoint) => convertEndpoint12({ endpoint, errorResolver })),
-    headers: service.headers.map((header) => convertHeader6(header)),
+    headers: service.headers.map((header) => convertHeader7(header)),
     pathParameters: service.pathParameters.map((pathParameter) => convertPathParameter8(pathParameter))
   };
 }
@@ -1197984,7 +1198249,7 @@ function convertEndpoint12({ endpoint, errorResolver }) {
     nameV2: convertNameToV2(endpoint.name),
     displayName: endpoint.displayName,
     method: endpoint.method,
-    headers: endpoint.headers.map((header) => convertHeader6(header)),
+    headers: endpoint.headers.map((header) => convertHeader7(header)),
     path: endpoint.path,
     pathParameters: endpoint.pathParameters.map((pathParameter) => convertPathParameter8(pathParameter)),
     queryParameters: endpoint.queryParameters.map((queryParameter) => convertQueryParameter8(queryParameter)),
@@ -1198401,7 +1198666,7 @@ var V5_TO_V4_MIGRATION = {
       apiDisplayName: v52.apiDisplayName,
       apiDocs: v52.apiDocs,
       auth: convertAuth7(v52.auth),
-      headers: v52.headers.map((header) => convertHeader6(header)),
+      headers: v52.headers.map((header) => convertHeader7(header)),
       types: v52.types.map((typeDeclaration) => convertTypeDeclaration5(typeDeclaration)),
       services: {
         http: v52.services.map((service) => convertService7({ service, errorResolver })),
@@ -1198664,14 +1198929,14 @@ function convertAuth8(auth) {
         case "bearer":
           return IrVersions_exports.V49.auth.AuthScheme.bearer(scheme);
         case "header":
-          return IrVersions_exports.V49.auth.AuthScheme.header(convertHeader7(scheme));
+          return IrVersions_exports.V49.auth.AuthScheme.header(convertHeader8(scheme));
         case "oauth":
           return IrVersions_exports.V49.auth.AuthScheme.oauth(convertOAuth2(scheme));
       }
     })
   };
 }
-function convertHeader7(header) {
+function convertHeader8(header) {
   return {
     ...header,
     valueType: convertTypeReference7(header.valueType)
@@ -1199225,7 +1199490,7 @@ var V8_TO_V7_MIGRATION = {
     return {
       ...v8,
       auth: convertAuth9(v8.auth),
-      headers: v8.headers.map((header) => convertHeader8(header)),
+      headers: v8.headers.map((header) => convertHeader9(header)),
       types: v8.types.map((type2) => convertTypeDeclaration6(type2)),
       errors: v8.errors.map((error) => convertErrorDeclaration8(error)),
       services: v8.services.map((service) => convertHttpService9(service))
@@ -1199243,11 +1199508,11 @@ function convertAuth9(auth) {
       if (scheme._type !== "header") {
         return scheme;
       }
-      return IrVersions_exports.V7.auth.AuthScheme.header(convertHeader8(scheme));
+      return IrVersions_exports.V7.auth.AuthScheme.header(convertHeader9(scheme));
     })
   };
 }
-function convertHeader8(header) {
+function convertHeader9(header) {
   return {
     docs: header.docs,
     availability: header.availability,
@@ -1199459,7 +1199724,7 @@ function convertHttpService9(service) {
     basePath: service.basePath,
     baseUrl: service.baseUrl,
     pathParameters: service.pathParameters.map((pathParameter) => convertPathParameter10(pathParameter)),
-    headers: service.headers.map((header) => convertHeader8(header)),
+    headers: service.headers.map((header) => convertHeader9(header)),
     endpoints: service.endpoints.map((endpoint) => convertEndpoint14(endpoint))
   };
 }
@@ -1199485,7 +1199750,7 @@ function convertEndpoint14(endpoint) {
     sdkRequest: endpoint.sdkRequest != null ? convertSdkRequest7(endpoint.sdkRequest) : void 0,
     requestBody: endpoint.requestBody != null ? convertRequestBody8(endpoint.requestBody) : void 0,
     response: convertHttpResponse8(endpoint.response),
-    headers: endpoint.headers.map((header) => convertHeader8(header)),
+    headers: endpoint.headers.map((header) => convertHeader9(header)),
     queryParameters: endpoint.queryParameters.map((queryParameter) => convertQueryParameter10(queryParameter)),
     examples: endpoint.examples.map((example) => convertExampleEndpointCall9(example))
   };
@@ -1204668,7 +1204933,7 @@ async function loadAndUpdateGenerators({
     return void 0;
   }
   const contents = await (0, import_promises76.readFile)(filepath);
-  context.logger.info(`Found generators: ${contents.toString()}`);
+  context.logger.debug(`Found generators: ${contents.toString()}`);
   const parsedDocument = import_yaml10.default.parseDocument(contents.toString());
   const generatorGroups = parsedDocument.get("groups");
   if (generatorGroups == null) {
@@ -1204679,7 +1204944,7 @@ async function loadAndUpdateGenerators({
     context.failAndThrow(`Expected 'groups' to be a map in ${import_path42.default.relative(process.cwd(), filepath)}`);
     return void 0;
   }
-  context.logger.info(`Groups found: ${generatorGroups.toString()}`);
+  context.logger.debug(`Groups found: ${generatorGroups.toString()}`);
   for (const groupBlock of generatorGroups.items) {
     const groupName = groupBlock.key;
     const group = groupBlock.value;
@@ -1204699,7 +1204964,7 @@ async function loadAndUpdateGenerators({
       );
       continue;
     }
-    context.logger.info(`Generators found: ${generators.toString()}`);
+    context.logger.debug(`Generators found: ${generators.toString()}`);
     for (const generator of generators.items) {
       if (!import_yaml10.default.isMap(generator)) {
         context.failAndThrow(
@@ -1204713,7 +1204978,7 @@ async function loadAndUpdateGenerators({
       const normalizedGeneratorName = generators_yml_exports.getGeneratorNameOrThrow(generatorName, context);
       const currentVersion = generator.get("version");
       const latestVersion2 = await generators_yml_exports.getLatestGeneratorVersion(normalizedGeneratorName, context);
-      context.logger.info(`${generatorName}, ${currentVersion}, ${latestVersion2}`);
+      context.logger.debug(`${generatorName}, ${currentVersion}, ${latestVersion2}`);
       if (latestVersion2 == null) {
         continue;
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fern-api",
-  "version": "0.31.25-rc0",
+  "version": "0.32.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/fern-api/fern.git",