@envive-ai/react-hooks 0.3.67 → 0.3.69

package/dist/hooks/PageViewedEvent/usePageViewedEvent.js

@@ -1,50 +1,25 @@
-import { VariantTypeEnum } from "../../application/models/variantInfo/variantInfo.js";
-import "../../application/models/index.js";
 import { EnviveMetricsEventName } from "../../services/amplitudeService/eventNames.js";
 import { getQueryParam } from "../../application/utils/urlsParser.js";
 import { hasParsedVariantInfoAtom, variantInfoAtom } from "../../atoms/app/variant.js";
 import { useAmplitude } from "../../contexts/amplitudeContext/amplitudeContext.js";
 import "../../contexts/amplitudeContext/index.js";
+import { extractPageViewedContext } from "../../contexts/pageContext/pageViewedContext.js";
 import { usePage } from "../../contexts/pageContext/pageContext.js";
 import "../../contexts/pageContext/index.js";
 import { useEffect, useRef } from "react";
 import { useAtomValue } from "jotai";
 
 //#region src/hooks/PageViewedEvent/usePageViewedEvent.ts
-const extractPageViewedContext = (pageVariant) => {
-	switch (pageVariant.variantType) {
-		case VariantTypeEnum.Pdp: return {
-			page_type: "pdp",
-			page_id: pageVariant.productId
-		};
-		case VariantTypeEnum.Plp: return {
-			page_type: "plp",
-			page_id: pageVariant.plpId
-		};
-		case VariantTypeEnum.Home: return {
-			page_type: "homepage",
-			page_id: pageVariant.url
-		};
-		case VariantTypeEnum.Other: return {
-			page_type: "other",
-			page_id: pageVariant.url
-		};
-		case VariantTypeEnum.PageVisit: return {
-			page_type: "other",
-			page_id: pageVariant.url
-		};
-		case VariantTypeEnum.FullPageSalesAgent: return {
-			page_type: "adaptive_storefront",
-			page_id: pageVariant.url
-		};
-		default: return null;
-	}
-};
 /**
 * Fires the [Envive] Page Viewed event once per page load when page context data is ready.
 *
 * This event captures page context information and is intended to eventually replace
 * the [Amplitude] Page Viewed event.
+*
+* @deprecated `PageProvider` (contexts/pageContext) already fires [Envive] Page Viewed;
+* mounting this hook alongside it double-fires the event. Not used by the injection
+* bundle. Retained only for compatibility with the public `./hooks/PageViewedEvent`
+* subpath and will be removed in a future breaking release.
 */
 const usePageViewedEvent = () => {
 	const hasFired = useRef(false);
@@ -81,5 +56,5 @@ const usePageViewedEvent = () => {
 };
 
 //#endregion
-export { extractPageViewedContext, usePageViewedEvent };
-//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXNlUGFnZVZpZXdlZEV2ZW50LmpzIiwibmFtZXMiOltdLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9ob29rcy9QYWdlVmlld2VkRXZlbnQvdXNlUGFnZVZpZXdlZEV2ZW50LnRzIl0sInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IHVzZUF0b21WYWx1ZSB9IGZyb20gJ2pvdGFpJztcbmltcG9ydCB7IHVzZUVmZmVjdCwgdXNlUmVmIH0gZnJvbSAncmVhY3QnO1xuaW1wb3J0IHsgVmFyaWFudFR5cGVFbnVtIH0gZnJvbSAnc3JjL2FwcGxpY2F0aW9uL21vZGVscyc7XG5pbXBvcnQgeyBnZXRRdWVyeVBhcmFtIH0gZnJvbSAnc3JjL2FwcGxpY2F0aW9uL3V0aWxzL3VybHNQYXJzZXInO1xuaW1wb3J0IHsgaGFzUGFyc2VkVmFyaWFudEluZm9BdG9tLCB2YXJpYW50SW5mb0F0b20gfSBmcm9tICdzcmMvYXRvbXMvYXBwL3ZhcmlhbnQnO1xuaW1wb3J0IHsgRW52aXZlTWV0cmljc0V2ZW50TmFtZSwgdXNlQW1wbGl0dWRlIH0gZnJvbSAnc3JjL2NvbnRleHRzL2FtcGxpdHVkZUNvbnRleHQnO1xuaW1wb3J0IHsgdXNlUGFnZSB9IGZyb20gJ3NyYy9jb250ZXh0cy9wYWdlQ29udGV4dCc7XG5pbXBvcnQge1xuICBGdWxsUGFnZVNhbGVzQWdlbnRWYXJpYW50SW5mbyxcbiAgSG9tZVZhcmlhbnRJbmZvLFxuICBPdGhlclZhcmlhbnRJbmZvLFxuICBQRFBQYWdlVmFyaWFudEluZm8sXG4gIFBMUFBhZ2VWYXJpYW50SW5mbyxcbiAgUGFnZVZhcmlhbnRJbmZvLFxuICBWaXNpdFBhZ2VWYXJpYW50SW5mbyxcbn0gZnJvbSAnc3JjL2NvbnRleHRzL3BhZ2VDb250ZXh0L3R5cGVzJztcblxuaW50ZXJmYWNlIFBhZ2VWaWV3ZWRDb250ZXh0IHtcbiAgcGFnZV90eXBlOiBzdHJpbmc7XG4gIHBhZ2VfaWQ6IHN0cmluZztcbn1cblxuZXhwb3J0IGNvbnN0IGV4dHJhY3RQYWdlVmlld2VkQ29udGV4dCA9IChcbiAgcGFnZVZhcmlhbnQ6IFBhZ2VWYXJpYW50SW5mbyxcbik6IFBhZ2VWaWV3ZWRDb250ZXh0IHwgbnVsbCA9PiB7XG4gIHN3aXRjaCAocGFnZVZhcmlhbnQudmFyaWFudFR5cGUpIHtcbiAgICBjYXNlIFZhcmlhbnRUeXBlRW51bS5QZHA6XG4gICAgICByZXR1cm4ge1xuICAgICAgICBwYWdlX3R5cGU6ICdwZHAnLFxuICAgICAgICBwYWdlX2lkOiAocGFnZVZhcmlhbnQgYXMgUERQUGFnZVZhcmlhbnRJbmZvKS5wcm9kdWN0SWQsXG4gICAgICB9O1xuICAgIGNhc2UgVmFyaWFudFR5cGVFbnVtLlBscDpcbiAgICAgIHJldHVybiB7XG4gICAgICAgIHBhZ2VfdHlwZTogJ3BscCcsXG4gICAgICAgIHBhZ2VfaWQ6IChwYWdlVmFyaWFudCBhcyBQTFBQYWdlVmFyaWFudEluZm8pLnBscElkLFxuICAgICAgfTtcbiAgICBjYXNlIFZhcmlhbnRUeXBlRW51bS5Ib21lOlxuICAgICAgcmV0dXJuIHtcbiAgICAgICAgcGFnZV90eXBlOiAnaG9tZXBhZ2UnLFxuICAgICAgICBwYWdlX2lkOiAocGFnZVZhcmlhbnQgYXMgSG9tZVZhcmlhbnRJbmZvKS51cmwsXG4gICAgICB9O1xuICAgIGNhc2UgVmFyaWFudFR5cGVFbnVtLk90aGVyOlxuICAgICAgcmV0dXJuIHtcbiAgICAgICAgcGFnZV90eXBlOiAnb3RoZXInLFxuICAgICAgICBwYWdlX2lkOiAocGFnZVZhcmlhbnQgYXMgT3RoZXJWYXJpYW50SW5mbykudXJsLFxuICAgICAgfTtcbiAgICBjYXNlIFZhcmlhbnRUeXBlRW51bS5QYWdlVmlzaXQ6XG4gICAgICByZXR1cm4ge1xuICAgICAgICBwYWdlX3R5cGU6ICdvdGhlcicsXG4gICAgICAgIHBhZ2VfaWQ6IChwYWdlVmFyaWFudCBhcyBWaXNpdFBhZ2VWYXJpYW50SW5mbykudXJsLFxuICAgICAgfTtcbiAgICBjYXNlIFZhcmlhbnRUeXBlRW51bS5GdWxsUGFnZVNhbGVzQWdlbnQ6XG4gICAgICByZXR1cm4ge1xuICAgICAgICBwYWdlX3R5cGU6ICdhZGFwdGl2ZV9zdG9yZWZyb250JyxcbiAgICAgICAgcGFnZV9pZDogKHBhZ2VWYXJpYW50IGFzIEZ1bGxQYWdlU2FsZXNBZ2VudFZhcmlhbnRJbmZvKS51cmwsXG4gICAgICB9O1xuICAgIGRlZmF1bHQ6XG4gICAgICByZXR1cm4gbnVsbDtcbiAgfVxufTtcblxuLyoqXG4gKiBGaXJlcyB0aGUgW0Vudml2ZV0gUGFnZSBWaWV3ZWQgZXZlbnQgb25jZSBwZXIgcGFnZSBsb2FkIHdoZW4gcGFnZSBjb250ZXh0IGRhdGEgaXMgcmVhZHkuXG4gKlxuICogVGhpcyBldmVudCBjYXB0dXJlcyBwYWdlIGNvbnRleHQgaW5mb3JtYXRpb24gYW5kIGlzIGludGVuZGVkIHRvIGV2ZW50dWFsbHkgcmVwbGFjZVxuICogdGhlIFtBbXBsaXR1ZGVdIFBhZ2UgVmlld2VkIGV2ZW50LlxuICovXG5leHBvcnQgY29uc3QgdXNlUGFnZVZpZXdlZEV2ZW50ID0gKCkgPT4ge1xuICBjb25zdCBoYXNGaXJlZCA9IHVzZVJlZihmYWxzZSk7XG4gIGNvbnN0IHsgdHJhY2tFdmVudCB9ID0gdXNlQW1wbGl0dWRlKCk7XG4gIGNvbnN0IHsgdmFyaWFudEluZm86IHBhZ2VWYXJpYW50SW5mbywgaXNTdXBwb3J0ZWQsIGlzTG9hZGluZyB9ID0gdXNlUGFnZSgpO1xuICBjb25zdCB2YXJpYW50SW5mbyA9IHVzZUF0b21WYWx1ZSh2YXJpYW50SW5mb0F0b20pO1xuICBjb25zdCBoYXNQYXJzZWRWYXJpYW50SW5mbyA9IHVzZUF0b21WYWx1ZShoYXNQYXJzZWRWYXJpYW50SW5mb0F0b20pO1xuXG4gIHVzZUVmZmVjdCgoKSA9PiB7XG4gICAgaWYgKGhhc0ZpcmVkLmN1cnJlbnQpIHtcbiAgICAgIHJldHVybjtcbiAgICB9XG5cbiAgICBpZiAoaXNMb2FkaW5nIHx8ICFoYXNQYXJzZWRWYXJpYW50SW5mbyB8fCAhcGFnZVZhcmlhbnRJbmZvKSB7XG4gICAgICByZXR1cm47XG4gICAgfVxuXG4gICAgY29uc3QgcGFnZUNvbnRleHQgPSBleHRyYWN0UGFnZVZpZXdlZENvbnRleHQocGFnZVZhcmlhbnRJbmZvKTtcbiAgICBpZiAoIXBhZ2VDb250ZXh0KSB7XG4gICAgICByZXR1cm47XG4gICAgfVxuXG4gICAgaGFzRmlyZWQuY3VycmVudCA9IHRydWU7XG5cbiAgICBjb25zdCBlbnZpdmVQbGFjZW1lbnQgPSBnZXRRdWVyeVBhcmFtKCdlbnZpdmVfcGxhY2VtZW50Jyk7XG5cbiAgICB0cmFja0V2ZW50KHtcbiAgICAgIGV2ZW50TmFtZTogRW52aXZlTWV0cmljc0V2ZW50TmFtZS5QYWdlVmlld2VkLFxuICAgICAgZXZlbnRQcm9wczoge1xuICAgICAgICAnY29udGV4dC5wYWdlX3R5cGUnOiBwYWdlQ29udGV4dC5wYWdlX3R5cGUsXG4gICAgICAgICdjb250ZXh0LnBhZ2VfaWQnOiBwYWdlQ29udGV4dC5wYWdlX2lkLFxuICAgICAgICAvLyBjb250ZXh0LnN1cHBvcnRlZCBhbmQgY29udGV4dC5yZWFkeSBib3RoIGRlcml2ZSBmcm9tIGlzU3VwcG9ydGVkIChyZXNwb25zZS5yZWFkeSlcbiAgICAgICAgLy8gYmVjYXVzZSB0aGUgc3VwcG9ydGVkRXZlbnRBdG9tIGlzIG5vdCBjdXJyZW50bHkgcG9wdWxhdGVkLlxuICAgICAgICAnY29udGV4dC5zdXBwb3J0ZWQnOiBpc1N1cHBvcnRlZCxcbiAgICAgICAgJ2NvbnRleHQucmVhZHknOiBpc1N1cHBvcnRlZCxcbiAgICAgICAgJ2NvbnRleHQucGFnZV92YXJpYW50X2lkJzogdmFyaWFudEluZm8udmFyaWFudElkLFxuICAgICAgICAuLi4oZW52aXZlUGxhY2VtZW50ID8geyAnY29udGV4dC5lbnZpdmVfcGxhY2VtZW50JzogZW52aXZlUGxhY2VtZW50IH0gOiB7fSksXG4gICAgICB9LFxuICAgIH0pO1xuICB9LCBbaXNMb2FkaW5nLCBpc1N1cHBvcnRlZCwgaGFzUGFyc2VkVmFyaWFudEluZm8sIHBhZ2VWYXJpYW50SW5mbywgdmFyaWFudEluZm8sIHRyYWNrRXZlbnRdKTtcbn07XG4iXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7QUFzQkEsTUFBYSw0QkFDWCxnQkFDNkI7QUFDN0IsU0FBUSxZQUFZLGFBQXBCO0VBQ0UsS0FBSyxnQkFBZ0IsSUFDbkIsUUFBTztHQUNMLFdBQVc7R0FDWCxTQUFVLFlBQW1DO0dBQzlDO0VBQ0gsS0FBSyxnQkFBZ0IsSUFDbkIsUUFBTztHQUNMLFdBQVc7R0FDWCxTQUFVLFlBQW1DO0dBQzlDO0VBQ0gsS0FBSyxnQkFBZ0IsS0FDbkIsUUFBTztHQUNMLFdBQVc7R0FDWCxTQUFVLFlBQWdDO0dBQzNDO0VBQ0gsS0FBSyxnQkFBZ0IsTUFDbkIsUUFBTztHQUNMLFdBQVc7R0FDWCxTQUFVLFlBQWlDO0dBQzVDO0VBQ0gsS0FBSyxnQkFBZ0IsVUFDbkIsUUFBTztHQUNMLFdBQVc7R0FDWCxTQUFVLFlBQXFDO0dBQ2hEO0VBQ0gsS0FBSyxnQkFBZ0IsbUJBQ25CLFFBQU87R0FDTCxXQUFXO0dBQ1gsU0FBVSxZQUE4QztHQUN6RDtFQUNILFFBQ0UsUUFBTzs7Ozs7Ozs7O0FBVWIsTUFBYSwyQkFBMkI7Q0FDdEMsTUFBTSxXQUFXLE9BQU8sTUFBTTtDQUM5QixNQUFNLEVBQUUsZUFBZSxjQUFjO0NBQ3JDLE1BQU0sRUFBRSxhQUFhLGlCQUFpQixhQUFhLGNBQWMsU0FBUztDQUMxRSxNQUFNLGNBQWMsYUFBYSxnQkFBZ0I7Q0FDakQsTUFBTSx1QkFBdUIsYUFBYSx5QkFBeUI7QUFFbkUsaUJBQWdCO0FBQ2QsTUFBSSxTQUFTLFFBQ1g7QUFHRixNQUFJLGFBQWEsQ0FBQyx3QkFBd0IsQ0FBQyxnQkFDekM7RUFHRixNQUFNLGNBQWMseUJBQXlCLGdCQUFnQjtBQUM3RCxNQUFJLENBQUMsWUFDSDtBQUdGLFdBQVMsVUFBVTtFQUVuQixNQUFNLGtCQUFrQixjQUFjLG1CQUFtQjtBQUV6RCxhQUFXO0dBQ1QsV0FBVyx1QkFBdUI7R0FDbEMsWUFBWTtJQUNWLHFCQUFxQixZQUFZO0lBQ2pDLG1CQUFtQixZQUFZO0lBRy9CLHFCQUFxQjtJQUNyQixpQkFBaUI7SUFDakIsMkJBQTJCLFlBQVk7SUFDdkMsR0FBSSxrQkFBa0IsRUFBRSw0QkFBNEIsaUJBQWlCLEdBQUcsRUFBRTtJQUMzRTtHQUNGLENBQUM7SUFDRDtFQUFDO0VBQVc7RUFBYTtFQUFzQjtFQUFpQjtFQUFhO0VBQVcsQ0FBQyJ9
+export { usePageViewedEvent };
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXNlUGFnZVZpZXdlZEV2ZW50LmpzIiwibmFtZXMiOltdLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9ob29rcy9QYWdlVmlld2VkRXZlbnQvdXNlUGFnZVZpZXdlZEV2ZW50LnRzIl0sInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IHVzZUF0b21WYWx1ZSB9IGZyb20gJ2pvdGFpJztcbmltcG9ydCB7IHVzZUVmZmVjdCwgdXNlUmVmIH0gZnJvbSAncmVhY3QnO1xuaW1wb3J0IHsgZ2V0UXVlcnlQYXJhbSB9IGZyb20gJ3NyYy9hcHBsaWNhdGlvbi91dGlscy91cmxzUGFyc2VyJztcbmltcG9ydCB7IGhhc1BhcnNlZFZhcmlhbnRJbmZvQXRvbSwgdmFyaWFudEluZm9BdG9tIH0gZnJvbSAnc3JjL2F0b21zL2FwcC92YXJpYW50JztcbmltcG9ydCB7IEVudml2ZU1ldHJpY3NFdmVudE5hbWUsIHVzZUFtcGxpdHVkZSB9IGZyb20gJ3NyYy9jb250ZXh0cy9hbXBsaXR1ZGVDb250ZXh0JztcbmltcG9ydCB7IHVzZVBhZ2UgfSBmcm9tICdzcmMvY29udGV4dHMvcGFnZUNvbnRleHQnO1xuaW1wb3J0IHsgZXh0cmFjdFBhZ2VWaWV3ZWRDb250ZXh0IH0gZnJvbSAnc3JjL2NvbnRleHRzL3BhZ2VDb250ZXh0L3BhZ2VWaWV3ZWRDb250ZXh0JztcblxuLy8gUmUtZXhwb3J0ZWQgZm9yIGNvbXBhdGliaWxpdHkgd2l0aCB0aGUgcHVibGljIC4vaG9va3MvUGFnZVZpZXdlZEV2ZW50IHN1YnBhdGguXG5leHBvcnQgeyBleHRyYWN0UGFnZVZpZXdlZENvbnRleHQgfTtcblxuLyoqXG4gKiBGaXJlcyB0aGUgW0Vudml2ZV0gUGFnZSBWaWV3ZWQgZXZlbnQgb25jZSBwZXIgcGFnZSBsb2FkIHdoZW4gcGFnZSBjb250ZXh0IGRhdGEgaXMgcmVhZHkuXG4gKlxuICogVGhpcyBldmVudCBjYXB0dXJlcyBwYWdlIGNvbnRleHQgaW5mb3JtYXRpb24gYW5kIGlzIGludGVuZGVkIHRvIGV2ZW50dWFsbHkgcmVwbGFjZVxuICogdGhlIFtBbXBsaXR1ZGVdIFBhZ2UgVmlld2VkIGV2ZW50LlxuICpcbiAqIEBkZXByZWNhdGVkIGBQYWdlUHJvdmlkZXJgIChjb250ZXh0cy9wYWdlQ29udGV4dCkgYWxyZWFkeSBmaXJlcyBbRW52aXZlXSBQYWdlIFZpZXdlZDtcbiAqIG1vdW50aW5nIHRoaXMgaG9vayBhbG9uZ3NpZGUgaXQgZG91YmxlLWZpcmVzIHRoZSBldmVudC4gTm90IHVzZWQgYnkgdGhlIGluamVjdGlvblxuICogYnVuZGxlLiBSZXRhaW5lZCBvbmx5IGZvciBjb21wYXRpYmlsaXR5IHdpdGggdGhlIHB1YmxpYyBgLi9ob29rcy9QYWdlVmlld2VkRXZlbnRgXG4gKiBzdWJwYXRoIGFuZCB3aWxsIGJlIHJlbW92ZWQgaW4gYSBmdXR1cmUgYnJlYWtpbmcgcmVsZWFzZS5cbiAqL1xuZXhwb3J0IGNvbnN0IHVzZVBhZ2VWaWV3ZWRFdmVudCA9ICgpID0+IHtcbiAgY29uc3QgaGFzRmlyZWQgPSB1c2VSZWYoZmFsc2UpO1xuICBjb25zdCB7IHRyYWNrRXZlbnQgfSA9IHVzZUFtcGxpdHVkZSgpO1xuICBjb25zdCB7IHZhcmlhbnRJbmZvOiBwYWdlVmFyaWFudEluZm8sIGlzU3VwcG9ydGVkLCBpc0xvYWRpbmcgfSA9IHVzZVBhZ2UoKTtcbiAgY29uc3QgdmFyaWFudEluZm8gPSB1c2VBdG9tVmFsdWUodmFyaWFudEluZm9BdG9tKTtcbiAgY29uc3QgaGFzUGFyc2VkVmFyaWFudEluZm8gPSB1c2VBdG9tVmFsdWUoaGFzUGFyc2VkVmFyaWFudEluZm9BdG9tKTtcblxuICB1c2VFZmZlY3QoKCkgPT4ge1xuICAgIGlmIChoYXNGaXJlZC5jdXJyZW50KSB7XG4gICAgICByZXR1cm47XG4gICAgfVxuXG4gICAgaWYgKGlzTG9hZGluZyB8fCAhaGFzUGFyc2VkVmFyaWFudEluZm8gfHwgIXBhZ2VWYXJpYW50SW5mbykge1xuICAgICAgcmV0dXJuO1xuICAgIH1cblxuICAgIGNvbnN0IHBhZ2VDb250ZXh0ID0gZXh0cmFjdFBhZ2VWaWV3ZWRDb250ZXh0KHBhZ2VWYXJpYW50SW5mbyk7XG4gICAgaWYgKCFwYWdlQ29udGV4dCkge1xuICAgICAgcmV0dXJuO1xuICAgIH1cblxuICAgIGhhc0ZpcmVkLmN1cnJlbnQgPSB0cnVlO1xuXG4gICAgY29uc3QgZW52aXZlUGxhY2VtZW50ID0gZ2V0UXVlcnlQYXJhbSgnZW52aXZlX3BsYWNlbWVudCcpO1xuXG4gICAgdHJhY2tFdmVudCh7XG4gICAgICBldmVudE5hbWU6IEVudml2ZU1ldHJpY3NFdmVudE5hbWUuUGFnZVZpZXdlZCxcbiAgICAgIGV2ZW50UHJvcHM6IHtcbiAgICAgICAgJ2NvbnRleHQucGFnZV90eXBlJzogcGFnZUNvbnRleHQucGFnZV90eXBlLFxuICAgICAgICAnY29udGV4dC5wYWdlX2lkJzogcGFnZUNvbnRleHQucGFnZV9pZCxcbiAgICAgICAgLy8gY29udGV4dC5zdXBwb3J0ZWQgYW5kIGNvbnRleHQucmVhZHkgYm90aCBkZXJpdmUgZnJvbSBpc1N1cHBvcnRlZCAocmVzcG9uc2UucmVhZHkpXG4gICAgICAgIC8vIGJlY2F1c2UgdGhlIHN1cHBvcnRlZEV2ZW50QXRvbSBpcyBub3QgY3VycmVudGx5IHBvcHVsYXRlZC5cbiAgICAgICAgJ2NvbnRleHQuc3VwcG9ydGVkJzogaXNTdXBwb3J0ZWQsXG4gICAgICAgICdjb250ZXh0LnJlYWR5JzogaXNTdXBwb3J0ZWQsXG4gICAgICAgICdjb250ZXh0LnBhZ2VfdmFyaWFudF9pZCc6IHZhcmlhbnRJbmZvLnZhcmlhbnRJZCxcbiAgICAgICAgLi4uKGVudml2ZVBsYWNlbWVudCA/IHsgJ2NvbnRleHQuZW52aXZlX3BsYWNlbWVudCc6IGVudml2ZVBsYWNlbWVudCB9IDoge30pLFxuICAgICAgfSxcbiAgICB9KTtcbiAgfSwgW2lzTG9hZGluZywgaXNTdXBwb3J0ZWQsIGhhc1BhcnNlZFZhcmlhbnRJbmZvLCBwYWdlVmFyaWFudEluZm8sIHZhcmlhbnRJbmZvLCB0cmFja0V2ZW50XSk7XG59O1xuIl0sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQXNCQSxNQUFhLDJCQUEyQjtDQUN0QyxNQUFNLFdBQVcsT0FBTyxNQUFNO0NBQzlCLE1BQU0sRUFBRSxlQUFlLGNBQWM7Q0FDckMsTUFBTSxFQUFFLGFBQWEsaUJBQWlCLGFBQWEsY0FBYyxTQUFTO0NBQzFFLE1BQU0sY0FBYyxhQUFhLGdCQUFnQjtDQUNqRCxNQUFNLHVCQUF1QixhQUFhLHlCQUF5QjtBQUVuRSxpQkFBZ0I7QUFDZCxNQUFJLFNBQVMsUUFDWDtBQUdGLE1BQUksYUFBYSxDQUFDLHdCQUF3QixDQUFDLGdCQUN6QztFQUdGLE1BQU0sY0FBYyx5QkFBeUIsZ0JBQWdCO0FBQzdELE1BQUksQ0FBQyxZQUNIO0FBR0YsV0FBUyxVQUFVO0VBRW5CLE1BQU0sa0JBQWtCLGNBQWMsbUJBQW1CO0FBRXpELGFBQVc7R0FDVCxXQUFXLHVCQUF1QjtHQUNsQyxZQUFZO0lBQ1YscUJBQXFCLFlBQVk7SUFDakMsbUJBQW1CLFlBQVk7SUFHL0IscUJBQXFCO0lBQ3JCLGlCQUFpQjtJQUNqQiwyQkFBMkIsWUFBWTtJQUN2QyxHQUFJLGtCQUFrQixFQUFFLDRCQUE0QixpQkFBaUIsR0FBRyxFQUFFO0lBQzNFO0dBQ0YsQ0FBQztJQUNEO0VBQUM7RUFBVztFQUFhO0VBQXNCO0VBQWlCO0VBQWE7RUFBVyxDQUFDIn0=

package/dist/hooks/utils.d.cts

@@ -19,4 +19,4 @@ declare enum SearchResultsState {
 declare const getSearchResultsState: (isLoadingSearch: boolean, searchData: SearchResult | null) => SearchResultsState;
 //#endregion
 export { SearchResultsState, createAppLoadedEvent, createVisitUserEvent, getSearchResultsState, isElementPartiallyVisible, isWithinBusinessHours };
-//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuZC5jdHMiLCJuYW1lcyI6W10sInNvdXJjZXMiOlsiLi4vLi4vc3JjL2hvb2tzL3V0aWxzLmQudHMiXSwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgU2VhcmNoUmVzdWx0IH0gZnJvbSAnc3JjL2FwcGxpY2F0aW9uL21vZGVscy9hcGkvc2VhcmNoJztcbmltcG9ydCB7IFVzZXJFdmVudCwgVmFyaWFudEluZm8gfSBmcm9tICdzcmMvYXBwbGljYXRpb24vbW9kZWxzJztcbmV4cG9ydCBkZWNsYXJlIGNvbnN0IGlzRWxlbWVudFBhcnRpYWxseVZpc2libGU6IChlbD86IEhUTUxEaXZFbGVtZW50IHwgbnVsbCkgPT4gYm9vbGVhbjtcbmV4cG9ydCBkZWNsYXJlIGNvbnN0IGNyZWF0ZUFwcExvYWRlZEV2ZW50OiAoKSA9PiBVc2VyRXZlbnQ7XG5leHBvcnQgZGVjbGFyZSBjb25zdCBjcmVhdGVWaXNpdFVzZXJFdmVudDogKHsgdmFyaWFudEluZm8sIH06IHtcbiAgICB2YXJpYW50SW5mbzogVmFyaWFudEluZm87XG59KSA9PiBVc2VyRXZlbnQgfCB1bmRlZmluZWQ7XG5leHBvcnQgZGVjbGFyZSBjb25zdCBpc1dpdGhpbkJ1c2luZXNzSG91cnM6IChzdGFydFRpbWU6IHN0cmluZywgZW5kVGltZTogc3RyaW5nLCB0aW1lWm9uZTogc3RyaW5nKSA9PiBib29sZWFuO1xuZXhwb3J0IGRlY2xhcmUgZW51bSBTZWFyY2hSZXN1bHRzU3RhdGUge1xuICAgIExvYWRpbmcgPSAwLFxuICAgIFJlc3VsdHMgPSAxLFxuICAgIE5vUmVzdWx0cyA9IDJcbn1cbmV4cG9ydCBkZWNsYXJlIGNvbnN0IGdldFNlYXJjaFJlc3VsdHNTdGF0ZTogKGlzTG9hZGluZ1NlYXJjaDogYm9vbGVhbiwgc2VhcmNoRGF0YTogU2VhcmNoUmVzdWx0IHwgbnVsbCkgPT4gU2VhcmNoUmVzdWx0c1N0YXRlO1xuIl0sIm1hcHBpbmdzIjoiOzs7OztBQUVBLElBQVcsNEJBQTRCLENBQUMsU0FBUyxlQUFlO0FBQ2hFLElBQVcsdUJBQXVCLENBQUMsU0FBUyxVQUFVO0FBQ3RELElBQVcsdUJBQXVCO0NBQUM7T0FBUztPQUFrQjtPQUFBO0NBQUE7QUFDOUQsSUFBVyx3QkFBaUIsQ0FBQSxFQUFBO0FBQzVCLElBQVcscUJBQWdCLENBQUEsRUFBQTtBQUMzQixJQUFXLHdCQUF3QjtDQUFDO09BQVM7T0FBb0I7Q0FBbUIifQ==
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuZC5jdHMiLCJuYW1lcyI6W10sInNvdXJjZXMiOlsiLi4vLi4vc3JjL2hvb2tzL3V0aWxzLmQudHMiXSwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgU2VhcmNoUmVzdWx0IH0gZnJvbSAnc3JjL2FwcGxpY2F0aW9uL21vZGVscy9hcGkvc2VhcmNoJztcbmltcG9ydCB7IFVzZXJFdmVudCwgVmFyaWFudEluZm8gfSBmcm9tICdzcmMvYXBwbGljYXRpb24vbW9kZWxzJztcbmV4cG9ydCBkZWNsYXJlIGNvbnN0IGlzRWxlbWVudFBhcnRpYWxseVZpc2libGU6IChlbD86IEhUTUxEaXZFbGVtZW50IHwgbnVsbCkgPT4gYm9vbGVhbjtcbmV4cG9ydCBkZWNsYXJlIGNvbnN0IGNyZWF0ZUFwcExvYWRlZEV2ZW50OiAoKSA9PiBVc2VyRXZlbnQ7XG5leHBvcnQgZGVjbGFyZSBjb25zdCBjcmVhdGVWaXNpdFVzZXJFdmVudDogKHsgdmFyaWFudEluZm8sIH06IHtcbiAgICB2YXJpYW50SW5mbzogVmFyaWFudEluZm87XG59KSA9PiBVc2VyRXZlbnQgfCB1bmRlZmluZWQ7XG5leHBvcnQgZGVjbGFyZSBjb25zdCBpc1dpdGhpbkJ1c2luZXNzSG91cnM6IChzdGFydFRpbWU6IHN0cmluZywgZW5kVGltZTogc3RyaW5nLCB0aW1lWm9uZTogc3RyaW5nKSA9PiBib29sZWFuO1xuZXhwb3J0IGRlY2xhcmUgZW51bSBTZWFyY2hSZXN1bHRzU3RhdGUge1xuICAgIExvYWRpbmcgPSAwLFxuICAgIFJlc3VsdHMgPSAxLFxuICAgIE5vUmVzdWx0cyA9IDJcbn1cbmV4cG9ydCBkZWNsYXJlIGNvbnN0IGdldFNlYXJjaFJlc3VsdHNTdGF0ZTogKGlzTG9hZGluZ1NlYXJjaDogYm9vbGVhbiwgc2VhcmNoRGF0YTogU2VhcmNoUmVzdWx0IHwgbnVsbCkgPT4gU2VhcmNoUmVzdWx0c1N0YXRlO1xuIl0sIm1hcHBpbmdzIjoiOzs7OztBQUVBLElBQVcsNEJBQTRCLENBQUMsV0FBVyxlQUFlO0FBQ2xFLElBQVcsdUJBQXVCLENBQUMsV0FBVyxVQUFVO0FBQ3hELElBQVcsdUJBQXVCO0NBQUM7T0FBVztPQUFnQjtPQUFBO0NBQUE7QUFDOUQsSUFBVyx3QkFBaUIsQ0FBQSxJQUFBO0FBQzVCLElBQVcscUJBQWdCLENBQUEsSUFBQTtBQUMzQixJQUFXLHdCQUF3QjtDQUFDO09BQVc7T0FBb0I7Q0FBbUIifQ==

package/dist/hooks/utils.d.ts

@@ -19,4 +19,4 @@ declare enum SearchResultsState {
 declare const getSearchResultsState: (isLoadingSearch: boolean, searchData: SearchResult | null) => SearchResultsState;
 //#endregion
 export { SearchResultsState, createAppLoadedEvent, createVisitUserEvent, getSearchResultsState, isElementPartiallyVisible, isWithinBusinessHours };
-//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuZC50cyIsIm5hbWVzIjpbXSwic291cmNlcyI6WyIuLi8uLi9zcmMvaG9va3MvdXRpbHMuZC50cyJdLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBTZWFyY2hSZXN1bHQgfSBmcm9tICdzcmMvYXBwbGljYXRpb24vbW9kZWxzL2FwaS9zZWFyY2gnO1xuaW1wb3J0IHsgVXNlckV2ZW50LCBWYXJpYW50SW5mbyB9IGZyb20gJ3NyYy9hcHBsaWNhdGlvbi9tb2RlbHMnO1xuZXhwb3J0IGRlY2xhcmUgY29uc3QgaXNFbGVtZW50UGFydGlhbGx5VmlzaWJsZTogKGVsPzogSFRNTERpdkVsZW1lbnQgfCBudWxsKSA9PiBib29sZWFuO1xuZXhwb3J0IGRlY2xhcmUgY29uc3QgY3JlYXRlQXBwTG9hZGVkRXZlbnQ6ICgpID0+IFVzZXJFdmVudDtcbmV4cG9ydCBkZWNsYXJlIGNvbnN0IGNyZWF0ZVZpc2l0VXNlckV2ZW50OiAoeyB2YXJpYW50SW5mbywgfToge1xuICAgIHZhcmlhbnRJbmZvOiBWYXJpYW50SW5mbztcbn0pID0+IFVzZXJFdmVudCB8IHVuZGVmaW5lZDtcbmV4cG9ydCBkZWNsYXJlIGNvbnN0IGlzV2l0aGluQnVzaW5lc3NIb3VyczogKHN0YXJ0VGltZTogc3RyaW5nLCBlbmRUaW1lOiBzdHJpbmcsIHRpbWVab25lOiBzdHJpbmcpID0+IGJvb2xlYW47XG5leHBvcnQgZGVjbGFyZSBlbnVtIFNlYXJjaFJlc3VsdHNTdGF0ZSB7XG4gICAgTG9hZGluZyA9IDAsXG4gICAgUmVzdWx0cyA9IDEsXG4gICAgTm9SZXN1bHRzID0gMlxufVxuZXhwb3J0IGRlY2xhcmUgY29uc3QgZ2V0U2VhcmNoUmVzdWx0c1N0YXRlOiAoaXNMb2FkaW5nU2VhcmNoOiBib29sZWFuLCBzZWFyY2hEYXRhOiBTZWFyY2hSZXN1bHQgfCBudWxsKSA9PiBTZWFyY2hSZXN1bHRzU3RhdGU7XG4iXSwibWFwcGluZ3MiOiI7Ozs7O0FBRUEsSUFBVyw0QkFBNEIsQ0FBQyxTQUFTLGVBQWU7QUFDaEUsSUFBVyx1QkFBdUIsQ0FBQyxTQUFTLFVBQVU7QUFDdEQsSUFBVyx1QkFBdUI7Q0FBQztPQUFTO09BQWtCO09BQUE7Q0FBQTtBQUM5RCxJQUFXLHdCQUFpQixDQUFBLEVBQUE7QUFDNUIsSUFBVyxxQkFBZ0IsQ0FBQSxFQUFBO0FBQzNCLElBQVcsd0JBQXdCO0NBQUM7T0FBUztPQUFvQjtDQUFtQiJ9
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuZC50cyIsIm5hbWVzIjpbXSwic291cmNlcyI6WyIuLi8uLi9zcmMvaG9va3MvdXRpbHMuZC50cyJdLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBTZWFyY2hSZXN1bHQgfSBmcm9tICdzcmMvYXBwbGljYXRpb24vbW9kZWxzL2FwaS9zZWFyY2gnO1xuaW1wb3J0IHsgVXNlckV2ZW50LCBWYXJpYW50SW5mbyB9IGZyb20gJ3NyYy9hcHBsaWNhdGlvbi9tb2RlbHMnO1xuZXhwb3J0IGRlY2xhcmUgY29uc3QgaXNFbGVtZW50UGFydGlhbGx5VmlzaWJsZTogKGVsPzogSFRNTERpdkVsZW1lbnQgfCBudWxsKSA9PiBib29sZWFuO1xuZXhwb3J0IGRlY2xhcmUgY29uc3QgY3JlYXRlQXBwTG9hZGVkRXZlbnQ6ICgpID0+IFVzZXJFdmVudDtcbmV4cG9ydCBkZWNsYXJlIGNvbnN0IGNyZWF0ZVZpc2l0VXNlckV2ZW50OiAoeyB2YXJpYW50SW5mbywgfToge1xuICAgIHZhcmlhbnRJbmZvOiBWYXJpYW50SW5mbztcbn0pID0+IFVzZXJFdmVudCB8IHVuZGVmaW5lZDtcbmV4cG9ydCBkZWNsYXJlIGNvbnN0IGlzV2l0aGluQnVzaW5lc3NIb3VyczogKHN0YXJ0VGltZTogc3RyaW5nLCBlbmRUaW1lOiBzdHJpbmcsIHRpbWVab25lOiBzdHJpbmcpID0+IGJvb2xlYW47XG5leHBvcnQgZGVjbGFyZSBlbnVtIFNlYXJjaFJlc3VsdHNTdGF0ZSB7XG4gICAgTG9hZGluZyA9IDAsXG4gICAgUmVzdWx0cyA9IDEsXG4gICAgTm9SZXN1bHRzID0gMlxufVxuZXhwb3J0IGRlY2xhcmUgY29uc3QgZ2V0U2VhcmNoUmVzdWx0c1N0YXRlOiAoaXNMb2FkaW5nU2VhcmNoOiBib29sZWFuLCBzZWFyY2hEYXRhOiBTZWFyY2hSZXN1bHQgfCBudWxsKSA9PiBTZWFyY2hSZXN1bHRzU3RhdGU7XG4iXSwibWFwcGluZ3MiOiI7Ozs7O0FBRUEsSUFBVyw0QkFBNEIsQ0FBQyxXQUFXLGVBQWU7QUFDbEUsSUFBVyx1QkFBdUIsQ0FBQyxXQUFXLFVBQVU7QUFDeEQsSUFBVyx1QkFBdUI7Q0FBQztPQUFXO09BQWdCO09BQUE7Q0FBQTtBQUM5RCxJQUFXLHdCQUFpQixDQUFBLElBQUE7QUFDNUIsSUFBVyxxQkFBZ0IsQ0FBQSxJQUFBO0FBQzNCLElBQVcsd0JBQXdCO0NBQUM7T0FBVztPQUFvQjtDQUFtQiJ9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@envive-ai/react-hooks",
-  "version": "0.3.67",
+  "version": "0.3.69",
   "description": "React hooks for connecting to Envive AI services.",
   "keywords": [
     "react",

package/src/contexts/pageContext/__tests__/pageContext.test.tsx

@@ -1,12 +1,13 @@
 import { PageVisitCategory, UserEventCategory } from '@spiffy-ai/commerce-api-client';
 import { act, render, screen, waitFor } from '@testing-library/react';
-import { Provider, useAtom } from 'jotai';
+import { Provider, createStore, useAtom } from 'jotai';
 import React from 'react';
 import CommerceApiClient from 'src/application/commerce-api';
 import Logger from 'src/application/logging/logger';
 import { VariantTypeEnum } from 'src/application/models';
 import {
   UrlResolverResponse,
+  hasParsedVariantInfoAtom,
   pageUserEventAtom,
   pageVariantInfoAtom,
   urlResolverAtom,
@@ -19,14 +20,11 @@ vi.spyOn(Logger.prototype, 'logInfo').mockImplementation(() => {});
 vi.spyOn(Logger.prototype, 'logWarn').mockImplementation(() => {});
 vi.spyOn(Logger.prototype, 'logError').mockImplementation(() => {});
 
+// Mock useAmplitude (PageProvider dispatches page viewed event internally)
+const { mockTrackEvent } = vi.hoisted(() => ({ mockTrackEvent: vi.fn() }));
 vi.mock('src/contexts/amplitudeContext', () => ({
-  useAmplitude: () => ({
-    trackEvent: vi.fn(),
-    isReady: true,
-  }),
-  EnviveMetricsEventName: {
-    PageViewed: 'Page Viewed',
-  },
+  EnviveMetricsEventName: { PageViewed: 'Page Viewed' },
+  useAmplitude: () => ({ trackEvent: mockTrackEvent, isReady: true }),
 }));
 
 // Mock CommerceApiClient
@@ -37,12 +35,6 @@ vi.mock('src/application/commerce-api', () => ({
   },
 }));
 
-// Mock useAmplitude (PageProvider dispatches page viewed event internally)
-vi.mock('src/contexts/amplitudeContext', () => ({
-  EnviveMetricsEventName: { PageViewed: 'Page Viewed' },
-  useAmplitude: () => ({ trackEvent: vi.fn() }),
-}));
-
 // Component that uses the usePage hook
 const MockComponent: React.FC = () => {
   const context = usePage();
@@ -771,6 +763,92 @@ describe('PageProvider', () => {
     });
   });
 
+  describe('Page Viewed event', () => {
+    const pdpResponse: UrlResolverResponse = {
+      variant_type: VariantTypeEnum.Pdp,
+      specific_details: { pdp_attributes: { product_id: 'product-123' } },
+      ready: true,
+    };
+
+    type TrackEventArg = { eventName: string; eventProps: Record<string, unknown> };
+    // hasParsedVariantInfoAtom is normally set by useUpdateAnalyticsProps elsewhere in the
+    // app; seed it so PageProvider's Page Viewed gate opens.
+    const renderWithParsedVariantInfo = () => {
+      const store = createStore();
+      store.set(hasParsedVariantInfoAtom, true);
+      return render(
+        <Provider store={store}>
+          <PageProvider previewMode={false}>
+            <MockComponent />
+          </PageProvider>
+        </Provider>,
+      );
+    };
+
+    const getPageViewedProps = () =>
+      (mockTrackEvent.mock.calls as [TrackEventArg][]).find(
+        ([arg]) => arg.eventName === 'Page Viewed',
+      )?.[0].eventProps;
+
+    it('includes context.envive_placement when the envive_placement param is present', async () => {
+      mockResolveUrl.mockResolvedValue(pdpResponse);
+      window.location.href =
+        'https://example.com/product?envive_campaign=spring&envive_placement=homepage-banner';
+
+      renderWithParsedVariantInfo();
+
+      await waitFor(() => expect(getPageViewedProps()).toBeDefined());
+      expect(getPageViewedProps()).toMatchObject({
+        'context.page_type': 'pdp',
+        'context.page_id': 'product-123',
+        'context.envive_placement': 'homepage-banner',
+      });
+    });
+
+    it('keeps the placement captured at mount when the URL is rewritten before Page Viewed fires', async () => {
+      let resolveUrl: (value: UrlResolverResponse) => void = () => {};
+      mockResolveUrl.mockReturnValue(
+        new Promise<UrlResolverResponse>(resolve => {
+          resolveUrl = resolve;
+        }),
+      );
+      window.location.href = 'https://example.com/product?envive_placement=homepage-banner';
+
+      renderWithParsedVariantInfo();
+
+      // e.g. a theme's history.replaceState('?variant=…') while url_resolving is in flight
+      window.location.href = 'https://example.com/product?variant=123';
+      await act(async () => {
+        resolveUrl(pdpResponse);
+      });
+
+      await waitFor(() => expect(getPageViewedProps()).toBeDefined());
+      expect(getPageViewedProps()).toMatchObject({
+        'context.envive_placement': 'homepage-banner',
+      });
+    });
+
+    it('omits context.envive_placement when the param is absent', async () => {
+      mockResolveUrl.mockResolvedValue(pdpResponse);
+      window.location.href = 'https://example.com/product';
+
+      renderWithParsedVariantInfo();
+
+      await waitFor(() => expect(getPageViewedProps()).toBeDefined());
+      expect(getPageViewedProps()).not.toHaveProperty('context.envive_placement');
+    });
+
+    it('omits context.envive_placement when the param is empty', async () => {
+      mockResolveUrl.mockResolvedValue(pdpResponse);
+      window.location.href = 'https://example.com/product?envive_placement=';
+
+      renderWithParsedVariantInfo();
+
+      await waitFor(() => expect(getPageViewedProps()).toBeDefined());
+      expect(getPageViewedProps()).not.toHaveProperty('context.envive_placement');
+    });
+  });
+
   describe('Context Value Memoization', () => {
     it('should memoize context value to prevent unnecessary re-renders', async () => {
       const mockResponse: UrlResolverResponse = {

package/src/contexts/pageContext/index.ts

@@ -1,2 +1,3 @@
 export * from './pageContext';
 export * from './mapping';
+export * from './pageViewedContext';

package/src/contexts/pageContext/pageContext.tsx

@@ -20,9 +20,11 @@ import { useAtom, useAtomValue } from 'jotai';
 import { VariantTypeEnum } from 'src/application/models';
 import CommerceApiClient from 'src/application/commerce-api';
 import Logger from 'src/application/logging/logger';
+import { parseHref } from 'src/application/utils/urlsParser';
 import { PageVisitCategory, UserEventCategory } from '@spiffy-ai/commerce-api-client';
 import { EnviveMetricsEventName, useAmplitude } from 'src/contexts/amplitudeContext';
 import { mapApiUserEventToUserEvent, mapUrlResolverResponseToVariantInfo } from './mapping';
+import { extractPageViewedContext } from './pageViewedContext';
 import { PageDetails } from './types';
 
 const logger = new Logger('pageContext');
@@ -43,6 +45,15 @@ export const PageProvider: React.FC<{
   onUrlResolverNotReady?: (error: Error) => Promise<unknown> | void;
 }> = ({ children, previewMode = false, onUrlResolverNotReady }) => {
   const [pageUrl, setPageUrl] = useState<string | undefined>(undefined);
+  // Merchant-tagged on-site placement (?envive_placement=…) for entry-source attribution,
+  // captured on first render: theme/consent scripts can rewrite the URL (replaceState) before
+  // the Page Viewed event fires after URL resolution. Empty/absent → undefined (key omitted).
+  const [initialEnvivePlacement] = useState(
+    () =>
+      parseHref(typeof window !== 'undefined' ? window.location.href : '').urlSearchParams?.get(
+        'envive_placement',
+      ) || undefined,
+  );
   const [urlResolverResponse, setUrlResolverResponse] = useAtom(urlResolverAtom);
   const [isLoading, setIsLoading] = useState(false);
   const [variantInfo, setVariantInfo] = useAtom(pageVariantInfoAtom);
@@ -197,36 +208,9 @@ export const PageProvider: React.FC<{
       return;
     }
 
-    let pageType: string;
-    let pageId: string;
-
-    switch (variantInfo.variantType) {
-      case VariantTypeEnum.Pdp:
-        pageType = 'pdp';
-        pageId = variantInfo.productId;
-        break;
-      case VariantTypeEnum.Plp:
-        pageType = 'plp';
-        pageId = variantInfo.plpId;
-        break;
-      case VariantTypeEnum.Home:
-        pageType = 'homepage';
-        pageId = variantInfo.url;
-        break;
-      case VariantTypeEnum.Other:
-        pageType = 'other';
-        pageId = variantInfo.url;
-        break;
-      case VariantTypeEnum.PageVisit:
-        pageType = 'other';
-        pageId = variantInfo.url;
-        break;
-      case VariantTypeEnum.FullPageSalesAgent:
-        pageType = 'adaptive_storefront';
-        pageId = variantInfo.url;
-        break;
-      default:
-        return;
+    const pageViewedContext = extractPageViewedContext(variantInfo);
+    if (!pageViewedContext) {
+      return;
     }
 
     pageViewedFired.current = true;
@@ -234,14 +218,23 @@ export const PageProvider: React.FC<{
     trackEvent({
       eventName: EnviveMetricsEventName.PageViewed,
       eventProps: {
-        'context.page_type': pageType,
-        'context.page_id': pageId,
+        'context.page_type': pageViewedContext.page_type,
+        'context.page_id': pageViewedContext.page_id,
         'context.supported': isSupported,
         'context.ready': isSupported,
         'context.page_variant_id': resolvedVariantInfo.variantId,
+        ...(initialEnvivePlacement ? { 'context.envive_placement': initialEnvivePlacement } : {}),
       },
     });
-  }, [isLoading, isSupported, hasParsedVariantInfo, variantInfo, resolvedVariantInfo, trackEvent]);
+  }, [
+    isLoading,
+    isSupported,
+    hasParsedVariantInfo,
+    variantInfo,
+    resolvedVariantInfo,
+    trackEvent,
+    initialEnvivePlacement,
+  ]);
 
   const setPageUrlStable = useCallback((url: string) => {
     setPageUrl(url);

package/src/contexts/pageContext/pageViewedContext.ts

@@ -0,0 +1,59 @@
+import { VariantTypeEnum } from 'src/application/models';
+import {
+  FullPageSalesAgentVariantInfo,
+  HomeVariantInfo,
+  OtherVariantInfo,
+  PDPPageVariantInfo,
+  PLPPageVariantInfo,
+  PageVariantInfo,
+  VisitPageVariantInfo,
+} from './types';
+
+export interface PageViewedContext {
+  page_type: string;
+  page_id: string;
+}
+
+/**
+ * Maps a resolved page variant to the `context.page_type` / `context.page_id` pair sent on
+ * [Envive] Page Viewed. Single source of truth for that mapping — returns null for variant
+ * types that don't emit the event.
+ */
+export const extractPageViewedContext = (
+  pageVariant: PageVariantInfo,
+): PageViewedContext | null => {
+  switch (pageVariant.variantType) {
+    case VariantTypeEnum.Pdp:
+      return {
+        page_type: 'pdp',
+        page_id: (pageVariant as PDPPageVariantInfo).productId,
+      };
+    case VariantTypeEnum.Plp:
+      return {
+        page_type: 'plp',
+        page_id: (pageVariant as PLPPageVariantInfo).plpId,
+      };
+    case VariantTypeEnum.Home:
+      return {
+        page_type: 'homepage',
+        page_id: (pageVariant as HomeVariantInfo).url,
+      };
+    case VariantTypeEnum.Other:
+      return {
+        page_type: 'other',
+        page_id: (pageVariant as OtherVariantInfo).url,
+      };
+    case VariantTypeEnum.PageVisit:
+      return {
+        page_type: 'other',
+        page_id: (pageVariant as VisitPageVariantInfo).url,
+      };
+    case VariantTypeEnum.FullPageSalesAgent:
+      return {
+        page_type: 'adaptive_storefront',
+        page_id: (pageVariant as FullPageSalesAgentVariantInfo).url,
+      };
+    default:
+      return null;
+  }
+};

package/src/contexts/typesV3.ts

@@ -1,7 +1,11 @@
 import { FloatingButtonLocation } from '@envive-ai/react-toolkit-v3/FloatingButton';
 import { ImageGalleryImage, ImageGalleryLayout } from '@envive-ai/react-toolkit-v3/ImageGallery';
 import { PromptButtonVariant } from '@envive-ai/react-toolkit-v3/PromptButton';
-import { AnimationSpeed, PromptCarouselRows } from '@envive-ai/react-toolkit-v3/PromptCarousel';
+import {
+  AnimationSpeed,
+  PromptCarouselLayout,
+  PromptCarouselRows,
+} from '@envive-ai/react-toolkit-v3/PromptCarousel';
 import { DynamicLayout, WidgetKind } from '@envive-ai/react-toolkit-v3/SocialProof';
 import { Theme } from '@envive-ai/react-toolkit-v3/Tokens';
 import { SparkleIconColor } from '@envive-ai/react-toolkit-v3/WelcomeMessage';
@@ -387,6 +391,7 @@ interface ProductCardWidgetV3Config extends BaseWidgetConfig<WidgetTypeV3.Produc
   fallbackColor?: string;
   imageSrc?: string;
   mode?: Mode;
+  promptButtonLayout?: PromptCarouselLayout;
 }
 
 export enum ProductCarouselLayoutV3 {

package/src/hooks/PageViewedEvent/usePageViewedEvent.ts

@@ -1,69 +1,24 @@
 import { useAtomValue } from 'jotai';
 import { useEffect, useRef } from 'react';
-import { VariantTypeEnum } from 'src/application/models';
 import { getQueryParam } from 'src/application/utils/urlsParser';
 import { hasParsedVariantInfoAtom, variantInfoAtom } from 'src/atoms/app/variant';
 import { EnviveMetricsEventName, useAmplitude } from 'src/contexts/amplitudeContext';
 import { usePage } from 'src/contexts/pageContext';
-import {
-  FullPageSalesAgentVariantInfo,
-  HomeVariantInfo,
-  OtherVariantInfo,
-  PDPPageVariantInfo,
-  PLPPageVariantInfo,
-  PageVariantInfo,
-  VisitPageVariantInfo,
-} from 'src/contexts/pageContext/types';
+import { extractPageViewedContext } from 'src/contexts/pageContext/pageViewedContext';
 
-interface PageViewedContext {
-  page_type: string;
-  page_id: string;
-}
-
-export const extractPageViewedContext = (
-  pageVariant: PageVariantInfo,
-): PageViewedContext | null => {
-  switch (pageVariant.variantType) {
-    case VariantTypeEnum.Pdp:
-      return {
-        page_type: 'pdp',
-        page_id: (pageVariant as PDPPageVariantInfo).productId,
-      };
-    case VariantTypeEnum.Plp:
-      return {
-        page_type: 'plp',
-        page_id: (pageVariant as PLPPageVariantInfo).plpId,
-      };
-    case VariantTypeEnum.Home:
-      return {
-        page_type: 'homepage',
-        page_id: (pageVariant as HomeVariantInfo).url,
-      };
-    case VariantTypeEnum.Other:
-      return {
-        page_type: 'other',
-        page_id: (pageVariant as OtherVariantInfo).url,
-      };
-    case VariantTypeEnum.PageVisit:
-      return {
-        page_type: 'other',
-        page_id: (pageVariant as VisitPageVariantInfo).url,
-      };
-    case VariantTypeEnum.FullPageSalesAgent:
-      return {
-        page_type: 'adaptive_storefront',
-        page_id: (pageVariant as FullPageSalesAgentVariantInfo).url,
-      };
-    default:
-      return null;
-  }
-};
+// Re-exported for compatibility with the public ./hooks/PageViewedEvent subpath.
+export { extractPageViewedContext };
 
 /**
  * Fires the [Envive] Page Viewed event once per page load when page context data is ready.
  *
  * This event captures page context information and is intended to eventually replace
  * the [Amplitude] Page Viewed event.
+ *
+ * @deprecated `PageProvider` (contexts/pageContext) already fires [Envive] Page Viewed;
+ * mounting this hook alongside it double-fires the event. Not used by the injection
+ * bundle. Retained only for compatibility with the public `./hooks/PageViewedEvent`
+ * subpath and will be removed in a future breaking release.
  */
 export const usePageViewedEvent = () => {
   const hasFired = useRef(false);