@envive-ai/react-hooks 0.3.19 → 0.3.20

package/dist/hooks/PageViewedEvent/usePageViewedEvent.js

@@ -0,0 +1,82 @@
+import { VariantTypeEnum } from "../../application/models/variantInfo/variantInfo.js";
+import "../../application/models/index.js";
+import { EnviveMetricsEventName } from "../../services/amplitudeService/eventNames.js";
+import { hasParsedVariantInfoAtom, variantInfoAtom } from "../../atoms/app/variant.js";
+import { useAmplitude } from "../../contexts/amplitudeContext/amplitudeContext.js";
+import "../../contexts/amplitudeContext/index.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: "full_page_sales_agent",
+			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.
+*/
+const usePageViewedEvent = () => {
+	const hasFired = useRef(false);
+	const { trackEvent } = useAmplitude();
+	const { variantInfo: pageVariantInfo, isSupported, isLoading } = usePage();
+	const variantInfo = useAtomValue(variantInfoAtom);
+	const hasParsedVariantInfo = useAtomValue(hasParsedVariantInfoAtom);
+	useEffect(() => {
+		if (hasFired.current) return;
+		if (isLoading || !hasParsedVariantInfo || !pageVariantInfo) return;
+		const pageContext = extractPageViewedContext(pageVariantInfo);
+		if (!pageContext) return;
+		hasFired.current = true;
+		trackEvent({
+			eventName: EnviveMetricsEventName.PageViewed,
+			eventProps: {
+				"context.page_type": pageContext.page_type,
+				"context.page_id": pageContext.page_id,
+				"context.supported": isSupported,
+				"context.ready": isSupported,
+				"context.page_variant_id": variantInfo.variantId
+			}
+		});
+	}, [
+		isLoading,
+		isSupported,
+		hasParsedVariantInfo,
+		pageVariantInfo,
+		variantInfo,
+		trackEvent
+	]);
+};
+
+//#endregion
+export { extractPageViewedContext, usePageViewedEvent };
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXNlUGFnZVZpZXdlZEV2ZW50LmpzIiwibmFtZXMiOltdLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9ob29rcy9QYWdlVmlld2VkRXZlbnQvdXNlUGFnZVZpZXdlZEV2ZW50LnRzIl0sInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IHVzZUF0b21WYWx1ZSB9IGZyb20gJ2pvdGFpJztcbmltcG9ydCB7IHVzZUVmZmVjdCwgdXNlUmVmIH0gZnJvbSAncmVhY3QnO1xuaW1wb3J0IHsgVmFyaWFudFR5cGVFbnVtIH0gZnJvbSAnc3JjL2FwcGxpY2F0aW9uL21vZGVscyc7XG5pbXBvcnQgeyBoYXNQYXJzZWRWYXJpYW50SW5mb0F0b20sIHZhcmlhbnRJbmZvQXRvbSB9IGZyb20gJ3NyYy9hdG9tcy9hcHAvdmFyaWFudCc7XG5pbXBvcnQgeyBFbnZpdmVNZXRyaWNzRXZlbnROYW1lLCB1c2VBbXBsaXR1ZGUgfSBmcm9tICdzcmMvY29udGV4dHMvYW1wbGl0dWRlQ29udGV4dCc7XG5pbXBvcnQgeyB1c2VQYWdlIH0gZnJvbSAnc3JjL2NvbnRleHRzL3BhZ2VDb250ZXh0JztcbmltcG9ydCB7XG4gIEZ1bGxQYWdlU2FsZXNBZ2VudFZhcmlhbnRJbmZvLFxuICBIb21lVmFyaWFudEluZm8sXG4gIE90aGVyVmFyaWFudEluZm8sXG4gIFBEUFBhZ2VWYXJpYW50SW5mbyxcbiAgUExQUGFnZVZhcmlhbnRJbmZvLFxuICBQYWdlVmFyaWFudEluZm8sXG4gIFZpc2l0UGFnZVZhcmlhbnRJbmZvLFxufSBmcm9tICdzcmMvY29udGV4dHMvcGFnZUNvbnRleHQvdHlwZXMnO1xuXG5pbnRlcmZhY2UgUGFnZVZpZXdlZENvbnRleHQge1xuICBwYWdlX3R5cGU6IHN0cmluZztcbiAgcGFnZV9pZDogc3RyaW5nO1xufVxuXG5leHBvcnQgY29uc3QgZXh0cmFjdFBhZ2VWaWV3ZWRDb250ZXh0ID0gKFxuICBwYWdlVmFyaWFudDogUGFnZVZhcmlhbnRJbmZvLFxuKTogUGFnZVZpZXdlZENvbnRleHQgfCBudWxsID0+IHtcbiAgc3dpdGNoIChwYWdlVmFyaWFudC52YXJpYW50VHlwZSkge1xuICAgIGNhc2UgVmFyaWFudFR5cGVFbnVtLlBkcDpcbiAgICAgIHJldHVybiB7XG4gICAgICAgIHBhZ2VfdHlwZTogJ3BkcCcsXG4gICAgICAgIHBhZ2VfaWQ6IChwYWdlVmFyaWFudCBhcyBQRFBQYWdlVmFyaWFudEluZm8pLnByb2R1Y3RJZCxcbiAgICAgIH07XG4gICAgY2FzZSBWYXJpYW50VHlwZUVudW0uUGxwOlxuICAgICAgcmV0dXJuIHtcbiAgICAgICAgcGFnZV90eXBlOiAncGxwJyxcbiAgICAgICAgcGFnZV9pZDogKHBhZ2VWYXJpYW50IGFzIFBMUFBhZ2VWYXJpYW50SW5mbykucGxwSWQsXG4gICAgICB9O1xuICAgIGNhc2UgVmFyaWFudFR5cGVFbnVtLkhvbWU6XG4gICAgICByZXR1cm4ge1xuICAgICAgICBwYWdlX3R5cGU6ICdob21lcGFnZScsXG4gICAgICAgIHBhZ2VfaWQ6IChwYWdlVmFyaWFudCBhcyBIb21lVmFyaWFudEluZm8pLnVybCxcbiAgICAgIH07XG4gICAgY2FzZSBWYXJpYW50VHlwZUVudW0uT3RoZXI6XG4gICAgICByZXR1cm4ge1xuICAgICAgICBwYWdlX3R5cGU6ICdvdGhlcicsXG4gICAgICAgIHBhZ2VfaWQ6IChwYWdlVmFyaWFudCBhcyBPdGhlclZhcmlhbnRJbmZvKS51cmwsXG4gICAgICB9O1xuICAgIGNhc2UgVmFyaWFudFR5cGVFbnVtLlBhZ2VWaXNpdDpcbiAgICAgIHJldHVybiB7XG4gICAgICAgIHBhZ2VfdHlwZTogJ290aGVyJyxcbiAgICAgICAgcGFnZV9pZDogKHBhZ2VWYXJpYW50IGFzIFZpc2l0UGFnZVZhcmlhbnRJbmZvKS51cmwsXG4gICAgICB9O1xuICAgIGNhc2UgVmFyaWFudFR5cGVFbnVtLkZ1bGxQYWdlU2FsZXNBZ2VudDpcbiAgICAgIHJldHVybiB7XG4gICAgICAgIHBhZ2VfdHlwZTogJ2Z1bGxfcGFnZV9zYWxlc19hZ2VudCcsXG4gICAgICAgIHBhZ2VfaWQ6IChwYWdlVmFyaWFudCBhcyBGdWxsUGFnZVNhbGVzQWdlbnRWYXJpYW50SW5mbykudXJsLFxuICAgICAgfTtcbiAgICBkZWZhdWx0OlxuICAgICAgcmV0dXJuIG51bGw7XG4gIH1cbn07XG5cbi8qKlxuICogRmlyZXMgdGhlIFtFbnZpdmVdIFBhZ2UgVmlld2VkIGV2ZW50IG9uY2UgcGVyIHBhZ2UgbG9hZCB3aGVuIHBhZ2UgY29udGV4dCBkYXRhIGlzIHJlYWR5LlxuICpcbiAqIFRoaXMgZXZlbnQgY2FwdHVyZXMgcGFnZSBjb250ZXh0IGluZm9ybWF0aW9uIGFuZCBpcyBpbnRlbmRlZCB0byBldmVudHVhbGx5IHJlcGxhY2VcbiAqIHRoZSBbQW1wbGl0dWRlXSBQYWdlIFZpZXdlZCBldmVudC5cbiAqL1xuZXhwb3J0IGNvbnN0IHVzZVBhZ2VWaWV3ZWRFdmVudCA9ICgpID0+IHtcbiAgY29uc3QgaGFzRmlyZWQgPSB1c2VSZWYoZmFsc2UpO1xuICBjb25zdCB7IHRyYWNrRXZlbnQgfSA9IHVzZUFtcGxpdHVkZSgpO1xuICBjb25zdCB7IHZhcmlhbnRJbmZvOiBwYWdlVmFyaWFudEluZm8sIGlzU3VwcG9ydGVkLCBpc0xvYWRpbmcgfSA9IHVzZVBhZ2UoKTtcbiAgY29uc3QgdmFyaWFudEluZm8gPSB1c2VBdG9tVmFsdWUodmFyaWFudEluZm9BdG9tKTtcbiAgY29uc3QgaGFzUGFyc2VkVmFyaWFudEluZm8gPSB1c2VBdG9tVmFsdWUoaGFzUGFyc2VkVmFyaWFudEluZm9BdG9tKTtcblxuICB1c2VFZmZlY3QoKCkgPT4ge1xuICAgIGlmIChoYXNGaXJlZC5jdXJyZW50KSB7XG4gICAgICByZXR1cm47XG4gICAgfVxuXG4gICAgaWYgKGlzTG9hZGluZyB8fCAhaGFzUGFyc2VkVmFyaWFudEluZm8gfHwgIXBhZ2VWYXJpYW50SW5mbykge1xuICAgICAgcmV0dXJuO1xuICAgIH1cblxuICAgIGNvbnN0IHBhZ2VDb250ZXh0ID0gZXh0cmFjdFBhZ2VWaWV3ZWRDb250ZXh0KHBhZ2VWYXJpYW50SW5mbyk7XG4gICAgaWYgKCFwYWdlQ29udGV4dCkge1xuICAgICAgcmV0dXJuO1xuICAgIH1cblxuICAgIGhhc0ZpcmVkLmN1cnJlbnQgPSB0cnVlO1xuXG4gICAgdHJhY2tFdmVudCh7XG4gICAgICBldmVudE5hbWU6IEVudml2ZU1ldHJpY3NFdmVudE5hbWUuUGFnZVZpZXdlZCxcbiAgICAgIGV2ZW50UHJvcHM6IHtcbiAgICAgICAgJ2NvbnRleHQucGFnZV90eXBlJzogcGFnZUNvbnRleHQucGFnZV90eXBlLFxuICAgICAgICAnY29udGV4dC5wYWdlX2lkJzogcGFnZUNvbnRleHQucGFnZV9pZCxcbiAgICAgICAgLy8gY29udGV4dC5zdXBwb3J0ZWQgYW5kIGNvbnRleHQucmVhZHkgYm90aCBkZXJpdmUgZnJvbSBpc1N1cHBvcnRlZCAocmVzcG9uc2UucmVhZHkpXG4gICAgICAgIC8vIGJlY2F1c2UgdGhlIHN1cHBvcnRlZEV2ZW50QXRvbSBpcyBub3QgY3VycmVudGx5IHBvcHVsYXRlZC5cbiAgICAgICAgJ2NvbnRleHQuc3VwcG9ydGVkJzogaXNTdXBwb3J0ZWQsXG4gICAgICAgICdjb250ZXh0LnJlYWR5JzogaXNTdXBwb3J0ZWQsXG4gICAgICAgICdjb250ZXh0LnBhZ2VfdmFyaWFudF9pZCc6IHZhcmlhbnRJbmZvLnZhcmlhbnRJZCxcbiAgICAgIH0sXG4gICAgfSk7XG4gIH0sIFtpc0xvYWRpbmcsIGlzU3VwcG9ydGVkLCBoYXNQYXJzZWRWYXJpYW50SW5mbywgcGFnZVZhcmlhbnRJbmZvLCB2YXJpYW50SW5mbywgdHJhY2tFdmVudF0pO1xufTtcbiJdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7O0FBcUJBLE1BQWEsNEJBQ1gsZ0JBQzZCO0FBQzdCLFNBQVEsWUFBWSxhQUFwQjtFQUNFLEtBQUssZ0JBQWdCLElBQ25CLFFBQU87R0FDTCxXQUFXO0dBQ1gsU0FBVSxZQUFtQztHQUM5QztFQUNILEtBQUssZ0JBQWdCLElBQ25CLFFBQU87R0FDTCxXQUFXO0dBQ1gsU0FBVSxZQUFtQztHQUM5QztFQUNILEtBQUssZ0JBQWdCLEtBQ25CLFFBQU87R0FDTCxXQUFXO0dBQ1gsU0FBVSxZQUFnQztHQUMzQztFQUNILEtBQUssZ0JBQWdCLE1BQ25CLFFBQU87R0FDTCxXQUFXO0dBQ1gsU0FBVSxZQUFpQztHQUM1QztFQUNILEtBQUssZ0JBQWdCLFVBQ25CLFFBQU87R0FDTCxXQUFXO0dBQ1gsU0FBVSxZQUFxQztHQUNoRDtFQUNILEtBQUssZ0JBQWdCLG1CQUNuQixRQUFPO0dBQ0wsV0FBVztHQUNYLFNBQVUsWUFBOEM7R0FDekQ7RUFDSCxRQUNFLFFBQU87Ozs7Ozs7OztBQVViLE1BQWEsMkJBQTJCO0NBQ3RDLE1BQU0sV0FBVyxPQUFPLE1BQU07Q0FDOUIsTUFBTSxFQUFFLGVBQWUsY0FBYztDQUNyQyxNQUFNLEVBQUUsYUFBYSxpQkFBaUIsYUFBYSxjQUFjLFNBQVM7Q0FDMUUsTUFBTSxjQUFjLGFBQWEsZ0JBQWdCO0NBQ2pELE1BQU0sdUJBQXVCLGFBQWEseUJBQXlCO0FBRW5FLGlCQUFnQjtBQUNkLE1BQUksU0FBUyxRQUNYO0FBR0YsTUFBSSxhQUFhLENBQUMsd0JBQXdCLENBQUMsZ0JBQ3pDO0VBR0YsTUFBTSxjQUFjLHlCQUF5QixnQkFBZ0I7QUFDN0QsTUFBSSxDQUFDLFlBQ0g7QUFHRixXQUFTLFVBQVU7QUFFbkIsYUFBVztHQUNULFdBQVcsdUJBQXVCO0dBQ2xDLFlBQVk7SUFDVixxQkFBcUIsWUFBWTtJQUNqQyxtQkFBbUIsWUFBWTtJQUcvQixxQkFBcUI7SUFDckIsaUJBQWlCO0lBQ2pCLDJCQUEyQixZQUFZO0lBQ3hDO0dBQ0YsQ0FBQztJQUNEO0VBQUM7RUFBVztFQUFhO0VBQXNCO0VBQWlCO0VBQWE7RUFBVyxDQUFDIn0=

