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

package/dist/livePages.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REPLAY_COMMENTS_SHOWN = exports.BACK_ACTIONS = void 0;
+exports.isCoveredOnlyBySheet = isCoveredOnlyBySheet;
+exports.chatNameAsk = chatNameAsk;
+exports.isTheShow = isTheShow;
+exports.playerMs = playerMs;
+exports.productOnScreen = productOnScreen;
+exports.firstShownAt = firstShownAt;
+exports.replayCommentsAt = replayCommentsAt;
+// ─── The Live screen ──────────────────────────────────────────────────────────
+/**
+ * The navigation actions that are a back press: the header's arrow and picture-in-picture button
+ * (`goBack`, or `popTo` the tabs when nothing is behind), Android's back (`GO_BACK`) and the iOS swipe
+ * (native-stack's `POP`). Leaving any of these ways shrinks a show on air into the bubble. Being
+ * replaced (a link's show has a recording) or navigated away from is not going back.
+ */
+exports.BACK_ACTIONS = new Set(['GO_BACK', 'POP', 'POP_TO', 'POP_TO_TOP']);
+/**
+ * The screen (`screenKey`, its route key) is covered only by a page drawn as a sheet (`sheets`, the
+ * app's route names: the variant page, the Sign In page): the show plays on behind it, with the screen
+ * kept on, as if the screen were on show.
+ */
+function isCoveredOnlyBySheet(state, screenKey, sheets) {
+    if (!state)
+        return false;
+    const top = state.routes[state.index];
+    const below = state.routes[state.index - 1];
+    return !!top && sheets.includes(top.name) && (below === null || below === void 0 ? void 0 : below.key) === screenKey;
+}
+/**
+ * What the comment box does about the shopper's name: ask for one on the first Send (`askForName`,
+ * saved on this phone by the session's `chooseViewerName`), or wait while the account loads
+ * (`waitingForName`, Send held so nothing goes out as "Anonymous").
+ *
+ * Signed in, the account's name is the room's (`viewerNameFor`). Since sdk-apptile-live-selling 0.13.0
+ * an account with no name gives none (it was the email's part before the @), and nor does one with a
+ * name the show's team goes by: the room has no name, and the shopper is asked like a signed-out one
+ * once the account has loaded. amore-v2's chat waited for as long as a signed-in shopper had no name,
+ * which on 0.13.0 was for ever for such an account.
+ */
+function chatNameAsk({ named, loggedIn, restoring, hasCustomer }) {
+    // On app open, or a moment after signing in (signed in, the account not read yet).
+    const accountLoading = restoring || (loggedIn && !hasCustomer);
+    return { askForName: !named && !accountLoading, waitingForName: !named && accountLoading };
+}
+// ─── The Replay screen ────────────────────────────────────────────────────────
+/** A card passes the recording's feed id; a push passes its show's streaming id. Both find it. */
+function isTheShow(replay, id) {
+    return replay.id === id || replay.streamingId === id;
+}
+/** A time or length from the player, in seconds, as milliseconds; 0 when it has none yet. */
+function playerMs(seconds) {
+    return Number.isFinite(seconds) && seconds > 0 ? seconds * 1000 : 0;
+}
+/**
+ * The product on screen at `atMs`: the one whose time window covers it (where windows overlap, the
+ * host went back to something, and the last one is what they were on); before the first window (a
+ * sale opens with a greeting), the first tagged product. Null with no products.
+ */
+function productOnScreen(segments, products, atMs) {
+    var _a, _b;
+    const covering = segments.filter((segment) => atMs >= segment.startMs && atMs <= segment.endMs);
+    const productId = covering.length ? covering[covering.length - 1].productGid : null;
+    return (_b = (_a = (productId ? products.find((product) => product.id === productId) : undefined)) !== null && _a !== void 0 ? _a : products[0]) !== null && _b !== void 0 ? _b : null;
+}
+/** Where the host first showed a product, or null for one they never did (tagged, with no time window). */
+function firstShownAt(segments, productId) {
+    var _a, _b;
+    return (_b = (_a = segments.find((segment) => segment.productGid === productId)) === null || _a === void 0 ? void 0 : _a.startMs) !== null && _b !== void 0 ? _b : null;
+}
+/** Comments kept in the replay's chat pane: the newest of what has been said so far. */
+exports.REPLAY_COMMENTS_SHOWN = 60;
+/**
+ * The recording's chat as it stood at `atMs`: what had been said by then, the newest `shown`, oldest
+ * first. The comments file writes the host's rows as "You" (true on the console that recorded them),
+ * so those read as the host's too.
+ */
+function replayCommentsAt(comments, atMs, shown = exports.REPLAY_COMMENTS_SHOWN) {
+    let said = 0;
+    while (said < comments.length && comments[said].atMs <= atMs)
+        said += 1;
+    return comments.slice(Math.max(0, said - shown), said).map(({ comment }) => ({
+        id: comment.id,
+        author: comment.userName,
+        text: comment.text,
+        fromHost: comment.source === 'HOST' || comment.userName === 'You',
+    }));
+}
+//# sourceMappingURL=livePages.js.map

