Fix backward compatibility for settings keys created under old Rawilk namespace

The package rebrand from Rawilk to AgentSoftware changed the FQCN embedded
in serialized Context objects, breaking key lookup for existing database
entries. The ContextSerializer now normalizes its output to use the old
namespace, and a class alias is registered so old serialized data can still
be unserialized.

Author: evan-burrell

src/SettingsServiceProvider.php

@@ -32,6 +32,7 @@ public function packageBooted(): void
 
     public function packageRegistered(): void
     {
+        $this->registerClassAliases();
         $this->registerSettings();
     }
 
@@ -43,6 +44,16 @@ public function provides(): array
         ];
     }
 
+    protected function registerClassAliases(): void
+    {
+        if (! class_exists(\Rawilk\Settings\Support\Context::class, false)) {
+            class_alias(
+                \AgentSoftware\Settings\Support\Context::class,
+                'Rawilk\Settings\Support\Context',
+            );
+        }
+    }
+
     protected function bootModelBindings(): void
     {
         $config = $this->app['config']['settings.drivers.eloquent'];

src/Support/ContextSerializers/ContextSerializer.php

@@ -11,6 +11,14 @@ class ContextSerializer implements ContextSerializerContract
 {
     public function serialize(?Context $context = null): string
     {
-        return serialize($context);
+        $serialized = serialize($context);
+
+        // Maintain backward compatibility with the old Rawilk namespace
+        // so that key generation produces identical keys for existing data.
+        return str_replace(
+            sprintf('O:%d:"%s"', strlen('AgentSoftware\\Settings\\Support\\Context'), 'AgentSoftware\\Settings\\Support\\Context'),
+            sprintf('O:%d:"%s"', strlen('Rawilk\\Settings\\Support\\Context'), 'Rawilk\\Settings\\Support\\Context'),
+            $serialized,
+        );
     }
 }

tests/Unit/ContextSerializers/ContextSerializerTest.php

@@ -10,11 +10,35 @@
 
     $serializer = new ContextSerializer;
 
-    expect($serializer->serialize($context))->toBe(serialize($context));
+    $result = $serializer->serialize($context);
+
+    expect($result)->toContain('Rawilk\Settings\Support\Context')
+        ->and($result)->not->toContain('AgentSoftware\Settings\Support\Context');
 });
 
 it('serializes null values', function () {
     $serializer = new ContextSerializer;
 
     expect($serializer->serialize(null))->toBe(serialize(null));
 });
+
+it('produces output compatible with the old Rawilk namespace for backward compatibility', function () {
+    $context = (new Context)->set('model', 'App\Models\Website')->set('id', '123');
+
+    $serializer = new ContextSerializer;
+    $serialized = $serializer->serialize($context);
+
+    expect($serialized)->toContain('O:31:"Rawilk\Settings\Support\Context"');
+});
+
+it('produces output that can be unserialized back to a valid Context', function () {
+    $context = (new Context)->set('model', 'App\Models\Website')->set('id', '123');
+
+    $serializer = new ContextSerializer;
+    $serialized = $serializer->serialize($context);
+
+    $unserialized = unserialize($serialized);
+
+    expect($unserialized)->toBeInstanceOf(Context::class)
+        ->and($unserialized->toArray())->toBe($context->toArray());
+});

tests/Unit/KeyGenerators/HashKeyGeneratorTest.php

@@ -26,8 +26,10 @@
         'id' => 123,
     ]);
 
+    $serializer = new ContextSerializer;
+
     expect($this->keyGenerator->generate('my-key', $context))
-        ->toBe(hash('xxh128', 'my-key' . serialize($context)));
+        ->toBe(hash('xxh128', 'my-key' . $serializer->serialize($context)));
 });
 
 it('works with other context serializers', function () {

tests/Unit/KeyGenerators/Md5KeyGeneratorTest.php

@@ -22,8 +22,10 @@
         'id' => 123,
     ]);
 
+    $serializer = new ContextSerializer;
+
     expect($this->keyGenerator->generate('my-key', $context))
-        ->toBe(md5('my-key' . serialize($context)));
+        ->toBe(md5('my-key' . $serializer->serialize($context)));
 });
 
 it('works with other context serializers', function () {

tests/Unit/KeyGenerators/ReadableKeyGeneratorTest.php

@@ -38,5 +38,7 @@
         'id' => 123,
     ]);
 
-    expect($this->keyGenerator->generate('my-key', $context))->toBe('my-key:c:::' . serialize($context));
+    $serializer = new ContextSerializer;
+
+    expect($this->keyGenerator->generate('my-key', $context))->toBe('my-key:c:::' . $serializer->serialize($context));
 });