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

package/dist/react/useLivePage.js

@@ -0,0 +1,304 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useLivePage = useLivePage;
+/**
+ * The Live screen's page model (0.14.0, moved from amore-v2's `src/core/hooks/useLivePage.ts`:
+ * Freckled Poppy's Live, phase 1, watching and the in-app bubble; 0.15.0 adds its links and the cart
+ * hold's timer, from amore-v2's `eng928/integration`). The routes are the app's (`LiveSellingProvider`'s
+ * `routes`); the route's `streamId` param is read here.
+ */
+const sdk_analytics_core_1 = require("@tiledev/sdk-analytics-core");
+const sdk_shopify_1 = require("@tiledev/sdk-shopify");
+const react_1 = require("react");
+const react_native_1 = require("react-native");
+const client_1 = require("../client");
+const hiddenShows_1 = require("../hiddenShows");
+const liveSelling_1 = require("../liveSelling");
+const linkLots_1 = require("../linkLots");
+const livePages_1 = require("../livePages");
+const pageOptions_1 = require("../pageOptions");
+const sessionTypes_1 = require("../sessionTypes");
+const LiveSellingProvider_1 = require("./LiveSellingProvider");
+const platformSession_1 = require("./platformSession");
+const replayPlayer_1 = require("./replayPlayer");
+const useKeepScreenAwake_1 = require("./useKeepScreenAwake");
+const useLiveChat_1 = require("./useLiveChat");
+const useStreamInfo_1 = require("./useStreamInfo");
+const navigation_1 = require("./navigation");
+/**
+ * Shows already reported as joined (`liveJoin`) in this run of the app: once per show per run, so a
+ * trip through the bubble, the Cart or another screen and back isn't a second join (amore-v2's audit,
+ * L5: production reported on every viewer-count tick).
+ */
+const joinedThisRun = new Set();
+/**
+ * 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.
+ * - **A link from the show** (`openLink`, 0.15.0; decided 2026-10-19 by amore-v2's Head of Engineering)
+ *   opens inside the app, never the phone's browser: the show goes into the bubble, as for the cart, and
+ *   the app's `routes.openLink` opens the page (amore-v2: the store's product or collection on its
+ *   screen, any other page in its web page). Leaving the app for the phone's browser is what left the
+ *   player dark on the way back (ENG-629) and the phone's window blank (ENG-580). A link that isn't https
+ *   (`opensInApp`), or an app without `routes.openLink`, opens nothing, and the show stays.
+ * - **The cart's holds** (0.15.0, amore-v2's ENG-691): the header shows a timer under the cart button in
+ *   the soonest hold's last minutes; this hands it when each hold ends (`header.holdEndTimes`,
+ *   `holdEndTimesOf` over sdk-shopify's cart and its `cartExtensions`), and the header counts.
+ * - **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; a host's or
+ *   moderator's link in the chat opens through `openLink`.
+ */
+function useLivePage() {
+    var _a, _b, _c, _d;
+    const nav = (0, navigation_1.useNavigation)();
+    const route = (0, navigation_1.useRoute)();
+    const streamId = (_b = (_a = route.params) === null || _a === void 0 ? void 0 : _a.streamId) !== null && _b !== void 0 ? _b : '';
+    const isFocused = (0, navigation_1.useIsFocused)();
+    const { routes, track, canOpenLinks } = (0, LiveSellingProvider_1.useLivePageOptions)();
+    // The session changes only on the room's events, never on a clock: the header and the auction tiles keep their own.
+    const session = (0, platformSession_1.useLiveSession)();
+    const { holdStream, releaseStream, enterPip, exitPip, setMuted } = session.actions;
+    const { viewerEmail: email } = (0, LiveSellingProvider_1.useLiveSelling)();
+    const { show: sessionShow, status, onAir } = (0, platformSession_1.useLiveShow)(streamId);
+    const { cart: { cart, itemCount }, cartPage: { extensions: cartExtensions }, } = (0, sdk_shopify_1.useShopify)();
+    const holdEndTimes = (0, react_1.useMemo)(() => (0, livePages_1.holdEndTimesOf)(cart, cartExtensions), [cart, cartExtensions]);
+    const { bubbleShown: replayInBubble, stop: stopReplay } = (0, replayPlayer_1.useReplayPlayer)();
+    // ─── Which show ────────────────────────────────────────────────────────────────────────────────
+    // `sessionShow` (above) is the session's record once it is this show's. The record the link's answer
+    // was read from stands in for its poster until then, and on the web.
+    const [linkedShow, setLinkedShow] = (0, react_1.useState)(null);
+    const show = sessionShow !== null && sessionShow !== void 0 ? sessionShow : (linkedShow && linkedShow.streamingId === streamId ? linkedShow : null);
+    /** The screen is leaving for good (closed, or sent on by the link's answer): going doesn't shrink the show. */
+    const leavingForGood = (0, react_1.useRef)(false);
+    // ─── Where the link lands ──────────────────────────────────────────────────────────────────────
+    (0, react_1.useEffect)(() => {
+        if (!streamId)
+            return;
+        let stillHere = true;
+        void liveSelling_1.liveSelling.streams.destinationFor(streamId, { viewerEmail: email }).then(({ destination, show: record, readError }) => {
+            if (readError)
+                (0, pageOptions_1.reportLiveWarning)(readError, { at: 'live.destinationFor', streamId });
+            if (!stillHere)
+                return;
+            setLinkedShow(record);
+            if (react_native_1.Platform.OS === 'web' || destination.to === 'livePlayer')
+                return;
+            leavingForGood.current = true;
+            if (destination.to === 'replay')
+                routes.replaceWithReplay(destination.feedId, nav);
+            // Back to the tabs already in the stack, or in this screen's place when it opened alone (a link on a cold start).
+            else
+                routes.backToLiveTab(nav);
+        });
+        return () => {
+            stillHere = false;
+        };
+    }, [streamId, email, nav, routes]);
+    // ─── Arriving ──────────────────────────────────────────────────────────────────────────────────
+    (0, navigation_1.useFocusEffect)((0, react_1.useCallback)(() => {
+        holdStream(streamId || undefined);
+        (0, useStreamInfo_1.refreshStreamRecords)();
+        exitPip();
+    }, [streamId, holdStream, exitPip]));
+    (0, react_1.useEffect)(() => {
+        if (isFocused && replayInBubble)
+            stopReplay();
+    }, [isFocused, replayInBubble, stopReplay]);
+    // ─── Leaving ───────────────────────────────────────────────────────────────────────────────────
+    /** The show went into the bubble on the way out: leaving keeps it playing there, pinned. */
+    const shrunk = (0, react_1.useRef)(false);
+    (0, react_1.useEffect)(() => {
+        if (!isFocused)
+            return;
+        shrunk.current = false;
+        leavingForGood.current = false;
+    }, [isFocused]);
+    const pipModeNow = (0, react_1.useRef)(session.pipMode);
+    pipModeNow.current = session.pipMode;
+    // Gone without the bubble (back on an ended show, replaced by the Replay or the Live tab): the show
+    // stops and the pin goes. Not when the bubble took it.
+    (0, react_1.useEffect)(() => () => {
+        if (shrunk.current || pipModeNow.current !== 'none')
+            return;
+        exitPip({ stopVideo: true });
+        releaseStream();
+    }, [exitPip, releaseStream]);
+    // ─── Where the show stands ─────────────────────────────────────────────────────────────────────
+    // `status` and `onAir` are `useLiveShow`'s: joining until the session holds this show's record. The
+    // controls follow the link's record until then (an auction's cart is Items You Won from the start).
+    const capabilities = (0, sessionTypes_1.capabilitiesFor)(show);
+    const canShrink = capabilities.canPip && onAir;
+    // On show, or covered only by a page drawn as a sheet (the variant page, from the shop): the picture
+    // stays here, playing behind it, and the screen stays on.
+    const coveredOnlyBySheet = (0, navigation_1.useNavigationState)((state) => (0, livePages_1.isCoveredOnlyBySheet)(state, route.key, routes.sheets));
+    const onScreen = isFocused || coveredOnlyBySheet;
+    const showing = onScreen && session.pipMode === 'none';
+    // ─── Leaving for another page, the show playing on in the bubble ───────────────────────────────
+    /**
+     * The show goes into the app's own bubble (the session's `enterPip`: `pipMode` `inapp`, `LiveBubble`;
+     * never the phone's window, which only the phone opens as the app is put away) before a page opens over
+     * this screen, so it plays on there; not while it is joining or has ended. Coming back here (back, the
+     * bubble's tap, Android's back) ends the bubble as the screen focuses (above).
+     */
+    const shrinkForAnotherPage = (0, react_1.useCallback)(() => {
+        if (!canShrink)
+            return;
+        shrunk.current = true;
+        enterPip();
+    }, [canShrink, enterPip]);
+    /** A link from the show: its page inside the app, the show in the bubble. Nothing for one that can't open. */
+    const openLink = (0, react_1.useCallback)((url, title) => {
+        if (!canOpenLinks || !(0, linkLots_1.opensInApp)(url))
+            return;
+        shrinkForAnotherPage();
+        routes.openLink(url.trim(), title, nav);
+    }, [canOpenLinks, shrinkForAnotherPage, routes, nav]);
+    // Chat and reactions: only while this show is on air. Its own hook (`useLiveChat`).
+    const chat = (0, useLiveChat_1.useLiveChat)({
+        onAir,
+        canComment: capabilities.canComment,
+        canReact: capabilities.canReact,
+        openLink,
+        auction: capabilities.canBid,
+    });
+    // Every back press (`BACK_ACTIONS`) passes here as the screen goes: a show on air enters the bubble,
+    // then the screen is let go. Nothing is prevented.
+    const canShrinkNow = (0, react_1.useRef)(canShrink);
+    canShrinkNow.current = canShrink;
+    (0, react_1.useEffect)(() => nav.addListener('beforeRemove', (event) => {
+        if (!livePages_1.BACK_ACTIONS.has(event.data.action.type))
+            return;
+        if (leavingForGood.current || !canShrinkNow.current || pipModeNow.current !== 'none')
+            return;
+        shrunk.current = true;
+        enterPip();
+    }), [nav, enterPip]);
+    (0, useKeepScreenAwake_1.useKeepScreenAwake)(showing && onAir, 'live');
+    // ─── liveJoin, once per show per app run ───────────────────────────────────────────────────────
+    const viewerCount = session.viewerCount;
+    (0, react_1.useEffect)(() => {
+        if (!isFocused || !sessionShow || sessionShow.status !== 'live' || (0, hiddenShows_1.isHiddenShow)(sessionShow, (0, client_1.hiddenShowsRule)()))
+            return;
+        if (joinedThisRun.has(sessionShow.streamingId))
+            return;
+        joinedThisRun.add(sessionShow.streamingId);
+        track(sdk_analytics_core_1.DefaultEvents.LIVE_JOIN, (0, sdk_analytics_core_1.liveJoinParams)(sessionShow.streamingId, viewerCount));
+    }, [isFocused, sessionShow, viewerCount, track]);
+    // ─── The header's buttons ──────────────────────────────────────────────────────────────────────
+    /** Back: to the screen behind, or to the Live tab when this one opened alone. A show on air shrinks on the way (above). */
+    const goBack = (0, react_1.useCallback)(() => {
+        if (nav.canGoBack())
+            nav.goBack();
+        else
+            routes.backToLiveTab(nav);
+    }, [nav, routes]);
+    const close = (0, react_1.useCallback)(() => {
+        leavingForGood.current = true;
+        // Stopped outright: without `stopVideo` the room plays on with no surface.
+        exitPip({ stopVideo: true });
+        releaseStream();
+        goBack();
+    }, [exitPip, releaseStream, goBack]);
+    const back = canShrink ? goBack : close;
+    // Android's back with nothing behind this screen (a link on a cold start) would close the app: it does
+    // what the arrow does instead. With a screen behind, the navigator goes back, through `beforeRemove`.
+    const backNow = (0, react_1.useRef)(back);
+    backNow.current = back;
+    (0, navigation_1.useFocusEffect)((0, react_1.useCallback)(() => {
+        const subscription = react_native_1.BackHandler.addEventListener('hardwareBackPress', () => {
+            if (nav.canGoBack())
+                return false;
+            backNow.current();
+            return true;
+        });
+        return () => subscription.remove();
+    }, [nav]));
+    const isAuction = capabilities.canBid;
+    const openCart = (0, react_1.useCallback)(() => {
+        shrinkForAnotherPage();
+        // A bidder's cart is what they've won: their bids never land in the shopping cart (Freckled Poppy's).
+        routes.openCart({ itemsYouWon: isAuction }, nav);
+    }, [shrinkForAnotherPage, isAuction, nav, routes]);
+    // One surface at a time: not while the bubble or the phone's own window has it, or another screen is over this one.
+    const videoActive = showing && !!sessionShow;
+    return {
+        /**
+         * 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: react_native_1.Platform.OS === 'android' && session.pipMode === 'system',
+        /** The screen is on show (or under a sheet), over the dark video: light status bar text. */
+        lightStatusBar: onScreen,
+        player: {
+            status,
+            posterUrl: (_c = show === null || show === void 0 ? void 0 : show.thumbnailUrl) !== null && _c !== void 0 ? _c : null,
+            isAuction: !!(show === null || show === void 0 ? void 0 : show.isAuction),
+            videoActive,
+            // Put away while the show plays here, it goes on in the phone's own floating window. Not while
+            // joining, waiting for the host or ended: there is no picture.
+            systemWindowWhenAway: videoActive && status === 'playing' && capabilities.canPip,
+        },
+        header: {
+            ended: status === 'ended',
+            // An auction show: the header's own LIVE words for one (sparkl-v2's and k-marie-v2's LiveHeader01 `auctionLiveLabel`).
+            isAuction: !!(show === null || show === void 0 ? void 0 : show.isAuction),
+            // The header counts its clock up from it on its own (`useShowClock`), so the screen isn't drawn each second.
+            startedAt: (_d = sessionShow === null || sessionShow === void 0 ? void 0 : sessionShow.startedAtMs) !== null && _d !== void 0 ? _d : null,
+            // Known once the room has said: 0 means it hasn't yet.
+            viewerCount: onAir && capabilities.showViewerCount && viewerCount > 0 ? viewerCount : null,
+            muted: session.muted,
+            canMute: status !== 'ended' && status !== 'error',
+            canPip: canShrink,
+            backShrinks: canShrink,
+            cartCount: itemCount,
+            // The hold timer under the cart button counts down to the soonest of these on its own (0.15.0).
+            holdEndTimes,
+            onBack: back,
+            onToggleMute: () => setMuted(!session.muted),
+            // Shown only while the show can shrink: a back press, which shrinks it on the way.
+            onPip: goBack,
+            onCart: openCart,
+        },
+        /** The chat, the comment box, reactions and the pinned comment: one set of props per tile (`useLiveChat`). */
+        chat,
+        /** A link from the show (0.15.0): its page inside the app, the show in the bubble. `useLiveShop` takes it. */
+        openLink,
+    };
+}
+//# sourceMappingURL=useLivePage.js.map

