perimeterx-js-core 0.26.1 → 0.27.0

package/lib/cjs/activities/utils.js

@@ -66,7 +66,7 @@ var createAsyncActivityCommonDetails = function (context) {
 };
 exports.createAsyncActivityCommonDetails = createAsyncActivityCommonDetails;
 var createCommonActivityDetails = function (config, context) {
-    var _a, _b;
+    var _a, _b, _c;
     var details = {
         module_version: config.moduleVersion,
         // Note: risk_mode currently reflects only Bot Defender mode
@@ -79,7 +79,7 @@ var createCommonActivityDetails = function (config, context) {
     (0, exports.addProductDataToDetails)(details, context.productData);
     (0, exports.addServerDataToDetails)(details, context.serverData);
     (0, exports.addTlsDataToDetails)(details, context.tlsData);
-    (0, exports.addCustomParametersToDetails)(details, (_b = context.customParameters) !== null && _b !== void 0 ? _b : null);
+    (0, exports.addCustomParametersToDetails)(details, (_b = context.customParameters) !== null && _b !== void 0 ? _b : null, (_c = context.responseCustomParameters) !== null && _c !== void 0 ? _c : null);
     return details;
 };
 exports.createCommonActivityDetails = createCommonActivityDetails;
@@ -116,10 +116,13 @@ var addConfigDataToDetails = function (details, config) {
     }
 };
 exports.addConfigDataToDetails = addConfigDataToDetails;
-var addCustomParametersToDetails = function (details, customParameters) {
+var addCustomParametersToDetails = function (details, customParameters, responseCustomParameters) {
     if (customParameters) {
         Object.assign(details, customParameters);
     }
+    if (responseCustomParameters) {
+        Object.assign(details, responseCustomParameters);
+    }
 };
 exports.addCustomParametersToDetails = addCustomParametersToDetails;
 var addProductDataToDetails = function (details, productData) {

package/lib/cjs/config/ConfigurationBase.js

@@ -492,6 +492,13 @@ var ConfigurationBase = /** @class */ (function () {
         enumerable: false,
         configurable: true
     });
+    Object.defineProperty(ConfigurationBase.prototype, "enrichResponseCustomParameters", {
+        get: function () {
+            return this.configParams.px_enrich_response_custom_parameters;
+        },
+        enumerable: false,
+        configurable: true
+    });
     Object.defineProperty(ConfigurationBase.prototype, "additionalActivityHandler", {
         get: function () {
             return this.configParams.px_additional_activity_handler;

package/lib/cjs/config/defaults/DefaultConfigurationParams.js

@@ -116,6 +116,7 @@ var defaultConfigurationParams = function () { return ({
     px_sensitive_graphql_operation_names: [],
     px_sensitive_graphql_operation_types: [],
     px_enrich_custom_parameters: null,
+    px_enrich_response_custom_parameters: null,
     px_jwt_cookie_name: '',
     px_jwt_cookie_user_id_field_name: '',
     px_jwt_cookie_additional_field_names: [],

package/lib/cjs/custom_parameters/CustomParametersUtils.js

@@ -62,6 +62,31 @@ var CustomParametersUtils;
             }
         });
     }); };
+    CustomParametersUtils.createResponseCustomParameters = function (config, context) { return __awaiter(_this, void 0, void 0, function () {
+        var parameters, e_2;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    if (!(config.enrichResponseCustomParameters && typeof config.enrichResponseCustomParameters === 'function')) return [3 /*break*/, 4];
+                    _a.label = 1;
+                case 1:
+                    _a.trys.push([1, 3, , 4]);
+                    if (!context.response) {
+                        context.logger.debug('no response available for response custom parameters');
+                        return [2 /*return*/, null];
+                    }
+                    return [4 /*yield*/, config.enrichResponseCustomParameters(config.getActiveConfig(), context.response.getUnderlyingResponse())];
+                case 2:
+                    parameters = _a.sent();
+                    return [2 /*return*/, CustomParametersUtils.normalizeResponseCustomParams(parameters)];
+                case 3:
+                    e_2 = _a.sent();
+                    context.logger.error("unable to enrich response custom params: ".concat(e_2));
+                    return [3 /*break*/, 4];
+                case 4: return [2 /*return*/, null];
+            }
+        });
+    }); };
     CustomParametersUtils.normalizeCustomParams = function (customParameters) {
         var normalizedParams = {};
         if (customParameters && typeof customParameters === 'object') {
@@ -79,4 +104,17 @@ var CustomParametersUtils;
         }
         return Object.keys(normalizedParams).length === 0 ? null : normalizedParams;
     };