package/dist/livePages.js.map

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

package/dist/liveRoom.d.ts

@@ -0,0 +1,21 @@
+/**
+ * An add to tell the live show's room about once it lands: the variant page's and quick add's
+ * `announceToLiveRoom`, set only by the Live screen (`useLiveShop`). `lotNumber` is the lot's number
+ * (the session's `sellId`), or null when the gateway hasn't issued one.
+ */
+export interface LiveRoomAnnouncement {
+    lotNumber: string | null;
+}
+/**
+ * Tells the room of the live show this phone is watching that the shopper put a product in their cart:
+ * every phone in the room shows it as a cart chip ("Sold 104", or "Jane added …"), this one included,
+ * as the room sends it back. **Only after the add landed** (Freckled Poppy's rule): a refused add must
+ * not be announced, as the room reads the chip as "it is going".
+ *
+ * The engine's own call (`sendCartAnnouncement`, which the session's `actions.announceAddToCart`
+ * wraps). The phone is in one room at a time, the one the Live screen holds (`holdStream`) while the
+ * variant page is over it; with no room (the show ended meanwhile) nothing is sent. A send that fails
+ * goes to the provider's `onWarning`. Never throws.
+ */
+export declare function announceAddToLiveRoom(productTitle: string, { lotNumber }: LiveRoomAnnouncement): void;
+//# sourceMappingURL=liveRoom.d.ts.map

package/dist/liveRoom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liveRoom.d.ts","sourceRoot":"","sources":["../src/liveRoom.ts"],"names":[],"mappings":"AASA;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,EAAE,oBAAoB,GAAG,IAAI,CAIrG"}

package/dist/liveRoom.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.announceAddToLiveRoom = announceAddToLiveRoom;
+/**
+ * Telling the live show's room about an add (0.14.0, moved from amore-v2's `src/core/services/liveRoom.ts`).
+ *
+ * Free of React, so the variant page and quick add can announce without reading the session, which they
+ * need for nothing else. `engine` is the native one on a phone and the no-op everywhere else.
+ */
+const engine_1 = require("./engine");
+const pageOptions_1 = require("./pageOptions");
+/**
+ * Tells the room of the live show this phone is watching that the shopper put a product in their cart:
+ * every phone in the room shows it as a cart chip ("Sold 104", or "Jane added …"), this one included,
+ * as the room sends it back. **Only after the add landed** (Freckled Poppy's rule): a refused add must
+ * not be announced, as the room reads the chip as "it is going".
+ *
+ * The engine's own call (`sendCartAnnouncement`, which the session's `actions.announceAddToCart`
+ * wraps). The phone is in one room at a time, the one the Live screen holds (`holdStream`) while the
+ * variant page is over it; with no room (the show ended meanwhile) nothing is sent. A send that fails
+ * goes to the provider's `onWarning`. Never throws.
+ */
+function announceAddToLiveRoom(productTitle, { lotNumber }) {
+    void engine_1.engine.sendCartAnnouncement(productTitle, lotNumber).catch((error) => {
+        (0, pageOptions_1.reportLiveWarning)(error, { at: 'announceAddToLiveRoom', productTitle, lotNumber });
+    });
+}
+//# sourceMappingURL=liveRoom.js.map

package/dist/liveRoom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"liveRoom.js","sourceRoot":"","sources":["../src/liveRoom.ts"],"names":[],"mappings":";;AA6BA,sDAIC;AAjCD;;;;;GAKG;AACH,qCAAkC;AAClC,+CAAkD;AAWlD;;;;;;;;;;GAUG;AACH,SAAgB,qBAAqB,CAAC,YAAoB,EAAE,EAAE,SAAS,EAAwB;IAC7F,KAAK,eAAM,CAAC,oBAAoB,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QACjF,IAAA,+BAAiB,EAAC,KAAK,EAAE,EAAE,EAAE,EAAE,uBAAuB,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC;IACrF,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/pageOptions.d.ts

