@constructor-io/constructorio-ui-pia 2.13.0 → 2.14.0

package/lib/cjs/components/CioPia/CioPia.js

@@ -4,9 +4,14 @@ const tslib_1 = require("tslib");
 const react_1 = tslib_1.__importDefault(require("react"));
 const CioPiaQna_1 = tslib_1.__importDefault(require("./CioPiaQna"));
 const CioPiaRecs_1 = tslib_1.__importDefault(require("../CioPiaRecs/CioPiaRecs"));
+const CioPiaControl_1 = tslib_1.__importDefault(require("../CioPiaControl/CioPiaControl"));
 function CioPia(props) {
-    var _a, _b;
+    var _a, _b, _c;
     const mode = (_b = (_a = props.displayConfigs) === null || _a === void 0 ? void 0 : _a.mode) !== null && _b !== void 0 ? _b : 'default';
+    // Before the mode dispatch: a control shopper gets no widget in any mode.
+    if ((_c = props.abTest) === null || _c === void 0 ? void 0 : _c.isControl) {
+        return react_1.default.createElement(CioPiaControl_1.default, Object.assign({}, props));
+    }
     if (mode === 'recommendations') {
         return react_1.default.createElement(CioPiaRecs_1.default, Object.assign({}, props));
     }

package/lib/cjs/components/CioPia/CioPiaQna.js

@@ -22,7 +22,7 @@ const StatusRegion_1 = tslib_1.__importStar(require("../StatusRegion/StatusRegio
 // eslint-disable-next-line complexity
 function CioPiaQna(props) {
     var _a;
-    const { apiKey, itemId, itemName, threadId, variationId, cioClient, displayConfigs, componentOverrides, callbacks, formatters, productCardProps, children, translations, suggestedQuestionsParameters, answerParameters, parameters, trackingConfigs, } = props;
+    const { apiKey, itemId, itemName, threadId, variationId, cioClient, displayConfigs, componentOverrides, callbacks, formatters, productCardProps, children, translations, suggestedQuestionsParameters, answerParameters, parameters, trackingConfigs, abTest, } = props;
     const { learnMoreUrl, showFeedback, mode = 'default', type = 'inline', showPreviousItems, disclaimerPosition = 'bottom', } = displayConfigs || {};
     const isConversation = mode === 'conversation' || type === 'modal';
     const { priceCurrency } = productCardProps || {};
@@ -36,6 +36,7 @@ function CioPiaQna(props) {
         answerParameters,
         parameters,
         formatImageUrl: formatters === null || formatters === void 0 ? void 0 : formatters.formatImageUrl,
+        testCells: abTest === null || abTest === void 0 ? void 0 : abTest.testCells,
     });
     const tracking = (0, useTracking_1.default)({
         cioClient: pia.cioClient,

package/lib/cjs/components/CioPiaControl/CioPiaControl.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const react_1 = tslib_1.__importDefault(require("react"));
+const usePiaClient_1 = tslib_1.__importDefault(require("../../hooks/usePiaClient"));
+const useTracking_1 = tslib_1.__importDefault(require("../../hooks/useTracking"));
+const useViewportTracking_1 = tslib_1.__importDefault(require("../../hooks/useViewportTracking"));
+const NO_QUESTIONS = [];
+/**
+ * What a control-group shopper gets instead of the widget: nothing to look at, but a node the
+ * view event can be tied to, so both arms of an A/B test are measured the same way.
+ *
+ * None of the question or answer hooks mount here, so the control arm cannot issue a request.
+ */
+function CioPiaControl(props) {
+    const { apiKey, itemId, itemName, threadId, variationId, cioClient, abTest, trackingConfigs } = props;
+    const { cioClient: client, threadId: resolvedThreadId } = (0, usePiaClient_1.default)({
+        apiKey,
+        threadId,
+        cioClient,
+        testCells: abTest === null || abTest === void 0 ? void 0 : abTest.testCells,
+    });
+    const tracking = (0, useTracking_1.default)({
+        cioClient: client,
+        itemId,
+        itemName,
+        variationId,
+        threadId: resolvedThreadId,
+    });
+    const { containerRef } = (0, useViewportTracking_1.default)({
+        tracking,
+        questions: NO_QUESTIONS,
+        viewThreshold: trackingConfigs === null || trackingConfigs === void 0 ? void 0 : trackingConfigs.viewThreshold,
+        awaitQuestions: false,
+    });
+    return (react_1.default.createElement("div", { ref: containerRef, className: 'cio-pia-control-placeholder', "data-testid": 'cio-pia-control-placeholder', style: { width: 1, height: 1, padding: 0, border: 0, margin: 0, overflow: 'hidden' }, "aria-hidden": 'true' }));
+}
+exports.default = CioPiaControl;

package/lib/cjs/components/CioPiaRecs/CioPiaRecs.js

@@ -20,8 +20,9 @@ const classNames_1 = require("../../utils/classNames");
  * that supplied its own root — `children` or `componentOverrides.reactNode` — still gets it in that
  * state, with `error` available, and decides what belongs there.
  */
+// eslint-disable-next-line complexity
 function CioPiaRecs(props) {
-    const { apiKey, itemId, threadId, variationId, cioClient, componentOverrides, callbacks, formatters, productCardProps, children, translations, recsPodParameters, } = props;
+    const { apiKey, itemId, threadId, variationId, cioClient, componentOverrides, callbacks, formatters, productCardProps, children, translations, recsPodParameters, abTest, } = props;
     const { priceCurrency } = productCardProps || {};
     const { showInput = true, numResults } = recsPodParameters || {};
     const { answer: answerOverride, carousel: carouselOverride, loading: loadingOverride, reactNode: rootOverride, } = componentOverrides || {};
@@ -29,6 +30,7 @@ function CioPiaRecs(props) {
         apiKey,
         threadId,
         cioClient,
+        testCells: abTest === null || abTest === void 0 ? void 0 : abTest.testCells,
     });
     const { title, items, refinement, isLoading, error, inputError, lastShopperInput, refine } = (0, useRecsPod_1.default)({
         itemId,

package/lib/cjs/hooks/useAnswerResults.js

@@ -6,14 +6,21 @@ function useAnswerResults({ itemId, variationId, threadId, cioClient, parameters
     const [answerResults, setAnswerResults] = (0, react_1.useState)(null);
     const [isLoading, setIsLoading] = (0, react_1.useState)(false);
     const [error, setError] = (0, react_1.useState)(null);
+    const serializedParameters = (0, react_1.useMemo)(() => JSON.stringify(parameters), [parameters]);
     const items = (0, react_1.useMemo)(() => (0, transformers_1.extractAndTransformItems)(answerResults, formatImageUrl), [answerResults, formatImageUrl]);
+    // A host that rebuilds the client on render must not change getAnswer's identity.
+    const cioClientRef = (0, react_1.useRef)(cioClient);
+    (0, react_1.useEffect)(() => {
+        cioClientRef.current = cioClient;
+    }, [cioClient]);
     const fetchResult = (0, react_1.useCallback)((question) => {
-        if (!cioClient)
+        const client = cioClientRef.current;
+        if (!client)
             return;
         setIsLoading(true);
         setError(null);
         setAnswerResults(null);
-        cioClient.agent.pia
+        client.agent.pia
             .getAnswerResults(itemId, question, Object.assign({ threadId, variationId }, parameters))
             .then((response) => {
             setAnswerResults(response);
@@ -26,7 +33,9 @@ function useAnswerResults({ itemId, variationId, threadId, cioClient, parameters
             .finally(() => {
             setIsLoading(false);
         });
-    }, [cioClient, itemId, variationId, threadId, parameters]);
+    }, 
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [itemId, variationId, threadId, serializedParameters]);
     return {
         data: answerResults,
         items,

package/lib/cjs/hooks/useCioPia.js

@@ -40,11 +40,12 @@ function mapDeprecatedParameters(params) {
     return hasEntries ? mapped : undefined;
 }
 function useCioPia(props) {
-    const { apiKey, itemId, variationId, threadId: providedThreadId, cioClient: providedClient, suggestedQuestionsParameters, answerParameters, parameters, formatImageUrl, } = props;
+    const { apiKey, itemId, variationId, threadId: providedThreadId, cioClient: providedClient, suggestedQuestionsParameters, answerParameters, parameters, formatImageUrl, testCells, } = props;
     const { cioClient: client, threadId } = (0, usePiaClient_1.default)({
         apiKey,
         threadId: providedThreadId,
         cioClient: providedClient,
+        testCells,
     });
     const mappedDeprecated = mapDeprecatedParameters(parameters);
     const mergedSuggestedParams = mappedDeprecated || suggestedQuestionsParameters

package/lib/cjs/hooks/useConversation.js

@@ -18,6 +18,9 @@ function useConversation({ pia, itemId, isConversation, callbacks, tracking, })
     const trackingRef = (0, react_1.useRef)(tracking);
     const lastQuestionRef = (0, react_1.useRef)('');
     const lastSourceRef = (0, react_1.useRef)('user');
+    // Set once an answer owns the question row, so a later suggested-questions
+    // response cannot take it back.
+    const showsFollowUpsRef = (0, react_1.useRef)(false);
     (0, react_1.useEffect)(() => {
         callbacksRef.current = callbacks;
     }, [callbacks]);
@@ -69,20 +72,29 @@ function useConversation({ pia, itemId, isConversation, callbacks, tracking, })
         setDisplayedQuestions(suggestedQuestions.data);
         setConversationHistory([]);
         prevAnswerDataRef.current = null;
+        showsFollowUpsRef.current = false;
     }, [suggestedQuestions.data]);
     (0, react_1.useEffect)(() => {
         setCurrentQuestion('');
         setDisplayedQuestions([]);
         setConversationHistory([]);
         prevAnswerDataRef.current = null;
+        showsFollowUpsRef.current = false;
     }, [itemId]);
     (0, react_1.useEffect)(() => {
+        // The ref, not `answers.data`, which outlives the item it answered.
+        if (showsFollowUpsRef.current)
+            return;
         setDisplayedQuestions(suggestedQuestions.data);
     }, [suggestedQuestions.data]);
     (0, react_1.useEffect)(() => {
         var _a, _b;
-        if ((_a = answers.data) === null || _a === void 0 ? void 0 : _a.follow_up_questions)
-            setDisplayedQuestions(answers.data.follow_up_questions);
+        if (answers.data) {
+            // An answer with no follow-ups empties the row: the pre-generated questions
+            // include the one just asked.
+            setDisplayedQuestions((_a = answers.data.follow_up_questions) !== null && _a !== void 0 ? _a : []);
+            showsFollowUpsRef.current = true;
+        }
         if (answers.data && lastQuestionRef.current && !hasTrackedCurrentAnswerRef.current) {
             hasTrackedCurrentAnswerRef.current = true;
             (_b = trackingRef.current) === null || _b === void 0 ? void 0 : _b.trackAnswerView(lastQuestionRef.current, answers.data, answers.items);

package/lib/cjs/hooks/usePiaClient.js

@@ -4,18 +4,25 @@ const tslib_1 = require("tslib");
 const react_1 = require("react");
 const constructorio_client_javascript_1 = tslib_1.__importDefault(require("@constructor-io/constructorio-client-javascript"));
 const version_1 = tslib_1.__importDefault(require("../version"));
-function usePiaClient({ apiKey, threadId: providedThreadId, cioClient: providedClient, }) {
+function usePiaClient({ apiKey, threadId: providedThreadId, cioClient: providedClient, testCells, }) {
     const [generatedThreadId] = (0, react_1.useState)(() => crypto.randomUUID());
     const threadId = providedThreadId || generatedThreadId;
+    const serializedTestCells = (0, react_1.useMemo)(() => JSON.stringify(testCells !== null && testCells !== void 0 ? testCells : null), [testCells]);
     const client = (0, react_1.useMemo)(() => {
         if (providedClient)
             return providedClient;
-        return new constructorio_client_javascript_1.default({
-            apiKey,
-            sendTrackingEvents: true,
-            version: `cio-ui-pia-${version_1.default}`,
-        });
-    }, [apiKey, providedClient]);
+        return new constructorio_client_javascript_1.default(Object.assign({ apiKey, sendTrackingEvents: true, version: `cio-ui-pia-${version_1.default}` }, (testCells && { testCells })));
+        // testCells is compared by serializedTestCells so an inline object does not rebuild the client
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [apiKey, providedClient, serializedTestCells]);
+    // A caller's client owns its own options, so say so rather than dropping these silently.
+    (0, react_1.useEffect)(() => {
+        if (!providedClient || !testCells || Object.keys(testCells).length === 0)
+            return;
+        console.warn('[CioPia] abTest.testCells is ignored when you supply your own cioClient. Set testCells on that client instead.');
+        // serializedTestCells stands in for testCells here too
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [providedClient, serializedTestCells]);
     return { cioClient: client, threadId };
 }
 exports.default = usePiaClient;

package/lib/cjs/hooks/useRecsPod.js

@@ -30,15 +30,23 @@ function useRecsPod({ itemId, variationId, threadId, cioClient, parameters, form
     (0, react_1.useEffect)(() => {
         formatImageUrlRef.current = formatImageUrl;
     }, [formatImageUrl]);
+    // A host that rebuilds the client on render must not restart the request.
+    const cioClientRef = (0, react_1.useRef)(cioClient);
+    (0, react_1.useEffect)(() => {
+        cioClientRef.current = cioClient;
+    }, [cioClient]);
+    // A client arriving where there was none still warrants a fetch.
+    const hasClient = !!cioClient;
     const strategy = (parameters === null || parameters === void 0 ? void 0 : parameters.strategy) || DEFAULT_STRATEGY;
     const { numResults, defaultTitle } = parameters || {};
     const fetchResult = (0, react_1.useCallback)((shopperInput, source) => {
         var _a;
         // TODO: once getRecs is added to the JS client SDK, replace this guard+cast
         // with a direct call: cioClient.agent.getRecs({...})
-        const getRecs = (_a = cioClient === null || cioClient === void 0 ? void 0 : cioClient.agent) === null || _a === void 0 ? void 0 : _a.getRecs;
-        if (!cioClient || !getRecs) {
-            if (cioClient && !getRecs) {
+        const client = cioClientRef.current;
+        const getRecs = (_a = client === null || client === void 0 ? void 0 : client.agent) === null || _a === void 0 ? void 0 : _a.getRecs;
+        if (!client || !getRecs) {
+            if (client && !getRecs) {
                 console.info('[CioPia] getRecs is not available on the client SDK yet.');
             }
             setIsLoading(false);
@@ -51,7 +59,7 @@ function useRecsPod({ itemId, variationId, threadId, cioClient, parameters, form
         setError(null);
         setHasUnsupportedInput(false);
         getRecs
-            .call(cioClient.agent, {
+            .call(client.agent, {
             itemId,
             variationId,
             threadId,
@@ -91,9 +99,9 @@ function useRecsPod({ itemId, variationId, threadId, cioClient, parameters, form
             setIsLoading(false);
         });
     }, 
-    // Every dependency is a primitive. `formatImageUrl` is read through a ref instead, so a
-    // caller writing it inline cannot restart the request on every render.
-    [cioClient, itemId, variationId, threadId, strategy, numResults]);
+    // Every dependency is a primitive; `formatImageUrl` and the client are read through refs.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [hasClient, itemId, variationId, threadId, strategy, numResults]);
     (0, react_1.useEffect)(() => {
         fetchResult();
     }, [fetchResult]);

package/lib/cjs/hooks/useSuggestedQuestions.js

@@ -6,12 +6,21 @@ function useSuggestedQuestions({ itemId, variationId, threadId, cioClient, param
     const [isLoading, setIsLoading] = (0, react_1.useState)(false);
     const [error, setError] = (0, react_1.useState)(null);
     const serializedParameters = (0, react_1.useMemo)(() => JSON.stringify(parameters), [parameters]);
+    // The client is how the question is asked, not part of the question: a host that
+    // rebuilds it on render must not make the widget ask the same thing again.
+    const cioClientRef = (0, react_1.useRef)(cioClient);
+    (0, react_1.useEffect)(() => {
+        cioClientRef.current = cioClient;
+    }, [cioClient]);
+    // A client arriving where there was none is the one client change worth a fetch.
+    const hasClient = !!cioClient;
     const fetchResult = (0, react_1.useCallback)(() => {
-        if (!cioClient)
+        const client = cioClientRef.current;
+        if (!client)
             return;
         setIsLoading(true);
         setError(null);
-        cioClient.agent.pia
+        client.agent.pia
             .getSuggestedQuestions(itemId, Object.assign({ threadId,
             variationId }, parameters))
             .then((response) => {
@@ -26,7 +35,7 @@ function useSuggestedQuestions({ itemId, variationId, threadId, cioClient, param
         });
         // parameters is serialized via serializedParameters to prevent refetch on identity changes
         // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [cioClient, itemId, variationId, threadId, serializedParameters]);
+    }, [hasClient, itemId, variationId, threadId, serializedParameters]);
     (0, react_1.useEffect)(() => {
         fetchResult();
     }, [fetchResult]);

package/lib/cjs/hooks/useViewportTracking.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const react_1 = require("react");
 const FLUSH_INTERVAL_MS = 5 * 60 * 1000;
 const DEFAULT_VIEW_THRESHOLD = 0.5;
-function useViewportTracking({ tracking, questions, viewThreshold = DEFAULT_VIEW_THRESHOLD, }) {
+function useViewportTracking({ tracking, questions, viewThreshold = DEFAULT_VIEW_THRESHOLD, awaitQuestions = true, }) {
     const nodeRef = (0, react_1.useRef)(null);
     const observerRef = (0, react_1.useRef)(null);
     const intervalRef = (0, react_1.useRef)(null);
@@ -11,10 +11,14 @@ function useViewportTracking({ tracking, questions, viewThreshold = DEFAULT_VIEW
     const entryTimeRef = (0, react_1.useRef)(null);
     const questionsRef = (0, react_1.useRef)(questions);
     const trackingRef = (0, react_1.useRef)(tracking);
+    const awaitQuestionsRef = (0, react_1.useRef)(awaitQuestions);
+    (0, react_1.useEffect)(() => {
+        awaitQuestionsRef.current = awaitQuestions;
+    }, [awaitQuestions]);
     (0, react_1.useEffect)(() => {
         const questionsJustArrived = questionsRef.current.length === 0 && questions.length > 0;
         questionsRef.current = questions;
-        if (questionsJustArrived && entryTimeRef.current) {
+        if (awaitQuestionsRef.current && questionsJustArrived && entryTimeRef.current) {
             trackingRef.current.trackView(questions);
         }
     }, [questions]);
@@ -30,7 +34,8 @@ function useViewportTracking({ tracking, questions, viewThreshold = DEFAULT_VIEW
             });
             entryTimeRef.current = null;
         }
-        if (timespansRef.current.length > 0 && questionsRef.current.length > 0) {
+        const hasPayload = !awaitQuestionsRef.current || questionsRef.current.length > 0;
+        if (timespansRef.current.length > 0 && hasPayload) {
             trackingRef.current.trackViews(questionsRef.current, [...timespansRef.current]);
             timespansRef.current = [];
         }
@@ -39,7 +44,7 @@ function useViewportTracking({ tracking, questions, viewThreshold = DEFAULT_VIEW
         const observer = new IntersectionObserver(([entry]) => {
             if (entry.isIntersecting) {
                 entryTimeRef.current = new Date().toISOString();
-                if (questionsRef.current.length > 0) {
+                if (!awaitQuestionsRef.current || questionsRef.current.length > 0) {
                     trackingRef.current.trackView(questionsRef.current);
                 }
             }

package/lib/cjs/version.js

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = '2.13.0';
+exports.default = '2.14.0';

package/lib/mjs/components/CioPia/CioPia.js

@@ -1,8 +1,13 @@
 import React from 'react';
 import CioPiaQna from './CioPiaQna';
 import CioPiaRecs from '../CioPiaRecs/CioPiaRecs';
+import CioPiaControl from '../CioPiaControl/CioPiaControl';
 export default function CioPia(props) {
     const mode = props.displayConfigs?.mode ?? 'default';
+    // Before the mode dispatch: a control shopper gets no widget in any mode.
+    if (props.abTest?.isControl) {
+        return React.createElement(CioPiaControl, { ...props });
+    }
     if (mode === 'recommendations') {
         return React.createElement(CioPiaRecs, { ...props });
     }

package/lib/mjs/components/CioPia/CioPiaQna.js

@@ -18,7 +18,7 @@ import StatusRegion, { answerStatusMessage } from '../StatusRegion/StatusRegion'
 /** The question-and-answer experience: `mode: 'default'`, `mode: 'conversation'`, and the modal. */
 // eslint-disable-next-line complexity
 export default function CioPiaQna(props) {
-    const { apiKey, itemId, itemName, threadId, variationId, cioClient, displayConfigs, componentOverrides, callbacks, formatters, productCardProps, children, translations, suggestedQuestionsParameters, answerParameters, parameters, trackingConfigs, } = props;
+    const { apiKey, itemId, itemName, threadId, variationId, cioClient, displayConfigs, componentOverrides, callbacks, formatters, productCardProps, children, translations, suggestedQuestionsParameters, answerParameters, parameters, trackingConfigs, abTest, } = props;
     const { learnMoreUrl, showFeedback, mode = 'default', type = 'inline', showPreviousItems, disclaimerPosition = 'bottom', } = displayConfigs || {};
     const isConversation = mode === 'conversation' || type === 'modal';
     const { priceCurrency } = productCardProps || {};
@@ -32,6 +32,7 @@ export default function CioPiaQna(props) {
         answerParameters,
         parameters,
         formatImageUrl: formatters?.formatImageUrl,
+        testCells: abTest?.testCells,
     });
     const tracking = useTracking({
         cioClient: pia.cioClient,

package/lib/mjs/components/CioPiaControl/CioPiaControl.js

@@ -0,0 +1,34 @@
+import React from 'react';
+import usePiaClient from '../../hooks/usePiaClient';
+import useTracking from '../../hooks/useTracking';
+import useViewportTracking from '../../hooks/useViewportTracking';
+const NO_QUESTIONS = [];
+/**
+ * What a control-group shopper gets instead of the widget: nothing to look at, but a node the
+ * view event can be tied to, so both arms of an A/B test are measured the same way.
+ *
+ * None of the question or answer hooks mount here, so the control arm cannot issue a request.
+ */
+export default function CioPiaControl(props) {
+    const { apiKey, itemId, itemName, threadId, variationId, cioClient, abTest, trackingConfigs } = props;
+    const { cioClient: client, threadId: resolvedThreadId } = usePiaClient({
+        apiKey,
+        threadId,
+        cioClient,
+        testCells: abTest?.testCells,
+    });
+    const tracking = useTracking({
+        cioClient: client,
+        itemId,
+        itemName,
+        variationId,
+        threadId: resolvedThreadId,
+    });
+    const { containerRef } = useViewportTracking({
+        tracking,
+        questions: NO_QUESTIONS,
+        viewThreshold: trackingConfigs?.viewThreshold,
+        awaitQuestions: false,
+    });
+    return (React.createElement("div", { ref: containerRef, className: 'cio-pia-control-placeholder', "data-testid": 'cio-pia-control-placeholder', style: { width: 1, height: 1, padding: 0, border: 0, margin: 0, overflow: 'hidden' }, "aria-hidden": 'true' }));
+}

package/lib/mjs/components/CioPiaRecs/CioPiaRecs.js

@@ -17,8 +17,9 @@ import { cx } from '../../utils/classNames';
  * that supplied its own root — `children` or `componentOverrides.reactNode` — still gets it in that
  * state, with `error` available, and decides what belongs there.
  */
+// eslint-disable-next-line complexity
 export default function CioPiaRecs(props) {
-    const { apiKey, itemId, threadId, variationId, cioClient, componentOverrides, callbacks, formatters, productCardProps, children, translations, recsPodParameters, } = props;
+    const { apiKey, itemId, threadId, variationId, cioClient, componentOverrides, callbacks, formatters, productCardProps, children, translations, recsPodParameters, abTest, } = props;
     const { priceCurrency } = productCardProps || {};
     const { showInput = true, numResults } = recsPodParameters || {};
     const { answer: answerOverride, carousel: carouselOverride, loading: loadingOverride, reactNode: rootOverride, } = componentOverrides || {};
@@ -26,6 +27,7 @@ export default function CioPiaRecs(props) {
         apiKey,
         threadId,
         cioClient,
+        testCells: abTest?.testCells,
     });
     const { title, items, refinement, isLoading, error, inputError, lastShopperInput, refine } = useRecsPod({
         itemId,

package/lib/mjs/hooks/useAnswerResults.js

@@ -1,17 +1,24 @@
-import { useCallback, useMemo, useState } from 'react';
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { extractAndTransformItems } from '../utils/transformers';
 export default function useAnswerResults({ itemId, variationId, threadId, cioClient, parameters, formatImageUrl, }) {
     const [answerResults, setAnswerResults] = useState(null);
     const [isLoading, setIsLoading] = useState(false);
     const [error, setError] = useState(null);
+    const serializedParameters = useMemo(() => JSON.stringify(parameters), [parameters]);
     const items = useMemo(() => extractAndTransformItems(answerResults, formatImageUrl), [answerResults, formatImageUrl]);
+    // A host that rebuilds the client on render must not change getAnswer's identity.
+    const cioClientRef = useRef(cioClient);
+    useEffect(() => {
+        cioClientRef.current = cioClient;
+    }, [cioClient]);
     const fetchResult = useCallback((question) => {
-        if (!cioClient)
+        const client = cioClientRef.current;
+        if (!client)
             return;
         setIsLoading(true);
         setError(null);
         setAnswerResults(null);
-        cioClient.agent.pia
+        client.agent.pia
             .getAnswerResults(itemId, question, { threadId, variationId, ...parameters })
             .then((response) => {
             setAnswerResults(response);
@@ -24,7 +31,9 @@ export default function useAnswerResults({ itemId, variationId, threadId, cioCli
             .finally(() => {
             setIsLoading(false);
         });
-    }, [cioClient, itemId, variationId, threadId, parameters]);
+    }, 
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [itemId, variationId, threadId, serializedParameters]);
     return {
         data: answerResults,
         items,

package/lib/mjs/hooks/useCioPia.js

@@ -37,11 +37,12 @@ function mapDeprecatedParameters(params) {
     return hasEntries ? mapped : undefined;
 }
 export default function useCioPia(props) {
-    const { apiKey, itemId, variationId, threadId: providedThreadId, cioClient: providedClient, suggestedQuestionsParameters, answerParameters, parameters, formatImageUrl, } = props;
+    const { apiKey, itemId, variationId, threadId: providedThreadId, cioClient: providedClient, suggestedQuestionsParameters, answerParameters, parameters, formatImageUrl, testCells, } = props;
     const { cioClient: client, threadId } = usePiaClient({
         apiKey,
         threadId: providedThreadId,
         cioClient: providedClient,
+        testCells,
     });
     const mappedDeprecated = mapDeprecatedParameters(parameters);
     const mergedSuggestedParams = mappedDeprecated || suggestedQuestionsParameters

package/lib/mjs/hooks/useConversation.js

@@ -15,6 +15,9 @@ export default function useConversation({ pia, itemId, isConversation, callbacks
     const trackingRef = useRef(tracking);
     const lastQuestionRef = useRef('');
     const lastSourceRef = useRef('user');
+    // Set once an answer owns the question row, so a later suggested-questions
+    // response cannot take it back.
+    const showsFollowUpsRef = useRef(false);
     useEffect(() => {
         callbacksRef.current = callbacks;
     }, [callbacks]);
@@ -62,19 +65,28 @@ export default function useConversation({ pia, itemId, isConversation, callbacks
         setDisplayedQuestions(suggestedQuestions.data);
         setConversationHistory([]);
         prevAnswerDataRef.current = null;
+        showsFollowUpsRef.current = false;
     }, [suggestedQuestions.data]);
     useEffect(() => {
         setCurrentQuestion('');
         setDisplayedQuestions([]);
         setConversationHistory([]);
         prevAnswerDataRef.current = null;
+        showsFollowUpsRef.current = false;
     }, [itemId]);
     useEffect(() => {
+        // The ref, not `answers.data`, which outlives the item it answered.
+        if (showsFollowUpsRef.current)
+            return;
         setDisplayedQuestions(suggestedQuestions.data);
     }, [suggestedQuestions.data]);
     useEffect(() => {
-        if (answers.data?.follow_up_questions)
-            setDisplayedQuestions(answers.data.follow_up_questions);
+        if (answers.data) {
+            // An answer with no follow-ups empties the row: the pre-generated questions
+            // include the one just asked.
+            setDisplayedQuestions(answers.data.follow_up_questions ?? []);
+            showsFollowUpsRef.current = true;
+        }
         if (answers.data && lastQuestionRef.current && !hasTrackedCurrentAnswerRef.current) {
             hasTrackedCurrentAnswerRef.current = true;
             trackingRef.current?.trackAnswerView(lastQuestionRef.current, answers.data, answers.items);

package/lib/mjs/hooks/usePiaClient.js

@@ -1,9 +1,10 @@
-import { useMemo, useState } from 'react';
+import { useEffect, useMemo, useState } from 'react';
 import ConstructorIOClient from '@constructor-io/constructorio-client-javascript';
 import version from '../version';
-export default function usePiaClient({ apiKey, threadId: providedThreadId, cioClient: providedClient, }) {
+export default function usePiaClient({ apiKey, threadId: providedThreadId, cioClient: providedClient, testCells, }) {
     const [generatedThreadId] = useState(() => crypto.randomUUID());
     const threadId = providedThreadId || generatedThreadId;
+    const serializedTestCells = useMemo(() => JSON.stringify(testCells ?? null), [testCells]);
     const client = useMemo(() => {
         if (providedClient)
             return providedClient;
@@ -11,7 +12,18 @@ export default function usePiaClient({ apiKey, threadId: providedThreadId, cioCl
             apiKey,
             sendTrackingEvents: true,
             version: `cio-ui-pia-${version}`,
+            ...(testCells && { testCells }),
         });
-    }, [apiKey, providedClient]);
+        // testCells is compared by serializedTestCells so an inline object does not rebuild the client
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [apiKey, providedClient, serializedTestCells]);
+    // A caller's client owns its own options, so say so rather than dropping these silently.
+    useEffect(() => {
+        if (!providedClient || !testCells || Object.keys(testCells).length === 0)
+            return;
+        console.warn('[CioPia] abTest.testCells is ignored when you supply your own cioClient. Set testCells on that client instead.');
+        // serializedTestCells stands in for testCells here too
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [providedClient, serializedTestCells]);
     return { cioClient: client, threadId };
 }

package/lib/mjs/hooks/useRecsPod.js

@@ -27,14 +27,22 @@ export default function useRecsPod({ itemId, variationId, threadId, cioClient, p
     useEffect(() => {
         formatImageUrlRef.current = formatImageUrl;
     }, [formatImageUrl]);
+    // A host that rebuilds the client on render must not restart the request.
+    const cioClientRef = useRef(cioClient);
+    useEffect(() => {
+        cioClientRef.current = cioClient;
+    }, [cioClient]);
+    // A client arriving where there was none still warrants a fetch.
+    const hasClient = !!cioClient;
     const strategy = parameters?.strategy || DEFAULT_STRATEGY;
     const { numResults, defaultTitle } = parameters || {};
     const fetchResult = useCallback((shopperInput, source) => {
         // TODO: once getRecs is added to the JS client SDK, replace this guard+cast
         // with a direct call: cioClient.agent.getRecs({...})
-        const getRecs = cioClient?.agent?.getRecs;
-        if (!cioClient || !getRecs) {
-            if (cioClient && !getRecs) {
+        const client = cioClientRef.current;
+        const getRecs = client?.agent?.getRecs;
+        if (!client || !getRecs) {
+            if (client && !getRecs) {
                 console.info('[CioPia] getRecs is not available on the client SDK yet.');
             }
             setIsLoading(false);
@@ -47,7 +55,7 @@ export default function useRecsPod({ itemId, variationId, threadId, cioClient, p
         setError(null);
         setHasUnsupportedInput(false);
         getRecs
-            .call(cioClient.agent, {
+            .call(client.agent, {
             itemId,
             variationId,
             threadId,
@@ -87,9 +95,9 @@ export default function useRecsPod({ itemId, variationId, threadId, cioClient, p
             setIsLoading(false);
         });
     }, 
-    // Every dependency is a primitive. `formatImageUrl` is read through a ref instead, so a
-    // caller writing it inline cannot restart the request on every render.
-    [cioClient, itemId, variationId, threadId, strategy, numResults]);
+    // Every dependency is a primitive; `formatImageUrl` and the client are read through refs.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [hasClient, itemId, variationId, threadId, strategy, numResults]);
     useEffect(() => {
         fetchResult();
     }, [fetchResult]);