feat: integrate Sequelize for database management and add first migrations

.env.template

@@ -1,6 +1,13 @@
 PORT=3100
 NODE_ENV=development
 
+# Database
+RDS_HOSTNAME=localhost
+RDS_PORT=5432
+RDS_DBNAME=mail
+RDS_USERNAME=postgres
+RDS_PASSWORD=example
+
 # Stalwart
 STALWART_JMAP_URL=http://localhost:8085
 STALWART_ADMIN_URL=http://localhost:8085

.sequelizerc

@@ -0,0 +1,8 @@
+const path = require('path');
+require('dotenv').config({ path: `./.env.${process.env.NODE_ENV}` });
+
+module.exports = {
+  'config': path.resolve('src/config', 'sequelize.js'),
+  'models-path': '',
+  'seeders-path': path.resolve('seeders'),
+}

eslint.config.mjs

@@ -5,6 +5,7 @@ import globals from 'globals';
 import tseslint from 'typescript-eslint';
 
 export default [
+  { ignores: ['migrations/', 'src/config/sequelize.js'] },
   eslint.configs.recommended,
   ...tseslint.configs.recommendedTypeChecked,
   eslintPluginPrettier,

migrations/20260316204744-create-mail-accounts.js

@@ -0,0 +1,38 @@
+'use strict';
+
+const TABLE_NAME = 'mail_accounts';
+
+/** @type {import('sequelize-cli').Migration} */
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.createTable(TABLE_NAME, {
+      id: {
+        type: Sequelize.UUID,
+        defaultValue: Sequelize.UUIDV4,
+        primaryKey: true,
+        allowNull: false,
+      },
+      drive_user_uuid: {
+        type: Sequelize.UUID,
+        allowNull: false,
+        unique: true,
+      },
+      created_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+        defaultValue: Sequelize.fn('now'),
+      },
+      updated_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+        defaultValue: Sequelize.fn('now'),
+      },
+    });
+
+    await queryInterface.addIndex(TABLE_NAME, ['drive_user_uuid']);
+  },
+
+  async down(queryInterface) {
+    await queryInterface.dropTable(TABLE_NAME);
+  },
+};

migrations/20260316204745-create-mail-domains.js

@@ -0,0 +1,39 @@
+'use strict';
+
+/** @type {import('sequelize-cli').Migration} */
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.createTable('mail_domains', {
+      id: {
+        type: Sequelize.UUID,
+        defaultValue: Sequelize.UUIDV4,
+        primaryKey: true,
+        allowNull: false,
+      },
+      domain: {
+        type: Sequelize.STRING(255),
+        allowNull: false,
+        unique: true,
+      },
+      status: {
+        type: Sequelize.STRING(20),
+        allowNull: false,
+        defaultValue: 'active',
+      },
+      created_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+        defaultValue: Sequelize.fn('now'),
+      },
+      updated_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+        defaultValue: Sequelize.fn('now'),
+      },
+    });
+  },
+
+  async down(queryInterface) {
+    await queryInterface.dropTable('mail_domains');
+  },
+};

migrations/20260316204746-create-mail-addresses.js

@@ -0,0 +1,62 @@
+'use strict';
+
+const TABLE_NAME = 'mail_addresses';
+
+/** @type {import('sequelize-cli').Migration} */
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.createTable(TABLE_NAME, {
+      id: {
+        type: Sequelize.UUID,
+        defaultValue: Sequelize.UUIDV4,
+        primaryKey: true,
+        allowNull: false,
+      },
+      mail_account_id: {
+        type: Sequelize.UUID,
+        allowNull: false,
+        references: {
+          model: 'mail_accounts',
+          key: 'id',
+        },
+        onDelete: 'CASCADE',
+      },
+      address: {
+        type: Sequelize.STRING(255),
+        allowNull: false,
+        unique: true,
+      },
+      domain_id: {
+        type: Sequelize.UUID,
+        allowNull: false,
+        references: {
+          model: 'mail_domains',
+          key: 'id',
+        },
+        onDelete: 'RESTRICT',
+      },
+      is_default: {
+        type: Sequelize.BOOLEAN,
+        allowNull: false,
+        defaultValue: false,
+      },
+      created_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+        defaultValue: Sequelize.fn('now'),
+      },
+      updated_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+        defaultValue: Sequelize.fn('now'),
+      },
+    });
+
+    await queryInterface.addIndex(TABLE_NAME, ['mail_account_id']);
+    await queryInterface.addIndex(TABLE_NAME, ['domain_id']);
+  },
+
+  async down(queryInterface) {
+    await queryInterface.dropTable(TABLE_NAME);
+  },
+};

migrations/20260318191700-create-mail-provider-enum.js

@@ -0,0 +1,16 @@
+'use strict';
+
+const ENUM_NAME = 'mail_provider';
+
+/** @type {import('sequelize-cli').Migration} */
+module.exports = {
+  async up(queryInterface) {
+    await queryInterface.sequelize.query(
+      `CREATE TYPE ${ENUM_NAME} AS ENUM ('stalwart')`,
+    );
+  },
+
+  async down(queryInterface) {
+    await queryInterface.sequelize.query(`DROP TYPE ${ENUM_NAME}`);
+  },
+};

migrations/20260318191701-create-mail-provider-accounts.js

@@ -0,0 +1,53 @@
+'use strict';
+
+const TABLE_NAME = 'mail_provider_accounts';
+
+/** @type {import('sequelize-cli').Migration} */
+module.exports = {
+  async up(queryInterface, Sequelize) {
+    await queryInterface.createTable(TABLE_NAME, {
+      id: {
+        type: Sequelize.UUID,
+        defaultValue: Sequelize.UUIDV4,
+        primaryKey: true,
+        allowNull: false,
+      },
+      mail_address_id: {
+        type: Sequelize.UUID,
+        allowNull: false,
+        unique: true,
+        references: {
+          model: 'mail_addresses',
+          key: 'id',
+        },
+        onDelete: 'CASCADE',
+      },
+      provider: {
+        type: 'mail_provider',
+        allowNull: false,
+      },
+      external_id: {
+        type: Sequelize.STRING(255),
+        allowNull: false,
+      },
+      created_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+        defaultValue: Sequelize.fn('now'),
+      },
+      updated_at: {
+        type: Sequelize.DATE,
+        allowNull: false,
+        defaultValue: Sequelize.fn('now'),
+      },
+    });
+
+    await queryInterface.addIndex(TABLE_NAME, ['provider', 'external_id'], {
+      unique: true,
+    });
+  },
+
+  async down(queryInterface) {
+    await queryInterface.dropTable(TABLE_NAME);
+  },
+};