Release 3.3.0 - files.update fix, multipart form-data handling

[david-ruiz-cko]

This release improves multipart form-data handling in HTTP requests, specifically ensuring that FormData is properly serialized and sent in API calls. The changes fix a bug where the form-data instance was previously string-coerced (resulting in an invalid request body), and add comprehensive regression tests to prevent this issue from recurring.

HTTP request handling improvements:

• Added a formDataToBuffer utility to serialize FormData streams into a buffer, ensuring multipart bodies are transmitted correctly in HTTP requests.
• Updated the HTTP request logic to use the new buffer serialization for FormData, preventing accidental string coercion and ensuring the correct Content-Type and body format.
• Enhanced header generation to merge headers from FormData instances when present, ensuring the multipart boundary is set correctly.
• Imported Node's Writable stream to support the new buffer serialization logic.

Testing and regression coverage:

• Improved and expanded tests in test/files/files.js to verify that multipart requests include the correct fields and headers, and added a regression test for issue files.upload fails with purpose_required / purpose_invalid — API only accepts purpose as query param #418 to ensure the bug does not reoccur. [1] [2]

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud