Pull request #11: Feature/EOA-5906 SS Intellegence Cloude Api

Merge in SDK/node_telesign from feature/EOA-5906-SS-Intellegence-Cloude-Api to developer

Squashed commit of the following:

commit 1e473b82f3941ef1ed92daff8eaef1fbd6dc3baa
Author: Juan Camilo Martinez <jmartinez@telesign.com>
Date:   Mon Jan 19 14:52:00 2026 -0500

    Commit merge

commit dbfcaa15e3babd9d7973a02b3c0274059e55920b
Author: MousumiMohanty <@telesign.com>
Date:   Thu Dec 4 22:21:19 2025 +0530

    revertback the detect endpoint

commit d089c276f98d2a2ab2efd6a79c28903611e6c2e4
Author: MousumiMohanty <@telesign.com>
Date:   Thu Dec 4 21:59:51 2025 +0530

    updated the comments

commit 4753210b7fa188a4f397f1a2dc203e065191431f
Author: MousumiMohanty <@telesign.com>
Date:   Thu Dec 4 16:40:07 2025 +0530

    updated with the comments

commit 758578296e317d1323f1f7a13ca02ceaa7861947
Author: MousumiMohanty <@telesign.com>
Date:   Wed Dec 3 16:48:38 2025 +0530

    updated the comments

commit 6e21a3dd45b71be9b2d8a9a20ec8b986dece977a
Author: MousumiMohanty <@telesign.com>
Date:   Wed Dec 3 10:45:56 2025 +0530

    added support for  Intelligence Cloud in Node SDKs

commit 045906f956749c1025b1a937a614008e16bdfc14
Author: MousumiMohanty <@telesign.com>
Date:   Tue Dec 2 19:16:35 2025 +0530

    Initial PR

Author: mmohanty-telesign

RELEASE.md

@@ -1,3 +1,7 @@
+4.0.0
+
+- Added support for Intelligence Cloud to use new endpoint.
+
 3.0.4
 
 - Added support for PATCH to the Telesign RestClient.

examples/intelligence/1_get_risk_score_and_related_insights.js

@@ -1,32 +1,39 @@
-// note change this to the following if using npm package: require('telesignsdk);
 const TeleSignSDK = require('../../src/TeleSign');
-//var TeleSignSDK = require('telesignsdk');
 
-const customerId = "customer_id"; // Todo: find in portal.telesign.com
-const apiKey = "dGVzdCBhcGkga2V5IGZvciBzZGsgZXhhbXBsZXM="; // Todo: find in portal.telesign.com
-const rest_endpoint = "https://rest-api.telesign.com"; // Todo: Enterprise customer, change this!
-const timeout = 10*1000; // 10 secs
+const customerId = "FFFFFFFF-EEEE-DDDD-1234-AB1234567890";
+const apiKey = "ABC12345yusumoN6BYsBVkh+yRJ5czgsnCehZaOYldPJdmFh6NeX8kunZ2zU1YWaUw/0wV6xfw==";
+const detectEndpoint = "https://detect.telesign.com";
+const timeout = 10*1000;
 
-const client = new TeleSignSDK( customerId,
-    apiKey,
-    rest_endpoint,
-    timeout // optional
-    // userAgent
-);
+const client = new TeleSignSDK(customerId, apiKey, detectEndpoint, timeout);
 
