@tiledev/sdk-apptile-live-selling 0.1.0

package/dist/react/useAuctionBidGate.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SHEET_HANDOFF_MS = void 0;
+exports.useAuctionBidGate = useAuctionBidGate;
+/**
+ * `useAuctionBidGate` — everything that has to be true before a bid can be placed.
+ *
+ * A bid is a binding commitment to buy, so it is the one action here with real conditions in front of
+ * it. They are gathered in one hook because the *order* is the whole point, and that order is
+ * invisible when it is spread across four call sites.
+ *
+ * In order:
+ *
+ * 1. **Signed in.** The host attributes a win to a customer and turns it into a cart, so an anonymous
+ *    bid has nowhere to land.
+ * 2. **Nothing outstanding.** A customer who won a lot on an earlier stream and never checked out is
+ *    asked to settle that first — the host settles a viewer's whole tab at once.
+ * 3. **Rules accepted.** Once per install, before the first bid ever.
+ * 4. **A variant chosen.** On a lot with more than one variant, a bid has to say which — the winner is
+ *    charged for a specific one. Asked once per round, not once per bid: a bidder raising three times
+ *    in the last ten seconds must not be asked their size three times.
+ *
+ * The requested bid is held while the blocker is resolved and then placed, so clearing the last panel
+ * completes the bid the viewer originally asked for rather than making them start again.
+ *
+ * The hook owns the *decisions*, never the UI: it reports which blocker is current and the host app
+ * renders whatever it likes for each.
+ */
+const react_1 = require("react");
+const client_1 = require("../client");
+const liveSelling_1 = require("../liveSelling");
+/**
+ * How long to leave between one panel closing and the next opening.
+ *
+ * Not cosmetic, if the host renders these as React Native `Modal`s: presenting one while another is
+ * still dismissing throws `Attempt to present … which is already presenting` on iOS — a native
+ * exception, so the app disappears rather than showing an error. The gate chains panels by design
+ * (rules, then the variant), so this is the one place that has to be careful about it.
+ *
+ * Long enough to outlast a slide-out, short enough not to read as a pause.
+ */
+exports.SHEET_HANDOFF_MS = 380;
+function useAuctionBidGate({ streamingId, isLoggedIn, biddingOpen, variantCount, placeBid, }) {
+    const [blocker, setBlocker] = (0, react_1.useState)(null);
+    const [variantId, setVariantId] = (0, react_1.useState)(null);
+    const [termsAccepted, setTermsAccepted] = (0, react_1.useState)(null);
+    const [unpaidStreamIds, setUnpaidStreamIds] = (0, react_1.useState)([]);
+    /** The bid being held behind a blocker. Undefined means "the round's minimum". */
+    const pendingRef = (0, react_1.useRef)(undefined);
+    /** Pending handoff, so unmounting mid-chain does not set state on a dead hook. */
+    const handoffRef = (0, react_1.useRef)(null);
+    (0, react_1.useEffect)(() => () => {
+        if (handoffRef.current)
+            clearTimeout(handoffRef.current);
+    }, []);
+    /**
+     * Shows a panel, waiting out the previous one if there is one up.
+     *
+     * Reads the current blocker through the setter rather than a dependency, so this stays stable and
+     * the callbacks below do not change identity every time a panel opens.
+     */
+    const show = (0, react_1.useCallback)((next) => {
+        if (handoffRef.current) {
+            clearTimeout(handoffRef.current);
+            handoffRef.current = null;
+        }
+        setBlocker((current) => {
+            if (current === null || next === null)
+                return next;
+            handoffRef.current = setTimeout(() => {
+                handoffRef.current = null;
+                setBlocker(next);
+            }, exports.SHEET_HANDOFF_MS);
+            return null;
+        });
+    }, []);
+    (0, react_1.useEffect)(() => {
+        let alive = true;
+        void liveSelling_1.liveSelling.auctions.hasAcceptedTerms().then((accepted) => {
+            if (alive)
+                setTermsAccepted(accepted);
+        });
+        return () => {
+            alive = false;
+        };
+    }, []);
+    // Read on demand rather than per bid: it is a customer metafield, it only changes when they check
+    // out, and a round is no place for a network round trip.
+    const refreshUnpaidWins = (0, react_1.useCallback)(() => {
+        if (!isLoggedIn) {
+            setUnpaidStreamIds([]);
+            return;
+        }
+        void liveSelling_1.liveSelling.auctions.unpaidStreamIds().then(setUnpaidStreamIds);
+    }, [isLoggedIn]);
+    (0, react_1.useEffect)(refreshUnpaidWins, [refreshUnpaidWins]);
+    // A variant choice belongs to one lot. Carrying it into the next round would bid on a size the
+    // viewer chose for something else.
+    (0, react_1.useEffect)(() => {
+        if (!biddingOpen)
+            setVariantId(null);
+    }, [biddingOpen]);
+    const send = (0, react_1.useCallback)((amount, variant) => {
+        pendingRef.current = undefined;
+        show(null);
+        void placeBid({ amount, variantId: variant }).catch((caught) => (0, client_1.getLogger)().error(caught, { at: 'auctionGate.placeBid' }));
+    }, [placeBid, show]);
+    const requestBid = (0, react_1.useCallback)((amount) => {
+        pendingRef.current = amount;
+        if (!isLoggedIn)
+            return show('signIn');
+        if (liveSelling_1.liveSelling.auctions.isBiddingBlocked(unpaidStreamIds, streamingId)) {
+            return show('unpaidWins');
+        }
+        // Null means the check has not finished. Treated as un-accepted, which shows the panel a moment
+        // early at worst — the opposite mistake would let a first bid through unseen.
+        if (!termsAccepted)
+            return show('terms');
+        if (variantCount > 1 && !variantId)
+            return show('variant');
+        send(amount, variantId);
+    }, [isLoggedIn, unpaidStreamIds, streamingId, termsAccepted, variantCount, variantId, send, show]);
+    const acceptTerms = (0, react_1.useCallback)(() => {
+        setTermsAccepted(true);
+        void liveSelling_1.liveSelling.auctions
+            .acceptTerms()
+            .catch((caught) => (0, client_1.getLogger)().error(caught, { at: 'auctionGate.acceptTerms' }));
+        // Straight on to the next condition rather than out: the viewer asked to bid, and accepting the
+        // rules was a step in that, not the end of it. `show` waits for this panel to go first.
+        if (variantCount > 1 && !variantId)
+            return show('variant');
+        send(pendingRef.current, variantId);
+    }, [variantCount, variantId, send, show]);
+    const chooseVariant = (0, react_1.useCallback)((chosen) => {
+        setVariantId(chosen);
+        send(pendingRef.current, chosen);
+    }, [send]);
+    const dismiss = (0, react_1.useCallback)(() => {
+        pendingRef.current = undefined;
+        show(null);
+    }, [show]);
+    return { blocker, variantId, requestBid, acceptTerms, chooseVariant, dismiss, refreshUnpaidWins };
+}
+//# sourceMappingURL=useAuctionBidGate.js.map

