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

package/dist/react/useGiveawayEntry.js

@@ -0,0 +1,170 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useGiveawayEntry = useGiveawayEntry;
+/**
+ * `useGiveawayEntry` — the shopper's part in a giveaway, on one screen (0.9.0, "SDK move 8").
+ *
+ * Every live screen with a giveaway wrote the same flow around `actions.enterGiveaway`, and the copies
+ * drifted (Freckled Poppy's Live screen inline, ENG-583; amore-v2's `useLiveGiveawaysAndPolls`):
+ *
+ * - **The entry sheet:** open and closed by the screen, and closed by the host's draw (an Enter button
+ *   for a giveaway that is over) or the giveaway going (retracted, the show ended).
+ * - **Entering needs a sign-in.** `signInToEnter()` starts the app's sign-in; once the shopper is back
+ *   on this screen signed in (`isLoggedIn` and `screenOnShow`), the sheet opens again if the giveaway
+ *   is still open and not drawn, and the shopper taps Enter themselves. Back on show still signed out
+ *   (a Sign In page closed, a system sheet dismissed: `screenOnShow` false, then true), nothing reopens,
+ *   and a later sign-in elsewhere doesn't raise it.
+ * - **The entry** (`enter`): `entering` while it goes, `entryFailed` when the host didn't take it. With
+ *   a name the shopper typed ("Entering As:"), the name is saved first and the entry goes once the
+ *   session holds it, as the session sends the entry under the name it holds at that moment.
+ * - **The draw** (`draw`): handed over once its roster is ready (the session waits for it, ENG-705), the
+ *   same object until another winner; `youWon` from the session (`giveaway.result.isYou`). A draw already
+ *   on the session as the screen opens happened while the shopper was elsewhere: it is let go rather
+ *   than played late.
+ *
+ * It takes the session as a value rather than reading it, as the clocks take a number: a test drives it
+ * with a plain object, and it loads where the native session can't (an app's test runner, the web).
+ * The screen decides when a sheet can show (`screenOnShow`): a sheet is a `Modal`, which can't open
+ * over a Sign In page or while another sheet is still going.
+ */
+const react_1 = require("react");
+const client_1 = require("../client");
+const sessionTypes_1 = require("../sessionTypes");
+const startSignIn_1 = require("./startSignIn");
+function useGiveawayEntry(options) {
+    var _a, _b, _c, _d, _e;
+    const { session, canEnter, isLoggedIn } = options;
+    const screenOnShow = (_a = options.screenOnShow) !== null && _a !== void 0 ? _a : true;
+    const giveaway = (_b = session.giveaway) !== null && _b !== void 0 ? _b : sessionTypes_1.IDLE_GIVEAWAY;
+    const { dismissGiveawayResult } = session.actions;
+    const result = giveaway.result;
+    const drawn = !!result;
+    const open = canEnter && ((_c = giveaway.active) === null || _c === void 0 ? void 0 : _c.status) === 'active' && !drawn ? giveaway.active : null;
+    /** What the actions read when they run, as it is now. */
+    const latest = (0, react_1.useRef)({ options, actions: session.actions });
+    latest.current = { options, actions: session.actions };
+    const mounted = (0, react_1.useRef)(true);
+    (0, react_1.useEffect)(() => () => {
+        mounted.current = false;
+    }, []);
+    // ─── The entry sheet ─────────────────────────────────────────────────────────────────────────────
+    const [sheetOpen, setSheetOpen] = (0, react_1.useState)(false);
+    const [entering, setEntering] = (0, react_1.useState)(false);
+    const [entryFailed, setEntryFailed] = (0, react_1.useState)(false);
+    // The host's draw closes the sheet (an Enter button for a giveaway that is over), and so does the
+    // giveaway going (retracted, or the show ending).
+    (0, react_1.useEffect)(() => {
+        if (drawn || !open)
+            setSheetOpen(false);
+    }, [drawn, open]);
+    const openSheet = (0, react_1.useCallback)(() => {
+        setEntryFailed(false);
+        setSheetOpen(true);
+    }, []);
+    const closeSheet = (0, react_1.useCallback)(() => setSheetOpen(false), []);
+    // ─── Entering ────────────────────────────────────────────────────────────────────────────────────
+    const enterNow = (0, react_1.useCallback)(async () => {
+        var _a;
+        setEntryFailed(false);
+        setEntering(true);
+        let entered = false;
+        try {
+            const answer = await latest.current.actions.enterGiveaway((_a = latest.current.options.cartId) !== null && _a !== void 0 ? _a : null);
+            entered = (answer === null || answer === void 0 ? void 0 : answer.entered) === true;
+        }
+        catch (caught) {
+            (0, client_1.getLogger)().error(caught, { at: 'giveawayEntry.enter' });
+        }
+        if (!mounted.current)
+            return;
+        setEntering(false);
+        if (!entered)
+            setEntryFailed(true);
+    }, []);
+    // "Entering As:": the name is saved first, and the entry goes once the session holds it.
+    const named = !!((_d = session.viewerName) === null || _d === void 0 ? void 0 : _d.trim());
+    const [enterOnceNamed, setEnterOnceNamed] = (0, react_1.useState)(false);
+    (0, react_1.useEffect)(() => {
+        if (!enterOnceNamed || !named)
+            return;
+        setEnterOnceNamed(false);
+        void enterNow();
+    }, [enterOnceNamed, named, enterNow]);
+    const enter = (0, react_1.useCallback)((typedName) => {
+        if (!typedName) {
+            void enterNow();
+            return;
+        }
+        setEntryFailed(false);
+        setEntering(true);
+        void (async () => {
+            const saved = await latest.current.actions.chooseViewerName(typedName).catch(() => null);
+            if (!mounted.current)
+                return;
+            if (saved)
+                setEnterOnceNamed(true);
+            else {
+                setEntering(false);
+                setEntryFailed(true);
+            }
+        })();
+    }, [enterNow]);
+    // ─── Signing in to enter, then back to the sheet ─────────────────────────────────────────────────
+    /** The shopper asked to enter signed out: once they are back here signed in, the sheet opens again. */
+    const [reopenAfterSignIn, setReopenAfterSignIn] = (0, react_1.useState)(false);
+    const signInToEnter = (0, react_1.useCallback)(() => {
+        setReopenAfterSignIn(true);
+        (0, startSignIn_1.startTheSignIn)(latest.current.options.startSignIn, 'giveawayEntry.startSignIn');
+    }, []);
+    const wasOnShow = (0, react_1.useRef)(screenOnShow);
+    (0, react_1.useEffect)(() => {
+        const cameBackOnShow = screenOnShow && !wasOnShow.current;
+        wasOnShow.current = screenOnShow;
+        if (!reopenAfterSignIn)
+            return;
+        // Drawn, retracted or ended meanwhile: there is nothing to enter any more.
+        if (!open)
+            setReopenAfterSignIn(false);
+        else if (isLoggedIn && screenOnShow) {
+            setReopenAfterSignIn(false);
+            openSheet();
+        }
+        // Back on show without signing in: nothing reopens, now or after a later sign-in elsewhere.
+        else if (!isLoggedIn && cameBackOnShow)
+            setReopenAfterSignIn(false);
+    }, [reopenAfterSignIn, open, isLoggedIn, screenOnShow, openSheet]);
+    // ─── The draw ────────────────────────────────────────────────────────────────────────────────────
+    const ready = !!result && result.entrantNamesReady;
+    const winnerName = (_e = result === null || result === void 0 ? void 0 : result.winnerName) !== null && _e !== void 0 ? _e : null;
+    const resultNow = (0, react_1.useRef)(result);
+    resultNow.current = result;
+    const draw = (0, react_1.useMemo)(() => {
+        const drawnNow = resultNow.current;
+        return ready && drawnNow ? { winnerName: drawnNow.winnerName, entrantNames: drawnNow.entrantNames } : null;
+        // A new draw only for a new winner or readiness: the roster never changes once ready (the session's
+        // promise), and the session hands over a new `result` object on every read of the record.
+    }, [ready, winnerName]);
+    const youWon = !!draw && !!(result === null || result === void 0 ? void 0 : result.isYou);
+    // A draw already on the session as the screen opens happened while the shopper was elsewhere.
+    const drawOnArrival = (0, react_1.useRef)(drawn);
+    (0, react_1.useEffect)(() => {
+        if (!drawOnArrival.current)
+            return;
+        drawOnArrival.current = false;
+        dismissGiveawayResult();
+    }, [dismissGiveawayResult]);
+    return {
+        open,
+        sheetOpen: sheetOpen && !!open,
+        openSheet,
+        closeSheet,
+        enter,
+        entering,
+        entryFailed,
+        signInToEnter,
+        draw,
+        youWon,
+        drawDone: dismissGiveawayResult,
+    };
+}
+//# sourceMappingURL=useGiveawayEntry.js.map

