feat: add exception for models with conflicting url/urls columns

- Add validation in HasUniqueUrls trait initialization
- Check if model has 'url' or 'urls' database columns
- Throw descriptive exception with guidance on fixing conflicts
- Add tests (test #12 and #13) to verify exception behavior

Fixes #67

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Vladislav Stoitsov <[email protected]>

Author: github-actions[bot]

src/HasUniqueUrls.php

@@ -18,6 +18,55 @@ trait HasUniqueUrls
 
     abstract public function urlHandler(): array;
 
+    /**
+     * Initialize the HasUniqueUrls trait for an instance.
+     *
+     * @throws Exception
+     */
+    public function initializeHasUniqueUrls(): void
+    {
+        $this->checkForConflictingAttributes();
+    }
+
+    /**
+     * Check if the model has conflicting 'url' or 'urls' attributes.
+     *
+     * @throws Exception
+     */
+    private function checkForConflictingAttributes(): void
+    {
+        $conflictingAttributes = ['url', 'urls'];
+        $modelClass = get_class($this);
+
+        foreach ($conflictingAttributes as $attribute) {
+            // Check if attribute exists in fillable, guarded, or as a database column
+            if ($this->hasColumn($attribute)) {
+                throw new Exception(
+                    "Model [{$modelClass}] has a conflicting column '{$attribute}'. " .
+                    "The HasUniqueUrls trait uses 'urls' as a relationship name and provides 'relative_url' and 'absolute_url' attributes. " .
+                    "Please rename the '{$attribute}' column in your model to avoid conflicts."
+                );
+            }
+        }
+    }
+
+    /**
+     * Check if the model has a specific column.
+     */
+    private function hasColumn(string $column): bool
+    {
+        try {
+            // Check if the table exists and has the column
+            if ($this->getConnection()->getSchemaBuilder()->hasColumn($this->getTable(), $column)) {
+                return true;
+            }
+        } catch (\Exception $e) {
+            // If we can't check the schema (e.g., during testing without migrations), skip the check
+        }
+
+        return false;
+    }
+
     /**
      * Generate a unique URL for the model.
      *

tests/HasUniqueUrlsTest.php

@@ -1,6 +1,8 @@
 <?php
 
+use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Foundation\Testing\RefreshDatabase;
+use Illuminate\Support\Facades\Schema;
 use Vlados\LaravelUniqueUrls\LaravelUniqueUrlsController;
 use Vlados\LaravelUniqueUrls\Models\Url;
 use Vlados\LaravelUniqueUrls\Tests\Models\ChildModel;
@@ -169,3 +171,77 @@
         expect($model->relative_url)->toEqual(app()->getLocale()."/parent/test".($i > 0 ? "_".$i : ""));
     }
 });
+
+test('12. Check if exception is thrown when model has conflicting url column', function () {
+    // Create a table with 'url' column
+    Schema::create('models_with_url_column', function (Blueprint $table) {
+        $table->increments('id');
+        $table->string('name');
+        $table->string('url');
+    });
+
+    // Create a model class that uses HasUniqueUrls trait
+    $modelClass = new class extends \Illuminate\Database\Eloquent\Model {
+        use \Vlados\LaravelUniqueUrls\HasUniqueUrls;
+
+        protected $table = 'models_with_url_column';
+        protected $guarded = [];
+        public $timestamps = false;
+
+        public function urlHandler(): array
+        {
+            return [
+                'controller' => \Vlados\LaravelUniqueUrls\Tests\TestUrlHandler::class,
+                'method' => 'view',
+                'arguments' => [],
+            ];
+        }
+
+        public function urlStrategy($language, $locale): string
+        {
+            return \Illuminate\Support\Str::slug($this->name);
+        }
+    };
+
+    expect(fn() => $modelClass::create(['name' => 'test', 'url' => 'test-url']))
+        ->toThrow(Exception::class, "has a conflicting column 'url'");
+
+    Schema::dropIfExists('models_with_url_column');
+});
+
+test('13. Check if exception is thrown when model has conflicting urls column', function () {
+    // Create a table with 'urls' column
+    Schema::create('models_with_urls_column', function (Blueprint $table) {
+        $table->increments('id');
+        $table->string('name');
+        $table->string('urls');
+    });
+
+    // Create a model class that uses HasUniqueUrls trait
+    $modelClass = new class extends \Illuminate\Database\Eloquent\Model {
+        use \Vlados\LaravelUniqueUrls\HasUniqueUrls;
+
+        protected $table = 'models_with_urls_column';
+        protected $guarded = [];
+        public $timestamps = false;
+
+        public function urlHandler(): array
+        {
+            return [
+                'controller' => \Vlados\LaravelUniqueUrls\Tests\TestUrlHandler::class,
+                'method' => 'view',
+                'arguments' => [],
+            ];
+        }
+
+        public function urlStrategy($language, $locale): string
+        {
+            return \Illuminate\Support\Str::slug($this->name);
+        }
+    };
+
+    expect(fn() => $modelClass::create(['name' => 'test', 'urls' => 'test-urls']))
+        ->toThrow(Exception::class, "has a conflicting column 'urls'");
+
+    Schema::dropIfExists('models_with_urls_column');
+});