+    CustomParametersUtils.normalizeResponseCustomParams = function (customParameters) {
+        var normalizedParams = {};
+        if (customParameters && typeof customParameters === 'object') {
+            var paramKeyRegex_2 = /^custom_param(1[1-9]|20)$/;
+            Object.entries(customParameters).forEach(function (_a) {
+                var param = _a[0], value = _a[1];
+                if (param.match(paramKeyRegex_2) && value !== '') {
+                    normalizedParams[param] = value;
+                }
+            });
+        }
+        return Object.keys(normalizedParams).length === 0 ? null : normalizedParams;
+    };
 })(CustomParametersUtils || (exports.CustomParametersUtils = CustomParametersUtils = {}));

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

@@ -38,6 +38,7 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EnrichContextFromResponsePhase = void 0;
 var utils_1 = require("../../utils/index.js");
+var custom_parameters_1 = require("../../custom_parameters/index.js");
 /**
  * `EnrichContextFromResponsePhase` enriches the context with response data. Each product's `enrichContextFromResponse`
  * method is called since every product may use the response data differently.
@@ -55,6 +56,9 @@ var EnrichContextFromResponsePhase = /** @class */ (function () {
                         context.logger.debug('enrich context from response phase');
                         return [4 /*yield*/, this.addProductDataToContext(context)];
                     case 1:
+                        _a.sent();
+                        return [4 /*yield*/, this.addResponseCustomParametersToContext(context)];
+                    case 2:
                         _a.sent();
                         return [2 /*return*/, { done: false }];
                 }
@@ -91,6 +95,21 @@ var EnrichContextFromResponsePhase = /** @class */ (function () {
             });
         });
     };
