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

package/dist/react/useLiveChat.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useLiveChat = useLiveChat;
+/**
+ * The Live screen's chat and reactions (0.14.0, moved from amore-v2's `src/core/hooks/useLiveChat.ts`:
+ * phase 2 of its "Live player plan", Freckled Poppy's behaviour).
+ */
+const sdk_shopify_1 = require("@tiledev/sdk-shopify");
+const react_1 = require("react");
+const react_native_1 = require("react-native");
+const livePages_1 = require("../livePages");
+const viewer_1 = require("../viewer");
+const platformSession_1 = require("./platformSession");
+/**
+ * The Live screen's chat and reactions. `useLivePage` calls it with what it knows about the show and
+ * hands the result to the screen (`page.chat`), one set of props per tile.
+ *
+ * - **Only while the show is on air** (playing, or waiting for its host): the chat, the comment box,
+ *   the reaction button, the floating reactions and the pinned comment all go once it has ended, as
+ *   Freckled Poppy's, and while it is still joining (nothing can be said into a room not yet joined).
+ * - **The session does the work:** the room's history in front of what arrives since
+ *   (`session.comments`), the name a comment goes out under, holding a comment while the shopper's
+ *   account loads, the pin (`session.pinnedComment`), the host's reaction setting
+ *   (`session.reactionStyle`), and the shopper's own comment and reaction shown at once. Nothing here
+ *   repeats it.
+ * - **Anyone can comment** (Freckled Poppy's rule, decided): a shopper the room has no name for is asked
+ *   for one on their first comment, inside the comment box, and the session saves it on this phone
+ *   (`chooseViewerName`) before the comment goes out. A signed-in shopper comments under their
+ *   account's name (`ShopifyLiveSessionProvider`'s `viewerName`); while their account loads (on app
+ *   open, or a moment after signing in), Send waits. An account with no name, or with a name the show's
+ *   team goes by, gives the room none since 0.13.0, so that shopper is asked too, once it has loaded
+ *   (`chatNameAsk`; amore-v2's chat waited for ever for them).
+ * - **Reactions** need no sign-in. Which ones is the button tile's; the Live screen hands the same list
+ *   to the floating reactions.
+ * - **A tap on a name** in the chat puts "@name" in the comment box.
+ * - **Hide Comments** is the shopper's, for this visit to the screen.
+ * - **`keyboardUp`**: the comment box's keyboard is up, so the screen lets a tap on the video put it
+ *   away (iOS has no key for that).
+ */
+function useLiveChat({ onAir, canComment, canReact }) {
+    var _a, _b, _c, _d, _e;
+    // The session changes only on the room's events, never on a clock.
+    const session = (0, platformSession_1.useLiveSession)();
+    const { sendComment, sendReaction, chooseViewerName } = session.actions;
+    const { loggedIn, restoring, customer } = (0, sdk_shopify_1.useCustomer)();
+    // ─── Who the shopper is in the room ──────────────────────────────────────────────────────────────
+    const { askForName, waitingForName } = (0, livePages_1.chatNameAsk)({
+        named: !!((_a = session.viewerName) === null || _a === void 0 ? void 0 : _a.trim()),
+        loggedIn: !!loggedIn,
+        restoring: !!restoring,
+        hasCustomer: !!customer,
+    });
+    // ─── Commenting ─────────────────────────────────────────────────────────────────────────────────
+    const [sending, setSending] = (0, react_1.useState)(false);
+    const send = (0, react_1.useCallback)(async (text) => {
+        setSending(true);
+        try {
+            await sendComment(text);
+        }
+        finally {
+            setSending(false);
+        }
+    }, [sendComment]);
+    /** True once the session has saved the name, and the engine has it for the comment that follows. */
+    const saveName = (0, react_1.useCallback)(async (name) => !!(await chooseViewerName(name)), [chooseViewerName]);
+    const [mention, setMention] = (0, react_1.useState)(null);
+    const mentionsSoFar = (0, react_1.useRef)(0);
+    const replyTo = (0, react_1.useCallback)((name) => {
+        mentionsSoFar.current += 1;
+        setMention({ name, key: mentionsSoFar.current });
+    }, []);
+    const [commentsHidden, setCommentsHidden] = (0, react_1.useState)(false);
+    const toggleComments = (0, react_1.useCallback)(() => setCommentsHidden((hidden) => !hidden), []);
+    // ─── Reacting ───────────────────────────────────────────────────────────────────────────────────
+    const react = (0, react_1.useCallback)((reactionUrl) => void sendReaction(reactionUrl), [sendReaction]);
+    // ─── The keyboard ───────────────────────────────────────────────────────────────────────────────
+    const [keyboardUp, setKeyboardUp] = (0, react_1.useState)(false);
+    /**
+     * The comment box has the keyboard. The bottom group rises only then (fixed 2026-10-05: it rose for
+     * any keyboard, and Shopify's sign-in sheet, opened by a bid while signed out, left it stuck a
+     * keyboard's height up the screen when the sheet closed without the screen hearing the keyboard go).
+     */
+    const [typing, setTyping] = (0, react_1.useState)(false);
+    (0, react_1.useEffect)(() => {
+        const shown = react_native_1.Keyboard.addListener(react_native_1.Platform.OS === 'ios' ? 'keyboardWillShow' : 'keyboardDidShow', () => setKeyboardUp(true));
+        const hidden = react_native_1.Keyboard.addListener(react_native_1.Platform.OS === 'ios' ? 'keyboardWillHide' : 'keyboardDidHide', () => setKeyboardUp(false));
+        return () => {
+            shown.remove();
+            hidden.remove();
+        };
+    }, []);
+    const commentBoxShown = onAir && canComment;
+    return {
+        keyboardUp: commentBoxShown && typing && keyboardUp,
+        /** The comment box has the keyboard: the screen lifts its bottom group for it, and for nothing else. */
+        typing: commentBoxShown && typing,
+        comments: {
+            visible: onAir,
+            comments: (_b = session.comments) !== null && _b !== void 0 ? _b : [],
+            hidden: commentsHidden,
+            onToggleHidden: toggleComments,
+            // Only with a comment box to reply into.
+            onPressName: commentBoxShown ? replyTo : undefined,
+        },
+        commentBox: {
+            visible: commentBoxShown,
+            askForName,
+            waitingForName,
+            sending,
+            mention,
+            nameMaxLength: viewer_1.MAX_VIEWER_NAME,
+            onSend: send,
+            onSaveName: saveName,
+            onTypingChange: setTyping,
+        },
+        reactionButton: {
+            visible: onAir && canReact,
+            onReact: react,
+        },
+        reactions: {
+            visible: onAir,
+            reactions: (_c = session.reactions) !== null && _c !== void 0 ? _c : [],
+            reactionStyle: (_d = session.reactionStyle) !== null && _d !== void 0 ? _d : 'single',
+        },
+        pinnedComment: {
+            visible: onAir,
+            pinnedComment: (_e = session.pinnedComment) !== null && _e !== void 0 ? _e : null,
+        },
+    };
+}
+//# sourceMappingURL=useLiveChat.js.map