package/dist/react/useAuctionBidGate.js.map

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

package/dist/react/useAuctionWins.d.ts

@@ -0,0 +1,51 @@
+import type { AuctionWinItem } from '../types';
+import type { LiveProduct, LiveProductVariant } from '../sessionTypes';
+/** One winning lot, resolved. */
+export interface AuctionWinRow<TRaw = unknown> {
+    /**
+     * List key. The win's position in the ledger, because nothing else is unique: the same customer can
+     * win the same variant twice on two lots, at the same price.
+     */
+    id: string;
+    product: LiveProduct<TRaw>;
+    variant: LiveProductVariant;
+    /** What the customer owes for this lot. 0 for a giveaway. */
+    winningBid: number;
+    isGiveaway: boolean;
+    /** Zeroes a giveaway's line at checkout. */
+    discountCode: string | null;
+    imageUrl: string | null;
+    /** The ledger entry with its variant resolved — what `createAuctionCheckout` is given. */
+    item: AuctionWinItem;
+}
+export interface UseAuctionWinsState<TRaw = unknown> {
+    rows: AuctionWinRow<TRaw>[];
+    /** Sum of the bids. Giveaways contribute nothing. */
+    totalBids: number;
+    /** The stream the tab settles against — `auction_id` on the cart. */
+    streamingId: string | null;
+    loading: boolean;
+    /** Minting the cart. Hold the button while it is true so a double tap cannot mint two. */
+    checkingOut: boolean;
+    error: string | null;
+    refresh: () => void;
+    /**
+     * Builds the auction cart and returns it, or null when there is nothing to settle or the build
+     * failed (the reason lands on `error`). Returns the cart id as well as the URL, so store credit can
+     * be applied to a cart that did not exist until now.
+     */
+    checkout: () => Promise<{
+        checkoutUrl: string;
+        cartId?: string;
+    } | null>;
+}
+export interface UseAuctionWinsOptions {
+    /**
+     * Whether to read at all. Defaults to "is anyone identified" — wins live on a customer metafield, so
+     * signed out there is nothing to read and a request would only fail. Pass the app's own reactive
+     * signed-in value to re-read the moment somebody signs in.
+     */
+    enabled?: boolean;
+}
+export declare function useAuctionWins<TRaw = unknown>(options?: UseAuctionWinsOptions): UseAuctionWinsState<TRaw>;
+//# sourceMappingURL=useAuctionWins.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAuctionWins.d.ts","sourceRoot":"","sources":["../../src/react/useAuctionWins.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEvE,iCAAiC;AACjC,MAAM,WAAW,aAAa,CAAC,IAAI,GAAG,OAAO;IAC3C;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;IAC3B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,0FAA0F;IAC1F,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB,CAAC,IAAI,GAAG,OAAO;IACjD,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;IAC5B,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,0FAA0F;IAC1F,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;CAC1E;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAyHD,wBAAgB,cAAc,CAAC,IAAI,GAAG,OAAO,EAC3C,OAAO,GAAE,qBAA0B,GAClC,mBAAmB,CAAC,IAAI,CAAC,CAkI3B"}

