> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bosonware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Release history for the BosonMail SDK: new features, fixes, and upgrade guidance for each version.

This page tracks releases of `@bosonware-ent/bosonmail`. Newest first.

**0.2.1**

October 30, 2026

## Bug fixes

* Fixed JSON send requests: `to`, `cc`, and `bcc` are now sent as comma-separated strings instead of arrays in JSON request bodies. This aligns JSON serialization with the multipart behavior and resolves compatibility issues with API expectations.

## Upgrade notes

If you are on 0.2.0, upgrade to 0.2.1 to ensure recipient arrays serialize correctly in JSON requests. No code changes are required.

```bash theme={null}
npm install @bosonware-ent/bosonmail@latest
```

**0.2.0**

October 29, 2026

## New features

* Added `timeoutMs` constructor option (default 30,000 ms) with per-request `AbortController` timeout support.
* Added `cc` and `bcc` support in `sendEmail`.
* Added attachment support via multipart `form-data`. Up to 10 files, 10 MB each, 20 MB total.
* Added `getEmailStatus(messageId)` for delivery status lookups.
* Expanded `Result` shape: now includes `statusCode`, `id`, `messageId`, and `status` fields.
* Added client-side validation for recipients, subject, body, text/html, and attachments.
* Exported TypeScript types: `Result`, `SendEmailBody`, `SendAttachment`, `EmailStatusResult`, `EmailStatusData`, `EmailSentStatus`, `BosonMailClientOptions`.

## Changes

* `text` is now optional in `SendEmailBody`. You must provide at least one of `text` or `html`.

## Upgrade notes from 0.1.0

Basic `sendEmail(to, subject, { text })` calls remain compatible. To use new features:

* Add `timeoutMs` to the constructor if you want a non-default timeout.
* Pass `cc`, `bcc`, or `attachments` in the body object.
* Read `result.messageId` and `result.status` from the returned `Result`.
* Use `getEmailStatus` to poll delivery state.

**0.1.0**

October 27, 2026

## Initial release

* `constructor({ apiKey, baseUrl? })`
* `sendEmail(to, subject, { text (required), html? })` returning `{ success, errorMessage? }`
* ESM-only, zero runtime dependencies
* TypeScript declarations included

> [!NOTE]
>
> Version 0.0.0-stage is a placeholder and not a real release. Do not install it.

## Version history on npm

View all published versions on the [npm versions page](https://www.npmjs.com/package/@bosonware-ent/bosonmail?activeTab=versions).

## Next steps

> [card] [Installation](https://docs.bosonware.com/installation.md)
>
> Install the latest version and verify your environment.

> [card] [Quickstart](https://docs.bosonware.com/quickstart.md)
>
> Send your first email with the current SDK.

> [card] [Support](https://docs.bosonware.com/resources/support.md)
>
> Report issues or ask questions about a specific release.

> [card] [npm package](https://www.npmjs.com/package/@bosonware-ent/bosonmail)
>
> View the package on npm.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.