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

package/dist/react/shopifyProviders.js

@@ -0,0 +1,98 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShopifyLiveSellingProvider = ShopifyLiveSellingProvider;
+exports.ShopifyLiveSessionProvider = ShopifyLiveSessionProvider;
+/**
+ * The live-selling providers for an app on `@tiledev/sdk-shopify` (0.14.0, moved from amore-v2's
+ * `AppLiveSellingProvider` and `AppLiveSessionProvider`, `src/core/providers/liveSelling.tsx` and
+ * `liveSession.tsx`): `LiveSellingProvider` and `LiveSessionProvider` filled in from the app's own
+ * sdk-shopify client (`shopify`) and customer (`useCustomer`), so the app passes only its config.
+ *
+ * `createElement` rather than JSX, like the rest of the package, so this stays a plain `.ts`.
+ */
+const async_storage_1 = __importDefault(require("@react-native-async-storage/async-storage"));
+const sdk_shopify_1 = require("@tiledev/sdk-shopify");
+const react_1 = require("react");
+const shopifyCommerce_1 = require("../shopifyCommerce");
+const shopifyIdentity_1 = require("../shopifyIdentity");
+const showNames_1 = require("../showNames");
+const LiveSellingProvider_1 = require("./LiveSellingProvider");
+const platformSession_1 = require("./platformSession");
+/**
+ * `LiveSellingProvider` on the app's sdk-shopify client and customer (the README's §4 "On Shopify"):
+ * products from Shopify at the card photo size; the wins checkout, a cart of its own (a won lot stamped
+ * `_winningBid`, a prize `prizeWriteKey`) with `source_name`, `source_type: "auction"` and `auction_id`
+ * for the order webhook; and the bidder, the customer's numeric id, only for a Shopify sign-in (the
+ * winner's record is on the Customer Account API). The phone's storage keeps the poll votes, a
+ * signed-out shopper's name and the accepted terms across relaunches. Hidden shows (`hiddenShows`) are
+ * hidden from every shopper whose email isn't the team's: the signed-in customer's email is the
+ * provider's `viewerEmail`, so a sign-in reaches every screen at once.
+ *
+ * Mount it inside sdk-shopify's `ShopifyProvider`, above the navigator. `routes`, `track`, `onWarning`
+ * and `shopName` pass through to `LiveSellingProvider`.
+ */
+function ShopifyLiveSellingProvider({ children, config, cartSourceName, prizeWriteKey, imageTransform = sdk_shopify_1.CARD_IMAGE, ...pageProps }) {
+    var _a, _b;
+    const customer = (0, sdk_shopify_1.useCustomer)();
+    const latestCustomer = (0, react_1.useRef)(customer);
+    latestCustomer.current = customer;
+    const liveConfig = (0, react_1.useMemo)(() => {
+        var _a;
+        const signedIn = (0, shopifyIdentity_1.createShopifyLiveIdentity)(() => latestCustomer.current);
+        return {
+            ...config,
+            storage: (_a = config.storage) !== null && _a !== void 0 ? _a : async_storage_1.default,
+            identity: signedIn.identity,
+            customerAccountRequest: signedIn.customerAccountRequest,
+            commerce: (0, shopifyCommerce_1.createShopifyLiveCommerce)({
+                shopify: sdk_shopify_1.shopify,
+                cartSourceName,
+                prizeWriteKey,
+                buyer: signedIn.buyer,
+                imageTransform,
+            }),
+        };
+    }, [config, cartSourceName, prizeWriteKey, imageTransform]);
+    return (0, react_1.createElement)(LiveSellingProvider_1.LiveSellingProvider, {
+        ...pageProps,
+        config: liveConfig,
+        viewerEmail: (_b = (_a = customer.customer) === null || _a === void 0 ? void 0 : _a.email) !== null && _b !== void 0 ? _b : null,
+        children,
+    });
+}
+/**
+ * The app's one live session (`LiveSessionProvider`; decided 2026-10-05 by amore-v2's Head of
+ * Engineering: joined app-wide, as Freckled Poppy). Mount it above the navigator, inside
+ * `ShopifyLiveSellingProvider`, because Zego's engine holds exactly one room and several places show
+ * the same show: the Live tab's card, the Live screen and the bubble. Each binds to the picture with
+ * `LiveVideoTarget`; none owns the room.
+ *
+ * - **`viewerName`** is the signed-in shopper's (`viewerNameFor`: first and last name, else whichever
+ *   the account has; never an email nor its part before the @), so a name edited on Account reaches the
+ *   room without a restart. Null with no name on the account, or signed out, so a name the shopper typed
+ *   on this phone stays in charge (the comment box asks for one: `useLivePage`'s chat).
+ * - **`blockedNames`** passes through: the names nobody watching may go by (Host and Moderator unless
+ *   the app says otherwise).
+ * - **`onPipRestore`**: the phone's picture-in-picture window, opened from the Live screen and then
+ *   expanded (or, on iOS, left up when the shopper came back by the app's icon), comes back to the Live
+ *   screen (`routes.openLive`). A window opened from the bubble goes back to the bubble instead, which
+ *   the session does itself without calling this. An `onPipRestore` of the app's own replaces it.
+ */
+function ShopifyLiveSessionProvider({ children, onPipRestore, ...props }) {
+    const { customer } = (0, sdk_shopify_1.useCustomer)();
+    const { routes } = (0, LiveSellingProvider_1.useLivePageOptions)();
+    const backToTheLiveShow = (0, react_1.useMemo)(() => onPipRestore !== null && onPipRestore !== void 0 ? onPipRestore : ((streamId) => {
+        if (streamId)
+            routes.openLive(streamId);
+    }), [onPipRestore, routes]);
+    return (0, react_1.createElement)(platformSession_1.LiveSessionProvider, {
+        ...props,
+        viewerName: (0, showNames_1.viewerNameFor)(customer),
+        onPipRestore: backToTheLiveShow,
+        children,
+    });
+}
+//# sourceMappingURL=shopifyProviders.js.map

