@fern-api/generator-cli 0.9.53 → 0.9.54

package/dist/cli.js

@@ -41843,11 +41843,20 @@ var SEMVER_PATTERN = /^(v)?(\d+)\.(\d+)\.(\d+)(?:-([\w.-]+))?(?:\+([\w.-]+))?$/;
 function isValidSemver(version2) {
   return SEMVER_PATTERN.test(version2);
 }
+function isPlaceholderVersion(version2) {
+  const withoutPrefix = version2.startsWith("v") ? version2.slice(1) : version2;
+  return withoutPrefix === MAGIC_VERSION || withoutPrefix.startsWith(`${MAGIC_VERSION}.`) || withoutPrefix === MAGIC_VERSION_PYTHON || withoutPrefix.startsWith(`${MAGIC_VERSION_PYTHON}.`);
+}
 function incrementVersion(currentVersion, versionBump) {
   const matcher = currentVersion.match(SEMVER_PATTERN);
   if (!matcher) {
     throw new AutoVersioningException("Invalid semantic version format: " + currentVersion);
   }
+  if (isPlaceholderVersion(currentVersion)) {
+    throw new AutoVersioningException(
+      "Refusing to increment the magic placeholder version: " + currentVersion + ". A real previous version must be resolved first."
+    );
+  }
   const prefix = matcher[1] ?? "";
   const versionWithoutPrefix = currentVersion.slice(prefix.length);
   const preRelease = matcher[5];
@@ -41918,7 +41927,8 @@ var AutoVersionStep = class extends BaseStep {
   }
   async handleFirstGeneration(params) {
     const { service, language, mappedMagicVersion, commit } = params;
-    const initialVersion = this.config.baseVersion ?? (mappedMagicVersion.startsWith("v") ? "v0.0.1" : "0.0.1");
+    const configuredBaseVersion = this.usableVersion(this.config.baseVersion, "baseVersion");
+    const initialVersion = configuredBaseVersion ?? (mappedMagicVersion.startsWith("v") ? "v0.0.1" : "0.0.1");
     if (!isValidSemver(initialVersion)) {
       const errorMessage = `AutoVersionStep: baseVersion ${JSON.stringify(initialVersion)} is not a valid semver string (expected e.g. "1.2.3" or "v1.2.3"). Refusing to run.`;
       this.logger.error(errorMessage);
@@ -42252,14 +42262,18 @@ var AutoVersionStep = class extends BaseStep {
    */
   async resolvePreviousVersionNonReplay(params) {
     const { service, rawDiff, mappedMagicVersion, baseVersion } = params;
-    if (baseVersion != null && isValidSemver(baseVersion)) {
+    const usableBaseVersion = this.usableVersion(baseVersion, "baseVersion");
+    if (usableBaseVersion != null && isValidSemver(usableBaseVersion)) {
       this.logger.debug(
-        `AutoVersionStep (non-replay): previous version from pipeline baseVersion: ${baseVersion}`
+        `AutoVersionStep (non-replay): previous version from pipeline baseVersion: ${usableBaseVersion}`
       );
-      return this.normalizeVersionPrefix(baseVersion, mappedMagicVersion);
+      return this.normalizeVersionPrefix(usableBaseVersion, mappedMagicVersion);
     }
     try {
-      const extracted = service.extractPreviousVersion(rawDiff, mappedMagicVersion);
+      const extracted = this.usableVersion(
+        service.extractPreviousVersion(rawDiff, mappedMagicVersion) ?? void 0,
+        "diff"
+      );
       if (extracted != null) {
         this.logger.debug(`AutoVersionStep (non-replay): previous version from diff: ${extracted}`);
         return extracted;
@@ -42270,12 +42284,15 @@ var AutoVersionStep = class extends BaseStep {
       }
       this.logger.info("AutoVersionStep (non-replay): magic version not in diff; trying metadata + git tags.");
     }
-    const metadataVersion = this.readVersionFromMetadataAtHead();
+    const metadataVersion = this.usableVersion(this.readVersionFromMetadataAtHead(), "metadata.json");
     if (metadataVersion != null) {
       return this.normalizeVersionPrefix(metadataVersion, mappedMagicVersion);
     }
     try {
-      const tagVersion = await service.getLatestVersionFromGitTags(this.outputDir);
+      const tagVersion = this.usableVersion(
+        await service.getLatestVersionFromGitTags(this.outputDir) ?? void 0,
+        "git tags"
+      );
       if (tagVersion != null) {
         return this.normalizeVersionPrefix(tagVersion, mappedMagicVersion);
       }
@@ -42286,12 +42303,16 @@ var AutoVersionStep = class extends BaseStep {
   }
   async resolvePreviousVersion(params) {
     const { service, rawDiff, mappedMagicVersion, baseVersion } = params;
-    if (baseVersion != null && isValidSemver(baseVersion)) {
-      this.logger.debug(`AutoVersionStep: previous version from pipeline baseVersion: ${baseVersion}`);
-      return this.normalizeVersionPrefix(baseVersion, mappedMagicVersion);
+    const usableBaseVersion = this.usableVersion(baseVersion, "baseVersion");
+    if (usableBaseVersion != null && isValidSemver(usableBaseVersion)) {
+      this.logger.debug(`AutoVersionStep: previous version from pipeline baseVersion: ${usableBaseVersion}`);
+      return this.normalizeVersionPrefix(usableBaseVersion, mappedMagicVersion);
     }
     try {
-      const extracted = service.extractPreviousVersion(rawDiff, mappedMagicVersion);
+      const extracted = this.usableVersion(
+        service.extractPreviousVersion(rawDiff, mappedMagicVersion) ?? void 0,
+        "diff"
+      );
       if (extracted != null) {
         this.logger.debug(`AutoVersionStep: previous version from diff: ${extracted}`);
         return extracted;
@@ -42302,12 +42323,15 @@ var AutoVersionStep = class extends BaseStep {
       }
       this.logger.info("AutoVersionStep: magic version not found in diff; falling back to metadata + git tags.");
     }
-    const metadataVersion = await this.readVersionFromMetadata();
+    const metadataVersion = this.usableVersion(await this.readVersionFromMetadata(), "metadata.json");
     if (metadataVersion != null) {
       return this.normalizeVersionPrefix(metadataVersion, mappedMagicVersion);
     }
     try {
-      const tagVersion = await service.getLatestVersionFromGitTags(this.outputDir);
+      const tagVersion = this.usableVersion(
+        await service.getLatestVersionFromGitTags(this.outputDir) ?? void 0,
+        "git tags"
+      );
       if (tagVersion != null) {
         return this.normalizeVersionPrefix(tagVersion, mappedMagicVersion);
       }
@@ -42329,6 +42353,27 @@ var AutoVersionStep = class extends BaseStep {
       return void 0;
     }
   }
+  /**
+   * Drops candidate previous versions that are the magic placeholder. SDK repos
+   * that derive their published version at release time keep the placeholder
+   * committed, so every resolution source (baseVersion, diff extraction,
+   * metadata.json, git tags) can hand back the sentinel; incrementing it would
+   * emit a mutated placeholder such as `0.0.0-fern-placeholder.0` instead of a
+   * real version. Returning undefined lets the caller fall through to the next
+   * source, and ultimately to the first-generation path.
+   */
+  usableVersion(version2, source) {
+    if (version2 == null) {
+      return void 0;
+    }
+    if (isPlaceholderVersion(version2)) {
+      this.logger.info(
+        `AutoVersionStep: ignoring placeholder version ${version2} from ${source}; trying the next previous-version source.`
+      );
+      return void 0;
+    }
+    return version2;
+  }
   normalizeVersionPrefix(version2, mappedMagicVersion) {
     const stripped = version2.startsWith("v") ? version2.slice(1) : version2;
     return mappedMagicVersion.startsWith("v") ? `v${stripped}` : stripped;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fern-api/generator-cli",
-  "version": "0.9.53",
+  "version": "0.9.54",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",