@fern-api/fern-api-dev 5.23.3-1840-g533c4e6a082 → 5.23.3-1852-g27d10f26ff8

package/cli.cjs

@@ -702983,7 +702983,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.23.3-1840-g533c4e6a082",
+          version: "5.23.3-1852-g27d10f26ff8",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -703049,7 +703049,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.23.3-1840-g533c4e6a082",
+        version: "5.23.3-1852-g27d10f26ff8",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -884215,7 +884215,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-1840-g533c4e6a082";
+  const version7 = "5.23.3-1852-g27d10f26ff8";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -909531,7 +909531,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.23.3-1840-g533c4e6a082",
+        cliVersion: "5.23.3-1852-g27d10f26ff8",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -933550,6 +933550,10 @@ var Type31 = class _Type extends AstNode2 {
   isOptional() {
     return this.internalType.type === "optional";
   }
+  /** Whether a value of this type can be compared to nil, and so can express its own absence. */
+  isNilable() {
+    return this.internalType.type === "optional" || NILABLE_TYPES.has(this.internalType.type);
+  }
   isIterable() {
     return this.internalType.type === "slice" || this.internalType.type === "variadic";
   }
@@ -933668,7 +933672,7 @@ var Type31 = class _Type extends AstNode2 {
     });
   }
   static isAlreadyOptional(value2) {
-    return value2.internalType.type === "optional" || NILABLE_TYPES.has(value2.internalType.type);
+    return value2.isNilable();
   }
   static isAlreadyVariadic(value2) {
     return value2.internalType.type === "variadic";
@@ -935527,7 +935531,10 @@ var EndpointSnippetGenerator2 = class {
     }
     this.context.errors.unscope();
     this.context.errors.scope(Scope4.RequestBody);
-    const requestArg = request7.body != null ? this.getBodyRequestArg({ body: request7.body, value: snippet.requestBody }) : void 0;
+    const requestArg = request7.body != null ? this.callOmitsRequestBody({ request: request7, snippet }) ? (
+      // Go has no optional parameters, so a call that leaves the body out passes nil.
+      go_exports.TypeInstantiation.nop()
+    ) : this.getBodyRequestArg({ body: request7.body, value: snippet.requestBody }) : void 0;
     this.context.errors.unscope();
     return { otherArgs, requestArg };
   }
@@ -935660,6 +935667,40 @@ var EndpointSnippetGenerator2 = class {
         assertNever(body);
     }
   }
