mailmark 0.1.2 → 0.1.3

package/README.md

@@ -1,6 +1,6 @@
 # mailmark
 
-Official Node.js SDK for the [DevMail](https://mailmark.io) transactional email API.
+Official Node.js SDK for the [Mailmark](https://mailmark.io) transactional email API.
 
 ## Installation
 
@@ -25,41 +25,204 @@ await client.send({
 });
 ```
 
-## API
+## API Reference
 
 ### `new Mailmark(apiKey, options?)`
 
 | Parameter | Type | Description |
 |-----------|------|-------------|
 | `apiKey` | `string` | Your API key from the Mailmark Developer dashboard |
-| `options.baseUrl` | `string` | Override the API base URL (for self-hosted) |
+| `options.baseUrl` | `string` | Override the API base URL (for self-hosted instances) |
 
-### `client.send(options)`
+---
+
+### Mailboxes
+
+#### `client.listMailboxes()`
+
+Returns all mailboxes on the API key's domain.
+
+```ts
+const mailboxes = await client.listMailboxes();
+// [{ id, address, fullAddress, displayName }, ...]
+```
+
+#### `client.createMailbox(options)`
+
+Creates a new mailbox. Pass only the local part of the address — the domain is appended automatically.
+
+```ts
+const mailbox = await client.createMailbox({
+  address: 'support',       // becomes support@yourdomain.com
+  displayName: 'Support Team',
+});
+```
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `address` | `string` | Yes | Local part of the address (e.g. `support`) |
+| `displayName` | `string` | No | Optional sender display name |
+
+#### `client.deleteMailbox(address)`
+
+Deletes a mailbox and all its emails. Pass either the local part (`"support"`) or the full address (`"support@yourdomain.com"`).
+
+```ts
+await client.deleteMailbox('support');
+```
+
+---
+
+### Sender Groups
+
+Sender groups define which mailboxes send to which recipient lists.
+
+#### `client.listSenderGroups()`
+
+Returns all sender groups on the API key's domain.
+
+```ts
+const groups = await client.listSenderGroups();
+// [{ id, name, mailboxIds, emails }, ...]
+```
+
+#### `client.createSenderGroup(options)`
+
+Creates a new sender group.
+
+```ts
+const group = await client.createSenderGroup({
+  name: 'Newsletter',
+  mailboxes: 'all',                          // or ['hello@yourdomain.com']
+  emails: ['alice@example.com', 'bob@example.com'],
+});
+```
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `name` | `string` | Yes | Group name |
+| `mailboxes` | `string[] \| "all"` | No | Sender mailbox addresses. Defaults to `"all"` |
+| `emails` | `string[]` | No | Initial recipient list |
+
+#### `client.updateSenderGroup(id, options)`
+
+Updates a sender group. All fields are optional.
+
+```ts
+await client.updateSenderGroup('group_id', {
+  name: 'Newsletter v2',
+  addEmails: ['carol@example.com'],
+  removeEmails: ['bob@example.com'],
+});
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `name` | `string` | Rename the group |
+| `emails` | `string[]` | Replace the entire recipient list |
+| `addEmails` | `string[]` | Add emails to the recipient list |
+| `removeEmails` | `string[]` | Remove emails from the recipient list |
+| `mailboxes` | `string[] \| "all"` | Replace the sender mailbox list |
+
+#### `client.deleteSenderGroup(id)`
+
+Deletes a sender group by ID.
+
+```ts
+await client.deleteSenderGroup('group_id');
+```
+
+---
+
+### Send Email
+
+#### `client.send(options)`
+
+Sends an email from a mailbox on the API key's domain.
+
+```ts
+// Transactional (default) — one email to all recipients together
+await client.send({
+  from: 'hello@yourdomain.com',
+  to: ['alice@example.com', 'bob@example.com'],
+  subject: 'Welcome',
+  html: '<p>Hello!</p>',
+});
+
+// Campaign — one individual email per recipient, tracked under a shared batchId
+await client.send({
+  from: 'hello@yourdomain.com',
+  to: ['alice@example.com', 'bob@example.com'],
+  subject: 'Our newsletter',
+  html: '<p>This month in Mailmark...</p>',
+  type: 'campaign',
+});
+
+// Scheduled — send at a future time (Unix ms timestamp)
+await client.send({
+  from: 'hello@yourdomain.com',
+  to: 'alice@example.com',
+  subject: 'Reminder',
+  text: 'Just a reminder!',
+  scheduledAt: Date.now() + 60 * 60 * 1000, // 1 hour from now
+});
+```
 
 | Field | Type | Required | Description |
 |-------|------|----------|-------------|
-| `from` | `string` | Yes | Sender address — must belong to the API key's domain |
-| `to` | `string \| string[]` | Yes | Recipient address(es) |
-| `subject` | `string` | Yes | Email subject |
+| `from` | `string` | Yes | Sender address — must be an existing mailbox on the domain |
+| `to` | `string \| string[]` | Yes | One or more recipient addresses |
+| `subject` | `string` | Yes | Email subject line |
 | `html` | `string` | One of | HTML email body |
-| `text` | `string` | One of | Plain-text body (used if html is omitted) |
+| `text` | `string` | One of | Plain-text body (used when `html` is not provided) |
+| `type` | `"transactional" \| "campaign"` | No | Defaults to `"transactional"` |
+| `scheduledAt` | `number` | No | Future Unix ms timestamp to schedule the send |
 
-Returns `Promise<{ messageId: string; status: "queued" }>`.
+**Returns** `Promise<SendEmailResult>`:
 
-Throws `MailmarkError` on API errors, with `.status` (HTTP status) and `.response` (parsed body).
+| Field | Description |
+|-------|-------------|
+| `messageId` | Present for transactional sends |
+| `messageIds` | Present for campaign sends (one per recipient) |
+| `batchId` | Present for campaign sends |
+| `status` | `"queued"` or `"scheduled"` |
 
-## cURL Equivalent
+---
+
+## Error Handling
+
+All API errors throw a `MailmarkError` with:
+
+- `.message` — human-readable error description
+- `.status` — HTTP status code
+- `.response` — parsed response body
+
+```ts
+import { Mailmark, MailmarkError } from 'mailmark';
+
+try {
+  await client.send({ ... });
+} catch (err) {
+  if (err instanceof MailmarkError) {
+    console.error(err.status, err.message);
+  }
+}
+```
+
+---
+
+## cURL Reference
 
 ```bash
+# List mailboxes
+curl https://harmless-armadillo-386.convex.site/v1/mailboxes \
+  -H "Authorization: Bearer dm_live_your_key"
+
+# Send email
 curl -X POST https://harmless-armadillo-386.convex.site/v1/send \
-  -H "Authorization: Bearer dm_live_your_api_key" \
+  -H "Authorization: Bearer dm_live_your_key" \
   -H "Content-Type: application/json" \
-  -d '{
-    "from": "hello@yourdomain.com",
-    "to": ["recipient@example.com"],
-    "subject": "Hello",
-    "html": "<p>Hello!</p>"
-  }'
+  -d '{"from":"hello@yourdomain.com","to":["recipient@example.com"],"subject":"Hello","html":"<p>Hello!</p>"}'
 ```
 
 ## License

package/dist/index.d.ts

@@ -1,5 +1,17 @@
+export interface Mailbox {
+    id: string;
+    address: string;
+    fullAddress: string;
+    displayName: string | null;
+}
+export interface SenderGroup {
+    id: string;
+    name: string;
+    mailboxIds: string[];
+    emails: string[];
+}
 export interface SendEmailOptions {
-    /** Sender address — must be a mailbox on the API key's scoped domain. */
+    /** Sender address — must be an existing mailbox on the API key's domain. */
     from: string;
     /** One or more recipient addresses. */
     to: string | string[];
@@ -7,12 +19,57 @@ export interface SendEmailOptions {
     subject: string;
     /** HTML body. Either html or text (or both) is required. */
     html?: string;
-    /** Plain-text body. Used if html is not provided. */
+    /** Plain-text body. Used when html is not provided. */
     text?: string;
+    /**
+     * "transactional" (default) — sends one email to all recipients.
+     * "campaign" — sends a separate individual email to each recipient,
+     * tracked under a shared batchId.
+     */
+    type?: "transactional" | "campaign";
+    /**
+     * Schedule the email for a future time.
+     * Unix millisecond timestamp (e.g. Date.now() + 60_000).
+     * Must be in the future.
+     */
+    scheduledAt?: number;
 }
 export interface SendEmailResult {
-    messageId: string;
-    status: "queued";
+    /** Present for transactional sends. */
+    messageId?: string;
+    /** Present for campaign sends (one per recipient). */
+    messageIds?: string[];
+    /** Present for campaign sends. */
+    batchId?: string;
+    status: "queued" | "scheduled";
+}
+export interface CreateMailboxOptions {
+    address: string;
+    displayName?: string;
+}
+export interface CreateSenderGroupOptions {
+    name: string;
+    /**
+     * Mailbox addresses to include as senders.
+     * Pass "all" to include every mailbox on the domain (default).
+     */
+    mailboxes?: string[] | "all";
+    /** Initial recipient email list. */
+    emails?: string[];
+}
+export interface UpdateSenderGroupOptions {
+    name?: string;
+    /** Replace the entire recipient list. */
+    emails?: string[];
+    /** Add emails to the recipient list (merged with existing). */
+    addEmails?: string[];
+    /** Remove emails from the recipient list. */
+    removeEmails?: string[];
+    /**
+     * Replace the sender mailbox list.
+     * Pass "all" to include every mailbox on the domain.
+     */
+    mailboxes?: string[] | "all";
 }
 export interface MailmarkOptions {
     /** Override the default API base URL. Useful for self-hosted instances. */
@@ -27,6 +84,41 @@ export declare class Mailmark {
     private readonly apiKey;
     private readonly baseUrl;
     constructor(apiKey: string, options?: MailmarkOptions);
+    private request;
+    /** List all mailboxes on the API key's domain. */
+    listMailboxes(): Promise<Mailbox[]>;
+    /**
+     * Create a new mailbox on the API key's domain.
+     * The domain suffix is appended automatically.
+     */
+    createMailbox(options: CreateMailboxOptions): Promise<Mailbox>;
+    /**
+     * Delete a mailbox and all its emails.
+     * Pass either the local part ("hello") or the full address ("hello@domain.com").
+     */
+    deleteMailbox(address: string): Promise<void>;
+    /** List all sender groups for the API key's domain. */
+    listSenderGroups(): Promise<SenderGroup[]>;
+    /**
+     * Create a sender group.
+     * Groups define which mailboxes send and which recipient emails they target.
+     */
+    createSenderGroup(options: CreateSenderGroupOptions): Promise<SenderGroup>;
+    /**
+     * Update a sender group. All fields are optional.
+     * Use addEmails / removeEmails for incremental changes to the recipient list,
+     * or emails to replace the entire list at once.
+     */
+    updateSenderGroup(id: string, options: UpdateSenderGroupOptions): Promise<SenderGroup>;
+    /** Delete a sender group by ID. */
+    deleteSenderGroup(id: string): Promise<void>;
+    /**
+     * Send an email from a mailbox on the API key's domain.
+     *
+     * - type "transactional" (default): one email to all recipients together.
+     * - type "campaign": one individual email per recipient, all tracked under a shared batchId.
+     * - scheduledAt: schedule for a future unix ms timestamp instead of sending now.
+     */
     send(options: SendEmailOptions): Promise<SendEmailResult>;
 }
 export default Mailmark;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,QAAQ,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,aAAc,SAAQ,KAAK;aAGpB,MAAM,EAAE,MAAM;aACd,QAAQ,EAAE,OAAO;gBAFjC,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO;CAKpC;AAID,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB;IAMnD,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;CAqChE;AAED,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,IAAI,CAAC,EAAE,eAAe,GAAG,UAAU,CAAC;IACpC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAC7B,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,qBAAa,aAAc,SAAQ,KAAK;aAGpB,MAAM,EAAE,MAAM;aACd,QAAQ,EAAE,OAAO;gBAFjC,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO;CAKpC;AAMD,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB;YAM3C,OAAO;IAyBrB,kDAAkD;IAClD,aAAa,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAInC;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAK9D;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnD,uDAAuD;IACvD,gBAAgB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAI1C;;;OAGG;IACH,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC;IAS1E;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC;IAKtF,mCAAmC;IAC7B,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlD;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;CAoB1D;AAED,eAAe,QAAQ,CAAC"}

package/dist/index.js

@@ -52,12 +52,58 @@ class Mailmark {
   baseUrl;
   constructor(apiKey, options = {}) {
     if (!apiKey)
-      throw new Error("DevMail API key is required");
+      throw new Error("Mailmark API key is required");
     this.apiKey = apiKey;
     this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
   }
-  async send(options) {
-    const { from, to, subject, html, text } = options;
+  async request(method, path, body) {
+    const res = await fetch(`${this.baseUrl}${path}`, {
+      method,
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`,
+        "Content-Type": "application/json"
+      },
+      ...body !== undefined ? { body: JSON.stringify(body) } : {}
+    });
+    const data = await res.json();
+    if (!res.ok) {
+      throw new MailmarkError(data.error ?? `Request failed with status ${res.status}`, res.status, data);
+    }
+    return data;
+  }
+  listMailboxes() {
+    return this.request("GET", "/v1/mailboxes");
+  }
+  createMailbox(options) {
+    if (!options.address)
+      throw new Error('"address" is required');
+    return this.request("POST", "/v1/mailboxes", options);
+  }
+  async deleteMailbox(address) {
+    await this.request("DELETE", `/v1/mailboxes/${encodeURIComponent(address)}`);
+  }
+  listSenderGroups() {
+    return this.request("GET", "/v1/sender-groups");
+  }
+  createSenderGroup(options) {
+    if (!options.name)
+      throw new Error('"name" is required');
+    return this.request("POST", "/v1/sender-groups", {
+      name: options.name,
+      mailboxes: options.mailboxes ?? "all",
+      emails: options.emails ?? []
+    });
+  }
+  updateSenderGroup(id, options) {
+    if (!id)
+      throw new Error('"id" is required');
+    return this.request("PATCH", `/v1/sender-groups/${encodeURIComponent(id)}`, options);
+  }
+  async deleteSenderGroup(id) {
+    await this.request("DELETE", `/v1/sender-groups/${encodeURIComponent(id)}`);
+  }
+  send(options) {
+    const { from, to, subject, html, text, type, scheduledAt } = options;
     if (!from)
       throw new Error('"from" is required');
     if (!to || Array.isArray(to) && to.length === 0)
@@ -66,26 +112,17 @@ class Mailmark {
       throw new Error('"subject" is required');
     if (!html && !text)
       throw new Error('Either "html" or "text" is required');
-    const body = {
+    if (scheduledAt !== undefined && scheduledAt <= Date.now())
+      throw new Error('"scheduledAt" must be a future timestamp');
+    return this.request("POST", "/v1/send", {
       from,
       to: Array.isArray(to) ? to : [to],
       subject,
       ...html ? { html } : {},
-      ...text ? { text } : {}
-    };
-    const res = await fetch(`${this.baseUrl}/v1/send`, {
-      method: "POST",
-      headers: {
-        Authorization: `Bearer ${this.apiKey}`,
-        "Content-Type": "application/json"
-      },
-      body: JSON.stringify(body)
+      ...text ? { text } : {},
+      ...type ? { type } : {},
+      ...scheduledAt !== undefined ? { scheduledAt } : {}
     });
-    const data = await res.json();
-    if (!res.ok) {
-      throw new MailmarkError(data.error ?? `Request failed with status ${res.status}`, res.status, data);
-    }
-    return data;
   }
 }
 var src_default = Mailmark;

package/dist/index.mjs

@@ -16,12 +16,58 @@ class Mailmark {
   baseUrl;
   constructor(apiKey, options = {}) {
     if (!apiKey)
-      throw new Error("DevMail API key is required");
+      throw new Error("Mailmark API key is required");
     this.apiKey = apiKey;
     this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
   }
-  async send(options) {
-    const { from, to, subject, html, text } = options;
+  async request(method, path, body) {
+    const res = await fetch(`${this.baseUrl}${path}`, {
+      method,
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`,
+        "Content-Type": "application/json"
+      },
+      ...body !== undefined ? { body: JSON.stringify(body) } : {}
+    });
+    const data = await res.json();
+    if (!res.ok) {
+      throw new MailmarkError(data.error ?? `Request failed with status ${res.status}`, res.status, data);
+    }
+    return data;
+  }
+  listMailboxes() {
+    return this.request("GET", "/v1/mailboxes");
+  }
+  createMailbox(options) {
+    if (!options.address)
+      throw new Error('"address" is required');
+    return this.request("POST", "/v1/mailboxes", options);
+  }
+  async deleteMailbox(address) {
+    await this.request("DELETE", `/v1/mailboxes/${encodeURIComponent(address)}`);
+  }
+  listSenderGroups() {
+    return this.request("GET", "/v1/sender-groups");
+  }
+  createSenderGroup(options) {
+    if (!options.name)
+      throw new Error('"name" is required');
+    return this.request("POST", "/v1/sender-groups", {
+      name: options.name,
+      mailboxes: options.mailboxes ?? "all",
+      emails: options.emails ?? []
+    });
+  }
+  updateSenderGroup(id, options) {
+    if (!id)
+      throw new Error('"id" is required');
+    return this.request("PATCH", `/v1/sender-groups/${encodeURIComponent(id)}`, options);
+  }
+  async deleteSenderGroup(id) {
+    await this.request("DELETE", `/v1/sender-groups/${encodeURIComponent(id)}`);
+  }
+  send(options) {
+    const { from, to, subject, html, text, type, scheduledAt } = options;
     if (!from)
       throw new Error('"from" is required');
     if (!to || Array.isArray(to) && to.length === 0)
@@ -30,26 +76,17 @@ class Mailmark {
       throw new Error('"subject" is required');
     if (!html && !text)
       throw new Error('Either "html" or "text" is required');
-    const body = {
+    if (scheduledAt !== undefined && scheduledAt <= Date.now())
+      throw new Error('"scheduledAt" must be a future timestamp');
+    return this.request("POST", "/v1/send", {
       from,
       to: Array.isArray(to) ? to : [to],
       subject,
       ...html ? { html } : {},
-      ...text ? { text } : {}
-    };
-    const res = await fetch(`${this.baseUrl}/v1/send`, {
-      method: "POST",
-      headers: {
-        Authorization: `Bearer ${this.apiKey}`,
-        "Content-Type": "application/json"
-      },
-      body: JSON.stringify(body)
+      ...text ? { text } : {},
+      ...type ? { type } : {},
+      ...scheduledAt !== undefined ? { scheduledAt } : {}
     });
-    const data = await res.json();
-    if (!res.ok) {
-      throw new MailmarkError(data.error ?? `Request failed with status ${res.status}`, res.status, data);
-    }
-    return data;
   }
 }
 var src_default = Mailmark;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mailmark",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Official Node.js SDK for the Mailmark transactional email API",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",