@tiledev/sdk-apptile-live-selling 0.12.1 → 0.14.0

package/dist/react/useReplayPage.js

@@ -0,0 +1,504 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useReplayPage = useReplayPage;
+/**
+ * The Replay screen's page model (0.14.0, moved from amore-v2's `src/core/hooks/useReplayPage.ts`: old
+ * Amore's Replay, rebuilt). The routes are the app's (`LiveSellingProvider`'s `routes`); the route's
+ * `feedId` and `streamId` params are read here, and `feedId` is set as the shopper swipes.
+ */
+const sdk_shopify_1 = require("@tiledev/sdk-shopify");
+const react_1 = require("react");
+const react_native_1 = require("react-native");
+const liveSelling_1 = require("../liveSelling");
+const livePages_1 = require("../livePages");
+const pageOptions_1 = require("../pageOptions");
+const showCredit_1 = require("../showCredit");
+const LiveSellingProvider_1 = require("./LiveSellingProvider");
+const platformSession_1 = require("./platformSession");
+const replayPlayer_1 = require("./replayPlayer");
+const useLiveShop_1 = require("./useLiveShop");
+const useReplays_1 = require("./useReplays");
+const navigation_1 = require("./navigation");
+/** Recordings per read: the gateway's own page size, as the Live tab. */
+const PAGE_SIZE = 20;
+/** How often the playhead is read. Product windows are seconds wide, so this is plenty. */
+const POSITION_CHECK_MS = 500;
+/** A seek has landed once the player reports within this of it (it plays on while it seeks). */
+const SEEK_LANDED_WITHIN_MS = 600;
+/** Checks a seek is held for before the player is believed anyway (about 3 s): one that never lands mustn't freeze the bar. */
+const SEEK_GIVE_UP_CHECKS = 6;
+/** The playback controls fade this long after they last showed or were touched. */
+const CONTROLS_SHOW_MS = 4000;
+/**
+ * Everything the Replay screen wires, so the screen stays plain tiles. Call it from the Replay screen
+ * and from each of its tiles' wiring.
+ *
+ * - **A feed over the archive.** The route names where the shopper comes in (`feedId` from a card,
+ *   `streamId` from a push or link); `useReplays` (playable recordings, 20 a read) is paged until that
+ *   recording turns up. A swipe moves along the archive, and the next page is read when the shopper
+ *   reaches the last one or two read so far. Hidden shows a shopper can't see are left out
+ *   (`hiddenShows`), as on the Live tab: one opened by its id reads the archive to its end, then "This
+ *   show has ended".
+ * - **One player** (expo-video) for the whole app, borrowed from `ReplayPlayerProvider`, which owns it
+ *   above the navigator so it outlives this screen: a new recording replaces the source, one source per
+ *   recording, and its poster covers the picture until the video has a frame. It plays while the screen
+ *   is on show, or only covered by a sheet (`routes.sheets`: the variant page), or in the bubble, and
+ *   pauses under anything else.
+ * - **Picture-in-picture, in the app** (decided 2026-10-05, amore-v2's Head of Engineering): the
+ *   header's picture-in-picture button shrinks the show into a floating bubble over the app and goes
+ *   back (Home when there's nothing to go back to: `routes.openHome`); its cart button shrinks it the
+ *   same way and opens the Cart (`routes.openCart`). Arriving on this screen ends the bubble, and the
+ *   screen shows the video where the bubble had it; ✕ stops the show, with no bubble. Opening another
+ *   recording replaces the bubble's. No system picture-in-picture. One shrunk show at a time: arriving
+ *   here stops a live show's bubble, as the Live screen stops this one's.
+ * - **The playhead** is read twice a second. A seek is held until the player reports arriving there,
+ *   so the bar never jumps back to where it was.
+ * - **The product on screen** is the one whose time window covers the playhead
+ *   (`liveSelling.replays.segments`, `productOnScreen`); before the first window, the first tagged
+ *   product. Picking a product in the shop sheet goes to where the host first showed it, playing, then
+ *   opens the variant page (`routes.openVariantPage`); a product the host never showed (tagged, no time
+ *   window) leaves the player untouched, where it was and playing or paused, and only opens the variant
+ *   page. Every add from there is credited to the recording (`replayShowCredit`): `_replay_id` on the
+ *   line, `replayAddToCart` (`track`), and the cart's `_apptile_attribution` count against the show's
+ *   `streamingId`, never the replay's feed id. Products are read at sdk-shopify's `CARD_IMAGE`.
+ * - **The chat** is the show's comments file (`liveSelling.replays.comments`), revealed up to the
+ *   playhead, the newest 60 (`replayCommentsAt`).
+ * - **A view** is counted once per recording per visit (not on the web, where the Tile preview would
+ *   count on the merchant's real counter); a show back from the bubble isn't a new view.
+ * - **A read that fails** (the products, the time windows, the chat) goes to `onWarning`; a failed
+ *   products or windows read is tried again when the shopper comes back to the recording.
+ */
+function useReplayPage() {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+    const nav = (0, navigation_1.useNavigation)();
+    const route = (0, navigation_1.useRoute)();
+    const linkedId = (_d = (_b = (_a = route.params) === null || _a === void 0 ? void 0 : _a.feedId) !== null && _b !== void 0 ? _b : (_c = route.params) === null || _c === void 0 ? void 0 : _c.streamId) !== null && _d !== void 0 ? _d : '';
+    const { ready } = (0, LiveSellingProvider_1.useLiveSelling)();
+    const { routes, track } = (0, LiveSellingProvider_1.useLivePageOptions)();
+    const wishlist = (0, sdk_shopify_1.useWishlist)();
+    // `firstReadDone`: the first read has finished; until then an empty archive is still being read.
+    const archive = (0, useReplays_1.useReplays)({ pageSize: PAGE_SIZE, playableOnly: true });
+    const { loadMore, hasMore, hasRead: firstReadDone, loading: reading, error: readFailed } = archive;
+    // The recordings this shopper may see: hidden shows they can't see are left out.
+    const shows = archive.replays;
+    const { itemCount } = (0, sdk_shopify_1.useCart)();
+    // The app's one replay player: borrowed, as it outlives this screen for the bubble.
+    const replayPlayer = (0, replayPlayer_1.useReplayPlayer)();
+    const { player, bubbleShown, muted, openRecording, holdsVideo, stop, showBubble, hideBubble, setPausedByShopper, markVideoReady, setScreenShowing, screenClosed, } = replayPlayer;
+    // ─── Which recording ───────────────────────────────────────────────────────────────────────────
+    // State, seeded from the route: a swipe moves on without a navigation, and a new link moves it again.
+    const [currentId, setCurrentId] = (0, react_1.useState)(linkedId);
+    (0, react_1.useEffect)(() => setCurrentId(linkedId), [linkedId]);
+    const index = currentId ? shows.findIndex((replay) => (0, livePages_1.isTheShow)(replay, currentId)) : -1;
+    // A recording back from the bubble shows at once: the player holds it, and a new screen reads the
+    // archive from the start, so it would otherwise wait for that read to find it again.
+    const heldRecording = replayPlayer.recording;
+    const show = index >= 0 ? shows[index] : heldRecording && currentId && (0, livePages_1.isTheShow)(heldRecording, currentId) ? heldRecording : null;
+    const previousShow = index > 0 ? shows[index - 1] : null;
+    const nextShow = index >= 0 ? ((_e = shows[index + 1]) !== null && _e !== void 0 ? _e : null) : null;
+    // Read on until the recording turns up. One read at a time: `useReplays` ignores a second.
+    const readSoFar = !!currentId && archive.replays.some((replay) => (0, livePages_1.isTheShow)(replay, currentId));
+    const searching = !!currentId && !readSoFar && hasMore && !readFailed;
+    (0, react_1.useEffect)(() => {
+        if (ready && firstReadDone && searching && !reading)
+            void loadMore();
+    }, [ready, firstReadDone, searching, reading, loadMore]);
+    // The next page before the shopper reaches the end, so the swipe after the last one lands.
+    const nearTheEnd = index >= 0 && index >= shows.length - 2;
+    (0, react_1.useEffect)(() => {
+        if (nearTheEnd && hasMore && !reading && !readFailed)
+            void loadMore();
+    }, [nearTheEnd, hasMore, reading, readFailed, loadMore]);
+    // Not in the archive (or a hidden show this shopper can't see), or the archive couldn't be read.
+    const missing = !currentId || (firstReadDone && !show && !searching && !reading);
+    const goTo = (0, react_1.useCallback)((target) => {
+        if (!target)
+            return;
+        setCurrentId(target.id);
+        // The route follows, so a reload or a later link starts from the show being watched.
+        nav.setParams({ feedId: target.id, streamId: undefined });
+    }, [nav]);
+    // ─── The player ────────────────────────────────────────────────────────────────────────────────
+    const isFocused = (0, navigation_1.useIsFocused)();
+    const coveredOnlyBySheet = (0, navigation_1.useNavigationState)((state) => (0, livePages_1.isCoveredOnlyBySheet)(state, route.key, routes.sheets));
+    const onScreen = isFocused || coveredOnlyBySheet;
+    const videoUrl = (_f = show === null || show === void 0 ? void 0 : show.videoUrl) !== null && _f !== void 0 ? _f : null;
+    /** The player holds this screen's recording. It may hold another (the bubble's, until this screen takes over) or none. */
+    const holdsThisShow = !!videoUrl && replayPlayer.videoUrl === videoUrl;
+    const playing = holdsThisShow && replayPlayer.playing;
+    const status = holdsThisShow ? replayPlayer.status : 'loading';
+    const videoReady = holdsThisShow && replayPlayer.videoReady;
+    // Back from the bubble, the player is already somewhere in the recording: start from there.
+    const [positionMs, setPositionMs] = (0, react_1.useState)(() => (holdsThisShow ? (0, livePages_1.playerMs)(player.currentTime) : 0));
+    /** While the shopper drags the bar: the product card and chat follow the finger, not the playhead. */
+    const [scrubMs, setScrubMs] = (0, react_1.useState)(null);
+    const [durationMs, setDurationMs] = (0, react_1.useState)(() => (holdsThisShow ? (0, livePages_1.playerMs)(player.duration) : 0));
+    /** A seek asked for and not yet reported back: the player keeps saying the old time until it lands. */
+    const pendingSeek = (0, react_1.useRef)(null);
+    const latest = (0, react_1.useRef)({ durationMs, holdsThisShow });
+    latest.current = { durationMs, holdsThisShow };
+    /** ✕ was pressed: the show has stopped, and the screen slides away on its poster. */
+    const [closing, setClosing] = (0, react_1.useState)(false);
+    // On show here, this screen's recording goes into the player, from the start, unless the player
+    // already holds it (back from the bubble, it plays on where it was). Not while the bubble is still
+    // up: arriving closes it first (below), so its view never loads another recording. Not once ✕ has
+    // stopped it, while the screen is still on show for its way out. The player is asked at the moment
+    // this runs (`holdsVideo`).
+    const showToOpen = (0, react_1.useRef)(show);
+    showToOpen.current = show;
+    (0, react_1.useEffect)(() => {
+        const target = showToOpen.current;
+        if (closing || !onScreen || bubbleShown || !videoUrl || !target || holdsVideo(videoUrl))
+            return;
+        setPositionMs(0);
+        setScrubMs(null);
+        setDurationMs(0);
+        // Held at 0 until the player stops reporting the last recording's time.
+        pendingSeek.current = { targetMs: 0, checks: 0 };
+        openRecording(target);
+    }, [closing, onScreen, bubbleShown, videoUrl, holdsVideo, openRecording]);
+    // Arriving here ends the bubble, however the shopper came (its tap, a link, back from the cart): the
+    // screen shows the video again. A screen ✕ couldn't take away (nothing behind it, so Home opened
+    // over it) plays again if the shopper comes back to it.
+    (0, react_1.useEffect)(() => {
+        if (!isFocused)
+            return;
+        hideBubble();
+        setClosing(false);
+    }, [isFocused, hideBubble]);
+    // One shrunk show at a time: a live show left in its bubble stops, and its pin goes with it.
+    const { pipMode: livePipMode, actions: liveActions } = (0, platformSession_1.useLiveSession)();
+    const { exitPip: closeLiveBubble, releaseStream: releaseLiveShow } = liveActions;
+    (0, react_1.useEffect)(() => {
+        if (!isFocused || livePipMode !== 'inapp')
+            return;
+        closeLiveBubble({ stopVideo: true });
+        releaseLiveShow();
+    }, [isFocused, livePipMode, closeLiveBubble, releaseLiveShow]);
+    // The player plays only while something shows it: this screen says when it does. Closing it stops
+    // the video, unless the bubble took it.
+    const screenKey = route.key;
+    const showingHere = onScreen && holdsThisShow;
+    (0, react_1.useEffect)(() => {
+        setScreenShowing(screenKey, showingHere);
+    }, [screenKey, showingHere, setScreenShowing]);
+    (0, react_1.useEffect)(() => () => screenClosed(screenKey), [screenKey, screenClosed]);
+    // The playhead, read rather than subscribed: product windows only need to land within half a second.
+    (0, react_1.useEffect)(() => {
+        const timer = setInterval(() => {
+            // Another recording's time (the player holds the bubble's, or nothing) isn't this one's.
+            if (!latest.current.holdsThisShow)
+                return;
+            try {
+                const reportedMs = (player.currentTime || 0) * 1000;
+                const pending = pendingSeek.current;
+                if (!pending)
+                    setPositionMs(reportedMs);
+                else if (Math.abs(reportedMs - pending.targetMs) <= SEEK_LANDED_WITHIN_MS || pending.checks + 1 >= SEEK_GIVE_UP_CHECKS) {
+                    pendingSeek.current = null;
+                    setPositionMs(reportedMs);
+                }
+                else
+                    pendingSeek.current = { targetMs: pending.targetMs, checks: pending.checks + 1 };
+                // A length that arrives late, or that the playlist revises.
+                const lengthSeconds = player.duration;
+                if (Number.isFinite(lengthSeconds) && lengthSeconds > 0)
+                    setDurationMs(lengthSeconds * 1000);
+            }
+            catch {
+                // The player was released under the timer (the app is closing).
+            }
+        }, POSITION_CHECK_MS);
+        return () => clearInterval(timer);
+    }, [player]);
+    const seekTo = (0, react_1.useCallback)((targetMs) => {
+        if (!latest.current.holdsThisShow)
+            return;
+        const length = latest.current.durationMs;
+        const target = Math.max(0, length > 0 ? Math.min(targetMs, length) : targetMs);
+        pendingSeek.current = { targetMs: target, checks: 0 };
+        try {
+            player.currentTime = target / 1000;
+        }
+        catch {
+            pendingSeek.current = null;
+            return;
+        }
+        setPositionMs(target);
+        setScrubMs(null);
+    }, [player]);
+    const shownPositionMs = scrubMs !== null && scrubMs !== void 0 ? scrubMs : positionMs;
+    // ─── The controls: up for 4 s after they show or are touched; a tap on the video shows or hides them ───
+    const [controlsVisible, setControlsVisible] = (0, react_1.useState)(true);
+    const [controlsTouches, setControlsTouches] = (0, react_1.useState)(0);
+    const showControls = (0, react_1.useCallback)(() => {
+        setControlsVisible(true);
+        setControlsTouches((count) => count + 1);
+    }, []);
+    const toggleControls = (0, react_1.useCallback)(() => {
+        setControlsVisible((visible) => !visible);
+        setControlsTouches((count) => count + 1);
+    }, []);
+    (0, react_1.useEffect)(() => {
+        if (!controlsVisible)
+            return;
+        const timer = setTimeout(() => setControlsVisible(false), CONTROLS_SHOW_MS);
+        return () => clearTimeout(timer);
+    }, [controlsVisible, controlsTouches]);
+    // ─── What the show sells, and its chat ─────────────────────────────────────────────────────────
+    const shoppingRead = (0, react_1.useRef)(new Map());
+    const [shopping, setShopping] = (0, react_1.useState)({ showId: '', products: [], segments: [] });
+    const showId = (_g = show === null || show === void 0 ? void 0 : show.id) !== null && _g !== void 0 ? _g : null;
+    const productIds = show === null || show === void 0 ? void 0 : show.productIds;
+    (0, react_1.useEffect)(() => {
+        if (!showId)
+            return;
+        const kept = shoppingRead.current.get(showId);
+        if (kept) {
+            setShopping({ showId, ...kept });
+            return;
+        }
+        let stillThisShow = true;
+        let everythingRead = true;
+        const failed = (at) => (error) => {
+            everythingRead = false;
+            (0, pageOptions_1.reportLiveWarning)(error, { at, feedId: showId });
+            return [];
+        };
+        void Promise.all([
+            (productIds === null || productIds === void 0 ? void 0 : productIds.length) ? sdk_shopify_1.shopify.products.byIds(productIds, { imageTransform: sdk_shopify_1.CARD_IMAGE }).catch(failed('replay.products')) : Promise.resolve([]),
+            liveSelling_1.liveSelling.replays.segments(showId).catch(failed('replay.segments')),
+        ]).then(([products, segments]) => {
+            const read = { products, segments };
+            // Kept for the visit only when it all came back: a failed read is tried again when the shopper returns.
+            if (everythingRead)
+                shoppingRead.current.set(showId, read);
+            if (stillThisShow)
+                setShopping({ showId, ...read });
+        });
+        return () => {
+            stillThisShow = false;
+        };
+    }, [showId, productIds]);
+    const products = shopping.showId === showId ? shopping.products : [];
+    const segments = shopping.showId === showId ? shopping.segments : [];
+    const onScreenProduct = (0, react_1.useMemo)(() => (0, livePages_1.productOnScreen)(segments, products, shownPositionMs), [segments, products, shownPositionMs]);
+    const firstShownAt = (0, react_1.useCallback)((productId) => (0, livePages_1.firstShownAt)(segments, productId), [segments]);
+    const chatRead = (0, react_1.useRef)(new Map());
+    const [chat, setChat] = (0, react_1.useState)({ streamingId: '', comments: [] });
+    const streamingId = (_h = show === null || show === void 0 ? void 0 : show.streamingId) !== null && _h !== void 0 ? _h : null;
+    (0, react_1.useEffect)(() => {
+        if (!streamingId)
+            return;
+        const kept = chatRead.current.get(streamingId);
+        if (kept) {
+            setChat({ streamingId, comments: kept });
+            return;
+        }
+        let stillThisShow = true;
+        liveSelling_1.liveSelling.replays
+            .comments(streamingId)
+            .then((comments) => {
+            chatRead.current.set(streamingId, comments);
+            if (stillThisShow)
+                setChat({ streamingId, comments });
+        })
+            .catch((error) => (0, pageOptions_1.reportLiveWarning)(error, { at: 'replay.comments', streamingId }));
+        return () => {
+            stillThisShow = false;
+        };
+    }, [streamingId]);
+    const allComments = chat.streamingId === streamingId ? chat.comments : [];
+    const saidSoFar = (0, react_1.useMemo)(() => (0, livePages_1.replayCommentsAt)(allComments, shownPositionMs), [allComments, shownPositionMs]);
+    const [chatHidden, setChatHidden] = (0, react_1.useState)(false);
+    // A swipe is a new show: its own controls showing, its chat out.
+    (0, react_1.useEffect)(() => {
+        setChatHidden(false);
+        showControls();
+    }, [showId, showControls]);
+    // ─── A view, once per recording per visit; never from the web preview ─────────────────────────
+    // A recording back from the bubble was counted when it was opened: a round trip isn't a new view
+    // (production's new Replay screen on every return counted another, amore-v2's audit L4).
+    const counted = (0, react_1.useRef)(null);
+    if (!counted.current)
+        counted.current = new Set(holdsThisShow && show ? [show.id] : []);
+    (0, react_1.useEffect)(() => {
+        const seen = counted.current;
+        if (!showId || react_native_1.Platform.OS === 'web' || !seen || seen.has(showId))
+            return;
+        seen.add(showId);
+        void liveSelling_1.liveSelling.replays.incrementViews(showId);
+    }, [showId]);
+    // ─── Buying: every add from this screen is credited to the recording ──────────────────────────
+    const credit = (0, react_1.useMemo)(() => (0, showCredit_1.replayShowCredit)(showId, streamingId), [showId, streamingId]);
+    const quickAdd = (0, sdk_shopify_1.useQuickAdd)((0, showCredit_1.showQuickAddOptions)((params) => routes.openVariantPage(params, nav), { credit, track }));
+    const openVariantPage = (0, react_1.useCallback)((product) => {
+        if (!credit.lineAttributes)
+            return;
+        routes.openVariantPage({ handle: product.handle, ...credit }, nav);
+    }, [routes, nav, credit]);
+    const pickFromSheet = (0, react_1.useCallback)((product) => {
+        // Shown in the recording: to where the host first showed it, playing, so the pitch goes on behind
+        // the variant page. Never shown (no time window): the player is left exactly as it was, where it
+        // was and playing or paused; only the variant page opens (2026-10-05, Head of Engineering).
+        const startMs = firstShownAt(product.id);
+        if (startMs != null) {
+            seekTo(startMs);
+            setPausedByShopper(false);
+        }
+        openVariantPage(product);
+    }, [firstShownAt, seekTo, setPausedByShopper, openVariantPage]);
+    const nowProduct = (0, react_1.useMemo)(() => {
+        var _a, _b, _c, _d;
+        return onScreenProduct
+            ? {
+                id: onScreenProduct.id,
+                title: onScreenProduct.title,
+                price: (0, sdk_shopify_1.formatMoney)(onScreenProduct.priceRange.min),
+                imageUrl: (_d = (_b = (_a = onScreenProduct.featuredImage) === null || _a === void 0 ? void 0 : _a.url) !== null && _b !== void 0 ? _b : (_c = onScreenProduct.images[0]) === null || _c === void 0 ? void 0 : _c.url) !== null && _d !== void 0 ? _d : null,
+            }
+            : null;
+    }, [onScreenProduct]);
+    const auctionProductIds = (0, react_1.useMemo)(() => products.filter(sdk_shopify_1.isAuctioned).map((product) => product.id), [products]);
+    const poster = (replay) => (replay ? { id: replay.id, posterUrl: replay.thumbnailUrl } : null);
+    const leave = (0, react_1.useCallback)(() => {
+        if (nav.canGoBack())
+            nav.goBack();
+        else
+            routes.openHome(nav);
+    }, [nav, routes]);
+    // ✕: the show stops, with no bubble.
+    const close = (0, react_1.useCallback)(() => {
+        setClosing(true);
+        stop();
+        leave();
+    }, [stop, leave]);
+    // Picture-in-picture: the show shrinks into the bubble, and the shopper goes back.
+    const shrinkIntoBubble = (0, react_1.useCallback)(() => {
+        if (holdsVideo(videoUrl))
+            showBubble();
+        leave();
+    }, [holdsVideo, videoUrl, showBubble, leave]);
+    // The cart opens under the bubble, so the show plays on over it, as production's; coming back here ends the bubble.
+    const openCart = (0, react_1.useCallback)(() => {
+        if (holdsVideo(videoUrl))
+            showBubble();
+        routes.openCart({ itemsYouWon: false }, nav);
+    }, [holdsVideo, videoUrl, showBubble, routes, nav]);
+    const playerShown = !missing;
+    const showing = !!show;
+    return {
+        /** The video is on screen: light status bar text over it. */
+        darkBehindStatusBar: playerShown && onScreen,
+        player: {
+            visible: playerShown,
+            show: poster(show),
+            previousShow: poster(previousShow),
+            nextShow: poster(nextShow),
+            // Drawn only once the player holds this recording, a new view per recording: on web a view still
+            // showing the last one would load the new one twice (from `replace`, then from React setting its
+            // `src`), and the second load aborts the first's `play()` (an unhandled `AbortError` inside
+            // expo-video's web player). And one view at a time: while the bubble has the video, none here.
+            player: holdsThisShow && !bubbleShown ? player : null,
+            // The poster stands in for the picture while the bubble has it (the screen sliding away, or under the cart).
+            videoReady: videoReady && !bubbleShown,
+            buffering: !closing && !!videoUrl && status !== 'error' && (status === 'loading' || !videoReady),
+            onVideoFirstFrame: () => {
+                if (holdsThisShow)
+                    markVideoReady();
+            },
+            onTapVideo: toggleControls,
+            onSwipeToNext: () => goTo(nextShow),
+            onSwipeToPrevious: () => goTo(previousShow),
+        },
+        header: {
+            title: (_j = show === null || show === void 0 ? void 0 : show.title) !== null && _j !== void 0 ? _j : null,
+            muted,
+            canMute: showing,
+            // Something to shrink: the player holds this recording.
+            canPip: holdsThisShow,
+            cartCount: itemCount,
+            onClose: close,
+            onToggleMute: () => {
+                replayPlayer.setMuted(!muted);
+                showControls();
+            },
+            onPip: shrinkIntoBubble,
+            onCart: openCart,
+        },
+        controls: {
+            visible: showing && controlsVisible,
+            positionMs: shownPositionMs,
+            durationMs,
+            playing,
+            onScrub: (atMs) => {
+                setScrubMs(atMs);
+                showControls();
+            },
+            onSeek: (atMs) => {
+                seekTo(atMs);
+                showControls();
+            },
+            onSkip: (changeMs) => {
+                var _a, _b;
+                // From the time last asked for, so tapping +10 twice adds up while the first is still seeking.
+                seekTo(((_b = (_a = pendingSeek.current) === null || _a === void 0 ? void 0 : _a.targetMs) !== null && _b !== void 0 ? _b : shownPositionMs) + changeMs);
+                showControls();
+            },
+            onTogglePlay: () => {
+                showControls();
+                if (!holdsThisShow)
+                    return;
+                if (playing) {
+                    setPausedByShopper(true);
+                    return;
+                }
+                setPausedByShopper(false);
+                // At the end of the recording, play means from the start.
+                if (durationMs > 0 && shownPositionMs >= durationMs - 1000)
+                    seekTo(0);
+                player.play();
+            },
+        },
+        nowCard: {
+            visible: showing,
+            product: nowProduct,
+            favorite: !!onScreenProduct && wishlist.has(onScreenProduct.id),
+            onOpen: () => {
+                if (onScreenProduct)
+                    openVariantPage(onScreenProduct);
+            },
+            onToggleFavorite: () => {
+                if (onScreenProduct)
+                    void wishlist.toggle(onScreenProduct);
+            },
+            onShare: () => {
+                if (onScreenProduct)
+                    void (0, useLiveShop_1.shareProduct)(onScreenProduct);
+            },
+        },
+        comments: {
+            visible: showing,
+            comments: saidSoFar,
+            hasChat: allComments.length > 0,
+            hidden: chatHidden,
+            onToggleHidden: () => setChatHidden((wasHidden) => !wasHidden),
+        },
+        shopBar: {
+            visible: showing,
+            products,
+            onScreenProductId: (_k = onScreenProduct === null || onScreenProduct === void 0 ? void 0 : onScreenProduct.id) !== null && _k !== void 0 ? _k : null,
+            favoriteIds: wishlist.ids,
+            auctionProductIds,
+            onPressProduct: pickFromSheet,
+            onToggleFavorite: (product) => void wishlist.toggle(product),
+            onQuickAdd: quickAdd.add,
+            addingProductIds: quickAdd.addingProductIds,
+        },
+        missing: {
+            visible: missing,
+            onAction: () => routes.openHome(nav),
+        },
+    };
+}
+//# sourceMappingURL=useReplayPage.js.map