+  /**
+   * Whether the call leaves the body out entirely, which a nil argument expresses. Applies only to
+   * a body the caller may omit, and only once the generator opts in to that. An example that
+   * supplies nothing for the body reaches the snippet generator as an absent or empty value, since
+   * that is how the importer spells it.
+   */
+  callOmitsRequestBody({ request: request7, snippet }) {
+    if (this.context.customConfig?.respectOptionalRequestBody !== true) {
+      return false;
+    }
+    if (request7.bodyRequired !== false || request7.body == null) {
+      return false;
+    }
+    if (!this.bodyParameterIsNilable({ body: request7.body })) {
+      return false;
+    }
+    const value2 = snippet.requestBody;
+    return value2 == null || typeof value2 === "object" && !Array.isArray(value2) && Object.keys(value2).length === 0;
+  }
+  /**
+   * Whether the generated body parameter accepts nil, which mirrors the condition the SDK
+   * generator applies before it lets a caller leave the body out. A value type keeps taking a
+   * value, so an example for it must keep supplying one.
+   */
+  bodyParameterIsNilable({ body }) {
+    switch (body.type) {
+      case "bytes":
+        return true;
+      case "typeReference":
+        return this.context.dynamicTypeMapper.convert({ typeReference: body.value }).isNilable();
+      default:
+        assertNever(body);
+    }
+  }
   getFileUploadRequestBodyStructFields({ filePropertyInfo }) {
     const inlineFileProperties = this.context.customConfig?.inlineFileProperties ?? true;
     if (inlineFileProperties) {
@@ -943179,7 +943220,8 @@ var EndpointSnippetGenerator4 = class {
     }
     this.context.errors.unscope();
     this.context.errors.scope(Scope4.RequestBody);
-    if (request7.body != null) {
+    const omitBody = optionalIrPathParameters.length === 0 && this.callOmitsRequestBody({ request: request7, snippet });
+    if (request7.body != null && !omitBody) {
       const bodyArg = this.getBodyRequestArg({ body: request7.body, value: snippet.requestBody });
       if (!php_exports.TypeLiteral.isNop(bodyArg)) {
         args.push(bodyArg);
@@ -943193,6 +943235,21 @@ var EndpointSnippetGenerator4 = class {
     this.context.errors.unscope();
     return args;
   }
+  /**
+   * Whether the snippet's call leaves the request body out. `bodyRequired` absent means required,
+   * so a snippet only drops the argument when the API says the body is optional, the generator is
+   * configured to respect that, and the snippet supplies no body of its own.
+   */
+  callOmitsRequestBody({ request: request7, snippet }) {
+    if (this.context.customConfig?.respectOptionalRequestBody !== true) {
+      return false;
+    }
+    if (request7.bodyRequired !== false) {
+      return false;
+    }
+    const value2 = snippet.requestBody;
+    return value2 == null || typeof value2 === "object" && !Array.isArray(value2) && Object.keys(value2).length === 0;
+  }
   getBodyRequestArg({ body, value: value2 }) {
     switch (body.type) {
       case "bytes": {
@@ -946134,8 +946191,8 @@ var EndpointSnippetGenerator5 = class {
     this.context.errors.add({ severity: Severity.Warning, message });
   }
   getConstructorBasicAuthArg({ auth: auth8, values: values2 }) {
-    const usernameOmitted = "usernameOmit" in auth8 && auth8.usernameOmit === true;
-    const passwordOmitted = "passwordOmit" in auth8 && auth8.passwordOmit === true;
+    const usernameOmitted = auth8.usernameOmit === true;
+    const passwordOmitted = auth8.passwordOmit === true;
     const args = [];
     if (!usernameOmitted) {
       args.push({
@@ -946264,8 +946321,9 @@ var EndpointSnippetGenerator5 = class {
     const args = [];
     this.context.errors.scope(Scope4.PathParameters);
     const pathParameters = [...this.context.ir.pathParameters ?? [], ...request7.pathParameters ?? []];
+    const omitsRequestBody = this.callOmitsRequestBody({ request: request7, snippet });
     let bodyPropertyNames = /* @__PURE__ */ new Set();
-    if (request7.body != null) {
+    if (request7.body != null && !omitsRequestBody) {
       const bodyArgs = this.getBodyRequestArgs({ body: request7.body, value: snippet.requestBody });
       bodyPropertyNames = new Set(bodyArgs.map((arg) => arg.name));
       if (request7.body.type === "typeReference") {
@@ -946295,12 +946353,26 @@ var EndpointSnippetGenerator5 = class {
     }
     this.context.errors.unscope();
     this.context.errors.scope(Scope4.RequestBody);
-    if (request7.body != null) {
+    if (request7.body != null && !omitsRequestBody) {
       args.push(...this.getBodyRequestArgs({ body: request7.body, value: snippet.requestBody }));
     }
     this.context.errors.unscope();
     return args;
   }
+  /**
+   * Whether the call leaves the body out entirely, which the sentinel default allows. Applies
+   * only to a body the caller may omit, and only once the generator opts in to that.
+   */
+  callOmitsRequestBody({ request: request7, snippet }) {
+    if (this.context.customConfig.respect_optional_request_body !== true) {
+      return false;
+    }
+    if (request7.bodyRequired !== false) {
+      return false;
+    }
+    const value2 = snippet.requestBody;
+    return value2 == null || typeof value2 === "object" && !Array.isArray(value2) && Object.keys(value2).length === 0;
+  }
   getBodyRequestArgs({ body, value: value2 }) {
     switch (body.type) {
       case "bytes":
@@ -949529,7 +949601,7 @@ var EndpointSnippetGenerator6 = class {
       namedParameters: pathParameters,
       values: snippet.pathParameters
     }));
-    if (request7.body != null && snippet.requestBody != null) {
+    if (request7.body != null && snippet.requestBody != null && !this.callOmitsRequestBody({ request: request7, snippet })) {
       switch (request7.body.type) {
         case "bytes":
           this.context.errors.add({
@@ -949578,6 +949650,21 @@ var EndpointSnippetGenerator6 = class {
     }
     return args;
   }
+  /**
+   * When the generator is configured to respect optional request bodies and the IR marks
+   * the body as optional, a snippet whose example has no body omits the body arguments
+   * entirely rather than passing an empty object.
+   */
+  callOmitsRequestBody({ request: request7, snippet }) {
+    if (this.context.customConfig?.respectOptionalRequestBody !== true) {
+      return false;
+    }
+    if (request7.bodyRequired !== false) {
+      return false;
+    }
+    const value2 = snippet.requestBody;
+    return value2 == null || typeof value2 === "object" && !Array.isArray(value2) && Object.keys(value2).length === 0;
+  }
   getBodyArgsForNonObjectType({ namedType, typeRef, bodyValue }) {
     const args = [];
     switch (namedType.type) {
@@ -976451,7 +976538,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-1840-g533c4e6a082"
+    cli_version: "5.23.3-1852-g27d10f26ff8"
   };
 }
 function isAutomationMode() {
@@ -977283,7 +977370,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.23.3-1840-g533c4e6a082";
+    return "5.23.3-1852-g27d10f26ff8";
   }
   getCliName() {
     if (false) {

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "5.23.3-1840-g533c4e6a082",
+  "version": "5.23.3-1852-g27d10f26ff8",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",