@@ -0,0 +1,100 @@
+/**
+ * What the live pages need from the app (0.14.0), set once on `LiveSellingProvider`: where the shopper
+ * goes (`routes`), the app's analytics (`track`), where a handled failure is reported (`onWarning`) and
+ * the store's name (`shopName`).
+ *
+ * The page hooks (`useLivePage`, `useReplayPage` and the rest) moved here from amore-v2, where they
+ * navigated by route name and reported through the app's own analytics and Sentry. Routes stay the
+ * app's: the hooks call these instead, handing over the screen's own navigation when they run inside
+ * one, so a route can act on that screen (replace it, go back from it) as the app's code did.
+ *
+ * Pure: no React, no React Native, so the defaults load in plain Node for tests.
+ */
+import type { NavigationProp, ParamListBase } from '@react-navigation/native' with { 'resolution-mode': 'import' };
+import type { VariantPageParams } from './showCredit';
+/** The navigation of the screen a route is taken from (React Navigation's `useNavigation()`). */
+export type ScreenNavigation = NavigationProp<ParamListBase>;
+/** How the app's Sign In page signs in: sdk-shopify's `AuthMethod`, as `useSignIn` hands it over. */
+export type SignInPageMethod = 'password' | 'shopify';
+/**
+ * Where the live pages send the shopper. Each is the app's: the route names, the params, and whether
+ * a screen already in the stack is reused. The ones that take `navigation` are taken from inside a
+ * screen and get that screen's; the others are taken from outside the navigator (a bubble, the
+ * session's `onPipRestore`), where the app reaches its navigator through its own ref.
+ */
+export interface LiveSellingRoutes {
+    /**
+     * Back to the Live screen for this show: the one already in the stack (the screens above it close,
+     * the Cart included), else a new one. Never a second Live screen over the first: the engine holds
+     * one room, and two players would fight over its one picture. Taken by the live bubble's tap and
+     * by the phone's picture-in-picture window coming back to a show the Live screen shrank.
+     */
+    openLive(streamId: string): void;
+    /**
+     * Back to the Replay screen for this recording: the one already in the stack (the screens above it
+     * close), else a new one. Taken by the replay bubble's tap.
+     */
+    openReplay(feedId: string): void;
+    /** The Live screen's link named a show that has ended and has a recording: its Replay, in the Live screen's place. */
+    replaceWithReplay(feedId: string, navigation: ScreenNavigation): void;
+    /**
+     * The Live tab: the Live screen's back with nothing behind it (a link on a cold start), and a link to
+     * a show with nothing to play. Back to the tabs already in the stack, or in the Live screen's place.
+     */
+    backToLiveTab(navigation: ScreenNavigation): void;
+    /** Home: the Replay screen's close or picture-in-picture with nothing behind it, and its "no recording" button. */
+    openHome(navigation: ScreenNavigation): void;
+    /** The cart, over the show; `itemsYouWon` opens its Items You Won tab (an auction show's cart). */
+    openCart(options: {
+        itemsYouWon: boolean;
+    }, navigation: ScreenNavigation): void;
+    /** The variant page, drawn as a sheet over the playing show, with the show's credit. */
+    openVariantPage(params: VariantPageParams, navigation: ScreenNavigation): void;
+    /** The app's Sign In page (sdk-shopify's `useSignIn` `onOpenSignInPage`), for a bid or a giveaway entry. */
+    openSignIn(method: SignInPageMethod, navigation: ScreenNavigation): void;
+    /**
+     * The route names of the pages drawn as sheets over a show (amore-v2's: `VariantSelector` and
+     * `SignIn`). Under one the show plays on, with the screen kept on and the light status bar.
+     */
+    sheets: readonly string[];
+}
+/** The app's analytics `track`, for `liveJoin` and a show's copy of each add that lands. */
+export type LiveTrack = (name: string, properties: Record<string, unknown>) => void;
+/** A handled failure: a read that failed, an announcement that didn't go. The app's Sentry, say. */
+export type LiveWarning = (error: unknown, context: Record<string, unknown>) => void;
+/** What the page hooks read from `LiveSellingProvider`. */
+export interface LivePageOptions {
+    routes: LiveSellingRoutes;
+    track: LiveTrack;
+    /** The store's name, in the bidding rules. Unset: the bid bar's own words. */
+    shopName: string | undefined;
+}
+/** The provider's props the options are made from, any of them unset. */
+export interface LivePageOptionsInput {
+    routes?: LiveSellingRoutes | null;
+    track?: LiveTrack | null;
+    shopName?: string | null;
+}
+/** Without `onWarning`: the console, so a failure is never silent in development. */
+export declare const consoleWarning: LiveWarning;
+/**
+ * Where `reportLiveWarning` goes: the provider's `onWarning`, or the console when it has none. Module
+ * state rather than context, because the plain functions an app calls outside any screen
+ * (`announceAddToLiveRoom`, `reportShowAdd`) report too.
+ */
+export declare function setLiveWarningSink(sink: LiveWarning | null | undefined): void;
+/** Reports a handled failure to the app. Never throws: a report that fails must not fail the screen. */
+export declare function reportLiveWarning(error: unknown, context: Record<string, unknown>): void;
+/**
+ * The routes of a provider given none: each says so (`reportLiveWarning`) and goes nowhere, and no
+ * page counts as a sheet. A screen still draws; only its buttons that go somewhere do nothing.
+ */
+export declare const NO_ROUTES: LiveSellingRoutes;
+/**
+ * The page options, read from `latest` at the moment each is used, with their defaults: no routes
+ * (`NO_ROUTES`), no analytics, no store name. The routes and `track` keep one identity however often
+ * the app hands the provider new ones (an inline object, a hook's function), so a page hook can depend
+ * on them without its effects running again.
+ */
+export declare function pageOptionsReading(latest: () => LivePageOptionsInput): LivePageOptions;
+//# sourceMappingURL=pageOptions.d.ts.map