+    EnrichContextFromResponsePhase.prototype.addResponseCustomParametersToContext = function (context) {
+        return __awaiter(this, void 0, void 0, function () {
+            var _a;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        _a = context;
+                        return [4 /*yield*/, custom_parameters_1.CustomParametersUtils.createResponseCustomParameters(this.config, context)];
+                    case 1:
+                        _a.responseCustomParameters = _b.sent();
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
     return EnrichContextFromResponsePhase;
 }());
 exports.EnrichContextFromResponsePhase = EnrichContextFromResponsePhase;

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

@@ -69,11 +69,14 @@ var GetRiskApiClientV2 = /** @class */ (function (_super) {
         return (0, utils_2.isAscii)(headerName) && headerValue.every(function (value) { return (0, utils_2.isAscii)(value); });
     };
     GetRiskApiClientV2.prototype.addHeadersFromObject = function (headers, object, headerNamesMap) {
-        Object.entries(object).forEach(function (_a) {
-            var key = _a[0], value = _a[1];
-            var headerConversionObject = headerNamesMap[key];
-            if (headerConversionObject && value != null) {
-                var header = headerConversionObject.header, convertToString = headerConversionObject.convertToString;
+        Object.entries(headerNamesMap).forEach(function (_a) {
+            var key = _a[0], headerConversionObject = _a[1];
+            if (!headerConversionObject) {
+                return;
+            }
+            var header = headerConversionObject.header, convertToString = headerConversionObject.convertToString;
+            var value = object[key];
+            if (value != null) {
                 var strValue = convertToString
                     ? convertToString(value)
                     : typeof value === 'string'
@@ -81,6 +84,10 @@ var GetRiskApiClientV2 = /** @class */ (function (_super) {
                         : "".concat(value);
                 headers[header] = [strValue];
             }
+            else {
+                // delete so that user cannot spoof
+                delete headers[header];
+            }
         });
     };
     GetRiskApiClientV2.prototype.createRiskResponse = function (response) {

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.26.1';
+exports.CORE_MODULE_VERSION = 'JS Core 0.27.0';

package/lib/esm/activities/utils.js

@@ -70,7 +70,7 @@ export const createCommonActivityDetails = (config, context) => {
     addProductDataToDetails(details, context.productData);
     addServerDataToDetails(details, context.serverData);
     addTlsDataToDetails(details, context.tlsData);
-    addCustomParametersToDetails(details, context.customParameters ?? null);
+    addCustomParametersToDetails(details, context.customParameters ?? null, context.responseCustomParameters ?? null);
     return details;
 };
 export const addRootContextDataToDetails = (details, context) => {
@@ -104,10 +104,13 @@ export const addConfigDataToDetails = (details, config) => {
         details.remote_config_version = config.remoteConfigVersion;
     }
 };
-export const addCustomParametersToDetails = (details, customParameters) => {
+export const addCustomParametersToDetails = (details, customParameters, responseCustomParameters) => {
     if (customParameters) {
         Object.assign(details, customParameters);
     }
+    if (responseCustomParameters) {
+        Object.assign(details, responseCustomParameters);
+    }
 };
 export const addProductDataToDetails = (details, productData) => {
     if (productData.ad) {

package/lib/esm/config/ConfigurationBase.js

@@ -273,6 +273,9 @@ export class ConfigurationBase {
     get enrichCustomParameters() {
         return this.configParams.px_enrich_custom_parameters;
     }
+    get enrichResponseCustomParameters() {
+        return this.configParams.px_enrich_response_custom_parameters;
+    }
     get additionalActivityHandler() {
         return this.configParams.px_additional_activity_handler;
     }

package/lib/esm/config/defaults/DefaultConfigurationParams.js

@@ -113,6 +113,7 @@ export const defaultConfigurationParams = () => ({
     px_sensitive_graphql_operation_names: [],
     px_sensitive_graphql_operation_types: [],
     px_enrich_custom_parameters: null,
+    px_enrich_response_custom_parameters: null,
     px_jwt_cookie_name: '',
     px_jwt_cookie_user_id_field_name: '',
     px_jwt_cookie_additional_field_names: [],

package/lib/esm/custom_parameters/CustomParametersUtils.js

@@ -13,6 +13,22 @@ export var CustomParametersUtils;
         }
         return null;
     };
+    CustomParametersUtils.createResponseCustomParameters = async (config, context) => {
+        if (config.enrichResponseCustomParameters && typeof config.enrichResponseCustomParameters === 'function') {
+            try {
+                if (!context.response) {
+                    context.logger.debug('no response available for response custom parameters');
+                    return null;
+                }
+                const parameters = await config.enrichResponseCustomParameters(config.getActiveConfig(), context.response.getUnderlyingResponse());
+                return CustomParametersUtils.normalizeResponseCustomParams(parameters);
+            }
+            catch (e) {
+                context.logger.error(`unable to enrich response custom params: ${e}`);
+            }
+        }
+        return null;
+    };
     CustomParametersUtils.normalizeCustomParams = (customParameters) => {
         const normalizedParams = {};
         if (customParameters && typeof customParameters === 'object') {
@@ -29,4 +45,16 @@ export var CustomParametersUtils;
         }
         return Object.keys(normalizedParams).length === 0 ? null : normalizedParams;
     };
+    CustomParametersUtils.normalizeResponseCustomParams = (customParameters) => {
+        const normalizedParams = {};
+        if (customParameters && typeof customParameters === 'object') {
+            const paramKeyRegex = /^custom_param(1[1-9]|20)$/;
+            Object.entries(customParameters).forEach(([param, value]) => {
+                if (param.match(paramKeyRegex) && value !== '') {
+                    normalizedParams[param] = value;
+                }
+            });
+        }
+        return Object.keys(normalizedParams).length === 0 ? null : normalizedParams;
+    };
 })(CustomParametersUtils || (CustomParametersUtils = {}));

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

@@ -1,4 +1,5 @@
 import { isNullOrUndefined } from '../../utils/index.js';
+import { CustomParametersUtils } from '../../custom_parameters/index.js';
 /**
  * `EnrichContextFromResponsePhase` enriches the context with response data. Each product's `enrichContextFromResponse`
  * method is called since every product may use the response data differently.
@@ -13,6 +14,7 @@ export class EnrichContextFromResponsePhase {
     async execute(context) {
         context.logger.debug('enrich context from response phase');
         await this.addProductDataToContext(context);
+        await this.addResponseCustomParametersToContext(context);
         return { done: false };
     }
     async addProductDataToContext(context) {
@@ -23,4 +25,7 @@ export class EnrichContextFromResponsePhase {
             }
         }));
     }
+    async addResponseCustomParametersToContext(context) {
+        context.responseCustomParameters = await CustomParametersUtils.createResponseCustomParameters(this.config, context);
+    }
 }

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

@@ -45,10 +45,13 @@ export class GetRiskApiClientV2 extends RiskApiClientBase {
         return isAscii(headerName) && headerValue.every((value) => isAscii(value));
     }
     addHeadersFromObject(headers, object, headerNamesMap) {
-        Object.entries(object).forEach(([key, value]) => {
-            const headerConversionObject = headerNamesMap[key];
-            if (headerConversionObject && value != null) {
-                const { header, convertToString } = headerConversionObject;
+        Object.entries(headerNamesMap).forEach(([key, headerConversionObject]) => {
+            if (!headerConversionObject) {
+                return;
+            }
+            const { header, convertToString } = headerConversionObject;
+            const value = object[key];
+            if (value != null) {
                 const strValue = convertToString
                     ? convertToString(value)
                     : typeof value === 'string'
@@ -56,6 +59,10 @@ export class GetRiskApiClientV2 extends RiskApiClientBase {
                         : `${value}`;
                 headers[header] = [strValue];
             }
+            else {
+                // delete so that user cannot spoof
+                delete headers[header];
+            }
         });
     }
     createRiskResponse(response) {

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.26.1';
+export const CORE_MODULE_VERSION = 'JS Core 0.27.0';

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

@@ -4,7 +4,7 @@ import { IConfiguration } from '../config';
 import { ProductData } from '../products';
 import { ActivityType } from './ActivityType';
 import { AdditionalS2SActivityDetails, AsyncActivity, AsyncActivityCommonDetails, AsyncActivityDetails, BlockActivityDetails, CommonActivityDetails, HeaderEntry, PageRequestedActivityDetails } from './model';
-import { CustomParameters } from '../custom_parameters';
+import { CustomParameters, ResponseCustomParameters } from '../custom_parameters';
 /**
  * Creates an async activity object based on the provided parameters.
  * @param activityType - The activity type to create.
@@ -26,7 +26,7 @@ export declare const createCommonActivityDetails: <Req, Res, Added, Removed>(con
 export declare const addRootContextDataToDetails: <Req, Res>(details: CommonActivityDetails, context: ReadonlyContext<Req, Res>) => void;
 export declare function redactCookieSecret(secret: string): string;
 export declare const addConfigDataToDetails: <Req, Res, Added, Removed>(details: CommonActivityDetails, config: IConfiguration<Req, Res, Added, Removed>) => void;
-export declare const addCustomParametersToDetails: (details: CommonActivityDetails, customParameters: CustomParameters | null) => void;
+export declare const addCustomParametersToDetails: (details: CommonActivityDetails, customParameters: CustomParameters | null, responseCustomParameters: ResponseCustomParameters | null) => void;
 export declare const addProductDataToDetails: (details: CommonActivityDetails, productData: DeepReadonly<ProductData>) => void;
 export declare const addTlsDataToDetails: (details: CommonActivityDetails, tlsData: DeepReadonly<TlsData>) => void;
 export declare const addServerDataToDetails: (details: CommonActivityDetails, serverData: DeepReadonly<ServerData>) => void;

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

@@ -1,6 +1,6 @@
 import { IConfiguration } from './IConfiguration';
 import { RemoteConfigurationParams, StaticConfigurationParams, AllConfigurationParams, RequiredAllConfigurationParams, ActiveConfigurationParams, CoreConfigurationParams } from './params';
-import { CustomParametersFunction } from '../custom_parameters';
+import { CustomParametersFunction, ResponseCustomParametersFunction } from '../custom_parameters';
 import { AdditionalActivityHandler } from '../additional_activity_handler';
 import { ILogger, LoggerSeverity } from '../logger';
 import { CustomBlockResponseHeadersHandler, CustomPreflightHandler } from '../cors';
@@ -104,6 +104,7 @@ export declare abstract class ConfigurationBase<Req, Res, Added, Removed extends
     get sensitiveGraphqlOperationNames(): Array<string | RegExp>;
     get sensitiveGraphqlOperationTypes(): string[];
     get enrichCustomParameters(): CustomParametersFunction<Req, Res, Added, Removed> | null;
+    get enrichResponseCustomParameters(): ResponseCustomParametersFunction<Req, Res, Added, Removed> | null;
     get additionalActivityHandler(): AdditionalActivityHandler<Req, Res, Added, Removed> | null;
     get altBackendCaptchaUrl(): string;
     get corsSupportEnabled(): boolean;

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

@@ -1,6 +1,6 @@
 import { ModuleMode } from '../utils';
 import { ILogger, LoggerSeverity } from '../logger';
-import { CustomParametersFunction } from '../custom_parameters';
+import { CustomParametersFunction, ResponseCustomParametersFunction } from '../custom_parameters';
 import { AdditionalActivityHandler } from '../additional_activity_handler';
 import { ActiveConfigurationParams, RemoteConfigurationParams, StaticConfigurationParams } from './params';
 import { CustomBlockResponseHeadersHandler, CustomPreflightHandler } from '../cors';
@@ -243,6 +243,10 @@ export interface IConfiguration<Req, Res, Added, Removed> {
      * A function returning CustomParameters that will be added to the enforcer activities.
      */
     readonly enrichCustomParameters: CustomParametersFunction<Req, Res, Added, Removed> | null;
+    /**
+     * A function returning ResponseCustomParameters that will be added to the enforcer activities.
+     */
+    readonly enrichResponseCustomParameters: ResponseCustomParametersFunction<Req, Res, Added, Removed> | null;
     /**
      * A function that will be called after the asynchronous activities are sent to the backend.
      */

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

@@ -3,7 +3,7 @@ import { ModuleMode } from '../../utils';
 import { CredentialEndpointConfiguration, CredentialIntelligenceVersion, CustomLoginSuccessfulCallback, LoginSuccessfulReportingMethod } from '../../products';
 import { GraphQLOperationType, ExtractGraphQLKeywordsFunction } from '../../graphql';
 import { AdditionalActivityHandler } from '../../additional_activity_handler';
-import { CustomParametersFunction } from '../../custom_parameters';
+import { CustomParametersFunction, ResponseCustomParametersFunction } from '../../custom_parameters';
 import { CustomBlockResponseHeadersHandler, CustomPreflightHandler } from '../../cors';
 import { CustomRequestFunction } from '../CustomRequestFunction';
 import { TokenVersion } from '../../risk_token';
@@ -121,6 +121,7 @@ export type CommonConfigurationParams<Req, Res, Added, Removed> = TokenV3Configu
     px_secured_pxhd_enabled?: boolean;
     px_additional_activity_handler?: AdditionalActivityHandler<Req, Res, Added, Removed> | null;
     px_enrich_custom_parameters?: CustomParametersFunction<Req, Res, Added, Removed> | null;
+    px_enrich_response_custom_parameters?: ResponseCustomParametersFunction<Req, Res, Added, Removed> | null;
     px_login_successful_custom_callback?: CustomLoginSuccessfulCallback<Res> | null;
     px_cors_custom_preflight_handler?: CustomPreflightHandler<Req> | null;
     px_cors_create_custom_block_response_headers?: CustomBlockResponseHeadersHandler<Req> | null;

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

@@ -1,6 +1,6 @@
 import { VidSource } from '../../utils';
 import { BlockAction } from '../../blocker';
-import { CustomParameters } from '../../custom_parameters';
+import { CustomParameters, ResponseCustomParameters } from '../../custom_parameters';
 import { PXDE } from '../../pxde';
 import { TokenOrigin } from '../../risk_token';
 import { RequestData } from './RequestData';
@@ -109,6 +109,13 @@ export interface IContext<Req, Res> {
      * custom parameters will be added to the activities sent to the collector.
      */
     customParameters?: CustomParameters | null;
+    /**
+     * An object with 10 additional custom parameters (11-20) that the customer can set and define
+     * based on the response from the origin. These custom parameters will be added to all async
+     * activities sent to the collector, including page_requested, (simulated) block,
+     * and additional_s2s activities.
+     */
+    responseCustomParameters?: ResponseCustomParameters | null;
     /**
      * An array of objects with information about the different GraphQL operations
      * parsed from the request.

package/lib/types/custom_parameters/CustomParameters.d.ts

@@ -1,6 +1,8 @@
 import { IS_HYPESALE_PARAM_NAME } from '../products';
 /**
- * Custom parameters defined by the user and included on all HUMAN backend requests.
+ * Custom parameters (1-10) defined by the user that will be added to all activities sent to HUMAN backend,
+ * including page_requested, block (and simulated block), and additional_s2s activities.
+ * These parameters are extracted from the incoming request.
  */
 export type CustomParameters = {
     custom_param1?: any;
@@ -15,3 +17,20 @@ export type CustomParameters = {
     custom_param10?: any;
     [IS_HYPESALE_PARAM_NAME]?: boolean;
 };
+/**
+ * Response-based custom parameters (11-20) defined by the user that will be added to all async activities sent to HUMAN backend,
+ * including page_requested, simulated block, and additional_s2s activities.
+ * These parameters are extracted from the origin response after it has been received.
+ */
+export type ResponseCustomParameters = {
+    custom_param11?: any;
+    custom_param12?: any;
+    custom_param13?: any;
+    custom_param14?: any;
+    custom_param15?: any;
+    custom_param16?: any;
+    custom_param17?: any;
+    custom_param18?: any;
+    custom_param19?: any;
+    custom_param20?: any;
+};

package/lib/types/custom_parameters/CustomParametersFunction.d.ts

@@ -1,3 +1,4 @@
-import { CustomParameters } from './CustomParameters';
+import { CustomParameters, ResponseCustomParameters } from './CustomParameters';
 import { ActiveConfigurationParams } from '../config';
 export type CustomParametersFunction<Req, Res, Added, Removed> = (config: ActiveConfigurationParams<Req, Res, Added, Removed>, request: Req) => CustomParameters | Promise<CustomParameters>;
+export type ResponseCustomParametersFunction<Req, Res, Added, Removed> = (config: ActiveConfigurationParams<Req, Res, Added, Removed>, response: Res) => ResponseCustomParameters | Promise<ResponseCustomParameters>;

package/lib/types/custom_parameters/CustomParametersUtils.d.ts

@@ -1,7 +1,9 @@
 import { IConfiguration } from '../config';
 import { ReadonlyContext } from '../context';
-import { CustomParameters } from './CustomParameters';
+import { CustomParameters, ResponseCustomParameters } from './CustomParameters';
 export declare namespace CustomParametersUtils {
     const createCustomParameters: <Req, Res, Added, Removed>(config: IConfiguration<Req, Res, Added, Removed>, context: ReadonlyContext<Req, Res>) => Promise<CustomParameters | null>;
+    const createResponseCustomParameters: <Req, Res, Added, Removed>(config: IConfiguration<Req, Res, Added, Removed>, context: ReadonlyContext<Req, Res>) => Promise<ResponseCustomParameters | null>;
     const normalizeCustomParams: (customParameters: Record<string, any>) => CustomParameters | null;
+    const normalizeResponseCustomParams: (customParameters: Record<string, any>) => ResponseCustomParameters | null;
 }

package/lib/types/custom_parameters/index.d.ts

@@ -1,3 +1,3 @@
-export { CustomParameters } from './CustomParameters';
+export { CustomParameters, ResponseCustomParameters } from './CustomParameters';
+export { CustomParametersFunction, ResponseCustomParametersFunction } from './CustomParametersFunction';
 export { CustomParametersUtils } from './CustomParametersUtils';
-export { CustomParametersFunction } from './CustomParametersFunction';

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

@@ -13,4 +13,5 @@ export declare class EnrichContextFromResponsePhase<Req, Res, Added, Removed> im
     constructor(config: IConfiguration<Req, Res, Added, Removed>, products: Products<Req, Res>);
     execute(context: IContext<Req, Res>): Promise<PhaseResult>;
     protected addProductDataToContext(context: IContext<Req, Res>): Promise<void>;
+    protected addResponseCustomParametersToContext(context: IContext<Req, Res>): Promise<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.26.1";
+export declare const CORE_MODULE_VERSION = "JS Core 0.27.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "perimeterx-js-core",
-  "version": "0.26.1",
+  "version": "0.27.0",
   "description": "",
   "type": "module",
   "typesVersions": {
@@ -35,8 +35,8 @@
     "build:esm": "tsc -p tsconfig.esm.json && tsc-alias -p tsconfig.esm.json",
     "build:dec": "tsc -p tsconfig.dec.json && tsc-alias -p tsconfig.dec.json",
     "clean": "rm -rf lib",
-    "lint": "ESLINT_USE_FLAT_CONFIG=false eslint . --ext .ts",
-    "lint:fix": "ESLINT_USE_FLAT_CONFIG=false eslint . --ext .ts --fix",
+    "lint": "eslint . --ext .ts",
+    "lint:fix": "eslint . --ext .ts --fix",
     "test": "mocha",
     "coverage": "nyc npm run test",
     "pre-commit": "./node_modules/.bin/lint-staged",
@@ -48,18 +48,18 @@
     "js-base64": "^3.7.2",
     "phin": "^3.7.0",
     "ts-essentials": "^10.0.0",
-    "uuid": "^10.0.0"
+    "uuid": "^11.1.0"
   },
   "devDependencies": {
-    "@types/chai": "^4.3.3",
-    "@types/chai-as-promised": "^7.1.5",
+    "@types/chai": "^5.2.1",
+    "@types/chai-as-promised": "^8.0.2",
     "@types/crypto-js": "^4.1.1",
     "@types/mocha": "^10.0.0",
     "@types/sinon": "^17.0.1",
     "@types/uuid": "^10.0.0",
     "@typescript-eslint/eslint-plugin": "^8.26.0",
     "@typescript-eslint/parser": "^8.26.0",
-    "chai": "^4.3.6",
+    "chai": "^5.2.0",
     "chai-as-promised": "^8.0.0",
     "core-js": "^3.19.1",
     "eslint": "^9.21.0",