package/dist/react/useReplayPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReplayPage.js","sourceRoot":"","sources":["../../src/react/useReplayPage.ts"],"names":[],"mappings":"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"}

package/dist/sessionTypes.d.ts

@@ -343,13 +343,17 @@ export interface IdentityAdapter {
     bidderId?: () => string | null;
     /** Full customer identifier, when the giveaway endpoint wants one (Shopify: the GID). */
     customerRef?: () => string | null;
-    /** The customer's own display name, so a signed-in bidder is never asked to invent one. */
+    /**
+     * The customer's own display name; null when their account has none. Never an email nor any part of
+     * it: the room shows it to everyone (`viewerNameFor`).
+     */
     customerName?: () => string | null;
     customerEmail?: () => string | null;
     /**
-     * True while the app is still reading the signed-in customer on app open, so who they are (and
-     * their name) isn't known yet. The session waits for it before entering a show's room, up to
-     * 10 seconds (0.9.2): the name a viewer enters under is the one the host sees join.
+     * True while the app is still reading the signed-in customer (on app open, or just after a sign-in),
+     * so who they are (and their name) isn't known yet. The session waits for it before entering a
+     * show's room, up to 10 seconds (0.9.2): the name a viewer enters under is the one the host sees
+     * join. A comment sent meanwhile is held until it is known (0.13.0). Without it, nothing waits.
      */
     customerLoading?: () => boolean;
 }
