retransmit.dev 0.1.2 → 0.3.0

package/README.md

@@ -1,12 +1,12 @@
 # retransmit.dev
 
-Node.js SDK for the [Retransmit](https://retransmit.dev) messaging API. Send email and SMS through one typed client; WhatsApp support is coming soon. Zero dependencies, works on Node 18+ and edge runtimes with `fetch`.
+Node.js SDK for the [Retransmit](https://retransmit.dev) messaging API. Send email, SMS, and WhatsApp through one typed client. Zero dependencies, works on Node 18+ and edge runtimes with `fetch`.
 
 | Channel | SDK namespace | Availability |
 | --- | --- | --- |
 | Email | `retransmit.emails` | Available |
 | SMS | `retransmit.sms` | Available |
-| WhatsApp | `retransmit.whatsapp` | Coming soon; not included in the current release |
+| WhatsApp | `retransmit.whatsapp` | Available |
 
 ## Install
 
@@ -51,6 +51,57 @@ const { data } = await retransmit.emails.get("em_xxxxxxxxxxxx");
 console.log(data?.status); // "delivered"
 ```
 
+### Tags
+
+Attach up to 10 `{ name, value }` tags to an email to label it. Filter by
+them in the dashboard or with `emails.list`. Tags come back on `emails.get`
+and are never sent to the recipient.
+
+```ts
+await retransmit.emails.send({
+  from: "Acme <hello@yourdomain.com>",
+  to: "user@example.com",
+  subject: "Your receipt",
+  html: "<p>Thanks for your order!</p>",
+  tags: [
+    { name: "category", value: "receipt" },
+    { name: "campaign", value: "spring-2026" },
+  ],
+});
+```
+
+Names and values allow letters, digits, underscores and dashes, up to 256
+characters each. Names must be unique within one email. Batch emails accept
+the same `tags` field.
+
+### List and filter emails
+
+`emails.list` returns your emails newest first. Every tag you pass must match.
+Combine with `status` or `batchId`, and page with `cursor`:
+
+```ts
+const { data } = await retransmit.emails.list({
+  tags: [{ name: "campaign", value: "spring-2026" }],
+  status: "bounced",
+  limit: 100,
+});
+
+for (const email of data!.emails) {
+  console.log(email.id, email.to, email.status, email.tags);
+}
+
+if (data!.has_more) {
+  await retransmit.emails.list({ cursor: data!.next_cursor!, /* same filters */ });
+}
+```
+
+To see which tags exist on your account, and how many emails carry each:
+
+```ts
+const { data } = await retransmit.emails.tags();
+// data.tags: [{ name: "campaign", value: "spring-2026", count: 1240 }, ...]
+```
+
 ## SMS
 
 Use international E.164 phone numbers. A single request can contain up to 50
@@ -93,10 +144,33 @@ console.log(progress?.processed, "/", progress?.total, progress?.counts);
 
 ## WhatsApp
 
-WhatsApp is the next planned channel. The intended SDK namespace is
-`retransmit.whatsapp`, but it is deliberately not exported yet because the
-production endpoint and request types are still being finalized. This keeps
-the current SDK honest while reserving a consistent channel-based API shape.
+Connect your WhatsApp Business number in the dashboard first. One recipient
+per request, in E.164 format. Start a conversation with an approved template;
+once the recipient replies you can send free-form text and media for 24 hours.
+
+```ts
+const { data, error } = await retransmit.whatsapp.send({
+  to: "+237670000000",
+  type: "template",
+  template: {
+    name: "verification_code",
+    language: "en_US",
+    components: [{ type: "body", parameters: [{ type: "text", text: "482913" }] }],
+  },
+});
+
+// Inside the 24-hour window:
+await retransmit.whatsapp.send({ to: "+237670000000", text: "Anything else we can help with?" });
+```
+
+Check the outcome, including `read` receipts:
+
+```ts
+const { data } = await retransmit.whatsapp.get("wa_xxxxxxxxxxxx");
+console.log(data?.status); // "sent" | "delivered" | "read" | "failed"
+```
+
+Replies from recipients reach you as `whatsapp.received` webhooks.
 
 ## Error handling
 

package/dist/index.cjs

@@ -25,7 +25,9 @@ __export(index_exports, {
   Emails: () => Emails,
   Retransmit: () => Retransmit,
   SMS_STATUSES: () => SMS_STATUSES,
-  Sms: () => Sms
+  Sms: () => Sms,
+  WHATSAPP_STATUSES: () => WHATSAPP_STATUSES,
+  Whatsapp: () => Whatsapp
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -40,7 +42,8 @@ function toWirePayload(options) {
     subject: options.subject,
     html: options.html,
     text: options.text,
-    marketing: options.marketing
+    marketing: options.marketing,
+    tags: options.tags
   };
 }
 var Emails = class {
@@ -56,6 +59,23 @@ var Emails = class {
   get(id) {
     return this.client.request("GET", `/v1/emails/${encodeURIComponent(id)}`);
   }
+  /**
+   * Lists your emails, newest first, optionally filtered by tags, status or
+   * batch. Pass `next_cursor` back as `cursor` to page through the results.
+   */
+  list(options = {}) {
+    return this.client.request("GET", "/v1/emails", void 0, {
+      tag: options.tags?.map((tag) => `${tag.name}:${tag.value}`),
+      status: options.status,
+      batch_id: options.batchId,
+      limit: options.limit,
+      cursor: options.cursor
+    });
+  }
+  /** Every distinct tag on your emails, with a count of emails carrying it. */
+  tags() {
+    return this.client.request("GET", "/v1/emails/tags");
+  }
 };
 
 // src/batch.ts
@@ -96,15 +116,45 @@ var Sms = class {
   }
 };
 
+// src/whatsapp.ts
+var Whatsapp = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Queues a single WhatsApp message to one recipient. Poll `get(id)` or
+   * subscribe to webhooks for the outcome; replies arrive as
+   * `whatsapp.received` webhooks.
+   */
+  send(options) {
+    return this.client.request("POST", "/v1/whatsapp", {
+      from: options.from,
+      to: options.to,
+      type: options.type,
+      text: options.text,
+      preview_url: options.previewUrl,
+      template: options.template,
+      image: options.image,
+      document: options.document
+    });
+  }
+  /** Retrieves a WhatsApp message with its current status and event history. */
+  get(id) {
+    return this.client.request("GET", `/v1/whatsapp/${encodeURIComponent(id)}`);
+  }
+};
+
 // src/retransmit.ts
 var DEFAULT_BASE_URL = "https://api.retransmit.dev";
-var USER_AGENT = "retransmit.dev-node/0.1.0";
+var USER_AGENT = "retransmit.dev-node/0.3.0";
 function readEnv(name) {
   return typeof process !== "undefined" ? process.env?.[name] : void 0;
 }
 var Retransmit = class {
   emails = new Emails(this);
   sms = new Sms(this);
+  whatsapp = new Whatsapp(this);
   batch = new Batch(this);
   apiKey;
   baseUrl;
@@ -122,10 +172,17 @@ var Retransmit = class {
     );
   }
   /** Internal transport shared by the resource classes. API failures are returned, never thrown. */
-  async request(method, path, body) {
+  async request(method, path, body, query) {
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(query ?? {})) {
+      if (value === void 0) continue;
+      for (const item of Array.isArray(value) ? value : [value]) params.append(key, String(item));
+    }
+    const encoded = params.toString();
+    const search = encoded ? `?${encoded}` : "";
     let response;
     try {
-      response = await fetch(`${this.baseUrl}${path}`, {
+      response = await fetch(`${this.baseUrl}${path}${search}`, {
         method,
         headers: {
           Authorization: `Bearer ${this.apiKey}`,
@@ -187,6 +244,7 @@ var SMS_STATUSES = [
   "rejected",
   "failed"
 ];
+var WHATSAPP_STATUSES = ["queued", "sent", "delivered", "read", "failed"];
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Batch,
@@ -194,5 +252,7 @@ var SMS_STATUSES = [
   Emails,
   Retransmit,
   SMS_STATUSES,
-  Sms
+  Sms,
+  WHATSAPP_STATUSES,
+  Whatsapp
 });

package/dist/index.d.cts

@@ -39,6 +39,18 @@ interface SendEmailOptions {
      * headers, and skips recipients who already unsubscribed.
      */
     marketing?: boolean;
+    /**
+     * Up to 10 labels for filtering emails in the dashboard, for example
+     * `[{ name: "campaign", value: "outreach-1" }]`. Names and values allow
+     * letters, digits, underscores and dashes, up to 256 characters each.
+     * Names must be unique within one email. Tags are returned by `emails.get`
+     * and are never sent to the recipient.
+     */
+    tags?: EmailTag[];
+}
+interface EmailTag {
+    name: string;
+    value: string;
 }
 interface SendEmailResponse {
     id: string;
@@ -59,12 +71,55 @@ interface GetEmailResponse {
     reply_to: string[] | null;
     subject: string;
     marketing: boolean;
+    tags: EmailTag[];
     status: EmailStatus;
     error: string | null;
     created_at: string;
     last_event_at: string | null;
     events: EmailEvent[];
 }
+interface ListEmailsOptions {
+    /**
+     * Only emails carrying every one of these tags, for example
+     * `[{ name: "campaign", value: "outreach-1" }]`.
+     */
+    tags?: EmailTag[];
+    status?: EmailStatus;
+    /** Only emails sent as part of this batch. */
+    batchId?: string;
+    /** Page size, 1 to 100. Defaults to 50. */
+    limit?: number;
+    /** `next_cursor` from the previous page. */
+    cursor?: string;
+}
+/** One row of `emails.list`. Call `emails.get(id)` for the event history. */
+interface EmailSummary {
+    id: string;
+    batch_id: string | null;
+    from: string;
+    to: string[];
+    subject: string;
+    marketing: boolean;
+    tags: EmailTag[];
+    status: EmailStatus;
+    error: string | null;
+    created_at: string;
+    last_event_at: string | null;
+}
+interface ListEmailsResponse {
+    /** Newest first. */
+    emails: EmailSummary[];
+    has_more: boolean;
+    /** Pass back as `cursor` to fetch the next page. `null` on the last page. */
+    next_cursor: string | null;
+}
+interface EmailTagCount extends EmailTag {
+    /** How many of your emails carry this tag. */
+    count: number;
+}
+interface ListEmailTagsResponse {
+    tags: EmailTagCount[];
+}
 declare const SMS_STATUSES: readonly ["queued", "sent", "delivered", "undelivered", "expired", "rejected", "failed"];
 type SmsStatus = (typeof SMS_STATUSES)[number];
 interface SendSmsOptions {
@@ -106,6 +161,81 @@ interface GetSmsResponse {
     last_event_at: string | null;
     events: SmsEvent[];
 }
+declare const WHATSAPP_STATUSES: readonly ["queued", "sent", "delivered", "read", "failed"];
+type WhatsappStatus = (typeof WHATSAPP_STATUSES)[number];
+type WhatsappMessageType = "text" | "template" | "image" | "document";
+interface WhatsappTemplate {
+    /** Template name as approved in WhatsApp Manager. */
+    name: string;
+    /** Language code the template was approved for, e.g. `en_US`. */
+    language: string;
+    /** Meta `components` (header/body/button parameters), passed through verbatim. */
+    components?: Record<string, unknown>[];
+}
+interface WhatsappMedia {
+    /** Public HTTPS link fetched at send time. */
+    link: string;
+    caption?: string;
+}
+interface WhatsappDocument extends WhatsappMedia {
+    /** File name shown to the recipient. */
+    filename?: string;
+}
+interface SendWhatsappOptions {
+    /**
+     * Connected number to send from, in international format. Optional when
+     * your organization has a single WhatsApp number.
+     */
+    from?: string;
+    /** One recipient in international format (`+237670000000`). */
+    to: string;
+    /** Defaults to `text`. */
+    type?: WhatsappMessageType;
+    /** Body for `text` messages (up to 4,096 characters), or a media caption. */
+    text?: string;
+    /** Render a preview for the first link in a `text` message. */
+    previewUrl?: boolean;
+    /** Required for `type: "template"`. Needed to start a conversation outside the 24h window. */
+    template?: WhatsappTemplate;
+    /** Required for `type: "image"`. */
+    image?: WhatsappMedia;
+    /** Required for `type: "document"`. */
+    document?: WhatsappDocument;
+}
+interface SendWhatsappResponse {
+    id: string;
+    status: "queued";
+    type: WhatsappMessageType;
+    /** The connected number the message goes out from. */
+    from: string;
+    /** ISO 3166-1 alpha-2 destination country detected from the number prefix. */
+    country: string | null;
+    created_at: string;
+}
+interface WhatsappEvent {
+    type: string;
+    created_at: string;
+}
+interface GetWhatsappResponse {
+    id: string;
+    from: string;
+    to: string;
+    country: string | null;
+    type: WhatsappMessageType;
+    text: string | null;
+    preview_url: boolean;
+    template: WhatsappTemplate | null;
+    media: WhatsappDocument | null;
+    /** Upstream provider that carried the message, e.g. `meta`. */
+    provider: string | null;
+    /** Provider-side message id (`wamid.…` on Meta); inbound replies reference it. */
+    provider_message_id: string | null;
+    status: WhatsappStatus;
+    error: string | null;
+    created_at: string;
+    last_event_at: string | null;
+    events: WhatsappEvent[];
+}
 interface SendBatchResponse {
     id: string;
     total: number;
@@ -138,6 +268,13 @@ declare class Emails {
     send(options: SendEmailOptions): Promise<Result<SendEmailResponse>>;
     /** Retrieves an email with its current status and event history. */
     get(id: string): Promise<Result<GetEmailResponse>>;
+    /**
+     * Lists your emails, newest first, optionally filtered by tags, status or
+     * batch. Pass `next_cursor` back as `cursor` to page through the results.
+     */
+    list(options?: ListEmailsOptions): Promise<Result<ListEmailsResponse>>;
+    /** Every distinct tag on your emails, with a count of emails carrying it. */
+    tags(): Promise<Result<ListEmailTagsResponse>>;
 }
 
 declare class Sms {
@@ -149,15 +286,29 @@ declare class Sms {
     get(id: string): Promise<Result<GetSmsResponse>>;
 }
 
+declare class Whatsapp {
+    private readonly client;
+    constructor(client: Retransmit);
+    /**
+     * Queues a single WhatsApp message to one recipient. Poll `get(id)` or
+     * subscribe to webhooks for the outcome; replies arrive as
+     * `whatsapp.received` webhooks.
+     */
+    send(options: SendWhatsappOptions): Promise<Result<SendWhatsappResponse>>;
+    /** Retrieves a WhatsApp message with its current status and event history. */
+    get(id: string): Promise<Result<GetWhatsappResponse>>;
+}
+
 declare class Retransmit {
     readonly emails: Emails;
     readonly sms: Sms;
+    readonly whatsapp: Whatsapp;
     readonly batch: Batch;
     private readonly apiKey;
     private readonly baseUrl;
     constructor(apiKey?: string, options?: RetransmitOptions);
     /** Internal transport shared by the resource classes. API failures are returned, never thrown. */
-    request<T>(method: "GET" | "POST", path: string, body?: unknown): Promise<Result<T>>;
+    request<T>(method: "GET" | "POST", path: string, body?: unknown, query?: Record<string, string | number | string[] | undefined>): Promise<Result<T>>;
 }
 
-export { Batch, EMAIL_STATUSES, type EmailEvent, type EmailStatus, Emails, type GetBatchResponse, type GetEmailResponse, type GetSmsResponse, type Result, Retransmit, type RetransmitError, type RetransmitOptions, SMS_STATUSES, type SendBatchResponse, type SendEmailOptions, type SendEmailResponse, type SendSmsOptions, type SendSmsResponse, Sms, type SmsEvent, type SmsStatus };
+export { Batch, EMAIL_STATUSES, type EmailEvent, type EmailStatus, type EmailSummary, type EmailTag, type EmailTagCount, Emails, type GetBatchResponse, type GetEmailResponse, type GetSmsResponse, type GetWhatsappResponse, type ListEmailTagsResponse, type ListEmailsOptions, type ListEmailsResponse, type Result, Retransmit, type RetransmitError, type RetransmitOptions, SMS_STATUSES, type SendBatchResponse, type SendEmailOptions, type SendEmailResponse, type SendSmsOptions, type SendSmsResponse, type SendWhatsappOptions, type SendWhatsappResponse, Sms, type SmsEvent, type SmsStatus, WHATSAPP_STATUSES, Whatsapp, type WhatsappDocument, type WhatsappEvent, type WhatsappMedia, type WhatsappMessageType, type WhatsappStatus, type WhatsappTemplate };

package/dist/index.d.ts

@@ -39,6 +39,18 @@ interface SendEmailOptions {
      * headers, and skips recipients who already unsubscribed.
      */
     marketing?: boolean;
+    /**
+     * Up to 10 labels for filtering emails in the dashboard, for example
+     * `[{ name: "campaign", value: "outreach-1" }]`. Names and values allow
+     * letters, digits, underscores and dashes, up to 256 characters each.
+     * Names must be unique within one email. Tags are returned by `emails.get`
+     * and are never sent to the recipient.
+     */
+    tags?: EmailTag[];
+}
+interface EmailTag {
+    name: string;
+    value: string;
 }
 interface SendEmailResponse {
     id: string;
@@ -59,12 +71,55 @@ interface GetEmailResponse {
     reply_to: string[] | null;
     subject: string;
     marketing: boolean;
+    tags: EmailTag[];
     status: EmailStatus;
     error: string | null;
     created_at: string;
     last_event_at: string | null;
     events: EmailEvent[];
 }
+interface ListEmailsOptions {
+    /**
+     * Only emails carrying every one of these tags, for example
+     * `[{ name: "campaign", value: "outreach-1" }]`.
+     */
+    tags?: EmailTag[];
+    status?: EmailStatus;
+    /** Only emails sent as part of this batch. */
+    batchId?: string;
+    /** Page size, 1 to 100. Defaults to 50. */
+    limit?: number;
+    /** `next_cursor` from the previous page. */
+    cursor?: string;
+}
+/** One row of `emails.list`. Call `emails.get(id)` for the event history. */
+interface EmailSummary {
+    id: string;
+    batch_id: string | null;
+    from: string;
+    to: string[];
+    subject: string;
+    marketing: boolean;
+    tags: EmailTag[];
+    status: EmailStatus;
+    error: string | null;
+    created_at: string;
+    last_event_at: string | null;
+}
+interface ListEmailsResponse {
+    /** Newest first. */
+    emails: EmailSummary[];
+    has_more: boolean;
+    /** Pass back as `cursor` to fetch the next page. `null` on the last page. */
+    next_cursor: string | null;
+}
+interface EmailTagCount extends EmailTag {
+    /** How many of your emails carry this tag. */
+    count: number;
+}
+interface ListEmailTagsResponse {
+    tags: EmailTagCount[];
+}
 declare const SMS_STATUSES: readonly ["queued", "sent", "delivered", "undelivered", "expired", "rejected", "failed"];
 type SmsStatus = (typeof SMS_STATUSES)[number];
 interface SendSmsOptions {
@@ -106,6 +161,81 @@ interface GetSmsResponse {
     last_event_at: string | null;
     events: SmsEvent[];
 }
+declare const WHATSAPP_STATUSES: readonly ["queued", "sent", "delivered", "read", "failed"];
+type WhatsappStatus = (typeof WHATSAPP_STATUSES)[number];
+type WhatsappMessageType = "text" | "template" | "image" | "document";
+interface WhatsappTemplate {
+    /** Template name as approved in WhatsApp Manager. */
+    name: string;
+    /** Language code the template was approved for, e.g. `en_US`. */
+    language: string;
+    /** Meta `components` (header/body/button parameters), passed through verbatim. */
+    components?: Record<string, unknown>[];
+}
+interface WhatsappMedia {
+    /** Public HTTPS link fetched at send time. */
+    link: string;
+    caption?: string;
+}
+interface WhatsappDocument extends WhatsappMedia {
+    /** File name shown to the recipient. */
+    filename?: string;
+}
+interface SendWhatsappOptions {
+    /**
+     * Connected number to send from, in international format. Optional when
+     * your organization has a single WhatsApp number.
+     */
+    from?: string;
+    /** One recipient in international format (`+237670000000`). */
+    to: string;
+    /** Defaults to `text`. */
+    type?: WhatsappMessageType;
+    /** Body for `text` messages (up to 4,096 characters), or a media caption. */
+    text?: string;
+    /** Render a preview for the first link in a `text` message. */
+    previewUrl?: boolean;
+    /** Required for `type: "template"`. Needed to start a conversation outside the 24h window. */
+    template?: WhatsappTemplate;
+    /** Required for `type: "image"`. */
+    image?: WhatsappMedia;
+    /** Required for `type: "document"`. */
+    document?: WhatsappDocument;
+}
+interface SendWhatsappResponse {
+    id: string;
+    status: "queued";
+    type: WhatsappMessageType;
+    /** The connected number the message goes out from. */
+    from: string;
+    /** ISO 3166-1 alpha-2 destination country detected from the number prefix. */
+    country: string | null;
+    created_at: string;
+}
+interface WhatsappEvent {
+    type: string;
+    created_at: string;
+}
+interface GetWhatsappResponse {
+    id: string;
+    from: string;
+    to: string;
+    country: string | null;
+    type: WhatsappMessageType;
+    text: string | null;
+    preview_url: boolean;
+    template: WhatsappTemplate | null;
+    media: WhatsappDocument | null;
+    /** Upstream provider that carried the message, e.g. `meta`. */
+    provider: string | null;
+    /** Provider-side message id (`wamid.…` on Meta); inbound replies reference it. */
+    provider_message_id: string | null;
+    status: WhatsappStatus;
+    error: string | null;
+    created_at: string;
+    last_event_at: string | null;
+    events: WhatsappEvent[];
+}
 interface SendBatchResponse {
     id: string;
     total: number;
@@ -138,6 +268,13 @@ declare class Emails {
     send(options: SendEmailOptions): Promise<Result<SendEmailResponse>>;
     /** Retrieves an email with its current status and event history. */
     get(id: string): Promise<Result<GetEmailResponse>>;
+    /**
+     * Lists your emails, newest first, optionally filtered by tags, status or
+     * batch. Pass `next_cursor` back as `cursor` to page through the results.
+     */
+    list(options?: ListEmailsOptions): Promise<Result<ListEmailsResponse>>;
+    /** Every distinct tag on your emails, with a count of emails carrying it. */
+    tags(): Promise<Result<ListEmailTagsResponse>>;
 }
 
 declare class Sms {
@@ -149,15 +286,29 @@ declare class Sms {
     get(id: string): Promise<Result<GetSmsResponse>>;
 }
 
+declare class Whatsapp {
+    private readonly client;
+    constructor(client: Retransmit);
+    /**
+     * Queues a single WhatsApp message to one recipient. Poll `get(id)` or
+     * subscribe to webhooks for the outcome; replies arrive as
+     * `whatsapp.received` webhooks.
+     */
+    send(options: SendWhatsappOptions): Promise<Result<SendWhatsappResponse>>;
+    /** Retrieves a WhatsApp message with its current status and event history. */
+    get(id: string): Promise<Result<GetWhatsappResponse>>;
+}
+
 declare class Retransmit {
     readonly emails: Emails;
     readonly sms: Sms;
+    readonly whatsapp: Whatsapp;
     readonly batch: Batch;
     private readonly apiKey;
     private readonly baseUrl;
     constructor(apiKey?: string, options?: RetransmitOptions);
     /** Internal transport shared by the resource classes. API failures are returned, never thrown. */
-    request<T>(method: "GET" | "POST", path: string, body?: unknown): Promise<Result<T>>;
+    request<T>(method: "GET" | "POST", path: string, body?: unknown, query?: Record<string, string | number | string[] | undefined>): Promise<Result<T>>;
 }
 
-export { Batch, EMAIL_STATUSES, type EmailEvent, type EmailStatus, Emails, type GetBatchResponse, type GetEmailResponse, type GetSmsResponse, type Result, Retransmit, type RetransmitError, type RetransmitOptions, SMS_STATUSES, type SendBatchResponse, type SendEmailOptions, type SendEmailResponse, type SendSmsOptions, type SendSmsResponse, Sms, type SmsEvent, type SmsStatus };
+export { Batch, EMAIL_STATUSES, type EmailEvent, type EmailStatus, type EmailSummary, type EmailTag, type EmailTagCount, Emails, type GetBatchResponse, type GetEmailResponse, type GetSmsResponse, type GetWhatsappResponse, type ListEmailTagsResponse, type ListEmailsOptions, type ListEmailsResponse, type Result, Retransmit, type RetransmitError, type RetransmitOptions, SMS_STATUSES, type SendBatchResponse, type SendEmailOptions, type SendEmailResponse, type SendSmsOptions, type SendSmsResponse, type SendWhatsappOptions, type SendWhatsappResponse, Sms, type SmsEvent, type SmsStatus, WHATSAPP_STATUSES, Whatsapp, type WhatsappDocument, type WhatsappEvent, type WhatsappMedia, type WhatsappMessageType, type WhatsappStatus, type WhatsappTemplate };

package/dist/index.js

@@ -9,7 +9,8 @@ function toWirePayload(options) {
     subject: options.subject,
     html: options.html,
     text: options.text,
-    marketing: options.marketing
+    marketing: options.marketing,
+    tags: options.tags
   };
 }
 var Emails = class {
@@ -25,6 +26,23 @@ var Emails = class {
   get(id) {
     return this.client.request("GET", `/v1/emails/${encodeURIComponent(id)}`);
   }
+  /**
+   * Lists your emails, newest first, optionally filtered by tags, status or
+   * batch. Pass `next_cursor` back as `cursor` to page through the results.
+   */
+  list(options = {}) {
+    return this.client.request("GET", "/v1/emails", void 0, {
+      tag: options.tags?.map((tag) => `${tag.name}:${tag.value}`),
+      status: options.status,
+      batch_id: options.batchId,
+      limit: options.limit,
+      cursor: options.cursor
+    });
+  }
+  /** Every distinct tag on your emails, with a count of emails carrying it. */
+  tags() {
+    return this.client.request("GET", "/v1/emails/tags");
+  }
 };
 
 // src/batch.ts
@@ -65,15 +83,45 @@ var Sms = class {
   }
 };
 
+// src/whatsapp.ts
+var Whatsapp = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Queues a single WhatsApp message to one recipient. Poll `get(id)` or
+   * subscribe to webhooks for the outcome; replies arrive as
+   * `whatsapp.received` webhooks.
+   */
+  send(options) {
+    return this.client.request("POST", "/v1/whatsapp", {
+      from: options.from,
+      to: options.to,
+      type: options.type,
+      text: options.text,
+      preview_url: options.previewUrl,
+      template: options.template,
+      image: options.image,
+      document: options.document
+    });
+  }
+  /** Retrieves a WhatsApp message with its current status and event history. */
+  get(id) {
+    return this.client.request("GET", `/v1/whatsapp/${encodeURIComponent(id)}`);
+  }
+};
+
 // src/retransmit.ts
 var DEFAULT_BASE_URL = "https://api.retransmit.dev";
-var USER_AGENT = "retransmit.dev-node/0.1.0";
+var USER_AGENT = "retransmit.dev-node/0.3.0";
 function readEnv(name) {
   return typeof process !== "undefined" ? process.env?.[name] : void 0;
 }
 var Retransmit = class {
   emails = new Emails(this);
   sms = new Sms(this);
+  whatsapp = new Whatsapp(this);
   batch = new Batch(this);
   apiKey;
   baseUrl;
@@ -91,10 +139,17 @@ var Retransmit = class {
     );
   }
   /** Internal transport shared by the resource classes. API failures are returned, never thrown. */
-  async request(method, path, body) {
+  async request(method, path, body, query) {
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(query ?? {})) {
+      if (value === void 0) continue;
+      for (const item of Array.isArray(value) ? value : [value]) params.append(key, String(item));
+    }
+    const encoded = params.toString();
+    const search = encoded ? `?${encoded}` : "";
     let response;
     try {
-      response = await fetch(`${this.baseUrl}${path}`, {
+      response = await fetch(`${this.baseUrl}${path}${search}`, {
         method,
         headers: {
           Authorization: `Bearer ${this.apiKey}`,
@@ -156,11 +211,14 @@ var SMS_STATUSES = [
   "rejected",
   "failed"
 ];
+var WHATSAPP_STATUSES = ["queued", "sent", "delivered", "read", "failed"];
 export {
   Batch,
   EMAIL_STATUSES,
   Emails,
   Retransmit,
   SMS_STATUSES,
-  Sms
+  Sms,
+  WHATSAPP_STATUSES,
+  Whatsapp
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "retransmit.dev",
-  "version": "0.1.2",
-  "description": "Node.js SDK for the Retransmit email and SMS APIs",
+  "version": "0.3.0",
+  "description": "Node.js SDK for the Retransmit email, SMS and WhatsApp APIs",
   "keywords": [
     "email",
     "sms",
@@ -9,7 +9,9 @@
     "retransmit",
     "ses",
     "transactional-email",
-    "transactional-sms"
+    "transactional-sms",
+    "whatsapp",
+    "whatsapp-cloud-api"
   ],
   "homepage": "https://docs.retransmit.dev",
   "repository": {