-const phoneNumber = "phone_number";
-const accountLifeCycleEvent = "create";
+const phoneNumber = "11234567890";
+const accountLifecycleEvent = "create";  
 
 console.log("## ScoreClient.score ##");
 
 function score_callback(error, response_body) {
-    if (error === null) {
-        console.log(`Score response for phone number: ${phoneNumber}` +
-            ` => code: ${response_body['status']['code']}` +
-            `, description: ${response_body['status']['description']}`);
-    } else {
-        console.error("Unable to get score. " + error);
+  if (error === null) {
+    console.log(`Score response for phone number: ${phoneNumber} => code: ${response_body['status']['code']}, description: ${response_body['status']['description']}`);
+
+    if (response_body['status']['code'] === 300) {
+      const riskLevel = response_body.risk?.level || "unknown";
+      const recommendation = response_body.risk?.recommendation || "no recommendation";
+      console.log(`SUCCESS! Phone number ${phoneNumber} risk level: ${riskLevel}, recommendation: ${recommendation}`);
+      
+      console.log("Full response:", JSON.stringify(response_body, null, 2));
+    } else if (response_body['status']['code'] === 301) {
+      console.log("PARTIAL SUCCESS - Some data available:", JSON.stringify(response_body, null, 2));
     }
+  } else {
+    console.error("Unable to get score. Error:", error);
+  }
 }
 
-client.score.score(score_callback, phoneNumber, accountLifeCycleEvent);
+client.score.score(score_callback, phoneNumber, accountLifecycleEvent, {
+  accountId: "account-123",
+  deviceId: "device-456",
+  emailAddress: "user@example.com",
+  externalId: "external-789",
+  originatingIp: "192.0.2.1"
+});

examples/score/1_check_phone_risk_level.js

@@ -1,7 +1,7 @@
 {
   "name": "telesignsdk",
-  "version": "3.0.4",
-  "description": "Official TeleSign SDK for Rest APIs including Messaging (SMS), Score, PhoneID, Voice, and AppVerify",
+  "version": "4.0.0",
+  "description": "Official TeleSign SDK for Rest APIs including Messaging (SMS), Intelligence Cloud, PhoneID, Voice, and AppVerify",
   "repository": {
     "type": "git",
     "url": "https://github.com/TeleSign/node_telesign"

package.json

@@ -1,68 +1,46 @@
 const RestClient = require('./RestClient.js');
 
 /***
- * Score provides risk information about a specified phone number.
+ * ScoreClient for TeleSign Intelligence Cloud.
+ * Supports POST /intelligence/phone endpoint(Cloud migration).
  */
 class ScoreClient extends RestClient {
-    constructor(requestWrapper,
-                customerId,
-                apiKey,
-                restEndpoint = null,
-                timeout = 15000,
-                userAgent = null) {
+  constructor(requestWrapper,
+              customerId,
+              apiKey,
+              restEndpoint = "https://detect.telesign.com",
+              timeout = 15000,
+              userAgent = null) {
+    super(requestWrapper, customerId, apiKey, restEndpoint, timeout, userAgent);
+    this.scoreResource = "/intelligence/phone";
+    this.setContentType("application/x-www-form-urlencoded");
+  }
+/**
+* Obtain a risk recommendation for a phone number using Telesign Intelligence Cloud API.
+*
+* @param callback Callback handling the response
+* @param phoneNumber Phone number to check (digits-only E.164 format)
+* @param accountLifecycleEvent Required lifecycle event string: 'create', 'sign-in', etc.
+* @param options Optional object for additional parameters:
+*    accountId, deviceId, emailAddress, externalId, originatingIp, etc.
+*/
+  score(callback,
+        phoneNumber,
+        accountLifecycleEvent,
+        options = {}) {
+    const params = {
+      phone_number: phoneNumber,
+      account_lifecycle_event: accountLifecycleEvent,
+      ...(options.accountId && { account_id: options.accountId }),
+      ...(options.deviceId && { device_id: options.deviceId }),
+      ...(options.emailAddress && { email_address: options.emailAddress }),
+      ...(options.externalId && { external_id: options.externalId }),
+      ...(options.originatingIp && { originating_ip: options.originatingIp }),
+    };
 
-        super(requestWrapper, customerId, apiKey, restEndpoint, timeout, userAgent);
-
-        this.scoreResource = "/v1/score/";
-    }
-
-    /***
-     * 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.
-     *
-     * @param callback: Callback method to handle response.
-     * @param phoneNumber: Phone number for which to check score
-     * @param accountLifecycleEvent: Indicate what phase of the lifecycle you are in when you
-     * send a transaction.
-     * @param originatingIP: (Optional) End user's IP address.
-     * @param deviceId: (Optional) End user’s device identifier.
-     * @param accountId: (Optional) End user’s account id
-     * @param emailAddress: (Optional) End user’s email address
-     * @param requestRiskInsights: (Optional) Boolean value of true, false or null for reason codes
-     *                              ONLY SET IF Score 2.0 requests is enabled, confirm with your Telesign representative
-     */
-    score(callback,
-          phoneNumber,
-          accountLifecycleEvent,
-          originatingIP = null,
-          deviceId = null,
-          accountId = null,
-          emailAddress = null,
-          requestRiskInsights = null) {
-
-        var params = {
-            account_lifecycle_event: accountLifecycleEvent
-        };
-        if (originatingIP != null) {
-            params.originating_ip = originatingIP;
-        }
-        if (deviceId != null) {
-            params.device_id = deviceId;
-        }
-        if (accountId != null) {
-            params.account_id = accountId;
-        }
-        if (emailAddress != null) {
-            params.email_address = emailAddress;
-        }
-        if (requestRiskInsights != null) {
-            params.request_risk_insights = requestRiskInsights;
-        }
-
-        this.execute(callback, "POST", this.scoreResource + encodeURI(phoneNumber), params);
-    }
+    this.execute(callback, "POST", this.scoreResource, params);
+  }
+          
 }
-
+        
 module.exports = ScoreClient;

src/IntelligenceClient.js

@@ -4,8 +4,8 @@ const ScoreClient = require('./ScoreClient.js');
 const PhoneIDClient = require('./PhoneIDClient.js');
 const VoiceClient = require('./VoiceClient.js');
 const AppVerifyClient = require('./AppVerifyClient.js');
-const IntelligenceClient = require('./IntelligenceClient.js');
-const { FetchRequestWrapper } = require('./RequestWrapper')
+const { FetchRequestWrapper } = require('./RequestWrapper');
+const detectEndpoint = "https://detect.telesign.com";
 
 module.exports = class TeleSign {
     constructor(customerId,
@@ -21,9 +21,8 @@ module.exports = class TeleSign {
         this.rest = new RestClient(requestWrapper, customerId, apiKey, restEndpoint, timeout, useragent, source, sdkVersionOrigin, sdkVersionDependency);
         this.sms = new MessagingClient(requestWrapper, customerId, apiKey, restEndpoint, timeout, useragent);
         this.voice = new VoiceClient(requestWrapper, customerId, apiKey, restEndpoint, timeout, useragent);
-        this.score = new ScoreClient(requestWrapper, customerId, apiKey, restEndpoint, timeout, useragent);
+        this.score = new ScoreClient(requestWrapper, customerId, apiKey, detectEndpoint, timeout, useragent);
         this.phoneid = new PhoneIDClient(requestWrapper, customerId, apiKey, restEndpoint, timeout, useragent);
         this.appverify = new AppVerifyClient(requestWrapper, customerId, apiKey, restEndpoint, timeout, useragent);
-        this.intelligence = new IntelligenceClient(requestWrapper, customerId, apiKey, restEndpoint, timeout, useragent);
     }
 };