mailisk 2.4.0 → 2.5.0

package/dist/index.js

@@ -101,6 +101,42 @@ var MailiskClient = class {
   async sendVirtualSms(params) {
     return (await this.axiosInstance.post("api/sms/virtual", params)).data;
   }
+  /**
+   * 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",
+   * });
+   * ```
+   */
+  async sendEmail(namespace, params) {
+    return (await this.axiosInstance.post("api/emails/send", params, {
+      params: { namespace }
+    })).data;
+  }
+  /**
+   * Get current delivery state for an outbound email.
+   */
+  async getOutboundEmail(outboundEmailId) {
+    return (await this.axiosInstance.get(`api/emails/outbound/${outboundEmailId}`)).data;
+  }
+  /**
+   * Create and queue a reply to an inbound email.
+   */
+  async replyToEmail(emailId, params) {
+    return (await this.axiosInstance.post(`api/emails/${emailId}/reply`, params)).data;
+  }
+  /**
+   * Create and queue a forwarded copy of an inbound email.
+   */
+  async forwardEmail(emailId, params) {
+    return (await this.axiosInstance.post(`api/emails/${emailId}/forward`, params)).data;
+  }
   /**
    * List saved TOTP devices.
    *
@@ -240,6 +276,8 @@ var MailiskClient = class {
    *
    * 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
@@ -328,6 +366,8 @@ var MailiskClient = class {
   }
   /**
    * Get the SMTP settings for a namespace.
+   *
+   * @deprecated Virtual SMTP is deprecated. Use sendEmail(namespace, params) for outbound email instead.
    */
   async getSmtpSettings(namespace) {
     const result = await this.axiosInstance.get(`api/smtp/${namespace}`);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/mailisk.ts"],"sourcesContent":["export * from \"./mailisk\";\nexport * from \"./mailisk.interfaces\";\n","import axios, { AxiosBasicCredentials, AxiosInstance, AxiosRequestConfig } from \"axios\";\nimport {\n  CreateBase32SecretKeyTotpDeviceParams,\n  CreateCustomTotpDeviceParams,\n  CreateOtpAuthUrlTotpDeviceParams,\n  CreateTotpDeviceParams,\n  GetAttachmentResponse,\n  GetTotpOtpParams,\n  ListNamespacesResponse,\n  ListSmsNumbersResponse,\n  ListTotpDevicesParams,\n  ListTotpDevicesResponse,\n  SearchInboxParams,\n  SearchInboxResponse,\n  SearchSmsMessagesParams,\n  SearchSmsMessagesResponse,\n  SendVirtualEmailParams,\n  SendVirtualSmsParams,\n  SmtpSettings,\n  TotpDevice,\n  TotpOtpResponse,\n} from \"./mailisk.interfaces\";\nimport nodemailer from \"nodemailer\";\n\nexport class MailiskClient {\n  constructor({ apiKey, baseUrl, auth }: { apiKey: string; baseUrl?: string; auth?: AxiosBasicCredentials }) {\n    this.axiosInstance = axios.create({\n      headers: {\n        \"X-Api-Key\": apiKey,\n      },\n      baseURL: baseUrl || \"https://api.mailisk.com/\",\n      auth,\n    });\n  }\n\n  private readonly axiosInstance: AxiosInstance;\n\n  /**\n   * Search SMS messages sent to a phone number.\n   *\n   * @example\n   * Search for SMS messages sent to a phone number\n   * ```typescript\n   * const { data: smsMessages } = await client.searchSmsMessages(\"1234567890\");\n   * ```\n   */\n  async searchSmsMessages(\n    phoneNumber: string,\n    params?: SearchSmsMessagesParams,\n    config?: AxiosRequestConfig,\n  ): Promise<SearchSmsMessagesResponse> {\n    let _params: SearchSmsMessagesParams = { ...params };\n\n    // default from timestamp, 15 minutes before starting this request\n    if (params?.from_date === undefined || params?.from_date === null) {\n      _params.from_date = new Date(Date.now() - 15 * 60 * 1000).toISOString();\n    }\n\n    // by default wait for sms\n    if (params?.wait !== false) {\n      _params.wait = true;\n    }\n\n    let _config = { ...config };\n\n    if (config?.maxRedirects === undefined) {\n      _config.maxRedirects = 99999;\n    }\n\n    // by default, wait 5 minutes for emails before timing out\n    if (_params.wait && config?.timeout === undefined) {\n      _config.timeout = 1000 * 60 * 5;\n    }\n\n    const requestParams = {\n      ..._params,\n      from_date: _params.from_date ?? undefined,\n      to_date: _params.to_date ?? undefined,\n    };\n\n    return (\n      await this.axiosInstance.get(`api/sms/${phoneNumber}/messages`, {\n        ..._config,\n        params: requestParams,\n      })\n    ).data;\n  }\n\n  /**\n   * List all SMS phone numbers associated with the current account.\n   *\n   * @example\n   * List all SMS phone numbers\n   * ```typescript\n   * const { data: smsNumbers } = await client.listSmsNumbers();\n   * ```\n   */\n  async listSmsNumbers(): Promise<ListSmsNumbersResponse> {\n    return (await this.axiosInstance.get(\"api/sms/numbers\")).data;\n  }\n\n  async sendVirtualSms(params: SendVirtualSmsParams): Promise<void> {\n    return (await this.axiosInstance.post(\"api/sms/virtual\", params)).data;\n  }\n\n  /**\n   * List saved TOTP devices.\n   *\n   * @example\n   * List saved TOTP devices for an issuer and username\n   * ```typescript\n   * const { items: devices } = await client.listTotpDevices({\n   *   issuer: \"GitHub\",\n   *   username: \"qa@example.com\",\n   * });\n   * ```\n   */\n  async listTotpDevices(params?: ListTotpDevicesParams): Promise<ListTotpDevicesResponse> {\n    const requestParams: ListTotpDevicesParams = {\n      ...params,\n      username: params?.username?.trim(),\n      issuer: params?.issuer?.trim(),\n    };\n\n    return (\n      await this.axiosInstance.get(\"api/devices\", {\n        params: requestParams,\n      })\n    ).data;\n  }\n\n  /**\n   * Create a saved TOTP device from a Base32 shared secret using default TOTP settings.\n   *\n   * @example\n   * Create a saved TOTP device from a shared secret\n   * ```typescript\n   * const device = await client.createTotpDevice({\n   *   name: \"GitHub staging\",\n   *   shared_secret: \"JBSWY3DPEHPK3PXP\",\n   * });\n   * ```\n   */\n  async createTotpDevice(params: CreateTotpDeviceParams): Promise<TotpDevice> {\n    return (await this.axiosInstance.post(\"api/devices\", params)).data;\n  }\n\n  /**\n   * Create a saved TOTP device with custom settings.\n   *\n   * @example\n   * Create a saved TOTP device with custom settings\n   * ```typescript\n   * const device = await client.createCustomTotpDevice({\n   *   name: \"GitHub staging\",\n   *   secret: \"JBSWY3DPEHPK3PXP\",\n   *   username: \"qa@example.com\",\n   *   issuer: \"GitHub\",\n   *   digits: 6,\n   *   period: 30,\n   *   algorithm: \"SHA1\",\n   * });\n   * ```\n   */\n  async createCustomTotpDevice(params: CreateCustomTotpDeviceParams): Promise<TotpDevice> {\n    return (await this.axiosInstance.post(\"api/devices/custom\", params)).data;\n  }\n\n  /**\n   * Create a saved TOTP device from a Base32 secret key.\n   *\n   * @example\n   * Create a saved TOTP device from a Base32 secret key\n   * ```typescript\n   * const device = await client.createTotpDeviceFromBase32SecretKey({\n   *   base32_secret_key: \"JBSWY3DPEHPK3PXP\",\n   *   username: \"qa@example.com\",\n   *   issuer: \"GitHub\",\n   * });\n   * ```\n   */\n  async createTotpDeviceFromBase32SecretKey(params: CreateBase32SecretKeyTotpDeviceParams): Promise<TotpDevice> {\n    return (await this.axiosInstance.post(\"api/devices/base32-secret-key\", params)).data;\n  }\n\n  /**\n   * Create a saved TOTP device from an otpauth://totp URL.\n   *\n   * @example\n   * Create a saved TOTP device from an otpauth URL\n   * ```typescript\n   * const device = await client.createTotpDeviceFromOtpAuthUrl({\n   *   otp_auth_url: \"otpauth://totp/GitHub:qa@example.com?secret=JBSWY3DPEHPK3PXP&issuer=GitHub\",\n   * });\n   * ```\n   */\n  async createTotpDeviceFromOtpAuthUrl(params: CreateOtpAuthUrlTotpDeviceParams): Promise<TotpDevice> {\n    return (await this.axiosInstance.post(\"api/devices/otpauth-url\", params)).data;\n  }\n\n  /**\n   * Generate a TOTP code from a shared secret without saving a device.\n   *\n   * @example\n   * Generate a TOTP code from a shared secret\n   * ```typescript\n   * const { code } = await client.getTotpOtpBySharedSecret(\"JBSWY3DPEHPK3PXP\", {\n   *   min_seconds_until_expire: 10,\n   * });\n   * ```\n   */\n  async getTotpOtpBySharedSecret(sharedSecret: string, params?: GetTotpOtpParams): Promise<TotpOtpResponse> {\n    return (await this.axiosInstance.post(\"api/devices/otp\", { shared_secret: sharedSecret, ...params })).data;\n  }\n\n  /**\n   * Generate a TOTP code for a saved device.\n   *\n   * @example\n   * Generate a TOTP code for a saved device\n   * ```typescript\n   * const { code } = await client.getTotpOtpByDeviceId(device.id, {\n   *   min_seconds_until_expire: 10,\n   * });\n   * ```\n   */\n  async getTotpOtpByDeviceId(deviceId: string, params?: GetTotpOtpParams): Promise<TotpOtpResponse> {\n    const url = `api/devices/${deviceId}/otp`;\n\n    return params ? (await this.axiosInstance.get(url, { params })).data : (await this.axiosInstance.get(url)).data;\n  }\n\n  /**\n   * Delete a saved TOTP device.\n   *\n   * @example\n   * Delete a saved TOTP device\n   * ```typescript\n   * await client.deleteTotpDevice(device.id);\n   * ```\n   */\n  async deleteTotpDevice(deviceId: string): Promise<void> {\n    await this.axiosInstance.delete(`api/devices/${deviceId}`);\n  }\n\n  /**\n   * List all namespaces that belong to the current account (API key).\n   */\n  async listNamespaces(): Promise<ListNamespacesResponse> {\n    return (await this.axiosInstance.get(\"api/namespaces\")).data;\n  }\n\n  /**\n   * Send an email using the Virtual SMTP.\n   *\n   * These emails can only be sent to valid Mailisk namespaces, i.e. emails that end in @mynamespace.mailisk.net\n   *\n   * @example\n   * For example, sending a test email:\n   * ```typescript\n   * client.sendVirtualEmail(namespace, {\n   *   from: \"test@example.com\",\n   *   to: `john@${namespace}.mailisk.net`,\n   *   subject: \"This is a test\",\n   *   text: \"Testing\",\n   * });\n   * ```\n   */\n  async sendVirtualEmail(namespace: string, params: SendVirtualEmailParams): Promise<void> {\n    const smtpSettings = await this.getSmtpSettings(namespace);\n\n    const transport = nodemailer.createTransport({\n      host: smtpSettings.data.host,\n      port: smtpSettings.data.port,\n      secure: false,\n      auth: {\n        user: smtpSettings.data.username,\n        pass: smtpSettings.data.password,\n      },\n    });\n\n    const { from, to, subject, text, html, headers, attachments } = params;\n\n    await transport.sendMail({\n      from,\n      to,\n      subject,\n      text,\n      html,\n      headers,\n      attachments,\n    });\n\n    transport.close();\n  }\n\n  /**\n   * Search inbox of a namespace.\n   *\n   * By default, this calls the api using the `wait` flag. This means the call won't timeout until at least one email is received or 5 minutes pass.\n   * It also uses a default `from_timestamp` of **current timestamp - 15 minutes**. This means that older emails will be ignored.\n   *\n   * Both of these settings can be overriden by passing them in the `params` object.\n   *\n   * @example\n   * Get the latest emails\n   * ```typescript\n   * const { data: emails } = await client.searchInbox(namespace);\n   * ```\n   *\n   * @example\n   * Get the latest emails for a specific email address\n   * ```typescript\n   * const { data: emails } = await client.searchInbox(namespace, {\n   *   to_addr_prefix: 'john@mynamespace.mailisk.net'\n   * });\n   * ```\n   *\n   * @example\n   * Get the last 20 emails in the namespace\n   * ```typescript\n   * const { data: emails } = await mailisk.searchInbox(namespace, {\n   *   wait: false,\n   *   from_timestamp: 0,\n   *   limit: 20\n   * });\n   * ```\n   */\n  async searchInbox(\n    namespace: string,\n    params?: SearchInboxParams,\n    config?: AxiosRequestConfig,\n  ): Promise<SearchInboxResponse> {\n    let _params = { ...params };\n\n    // default from timestamp, 15 minutes before starting this request\n    if (params?.from_timestamp === undefined || params?.from_timestamp === null) {\n      _params.from_timestamp = Math.floor(new Date().getTime() / 1000) - 15 * 60;\n    }\n\n    // by default wait for email\n    if (params?.wait !== false) {\n      _params.wait = true;\n    }\n\n    let _config = { ...config };\n\n    if (config?.maxRedirects === undefined) {\n      _config.maxRedirects = 99999;\n    }\n\n    // by default, wait 5 minutes for emails before timing out\n    if (_params.wait && config?.timeout === undefined) {\n      _config.timeout = 1000 * 60 * 5;\n    }\n\n    return (\n      await this.axiosInstance.get(`api/emails/${namespace}/inbox`, {\n        ..._config,\n        params: _params,\n      })\n    ).data;\n  }\n\n  /**\n   * Get the SMTP settings for a namespace.\n   */\n  async getSmtpSettings(namespace: string): Promise<SmtpSettings> {\n    const result = await this.axiosInstance.get(`api/smtp/${namespace}`);\n    return result.data;\n  }\n\n  async getAttachment(attachmentId: string): Promise<GetAttachmentResponse> {\n    const result = await this.axiosInstance.get(`api/attachments/${attachmentId}`);\n    return result.data;\n  }\n\n  /**\n   * Download an attachment from an attachment ID.\n   *\n   * @example\n   * Download an attachment from an email\n   * ```typescript\n   * const attachment = email.attachments[0];\n   * const attachmentBuffer = await client.downloadAttachment(attachment.id);\n   *\n   * // save to file\n   * fs.writeFileSync(attachment.filename, attachmentBuffer);\n   * ```\n   */\n  async downloadAttachment(attachmentId: string): Promise<Buffer> {\n    const result = await this.getAttachment(attachmentId);\n\n    const response = await axios.get(result.data.download_url, { responseType: \"arraybuffer\" });\n    return Buffer.from(response.data);\n  }\n}\n"],"mappings":"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","names":["axios","nodemailer"]}
