fix: checking the state of a database with a binary field.

src/Testing/TableTestState.php

@@ -89,14 +89,24 @@ protected function prepareChanges(array $changes): array
         return array_map(function ($item) use ($jsonFields) {
             foreach ($jsonFields as $jsonField) {
                 if (Arr::has($item, $jsonField)) {
-                    $item[$jsonField] = json_decode($item[$jsonField], true);
+                    $value = $item[$jsonField];
+
+                    $item[$jsonField] = $this->isBinary($value)
+                        ? bin2hex($value)
+                        : json_decode($value, true);
                 }
             }
 
             return $item;
         }, $changes);
     }
 
+    protected function isBinary(?string $data): bool
+    {
+        return !is_null($data)
+            && !mb_check_encoding($data, 'UTF-8');
+    }
+
     protected function getFixturePath(string $fixtureName): string
     {
         $testClassTrace = Arr::first(debug_backtrace(), fn ($trace) => str_ends_with($trace['file'], 'Test.php'));

tests/BaseRequestTest.php

@@ -14,7 +14,7 @@ public function testGetOrderableFields()
     {
         $result = $this->callEncapsulatedMethod(new BaseRequest(), 'getOrderableFields', TestModel::class);
 
-        $expectedResult = 'id,name,json_field,castable_field,*,created_at,updated_at';
+        $expectedResult = 'id,name,json_field,castable_field,binary_field,*,created_at,updated_at';
 
         $this->assertEquals($expectedResult, $result);
     }
@@ -28,7 +28,7 @@ public function testGetOrderableFieldsWithAdditionalFields()
 
         $result = $this->callEncapsulatedMethod(new BaseRequest(), 'getOrderableFields', ...$args);
 
-        $expectedResult = 'id,name,json_field,castable_field,*,created_at,updated_at,additional_field_1,additional_field_2';
+        $expectedResult = 'id,name,json_field,castable_field,binary_field,*,created_at,updated_at,additional_field_1,additional_field_2';
 
         $this->assertEquals($expectedResult, $result);
     }

tests/ModelTestStateTest.php

@@ -35,7 +35,7 @@ public function testInitialization()
         $jsonFields = $this->getProtectedProperty($reflectionClass, 'jsonFields', $modelTestState);
         $state = $this->getProtectedProperty($reflectionClass, 'state', $modelTestState);
 
-        $this->assertEquals(['json_field', 'castable_field'], $jsonFields);
+        $this->assertEquals(['json_field', 'castable_field', 'binary_field'], $jsonFields);
         $this->assertEquals($originRecords, $state);
     }
 
@@ -88,6 +88,40 @@ public function testAssertChangesWithoutJsonFields()
         $modelTestState->assertChangesEqualsFixture('assertion_fixture_without_json_fields.json');
     }
 
+    public function testAssertChangesBinaryString()
+    {
+        $initialDatasetMock = collect([[
+            'id' => 1,
+            'binary_field' => null,
+        ]]);
+        $changedDatasetMock = collect([[
+            'id' => 1,
+            'binary_field' => md5('some_string', true),
+        ]]);
+
+        $this->mockGettingDatasetForChanges($changedDatasetMock, $initialDatasetMock, 'test_models');
+
+        $modelTestState = new ModelTestState(TestModel::class);
+        $modelTestState->assertChangesEqualsFixture('assert_changes_binary_string.json');
+    }
+
+    public function testAssertChangesBinaryNullable()
+    {
+        $initialDatasetMock = collect([[
+            'id' => 1,
+            'binary_field' => md5('some_string', true),
+        ]]);
+        $changedDatasetMock = collect([[
+            'id' => 1,
+            'binary_field' => null,
+        ]]);
+
+        $this->mockGettingDatasetForChanges($changedDatasetMock, $initialDatasetMock, 'test_models');
+
+        $modelTestState = new ModelTestState(TestModel::class);
+        $modelTestState->assertChangesEqualsFixture('assert_changes_binary_string_to_null.json');
+    }
+
     public function testAssertNoChanges()
     {
         $datasetMock = collect($this->getJsonFixture('get_without_changes/dataset.json'));

tests/fixtures/ModelTestStateTest/db_changes/test_models/assert_changes_binary_string.json

@@ -0,0 +1,10 @@
+{
+    "updated": [
+        {
+            "id": 1,
+            "binary_field": "31ee76261d87fed8cb9d4c465c48158c"
+        }
+    ],
+    "created": [],
+    "deleted": []
+}

tests/fixtures/ModelTestStateTest/db_changes/test_models/assert_changes_binary_string_to_null.json

@@ -0,0 +1,10 @@
+{
+    "updated": [
+        {
+            "id": 1,
+            "binary_field": null
+        }
+    ],
+    "created": [],
+    "deleted": []
+}

tests/support/Mock/Casts/BinaryCast.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace RonasIT\Support\Tests\Support\Mock\Casts;
+
+use Illuminate\Contracts\Database\Eloquent\CastsAttributes;
+
+class BinaryCast implements CastsAttributes
+{
+    public function get($model, $key, $value, $attributes)
+    {
+        return is_null($value) ? $value : bin2hex($value);
+    }
+
+    public function set($model, $key, $value, $attributes)
+    {
+        return is_null($value) ? $value : md5($value, true);
+    }
+}

tests/support/Mock/Models/TestModel.php

@@ -5,6 +5,7 @@
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\HasMany;
 use Illuminate\Database\Eloquent\SoftDeletes;
+use RonasIT\Support\Tests\Support\Mock\Casts\BinaryCast;
 use RonasIT\Support\Tests\Support\Mock\Casts\JSONCustomCast;
 use RonasIT\Support\Traits\ModelTrait;
 
@@ -17,11 +18,13 @@ class TestModel extends Model
         'name',
         'json_field',
         'castable_field',
+        'binary_field',
     ];
 
     protected $casts = [
         'json_field' => 'array',
         'castable_field' => JSONCustomCast::class,
+        'binary_field' => BinaryCast::class,
     ];
 
     public function relation(): HasMany