package/dist/react/useAuctionWins.js

@@ -0,0 +1,268 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useAuctionWins = useAuctionWins;
+/**
+ * `useAuctionWins` — the lots this customer won and has not paid for, resolved against the catalogue.
+ *
+ * The metafield is a ledger of bare ids and amounts; a wins list needs titles, images, variant labels
+ * and prices. This is the join: `auctions.wins()` for the ledger, then one `productsByIds` through the
+ * commerce adapter for everything it names. Rows come back ready to render, and `checkout()` mints the
+ * disposable cart that settles the tab.
+ *
+ * **Resolving the variant is the point of this hook, not a detail of it.** What the host writes is not
+ * what a cart can be built from:
+ *
+ *   - a lot with one variant is recorded with **no variant at all**, and the win still has to be
+ *     payable — it resolves to the product's only variant
+ *   - the host writes the variant id **bare** on one path and as a **full GID** on another, so a
+ *     matcher that assumes either form silently fails on half the wins
+ *   - a lot whose product has since been deleted from the store can be resolved by nothing, and is
+ *     dropped rather than carried into a cart that would fail to build
+ *
+ * A caller that skips this and hands the raw ledger to `createAuctionCheckout` is passing ids the
+ * platform may reject outright — which is a checkout button that cannot work, on the one screen a
+ * blocked bidder is sent to in order to become unblocked.
+ *
+ * Not focus-aware, because the SDK has no navigator: the metafield changes host-side mid-stream and
+ * again on payment, so the screen that shows this should call `refresh()` when it regains focus — the
+ * same division as `refreshStreamRecordsIfStale`.
+ */
+const react_1 = require("react");
+const client_1 = require("../client");
+const liveSelling_1 = require("../liveSelling");
+const LOAD_FAILED = 'Could not load your auction wins';
+const CHECKOUT_FAILED = 'Could not start checkout. Please try again.';
+/**
+ * How close together two reads have to be before the second is served by the first.
+ *
+ * A ledger read is two network round trips (the metafield, then the catalogue), and `refresh()` is wired
+ * to navigation focus by design — so the caller decides how often this runs, and callers get that wrong
+ * in a way that is invisible from here. `useCart().refresh` from `@apptile/sdk-shopify` is a
+ * `useCallback` keyed on the cart object and it *replaces the cart* when it resolves, so a focus effect
+ * listing it as a dependency re-runs on its own result, forever. Sharing that effect put this hook in
+ * the loop: every read superseded the one before it, so the list never settled and the tab spun for as
+ * long as you looked at it.
+ *
+ * Coalescing here rather than only fixing the call site, because the same mistake is one line away in
+ * any screen, and the symptom (a permanent spinner) does not look like a dependency-array bug.
+ */
+const MIN_RELOAD_GAP_MS = 2000;
+/** Bare numeric tail of an id, whichever form it arrives in. */
+function bareId(id) {
+    var _a;
+    return (_a = id.split('/').pop()) !== null && _a !== void 0 ? _a : id;
+}
+/**
+ * Mismatches already reported, so an unchanged ledger is reported once and not once per read.
+ *
+ * The wins are re-read on every arrival at the tab, and a bad record stays bad — so without this the
+ * same merchant typo is announced again every time the shopper looks at their wins, and again on every
+ * return from checkout. A repeated report is not more information; it is the same information louder,
+ * and it buries whatever is next to it. Keyed by the pair so a *different* bad record still speaks up.
+ *
+ * Module scope, deliberately: the report is about the record, not about a component, and the hook
+ * remounts every time the tab does.
+ */
+const reportedMismatches = new Set();
+/**
+ * Whether a fresh read says the same thing as what is already on screen.
+ *
+ * A read builds new row objects every time, so writing them unconditionally re-renders the list — and
+ * any caller whose refresh is driven by a re-render then has a loop with a new array on each turn. The
+ * ledger is small and its identity is exactly these four fields, so comparing them is cheaper than the
+ * render it avoids.
+ */
+function sameRows(a, b) {
+    if (a.length !== b.length)
+        return false;
+    return a.every((row, index) => {
+        const other = b[index];
+        return (row.product.id === other.product.id &&
+            row.variant.id === other.variant.id &&
+            row.winningBid === other.winningBid &&
+            row.isGiveaway === other.isGiveaway);
+    });
+}
+/**
+ * The variant to charge for.
+ *
+ * Falls back to the product's first rather than dropping the win: a single-variant lot is recorded with
+ * no variant, and a paid-for lot must never vanish from the tab over a field the host had no reason to
+ * write.
+ *
+ * **A variant that is recorded but does not belong to this product is a different thing, and it is
+ * logged.** It happens — a win read from this store paired a jacket's product id with a variant id
+ * belonging to a pair of shoes, because the host's "variant the bidder opted into" can be left over
+ * from an earlier lot. The product is the better anchor of the two (it is the lot the host opened, and
+ * the bid was recorded against it), so the fallback still stands rather than dropping a binding win.
+ * But it means the customer may be billed for a size they did not choose, and the visible symptom lands
+ * on support long before anyone looks at a metafield — so it must not pass silently.
+ */
+function resolveVariant(product, item) {
+    var _a, _b;
+    /**
+     * The fallback prefers a variant that can actually be sold, where the recorded one does not.
+     *
+     * `variants[0]` alone is not good enough, and the same jacket proves it: its first variant is sold out
+     * and only one of its six is in stock, so a cart built on the first one comes back with the line at
+     * **quantity 0** — an unpayable checkout, which for a blocked bidder is the same dead end as no
+     * checkout at all. A guess that has to be made should at least be made in favour of the win being
+     * settleable.
+     *
+     * Only the *fallback* does this. A recorded variant is honoured even when it is out of stock: that is
+     * the thing the customer won, and quietly billing them for another size would be worse than a
+     * checkout they have to ask about.
+     */
+    const fallback = () => { var _a, _b; return (_b = (_a = product.variants.find((variant) => variant.available)) !== null && _a !== void 0 ? _a : product.variants[0]) !== null && _b !== void 0 ? _b : null; };
+    if (item.variantId) {
+        const wanted = bareId(String(item.variantId));
+        const match = product.variants.find((variant) => bareId(variant.id) === wanted);
+        if (match)
+            return match;
+        /**
+         * A warning, not an error, and once per bad record.
+         *
+         * Nothing failed here: the win is resolved, listed and payable. What happened is that the host's
+         * record is wrong and the app chose the product over the variant — which a developer should know,
+         * and which is not a fault of the screen the shopper is looking at.
+         */
+        const key = `${item.productGid}:${item.variantId}`;
+        if (!reportedMismatches.has(key)) {
+            reportedMismatches.add(key);
+            (0, client_1.logWarning)(new Error('Auction win variant does not belong to its product'), {
+                at: 'useAuctionWins.resolveVariant',
+                productGid: item.productGid,
+                variantId: item.variantId,
+                fellBackTo: (_b = (_a = fallback()) === null || _a === void 0 ? void 0 : _a.id) !== null && _b !== void 0 ? _b : null,
+            });
+        }
+    }
+    return fallback();
+}
+function useAuctionWins(options = {}) {
+    var _a, _b, _c;
+    const commerce = (0, client_1.getCommerce)();
+    const identified = !!((_b = (_a = (0, client_1.getIdentity)()) === null || _a === void 0 ? void 0 : _a.bidderId) === null || _b === void 0 ? void 0 : _b.call(_a));
+    const enabled = (_c = options.enabled) !== null && _c !== void 0 ? _c : identified;
+    const [rows, setRows] = (0, react_1.useState)([]);
+    const [streamingId, setStreamingId] = (0, react_1.useState)(null);
+    const [loading, setLoading] = (0, react_1.useState)(false);
+    const [checkingOut, setCheckingOut] = (0, react_1.useState)(false);
+    const [error, setError] = (0, react_1.useState)(null);
+    /** Guards state writes after unmount, and drops a slow read that a newer one has overtaken. */
+    const readIdRef = (0, react_1.useRef)(0);
+    /** The read in flight, and when the last one finished — see `MIN_RELOAD_GAP_MS`. */
+    const inFlightRef = (0, react_1.useRef)(null);
+    const lastReadAtRef = (0, react_1.useRef)(0);
+    const read = (0, react_1.useCallback)(async () => {
+        const readId = ++readIdRef.current;
+        const settle = (next, stream) => {
+            if (readIdRef.current !== readId)
+                return;
+            setRows((current) => (sameRows(current, next) ? current : next));
+            setStreamingId(stream);
+        };
+        if (!enabled || !commerce) {
+            settle([], null);
+            return;
+        }
+        setLoading(true);
+        setError(null);
+        try {
+            const wins = await liveSelling_1.liveSelling.auctions.wins();
+            if (!wins) {
+                settle([], null);
+                return;
+            }
+            // One request for the whole ledger — a customer can win the same product on two lots.
+            const products = await commerce.productsByIds([
+                ...new Set(wins.items.map((item) => bareId(item.productGid))),
+            ]);
+            const resolved = [];
+            wins.items.forEach((item, index) => {
+                const wanted = bareId(item.productGid);
+                const product = products.find((candidate) => candidate.storeProductId === wanted);
+                // A lot deleted from the store: nothing to render, and nothing a cart could charge for.
+                if (!product)
+                    return;
+                const variant = resolveVariant(product, item);
+                if (!variant)
+                    return;
+                resolved.push({
+                    id: `win-${index}`,
+                    product: product,
+                    variant,
+                    winningBid: item.winningBid,
+                    isGiveaway: item.isGiveaway,
+                    discountCode: item.discountCode,
+                    imageUrl: product.imageUrl,
+                    // The resolved variant id, so the cart is built from something that exists.
+                    item: { ...item, variantId: variant.id },
+                });
+            });
+            settle(resolved, wins.streamingId);
+        }
+        catch (caught) {
+            (0, client_1.getLogger)().error(caught, { at: 'useAuctionWins.load' });
+            if (readIdRef.current === readId)
+                setError(LOAD_FAILED);
+        }
+        finally {
+            if (readIdRef.current === readId)
+                setLoading(false);
+        }
+    }, [commerce, enabled]);
+    /**
+     * One read at a time, and not twice inside `MIN_RELOAD_GAP_MS`.
+     *
+     * Both halves matter. Without coalescing, concurrent reads mean every one but the last is discarded by
+     * the `readId` guard — including its `setLoading(false)` — so a caller that refreshes faster than the
+     * network answers leaves the tab loading forever. Without the floor, a caller in a render loop still
+     * issues a read per iteration.
+     */
+    const load = (0, react_1.useCallback)(() => {
+        if (inFlightRef.current)
+            return inFlightRef.current;
+        if (Date.now() - lastReadAtRef.current < MIN_RELOAD_GAP_MS)
+            return Promise.resolve();
+        const pending = read().finally(() => {
+            lastReadAtRef.current = Date.now();
+            inFlightRef.current = null;
+        });
+        inFlightRef.current = pending;
+        return pending;
+    }, [read]);
+    (0, react_1.useEffect)(() => {
+        void load();
+    }, [load]);
+    /**
+     * The floor applies here too, and 2s is chosen so that it can.
+     *
+     * Every real reason to refresh is far slower than the floor: the customer walked to Shopify's checkout
+     * and back, or opened the tab having been elsewhere in the app. Nothing legitimate asks twice in two
+     * seconds — but a dependency-array mistake asks continuously, and that is the case this has to survive.
+     */
+    const refresh = (0, react_1.useCallback)(() => {
+        void load();
+    }, [load]);
+    const checkout = (0, react_1.useCallback)(async () => {
+        if (!rows.length || !streamingId || !(commerce === null || commerce === void 0 ? void 0 : commerce.createAuctionCheckout))
+            return null;
+        setCheckingOut(true);
+        setError(null);
+        try {
+            return await commerce.createAuctionCheckout(rows.map((row) => row.item), streamingId);
+        }
+        catch (caught) {
+            (0, client_1.getLogger)().error(caught, { at: 'useAuctionWins.checkout' });
+            setError(CHECKOUT_FAILED);
+            return null;
+        }
+        finally {
+            setCheckingOut(false);
+        }
+    }, [rows, streamingId, commerce]);
+    const totalBids = rows.reduce((sum, row) => sum + (row.isGiveaway ? 0 : row.winningBid), 0);
+    return { rows, totalBids, streamingId, loading, checkingOut, error, refresh, checkout };
+}
+//# sourceMappingURL=useAuctionWins.js.map

