@fern-api/fern-api-dev 5.23.3-1306-g97e4764e29d → 5.23.3-1314-ge04cf20354b

package/cli.cjs

@@ -67272,6 +67272,13 @@ var init_HeaderApiVersionScheme = __esm({
   }
 });
 
+// ../../ir-sdk/lib/sdk/api/resources/ir/types/IdempotencyKeyGeneration.js
+var init_IdempotencyKeyGeneration = __esm({
+  "../../ir-sdk/lib/sdk/api/resources/ir/types/IdempotencyKeyGeneration.js"() {
+    "use strict";
+  }
+});
+
 // ../../ir-sdk/lib/sdk/api/resources/ir/types/IntermediateRepresentation.js
 var init_IntermediateRepresentation = __esm({
   "../../ir-sdk/lib/sdk/api/resources/ir/types/IntermediateRepresentation.js"() {
@@ -67400,6 +67407,7 @@ var init_types63 = __esm({
     init_ExampleStyle();
     init_GenerationMetadata();
     init_HeaderApiVersionScheme();
+    init_IdempotencyKeyGeneration();
     init_IntermediateRepresentation();
     init_InvocationSource();
     init_Package();
@@ -79542,6 +79550,20 @@ var init_GenerationMetadata2 = __esm({
   }
 });
 
+// ../../ir-sdk/lib/sdk/serialization/resources/ir/types/IdempotencyKeyGeneration.js
+var IdempotencyKeyGeneration;
+var init_IdempotencyKeyGeneration2 = __esm({
+  "../../ir-sdk/lib/sdk/serialization/resources/ir/types/IdempotencyKeyGeneration.js"() {
+    "use strict";
+    init_core2();
+    init_HttpMethod4();
+    IdempotencyKeyGeneration = schemas_exports3.objectWithoutOptionalProperties({
+      headerName: schemas_exports3.string(),
+      methods: schemas_exports3.list(HttpMethod4)
+    });
+  }
+});
+
 // ../../ir-sdk/lib/sdk/serialization/resources/publish/types/CratesPublishTarget.js
 var CratesPublishTarget;
 var init_CratesPublishTarget2 = __esm({
@@ -81375,13 +81397,15 @@ var init_SdkConfig2 = __esm({
   "../../ir-sdk/lib/sdk/serialization/resources/ir/types/SdkConfig.js"() {
     "use strict";
     init_core2();
+    init_IdempotencyKeyGeneration2();
     init_PlatformHeaders2();
     SdkConfig = schemas_exports3.objectWithoutOptionalProperties({
       isAuthMandatory: schemas_exports3.boolean(),
       hasStreamingEndpoints: schemas_exports3.boolean(),
       hasPaginatedEndpoints: schemas_exports3.boolean(),
       hasFileDownloadEndpoints: schemas_exports3.boolean(),
-      platformHeaders: PlatformHeaders
+      platformHeaders: PlatformHeaders,
+      idempotencyKeyGeneration: IdempotencyKeyGeneration.optional()
     });
   }
 });
@@ -81521,6 +81545,7 @@ var init_types92 = __esm({
     init_ExampleStyle2();
     init_GenerationMetadata2();
     init_HeaderApiVersionScheme2();
+    init_IdempotencyKeyGeneration2();
     init_IntermediateRepresentation2();
     init_InvocationSource2();
     init_Package2();
@@ -81549,6 +81574,7 @@ __export(ir_exports4, {
   ExampleStyle: () => ExampleStyle2,
   GenerationMetadata: () => GenerationMetadata,
   HeaderApiVersionScheme: () => HeaderApiVersionScheme,
+  IdempotencyKeyGeneration: () => IdempotencyKeyGeneration,
   IntermediateRepresentation: () => IntermediateRepresentation,
   InvocationSource: () => InvocationSource2,
   Package: () => Package,
@@ -82851,6 +82877,7 @@ __export(serialization_exports2, {
   HttpResponse: () => HttpResponse,
   HttpResponseBody: () => HttpResponseBody2,
   HttpService: () => HttpService,
+  IdempotencyKeyGeneration: () => IdempotencyKeyGeneration,
   InferredAuthScheme: () => InferredAuthScheme,
   InferredAuthSchemeTokenEndpoint: () => InferredAuthSchemeTokenEndpoint,
   InferredAuthenticatedRequestHeader: () => InferredAuthenticatedRequestHeader2,
@@ -83903,6 +83930,30 @@ function getUserAgentTemplateFromGeneratorConfig(generatorInvocation) {
   }
   return void 0;
 }
+function parseIdempotencyKeyMethods(value2) {
+  if (!Array.isArray(value2)) {
+    return DEFAULT_IDEMPOTENCY_KEY_METHODS;
+  }
+  const methods = value2.filter((entry) => typeof entry === "string").map((entry) => entry.toUpperCase()).filter((entry) => ALL_HTTP_METHODS.has(entry));
+  return methods.length > 0 ? methods : DEFAULT_IDEMPOTENCY_KEY_METHODS;
+}
+function getIdempotencyKeyGenerationFromGeneratorConfig(generatorInvocation) {
+  if (typeof generatorInvocation.raw?.config !== "object" || generatorInvocation.raw?.config === null) {
+    return void 0;
+  }
+  const value2 = generatorInvocation.raw.config["auto-generate-idempotency-key"];
+  if (value2 === true) {
+    return { headerName: DEFAULT_IDEMPOTENCY_KEY_HEADER, methods: DEFAULT_IDEMPOTENCY_KEY_METHODS };
+  }
+  if (typeof value2 === "object" && value2 !== null) {
+    const headerName = value2["header-name"];
+    return {
+      headerName: typeof headerName === "string" ? headerName : DEFAULT_IDEMPOTENCY_KEY_HEADER,
+      methods: parseIdempotencyKeyMethods(value2["methods"])
+    };
+  }
+  return void 0;
+}
 function stripCliConfigKeys(config5) {
   if (typeof config5 !== "object" || config5 === null) {
     return config5;
@@ -84068,13 +84119,16 @@ function getRegistryName(language) {
       return language;
   }
 }
-var CLI_ONLY_CONFIG_KEYS, REGISTRY_TIMEOUT_MS;
+var DEFAULT_IDEMPOTENCY_KEY_HEADER, DEFAULT_IDEMPOTENCY_KEY_METHODS, ALL_HTTP_METHODS, CLI_ONLY_CONFIG_KEYS, REGISTRY_TIMEOUT_MS;
 var init_checkVersionExists = __esm({
   "../../commons/api-workspace-commons/lib/checkVersionExists.js"() {
     "use strict";
     init_lib4();
     init_lib6();
-    CLI_ONLY_CONFIG_KEYS = /* @__PURE__ */ new Set(["user-agent"]);
+    DEFAULT_IDEMPOTENCY_KEY_HEADER = "Idempotency-Key";
+    DEFAULT_IDEMPOTENCY_KEY_METHODS = ["POST", "PUT"];
+    ALL_HTTP_METHODS = /* @__PURE__ */ new Set(["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD"]);
+    CLI_ONLY_CONFIG_KEYS = /* @__PURE__ */ new Set(["user-agent", "auto-generate-idempotency-key"]);
     REGISTRY_TIMEOUT_MS = 5e3;
   }
 });
@@ -276640,7 +276694,7 @@ var init_getIrGenerationSettings = __esm({
 });
 
 // ../generation/ir-generator/lib/generateIntermediateRepresentation.js
-function generateIntermediateRepresentation({ workspace, generationLanguage, keywords: keywords3, smartCasing, exampleGeneration, audiences, readme, packageName, userAgentTemplate, organization, version: version7, context: context3, fdrApiDefinitionId, sourceResolver, disableDynamicExamples, dynamicGeneratorConfig, generationMetadata }) {
+function generateIntermediateRepresentation({ workspace, generationLanguage, keywords: keywords3, smartCasing, exampleGeneration, audiences, readme, packageName, userAgentTemplate, idempotencyKeyGeneration, organization, version: version7, context: context3, fdrApiDefinitionId, sourceResolver, disableDynamicExamples, dynamicGeneratorConfig, generationMetadata }) {
   const irSettings = getIrGenerationSettings({ workspace });
   const casingsGenerator = constructCasingsGenerator({ generationLanguage, keywords: keywords3, smartCasing });
   const irGraph = new IrGraph(audiences);
@@ -276978,6 +277032,7 @@ function generateIntermediateRepresentation({ workspace, generationLanguage, key
     hasStreamingEndpoints,
     hasPaginatedEndpoints,
     hasFileDownloadEndpoints,
+    idempotencyKeyGeneration,
     platformHeaders: {
       language: "X-Fern-Language",
       sdkName: "X-Fern-SDK-Name",
@@ -342420,6 +342475,7 @@ var init_AbstractSpecConverter = __esm({
             hasPaginatedEndpoints: false,
             hasStreamingEndpoints: false,
             isAuthMandatory: true,
+            idempotencyKeyGeneration: void 0,
             platformHeaders: {
               language: "",
               sdkName: "",
@@ -565816,7 +565872,8 @@ var require_AutoVersionStep = __commonJS({
       }
       async handleNormalFlow(params2) {
         const { prepared, service, language, mappedMagicVersion, previousGenerationSha } = params2;
-        const rawDiff = this.gitDiff(previousGenerationSha, prepared.currentGenerationSha);
+        const diffBase = this.resolveReachableGenerationBase(previousGenerationSha, prepared.currentGenerationSha);
+        const rawDiff = diffBase != null ? this.safeGitDiff(diffBase, prepared.currentGenerationSha) : "";
         const previousVersion = await this.resolvePreviousVersion({
           service,
           rawDiff,
@@ -566213,6 +566270,91 @@ var require_AutoVersionStep = __commonJS({
           maxBuffer: 256 * 1024 * 1024
         });
       }
+      /**
+       * Resolves a reachable base commit for the autoversion diff.
+       *
+       * `recordedSha` (the previous generation from replay.lock) is preferred when it exists
+       * in this clone. When it doesn't — e.g. the signed-commit push recreated the
+       * [fern-generated] commit under a new SHA, or the branch was squash-merged — we re-anchor
+       * on the most recent reachable [fern-generated] commit in history. Returns null when no
+       * generation baseline is reachable at all, in which case the caller resolves the previous
+       * version from metadata/git-tags and still rewrites the placeholder.
+       */
+      resolveReachableGenerationBase(recordedSha, currentGenerationSha) {
+        if (this.commitExists(recordedSha)) {
+          return recordedSha;
+        }
+        this.logger.warn(`AutoVersionStep: recorded previous generation ${recordedSha.slice(0, 7)} is unreachable in this clone; deriving the baseline from history.`);
+        const derived = this.findPreviousGenerationFromHistory(currentGenerationSha);
+        if (derived != null) {
+          this.logger.info(`AutoVersionStep: re-anchored autoversion baseline on ${derived.slice(0, 7)}.`);
+          return derived;
+        }
+        this.logger.warn("AutoVersionStep: no reachable [fern-generated] baseline found; falling back to metadata/git-tags.");
+        return null;
+      }
+      commitExists(sha) {
+        if (!/^[0-9a-f]{7,40}$/.test(sha)) {
+          return false;
+        }
+        try {
+          (0, child_process_1.execFileSync)("git", ["cat-file", "-e", `${sha}^{commit}`], {
+            cwd: this.outputDir,
+            stdio: "pipe"
+          });
+          return true;
+        } catch {
+          return false;
+        }
+      }
+      /**
+       * Walks first-parent history from the current generation commit and returns the most
+       * recent prior [fern-generated] commit — the reachable equivalent of replay.lock's
+       * recorded baseline. Mirrors @fern-api/replay's `findPreviousGenerationFromHistory`.
+       */
+      findPreviousGenerationFromHistory(currentGenerationSha) {
+        const start2 = this.commitExists(currentGenerationSha) ? currentGenerationSha : "HEAD";
+        let log4;
+        try {
+          log4 = (0, child_process_1.execFileSync)("git", ["log", "--first-parent", "--format=%H%x00%s", start2], {
+            cwd: this.outputDir,
+            encoding: "utf-8",
+            stdio: "pipe",
+            maxBuffer: 64 * 1024 * 1024
+          });
+        } catch (error50) {
+          this.logger.debug(`AutoVersionStep: git log history walk failed (${String(error50)}); no baseline derived.`);
+          return null;
+        }
+        for (const line of log4.split("\n")) {
+          if (line.trim().length === 0) {
+            continue;
+          }
+          const [sha, subject = ""] = line.split("\0");
+          if (sha == null || sha === currentGenerationSha) {
+            continue;
+          }
+          if (subject.startsWith("[fern-generated]")) {
+            return sha;
+          }
+        }
+        return null;
+      }
+      /**
+       * `gitDiff` that degrades to an empty diff instead of throwing. Both endpoints are
+       * expected to be reachable (the base is resolved via resolveReachableGenerationBase and
+       * `to` is this run's freshly-created HEAD), but we never want a `git diff` failure to
+       * abort autoversion and leave the magic placeholder in the shipped SDK — the empty diff
+       * routes version resolution to baseVersion/metadata/git-tags, which still rewrites it.
+       */
+      safeGitDiff(from4, to2) {
+        try {
+          return this.gitDiff(from4, to2);
+        } catch (error50) {
+          this.logger.warn(`AutoVersionStep: git diff ${from4.slice(0, 7)}..${to2.slice(0, 7)} failed (${error50 instanceof Error ? error50.message : String(error50)}); proceeding with an empty diff.`);
+          return "";
+        }
+      }
       gitDiff(from4, to2) {
         return (0, child_process_1.execFileSync)("git", ["diff", from4, to2, "--", ".", ":(exclude).fern/metadata.json"], {
           cwd: this.outputDir,
@@ -689087,7 +689229,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.23.3-1306-g97e4764e29d",
+          version: "5.23.3-1314-ge04cf20354b",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -689153,7 +689295,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.23.3-1306-g97e4764e29d",
+        version: "5.23.3-1314-ge04cf20354b",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -870254,7 +870396,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.23.3-1306-g97e4764e29d";
+  const version7 = "5.23.3-1314-ge04cf20354b";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -900060,6 +900202,7 @@ async function runRemoteGenerationForGenerator({ projectConfig, organization, wo
   }
   const effectiveIrVersion = resolvedVersion != null && (0, import_autoversion.isAutoVersion)(resolvedVersion) ? import_autoversion.MAGIC_VERSION : resolvedVersion;
   const userAgentTemplate = getUserAgentTemplateFromGeneratorConfig(generatorInvocation);
+  const idempotencyKeyGeneration = getIdempotencyKeyGenerationFromGeneratorConfig(generatorInvocation);
   const ir3 = generateIntermediateRepresentation({
     workspace,
     generationLanguage: generatorInvocation.language,
@@ -900074,6 +900217,7 @@ async function runRemoteGenerationForGenerator({ projectConfig, organization, wo
     readme,
     packageName,
     userAgentTemplate,
+    idempotencyKeyGeneration,
     organization,
     version: effectiveIrVersion,
     context: interactiveTaskContext,
@@ -902813,7 +902957,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.23.3-1306-g97e4764e29d",
+        cliVersion: "5.23.3-1314-ge04cf20354b",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -955671,6 +955815,7 @@ init_lib26();
 init_lib22();
 async function getIntermediateRepresentation({ workspace, audiences, generatorInvocation, context: context3, irVersionOverride, version: version7, packageName, userAgentTemplate, organization, sourceConfig, includeOptionalRequestPropertyExamples, ir: ir3 }) {
   const resolvedUserAgentTemplate = userAgentTemplate ?? getUserAgentTemplateFromGeneratorConfig(generatorInvocation);
+  const idempotencyKeyGeneration = getIdempotencyKeyGenerationFromGeneratorConfig(generatorInvocation);
   const intermediateRepresentation = ir3 ?? generateIntermediateRepresentation({
     workspace,
     audiences,
@@ -955685,6 +955830,7 @@ async function getIntermediateRepresentation({ workspace, audiences, generatorIn
     version: version7,
     packageName,
     userAgentTemplate: resolvedUserAgentTemplate,
+    idempotencyKeyGeneration,
     organization,
     context: context3,
     sourceResolver: new SourceResolverImpl(context3, workspace),
@@ -957009,6 +957155,7 @@ async function runLocalGenerationForWorkspace({ token, projectConfig, workspace,
       });
       const packageName = getPackageNameFromGeneratorConfig(generatorInvocation);
       const userAgentTemplate = getUserAgentTemplateFromGeneratorConfig(generatorInvocation);
+      const idempotencyKeyGeneration = getIdempotencyKeyGenerationFromGeneratorConfig(generatorInvocation);
       version7 = version7 ?? await computeSemanticVersion({ packageName, generatorInvocation });
       const irLanguage = generatorInvocation.language ?? (0, import_autoversion4.extractLanguageFromGeneratorName)(generatorInvocation.name);
       const effectiveIrVersion = version7 != null && (0, import_autoversion4.isAutoVersion)(version7) ? (0, import_autoversion4.mapMagicVersionForLanguage)(import_autoversion4.MAGIC_VERSION, irLanguage) : version7;
@@ -957026,6 +957173,7 @@ async function runLocalGenerationForWorkspace({ token, projectConfig, workspace,
         version: effectiveIrVersion,
         packageName,
         userAgentTemplate,
+        idempotencyKeyGeneration,
         organization: projectConfig.organization,
         context: context3,
         sourceResolver: new SourceResolverImpl(context3, fernWorkspace),
@@ -957568,6 +957716,7 @@ var GenerationRunner = class {
       version: outputVersionOverride,
       packageName: generators_yml_exports.getPackageName({ generatorInvocation }),
       userAgentTemplate: getUserAgentTemplateFromGeneratorConfig(generatorInvocation),
+      idempotencyKeyGeneration: getIdempotencyKeyGenerationFromGeneratorConfig(generatorInvocation),
       organization,
       context: context3,
       sourceResolver: new SourceResolverImpl(context3, workspace),
@@ -969156,7 +969305,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.23.3-1306-g97e4764e29d"
+    cli_version: "5.23.3-1314-ge04cf20354b"
   };
 }
 function isAutomationMode() {
@@ -969988,7 +970137,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.23.3-1306-g97e4764e29d";
+    return "5.23.3-1314-ge04cf20354b";
   }
   getCliName() {
     if (false) {

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "5.23.3-1306-g97e4764e29d",
+  "version": "5.23.3-1314-ge04cf20354b",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",