@tiledev/sdk-apptile-live-selling 0.8.0 → 0.9.0

package/dist/streams.d.ts.map

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

package/dist/streams.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.streams = void 0;
+exports.winnerIdOf = winnerIdOf;
 exports.toLiveStreamProduct = toLiveStreamProduct;
 exports.toGiveawayEntries = toGiveawayEntries;
 exports.toLiveGiveaway = toLiveGiveaway;
@@ -14,7 +15,12 @@ exports.toLiveStreams = toLiveStreams;
  * "misconfigured".
  */
 const client_1 = require("./client");
+const commentHistory_1 = require("./commentHistory");
 const polls_1 = require("./polls");
+const wire_1 = require("./wire");
+const hiddenShows_1 = require("./hiddenShows");
+const showNames_1 = require("./showNames");
+const showLinks_1 = require("./showLinks");
 // ─── Mappers ─────────────────────────────────────────────────────────────────
 function toStatus(status) {
     if (status === 2)
@@ -26,6 +32,29 @@ function toStatus(status) {
 function toMillis(unix) {
     return unix ? unix * 1000 : null;
 }
+/**
+ * The winner's bare customer id from the record's `winner`: the number at the end of a GID, or a bare
+ * number. Anything else (`"No One Joined"`, absent) is no winner.
+ */
+function winnerIdOf(winner) {
+    var _a;
+    if (typeof winner !== 'string')
+        return null;
+    const trimmed = winner.trim();
+    const fromGid = /^gid:\/\/[^/]+\/[^/]+\/([^/\s]+)$/.exec(trimmed);
+    if (fromGid)
+        return (_a = fromGid[1]) !== null && _a !== void 0 ? _a : null;
+    return /^\d+$/.test(trimmed) ? trimmed : null;
+}
+/** An ISO time (or epoch ms) as epoch ms; null when missing or unreadable. */
+function toEpochMs(value) {
+    if (typeof value === 'number')
+        return Number.isFinite(value) && value > 0 ? value : null;
+    if (typeof value !== 'string' || !value.trim())
+        return null;
+    const ms = Date.parse(value);
+    return Number.isFinite(ms) ? ms : null;
+}
 /** Numbers arrive as strings on some dashboard fields; anything unparseable is "not set". */
 function toAmount(value) {
     if (value === null || value === undefined || value === '')
@@ -33,19 +62,6 @@ function toAmount(value) {
     const parsed = Number(value);
     return Number.isFinite(parsed) ? parsed : null;
 }
-/**
- * The lot's thumbnail, whichever way the gateway spelled it.
- *
- * A catalogue lot carries `{ url }`; a link lot carries the URL as a plain string — the same
- * inconsistency the giveaway mapper below already had to absorb. Reading only `.url` left every
- * link lot with a blank square where its picture should be.
- */
-function toThumbnailUrl(value) {
-    var _a;
-    if (!value)
-        return null;
-    return typeof value === 'string' ? value : ((_a = value.url) !== null && _a !== void 0 ? _a : null);
-}
 function toLiveStreamProduct(raw) {
     var _a, _b, _c, _d, _e, _f, _g, _h;
     /*
@@ -62,7 +78,9 @@ function toLiveStreamProduct(raw) {
         productGid: `gid://shopify/Product/${storeProductId}`,
         name: (_d = raw.product_name) !== null && _d !== void 0 ? _d : '',
         price: (_e = raw.product_price) !== null && _e !== void 0 ? _e : null,
-        thumbnailUrl: toThumbnailUrl(raw.product_thumbnail),
+        /* A catalogue lot carries `{ url }`, a link lot a plain string. Reading only `.url` left every
+           link lot with a blank square where its picture should be. */
+        thumbnailUrl: (0, wire_1.imageUrl)(raw.product_thumbnail),
         isCurrent: !!raw.is_current,
         /* `sell_id` on the wire. A string on the gateway even though it reads as a number, so it is
            carried through as one rather than coerced — a leading zero is meaningful to a host reading
@@ -70,6 +88,7 @@ function toLiveStreamProduct(raw) {
         sellId: raw.sell_id != null ? String(raw.sell_id) : null,
         startedAtMs: (_f = raw.start_time) !== null && _f !== void 0 ? _f : null,
         baseBidPrice: toAmount(raw.base_bid_price),
+        bidIncrement: toAmount(raw.bid_incrementer),
         winnerCount: (_h = (_g = raw.auction_winner) === null || _g === void 0 ? void 0 : _g.length) !== null && _h !== void 0 ? _h : 0,
         externalUrl,
     };
@@ -101,17 +120,24 @@ function toLiveGiveaway(raw, meta) {
     const storeProductId = raw.store_product_id;
     if (!storeProductId)
         return null;
-    const price = toAmount(raw.product_variant_price);
+    /* `variant_price` is what the gateway writes; 0.9.0 read only `product_variant_price`, which no
+       record has, so the price was always null. */
+    const price = (_a = toAmount(raw.variant_price)) !== null && _a !== void 0 ? _a : toAmount(raw.product_variant_price);
     return {
         storeProductId,
-        variantId: (_a = raw.variant_id) !== null && _a !== void 0 ? _a : null,
+        variantId: (_b = raw.variant_id) !== null && _b !== void 0 ? _b : null,
         status: raw.giveawayStatus === 'active' ? 'active' : 'ended',
-        productName: (_b = raw.product_name) !== null && _b !== void 0 ? _b : '',
-        thumbnailUrl: (_c = raw.product_thumbnail) !== null && _c !== void 0 ? _c : null,
+        productName: (_c = raw.product_name) !== null && _c !== void 0 ? _c : '',
+        /* Passed through raw before 0.9.0, so an object arrived typed as a string. */
+        thumbnailUrl: (0, wire_1.imageUrl)(raw.product_thumbnail),
         variantTitle: (_d = raw.product_variant_title) !== null && _d !== void 0 ? _d : null,
         variantPrice: price === null ? null : String(price),
+        variantImageUrl: (0, wire_1.imageUrl)(raw.variant_image),
+        startedAtMs: toEpochMs(raw.giveawayStartTime),
+        winnerId: winnerIdOf(raw.winner),
+        // Names the room will show: never an email (`publicName`).
         entrantNames: ((_e = raw.users) !== null && _e !== void 0 ? _e : [])
-            .map((user) => { var _a; return (_a = user === null || user === void 0 ? void 0 : user.displayName) !== null && _a !== void 0 ? _a : ''; })
+            .map((user) => { var _a; return (_a = (0, showNames_1.publicName)(user === null || user === void 0 ? void 0 : user.displayName)) !== null && _a !== void 0 ? _a : ''; })
             .filter((name) => !!name),
         entries: toGiveawayEntries(meta, storeProductId),
     };
@@ -129,8 +155,13 @@ function toMutedDeviceIds(raw) {
         .map((entry) => entry === null || entry === void 0 ? void 0 : entry.deviceId)
         .filter((id) => typeof id === 'string' && id.length > 0);
 }
+function toReturnable(raw) {
+    var _a;
+    const value = (_a = raw.meta) === null || _a === void 0 ? void 0 : _a.returnable;
+    return value === 'returnable' || value === 'non_returnable' ? value : null;
+}
 function toLiveStream(raw) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
     const multiplier = Number((_b = (_a = raw.meta) === null || _a === void 0 ? void 0 : _a.viewMultiplier) !== null && _b !== void 0 ? _b : 1);
     const extendedBidding = Number((_c = raw.ext_bidding_duration) !== null && _c !== void 0 ? _c : 0);
     return {
@@ -155,14 +186,17 @@ function toLiveStream(raw) {
             .filter((p) => !!p),
         productSegments: (_m = raw.product_segments) !== null && _m !== void 0 ? _m : [],
         bidCap: toAmount((_o = raw.meta) === null || _o === void 0 ? void 0 : _o.biddingCap),
+        minimumBidIncrement: toAmount((_p = raw.meta) === null || _p === void 0 ? void 0 : _p.minimumBidIncrement),
         extendedBiddingMs: Number.isFinite(extendedBidding) && extendedBidding > 0 ? extendedBidding : 0,
         /* Both off the same document: the gateway attaches the Poll row as it stands, and its field names
            are the ones these two already read, so the question and the tally arrive together. */
         poll: (0, polls_1.toLivePoll)(raw.poll),
         pollResults: (0, polls_1.toEmbeddedResults)(raw.poll),
-        giveaways: ((_q = (_p = raw.meta) === null || _p === void 0 ? void 0 : _p.giveawayProducts) !== null && _q !== void 0 ? _q : [])
+        giveaways: ((_r = (_q = raw.meta) === null || _q === void 0 ? void 0 : _q.giveawayProducts) !== null && _r !== void 0 ? _r : [])
             .map((giveaway) => toLiveGiveaway(giveaway, raw.meta))
             .filter((giveaway) => !!giveaway),
+        returnable: toReturnable(raw),
+        pinnedComment: (0, wire_1.toPinnedComment)(raw.pinned_comment),
     };
 }
 function toLiveStreams(response) {
@@ -173,6 +207,13 @@ function toLiveStreams(response) {
         .sort((a, b) => { var _a, _b; return ((_a = a.scheduledAtMs) !== null && _a !== void 0 ? _a : 0) - ((_b = b.scheduledAtMs) !== null && _b !== void 0 ? _b : 0); });
 }
 // ─── Namespace ─────────────────────────────────────────────────────────────
+/**
+ * Shows that ended with a recording, by streaming id, as `destinationFor` read them: a recording,
+ * once it exists, doesn't change, so a second tap on the same link needs no read. Only the record is
+ * kept, never the answer: whether the viewer may see the show is asked again each time, as it turns on
+ * who is signed in (a team member's answer must not reach the next shopper on the same phone).
+ */
+const endedWithRecording = new Map();
 exports.streams = {
     async list() {
         var _a;
@@ -197,5 +238,33 @@ exports.streams = {
         });
         return (_a = body === null || body === void 0 ? void 0 : body.data) !== null && _a !== void 0 ? _a : null;
     },
+    async commentHistory(streamingId) {
+        if (!streamingId)
+            return [];
+        const body = await (0, client_1.liveSellingRequest)('/live-streaming/comments', {
+            params: { streaming_id: streamingId, limit: commentHistory_1.COMMENT_HISTORY_FETCH_LIMIT },
+        });
+        return (0, commentHistory_1.toCommentHistory)(body === null || body === void 0 ? void 0 : body.data);
+    },
+    async destinationFor(streamingId, options) {
+        var _a;
+        if (!streamingId)
+            return { destination: { to: 'showList' }, show: null, readError: null };
+        let record = (_a = endedWithRecording.get(streamingId)) !== null && _a !== void 0 ? _a : null;
+        let readError = null;
+        if (!record) {
+            try {
+                record = await exports.streams.byId(streamingId);
+            }
+            catch (caught) {
+                readError = caught;
+            }
+        }
+        if (record && record.status === 'ended' && record.replayFeedId)
+            endedWithRecording.set(streamingId, record);
+        // A show hidden from this viewer is handed out nowhere, its record included: as if there were none.
+        const visible = record && !(0, hiddenShows_1.isHiddenFrom)(record, options === null || options === void 0 ? void 0 : options.viewerEmail, (0, client_1.hiddenShowsRule)()) ? record : null;
+        return { destination: (0, showLinks_1.showLinkDestination)(visible), show: visible, readError };
+    },
 };
 //# sourceMappingURL=streams.js.map

package/dist/streams.js.map

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

package/dist/types.d.ts

@@ -7,7 +7,8 @@
  *
  * Nothing here imports React, React Native or Zego, so the pure data layer typechecks and runs in any
  * JavaScript runtime. Product ids are Shopify GIDs (`gid://shopify/Product/…`), ready to hand to a
- * Storefront client such as `@tiledev/sdk-shopify`; this package never resolves a product itself.
+ * Storefront client such as `@tiledev/sdk-shopify`. This package resolves a product only through the
+ * commerce adapter the app gives it (`createShopifyLiveCommerce` builds one on the app's own client).
  */
 /**
  * Minimal async key/value store. Satisfied by React Native's AsyncStorage as-is, and by a thin
@@ -85,8 +86,28 @@ export interface LiveSellingConfig {
      * product is reasonable; a room showing the wrong one is not.
      */
     strictActiveProduct?: boolean;
-    /** Backs the durable ids, remembered votes and terms flag. Defaults to localStorage, else in-memory. */
-    storage?: StorageAdapter;
+    /**
+     * Milliseconds before any request to the gateway (or the replay-comment CDN) is given up on, with a
+     * `LiveSellingTimeoutError`. Defaults to 10 000. Zero, negative or non-numbers mean the default.
+     */
+    requestTimeoutMs?: number;
+    /**
+     * Milliseconds the session waits, with no live record and not connecting, before its status
+     * becomes `ended`. Defaults to 4 000. Without it a session whose record never arrives — nothing on
+     * air, or a deep link to a show that has gone — spins on `loading` for ever. A forced record read
+     * (`refreshStreamRecords()`) starts the wait again, so a stale record cannot end a show that has
+     * only just started.
+     */
+    offAirGraceMs?: number;
+    /**
+     * Backs the durable ids, the remembered poll votes, the signed-out shopper's name and the accepted
+     * auction terms: `AsyncStorage` on a phone, `window.localStorage` on the web.
+     *
+     * **Required since 0.9.0**, and `configure` throws without it. It was optional, with an in-memory
+     * store on a phone, and two of the three apps on this package shipped without it: every relaunch
+     * forgot the votes, and the gateway doesn't dedupe votes, so a forgotten vote is counted twice.
+     */
+    storage: StorageAdapter;
     /** Defaults to a silent no-op. */
     logger?: Logger;
     /** See {@link CustomerAccountRequest}. Only the unpaid-wins helpers use it. */
@@ -108,10 +129,37 @@ export interface LiveSellingConfig {
      * (foreground, `refresh()`, `refreshOngoingLive()`). See `ongoingLive.ts`.
      */
     ongoingLivePolling?: import('./ongoingLive').OngoingLivePolling;
+    /**
+     * Shows to keep from shoppers: a team's practice runs on the store's real gateway, which has no
+     * "draft" or "hidden" setting of its own. Unset: nothing is hidden. See {@link HiddenShows}.
+     */
+    hiddenShows?: HiddenShows;
+}
+/**
+ * Which shows a viewer never sees (0.9.0). A show is hidden when its title contains any of
+ * `titleIncludes` (in any case), unless the viewer is signed in with an email at one of
+ * `visibleToEmailDomains`.
+ *
+ * What it reaches: every hook that hands out shows (`useReplays`, `useOngoingLive`, `useLiveStreams`,
+ * `useStreamInfo` and so the session, which then never joins a hidden show's room) and
+ * `streams.destinationFor`. The imperative reads (`streams.list`, `ongoing`, `byId`, `replays.list`)
+ * stay the gateway's, unfiltered. The viewer is `LiveSellingProvider`'s `viewerEmail`.
+ *
+ * It hides shows in the app only: anyone with the company id can still ask the gateway for them.
+ */
+export interface HiddenShows {
+    /** A show whose title contains any of these, in any case, is hidden. Amore: `['apptiletest']`. */
+    titleIncludes: string[];
+    /**
+     * Email domains that still see hidden shows, without the @: `['apptile.io']` lets
+     * `host@apptile.io` see them, and not `host@apptile.io.example.com`. A signed-out viewer never does.
+     */
+    visibleToEmailDomains: string[];
 }
 export type LiveStreamStatus = 'live' | 'scheduled' | 'ended';
 /** How one reaction tap animates: `single` is one emoji, `multiple` a burst. Per stream. */
 export type ReactionStyle = 'single' | 'multiple';
+export type LiveStreamReturnable = 'returnable' | 'non_returnable';
 export interface LiveStreamProduct {
     /**
      * How a lot is matched to a product, and the key everything else joins on.
@@ -131,6 +179,12 @@ export interface LiveStreamProduct {
     startedAtMs: number | null;
     /** Auction only: opening bid, or null on a lot the host has not priced. */
     baseBidPrice: number | null;
+    /**
+     * Auction only: the lot's bid step (`bid_incrementer`), or null when the host set none. On a lot with
+     * no opening bid, the first bid is this step (`openingBidFor`). Optional, so a record built by hand
+     * still type-checks.
+     */
+    bidIncrement?: number | null;
     /** Auction only: rounds already won on this lot. Non-zero means bidding closed. */
     winnerCount: number;
     /**
@@ -171,8 +225,30 @@ export interface LiveGiveaway {
     productName: string;
     thumbnailUrl: string | null;
     variantTitle: string | null;
-    /** Retail price, struck through beside FREE. */
+    /**
+     * Retail price, struck through beside FREE: the record's `variant_price` (`"22.0"`). Read since
+     * 0.9.0; before, the SDK looked only for `product_variant_price`, which no record carries (none of
+     * the 24 giveaways on Amore's 20 latest recorded shows, read 2026-10-06), so this was always null.
+     */
     variantPrice: string | null;
+    /**
+     * The given-away variant's own photo (`variant_image`), where `thumbnailUrl` is the product's. Null
+     * when the record has none. Since 0.9.0; optional so a giveaway built by hand (a test's) still fits.
+     */
+    variantImageUrl?: string | null;
+    /**
+     * When the host started this giveaway (`giveawayStartTime`), epoch ms; null when the record has no
+     * readable time. Two giveaways of the same product in one show differ by it, so it is what tells
+     * them apart. Since 0.9.0; optional so a giveaway built by hand (a test's) still fits.
+     */
+    startedAtMs?: number | null;
+    /**
+     * Who won, once drawn: the bare customer id of the record's `winner` (`"gid://shopify/Customer/42"`
+     * → `"42"`, the id `identity.bidderId` gives). Null while open, and for a draw nobody entered (the
+     * record says `"No One Joined"`). Every drawn giveaway on shows `h2rorgm7po` and `dq9r6hd8ml` has it
+     * (read 2026-10-06). Since 0.9.0; optional so a giveaway built by hand (a test's) still fits.
+     */
+    winnerId?: string | null;
     /** The roster the host keeps on the lot, for the winner-roll animation. */
     entrantNames: string[];
     entries: GiveawayEntry[];
@@ -206,7 +282,10 @@ export interface LiveStream {
      */
     replayFeedId: string | null;
     isAuction: boolean;
-    /** Epoch ms the stream went live, or null when it has not started. */
+    /**
+     * Epoch ms the stream went live, or null when it has not started. The show's clock counts up from it
+     * (`useShowClock(stream.startedAtMs)`), read against the phone's clock as `elapsedMs` always was.
+     */
     startedAtMs: number | null;
     scheduledAtMs: number | null;
     hostName: string | null;
@@ -230,6 +309,11 @@ export interface LiveStream {
     productSegments: ProductSegment[];
     /** Auction only: highest bid the host will accept, or null for no ceiling. */
     bidCap: number | null;
+    /**
+     * Auction only: the show's smallest bid step (`meta.minimumBidIncrement`), or null. The first bid on a
+     * lot with neither an opening bid nor a step of its own. Optional, so a record built by hand still type-checks.
+     */
+    minimumBidIncrement?: number | null;
     /** Auction only: ms a late bid adds to the clock. 0 when the host disabled extended bidding. */
     extendedBiddingMs: number;
     /** Every giveaway the host has run on this stream, active and finished. */
@@ -244,6 +328,23 @@ export interface LiveStream {
      */
     poll: LivePoll | null;
     pollResults: LivePollResults | null;
+    /** The show's returns setting, from `meta.returnable`. Null means each product decides. */
+    returnable: LiveStreamReturnable | null;
+    /**
+     * The comment the host or a moderator pinned, from the record's `pinned_comment`. Null when nothing
+     * is pinned, or the saved pin has no id or no text. The room announces changes with a
+     * `pinnedCommentChanged` event; read `session.pinnedComment`, which joins the two.
+     */
+    pinnedComment: LivePinnedComment | null;
+}
+/** One pinned comment. Text only: the gateway also sends the author's name, which nothing shows. */
+export interface LivePinnedComment {
+    id: string;
+    /**
+     * The words. A broadcast longer than Zego's 1024 bytes arrives cut, ending in "…"; the record keeps
+     * the whole text, and the next record read replaces the cut one.
+     */
+    text: string;
 }
 export declare const COMMENT_SOURCES: readonly ["USER", "MODERATOR", "HOST", "TIP"];
 export type CommentSource = (typeof COMMENT_SOURCES)[number];
@@ -287,6 +388,12 @@ export interface LivePoll {
     options: LivePollOption[];
     /** The option ids exactly as they arrived, by normalised id — a vote must echo the original type. */
     wireOptionIds: Record<string, string | number>;
+    /**
+     * The poll's `status` as the gateway wrote it (`"active"` while it runs), or null when it sent none.
+     * The session raises a poll off the RECORD only while this is `"active"` or absent. Since 0.9.0;
+     * optional so a poll built by hand (a test's) still fits.
+     */
+    status?: string | null;
 }
 export interface LivePollResults {
     pollUuid: string | null;
@@ -312,10 +419,19 @@ export interface AuctionWinItem {
     winningBid: number;
     isGiveaway: boolean;
     discountCode: string | null;
+    /**
+     * The show this lot was won on. A customer can owe on more than one show at once (a giveaway has no
+     * unpaid-wins gate), so the items of one {@link AuctionWins} do not all share its `streamingId`.
+     */
+    streamingId: string;
 }
 export interface AuctionWins {
-    /** The stream the tab is settled against — `auction_id` on the checkout cart. */
+    /**
+     * The stream the tab is settled against — `auction_id` on the checkout cart. The first stream with
+     * something payable; `items` can come from more streams than this one, and each names its own.
+     */
     streamingId: string;
+    /** Every unpaid lot from every stream: stream by stream in the metafield's key order, then entry order. */
     items: AuctionWinItem[];
 }
 export interface Replay {
@@ -331,8 +447,17 @@ export interface Replay {
     publishedAt: string | null;
 }
 export interface ReplayFeed {
+    /** The page's finished recordings that have a playlist, in the gateway's order. */
     replays: Replay[];
+    /** The gateway has more after this page. Always false after an empty page. */
     hasMore: boolean;
+    /**
+     * How many entries the gateway sent for this page, before anything was dropped (no playlist, not a
+     * finished livestream). The next page's offset moves by this, never by `replays.length`: moving by
+     * what was kept asks for entries already read, and a page where nothing is kept would be asked for
+     * again forever.
+     */
+    receivedCount: number;
 }
 export interface ReplaySegment {
     productGid: string;
@@ -456,6 +581,11 @@ export type LiveEvent = {
     endsAtMs: number | null;
     serverNowMs: number;
     leader: BidLeader | null;
+    /**
+     * Who to send bids to, when the host's bid info names one (`data.moderatorInCharge`). The
+     * gateway does not send it today — only `START_BIDDING` does — so this is null until it does.
+     */
+    moderatorId: string | null;
 } | {
     type: 'biddingClosed';
 } | {
@@ -503,6 +633,15 @@ export type LiveEvent = {
 } | {
     type: 'mixer';
     active: boolean;
+}
+/**
+ * The host pinned, replaced or unpinned a comment — `PINNED_COMMENT_CHANGED` on the broadcast
+ * channel. `comment` is null for an unpin, and for a pin with no id or no text (a blank banner is
+ * worse than none).
+ */
+ | {
+    type: 'pinnedCommentChanged';
+    comment: LivePinnedComment | null;
 } | {
     type: 'unknown';
     channel: string;
@@ -582,6 +721,47 @@ export interface LiveStreamsAPI {
     byId(streamingId: string): Promise<LiveStream | null>;
     /** The anonymous Zego room credential for this viewer. */
     zegoToken(viewerId: string, streamingId: string): Promise<string | null>;
+    /**
+     * What the room said before this viewer arrived: the last 40 lines of a show that is on air, oldest
+     * first, with the gateway's duplicate rows collapsed and muted lines left out. `isOwn` is always
+     * false here — the stored rows cannot say which device wrote them. The session puts these in front
+     * of `session.comments` by itself; call this only to show history without a session.
+     */
+    commentHistory(streamingId: string): Promise<LiveComment[]>;
+    /**
+     * Where a link about a show should take this viewer (0.9.0): one read of the show's record. On air:
+     * the live player. Ended with a recording: the replay. Anything else (scheduled, ended with no
+     * recording, unknown, unreadable, or hidden from this viewer by `hiddenShows`): the list of shows.
+     * Never throws. A show's recording, once it exists, is remembered for the rest of the app's run.
+     */
+    destinationFor(streamingId: string, options?: {
+        viewerEmail?: string | null;
+    }): Promise<ShowLinkAnswer>;
+}
+/** Where a link about a show goes. The app maps each to a screen of its own. */
+export type ShowLinkDestination = 
+/** The show is on air: the live player. */
+{
+    to: 'livePlayer';
+}
+/** The show has ended and has a recording: its replay, by `Replay.id`. */
+ | {
+    to: 'replay';
+    feedId: string;
+}
+/** Nothing to play: the list of shows, which says what is on now and what has been. */
+ | {
+    to: 'showList';
+};
+export interface ShowLinkAnswer {
+    destination: ShowLinkDestination;
+    /**
+     * The record the answer was read from, so its poster and title can stand in while a session reads
+     * its own. Null when the show is unknown, the read failed, or it is hidden from this viewer.
+     */
+    show: LiveStream | null;
+    /** Why the read failed, when it did (the answer is then the list of shows); null otherwise. Not logged. */
+    readError: unknown;
 }
 export interface AuctionsAPI {
     /** Records a bid against the stream. Fire-and-forget; the round is decided by the host's broadcast. */
@@ -610,7 +790,10 @@ export interface AuctionsAPI {
     acceptTerms(): Promise<void>;
     /** Streams the customer owes on. Needs `customerAccountRequest`; `[]` without it. Never throws. */
     unpaidStreamIds(): Promise<string[]>;
-    /** Everything the customer has won and not checked out. Needs `customerAccountRequest`; null without it. */
+    /**
+     * Everything the customer has won and not checked out, across every stream with something payable.
+     * Needs `customerAccountRequest`; null without it, or when nothing is owed.
+     */
     wins(): Promise<AuctionWins | null>;
     /** Whether bidding is blocked by an unsettled previous auction. Pure. */
     isBiddingBlocked(unpaidStreamIds: string[], streamingId: string | null): boolean;
@@ -638,7 +821,11 @@ export interface ReplaysAPI {
     list(limit?: number, offset?: number): Promise<ReplayFeed>;
     /** Product windows for a recording, keyed by shoppable_feed_id. */
     segments(feedId: string): Promise<ReplaySegment[]>;
-    /** Stored comments for a recording, keyed by streaming_id, in the order said. */
+    /**
+     * The chat a recording had while it was live, in the order said: the static file
+     * `https://cdn.apptile.io/assets/live-replay-comments/<streamingId>.json`. A show nobody talked
+     * during has no file (the CDN answers 403), which is an empty list, not an error.
+     */
     comments(streamingId: string): Promise<ReplayComment[]>;
     /** Records a play. Fire-and-forget. */
     incrementViews(feedId: string): Promise<void>;