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

package/dist/react/useLiveAuction.js

@@ -0,0 +1,249 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useLiveAuction = useLiveAuction;
+/**
+ * The Live screen's auction (0.14.0, moved from amore-v2's `src/core/hooks/useLiveAuction.ts`: phase 4
+ * of its "Live player plan", bidding). The routes and the store's name are the app's
+ * (`LiveSellingProvider`'s `routes` and `shopName`); the route's `streamId` param is read here.
+ */
+const sdk_shopify_1 = require("@tiledev/sdk-shopify");
+const react_1 = require("react");
+const auctionRules_1 = require("../auctionRules");
+const linkLots_1 = require("../linkLots");
+const LiveSellingProvider_1 = require("./LiveSellingProvider");
+const platformSession_1 = require("./platformSession");
+const navigation_1 = require("./navigation");
+/**
+ * Why a sent bid "didn't go through", in the bar's words (decided 2026-10-06, amore-v2's Head of
+ * Engineering): no moderator was known for the round (L3), or the room's send failed. The session's
+ * other reasons never reach a shopper here: the gate sends only for a signed-in bidder (`signedOut`)
+ * and only while this show's round is open (`noShow`). `noAmount` (a bid of 0, on a lot the host gave
+ * no starting bid, before the first bid) has no words yet.
+ */
+const DIDNT_GO_THROUGH = new Set(['noModerator', 'sendFailed']);
+/** Money in the lot's currency, for a tile that shows it as words. */
+const moneyIn = (currencyCode) => (amount) => (0, sdk_shopify_1.formatMoney)({ amount: String(amount), currencyCode });
+/**
+ * The Live screen's auction, so the screen stays plain tiles. The session never ticks: it gives when
+ * the round closes (`auction.closesAt`, on the phone's clock), and the bid bar and the final countdown
+ * count down to it themselves (`useAuctionCountdown`), so the screen is never drawn on the round's
+ * clock.
+ *
+ * - **The session does the auction:** the round, the leader, the clock, the hammer and whether it is the
+ *   shopper's (`session.auction`, `lastWin.isYou`), the bid itself (`actions.placeBid`), and everything
+ *   in front of a bid (`useAuctionBidGate`: signed in, nothing unpaid from another show, the rules
+ *   accepted once per phone, a variant chosen once a round). Nothing here repeats them.
+ * - **The bid gate's sheets are the bid bar's** (decided, amore-v2's Head of Engineering): `step` tells
+ *   the bid bar which one to show. Signing in is sdk-shopify's `useSignIn` (Shopify's sheet, or the
+ *   app's Sign In page: `routes.openSignIn`), as bidding needs a Shopify sign-in (the win is written to
+ *   the customer).
+ * - **Back to the bid after signing in** (the gate's `startSignIn`): the bid waits; once the shopper is
+ *   a bidder, and if bidding on that lot is still open, it goes through the gate again (unpaid wins,
+ *   read fresh first, then the rules, the variant). Dropped when bidding on the lot closes, when the
+ *   shopper asks for another bid, or when this screen is back on show still signed out (the Sign In
+ *   page closed). Shopify's own sign-in sheet doesn't leave the screen: closed without signing in, the
+ *   bid waits until bidding on its lot closes. Signed in with the customer still loading, no sign-in
+ *   opens: the bid waits for them (`signInLoading`).
+ * - **A bid goes out at the amount the shopper saw** (the gate's `atAmountShown`): the slide's "Bid
+ *   $25.00", or the amount typed. The last look before it goes: the round still open with time on the
+ *   clock, at most the host's ceiling, at least the next bid. If the room moved past it (a sheet was
+ *   open meanwhile), it isn't sent and the bar says so (`refusal`), rather than going out at a price
+ *   nobody showed. After a bid goes the bar takes no other for 1.2 s (`bidOnItsWay`). The session sends
+ *   nothing when it knows no moderator for the round (L3), and a send can fail: `placeBid` says so
+ *   (`{ sent: false }`), and the bar says the bid didn't go through in the place of the outbid line,
+ *   and takes a bid again at once (decided 2026-10-06: "Bid didn't go through"). The bar's line goes
+ *   with the next bid or the round.
+ * - **The winner is told** (`win`): everyone sees who won; the shopper sees "You" when they held the
+ *   highest bid as the round closed and the winning bid is theirs (`lastWin.isYou`). The room sends only
+ *   the winner's name, not who they are. No name is handed out as an email. The win itself reaches the
+ *   cart's Items You Won from the server; that page reads it each time it opens.
+ * - **The lots** for the Shop button's sheet and the card (`lotStateFor`): open (the round is on it),
+ *   closed (won: on the show's record, or seen here), else upcoming. A link the host added (0.15.0,
+ *   `showLinkOf`) sits among them with its price and no state, and a featured link has no round on the
+ *   card: it is opened, never bid on (`useLiveShop` opens it).
+ * - **The store's name** in the bidding rules is `shopName` (old Amore's took the host's, which can be
+ *   a person's).
+ * - **Nothing shows** until the session holds this show's record (`useLiveShow`; never a hidden show the
+ *   shopper can't see), or on a show that isn't an auction. The web's session is always "ended":
+ *   nothing draws there.
+ */
+function useLiveAuction({ openItemsYouWon }) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+    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)();
+    const session = (0, platformSession_1.useLiveSession)();
+    const { placeBid, dismissAuctionWin } = session.actions;
+    const customer = (0, sdk_shopify_1.useCustomer)();
+    const nav = (0, navigation_1.useNavigation)();
+    const { routes, shopName, canOpenLinks } = (0, LiveSellingProvider_1.useLivePageOptions)();
+    const signIn = (0, sdk_shopify_1.useSignIn)({ onOpenSignInPage: (method) => routes.openSignIn(method, nav) });
+    const { auction } = session;
+    // ─── 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 isAuction = !!show && capabilities.canBid;
+    const roundOpen = isAuction && onAir && auction.biddingOpen;
+    // ─── Who is bidding ────────────────────────────────────────────────────────────────────────────
+    // The app's bidder (the identity's `bidderId`): a Shopify sign-in with the customer loaded.
+    const isBidder = !!customer.loggedIn && customer.sessionKind === 'shopify' && !!((_c = customer.customer) === null || _c === void 0 ? void 0 : _c.id);
+    // Signed in, the customer still loading (or the stored sign-in still being read): not someone to send to sign-in.
+    const bidderLoading = !isBidder && (!!customer.restoring || (!!customer.loggedIn && customer.sessionKind === 'shopify'));
+    // ─── The lot under the hammer ──────────────────────────────────────────────────────────────────
+    // The lot the host opened the round on, which may lead the featured product (old Amore's).
+    const lot = (0, react_1.useMemo)(() => {
+        var _a;
+        if (!auction.storeProductId)
+            return session.activeProduct;
+        return (_a = session.products.find((product) => product.storeProductId === auction.storeProductId)) !== null && _a !== void 0 ? _a : session.activeProduct;
+    }, [auction.storeProductId, session.products, session.activeProduct]);
+    const lotProduct = (_d = lot === null || lot === void 0 ? void 0 : lot.raw) !== null && _d !== void 0 ? _d : null;
+    const currencyCode = (_g = (_e = lot === null || lot === void 0 ? void 0 : lot.currencyCode) !== null && _e !== void 0 ? _e : (_f = session.products[0]) === null || _f === void 0 ? void 0 : _f.currencyCode) !== null && _g !== void 0 ? _g : 'USD';
+    const money = (0, react_1.useMemo)(() => moneyIn(currencyCode), [currencyCode]);
+    // ─── A bid that didn't go through ──────────────────────────────────────────────────────────────
+    /** The bar's one line about the last bid: the gate's refusal (outbid, over the ceiling), or a bid that didn't go through. */
+    const [barMessage, setBarMessage] = (0, react_1.useState)(null);
+    /** The last bid sent didn't go through: the bar takes another at once, rather than after its 1.2 s. */
+    const [lastBidFailed, setLastBidFailed] = (0, react_1.useState)(false);
+    const messagesSoFar = (0, react_1.useRef)(0);
+    const mounted = (0, react_1.useRef)(true);
+    (0, react_1.useEffect)(() => () => {
+        mounted.current = false;
+    }, []);
+    /** The session's bid, and what it answered: a bid that didn't go through is said on the bar. */
+    const placeBidAndSay = (0, react_1.useCallback)(async (options) => {
+        var _a;
+        setLastBidFailed(false);
+        const result = await placeBid(options);
+        if (mounted.current && !result.sent && DIDNT_GO_THROUGH.has(result.reason)) {
+            messagesSoFar.current += 1;
+            setBarMessage({ id: messagesSoFar.current, reason: 'notSent', amount: (_a = options === null || options === void 0 ? void 0 : options.amount) !== null && _a !== void 0 ? _a : 0 });
+            setLastBidFailed(true);
+        }
+        return result;
+    }, [placeBid]);
+    // ─── The bid gate ──────────────────────────────────────────────────────────────────────────────
+    const gate = (0, platformSession_1.useAuctionBidGate)({
+        streamingId: (_h = show === null || show === void 0 ? void 0 : show.streamingId) !== null && _h !== void 0 ? _h : null,
+        isLoggedIn: isBidder,
+        biddingOpen: roundOpen,
+        variantCount: (_j = lot === null || lot === void 0 ? void 0 : lot.variants.length) !== null && _j !== void 0 ? _j : 0,
+        placeBid: placeBidAndSay,
+        atAmountShown: true,
+        round: auction,
+        startSignIn: signIn.start,
+        signInLoading: bidderLoading,
+        screenOnShow: isFocused,
+    });
+    const { dismiss, refreshUnpaidWins, requestBid } = gate;
+    // The gate's refusals take the bar's line as they come.
+    const gateRefusal = gate.refusal;
+    (0, react_1.useEffect)(() => {
+        if (!gateRefusal)
+            return;
+        messagesSoFar.current += 1;
+        setBarMessage({ ...gateRefusal, id: messagesSoFar.current });
+    }, [gateRefusal]);
+    // The line goes with the next bid, and with the round (closed, or another lot's).
+    const bid = (0, react_1.useCallback)((amount) => {
+        setBarMessage(null);
+        requestBid(amount);
+    }, [requestBid]);
+    (0, react_1.useEffect)(() => {
+        setBarMessage(null);
+        setLastBidFailed(false);
+    }, [roundOpen, auction.storeProductId]);
+    // Unpaid wins are read again each time the screen comes back (the shopper may have just paid them).
+    (0, navigation_1.useFocusEffect)((0, react_1.useCallback)(() => {
+        refreshUnpaidWins();
+    }, [refreshUnpaidWins]));
+    // The gate signs the shopper in itself (`startSignIn`), so it never stops at "signIn".
+    const step = gate.blocker === 'signIn' ? null : gate.blocker;
+    const seeWins = (0, react_1.useCallback)(() => {
+        dismiss();
+        openItemsYouWon();
+    }, [dismiss, openItemsYouWon]);
+    // ─── The bidding war, once a round ─────────────────────────────────────────────────────────────
+    const [warAnnounced, setWarAnnounced] = (0, react_1.useState)(false);
+    (0, react_1.useEffect)(() => {
+        if (!auction.biddingOpen)
+            setWarAnnounced(false);
+    }, [auction.biddingOpen]);
+    // ─── The hammer ────────────────────────────────────────────────────────────────────────────────
+    const lastWin = auction.lastWin;
+    const winner = (0, react_1.useMemo)(() => {
+        var _a;
+        if (!lastWin || !isAuction)
+            return null;
+        return {
+            key: `${(_a = lastWin.storeProductId) !== null && _a !== void 0 ? _a : ''}|${lastWin.userName}|${lastWin.winningBid}`,
+            name: lastWin.userName,
+            amount: money(lastWin.winningBid),
+            isYou: lastWin.isYou,
+        };
+    }, [lastWin, isAuction, money]);
+    // ─── The lots and the featured lot's round ─────────────────────────────────────────────────────
+    const { biddingOpen, storeProductId: roundLotId, wonLotIds } = auction;
+    const stateOf = (0, react_1.useCallback)((storeProductId) => (0, auctionRules_1.lotStateFor)(storeProductId, { biddingOpen, storeProductId: roundLotId, wonLotIds }, show), [biddingOpen, roundLotId, wonLotIds, show]);
+    const lots = (0, react_1.useMemo)(() => {
+        if (!isAuction)
+            return null;
+        return session.products.flatMap((item) => {
+            var _a;
+            // A link the host added: opened, not bid on.
+            if (!item.raw)
+                return item.externalUrl ? [(0, linkLots_1.showLinkOf)(item, { canOpen: canOpenLinks })] : [];
+            // The lot's opening bid, joined onto the product from the record by the session.
+            const startingBid = (_a = item.baseBidPrice) !== null && _a !== void 0 ? _a : null;
+            return [{ product: item.raw, startingBid: startingBid !== null ? money(startingBid) : null, state: stateOf(item.storeProductId) }];
+        });
+    }, [isAuction, session.products, money, stateOf, canOpenLinks]);
+    const featured = session.activeProduct;
+    const auctionRound = (0, react_1.useMemo)(() => {
+        // A featured link is never on the block.
+        if (!isAuction || !featured || (!featured.raw && featured.externalUrl))
+            return null;
+        const state = stateOf(featured.storeProductId);
+        const onThisLot = state === 'open';
+        return {
+            state,
+            highestBid: onThisLot && auction.highestBid > 0 ? money(auction.highestBid) : null,
+            leaderName: onThisLot ? auction.leaderName || null : null,
+            leaderIsYou: onThisLot && auction.isLeading,
+        };
+    }, [isAuction, featured, stateOf, auction.highestBid, auction.leaderName, auction.isLeading, money]);
+    return {
+        bidBar: {
+            visible: roundOpen,
+            currencyCode,
+            highestBid: auction.highestBid,
+            nextBid: auction.nextBid,
+            closesAt: auction.closesAt,
+            extended: auction.extended,
+            extendedSeconds: Math.round(auction.extendedBiddingMs / 1000),
+            isLeading: auction.isLeading,
+            bidCap: auction.bidCap,
+            busy: gate.bidOnItsWay && !lastBidFailed,
+            step: roundOpen ? step : null,
+            // The store's name in the bidding rules (old Amore's took the host's, which can be a person's).
+            shopName,
+            lotProduct,
+            refusal: barMessage,
+            onBid: bid,
+            onAcceptTerms: gate.acceptTerms,
+            onChooseVariant: gate.chooseVariant,
+            onCloseStep: dismiss,
+            onSeeWins: seeWins,
+        },
+        finalCountdown: { visible: roundOpen, closesAt: auction.closesAt },
+        biddingWar: {
+            active: roundOpen && auction.extended && !warAnnounced,
+            onDone: () => setWarAnnounced(true),
+        },
+        win: { winner, onDone: dismissAuctionWin },
+        /** The auction part of the featured card; `useLiveShop` gives the rest. */
+        productCard: { auctionRound },
+        /** The auction part of the Shop button: its sheet lists the lots. */
+        shopButton: { lots },
+    };
+}
+//# sourceMappingURL=useLiveAuction.js.map