package/dist/hooks/SystemSettingsContext/useSystemSettingsContext.d.cts

@@ -1,12 +1,12 @@
 import { GenerationParams } from "../../application/models/api/generationParams.cjs";
-import * as react1 from "react";
+import * as react0 from "react";
 
 //#region src/hooks/SystemSettingsContext/useSystemSettingsContext.d.ts
 declare const useSystemSettingsContext: () => {
   generationParams?: GenerationParams;
   showDebugBar?: boolean;
   endpointURL?: string;
-  setGenerationParams: react1.Dispatch<react1.SetStateAction<GenerationParams | undefined>>;
+  setGenerationParams: react0.Dispatch<react0.SetStateAction<GenerationParams | undefined>>;
 };
 //#endregion
 export { useSystemSettingsContext };

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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuZC5jdHMiLCJuYW1lcyI6W10sInNvdXJjZXMiOlsiLi4vLi4vc3JjL2hvb2tzL3V0aWxzLmQudHMiXSwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgU2VhcmNoUmVzdWx0IH0gZnJvbSAnc3JjL2FwcGxpY2F0aW9uL21vZGVscy9hcGkvc2VhcmNoJztcbmltcG9ydCB7IFVzZXJFdmVudCwgVmFyaWFudEluZm8gfSBmcm9tICdzcmMvYXBwbGljYXRpb24vbW9kZWxzJztcbmV4cG9ydCBkZWNsYXJlIGNvbnN0IGlzRWxlbWVudFBhcnRpYWxseVZpc2libGU6IChlbD86IEhUTUxEaXZFbGVtZW50IHwgbnVsbCkgPT4gYm9vbGVhbjtcbmV4cG9ydCBkZWNsYXJlIGNvbnN0IGNyZWF0ZUFwcExvYWRlZEV2ZW50OiAoKSA9PiBVc2VyRXZlbnQ7XG5leHBvcnQgZGVjbGFyZSBjb25zdCBjcmVhdGVWaXNpdFVzZXJFdmVudDogKHsgdmFyaWFudEluZm8sIH06IHtcbiAgICB2YXJpYW50SW5mbzogVmFyaWFudEluZm87XG59KSA9PiBVc2VyRXZlbnQgfCB1bmRlZmluZWQ7XG5leHBvcnQgZGVjbGFyZSBjb25zdCBpc1dpdGhpbkJ1c2luZXNzSG91cnM6IChzdGFydFRpbWU6IHN0cmluZywgZW5kVGltZTogc3RyaW5nLCB0aW1lWm9uZTogc3RyaW5nKSA9PiBib29sZWFuO1xuZXhwb3J0IGRlY2xhcmUgZW51bSBTZWFyY2hSZXN1bHRzU3RhdGUge1xuICAgIExvYWRpbmcgPSAwLFxuICAgIFJlc3VsdHMgPSAxLFxuICAgIE5vUmVzdWx0cyA9IDJcbn1cbmV4cG9ydCBkZWNsYXJlIGNvbnN0IGdldFNlYXJjaFJlc3VsdHNTdGF0ZTogKGlzTG9hZGluZ1NlYXJjaDogYm9vbGVhbiwgc2VhcmNoRGF0YTogU2VhcmNoUmVzdWx0IHwgbnVsbCkgPT4gU2VhcmNoUmVzdWx0c1N0YXRlO1xuIl0sIm1hcHBpbmdzIjoiOzs7OztBQUVBLElBQVcsNEJBQTRCLENBQUMsV0FBVyxlQUFlO0FBQ2xFLElBQVcsdUJBQXVCLENBQUMsV0FBVyxVQUFVO0FBQ3hELElBQVcsdUJBQXVCO0NBQUM7T0FBVztPQUFnQjtPQUFBO0NBQUE7QUFDOUQsSUFBVyx3QkFBaUIsQ0FBQSxJQUFBO0FBQzVCLElBQVcscUJBQWdCLENBQUEsSUFBQTtBQUMzQixJQUFXLHdCQUF3QjtDQUFDO09BQVc7T0FBb0I7Q0FBbUIifQ==
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuZC5jdHMiLCJuYW1lcyI6W10sInNvdXJjZXMiOlsiLi4vLi4vc3JjL2hvb2tzL3V0aWxzLmQudHMiXSwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgU2VhcmNoUmVzdWx0IH0gZnJvbSAnc3JjL2FwcGxpY2F0aW9uL21vZGVscy9hcGkvc2VhcmNoJztcbmltcG9ydCB7IFVzZXJFdmVudCwgVmFyaWFudEluZm8gfSBmcm9tICdzcmMvYXBwbGljYXRpb24vbW9kZWxzJztcbmV4cG9ydCBkZWNsYXJlIGNvbnN0IGlzRWxlbWVudFBhcnRpYWxseVZpc2libGU6IChlbD86IEhUTUxEaXZFbGVtZW50IHwgbnVsbCkgPT4gYm9vbGVhbjtcbmV4cG9ydCBkZWNsYXJlIGNvbnN0IGNyZWF0ZUFwcExvYWRlZEV2ZW50OiAoKSA9PiBVc2VyRXZlbnQ7XG5leHBvcnQgZGVjbGFyZSBjb25zdCBjcmVhdGVWaXNpdFVzZXJFdmVudDogKHsgdmFyaWFudEluZm8sIH06IHtcbiAgICB2YXJpYW50SW5mbzogVmFyaWFudEluZm87XG59KSA9PiBVc2VyRXZlbnQgfCB1bmRlZmluZWQ7XG5leHBvcnQgZGVjbGFyZSBjb25zdCBpc1dpdGhpbkJ1c2luZXNzSG91cnM6IChzdGFydFRpbWU6IHN0cmluZywgZW5kVGltZTogc3RyaW5nLCB0aW1lWm9uZTogc3RyaW5nKSA9PiBib29sZWFuO1xuZXhwb3J0IGRlY2xhcmUgZW51bSBTZWFyY2hSZXN1bHRzU3RhdGUge1xuICAgIExvYWRpbmcgPSAwLFxuICAgIFJlc3VsdHMgPSAxLFxuICAgIE5vUmVzdWx0cyA9IDJcbn1cbmV4cG9ydCBkZWNsYXJlIGNvbnN0IGdldFNlYXJjaFJlc3VsdHNTdGF0ZTogKGlzTG9hZGluZ1NlYXJjaDogYm9vbGVhbiwgc2VhcmNoRGF0YTogU2VhcmNoUmVzdWx0IHwgbnVsbCkgPT4gU2VhcmNoUmVzdWx0c1N0YXRlO1xuIl0sIm1hcHBpbmdzIjoiOzs7OztBQUVBLElBQVcsNEJBQTRCLENBQUMsU0FBUyxlQUFlO0FBQ2hFLElBQVcsdUJBQXVCLENBQUMsU0FBUyxVQUFVO0FBQ3RELElBQVcsdUJBQXVCO0NBQUM7T0FBUztPQUFrQjtPQUFBO0NBQUE7QUFDOUQsSUFBVyx3QkFBaUIsQ0FBQSxFQUFBO0FBQzVCLElBQVcscUJBQWdCLENBQUEsRUFBQTtBQUMzQixJQUFXLHdCQUF3QjtDQUFDO09BQVM7T0FBb0I7Q0FBbUIifQ==

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+IGJvb2xlYW47XG5leHBvcnQgZGVjbGFyZSBlbnVtIFNlYXJjaFJlc3VsdHNTdGF0ZSB7XG4gICAgTG9hZGluZyA9IDAsXG4gICAgUmVzdWx0cyA9IDEsXG4gICAgTm9SZXN1bHRzID0gMlxufVxuZXhwb3J0IGRlY2xhcmUgY29uc3QgZ2V0U2VhcmNoUmVzdWx0c1N0YXRlOiAoaXNMb2FkaW5nU2VhcmNoOiBib29sZWFuLCBzZWFyY2hEYXRhOiBTZWFyY2hSZXN1bHQgfCBudWxsKSA9PiBTZWFyY2hSZXN1bHRzU3RhdGU7XG4iXSwibWFwcGluZ3MiOiI7Ozs7O0FBRUEsSUFBVyw0QkFBNEIsQ0FBQyxVQUFVLGVBQWU7QUFDakUsSUFBVyx1QkFBdUIsQ0FBQyxVQUFVLFVBQVU7QUFDdkQsSUFBVyx1QkFBdUI7Q0FBQztPQUFVO09BQWlCO09BQUE7Q0FBQTtBQUM5RCxJQUFXLHdCQUFpQixDQUFBLEdBQUE7QUFDNUIsSUFBVyxxQkFBZ0IsQ0FBQSxHQUFBO0FBQzNCLElBQVcsd0JBQXdCO0NBQUM7T0FBVTtPQUFvQjtDQUFtQiJ9
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuZC50cyIsIm5hbWVzIjpbXSwic291cmNlcyI6WyIuLi8uLi9zcmMvaG9va3MvdXRpbHMuZC50cyJdLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBTZWFyY2hSZXN1bHQgfSBmcm9tICdzcmMvYXBwbGljYXRpb24vbW9kZWxzL2FwaS9zZWFyY2gnO1xuaW1wb3J0IHsgVXNlckV2ZW50LCBWYXJpYW50SW5mbyB9IGZyb20gJ3NyYy9hcHBsaWNhdGlvbi9tb2RlbHMnO1xuZXhwb3J0IGRlY2xhcmUgY29uc3QgaXNFbGVtZW50UGFydGlhbGx5VmlzaWJsZTogKGVsPzogSFRNTERpdkVsZW1lbnQgfCBudWxsKSA9PiBib29sZWFuO1xuZXhwb3J0IGRlY2xhcmUgY29uc3QgY3JlYXRlQXBwTG9hZGVkRXZlbnQ6ICgpID0+IFVzZXJFdmVudDtcbmV4cG9ydCBkZWNsYXJlIGNvbnN0IGNyZWF0ZVZpc2l0VXNlckV2ZW50OiAoeyB2YXJpYW50SW5mbywgfToge1xuICAgIHZhcmlhbnRJbmZvOiBWYXJpYW50SW5mbztcbn0pID0+IFVzZXJFdmVudCB8IHVuZGVmaW5lZDtcbmV4cG9ydCBkZWNsYXJlIGNvbnN0IGlzV2l0aGluQnVzaW5lc3NIb3VyczogKHN0YXJ0VGltZTogc3RyaW5nLCBlbmRUaW1lOiBzdHJpbmcsIHRpbWVab25lOiBzdHJpbmcpID0+IGJvb2xlYW47XG5leHBvcnQgZGVjbGFyZSBlbnVtIFNlYXJjaFJlc3VsdHNTdGF0ZSB7XG4gICAgTG9hZGluZyA9IDAsXG4gICAgUmVzdWx0cyA9IDEsXG4gICAgTm9SZXN1bHRzID0gMlxufVxuZXhwb3J0IGRlY2xhcmUgY29uc3QgZ2V0U2VhcmNoUmVzdWx0c1N0YXRlOiAoaXNMb2FkaW5nU2VhcmNoOiBib29sZWFuLCBzZWFyY2hEYXRhOiBTZWFyY2hSZXN1bHQgfCBudWxsKSA9PiBTZWFyY2hSZXN1bHRzU3RhdGU7XG4iXSwibWFwcGluZ3MiOiI7Ozs7O0FBRUEsSUFBVyw0QkFBNEIsQ0FBQyxTQUFTLGVBQWU7QUFDaEUsSUFBVyx1QkFBdUIsQ0FBQyxTQUFTLFVBQVU7QUFDdEQsSUFBVyx1QkFBdUI7Q0FBQztPQUFTO09BQWtCO09BQUE7Q0FBQTtBQUM5RCxJQUFXLHdCQUFpQixDQUFBLEVBQUE7QUFDNUIsSUFBVyxxQkFBZ0IsQ0FBQSxFQUFBO0FBQzNCLElBQVcsd0JBQXdCO0NBQUM7T0FBUztPQUFvQjtDQUFtQiJ9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@envive-ai/react-hooks",
-  "version": "0.3.19",
+  "version": "0.3.20",
   "description": "React hooks for connecting to Envive AI services.",
   "keywords": [
     "react",
@@ -342,6 +342,10 @@
       "import": "./dist/hooks/NewOrgConfig/index.js",
       "require": "./dist/hooks/NewOrgConfig/index.cjs"
     },