package/dist/pageOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pageOptions.d.ts","sourceRoot":"","sources":["../src/pageOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC,OAAO,iBAAiB,EAAE,QAAQ,EAAE,CAAC;AAEnH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,iGAAiG;AACjG,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;AAE7D,qGAAqG;AACrG,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,SAAS,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,sHAAsH;IACtH,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACtE;;;OAGG;IACH,aAAa,CAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAClD,mHAAmH;IACnH,QAAQ,CAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC7C,mGAAmG;IACnG,QAAQ,CAAC,OAAO,EAAE;QAAE,WAAW,EAAE,OAAO,CAAA;KAAE,EAAE,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChF,wFAAwF;IACxF,eAAe,CAAC,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC/E,4GAA4G;IAC5G,UAAU,CAAC,MAAM,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACzE;;;OAGG;IACH,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED,4FAA4F;AAC5F,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AAEpF,oGAAoG;AACpG,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AAErF,2DAA2D;AAC3D,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,EAAE,SAAS,CAAC;IACjB,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED,yEAAyE;AACzE,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAClC,KAAK,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,qFAAqF;AACrF,eAAO,MAAM,cAAc,EAAE,WAE5B,CAAC;AAIF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAE7E;AAED,wGAAwG;AACxG,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAMxF;AAOD;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,iBAUvB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,oBAAoB,GAAG,eAAe,CAwBtF"}

package/dist/pageOptions.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NO_ROUTES = exports.consoleWarning = void 0;
+exports.setLiveWarningSink = setLiveWarningSink;
+exports.reportLiveWarning = reportLiveWarning;
+exports.pageOptionsReading = pageOptionsReading;
+/** Without `onWarning`: the console, so a failure is never silent in development. */
+const consoleWarning = (error, context) => {
+    console.warn(error, context);
+};
+exports.consoleWarning = consoleWarning;
+let warningSink = exports.consoleWarning;
+/**
+ * Where `reportLiveWarning` goes: the provider's `onWarning`, or the console when it has none. Module
+ * state rather than context, because the plain functions an app calls outside any screen
+ * (`announceAddToLiveRoom`, `reportShowAdd`) report too.
+ */
+function setLiveWarningSink(sink) {
+    warningSink = sink !== null && sink !== void 0 ? sink : exports.consoleWarning;
+}
+/** Reports a handled failure to the app. Never throws: a report that fails must not fail the screen. */
+function reportLiveWarning(error, context) {
+    try {
+        warningSink(error, context);
+    }
+    catch {
+        // Nothing more to do: the report itself failed.
+    }
+}
+function goesNowhere(route) {
+    return () => reportLiveWarning(new Error(`LiveSellingProvider has no \`routes\`: ${route} goes nowhere`), { at: `routes.${route}` });
+}
+/**
+ * The routes of a provider given none: each says so (`reportLiveWarning`) and goes nowhere, and no
+ * page counts as a sheet. A screen still draws; only its buttons that go somewhere do nothing.
+ */
+exports.NO_ROUTES = {
+    openLive: goesNowhere('openLive'),
+    openReplay: goesNowhere('openReplay'),
+    replaceWithReplay: goesNowhere('replaceWithReplay'),
+    backToLiveTab: goesNowhere('backToLiveTab'),
+    openHome: goesNowhere('openHome'),
+    openCart: goesNowhere('openCart'),
+    openVariantPage: goesNowhere('openVariantPage'),
+    openSignIn: goesNowhere('openSignIn'),
+    sheets: [],
+};
+/**
+ * The page options, read from `latest` at the moment each is used, with their defaults: no routes
+ * (`NO_ROUTES`), no analytics, no store name. The routes and `track` keep one identity however often
+ * the app hands the provider new ones (an inline object, a hook's function), so a page hook can depend
+ * on them without its effects running again.
+ */
+function pageOptionsReading(latest) {
+    const routes = () => { var _a; return (_a = latest().routes) !== null && _a !== void 0 ? _a : exports.NO_ROUTES; };
+    return {
+        routes: {
+            openLive: (streamId) => routes().openLive(streamId),
+            openReplay: (feedId) => routes().openReplay(feedId),
+            replaceWithReplay: (feedId, navigation) => routes().replaceWithReplay(feedId, navigation),
+            backToLiveTab: (navigation) => routes().backToLiveTab(navigation),
+            openHome: (navigation) => routes().openHome(navigation),
+            openCart: (options, navigation) => routes().openCart(options, navigation),
+            openVariantPage: (params, navigation) => routes().openVariantPage(params, navigation),
+            openSignIn: (method, navigation) => routes().openSignIn(method, navigation),
+            get sheets() {
+                var _a;
+                return (_a = routes().sheets) !== null && _a !== void 0 ? _a : [];
+            },
+        },
+        track: (name, properties) => {
+            const track = latest().track;
+            if (track)
+                track(name, properties);
+        },
+        get shopName() {
+            var _a;
+            return (_a = latest().shopName) !== null && _a !== void 0 ? _a : undefined;
+        },
+    };
+}
+//# sourceMappingURL=pageOptions.js.map