package/dist/react/useLiveChat.js.map

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

package/dist/react/useLiveGiveawaysAndPolls.d.ts

@@ -0,0 +1,84 @@
+import type { LiveGiveawayPrize } from '../pageTypes';
+/**
+ * The Live screen's giveaways and polls, so the screen stays plain tiles. Reads the app's live session
+ * for the show the route names, as `useLiveShop` does.
+ *
+ * - **Only while the show is on air** (playing, or waiting for its host) and the session holds this
+ *   show's record (`useLiveShow`; never a hidden show the shopper can't see). Once the show has ended,
+ *   all three tiles go.
+ * - **The session does the work:** the giveaway and poll, from the room and from the show's record for
+ *   a shopper who arrives late; the entry count; whether this shopper has entered
+ *   (`giveaway.registered`); the entry itself (`actions.enterGiveaway`); the draw's roster, waited for
+ *   and kept (`giveaway.result.entrantNamesReady`, ENG-705); one vote a poll, kept on the phone
+ *   (`actions.voteInPoll`), the tally hidden until this phone votes; a giveaway this phone watched end
+ *   never coming back from an out-of-date record, and a poll the record says has closed never raised;
+ *   the entry's flow (`useGiveawayEntry`), "YOU WON!" (`giveaway.result.isYou`) and the prize's
+ *   catalogue read (`useGiveawayPrize`). Nothing here repeats it.
+ * - **The giveaway** (`giveawayButton`): the pill while a giveaway is open and not drawn yet. Its sheet
+ *   shows the prize from the catalogue (Freckled Poppy's: the host picks it from the whole store, not
+ *   from this show's lots), its variant's photo and price, and the record's own name and variant; until
+ *   the catalogue answers, the record's variant photo and price (`variantImageUrl`, `variantPrice`). A
+ *   catalogue read that fails goes to `onWarning`.
+ *   - **Entering needs sign-in** (Freckled Poppy's rule). Signed out, Enter closes the sheet and starts
+ *     the app's sign-in (sdk-shopify's `useSignIn`; the app's Sign In page is `routes.openSignIn`); back
+ *     here signed in, the sheet opens again if the giveaway is still open and not drawn (Freckled
+ *     Poppy's ENG-583 fix), and the shopper taps Enter themselves. Back without signing in (the Sign In
+ *     page closed, or the system's sheet dismissed), nothing reopens. `useGiveawayEntry` does this;
+ *     "back here" is this screen focused with no system sheet up.
+ *   - **The entry carries the room's name for the shopper** (`session.viewerName`: their account's
+ *     name, never an email). While it loads, Enter waits; if the room has none (an account with no
+ *     name, since 0.13.0), the sheet asks ("Entering As:", old Amore's) and the entry goes once the
+ *     session holds the name.
+ *   - An entry the host didn't confirm (`enterGiveaway` answers `{ entered: false }`) says so in the
+ *     sheet, and Enter can be tried again.
+ *   - The host's draw closes the sheet (Freckled Poppy's).
+ * - **The draw** (`giveawayDraw`): handed over once the roster is ready; "YOU WON!" for the shopper who
+ *   won (`giveaway.result.isYou`: by customer id when the record names the winner, else among those who
+ *   entered by name, the gateway naming the winner only by name). A draw already on the session when
+ *   this screen opens happened while the shopper was elsewhere: it is let go rather than played late.
+ * - **Where the prize goes is the server's, by the kind of show** (corrected 2026-10-19 in k-marie-v2,
+ *   ENG-928). On an auction show the server writes the win to the customer's `auction.winner` metafield
+ *   only, and Items You Won shows it. On a live show (not an auction) it adds the prize line, with its
+ *   `GIVEAWAY-…` discount code, to the cart id the shopper entered with (`cartId`, below) and writes no
+ *   metafield: Items You Won never sees it, and if that cart has been replaced since (a new cart after
+ *   an order, a dead cart replaced at launch) the prize is lost.
+ * - **The poll** (`pollButton`): the chip while a poll is open; its sheet closes when the poll ends or
+ *   the host opens another (Freckled Poppy's). Voting needs no sign-in.
+ */
+export declare function useLiveGiveawaysAndPolls(): {
+    giveawayButton: {
+        visible: boolean;
+        prize: LiveGiveawayPrize | null;
+        entryCount: number;
+        entered: boolean;
+        entering: boolean;
+        signInToEnter: boolean;
+        waitingForName: boolean;
+        askForName: boolean;
+        nameMaxLength: number;
+        entryFailed: boolean;
+        sheetVisible: boolean;
+        onOpenSheet: () => void;
+        onCloseSheet: () => void;
+        onEnter: (typedName?: string) => void;
+        onSignInToEnter: () => void;
+    };
+    giveawayDraw: {
+        visible: boolean;
+        draw: import("./useGiveawayEntry").GiveawayDraw | null;
+        isWinner: boolean;
+        onDone: () => void;
+    };
+    pollButton: {
+        visible: boolean;
+        poll: import("../sessionTypes").LivePollView | null;
+        logoUrl: string | null;
+        sheetVisible: boolean;
+        onOpenSheet: () => void;
+        onCloseSheet: () => void;
+        onVote: (optionId: string) => void;
+    };
+};
+/** What `useLiveGiveawaysAndPolls` hands the Live screen's giveaway and poll tiles. */
+export type LiveGiveawaysAndPolls = ReturnType<typeof useLiveGiveawaysAndPolls>;
+//# sourceMappingURL=useLiveGiveawaysAndPolls.d.ts.map

