@fern-api/fern-api-dev 5.50.6 → 5.51.1

package/cli.cjs

@@ -81214,6 +81214,7 @@ var init_IntermediateRepresentation2 = __esm({
     IntermediateRepresentation = schemas_exports3.objectWithoutOptionalProperties({
       fdrApiDefinitionId: schemas_exports3.string().optional(),
       apiVersion: ApiVersionScheme2.optional(),
+      specVersion: schemas_exports3.string().optional(),
       apiName: NameOrString,
       apiDisplayName: schemas_exports3.string().optional(),
       apiDocs: schemas_exports3.string().optional(),
@@ -139019,6 +139020,7 @@ var init_OpenApiIntermediateRepresentation2 = __esm({
     init_WebsocketChannel2();
     OpenApiIntermediateRepresentation = schemas_exports9.objectWithoutOptionalProperties({
       apiVersion: schemas_exports9.unknown().optional(),
+      specVersion: schemas_exports9.string().optional(),
       title: schemas_exports9.string().optional(),
       description: schemas_exports9.string().optional(),
       basePath: schemas_exports9.string().optional(),
@@ -149711,7 +149713,8 @@ var init_FernDefinitionConverter = __esm({
             }
           },
           packageMarkers: {},
-          importedDefinitions: {}
+          importedDefinitions: {},
+          specVersion: ir3.specVersion ?? void 0
         };
       }
     };
@@ -166399,6 +166402,7 @@ function generateIr({ openApi, taskContext, options: options2, source: source2,
       context: context3,
       document: openApi
     }),
+    specVersion: openApi.info.version != null && openApi.info.version.length > 0 ? openApi.info.version : void 0,
     basePath: (() => {
       const parsed = getFernBasePath(openApi);
       return parsed?.basePath;
@@ -166633,6 +166637,7 @@ var init_generateIr = __esm({
 function parse8({ context: context3, documents, options: options2 }) {
   let ir3 = {
     apiVersion: void 0,
+    specVersion: void 0,
     title: void 0,
     description: void 0,
     basePath: void 0,
@@ -166849,6 +166854,7 @@ function merge6(ir1, ir22, options2) {
   if (!shouldGroupEnvironments) {
     return {
       apiVersion: ir1.apiVersion ?? ir22.apiVersion,
+      specVersion: ir1.specVersion ?? ir22.specVersion,
       title: ir1.title ?? ir22.title,
       description: ir1.description ?? ir22.description,
       basePath: ir1.basePath ?? ir22.basePath,
@@ -166980,6 +166986,7 @@ function merge6(ir1, ir22, options2) {
     mergedEndpoints = [...ir1EndpointsWithApiTag, ...ir2EndpointsWithApiTag];
     return {
       apiVersion: ir1.apiVersion ?? ir22.apiVersion,
+      specVersion: ir1.specVersion ?? ir22.specVersion,
       title: ir1.title ?? ir22.title,
       description: ir1.description ?? ir22.description,
       basePath: ir1.basePath ?? ir22.basePath,
@@ -167033,6 +167040,7 @@ function merge6(ir1, ir22, options2) {
   }
   return {
     apiVersion: ir1.apiVersion ?? ir22.apiVersion,
+    specVersion: ir1.specVersion ?? ir22.specVersion,
     title: ir1.title ?? ir22.title,
     description: ir1.description ?? ir22.description,
     basePath: ir1.basePath ?? ir22.basePath,
@@ -266375,6 +266383,7 @@ function mergeIntermediateRepresentation(ir1, ir22, casingsGenerator) {
     apiName: ir1.apiName,
     basePath: ir1.basePath,
     selfHosted: ir1.selfHosted && ir22.selfHosted,
+    specVersion: ir1.specVersion ?? ir22.specVersion,
     apiDisplayName: ir1.apiDisplayName ?? ir22.apiDisplayName,
     apiDocs: ir1.apiDocs ?? ir22.apiDocs,
     auth: {
@@ -275614,6 +275623,7 @@ function generateIntermediateRepresentation({ workspace, generationLanguage, key
       file: rootApiFileContext,
       rawApiFileSchema: workspace.definition.rootApiFile.contents
     }),
+    specVersion: workspace.definition.specVersion,
     apiName: casingsGenerator.generateName(workspace.definition.rootApiFile.contents.name),
     apiDisplayName: workspace.definition.rootApiFile.contents["display-name"],
     apiDocs: formatDocs(workspace.definition.rootApiFile.contents.docs),
@@ -341170,7 +341180,8 @@ var init_AbstractSpecConverter = __esm({
           audiences: void 0,
           generationMetadata: void 0,
           apiPlayground: void 0,
-          casingsConfig: void 0
+          casingsConfig: void 0,
+          specVersion: void 0
         };
       }
       removeXFernIgnores({ document: document4, breadcrumbs = [] }) {
@@ -562563,9 +562574,9 @@ var require_VersionUtils = __commonJS({
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.VersionBump = exports2.MAX_RAW_DIFF_BYTES = exports2.MAX_CHUNKS = exports2.MAX_AI_DIFF_BYTES = exports2.MAGIC_VERSION_PYTHON = exports2.MAGIC_VERSION = exports2.AUTO_VERSION = void 0;
     exports2.extractLanguageFromGeneratorName = extractLanguageFromGeneratorName2;
-    exports2.mapMagicVersionForLanguage = mapMagicVersionForLanguage2;
+    exports2.mapMagicVersionForLanguage = mapMagicVersionForLanguage3;
     exports2.maxVersionBump = maxVersionBump3;
-    exports2.isAutoVersion = isAutoVersion4;
+    exports2.isAutoVersion = isAutoVersion5;
     exports2.isValidSemver = isValidSemver;
     exports2.incrementVersion = incrementVersion;
     exports2.extractPreviousVersionFromDiffLine = extractPreviousVersionFromDiffLine;
@@ -562608,7 +562619,7 @@ var require_VersionUtils = __commonJS({
     exports2.AUTO_VERSION = "AUTO";
     exports2.MAGIC_VERSION = "0.0.0-fern-placeholder";
     exports2.MAGIC_VERSION_PYTHON = "0.0.0.dev0";
-    function mapMagicVersionForLanguage2(magicVersion, language) {
+    function mapMagicVersionForLanguage3(magicVersion, language) {
       if (magicVersion !== exports2.MAGIC_VERSION) {
         return magicVersion;
       }
@@ -562640,7 +562651,7 @@ var require_VersionUtils = __commonJS({
       return (VERSION_BUMP_RANK[a3] ?? 0) >= (VERSION_BUMP_RANK[b5] ?? 0) ? a3 : b5;
     }
     var SEMVER_PATTERN = /^(v)?(\d+)\.(\d+)\.(\d+)(?:-([\w.-]+))?(?:\+([\w.-]+))?$/;
-    function isAutoVersion4(version7) {
+    function isAutoVersion5(version7) {
       return exports2.AUTO_VERSION.toLowerCase() === version7.toLowerCase();
     }
     function isValidSemver(version7) {
@@ -686370,7 +686381,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.50.6",
+          version: "5.51.1",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -686436,7 +686447,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.50.6",
+        version: "5.51.1",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -867498,7 +867509,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 = "5.50.6";
+  const version7 = "5.51.1";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -899686,7 +899697,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.50.6",
+        cliVersion: "5.51.1",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -952518,7 +952529,8 @@ var LocalTaskHandler = class {
           autoVersioningVersionBumpReason: void 0
         };
       }
-      await autoVersioningService.replaceMagicVersion(this.absolutePathToLocalOutput, this.version, autoVersionResult.version);
+      const mappedMagicVersion = (0, import_autoversion2.mapMagicVersionForLanguage)(import_autoversion2.MAGIC_VERSION, this.generatorLanguage ?? "");
+      await autoVersioningService.replaceMagicVersion(this.absolutePathToLocalOutput, mappedMagicVersion, autoVersionResult.version);
       if (this.generatorLanguage === "go") {
         this.context.logger.info("Adding Go major version suffix to module paths");
         await autoVersioningService.addGoMajorVersionSuffix(this.absolutePathToLocalOutput, autoVersionResult.version);
@@ -952543,6 +952555,7 @@ var LocalTaskHandler = class {
   async handleAutoVersioning(priorChangelog) {
     const autoVersioningService = new import_autoversion2.AutoVersioningService({ logger: this.context.logger });
     let diffFile;
+    const mappedMagicVersion = (0, import_autoversion2.mapMagicVersionForLanguage)(import_autoversion2.MAGIC_VERSION, this.generatorLanguage ?? "");
     try {
       this.context.logger.info("Analyzing SDK changes for automatic semantic versioning");
       diffFile = await this.generateDiffFile();
@@ -952559,7 +952572,7 @@ var LocalTaskHandler = class {
       }
       let previousVersion;
       try {
-        previousVersion = autoVersioningService.extractPreviousVersion(diffContent, this.version);
+        previousVersion = autoVersioningService.extractPreviousVersion(diffContent, mappedMagicVersion);
       } catch (e2) {
         if (!(e2 instanceof import_autoversion2.AutoVersioningException) || !e2.magicVersionAbsent) {
           throw e2;
@@ -952572,7 +952585,7 @@ var LocalTaskHandler = class {
         }
         if (previousVersion == null) {
           this.context.logger.info("No git tags found \u2014 treating as new SDK repository");
-          const initialVersion = this.version?.startsWith("v") ? "v0.0.1" : "0.0.1";
+          const initialVersion = mappedMagicVersion.startsWith("v") ? "v0.0.1" : "0.0.1";
           const commitMessage2 = this.isWhitelabel ? "Initial SDK generation" : "Initial SDK generation\n\n\u{1F33F} Generated with Fern";
           return {
             version: initialVersion,
@@ -952581,7 +952594,7 @@ var LocalTaskHandler = class {
         }
         this.context.logger.debug(`Previous version from fallback: ${previousVersion}`);
       }
-      const cleanedDiff = autoVersioningService.cleanDiffForAI(diffContent, this.version);
+      const cleanedDiff = autoVersioningService.cleanDiffForAI(diffContent, mappedMagicVersion);
       const rawDiffSizeKB = (0, import_autoversion2.formatSizeKB)(diffContent.length);
       const cleanedDiffSizeKB = (0, import_autoversion2.formatSizeKB)(cleanedDiff.length);
       const rawFileCount = (0, import_autoversion2.countFilesInDiff)(diffContent);
@@ -952600,7 +952613,7 @@ var LocalTaskHandler = class {
       }
       if (previousVersion == null) {
         this.context.logger.info("No previous version found (new SDK repository). Using 0.0.1 as initial version.");
-        const initialVersion = this.version?.startsWith("v") ? "v0.0.1" : "0.0.1";
+        const initialVersion = mappedMagicVersion.startsWith("v") ? "v0.0.1" : "0.0.1";
         const commitMessage2 = this.isWhitelabel ? "Initial SDK generation" : "Initial SDK generation\n\n\u{1F33F} Generated with Fern";
         return {
           version: initialVersion,
@@ -952736,7 +952749,7 @@ var LocalTaskHandler = class {
     } catch (error50) {
       if (error50 instanceof import_autoversion2.AutoVersioningException) {
         this.context.logger.warn(`AUTO versioning could not extract previous version: ${error50.message}. Falling back to initial version 0.0.1.`);
-        const initialVersion = this.version?.startsWith("v") ? "v0.0.1" : "0.0.1";
+        const initialVersion = mappedMagicVersion.startsWith("v") ? "v0.0.1" : "0.0.1";
         const commitMessage = this.isWhitelabel ? "Initial SDK generation" : "Initial SDK generation\n\n\u{1F33F} Generated with Fern";
         return {
           version: initialVersion,
@@ -952863,8 +952876,8 @@ var LocalTaskHandler = class {
   }
   /**
    * Normalizes a version string's `v` prefix to match the convention used by
-   * the magic version (`this.version`).  Git tags may use `v1.2.3` while the
-   * magic version is `0.0.0-fern-placeholder` (no prefix) or vice-versa.
+   * the magic version for this generator's language. Git tags may use `v1.2.3`
+   * while the magic version is `0.0.0-fern-placeholder` (no prefix) or vice-versa.
    * Without normalization the mismatch propagates into `replaceMagicVersion`
    * and can produce invalid versions in package manifests (e.g. `v1.3.0` in
    * a `package.json` that expects bare semver).
@@ -952873,8 +952886,9 @@ var LocalTaskHandler = class {
     if (version7 == null) {
       return void 0;
     }
+    const mapped = (0, import_autoversion2.mapMagicVersionForLanguage)(import_autoversion2.MAGIC_VERSION, this.generatorLanguage ?? "");
     const stripped = version7.startsWith("v") ? version7.slice(1) : version7;
-    if (this.version?.startsWith("v")) {
+    if (mapped.startsWith("v")) {
       return `v${stripped}`;
     }
     return stripped;
@@ -953442,6 +953456,8 @@ function extractLicenseFilePath(generatorInvocation, absolutePathToFernConfig) {
   return void 0;
 }
 async function writeFilesToDiskAndRunGenerator({ organization, absolutePathToFernConfig, workspace, generatorInvocation, absolutePathToLocalOutput, absolutePathToLocalSnippetJSON, absolutePathToLocalSnippetTemplateJSON, audiences, version: version7, workspaceTempDir, keepDocker, context: context3, irVersionOverride, outputVersionOverride, writeUnitTests, generateOauthClients, generatePaginatedClients, includeOptionalRequestPropertyExamples, inspect: inspect6, executionEnvironment, runner, whiteLabel, publishToRegistry, ir: ir3, ai: ai2, autoVersioningCache, absolutePathToSpecRepo, skipFernignore, disableTelemetry, rawApiSpecs }) {
+  const irVersion = version7 ?? outputVersionOverride;
+  const effectiveIrVersion = irVersion != null && (0, import_autoversion3.isAutoVersion)(irVersion) ? import_autoversion3.MAGIC_VERSION : irVersion;
   const { latest: latest2, migrated } = await getIntermediateRepresentation({
     workspace,
     audiences,
@@ -953449,7 +953465,7 @@ async function writeFilesToDiskAndRunGenerator({ organization, absolutePathToFer
     context: context3,
     irVersionOverride,
     packageName: generators_yml_exports.getPackageName({ generatorInvocation }),
-    version: version7 ?? outputVersionOverride,
+    version: effectiveIrVersion,
     sourceConfig: getSourceConfig(workspace, executionEnvironment?.usesContainerPaths ?? true),
     includeOptionalRequestPropertyExamples,
     ir: ir3
@@ -953504,7 +953520,8 @@ async function writeFilesToDiskAndRunGenerator({ organization, absolutePathToFer
   };
   const generatorLanguage = generatorInvocation.language ?? (0, import_autoversion3.extractLanguageFromGeneratorName)(generatorInvocation.name);
   const mappedVersion = version7 != null ? (0, import_autoversion3.mapMagicVersionForLanguage)(version7, generatorLanguage) : version7;
-  const mappedOutputVersionOverride = outputVersionOverride != null ? (0, import_autoversion3.mapMagicVersionForLanguage)(outputVersionOverride, generatorLanguage) : outputVersionOverride;
+  const effectiveOutputVersion = outputVersionOverride != null && (0, import_autoversion3.isAutoVersion)(outputVersionOverride) ? import_autoversion3.MAGIC_VERSION : outputVersionOverride;
+  const mappedOutputVersionOverride = effectiveOutputVersion != null ? (0, import_autoversion3.mapMagicVersionForLanguage)(effectiveOutputVersion, generatorLanguage) : effectiveOutputVersion;
   const config5 = getGeneratorConfig({
     generatorInvocation,
     customConfig: generatorInvocation.config,
@@ -965821,7 +965838,7 @@ function getAutomationContextFromEnv() {
     config_branch: process.env.FERN_CONFIG_BRANCH,
     config_pr_number: process.env.FERN_CONFIG_PR_NUMBER,
     trigger: process.env.GITHUB_EVENT_NAME,
-    cli_version: "5.50.6"
+    cli_version: "5.51.1"
   };
 }
 function isAutomationMode() {
@@ -966653,7 +966670,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.50.6";
+    return "5.51.1";
   }
   getCliName() {
     if (false) {

package/package.json

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