+{"version":3,"sources":["../src/index.ts","../src/mailisk.ts"],"sourcesContent":["export * from \"./mailisk\";\nexport * from \"./mailisk.interfaces\";\n","import axios, { AxiosBasicCredentials, AxiosInstance, AxiosRequestConfig } from \"axios\";\nimport {\n  CreateBase32SecretKeyTotpDeviceParams,\n  CreateCustomTotpDeviceParams,\n  CreateOtpAuthUrlTotpDeviceParams,\n  CreateTotpDeviceParams,\n  GetAttachmentResponse,\n  GetTotpOtpParams,\n  ListNamespacesResponse,\n  ListSmsNumbersResponse,\n  ListTotpDevicesParams,\n  ListTotpDevicesResponse,\n  ForwardEmailParams,\n  OutboundEmailDetailResponse,\n  OutboundEmailResponse,\n  ReplyToEmailParams,\n  SearchInboxParams,\n  SearchInboxResponse,\n  SearchSmsMessagesParams,\n  SearchSmsMessagesResponse,\n  SendEmailParams,\n  SendVirtualEmailParams,\n  SendVirtualSmsParams,\n  SmtpSettings,\n  TotpDevice,\n  TotpOtpResponse,\n} from \"./mailisk.interfaces\";\nimport nodemailer from \"nodemailer\";\n\nexport class MailiskClient {\n  constructor({ apiKey, baseUrl, auth }: { apiKey: string; baseUrl?: string; auth?: AxiosBasicCredentials }) {\n    this.axiosInstance = axios.create({\n      headers: {\n        \"X-Api-Key\": apiKey,\n      },\n      baseURL: baseUrl || \"https://api.mailisk.com/\",\n      auth,\n    });\n  }\n\n  private readonly axiosInstance: AxiosInstance;\n\n  /**\n   * Search SMS messages sent to a phone number.\n   *\n   * @example\n   * Search for SMS messages sent to a phone number\n   * ```typescript\n   * const { data: smsMessages } = await client.searchSmsMessages(\"1234567890\");\n   * ```\n   */\n  async searchSmsMessages(\n    phoneNumber: string,\n    params?: SearchSmsMessagesParams,\n    config?: AxiosRequestConfig,\n  ): Promise<SearchSmsMessagesResponse> {\n    let _params: SearchSmsMessagesParams = { ...params };\n\n    // default from timestamp, 15 minutes before starting this request\n    if (params?.from_date === undefined || params?.from_date === null) {\n      _params.from_date = new Date(Date.now() - 15 * 60 * 1000).toISOString();\n    }\n\n    // by default wait for sms\n    if (params?.wait !== false) {\n      _params.wait = true;\n    }\n\n    let _config = { ...config };\n\n    if (config?.maxRedirects === undefined) {\n      _config.maxRedirects = 99999;\n    }\n\n    // by default, wait 5 minutes for emails before timing out\n    if (_params.wait && config?.timeout === undefined) {\n      _config.timeout = 1000 * 60 * 5;\n    }\n\n    const requestParams = {\n      ..._params,\n      from_date: _params.from_date ?? undefined,\n      to_date: _params.to_date ?? undefined,\n    };\n\n    return (\n      await this.axiosInstance.get(`api/sms/${phoneNumber}/messages`, {\n        ..._config,\n        params: requestParams,\n      })\n    ).data;\n  }\n\n  /**\n   * List all SMS phone numbers associated with the current account.\n   *\n   * @example\n   * List all SMS phone numbers\n   * ```typescript\n   * const { data: smsNumbers } = await client.listSmsNumbers();\n   * ```\n   */\n  async listSmsNumbers(): Promise<ListSmsNumbersResponse> {\n    return (await this.axiosInstance.get(\"api/sms/numbers\")).data;\n  }\n\n  async sendVirtualSms(params: SendVirtualSmsParams): Promise<void> {\n    return (await this.axiosInstance.post(\"api/sms/virtual\", params)).data;\n  }\n\n  /**\n   * Create and queue a new outbound email from a namespace.\n   *\n   * @example\n   * Send an outbound email\n   * ```typescript\n   * const email = await client.sendEmail(\"mynamespace\", {\n   *   to: [\"verified@example.com\"],\n   *   subject: \"Hello\",\n   *   text: \"Hello from Mailisk\",\n   * });\n   * ```\n   */\n  async sendEmail(namespace: string, params: SendEmailParams): Promise<OutboundEmailResponse> {\n    return (\n      await this.axiosInstance.post(\"api/emails/send\", params, {\n        params: { namespace },\n      })\n    ).data;\n  }\n\n  /**\n   * Get current delivery state for an outbound email.\n   */\n  async getOutboundEmail(outboundEmailId: string): Promise<OutboundEmailDetailResponse> {\n    return (await this.axiosInstance.get(`api/emails/outbound/${outboundEmailId}`)).data;\n  }\n\n  /**\n   * Create and queue a reply to an inbound email.\n   */\n  async replyToEmail(emailId: string, params: ReplyToEmailParams): Promise<OutboundEmailResponse> {\n    return (await this.axiosInstance.post(`api/emails/${emailId}/reply`, params)).data;\n  }\n\n  /**\n   * Create and queue a forwarded copy of an inbound email.\n   */\n  async forwardEmail(emailId: string, params: ForwardEmailParams): Promise<OutboundEmailResponse> {\n    return (await this.axiosInstance.post(`api/emails/${emailId}/forward`, params)).data;\n  }\n\n  /**\n   * List saved TOTP devices.\n   *\n   * @example\n   * List saved TOTP devices for an issuer and username\n   * ```typescript\n   * const { items: devices } = await client.listTotpDevices({\n   *   issuer: \"GitHub\",\n   *   username: \"qa@example.com\",\n   * });\n   * ```\n   */\n  async listTotpDevices(params?: ListTotpDevicesParams): Promise<ListTotpDevicesResponse> {\n    const requestParams: ListTotpDevicesParams = {\n      ...params,\n      username: params?.username?.trim(),\n      issuer: params?.issuer?.trim(),\n    };\n\n    return (\n      await this.axiosInstance.get(\"api/devices\", {\n        params: requestParams,\n      })\n    ).data;\n  }\n\n  /**\n   * Create a saved TOTP device from a Base32 shared secret using default TOTP settings.\n   *\n   * @example\n   * Create a saved TOTP device from a shared secret\n   * ```typescript\n   * const device = await client.createTotpDevice({\n   *   name: \"GitHub staging\",\n   *   shared_secret: \"JBSWY3DPEHPK3PXP\",\n   * });\n   * ```\n   */\n  async createTotpDevice(params: CreateTotpDeviceParams): Promise<TotpDevice> {\n    return (await this.axiosInstance.post(\"api/devices\", params)).data;\n  }\n\n  /**\n   * Create a saved TOTP device with custom settings.\n   *\n   * @example\n   * Create a saved TOTP device with custom settings\n   * ```typescript\n   * const device = await client.createCustomTotpDevice({\n   *   name: \"GitHub staging\",\n   *   secret: \"JBSWY3DPEHPK3PXP\",\n   *   username: \"qa@example.com\",\n   *   issuer: \"GitHub\",\n   *   digits: 6,\n   *   period: 30,\n   *   algorithm: \"SHA1\",\n   * });\n   * ```\n   */\n  async createCustomTotpDevice(params: CreateCustomTotpDeviceParams): Promise<TotpDevice> {\n    return (await this.axiosInstance.post(\"api/devices/custom\", params)).data;\n  }\n\n  /**\n   * Create a saved TOTP device from a Base32 secret key.\n   *\n   * @example\n   * Create a saved TOTP device from a Base32 secret key\n   * ```typescript\n   * const device = await client.createTotpDeviceFromBase32SecretKey({\n   *   base32_secret_key: \"JBSWY3DPEHPK3PXP\",\n   *   username: \"qa@example.com\",\n   *   issuer: \"GitHub\",\n   * });\n   * ```\n   */\n  async createTotpDeviceFromBase32SecretKey(params: CreateBase32SecretKeyTotpDeviceParams): Promise<TotpDevice> {\n    return (await this.axiosInstance.post(\"api/devices/base32-secret-key\", params)).data;\n  }\n\n  /**\n   * Create a saved TOTP device from an otpauth://totp URL.\n   *\n   * @example\n   * Create a saved TOTP device from an otpauth URL\n   * ```typescript\n   * const device = await client.createTotpDeviceFromOtpAuthUrl({\n   *   otp_auth_url: \"otpauth://totp/GitHub:qa@example.com?secret=JBSWY3DPEHPK3PXP&issuer=GitHub\",\n   * });\n   * ```\n   */\n  async createTotpDeviceFromOtpAuthUrl(params: CreateOtpAuthUrlTotpDeviceParams): Promise<TotpDevice> {\n    return (await this.axiosInstance.post(\"api/devices/otpauth-url\", params)).data;\n  }\n\n  /**\n   * Generate a TOTP code from a shared secret without saving a device.\n   *\n   * @example\n   * Generate a TOTP code from a shared secret\n   * ```typescript\n   * const { code } = await client.getTotpOtpBySharedSecret(\"JBSWY3DPEHPK3PXP\", {\n   *   min_seconds_until_expire: 10,\n   * });\n   * ```\n   */\n  async getTotpOtpBySharedSecret(sharedSecret: string, params?: GetTotpOtpParams): Promise<TotpOtpResponse> {\n    return (await this.axiosInstance.post(\"api/devices/otp\", { shared_secret: sharedSecret, ...params })).data;\n  }\n\n  /**\n   * Generate a TOTP code for a saved device.\n   *\n   * @example\n   * Generate a TOTP code for a saved device\n   * ```typescript\n   * const { code } = await client.getTotpOtpByDeviceId(device.id, {\n   *   min_seconds_until_expire: 10,\n   * });\n   * ```\n   */\n  async getTotpOtpByDeviceId(deviceId: string, params?: GetTotpOtpParams): Promise<TotpOtpResponse> {\n    const url = `api/devices/${deviceId}/otp`;\n\n    return params ? (await this.axiosInstance.get(url, { params })).data : (await this.axiosInstance.get(url)).data;\n  }\n\n  /**\n   * Delete a saved TOTP device.\n   *\n   * @example\n   * Delete a saved TOTP device\n   * ```typescript\n   * await client.deleteTotpDevice(device.id);\n   * ```\n   */\n  async deleteTotpDevice(deviceId: string): Promise<void> {\n    await this.axiosInstance.delete(`api/devices/${deviceId}`);\n  }\n\n  /**\n   * List all namespaces that belong to the current account (API key).\n   */\n  async listNamespaces(): Promise<ListNamespacesResponse> {\n    return (await this.axiosInstance.get(\"api/namespaces\")).data;\n  }\n\n  /**\n   * Send an email using the Virtual SMTP.\n   *\n   * These emails can only be sent to valid Mailisk namespaces, i.e. emails that end in @mynamespace.mailisk.net\n   *\n   * @deprecated Use sendEmail(namespace, params) for outbound email. This method remains available for existing Virtual SMTP tests.\n   *\n   * @example\n   * For example, sending a test email:\n   * ```typescript\n   * client.sendVirtualEmail(namespace, {\n   *   from: \"test@example.com\",\n   *   to: `john@${namespace}.mailisk.net`,\n   *   subject: \"This is a test\",\n   *   text: \"Testing\",\n   * });\n   * ```\n   */\n  async sendVirtualEmail(namespace: string, params: SendVirtualEmailParams): Promise<void> {\n    const smtpSettings = await this.getSmtpSettings(namespace);\n\n    const transport = nodemailer.createTransport({\n      host: smtpSettings.data.host,\n      port: smtpSettings.data.port,\n      secure: false,\n      auth: {\n        user: smtpSettings.data.username,\n        pass: smtpSettings.data.password,\n      },\n    });\n\n    const { from, to, subject, text, html, headers, attachments } = params;\n\n    await transport.sendMail({\n      from,\n      to,\n      subject,\n      text,\n      html,\n      headers,\n      attachments,\n    });\n\n    transport.close();\n  }\n\n  /**\n   * Search inbox of a namespace.\n   *\n   * By default, this calls the api using the `wait` flag. This means the call won't timeout until at least one email is received or 5 minutes pass.\n   * It also uses a default `from_timestamp` of **current timestamp - 15 minutes**. This means that older emails will be ignored.\n   *\n   * Both of these settings can be overriden by passing them in the `params` object.\n   *\n   * @example\n   * Get the latest emails\n   * ```typescript\n   * const { data: emails } = await client.searchInbox(namespace);\n   * ```\n   *\n   * @example\n   * Get the latest emails for a specific email address\n   * ```typescript\n   * const { data: emails } = await client.searchInbox(namespace, {\n   *   to_addr_prefix: 'john@mynamespace.mailisk.net'\n   * });\n   * ```\n   *\n   * @example\n   * Get the last 20 emails in the namespace\n   * ```typescript\n   * const { data: emails } = await mailisk.searchInbox(namespace, {\n   *   wait: false,\n   *   from_timestamp: 0,\n   *   limit: 20\n   * });\n   * ```\n   */\n  async searchInbox(\n    namespace: string,\n    params?: SearchInboxParams,\n    config?: AxiosRequestConfig,\n  ): Promise<SearchInboxResponse> {\n    let _params = { ...params };\n\n    // default from timestamp, 15 minutes before starting this request\n    if (params?.from_timestamp === undefined || params?.from_timestamp === null) {\n      _params.from_timestamp = Math.floor(new Date().getTime() / 1000) - 15 * 60;\n    }\n\n    // by default wait for email\n    if (params?.wait !== false) {\n      _params.wait = true;\n    }\n\n    let _config = { ...config };\n\n    if (config?.maxRedirects === undefined) {\n      _config.maxRedirects = 99999;\n    }\n\n    // by default, wait 5 minutes for emails before timing out\n    if (_params.wait && config?.timeout === undefined) {\n      _config.timeout = 1000 * 60 * 5;\n    }\n\n    return (\n      await this.axiosInstance.get(`api/emails/${namespace}/inbox`, {\n        ..._config,\n        params: _params,\n      })\n    ).data;\n  }\n\n  /**\n   * Get the SMTP settings for a namespace.\n   *\n   * @deprecated Virtual SMTP is deprecated. Use sendEmail(namespace, params) for outbound email instead.\n   */\n  async getSmtpSettings(namespace: string): Promise<SmtpSettings> {\n    const result = await this.axiosInstance.get(`api/smtp/${namespace}`);\n    return result.data;\n  }\n\n  async getAttachment(attachmentId: string): Promise<GetAttachmentResponse> {\n    const result = await this.axiosInstance.get(`api/attachments/${attachmentId}`);\n    return result.data;\n  }\n\n  /**\n   * Download an attachment from an attachment ID.\n   *\n   * @example\n   * Download an attachment from an email\n   * ```typescript\n   * const attachment = email.attachments[0];\n   * const attachmentBuffer = await client.downloadAttachment(attachment.id);\n   *\n   * // save to file\n   * fs.writeFileSync(attachment.filename, attachmentBuffer);\n   * ```\n   */\n  async downloadAttachment(attachmentId: string): Promise<Buffer> {\n    const result = await this.getAttachment(attachmentId);\n\n    const response = await axios.get(result.data.download_url, { responseType: \"arraybuffer\" });\n    return Buffer.from(response.data);\n  }\n}\n"],"mappings":"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","names":["axios","nodemailer"]}