package/dist/react/useAuctionWins.js.map

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

package/dist/react/useClips.d.ts

@@ -0,0 +1,9 @@
+import type { ClipItem } from '../types';
+export interface UseClipsState {
+    clips: ClipItem[];
+    loading: boolean;
+    error: string | null;
+    refresh: () => Promise<void>;
+}
+export declare function useClips(): UseClipsState;
+//# sourceMappingURL=useClips.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useClips.d.ts","sourceRoot":"","sources":["../../src/react/useClips.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,wBAAgB,QAAQ,IAAI,aAAa,CAwBxC"}

package/dist/react/useClips.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useClips = useClips;
+/**
+ * `useClips` — the curated clip reel, in the collection's order.
+ *
+ * Empty (never an error) when no `videoCollectionId` is configured.
+ */
+const react_1 = require("react");
+const liveSelling_1 = require("../liveSelling");
+const LiveSellingProvider_1 = require("./LiveSellingProvider");
+function useClips() {
+    const { ready } = (0, LiveSellingProvider_1.useLiveSelling)();
+    const [clips, setClips] = (0, react_1.useState)([]);
+    const [loading, setLoading] = (0, react_1.useState)(false);
+    const [error, setError] = (0, react_1.useState)(null);
+    const refresh = (0, react_1.useCallback)(async () => {
+        setLoading(true);
+        try {
+            const next = await liveSelling_1.liveSelling.clips.list();
+            setClips(next);
+            setError(null);
+        }
+        catch (caught) {
+            setError(caught instanceof Error ? caught.message : String(caught));
+        }
+        finally {
+            setLoading(false);
+        }
+    }, []);
+    (0, react_1.useEffect)(() => {
+        if (ready)
+            void refresh();
+    }, [ready, refresh]);
+    return { clips, loading, error, refresh };
+}
+//# sourceMappingURL=useClips.js.map