@@ -417,7 +421,8 @@ export interface LiveSessionState<TRaw = unknown> {
     /**
      * What this device comments under: the identity adapter's name, or one a signed-out shopper gave.
      * **Null means nobody has said** — ask before letting the first comment out rather than publishing
-     * "Anonymous" to a room.
+     * "Anonymous" to a room. Never a name the show's team goes by (`blockedNames`, 0.13.0): one of those
+     * counts as no name.
      */
     viewerName: string | null;
     /** Inert unless the stream is an auction. */
@@ -440,8 +445,10 @@ export interface LiveSessionActions {
     /**
      * `forceMuted` shadow-mutes this comment: the room never sees it, the sender does.
      *
-     * For a signed-in shopper whose name has not loaded yet, the comment is held and sent the moment it
-     * does (or after 10 s), and the promise resolves then — so it never goes out as "Anonymous" (L6).
+     * For a signed-in shopper whose account is still loading (`identity.customerLoading`), the comment
+     * is held and sent the moment it has loaded (or after 10 s), and the promise resolves then — so it
+     * never goes out under a name that is about to change (L6). An account with no name on it is not
+     * waited for (0.13.0): ask the shopper for a name before sending (`viewerName` null).
      */
     sendComment: (text: string, options?: SendCommentOptions) => Promise<void>;
     sendReaction: (reactionUrl: string) => Promise<void>;
@@ -450,8 +457,9 @@ export interface LiveSessionActions {
     voteInPoll: (optionId: string) => Promise<void>;
     /**
      * Remember the name a signed-out shopper typed. Resolves to the name as stored — trimmed,
-     * collapsed, capped — or null if the input was empty, so the caller can send the comment that
-     * prompted for it without normalising again.
+     * collapsed, capped — or null if the input was empty or is a name the show's team goes by
+     * (`blockedNames`, 0.13.0: check it first with `isBlockedViewerName` to say why), so the caller can
+     * send the comment that prompted for it without normalising again.
      */
     chooseViewerName: (raw: string) => Promise<string | null>;
     /** Add to cart through the commerce adapter and tell the room. False when the line was refused. */