wip: update to dynamic prepoerties

Author: lam0819

.vscode/settings.json

@@ -0,0 +1,6 @@
+{
+    "kiroAgent.trustedCommands": [
+        "*",
+        "./vendor/bin/pest --no-coverage --exclude-group=performance 2>&1 | grep -E \"(FAILED|Tests:)\" | tail -5"
+    ]
+}

CHANGELOG.md

@@ -375,8 +375,8 @@ Property::create([
 
 // Use properties
 $user = User::find(1);
-$user->setProperty('phone', '+1234567890');
-$phone = $user->getProperty('phone');
+$user->setDynamicProperty('phone', '+1234567890');
+$phone = $user->getDynamicProperty('phone');
 
 // Search by properties
 $users = User::whereProperty('phone', 'LIKE', '+1%')->get();

CONTRIBUTING.md

@@ -165,7 +165,7 @@ class PropertyService
      * @throws PropertyNotFoundException
      * @throws PropertyValidationException
      */
-    public function setProperty(Model $entity, string $name, mixed $value): void
+    public function setDynamicProperty(Model $entity, string $name, mixed $value): void
     {
         // Implementation...
     }
@@ -175,7 +175,7 @@ class PropertyService
 #### Naming Conventions
 
 - **Classes**: PascalCase (`PropertyService`)
-- **Methods**: camelCase (`setProperty`)
+- **Methods**: camelCase (`setDynamicProperty`)
 - **Variables**: camelCase (`$propertyName`)
 - **Constants**: SCREAMING_SNAKE_CASE (`MAX_PROPERTY_LENGTH`)
 - **Database tables**: snake_case (`entity_properties`)
@@ -310,15 +310,15 @@ describe('PropertyService', function () {
     it('can set a property value', function () {
         $user = User::factory()->create();
 
-        $this->service->setProperty($user, 'test_property', 'test value');
+        $this->service->setDynamicProperty($user, 'test_property', 'test value');
 
-        expect($user->getProperty('test_property'))->toBe('test value');
+        expect($user->getDynamicProperty('test_property'))->toBe('test value');
     });
 
     it('throws exception for invalid property', function () {
         $user = User::factory()->create();
 
-        expect(fn() => $this->service->setProperty($user, 'invalid', 'value'))
+        expect(fn() => $this->service->setDynamicProperty($user, 'invalid', 'value'))
             ->toThrow(PropertyNotFoundException::class);
     });
 });
@@ -344,8 +344,8 @@ describe('Property Search', function () {
         $engineeringUser = User::factory()->create();
         $marketingUser = User::factory()->create();
 
-        $engineeringUser->setProperty('department', 'engineering');
-        $marketingUser->setProperty('department', 'marketing');
+        $engineeringUser->setDynamicProperty('department', 'engineering');
+        $marketingUser->setDynamicProperty('department', 'marketing');
 
         $results = User::whereProperty('department', 'engineering')->get();
 

INSTALLATION.md

@@ -406,8 +406,8 @@ $property = Property::create([
 // Add trait to User model (if not already added)
 // Then test property operations
 $user = User::first();
-$user->setProperty('test_property', 'Hello World');
-echo $user->getProperty('test_property'); // Should output: Hello World
+$user->setDynamicProperty('test_property', 'Hello World');
+echo $user->getDynamicProperty('test_property'); // Should output: Hello World
 
 // Clean up
 $user->removeProperty('test_property');

README.md

@@ -92,16 +92,16 @@ Property::create([
 $user = User::find(1);
 
 // Set properties
-$user->setProperty('phone', '+1234567890');
-$user->setProperty('age', 25);
-$user->setProperty('status', 'active');
+$user->setDynamicProperty('phone', '+1234567890');
+$user->setDynamicProperty('age', 25);
+$user->setDynamicProperty('status', 'active');
 
 // Or use magic methods
 $user->prop_phone = '+1234567890';
 $user->prop_age = 25;
 
 // Get properties
-$phone = $user->getProperty('phone');
+$phone = $user->getDynamicProperty('phone');
 $age = $user->prop_age; // Magic method
 $allProperties = $user->properties; // All properties as array
 
@@ -263,14 +263,14 @@ use YourVendor\DynamicProperties\Exceptions\PropertyNotFoundException;
 use YourVendor\DynamicProperties\Exceptions\PropertyValidationException;
 
 try {
-    $user->setProperty('nonexistent_property', 'value');
+    $user->setDynamicProperty('nonexistent_property', 'value');
 } catch (PropertyNotFoundException $e) {
     // Handle property not found
     echo "Property not found: " . $e->getMessage();
 }
 
 try {
-    $user->setProperty('age', 'invalid_number');
+    $user->setDynamicProperty('age', 'invalid_number');
 } catch (PropertyValidationException $e) {
     // Handle validation error
     echo "Validation failed: " . $e->getMessage();
@@ -301,18 +301,18 @@ php artisan properties:cache-sync
 
 #### Methods
 
-**setProperty(string $name, mixed $value): void**
+**setDynamicProperty(string $name, mixed $value): void**
 - Sets a single property value
 - Validates the value against property rules
 - Updates JSON cache if available
 
-**getProperty(string $name): mixed**
+**getDynamicProperty(string $name): mixed**
 - Retrieves a single property value
 - Returns null if property doesn't exist
 
 **setProperties(array $properties): void**
 - Sets multiple properties at once
-- More efficient than multiple setProperty calls
+- More efficient than multiple setDynamicProperty calls
 
 **getPropertiesAttribute(): array**
 - Returns all properties as an associative array
@@ -340,7 +340,7 @@ php artisan properties:cache-sync
 
 ### PropertyService
 
-**setProperty(Model $entity, string $name, mixed $value): void**
+**setDynamicProperty(Model $entity, string $name, mixed $value): void**
 - Core method for setting property values
 - Handles validation and storage
 

composer.json

@@ -1,5 +1,5 @@
 {
-    "name": "user-property-library/dynamic-properties",
+    "name": "solution-forest/laravel-dynamic-properties",
     "description": "A fast, flexible dynamic property system for Laravel entities",
     "type": "library",
     "license": "MIT",
@@ -15,8 +15,8 @@
     },
     "require": {
         "php": "^8.3",
-        "illuminate/database": "^10.0|^11.0",
-        "illuminate/support": "^10.0|^11.0"
+        "illuminate/database": "^10.0|^11.0|^12.0",
+        "illuminate/support": "^10.0|^11.0|^12.0"
     },
     "require-dev": {
         "laravel/pint": "^1.24",
@@ -41,4 +41,4 @@
     },
     "minimum-stability": "dev",
     "prefer-stable": true
-}
+}

composer.json.backup

@@ -0,0 +1,44 @@
+{
+    "name": "user-property-library/dynamic-properties",
+    "description": "A fast, flexible dynamic property system for Laravel entities",
+    "type": "library",
+    "license": "MIT",
+    "autoload": {
+        "psr-4": {
+            "DynamicProperties\\": "src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "DynamicProperties\\Tests\\": "tests/"
+        }
+    },
+    "require": {
+        "php": "^8.3",
+        "illuminate/database": "^10.0|^11.0",
+        "illuminate/support": "^10.0|^11.0"
+    },
+    "require-dev": {
+        "laravel/pint": "^1.24",
+        "orchestra/testbench": "^8.0|^9.0",
+        "pestphp/pest": "^4.0"
+    },
+    "extra": {
+        "laravel": {
+            "providers": [
+                "DynamicProperties\\DynamicPropertyServiceProvider"
+            ],
+            "aliases": {
+                "DynamicProperties": "DynamicProperties\\Facades\\DynamicProperties"
+            }
+        }
+    },
+    "config": {
+        "sort-packages": true,
+        "allow-plugins": {
+            "pestphp/pest-plugin": true
+        }
+    },
+    "minimum-stability": "dev",
+    "prefer-stable": true
+}

docs/API.md

@@ -160,7 +160,7 @@ class User extends Model
 Sets a single property value with validation.
 
 ```php
-$user->setProperty('phone', '+1234567890');
+$user->setDynamicProperty('phone', '+1234567890');
 ```
 
 **Parameters:**
@@ -173,12 +173,12 @@ $user->setProperty('phone', '+1234567890');
 
 ---
 
-**getProperty(string $name): mixed**
+**getDynamicProperty(string $name): mixed**
 
 Retrieves a single property value.
 
 ```php
-$phone = $user->getProperty('phone');
+$phone = $user->getDynamicProperty('phone');
 ```
 
 **Parameters:**
@@ -250,15 +250,15 @@ $user->removeProperty('phone');
 Access properties using the `prop_` prefix.
 
 ```php
-$phone = $user->prop_phone; // Equivalent to $user->getProperty('phone')
+$phone = $user->prop_phone; // Equivalent to $user->getDynamicProperty('phone')
 ```
 
 **__set(string $key, mixed $value): void**
 
 Set properties using the `prop_` prefix.
 
 ```php
-$user->prop_phone = '+1234567890'; // Equivalent to $user->setProperty('phone', '+1234567890')
+$user->prop_phone = '+1234567890'; // Equivalent to $user->setDynamicProperty('phone', '+1234567890')
 ```
 
 **__isset(string $key): bool**
@@ -374,7 +374,7 @@ Sets a property value for an entity.
 
 ```php
 $propertyService = app(PropertyService::class);
-$propertyService->setProperty($user, 'phone', '+1234567890');
+$propertyService->setDynamicProperty($user, 'phone', '+1234567890');
 ```
 
 **Parameters:**
@@ -388,12 +388,12 @@ $propertyService->setProperty($user, 'phone', '+1234567890');
 
 ---
 
-**getProperty(Model $entity, string $name): mixed**
+**getDynamicProperty(Model $entity, string $name): mixed**
 
 Gets a property value for an entity.
 
 ```php
-$phone = $propertyService->getProperty($user, 'phone');
+$phone = $propertyService->getDynamicProperty($user, 'phone');
 ```
 
 **Parameters:**
@@ -541,7 +541,7 @@ Thrown when trying to access a property that doesn't exist.
 use YourVendor\DynamicProperties\Exceptions\PropertyNotFoundException;
 
 try {
-    $user->setProperty('nonexistent', 'value');
+    $user->setDynamicProperty('nonexistent', 'value');
 } catch (PropertyNotFoundException $e) {
     echo "Property not found: " . $e->getPropertyName();
 }
@@ -558,7 +558,7 @@ Thrown when a property value fails validation.
 use YourVendor\DynamicProperties\Exceptions\PropertyValidationException;
 
 try {
-    $user->setProperty('age', 'not_a_number');
+    $user->setDynamicProperty('age', 'not_a_number');
 } catch (PropertyValidationException $e) {
     echo "Validation failed: " . $e->getMessage();
     $errors = $e->getValidationErrors(); // Array of validation messages
@@ -612,10 +612,10 @@ Provides convenient access to PropertyService methods.
 use YourVendor\DynamicProperties\Facades\DynamicProperties;
 
 // Set property
-DynamicProperties::setProperty($user, 'phone', '+1234567890');
+DynamicProperties::setDynamicProperty($user, 'phone', '+1234567890');
 
 // Get property
-$phone = DynamicProperties::getProperty($user, 'phone');
+$phone = DynamicProperties::getDynamicProperty($user, 'phone');
 
 // Set multiple properties
 DynamicProperties::setProperties($user, [