package/dist/react/shopifyProviders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shopifyProviders.js","sourceRoot":"","sources":["../../src/react/shopifyProviders.ts"],"names":[],"mappings":";;;;;AA8DA,gEAmCC;AAwBD,gEAiBC;AA1ID;;;;;;;GAOG;AACH,8FAAqE;AACrE,sDAAwE;AACxE,iCAAuD;AAGvD,wDAA2F;AAC3F,wDAA+D;AAC/D,4CAA6C;AAE7C,+DAA+G;AAC/G,uDAAwD;AA+BxD;;;;;;;;;;;;GAYG;AACH,SAAgB,0BAA0B,CAAC,EACzC,QAAQ,EACR,MAAM,EACN,cAAc,EACd,aAAa,EACb,cAAc,GAAG,wBAAU,EAC3B,GAAG,SAAS,EACoB;;IAChC,MAAM,QAAQ,GAAG,IAAA,yBAAW,GAAE,CAAC;IAC/B,MAAM,cAAc,GAAG,IAAA,cAAM,EAAC,QAAQ,CAAC,CAAC;IACxC,cAAc,CAAC,OAAO,GAAG,QAAQ,CAAC;IAElC,MAAM,UAAU,GAAG,IAAA,eAAO,EAAoB,GAAG,EAAE;;QACjD,MAAM,QAAQ,GAAG,IAAA,2CAAyB,EAAC,GAAG,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACzE,OAAO;YACL,GAAG,MAAM;YACT,OAAO,EAAE,MAAA,MAAM,CAAC,OAAO,mCAAI,uBAAY;YACvC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,sBAAsB,EAAE,QAAQ,CAAC,sBAAsB;YACvD,QAAQ,EAAE,IAAA,2CAAyB,EAAC;gBAClC,OAAO,EAAP,qBAAO;gBACP,cAAc;gBACd,aAAa;gBACb,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,cAAc;aACf,CAAC;SACH,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC;IAE5D,OAAO,IAAA,qBAAa,EAAC,yCAAmB,EAAE;QACxC,GAAG,SAAS;QACZ,MAAM,EAAE,UAAU;QAClB,WAAW,EAAE,MAAA,MAAA,QAAQ,CAAC,QAAQ,0CAAE,KAAK,mCAAI,IAAI;QAC7C,QAAQ;KACT,CAAC,CAAC;AACL,CAAC;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,0BAA0B,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,KAAK,EAAmC;IAC9G,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAA,yBAAW,GAAE,CAAC;IACnC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,wCAAkB,GAAE,CAAC;IACxC,MAAM,iBAAiB,GAAG,IAAA,eAAO,EAC/B,GAAG,EAAE,CACH,YAAY,aAAZ,YAAY,cAAZ,YAAY,GACZ,CAAC,CAAC,QAA4B,EAAE,EAAE;QAChC,IAAI,QAAQ;YAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC,CAAC,EACJ,CAAC,YAAY,EAAE,MAAM,CAAC,CACvB,CAAC;IACF,OAAO,IAAA,qBAAa,EAAC,qCAAmB,EAAE;QACxC,GAAG,KAAK;QACR,UAAU,EAAE,IAAA,yBAAa,EAAC,QAAQ,CAAC;QACnC,YAAY,EAAE,iBAAiB;QAC/B,QAAQ;KACT,CAAC,CAAC;AACL,CAAC"}

