@fern-api/fern-api-dev 5.67.1 → 5.68.0

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: "",
@@ -689087,7 +689143,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.67.1",
+          version: "5.68.0",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -689153,7 +689209,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.67.1",
+        version: "5.68.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -870254,7 +870310,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.67.1";
+  const version7 = "5.68.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -900060,6 +900116,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 +900131,7 @@ async function runRemoteGenerationForGenerator({ projectConfig, organization, wo
     readme,
     packageName,
     userAgentTemplate,
+    idempotencyKeyGeneration,
     organization,
     version: effectiveIrVersion,
     context: interactiveTaskContext,
@@ -902813,7 +902871,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.67.1",
+        cliVersion: "5.68.0",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -922377,6 +922435,8 @@ var Generation = class {
     extraDependencies: () => this.customConfig["extra-dependencies"] ?? {},
     /** When true, omits Fern platform headers (X-Fern-Language, SDK name/version, User-Agent) from generated SDK requests. Default: false. */
     omitFernHeaders: () => this.customConfig["omit-fern-headers"] ?? false,
+    /** When true, emits the platform observability headers (X-Fern-Runtime, X-Fern-Runtime-Version, X-Fern-Platform). Default: false. Still subject to omitFernHeaders. */
+    includePlatformHeaders: () => this.customConfig["include-platform-headers"] ?? false,
     /** When true, falls back to `<NuGetPackageId>/<version>` for the `User-Agent` header when the IR doesn't supply one. Default: false. */
     userAgentNameFromPackage: () => this.customConfig["user-agent-name-from-package"] ?? false,
     /** When true, moves auth params and IR headers into ClientOptions so the constructor takes only named arguments. Default: false. */
@@ -928964,6 +929024,7 @@ var BaseJavaCustomConfigSchema = external_exports2.object({
   "output-directory": external_exports2.enum(["source-root", "project-root"]).optional(),
   "custom-interceptors": external_exports2.boolean().optional(),
   "omit-fern-headers": external_exports2.boolean().optional(),
+  includePlatformHeaders: external_exports2.boolean().optional(),
   "retry-status-codes": external_exports2.optional(external_exports2.enum(["legacy", "recommended"])),
   // Hidden options (for debugging).
   "enable-gradle-profiling": external_exports2.boolean().optional(),
@@ -952791,6 +952852,7 @@ var TypescriptCustomConfigSchema = external_exports2.strictObject({
   fetchSupport: external_exports2.optional(external_exports2.enum(["node-fetch", "native"])),
   packagePath: external_exports2.optional(external_exports2.string()),
   omitFernHeaders: external_exports2.optional(external_exports2.boolean()),
+  includePlatformHeaders: external_exports2.optional(external_exports2.boolean()),
   useDefaultRequestParameterValues: external_exports2.optional(external_exports2.boolean()),
   packageManager: external_exports2.optional(external_exports2.enum(["pnpm", "yarn"])),
   flattenRequestParameters: external_exports2.optional(external_exports2.boolean()),
@@ -955667,6 +955729,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,
@@ -955681,6 +955744,7 @@ async function getIntermediateRepresentation({ workspace, audiences, generatorIn
     version: version7,
     packageName,
     userAgentTemplate: resolvedUserAgentTemplate,
+    idempotencyKeyGeneration,
     organization,
     context: context3,
     sourceResolver: new SourceResolverImpl(context3, workspace),
@@ -957005,6 +957069,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;
@@ -957022,6 +957087,7 @@ async function runLocalGenerationForWorkspace({ token, projectConfig, workspace,
         version: effectiveIrVersion,
         packageName,
         userAgentTemplate,
+        idempotencyKeyGeneration,
         organization: projectConfig.organization,
         context: context3,
         sourceResolver: new SourceResolverImpl(context3, fernWorkspace),
@@ -957564,6 +957630,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),
@@ -969152,7 +969219,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.67.1"
+    cli_version: "5.68.0"
   };
 }
 function isAutomationMode() {
@@ -969984,7 +970051,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.67.1";
+    return "5.68.0";
   }
   getCliName() {
     if (false) {

package/package.json

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