From 9fde7704e7d350b2aa4a4899e5f7bf175d51f0a2 Mon Sep 17 00:00:00 2001
From: Enan54 <enan@spaceship.com.sg>
Date: Thu, 12 Sep 2024 10:11:52 +0600
Subject: [PATCH] Add new option to get the user success rate

---
 README.md                                     | 25 ++++++++++-----
 src/APIBase/PathaoBaseAPI.php                 |  9 ++++--
 src/APIBase/PathaoUserSuccess.php             | 32 +++++++++++++++++++
 src/DataDTO/PathaoOrderDTO.php                |  8 +++++
 src/PathaoCourier.php                         | 18 +++++++++++
 src/Requests/PathaoUserSuccessRateRequest.php | 19 +++++++++++
 6 files changed, 101 insertions(+), 10 deletions(-)
 create mode 100644 src/APIBase/PathaoUserSuccess.php
 create mode 100644 src/Requests/PathaoUserSuccessRateRequest.php

diff --git a/README.md b/README.md
index 44b64e3..5047cdc 100644
--- a/README.md
+++ b/README.md
@@ -12,14 +12,15 @@
 A complete package for Laravel to use [Pathao Courier Merchant API](https://merchant.pathao.com/). Setup once and forget about it. You don’t even have to worry about the validation of creating orders, creating a store, or getting calculated price value which are generally a POST request on the Pathao courier end. <br>
 With this package you can get the following
 
-- [x] Get the city list
-- [x] Get the zone list
-- [x] Get the area list
-- [x] Get the store list
-- [x] Create Store
-- [x] Get order details
-- [x] Get calculated price
-- [x] Get the token exipiration days left and also expected date of it
+-   [x] Get the city list
+-   [x] Get the zone list
+-   [x] Get the area list
+-   [x] Get the store list
+-   [x] Create Store
+-   [x] Get order details
+-   [x] Get calculated price
+-   [x] Get the token exipiration days left and also expected date of it
+-   [x] Get the user success rate using phone number ![New](https://img.shields.io/badge/New-brightgreen)
 
 It offers you a bunch of validation for Create order, Create Store, Get calculated price.So you don't have to worry about the validation for all of this.
 
@@ -194,6 +195,14 @@ PathaoCourier::GET_PRICE_CALCULATION($request);
  */
 PathaoCourier::VIEW_ORDER(string $consignment_id);
 
+
+/**
+ * To Get User's success rate using phone number
+ * @type <POST>
+ * @param string $phone
+ */
+PathaoCourier::GET_USER_SUCCESS_RATE($request);
+
 ```
 
 <!-- ## Testing
diff --git a/src/APIBase/PathaoBaseAPI.php b/src/APIBase/PathaoBaseAPI.php
index 4f740f6..6c4e8b4 100644
--- a/src/APIBase/PathaoBaseAPI.php
+++ b/src/APIBase/PathaoBaseAPI.php
@@ -17,6 +17,7 @@ class PathaoBaseAPI
 {
     // public string $base_url = config('pathao-courier.pathao_base_url');
     public string $base_url = 'https://api-hermes.pathao.com/';
+    public string $merchant_base_url = 'https://merchant.pathao.com/';
 
     public $secret_token;
     public $table_name;
@@ -83,13 +84,17 @@ protected function setHeaders(bool $auth = false)
      * @param mixed $data
      * @return array
      */
-    public function Pathao_API_Response(bool $auth = false, string $api, string $method, ?array $data = [])
+    public function Pathao_API_Response(bool $auth = false, string $api, string $method, ?array $data = [], ?bool $merchant = false)
     {
         $response = ['data' => [], 'status' => Response::HTTP_OK];
 
         try {
             $httpClient = Http::timeout(100)->withHeaders($this->setHeaders($auth));
-            $httpUrl = $this->base_url . $api;
+            if ($merchant) {
+                $httpUrl = $this->merchant_base_url . $api;
+            } else {
+                $httpUrl = $this->base_url . $api;
+            }
             if ($method === Request::METHOD_GET) {
                 $pathaoResponse = $httpClient->get($httpUrl, null);
             } else {
diff --git a/src/APIBase/PathaoUserSuccess.php b/src/APIBase/PathaoUserSuccess.php
new file mode 100644
index 0000000..ed58aaa
--- /dev/null
+++ b/src/APIBase/PathaoUserSuccess.php
@@ -0,0 +1,32 @@
+<?php
+
+
+namespace Enan\PathaoCourier\APIBase;
+
+
+use Illuminate\Support\Arr;
+use Enan\PathaoCourier\APIBase\PathaoBaseAPI;
+use Symfony\Component\HttpFoundation\Request;
+use Enan\PathaoCourier\Services\DataServiceOutput;
+
+
+class PathaoUserSuccess extends PathaoBaseAPI
+{
+    /**
+     * Get User Success Rate
+     *
+     * @return mixed
+     */
+    public function get_user_success_rate(array $data)
+    {
+        $url = "api/v1/user/success";
+        $API_response = $this->Pathao_API_Response(true, $url, Request::METHOD_POST, $data, true);
+
+        $data = Arr::get($API_response, 'data.data') ?: [];
+        $message = Arr::get($API_response, 'data.message') ?: null;
+        $is_success = $this->isSuccessfulResponse(Arr::get($API_response, 'status'));
+        $status_code = Arr::get($API_response, 'data.code') ?: [];
+
+        return new DataServiceOutput($data, $message, $is_success, $status_code);
+    }
+}
diff --git a/src/DataDTO/PathaoOrderDTO.php b/src/DataDTO/PathaoOrderDTO.php
index 3987976..8bd19f6 100644
--- a/src/DataDTO/PathaoOrderDTO.php
+++ b/src/DataDTO/PathaoOrderDTO.php
@@ -5,6 +5,7 @@
 
 
 use Enan\PathaoCourier\Requests\PathaoOrderRequest;
+use Enan\PathaoCourier\Requests\PathaoUserSuccessRateRequest;
 use Enan\PathaoCourier\Requests\PathaoOrderPriceCalculationRequest;
 
 
@@ -44,4 +45,11 @@ public function fromPriceCalculationRequest(PathaoOrderPriceCalculationRequest $
             "store_id" => $request['store_id'],
         ];
     }
+
+    public function fromUserSuccessRate(PathaoUserSuccessRateRequest $request)
+    {
+        return [
+            "phone" => $request['phone'],
+        ];
+    }
 }
diff --git a/src/PathaoCourier.php b/src/PathaoCourier.php
index 4089f98..3a72ca0 100644
--- a/src/PathaoCourier.php
+++ b/src/PathaoCourier.php
@@ -9,10 +9,12 @@
 use Enan\PathaoCourier\APIBase\PathaoOrder;
 use Enan\PathaoCourier\APIBase\PathaoStore;
 use Enan\PathaoCourier\DataDTO\PathaoOrderDTO;
+use Enan\PathaoCourier\APIBase\PathaoUserSuccess;
 use Enan\PathaoCourier\DataDTO\PathaoStoreDataDTO;
 use Enan\PathaoCourier\Requests\PathaoOrderRequest;
 use Enan\PathaoCourier\Requests\PathaoStoreRequest;
 use Enan\PathaoCourier\Services\StandardResponseService;
+use Enan\PathaoCourier\Requests\PathaoUserSuccessRateRequest;
 use Enan\PathaoCourier\Requests\PathaoOrderPriceCalculationRequest;
 
 class PathaoCourier
@@ -165,4 +167,20 @@ public function GET_PRICE_CALCULATION(PathaoOrderPriceCalculationRequest $reques
         $priceCalculationDTO = (new PathaoOrderDTO)->fromPriceCalculationRequest($request);
         return StandardResponseService::RESPONSE_OUTPUT((new PathaoOrder)->price_calculation($priceCalculationDTO));
     }
+
+    /**
+     * Usage: PathaoCourier::GET_USER_SUCCESS_RATE($request)
+     * 
+     * This will return the users success rate using a phone number
+     * @param \Enan\PathaoCourier\Requests\PathaoUserSuccessRateRequest $request
+     *
+     * Request parameters are below and will follow a validation
+     * @param $phone <required, numeric>
+     * @return array
+     */
+    public function GET_USER_SUCCESS_RATE(PathaoUserSuccessRateRequest $request)
+    {
+        $data = (new PathaoOrderDTO)->fromUserSuccessRate($request);
+        return StandardResponseService::RESPONSE_OUTPUT((new PathaoUserSuccess)->get_user_success_rate($data));
+    }
 }
diff --git a/src/Requests/PathaoUserSuccessRateRequest.php b/src/Requests/PathaoUserSuccessRateRequest.php
new file mode 100644
index 0000000..02393e6
--- /dev/null
+++ b/src/Requests/PathaoUserSuccessRateRequest.php
@@ -0,0 +1,19 @@
+<?php
+
+
+namespace Enan\PathaoCourier\Requests;
+
+
+class PathaoUserSuccessRateRequest extends BasePathaoRequest
+{
+    public function rules()
+    {
+        return [
+            'phone' => [
+                'required',
+                'string',
+                'regex:/^(?:\+880|880|01[3-9])\d{8}$/'
+            ],
+        ];
+    }
+}