package/dist/react/useKeepScreenAwake.d.ts

@@ -0,0 +1,2 @@
+export declare function useKeepScreenAwake(active: boolean, tag: string): void;
+//# sourceMappingURL=useKeepScreenAwake.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useKeepScreenAwake.d.ts","sourceRoot":"","sources":["../../src/react/useKeepScreenAwake.ts"],"names":[],"mappings":"AAmBA,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAWrE"}

package/dist/react/useKeepScreenAwake.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useKeepScreenAwake = useKeepScreenAwake;
+/**
+ * `useKeepScreenAwake(active, tag)` (0.14.0, moved from amore-v2's `src/core/hooks/useKeepScreenAwake.ts`,
+ * Freckled Poppy's before it): keeps the phone's screen on while `active` is true. A live show runs for
+ * an hour and is watched without a touch, so the phone's idle timer would put it to sleep mid-show.
+ *
+ * - **Driven by a condition, not by the screen being mounted** (expo-keep-awake's own `useKeepAwake`):
+ *   the Live screen stays mounted under the Cart and the variant page, where it has no claim on the
+ *   screen.
+ * - **One `tag` per caller.** expo-keep-awake releases by tag, so the Live screen and the live bubble
+ *   holding the same tag would release each other's hold as the show moves between them.
+ * - The release waits for the hold to have been taken: both cross to native, and a condition that turns
+ *   off as soon as it turned on would otherwise release a hold not yet made, leaving it on for good.
+ * - A hold or release that fails goes to `LiveSellingProvider`'s `onWarning`.
+ */
+const expo_keep_awake_1 = require("expo-keep-awake");
+const react_1 = require("react");
+const pageOptions_1 = require("../pageOptions");
+function useKeepScreenAwake(active, tag) {
+    (0, react_1.useEffect)(() => {
+        if (!active)
+            return;
+        const holding = (0, expo_keep_awake_1.activateKeepAwakeAsync)(tag);
+        holding.catch((error) => (0, pageOptions_1.reportLiveWarning)(error, { at: 'useKeepScreenAwake.activate', tag }));
+        return () => {
+            holding
+                .then(() => (0, expo_keep_awake_1.deactivateKeepAwake)(tag))
+                .catch((error) => (0, pageOptions_1.reportLiveWarning)(error, { at: 'useKeepScreenAwake.deactivate', tag }));
+        };
+    }, [active, tag]);
+}
+//# sourceMappingURL=useKeepScreenAwake.js.map

package/dist/react/useKeepScreenAwake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeepScreenAwake.js","sourceRoot":"","sources":["../../src/react/useKeepScreenAwake.ts"],"names":[],"mappings":";;AAmBA,gDAWC;AA9BD;;;;;;;;;;;;;GAaG;AACH,qDAA8E;AAC9E,iCAAkC;AAElC,gDAAmD;AAEnD,SAAgB,kBAAkB,CAAC,MAAe,EAAE,GAAW;IAC7D,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,MAAM,OAAO,GAAG,IAAA,wCAAsB,EAAC,GAAG,CAAC,CAAC;QAC5C,OAAO,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,IAAA,+BAAiB,EAAC,KAAK,EAAE,EAAE,EAAE,EAAE,6BAA6B,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QACxG,OAAO,GAAG,EAAE;YACV,OAAO;iBACJ,IAAI,CAAC,GAAG,EAAE,CAAC,IAAA,qCAAmB,EAAC,GAAG,CAAC,CAAC;iBACpC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,IAAA,+BAAiB,EAAC,KAAK,EAAE,EAAE,EAAE,EAAE,+BAA+B,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QACvG,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;AACpB,CAAC"}

