[_]: feat/add migration to clean up duplicate folders

migrations/20260225012358-cleanup-duplicate-folders.js

@@ -0,0 +1,78 @@
+'use strict';
+
+const MAX_ATTEMPTS = 10;
+
+module.exports = {
+  up: async (queryInterface) => {
+    console.info('Starting cleanup of duplicate folders...');
+
+    console.info('Creating supporting index...');
+    await queryInterface.sequelize.query(`
+      CREATE INDEX CONCURRENTLY IF NOT EXISTS folders_parentuuid_plainname_not_deleted_support_index
+      ON folders (parent_uuid, plain_name)
+      WHERE deleted = false AND removed = false;
+    `);
+
+    const [pairs] = await queryInterface.sequelize.query(`
+      SELECT parent_uuid, plain_name
+      FROM folders
+      WHERE deleted = false AND removed = false
+        AND parent_uuid IS NOT NULL
+        AND plain_name IS NOT NULL
+      GROUP BY parent_uuid, plain_name
+      HAVING COUNT(*) > 1;
+    `);
+
+    console.info(
+      `Found ${pairs.length} duplicate (parent_uuid, plain_name) pairs.`,
+    );
+
+    let renamed = 0;
+
+    for (const { parent_uuid, plain_name } of pairs) {
+      const [rows] = await queryInterface.sequelize.query(
+        `SELECT id FROM folders
+         WHERE parent_uuid = $1 AND plain_name = $2
+           AND deleted = false AND removed = false
+         ORDER BY id`,
+        { bind: [parent_uuid, plain_name] },
+      );
+
+      // Skip first row (the oldest folder)
+      for (let i = 1; i < rows.length; i++) {
+        const { id } = rows[i];
+        let attempts = 0;
+
+        while (attempts < MAX_ATTEMPTS) {
+          try {
+            await queryInterface.sequelize.query(
+              `UPDATE folders SET plain_name = $1 WHERE id = $2`,
+              { bind: [`${plain_name}_${id}`, id] },
+            );
+            renamed++;
+            break;
+          } catch (err) {
+            attempts++;
+            console.error(
+              `[ERROR]: Failed to rename folder id=${id} (attempt ${attempts}/${MAX_ATTEMPTS}): ${err.message}`,
+            );
+            if (attempts >= MAX_ATTEMPTS) throw err;
+          }
+        }
+      }
+    }
+
+    console.info(`=== Cleanup Complete: renamed ${renamed} folders ===`);
+
+    console.info('Dropping supporting index...');
+    await queryInterface.sequelize.query(`
+      DROP INDEX CONCURRENTLY IF EXISTS folders_parentuuid_plainname_not_deleted_support_index;
+    `);
+  },
+
+  down: async (queryInterface) => {
+    await queryInterface.sequelize.query(`
+      DROP INDEX CONCURRENTLY IF EXISTS folders_parentuuid_plainname_not_deleted_support_index;
+    `);
+  },
+};