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

package/dist/linkLots.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Whether a link can open inside the app: an https address. Plain `http:`, an email, a phone number,
+ * words or nothing: false, and the link is drawn as words, not something to tap. Where an https link
+ * goes is the app's (`LiveSellingProvider`'s `routes.openLink`).
+ */
+export declare function opensInApp(url: string | null | undefined): boolean;
+/** A link lot ready to draw: what the Live and Replay screens' link cards take (`LiveShopLink`, `ReplayShopLink`). */
+export interface ShowLink {
+    /** Says this item is a link, not a product. */
+    kind: 'link';
+    /** The lot's key on the show: its address when the host gave it no id. */
+    id: string;
+    title: string;
+    /** Formatted ("$45.00"); empty when the host gave no price. */
+    price: string;
+    imageUrl: string | null;
+    /**
+     * The page, when a tap can open it inside the app (an https address, and an app that opens links);
+     * null otherwise, and the card is words, not a button.
+     */
+    url: string | null;
+}
+/** What a link lot carries, from the session (`LiveProduct`) or the show's record (`LiveStreamProduct`). */
+export interface LinkLotFields {
+    id: string;
+    title: string;
+    /** The host's price, as the gateway sends it ("45.0"); none when unset. */
+    price: string | number | null | undefined;
+    /** The session leaves it null on a link lot: the shop's own currency then (`getCurrencyCode`). */
+    currencyCode?: string | null;
+    imageUrl?: string | null;
+    externalUrl?: string | null;
+}
+/** The host's price in the shop's currency ("$45.00"), or empty when there is none to show. */
+export declare function linkLotPrice(price: LinkLotFields['price'], currencyCode?: string | null): string;
+/**
+ * A link lot as its card draws it. `canOpen` false (an app that gave no `routes.openLink`): the address
+ * is kept from the card, so it is words, as for a link that isn't https.
+ */
+export declare function showLinkOf(lot: LinkLotFields, { canOpen }?: {
+    canOpen?: boolean;
+}): ShowLink;
+/** A lot on a show's record (`LiveStreamProduct`), as far as a recording's shop reads it. */
+export interface RecordLot {
+    storeProductId: string;
+    name: string;
+    price: string | number | null;
+    thumbnailUrl: string | null;
+    externalUrl?: string | null;
+}
+/**
+ * A recording's shop in the host's order (amore-v2, 2026-10-19): the show's record lists every lot, the
+ * links the host added among the products, so a link takes its place there and a product is found by
+ * its id (`productGidOf` the lot's). Products the record doesn't list (the replay feed's own list) follow
+ * in the feed's order. With no record (it couldn't be read) the products alone, as before.
+ */
+export declare function recordingShopItems<Item extends {
+    id: string;
+}>(products: readonly Item[], recordLots: readonly RecordLot[] | null, productGidOf: (storeProductId: string) => string, { canOpen }?: {
+    canOpen?: boolean;
+}): (Item | ShowLink)[];
+/** An item of a show's shop that is a link the host added, not a product. */
+export declare function isShowLink<Item extends object>(item: Item | ShowLink): item is ShowLink;
+//# sourceMappingURL=linkLots.d.ts.map

package/dist/linkLots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linkLots.d.ts","sourceRoot":"","sources":["../src/linkLots.ts"],"names":[],"mappings":"AAiBA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAElE;AAED,sHAAsH;AACtH,MAAM,WAAW,QAAQ;IACvB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;;OAGG;IACH,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,4GAA4G;AAC5G,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1C,kGAAkG;IAClG,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,+FAA+F;AAC/F,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAKhG;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,aAAa,EAAE,EAAE,OAAc,EAAE,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,QAAQ,CAUvG;AAED,6FAA6F;AAC7F,MAAM,WAAW,SAAS;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAC5D,QAAQ,EAAE,SAAS,IAAI,EAAE,EACzB,UAAU,EAAE,SAAS,SAAS,EAAE,GAAG,IAAI,EACvC,YAAY,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,MAAM,EAChD,EAAE,OAAc,EAAE,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAC7C,CAAC,IAAI,GAAG,QAAQ,CAAC,EAAE,CAqBrB;AAED,6EAA6E;AAC7E,wBAAgB,UAAU,CAAC,IAAI,SAAS,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,QAAQ,GAAG,IAAI,IAAI,QAAQ,CAEvF"}

