mailisk 2.2.3 → 2.3.0

package/README.md

@@ -5,6 +5,7 @@ Mailisk is an end-to-end email and SMS testing platform. It allows you to receiv
 - Get a unique subdomain and unlimited email addresses for free.
 - 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.
 
 ## Get started
@@ -214,3 +215,99 @@ await mailisk.sendVirtualSms({
   body: "Test message",
 });
 ```
+
+## Client functions (TOTP)
+
+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.
+
+```js
+const devices = await mailisk.listTotpDevices({
+  limit: 20,
+  offset: 0,
+  issuer: "GitHub",
+  username: "qa@example.com",
+});
+```
+
+### `createTotpDevice(params)`
+
+Create a saved TOTP device from a Base32 shared secret using default settings: 6 digits, 30 second period, and SHA1.
+
+```js
+const device = await mailisk.createTotpDevice({
+  name: "GitHub staging",
+  sharedSecret: "JBSWY3DPEHPK3PXP",
+  expiresAt: "2026-06-01T12:00:00.000Z",
+});
+```
+
+### `createCustomTotpDevice(params)`
+
+Create a saved TOTP device with custom settings.
+
+```js
+const device = await mailisk.createCustomTotpDevice({
+  name: "GitHub staging",
+  secret: "JBSWY3DPEHPK3PXP",
+  username: "qa@example.com",
+  issuer: "GitHub",
+  digits: 6,
+  period: 30,
+  algorithm: "SHA1",
+});
+```
+
+### `createTotpDeviceFromBase32SecretKey(params)`
+
+Create a saved TOTP device from a Base32 secret key.
+
+```js
+const device = await mailisk.createTotpDeviceFromBase32SecretKey({
+  base32SecretKey: "JBSWY3DPEHPK3PXP",
+  username: "qa@example.com",
+  issuer: "GitHub",
+});
+```
+
+### `createTotpDeviceFromOtpAuthUrl(params)`
+
+Create a saved TOTP device from an `otpauth://totp/...` URL.
+
+```js
+const device = await mailisk.createTotpDeviceFromOtpAuthUrl({
+  otpAuthUrl: "otpauth://totp/GitHub:qa@example.com?secret=JBSWY3DPEHPK3PXP&issuer=GitHub",
+});
+```
+
+### `getTotpOtpBySharedSecret(sharedSecret)`
+
+Generate a TOTP code from a shared secret without saving a device.
+
+```js
+const otp = await mailisk.getTotpOtpBySharedSecret("JBSWY3DPEHPK3PXP");
+
+console.log(otp.code);
+console.log(otp.expires);
+```
+
+### `getTotpOtpByDeviceId(deviceId)`
+
+Generate a TOTP code for a saved device.
+
+```js
+const otp = await mailisk.getTotpOtpByDeviceId(device.id);
+```
+
+### `deleteTotpDevice(deviceId)`
+
+Delete a saved TOTP device.
+
+```js
+await mailisk.deleteTotpDevice(device.id);
+```

package/dist/index.d.mts

@@ -231,6 +231,104 @@ interface SendVirtualSmsParams {
     /** The body of the SMS message */
     body: string;
 }