package/dist/react/useGiveawayEntry.js.map

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

package/dist/react/useGiveawayPrize.d.ts

@@ -0,0 +1,12 @@
+import type { LiveProduct, LiveProductVariant } from '../sessionTypes';
+import type { LiveGiveaway } from '../types';
+export interface UseGiveawayPrizeState<TRaw = unknown> {
+    /** The prize as the adapter reads it (your own product on `raw`); null until it answers, or if it can't. */
+    product: LiveProduct<TRaw> | null;
+    /** The variant given away, among the product's; null when the record names none or it's gone. */
+    variant: LiveProductVariant | null;
+    /** The read's failure, or null. Not logged. */
+    readError: unknown;
+}
+export declare function useGiveawayPrize<TRaw = unknown>(giveaway: Pick<LiveGiveaway, 'storeProductId' | 'variantId'> | null | undefined): UseGiveawayPrizeState<TRaw>;
+//# sourceMappingURL=useGiveawayPrize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useGiveawayPrize.d.ts","sourceRoot":"","sources":["../../src/react/useGiveawayPrize.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,MAAM,WAAW,qBAAqB,CAAC,IAAI,GAAG,OAAO;IACnD,4GAA4G;IAC5G,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAClC,iGAAiG;IACjG,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACnC,+CAA+C;IAC/C,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,GAAG,OAAO,EAC7C,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,gBAAgB,GAAG,WAAW,CAAC,GAAG,IAAI,GAAG,SAAS,GAC9E,qBAAqB,CAAC,IAAI,CAAC,CA4B7B"}

