Pull request #25: Feature/EOA-5903 SS Intellegence

Merge in SDK/php_telesign from feature/EOA-5903-SS-Intellegence to developer

Squashed commit of the following:

commit 4b2de55a789441090168e0a23f4992a70ce255c5
Merge: 7a95ab1 b7c3190
Author: Juan Camilo Martinez <jmartinez@telesign.com>
Date:   Thu Jan 15 10:43:39 2026 -0500

    Solve issues merge

commit 7a95ab10cb538f530060d80207f5730dd0c4523e
Author: MousumiMohanty <@telesign.com>
Date:   Thu Oct 23 16:09:37 2025 +0530

    update the release file

commit 94efe5beb37d9d7eca4fc91bd118362891c74cf6
Author: MousumiMohanty <@telesign.com>
Date:   Thu Oct 23 13:36:03 2025 +0530

    Added support for Intelligence Cloud to use new endpoint

commit 48f47b8
Author: Mousumi Mohanty <mmohanty@telesign.com>
Date:   Fri Oct 24 08:45:14 2025 +0000

    Pull request #24: feature/EOA-5599-Update-psr-http-message

    Merge in SDK/php_telesign from feature/EOA-5599-Update-psr-http-message to developer

    Squashed commit of the following:

    commit 4be027844b6387198dfd547374363f32da1e4687
    Author: MousumiMohanty <@telesign.com>
    Date:   Thu Oct 23 15:46:05 2025 +0530

        Updated psr/http-message dependency to allow both v1 and v2

Author: mmohanty-telesign

RELEASE

@@ -1,8 +1,11 @@
+5.0.0
+- Added support for Intelligence Cloud to use new endpoint
+
 4.0.2
 - Added config.php to Composer’s autoload classmap to prevent file-loading errors on case-sensitive systems, while maintaining compatibility with existing integrations.
 
 4.0.1
-- Updated psr/http-message dependency to allow both v1 and v2
+- Updated psr/http-message dependency to allow both v1 and v2 
 
 4.0.0
 - Removed all functionality and methods for App Verify SDK

examples/score/1_check_phone_number_risk_level.php

@@ -5,15 +5,20 @@
 use telesign\sdk\score\ScoreClient;
 
 $customer_id = "FFFFFFFF-EEEE-DDDD-1234-AB1234567890";
-$api_key = "EXAMPLE----TE8sTgg45yusumoN6BYsBVkh+yRJ5czgsnCehZaOYldPJdmFh6NeX8kunZ2zU1YWaUw/0wV6xfw==";
+$api_key = "ABC12345yusumoN6BYsBVkh+yRJ5czgsnCehZaOYldPJdmFh6NeX8kunZ2zU1YWaUw/0wV6xfw==";
 
 $phone_number = "phone_number";
 $account_lifecycle_event = "create";
 
-$data = new ScoreClient($customer_id, $api_key);
-$response = $data->score($phone_number, $account_lifecycle_event);
+$scoreClient = new ScoreClient($customer_id, $api_key);
+$response = $scoreClient->score($phone_number, $account_lifecycle_event);
 
 if ($response->ok) {
-  echo "Phone number $phone_number has a '{$response->json["risk"]["level"]}' risk level"
-  . " and the recommendation is to '{$response->json["risk"]["recommendation"]}' the transaction.";
+    echo "Phone number {$phone_number} has a '{$response->json['risk']['level']}' risk level"
+         . " and the recommendation is to '{$response->json['risk']['recommendation']}' the transaction.";
+} else {
+    echo "Request failed with status code: {$response->status_code}";
+    if ($response->json !== null) {
+        echo "\nError details: " . json_encode($response->json);
+    }
 }

src/score/ScoreClient.php

@@ -5,22 +5,53 @@
 use telesign\sdk\rest\RestClient;
 
 /**
- * Score provides risk information about a specified phone number.
+ * ScoreClient for TeleSign Intelligence Cloud.
+ * Supports POST /intelligence/phone endpoint only (Cloud migration).
+ * Sends phone number and parameters in the request body encoded as application/x-www-form-urlencoded.
+ * See https://developer.telesign.com/enterprise/docs/intelligence-cloud-get-started for documentation.
  */