package/dist/pageOptions.js.map

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

package/dist/pageTypes.d.ts

@@ -0,0 +1,127 @@
+/**
+ * What the live pages hand their tiles, ready to draw (0.14.0): the shapes amore-v2's Live and Replay
+ * tiles declared (`@/components/modules`), with the same names and fields, so a tile imports its
+ * props' parts from here and the page hook that fills them is the SDK's. Money is formatted by the
+ * hook; the words are the tile's.
+ *
+ * Types alone: sdk-shopify's `Product` is read for its type.
+ */
+import type { Product } from '@tiledev/sdk-shopify';
+/** The product the host is featuring, ready to draw (`LiveProductCard01`): the page formats the money. */
+export interface LiveFeaturedProduct {
+    id: string;
+    title: string;
+    /** Formatted ("$58.00"). */
+    price: string;
+    imageUrl?: string | null;
+    /** The lot's number, the one the host reads out ("104"). None: no badge. */
+    lotNumber?: string | null;
+    /** An auction lot's opening bid, formatted ("$20.00"). None on a live show. */
+    startingBid?: string | null;
+}
+/**
+ * Where the featured lot stands in its auction, ready to draw (`LiveProductCard01`; the page formats
+ * the money): bidding on it is open now, it has been won, or the host hasn't opened it yet.
+ */
+export interface LiveAuctionRound {
+    state: 'open' | 'closed' | 'upcoming';
+    /** The highest bid so far, formatted ("$45.00"). None before the first bid. */
+    highestBid: string | null;
+    /** Who holds it, as the room shows them (never an email). None before the first bid. */
+    leaderName: string | null;
+    /** The shopper holds it. */
+    leaderIsYou: boolean;
+}
+/** One lot on an auction show, ready to draw (`LiveShopButton01`): where bidding opens (formatted) and where it stands. */
+export interface LiveAuctionLot {
+    product: Product;
+    /** The host's opening bid ("$20.00"); none on a lot the host hasn't priced. */
+    startingBid: string | null;
+    /** Bidding on it is open now, it has been won, or the host hasn't opened it yet. */
+    state: 'open' | 'closed' | 'upcoming';
+}
+/** A round's winner, ready to draw (`LiveAuctionWin01`): the page formats the money and knows whether it is the shopper. */
+export interface LiveAuctionWinner {
+    /** Tells one win from the next: a new key plays the celebration again. */
+    key: string;
+    /** The winner's name as the room shows it (never an email). */
+    name: string;
+    /** The winning bid, formatted ("$45.00"). */
+    amount: string;
+    /** The shopper won: the celebration says "You". */
+    isYou: boolean;
+}
+/** What stands between the shopper and the bid they asked for (`LiveBidBar01`), in the order the bid gate asks. */
+export type LiveBidStep = 'terms' | 'unpaidWins' | 'variant';
+/**
+ * A bid that didn't go, and why (`LiveBidBar01`): the room moved past it or it is over the host's
+ * ceiling (the page didn't send it), or it was sent and didn't go through (`notSent`: no one to take
+ * it, or the send failed; decided 2026-10-06, Head of Engineering).
+ */
+export interface LiveBidRefusal {
+    /** A new number for each refusal, so the same reason twice shows twice. */
+    id: number;
+    reason: 'outbid' | 'overCap' | 'notSent';
+    /** The round's minimum now ("outbid"), the ceiling ("overCap"), or the bid itself ("notSent", not shown). */
+    amount: number;
+}
+/** One shopper's add to their cart, as the room announced it (`LiveCartChips01`). */
+export interface LiveCartChip {
+    id: string;
+    /** The shopper's first name, safe to show the room; none when the room doesn't know it. */
+    name?: string | null;
+    productTitle: string;
+    /** The lot's number ("104"), when the shopper's app sent one. */
+    lotNumber?: string | null;
+}
+/** One sale the host closed, as the room announced it (`LiveSoldChips01`). */
+export interface LiveSoldChip {
+    id: string;
+    /** How many were sold. */
+    quantity: number;
+    productName: string;
+    /** The lot's number ("104"), when the room's announcement carried one. */
+    lotNumber?: string | null;
+}
+/** The prize on offer, as the giveaway's sheet shows it (`LiveGiveawayButton01`), from its record and the catalogue. */
+export interface LiveGiveawayPrize {
+    /** The prize's name on the giveaway ("Flutter Sleeve Tie-Front Blouse"). */
+    productName: string;
+    /** The one variant given away ("Navy / XL"), or null. */
+    variantTitle: string | null;
+    /** What it costs in the store, formatted ("$22.00"), struck through beside FREE. Null: not known yet. */
+    retailPrice: string | null;
+    /** The variant's photo, else the product's, else the giveaway's own thumbnail. */
+    imageUrl: string | null;
+    /** The product's description from the catalogue, as plain text. Null until the catalogue answers, or none. */
+    description: string | null;
+}
+/** A name tapped in the chat, to reply to (`LiveCommentBox01`). A new `key` for every tap, so tapping the same name twice still puts it in. */
+export interface LiveCommentMention {
+    name: string;
+    key: number;
+}
+/** One recording in the feed, as the player draws it (`ReplayPlayer01`). */
+export interface ReplayShow {
+    id: string;
+    /** Shown until the video has its first picture, and while the show slides in. */
+    posterUrl?: string | null;
+}
+/** The product on screen, ready to draw (`ReplayNowCard01`): the page formats the price. */
+export interface ReplayNowProduct {
+    id: string;
+    title: string;
+    /** Formatted ("$58.00"). */
+    price: string;
+    imageUrl?: string | null;
+}
+/** One comment from the show's chat (`ReplayComments01`). */
+export interface ReplayCommentItem {
+    id: string;
+    /** The name it was said under. */
+    author: string;
+    text: string;
+    /** Said by the host: drawn under the tile's `hostName`. */
+    fromHost?: boolean;
+}
+//# sourceMappingURL=pageTypes.d.ts.map

