feat(trait): ✨ 新增422與401狀況的builder

Author: hankz1108

src/Traits/ApiResponse.php

@@ -4,6 +4,7 @@
 
 use Hankz\LaravelPlusApi\Classes\ApiResponseBuilder;
 use Illuminate\Http\JsonResponse;
+use Illuminate\Validation\ValidationException;
 
 trait ApiResponse
 {
@@ -37,21 +38,52 @@ public static function success(
      * Builds error Response object. Supports optional arguments passed to Lang::get() if associated error
      * message uses placeholders as well as return data payload.
      *
-     * @param string      $apiCode  your API code to be returned with the response object
-     * @param string|null $message  error message
-     * @param int|null    $httpCode HTTP code to be used for HttpResponse sent or @null
-     *                              for default DEFAULT_HTTP_CODE_ERROR
-     * @param int|null    $headers  Http Header
+     * @param string            $apiCode  your API code to be returned with the response object
+     * @param string|null       $message  error message
+     * @param int|null          $httpCode HTTP code to be used for HttpResponse sent or @null
+     *                                    for default DEFAULT_HTTP_CODE_ERROR
+     * @param object|array|null $data     array of primitives and supported objects to be returned in 'data' node
+     * @param int|null          $headers  Http Header
      */
     public static function error(
         string $apiCode,
-        string $message = null,
         int $httpCode = null,
+        string $message = null,
+        $data = null,
         array $headers = null
     ): JsonResponse {
         return ApiResponseBuilder::asError($apiCode)
             ->withMessage($message)
             ->withHttpCode($httpCode)
+            ->withData($data)
+            ->withHttpHeaders($headers)
+            ->build();
+    }
+
+    /**
+     * return validation error response.
+     */
+    public static function validationError(ValidationException $e): JsonResponse
+    {
+        return ApiResponseBuilder::asError(config('plus-api.default_response.validation_fail.api_code'))
+            ->withErrors($e->errors())
+            ->withHttpCode($e->status)
+            ->build();
+    }
+
+    public static function exceptionError(
+        array $debug_data = null,
+        string $apiCode = null,
+        int $httpCode,
+        string $message = null,
+        array $headers = []
+    ): JsonResponse {
+        $apiCode = $apiCode ?? config('plus-api.default_response.error.api_code');
+
+        return ApiResponseBuilder::asError($apiCode)
+            ->withDebugData($debug_data)
+            ->withHttpCode($httpCode)
+            ->withMessage($message)
             ->withHttpHeaders($headers)
             ->build();
     }