package/dist/linkLots.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.opensInApp = opensInApp;
+exports.linkLotPrice = linkLotPrice;
+exports.showLinkOf = showLinkOf;
+exports.recordingShopItems = recordingShopItems;
+exports.isShowLink = isShowLink;
+/**
+ * Link lots (0.15.0, moved from amore-v2's `src/core/utils/linkLots.ts` and the https rule of its
+ * `screenForLink`): a lot the host added as a web address (`product_type: "url"`) rather than a product
+ * of the store, mostly an affiliate link. The session hands them over among its products, in the host's
+ * order, with a title, a price, a photo and the address (`LiveProduct.externalUrl`), no sizes and no
+ * catalogue product (`raw`); a show's record has the same (`LiveStreamProduct.externalUrl`). One store's
+ * last 80 shows had 305 of 1,803 lots as links (17%), every one https and priced. They are opened, never
+ * bought: no Add to Cart, no favourite.
+ *
+ * Free of React and React Native, so it loads in plain Node for tests; the price is sdk-shopify's
+ * `formatMoney` in the shop's currency (`getCurrencyCode`), plain functions.
+ */
+const sdk_shopify_1 = require("@tiledev/sdk-shopify");
+/** An https address with a host and no spaces: the only kind of link that opens anything (an app's web page loads https only). */
+const HTTPS_ADDRESS = /^https:\/\/[^\s/?#]+\S*$/i;
+/**
+ * Whether a link can open inside the app: an https address. Plain `http:`, an email, a phone number,
+ * words or nothing: false, and the link is drawn as words, not something to tap. Where an https link
+ * goes is the app's (`LiveSellingProvider`'s `routes.openLink`).
+ */
+function opensInApp(url) {
+    return typeof url === 'string' && HTTPS_ADDRESS.test(url.trim());
+}
+/** The host's price in the shop's currency ("$45.00"), or empty when there is none to show. */
+function linkLotPrice(price, currencyCode) {
+    if (price === null || price === undefined || price === '')
+        return '';
+    const amount = Number(price);
+    if (!Number.isFinite(amount))
+        return '';
+    return (0, sdk_shopify_1.formatMoney)({ amount: String(amount), currencyCode: currencyCode || (0, sdk_shopify_1.getCurrencyCode)() || 'USD' });
+}
+/**
+ * A link lot as its card draws it. `canOpen` false (an app that gave no `routes.openLink`): the address
+ * is kept from the card, so it is words, as for a link that isn't https.
+ */
+function showLinkOf(lot, { canOpen = true } = {}) {
+    var _a;
+    const address = typeof lot.externalUrl === 'string' ? lot.externalUrl.trim() : '';
+    return {
+        kind: 'link',
+        id: lot.id,
+        title: lot.title,
+        price: linkLotPrice(lot.price, lot.currencyCode),
+        imageUrl: (_a = lot.imageUrl) !== null && _a !== void 0 ? _a : null,
+        url: canOpen && opensInApp(address) ? address : null,
+    };
+}
+/**
+ * A recording's shop in the host's order (amore-v2, 2026-10-19): the show's record lists every lot, the
+ * links the host added among the products, so a link takes its place there and a product is found by
+ * its id (`productGidOf` the lot's). Products the record doesn't list (the replay feed's own list) follow
+ * in the feed's order. With no record (it couldn't be read) the products alone, as before.
+ */
+function recordingShopItems(products, recordLots, productGidOf, { canOpen = true } = {}) {
+    if (!recordLots)
+        return [...products];
+    const placed = new Set();
+    const inOrder = [];
+    for (const lot of recordLots) {
+        if (lot.externalUrl) {
+            inOrder.push(showLinkOf({ id: lot.storeProductId, title: lot.name, price: lot.price, imageUrl: lot.thumbnailUrl, externalUrl: lot.externalUrl }, { canOpen }));
+            continue;
+        }
+        const product = products.find((item) => item.id === productGidOf(lot.storeProductId));
+        if (product && !placed.has(product.id)) {
+            placed.add(product.id);
+            inOrder.push(product);
+        }
+    }
+    return [...inOrder, ...products.filter((item) => !placed.has(item.id))];
+}
+/** An item of a show's shop that is a link the host added, not a product. */
+function isShowLink(item) {
+    return item.kind === 'link';
+}
+//# sourceMappingURL=linkLots.js.map

package/dist/linkLots.js.map

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

package/dist/livePages.d.ts

@@ -0,0 +1,166 @@
+/**
+ * The rules behind the Live and Replay page models (0.14.0, moved from amore-v2's `useLivePage`,
+ * `useLiveChat` and `useReplayPage`): which navigation is a back press, when a sheet leaves the show
+ * playing, who the chat asks for a name, and what a recording shows at a point of its playhead.
+ *
+ * Pure, so it loads in plain Node for tests (sdk-shopify's `cartLineFacts` is a plain function). The
+ * hooks (`react/useLivePage.ts` and the rest) apply them.
+ */
+import { type Cart, type CartExtension } from '@tiledev/sdk-shopify';
+import type { NameOnAccount, ReplayCommentItem } from './pageTypes';
+import type { Replay, ReplayComment, ReplaySegment } from './types';
+/**
+ * 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.
+ */
+export declare const BACK_ACTIONS: ReadonlySet<string>;
+/** A navigator's state, as far as `isCoveredOnlyBySheet` reads it (React Navigation's has it). */
+export interface StackStateForSheets {
+    index: number;
+    routes: readonly {
+        key: string;
+        name: string;
+    }[];
+}
+/**
+ * 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.
+ */
+export declare function isCoveredOnlyBySheet(state: StackStateForSheets | null | undefined, screenKey: string, sheets: readonly string[]): boolean;
+/** Who the shopper is in the room, as far as the chat's name ask reads it. */
+export interface ChatNameInput {
+    /** The room has a name for the shopper (`session.viewerName`). */
+    named: boolean;
+    /** sdk-shopify's `useCustomer().loggedIn`. */
+    loggedIn: boolean;
+    /** A stored sign-in is still being read on app open (`useCustomer().restoring`). */
+    restoring: boolean;
+    /** The signed-in shopper's account has been read (`useCustomer().customer`). */
+    hasCustomer: boolean;
+}
+/**
+ * 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.
+ */
+export declare function chatNameAsk({ named, loggedIn, restoring, hasCustomer }: ChatNameInput): {
+    askForName: boolean;
+    waitingForName: boolean;
+};
+/**
+ * A cart with no holds: one list, so the header isn't handed a new one on every draw. A plain array, as
+ * the header tile types it (`holdEndTimes?: number[]`); never change it.
+ */
+export declare const NO_HOLDS: number[];
+/**
+ * When each of the cart's holds ends (0.15.0, amore-v2's ENG-691), for the Live header's timer under the
+ * cart button: each line's reservation as the Cart reads it (sdk-shopify's `cartLineFacts` over the
+ * provider's `cartExtensions`: Cart Hold's stamp). A giveaway prize and a service line have none, nor
+ * does a line Cart Hold never held. Every end, not only the soonest: the Live screen doesn't read the
+ * cart again when a hold runs out, so the soonest worked out here would stay on a hold that has ended;
+ * the header picks the soonest still running as it counts. `NO_HOLDS` when there are none.
+ */
+export declare function holdEndTimesOf(cart: Cart | null | undefined, extensions: readonly CartExtension[]): number[];
+/** The signed-in shopper's account, as far as the name asks read it (sdk-shopify's `useCustomer()`). */
+export interface AccountForNames {
+    loggedIn: boolean;
+    /** A stored sign-in is still being read on app open. */
+    restoring?: boolean;
+    customer: {
+        firstName?: string | null;
+        lastName?: string | null;
+    } | null | undefined;
+}
+/**
+ * Signed in, the account not read yet (a stored sign-in on app open, or a moment after signing in, with
+ * the session and no profile): what to ask isn't known, so Send and Enter wait.
+ */
+export declare function accountLoadingOf({ loggedIn, restoring, customer }: AccountForNames): boolean;
+/**
+ * The name a signed-in shopper's account needs (0.15.0, amore-v2's ENG-686): read, and with no first
+ * name (blank, or only spaces) or with a name the show's team goes by. What it has, each part trimmed,
+ * for the ask to start from (a last name already there needn't be typed again). Null when it has a
+ * first name, while it loads, and when signed out (a guest's name stays on the phone).
+ */
+export declare function accountNameToComplete(account: AccountForNames, blockedNames: readonly string[]): NameOnAccount | null;
+/**
+ * A typed name as it goes on the account: each part's spaces closed up and trimmed, and the whole name
+ * ("Jane Doe", or "Jane" with no last name). Null with no first name, or a name the show's team goes by:
+ * nothing is saved.
+ */
+export declare function tidyAccountName(typedFirstName: string, typedLastName: string, blockedNames: readonly string[]): {
+    firstName: string;
+    lastName: string;
+    fullName: string;
+} | null;
+/**
+ * What the comment box does about the shopper's name since 0.15.0 (amore-v2's ENG-686), beside
+ * `chatNameAsk`, 0.14.0's rule, which is unchanged:
+ *
+ * - **Ask** (`askForName`) a signed-in shopper whose account needs a name (`accountNameToComplete`):
+ *   a first and a last name, saved to the account; and a signed-out shopper the room has no name for,
+ *   saved on this phone.
+ * - **Wait** (`waitingForName`) while the account loads: Send is held, so nothing goes out as
+ *   "Anonymous".
+ */
+export declare function accountNameAsk({ named, loggedIn, restoring, accountLoading, nameToComplete, }: {
+    /** The room has a name for the shopper (`session.viewerName`). */
+    named: boolean;
+    loggedIn: boolean;
+    restoring: boolean;
+    accountLoading: boolean;
+    nameToComplete: NameOnAccount | null;
+}): {
+    askForName: boolean;
+    waitingForName: boolean;
+};
+/**
+ * What a giveaway's "Entering As:" does about the shopper's name (entering needs a sign-in): ask a
+ * signed-in shopper whose account needs a name, or whom the room has no name for once their profile has
+ * arrived; wait while the account loads.
+ */
+export declare function giveawayNameAsk({ named, loggedIn, hasCustomer, accountLoading, nameToComplete, }: {
+    named: boolean;
+    loggedIn: boolean;
+    hasCustomer: boolean;
+    accountLoading: boolean;
+    nameToComplete: NameOnAccount | null;
+}): {
+    askForName: boolean;
+    waitingForName: boolean;
+};
+/** A card passes the recording's feed id; a push passes its show's streaming id. Both find it. */
+export declare function isTheShow(replay: Pick<Replay, 'id' | 'streamingId'>, id: string): boolean;
+/** A time or length from the player, in seconds, as milliseconds; 0 when it has none yet. */
+export declare function playerMs(seconds: number): number;
+/**
+ * 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. Since 0.15.0 the items
+ * can be a recording's shop, links among the products (`windowKeyOf`).
+ */
+export declare function productOnScreen<Item extends {
+    id: string;
+}>(segments: readonly ReplaySegment[], products: readonly Item[], atMs: number, 
+/** The key a window names an item by (0.15.0): a product's id, or a link lot's as a product GID. */
+windowKeyOf?: (item: Item) => string): Item | null;
+/** Where the host first showed a product, or null for one they never did (tagged, with no time window). */
+export declare function firstShownAt(segments: readonly ReplaySegment[], productId: string): number | null;
+/** Comments kept in the replay's chat pane: the newest of what has been said so far. */
+export declare const 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.
+ */
+export declare function replayCommentsAt(comments: readonly ReplayComment[], atMs: number, shown?: number): ReplayCommentItem[];
+//# sourceMappingURL=livePages.d.ts.map

package/dist/livePages.d.ts.map

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

package/dist/livePages.js

@@ -0,0 +1,187 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REPLAY_COMMENTS_SHOWN = exports.NO_HOLDS = exports.BACK_ACTIONS = void 0;
+exports.isCoveredOnlyBySheet = isCoveredOnlyBySheet;
+exports.chatNameAsk = chatNameAsk;
+exports.holdEndTimesOf = holdEndTimesOf;
+exports.accountLoadingOf = accountLoadingOf;
+exports.accountNameToComplete = accountNameToComplete;
+exports.tidyAccountName = tidyAccountName;
+exports.accountNameAsk = accountNameAsk;
+exports.giveawayNameAsk = giveawayNameAsk;
+exports.isTheShow = isTheShow;
+exports.playerMs = playerMs;
+exports.productOnScreen = productOnScreen;
+exports.firstShownAt = firstShownAt;
+exports.replayCommentsAt = replayCommentsAt;
+/**
+ * The rules behind the Live and Replay page models (0.14.0, moved from amore-v2's `useLivePage`,
+ * `useLiveChat` and `useReplayPage`): which navigation is a back press, when a sheet leaves the show
+ * playing, who the chat asks for a name, and what a recording shows at a point of its playhead.
+ *
+ * Pure, so it loads in plain Node for tests (sdk-shopify's `cartLineFacts` is a plain function). The
+ * hooks (`react/useLivePage.ts` and the rest) apply them.
+ */
+const sdk_shopify_1 = require("@tiledev/sdk-shopify");
+const showNames_1 = require("./showNames");
+// ─── 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 };
+}
+/**
+ * A cart with no holds: one list, so the header isn't handed a new one on every draw. A plain array, as
+ * the header tile types it (`holdEndTimes?: number[]`); never change it.
+ */
+exports.NO_HOLDS = [];
+/**
+ * When each of the cart's holds ends (0.15.0, amore-v2's ENG-691), for the Live header's timer under the
+ * cart button: each line's reservation as the Cart reads it (sdk-shopify's `cartLineFacts` over the
+ * provider's `cartExtensions`: Cart Hold's stamp). A giveaway prize and a service line have none, nor
+ * does a line Cart Hold never held. Every end, not only the soonest: the Live screen doesn't read the
+ * cart again when a hold runs out, so the soonest worked out here would stay on a hold that has ended;
+ * the header picks the soonest still running as it counts. `NO_HOLDS` when there are none.
+ */
+function holdEndTimesOf(cart, extensions) {
+    if (!cart)
+        return exports.NO_HOLDS;
+    const ends = cart.lines
+        .map((line) => (0, sdk_shopify_1.cartLineFacts)(line, cart, extensions).holdExpiresAt)
+        .filter((end) => end !== null && end !== undefined);
+    return ends.length > 0 ? ends : exports.NO_HOLDS;
+}
+/**
+ * Signed in, the account not read yet (a stored sign-in on app open, or a moment after signing in, with
+ * the session and no profile): what to ask isn't known, so Send and Enter wait.
+ */
+function accountLoadingOf({ loggedIn, restoring, customer }) {
+    return !!restoring || (!!loggedIn && !customer);
+}
+/**
+ * The name a signed-in shopper's account needs (0.15.0, amore-v2's ENG-686): read, and with no first
+ * name (blank, or only spaces) or with a name the show's team goes by. What it has, each part trimmed,
+ * for the ask to start from (a last name already there needn't be typed again). Null when it has a
+ * first name, while it loads, and when signed out (a guest's name stays on the phone).
+ */
+function accountNameToComplete(account, blockedNames) {
+    var _a, _b, _c, _d, _e, _f;
+    if (!account.loggedIn || accountLoadingOf(account))
+        return null;
+    const firstName = (_c = (_b = (_a = account.customer) === null || _a === void 0 ? void 0 : _a.firstName) === null || _b === void 0 ? void 0 : _b.trim()) !== null && _c !== void 0 ? _c : '';
+    const lastName = (_f = (_e = (_d = account.customer) === null || _d === void 0 ? void 0 : _d.lastName) === null || _e === void 0 ? void 0 : _e.trim()) !== null && _f !== void 0 ? _f : '';
+    const needsAName = !firstName || (0, showNames_1.isBlockedViewerName)(`${firstName} ${lastName}`, blockedNames);
+    return needsAName ? { firstName, lastName } : null;
+}
+/**
+ * A typed name as it goes on the account: each part's spaces closed up and trimmed, and the whole name
+ * ("Jane Doe", or "Jane" with no last name). Null with no first name, or a name the show's team goes by:
+ * nothing is saved.
+ */
+function tidyAccountName(typedFirstName, typedLastName, blockedNames) {
+    const firstName = typedFirstName.replace(/\s+/g, ' ').trim();
+    const lastName = typedLastName.replace(/\s+/g, ' ').trim();
+    const fullName = lastName ? `${firstName} ${lastName}` : firstName;
+    if (!firstName || (0, showNames_1.isBlockedViewerName)(fullName, blockedNames))
+        return null;
+    return { firstName, lastName, fullName };
+}
+/**
+ * What the comment box does about the shopper's name since 0.15.0 (amore-v2's ENG-686), beside
+ * `chatNameAsk`, 0.14.0's rule, which is unchanged:
+ *
+ * - **Ask** (`askForName`) a signed-in shopper whose account needs a name (`accountNameToComplete`):
+ *   a first and a last name, saved to the account; and a signed-out shopper the room has no name for,
+ *   saved on this phone.
+ * - **Wait** (`waitingForName`) while the account loads: Send is held, so nothing goes out as
+ *   "Anonymous".
+ */
+function accountNameAsk({ named, loggedIn, restoring, accountLoading, nameToComplete, }) {
+    const signedIn = loggedIn || restoring;
+    return { askForName: !!nameToComplete || (!named && !signedIn), waitingForName: accountLoading };
+}
+/**
+ * What a giveaway's "Entering As:" does about the shopper's name (entering needs a sign-in): ask a
+ * signed-in shopper whose account needs a name, or whom the room has no name for once their profile has
+ * arrived; wait while the account loads.
+ */
+function giveawayNameAsk({ named, loggedIn, hasCustomer, accountLoading, nameToComplete, }) {
+    return { askForName: !!nameToComplete || (loggedIn && !named && hasCustomer), waitingForName: 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. Since 0.15.0 the items
+ * can be a recording's shop, links among the products (`windowKeyOf`).
+ */
+function productOnScreen(segments, products, atMs, 
+/** The key a window names an item by (0.15.0): a product's id, or a link lot's as a product GID. */
+windowKeyOf = (item) => item.id) {
+    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) => windowKeyOf(product) === 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":";;;AAmCA,oDASC;AAyBD,kCAOC;AAgBD,wCAMC;AAgBD,4CAEC;AAQD,sDAMC;AAOD,0CAUC;AAYD,wCAgBC;AAOD,0CAcC;AAKD,8BAEC;AAGD,4BAEC;AAQD,0CAUC;AAGD,oCAEC;AAUD,4CAaC;AA9PD;;;;;;;GAOG;AACH,sDAAoF;AAGpF,2CAAkD;AAGlD,iFAAiF;AAEjF;;;;;GAKG;AACU,QAAA,YAAY,GAAwB,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;AAQrG;;;;GAIG;AACH,SAAgB,oBAAoB,CAClC,KAA6C,EAC7C,SAAiB,EACjB,MAAyB;IAEzB,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAC5C,OAAO,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,GAAG,MAAK,SAAS,CAAC;AACxE,CAAC;AAcD;;;;;;;;;;GAUG;AACH,SAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAiB;IAIpF,mFAAmF;IACnF,MAAM,cAAc,GAAG,SAAS,IAAI,CAAC,QAAQ,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/D,OAAO,EAAE,UAAU,EAAE,CAAC,KAAK,IAAI,CAAC,cAAc,EAAE,cAAc,EAAE,CAAC,KAAK,IAAI,cAAc,EAAE,CAAC;AAC7F,CAAC;AAED;;;GAGG;AACU,QAAA,QAAQ,GAAa,EAAE,CAAC;AAErC;;;;;;;GAOG;AACH,SAAgB,cAAc,CAAC,IAA6B,EAAE,UAAoC;IAChG,IAAI,CAAC,IAAI;QAAE,OAAO,gBAAQ,CAAC;IAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK;SACpB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,2BAAa,EAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,aAAa,CAAC;SAClE,MAAM,CAAC,CAAC,GAAG,EAAiB,EAAE,CAAC,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,CAAC,CAAC;IACrE,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAQ,CAAC;AAC3C,CAAC;AAYD;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAmB;IACjF,OAAO,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,qBAAqB,CAAC,OAAwB,EAAE,YAA+B;;IAC7F,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,gBAAgB,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAChE,MAAM,SAAS,GAAG,MAAA,MAAA,MAAA,OAAO,CAAC,QAAQ,0CAAE,SAAS,0CAAE,IAAI,EAAE,mCAAI,EAAE,CAAC;IAC5D,MAAM,QAAQ,GAAG,MAAA,MAAA,MAAA,OAAO,CAAC,QAAQ,0CAAE,QAAQ,0CAAE,IAAI,EAAE,mCAAI,EAAE,CAAC;IAC1D,MAAM,UAAU,GAAG,CAAC,SAAS,IAAI,IAAA,+BAAmB,EAAC,GAAG,SAAS,IAAI,QAAQ,EAAE,EAAE,YAAY,CAAC,CAAC;IAC/F,OAAO,UAAU,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,SAAgB,eAAe,CAC7B,cAAsB,EACtB,aAAqB,EACrB,YAA+B;IAE/B,MAAM,SAAS,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7D,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3D,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACnE,IAAI,CAAC,SAAS,IAAI,IAAA,+BAAmB,EAAC,QAAQ,EAAE,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3E,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAC3C,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,QAAQ,EACR,SAAS,EACT,cAAc,EACd,cAAc,GAQf;IACC,MAAM,QAAQ,GAAG,QAAQ,IAAI,SAAS,CAAC;IACvC,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;AACnG,CAAC;AAED;;;;GAIG;AACH,SAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,QAAQ,EACR,WAAW,EACX,cAAc,EACd,cAAc,GAOf;IACC,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC,cAAc,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,IAAI,WAAW,CAAC,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;AACjH,CAAC;AAED,iFAAiF;AAEjF,kGAAkG;AAClG,SAAgB,SAAS,CAAC,MAA0C,EAAE,EAAU;IAC9E,OAAO,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,MAAM,CAAC,WAAW,KAAK,EAAE,CAAC;AACvD,CAAC;AAED,6FAA6F;AAC7F,SAAgB,QAAQ,CAAC,OAAe;IACtC,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACtE,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAC7B,QAAkC,EAClC,QAAyB,EACzB,IAAY;AACZ,oGAAoG;AACpG,cAAsC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE;;IAEvD,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,IAAI,OAAO,CAAC,OAAO,IAAI,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;IAChG,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;IACpF,OAAO,MAAA,MAAA,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,mCAAI,QAAQ,CAAC,CAAC,CAAC,mCAAI,IAAI,CAAC;AACzH,CAAC;AAED,2GAA2G;AAC3G,SAAgB,YAAY,CAAC,QAAkC,EAAE,SAAiB;;IAChF,OAAO,MAAA,MAAA,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,0CAAE,OAAO,mCAAI,IAAI,CAAC;AACvF,CAAC;AAED,wFAAwF;AAC3E,QAAA,qBAAqB,GAAG,EAAE,CAAC;AAExC;;;;GAIG;AACH,SAAgB,gBAAgB,CAC9B,QAAkC,EAClC,IAAY,EACZ,QAAgB,6BAAqB;IAErC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,OAAO,IAAI,GAAG,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI;QAAE,IAAI,IAAI,CAAC,CAAC;IACxE,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAC3E,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,MAAM,EAAE,OAAO,CAAC,QAAQ;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,OAAO,CAAC,MAAM,KAAK,MAAM,IAAI,OAAO,CAAC,QAAQ,KAAK,KAAK;KAClE,CAAC,CAAC,CAAC;AACN,CAAC"}

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"}