package/dist/react/useClips.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClips.js","sourceRoot":"","sources":["../../src/react/useClips.ts"],"names":[],"mappings":";;AAkBA,4BAwBC;AA1CD;;;;GAIG;AACH,iCAAyD;AAEzD,gDAA6C;AAE7C,+DAAuD;AASvD,SAAgB,QAAQ;IACtB,MAAM,EAAE,KAAK,EAAE,GAAG,IAAA,oCAAc,GAAE,CAAC;IACnC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAa,EAAE,CAAC,CAAC;IACnD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,IAAA,gBAAQ,EAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAgB,IAAI,CAAC,CAAC;IAExD,MAAM,OAAO,GAAG,IAAA,mBAAW,EAAC,KAAK,IAAI,EAAE;QACrC,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,yBAAW,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAC5C,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;QACtE,CAAC;gBAAS,CAAC;YACT,UAAU,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,KAAK;YAAE,KAAK,OAAO,EAAE,CAAC;IAC5B,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IAErB,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5C,CAAC"}

package/dist/react/useLiveSession.d.ts

@@ -0,0 +1,34 @@
+import type { ReactNode } from 'react';
+import type { LiveSession } from '../sessionTypes';
+/**
+ * Reads the shared live session.
+ *
+ * `TRaw` is your catalogue's own product type — whatever the commerce adapter put on `LiveProduct.raw`.
+ * Pass it and `session.products[n].raw` comes back typed, with no cast at the call site:
+ * `useLiveSession<ShopifyProduct>()`.
+ */
+export declare function useLiveSession<TRaw = unknown>(): LiveSession<TRaw>;
+export interface LiveSessionProviderProps {
+    /**
+     * Watch this stream instead of whichever one is on air. For a deep link into a specific show; omit
+     * for the ordinary case.
+     */
+    streamingId?: string;
+    /** 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.
+     */
+    onPipRestore?: (streamingId: string | undefined) => void;
+    children: ReactNode;
+}
+/**
+ * Holds one live session for the whole app. Nothing is joined while no stream is live, so the engine
+ * stays idle on an ordinary session.
+ *
+ * Goes *inside* `LiveSellingProvider`, which is what configures the client.
+ */
+export declare function LiveSessionProvider({ children, ...props }: LiveSessionProviderProps): import("react").FunctionComponentElement<import("react").ProviderProps<LiveSession | null>>;
+//# sourceMappingURL=useLiveSession.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useLiveSession.d.ts","sourceRoot":"","sources":["../../src/react/useLiveSession.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAQvC,OAAO,KAAK,EAMV,WAAW,EAEZ,MAAM,iBAAiB,CAAC;AAsBzB;;;;;;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;AA60BD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,wBAAwB,+FAGnF"}