package/dist/index.mjs

@@ -67,6 +67,42 @@ var MailiskClient = class {
   async sendVirtualSms(params) {
     return (await this.axiosInstance.post("api/sms/virtual", params)).data;
   }
+  /**
+   * 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",
+   * });
+   * ```
+   */
+  async sendEmail(namespace, params) {
+    return (await this.axiosInstance.post("api/emails/send", params, {
+      params: { namespace }
+    })).data;
+  }
+  /**
+   * Get current delivery state for an outbound email.
+   */
+  async getOutboundEmail(outboundEmailId) {
+    return (await this.axiosInstance.get(`api/emails/outbound/${outboundEmailId}`)).data;
+  }
+  /**
+   * Create and queue a reply to an inbound email.
+   */
+  async replyToEmail(emailId, params) {
+    return (await this.axiosInstance.post(`api/emails/${emailId}/reply`, params)).data;
+  }
+  /**
+   * Create and queue a forwarded copy of an inbound email.
+   */
+  async forwardEmail(emailId, params) {
+    return (await this.axiosInstance.post(`api/emails/${emailId}/forward`, params)).data;
+  }
   /**
    * List saved TOTP devices.
    *
@@ -206,6 +242,8 @@ var MailiskClient = class {
    *
    * 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
@@ -294,6 +332,8 @@ var MailiskClient = class {
   }
   /**
    * Get the SMTP settings for a namespace.
+   *
+   * @deprecated Virtual SMTP is deprecated. Use sendEmail(namespace, params) for outbound email instead.
    */
   async getSmtpSettings(namespace) {
     const result = await this.axiosInstance.get(`api/smtp/${namespace}`);

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/mailisk.ts"],"sourcesContent":["import axios, { AxiosBasicCredentials, AxiosInstance, AxiosRequestConfig } from \"axios\";\nimport {\n  CreateBase32SecretKeyTotpDeviceParams,\n  CreateCustomTotpDeviceParams,\n  CreateOtpAuthUrlTotpDeviceParams,\n  CreateTotpDeviceParams,\n  GetAttachmentResponse,\n  GetTotpOtpParams,\n  ListNamespacesResponse,\n  ListSmsNumbersResponse,\n  ListTotpDevicesParams,\n  ListTotpDevicesResponse,\n  SearchInboxParams,\n  SearchInboxResponse,\n  SearchSmsMessagesParams,\n  SearchSmsMessagesResponse,\n  SendVirtualEmailParams,\n  SendVirtualSmsParams,\n  SmtpSettings,\n  TotpDevice,\n  TotpOtpResponse,\n} from \"./mailisk.interfaces\";\nimport nodemailer from \"nodemailer\";\n\nexport class MailiskClient {\n  constructor({ apiKey, baseUrl, auth }: { apiKey: string; baseUrl?: string; auth?: AxiosBasicCredentials }) {\n    this.axiosInstance = axios.create({\n      headers: {\n        \"X-Api-Key\": apiKey,\n      },\n      baseURL: baseUrl || \"https://api.mailisk.com/\",\n      auth,\n    });\n  }\n\n  private readonly axiosInstance: AxiosInstance;\n\n  /**\n   * Search SMS messages sent to a phone number.\n   *\n   * @example\n   * Search for SMS messages sent to a phone number\n   * ```typescript\n   * const { data: smsMessages } = await client.searchSmsMessages(\"1234567890\");\n   * ```\n   */\n  async searchSmsMessages(\n    phoneNumber: string,\n    params?: SearchSmsMessagesParams,\n    config?: AxiosRequestConfig,\n  ): Promise<SearchSmsMessagesResponse> {\n    let _params: SearchSmsMessagesParams = { ...params };\n\n    // default from timestamp, 15 minutes before starting this request\n    if (params?.from_date === undefined || params?.from_date === null) {\n      _params.from_date = new Date(Date.now() - 15 * 60 * 1000).toISOString();\n    }\n\n    // by default wait for sms\n    if (params?.wait !== false) {\n      _params.wait = true;\n    }\n\n    let _config = { ...config };\n\n    if (config?.maxRedirects === undefined) {\n      _config.maxRedirects = 99999;\n    }\n\n    // by default, wait 5 minutes for emails before timing out\n    if (_params.wait && config?.timeout === undefined) {\n      _config.timeout = 1000 * 60 * 5;\n    }\n\n    const requestParams = {\n      ..._params,\n      from_date: _params.from_date ?? undefined,\n      to_date: _params.to_date ?? undefined,\n    };\n\n    return (\n      await this.axiosInstance.get(`api/sms/${phoneNumber}/messages`, {\n        ..._config,\n        params: requestParams,\n      })\n    ).data;\n  }\n\n  /**\n   * List all SMS phone numbers associated with the current account.\n   *\n   * @example\n   * List all SMS phone numbers\n   * ```typescript\n   * const { data: smsNumbers } = await client.listSmsNumbers();\n   * ```\n   */\n  async listSmsNumbers(): Promise<ListSmsNumbersResponse> {\n    return (await this.axiosInstance.get(\"api/sms/numbers\")).data;\n  }\n\n  async sendVirtualSms(params: SendVirtualSmsParams): Promise<void> {\n    return (await this.axiosInstance.post(\"api/sms/virtual\", params)).data;\n  }\n\n  /**\n   * List saved TOTP devices.\n   *\n   * @example\n   * List saved TOTP devices for an issuer and username\n   * ```typescript\n   * const { items: devices } = await client.listTotpDevices({\n   *   issuer: \"GitHub\",\n   *   username: \"qa@example.com\",\n   * });\n   * ```\n   */\n  async listTotpDevices(params?: ListTotpDevicesParams): Promise<ListTotpDevicesResponse> {\n    const requestParams: ListTotpDevicesParams = {\n      ...params,\n      username: params?.username?.trim(),\n      issuer: params?.issuer?.trim(),\n    };\n\n    return (\n      await this.axiosInstance.get(\"api/devices\", {\n        params: requestParams,\n      })\n    ).data;\n  }\n\n  /**\n   * Create a saved TOTP device from a Base32 shared secret using default TOTP settings.\n   *\n   * @example\n   * Create a saved TOTP device from a shared secret\n   * ```typescript\n   * const device = await client.createTotpDevice({\n   *   name: \"GitHub staging\",\n   *   shared_secret: \"JBSWY3DPEHPK3PXP\",\n   * });\n   * ```\n   */\n  async createTotpDevice(params: CreateTotpDeviceParams): Promise<TotpDevice> {\n    return (await this.axiosInstance.post(\"api/devices\", params)).data;\n  }\n\n  /**\n   * Create a saved TOTP device with custom settings.\n   *\n   * @example\n   * Create a saved TOTP device with custom settings\n   * ```typescript\n   * const device = await client.createCustomTotpDevice({\n   *   name: \"GitHub staging\",\n   *   secret: \"JBSWY3DPEHPK3PXP\",\n   *   username: \"qa@example.com\",\n   *   issuer: \"GitHub\",\n   *   digits: 6,\n   *   period: 30,\n   *   algorithm: \"SHA1\",\n   * });\n   * ```\n   */\n  async createCustomTotpDevice(params: CreateCustomTotpDeviceParams): Promise<TotpDevice> {\n    return (await this.axiosInstance.post(\"api/devices/custom\", params)).data;\n  }\n\n  /**\n   * Create a saved TOTP device from a Base32 secret key.\n   *\n   * @example\n   * Create a saved TOTP device from a Base32 secret key\n   * ```typescript\n   * const device = await client.createTotpDeviceFromBase32SecretKey({\n   *   base32_secret_key: \"JBSWY3DPEHPK3PXP\",\n   *   username: \"qa@example.com\",\n   *   issuer: \"GitHub\",\n   * });\n   * ```\n   */\n  async createTotpDeviceFromBase32SecretKey(params: CreateBase32SecretKeyTotpDeviceParams): Promise<TotpDevice> {\n    return (await this.axiosInstance.post(\"api/devices/base32-secret-key\", params)).data;\n  }\n\n  /**\n   * Create a saved TOTP device from an otpauth://totp URL.\n   *\n   * @example\n   * Create a saved TOTP device from an otpauth URL\n   * ```typescript\n   * const device = await client.createTotpDeviceFromOtpAuthUrl({\n   *   otp_auth_url: \"otpauth://totp/GitHub:qa@example.com?secret=JBSWY3DPEHPK3PXP&issuer=GitHub\",\n   * });\n   * ```\n   */\n  async createTotpDeviceFromOtpAuthUrl(params: CreateOtpAuthUrlTotpDeviceParams): Promise<TotpDevice> {\n    return (await this.axiosInstance.post(\"api/devices/otpauth-url\", params)).data;\n  }\n\n  /**\n   * Generate a TOTP code from a shared secret without saving a device.\n   *\n   * @example\n   * Generate a TOTP code from a shared secret\n   * ```typescript\n   * const { code } = await client.getTotpOtpBySharedSecret(\"JBSWY3DPEHPK3PXP\", {\n   *   min_seconds_until_expire: 10,\n   * });\n   * ```\n   */\n  async getTotpOtpBySharedSecret(sharedSecret: string, params?: GetTotpOtpParams): Promise<TotpOtpResponse> {\n    return (await this.axiosInstance.post(\"api/devices/otp\", { shared_secret: sharedSecret, ...params })).data;\n  }\n\n  /**\n   * Generate a TOTP code for a saved device.\n   *\n   * @example\n   * Generate a TOTP code for a saved device\n   * ```typescript\n   * const { code } = await client.getTotpOtpByDeviceId(device.id, {\n   *   min_seconds_until_expire: 10,\n   * });\n   * ```\n   */\n  async getTotpOtpByDeviceId(deviceId: string, params?: GetTotpOtpParams): Promise<TotpOtpResponse> {\n    const url = `api/devices/${deviceId}/otp`;\n\n    return params ? (await this.axiosInstance.get(url, { params })).data : (await this.axiosInstance.get(url)).data;\n  }\n\n  /**\n   * Delete a saved TOTP device.\n   *\n   * @example\n   * Delete a saved TOTP device\n   * ```typescript\n   * await client.deleteTotpDevice(device.id);\n   * ```\n   */\n  async deleteTotpDevice(deviceId: string): Promise<void> {\n    await this.axiosInstance.delete(`api/devices/${deviceId}`);\n  }\n\n  /**\n   * List all namespaces that belong to the current account (API key).\n   */\n  async listNamespaces(): Promise<ListNamespacesResponse> {\n    return (await this.axiosInstance.get(\"api/namespaces\")).data;\n  }\n\n  /**\n   * Send an email using the Virtual SMTP.\n   *\n   * These emails can only be sent to valid Mailisk namespaces, i.e. emails that end in @mynamespace.mailisk.net\n   *\n   * @example\n   * For example, sending a test email:\n   * ```typescript\n   * client.sendVirtualEmail(namespace, {\n   *   from: \"test@example.com\",\n   *   to: `john@${namespace}.mailisk.net`,\n   *   subject: \"This is a test\",\n   *   text: \"Testing\",\n   * });\n   * ```\n   */\n  async sendVirtualEmail(namespace: string, params: SendVirtualEmailParams): Promise<void> {\n    const smtpSettings = await this.getSmtpSettings(namespace);\n\n    const transport = nodemailer.createTransport({\n      host: smtpSettings.data.host,\n      port: smtpSettings.data.port,\n      secure: false,\n      auth: {\n        user: smtpSettings.data.username,\n        pass: smtpSettings.data.password,\n      },\n    });\n\n    const { from, to, subject, text, html, headers, attachments } = params;\n\n    await transport.sendMail({\n      from,\n      to,\n      subject,\n      text,\n      html,\n      headers,\n      attachments,\n    });\n\n    transport.close();\n  }\n\n  /**\n   * Search inbox of a namespace.\n   *\n   * By default, this calls the api using the `wait` flag. This means the call won't timeout until at least one email is received or 5 minutes pass.\n   * It also uses a default `from_timestamp` of **current timestamp - 15 minutes**. This means that older emails will be ignored.\n   *\n   * Both of these settings can be overriden by passing them in the `params` object.\n   *\n   * @example\n   * Get the latest emails\n   * ```typescript\n   * const { data: emails } = await client.searchInbox(namespace);\n   * ```\n   *\n   * @example\n   * Get the latest emails for a specific email address\n   * ```typescript\n   * const { data: emails } = await client.searchInbox(namespace, {\n   *   to_addr_prefix: 'john@mynamespace.mailisk.net'\n   * });\n   * ```\n   *\n   * @example\n   * Get the last 20 emails in the namespace\n   * ```typescript\n   * const { data: emails } = await mailisk.searchInbox(namespace, {\n   *   wait: false,\n   *   from_timestamp: 0,\n   *   limit: 20\n   * });\n   * ```\n   */\n  async searchInbox(\n    namespace: string,\n    params?: SearchInboxParams,\n    config?: AxiosRequestConfig,\n  ): Promise<SearchInboxResponse> {\n    let _params = { ...params };\n\n    // default from timestamp, 15 minutes before starting this request\n    if (params?.from_timestamp === undefined || params?.from_timestamp === null) {\n      _params.from_timestamp = Math.floor(new Date().getTime() / 1000) - 15 * 60;\n    }\n\n    // by default wait for email\n    if (params?.wait !== false) {\n      _params.wait = true;\n    }\n\n    let _config = { ...config };\n\n    if (config?.maxRedirects === undefined) {\n      _config.maxRedirects = 99999;\n    }\n\n    // by default, wait 5 minutes for emails before timing out\n    if (_params.wait && config?.timeout === undefined) {\n      _config.timeout = 1000 * 60 * 5;\n    }\n\n    return (\n      await this.axiosInstance.get(`api/emails/${namespace}/inbox`, {\n        ..._config,\n        params: _params,\n      })\n    ).data;\n  }\n\n  /**\n   * Get the SMTP settings for a namespace.\n   */\n  async getSmtpSettings(namespace: string): Promise<SmtpSettings> {\n    const result = await this.axiosInstance.get(`api/smtp/${namespace}`);\n    return result.data;\n  }\n\n  async getAttachment(attachmentId: string): Promise<GetAttachmentResponse> {\n    const result = await this.axiosInstance.get(`api/attachments/${attachmentId}`);\n    return result.data;\n  }\n\n  /**\n   * Download an attachment from an attachment ID.\n   *\n   * @example\n   * Download an attachment from an email\n   * ```typescript\n   * const attachment = email.attachments[0];\n   * const attachmentBuffer = await client.downloadAttachment(attachment.id);\n   *\n   * // save to file\n   * fs.writeFileSync(attachment.filename, attachmentBuffer);\n   * ```\n   */\n  async downloadAttachment(attachmentId: string): Promise<Buffer> {\n    const result = await this.getAttachment(attachmentId);\n\n    const response = await axios.get(result.data.download_url, { responseType: \"arraybuffer\" });\n    return Buffer.from(response.data);\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/mailisk.ts"],"sourcesContent":["import axios, { AxiosBasicCredentials, AxiosInstance, AxiosRequestConfig } from \"axios\";\nimport {\n  CreateBase32SecretKeyTotpDeviceParams,\n  CreateCustomTotpDeviceParams,\n  CreateOtpAuthUrlTotpDeviceParams,\n  CreateTotpDeviceParams,\n  GetAttachmentResponse,\n  GetTotpOtpParams,\n  ListNamespacesResponse,\n  ListSmsNumbersResponse,\n  ListTotpDevicesParams,\n  ListTotpDevicesResponse,\n  ForwardEmailParams,\n  OutboundEmailDetailResponse,\n  OutboundEmailResponse,\n  ReplyToEmailParams,\n  SearchInboxParams,\n  SearchInboxResponse,\n  SearchSmsMessagesParams,\n  SearchSmsMessagesResponse,\n  SendEmailParams,\n  SendVirtualEmailParams,\n  SendVirtualSmsParams,\n  SmtpSettings,\n  TotpDevice,\n  TotpOtpResponse,\n} from \"./mailisk.interfaces\";\nimport nodemailer from \"nodemailer\";\n\nexport class MailiskClient {\n  constructor({ apiKey, baseUrl, auth }: { apiKey: string; baseUrl?: string; auth?: AxiosBasicCredentials }) {\n    this.axiosInstance = axios.create({\n      headers: {\n        \"X-Api-Key\": apiKey,\n      },\n      baseURL: baseUrl || \"https://api.mailisk.com/\",\n      auth,\n    });\n  }\n\n  private readonly axiosInstance: AxiosInstance;\n\n  /**\n   * Search SMS messages sent to a phone number.\n   *\n   * @example\n   * Search for SMS messages sent to a phone number\n   * ```typescript\n   * const { data: smsMessages } = await client.searchSmsMessages(\"1234567890\");\n   * ```\n   */\n  async searchSmsMessages(\n    phoneNumber: string,\n    params?: SearchSmsMessagesParams,\n    config?: AxiosRequestConfig,\n  ): Promise<SearchSmsMessagesResponse> {\n    let _params: SearchSmsMessagesParams = { ...params };\n\n    // default from timestamp, 15 minutes before starting this request\n    if (params?.from_date === undefined || params?.from_date === null) {\n      _params.from_date = new Date(Date.now() - 15 * 60 * 1000).toISOString();\n    }\n\n    // by default wait for sms\n    if (params?.wait !== false) {\n      _params.wait = true;\n    }\n\n    let _config = { ...config };\n\n    if (config?.maxRedirects === undefined) {\n      _config.maxRedirects = 99999;\n    }\n\n    // by default, wait 5 minutes for emails before timing out\n    if (_params.wait && config?.timeout === undefined) {\n      _config.timeout = 1000 * 60 * 5;\n    }\n\n    const requestParams = {\n      ..._params,\n      from_date: _params.from_date ?? undefined,\n      to_date: _params.to_date ?? undefined,\n    };\n\n    return (\n      await this.axiosInstance.get(`api/sms/${phoneNumber}/messages`, {\n        ..._config,\n        params: requestParams,\n      })\n    ).data;\n  }\n\n  /**\n   * List all SMS phone numbers associated with the current account.\n   *\n   * @example\n   * List all SMS phone numbers\n   * ```typescript\n   * const { data: smsNumbers } = await client.listSmsNumbers();\n   * ```\n   */\n  async listSmsNumbers(): Promise<ListSmsNumbersResponse> {\n    return (await this.axiosInstance.get(\"api/sms/numbers\")).data;\n  }\n\n  async sendVirtualSms(params: SendVirtualSmsParams): Promise<void> {\n    return (await this.axiosInstance.post(\"api/sms/virtual\", params)).data;\n  }\n\n  /**\n   * Create and queue a new outbound email from a namespace.\n   *\n   * @example\n   * Send an outbound email\n   * ```typescript\n   * const email = await client.sendEmail(\"mynamespace\", {\n   *   to: [\"verified@example.com\"],\n   *   subject: \"Hello\",\n   *   text: \"Hello from Mailisk\",\n   * });\n   * ```\n   */\n  async sendEmail(namespace: string, params: SendEmailParams): Promise<OutboundEmailResponse> {\n    return (\n      await this.axiosInstance.post(\"api/emails/send\", params, {\n        params: { namespace },\n      })\n    ).data;\n  }\n\n  /**\n   * Get current delivery state for an outbound email.\n   */\n  async getOutboundEmail(outboundEmailId: string): Promise<OutboundEmailDetailResponse> {\n    return (await this.axiosInstance.get(`api/emails/outbound/${outboundEmailId}`)).data;\n  }\n\n  /**\n   * Create and queue a reply to an inbound email.\n   */\n  async replyToEmail(emailId: string, params: ReplyToEmailParams): Promise<OutboundEmailResponse> {\n    return (await this.axiosInstance.post(`api/emails/${emailId}/reply`, params)).data;\n  }\n\n  /**\n   * Create and queue a forwarded copy of an inbound email.\n   */\n  async forwardEmail(emailId: string, params: ForwardEmailParams): Promise<OutboundEmailResponse> {\n    return (await this.axiosInstance.post(`api/emails/${emailId}/forward`, params)).data;\n  }\n\n  /**\n   * List saved TOTP devices.\n   *\n   * @example\n   * List saved TOTP devices for an issuer and username\n   * ```typescript\n   * const { items: devices } = await client.listTotpDevices({\n   *   issuer: \"GitHub\",\n   *   username: \"qa@example.com\",\n   * });\n   * ```\n   */\n  async listTotpDevices(params?: ListTotpDevicesParams): Promise<ListTotpDevicesResponse> {\n    const requestParams: ListTotpDevicesParams = {\n      ...params,\n      username: params?.username?.trim(),\n      issuer: params?.issuer?.trim(),\n    };\n\n    return (\n      await this.axiosInstance.get(\"api/devices\", {\n        params: requestParams,\n      })\n    ).data;\n  }\n\n  /**\n   * Create a saved TOTP device from a Base32 shared secret using default TOTP settings.\n   *\n   * @example\n   * Create a saved TOTP device from a shared secret\n   * ```typescript\n   * const device = await client.createTotpDevice({\n   *   name: \"GitHub staging\",\n   *   shared_secret: \"JBSWY3DPEHPK3PXP\",\n   * });\n   * ```\n   */\n  async createTotpDevice(params: CreateTotpDeviceParams): Promise<TotpDevice> {\n    return (await this.axiosInstance.post(\"api/devices\", params)).data;\n  }\n\n  /**\n   * Create a saved TOTP device with custom settings.\n   *\n   * @example\n   * Create a saved TOTP device with custom settings\n   * ```typescript\n   * const device = await client.createCustomTotpDevice({\n   *   name: \"GitHub staging\",\n   *   secret: \"JBSWY3DPEHPK3PXP\",\n   *   username: \"qa@example.com\",\n   *   issuer: \"GitHub\",\n   *   digits: 6,\n   *   period: 30,\n   *   algorithm: \"SHA1\",\n   * });\n   * ```\n   */\n  async createCustomTotpDevice(params: CreateCustomTotpDeviceParams): Promise<TotpDevice> {\n    return (await this.axiosInstance.post(\"api/devices/custom\", params)).data;\n  }\n\n  /**\n   * Create a saved TOTP device from a Base32 secret key.\n   *\n   * @example\n   * Create a saved TOTP device from a Base32 secret key\n   * ```typescript\n   * const device = await client.createTotpDeviceFromBase32SecretKey({\n   *   base32_secret_key: \"JBSWY3DPEHPK3PXP\",\n   *   username: \"qa@example.com\",\n   *   issuer: \"GitHub\",\n   * });\n   * ```\n   */\n  async createTotpDeviceFromBase32SecretKey(params: CreateBase32SecretKeyTotpDeviceParams): Promise<TotpDevice> {\n    return (await this.axiosInstance.post(\"api/devices/base32-secret-key\", params)).data;\n  }\n\n  /**\n   * Create a saved TOTP device from an otpauth://totp URL.\n   *\n   * @example\n   * Create a saved TOTP device from an otpauth URL\n   * ```typescript\n   * const device = await client.createTotpDeviceFromOtpAuthUrl({\n   *   otp_auth_url: \"otpauth://totp/GitHub:qa@example.com?secret=JBSWY3DPEHPK3PXP&issuer=GitHub\",\n   * });\n   * ```\n   */\n  async createTotpDeviceFromOtpAuthUrl(params: CreateOtpAuthUrlTotpDeviceParams): Promise<TotpDevice> {\n    return (await this.axiosInstance.post(\"api/devices/otpauth-url\", params)).data;\n  }\n\n  /**\n   * Generate a TOTP code from a shared secret without saving a device.\n   *\n   * @example\n   * Generate a TOTP code from a shared secret\n   * ```typescript\n   * const { code } = await client.getTotpOtpBySharedSecret(\"JBSWY3DPEHPK3PXP\", {\n   *   min_seconds_until_expire: 10,\n   * });\n   * ```\n   */\n  async getTotpOtpBySharedSecret(sharedSecret: string, params?: GetTotpOtpParams): Promise<TotpOtpResponse> {\n    return (await this.axiosInstance.post(\"api/devices/otp\", { shared_secret: sharedSecret, ...params })).data;\n  }\n\n  /**\n   * Generate a TOTP code for a saved device.\n   *\n   * @example\n   * Generate a TOTP code for a saved device\n   * ```typescript\n   * const { code } = await client.getTotpOtpByDeviceId(device.id, {\n   *   min_seconds_until_expire: 10,\n   * });\n   * ```\n   */\n  async getTotpOtpByDeviceId(deviceId: string, params?: GetTotpOtpParams): Promise<TotpOtpResponse> {\n    const url = `api/devices/${deviceId}/otp`;\n\n    return params ? (await this.axiosInstance.get(url, { params })).data : (await this.axiosInstance.get(url)).data;\n  }\n\n  /**\n   * Delete a saved TOTP device.\n   *\n   * @example\n   * Delete a saved TOTP device\n   * ```typescript\n   * await client.deleteTotpDevice(device.id);\n   * ```\n   */\n  async deleteTotpDevice(deviceId: string): Promise<void> {\n    await this.axiosInstance.delete(`api/devices/${deviceId}`);\n  }\n\n  /**\n   * List all namespaces that belong to the current account (API key).\n   */\n  async listNamespaces(): Promise<ListNamespacesResponse> {\n    return (await this.axiosInstance.get(\"api/namespaces\")).data;\n  }\n\n  /**\n   * Send an email using the Virtual SMTP.\n   *\n   * These emails can only be sent to valid Mailisk namespaces, i.e. emails that end in @mynamespace.mailisk.net\n   *\n   * @deprecated Use sendEmail(namespace, params) for outbound email. This method remains available for existing Virtual SMTP tests.\n   *\n   * @example\n   * For example, sending a test email:\n   * ```typescript\n   * client.sendVirtualEmail(namespace, {\n   *   from: \"test@example.com\",\n   *   to: `john@${namespace}.mailisk.net`,\n   *   subject: \"This is a test\",\n   *   text: \"Testing\",\n   * });\n   * ```\n   */\n  async sendVirtualEmail(namespace: string, params: SendVirtualEmailParams): Promise<void> {\n    const smtpSettings = await this.getSmtpSettings(namespace);\n\n    const transport = nodemailer.createTransport({\n      host: smtpSettings.data.host,\n      port: smtpSettings.data.port,\n      secure: false,\n      auth: {\n        user: smtpSettings.data.username,\n        pass: smtpSettings.data.password,\n      },\n    });\n\n    const { from, to, subject, text, html, headers, attachments } = params;\n\n    await transport.sendMail({\n      from,\n      to,\n      subject,\n      text,\n      html,\n      headers,\n      attachments,\n    });\n\n    transport.close();\n  }\n\n  /**\n   * Search inbox of a namespace.\n   *\n   * By default, this calls the api using the `wait` flag. This means the call won't timeout until at least one email is received or 5 minutes pass.\n   * It also uses a default `from_timestamp` of **current timestamp - 15 minutes**. This means that older emails will be ignored.\n   *\n   * Both of these settings can be overriden by passing them in the `params` object.\n   *\n   * @example\n   * Get the latest emails\n   * ```typescript\n   * const { data: emails } = await client.searchInbox(namespace);\n   * ```\n   *\n   * @example\n   * Get the latest emails for a specific email address\n   * ```typescript\n   * const { data: emails } = await client.searchInbox(namespace, {\n   *   to_addr_prefix: 'john@mynamespace.mailisk.net'\n   * });\n   * ```\n   *\n   * @example\n   * Get the last 20 emails in the namespace\n   * ```typescript\n   * const { data: emails } = await mailisk.searchInbox(namespace, {\n   *   wait: false,\n   *   from_timestamp: 0,\n   *   limit: 20\n   * });\n   * ```\n   */\n  async searchInbox(\n    namespace: string,\n    params?: SearchInboxParams,\n    config?: AxiosRequestConfig,\n  ): Promise<SearchInboxResponse> {\n    let _params = { ...params };\n\n    // default from timestamp, 15 minutes before starting this request\n    if (params?.from_timestamp === undefined || params?.from_timestamp === null) {\n      _params.from_timestamp = Math.floor(new Date().getTime() / 1000) - 15 * 60;\n    }\n\n    // by default wait for email\n    if (params?.wait !== false) {\n      _params.wait = true;\n    }\n\n    let _config = { ...config };\n\n    if (config?.maxRedirects === undefined) {\n      _config.maxRedirects = 99999;\n    }\n\n    // by default, wait 5 minutes for emails before timing out\n    if (_params.wait && config?.timeout === undefined) {\n      _config.timeout = 1000 * 60 * 5;\n    }\n\n    return (\n      await this.axiosInstance.get(`api/emails/${namespace}/inbox`, {\n        ..._config,\n        params: _params,\n      })\n    ).data;\n  }\n\n  /**\n   * Get the SMTP settings for a namespace.\n   *\n   * @deprecated Virtual SMTP is deprecated. Use sendEmail(namespace, params) for outbound email instead.\n   */\n  async getSmtpSettings(namespace: string): Promise<SmtpSettings> {\n    const result = await this.axiosInstance.get(`api/smtp/${namespace}`);\n    return result.data;\n  }\n\n  async getAttachment(attachmentId: string): Promise<GetAttachmentResponse> {\n    const result = await this.axiosInstance.get(`api/attachments/${attachmentId}`);\n    return result.data;\n  }\n\n  /**\n   * Download an attachment from an attachment ID.\n   *\n   * @example\n   * Download an attachment from an email\n   * ```typescript\n   * const attachment = email.attachments[0];\n   * const attachmentBuffer = await client.downloadAttachment(attachment.id);\n   *\n   * // save to file\n   * fs.writeFileSync(attachment.filename, attachmentBuffer);\n   * ```\n   */\n  async downloadAttachment(attachmentId: string): Promise<Buffer> {\n    const result = await this.getAttachment(attachmentId);\n\n    const response = await axios.get(result.data.download_url, { responseType: \"arraybuffer\" });\n    return Buffer.from(response.data);\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mailisk",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "Mailisk library for NodeJS",
   "keywords": [
     "mailisk",

package/src/mailisk.interfaces.ts

@@ -242,6 +242,227 @@ export interface SendVirtualSmsParams {
   body: string;
 }
 
+export type OutboundEmailType = "new" | "reply" | "forward";
+
+export type OutboundEmailStatus = "queued" | "sending" | "sent" | "failed";
+
+export type OutboundEmailRecipientType = "to" | "cc" | "bcc";
+
+export type OutboundEmailRecipientDeliveryStatus =
+  | "pending"
+  | "accepted"
+  | "queued"
+  | "sent"
+  | "delayed"
+  | "deferred"
+  | "delivered"
+  | "bounced"
+  | "expired"
+  | "complained"
+  | "unsubscribed"
+  | "suppressed"
+  | "rejected"
+  | "failed"
+  | "cancelled";
+
+export type OutboundEmailEventType =
+  | "accepted"
+  | "queued"
+  | "sent"
+  | "failed"
+  | "rejected"
+  | "delayed"
+  | "deferred"
+  | "delivered"
+  | "bounced"
+  | "expired"
+  | "complained"
+  | "unsubscribed"
+  | "suppressed"
+  | "cancelled"
+  | "opened"
+  | "clicked";
+
+export type OutboundEmailAttachmentDisposition = "attachment" | "inline";
+
+export interface OutboundEmailAddress {
+  /** Email address */
+  email: string;
+  /** Display name, if one is specified */
+  name?: string;
+}
+
+export 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;
+}
+
+export 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[];
+}
+
+export 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[];
+}
+
+export 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;
+}
+
+export 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;
+}
+
+export 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;
+}
+
+export 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;
+}
+
+export 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;
+}
+
+export 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;
+}
+
+export interface OutboundEmailDetailResponse extends OutboundEmailResponse {
+  delivery_summary: OutboundEmailDeliverySummary;
+  recipients: OutboundEmailRecipient[];
+  events: OutboundEmailEvent[];
+}
+
 export type TotpAlgorithm = "SHA1" | "SHA256" | "SHA512";
 
 export type KnownTotpDeviceSource = "shared_secret" | "custom" | "base32_secret_key" | "otpauth_url";

