Refactor PivotProcessor: Replace composite primary key with auto-increment ID and preserve uniqueness via unique index

- Replaces composite primary keys (e.g. role_id + customer_id) with a single 'id' column (bigInteger, auto-increment)
- Converts the removed primary key columns into a unique index to retain logical constraints
- Ensures compatibility with Laravel's Eloquent model usage on pivot tables

Author: N3XT0R

src/Service/Generator/Normalization/Processors/PivotProcessor.php

@@ -22,33 +22,63 @@ public function process(NormalizationContext $context): ResultEntity
         $results = $result->getResults();
 
         foreach ($results as $tableName => $definitions) {
+            if (!isset($definitions['primaryKey'])) {
+                continue;
+            }
+
+            /** @var PrimaryKeyEntity|null $primary */
             $primary = current($definitions['primaryKey']);
-            $pkColumns = $primary->getColumns();
-            if ($primary instanceof PrimaryKeyEntity && count($pkColumns) >= 2) {
-                $idField = new FieldEntity();
-                $idField->setTable($tableName);
-                $idField->setType('bigInteger');
-                $idField->setArguments(['autoIncrement' => true]);
-                $idField->setOptions([
-                    'default' => null,
-                    'unsigned' => true,
-                    'nullable' => false
-                ]);
-
-                $uniqueIndex = new IndexEntity();
-                $uniqueIndex->setType('unique');
-                $uniqueIndex->setColumns($pkColumns);
-
-                $idField->setColumnName('id');
-                $results[$tableName]['table'] = ['id' => $idField, ...$definitions['table']];
-                $results[$tableName]['index'] = [$uniqueIndex, ...$definitions['index']];
-                unset($results[$tableName]['primaryKey']);
-                //dump($results);
+            if (!$this->isCompositePrimaryKey($primary)) {
+                continue;
             }
+
+            $results[$tableName] = $this->transformPivotTable($tableName, $definitions, $primary);
         }
 
         $result->setResults($results);
         $context->update($result);
+
         return $result;
     }
+
+    protected function isCompositePrimaryKey(?PrimaryKeyEntity $primary): bool
+    {
+        return $primary instanceof PrimaryKeyEntity && count($primary->getColumns()) >= 2;
+    }
+
+    protected function transformPivotTable(string $tableName, array $definitions, PrimaryKeyEntity $primary): array
+    {
+        $definitions['table'] = $this->prependIdField($tableName, $definitions['table']);
+        unset($definitions['primaryKey']);
+        $definitions['index'][] = $this->createUniqueIndexFromPrimaryKey($primary);
+
+        return $definitions;
+    }
+
+    protected function prependIdField(string $tableName, array $fields): array
+    {
+        $idField = new FieldEntity();
+        $idField->setTable($tableName);
+        $idField->setType('bigInteger');
+        $idField->setArguments(['autoIncrement' => true]);
+        $idField->setOptions([
+            'default' => null,
+            'unsigned' => true,
+            'nullable' => false,
+        ]);
+        $idField->setColumnName('id');
+
+        return ['id' => $idField] + $fields;
+    }
+
+    protected function createUniqueIndexFromPrimaryKey(PrimaryKeyEntity $primary): IndexEntity
+    {
+        $index = new IndexEntity();
+        $index->setType('unique');
+        $index->setIndexType('index');
+        $index->setColumns($primary->getColumns());
+        $index->setName(implode('_', $primary->getColumns()) . '_unique');
+
+        return $index;
+    }
 }