[_]: feat/mail get encryption keys

package.json

@@ -1,7 +1,7 @@
 {
   "name": "@internxt/sdk",
   "author": "Internxt <hello@internxt.com>",
-  "version": "1.15.11",
+  "version": "1.15.12",
   "description": "An sdk for interacting with Internxt's services",
   "repository": {
     "type": "git",
@@ -51,4 +51,4 @@
       "prettier --write"
     ]
   }
-}
+}

src/mail/api.ts

@@ -22,6 +22,7 @@ import {
   EmailDomainsResponse,
   SetupMailAccountPayload,
   SearchFiltersQuery,
+  MailAccountKeysResponse,
 } from './types';
 
 export class MailApi {
@@ -200,6 +201,16 @@ export class MailApi {
     return this.client.post('/users/me/mail-account', payload, this.headers());
   }
 
+  /**
+   * Gets the mail account keys for the given address
+   *
+   * @param address - The mail address whose keys should be retrieved
+   * @returns The public, encrypted private and recovery keys plus the salt
+   */
+  async getMailAccountKeys(address: string): Promise<MailAccountKeysResponse> {
+    return this.client.getWithParams('/users/me/mail-account/keys', { address }, this.headers());
+  }
+
   /**
    * Returns the needed headers for the module requests
    * @private

src/mail/mail.ts

@@ -23,6 +23,7 @@ import {
   SearchFiltersQuery,
   EmailDomainsResponse,
   SetupMailAccountPayload,
+  MailAccountKeysResponse,
 } from './types';
 import { createKeystores, encryptEmail, passwordProtectAndSendEmail, openKeystore, recoverKeys } from './crypto';
 
@@ -258,4 +259,14 @@ export class Mail {
   async setupMailAccount(payload: SetupMailAccountPayload): Promise<{ address: string }> {
     return this.api.setupMailAccount(payload);
   }
+
+  /**
+   * Gets the mail account keys for the given address
+   *
+   * @param address - The mail address whose keys should be retrieved
+   * @returns The public, encrypted private and recovery keys plus the salt
+   */
+  async getMailAccountKeys(address: string): Promise<MailAccountKeysResponse> {
+    return this.api.getMailAccountKeys(address);
+  }
 }

src/mail/types.ts

@@ -21,6 +21,12 @@ export type SetupMailAccountPayload = {
     publicKey: string;
     encryptionPrivateKey: string;
     recoveryPrivateKey: string;
-    salt: string;
   };
 };
+
+export type MailAccountKeysResponse = {
+  address: string;
+  publicKey: string;
+  encryptionPrivateKey: string;
+  recoveryPrivateKey: string;
+};

test/mail/index.test.ts

@@ -302,7 +302,6 @@ describe('Mail service tests', () => {
           publicKey: 'public-key',
           encryptionPrivateKey: 'encryption-private-key',
           recoveryPrivateKey: 'recovery-private-key',
-          salt: 'salt',
         },
       };
 
@@ -311,6 +310,22 @@ describe('Mail service tests', () => {
       expect(postStub).toHaveBeenCalledWith('/users/me/mail-account', payload, headers);
       expect(result).toEqual({ address: 'user@domain.com' });
     });
+
+    it('When the mail account keys are requested, then it should GET /users/me/mail-account/keys with the address', async () => {
+      const { client, headers } = clientAndHeadersWithToken();
+      const expectedKeys = {
+        address: 'user@domain.com',
+        publicKey: 'public-key',
+        encryptionPrivateKey: 'encryption-private-key',
+        recoveryPrivateKey: 'recovery-private-key',
+      };
+      const getStub = vi.spyOn(HttpClient.prototype, 'getWithParams').mockResolvedValue(expectedKeys);
+
+      const result = await client.getMailAccountKeys('user@domain.com');
+
+      expect(getStub).toHaveBeenCalledWith('/users/me/mail-account/keys', { address: 'user@domain.com' }, headers);
+      expect(result).toEqual(expectedKeys);
+    });
   });
 });