mailisk 2.4.0 → 2.5.0

package/README.md

@@ -6,12 +6,48 @@ Mailisk is an end-to-end email and SMS testing platform. It allows you to receiv
 - Easily automate E2E password reset and account verification by catching emails.
 - Receive SMS messages and automate SMS tests.
 - Generate TOTP authenticator codes and manage saved TOTP devices.
-- Virtual SMTP and SMS support to test without 3rd party clients.
+- Outbound email and virtual SMS support to test without 3rd party clients.
 
 ## Get started
 
 For a more step-by-step walkthrough see the [NodeJS Guide](https://docs.mailisk.com/guides/nodejs.html).
 
+- [Mailisk Node Client](#mailisk-node-client)
+  - [Get started](#get-started)
+    - [Requirements](#requirements)
+    - [Installation](#installation)
+      - [Install with npm](#install-with-npm)
+      - [Install with Yarn](#install-with-yarn)
+    - [Usage](#usage)
+    - [API Reference](#api-reference)
+  - [Client functions (Email)](#client-functions-email)
+    - [`searchInbox(namespace, params?, requestOptions?)`](#searchinboxnamespace-params-requestoptions)
+      - [Quick examples](#quick-examples)
+      - [Filter by destination address](#filter-by-destination-address)
+    - [`listNamespaces()`](#listnamespaces)
+    - [`getAttachment(attachmentId)`](#getattachmentattachmentid)
+    - [`downloadAttachment(attachmentId)`](#downloadattachmentattachmentid)
+      - [Quick examples](#quick-examples-1)
+  - [Client functions (Outbound Email)](#client-functions-outbound-email)
+    - [`sendEmail(namespace, params)`](#sendemailnamespace-params)
+    - [`getOutboundEmail(outboundEmailId)`](#getoutboundemailoutboundemailid)
+    - [`replyToEmail(emailId, params)`](#replytoemailemailid-params)
+    - [`forwardEmail(emailId, params)`](#forwardemailemailid-params)
+  - [Client functions (SMS)](#client-functions-sms)
+    - [`searchSmsMessages(phoneNumber, params?, requestOptions?)`](#searchsmsmessagesphonenumber-params-requestoptions)
+      - [Quick examples](#quick-examples-2)
+    - [`listSmsNumbers()`](#listsmsnumbers)
+    - [`sendVirtualSms(params)`](#sendvirtualsmsparams)
+  - [Client functions (TOTP)](#client-functions-totp)
+    - [`listTotpDevices(params?)`](#listtotpdevicesparams)
+    - [`createTotpDevice(params)`](#createtotpdeviceparams)
+    - [`createCustomTotpDevice(params)`](#createcustomtotpdeviceparams)
+    - [`createTotpDeviceFromBase32SecretKey(params)`](#createtotpdevicefrombase32secretkeyparams)
+    - [`createTotpDeviceFromOtpAuthUrl(params)`](#createtotpdevicefromotpauthurlparams)
+    - [`getTotpOtpBySharedSecret(sharedSecret, params?)`](#gettotpotpbysharedsecretsharedsecret-params)
+    - [`getTotpOtpByDeviceId(deviceId, params?)`](#gettotpotpbydeviceiddeviceid-params)
+    - [`deleteTotpDevice(deviceId)`](#deletetotpdevicedeviceid)
+
 ### Requirements
 
 - Node.js 18 or newer
@@ -40,10 +76,9 @@ const { MailiskClient } = require("mailisk");
 // create client
 const mailisk = new MailiskClient({ apiKey: "YOUR_API_KEY" });
 
-// send email (using virtual SMTP)
-await mailisk.sendVirtualEmail(namespace, {
-  from: "test@example.com",
-  to: `john@${namespace}.mailisk.net`,
+// send outbound email
+await mailisk.sendEmail(namespace, {
+  to: ["verified@example.com"],
   subject: "Testing",
   text: "This is a test.",
 });
@@ -96,21 +131,6 @@ const { data: emails } = await mailisk.searchInbox(namespace, {
 });
 ```
 
-### sendVirtualEmail(namespace, params)
-
-Send an email using [Virtual SMTP](https://docs.mailisk.com/smtp.html). This will fetch the SMTP settings for the selected namespace and send an email. These emails can only be sent to an address that ends in `@{namespace}.mailisk.net`.
-
-```js
-const namespace = "mynamespace";
-
-await mailisk.sendVirtualEmail(namespace, {
-  from: "test@example.com",
-  to: `john@${namespace}.mailisk.net`,
-  subject: "This is a test",
-  text: "Testing",
-});
-```
-
 ### `listNamespaces()`
 
 List all namespaces associated with the current API Key.
@@ -163,6 +183,89 @@ const fileStream = fs.createWriteStream(filename);
 await new Promise((ok, err) => res.body.pipe(fileStream).on("finish", ok).on("error", err));
 ```
 
+## Client functions (Outbound Email)
+
+Outbound email methods call the Mailisk API to create, queue, and inspect email delivery.
+
+### `sendEmail(namespace, params)`
+
+Create and queue a new outbound email from a namespace. Recipients must be verified external destinations or addresses under the same namespace. Messages sent only to the same namespace do not consume outbound usage because they are counted as inbound email when delivered.
+
+```js
+const outboundEmail = await mailisk.sendEmail("mynamespace", {
+  from: {
+    email: "support@mynamespace.mailisk.net",
+    name: "Support",
+  },
+  to: ["verified@example.com"],
+  subject: "Hello from Mailisk",
+  text: "This is the plain text body.",
+  html: "<p>This is the HTML body.</p>",
+});
+
+console.log(outboundEmail.id, outboundEmail.status);
+```
+
+Attachments use base64 encoded content:
+
+```js
+const fs = require("node:fs");
+const attachmentContent = fs.readFileSync("report.txt");
+
+await mailisk.sendEmail("mynamespace", {
+  to: ["verified@example.com"],
+  subject: "Report",
+  text: "Attached.",
+  attachments: [
+    {
+      filename: "report.txt",
+      content_type: "application/octet-stream",
+      content_base64: attachmentContent.toString("base64"),
+    },
+  ],
+});
+```
+
+### `getOutboundEmail(outboundEmailId)`
+
+Fetch the current delivery state for an outbound email, including recipient delivery statuses and provider events.
+
+```js
+const outboundEmail = await mailisk.getOutboundEmail(outboundEmailId);
+
+console.log(outboundEmail.delivery_summary.delivered);
+console.log(outboundEmail.recipients);
+```
+
+### `replyToEmail(emailId, params)`
+
+Create and queue a reply to an inbound email returned by `searchInbox`. Mailisk derives the reply recipient and threading headers from the source email.
+
+```js
+const { data: emails } = await mailisk.searchInbox("mynamespace", {
+  to_addr_prefix: "support@mynamespace.mailisk.net",
+});
+
+const reply = await mailisk.replyToEmail(emails[0].id, {
+  text: "Thanks, we received your message.",
+});
+
+console.log(reply.id);
+```
+
+### `forwardEmail(emailId, params)`
+
+Create and queue a forwarded copy of an inbound email.
+
+```js
+const forwarded = await mailisk.forwardEmail(emailId, {
+  to: ["verified@example.com"],
+  text: "Forwarding this along.",
+});
+
+console.log(forwarded.id);
+```
+
 ## Client functions (SMS)
 
 ### `searchSmsMessages(phoneNumber, params?, requestOptions?)`
@@ -192,7 +295,7 @@ await mailisk.searchSmsMessages(phoneNumber, {
 await mailisk.searchSmsMessages(
   phoneNumber,
   { wait: false, limit: 10, from_date: new Date(Date.now() - 1000 * 60 * 5).toISOString() },
-  { timeout: 10_000 }
+  { timeout: 10_000 },
 );
 ```
 
@@ -220,8 +323,6 @@ await mailisk.sendVirtualSms({
 
 TOTP methods call the Mailisk API to generate codes and manage saved authenticator devices. The client does not generate TOTP codes locally.
 
-These endpoints require an organisation API key, prefixed with `sk_org_`.
-
 ### `listTotpDevices(params?)`
 
 List active saved TOTP devices.

package/dist/index.d.mts

@@ -231,6 +231,179 @@ interface SendVirtualSmsParams {
     /** The body of the SMS message */
     body: string;
 }
+type OutboundEmailType = "new" | "reply" | "forward";
+type OutboundEmailStatus = "queued" | "sending" | "sent" | "failed";
+type OutboundEmailRecipientType = "to" | "cc" | "bcc";
+type OutboundEmailRecipientDeliveryStatus = "pending" | "accepted" | "queued" | "sent" | "delayed" | "deferred" | "delivered" | "bounced" | "expired" | "complained" | "unsubscribed" | "suppressed" | "rejected" | "failed" | "cancelled";
+type OutboundEmailEventType = "accepted" | "queued" | "sent" | "failed" | "rejected" | "delayed" | "deferred" | "delivered" | "bounced" | "expired" | "complained" | "unsubscribed" | "suppressed" | "cancelled" | "opened" | "clicked";
+type OutboundEmailAttachmentDisposition = "attachment" | "inline";
+interface OutboundEmailAddress {
+    /** Email address */
+    email: string;
+    /** Display name, if one is specified */
+    name?: string;
+}
+interface OutboundEmailAttachment {
+    /** Filename of the attachment */
+    filename: string;
+    /** MIME content type */
+    content_type: string;
+    /** Base64 encoded attachment content */
+    content_base64: string;
+    /** Content-ID for inline attachments */
+    content_id?: string;
+    /** Attachment disposition */
+    disposition?: OutboundEmailAttachmentDisposition;
+}
+interface SendEmailParams {
+    /** Optional sender override. Must belong to the requested namespace. */
+    from?: OutboundEmailAddress;
+    /** Optional Reply-To address */
+    reply_to?: OutboundEmailAddress;
+    /** Primary recipients */
+    to?: string[];
+    /** Carbon-copied recipients */
+    cc?: string[];
+    /** Blind carbon-copied recipients */
+    bcc?: string[];
+    /** Email subject */
+    subject: string;
+    /** HTML message body */
+    html?: string;
+    /** Plain text message body */
+    text?: string;
+    /** Attachments to include */
+    attachments?: OutboundEmailAttachment[];
+}
+interface ReplyToEmailParams {
+    /** Optional sender override. Must belong to the source email namespace. */
+    from?: OutboundEmailAddress;
+    /** Carbon-copied recipients */
+    cc?: string[];
+    /** Blind carbon-copied recipients */
+    bcc?: string[];
+    /** Optional subject. Defaults to Re: original subject. */
+    subject?: string;
+    /** HTML reply body */
+    html?: string;
+    /** Plain text reply body */
+    text?: string;
+    /** Attachments to include */
+    attachments?: OutboundEmailAttachment[];
+}
+interface ForwardEmailParams {
+    /** Optional sender override. Must belong to the source email namespace. */
+    from?: OutboundEmailAddress;
+    /** Primary recipients */
+    to: string[];
+    /** Carbon-copied recipients */
+    cc?: string[];
+    /** Blind carbon-copied recipients */
+    bcc?: string[];
+    /** Optional subject. Defaults to Fwd: original subject. */
+    subject?: string;
+    /** Optional HTML body to prepend before the forwarded message */
+    html?: string;
+    /** Optional plain text body to prepend before the forwarded message */
+    text?: string;
+}
+interface OutboundEmailResponse {
+    id: string;
+    organisation_id: string;
+    type: OutboundEmailType;
+    status: OutboundEmailStatus;
+    from: OutboundEmailAddress;
+    reply_to?: OutboundEmailAddress;
+    subject: string;
+    recipient_count: number;
+    attachment_count: number;
+    message_id: string;
+    provider?: string;
+    provider_message_id?: string;
+    failure_reason?: string;
+    queued_at: string;
+    sending_at?: string;
+    sent_at?: string;
+    failed_at?: string;
+    created_at: string;
+    updated_at: string;
+}
+interface OutboundEmailDeliverySummary {
+    pending: number;
+    accepted: number;
+    queued: number;
+    sent: number;
+    delayed: number;
+    deferred: number;
+    delivered: number;
+    bounced: number;
+    expired: number;
+    complained: number;
+    unsubscribed: number;
+    suppressed: number;
+    rejected: number;
+    failed: number;
+    cancelled: number;
+}
+interface OutboundEmailRecipient {
+    id: string;
+    type: OutboundEmailRecipientType;
+    email: string;
+    name?: string;
+    delivery_status: OutboundEmailRecipientDeliveryStatus;
+    last_event_type?: string;
+    last_event_at?: string;
+    accepted_at?: string;
+    queued_at?: string;
+    sent_at?: string;
+    delayed_at?: string;
+    deferred_at?: string;
+    delivered_at?: string;
+    bounced_at?: string;
+    expired_at?: string;
+    complained_at?: string;
+    unsubscribed_at?: string;
+    suppressed_at?: string;
+    rejected_at?: string;
+    failed_at?: string;
+    cancelled_at?: string;
+    last_smtp_code?: string;
+    last_enhanced_status_code?: string;
+    last_smtp_response?: string;
+    attempt_count: number;
+    bounce_type?: string;
+    bounce_subtype?: string;
+    bounce_classification?: string;
+    complaint_feedback_type?: string;
+}
+interface OutboundEmailEventRecipient {
+    id: string;
+    outbound_email_recipient_id?: string;
+    email: string;
+    smtp_code?: string;
+    enhanced_status_code?: string;
+    smtp_response?: string;
+    diagnostic_code?: string;
+    action?: string;
+    attempt_count?: number;
+    bounce_classification?: string;
+}
+interface OutboundEmailEvent {
+    id: string;
+    provider: string;
+    provider_message_id?: string;
+    provider_event_id?: string;
+    event_type: OutboundEmailEventType;
+    event_subtype?: string;
+    occurred_at: string;
+    recipients: OutboundEmailEventRecipient[];
+    created_at: string;
+}
+interface OutboundEmailDetailResponse extends OutboundEmailResponse {
+    delivery_summary: OutboundEmailDeliverySummary;
+    recipients: OutboundEmailRecipient[];
+    events: OutboundEmailEvent[];
+}
 type TotpAlgorithm = "SHA1" | "SHA256" | "SHA512";
 type KnownTotpDeviceSource = "shared_secret" | "custom" | "base32_secret_key" | "otpauth_url";
 type TotpDeviceSource = KnownTotpDeviceSource | (string & {});
@@ -362,6 +535,32 @@ declare class MailiskClient {
      */
     listSmsNumbers(): Promise<ListSmsNumbersResponse>;
     sendVirtualSms(params: SendVirtualSmsParams): Promise<void>;
+    /**
+     * Create and queue a new outbound email from a namespace.
+     *
+     * @example
+     * Send an outbound email
+     * ```typescript
+     * const email = await client.sendEmail("mynamespace", {
+     *   to: ["verified@example.com"],
+     *   subject: "Hello",
+     *   text: "Hello from Mailisk",
+     * });
+     * ```
+     */
+    sendEmail(namespace: string, params: SendEmailParams): Promise<OutboundEmailResponse>;
+    /**
+     * Get current delivery state for an outbound email.
+     */
+    getOutboundEmail(outboundEmailId: string): Promise<OutboundEmailDetailResponse>;
+    /**
+     * Create and queue a reply to an inbound email.
+     */
+    replyToEmail(emailId: string, params: ReplyToEmailParams): Promise<OutboundEmailResponse>;
+    /**
+     * Create and queue a forwarded copy of an inbound email.
+     */
+    forwardEmail(emailId: string, params: ForwardEmailParams): Promise<OutboundEmailResponse>;
     /**
      * List saved TOTP devices.
      *
@@ -475,6 +674,8 @@ declare class MailiskClient {
      *
      * These emails can only be sent to valid Mailisk namespaces, i.e. emails that end in @mynamespace.mailisk.net
      *
+     * @deprecated Use sendEmail(namespace, params) for outbound email. This method remains available for existing Virtual SMTP tests.
+     *
      * @example
      * For example, sending a test email:
      * ```typescript
@@ -522,6 +723,8 @@ declare class MailiskClient {
     searchInbox(namespace: string, params?: SearchInboxParams, config?: AxiosRequestConfig): Promise<SearchInboxResponse>;
     /**
      * Get the SMTP settings for a namespace.
+     *
+     * @deprecated Virtual SMTP is deprecated. Use sendEmail(namespace, params) for outbound email instead.
      */
     getSmtpSettings(namespace: string): Promise<SmtpSettings>;
     getAttachment(attachmentId: string): Promise<GetAttachmentResponse>;
@@ -541,4 +744,4 @@ declare class MailiskClient {
     downloadAttachment(attachmentId: string): Promise<Buffer>;
 }
 
-export { type CreateBase32SecretKeyTotpDeviceParams, type CreateCustomTotpDeviceParams, type CreateOtpAuthUrlTotpDeviceParams, type CreateTotpDeviceParams, type Email, type EmailAddress, type EmailAttachment, type GetAttachmentResponse, type GetTotpOtpParams, type KnownTotpDeviceSource, type ListNamespacesResponse, type ListSmsNumbersResponse, type ListTotpDevicesParams, type ListTotpDevicesResponse, MailiskClient, type SearchInboxParams, type SearchInboxResponse, type SearchSmsMessagesParams, type SearchSmsMessagesResponse, type SendVirtualEmailParams, type SendVirtualSmsParams, type SmsMessage, type SmsNumber, type SmtpSettings, type TotpAlgorithm, type TotpDevice, type TotpDeviceSource, type TotpOtpResponse };
+export { type CreateBase32SecretKeyTotpDeviceParams, type CreateCustomTotpDeviceParams, type CreateOtpAuthUrlTotpDeviceParams, type CreateTotpDeviceParams, type Email, type EmailAddress, type EmailAttachment, type ForwardEmailParams, type GetAttachmentResponse, type GetTotpOtpParams, type KnownTotpDeviceSource, type ListNamespacesResponse, type ListSmsNumbersResponse, type ListTotpDevicesParams, type ListTotpDevicesResponse, MailiskClient, type OutboundEmailAddress, type OutboundEmailAttachment, type OutboundEmailAttachmentDisposition, type OutboundEmailDeliverySummary, type OutboundEmailDetailResponse, type OutboundEmailEvent, type OutboundEmailEventRecipient, type OutboundEmailEventType, type OutboundEmailRecipient, type OutboundEmailRecipientDeliveryStatus, type OutboundEmailRecipientType, type OutboundEmailResponse, type OutboundEmailStatus, type OutboundEmailType, type ReplyToEmailParams, type SearchInboxParams, type SearchInboxResponse, type SearchSmsMessagesParams, type SearchSmsMessagesResponse, type SendEmailParams, type SendVirtualEmailParams, type SendVirtualSmsParams, type SmsMessage, type SmsNumber, type SmtpSettings, type TotpAlgorithm, type TotpDevice, type TotpDeviceSource, type TotpOtpResponse };

package/dist/index.d.ts

@@ -231,6 +231,179 @@ interface SendVirtualSmsParams {
     /** The body of the SMS message */
     body: string;
 }
+type OutboundEmailType = "new" | "reply" | "forward";
+type OutboundEmailStatus = "queued" | "sending" | "sent" | "failed";
+type OutboundEmailRecipientType = "to" | "cc" | "bcc";
+type OutboundEmailRecipientDeliveryStatus = "pending" | "accepted" | "queued" | "sent" | "delayed" | "deferred" | "delivered" | "bounced" | "expired" | "complained" | "unsubscribed" | "suppressed" | "rejected" | "failed" | "cancelled";
+type OutboundEmailEventType = "accepted" | "queued" | "sent" | "failed" | "rejected" | "delayed" | "deferred" | "delivered" | "bounced" | "expired" | "complained" | "unsubscribed" | "suppressed" | "cancelled" | "opened" | "clicked";
+type OutboundEmailAttachmentDisposition = "attachment" | "inline";
+interface OutboundEmailAddress {
+    /** Email address */
+    email: string;
+    /** Display name, if one is specified */
+    name?: string;
+}
+interface OutboundEmailAttachment {
+    /** Filename of the attachment */
+    filename: string;
+    /** MIME content type */
+    content_type: string;
+    /** Base64 encoded attachment content */
+    content_base64: string;
+    /** Content-ID for inline attachments */
+    content_id?: string;
+    /** Attachment disposition */
+    disposition?: OutboundEmailAttachmentDisposition;
+}
+interface SendEmailParams {
+    /** Optional sender override. Must belong to the requested namespace. */
+    from?: OutboundEmailAddress;
+    /** Optional Reply-To address */
+    reply_to?: OutboundEmailAddress;
+    /** Primary recipients */
+    to?: string[];
+    /** Carbon-copied recipients */
+    cc?: string[];
+    /** Blind carbon-copied recipients */
+    bcc?: string[];
+    /** Email subject */
+    subject: string;
+    /** HTML message body */
+    html?: string;
+    /** Plain text message body */
+    text?: string;
+    /** Attachments to include */
+    attachments?: OutboundEmailAttachment[];
+}
+interface ReplyToEmailParams {
+    /** Optional sender override. Must belong to the source email namespace. */
+    from?: OutboundEmailAddress;
+    /** Carbon-copied recipients */
+    cc?: string[];
+    /** Blind carbon-copied recipients */
+    bcc?: string[];
+    /** Optional subject. Defaults to Re: original subject. */
+    subject?: string;
+    /** HTML reply body */
+    html?: string;
+    /** Plain text reply body */
+    text?: string;
+    /** Attachments to include */
+    attachments?: OutboundEmailAttachment[];
+}
+interface ForwardEmailParams {
+    /** Optional sender override. Must belong to the source email namespace. */
+    from?: OutboundEmailAddress;
+    /** Primary recipients */
+    to: string[];
+    /** Carbon-copied recipients */
+    cc?: string[];
+    /** Blind carbon-copied recipients */
+    bcc?: string[];
+    /** Optional subject. Defaults to Fwd: original subject. */
+    subject?: string;
+    /** Optional HTML body to prepend before the forwarded message */
+    html?: string;
+    /** Optional plain text body to prepend before the forwarded message */
+    text?: string;
+}
+interface OutboundEmailResponse {
+    id: string;
+    organisation_id: string;
+    type: OutboundEmailType;
+    status: OutboundEmailStatus;
+    from: OutboundEmailAddress;
+    reply_to?: OutboundEmailAddress;
+    subject: string;
+    recipient_count: number;
+    attachment_count: number;
+    message_id: string;
+    provider?: string;
+    provider_message_id?: string;
+    failure_reason?: string;
+    queued_at: string;
+    sending_at?: string;
+    sent_at?: string;
+    failed_at?: string;
+    created_at: string;
+    updated_at: string;
+}
+interface OutboundEmailDeliverySummary {
+    pending: number;
+    accepted: number;
+    queued: number;
+    sent: number;
+    delayed: number;
+    deferred: number;
+    delivered: number;
+    bounced: number;
+    expired: number;
+    complained: number;
+    unsubscribed: number;
+    suppressed: number;
+    rejected: number;
+    failed: number;
+    cancelled: number;
+}
+interface OutboundEmailRecipient {
+    id: string;
+    type: OutboundEmailRecipientType;
+    email: string;
+    name?: string;
+    delivery_status: OutboundEmailRecipientDeliveryStatus;
+    last_event_type?: string;
+    last_event_at?: string;
+    accepted_at?: string;
+    queued_at?: string;
+    sent_at?: string;
+    delayed_at?: string;
+    deferred_at?: string;
+    delivered_at?: string;
+    bounced_at?: string;
+    expired_at?: string;
+    complained_at?: string;
+    unsubscribed_at?: string;
+    suppressed_at?: string;
+    rejected_at?: string;
+    failed_at?: string;
+    cancelled_at?: string;
+    last_smtp_code?: string;
+    last_enhanced_status_code?: string;
+    last_smtp_response?: string;
+    attempt_count: number;
+    bounce_type?: string;
+    bounce_subtype?: string;
+    bounce_classification?: string;
+    complaint_feedback_type?: string;
+}
+interface OutboundEmailEventRecipient {
+    id: string;
+    outbound_email_recipient_id?: string;
+    email: string;
+    smtp_code?: string;
+    enhanced_status_code?: string;
+    smtp_response?: string;
+    diagnostic_code?: string;
+    action?: string;
+    attempt_count?: number;
+    bounce_classification?: string;
+}
+interface OutboundEmailEvent {
+    id: string;
+    provider: string;
+    provider_message_id?: string;
+    provider_event_id?: string;
+    event_type: OutboundEmailEventType;
+    event_subtype?: string;
+    occurred_at: string;
+    recipients: OutboundEmailEventRecipient[];
+    created_at: string;
+}
+interface OutboundEmailDetailResponse extends OutboundEmailResponse {
+    delivery_summary: OutboundEmailDeliverySummary;
+    recipients: OutboundEmailRecipient[];
+    events: OutboundEmailEvent[];
+}
 type TotpAlgorithm = "SHA1" | "SHA256" | "SHA512";
 type KnownTotpDeviceSource = "shared_secret" | "custom" | "base32_secret_key" | "otpauth_url";
 type TotpDeviceSource = KnownTotpDeviceSource | (string & {});
@@ -362,6 +535,32 @@ declare class MailiskClient {
      */
     listSmsNumbers(): Promise<ListSmsNumbersResponse>;
     sendVirtualSms(params: SendVirtualSmsParams): Promise<void>;
+    /**
+     * Create and queue a new outbound email from a namespace.
+     *
+     * @example
+     * Send an outbound email
+     * ```typescript
+     * const email = await client.sendEmail("mynamespace", {
+     *   to: ["verified@example.com"],
+     *   subject: "Hello",
+     *   text: "Hello from Mailisk",
+     * });
+     * ```
+     */
+    sendEmail(namespace: string, params: SendEmailParams): Promise<OutboundEmailResponse>;
+    /**
+     * Get current delivery state for an outbound email.
+     */
+    getOutboundEmail(outboundEmailId: string): Promise<OutboundEmailDetailResponse>;
+    /**
+     * Create and queue a reply to an inbound email.
+     */
+    replyToEmail(emailId: string, params: ReplyToEmailParams): Promise<OutboundEmailResponse>;
+    /**
+     * Create and queue a forwarded copy of an inbound email.
+     */
+    forwardEmail(emailId: string, params: ForwardEmailParams): Promise<OutboundEmailResponse>;
     /**
      * List saved TOTP devices.
      *
@@ -475,6 +674,8 @@ declare class MailiskClient {
      *
      * These emails can only be sent to valid Mailisk namespaces, i.e. emails that end in @mynamespace.mailisk.net
      *
+     * @deprecated Use sendEmail(namespace, params) for outbound email. This method remains available for existing Virtual SMTP tests.
+     *
      * @example
      * For example, sending a test email:
      * ```typescript
@@ -522,6 +723,8 @@ declare class MailiskClient {
     searchInbox(namespace: string, params?: SearchInboxParams, config?: AxiosRequestConfig): Promise<SearchInboxResponse>;
     /**
      * Get the SMTP settings for a namespace.
+     *
+     * @deprecated Virtual SMTP is deprecated. Use sendEmail(namespace, params) for outbound email instead.
      */
     getSmtpSettings(namespace: string): Promise<SmtpSettings>;
     getAttachment(attachmentId: string): Promise<GetAttachmentResponse>;
@@ -541,4 +744,4 @@ declare class MailiskClient {
     downloadAttachment(attachmentId: string): Promise<Buffer>;
 }
 
-export { type CreateBase32SecretKeyTotpDeviceParams, type CreateCustomTotpDeviceParams, type CreateOtpAuthUrlTotpDeviceParams, type CreateTotpDeviceParams, type Email, type EmailAddress, type EmailAttachment, type GetAttachmentResponse, type GetTotpOtpParams, type KnownTotpDeviceSource, type ListNamespacesResponse, type ListSmsNumbersResponse, type ListTotpDevicesParams, type ListTotpDevicesResponse, MailiskClient, type SearchInboxParams, type SearchInboxResponse, type SearchSmsMessagesParams, type SearchSmsMessagesResponse, type SendVirtualEmailParams, type SendVirtualSmsParams, type SmsMessage, type SmsNumber, type SmtpSettings, type TotpAlgorithm, type TotpDevice, type TotpDeviceSource, type TotpOtpResponse };
+export { type CreateBase32SecretKeyTotpDeviceParams, type CreateCustomTotpDeviceParams, type CreateOtpAuthUrlTotpDeviceParams, type CreateTotpDeviceParams, type Email, type EmailAddress, type EmailAttachment, type ForwardEmailParams, type GetAttachmentResponse, type GetTotpOtpParams, type KnownTotpDeviceSource, type ListNamespacesResponse, type ListSmsNumbersResponse, type ListTotpDevicesParams, type ListTotpDevicesResponse, MailiskClient, type OutboundEmailAddress, type OutboundEmailAttachment, type OutboundEmailAttachmentDisposition, type OutboundEmailDeliverySummary, type OutboundEmailDetailResponse, type OutboundEmailEvent, type OutboundEmailEventRecipient, type OutboundEmailEventType, type OutboundEmailRecipient, type OutboundEmailRecipientDeliveryStatus, type OutboundEmailRecipientType, type OutboundEmailResponse, type OutboundEmailStatus, type OutboundEmailType, type ReplyToEmailParams, type SearchInboxParams, type SearchInboxResponse, type SearchSmsMessagesParams, type SearchSmsMessagesResponse, type SendEmailParams, type SendVirtualEmailParams, type SendVirtualSmsParams, type SmsMessage, type SmsNumber, type SmtpSettings, type TotpAlgorithm, type TotpDevice, type TotpDeviceSource, type TotpOtpResponse };