package/dist/react/useGiveawayPrize.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useGiveawayPrize = useGiveawayPrize;
+/**
+ * `useGiveawayPrize(giveaway)` — the giveaway's prize in the catalogue (0.9.0, "SDK move 8").
+ *
+ * The host picks a prize from the whole catalogue, kept apart from the show's lots, so it is usually
+ * not one of `session.products`. The record names it, its variant, its price and its photo (0.9.0), so
+ * a sheet is complete enough to enter from at once; the catalogue adds the description and the
+ * variant's price now. Freckled Poppy and amore-v2 each read it by hand.
+ *
+ * One `productsByIds` read through the configured commerce adapter when the prize changes. Cleared
+ * first, because the host can change the prize and the last prize's photo mustn't stand in for the new
+ * one; an answer for an earlier prize is dropped. `variant` is the one given away, the record's bare id
+ * matched to the catalogue's (`isTheVariant`). A failed read comes back in `readError`, for the app to
+ * report, as `streams.destinationFor`'s does; nothing is logged here. No adapter: nothing is read.
+ */
+const react_1 = require("react");
+const client_1 = require("../client");
+const giveawayPrize_1 = require("../giveawayPrize");
+function useGiveawayPrize(giveaway) {
+    var _a, _b;
+    const prizeId = (_a = giveaway === null || giveaway === void 0 ? void 0 : giveaway.storeProductId) !== null && _a !== void 0 ? _a : null;
+    const recordVariantId = (_b = giveaway === null || giveaway === void 0 ? void 0 : giveaway.variantId) !== null && _b !== void 0 ? _b : null;
+    const [answer, setAnswer] = (0, react_1.useState)(null);
+    const [readError, setReadError] = (0, react_1.useState)(null);
+    (0, react_1.useEffect)(() => {
+        setAnswer(null);
+        setReadError(null);
+        const commerce = (0, client_1.getCommerce)();
+        if (!prizeId || !commerce)
+            return;
+        let stillWanted = true;
+        commerce
+            .productsByIds([prizeId])
+            .then(([product]) => {
+            var _a;
+            if (stillWanted)
+                setAnswer({ prizeId, product: (_a = product) !== null && _a !== void 0 ? _a : null });
+        })
+            .catch((caught) => {
+            if (stillWanted)
+                setReadError(caught);
+        });
+        return () => {
+            stillWanted = false;
+        };
+    }, [prizeId]);
+    const product = answer && answer.prizeId === prizeId ? answer.product : null;
+    const variant = (0, react_1.useMemo)(() => (0, giveawayPrize_1.givenAwayVariant)(product, recordVariantId), [product, recordVariantId]);
+    return (0, react_1.useMemo)(() => ({ product, variant, readError }), [product, variant, readError]);
+}
+//# sourceMappingURL=useGiveawayPrize.js.map

