@fern-api/fern-api-dev 5.76.0 → 5.78.0

package/cli.cjs

@@ -130089,7 +130089,8 @@ var init_OpenApiSettingsSchema2 = __esm({
       "group-multi-api-environments": schemas_exports8.boolean().optional(),
       "default-integer-format": DefaultIntegerFormat2.optional(),
       "infer-discriminated-union-base-properties": schemas_exports8.boolean().optional(),
-      "disambiguate-request-names": schemas_exports8.boolean().optional()
+      "disambiguate-request-names": schemas_exports8.boolean().optional(),
+      "ignore-tags": schemas_exports8.boolean().optional()
     }).extend(BaseApiSettingsSchema);
   }
 });
@@ -145600,7 +145601,7 @@ var init_convertFullExample = __esm({
 });
 
 // ../api-importers/openapi/openapi-ir-to-fern/lib/buildEndpointExample.js
-function buildEndpointExample({ endpointExample, context: context3 }) {
+function buildEndpointExample({ endpointExample, context: context3, pathParameterRenames }) {
   const example = {};
   if (endpointExample.type !== "full") {
     return endpointExample.value;
@@ -145621,7 +145622,7 @@ function buildEndpointExample({ endpointExample, context: context3 }) {
     }
   }
   if (endpointExample.pathParameters != null && endpointExample.pathParameters.length > 0) {
-    Object.assign(pathParametersForExample, convertPathParameterExample(endpointExample.pathParameters));
+    Object.assign(pathParametersForExample, convertPathParameterExample(endpointExample.pathParameters, pathParameterRenames));
   }
   if (Object.keys(pathParametersForExample).length > 0) {
     example["path-parameters"] = pathParametersForExample;
@@ -145723,12 +145724,13 @@ function buildEndpointExample({ endpointExample, context: context3 }) {
   }
   return example;
 }
-function convertPathParameterExample(pathParameterExamples) {
+function convertPathParameterExample(pathParameterExamples, pathParameterRenames) {
   const result = {};
   pathParameterExamples.forEach((pathParameterExample) => {
     const convertedExample = convertFullExample2(pathParameterExample.value);
     if (convertedExample != null) {
-      result[pathParameterExample.parameterNameOverride ?? pathParameterExample.name] = convertedExample;
+      const name2 = pathParameterExample.parameterNameOverride ?? pathParameterRenames?.[pathParameterExample.name] ?? pathParameterExample.name;
+      result[name2] = convertedExample;
     }
   });
   return result;
@@ -145853,17 +145855,92 @@ var init_isWriteMethod = __esm({
 });
 
 // ../api-importers/openapi/openapi-ir-to-fern/lib/buildEndpoint.js
+function getReservedRequestPropertyNames({ endpoint: endpoint3, context: context3, namespace }) {
+  const reservedNames = /* @__PURE__ */ new Set();
+  for (const queryParameter of endpoint3.queryParameters) {
+    reservedNames.add(queryParameter.name);
+  }
+  for (const header of endpoint3.headers) {
+    reservedNames.add(header.parameterNameOverride ?? header.name);
+  }
+  const request7 = endpoint3.request;
+  if (request7 == null) {
+    return reservedNames;
+  }
+  switch (request7.type) {
+    case "multipart":
+      for (const property24 of request7.properties) {
+        reservedNames.add(property24.key);
+      }
+      break;
+    case "json":
+    case "formUrlEncoded": {
+      const maybeSchemaId = request7.schema.type === "reference" ? request7.schema.schema : void 0;
+      const resolvedSchema = request7.schema.type === "reference" ? context3.getSchema(request7.schema.schema, namespace) : request7.schema;
+      if (resolvedSchema?.type !== "object" || maybeSchemaId != null && context3.isResponseReachable(maybeSchemaId)) {
+        reservedNames.add("body");
+        break;
+      }
+      for (const property24 of resolvedSchema.properties) {
+        reservedNames.add(property24.nameOverride ?? property24.key);
+      }
+      for (const allOfRef of resolvedSchema.allOf) {
+        const { properties: allOfProperties } = getProperties(context3, allOfRef.schema, namespace);
+        for (const property24 of allOfProperties) {
+          reservedNames.add(property24.nameOverride ?? property24.key);
+        }
+      }
+      break;
+    }
+    case "octetStream":
+      break;
+    default:
+      assertNever(request7);
+  }
+  return reservedNames;
+}
+function deconflictPathParameterName({ pathParameterName, reservedNames, pathParameters }) {
+  const otherPathParameterNames = /* @__PURE__ */ new Set();
+  for (const pathParameter of pathParameters) {
+    const name2 = pathParameter.parameterNameOverride ?? pathParameter.name;
+    if (name2 !== pathParameterName) {
+      otherPathParameterNames.add(name2);
+    }
+  }
+  let candidate = `${pathParameterName}${PATH_PARAM_DECONFLICT_SUFFIX}`;
+  let counter = 2;
+  while (reservedNames.has(candidate) || otherPathParameterNames.has(candidate)) {
+    candidate = `${pathParameterName}${PATH_PARAM_DECONFLICT_SUFFIX}${counter}`;
+    counter++;
+  }
+  return candidate;
+}
 function buildEndpoint({ endpoint: endpoint3, declarationFile, context: context3 }) {
   let schemaIdsToExclude = [];
   const names2 = /* @__PURE__ */ new Set();
   let path120 = endpoint3.path;
   const maybeEndpointNamespace = getEndpointNamespace(endpoint3.sdkName, endpoint3.namespace);
+  const reservedRequestPropertyNames = getReservedRequestPropertyNames({
+    endpoint: endpoint3,
+    context: context3,
+    namespace: maybeEndpointNamespace
+  });
+  const pathParameterRenames = {};
   const pathParameters = {};
   for (const pathParameter of endpoint3.pathParameters) {
-    if (pathParameter.parameterNameOverride) {
-      path120 = path120.replace(pathParameter.name, pathParameter.parameterNameOverride);
+    let parameterNameOverride = pathParameter.parameterNameOverride;
+    if (parameterNameOverride == null && reservedRequestPropertyNames.has(pathParameter.name)) {
+      parameterNameOverride = deconflictPathParameterName({
+        pathParameterName: pathParameter.name,
+        reservedNames: reservedRequestPropertyNames,
+        pathParameters: endpoint3.pathParameters
+      });
+      pathParameterRenames[pathParameter.name] = parameterNameOverride;
+    }
+    if (parameterNameOverride) {
+      path120 = path120.replace(`{${pathParameter.name}}`, `{${parameterNameOverride}}`);
     }
-    pathParameters[pathParameter.parameterNameOverride ?? pathParameter.name] = buildPathParameter({
+    pathParameters[parameterNameOverride ?? pathParameter.name] = buildPathParameter({
       pathParameter,
       context: context3,
       fileContainingReference: declarationFile,
@@ -146170,7 +146247,8 @@ function buildEndpoint({ endpoint: endpoint3, declarationFile, context: context3
   if (endpoint3.examples.length > 0) {
     convertedEndpoint.examples = convertEndpointExamples({
       endpointExamples: endpoint3.examples,
-      context: context3
+      context: context3,
+      pathParameterRenames
     });
   }
   if (endpoint3.retries != null) {
@@ -146212,10 +146290,10 @@ function convertEndpointAuth({ endpoint: endpoint3, context: context3 }) {
   }
   return endpoint3.security;
 }
-function convertEndpointExamples({ endpointExamples, context: context3 }) {
+function convertEndpointExamples({ endpointExamples, context: context3, pathParameterRenames }) {
   return endpointExamples.map((endpointExample) => {
     try {
-      return buildEndpointExample({ endpointExample, context: context3 });
+      return buildEndpointExample({ endpointExample, context: context3, pathParameterRenames });
     } catch (e2) {
       console.error(`Error building endpoint example: ${e2}`);
       throw e2;
@@ -146547,6 +146625,7 @@ function endpointRequestSupportsInlinedPathParameters({ context: context3, reque
       assertNever(request7);
   }
 }
+var PATH_PARAM_DECONFLICT_SUFFIX;
 var init_buildEndpoint = __esm({
   "../api-importers/openapi/openapi-ir-to-fern/lib/buildEndpoint.js"() {
     "use strict";
@@ -146572,6 +146651,7 @@ var init_buildEndpoint = __esm({
     init_getNamespaceFromGroup();
     init_getTypeFromTypeReference();
     init_isWriteMethod();
+    PATH_PARAM_DECONFLICT_SUFFIX = "PathParam";
   }
 });
 
@@ -151847,7 +151927,8 @@ var init_options2 = __esm({
       coerceConstsTo: "enums-coerceable-to-literals",
       respectByteFormat: false,
       shouldInferDiscriminatedUnionBaseProperties: false,
-      disambiguateRequestNames: true
+      disambiguateRequestNames: true,
+      ignoreTags: false
     };
   }
 });
@@ -166011,7 +166092,7 @@ function convertHttpOperation({ operationContext, context: context3, responseSta
     idempotent,
     audiences: getExtension(operation, FernOpenAPIExtension.AUDIENCES) ?? [],
     operationId: operation.operationId != null && suffix != null ? operation.operationId + "_" + suffix : operation.operationId,
-    tags: context3.resolveTagsToTagIds(operation.tags),
+    tags: context3.options.ignoreTags ? [] : context3.resolveTagsToTagIds(operation.tags),
     namespace: context3.namespace,
     sdkName: createOperationSdkMethodName({ operationContext, request: request7 }),
     pathParameters: convertedParameters.pathParameters,
@@ -198996,7 +199077,8 @@ var init_getAPIDefinitionSettings = __esm({
       inferForwardCompatible: "inferForwardCompatible",
       coerceConstsTo: "coerceConstsTo",
       shouldInferDiscriminatedUnionBaseProperties: "shouldInferDiscriminatedUnionBaseProperties",
-      disambiguateRequestNames: "disambiguateRequestNames"
+      disambiguateRequestNames: "disambiguateRequestNames",
+      ignoreTags: "ignoreTags"
     };
   }
 });
@@ -260648,7 +260730,8 @@ function parseOpenApiDefinitionSettingsSchema(settings) {
     defaultIntegerFormat: settings?.["default-integer-format"],
     pathParameterOrder: settings?.["path-parameter-order"],
     shouldInferDiscriminatedUnionBaseProperties: settings?.["infer-discriminated-union-base-properties"],
-    disambiguateRequestNames: settings?.["disambiguate-request-names"]
+    disambiguateRequestNames: settings?.["disambiguate-request-names"],
+    ignoreTags: settings?.["ignore-tags"]
   };
 }
 function parseAsyncApiDefinitionSettingsSchema(settings) {
@@ -261512,7 +261595,8 @@ var init_convertGeneratorsConfiguration = __esm({
       inferForwardCompatible: void 0,
       coerceConstsTo: void 0,
       shouldInferDiscriminatedUnionBaseProperties: void 0,
-      disambiguateRequestNames: void 0
+      disambiguateRequestNames: void 0,
+      ignoreTags: void 0
     };
   }
 });
@@ -682794,7 +682878,14 @@ var OpenApiSettingsSchema2 = BaseApiSettingsSchema2.extend({
    * If false, keep the original "Request" suffix regardless of collisions.
    * Defaults to true.
    */
-  "disambiguate-request-names": external_exports.boolean().optional()
+  "disambiguate-request-names": external_exports.boolean().optional(),
+  /**
+   * If true, ignore operation-level tags when determining the SDK structure.
+   * Endpoints fall back to the root package (or their namespace) and method
+   * names are derived from each operation's operationId.
+   * Defaults to false.
+   */
+  "ignore-tags": external_exports.boolean().optional()
 });
 
 // ../config/lib/schemas/specs/OpenApiSpecSchema.js
@@ -691383,7 +691474,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.76.0",
+          version: "5.78.0",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -691449,7 +691540,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.76.0",
+        version: "5.78.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -698262,7 +698353,8 @@ var LegacyApiSpecAdapter = class {
       defaultIntegerFormat: this.adaptDefaultIntegerFormat(settings.defaultIntegerFormat),
       coerceConstsTo: settings.coerceConstsTo,
       shouldInferDiscriminatedUnionBaseProperties: settings.inferDiscriminatedUnionBaseProperties,
-      disambiguateRequestNames: settings["disambiguate-request-names"]
+      disambiguateRequestNames: settings["disambiguate-request-names"],
+      ignoreTags: settings["ignore-tags"]
     };
     const hasSettings = Object.values(result).some((v3) => v3 != null);
     return hasSettings ? result : void 0;
@@ -872554,7 +872646,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.76.0";
+  const version7 = "5.78.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -905207,7 +905299,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.76.0",
+        cliVersion: "5.78.0",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -924928,6 +925020,8 @@ var Generation = class {
     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. */
     unifiedClientOptions: () => this.customConfig["unified-client-options"] ?? false,
+    /** When true, exposes server URL variables as ClientOptions properties and interpolates them into the environment URL template(s) at construction time. When false, suppresses those options and the interpolation, falling back to the pre-feature base-URL behavior. Default: true. */
+    serverUrlVariables: () => this.customConfig["server-url-variables"] ?? true,
     /** When true, uses PascalCase for environment names (e.g., "Production" instead of "production"). Default: true. */
     pascalCaseEnvironments: () => this.customConfig["pascal-case-environments"] ?? true,
     /** Solution file format: "sln" generates both .sln and .slnx, "slnx" (default) generates only .slnx. */
@@ -948933,8 +949027,7 @@ var DynamicTypeLiteralMapper5 = class {
     if (!enumVariant2) {
       return rust_exports.Expression.raw(`todo!("Unknown enum variant: ${value2}")`);
     }
-    const rawVariantName = enumVariant2.name.pascalCase.unsafeName;
-    const variantName = this.context.escapeRustReservedType(rawVariantName);
+    const variantName = enumVariant2.name.pascalCase.safeName;
     return rust_exports.Expression.reference(`${enumName}::${variantName}`);
   }
   convertDiscriminatedUnionType({ unionType: unionType2, value: value2 }) {
@@ -950417,8 +950510,7 @@ var EndpointSnippetGenerator7 = class {
             if (namedType.values.length > 0) {
               const firstVariant = namedType.values[0];
               if (firstVariant) {
-                const rawVariantName = firstVariant.name.pascalCase.unsafeName;
-                const variantName = this.context.escapeRustReservedType(rawVariantName);
+                const variantName = firstVariant.name.pascalCase.safeName;
                 return rust_exports.Expression.raw(`${typeName}::${variantName}`);
               }
             }
@@ -972120,7 +972212,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.76.0"
+    cli_version: "5.78.0"
   };
 }
 function isAutomationMode() {
@@ -972952,7 +973044,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.76.0";
+    return "5.78.0";
   }
   getCliName() {
     if (false) {

package/package.json

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