@xxmichas/bussinboy NPM

💯 bussinboy

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

🛠️ Requirements

Node.js >= 18

✨ 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

npm i @xxmichas/bussinboy

npm link

📖 Usage

import { BussinboyErrorMessages, BussinboyEndUserError, BussinboyLimits, bussinboy } from "@xxmichas/bussinboy";

const limits: BussinboyLimits = {
  // ...
};

const errorMessages: BussinboyErrorMessages = {
  // Define your own error messages here, so you can easily return them to the client
  // instead of having to check BussinboyLimitError.code
};

try {
  const data = await bussinboy({ headers, limits, errorMessages }, req);

  const { fields, files } = data;
  console.log(fields, files);

  // ...
} catch (error) {
  let message = "Internal Server Error";
  let status = 500;

  if (error instanceof BussinboyEndUserError) {
    // It's safe to return the error message to the client
    message = error.message;
    status = 413;
  }

  // ...
}