package/dist/react/useGiveawayPrize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGiveawayPrize.js","sourceRoot":"","sources":["../../src/react/useGiveawayPrize.ts"],"names":[],"mappings":";;AA8BA,4CA8BC;AA5DD;;;;;;;;;;;;;GAaG;AACH,iCAAqD;AAErD,sCAAwC;AACxC,oDAAoD;AAapD,SAAgB,gBAAgB,CAC9B,QAA+E;;IAE/E,MAAM,OAAO,GAAG,MAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,cAAc,mCAAI,IAAI,CAAC;IACjD,MAAM,eAAe,GAAG,MAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,SAAS,mCAAI,IAAI,CAAC;IACpD,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAA,gBAAQ,EAAgE,IAAI,CAAC,CAAC;IAC1G,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,IAAA,gBAAQ,EAAU,IAAI,CAAC,CAAC;IAE1D,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,SAAS,CAAC,IAAI,CAAC,CAAC;QAChB,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,MAAM,QAAQ,GAAG,IAAA,oBAAW,GAAE,CAAC;QAC/B,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ;YAAE,OAAO;QAClC,IAAI,WAAW,GAAG,IAAI,CAAC;QACvB,QAAQ;aACL,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC;aACxB,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE;;YAClB,IAAI,WAAW;gBAAE,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAC,OAAyC,mCAAI,IAAI,EAAE,CAAC,CAAC;QACvG,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,MAAe,EAAE,EAAE;YACzB,IAAI,WAAW;gBAAE,YAAY,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QACL,OAAO,GAAG,EAAE;YACV,WAAW,GAAG,KAAK,CAAC;QACtB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,MAAM,OAAO,GAAG,MAAM,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7E,MAAM,OAAO,GAAG,IAAA,eAAO,EAAC,GAAG,EAAE,CAAC,IAAA,gCAAgB,EAAC,OAAO,EAAE,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC;IACtG,OAAO,IAAA,eAAO,EAAC,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;AACzF,CAAC"}

package/dist/react/useHiddenShows.d.ts

@@ -0,0 +1,10 @@
+export interface HiddenShowsForViewer {
+    isHidden: (show: {
+        title: string;
+    } | null | undefined) => boolean;
+    visible: <Show extends {
+        title: string;
+    }>(shows: Show[]) => Show[];
+}
+export declare function useHiddenShows(): HiddenShowsForViewer;
+//# sourceMappingURL=useHiddenShows.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useHiddenShows.d.ts","sourceRoot":"","sources":["../../src/react/useHiddenShows.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,GAAG,SAAS,KAAK,OAAO,CAAC;IAClE,OAAO,EAAE,CAAC,IAAI,SAAS;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;CACpE;AAED,wBAAgB,cAAc,IAAI,oBAAoB,CAYrD"}