package/dist/react/useLiveGiveawaysAndPolls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLiveGiveawaysAndPolls.d.ts","sourceRoot":"","sources":["../../src/react/useLiveGiveawaysAndPolls.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAYtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BA4EzB,MAAM;;EA0CpB;AAED,uFAAuF;AACvF,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/react/useLiveGiveawaysAndPolls.js

@@ -0,0 +1,180 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useLiveGiveawaysAndPolls = useLiveGiveawaysAndPolls;
+/**
+ * The Live screen's giveaways and polls (0.14.0, moved from amore-v2's
+ * `src/core/hooks/useLiveGiveawaysAndPolls.ts`: phase 5 of its "Live player plan", Freckled Poppy's
+ * behaviour, old Amore's look). The routes are the app's (`LiveSellingProvider`'s `routes`); the
+ * route's `streamId` param is read here.
+ */
+const sdk_shopify_1 = require("@tiledev/sdk-shopify");
+const react_1 = require("react");
+const pageOptions_1 = require("../pageOptions");
+const sessionTypes_1 = require("../sessionTypes");
+const viewer_1 = require("../viewer");
+const LiveSellingProvider_1 = require("./LiveSellingProvider");
+const platformSession_1 = require("./platformSession");
+const useGiveawayEntry_1 = require("./useGiveawayEntry");
+const useGiveawayPrize_1 = require("./useGiveawayPrize");
+const navigation_1 = require("./navigation");
+/**
+ * The Live screen's giveaways and polls, so the screen stays plain tiles. Reads the app's live session
+ * for the show the route names, as `useLiveShop` does.
+ *
+ * - **Only while the show is on air** (playing, or waiting for its host) and the session holds this
+ *   show's record (`useLiveShow`; never a hidden show the shopper can't see). Once the show has ended,
+ *   all three tiles go.
+ * - **The session does the work:** the giveaway and poll, from the room and from the show's record for
+ *   a shopper who arrives late; the entry count; whether this shopper has entered
+ *   (`giveaway.registered`); the entry itself (`actions.enterGiveaway`); the draw's roster, waited for
+ *   and kept (`giveaway.result.entrantNamesReady`, ENG-705); one vote a poll, kept on the phone
+ *   (`actions.voteInPoll`), the tally hidden until this phone votes; a giveaway this phone watched end
+ *   never coming back from an out-of-date record, and a poll the record says has closed never raised;
+ *   the entry's flow (`useGiveawayEntry`), "YOU WON!" (`giveaway.result.isYou`) and the prize's
+ *   catalogue read (`useGiveawayPrize`). Nothing here repeats it.
+ * - **The giveaway** (`giveawayButton`): the pill while a giveaway is open and not drawn yet. Its sheet
+ *   shows the prize from the catalogue (Freckled Poppy's: the host picks it from the whole store, not
+ *   from this show's lots), its variant's photo and price, and the record's own name and variant; until
+ *   the catalogue answers, the record's variant photo and price (`variantImageUrl`, `variantPrice`). A
+ *   catalogue read that fails goes to `onWarning`.
+ *   - **Entering needs sign-in** (Freckled Poppy's rule). Signed out, Enter closes the sheet and starts
+ *     the app's sign-in (sdk-shopify's `useSignIn`; the app's Sign In page is `routes.openSignIn`); back
+ *     here signed in, the sheet opens again if the giveaway is still open and not drawn (Freckled
+ *     Poppy's ENG-583 fix), and the shopper taps Enter themselves. Back without signing in (the Sign In
+ *     page closed, or the system's sheet dismissed), nothing reopens. `useGiveawayEntry` does this;
+ *     "back here" is this screen focused with no system sheet up.
+ *   - **The entry carries the room's name for the shopper** (`session.viewerName`: their account's
+ *     name, never an email). While it loads, Enter waits; if the room has none (an account with no
+ *     name, since 0.13.0), the sheet asks ("Entering As:", old Amore's) and the entry goes once the
+ *     session holds the name.
+ *   - An entry the host didn't confirm (`enterGiveaway` answers `{ entered: false }`) says so in the
+ *     sheet, and Enter can be tried again.
+ *   - The host's draw closes the sheet (Freckled Poppy's).
+ * - **The draw** (`giveawayDraw`): handed over once the roster is ready; "YOU WON!" for the shopper who
+ *   won (`giveaway.result.isYou`: by customer id when the record names the winner, else among those who
+ *   entered by name, the gateway naming the winner only by name). A draw already on the session when
+ *   this screen opens happened while the shopper was elsewhere: it is let go rather than played late.
+ * - **Where the prize goes is the server's, by the kind of show** (corrected 2026-10-19 in k-marie-v2,
+ *   ENG-928). On an auction show the server writes the win to the customer's `auction.winner` metafield
+ *   only, and Items You Won shows it. On a live show (not an auction) it adds the prize line, with its
+ *   `GIVEAWAY-…` discount code, to the cart id the shopper entered with (`cartId`, below) and writes no
+ *   metafield: Items You Won never sees it, and if that cart has been replaced since (a new cart after
+ *   an order, a dead cart replaced at launch) the prize is lost.
+ * - **The poll** (`pollButton`): the chip while a poll is open; its sheet closes when the poll ends or
+ *   the host opens another (Freckled Poppy's). Voting needs no sign-in.
+ */
+function useLiveGiveawaysAndPolls() {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
+    const streamId = (_b = (_a = (0, navigation_1.useRoute)().params) === null || _a === void 0 ? void 0 : _a.streamId) !== null && _b !== void 0 ? _b : '';
+    const isFocused = (0, navigation_1.useIsFocused)();
+    // The session changes only on the room's events, never on a clock.
+    const session = (0, platformSession_1.useLiveSession)();
+    const { voteInPoll } = session.actions;
+    const { loggedIn, restoring, customer } = (0, sdk_shopify_1.useCustomer)();
+    const cartId = (_d = (_c = (0, sdk_shopify_1.useCart)().cart) === null || _c === void 0 ? void 0 : _c.id) !== null && _d !== void 0 ? _d : null;
+    const nav = (0, navigation_1.useNavigation)();
+    const { routes } = (0, LiveSellingProvider_1.useLivePageOptions)();
+    const signIn = (0, sdk_shopify_1.useSignIn)({ onOpenSignInPage: (method) => routes.openSignIn(method, nav) });
+    // ─── Which show ────────────────────────────────────────────────────────────────────────────────
+    // The session's record once it is this show's: right after the pin it can still hold the last show's.
+    const { show, onAir, capabilities } = (0, platformSession_1.useLiveShow)(streamId);
+    const showing = onAir && !!show;
+    const giveaway = (_e = session.giveaway) !== null && _e !== void 0 ? _e : sessionTypes_1.IDLE_GIVEAWAY;
+    // ─── The giveaway: the entry's flow ────────────────────────────────────────────────────────────
+    const entry = (0, useGiveawayEntry_1.useGiveawayEntry)({
+        session,
+        canEnter: showing && capabilities.canEnterGiveaway,
+        isLoggedIn: !!loggedIn,
+        startSignIn: signIn.start,
+        // Back here: this screen focused (the Sign In page closed), and no system sign-in sheet up.
+        screenOnShow: isFocused && !signIn.signingIn,
+        // The shopper's ordinary cart, which the gateway ties the entry to (Freckled Poppy's). On a live
+        // show the server puts a won prize in this cart, even if the app has moved to another by the draw
+        // ("Where the prize goes", above).
+        cartId,
+    });
+    const openGiveaway = entry.open;
+    /** The prize from the catalogue: the description, and the given-away variant's photo and price. */
+    const { product: prizeProduct, variant: prizeVariant, readError: prizeReadError } = (0, useGiveawayPrize_1.useGiveawayPrize)(openGiveaway);
+    (0, react_1.useEffect)(() => {
+        var _a;
+        if (prizeReadError)
+            (0, pageOptions_1.reportLiveWarning)(prizeReadError, { at: 'live.giveawayPrize', storeProductId: (_a = openGiveaway === null || openGiveaway === void 0 ? void 0 : openGiveaway.storeProductId) !== null && _a !== void 0 ? _a : null });
+        // Reported once per failed read, for the prize it was for.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [prizeReadError]);
+    // The record's own price, should the catalogue not answer, priced in the show's currency.
+    const showCurrency = (_k = (_g = (_f = session.activeProduct) === null || _f === void 0 ? void 0 : _f.currencyCode) !== null && _g !== void 0 ? _g : (_j = (_h = session.products) === null || _h === void 0 ? void 0 : _h[0]) === null || _j === void 0 ? void 0 : _j.currencyCode) !== null && _k !== void 0 ? _k : null;
+    const prize = (0, react_1.useMemo)(() => {
+        var _a, _b, _c, _d, _e, _f, _g, _h;
+        if (!openGiveaway)
+            return null;
+        const recordPrice = openGiveaway.variantPrice && showCurrency ? (0, sdk_shopify_1.formatMoney)({ amount: openGiveaway.variantPrice, currencyCode: showCurrency }) : null;
+        const variantPrice = (prizeVariant === null || prizeVariant === void 0 ? void 0 : prizeVariant.price) && (prizeProduct === null || prizeProduct === void 0 ? void 0 : prizeProduct.currencyCode) ? (0, sdk_shopify_1.formatMoney)({ amount: prizeVariant.price, currencyCode: prizeProduct.currencyCode }) : null;
+        return {
+            productName: openGiveaway.productName || (prizeProduct === null || prizeProduct === void 0 ? void 0 : prizeProduct.title) || '',
+            variantTitle: (_b = (_a = openGiveaway.variantTitle) !== null && _a !== void 0 ? _a : prizeVariant === null || prizeVariant === void 0 ? void 0 : prizeVariant.title) !== null && _b !== void 0 ? _b : null,
+            retailPrice: prizeVariant ? variantPrice : recordPrice,
+            // The catalogue's variant photo, else its product photo; until it answers, the record's variant photo.
+            imageUrl: (_f = (_e = (_d = (_c = prizeVariant === null || prizeVariant === void 0 ? void 0 : prizeVariant.imageUrl) !== null && _c !== void 0 ? _c : prizeProduct === null || prizeProduct === void 0 ? void 0 : prizeProduct.imageUrl) !== null && _d !== void 0 ? _d : openGiveaway.variantImageUrl) !== null && _e !== void 0 ? _e : openGiveaway.thumbnailUrl) !== null && _f !== void 0 ? _f : null,
+            description: ((_h = (_g = prizeProduct === null || prizeProduct === void 0 ? void 0 : prizeProduct.raw) === null || _g === void 0 ? void 0 : _g.description) === null || _h === void 0 ? void 0 : _h.trim()) || null,
+        };
+    }, [openGiveaway, prizeProduct, prizeVariant, showCurrency]);
+    // ─── Who the shopper is to the giveaway ────────────────────────────────────────────────────────
+    const named = !!((_l = session.viewerName) === null || _l === void 0 ? void 0 : _l.trim());
+    const signInToEnter = !loggedIn && !restoring;
+    // A stored sign-in still being read, or a signed-in shopper's profile (and so their name) still on its way.
+    const waitingForName = !!restoring || (!!loggedIn && !named && !customer);
+    const askForName = !!loggedIn && !named && !!customer;
+    // ─── The poll ──────────────────────────────────────────────────────────────────────────────────
+    const poll = showing ? ((_m = session.poll) !== null && _m !== void 0 ? _m : null) : null;
+    const pollId = (_p = (_o = session.poll) === null || _o === void 0 ? void 0 : _o.pollUuid) !== null && _p !== void 0 ? _p : null;
+    const [pollSheetOpen, setPollSheetOpen] = (0, react_1.useState)(false);
+    // Closed whenever the poll changes, ended or replaced by the host's next: an empty sheet, or a
+    // question the shopper never chose to answer, would be in front of them.
+    (0, react_1.useEffect)(() => {
+        setPollSheetOpen(false);
+    }, [pollId]);
+    const votedAlready = !!((_q = session.poll) === null || _q === void 0 ? void 0 : _q.votedOptionId);
+    const vote = (0, react_1.useCallback)((optionId) => {
+        // One vote a poll (the session keeps it on the phone and ignores another); the sheet's choices are off once voted.
+        if (!votedAlready)
+            void voteInPoll(optionId);
+    }, [votedAlready, voteInPoll]);
+    return {
+        giveawayButton: {
+            visible: !!openGiveaway,
+            prize,
+            entryCount: giveaway.entryCount,
+            entered: giveaway.registered,
+            entering: entry.entering,
+            signInToEnter,
+            waitingForName,
+            askForName,
+            nameMaxLength: viewer_1.MAX_VIEWER_NAME,
+            entryFailed: entry.entryFailed,
+            sheetVisible: entry.sheetOpen,
+            onOpenSheet: entry.openSheet,
+            onCloseSheet: entry.closeSheet,
+            onEnter: entry.enter,
+            onSignInToEnter: entry.signInToEnter,
+        },
+        giveawayDraw: {
+            visible: showing,
+            draw: entry.draw,
+            isWinner: entry.youWon,
+            onDone: entry.drawDone,
+        },
+        pollButton: {
+            visible: !!poll,
+            poll,
+            // The show's poster stands in for a brand mark beside the question (old Amore's).
+            logoUrl: (_r = show === null || show === void 0 ? void 0 : show.thumbnailUrl) !== null && _r !== void 0 ? _r : null,
+            sheetVisible: pollSheetOpen && !!poll,
+            onOpenSheet: () => setPollSheetOpen(true),
+            onCloseSheet: () => setPollSheetOpen(false),
+            onVote: vote,
+        },
+    };
+}
+//# sourceMappingURL=useLiveGiveawaysAndPolls.js.map

package/dist/react/useLiveGiveawaysAndPolls.js.map

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

package/dist/react/useLivePage.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Everything the Live screen wires, so the screen stays plain tiles. Call it from the Live screen and
+ * from each of its tiles' wiring: every call reads the same session.
+ *
+ * - **The session is the app's** (`ShopifyLiveSessionProvider`), joined above the navigator; this
+ *   screen binds to its picture (the player tile's `LiveVideoTarget`) and never owns the room.
+ * - **Pinned to the route's show** while watching (`holdStream(streamId)`, at every arrival), so a host
+ *   restarting the broadcast can't swap the room underneath; released when the shopper closes the show
+ *   (back on a show that has ended or is still joining, ✕ on the bubble, or leaving any other way
+ *   without the bubble), and kept when the bubble takes the show.
+ * - **Which show** (`useLiveShow`): the session's record once it is this show's (just after the pin it
+ *   can still hold the last show's), where it stands, and whether it is on air.
+ * - **Where the link lands** (`streams.destinationFor`, one read of the show's record on arrival): a
+ *   show on air stays; an ended show with a recording is replaced by its Replay
+ *   (`routes.replaceWithReplay`); anything else (a rehearsal this shopper can't see included) by the
+ *   Live tab (`routes.backToLiveTab`). Not on the web, where nothing can play: the Tile preview stays on
+ *   this page to show its tiles, with the record's poster and the ended words.
+ * - **Every arrival** reads the record again (`refreshStreamRecords`, which restarts the session's
+ *   off-air wait, so a push tapped in the foreground can't be declared over on a stale record) and ends
+ *   the bubble: this screen shows the picture again.
+ * - **Back, every kind** (the header's arrow, the iOS swipe, Android's back; decided 2026-10-05,
+ *   amore-v2's Head of Engineering) shrinks a show that is playing or waiting for its host into the
+ *   bubble as the screen leaves, and closes one that has ended. One path: the screen's `beforeRemove`,
+ *   for the navigation's back actions (`BACK_ACTIONS`). Picture-in-picture is a back that always
+ *   shrinks; the cart shrinks the show and opens the Cart over this screen (Items You Won on an auction
+ *   show: `routes.openCart`). Android's back with nothing behind this screen (a link on a cold start)
+ *   does what the arrow does: back to the Live tab.
+ * - **One shrunk show at a time:** arriving here stops a replay's bubble (and the Replay screen stops
+ *   this show's bubble).
+ * - **The screen stays on** while it shows the show playing or waiting for its host.
+ * - **Under a sheet** (`routes.sheets`: the variant page, opened from the shop; the Sign In page) the
+ *   show plays on here, with the screen on and the light status bar, as Replay's does.
+ * - **Put away** while the show plays here (a sheet over it included), it goes on in the phone's own
+ *   floating window (`systemWindowWhenAway`); coming back finds it here again.
+ * - **`liveJoin`** (`track`) once per show per app run; never for a rehearsal, a show the config's
+ *   `hiddenShows` names, whoever watches it.
+ * - **Hidden shows** (`hiddenShows`): for a shopper who isn't on the team the session never holds one,
+ *   so it is never on air here (the link goes to the Live tab).
+ * - **Chat and reactions** are `useLiveChat`'s, shown only while the show is on air.
+ */
+export declare function useLivePage(): {
+    /**
+     * Android's own picture-in-picture window is up. It shrinks the whole app, and every sheet on the
+     * Live screen (poll, giveaway, shop, custom bid, name, reactions) is a window of its own above the
+     * app, so it rode the shrink and covered the video (fixed 2026-10-08; Freckled Poppy hides its
+     * sheets the same way). The screen then draws only the player; the sheets' open state is the
+     * hooks', so they come back. iOS's window shows the video alone.
+     */
+    inSystemWindow: boolean;
+    /** The screen is on show (or under a sheet), over the dark video: light status bar text. */
+    lightStatusBar: boolean;
+    player: {
+        status: import("..").LiveShowStatus;
+        posterUrl: string | null;
+        isAuction: boolean;
+        videoActive: boolean;
+        systemWindowWhenAway: boolean;
+    };
+    header: {
+        ended: boolean;
+        isAuction: boolean;
+        startedAt: number | null;
+        viewerCount: number | null;
+        muted: boolean;
+        canMute: boolean;
+        canPip: boolean;
+        backShrinks: boolean;
+        cartCount: number;
+        onBack: () => void;
+        onToggleMute: () => void;
+        onPip: () => void;
+        onCart: () => void;
+    };
+    /** The chat, the comment box, reactions and the pinned comment: one set of props per tile (`useLiveChat`). */
+    chat: {
+        keyboardUp: boolean;
+        typing: boolean;
+        comments: {
+            visible: boolean;
+            comments: import("../types").LiveComment[];
+            hidden: boolean;
+            onToggleHidden: () => void;
+            onPressName: ((name: string) => void) | undefined;
+        };
+        commentBox: {
+            visible: boolean;
+            askForName: boolean;
+            waitingForName: boolean;
+            sending: boolean;
+            mention: import("..").LiveCommentMention | null;
+            nameMaxLength: number;
+            onSend: (text: string) => Promise<void>;
+            onSaveName: (name: string) => Promise<boolean>;
+            onTypingChange: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+        };
+        reactionButton: {
+            visible: boolean;
+            onReact: (reactionUrl: string) => undefined;
+        };
+        reactions: {
+            visible: boolean;
+            reactions: import("../sessionTypes").FloatingReaction[];
+            reactionStyle: import("../types").ReactionStyle;
+        };
+        pinnedComment: {
+            visible: boolean;
+            pinnedComment: import("../types").LivePinnedComment | null;
+        };
+    };
+};
+/** What `useLivePage` hands the Live screen and its tiles. */
+export type LivePage = ReturnType<typeof useLivePage>;
+//# sourceMappingURL=useLivePage.d.ts.map

package/dist/react/useLivePage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLivePage.d.ts","sourceRoot":"","sources":["../../src/react/useLivePage.ts"],"names":[],"mappings":"AA4CA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,WAAW;IA8JvB;;;;;;OAMG;;IAEH,4FAA4F;;;;;;;;;;;;;;;;;;;;;;;;IA8B5F,8GAA8G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGjH;AAED,8DAA8D;AAC9D,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC"}