package/src/mailisk.ts

@@ -10,10 +10,15 @@ import {
   ListSmsNumbersResponse,
   ListTotpDevicesParams,
   ListTotpDevicesResponse,
+  ForwardEmailParams,
+  OutboundEmailDetailResponse,
+  OutboundEmailResponse,
+  ReplyToEmailParams,
   SearchInboxParams,
   SearchInboxResponse,
   SearchSmsMessagesParams,
   SearchSmsMessagesResponse,
+  SendEmailParams,
   SendVirtualEmailParams,
   SendVirtualSmsParams,
   SmtpSettings,
@@ -103,6 +108,48 @@ export class MailiskClient {
     return (await this.axiosInstance.post("api/sms/virtual", params)).data;
   }
 
+  /**
+   * 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",
+   * });
+   * ```
+   */
+  async sendEmail(namespace: string, params: SendEmailParams): Promise<OutboundEmailResponse> {
+    return (
+      await this.axiosInstance.post("api/emails/send", params, {
+        params: { namespace },
+      })
+    ).data;
+  }
+
+  /**
+   * Get current delivery state for an outbound email.
+   */
+  async getOutboundEmail(outboundEmailId: string): Promise<OutboundEmailDetailResponse> {
+    return (await this.axiosInstance.get(`api/emails/outbound/${outboundEmailId}`)).data;
+  }
+
+  /**
+   * Create and queue a reply to an inbound email.
+   */
+  async replyToEmail(emailId: string, params: ReplyToEmailParams): Promise<OutboundEmailResponse> {
+    return (await this.axiosInstance.post(`api/emails/${emailId}/reply`, params)).data;
+  }
+
+  /**
+   * Create and queue a forwarded copy of an inbound email.
+   */
+  async forwardEmail(emailId: string, params: ForwardEmailParams): Promise<OutboundEmailResponse> {
+    return (await this.axiosInstance.post(`api/emails/${emailId}/forward`, params)).data;
+  }
+
   /**
    * List saved TOTP devices.
    *
@@ -255,6 +302,8 @@ export 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
@@ -364,6 +413,8 @@ export class MailiskClient {
 
   /**
    * Get the SMTP settings for a namespace.
+   *
+   * @deprecated Virtual SMTP is deprecated. Use sendEmail(namespace, params) for outbound email instead.
    */
   async getSmtpSettings(namespace: string): Promise<SmtpSettings> {
     const result = await this.axiosInstance.get(`api/smtp/${namespace}`);

package/tests/mocks/axios-mocks.ts

@@ -107,6 +107,54 @@ export const mockSmsNumbersResponse = {
   ],
 };
 
+export const mockOutboundEmailResponse = {
+  id: "2d1d9e75-4bc8-49a4-b618-f9b6af78cc4f",
+  organisation_id: "7f0a9c32-66b2-4e25-a4cf-1f77db8f7f3b",
+  type: "new",
+  status: "queued",
+  from: {
+    email: "outbound-delivery@test-namespace.mailisk.net",
+  },
+  subject: "Hello",
+  recipient_count: 1,
+  attachment_count: 0,
+  message_id: "<2d1d9e75-4bc8-49a4-b618-f9b6af78cc4f@test-namespace.mailisk.net>",
+  queued_at: "2026-06-01T12:00:00.000Z",
+  created_at: "2026-06-01T12:00:00.000Z",
+  updated_at: "2026-06-01T12:00:00.000Z",
+};
+
+export const mockOutboundEmailDetailResponse = {
+  ...mockOutboundEmailResponse,
+  delivery_summary: {
+    pending: 1,
+    accepted: 0,
+    queued: 0,
+    sent: 0,
+    delayed: 0,
+    deferred: 0,
+    delivered: 0,
+    bounced: 0,
+    expired: 0,
+    complained: 0,
+    unsubscribed: 0,
+    suppressed: 0,
+    rejected: 0,
+    failed: 0,
+    cancelled: 0,
+  },
+  recipients: [
+    {
+      id: "2a30af1d-3348-4232-9958-20bf446ad793",
+      type: "to",
+      email: "verified@example.com",
+      delivery_status: "pending",
+      attempt_count: 0,
+    },
+  ],
+  events: [],
+};
+
 export const mockTotpDevice = {
   id: "9b1f6ec0-b90d-4bd8-8dd0-f6b2d5138273",
   organisation_id: "7f0a9c32-66b2-4e25-a4cf-1f77db8f7f3b",