Add flowforgePositionColumn macro to Blueprint for database-specific collations

Author: ManukMinasyan

README.md

@@ -36,15 +36,7 @@ php artisan make:migration add_position_to_tasks_table
 ```php
 // migration
 Schema::table('tasks', function (Blueprint $table) {
-    // Database-specific collations for binary sorting
-    $driver = DB::connection()->getDriverName();
-    $positionColumn = $table->string('position')->nullable();
-    
-    match ($driver) {
-        'pgsql' => $positionColumn->collation('C'),
-        'mysql' => $positionColumn->collation('utf8mb4_bin'),
-        default => null,
-    };
+    $table->flowforgePositionColumn('position'); // Handles database-specific collations automatically
 });
 ```
 
@@ -342,19 +334,12 @@ Schema::create('tasks', function (Blueprint $table) {
     $table->id();
     $table->string('title');                         // Card title
     $table->string('status');                        // Column identifier
-    
-    // Position column with database-specific collations for binary sorting
-    $driver = DB::connection()->getDriverName();
-    $positionColumn = $table->string('position')->nullable();
-    
-    match ($driver) {
-        'pgsql' => $positionColumn->collation('C'),        // PostgreSQL binary
-        'mysql' => $positionColumn->collation('utf8mb4_bin'), // MySQL binary
-        default => null,
-    };
-    
+    $table->flowforgePositionColumn();               // Drag-and-drop ordering (handles DB-specific collations)
     $table->timestamps();
 });
+
+// Custom column name
+$table->flowforgePositionColumn('sort_order');      // Creates 'sort_order' column instead
 ```
 
 ### Factory Integration

src/FlowforgeServiceProvider.php

@@ -6,7 +6,9 @@
 use Filament\Support\Assets\Asset;
 use Filament\Support\Facades\FilamentAsset;
 use Filament\Support\Facades\FilamentIcon;
+use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Blade;
+use Illuminate\Support\Facades\DB;
 use Relaticle\Flowforge\Commands\MakeKanbanBoardCommand;
 use Spatie\LaravelPackageTools\Commands\InstallCommand;
 use Spatie\LaravelPackageTools\Package;
@@ -70,6 +72,9 @@ public function packageBooted(): void
 
         // Register Blade Components
         $this->registerBladeComponents();
+
+        // Register Blueprint Macros
+        $this->registerBlueprintMacros();
     }
 
     /**
@@ -139,4 +144,21 @@ protected function getScriptData(): array
             ],
         ];
     }
+
+    /**
+     * Register Blueprint macros for Flowforge.
+     */
+    private function registerBlueprintMacros(): void
+    {
+        Blueprint::macro('flowforgePositionColumn', function (string $name = 'position') {
+            $driver = DB::connection()->getDriverName();
+            $column = $this->string($name)->nullable();
+
+            return match ($driver) {
+                'pgsql' => $column->collation('C'),
+                'mysql' => $column->collation('utf8mb4_bin'),
+                default => $column,
+            };
+        });
+    }
 }

tests/Feature/BlueprintMacroTest.php

@@ -0,0 +1,64 @@
+<?php
+
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Schema\ColumnDefinition;
+use Illuminate\Support\Facades\DB;
+
+test('flowforgePositionColumn macro creates position column with correct collation for MySQL', function () {
+    // Mock MySQL connection
+    DB::shouldReceive('connection->getDriverName')
+        ->once()
+        ->andReturn('mysql');
+
+    $blueprint = new Blueprint('test_table');
+    $column = $blueprint->flowforgePositionColumn();
+
+    expect($column)->toBeInstanceOf(ColumnDefinition::class)
+        ->and($column->get('type'))->toBe('string')
+        ->and($column->get('nullable'))->toBeTrue()
+        ->and($column->get('collation'))->toBe('utf8mb4_bin');
+});
+
+test('flowforgePositionColumn macro creates position column with correct collation for PostgreSQL', function () {
+    // Mock PostgreSQL connection
+    DB::shouldReceive('connection->getDriverName')
+        ->once()
+        ->andReturn('pgsql');
+
+    $blueprint = new Blueprint('test_table');
+    $column = $blueprint->flowforgePositionColumn();
+
+    expect($column)->toBeInstanceOf(ColumnDefinition::class)
+        ->and($column->get('type'))->toBe('string')
+        ->and($column->get('nullable'))->toBeTrue()
+        ->and($column->get('collation'))->toBe('C');
+});
+
+test('flowforgePositionColumn macro accepts custom column name', function () {
+    // Mock MySQL connection
+    DB::shouldReceive('connection->getDriverName')
+        ->once()
+        ->andReturn('mysql');
+
+    $blueprint = new Blueprint('test_table');
+    $column = $blueprint->flowforgePositionColumn('sort_order');
+
+    expect($column)->toBeInstanceOf(ColumnDefinition::class)
+        ->and($column->get('name'))->toBe('sort_order')
+        ->and($column->get('collation'))->toBe('utf8mb4_bin');
+});
+
+test('flowforgePositionColumn macro works with unsupported database driver', function () {
+    // Mock unsupported driver
+    DB::shouldReceive('connection->getDriverName')
+        ->once()
+        ->andReturn('sqlite');
+
+    $blueprint = new Blueprint('test_table');
+    $column = $blueprint->flowforgePositionColumn();
+
+    expect($column)->toBeInstanceOf(ColumnDefinition::class)
+        ->and($column->get('type'))->toBe('string')
+        ->and($column->get('nullable'))->toBeTrue()
+        ->and($column->get('collation'))->toBeNull();
+});