💯 bussinboy

A small promise based wrapper for @fastify/busboy that focuses on ease of use and simplicity.

🛠️ Requirements

• Node.js >= 20

✨ Features

• Promise based
• 100% TypeScript
• Supports CJS and ESM
• Framework agnostic
• Doesn't allow fields without a name RFC 7578 Section 4.2
• Fixes an issue where @fastify/busboy becomes unresponsive when processing a field without a value
• Respects "fieldNameSize" limit that busboy and @fastify/busboy ignore (at least as of 12.06.2023)
• Introduces 4 new limits:
  • bodySize
  • totalFieldNamesSize
  • totalFieldsSize
  • totalFileSize
• Stops processing data after bodySize limit is reached (doesn't waste resources). Note: If you choose to use "bodySize" limit, make sure to append a "Connection": "close" header to the response. Aborting an upload and sending a response early in http1, before a request is fully read may cause most browsers to either:
  • Continue uploading payload
  • Hang and keep the connection open indefinitely
  • Show ERR_CONNECTION_RESET page instead of the response body

⚠️ Drawbacks

• Only supports multipart/form-data
• Allocates all files to buffers (no streams)

💾 Installation

1npm i @xxmichas/bussinboy

npm link

📖 Usage

1import { BussinboyErrorMessages, BussinboyEndUserError, BussinboyLimits, bussinboy } from "@xxmichas/bussinboy";
2
3const limits: BussinboyLimits = {
4  // ...
5};
6
7const errorMessages: BussinboyErrorMessages = {
8  // Define your own error messages here, so you can easily return them to the client
9  // instead of having to check BussinboyLimitError.code
10};
11
12try {
13  const data = await bussinboy({ headers, limits, errorMessages }, req);
14
15  const { fields, files } = data;
16  console.log(fields, files);
17
18  // ...
19} catch (error) {
20  let message = "Internal Server Error";
21  let status = 500;
22
23  if (error instanceof BussinboyEndUserError) {
24    // It's safe to return the error message to the client
25    message = error.message;
26    status = 413;
27  }
28
29  // ...
30}

📚 TODO

• Add more tests
• Add benchmarks