package/dist/react/useLivePage.js.map

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

package/dist/react/useLiveShop.d.ts

@@ -0,0 +1,103 @@
+/**
+ * The Live screen's shopping (0.14.0, moved from amore-v2's `src/core/hooks/useLiveShop.ts`: phase 3 of
+ * its "Live player plan", shop and cart; 0.15.0 adds its link lots, from amore-v2's `eng928/integration`).
+ * The routes are the app's (`LiveSellingProvider`'s `routes`); the route's `streamId` param is read here.
+ */
+import { type Product } from '@tiledev/sdk-shopify';
+import { type ShowLink } from '../linkLots';
+import type { LiveCartChip, LiveFeaturedProduct, LiveShopLink, LiveSoldChip } from '../pageTypes';
+/** What the Live screen hands the shop (0.15.0). */
+export interface LiveShopScreen {
+    /**
+     * Opens a link the host added inside the app, the show in the bubble: `useLivePage`'s `openLink`, as
+     * amore-v2's wiring passes it (`useLiveShop({ openLink: page.openLink })`). Unset: the link opens
+     * through `routes.openLink` with the show left where it is.
+     */
+    openLink?: (url: string, title?: string | null) => void;
+}
+/**
+ * The phone's share sheet with an address (a product's page): iOS takes the link as `url`, Android as
+ * text. Nothing without one; a dismissed sheet, or none (the web preview without the browser's share),
+ * is nothing to report.
+ */
+export declare function shareAddress(url: string | null | undefined): Promise<void>;
+/** The phone's share sheet with a product's link (the Live card's and Replay's share): its page on the store (`productShareUrl`). */
+export declare function shareProduct(product: Product): Promise<void>;
+/**
+ * The Live screen's shopping, so the screen stays plain tiles. Reads the app's live session, as
+ * `useLivePage` does, for the show the route names.
+ *
+ * - **The featured product** (`productCard`): the session's `activeProduct`, with its lot number
+ *   (`sellId`; the session re-reads the record when the host features a lot, so a number issued at
+ *   show time arrives; the card shows it only when its own setting turns it on). A tap on the card
+ *   opens the product (`openProduct`, below); share opens the phone's share sheet with the product's
+ *   link (`shareProduct`, old Amore's). On an auction show: where bidding starts, no Buy and no lot
+ *   badge, no share (decided 2026-10-05, amore-v2's Head of Engineering: "Share icon should be hidden
+ *   for live auctions"), and "Waiting for the next lot…" while nothing is featured; the round's bid,
+ *   state and leader are `useLiveAuction`'s.
+ * - **The Shop button** (`shopButton`) and its sheet: every product on the show, the featured one first
+ *   and marked (`featuredFirst`), each with its lot number. A pick opens the product (`openProduct`);
+ *   quick add as everywhere. On an auction show too: there its sheet lists the lots instead
+ *   (`useLiveAuction`), and a pick opens the lot.
+ * - **What a tap on a product opens** (`openProduct`; decided 2026-10-05: "Size sheet over show"): the
+ *   variant page over the playing show (`routes.openVariantPage`). On a live show it is for buying, with
+ *   the live credit (`liveShowCredit`). On an auction show it is the lot's details in auction mode
+ *   (`auctionLotPageParams`): the product page's auction notice, no Add to Cart, no credit and no
+ *   announcement; the shopper bids from the show.
+ * - **Buying goes through the variant page**, over the playing show, as Replay's products do. Every add
+ *   from here carries the live credit and, once it lands, is announced to the room
+ *   (`announceToLiveRoom`, which the app's variant page hands `reportShowAdd`; quick add does it
+ *   itself). Signed out, shopping is open, as Freckled Poppy's.
+ * - **Links the host added** (0.15.0; amore-v2, 2026-10-19: lots that are web addresses, mostly affiliate
+ *   links, `showLinkOf`). The session hands them over among the products, in the host's order, with a
+ *   title, a price (in the shop's currency: the session gives none), a photo and the address, and no
+ *   product (`raw`). Featured, the card shows it with Open in place of Buy (`isLink`), the price, no
+ *   star, on any show (never "Waiting for the next lot…"); in the Shop sheet it is a card among the
+ *   products (`LiveShopLink`: no star, no Add to Cart). A tap opens it inside the app with the show in the
+ *   bubble (the screen's `openLink`); share shares its address. A link that isn't https, or an app with no
+ *   `routes.openLink`, is shown but opens nothing (`url` null, `canOpen` false).
+ * - **The room's chips:** "just sold" (`session.sold`) and "added to cart" (`session.cartAnnouncements`,
+ *   not on an auction show, as Freckled Poppy's). A name the room sent is shown by its first word
+ *   (`firstNameOf`); the session hands out no name as an email.
+ * - **Nothing shows** until the session holds this show's record (`useLiveShow`). It never holds a
+ *   hidden show the shopper can't see (`hiddenShows`). The web's session is always "ended" with no
+ *   show, so none of these tiles draw there.
+ */
+export declare function useLiveShop(screen?: LiveShopScreen): {
+    productCard: {
+        visible: boolean;
+        product: LiveFeaturedProduct | null;
+        betweenLots: boolean;
+        canBuy: boolean;
+        canShare: boolean;
+        favorite: boolean;
+        onOpenProduct: () => void;
+        onToggleFavorite: () => void;
+        onShare: () => void;
+    };
+    shopButton: {
+        visible: boolean;
+        /** The products and the links the host added (`LiveShopLink`), in the host's order, the featured one first. */
+        products: (Product | ShowLink)[];
+        onScreenProductId: string | null;
+        lotNumbers: Record<string, string>;
+        favoriteIds: string[];
+        auctionProductIds: string[];
+        onPressProduct: (product: Product) => void;
+        onOpenLink: (link: Pick<LiveShopLink, "url" | "title">) => void;
+        onToggleFavorite: (product: Product) => undefined;
+        onQuickAdd: (product: Product) => void;
+        addingProductIds: string[];
+    };
+    soldChips: {
+        visible: boolean;
+        chips: LiveSoldChip[];
+    };
+    cartChips: {
+        visible: boolean;
+        chips: LiveCartChip[];
+    };
+};
+/** What `useLiveShop` hands the Live screen's shop tiles. */
+export type LiveShop = ReturnType<typeof useLiveShop>;
+//# sourceMappingURL=useLiveShop.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useLiveShop.d.ts","sourceRoot":"","sources":["../../src/react/useLiveShop.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAuE,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAIzH,OAAO,EAA0B,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAWlG,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACzD;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAOhF;AAED,qIAAqI;AACrI,wBAAsB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAElE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,WAAW,CAAC,MAAM,GAAE,cAAmB;;;;;;;;;;;;;;QA+IjD,+GAA+G;;;;;;kCAxFvG,OAAO;2BAQV,IAAI,CAAC,YAAY,EAAE,KAAK,GAAG,OAAO,CAAC;oCAwFZ,OAAO;;;;;;;;;;;;EAQxC;AAED,6DAA6D;AAC7D,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/react/useLiveShop.js