package/dist/react/useLiveAuction.d.ts

@@ -0,0 +1,104 @@
+/**
+ * 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.
+ */
+import { type Product } from '@tiledev/sdk-shopify';
+import type { LiveAuctionLot, LiveAuctionRound, LiveAuctionWinner, LiveBidRefusal, LiveBidStep } from '../pageTypes';
+/** What the Live screen hands the auction. */
+export interface LiveAuctionScreen {
+    /**
+     * Opens Items You Won over the show, as the header's cart does on an auction show (`useLivePage`'s
+     * `header.onCart`, which shrinks a show on air into the bubble first): the unpaid-wins sheet's
+     * "Checkout now".
+     */
+    openItemsYouWon: () => void;
+}
+/**
+ * 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.
+ * - **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.
+ */
+export declare function useLiveAuction({ openItemsYouWon }: LiveAuctionScreen): {
+    bidBar: {
+        visible: boolean;
+        currencyCode: string;
+        highestBid: number;
+        nextBid: number;
+        closesAt: number | null;
+        extended: boolean;
+        extendedSeconds: number;
+        isLeading: boolean;
+        bidCap: number | null;
+        busy: boolean;
+        step: LiveBidStep | null;
+        shopName: string | undefined;
+        lotProduct: Product | null;
+        refusal: LiveBidRefusal | null;
+        onBid: (amount: number) => void;
+        onAcceptTerms: () => void;
+        onChooseVariant: (variantId: string) => void;
+        onCloseStep: () => void;
+        onSeeWins: () => void;
+    };
+    finalCountdown: {
+        visible: boolean;
+        closesAt: number | null;
+    };
+    biddingWar: {
+        active: boolean;
+        onDone: () => void;
+    };
+    win: {
+        winner: LiveAuctionWinner | null;
+        onDone: () => void;
+    };
+    /** The auction part of the featured card; `useLiveShop` gives the rest. */
+    productCard: {
+        auctionRound: LiveAuctionRound | null;
+    };
+    /** The auction part of the Shop button: its sheet lists the lots. */
+    shopButton: {
+        lots: LiveAuctionLot[] | null;
+    };
+};
+/** What `useLiveAuction` hands the Live screen's auction tiles. */
+export type LiveAuction = ReturnType<typeof useLiveAuction>;
+//# sourceMappingURL=useLiveAuction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useLiveAuction.d.ts","sourceRoot":"","sources":["../../src/react/useLiveAuction.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAuC,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAIzF,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAiBrH,8CAA8C;AAC9C,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,eAAe,EAAE,MAAM,IAAI,CAAC;CAC7B;AAcD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,cAAc,CAAC,EAAE,eAAe,EAAE,EAAE,iBAAiB;;;;;;;;;;;;;;;;wBAqFxD,MAAM;;;;;;;;;;;;;;;;;;IAoGf,2EAA2E;;;;IAE3E,qEAAqE;;;;EAGxE;AAED,mEAAmE;AACnE,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/react/useLiveAuction.js

@@ -0,0 +1,244 @@
+"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 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.
+ * - **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 } = (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;
+            if (!item.raw)
+                return [];
+            // 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]);
+    const featured = session.activeProduct;
+    const auctionRound = (0, react_1.useMemo)(() => {
+        if (!isAuction || !featured)
+            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,75 @@
+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;
+}
+/**
+ * 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).
+ */
+export declare function useLiveChat({ onAir, canComment, canReact }: 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;
+    };
+    commentBox: {
+        visible: boolean;
+        askForName: boolean;
+        waitingForName: boolean;
+        sending: boolean;
+        mention: 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("..").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":"AASA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAIvD,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;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,YAAY;;IA+DrE,wGAAwG;;;;;;;6BA/BvE,MAAM;;;;;;;;;uBAf1B,MAAM;2BAWqB,MAAM;;;;;+BAaR,MAAM;;;;;;;;;;;EAyD/C;AAED,2EAA2E;AAC3E,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC"}