Refactor state management to use StateHistory model and update README and migration files accordingly

Author: nthndnn

README.md

@@ -6,7 +6,7 @@ A Laravel package for managing **enum-based model states** with enforced transit
 
 - **Native PHP Enums** (PHP 8.2+)
 - **Enforced Transitions** with a pluggable state machine
-- **Automatic History** with metadata & correlation IDs
+- **Automatic History** with metadata
 - **Smart Casting** of historical `from`/`to` values (enums, dates, primitives, custom casts)
 - **Atomic Operations** – state change + history in one transaction
 - **Current State Columns** (`current_{field}`) for indexing & querying
@@ -203,7 +203,7 @@ Config (`config/state-history.php`):
 return [
     'use_current_columns' => true,
     'prefix' => 'current_',
-    'model' => \App\Models\CustomModelState::class,
+    'model' => \App\Models\CustomStateHistory::class,
 ];
 ```
 

config/state-history.php

@@ -43,9 +43,9 @@
     |--------------------------------------------------------------------------
     |
     | The model class to use for state history records. This should be a class
-    | that extends the base ModelState model.
+    | that extends the base StateHistory model.
     |
     */
 
-    'model' => env('STATE_HISTORY_MODEL', \NathanDunn\StateHistory\Models\ModelState::class),
+    'model' => env('STATE_HISTORY_MODEL', \NathanDunn\StateHistory\Models\StateHistory::class),
 ];

database/migrations/create_model_states_table.php.stub renamed to database/migrations/create_state_histories_table.php.stub

@@ -12,7 +12,7 @@ return new class extends Migration
      */
     public function up(): void
     {
-        Schema::create('model_states', function (Blueprint $table) {
+        Schema::create('state_histories', function (Blueprint $table) {
             $table->id();
             $table->morphs('model');
             $table->string('field');
@@ -36,6 +36,6 @@ return new class extends Migration
      */
     public function down(): void
     {
-        Schema::dropIfExists('model_states');
+        Schema::dropIfExists('state_histories');
     }
 };

src/Models/ModelState.php

@@ -26,7 +26,7 @@ public function boot(): void
         ], 'config');
 
         $this->publishes([
-            __DIR__ . '/../database/migrations/create_model_states_table.php.stub' => database_path('migrations/' . date('Y_m_d_His') . '_create_model_states_table.php'),
+            __DIR__ . '/../database/migrations/create_state_histories_table.php.stub' => database_path('migrations/' . date('Y_m_d_His') . '_create_state_histories_table.php'),
         ], 'migrations');
     }
 }

src/StateHistoryServiceProvider.php

@@ -14,7 +14,7 @@
 use NathanDunn\StateHistory\Events\StateTransitioning;
 use NathanDunn\StateHistory\Exceptions\InvalidStateTransitionException;
 use NathanDunn\StateHistory\Exceptions\StateTransitionBlockedException;
-use NathanDunn\StateHistory\Models\ModelState;
+use NathanDunn\StateHistory\Models\StateHistory;
 use NathanDunn\StateHistory\Support\StateMachineConfig;
 
 class StateManager
@@ -117,7 +117,7 @@ protected function getCurrentState(Model $model, string $field): ?string
             }
         }
 
-        $latestState = app(ModelState::class)
+        $latestState = app(StateHistory::class)
             ->where('model_type', get_class($model))
             ->where('model_id', $model->getKey())
             ->where('field', $field)

src/StateManager.php

@@ -7,7 +7,7 @@
 use Illuminate\Database\Eloquent\Relations\MorphMany;
 use Illuminate\Support\Facades\Schema;
 use NathanDunn\StateHistory\Exceptions\NoStateMachineConfiguredException;
-use NathanDunn\StateHistory\Models\ModelState;
+use NathanDunn\StateHistory\Models\StateHistory;
 use NathanDunn\StateHistory\StateManager;
 use NathanDunn\StateHistory\Support\StateMachineConfig;
 
@@ -65,7 +65,7 @@ public function states(string $field): MorphMany
     /**
      * Get the latest state for a specific field.
      */
-    public function latestState(string $field): ?ModelState
+    public function latestState(string $field): ?StateHistory
     {
         return $this->states($field)->first();
     }

src/Traits/HasState.php

@@ -37,7 +37,7 @@ private function createTables(): void
             $table->timestamps();
         });
 
-        $this->app['db']->connection()->getSchemaBuilder()->create('model_states', function (Blueprint $table) {
+        $this->app['db']->connection()->getSchemaBuilder()->create('state_histories', function (Blueprint $table) {
             $table->id();
             $table->string('model_type');
             $table->unsignedBigInteger('model_id');
@@ -269,7 +269,7 @@ public function it_uses_config_based_model_resolution()
     {
         // Test that the package uses the configured model class
         $this->assertEquals(
-            \NathanDunn\StateHistory\Models\ModelState::class,
+            \NathanDunn\StateHistory\Models\StateHistory::class,
             config('state-history.model')
         );