@@ -0,0 +1,211 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shareAddress = shareAddress;
+exports.shareProduct = shareProduct;
+exports.useLiveShop = useLiveShop;
+/**
+ * The Live screen's shopping (0.14.0, moved from amore-v2's `src/core/hooks/useLiveShop.ts`: phase 3 of
+ * its "Live player plan", shop and cart; 0.15.0 adds its link lots, from amore-v2's `eng928/integration`).
+ * 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 react_native_1 = require("react-native");
+const linkLots_1 = require("../linkLots");
+const showCredit_1 = require("../showCredit");
+const showNames_1 = require("../showNames");
+const showLots_1 = require("../showLots");
+const LiveSellingProvider_1 = require("./LiveSellingProvider");
+const platformSession_1 = require("./platformSession");
+const navigation_1 = require("./navigation");
+/**
+ * The phone's share sheet with an address (a product's page): iOS takes the link as `url`, Android as
+ * text. Nothing without one; a dismissed sheet, or none (the web preview without the browser's share),
+ * is nothing to report.
+ */
+async function shareAddress(url) {
+    if (!url)
+        return;
+    try {
+        await react_native_1.Share.share(react_native_1.Platform.OS === 'ios' ? { url } : { message: url });
+    }
+    catch {
+        // Dismissed, or no share sheet.
+    }
+}
+/** The phone's share sheet with a product's link (the Live card's and Replay's share): its page on the store (`productShareUrl`). */
+async function shareProduct(product) {
+    await shareAddress((0, sdk_shopify_1.productShareUrl)(product));
+}
+/**
+ * The Live screen's shopping, so the screen stays plain tiles. Reads the app's live session, as
+ * `useLivePage` does, for the show the route names.
+ *
+ * - **The featured product** (`productCard`): the session's `activeProduct`, with its lot number
+ *   (`sellId`; the session re-reads the record when the host features a lot, so a number issued at
+ *   show time arrives; the card shows it only when its own setting turns it on). A tap on the card
+ *   opens the product (`openProduct`, below); share opens the phone's share sheet with the product's
+ *   link (`shareProduct`, old Amore's). On an auction show: where bidding starts, no Buy and no lot
+ *   badge, no share (decided 2026-10-05, amore-v2's Head of Engineering: "Share icon should be hidden
+ *   for live auctions"), and "Waiting for the next lot…" while nothing is featured; the round's bid,
+ *   state and leader are `useLiveAuction`'s.
+ * - **The Shop button** (`shopButton`) and its sheet: every product on the show, the featured one first
+ *   and marked (`featuredFirst`), each with its lot number. A pick opens the product (`openProduct`);
+ *   quick add as everywhere. On an auction show too: there its sheet lists the lots instead
+ *   (`useLiveAuction`), and a pick opens the lot.
+ * - **What a tap on a product opens** (`openProduct`; decided 2026-10-05: "Size sheet over show"): the
+ *   variant page over the playing show (`routes.openVariantPage`). On a live show it is for buying, with
+ *   the live credit (`liveShowCredit`). On an auction show it is the lot's details in auction mode
+ *   (`auctionLotPageParams`): the product page's auction notice, no Add to Cart, no credit and no
+ *   announcement; the shopper bids from the show.
+ * - **Buying goes through the variant page**, over the playing show, as Replay's products do. Every add
+ *   from here carries the live credit and, once it lands, is announced to the room
+ *   (`announceToLiveRoom`, which the app's variant page hands `reportShowAdd`; quick add does it
+ *   itself). Signed out, shopping is open, as Freckled Poppy's.
+ * - **Links the host added** (0.15.0; amore-v2, 2026-10-19: lots that are web addresses, mostly affiliate
+ *   links, `showLinkOf`). The session hands them over among the products, in the host's order, with a
+ *   title, a price (in the shop's currency: the session gives none), a photo and the address, and no
+ *   product (`raw`). Featured, the card shows it with Open in place of Buy (`isLink`), the price, no
+ *   star, on any show (never "Waiting for the next lot…"); in the Shop sheet it is a card among the
+ *   products (`LiveShopLink`: no star, no Add to Cart). A tap opens it inside the app with the show in the
+ *   bubble (the screen's `openLink`); share shares its address. A link that isn't https, or an app with no
+ *   `routes.openLink`, is shown but opens nothing (`url` null, `canOpen` false).
+ * - **The room's chips:** "just sold" (`session.sold`) and "added to cart" (`session.cartAnnouncements`,
+ *   not on an auction show, as Freckled Poppy's). A name the room sent is shown by its first word
+ *   (`firstNameOf`); the session hands out no name as an email.
+ * - **Nothing shows** until the session holds this show's record (`useLiveShow`). It never holds a
+ *   hidden show the shopper can't see (`hiddenShows`). The web's session is always "ended" with no
+ *   show, so none of these tiles draw there.
+ */
+function useLiveShop(screen = {}) {
+    var _a, _b, _c, _d, _e, _f;
+    const nav = (0, navigation_1.useNavigation)();
+    const streamId = (_b = (_a = (0, navigation_1.useRoute)().params) === null || _a === void 0 ? void 0 : _a.streamId) !== null && _b !== void 0 ? _b : '';
+    const { routes, track, canOpenLinks } = (0, LiveSellingProvider_1.useLivePageOptions)();
+    const screenOpenLink = screen.openLink;
+    // The session changes only on the room's events, never on a clock.
+    const session = (0, platformSession_1.useLiveSession)();
+    const wishlist = (0, sdk_shopify_1.useWishlist)();
+    // 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 hidden = !show;
+    const isAuction = capabilities.canBid;
+    // ─── The products and links ────────────────────────────────────────────────────────────────────
+    const featured = show ? session.activeProduct : null;
+    const featuredProduct = (_c = featured === null || featured === void 0 ? void 0 : featured.raw) !== null && _c !== void 0 ? _c : null;
+    // A link the host featured: a web address, no product of the store.
+    const featuredLink = (0, react_1.useMemo)(() => (featured && !featured.raw && featured.externalUrl ? (0, linkLots_1.showLinkOf)(featured, { canOpen: canOpenLinks }) : null), [featured, canOpenLinks]);
+    const featuredId = (_e = (_d = featuredProduct === null || featuredProduct === void 0 ? void 0 : featuredProduct.id) !== null && _d !== void 0 ? _d : featuredLink === null || featuredLink === void 0 ? void 0 : featuredLink.id) !== null && _e !== void 0 ? _e : null;
+    /**
+     * The show's Shopify products and the links the host added, in the host's order, the featured one
+     * first: the shopper who taps Shop wants what the host holds up.
+     */
+    const shopItems = (0, react_1.useMemo)(() => (0, showLots_1.featuredFirst)(session.products.flatMap((lot) => lot.raw ? [lot.raw] : lot.externalUrl ? [(0, linkLots_1.showLinkOf)(lot, { canOpen: canOpenLinks })] : []), featuredId), [session.products, featuredId, canOpenLinks]);
+    const products = (0, react_1.useMemo)(() => shopItems.filter((item) => !(0, linkLots_1.isShowLink)(item)), [shopItems]);
+    /** Each lot's number, by product id (a link's own id): the number the host reads out. */
+    const lotNumbers = (0, react_1.useMemo)(() => Object.fromEntries(session.products.flatMap((lot) => {
+        var _a, _b;
+        const id = (_b = (_a = lot.raw) === null || _a === void 0 ? void 0 : _a.id) !== null && _b !== void 0 ? _b : (lot.externalUrl ? lot.id : null);
+        return id && lot.sellId ? [[id, lot.sellId]] : [];
+    })), [session.products]);
+    const auctionProductIds = (0, react_1.useMemo)(() => products.filter(sdk_shopify_1.isAuctioned).map((product) => product.id), [products]);
+    // ─── Buying ────────────────────────────────────────────────────────────────────────────────────
+    const creditFor = (0, react_1.useCallback)((product) => { var _a; return (0, showCredit_1.liveShowCredit)(show, (_a = lotNumbers[product.id]) !== null && _a !== void 0 ? _a : null); }, [show, lotNumbers]);
+    const quickAdd = (0, sdk_shopify_1.useQuickAdd)((0, showCredit_1.showQuickAddOptions)((params) => routes.openVariantPage(params, nav), { credit: creditFor, track }));
+    const openVariantPage = (0, react_1.useCallback)((product) => routes.openVariantPage((0, showCredit_1.variantPageParams)(product, creditFor(product)), nav), [routes, nav, creditFor]);
+    const openLotPage = (0, react_1.useCallback)((product) => routes.openVariantPage((0, showCredit_1.auctionLotPageParams)(product), nav), [routes, nav]);
+    /** A tap on a product, on the card or in the Shop sheet: a lot's details on an auction show, else the variant page to buy it. */
+    const openProduct = isAuction ? openLotPage : openVariantPage;
+    /** A tap on a link the host added: its page inside the app, the show in the bubble. Nothing for one that can't open. */
+    const openShowLink = (0, react_1.useCallback)((link) => {
+        if (!link.url)
+            return;
+        if (screenOpenLink)
+            screenOpenLink(link.url, link.title);
+        else
+            routes.openLink(link.url, link.title, nav);
+    }, [screenOpenLink, routes, nav]);
+    // ─── The featured card ─────────────────────────────────────────────────────────────────────────
+    // The lot's opening bid, joined onto the product from the record by the session.
+    const startingBid = isAuction && featured ? ((_f = featured.baseBidPrice) !== null && _f !== void 0 ? _f : null) : null;
+    const featuredCard = (0, react_1.useMemo)(() => {
+        var _a, _b, _c, _d, _e, _f;
+        return featuredProduct
+            ? {
+                id: featuredProduct.id,
+                title: featuredProduct.title,
+                price: (0, sdk_shopify_1.formatMoney)(featuredProduct.priceRange.min),
+                imageUrl: (_d = (_b = (_a = featuredProduct.featuredImage) === null || _a === void 0 ? void 0 : _a.url) !== null && _b !== void 0 ? _b : (_c = featuredProduct.images[0]) === null || _c === void 0 ? void 0 : _c.url) !== null && _d !== void 0 ? _d : null,
+                // No lot badge on an auction lot: a bidder bids, they don't buy by the number (Freckled Poppy's).
+                lotNumber: isAuction ? null : ((_e = featured === null || featured === void 0 ? void 0 : featured.sellId) !== null && _e !== void 0 ? _e : null),
+                startingBid: startingBid != null ? (0, sdk_shopify_1.formatMoney)({ amount: String(startingBid), currencyCode: featuredProduct.priceRange.min.currencyCode }) : null,
+            }
+            : featuredLink
+                ? {
+                    id: featuredLink.id,
+                    title: featuredLink.title,
+                    price: featuredLink.price,
+                    imageUrl: featuredLink.imageUrl,
+                    lotNumber: isAuction ? null : ((_f = featured === null || featured === void 0 ? void 0 : featured.sellId) !== null && _f !== void 0 ? _f : null),
+                    startingBid: null,
+                    isLink: true,
+                    canOpen: !!featuredLink.url,
+                }
+                : null;
+    }, [featuredProduct, featuredLink, featured === null || featured === void 0 ? void 0 : featured.sellId, isAuction, startingBid]);
+    // ─── The room's chips ──────────────────────────────────────────────────────────────────────────
+    const soldChips = (0, react_1.useMemo)(() => session.sold.map((card) => ({ id: card.id, quantity: card.quantity, productName: card.productName, lotNumber: card.sellId })), [session.sold]);
+    const cartChips = (0, react_1.useMemo)(() => session.cartAnnouncements.map((card) => ({
+        id: card.id,
+        name: (0, showNames_1.firstNameOf)(card.userName),
+        productTitle: card.productTitle,
+        lotNumber: card.sellId,
+    })), [session.cartAnnouncements]);
+    return {
+        productCard: {
+            visible: !hidden,
+            product: featuredCard,
+            // An auction has gaps between lots: the slot keeps its place rather than leave the frame empty.
+            betweenLots: isAuction && !featuredCard && onAir,
+            canBuy: !isAuction,
+            // No share on an auction show (decided 2026-10-05, amore-v2's Head of Engineering), nor for a link that opens nothing.
+            canShare: !isAuction && (!featuredLink || !!featuredLink.url),
+            favorite: !!featuredProduct && wishlist.has(featuredProduct.id),
+            onOpenProduct: () => {
+                if (featuredProduct)
+                    openProduct(featuredProduct);
+                else if (featuredLink)
+                    openShowLink(featuredLink);
+            },
+            onToggleFavorite: () => {
+                if (featuredProduct)
+                    void wishlist.toggle(featuredProduct);
+            },
+            onShare: () => {
+                if (featuredProduct)
+                    void shareProduct(featuredProduct);
+                else if (featuredLink)
+                    void shareAddress(featuredLink.url);
+            },
+        },
+        shopButton: {
+            // On an auction show too: there its sheet lists the lots (`useLiveAuction`'s `shopButton.lots`).
+            visible: !hidden,
+            /** The products and the links the host added (`LiveShopLink`), in the host's order, the featured one first. */
+            products: shopItems,
+            onScreenProductId: featuredId,
+            lotNumbers,
+            favoriteIds: wishlist.ids,
+            auctionProductIds,
+            onPressProduct: openProduct,
+            onOpenLink: openShowLink,
+            onToggleFavorite: (product) => void wishlist.toggle(product),
+            onQuickAdd: quickAdd.add,
+            addingProductIds: quickAdd.addingProductIds,
+        },
+        soldChips: { visible: !hidden, chips: soldChips },
+        // An auction sells by bidding: its room has no carts to announce (Freckled Poppy's).
+        cartChips: { visible: !hidden && !isAuction, chips: cartChips },
+    };
+}
+//# sourceMappingURL=useLiveShop.js.map