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

package/dist/react/platformSession.web.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SHEET_HANDOFF_MS = exports.NativeVideoView = exports.isNativeVideoSupported = exports.IDLE_SESSION = void 0;
+exports.LiveSessionProvider = LiveSessionProvider;
+exports.useLiveSession = useLiveSession;
+exports.useLiveShow = useLiveShow;
+exports.LiveVideoTarget = LiveVideoTarget;
+exports.useAuctionBidGate = useAuctionBidGate;
+exports.useAuctionWins = useAuctionWins;
+/**
+ * The session and what draws it, on the **web** (0.14.0: moved here from `index.web.ts`, which
+ * re-exports them): an idle session, a show that is always `ended`, a `View` for the video, a bid gate
+ * that never blocks and no wins. Metro serves this file in place of `platformSession.ts` on the web,
+ * so the page hooks, the Shopify session provider and the `/ui` bubbles, which read the session from
+ * `./platformSession`, run here over these stand-ins and never reach the Zego module. `index.web.ts`
+ * says why each is what it is.
+ *
+ * `createElement` rather than JSX, like the rest of the package, so this stays a plain `.ts`.
+ */
+const react_1 = require("react");
+const react_native_1 = require("react-native");
+const liveShow_1 = require("../liveShow");
+const sessionTypes_1 = require("../sessionTypes");
+// ─── The session ─────────────────────────────────────────────────────────────
+/** Every action, resolved and doing nothing. There is no room to send any of it to. */
+const IDLE_ACTIONS = {
+    bindVideoView: () => undefined,
+    sendComment: async () => undefined,
+    sendReaction: async () => undefined,
+    announceAddToCart: async () => undefined,
+    voteInPoll: async () => undefined,
+    chooseViewerName: async () => null,
+    addToCart: async () => false,
+    joinAsGuest: () => Promise.reject(new Error('Co-hosting needs a device build.')),
+    leaveGuest: async () => undefined,
+    setGuestMicMuted: async () => undefined,
+    setGuestCameraOff: async () => undefined,
+    flipGuestCamera: async () => undefined,
+    bindGuestPreview: () => undefined,
+    bindGuestHostView: () => undefined,
+    setMuted: () => undefined,
+    setOutputMuted: () => undefined,
+    setPipHandover: () => undefined,
+    holdStream: () => undefined,
+    releaseStream: () => undefined,
+    enterPip: () => undefined,
+    exitPip: () => undefined,
+    placeBid: async () => ({ sent: false, reason: 'noShow' }),
+    enterGiveaway: async () => ({ entered: false, reason: 'noGiveaway' }),
+    dismissAuctionWin: () => undefined,
+    dismissGiveawayResult: () => undefined,
+};
+/** A stream that is over: the one state every surface already knows how to draw. */
+exports.IDLE_SESSION = {
+    status: 'ended',
+    stream: null,
+    viewerCount: 0,
+    rawViewerCount: 0,
+    reactionStyle: 'single',
+    comments: [],
+    activeProduct: null,
+    products: [],
+    sold: [],
+    cartAnnouncements: [],
+    reactions: [],
+    poll: null,
+    muted: true,
+    videoTag: null,
+    pipMode: 'none',
+    guest: {
+        mode: false,
+        status: 'idle',
+        slot: null,
+        mutedByHost: false,
+        cameraOffByHost: false,
+        mixerLayout: null,
+    },
+    viewerName: null,
+    auction: sessionTypes_1.IDLE_AUCTION,
+    giveaway: sessionTypes_1.IDLE_GIVEAWAY,
+    pinnedComment: null,
+    error: null,
+    actions: IDLE_ACTIONS,
+};
+const LiveSessionContext = (0, react_1.createContext)(null);
+function LiveSessionProvider({ children }) {
+    return (0, react_1.createElement)(LiveSessionContext.Provider, { value: exports.IDLE_SESSION }, children);
+}
+/**
+ * The idle session, read without touching the context: a surface rendered outside the provider
+ * behaves the same as one inside it, because on the web there is only ever this one session.
+ */
+function useLiveSession() {
+    return exports.IDLE_SESSION;
+}
+/** The idle session's show: none, and `ended`. One object, as the session never changes here. */
+const IDLE_SHOW = (0, liveShow_1.liveShowFor)(exports.IDLE_SESSION, null);
+/** `useLiveShow` over the idle session: always `ended`, with no show, whatever the id. */
+function useLiveShow(_streamingId) {
+    return IDLE_SHOW;
+}
+// ─── The video ───────────────────────────────────────────────────────────────
+exports.isNativeVideoSupported = false;
+/**
+ * A plain `View`, which is what the native file falls back to on a build without the Zego SDK:
+ * callers position this and draw a poster over it, so returning null would collapse the layout the
+ * poster depends on.
+ */
+exports.NativeVideoView = (0, react_1.forwardRef)(function NativeVideoView(props, _ref) {
+    return (0, react_1.createElement)(react_native_1.View, props);
+});
+function LiveVideoTarget({ style, children }) {
+    return (0, react_1.createElement)(react_native_1.View, { style: style !== null && style !== void 0 ? style : { flex: 1 } }, children);
+}
+// ─── Auctions ────────────────────────────────────────────────────────────────
+exports.SHEET_HANDOFF_MS = 380;
+/** Never blocks, because there is no bid to gate — `placeBid` above resolves without sending. */
+function useAuctionBidGate(_options) {
+    return (0, react_1.useMemo)(() => ({
+        blocker: null,
+        variantId: null,
+        requestBid: () => undefined,
+        acceptTerms: () => undefined,
+        chooseVariant: () => undefined,
+        dismiss: () => undefined,
+        refreshUnpaidWins: () => undefined,
+        refusal: null,
+        bidOnItsWay: false,
+    }), []);
+}
+/**
+ * An empty tab rather than a failure. The wins metafield is readable from a browser, but settling one
+ * mints a cart and sends the shopper to checkout — not something a preview should be able to start.
+ */
+function useAuctionWins(_options) {
+    return (0, react_1.useMemo)(() => ({
+        rows: [],
+        giveawayVariantIds: new Set(),
+        totalBids: 0,
+        streamingId: null,
+        loading: false,
+        checkingOut: false,
+        error: null,
+        refresh: () => undefined,
+        checkout: async () => null,
+    }), []);
+}
+//# sourceMappingURL=platformSession.web.js.map