package/dist/react/useLiveAuction.js.map

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

package/dist/react/useLiveChat.d.ts

@@ -0,0 +1,110 @@
+import type { LiveCommentMention } from '../pageTypes';
+/** What the Live screen knows about the show, which decides what the chat shows. */
+export interface LiveChatShow {
+    /** This show is playing or waiting for its host: not joining, ended or failed. */
+    onAir: boolean;
+    /** The show takes comments (`capabilitiesFor(show).canComment`). */
+    canComment: boolean;
+    /** The show takes reactions (`capabilitiesFor(show).canReact`). */
+    canReact: boolean;
+    /**
+     * Opens a link from the chat inside the app, the show in the bubble (`useLivePage`'s `openLink`, 0.15.0).
+     * The chat hands over only the host's and moderators' links (the comments tile decides by the line's
+     * `source`). Unset, or an app with no `routes.openLink`: the chat's links are words.
+     */
+    openLink?: (url: string) => void;
+    /** An auction show (`capabilitiesFor(show).canBid`, 0.15.0): the comment box's "Sign in to comment" has a switch per kind of show. */
+    auction?: boolean;
+}
+/**
+ * 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 signed-out 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 (`accountNameAsk`).
+ * - **A signed-in shopper with no first name on their account is asked once** (0.15.0; amore-v2's
+ *   ENG-686, decided 2026-10-19 by its Head of Engineering: old Amore's and old K-Marie's way). A Shopify
+ *   sign-in by emailed code leaves the name blank, and since 0.13.0 the room names nobody by their
+ *   email. The comment box asks for a first and a last name (`commentBox.accountName`, starting from what
+ *   the account has), saves them on the account (`onSaveAccountName`, through `useAccountName`) and only
+ *   then sends the comment, so the account, the room and the next show all have it. A giveaway entry
+ *   asks the same way, so whichever comes first asks, once. A name typed as a guest before signing in
+ *   isn't used: the account's name governs. A save that didn't go through sends nothing, and the sheet
+ *   says so. A comment box without the account's fields asks for one name, kept on this phone
+ *   (`onSaveName`), as in 0.14.0.
+ * - **The show's team's names can't be used** (0.15.0; Host and Moderator unless `LiveSellingProvider`'s
+ *   `blockedNames` says), signed in or not: the sheet says so as the name is typed (`isNameAllowed`), and
+ *   an account named as one is asked as one with no name. The session refuses them too.
+ * - **"Sign in to comment"** (0.15.0; decided 2026-10-19 by amore-v2's Head of Engineering): the comment
+ *   box's two switches, one for live shows and one for auction shows (`auction` says which applies), off
+ *   by default. On, a signed-out shopper's tap on the box starts the app's sign-in (sdk-shopify's
+ *   `useSignIn`; the app's Sign In page is `routes.openSignIn`) in place of the name sheet; back on this
+ *   screen signed in, the keyboard comes up in the box (`keyboardRequest`). Back still signed out,
+ *   nothing more happens, now or after a later sign-in elsewhere.
+ * - **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.
+ * - **A tap on a host's or moderator's link** opens it inside the app, the show in the bubble
+ *   (`comments.onOpenLink`, 0.15.0, amore-v2's ENG-656). None without a way to open links.
+ * - **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).
+ */
+export declare function useLiveChat({ onAir, canComment, canReact, openLink, auction }: LiveChatShow): {
+    keyboardUp: boolean;
+    /** The comment box has the keyboard: the screen lifts its bottom group for it, and for nothing else. */
+    typing: boolean;
+    comments: {
+        visible: boolean;
+        comments: import("..").LiveComment[];
+        hidden: boolean;
+        onToggleHidden: () => void;
+        onPressName: ((name: string) => void) | undefined;
+        onOpenLink: ((url: string) => void) | undefined;
+    };
+    commentBox: {
+        visible: boolean;
+        askForName: boolean;
+        accountName: import("../pageTypes").NameOnAccount | null;
+        waitingForName: boolean;
+        signedOut: boolean;
+        auction: boolean;
+        keyboardRequest: number;
+        onSignInToComment: () => void;
+        sending: boolean;
+        mention: LiveCommentMention | null;
+        nameMaxLength: number;
+        onSend: (text: string) => Promise<void>;
+        onSaveName: (name: string) => Promise<boolean>;
+        onSaveAccountName: (firstName: string, lastName: string) => Promise<boolean>;
+        isNameAllowed: (name: string) => boolean;
+        onTypingChange: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    };
+    reactionButton: {
+        visible: boolean;
+        onReact: (reactionUrl: string) => undefined;
+    };
+    reactions: {
+        visible: boolean;
+        reactions: import("..").FloatingReaction[];
+        reactionStyle: import("..").ReactionStyle;
+    };
+    pinnedComment: {
+        visible: boolean;
+        pinnedComment: import("..").LivePinnedComment | null;
+    };
+};
+/** What `useLiveChat` hands the Live screen: one set of props per tile. */
+export type LiveChat = ReturnType<typeof useLiveChat>;
+//# sourceMappingURL=useLiveChat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useLiveChat.d.ts","sourceRoot":"","sources":["../../src/react/useLiveChat.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAQvD,oFAAoF;AACpF,MAAM,WAAW,YAAY;IAC3B,kFAAkF;IAClF,KAAK,EAAE,OAAO,CAAC;IACf,oEAAoE;IACpE,UAAU,EAAE,OAAO,CAAC;IACpB,mEAAmE;IACnE,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,sIAAsI;IACtI,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAe,EAAE,EAAE,YAAY;;IA8GhG,wGAAwG;;;;;;;6BA/BvE,MAAM;2BAjIxB,MAAM,KAAK,IAAI;;;;;;;;;;;;;;uBAoGjB,MAAM;2BAaqB,MAAM;uCAO5B,MAAM,YAAY,MAAM;8BATH,MAAM;;;;;+BA2BP,MAAM;;;;;;;;;;;EAkE/C;AAED,2EAA2E;AAC3E,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/react/useLiveChat.js