-class ScoreClient extends RestClient {
-
-  const SCORE_RESOURCE = "/v1/score/%s";
-
-  /**
-   * Score is an API that delivers reputation scoring based on phone number intelligence, traffic patterns, machine
-   * learning, and a global data consortium.
-   *
-   * See https://developer.telesign.com/docs/score-api for detailed API documentation.
-   */
-  function score ($phone_number, $account_lifecycle_event, array $other = []) {
-    return $this->post(sprintf(self::SCORE_RESOURCE, $phone_number), array_merge($other, [
-      "account_lifecycle_event" => $account_lifecycle_event
-    ]));
-  }
-
-}
+class ScoreClient extends RestClient
+{
+    const DETECT_HOST = "https://detect.telesign.com";
+    const INTELLIGENCE_RESOURCE = "/intelligence/phone";
+
+    public function __construct($customer_id, $api_key, $rest_endpoint = self::DETECT_HOST)
+    {
+        parent::__construct($customer_id, $api_key, $rest_endpoint);
+    }
+
+    /**
+     * Obtain a risk recommendation for a phone number using Telesign Intelligence Cloud API.
+     * Required parameters:
+     *   - phone_number
+     *   - account_lifecycle_event ("create", "sign-in", "transact", "update", "delete")
+     * Optional parameters include account_id, device_id, email_address, external_id, originating_ip.
+     * API: POST https://detect.telesign.com/intelligence/phone
+     * 
+     * See https://developer.telesign.com/enterprise/reference/submitphonenumberforintelligencecloud for detailed API documentation.
+     */
+    public function score($phone_number, $account_lifecycle_event, array $optional = [])
+    {
+        if (empty($phone_number)) {
+            throw new \InvalidArgumentException("phone_number cannot be null or empty");
+        }
+
+        if (empty($account_lifecycle_event)) {
+            throw new \InvalidArgumentException("account_lifecycle_event cannot be null or empty");
+        }
+
+        $params = array_merge($optional, [
+            "phone_number" => $phone_number,
+            "account_lifecycle_event" => $account_lifecycle_event
+        ]);
+
+        return $this->post(
+            self::INTELLIGENCE_RESOURCE,
+            $params,
+            null,
+            null,
+            "application/x-www-form-urlencoded",
+            "HMAC-SHA256"
+        );
+    }
+}

test/score/ScoreClientTest.php

@@ -5,28 +5,30 @@
 use telesign\sdk\Example;
 use telesign\sdk\ClientTest;
 
-final class ScoreClientTest extends ClientTest {
-
+final class ScoreClientTest extends ClientTest
+{
   const EXAMPLE_PHONE_NUMBER = Example::PHONE_NUMBER;
   const EXAMPLE_ACCOUNT_LIFECYCLE_EVENT = Example::ACCOUNT_LIFECYCLE_EVENT;
 
-  function getRequestExamples () {
-    return [
+  function getRequestExamples()
+  {
+    return 
+    [
       [
         ScoreClient::class,
         "score",
-        [
-          self::EXAMPLE_PHONE_NUMBER,
-          self::EXAMPLE_ACCOUNT_LIFECYCLE_EVENT,
-          [ "optional_param" => "123" ]
-        ],
-        self::EXAMPLE_REST_ENDPOINT . "/v1/score/" . self::EXAMPLE_PHONE_NUMBER,
-        [
-          "account_lifecycle_event" => self::EXAMPLE_ACCOUNT_LIFECYCLE_EVENT,
-          "optional_param" => "123"
+          [
+            self::EXAMPLE_PHONE_NUMBER,
+            self::EXAMPLE_ACCOUNT_LIFECYCLE_EVENT,
+            [ "optional_param" => "123" ]
+          ],
+          self::EXAMPLE_REST_ENDPOINT . "/intelligence/phone", 
+          [
+            "phone_number" => self::EXAMPLE_PHONE_NUMBER,      
+            "account_lifecycle_event" => self::EXAMPLE_ACCOUNT_LIFECYCLE_EVENT,
+            "optional_param" => "123"
+          ]
         ]
-      ]
-    ];
-  }
-
+      ];
+    }
 }