package/dist/react/platformSession.web.js.map

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

package/dist/react/replayPlayer.d.ts

@@ -0,0 +1,74 @@
+/**
+ * The app's one player for recorded shows (0.14.0, moved from amore-v2's
+ * `src/core/providers/replayPlayer.tsx`: the old app's `ReplayPipProvider`, rebuilt; decided 2026-10-05,
+ * Head of Engineering: a picture-in-picture button and a cart on the Replay screen, with an in-app
+ * bubble). `useReplayPage` borrows it, and the `/ui` entry's `ReplayBubble` draws it.
+ *
+ * `createElement` rather than JSX, like the rest of the package, so this stays a plain `.ts`.
+ */
+import { type VideoPlayer, type VideoPlayerStatus } from 'expo-video';
+import type { ReactNode } from 'react';
+import type { Replay } from '../types';
+export interface ReplayPlayerState {
+    /** The app's one video player for recorded shows: the Replay screen and the bubble both draw it. */
+    player: VideoPlayer;
+    /** The recording the player holds, or null when it holds nothing. */
+    recording: Replay | null;
+    /** That recording's video, the player's source. */
+    videoUrl: string | null;
+    /** The video has its first picture, so a poster over it can come off. */
+    videoReady: boolean;
+    status: VideoPlayerStatus;
+    playing: boolean;
+    muted: boolean;
+    /** The shopper paused the recording; a new recording starts unpaused. */
+    pausedByShopper: boolean;
+    /** The floating bubble shows the video, over whatever screen is open. */
+    bubbleShown: boolean;
+    /** Puts this recording in the player, from the start. Nothing changes if the player already holds it. */
+    openRecording: (recording: Replay) => void;
+    /** Whether the player holds this video now (read at the moment it is asked, not at the last render). */
+    holdsVideo: (videoUrl: string | null) => boolean;
+    /** Pauses, takes the video out of the player and closes the bubble. */
+    stop: () => void;
+    /** The video moves into the bubble. Nothing happens when the player holds nothing. */
+    showBubble: () => void;
+    /** The bubble closes and the video goes on playing, for the Replay screen to show. */
+    hideBubble: () => void;
+    setMuted: (muted: boolean) => void;
+    setPausedByShopper: (paused: boolean) => void;
+    /** A view drew the video's first picture. */
+    markVideoReady: () => void;
+    /** A Replay screen (its route key) is on show with the player's recording, or no longer is. */
+    setScreenShowing: (screenKey: string, showing: boolean) => void;
+    /** A Replay screen closed: the video stops, unless the bubble or another Replay screen shows it. */
+    screenClosed: (screenKey: string) => void;
+}
+/** The app's replay player, for the Replay screen's hook and the bubble. Only inside `ReplayPlayerProvider`. */
+export declare function useReplayPlayer(): ReplayPlayerState;
+/**
+ * The app's one player for recorded shows. Mount it above the navigator, because the bubble outlives
+ * the screen that opened it: a player made in the screen is released when the screen closes, which is
+ * exactly when the bubble needs it. The Replay screen borrows it (`useReplayPage`); nothing is loaded
+ * until a recording is opened, so a session that never opens one has an idle player and no requests.
+ *
+ * - **One recording at a time,** one source per recording: opening the one the player already holds
+ *   changes nothing, so a recording coming back from the bubble plays on where it was.
+ * - **When it plays:** it holds a recording, the shopper hasn't paused it, and something shows it, the
+ *   bubble or the Replay screen of that recording while that screen is on show (a sheet over it, like
+ *   the variant page, counts as on show). Anything else pauses it.
+ * - **One view at a time:** while the bubble is up only the bubble draws the video; the Replay screen
+ *   draws it again once the bubble closes. A second view on the same player would have two native
+ *   views competing for it.
+ * - **Stopping** (the bubble's ✕, the screen's close, the recording ending in the bubble, or the last
+ *   Replay screen closing with no bubble) pauses, takes the video out, closes the bubble and puts the
+ *   sound back to how a recording starts.
+ * - **On web** a view is a `<video>` element of its own that starts at 0, so moving between the screen
+ *   and the bubble carries the time across by hand.
+ * - **No system picture-in-picture**: it needs expo-video's picture-in-picture flag, the audio
+ *   background mode and a native build.
+ */
+export declare function ReplayPlayerProvider({ children }: {
+    children: ReactNode;
+}): import("react").FunctionComponentElement<import("react").ProviderProps<ReplayPlayerState | null>>;
+//# sourceMappingURL=replayPlayer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replayPlayer.d.ts","sourceRoot":"","sources":["../../src/react/replayPlayer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAkB,KAAK,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEtF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAcvC,MAAM,WAAW,iBAAiB;IAChC,oGAAoG;IACpG,MAAM,EAAE,WAAW,CAAC;IACpB,qEAAqE;IACrE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,yEAAyE;IACzE,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,yEAAyE;IACzE,eAAe,EAAE,OAAO,CAAC;IACzB,yEAAyE;IACzE,WAAW,EAAE,OAAO,CAAC;IACrB,yGAAyG;IACzG,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,wGAAwG;IACxG,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC;IACjD,uEAAuE;IACvE,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,sFAAsF;IACtF,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,sFAAsF;IACtF,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,kBAAkB,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAC9C,6CAA6C;IAC7C,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,+FAA+F;IAC/F,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAChE,oGAAoG;IACpG,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAID,gHAAgH;AAChH,wBAAgB,eAAe,IAAI,iBAAiB,CAInD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,qGAqOzE"}