@@ -0,0 +1,209 @@
+"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; 0.15.0 adds its links, account names,
+ * blocked names and "Sign in to comment", from amore-v2's `eng928/integration`).
+ */
+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 showNames_1 = require("../showNames");
+const viewer_1 = require("../viewer");
+const LiveSellingProvider_1 = require("./LiveSellingProvider");
+const platformSession_1 = require("./platformSession");
+const useAccountName_1 = require("./useAccountName");
+const navigation_1 = require("./navigation");
+/**
+ * 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 signed-out 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 (`accountNameAsk`).
+ * - **A signed-in shopper with no first name on their account is asked once** (0.15.0; amore-v2's
+ *   ENG-686, decided 2026-10-19 by its Head of Engineering: old Amore's and old K-Marie's way). A Shopify
+ *   sign-in by emailed code leaves the name blank, and since 0.13.0 the room names nobody by their
+ *   email. The comment box asks for a first and a last name (`commentBox.accountName`, starting from what
+ *   the account has), saves them on the account (`onSaveAccountName`, through `useAccountName`) and only
+ *   then sends the comment, so the account, the room and the next show all have it. A giveaway entry
+ *   asks the same way, so whichever comes first asks, once. A name typed as a guest before signing in
+ *   isn't used: the account's name governs. A save that didn't go through sends nothing, and the sheet
+ *   says so. A comment box without the account's fields asks for one name, kept on this phone
+ *   (`onSaveName`), as in 0.14.0.
+ * - **The show's team's names can't be used** (0.15.0; Host and Moderator unless `LiveSellingProvider`'s
+ *   `blockedNames` says), signed in or not: the sheet says so as the name is typed (`isNameAllowed`), and
+ *   an account named as one is asked as one with no name. The session refuses them too.
+ * - **"Sign in to comment"** (0.15.0; decided 2026-10-19 by amore-v2's Head of Engineering): the comment
+ *   box's two switches, one for live shows and one for auction shows (`auction` says which applies), off
+ *   by default. On, a signed-out shopper's tap on the box starts the app's sign-in (sdk-shopify's
+ *   `useSignIn`; the app's Sign In page is `routes.openSignIn`) in place of the name sheet; back on this
+ *   screen signed in, the keyboard comes up in the box (`keyboardRequest`). Back still signed out,
+ *   nothing more happens, now or after a later sign-in elsewhere.
+ * - **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.
+ * - **A tap on a host's or moderator's link** opens it inside the app, the show in the bubble
+ *   (`comments.onOpenLink`, 0.15.0, amore-v2's ENG-656). None without a way to open links.
+ * - **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, openLink, auction = false }) {
+    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 } = (0, sdk_shopify_1.useCustomer)();
+    const { accountLoading, nameToComplete, saveNameToAccount } = (0, useAccountName_1.useAccountName)();
+    const { routes, blockedNames, canOpenLinks } = (0, LiveSellingProvider_1.useLivePageOptions)();
+    // ─── Who the shopper is in the room ──────────────────────────────────────────────────────────────
+    // A stored sign-in is still being read on app open: not a signed-out shopper to ask.
+    const signedIn = !!loggedIn || !!restoring;
+    const { askForName, waitingForName } = (0, livePages_1.accountNameAsk)({
+        named: !!((_a = session.viewerName) === null || _a === void 0 ? void 0 : _a.trim()),
+        loggedIn: !!loggedIn,
+        restoring: !!restoring,
+        accountLoading,
+        nameToComplete,
+    });
+    // ─── "Sign in to comment", and back to the box ───────────────────────────────────────────────────
+    const nav = (0, navigation_1.useNavigation)();
+    const isFocused = (0, navigation_1.useIsFocused)();
+    const signIn = (0, sdk_shopify_1.useSignIn)({ onOpenSignInPage: (method) => routes.openSignIn(method, nav) });
+    /** The shopper tapped the box to sign in: once back here signed in, the keyboard comes up in it. */
+    const [backToTheBox, setBackToTheBox] = (0, react_1.useState)(false);
+    /** A new number each time the box should take the keyboard. */
+    const [keyboardRequest, setKeyboardRequest] = (0, react_1.useState)(0);
+    const startSignIn = signIn.start;
+    const signInToComment = (0, react_1.useCallback)(() => {
+        setBackToTheBox(true);
+        void startSignIn();
+    }, [startSignIn]);
+    // Back here: this screen focused (the Sign In page closed), and no system sign-in sheet up.
+    const screenOnShow = isFocused && !signIn.signingIn;
+    const wasOnShow = (0, react_1.useRef)(screenOnShow);
+    (0, react_1.useEffect)(() => {
+        const cameBackOnShow = screenOnShow && !wasOnShow.current;
+        wasOnShow.current = screenOnShow;
+        if (!backToTheBox)
+            return;
+        if (loggedIn && screenOnShow) {
+            setBackToTheBox(false);
+            setKeyboardRequest((request) => request + 1);
+        }
+        // Back without signing in: the box stays as it was, now and after a later sign-in elsewhere.
+        else if (!loggedIn && cameBackOnShow)
+            setBackToTheBox(false);
+    }, [backToTheBox, loggedIn, screenOnShow]);
+    // ─── 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]);
+    /** False for a name the show's team goes by: the sheet says so before Save. */
+    const isNameAllowed = (0, react_1.useCallback)((name) => !(0, showNames_1.isBlockedViewerName)(name, blockedNames), [blockedNames]);
+    /** Signed out: true once the session has saved the name on this phone, and the engine has it for the comment that follows. */
+    const saveName = (0, react_1.useCallback)(async (name) => !!(await chooseViewerName(name)), [chooseViewerName]);
+    /**
+     * Signed in: true once the name is on the account. Then given to the session as well, as the room reads
+     * the account's name only on the next draw, after the comment waiting for it has gone: this gives the
+     * engine the name for that comment, and keeps it on this phone.
+     */
+    const saveAccountName = (0, react_1.useCallback)(async (firstName, lastName) => {
+        const savedName = await saveNameToAccount(firstName, lastName);
+        return !!savedName && !!(await chooseViewerName(savedName));
+    }, [saveNameToAccount, 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,
+            // Only with somewhere to open it: without, every link is words.
+            onOpenLink: canOpenLinks ? openLink : undefined,
+        },
+        commentBox: {
+            visible: commentBoxShown,
+            askForName,
+            accountName: nameToComplete,
+            waitingForName,
+            signedOut: !signedIn,
+            auction,
+            keyboardRequest,
+            onSignInToComment: signInToComment,
+            sending,
+            mention,
+            nameMaxLength: viewer_1.MAX_VIEWER_NAME,
+            onSend: send,
+            onSaveName: saveName,
+            onSaveAccountName: saveAccountName,
+            isNameAllowed,
+            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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"}