+type TotpAlgorithm = "SHA1" | "SHA256" | "SHA512";
+type KnownTotpDeviceSource = "shared_secret" | "custom" | "base32_secret_key" | "otpauth_url";
+type TotpDeviceSource = KnownTotpDeviceSource | (string & {});
+interface TotpDevice {
+    id: string;
+    organisation_id: string;
+    name: string;
+    username?: string | null;
+    issuer?: string | null;
+    digits: number;
+    period: number;
+    algorithm: TotpAlgorithm;
+    source: TotpDeviceSource;
+    expiresAt?: string | null;
+    created_at: string;
+    updated_at: string;
+}
+interface ListTotpDevicesParams {
+    /** The maximum number of saved TOTP devices returned (1-100), used alongside `offset` for pagination. */
+    limit?: number;
+    /** The number of saved TOTP devices to skip/ignore, used alongside `limit` for pagination. Must be >= 0. */
+    offset?: number;
+    /** Case-insensitive partial username match. Trimmed before sending. */
+    username?: string;
+    /** Case-insensitive partial issuer match. Trimmed before sending. */
+    issuer?: string;
+}
+interface ListTotpDevicesResponse {
+    total_count: number;
+    options: ListTotpDevicesParams;
+    items: TotpDevice[];
+}
+interface CreateTotpDeviceParams {
+    /** Base32 shared secret. Uses default TOTP settings. */
+    sharedSecret: string;
+    /** Optional saved-device display name. Max 120 characters. */
+    name?: string;
+    /** Future ISO timestamp after which the saved device expires. */
+    expiresAt?: string;
+}
+interface CreateCustomTotpDeviceParams {
+    /** Base32 shared secret. */
+    secret: string;
+    /** Optional saved-device display name. Max 120 characters. */
+    name?: string;
+    /** Account label. Max 240 characters. */
+    username?: string;
+    /** Issuer/app label. Max 240 characters. */
+    issuer?: string;
+    /** Number of OTP digits. */
+    digits?: 6 | 8;
+    /** OTP period in seconds. Must be an integer from 10 to 300. */
+    period?: number;
+    /** Hashing algorithm. */
+    algorithm?: TotpAlgorithm;
+    /** Future ISO timestamp after which the saved device expires. */
+    expiresAt?: string;
+}
+interface CreateBase32SecretKeyTotpDeviceParams {
+    /** Base32 shared secret key. */
+    base32SecretKey: string;
+    /** Optional saved-device display name. Max 120 characters. */
+    name?: string;
+    /** Account label. Max 240 characters. */
+    username?: string;
+    /** Issuer/app label. Max 240 characters. */
+    issuer?: string;
+    /** Number of OTP digits. */
+    digits?: 6 | 8;
+    /** OTP period in seconds. Must be an integer from 10 to 300. */
+    period?: number;
+    /** Hashing algorithm. */
+    algorithm?: TotpAlgorithm;
+    /** Future ISO timestamp after which the saved device expires. */
+    expiresAt?: string;
+}
+interface CreateOtpAuthUrlTotpDeviceParams {
+    /** otpauth://totp URL with a secret query parameter. */
+    otpAuthUrl: string;
+    /** Optional saved-device display name. Max 120 characters. */
+    name?: string;
+    /** Account label, used when missing from the URL label. Max 240 characters. */
+    username?: string;
+    /** Issuer/app label, used when missing from the URL. Max 240 characters. */
+    issuer?: string;
+    /** Number of OTP digits, used when missing from the URL. */
+    digits?: 6 | 8;
+    /** OTP period in seconds, used when missing from the URL. Must be an integer from 10 to 300. */
+    period?: number;
+    /** Hashing algorithm, used when missing from the URL. */
+    algorithm?: TotpAlgorithm;
+    /** Future ISO timestamp after which the saved device expires. */
+    expiresAt?: string;
+}
+interface TotpOtpResponse {
+    code: string;
+    expires: string;
+}
 
 declare class MailiskClient {
     constructor({ apiKey, baseUrl, auth }: {
@@ -260,6 +358,106 @@ declare class MailiskClient {
      */
     listSmsNumbers(): Promise<ListSmsNumbersResponse>;
     sendVirtualSms(params: SendVirtualSmsParams): Promise<void>;
+    /**
+     * List saved TOTP devices.
+     *
+     * @example
+     * List saved TOTP devices for an issuer and username
+     * ```typescript
+     * const { items: devices } = await client.listTotpDevices({
+     *   issuer: "GitHub",
+     *   username: "qa@example.com",
+     * });
+     * ```
+     */
+    listTotpDevices(params?: ListTotpDevicesParams): Promise<ListTotpDevicesResponse>;
+    /**
+     * Create a saved TOTP device from a Base32 shared secret using default TOTP settings.
+     *
+     * @example
+     * Create a saved TOTP device from a shared secret
+     * ```typescript
+     * const device = await client.createTotpDevice({
+     *   name: "GitHub staging",
+     *   sharedSecret: "JBSWY3DPEHPK3PXP",
+     * });
+     * ```
+     */
+    createTotpDevice(params: CreateTotpDeviceParams): Promise<TotpDevice>;
+    /**
+     * Create a saved TOTP device with custom settings.
+     *
+     * @example
+     * Create a saved TOTP device with custom settings
+     * ```typescript
+     * const device = await client.createCustomTotpDevice({
+     *   name: "GitHub staging",
+     *   secret: "JBSWY3DPEHPK3PXP",
+     *   username: "qa@example.com",
+     *   issuer: "GitHub",
+     *   digits: 6,
+     *   period: 30,
+     *   algorithm: "SHA1",
+     * });
+     * ```
+     */
+    createCustomTotpDevice(params: CreateCustomTotpDeviceParams): Promise<TotpDevice>;
+    /**
+     * Create a saved TOTP device from a Base32 secret key.
+     *
+     * @example
+     * Create a saved TOTP device from a Base32 secret key
+     * ```typescript
+     * const device = await client.createTotpDeviceFromBase32SecretKey({
+     *   base32SecretKey: "JBSWY3DPEHPK3PXP",
+     *   username: "qa@example.com",
+     *   issuer: "GitHub",
+     * });
+     * ```
+     */
+    createTotpDeviceFromBase32SecretKey(params: CreateBase32SecretKeyTotpDeviceParams): Promise<TotpDevice>;
+    /**
+     * Create a saved TOTP device from an otpauth://totp URL.
+     *
+     * @example
+     * Create a saved TOTP device from an otpauth URL
+     * ```typescript
+     * const device = await client.createTotpDeviceFromOtpAuthUrl({
+     *   otpAuthUrl: "otpauth://totp/GitHub:qa@example.com?secret=JBSWY3DPEHPK3PXP&issuer=GitHub",
+     * });
+     * ```
+     */
+    createTotpDeviceFromOtpAuthUrl(params: CreateOtpAuthUrlTotpDeviceParams): Promise<TotpDevice>;
+    /**
+     * Generate a TOTP code from a shared secret without saving a device.
+     *
+     * @example
+     * Generate a TOTP code from a shared secret
+     * ```typescript
+     * const { code } = await client.getTotpOtpBySharedSecret("JBSWY3DPEHPK3PXP");
+     * ```
+     */
+    getTotpOtpBySharedSecret(sharedSecret: string): Promise<TotpOtpResponse>;
+    /**
+     * Generate a TOTP code for a saved device.
+     *
+     * @example
+     * Generate a TOTP code for a saved device
+     * ```typescript
+     * const { code } = await client.getTotpOtpByDeviceId(device.id);
+     * ```
+     */
+    getTotpOtpByDeviceId(deviceId: string): Promise<TotpOtpResponse>;
+    /**
+     * Delete a saved TOTP device.
+     *
+     * @example
+     * Delete a saved TOTP device
+     * ```typescript
+     * await client.deleteTotpDevice(device.id);
+     * ```
+     */
+    deleteTotpDevice(deviceId: string): Promise<void>;
     /**
      * List all namespaces that belong to the current account (API key).
      */
@@ -335,4 +533,4 @@ declare class MailiskClient {
     downloadAttachment(attachmentId: string): Promise<Buffer>;
 }
 
-export { MailiskClient };
+export { type CreateBase32SecretKeyTotpDeviceParams, type CreateCustomTotpDeviceParams, type CreateOtpAuthUrlTotpDeviceParams, type CreateTotpDeviceParams, type Email, type EmailAddress, type EmailAttachment, type GetAttachmentResponse, 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 };

package/dist/index.d.ts

@@ -231,6 +231,104 @@ interface SendVirtualSmsParams {
     /** The body of the SMS message */
     body: string;
 }
+type TotpAlgorithm = "SHA1" | "SHA256" | "SHA512";
+type KnownTotpDeviceSource = "shared_secret" | "custom" | "base32_secret_key" | "otpauth_url";
+type TotpDeviceSource = KnownTotpDeviceSource | (string & {});
+interface TotpDevice {
+    id: string;
+    organisation_id: string;
+    name: string;
+    username?: string | null;
+    issuer?: string | null;
+    digits: number;
+    period: number;
+    algorithm: TotpAlgorithm;
+    source: TotpDeviceSource;
+    expiresAt?: string | null;
+    created_at: string;
+    updated_at: string;
+}
+interface ListTotpDevicesParams {
+    /** The maximum number of saved TOTP devices returned (1-100), used alongside `offset` for pagination. */
+    limit?: number;
+    /** The number of saved TOTP devices to skip/ignore, used alongside `limit` for pagination. Must be >= 0. */
+    offset?: number;
+    /** Case-insensitive partial username match. Trimmed before sending. */
+    username?: string;
+    /** Case-insensitive partial issuer match. Trimmed before sending. */
+    issuer?: string;
+}
+interface ListTotpDevicesResponse {
+    total_count: number;
+    options: ListTotpDevicesParams;
+    items: TotpDevice[];
+}
+interface CreateTotpDeviceParams {
+    /** Base32 shared secret. Uses default TOTP settings. */
+    sharedSecret: string;
+    /** Optional saved-device display name. Max 120 characters. */
+    name?: string;
+    /** Future ISO timestamp after which the saved device expires. */
+    expiresAt?: string;
+}
+interface CreateCustomTotpDeviceParams {
+    /** Base32 shared secret. */
+    secret: string;
+    /** Optional saved-device display name. Max 120 characters. */
+    name?: string;
+    /** Account label. Max 240 characters. */
+    username?: string;
+    /** Issuer/app label. Max 240 characters. */
+    issuer?: string;
+    /** Number of OTP digits. */
+    digits?: 6 | 8;
+    /** OTP period in seconds. Must be an integer from 10 to 300. */
+    period?: number;
+    /** Hashing algorithm. */
+    algorithm?: TotpAlgorithm;
+    /** Future ISO timestamp after which the saved device expires. */
+    expiresAt?: string;
+}
+interface CreateBase32SecretKeyTotpDeviceParams {
+    /** Base32 shared secret key. */
+    base32SecretKey: string;
+    /** Optional saved-device display name. Max 120 characters. */
+    name?: string;
+    /** Account label. Max 240 characters. */
+    username?: string;
+    /** Issuer/app label. Max 240 characters. */
+    issuer?: string;
+    /** Number of OTP digits. */
+    digits?: 6 | 8;
+    /** OTP period in seconds. Must be an integer from 10 to 300. */
+    period?: number;
+    /** Hashing algorithm. */
+    algorithm?: TotpAlgorithm;
+    /** Future ISO timestamp after which the saved device expires. */
+    expiresAt?: string;
+}
+interface CreateOtpAuthUrlTotpDeviceParams {
+    /** otpauth://totp URL with a secret query parameter. */
+    otpAuthUrl: string;
+    /** Optional saved-device display name. Max 120 characters. */
+    name?: string;
+    /** Account label, used when missing from the URL label. Max 240 characters. */
+    username?: string;
+    /** Issuer/app label, used when missing from the URL. Max 240 characters. */
+    issuer?: string;
+    /** Number of OTP digits, used when missing from the URL. */
+    digits?: 6 | 8;
+    /** OTP period in seconds, used when missing from the URL. Must be an integer from 10 to 300. */
+    period?: number;
+    /** Hashing algorithm, used when missing from the URL. */
+    algorithm?: TotpAlgorithm;
+    /** Future ISO timestamp after which the saved device expires. */
+    expiresAt?: string;
+}
+interface TotpOtpResponse {
+    code: string;
+    expires: string;
+}
 
 declare class MailiskClient {
     constructor({ apiKey, baseUrl, auth }: {
@@ -260,6 +358,106 @@ declare class MailiskClient {
      */
     listSmsNumbers(): Promise<ListSmsNumbersResponse>;
     sendVirtualSms(params: SendVirtualSmsParams): Promise<void>;
+    /**
+     * List saved TOTP devices.
+     *
+     * @example
+     * List saved TOTP devices for an issuer and username
+     * ```typescript
+     * const { items: devices } = await client.listTotpDevices({
+     *   issuer: "GitHub",
+     *   username: "qa@example.com",
+     * });
+     * ```
+     */
+    listTotpDevices(params?: ListTotpDevicesParams): Promise<ListTotpDevicesResponse>;
+    /**
+     * Create a saved TOTP device from a Base32 shared secret using default TOTP settings.
+     *
+     * @example
+     * Create a saved TOTP device from a shared secret
+     * ```typescript
+     * const device = await client.createTotpDevice({
+     *   name: "GitHub staging",
+     *   sharedSecret: "JBSWY3DPEHPK3PXP",
+     * });
+     * ```
+     */
+    createTotpDevice(params: CreateTotpDeviceParams): Promise<TotpDevice>;
+    /**
+     * Create a saved TOTP device with custom settings.
+     *
+     * @example
+     * Create a saved TOTP device with custom settings
+     * ```typescript
+     * const device = await client.createCustomTotpDevice({
+     *   name: "GitHub staging",
+     *   secret: "JBSWY3DPEHPK3PXP",
+     *   username: "qa@example.com",
+     *   issuer: "GitHub",
+     *   digits: 6,
+     *   period: 30,
+     *   algorithm: "SHA1",
+     * });
+     * ```
+     */
+    createCustomTotpDevice(params: CreateCustomTotpDeviceParams): Promise<TotpDevice>;
+    /**
+     * Create a saved TOTP device from a Base32 secret key.
+     *
+     * @example
+     * Create a saved TOTP device from a Base32 secret key
+     * ```typescript
+     * const device = await client.createTotpDeviceFromBase32SecretKey({
+     *   base32SecretKey: "JBSWY3DPEHPK3PXP",
+     *   username: "qa@example.com",
+     *   issuer: "GitHub",
+     * });
+     * ```
+     */
+    createTotpDeviceFromBase32SecretKey(params: CreateBase32SecretKeyTotpDeviceParams): Promise<TotpDevice>;
+    /**
+     * Create a saved TOTP device from an otpauth://totp URL.
+     *
+     * @example
+     * Create a saved TOTP device from an otpauth URL
+     * ```typescript
+     * const device = await client.createTotpDeviceFromOtpAuthUrl({
+     *   otpAuthUrl: "otpauth://totp/GitHub:qa@example.com?secret=JBSWY3DPEHPK3PXP&issuer=GitHub",
+     * });
+     * ```
+     */
+    createTotpDeviceFromOtpAuthUrl(params: CreateOtpAuthUrlTotpDeviceParams): Promise<TotpDevice>;
+    /**
+     * Generate a TOTP code from a shared secret without saving a device.
+     *
+     * @example
+     * Generate a TOTP code from a shared secret
+     * ```typescript
+     * const { code } = await client.getTotpOtpBySharedSecret("JBSWY3DPEHPK3PXP");
+     * ```
+     */
+    getTotpOtpBySharedSecret(sharedSecret: string): Promise<TotpOtpResponse>;
+    /**
+     * Generate a TOTP code for a saved device.
+     *
+     * @example
+     * Generate a TOTP code for a saved device
+     * ```typescript
+     * const { code } = await client.getTotpOtpByDeviceId(device.id);
+     * ```
+     */
+    getTotpOtpByDeviceId(deviceId: string): Promise<TotpOtpResponse>;
+    /**
+     * Delete a saved TOTP device.
+     *
+     * @example
+     * Delete a saved TOTP device
+     * ```typescript
+     * await client.deleteTotpDevice(device.id);
+     * ```
+     */
+    deleteTotpDevice(deviceId: string): Promise<void>;
     /**
      * List all namespaces that belong to the current account (API key).
      */
@@ -335,4 +533,4 @@ declare class MailiskClient {
     downloadAttachment(attachmentId: string): Promise<Buffer>;
 }
 
-export { MailiskClient };
+export { type CreateBase32SecretKeyTotpDeviceParams, type CreateCustomTotpDeviceParams, type CreateOtpAuthUrlTotpDeviceParams, type CreateTotpDeviceParams, type Email, type EmailAddress, type EmailAttachment, type GetAttachmentResponse, 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 };

package/dist/index.js

@@ -101,6 +101,129 @@ var MailiskClient = class {
   async sendVirtualSms(params) {
     return (await this.axiosInstance.post("api/sms/virtual", params)).data;
   }
+  /**
+   * List saved TOTP devices.
+   *
+   * @example
+   * List saved TOTP devices for an issuer and username
+   * ```typescript
+   * const { items: devices } = await client.listTotpDevices({
+   *   issuer: "GitHub",
+   *   username: "qa@example.com",
+   * });
+   * ```
+   */
+  async listTotpDevices(params) {
+    const requestParams = {
+      ...params,
+      username: params?.username?.trim(),
+      issuer: params?.issuer?.trim()
+    };
+    return (await this.axiosInstance.get("api/devices", {
+      params: requestParams
+    })).data;
+  }
+  /**
+   * Create a saved TOTP device from a Base32 shared secret using default TOTP settings.
+   *
+   * @example
+   * Create a saved TOTP device from a shared secret
+   * ```typescript
+   * const device = await client.createTotpDevice({
+   *   name: "GitHub staging",
+   *   sharedSecret: "JBSWY3DPEHPK3PXP",
+   * });
+   * ```
+   */
+  async createTotpDevice(params) {
+    return (await this.axiosInstance.post("api/devices", params)).data;
+  }
+  /**
+   * Create a saved TOTP device with custom settings.
+   *
+   * @example
+   * Create a saved TOTP device with custom settings
+   * ```typescript
+   * const device = await client.createCustomTotpDevice({
+   *   name: "GitHub staging",
+   *   secret: "JBSWY3DPEHPK3PXP",
+   *   username: "qa@example.com",
+   *   issuer: "GitHub",
+   *   digits: 6,
+   *   period: 30,
+   *   algorithm: "SHA1",
+   * });
+   * ```
+   */
+  async createCustomTotpDevice(params) {
+    return (await this.axiosInstance.post("api/devices/custom", params)).data;
+  }
+  /**
+   * Create a saved TOTP device from a Base32 secret key.
+   *
+   * @example
+   * Create a saved TOTP device from a Base32 secret key
+   * ```typescript
+   * const device = await client.createTotpDeviceFromBase32SecretKey({
+   *   base32SecretKey: "JBSWY3DPEHPK3PXP",
+   *   username: "qa@example.com",
+   *   issuer: "GitHub",
+   * });
+   * ```
+   */
+  async createTotpDeviceFromBase32SecretKey(params) {
+    return (await this.axiosInstance.post("api/devices/base32-secret-key", params)).data;
+  }
+  /**
+   * Create a saved TOTP device from an otpauth://totp URL.
+   *
+   * @example
+   * Create a saved TOTP device from an otpauth URL
+   * ```typescript
+   * const device = await client.createTotpDeviceFromOtpAuthUrl({
+   *   otpAuthUrl: "otpauth://totp/GitHub:qa@example.com?secret=JBSWY3DPEHPK3PXP&issuer=GitHub",
+   * });
+   * ```
+   */
+  async createTotpDeviceFromOtpAuthUrl(params) {
+    return (await this.axiosInstance.post("api/devices/otpauth-url", params)).data;
+  }
+  /**
+   * Generate a TOTP code from a shared secret without saving a device.
+   *
+   * @example
+   * Generate a TOTP code from a shared secret
+   * ```typescript
+   * const { code } = await client.getTotpOtpBySharedSecret("JBSWY3DPEHPK3PXP");
+   * ```
+   */
+  async getTotpOtpBySharedSecret(sharedSecret) {
+    return (await this.axiosInstance.post("api/devices/otp", { sharedSecret })).data;
+  }
+  /**
+   * Generate a TOTP code for a saved device.
+   *
+   * @example
+   * Generate a TOTP code for a saved device
+   * ```typescript
+   * const { code } = await client.getTotpOtpByDeviceId(device.id);
+   * ```
+   */
+  async getTotpOtpByDeviceId(deviceId) {
+    return (await this.axiosInstance.get(`api/devices/${deviceId}/otp`)).data;
+  }
+  /**
+   * Delete a saved TOTP device.
+   *
+   * @example
+   * Delete a saved TOTP device
+   * ```typescript
+   * await client.deleteTotpDevice(device.id);
+   * ```
+   */
+  async deleteTotpDevice(deviceId) {
+    await this.axiosInstance.delete(`api/devices/${deviceId}`);
+  }
   /**
    * List all namespaces that belong to the current account (API key).
    */