fix(builder): enhance createForeignKey to handle deprecated reference option and ensure proper assignment of reference properties

Author: AxiosLeo

src/builder.js

@@ -583,7 +583,16 @@ class ManageSQLBuilder extends Builder {
   }
 
   createForeignKey(options, onCreateTable = false) {
+    if (options.reference && !options.references) {
+      options.references = options.reference;
+    }
     if (options.references) {
+      if (options.references.tableName && !options.references.table) {
+        options.references.table = options.references.tableName;
+      }
+      if (options.references.columnName && !options.references.column) {
+        options.references.column = options.references.columnName;
+      }
       options.references.onDelete = options.references.onDelete ? options.references.onDelete.toUpperCase() : 'NO ACTION';
       options.references.onUpdate = options.references.onUpdate ? options.references.onUpdate.toUpperCase() : 'NO ACTION';
     }

tests/builder.tests.js

@@ -916,6 +916,28 @@ describe('builder test case', () => {
       expect(sql).to.be.equal('ALTER TABLE `test_table` DROP FOREIGN KEY `fk_test`');
     });
 
+    it('should handle createForeignKey with deprecated reference (singular) option', () => {
+      const builder = new ManageSQLBuilder({
+        operator: 'create',
+        target: 'foreignKey',
+        name: 'fk_orders_user_id',
+        table: 'orders',
+        column: 'user_id',
+        reference: {
+          tableName: 'users',
+          columnName: 'id',
+          onDelete: 'CASCADE',
+          onUpdate: 'RESTRICT'
+        }
+      });
+      const sql = builder.sql;
+      expect(sql).to.include('ALTER TABLE `orders`');
+      expect(sql).to.include('FOREIGN KEY (`user_id`)');
+      expect(sql).to.include('REFERENCES `users` (`id`)');
+      expect(sql).to.include('ON DELETE CASCADE');
+      expect(sql).to.include('ON UPDATE RESTRICT');
+    });
+
     it('should handle createColumns with uniqIndex', () => {
       const options = {
         operator: 'create',