package/dist/react/replayPlayer.js

@@ -0,0 +1,279 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useReplayPlayer = useReplayPlayer;
+exports.ReplayPlayerProvider = ReplayPlayerProvider;
+/**
+ * The app's one player for recorded shows (0.14.0, moved from amore-v2's
+ * `src/core/providers/replayPlayer.tsx`: the old app's `ReplayPipProvider`, rebuilt; decided 2026-10-05,
+ * Head of Engineering: a picture-in-picture button and a cart on the Replay screen, with an in-app
+ * bubble). `useReplayPage` borrows it, and the `/ui` entry's `ReplayBubble` draws it.
+ *
+ * `createElement` rather than JSX, like the rest of the package, so this stays a plain `.ts`.
+ */
+const expo_video_1 = require("expo-video");
+const react_1 = require("react");
+const react_native_1 = require("react-native");
+/** The poster comes off by now even if the video never says it has a picture. */
+const POSTER_AT_MOST_MS = 4000;
+/** Web: how long after the video moves to another view it is played again (see the play effect). */
+const WEB_PLAY_AGAIN_MS = 300;
+/**
+ * A recording starts with sound on a phone, as old Amore. Browsers refuse to start a video with sound
+ * before the visitor has touched the page (Chrome's autoplay policy; the dashboard preview opens screens
+ * without a tap, and the refusal is an unhandled `NotAllowedError` inside expo-video's web `play()`), so
+ * on web it starts muted, the sound button a tap away.
+ */
+const STARTS_MUTED = react_native_1.Platform.OS === 'web';
+const ReplayPlayerContext = (0, react_1.createContext)(null);
+/** The app's replay player, for the Replay screen's hook and the bubble. Only inside `ReplayPlayerProvider`. */
+function useReplayPlayer() {
+    const value = (0, react_1.useContext)(ReplayPlayerContext);
+    if (!value)
+        throw new Error('useReplayPlayer must be used inside ReplayPlayerProvider');
+    return value;
+}
+/**
+ * The app's one player for recorded shows. Mount it above the navigator, because the bubble outlives
+ * the screen that opened it: a player made in the screen is released when the screen closes, which is
+ * exactly when the bubble needs it. The Replay screen borrows it (`useReplayPage`); nothing is loaded
+ * until a recording is opened, so a session that never opens one has an idle player and no requests.
+ *
+ * - **One recording at a time,** one source per recording: opening the one the player already holds
+ *   changes nothing, so a recording coming back from the bubble plays on where it was.
+ * - **When it plays:** it holds a recording, the shopper hasn't paused it, and something shows it, the
+ *   bubble or the Replay screen of that recording while that screen is on show (a sheet over it, like
+ *   the variant page, counts as on show). Anything else pauses it.
+ * - **One view at a time:** while the bubble is up only the bubble draws the video; the Replay screen
+ *   draws it again once the bubble closes. A second view on the same player would have two native
+ *   views competing for it.
+ * - **Stopping** (the bubble's ✕, the screen's close, the recording ending in the bubble, or the last
+ *   Replay screen closing with no bubble) pauses, takes the video out, closes the bubble and puts the
+ *   sound back to how a recording starts.
+ * - **On web** a view is a `<video>` element of its own that starts at 0, so moving between the screen
+ *   and the bubble carries the time across by hand.
+ * - **No system picture-in-picture**: it needs expo-video's picture-in-picture flag, the audio
+ *   background mode and a native build.
+ */
+function ReplayPlayerProvider({ children }) {
+    var _a;
+    const player = (0, expo_video_1.useVideoPlayer)(null, (created) => {
+        created.loop = false;
+        // Muted from the start on web: the first source starts playing as it is applied.
+        created.muted = STARTS_MUTED;
+    });
+    const [recording, setRecording] = (0, react_1.useState)(null);
+    const [bubbleShown, setBubbleShown] = (0, react_1.useState)(false);
+    /** The route key of the Replay screen on show with the player's recording, if one is. */
+    const [screenShowingKey, setScreenShowingKey] = (0, react_1.useState)(null);
+    const [muted, setMuted] = (0, react_1.useState)(STARTS_MUTED);
+    const [pausedByShopper, setPausedByShopper] = (0, react_1.useState)(false);
+    const [playing, setPlaying] = (0, react_1.useState)(player.playing);
+    const [status, setStatus] = (0, react_1.useState)(player.status);
+    const [videoReady, setVideoReady] = (0, react_1.useState)(false);
+    const videoUrl = (_a = recording === null || recording === void 0 ? void 0 : recording.videoUrl) !== null && _a !== void 0 ? _a : null;
+    const shouldPlay = !!videoUrl && !pausedByShopper && (bubbleShown || screenShowingKey !== null);
+    // Read by callbacks the moment they run: a screen closing straight after `showBubble`, or a load
+    // finishing, must see what was just decided, not the last render.
+    const videoUrlNow = (0, react_1.useRef)(null);
+    const bubbleShownNow = (0, react_1.useRef)(false);
+    const screenShowingKeyNow = (0, react_1.useRef)(null);
+    const shouldPlayNow = (0, react_1.useRef)(shouldPlay);
+    shouldPlayNow.current = shouldPlay;
+    /** The status the player reports next belongs to this source only once it has left the last one's "ready". */
+    const statusIsThisSource = (0, react_1.useRef)(false);
+    /** Web only: where the video was when it moved between the screen and the bubble, for the new view. */
+    const handover = (0, react_1.useRef)(null);
+    const timeNow = (0, react_1.useCallback)(() => {
+        try {
+            return player.currentTime || 0;
+        }
+        catch {
+            return 0;
+        }
+    }, [player]);
+    const openRecording = (0, react_1.useCallback)((next) => {
+        const nextUrl = next.videoUrl;
+        if (!nextUrl || videoUrlNow.current === nextUrl)
+            return;
+        videoUrlNow.current = nextUrl;
+        handover.current = null;
+        statusIsThisSource.current = player.status !== 'readyToPlay';
+        setVideoReady(false);
+        setPausedByShopper(false);
+        setRecording(next);
+        player
+            .replaceAsync(nextUrl)
+            .then(() => {
+            if (videoUrlNow.current === nextUrl && shouldPlayNow.current)
+                player.play();
+        })
+            // A source that won't open reports `error` through its status.
+            .catch(() => undefined);
+    }, [player]);
+    const holdsVideo = (0, react_1.useCallback)((url) => !!url && videoUrlNow.current === url, []);
+    const stop = (0, react_1.useCallback)(() => {
+        const held = videoUrlNow.current;
+        videoUrlNow.current = null;
+        bubbleShownNow.current = false;
+        handover.current = null;
+        try {
+            player.pause();
+        }
+        catch {
+            // Already released (the app is closing).
+        }
+        if (held)
+            void player.replaceAsync(null).catch(() => undefined);
+        setRecording(null);
+        setBubbleShown(false);
+        setPausedByShopper(false);
+        setVideoReady(false);
+        setMuted(STARTS_MUTED);
+    }, [player]);
+    const showBubble = (0, react_1.useCallback)(() => {
+        if (!videoUrlNow.current || bubbleShownNow.current)
+            return;
+        handover.current = { videoUrl: videoUrlNow.current, atSeconds: timeNow() };
+        bubbleShownNow.current = true;
+        setBubbleShown(true);
+    }, [timeNow]);
+    const hideBubble = (0, react_1.useCallback)(() => {
+        if (!bubbleShownNow.current)
+            return;
+        if (videoUrlNow.current)
+            handover.current = { videoUrl: videoUrlNow.current, atSeconds: timeNow() };
+        bubbleShownNow.current = false;
+        setBubbleShown(false);
+    }, [timeNow]);
+    const setScreenShowing = (0, react_1.useCallback)((screenKey, showing) => {
+        if (showing) {
+            screenShowingKeyNow.current = screenKey;
+            setScreenShowingKey(screenKey);
+        }
+        else if (screenShowingKeyNow.current === screenKey) {
+            screenShowingKeyNow.current = null;
+            setScreenShowingKey(null);
+        }
+    }, []);
+    const screenClosed = (0, react_1.useCallback)((screenKey) => {
+        setScreenShowing(screenKey, false);
+        // Nothing left to show the video: it stops rather than stay loaded, paused, out of sight.
+        if (!bubbleShownNow.current && screenShowingKeyNow.current === null)
+            stop();
+    }, [setScreenShowing, stop]);
+    const markVideoReady = (0, react_1.useCallback)(() => setVideoReady(true), []);
+    // Web: the view that now shows the video is a new `<video>` element at 0; it starts where the last
+    // one was. Declared before the play effect, so the time is set before it plays.
+    (0, react_1.useEffect)(() => {
+        const moved = handover.current;
+        handover.current = null;
+        if (react_native_1.Platform.OS !== 'web' || !moved || moved.videoUrl !== videoUrlNow.current)
+            return;
+        try {
+            player.currentTime = moved.atSeconds;
+        }
+        catch {
+            // No view yet: it starts from the beginning.
+        }
+    }, [player, bubbleShown, screenShowingKey]);
+    // Also when the view showing it changes: on web the player plays through the view it is shown in.
+    (0, react_1.useEffect)(() => {
+        if (!videoUrl)
+            return;
+        if (!shouldPlay) {
+            player.pause();
+            return;
+        }
+        player.play();
+        if (react_native_1.Platform.OS !== 'web')
+            return;
+        // Web: the `<video>` element that just went away pauses as the browser removes it, and expo-video's
+        // web player passes that pause on to every view it has, the new one included (seen in the preview:
+        // the bubble came up paused). Played again once that has happened.
+        const timer = setTimeout(() => {
+            if (shouldPlayNow.current)
+                player.play();
+        }, WEB_PLAY_AGAIN_MS);
+        return () => clearTimeout(timer);
+    }, [player, videoUrl, shouldPlay, bubbleShown, screenShowingKey]);
+    (0, react_1.useEffect)(() => {
+        player.muted = muted;
+    }, [player, muted]);
+    // The phone pauses the video when the app goes to the background; coming back picks it up again.
+    (0, react_1.useEffect)(() => {
+        const subscription = react_native_1.AppState.addEventListener('change', (state) => {
+            if (state === 'active' && shouldPlayNow.current)
+                player.play();
+        });
+        return () => subscription.remove();
+    }, [player]);
+    (0, react_1.useEffect)(() => {
+        const playingChange = player.addListener('playingChange', ({ isPlaying }) => setPlaying(isPlaying));
+        const statusChange = player.addListener('statusChange', ({ status: next }) => {
+            setStatus(next);
+            if (next !== 'readyToPlay')
+                statusIsThisSource.current = true;
+            else if (statusIsThisSource.current)
+                setVideoReady(true);
+        });
+        // The bubble outlives the screen, so nothing else would take it down at the end of the recording:
+        // it would sit over the app on a frozen last frame.
+        const ended = player.addListener('playToEnd', () => {
+            if (bubbleShownNow.current)
+                stop();
+        });
+        return () => {
+            playingChange.remove();
+            statusChange.remove();
+            ended.remove();
+        };
+    }, [player, stop]);
+    // The poster's backstop, unless the video failed: then the poster stays rather than a black picture.
+    (0, react_1.useEffect)(() => {
+        if (videoReady || !videoUrl || status === 'error')
+            return;
+        const timer = setTimeout(() => setVideoReady(true), POSTER_AT_MOST_MS);
+        return () => clearTimeout(timer);
+    }, [videoReady, videoUrl, status]);
+    const value = (0, react_1.useMemo)(() => ({
+        player,
+        recording,
+        videoUrl,
+        videoReady,
+        status,
+        playing,
+        muted,
+        pausedByShopper,
+        bubbleShown,
+        openRecording,
+        holdsVideo,
+        stop,
+        showBubble,
+        hideBubble,
+        setMuted,
+        setPausedByShopper,
+        markVideoReady,
+        setScreenShowing,
+        screenClosed,
+    }), [
+        player,
+        recording,
+        videoUrl,
+        videoReady,
+        status,
+        playing,
+        muted,
+        pausedByShopper,
+        bubbleShown,
+        openRecording,
+        holdsVideo,
+        stop,
+        showBubble,
+        hideBubble,
+        markVideoReady,
+        setScreenShowing,
+        screenClosed,
+    ]);
+    return (0, react_1.createElement)(ReplayPlayerContext.Provider, { value }, children);
+}
+//# sourceMappingURL=replayPlayer.js.map

