perimeterx-js-core 0.24.0 → 0.24.1

package/lib/cjs/context/DefaultContext.js

@@ -48,6 +48,7 @@ var DefaultContext = /** @class */ (function () {
         if (!this.isMobile) {
             this.setCookiesOnContext();
         }
+        this.shouldSendTelemetry = false;
     }
     Object.defineProperty(DefaultContext.prototype, "isMobile", {
         get: function () {
@@ -165,6 +166,7 @@ var DefaultContext = /** @class */ (function () {
             enforcerStartTime: this.enforcerStartTime,
             blockAction: this.blockAction,
             pxdeVerified: this.pxdeVerified,
+            shouldSendTelemetry: this.shouldSendTelemetry,
             logger: this.shouldSendLogs
                 ? {
                     logs: this.logger.getLogs(),

package/lib/cjs/context/SerializedContext.js

@@ -43,6 +43,7 @@ var SerializedContext = /** @class */ (function () {
         this.graphqlData = contextJson.graphqlData;
         this.enforcerStartTime = contextJson.enforcerStartTime;
         this.blockAction = contextJson.blockAction;
+        this.shouldSendTelemetry = contextJson.shouldSendTelemetry;
     }
     SerializedContext.prototype.createRequestData = function (_a, request, urlUtils) {
         var requestData = _a.requestData;

package/lib/cjs/phase/flow/EndEnforcerFlow.js

@@ -17,16 +17,16 @@ var __extends = (this && this.__extends) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EndEnforcerFlow = void 0;
 var impl_1 = require("../impl");
-var ClearLogsPhase_1 = require("../impl/ClearLogsPhase");
+var impl_2 = require("../impl");
 var EndEnforcerFlow = /** @class */ (function (_super) {
     __extends(EndEnforcerFlow, _super);
     function EndEnforcerFlow(config, _a) {
-        var logServiceClient = _a.logServiceClient;
-        var phases = [];
+        var logServiceClient = _a.logServiceClient, telemetry = _a.telemetry;
+        var phases = [new impl_2.SendTelemetryActivityPhase(telemetry)];
         if (logServiceClient) {
             phases.push(new impl_1.SendLogsPhase(config, logServiceClient));
         }
-        phases.push(new ClearLogsPhase_1.ClearLogsPhase());
+        phases.push(new impl_2.ClearLogsPhase());
         return _super.call(this, phases) || this;
     }
     return EndEnforcerFlow;

package/lib/cjs/phase/flow/FilterFlow.js

@@ -33,7 +33,7 @@ var FilterFlow = /** @class */ (function (_super) {
             phases.push(new impl_1.FilterPhase(filterProducts));
         }
         phases.push(new impl_1.PreflightPhase(config, cors));
-        phases.push(new impl_1.TelemetryPhase(telemetry));
+        phases.push(new impl_1.IdentifyTelemetryRequestPhase(telemetry));
         if (remoteConfigUpdater) {
             var updateRemoteConfigPhase = new impl_1.UpdateRemoteConfigPhase(config, remoteConfigUpdater);
             phases.push(updateRemoteConfigPhase);

package/lib/cjs/phase/impl/IdentifyTelemetryRequestPhase.js

@@ -0,0 +1,61 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IdentifyTelemetryRequestPhase = void 0;
+var IdentifyTelemetryRequestPhase = /** @class */ (function () {
+    function IdentifyTelemetryRequestPhase(telemetry) {
+        this.telemetry = telemetry;
+    }
+    IdentifyTelemetryRequestPhase.prototype.execute = function (context) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.telemetry.isValidTelemetryRequest(context)];
+                    case 1:
+                        if (_a.sent()) {
+                            context.shouldSendTelemetry = true;
+                            return [2 /*return*/, { done: true }];
+                        }
+                        return [2 /*return*/, { done: false }];
+                }
+            });
+        });
+    };
+    return IdentifyTelemetryRequestPhase;
+}());
+exports.IdentifyTelemetryRequestPhase = IdentifyTelemetryRequestPhase;

package/lib/cjs/phase/impl/RiskApiPhase.js

@@ -129,6 +129,7 @@ var RiskApiPhase = /** @class */ (function (_super) {
             uuid: 'uuid',
             action: 'blockAction',
             dataEnrichment: 'pxde',
+            telemetryRequested: 'shouldSendTelemetry',
         });
         if (riskResponse.dataEnrichment) {
             context.pxdeVerified = true;

package/lib/cjs/phase/impl/{TelemetryPhase.js → SendTelemetryActivityPhase.js}

@@ -36,29 +36,28 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
     }
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TelemetryPhase = void 0;
-var TelemetryPhase = /** @class */ (function () {
-    function TelemetryPhase(telemetry) {
+exports.SendTelemetryActivityPhase = void 0;
+var SendTelemetryActivityPhase = /** @class */ (function () {
+    function SendTelemetryActivityPhase(telemetry) {
         this.telemetry = telemetry;
     }
-    TelemetryPhase.prototype.execute = function (context) {
+    SendTelemetryActivityPhase.prototype.execute = function (context) {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
                 switch (_a.label) {
-                    case 0: return [4 /*yield*/, this.telemetry.isValidTelemetryRequest(context)];
+                    case 0:
+                        if (!context.shouldSendTelemetry) return [3 /*break*/, 2];
+                        return [4 /*yield*/, this.telemetry.sendTelemetry(context)];
                     case 1:
-                        if (!_a.sent()) return [3 /*break*/, 3];
-                        return [4 /*yield*/, this.sendTelemetry(context)];
-                    case 2:
                         _a.sent();
-                        return [2 /*return*/, { done: true }];
-                    case 3: return [2 /*return*/, { done: false }];
+                        _a.label = 2;
+                    case 2: return [2 /*return*/, { done: false }];
                 }
             });
         });
     };
     // Note: If await is not necessary, can be overridden
-    TelemetryPhase.prototype.sendTelemetry = function (context) {
+    SendTelemetryActivityPhase.prototype.sendTelemetry = function (context) {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
                 switch (_a.label) {
@@ -70,6 +69,6 @@ var TelemetryPhase = /** @class */ (function () {
             });
         });
     };
-    return TelemetryPhase;
+    return SendTelemetryActivityPhase;
 }());
-exports.TelemetryPhase = TelemetryPhase;
+exports.SendTelemetryActivityPhase = SendTelemetryActivityPhase;

package/lib/cjs/phase/impl/index.js

@@ -17,7 +17,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./FirstPartyPhase"), exports);
 __exportStar(require("./FilterPhase"), exports);
 __exportStar(require("./PreflightPhase"), exports);
-__exportStar(require("./TelemetryPhase"), exports);
 __exportStar(require("./EnrichContextFromRequestPhase"), exports);
 __exportStar(require("./ParseTokenPhase"), exports);
 __exportStar(require("./DecideActionPhase"), exports);
@@ -33,3 +32,5 @@ __exportStar(require("./CompositePhase"), exports);
 __exportStar(require("./SendLogsPhase"), exports);
 __exportStar(require(".//UpdateRemoteConfigPhase"), exports);
 __exportStar(require("./ClearLogsPhase"), exports);
+__exportStar(require("./IdentifyTelemetryRequestPhase"), exports);
+__exportStar(require("./SendTelemetryActivityPhase"), exports);

package/lib/cjs/risk_api/client/PostRiskApiClientBase.js

@@ -78,7 +78,7 @@ var PostRiskApiClientBase = /** @class */ (function () {
                     case 2:
                         response = _a.sent();
                         if (!((response === null || response === void 0 ? void 0 : response.status) !== 200)) return [3 /*break*/, 4];
-                        return [4 /*yield*/, this.handleS2SError(riskApiData, response)];
+                        return [4 /*yield*/, this.handleS2SError(riskApiData, context, response)];
                     case 3: return [2 /*return*/, _a.sent()];
                     case 4:
                         riskResponse = this.createRiskResponse(response);
@@ -86,7 +86,7 @@ var PostRiskApiClientBase = /** @class */ (function () {
                         return [4 /*yield*/, riskResponse.validate()];
                     case 5:
                         if (!!(_a.sent())) return [3 /*break*/, 7];
-                        return [4 /*yield*/, this.handleS2SError(riskApiData, response)];
+                        return [4 /*yield*/, this.handleS2SError(riskApiData, context, response)];
                     case 6: return [2 /*return*/, _a.sent()];
                     case 7:
                         context.logger.debug("received risk response, score: ".concat(riskResponse.score, ", rtt: ").concat(riskApiData.riskRtt));
@@ -97,7 +97,7 @@ var PostRiskApiClientBase = /** @class */ (function () {
                             return [2 /*return*/, this.handleS2STimeout(riskApiData)];
                         }
                         context.logger.error("caught error in risk api: ".concat(err_1, " - ").concat(JSON.stringify(context.requestData.url)));
-                        return [4 /*yield*/, this.handleS2SError(riskApiData, response, err_1)];
+                        return [4 /*yield*/, this.handleS2SError(riskApiData, context, response, err_1)];
                     case 9: return [2 /*return*/, _a.sent()];
                     case 10: return [2 /*return*/];
                 }
@@ -176,7 +176,7 @@ var PostRiskApiClientBase = /** @class */ (function () {
         riskApiData.riskApiCallResult = model_1.RiskApiCallResult.TIMEOUT;
         return riskApiData;
     };
-    PostRiskApiClientBase.prototype.handleS2SError = function (riskApiData, response, error) {
+    PostRiskApiClientBase.prototype.handleS2SError = function (riskApiData, context, response, error) {
         return __awaiter(this, void 0, void 0, function () {
             var _a, _b, _c, errorMessage, existingMessage;
             var _d, _e, _f;
@@ -222,6 +222,7 @@ var PostRiskApiClientBase = /** @class */ (function () {
                             existingMessage = riskApiData.errorMessage;
                             riskApiData.errorMessage = existingMessage ? "".concat(existingMessage, ", ").concat(errorMessage) : errorMessage;
                         }
+                        context.logger.debug("S2S error message: ".concat(riskApiData.errorMessage));
                         return [2 /*return*/, riskApiData];
                 }
             });

package/lib/cjs/risk_api/risk_response/RiskResponseBase.js

@@ -126,6 +126,14 @@ var RiskResponseBase = /** @class */ (function () {
         enumerable: false,
         configurable: true
     });
+    Object.defineProperty(RiskResponseBase.prototype, "telemetryRequested", {
+        get: function () {
+            var _a;
+            return (_a = this.riskResponse) === null || _a === void 0 ? void 0 : _a.telemetry_requested;
+        },
+        enumerable: false,
+        configurable: true
+    });
     Object.defineProperty(RiskResponseBase.prototype, "drc", {
         get: function () {
             var _a;
@@ -145,6 +153,7 @@ var RiskResponseBase = /** @class */ (function () {
             score: this.score,
             drc: this.drc,
             additionalRiskInfo: this.additionalRiskInfo,
+            telemetryRequested: this.telemetryRequested,
             uuid: this.uuid,
         };
     };

package/lib/cjs/risk_api/risk_response/serialize/SerializedRiskResponse.js

@@ -5,6 +5,7 @@ var SerializedRiskResponse = /** @class */ (function () {
     function SerializedRiskResponse(riskResponseJson) {
         this.action = riskResponseJson.action;
         this.additionalRiskInfo = riskResponseJson.additionalRiskInfo;
+        this.telemetryRequested = riskResponseJson.telemetryRequested;
         this.dataEnrichment = riskResponseJson.dataEnrichment;
         this.drc = riskResponseJson.drc;
         this.message = riskResponseJson.message;

package/lib/cjs/utils/constants.js

@@ -14,4 +14,4 @@ exports.PUSH_DATA_FEATURE_HEADER_NAME = 'x-px-feature';
 exports.EMAIL_ADDRESS_REGEX = /^[a-zA-Z0-9_+&*-]+(?:\.[a-zA-Z0-9_+&*-]+)*@(?:[a-zA-Z0-9-]+\.)+[a-zA-Z]{2,7}$/;
 exports.URL_REGEX = /^(https?:)\/\/(([^@\s:\/]+):?([^@\s\/]*)@)?(([^:\/?#]*)(?:\:([0-9]+))?)(\/?[^?#]*)(\?[^#]*|)(#.*|)$/;
 exports.REGEX_STRUCTURE = /^\/(.+?)\/([gimsuyvd]*)$/;
-exports.CORE_MODULE_VERSION = 'JS Core 0.24.0';
+exports.CORE_MODULE_VERSION = 'JS Core 0.24.1';

package/lib/cjs/utils/request_id_generator/SimpleRequestIdGenerator.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SimpleRequestIdGenerator = void 0;
+var SimpleRequestIdGenerator = /** @class */ (function () {
+    function SimpleRequestIdGenerator(requestId) {
+        this.requestId = requestId;
+    }
+    SimpleRequestIdGenerator.prototype.generateRequestId = function () {
+        return this.requestId;
+    };
+    return SimpleRequestIdGenerator;
+}());
+exports.SimpleRequestIdGenerator = SimpleRequestIdGenerator;

package/lib/cjs/utils/request_id_generator/index.js

@@ -15,3 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./IRequestIdGenerator"), exports);
+__exportStar(require("./SimpleRequestIdGenerator"), exports);

package/lib/esm/context/DefaultContext.js

@@ -34,6 +34,7 @@ export class DefaultContext {
     enforcerStartTime;
     logger;
     usedCookieSecret;
+    shouldSendTelemetry;
     config;
     urlUtils;
     constructor(config, request, options) {
@@ -62,6 +63,7 @@ export class DefaultContext {
         if (!this.isMobile) {
             this.setCookiesOnContext();
         }
+        this.shouldSendTelemetry = false;
     }
     get isMobile() {
         return this.tokenOrigin === TokenOrigin.HEADER;
@@ -175,6 +177,7 @@ export class DefaultContext {
             enforcerStartTime: this.enforcerStartTime,
             blockAction: this.blockAction,
             pxdeVerified: this.pxdeVerified,
+            shouldSendTelemetry: this.shouldSendTelemetry,
             logger: this.shouldSendLogs
                 ? {
                     logs: this.logger.getLogs(),

package/lib/esm/context/SerializedContext.js

@@ -27,6 +27,7 @@ export class SerializedContext {
     vidSource;
     tokenOrigin;
     uuid;
+    shouldSendTelemetry;
     constructor(config, contextJson, request, urlUtils) {
         this.action = contextJson.action;
         this.reasons = contextJson.reasons;
@@ -53,6 +54,7 @@ export class SerializedContext {
         this.graphqlData = contextJson.graphqlData;
         this.enforcerStartTime = contextJson.enforcerStartTime;
         this.blockAction = contextJson.blockAction;
+        this.shouldSendTelemetry = contextJson.shouldSendTelemetry;
     }
     createRequestData({ requestData }, request, urlUtils) {
         return {

package/lib/esm/phase/flow/EndEnforcerFlow.js

@@ -1,8 +1,8 @@
 import { CompositePhase, SendLogsPhase } from '../impl';
-import { ClearLogsPhase } from '../impl/ClearLogsPhase';
+import { ClearLogsPhase, SendTelemetryActivityPhase } from '../impl';
 export class EndEnforcerFlow extends CompositePhase {
-    constructor(config, { logServiceClient }) {
-        const phases = [];
+    constructor(config, { logServiceClient, telemetry, }) {
+        const phases = [new SendTelemetryActivityPhase(telemetry)];
         if (logServiceClient) {
             phases.push(new SendLogsPhase(config, logServiceClient));
         }

package/lib/esm/phase/flow/FilterFlow.js

@@ -1,6 +1,6 @@
 import { ProductName } from '../../products';
 import { isNullOrUndefined } from '../../utils';
-import { CompositePhase, FilterPhase, FirstPartyPhase, PreflightPhase, TelemetryPhase, UpdateRemoteConfigPhase, } from '../impl';
+import { CompositePhase, FilterPhase, FirstPartyPhase, PreflightPhase, UpdateRemoteConfigPhase, IdentifyTelemetryRequestPhase, } from '../impl';
 export class FilterFlow extends CompositePhase {
     constructor(config, { httpClient, products, cors, telemetry, remoteConfigUpdater, }) {
         const phases = [];
@@ -13,7 +13,7 @@ export class FilterFlow extends CompositePhase {
             phases.push(new FilterPhase(filterProducts));
         }
         phases.push(new PreflightPhase(config, cors));
-        phases.push(new TelemetryPhase(telemetry));
+        phases.push(new IdentifyTelemetryRequestPhase(telemetry));
         if (remoteConfigUpdater) {
             const updateRemoteConfigPhase = new UpdateRemoteConfigPhase(config, remoteConfigUpdater);
             phases.push(updateRemoteConfigPhase);

package/lib/esm/phase/impl/IdentifyTelemetryRequestPhase.js

@@ -0,0 +1,13 @@
+export class IdentifyTelemetryRequestPhase {
+    telemetry;
+    constructor(telemetry) {
+        this.telemetry = telemetry;
+    }
+    async execute(context) {
+        if (await this.telemetry.isValidTelemetryRequest(context)) {
+            context.shouldSendTelemetry = true;
+            return { done: true };
+        }
+        return { done: false };
+    }
+}

package/lib/esm/phase/impl/RiskApiPhase.js

@@ -41,6 +41,7 @@ export class RiskApiPhase extends DecideActionPhase {
             uuid: 'uuid',
             action: 'blockAction',
             dataEnrichment: 'pxde',
+            telemetryRequested: 'shouldSendTelemetry',
         });
         if (riskResponse.dataEnrichment) {
             context.pxdeVerified = true;

package/lib/esm/phase/impl/{TelemetryPhase.js → SendTelemetryActivityPhase.js}

@@ -1,12 +1,11 @@
-export class TelemetryPhase {
+export class SendTelemetryActivityPhase {
     telemetry;
     constructor(telemetry) {
         this.telemetry = telemetry;
     }
     async execute(context) {
-        if (await this.telemetry.isValidTelemetryRequest(context)) {
-            await this.sendTelemetry(context);
-            return { done: true };
+        if (context.shouldSendTelemetry) {
+            await this.telemetry.sendTelemetry(context);
         }
         return { done: false };
     }

package/lib/esm/phase/impl/index.js

@@ -1,7 +1,6 @@
 export * from './FirstPartyPhase';
 export * from './FilterPhase';
 export * from './PreflightPhase';
-export * from './TelemetryPhase';
 export * from './EnrichContextFromRequestPhase';
 export * from './ParseTokenPhase';
 export * from './DecideActionPhase';
@@ -17,3 +16,5 @@ export * from './CompositePhase';
 export * from './SendLogsPhase';
 export * from './/UpdateRemoteConfigPhase';
 export * from './ClearLogsPhase';
+export * from './IdentifyTelemetryRequestPhase';
+export * from './SendTelemetryActivityPhase';

package/lib/esm/risk_api/client/PostRiskApiClientBase.js

@@ -23,12 +23,12 @@ export class PostRiskApiClientBase {
             const riskActivity = this.createRiskActivity(context);
             response = await this.sendRiskActivity(riskActivity, riskApiData, context);
             if (response?.status !== 200) {
-                return await this.handleS2SError(riskApiData, response);
+                return await this.handleS2SError(riskApiData, context, response);
             }
             riskResponse = this.createRiskResponse(response);
             riskApiData.riskResponse = riskResponse;
             if (!(await riskResponse.validate())) {
-                return await this.handleS2SError(riskApiData, response);
+                return await this.handleS2SError(riskApiData, context, response);
             }
             context.logger.debug(`received risk response, score: ${riskResponse.score}, rtt: ${riskApiData.riskRtt}`);
             return riskApiData;
@@ -38,7 +38,7 @@ export class PostRiskApiClientBase {
                 return this.handleS2STimeout(riskApiData);
             }
             context.logger.error(`caught error in risk api: ${err} - ${JSON.stringify(context.requestData.url)}`);
-            return await this.handleS2SError(riskApiData, response, err);
+            return await this.handleS2SError(riskApiData, context, response, err);
         }
     }
     /**
@@ -105,7 +105,7 @@ export class PostRiskApiClientBase {
         riskApiData.riskApiCallResult = RiskApiCallResult.TIMEOUT;
         return riskApiData;
     }
-    async handleS2SError(riskApiData, response, error) {
+    async handleS2SError(riskApiData, context, response, error) {
         riskApiData.riskApiCallResult = RiskApiCallResult.ERROR;
         riskApiData.errorReason = S2SErrorReason.UNKNOWN_ERROR;
         if (response) {
@@ -131,6 +131,7 @@ export class PostRiskApiClientBase {
             const existingMessage = riskApiData.errorMessage;
             riskApiData.errorMessage = existingMessage ? `${existingMessage}, ${errorMessage}` : errorMessage;
         }
+        context.logger.debug(`S2S error message: ${riskApiData.errorMessage}`);
         return riskApiData;
     }
 }

package/lib/esm/risk_api/risk_response/RiskResponseBase.js

@@ -38,6 +38,9 @@ export class RiskResponseBase {
     get additionalRiskInfo() {
         return this.riskResponse?.additional_risk_info;
     }
+    get telemetryRequested() {
+        return this.riskResponse?.telemetry_requested;
+    }
     get drc() {
         return this.riskResponse?.drc;
     }
@@ -52,6 +55,7 @@ export class RiskResponseBase {
             score: this.score,
             drc: this.drc,
             additionalRiskInfo: this.additionalRiskInfo,
+            telemetryRequested: this.telemetryRequested,
             uuid: this.uuid,
         };
     }

package/lib/esm/risk_api/risk_response/serialize/SerializedRiskResponse.js

@@ -1,6 +1,7 @@
 export class SerializedRiskResponse {
     action;
     additionalRiskInfo;
+    telemetryRequested;
     dataEnrichment;
     drc;
     message;
@@ -12,6 +13,7 @@ export class SerializedRiskResponse {
     constructor(riskResponseJson) {
         this.action = riskResponseJson.action;
         this.additionalRiskInfo = riskResponseJson.additionalRiskInfo;
+        this.telemetryRequested = riskResponseJson.telemetryRequested;
         this.dataEnrichment = riskResponseJson.dataEnrichment;
         this.drc = riskResponseJson.drc;
         this.message = riskResponseJson.message;

package/lib/esm/utils/constants.js

@@ -11,4 +11,4 @@ export const PUSH_DATA_FEATURE_HEADER_NAME = 'x-px-feature';
 export const EMAIL_ADDRESS_REGEX = /^[a-zA-Z0-9_+&*-]+(?:\.[a-zA-Z0-9_+&*-]+)*@(?:[a-zA-Z0-9-]+\.)+[a-zA-Z]{2,7}$/;
 export const URL_REGEX = /^(https?:)\/\/(([^@\s:\/]+):?([^@\s\/]*)@)?(([^:\/?#]*)(?:\:([0-9]+))?)(\/?[^?#]*)(\?[^#]*|)(#.*|)$/;
 export const REGEX_STRUCTURE = /^\/(.+?)\/([gimsuyvd]*)$/;
-export const CORE_MODULE_VERSION = 'JS Core 0.24.0';
+export const CORE_MODULE_VERSION = 'JS Core 0.24.1';

package/lib/esm/utils/request_id_generator/SimpleRequestIdGenerator.js

@@ -0,0 +1,9 @@
+export class SimpleRequestIdGenerator {
+    requestId;
+    constructor(requestId) {
+        this.requestId = requestId;
+    }
+    generateRequestId() {
+        return this.requestId;
+    }
+}

package/lib/esm/utils/request_id_generator/index.js

@@ -1 +1,2 @@
 export * from './IRequestIdGenerator';
+export * from './SimpleRequestIdGenerator';

package/lib/types/config/ConfigurationBuilderBase.d.ts

@@ -4,7 +4,7 @@ import { CoreConfigurationParams, StaticConfigurationParams, RemoteConfiguration
 import { IBase64Utils } from '../utils';
 export declare abstract class ConfigurationBuilderBase<Req, Res, Added, Removed, ParamsType extends CoreConfigurationParams<Req, Res, Added, Removed>, ConfigurationType extends IConfiguration<Req, Res, Added, Removed>> {
     protected readonly base64Utils: IBase64Utils;
-    protected abstract createRemoteConfigStorageClient(staticConfig: ConfigurationType): Promise<IRemoteConfigStorageClient<Req, Res, Added, Removed>>;
+    protected abstract createRemoteConfigStorageClient(staticConfig: ConfigurationType): Promise<IRemoteConfigStorageClient<Req, Res, Added, Removed> | null>;
     protected abstract createConfiguration(params: ParamsType | StaticConfigurationParams<Req, Res, Added, Removed>): ConfigurationType;
     protected constructor(base64Utils: IBase64Utils);
     build(params: StaticConfigurationParams<Req, Res, Added, Removed>): Promise<ConfigurationType>;

package/lib/types/context/ContextJson.d.ts

@@ -41,5 +41,6 @@ export type ContextJson<Req = unknown, Res = unknown> = {
     logger?: {
         logs: LogRecord[];
     };
+    shouldSendTelemetry: boolean;
 };
 export {};

package/lib/types/context/DefaultContext.d.ts

@@ -44,6 +44,7 @@ export declare class DefaultContext<Req, Res, Added, Removed> implements IContex
     enforcerStartTime?: number;
     logger: ILogger;
     usedCookieSecret?: string;
+    shouldSendTelemetry: boolean;
     protected readonly config: IConfiguration<Req, Res, Added, Removed>;
     protected readonly urlUtils: IUrlUtils;
     constructor(config: IConfiguration<Req, Res, Added, Removed>, request: IIncomingRequest<Req>, options: DefaultContextOptions);

package/lib/types/context/SerializedContext.d.ts

@@ -38,6 +38,7 @@ export declare class SerializedContext<Req, Res, Added, Removed> implements ICon
     vidSource?: VidSource;
     tokenOrigin: TokenOrigin;
     uuid?: string;
+    shouldSendTelemetry: boolean;
     constructor(config: IConfiguration<Req, Res, Added, Removed>, contextJson: ContextJson<Req, Res>, request: IIncomingRequest<Req>, urlUtils: IUrlUtils);
     protected createRequestData({ requestData }: ContextJson<Req, Res>, request: IIncomingRequest<Req>, urlUtils: IUrlUtils): RequestData<Req>;
     protected createTokenData({ tokenData }: ContextJson<Req, Res>, config: IConfiguration<Req, Res, Added, Removed>): TokenData<Req, Res>;

package/lib/types/context/interfaces/IContext.d.ts

@@ -129,4 +129,8 @@ export interface IContext<Req, Res> {
      * The time the Enforcer process started
      */
     readonly enforcerStartTime?: number;
+    /**
+     * Whether to send telemetry activity for the current request.
+     */
+    shouldSendTelemetry: boolean;
 }

package/lib/types/phase/flow/EndEnforcerFlow.d.ts

@@ -1,6 +1,8 @@
 import { IConfiguration } from '../../config';
 import { CompositePhase } from '../impl';
 import { EnforcerOptions } from '../../enforcer';
+type RequiredEndEnforcerFlowOptions = 'logServiceClient' | 'telemetry';
 export declare class EndEnforcerFlow<Req, Res, Added, Removed> extends CompositePhase<Req, Res> {
-    constructor(config: IConfiguration<Req, Res, Added, Removed>, { logServiceClient }: Pick<Required<EnforcerOptions<Req, Res, Added, Removed>>, 'logServiceClient'>);
+    constructor(config: IConfiguration<Req, Res, Added, Removed>, { logServiceClient, telemetry, }: Pick<Required<EnforcerOptions<Req, Res, Added, Removed>>, RequiredEndEnforcerFlowOptions>);
 }
+export {};

package/lib/types/phase/impl/IdentifyTelemetryRequestPhase.d.ts

@@ -0,0 +1,9 @@
+import { IPhase } from '../IPhase';
+import { PhaseResult } from '../PhaseResult';
+import { IContext } from '../../context';
+import { ITelemetry } from '../../telemetry';
+export declare class IdentifyTelemetryRequestPhase<Req, Res> implements IPhase<Req, Res> {
+    protected readonly telemetry: ITelemetry<Req, Res>;
+    constructor(telemetry: ITelemetry<Req, Res>);
+    execute(context: IContext<Req, Res>): Promise<PhaseResult>;
+}

package/lib/types/phase/impl/{TelemetryPhase.d.ts → SendTelemetryActivityPhase.d.ts}

@@ -2,7 +2,7 @@ import { IPhase } from '../IPhase';
 import { PhaseResult } from '../PhaseResult';
 import { IContext } from '../../context';
 import { ITelemetry } from '../../telemetry';
-export declare class TelemetryPhase<Req, Res> implements IPhase<Req, Res> {
+export declare class SendTelemetryActivityPhase<Req, Res> implements IPhase<Req, Res> {
     protected readonly telemetry: ITelemetry<Req, Res>;
     constructor(telemetry: ITelemetry<Req, Res>);
     execute(context: IContext<Req, Res>): Promise<PhaseResult>;

package/lib/types/phase/impl/index.d.ts

@@ -1,7 +1,6 @@
 export * from './FirstPartyPhase';
 export * from './FilterPhase';
 export * from './PreflightPhase';
-export * from './TelemetryPhase';
 export * from './EnrichContextFromRequestPhase';
 export * from './ParseTokenPhase';
 export * from './DecideActionPhase';
@@ -17,3 +16,5 @@ export * from './CompositePhase';
 export * from './SendLogsPhase';
 export * from './/UpdateRemoteConfigPhase';
 export * from './ClearLogsPhase';
+export * from './IdentifyTelemetryRequestPhase';
+export * from './SendTelemetryActivityPhase';

package/lib/types/risk_api/client/PostRiskApiClientBase.d.ts

@@ -35,6 +35,6 @@ export declare abstract class PostRiskApiClientBase<Req, Res, Added, Removed> im
     protected getRiskUrl(): string;
     protected getRiskHeaders(): ReadonlyHeaders;
     protected handleS2STimeout(riskApiData: RiskApiData): RiskApiData;
-    protected handleS2SError(riskApiData: RiskApiData, response?: IIncomingResponse, error?: unknown): Promise<RiskApiData>;
+    protected handleS2SError(riskApiData: RiskApiData, context: ReadonlyContext<Req, Res>, response?: IIncomingResponse, error?: unknown): Promise<RiskApiData>;
 }
 export declare const isEnforcerTimeoutError: (err: unknown) => boolean;

package/lib/types/risk_api/risk_response/CommonRiskResponsePayload.d.ts

@@ -11,4 +11,5 @@ export type CommonRiskResponsePayload = {
     data_enrichment?: PXDE;
     drc?: number;
     additional_risk_info?: string;
+    telemetry_requested?: boolean;
 };

package/lib/types/risk_api/risk_response/IRiskResponse.d.ts

@@ -13,5 +13,6 @@ export interface IRiskResponse {
     readonly dataEnrichment?: PXDE;
     readonly drc?: number;
     readonly additionalRiskInfo?: string;
+    readonly telemetryRequested?: boolean;
     validate(): AsyncOrSync<boolean>;
 }

package/lib/types/risk_api/risk_response/RiskResponseBase.d.ts

@@ -21,6 +21,7 @@ export declare abstract class RiskResponseBase<TokenV extends TokenVersion> impl
     get dataEnrichment(): PXDE | undefined;
     get pxhdDomain(): string | undefined;
     get additionalRiskInfo(): string | undefined;
+    get telemetryRequested(): boolean | undefined;
     get drc(): number | undefined;
     toJSON(): RiskResponseJson;
 }

package/lib/types/risk_api/risk_response/serialize/RiskResponseJson.d.ts

@@ -12,4 +12,5 @@ export type RiskResponseJson = {
     readonly dataEnrichment?: PXDE;
     readonly drc?: number;
     readonly additionalRiskInfo?: string;
+    readonly telemetryRequested?: boolean;
 };

package/lib/types/risk_api/risk_response/serialize/SerializedRiskResponse.d.ts

@@ -6,6 +6,7 @@ import { RiskResponseJson } from './RiskResponseJson';
 export declare class SerializedRiskResponse implements IRiskResponse {
     readonly action: BlockAction | undefined;
     readonly additionalRiskInfo: string | undefined;
+    readonly telemetryRequested: boolean | undefined;
     readonly dataEnrichment: PXDE | undefined;
     readonly drc: number | undefined;
     readonly message: string | undefined;

package/lib/types/utils/constants.d.ts

@@ -11,4 +11,4 @@ export declare const PUSH_DATA_FEATURE_HEADER_NAME = "x-px-feature";
 export declare const EMAIL_ADDRESS_REGEX: RegExp;
 export declare const URL_REGEX: RegExp;
 export declare const REGEX_STRUCTURE: RegExp;
-export declare const CORE_MODULE_VERSION = "JS Core 0.24.0";
+export declare const CORE_MODULE_VERSION = "JS Core 0.24.1";

package/lib/types/utils/request_id_generator/SimpleRequestIdGenerator.d.ts

@@ -0,0 +1,6 @@
+import { IRequestIdGenerator } from './IRequestIdGenerator';
+export declare class SimpleRequestIdGenerator implements IRequestIdGenerator {
+    protected readonly requestId: string;
+    constructor(requestId: string);
+    generateRequestId(): string;
+}

package/lib/types/utils/request_id_generator/index.d.ts

@@ -1 +1,2 @@
 export * from './IRequestIdGenerator';
+export * from './SimpleRequestIdGenerator';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "perimeterx-js-core",
-  "version": "0.24.0",
+  "version": "0.24.1",
   "description": "",
   "type": "module",
   "typesVersions": {