+    "./hooks/PageViewedEvent": {
+      "import": "./dist/hooks/PageViewedEvent/index.js",
+      "require": "./dist/hooks/PageViewedEvent/index.cjs"
+    },
     "./hooks/ProductImageUrl": {
       "import": "./dist/hooks/ProductImageUrl/index.js",
       "require": "./dist/hooks/ProductImageUrl/index.cjs"

package/src/contexts/enviveContext/enviveContext.tsx

@@ -1,4 +1,4 @@
-import { ReactNode, useEffect, useMemo, useState } from 'react';
+import { ReactNode, useCallback, useEffect, useMemo, useRef, useState } from 'react';
 
 import { OrgConfigFeatureGate } from 'src/application/models/api/orgConfigResults';
 import { EnviveConfigService, EnviveServiceConfig } from 'src/services/enviveConfigService';
@@ -30,6 +30,12 @@ interface AgentWrapperProps {
   enabledAgents: EnviveAgent[];
 }
 
+export interface ExtensionStatusCallbacks {
+  onInjectionLoading?: () => Promise<unknown> | void;
+  onInjectionSuccess?: () => Promise<unknown> | void;
+  onInjectionError?: (error: Error) => Promise<unknown> | void;
+}
+
 interface EnviveProviderProps extends AgentWrapperProps {
   amplitudeApiKey?: string;
   dataResidency?: string;
@@ -58,6 +64,7 @@ interface EnviveProviderProps extends AgentWrapperProps {
   overrideConfig?: GraphQlConfigValues;
   mockSalesAgentData?: any;
   hardcopyOverride?: Partial<Record<WidgetTypeV3, HardcopyResponse>>;
+  extensionService?: ExtensionStatusCallbacks;
 }
 
 const SearchAgentWrapper: React.FC<AgentWrapperProps> = ({ children, enabledAgents }) => {
@@ -108,9 +115,34 @@ export const EnviveProvider: React.FC<EnviveProviderProps> = ({
   requestV3Config = false,
   mockSalesAgentData,
   hardcopyOverride,
+  extensionService,
   ...config
 }) => {
   const [userId, setUserId] = useState<string>('');
+  const didReportSuccessRef = useRef(false);
+
+  const invokeExtensionCallback = useCallback((callback?: () => Promise<unknown> | void) => {
+    if (!callback) {
+      return;
+    }
+
+    Promise.resolve(callback()).catch(error => {
+      logger.logDebug('Extension status callback failed', error);
+    });
+  }, []);
+
+  const invokeExtensionErrorCallback = useCallback(
+    (error: Error) => {
+      if (!extensionService?.onInjectionError) {
+        return;
+      }
+
+      Promise.resolve(extensionService.onInjectionError(error)).catch(callbackError => {
+        logger.logDebug('Extension error callback failed', callbackError);
+      });
+    },
+    [extensionService],
+  );
 
   const userIdService = useMemo(
     () =>
@@ -133,6 +165,8 @@ export const EnviveProvider: React.FC<EnviveProviderProps> = ({
   const [enviveServiceConfig, setEnviveServiceConfig] = useState<EnviveServiceConfig | null>(null);
 
   useEffect(() => {
+    invokeExtensionCallback(extensionService?.onInjectionLoading);
+
     // Really not happy with this approach, but I'm seeing 429 errors in the tests
     // because of the rate limiting on the API.
     const enviveConfigService =
@@ -144,11 +178,38 @@ export const EnviveProvider: React.FC<EnviveProviderProps> = ({
         namespace: namespace || '',
         source: source || '',
       });
-    enviveConfigService.getEnviveConfig().then(newConfig => {
-      setEnviveServiceConfig(newConfig);
-      return newConfig;
-    });
-  }, [config, userId, namespace, source, inputEnviveConfigService]);
+    const fetchEnviveConfig = async () => {
+      try {
+        const newConfig = await enviveConfigService.getEnviveConfig();
+        setEnviveServiceConfig(newConfig);
+      } catch (error) {
+        const resolvedError =
+          error instanceof Error ? error : new Error('Failed to load envive config');
+        logger.logError('Failed to initialize EnviveProvider', resolvedError);
+        invokeExtensionErrorCallback(resolvedError);
+      }
+    };
+
+    fetchEnviveConfig();
+  }, [
+    config,
+    userId,
+    namespace,
+    source,
+    inputEnviveConfigService,
+    extensionService,
+    invokeExtensionCallback,
+    invokeExtensionErrorCallback,
+  ]);
+
+  useEffect(() => {
+    if (!enviveServiceConfig || didReportSuccessRef.current) {
+      return;
+    }
+
+    didReportSuccessRef.current = true;
+    invokeExtensionCallback(extensionService?.onInjectionSuccess);
+  }, [enviveServiceConfig, extensionService, invokeExtensionCallback]);
 
   const enviveConfig = useMemo(
     () => ({
@@ -182,7 +243,10 @@ export const EnviveProvider: React.FC<EnviveProviderProps> = ({
             <FeatureFlagServiceProvider featureFlagService={featureFlagService}>
               <UserIdentityProvider userIdService={userIdService}>
                 <AmplitudeProvider externalAmplitudeService={inputAmplitudeService}>
-                  <PageProvider previewMode={previewMode}>
+                  <PageProvider
+                    previewMode={previewMode}
+                    onUrlResolverNotReady={extensionService?.onInjectionError}
+                  >
                     <WidgetConfigProvider>
                       <HardcopyProvider hardcopyOverride={hardcopyOverride}>
                         <EnviveCssProvider>

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

@@ -27,6 +27,12 @@ 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();

package/src/contexts/pageContext/pageContext.tsx

@@ -5,19 +5,23 @@ import {
   useContext,
   useEffect,
   useMemo,
+  useRef,
   useState,
 } from 'react';
 import {
   UrlResolverResponse,
+  hasParsedVariantInfoAtom,
   pageUserEventAtom,
   pageVariantInfoAtom,
   urlResolverAtom,
+  variantInfoAtom,
 } from 'src/atoms/app/variant';
-import { useAtom } from 'jotai';
+import { useAtom, useAtomValue } from 'jotai';
 import CommerceApiClient from 'src/application/commerce-api';
 import Logger from 'src/application/logging/logger';
 import { PageVisitCategory, UserEventCategory } from '@spiffy-ai/commerce-api-client';
 import { VariantTypeEnum } from 'src/application/models';
+import { EnviveMetricsEventName, useAmplitude } from 'src/contexts/amplitudeContext';
 import { mapApiUserEventToUserEvent, mapUrlResolverResponseToVariantInfo } from './mapping';
 import { PageDetails } from './types';
 
@@ -35,13 +39,17 @@ const PageContext = createContext<
 export const PageProvider: React.FC<{
   children: ReactNode;
   previewMode: boolean;
-}> = ({ children, previewMode = false }) => {
+  /** When URL resolver returns `ready: false`, invoked for extension/injection failure reporting. */
+  onUrlResolverNotReady?: (error: Error) => Promise<unknown> | void;
+}> = ({ children, previewMode = false, onUrlResolverNotReady }) => {
   const [pageUrl, setPageUrl] = useState<string | undefined>(undefined);
   const [urlResolverResponse, setUrlResolverResponse] = useAtom(urlResolverAtom);
   const [isLoading, setIsLoading] = useState(false);
   const [variantInfo, setVariantInfo] = useAtom(pageVariantInfoAtom);
   const [userEvent, setUserEvent] = useAtom(pageUserEventAtom);
   const [isSupported, setIsSupported] = useState(false);
+  const lastNotReadyUrlRef = useRef<string | null>(null);
+
   useEffect(() => {
     setPageUrl(window.location.href);
   }, []);
@@ -72,11 +80,13 @@ export const PageProvider: React.FC<{
       if (response.ready) {
         const newVariantInfo = mapUrlResolverResponseToVariantInfo(url, response);
         const newUserEvent = mapApiUserEventToUserEvent(response.user_event ?? undefined);
+        logger.logDebug('setting variant info and user event', { newVariantInfo, newUserEvent });
         setVariantInfo(newVariantInfo);
         setUserEvent(newUserEvent);
       } else {
         setUserEvent(undefined);
         setVariantInfo(undefined);
+        logger.logDebug('set variant info and user event to undefined', { variantInfo, userEvent });
       }
     },
     [setVariantInfo, setUserEvent],
@@ -104,6 +114,16 @@ export const PageProvider: React.FC<{
         setVariantFromUrlResolver(cleansedUrl, response);
         setIsLoading(false);
         setIsSupported(response.ready);
+
+        if (response.ready) {
+          lastNotReadyUrlRef.current = null;
+        } else if (onUrlResolverNotReady && lastNotReadyUrlRef.current !== cleansedUrl) {
+          lastNotReadyUrlRef.current = cleansedUrl;
+          const err = new Error(`URL resolver returned ready=false for ${cleansedUrl}`);
+          Promise.resolve(onUrlResolverNotReady(err)).catch(callbackError => {
+            logger.logDebug('onUrlResolverNotReady callback failed', callbackError);
+          });
+        }
       } catch (e) {
         setIsLoading(false);
         logger.logError('Failed to resolve page URL', e, { pageUrl });
@@ -118,8 +138,65 @@ export const PageProvider: React.FC<{
     userEvent,
     variantInfo,
     previewMode,
+    onUrlResolverNotReady,
   ]);
 
+  const { trackEvent } = useAmplitude();
+  const resolvedVariantInfo = useAtomValue(variantInfoAtom);
+  const hasParsedVariantInfo = useAtomValue(hasParsedVariantInfoAtom);
+  const pageViewedFired = useRef(false);
+
+  useEffect(() => {
+    if (pageViewedFired.current || isLoading || !hasParsedVariantInfo || !variantInfo) {
+      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 = 'full_page_sales_agent';
+        pageId = variantInfo.url;
+        break;
+      default:
+        return;
+    }
+
+    pageViewedFired.current = true;
+
+    trackEvent({
+      eventName: EnviveMetricsEventName.PageViewed,
+      eventProps: {
+        'context.page_type': pageType,
+        'context.page_id': pageId,
+        'context.supported': isSupported,
+        'context.ready': isSupported,
+        'context.page_variant_id': resolvedVariantInfo.variantId,
+      },
+    });
+  }, [isLoading, isSupported, hasParsedVariantInfo, variantInfo, resolvedVariantInfo, trackEvent]);
+
   const setPageUrlStable = useCallback((url: string) => {
     setPageUrl(url);
   }, []);