Merge branch 'feature/request-dto-transition' into develop

Author: ljonesfl

composer.json

@@ -15,6 +15,7 @@
       "ext-json": "*",
       "neuron-php/application": "0.8.*",
       "neuron-php/routing": "0.8.*",
+      "neuron-php/dto": "^0.0.7",
       "league/commonmark": "^2.6",
       "neuron-php/cli": "0.8.*",
       "robmorgan/phinx": "^0.16",

examples/config/requests/login.yaml

@@ -6,17 +6,20 @@ request:
     username:
       required: true
       type: string
-      minLength: 3
-      maxLength: 20
+      length:
+        min: 3
+        max: 20
     password:
       required: true
       type: string
-      minLength: 8
-      maxLength: 50
+      length:
+        min: 8
+        max: 50
     age:
       type: integer
-      minimum: 18
-      maximum: 40
+      range:
+        min: 18
+        max: 40
     birthdate:
       type: string
       format: date
@@ -28,20 +31,24 @@ request:
         street:
           required: true
           type: string
-          minLength: 3
-          maxLength: 10
+          length:
+            min: 3
+            max: 10
         city:
           required: true
           type: string
-          minLength: 3
-          maxLength: 20
+          length:
+            min: 3
+            max: 20
         state:
           required: true
           type: string
-          minLength: 2
-          maxLength: 2
+          length:
+            min: 2
+            max: 2
         zip:
           required: true
           type: string
-          minLength: 3
-          maxLength: 20
+          length:
+            min: 3
+            max: 20

examples/config/requests/test.yaml

@@ -27,8 +27,9 @@ request:
     integer:
       required: true
       type: integer
-      minValue: 1
-      maxValue: 100
+      range:
+        min: 1
+        max: 100
     ip_address:
       required: true
       type: ip_address
@@ -45,18 +46,21 @@ request:
         subparam1:
           required: true
           type: string
-          minLength: 3
-          maxLength: 20
+          length:
+            min: 3
+            max: 20
         subparam2:
           required: true
           type: string
-          minLength: 3
-          maxLength: 20
+          length:
+            min: 3
+            max: 20
     string:
       required: true
       type: string
-      minLength: 3
-      maxLength: 20
+      length:
+        min: 3
+        max: 20
     time:
       required: true
       type: time

readme.md

@@ -187,23 +187,52 @@ routes:
 
 ### Request Handling
 
-Create request parameter definitions for validation:
+Create request DTO definitions for validation. You can define DTOs inline or reference external DTO files:
+
+**Inline DTO Definition:**
 
 ```yaml
 # config/requests/user_profile.yaml
-parameters:
-  id:
-    type: integer
+request:
+  method: GET
+  properties:
+    id:
+      type: integer
+      required: true
+      range:
+        min: 1
+```
+
+**Referenced DTO:**
+
+```yaml
+# config/requests/user_create.yaml
+request:
+  method: POST
+  dto: user  # References config/Dtos/user.yaml or src/Dtos/user.yaml
+```
+
+```yaml
+# config/Dtos/user.yaml (or src/Dtos/user.yaml)
+dto:
+  username:
+    type: string
+    required: true
+    length:
+      min: 3
+      max: 20
+  email:
+    type: email
     required: true
-    min_value: 1
 ```
 
-Access parameters in controllers:
+Access validated data in controllers:
 
 ```php
 public function profile(Request $request): string
 {
-    $userId = $request->getParam('id')->getValue();
+    $dto = $request->getDto();
+    $userId = $dto->id;
     // ...
 }
 ```
@@ -448,7 +477,7 @@ class ProductController extends Base
     
     public function details(Request $request): string
     {
-        $id = $request->getParam('id')->getValue();
+        $id = $request->getRouteParameter('id');
         $product = $this->getProduct($id);
         
         if (!$product) {
@@ -470,40 +499,48 @@ class ProductController extends Base
 }
 ```
 
-### Request Parameter Validation
+### Request Validation with DTOs
 
-Define parameters in YAML:
+Define request DTOs in YAML:
 
 ```yaml
 # config/requests/product_create.yaml
-parameters:
-  name:
-    type: string
-    required: true
-    min_length: 3
-    max_length: 100
-    
-  price:
-    type: currency
-    required: true
-    min_value: 0
-    
-  category_id:
-    type: integer
-    required: true
-    
-  description:
-    type: string
-    required: false
-    max_length: 1000
+request:
+  method: POST
+  headers:
+    Content-Type: application/json
+  properties:
+    name:
+      type: string
+      required: true
+      length:
+        min: 3
+        max: 100
+
+    price:
+      type: currency
+      required: true
+      range:
+        min: 0
+
+    category_id:
+      type: integer
+      required: true
+
+    description:
+      type: string
+      required: false
+      length:
+        max: 1000
 ```
 
-Available parameter types:
+Available property types:
 - `string`, `integer`, `float`, `boolean`
 - `email`, `url`, `uuid`
-- `date`, `datetime`
-- `currency`, `phone_number`
+- `date`, `date_time`, `time`
+- `currency`, `us_phone_number`, `intl_phone_number`
 - `array`, `object`
+- `ip_address`, `ein`, `upc`, `name`, `numeric`
 
 ### Error Handling