[PB-6134]: feat/stalwart admin api principals

.env.template

@@ -11,7 +11,8 @@ RDS_PASSWORD=example
 # Stalwart
 STALWART_JMAP_URL=http://localhost:8085
 STALWART_ADMIN_URL=http://localhost:8085
-STALWART_ADMIN_TOKEN=
+STALWART_ADMIN_USER=
+STALWART_ADMIN_SECRET=
 
 # Auth
 JWT_SECRET=

eslint.config.mjs

@@ -39,4 +39,10 @@ export default [
       ],
     },
   },
+  {
+    files: ['**/*.spec.ts', '**/*.test.ts'],
+    rules: {
+      '@typescript-eslint/unbound-method': 'off',
+    },
+  },
 ];

migrations/20260325105400-add-deleted-at-to-mail-accounts.js

@@ -0,0 +1,16 @@
+'use strict';
+
+/** @type {import('sequelize-cli').Migration} */
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.addColumn('mail_accounts', 'deleted_at', {
+      type: Sequelize.DATE,
+      allowNull: true,
+      defaultValue: null,
+    });
+  },
+
+  async down(queryInterface) {
+    await queryInterface.removeColumn('mail_accounts', 'deleted_at');
+  },
+};

migrations/20260325105401-add-deleted-at-to-mail-addresses.js

@@ -0,0 +1,16 @@
+'use strict';
+
+/** @type {import('sequelize-cli').Migration} */
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.addColumn('mail_addresses', 'deleted_at', {
+      type: Sequelize.DATE,
+      allowNull: true,
+      defaultValue: null,
+    });
+  },
+
+  async down(queryInterface) {
+    await queryInterface.removeColumn('mail_addresses', 'deleted_at');
+  },
+};

migrations/20260326100000-rename-drive-user-uuid-to-user-id.js

@@ -0,0 +1,20 @@
+'use strict';
+
+/** @type {import('sequelize-cli').Migration} */
+module.exports = {
+  async up(queryInterface) {
+    await queryInterface.renameColumn(
+      'mail_accounts',
+      'drive_user_uuid',
+      'user_id',
+    );
+  },
+
+  async down(queryInterface) {
+    await queryInterface.renameColumn(
+      'mail_accounts',
+      'user_id',
+      'drive_user_uuid',
+    );
+  },
+};

migrations/20260326130000-add-deleted-at-to-mail-provider-accounts.js

@@ -0,0 +1,16 @@
+'use strict';
+
+/** @type {import('sequelize-cli').Migration} */
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.addColumn('mail_provider_accounts', 'deleted_at', {
+      type: Sequelize.DATE,
+      allowNull: true,
+      defaultValue: null,
+    });
+  },
+
+  async down(queryInterface) {
+    await queryInterface.removeColumn('mail_provider_accounts', 'deleted_at');
+  },
+};

seeders/20260318200321-test-user.js

@@ -14,7 +14,7 @@ const domain = {
 const account = {
   id: 'a1b2c3d4-0000-0000-0000-000000000002',
   // Matches the uuid of the test user in drive-server-wip seeders
-  drive_user_uuid: '87204d6b-c4a7-4f38-bd99-f7f47964a643',
+  user_id: '87204d6b-c4a7-4f38-bd99-f7f47964a643',
   created_at: new Date(),
   updated_at: new Date(),
 };
@@ -49,8 +49,8 @@ module.exports = {
     }
 
     const [existingAccount] = await queryInterface.sequelize.query(
-      'SELECT id FROM mail_accounts WHERE drive_user_uuid = :uuid',
-      { replacements: { uuid: account.drive_user_uuid }, type: queryInterface.sequelize.QueryTypes.SELECT },
+      'SELECT id FROM mail_accounts WHERE user_id = :uuid',
+      { replacements: { uuid: account.user_id }, type: queryInterface.sequelize.QueryTypes.SELECT },
     );
     if (!existingAccount) {
       await queryInterface.bulkInsert('mail_accounts', [account]);

src/config/configuration.ts

@@ -15,7 +15,8 @@ export default () => ({
   stalwart: {
     url: process.env.STALWART_JMAP_URL ?? 'http://localhost:8085',
     adminUrl: process.env.STALWART_ADMIN_URL ?? 'http://localhost:8085',
-    adminToken: process.env.STALWART_ADMIN_TOKEN ?? '',
+    adminUser: process.env.STALWART_ADMIN_USER ?? 'mail-api',
+    adminSecret: process.env.STALWART_ADMIN_SECRET ?? '',
     masterUser: process.env.STALWART_MASTER_USER ?? 'master',
     masterPassword: process.env.STALWART_MASTER_PASSWORD ?? '',
   },

src/modules/account/account-provider.port.ts

@@ -0,0 +1,7 @@
+import type { AccountInfo, CreateAccountParams } from './account.types.js';
+
+export abstract class AccountProvider {
+  abstract createAccount(params: CreateAccountParams): Promise<void>;
+  abstract deleteAccount(name: string): Promise<void>;
+  abstract getAccount(name: string): Promise<AccountInfo | null>;
+}

src/modules/account/account.module.ts

@@ -1,11 +1,16 @@
 import { Module } from '@nestjs/common';
 import { SequelizeModule } from '@nestjs/sequelize';
+import { StalwartModule } from '../infrastructure/stalwart/stalwart.module.js';
+import { AccountService } from './account.service.js';
 import {
   MailAccountModel,
   MailAddressModel,
   MailDomainModel,
   MailProviderAccountModel,
 } from './models/index.js';
+import { AccountRepository } from './repositories/account.repository.js';
+import { AddressRepository } from './repositories/address.repository.js';
+import { DomainRepository } from './repositories/domain.repository.js';
 
 @Module({
   imports: [
@@ -15,7 +20,14 @@ import {
       MailDomainModel,
       MailProviderAccountModel,
     ]),
+    StalwartModule,
   ],
-  exports: [SequelizeModule],
+  providers: [
+    AccountRepository,
+    AddressRepository,
+    DomainRepository,
+    AccountService,
+  ],
+  exports: [AccountService],
 })
 export class AccountModule {}