package/dist/pageTypes.d.ts.map

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

package/dist/pageTypes.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=pageTypes.js.map

package/dist/pageTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pageTypes.js","sourceRoot":"","sources":["../src/pageTypes.ts"],"names":[],"mappings":""}

package/dist/react/LiveSellingProvider.d.ts

@@ -1,4 +1,5 @@
 import type { ReactNode } from 'react';
+import { type LivePageOptions, type LiveSellingRoutes, type LiveTrack, type LiveWarning } from '../pageOptions';
 import type { LiveEvent, LiveSellingClient, LiveSellingConfig } from '../types';
 export interface LiveSellingContextType {
     ready: boolean;
@@ -19,7 +20,28 @@ export interface LiveSellingProviderProps {
      * once. Only matters with `hiddenShows` set.
      */
     viewerEmail?: string | null;
+    /**
+     * Where the live pages send the shopper (0.14.0): the Live and Replay screens' hooks, the bubbles and
+     * the session's `onPipRestore` take these rather than naming the app's routes. Unset, each says so
+     * through `onWarning` and goes nowhere. Read at the moment each is taken, so an inline object is fine.
+     */
+    routes?: LiveSellingRoutes;
+    /** The app's analytics `track` (0.14.0): `liveJoin`, and a show's copy of each add that lands. Unset: nothing is sent. */
+    track?: LiveTrack;
+    /**
+     * Where a handled failure goes (0.14.0): a read the page carried on without, an announcement to the
+     * room that didn't go, a keep-awake that failed. The app's Sentry, say. Unset: `console.warn`.
+     */
+    onWarning?: LiveWarning;
+    /** The store's name, in the bidding rules (0.14.0); amore-v2 passed its `APP_NAME`. Unset: the bid bar's own words. */
+    shopName?: string;
 }
-export declare function LiveSellingProvider({ children, config, onEvent, viewerEmail }: LiveSellingProviderProps): import("react").FunctionComponentElement<import("react").ProviderProps<LiveSellingContextType | undefined>>;
+export declare function LiveSellingProvider({ children, config, onEvent, viewerEmail, routes, track, onWarning, shopName, }: LiveSellingProviderProps): import("react").FunctionComponentElement<import("react").ProviderProps<LiveSellingContextType | undefined>>;
 export declare function useLiveSelling(): LiveSellingContextType;
+/**
+ * What the live pages need from the app (0.14.0), as `LiveSellingProvider` was given it: `routes`,
+ * `track` and `shopName`, with their defaults outside a provider. The routes and `track` keep one
+ * identity, so an app's own screen can take the same routes the page hooks do.
+ */
+export declare function useLivePageOptions(): LivePageOptions;
 //# sourceMappingURL=LiveSellingProvider.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"LiveSellingProvider.d.ts","sourceRoot":"","sources":["../../src/react/LiveSellingProvider.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAEhF,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,kGAAkG;IAClG,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,iGAAiG;IACjG,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACrC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAID,wBAAgB,mBAAmB,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,wBAAwB,+GA8BvG;AAED,wBAAgB,cAAc,IAAI,sBAAsB,CAIvD"}
+{"version":3,"file":"LiveSellingProvider.d.ts","sourceRoot":"","sources":["../../src/react/LiveSellingProvider.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,WAAW,EACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAEhF,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,kGAAkG;IAClG,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,iGAAiG;IACjG,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACrC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;;;OAIG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,0HAA0H;IAC1H,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,uHAAuH;IACvH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAOD,wBAAgB,mBAAmB,CAAC,EAClC,QAAQ,EACR,MAAM,EACN,OAAO,EACP,WAAW,EACX,MAAM,EACN,KAAK,EACL,SAAS,EACT,QAAQ,GACT,EAAE,wBAAwB,+GAgD1B;AAED,wBAAgB,cAAc,IAAI,sBAAsB,CAIvD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAEpD"}

package/dist/react/LiveSellingProvider.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LiveSellingProvider = LiveSellingProvider;
 exports.useLiveSelling = useLiveSelling;
+exports.useLivePageOptions = useLivePageOptions;
 /**
  * `LiveSellingProvider` — configures the client once and exposes readiness + the client to the tree.
  *
@@ -14,13 +15,22 @@ exports.useLiveSelling = useLiveSelling;
  *
  * `viewerEmail` is who is watching, for the hidden shows (`config.hiddenShows`); `useHiddenShows`
  * (its own file) reads it with the rule for the hooks that hand out shows.
+ *
+ * `routes`, `track`, `onWarning` and `shopName` (0.14.0) are what the live pages need from the app
+ * (`pageOptions.ts`): the page hooks read them through `useLivePageOptions`, and the bubbles too.
  */
 const react_1 = require("react");
 const liveSelling_1 = require("../liveSelling");
+const pageOptions_1 = require("../pageOptions");
 const LiveSellingContext = (0, react_1.createContext)(undefined);
-function LiveSellingProvider({ children, config, onEvent, viewerEmail }) {
+/** The defaults, for a hook rendered without the provider: no routes, no analytics, no store name. */
+const LivePageOptionsContext = (0, react_1.createContext)((0, pageOptions_1.pageOptionsReading)(() => ({})));
+function LiveSellingProvider({ children, config, onEvent, viewerEmail, routes, track, onWarning, shopName, }) {
     const [ready, setReady] = (0, react_1.useState)(false);
     const [error, setError] = (0, react_1.useState)(null);
+    // Set as the provider draws rather than in an effect: the screens below run their effects first, and
+    // a failure reported there must reach the app's `onWarning`, not the console.
+    (0, pageOptions_1.setLiveWarningSink)(onWarning);
     (0, react_1.useEffect)(() => {
         try {
             liveSelling_1.liveSelling.configure(config);
@@ -42,7 +52,13 @@ function LiveSellingProvider({ children, config, onEvent, viewerEmail }) {
     }, [onEvent]);
     const email = (viewerEmail === null || viewerEmail === void 0 ? void 0 : viewerEmail.trim()) || null;
     const value = (0, react_1.useMemo)(() => ({ ready, error, client: liveSelling_1.liveSelling, viewerEmail: email }), [ready, error, email]);
-    return (0, react_1.createElement)(LiveSellingContext.Provider, { value }, children);
+    // The routes and `track` keep one identity for the provider's life, reading the latest props when
+    // taken, so the page hooks' effects don't run again each time the app draws.
+    const latestPageProps = (0, react_1.useRef)({ routes, track, shopName });
+    latestPageProps.current = { routes, track, shopName };
+    const stablePageOptions = (0, react_1.useMemo)(() => (0, pageOptions_1.pageOptionsReading)(() => latestPageProps.current), []);
+    const pageOptions = (0, react_1.useMemo)(() => ({ routes: stablePageOptions.routes, track: stablePageOptions.track, shopName: shopName !== null && shopName !== void 0 ? shopName : undefined }), [stablePageOptions, shopName]);
+    return (0, react_1.createElement)(LiveSellingContext.Provider, { value }, (0, react_1.createElement)(LivePageOptionsContext.Provider, { value: pageOptions }, children));
 }
 function useLiveSelling() {
     const ctx = (0, react_1.useContext)(LiveSellingContext);
@@ -50,4 +66,12 @@ function useLiveSelling() {
         throw new Error('useLiveSelling must be used within a LiveSellingProvider');
     return ctx;
 }
+/**
+ * What the live pages need from the app (0.14.0), as `LiveSellingProvider` was given it: `routes`,
+ * `track` and `shopName`, with their defaults outside a provider. The routes and `track` keep one
+ * identity, so an app's own screen can take the same routes the page hooks do.
+ */
+function useLivePageOptions() {
+    return (0, react_1.useContext)(LivePageOptionsContext);
+}
 //# sourceMappingURL=LiveSellingProvider.js.map

package/dist/react/LiveSellingProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"LiveSellingProvider.js","sourceRoot":"","sources":["../../src/react/LiveSellingProvider.ts"],"names":[],"mappings":";;AA2CA,kDA8BC;AAED,wCAIC;AA/ED;;;;;;;;;;;;GAYG;AACH,iCAA+F;AAG/F,gDAA6C;AAyB7C,MAAM,kBAAkB,GAAG,IAAA,qBAAa,EAAqC,SAAS,CAAC,CAAC;AAExF,SAAgB,mBAAmB,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAA4B;IACtG,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAgB,IAAI,CAAC,CAAC;IAExD,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,CAAC;YACH,yBAAW,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC9B,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,QAAQ,CAAC,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YACpE,mFAAmF;YACnF,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;QACD,yDAAyD;QACzD,uDAAuD;IACzD,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAEhE,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,OAAO,yBAAW,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,MAAM,KAAK,GAAG,CAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,IAAI,EAAE,KAAI,IAAI,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAA,eAAO,EACnB,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,yBAAW,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,EACjE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CACtB,CAAC;IAEF,OAAO,IAAA,qBAAa,EAAC,kBAAkB,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,QAAQ,CAAC,CAAC;AACzE,CAAC;AAED,SAAgB,cAAc;IAC5B,MAAM,GAAG,GAAG,IAAA,kBAAU,EAAC,kBAAkB,CAAC,CAAC;IAC3C,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IACtF,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"LiveSellingProvider.js","sourceRoot":"","sources":["../../src/react/LiveSellingProvider.ts"],"names":[],"mappings":"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"}

package/dist/react/index.d.ts

@@ -29,4 +29,14 @@ export { useAuctionWins, type AuctionWinRow, type UseAuctionWinsOptions, type Us
 export { useItemsYouWonPage, useLiveHubPage, useLiveRail } from './showPagesOnDevice';
 export { useItemsYouWonPageFor, useLiveHubPageFor, useLiveRailFor, SHOWS_PAGE_SIZE, type ItemsYouWonPage, type LiveHubPage, type LiveRail, type SessionForShowPages, type UseItemsYouWonPageOptions, type UseLiveHubPageOptions, } from './showPages';
 export { nativeViewTag } from '../nativeViewTag';
+export { useLivePageOptions } from './LiveSellingProvider';
+export { ShopifyLiveSellingProvider, ShopifyLiveSessionProvider, type ShopifyLiveSellingConfig, type ShopifyLiveSellingProviderProps, type ShopifyLiveSessionProviderProps, } from './shopifyProviders';
+export { ReplayPlayerProvider, useReplayPlayer, type ReplayPlayerState } from './replayPlayer';
+export { useKeepScreenAwake } from './useKeepScreenAwake';
+export { useLivePage, type LivePage } from './useLivePage';
+export { useLiveChat, type LiveChat, type LiveChatShow } from './useLiveChat';
+export { useLiveShop, shareProduct, shareAddress, type LiveShop } from './useLiveShop';
+export { useLiveAuction, type LiveAuction, type LiveAuctionScreen } from './useLiveAuction';
+export { useLiveGiveawaysAndPolls, type LiveGiveawaysAndPolls } from './useLiveGiveawaysAndPolls';
+export { useReplayPage, type ReplayPage } from './useReplayPage';
 //# sourceMappingURL=index.d.ts.map