perimeterx-js-core 0.23.1 → 0.23.3

package/lib/cjs/context/DefaultContext.js

@@ -165,6 +165,11 @@ var DefaultContext = /** @class */ (function () {
             enforcerStartTime: this.enforcerStartTime,
             blockAction: this.blockAction,
             pxdeVerified: this.pxdeVerified,
+            logger: this.shouldSendLogs
+                ? {
+                    logs: this.logger.getLogs(),
+                }
+                : undefined,
         };
     };
     return DefaultContext;

package/lib/cjs/context/SerializedContext.js

@@ -17,12 +17,13 @@ var risk_token_1 = require("../risk_token");
 var risk_api_1 = require("../risk_api");
 var SerializedContext = /** @class */ (function () {
     function SerializedContext(config, contextJson, request, urlUtils) {
+        var _a;
         this.action = contextJson.action;
         this.reasons = contextJson.reasons;
         this.isMobile = contextJson.isMobile;
         this.requestId = contextJson.requestId;
         this.isRemoteConfigUpdateRequest = contextJson.isRemoteConfigUpdateRequest;
-        this.logger = this.createLogger(config, contextJson.shouldSendLogs);
+        this.logger = this.createLogger(config, contextJson.shouldSendLogs, (_a = contextJson.logger) === null || _a === void 0 ? void 0 : _a.logs);
         this.productData = contextJson.productData;
         this.requestData = this.createRequestData(contextJson, request, urlUtils);
         this.riskApiData = this.createRiskApiData(contextJson);
@@ -58,8 +59,8 @@ var SerializedContext = /** @class */ (function () {
         var riskApiData = _a.riskApiData;
         return __assign(__assign({}, riskApiData), { riskResponse: riskApiData.riskResponse ? new risk_api_1.SerializedRiskResponse(riskApiData.riskResponse) : undefined });
     };
-    SerializedContext.prototype.createLogger = function (config, shouldSendLogs) {
-        return new logger_1.DefaultLogger(config.loggerSeverity, shouldSendLogs);
+    SerializedContext.prototype.createLogger = function (config, shouldSendLogs, logs) {
+        return new logger_1.DefaultLogger(config.loggerSeverity, shouldSendLogs, logs);
     };
     return SerializedContext;
 }());

package/lib/cjs/graphql/DefaultGraphQLParser.js

@@ -49,7 +49,7 @@ var DefaultGraphQLParser = /** @class */ (function () {
     DefaultGraphQLParser.prototype.isGraphQLRequest = function (_a) {
         var requestData = _a.requestData;
         return (requestData.method === http_1.HttpMethod.POST &&
-            (0, utils_1.isRouteInPatterns)(requestData.url.pathname, this.config.graphqlRoutes));
+            (0, utils_1.isStringInPatterns)(requestData.url.pathname, this.config.graphqlRoutes));
     };
     DefaultGraphQLParser.prototype.parseGraphQLRequest = function (context) {
         return __awaiter(this, void 0, void 0, function () {

package/lib/cjs/logger/DefaultLogger.js

@@ -19,8 +19,8 @@ exports.DefaultLogger = void 0;
 var LoggerBase_1 = require("./LoggerBase");
 var DefaultLogger = /** @class */ (function (_super) {
     __extends(DefaultLogger, _super);
-    function DefaultLogger(loggerSeverity, shouldSaveLogs) {
-        return _super.call(this, loggerSeverity, shouldSaveLogs) || this;
+    function DefaultLogger(loggerSeverity, shouldSaveLogs, logs) {
+        return _super.call(this, loggerSeverity, shouldSaveLogs, logs) || this;
     }
     DefaultLogger.prototype.log = function (message) {
         /* eslint-disable no-console */

package/lib/cjs/monitored_request/MonitoredRequestUtils.js

@@ -74,10 +74,10 @@ var MonitoredRequestUtils;
         });
     }); };
     MonitoredRequestUtils.isMonitoredRoute = function (url, isMonitoredRoute) {
-        return (0, utils_1.isRouteInPatterns)(url.pathname, isMonitoredRoute);
+        return (0, utils_1.isStringInPatterns)(url.pathname, isMonitoredRoute);
     };
     MonitoredRequestUtils.isEnforcedRoute = function (url, enforcedRoutes) {
-        return (0, utils_1.isRouteInPatterns)(url.pathname, enforcedRoutes);
+        return (0, utils_1.isStringInPatterns)(url.pathname, enforcedRoutes);
     };
     MonitoredRequestUtils.invokeCustomIsEnforcedRequest = function (config, context) { return __awaiter(_this, void 0, void 0, function () {
         var err_1;

package/lib/cjs/products/bot_defender/filter/DefaultBotDefenderFilter.js

@@ -109,10 +109,10 @@ var DefaultBotDefenderFilter = /** @class */ (function () {
         return this.config.filteredIps.some(function (range) { return _this.ipRangeChecker.isIpInRange(ip, range); });
     };
     DefaultBotDefenderFilter.prototype.shouldFilterByRoute = function (route) {
-        return (0, utils_1.isRouteInPatterns)(route, this.config.filteredRoutes);
+        return (0, utils_1.isStringInPatterns)(route, this.config.filteredRoutes);
     };
     DefaultBotDefenderFilter.prototype.shouldFilterByUserAgent = function (userAgent) {
-        return this.config.filteredUserAgents.includes(userAgent);
+        return (0, utils_1.isStringInPatterns)(userAgent, this.config.filteredUserAgents);
     };
     DefaultBotDefenderFilter.prototype.shouldFilterByCustomFunction = function (context) {
         return __awaiter(this, void 0, void 0, function () {

package/lib/cjs/sensitive_request/SensitiveRequestUtils.js

@@ -58,7 +58,7 @@ var SensitiveRequestUtils;
         });
     }); };
     SensitiveRequestUtils.isSensitiveRoute = function (url, sensitiveRoutes) {
-        return (0, utils_1.isRouteInPatterns)(url.pathname, sensitiveRoutes);
+        return (0, utils_1.isStringInPatterns)(url.pathname, sensitiveRoutes);
     };
     SensitiveRequestUtils.isSensitiveGraphqlOperation = function (graphQLData) {
         return !!(graphQLData === null || graphQLData === void 0 ? void 0 : graphQLData.some(function (operation) { return operation.sensitive; }));

package/lib/cjs/utils/constants.js

@@ -12,6 +12,6 @@ exports.X_PX_BYPASS_REASON_HEADER_NAME = 'x-px-bypass-reason';
 exports.PUSH_DATA_HMAC_HEADER_NAME = 'x-px-pushdata';
 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]+))?)([\/]{0,1}[^?#]*)(\?[^#]*|)(#.*|)$/;
+exports.URL_REGEX = /^(https?:)\/\/(([^@\s:\/]+):?([^@\s\/]*)@)?(([^:\/?#]*)(?:\:([0-9]+))?)(\/?[^?#]*)(\?[^#]*|)(#.*|)$/;
 exports.REGEX_STRUCTURE = /^\/(.+?)\/([gimsuyvd]*)$/;
-exports.CORE_MODULE_VERSION = 'JS Core 0.23.1';
+exports.CORE_MODULE_VERSION = 'JS Core 0.23.3';

package/lib/cjs/utils/error/EnforcerConfigurationError.js

@@ -22,7 +22,14 @@ var EnforcerConfigurationError = /** @class */ (function (_super) {
     __extends(EnforcerConfigurationError, _super);
     function EnforcerConfigurationError(configName, invalidConfigValue, possibleValues) {
         var _this = this;
-        var message = "configuration ".concat(configName, " cannot be type ").concat(typeof invalidConfigValue, " with value ").concat(invalidConfigValue);
+        var value = invalidConfigValue === null
+            ? 'null'
+            : invalidConfigValue === undefined
+                ? 'undefined'
+                : typeof invalidConfigValue === 'string'
+                    ? "\"".concat(invalidConfigValue, "\"")
+                    : invalidConfigValue;
+        var message = "configuration ".concat(configName, " cannot be type ").concat(typeof invalidConfigValue, " with value ").concat(value);
         if (possibleValues) {
             message += ", possible values: ".concat(possibleValues.join(', '));
         }

package/lib/cjs/utils/utils.js

@@ -36,7 +36,7 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
     }
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isNullOrUndefined = exports.isValidTokenVersion = exports.telemetryConfigReplacer = exports.convertRegexStringToRegex = exports.algoToCryptoString = exports.algoToSubtleCryptoString = exports.sleep = exports.getPropertyFromObject = exports.rejectOnTimeout = exports.transferExistingProperties = exports.isRouteMatch = exports.isRouteInPatterns = exports.removeSensitiveHeaders = exports.redactSensitiveFields = exports.getExtension = exports.getAuthorizationHeader = exports.getCollectorDomain = exports.getScoreApiDomain = exports.isEmailAddress = exports.isValidUuid = exports.isValidEnumValue = void 0;
+exports.isNullOrUndefined = exports.isValidTokenVersion = exports.telemetryConfigReplacer = exports.convertRegexStringToRegex = exports.algoToCryptoString = exports.algoToSubtleCryptoString = exports.sleep = exports.getPropertyFromObject = exports.rejectOnTimeout = exports.transferExistingProperties = exports.isStringMatch = exports.isStringInPatterns = exports.removeSensitiveHeaders = exports.redactSensitiveFields = exports.getExtension = exports.getAuthorizationHeader = exports.getCollectorDomain = exports.getScoreApiDomain = exports.isEmailAddress = exports.isValidUuid = exports.isValidEnumValue = void 0;
 var http_1 = require("../http");
 var error_1 = require("./error");
 var constants_1 = require("./constants");
@@ -80,21 +80,37 @@ var getExtension = function (route) {
 };
 exports.getExtension = getExtension;
 var redactSensitiveFields = function (object, sensitiveFields) {
-    var NUMBER_OF_TRAILING_CHARS_TO_EXPOSE = 5;
-    var SENSITIVE_VALUE_MINIMUM_LENGTH_TO_EXPOSE_TRAILING_CHARS = NUMBER_OF_TRAILING_CHARS_TO_EXPOSE * 10;
     var newObj = Object.assign({}, object);
     sensitiveFields.forEach(function (fieldName) {
         var sensitiveValue = object[fieldName];
         if (!sensitiveValue) {
             return;
         }
-        var trailingCharsExposed = sensitiveValue.length >= SENSITIVE_VALUE_MINIMUM_LENGTH_TO_EXPOSE_TRAILING_CHARS;
-        var trailingChars = sensitiveValue.substring(sensitiveValue.length - (trailingCharsExposed ? NUMBER_OF_TRAILING_CHARS_TO_EXPOSE : 0));
-        newObj[fieldName] = "***REDACTED***".concat(trailingChars);
+        newObj[fieldName] = redactUnknownValue(sensitiveValue);
     });
     return newObj;
 };
 exports.redactSensitiveFields = redactSensitiveFields;
+var redactUnknownValue = function (value) {
+    switch (typeof value) {
+        case 'string':
+            return redactSensitiveString(value);
+        case 'object':
+            if (Array.isArray(value)) {
+                return value.flatMap(redactUnknownValue).filter(function (v) { return !(0, exports.isNullOrUndefined)(v); });
+            }
+            return null;
+        default:
+            return null;
+    }
+};
+var redactSensitiveString = function (sensitiveValue) {
+    var NUMBER_OF_TRAILING_CHARS_TO_EXPOSE = 5;
+    var SENSITIVE_VALUE_MINIMUM_LENGTH_TO_EXPOSE_TRAILING_CHARS = NUMBER_OF_TRAILING_CHARS_TO_EXPOSE * 10;
+    var trailingCharsExposed = sensitiveValue.length >= SENSITIVE_VALUE_MINIMUM_LENGTH_TO_EXPOSE_TRAILING_CHARS;
+    var trailingChars = sensitiveValue.substring(sensitiveValue.length - (trailingCharsExposed ? NUMBER_OF_TRAILING_CHARS_TO_EXPOSE : 0));
+    return "***REDACTED***".concat(trailingChars);
+};
 var removeSensitiveHeaders = function (headers, sensitiveHeaderNames) {
     var ret = (0, http_1.toMutableHeaders)(headers);
     sensitiveHeaderNames.forEach(function (name) {
@@ -103,23 +119,23 @@ var removeSensitiveHeaders = function (headers, sensitiveHeaderNames) {
     return ret;
 };
 exports.removeSensitiveHeaders = removeSensitiveHeaders;
-var isRouteInPatterns = function (route, patterns) {
-    return patterns.some(function (pattern) { return (0, exports.isRouteMatch)(route, pattern); });
+var isStringInPatterns = function (str, patterns) {
+    return patterns.some(function (pattern) { return (0, exports.isStringMatch)(str, pattern); });
 };
-exports.isRouteInPatterns = isRouteInPatterns;
-var isRouteMatch = function (route, pattern) {
-    if (!route || !pattern) {
+exports.isStringInPatterns = isStringInPatterns;
+var isStringMatch = function (str, pattern) {
+    if (!str || !pattern) {
         return false;
     }
-    if (pattern instanceof RegExp && !!route.match(pattern)) {
+    if (pattern instanceof RegExp && !!str.match(pattern)) {
         return true;
     }
-    if (typeof pattern === 'string' && route.startsWith(pattern)) {
+    if (typeof pattern === 'string' && str.startsWith(pattern)) {
         return true;
     }
     return false;
 };
-exports.isRouteMatch = isRouteMatch;
+exports.isStringMatch = isStringMatch;
 /**
  * @deprecated this method is not typesafe. Copy the fields manually instead,
  *             unsafe - ignores compilerOptions.strictNullChecks

package/lib/esm/context/DefaultContext.js

@@ -175,6 +175,11 @@ export class DefaultContext {
             enforcerStartTime: this.enforcerStartTime,
             blockAction: this.blockAction,
             pxdeVerified: this.pxdeVerified,
+            logger: this.shouldSendLogs
+                ? {
+                    logs: this.logger.getLogs(),
+                }
+                : undefined,
         };
     }
 }

package/lib/esm/context/SerializedContext.js

@@ -33,7 +33,7 @@ export class SerializedContext {
         this.isMobile = contextJson.isMobile;
         this.requestId = contextJson.requestId;
         this.isRemoteConfigUpdateRequest = contextJson.isRemoteConfigUpdateRequest;
-        this.logger = this.createLogger(config, contextJson.shouldSendLogs);
+        this.logger = this.createLogger(config, contextJson.shouldSendLogs, contextJson.logger?.logs);
         this.productData = contextJson.productData;
         this.requestData = this.createRequestData(contextJson, request, urlUtils);
         this.riskApiData = this.createRiskApiData(contextJson);
@@ -81,7 +81,7 @@ export class SerializedContext {
             riskResponse: riskApiData.riskResponse ? new SerializedRiskResponse(riskApiData.riskResponse) : undefined,
         };
     }
-    createLogger(config, shouldSendLogs) {
-        return new DefaultLogger(config.loggerSeverity, shouldSendLogs);
+    createLogger(config, shouldSendLogs, logs) {
+        return new DefaultLogger(config.loggerSeverity, shouldSendLogs, logs);
     }
 }

package/lib/esm/graphql/DefaultGraphQLParser.js

@@ -1,4 +1,4 @@
-import { isNullOrUndefined, isRouteInPatterns } from '../utils';
+import { isNullOrUndefined, isStringInPatterns } from '../utils';
 import { HttpMethod } from '../http';
 import { GraphQLOperationType } from './model';
 export class DefaultGraphQLParser {
@@ -12,7 +12,7 @@ export class DefaultGraphQLParser {
     }
     isGraphQLRequest({ requestData }) {
         return (requestData.method === HttpMethod.POST &&
-            isRouteInPatterns(requestData.url.pathname, this.config.graphqlRoutes));
+            isStringInPatterns(requestData.url.pathname, this.config.graphqlRoutes));
     }
     async parseGraphQLRequest(context) {
         try {

package/lib/esm/logger/DefaultLogger.js

@@ -1,7 +1,7 @@
 import { LoggerBase } from './LoggerBase';
 export class DefaultLogger extends LoggerBase {
-    constructor(loggerSeverity, shouldSaveLogs) {
-        super(loggerSeverity, shouldSaveLogs);
+    constructor(loggerSeverity, shouldSaveLogs, logs) {
+        super(loggerSeverity, shouldSaveLogs, logs);
     }
     log(message) {
         /* eslint-disable no-console */

package/lib/esm/monitored_request/MonitoredRequestUtils.js

@@ -1,4 +1,4 @@
-import { BYPASS_MONITOR_HEADER_VALUE, isRouteInPatterns, ModuleMode } from '../utils';
+import { BYPASS_MONITOR_HEADER_VALUE, isStringInPatterns, ModuleMode } from '../utils';
 export var MonitoredRequestUtils;
 (function (MonitoredRequestUtils) {
     MonitoredRequestUtils.isMonitoredRequest = async (config, context) => {
@@ -10,10 +10,10 @@ export var MonitoredRequestUtils;
         return (monitorMode || monitoredRoute) && !MonitoredRequestUtils.isAllowedToBypassMonitor(config.bypassMonitorHeader, request);
     };
     MonitoredRequestUtils.isMonitoredRoute = (url, isMonitoredRoute) => {
-        return isRouteInPatterns(url.pathname, isMonitoredRoute);
+        return isStringInPatterns(url.pathname, isMonitoredRoute);
     };
     MonitoredRequestUtils.isEnforcedRoute = (url, enforcedRoutes) => {
-        return isRouteInPatterns(url.pathname, enforcedRoutes);
+        return isStringInPatterns(url.pathname, enforcedRoutes);
     };
     MonitoredRequestUtils.invokeCustomIsEnforcedRequest = async (config, context) => {
         if (config.customIsEnforcedRequest && typeof config.customIsEnforcedRequest === 'function') {

package/lib/esm/products/bot_defender/filter/DefaultBotDefenderFilter.js

@@ -1,6 +1,6 @@
 import { HttpMethod } from '../../../http';
 import { FilterReason } from '../../../filter';
-import { getExtension, isRouteInPatterns } from '../../../utils';
+import { getExtension, isStringInPatterns } from '../../../utils';
 export class DefaultBotDefenderFilter {
     config;
     ipRangeChecker;
@@ -52,10 +52,10 @@ export class DefaultBotDefenderFilter {
         return this.config.filteredIps.some((range) => this.ipRangeChecker.isIpInRange(ip, range));
     }
     shouldFilterByRoute(route) {
-        return isRouteInPatterns(route, this.config.filteredRoutes);
+        return isStringInPatterns(route, this.config.filteredRoutes);
     }
     shouldFilterByUserAgent(userAgent) {
-        return this.config.filteredUserAgents.includes(userAgent);
+        return isStringInPatterns(userAgent, this.config.filteredUserAgents);
     }
     async shouldFilterByCustomFunction(context) {
         if (this.config.customIsFilteredRequest && typeof this.config.customIsFilteredRequest === 'function') {

package/lib/esm/sensitive_request/SensitiveRequestUtils.js

@@ -1,4 +1,4 @@
-import { isRouteInPatterns } from '../utils';
+import { isStringInPatterns } from '../utils';
 export var SensitiveRequestUtils;
 (function (SensitiveRequestUtils) {
     SensitiveRequestUtils.isSensitiveRequest = async (config, context) => {
@@ -7,7 +7,7 @@ export var SensitiveRequestUtils;
             (await SensitiveRequestUtils.invokeCustomIsSensitiveRequest(config, context)));
     };
     SensitiveRequestUtils.isSensitiveRoute = (url, sensitiveRoutes) => {
-        return isRouteInPatterns(url.pathname, sensitiveRoutes);
+        return isStringInPatterns(url.pathname, sensitiveRoutes);
     };
     SensitiveRequestUtils.isSensitiveGraphqlOperation = (graphQLData) => {
         return !!graphQLData?.some((operation) => operation.sensitive);

package/lib/esm/utils/constants.js

@@ -9,6 +9,6 @@ export const X_PX_BYPASS_REASON_HEADER_NAME = 'x-px-bypass-reason';
 export const PUSH_DATA_HMAC_HEADER_NAME = 'x-px-pushdata';
 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]+))?)([\/]{0,1}[^?#]*)(\?[^#]*|)(#.*|)$/;
+export const URL_REGEX = /^(https?:)\/\/(([^@\s:\/]+):?([^@\s\/]*)@)?(([^:\/?#]*)(?:\:([0-9]+))?)(\/?[^?#]*)(\?[^#]*|)(#.*|)$/;
 export const REGEX_STRUCTURE = /^\/(.+?)\/([gimsuyvd]*)$/;
-export const CORE_MODULE_VERSION = 'JS Core 0.23.1';
+export const CORE_MODULE_VERSION = 'JS Core 0.23.3';

package/lib/esm/utils/error/EnforcerConfigurationError.js

@@ -2,7 +2,14 @@ import { EnforcerError } from './EnforcerError';
 import { EnforcerErrorName } from './EnforcerErrorName';
 export class EnforcerConfigurationError extends EnforcerError {
     constructor(configName, invalidConfigValue, possibleValues) {
-        let message = `configuration ${configName} cannot be type ${typeof invalidConfigValue} with value ${invalidConfigValue}`;
+        const value = invalidConfigValue === null
+            ? 'null'
+            : invalidConfigValue === undefined
+                ? 'undefined'
+                : typeof invalidConfigValue === 'string'
+                    ? `"${invalidConfigValue}"`
+                    : invalidConfigValue;
+        let message = `configuration ${configName} cannot be type ${typeof invalidConfigValue} with value ${value}`;
         if (possibleValues) {
             message += `, possible values: ${possibleValues.join(', ')}`;
         }

package/lib/esm/utils/utils.js

@@ -33,20 +33,36 @@ export const getExtension = (route) => {
     return endOfPath.substring(extensionIndex);
 };
 export const redactSensitiveFields = (object, sensitiveFields) => {
-    const NUMBER_OF_TRAILING_CHARS_TO_EXPOSE = 5;
-    const SENSITIVE_VALUE_MINIMUM_LENGTH_TO_EXPOSE_TRAILING_CHARS = NUMBER_OF_TRAILING_CHARS_TO_EXPOSE * 10;
     const newObj = Object.assign({}, object);
     sensitiveFields.forEach((fieldName) => {
         const sensitiveValue = object[fieldName];
         if (!sensitiveValue) {
             return;
         }
-        const trailingCharsExposed = sensitiveValue.length >= SENSITIVE_VALUE_MINIMUM_LENGTH_TO_EXPOSE_TRAILING_CHARS;
-        const trailingChars = sensitiveValue.substring(sensitiveValue.length - (trailingCharsExposed ? NUMBER_OF_TRAILING_CHARS_TO_EXPOSE : 0));
-        newObj[fieldName] = `***REDACTED***${trailingChars}`;
+        newObj[fieldName] = redactUnknownValue(sensitiveValue);
     });
     return newObj;
 };
+const redactUnknownValue = (value) => {
+    switch (typeof value) {
+        case 'string':
+            return redactSensitiveString(value);
+        case 'object':
+            if (Array.isArray(value)) {
+                return value.flatMap(redactUnknownValue).filter((v) => !isNullOrUndefined(v));
+            }
+            return null;
+        default:
+            return null;
+    }
+};
+const redactSensitiveString = (sensitiveValue) => {
+    const NUMBER_OF_TRAILING_CHARS_TO_EXPOSE = 5;
+    const SENSITIVE_VALUE_MINIMUM_LENGTH_TO_EXPOSE_TRAILING_CHARS = NUMBER_OF_TRAILING_CHARS_TO_EXPOSE * 10;
+    const trailingCharsExposed = sensitiveValue.length >= SENSITIVE_VALUE_MINIMUM_LENGTH_TO_EXPOSE_TRAILING_CHARS;
+    const trailingChars = sensitiveValue.substring(sensitiveValue.length - (trailingCharsExposed ? NUMBER_OF_TRAILING_CHARS_TO_EXPOSE : 0));
+    return `***REDACTED***${trailingChars}`;
+};
 export const removeSensitiveHeaders = (headers, sensitiveHeaderNames) => {
     const ret = toMutableHeaders(headers);
     sensitiveHeaderNames.forEach((name) => {
@@ -54,17 +70,17 @@ export const removeSensitiveHeaders = (headers, sensitiveHeaderNames) => {
     });
     return ret;
 };
-export const isRouteInPatterns = (route, patterns) => {
-    return patterns.some((pattern) => isRouteMatch(route, pattern));
+export const isStringInPatterns = (str, patterns) => {
+    return patterns.some((pattern) => isStringMatch(str, pattern));
 };
-export const isRouteMatch = (route, pattern) => {
-    if (!route || !pattern) {
+export const isStringMatch = (str, pattern) => {
+    if (!str || !pattern) {
         return false;
     }
-    if (pattern instanceof RegExp && !!route.match(pattern)) {
+    if (pattern instanceof RegExp && !!str.match(pattern)) {
         return true;
     }
-    if (typeof pattern === 'string' && route.startsWith(pattern)) {
+    if (typeof pattern === 'string' && str.startsWith(pattern)) {
         return true;
     }
     return false;

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

@@ -43,7 +43,7 @@ export declare abstract class ConfigurationBase<Req, Res, Added, Removed extends
     get filteredHttpMethods(): string[];
     get filteredIps(): string[];
     get filteredRoutes(): Array<string | RegExp>;
-    get filteredUserAgents(): string[];
+    get filteredUserAgents(): Array<string | RegExp>;
     get firstPartyEnabled(): boolean;
     get customIsFilteredRequest(): CustomRequestFunction<Req> | null;
     get customFirstPartyPrefix(): string;

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

@@ -48,7 +48,7 @@ export interface IConfiguration<Req, Res, Added, Removed> {
     /**
      * An array of agents that should not go through the enforcer flow.
      */
-    readonly filteredUserAgents: string[];
+    readonly filteredUserAgents: Array<string | RegExp>;
     /**
      * An array of regular expressions or prefixes of routes that should not go through the enforcer flow.
      */

package/lib/types/config/params/CoreConfigurationParams.d.ts

@@ -74,7 +74,7 @@ export type CommonConfigurationParams<Req, Res, Added, Removed> = TokenV3Configu
     px_filter_by_http_method?: string[];
     px_filter_by_ip?: string[];
     px_filter_by_route?: Array<string | RegExp>;
-    px_filter_by_user_agent?: string[];
+    px_filter_by_user_agent?: Array<string | RegExp>;
     px_css_ref?: string;
     px_js_ref?: string;
     px_custom_cookie_header?: string;

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

@@ -8,6 +8,7 @@ import { PXDE } from '../pxde';
 import { CustomParameters } from '../custom_parameters';
 import { GraphQLData } from '../graphql';
 import { RequestData, RiskApiData, ServerData, TlsData, TokenData } from './interfaces';
+import { LogRecord } from '../logger';
 type RequestDataJson<Req> = Omit<RequestData<Req>, 'url' | 'request'> & {
     url: string;
     request: undefined;
@@ -37,5 +38,8 @@ export type ContextJson<Req = unknown, Res = unknown> = {
     readonly shouldSendLogs: boolean;
     readonly isRemoteConfigUpdateRequest: boolean;
     readonly enforcerStartTime?: number;
+    logger?: {
+        logs: LogRecord[];
+    };
 };
 export {};

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

@@ -1,6 +1,6 @@
 import { IConfiguration } from '../config';
 import { Action } from '../action';
-import { ILogger } from '../logger';
+import { ILogger, LogRecord } from '../logger';
 import { ProductData, ProductName } from '../products';
 import { TokenOrigin } from '../risk_token';
 import { IIncomingRequest } from '../http';
@@ -42,5 +42,5 @@ export declare class SerializedContext<Req, Res, Added, Removed> implements ICon
     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>;
     protected createRiskApiData({ riskApiData }: ContextJson<Req, Res>): RiskApiData;
-    protected createLogger(config: IConfiguration<Req, Res, Added, Removed>, shouldSendLogs: boolean): ILogger;
+    protected createLogger(config: IConfiguration<Req, Res, Added, Removed>, shouldSendLogs: boolean, logs?: LogRecord[]): ILogger;
 }

package/lib/types/logger/DefaultLogger.d.ts

@@ -1,7 +1,8 @@
 import { LoggerSeverity } from './LoggerSeverity';
 import { LoggerBase } from './LoggerBase';
 import { ILogger } from './ILogger';
+import { LogRecord } from './model';
 export declare class DefaultLogger extends LoggerBase implements ILogger {
-    constructor(loggerSeverity: `${LoggerSeverity}`, shouldSaveLogs: boolean);
+    constructor(loggerSeverity: `${LoggerSeverity}`, shouldSaveLogs: boolean, logs?: LogRecord[]);
     protected log(message: string): void;
 }

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.23.1";
+export declare const CORE_MODULE_VERSION = "JS Core 0.23.3";

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

@@ -11,8 +11,8 @@ export declare const getAuthorizationHeader: (authToken: string) => string;
 export declare const getExtension: (route: string) => string;
 export declare const redactSensitiveFields: <T extends Record<string, any>>(object: T, sensitiveFields: Array<keyof T | string>) => T;
 export declare const removeSensitiveHeaders: (headers: ReadonlyHeaders, sensitiveHeaderNames: string[]) => Record<string, string[]>;
-export declare const isRouteInPatterns: (route: string, patterns: Array<string | RegExp>) => boolean;
-export declare const isRouteMatch: (route: string, pattern: string | RegExp) => boolean;
+export declare const isStringInPatterns: (str: string, patterns: Array<string | RegExp>) => boolean;
+export declare const isStringMatch: (str: string, pattern: string | RegExp) => boolean;
 /**
  * @deprecated this method is not typesafe. Copy the fields manually instead,
  *             unsafe - ignores compilerOptions.strictNullChecks

package/package.json

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