package/dist/react/replayPlayer.js.map

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

package/dist/react/shopifyProviders.d.ts

@@ -0,0 +1,68 @@
+import type { ReactNode } from 'react';
+import { type ShopifyImageTransform } from '../shopifyCommerce';
+import type { LiveSellingConfig, StorageAdapter } from '../types';
+import { type LiveSellingProviderProps } from './LiveSellingProvider';
+import type { LiveSessionProviderProps } from './useLiveSession';
+/**
+ * The gateway's config as `ShopifyLiveSellingProvider` takes it: everything but what it builds from
+ * sdk-shopify (`identity`, `customerAccountRequest`, `commerce`), with `storage` optional.
+ */
+export type ShopifyLiveSellingConfig = Omit<LiveSellingConfig, 'storage' | 'identity' | 'customerAccountRequest' | 'commerce'> & {
+    /** Where poll votes, a signed-out shopper's name and the accepted terms are kept. Default: AsyncStorage. */
+    storage?: StorageAdapter;
+};
+export interface ShopifyLiveSellingProviderProps extends Omit<LiveSellingProviderProps, 'config' | 'viewerEmail'> {
+    /**
+     * The gateway (`apiUrl`, `companyId`, `videoCollectionId`, `zegoAppId`…), `haptics` and `hiddenShows`
+     * (`REHEARSALS` for the Apptile team's practice shows). Read when the provider mounts and when one
+     * of these props changes; the client itself reconfigures only when `apiUrl`, `companyId` or
+     * `videoCollectionId` does.
+     */
+    config: ShopifyLiveSellingConfig;
+    /** `source_name` on the wins cart: which app the order came from (`createShopifyLiveCommerce`'s `cartSourceName`). */
+    cartSourceName: string;
+    /**
+     * The line attribute that marks a prize in the wins cart (`GIVEAWAY_PRIZE_KEY` on the Tile apps'
+     * stores). No default, as `createShopifyLiveCommerce` has none: a wrong key gets the prize charged.
+     */
+    prizeWriteKey: string;
+    /** The products' photo size. Default: sdk-shopify's `CARD_IMAGE`, the product cards' size. */
+    imageTransform?: ShopifyImageTransform;
+}
+/**
+ * `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`.
+ */
+export declare function ShopifyLiveSellingProvider({ children, config, cartSourceName, prizeWriteKey, imageTransform, ...pageProps }: ShopifyLiveSellingProviderProps): import("react").FunctionComponentElement<LiveSellingProviderProps>;
+export interface ShopifyLiveSessionProviderProps extends Omit<LiveSessionProviderProps, 'viewerName' | 'children'> {
+    children: ReactNode;
+}
+/**
+ * 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.
+ */
+export declare function ShopifyLiveSessionProvider({ children, onPipRestore, ...props }: ShopifyLiveSessionProviderProps): import("react").FunctionComponentElement<LiveSessionProviderProps>;
+//# sourceMappingURL=shopifyProviders.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shopifyProviders.d.ts","sourceRoot":"","sources":["../../src/react/shopifyProviders.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAA6B,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAG3F,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAClE,OAAO,EAA2C,KAAK,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAE/G,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAEjE;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,IAAI,CAAC,iBAAiB,EAAE,SAAS,GAAG,UAAU,GAAG,wBAAwB,GAAG,UAAU,CAAC,GAAG;IAC/H,4GAA4G;IAC5G,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B,CAAC;AAEF,MAAM,WAAW,+BAAgC,SAAQ,IAAI,CAAC,wBAAwB,EAAE,QAAQ,GAAG,aAAa,CAAC;IAC/G;;;;;OAKG;IACH,MAAM,EAAE,wBAAwB,CAAC;IACjC,sHAAsH;IACtH,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,8FAA8F;IAC9F,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACxC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,EACzC,QAAQ,EACR,MAAM,EACN,cAAc,EACd,aAAa,EACb,cAA2B,EAC3B,GAAG,SAAS,EACb,EAAE,+BAA+B,sEA4BjC;AAED,MAAM,WAAW,+BAAgC,SAAQ,IAAI,CAAC,wBAAwB,EAAE,YAAY,GAAG,UAAU,CAAC;IAChH,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,0BAA0B,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,KAAK,EAAE,EAAE,+BAA+B,sEAiB/G"}