package/dist/react/useHiddenShows.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useHiddenShows = useHiddenShows;
+/**
+ * `useHiddenShows()` — the shows this viewer may see (0.9.0), for the hooks that hand out shows
+ * (`useReplays`, `useOngoingLive`, `useLiveStreams`, `useStreamInfo`) and an app's own lists: the viewer
+ * from `LiveSellingProvider`'s `viewerEmail`, the rule from the config's `hiddenShows`.
+ *
+ * `isHidden(show)` is true for a show they must not be shown; `visible(shows)` leaves those out, in the
+ * same order (the same array when none is). The object changes only when the viewer or the rule does,
+ * so a memo that depends on it filters again on a sign-in or sign-out, and not otherwise.
+ *
+ * Its own file rather than the provider's, so a test that stands in for the provider module
+ * (`useLiveSelling` alone) still gets it.
+ */
+const react_1 = require("react");
+const client_1 = require("../client");
+const hiddenShows_1 = require("../hiddenShows");
+const LiveSellingProvider_1 = require("./LiveSellingProvider");
+function useHiddenShows() {
+    const { ready, viewerEmail } = (0, LiveSellingProvider_1.useLiveSelling)();
+    // Read once the client is configured; before that nothing is handed out anyway.
+    const rule = ready ? (0, client_1.hiddenShowsRule)() : null;
+    const email = viewerEmail !== null && viewerEmail !== void 0 ? viewerEmail : null;
+    return (0, react_1.useMemo)(() => ({
+        isHidden: (show) => (0, hiddenShows_1.isHiddenFrom)(show, email, rule),
+        visible: (shows) => (0, hiddenShows_1.withoutHiddenShows)(shows, email, rule),
+    }), [email, rule]);
+}
+//# sourceMappingURL=useHiddenShows.js.map

package/dist/react/useHiddenShows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHiddenShows.js","sourceRoot":"","sources":["../../src/react/useHiddenShows.ts"],"names":[],"mappings":";;AAuBA,wCAYC;AAnCD;;;;;;;;;;;GAWG;AACH,iCAAgC;AAEhC,sCAA4C;AAC5C,gDAAkE;AAClE,+DAAuD;AAOvD,SAAgB,cAAc;IAC5B,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,IAAA,oCAAc,GAAE,CAAC;IAChD,gFAAgF;IAChF,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAA,wBAAe,GAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9C,MAAM,KAAK,GAAG,WAAW,aAAX,WAAW,cAAX,WAAW,GAAI,IAAI,CAAC;IAClC,OAAO,IAAA,eAAO,EACZ,GAAG,EAAE,CAAC,CAAC;QACL,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,0BAAY,EAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC;QACnD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,gCAAkB,EAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC;KAC3D,CAAC,EACF,CAAC,KAAK,EAAE,IAAI,CAAC,CACd,CAAC;AACJ,CAAC"}

package/dist/react/useLiveSession.d.ts

@@ -17,9 +17,13 @@ export interface LiveSessionProviderProps {
     /** Shown next to this viewer's own comments and sent with them. Overrides the identity adapter. */
     viewerName?: string | null;
     /**
-     * Called when the user taps the system PIP window to come back. Navigate to your live screen — the
-     * window *is* that screen as far as they are concerned. The SDK cannot do this itself: it lives
-     * above the navigator and has no route context.
+     * Called when the system PIP window gives the picture back to a full-screen player: the user expanded
+     * a window that the player opened (or, on iOS, came back to the app with it still up). Navigate to
+     * your live screen — the window *is* that screen as far as they are concerned. The SDK cannot do this
+     * itself: it lives above the navigator and has no route context.
+     *
+     * Not called for a window that opened from your in-app bubble: coming back puts the picture in the
+     * bubble again (`pipMode` `'inapp'`), where it was, and there is nowhere to navigate.
      */
     onPipRestore?: (streamingId: string | undefined) => void;
     children: ReactNode;

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

@@ -1 +1 @@
-{"version":3,"file":"useLiveSession.d.ts","sourceRoot":"","sources":["../../src/react/useLiveSession.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAUvC,OAAO,KAAK,EAMV,WAAW,EAEZ,MAAM,iBAAiB,CAAC;AAiCzB;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,GAAG,OAAO,KAAK,WAAW,CAAC,IAAI,CAAC,CAIlE;AAED,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mGAAmG;IACnG,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACzD,QAAQ,EAAE,SAAS,CAAC;CACrB;AA6nCD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,wBAAwB,+FAwCnF"}
+{"version":3,"file":"useLiveSession.d.ts","sourceRoot":"","sources":["../../src/react/useLiveSession.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AA4CvC,OAAO,KAAK,EASV,WAAW,EAEZ,MAAM,iBAAiB,CAAC;AAiCzB;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,GAAG,OAAO,KAAK,WAAW,CAAC,IAAI,CAAC,CAIlE;AAED,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mGAAmG;IACnG,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACzD,QAAQ,EAAE,SAAS,CAAC;CACrB;AAy9CD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,wBAAwB,+FA0CnF"}