@tiledev/sdk-apptile-live-selling 0.15.4 → 0.16.0

package/README.md

@@ -470,7 +470,8 @@ const routes: LiveSellingRoutes = {
   openReplay: (feedId) => navigationRef.dispatch(CommonActions.navigate('Replay', { feedId }, { pop: true })),
   replaceWithReplay: (feedId, nav) => nav.dispatch(StackActions.replace('Replay', { feedId })),
   backToLiveTab: (nav) => nav.dispatch(StackActions.popTo('Tabs', { screen: 'LiveTab' })),
-  openHome: (nav) => nav.navigate('Tabs', { screen: 'Home' }),
+  // Back to the tabs already there: a navigate pushes a second Tabs over Live (0.16.0: every back goes Home).
+  openHome: (nav) => nav.dispatch(StackActions.popTo('Tabs', { screen: 'Home' })),
   openCart: ({ itemsYouWon }, nav) => nav.navigate('Cart', itemsYouWon ? { screen: 'ItemsYouWon' } : undefined),
   openVariantPage: (params, nav) => nav.navigate('VariantSelector', params),
   openSignIn: (method, nav) => nav.navigate('SignIn', { method }),
@@ -493,6 +494,10 @@ const routes: LiveSellingRoutes = {
   shopName={APP_NAME}
   // 0.15.0: the names nobody watching may go by, from a list the app publishes (`blockedNamesFrom`).
   blockedNames={blockedNamesFrom(publishedBlockedNames)}
+  // 0.16.0, optional: a limit on each viewer's reactions, refilled when the host features another product;
+  // past it a tap sends nothing and onReactionLimitReached is called. Unset: no limit.
+  reactionLimit={15}
+  onReactionLimitReached={() => showToast('Please wait before reacting again.')}
 >
   <ShopifyLiveSessionProvider>
     <ReplayPlayerProvider>
@@ -692,6 +697,7 @@ typed with `useAuctionWins<Product>()` / `useLiveSession<Product>()`.
 | `shopify` | yes | The app's sdk-shopify client (`shopify`): its `products.byIds` and `cart.create` |
 | `cartSourceName` | yes | `source_name` on the wins cart |
 | `prizeWriteKey` | yes | The line attribute this store's cart transform reads for a prize. No default: a wrong one charges a winner full price |
+| `winningBidKey` | no | The line attribute the store's cart transform reprices a win by. Default `_winningBid` (0.16.0) |
 | `buyer` | yes | Who pays: `{ customerAccessToken, email? }`, or null for a guest cart. `createShopifyLiveIdentity(...).buyer` |
 | `imageTransform` | no | The products' photo size, passed to `products.byIds` |
 | `extraLineAttributes` | no | `(win) => ShopifyAttribute[]`: more attributes on each win's line, after the adapter's own (a final-sale stamp, say) |
@@ -701,8 +707,9 @@ typed with `useAuctionWins<Product>()` / `useLiveSession<Product>()`.
   left out, and each `LiveProduct` keeps the Shopify `Product` on `raw`. Each variant carries its own
   photo, when it has one (`imageUrl`, 0.9.0).
 - `createAuctionCheckout(wins, auctionId)`: the contract above. A cart of its own; each win a line of
-  one stamped `_winningBid` (or `prizeWriteKey: "true"`) and `_winIndex`; the giveaway discount codes;
-  `source_name`, `source_type: "auction"`, `auction_id`; the buyer when there is one (a guest cart when
+  one stamped `_winningBid` (`winningBidKey`; or `prizeWriteKey: "true"`), `_winIndex` and a silent
+  auction's `_lotNumber` (0.16.0); the giveaway discount codes; `source_name`, `source_type: "auction"`,
+  `auction_id` (every show the lines were won on, comma-joined, 0.16.0); the buyer when there is one (a guest cart when
   there isn't, or reading it fails). Each win is charged on the variant `useAuctionWins` shows: the
   recorded one when it belongs to the product, else the first that can be sold, else the first. Throws
   when there is nothing to check out or none of the wins can be sold.
@@ -787,13 +794,18 @@ const gate = useAuctionBidGate({
   screenOnShow: isFocused,               // back on show still signed out: the held bid is dropped
 });
 
-// gate.blocker: 'signIn' | 'unpaidWins' | 'terms' | 'variant' | null
+// gate.blocker: 'signIn' | 'blocked' | 'checkingAccount' | 'accountUnknown' | 'unpaidWins' | 'terms' | 'variant' | null
 gate.requestBid();        // the round's minimum — the slide gesture
 gate.requestBid(250);     // a custom bid
 gate.refusal;             // { id, reason: 'outbid' | 'overCap', amount } | null   (atAmountShown)
 gate.bidOnItsWay;         // true for BID_ON_ITS_WAY_MS (1.2 s) after a bid goes
 ```
 
+The store's bar (0.16.0): the provider's `viewerRestrictions` (on Shopify, the customer's `BIDBLOCKED` /
+`APPBLOCKED` tags, read by `viewerRestrictionsFromTags`). Barred, a bid stops at `blocked`, before unpaid wins. Not read yet, it waits at
+`checkingAccount` ("Checking your account…") while they are read again, then goes on (or stops at `blocked`);
+not read within `ACCOUNT_CHECK_LIMIT_MS` (10 s) it is dropped at `accountUnknown`.
+
 Signed in → nothing outstanding on another stream → rules accepted once per install → a variant chosen
 (once per round, not per bid). The requested bid is held while you clear the blockers and then placed, so
 finishing the last panel completes the bid they originally asked for. A held bid belongs to its round:
@@ -877,8 +889,11 @@ const lots = useSilentAuctionLots({ order, screenOnShow: useIsFocused(), pollInt
 // lots.status, lots.items ({ lot, product }), lots.upcoming, lots.refresh(), lots.readingAhead, lots.hasMore
 
 // The product page's console.
+// The page reads the auction metafields on its own read (0.16.0; never with every product: winners' emails):
+const page = useProductPage(handle, { metafields: AUCTION_METAFIELDS.product, variantMetafields: AUCTION_METAFIELDS.variant });
 const auction = useSilentAuctionLot(product?.id ?? null, { customerId, signedIn, email, variantId, screenOnShow: useIsFocused() });
-const bar = productPageBuyBar({ lot: auction.lot, lotStatus: auction.status, ...gatesFromTheProduct, nowMs: Date.now() });
+const bar = productPageBuyBar({ lot: auction.lot, lotStatus: auction.status, ...productAuctionGates(page.product, variantId), nowMs: Date.now() });
+// A copy read without them (a card's, the device's) is not known: neither bar shows until the page's read lands.
 // auction.nextBid, auction.bidCap, auction.leading, auction.phase, auction.extended, auction.placeBid(amount?)
 
 // My Bids.
@@ -1109,6 +1124,34 @@ can be driven with no room, socket or React — from Node, import it as
 - **Consuming via `file:` or a workspace link?** Hoist `@types/react`. The `.d.ts` otherwise resolves
   against the SDK's own nested copy, and React 18's `ReactNode` isn't assignable to React 19's.
 
+**A product's featured clip** (0.15.3; read as 33.2.0 did since 0.16.0): `useFeaturedClip(product.id, { enabled })`
+(or `liveSelling.clips.featuredForProduct`) is the clip the merchant ranked first for that product, cut to its
+window (`videoUrl`, `startMs`, `endMs`), with its products and `recordingId` / `streamingId` to open it on Replay
+(the route's `clip`), or null. `isCopyOfClip(media, clip)` spots Shopify's own copy of it among the product's videos.
+
+**The store-data standard** (0.16.0, `storeData.ts`): `BID_BLOCKED_TAG`, `APP_BLOCKED_TAG`, `LOT_TAG`,
+`AUCTION_METAFIELDS` and `viewerRestrictionsFrom(tags)`. Every store sets its Shopify data up to match;
+sdk-shopify names none of them, so the app passes them where it reads (the product page's own metafields, a
+search `queryTemplate` such as `{query}* -tag:${LOT_TAG}` for a store that hides lots from search).
+
+**A wins checkout that can't be trusted is refused** (0.16.0): `createAuctionCheckout` throws
+`CheckoutRefusedError` (its message is for the shopper) for a won item that can't be bought any more, a win with
+no winning price above 0, or no auction id; `useAuctionWins().error` shows the message.
+
+**Also new in 0.16.0** (details in the CHANGELOG):
+
+| What | Where |
+| --- | --- |
+| A barred or not-yet-read viewer's bid | the gate's `blocked`, `checkingAccount`, `accountUnknown` steps; `ACCOUNT_CHECK_LIMIT_MS`, `RESTRICTIONS_REFRESH_MS` |
+| The reaction limit | `reactionButton.limitNotice` (`{ id, message }`); `createReactionBudget()` |
+| Recent clips for a store with no reel | `clips.recent()`, `useClips({ source: 'recent', enabled })` |
+| Replay of a clip | the Replay route's `clip` (a `ClipItem`); `replayClipWindow`, `replayOfClip` |
+| Replay's taps and end | `useReplayPage({ tapVideo: 'showControls', controlsShowMs })`; `player.finished` |
+| A silent auction's last bid variant | `useSilentAuctionLot().bidVariantId` |
+| Lots kept on a failed refresh | `useSilentAuctionLots().refreshFailed` |
+| The wins cart | `_lotNumber` (`LOT_NUMBER_KEY`), `winningBidKey`, `auctionIdsOf`, `CheckoutRefusedError` |
+| Giveaway prizes onto the cart | `config.giveawayPrizes`, `collectGiveawayPrizes`, `useGiveawayPrizes({ active })` (default: the screen's focus) |
+
 ## Not included
 
 UI beyond the bubbles (`/ui`) · a storefront · navigation (the pages take the app's `routes`) · a static

package/dist/attribution.d.ts

@@ -6,13 +6,27 @@ export type AttributionSource = {
 } | {
     type: 'replay';
     showId: string;
+} | {
+    type: 'auction';
+    showId: string;
+} | {
+    type: 'auction-replay';
+    showId: string;
+} | {
+    type: 'silent-auction';
+    showId: string;
 } | {
     type: 'app';
 };
+/** A show on air: `auction` for an auction show (`isAuction`), else `live`; by its streamingId. */
 export declare function liveAttributionSourceFor(stream: {
     streamingId: string;
     status: LiveStreamStatus;
+    isAuction?: boolean;
 } | null): AttributionSource | null;
-/** Takes the streamingId of the show the replay is of, never the replay feed id. */
-export declare function replayAttributionSourceFor(showStreamingId: string | null): AttributionSource | null;
+/**
+ * Takes the streamingId of the show the replay is of, never the replay feed id: `auction-replay` for an
+ * auction show's recording, else `replay`.
+ */
+export declare function replayAttributionSourceFor(showStreamingId: string | null, isAuction?: boolean): AttributionSource | null;
 //# sourceMappingURL=attribution.d.ts.map

package/dist/attribution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attribution.d.ts","sourceRoot":"","sources":["../src/attribution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,uGAAuG;AACvG,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC;AAEpB,wBAAgB,wBAAwB,CACtC,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,GAAG,IAAI,GAC/D,iBAAiB,GAAG,IAAI,CAE1B;AAED,oFAAoF;AACpF,wBAAgB,0BAA0B,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,iBAAiB,GAAG,IAAI,CAEnG"}
+{"version":3,"file":"attribution.d.ts","sourceRoot":"","sources":["../src/attribution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,uGAAuG;AACvG,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC;AAEpB,mGAAmG;AACnG,wBAAgB,wBAAwB,CACtC,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,GACpF,iBAAiB,GAAG,IAAI,CAG1B;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,UAAQ,GAAG,iBAAiB,GAAG,IAAI,CAEtH"}

package/dist/attribution.js

@@ -2,11 +2,17 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.liveAttributionSourceFor = liveAttributionSourceFor;
 exports.replayAttributionSourceFor = replayAttributionSourceFor;
+/** A show on air: `auction` for an auction show (`isAuction`), else `live`; by its streamingId. */
 function liveAttributionSourceFor(stream) {
-    return (stream === null || stream === void 0 ? void 0 : stream.status) === 'live' ? { type: 'live', showId: stream.streamingId } : null;
+    if ((stream === null || stream === void 0 ? void 0 : stream.status) !== 'live')
+        return null;
+    return { type: stream.isAuction ? 'auction' : 'live', showId: stream.streamingId };
 }
-/** Takes the streamingId of the show the replay is of, never the replay feed id. */
-function replayAttributionSourceFor(showStreamingId) {
-    return showStreamingId ? { type: 'replay', showId: showStreamingId } : null;
+/**
+ * Takes the streamingId of the show the replay is of, never the replay feed id: `auction-replay` for an
+ * auction show's recording, else `replay`.
+ */
+function replayAttributionSourceFor(showStreamingId, isAuction = false) {
+    return showStreamingId ? { type: isAuction ? 'auction-replay' : 'replay', showId: showStreamingId } : null;
 }
 //# sourceMappingURL=attribution.js.map

package/dist/attribution.js.map

@@ -1 +1 @@
-{"version":3,"file":"attribution.js","sourceRoot":"","sources":["../src/attribution.ts"],"names":[],"mappings":";;AAQA,4DAIC;AAGD,gEAEC;AATD,SAAgB,wBAAwB,CACtC,MAAgE;IAEhE,OAAO,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,MAAM,MAAK,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACzF,CAAC;AAED,oFAAoF;AACpF,SAAgB,0BAA0B,CAAC,eAA8B;IACvE,OAAO,eAAe,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9E,CAAC"}
+{"version":3,"file":"attribution.js","sourceRoot":"","sources":["../src/attribution.ts"],"names":[],"mappings":";;AAYA,4DAKC;AAMD,gEAEC;AAdD,mGAAmG;AACnG,SAAgB,wBAAwB,CACtC,MAAqF;IAErF,IAAI,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,MAAM,MAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;AACrF,CAAC;AAED;;;GAGG;AACH,SAAgB,0BAA0B,CAAC,eAA8B,EAAE,SAAS,GAAG,KAAK;IAC1F,OAAO,eAAe,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7G,CAAC"}

package/dist/auctions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auctions.d.ts","sourceRoot":"","sources":["../src/auctions.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAA+B,WAAW,EAAE,MAAM,SAAS,CAAC;AA8FxE,eAAO,MAAM,QAAQ,EAAE,WAkGtB,CAAC"}
+{"version":3,"file":"auctions.d.ts","sourceRoot":"","sources":["../src/auctions.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAA+B,WAAW,EAAE,MAAM,SAAS,CAAC;AA8FxE,eAAO,MAAM,QAAQ,EAAE,WAkGtB,CAAC"}

package/dist/auctions.js

@@ -13,6 +13,7 @@ exports.auctions = void 0;
  * token and so goes through the injected `customerAccountRequest`.
  */
 const client_1 = require("./client");
+const cartAttributes_1 = require("./cartAttributes");
 const TERMS_KEY = 'auction.termsAccepted';
 // ─── Unpaid wins (customer-account metafield) ────────────────────────────────
 const UNPAID_WINS_QUERY = /* GraphQL */ `
@@ -25,7 +26,7 @@ const UNPAID_WINS_QUERY = /* GraphQL */ `
   }
 `;
 /** A silent auction's wins are recorded under a key of their own, `silent_…` (0.12.0). */
-const SILENT_KEY_PREFIX = 'silent_';
+const SILENT_KEY_PREFIX = cartAttributes_1.SILENT_AUCTION_KEY_PREFIX;
 async function fetchWinnerMetafield() {
     var _a, _b;
     const customerAccountRequest = (0, client_1.getCustomerAccountRequest)();

package/dist/auctions.js.map

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

package/dist/cartAttributes.d.ts

@@ -7,11 +7,21 @@ import type { CartLineAttribute, CommerceAdapter } from './sessionTypes';
 import type { LiveStreamStatus } from './types';
 export declare const LIVE_STREAM_ID_ATTRIBUTE = "_stream_id";
 export declare const REPLAY_ID_ATTRIBUTE = "_replay_id";
+/** A silent auction's win, by the auction's id (its `silent_…` key without the prefix). */
+export declare const SILENT_AUCTION_ID_ATTRIBUTE = "_silent_auction_id";
 /** Gates on the record's own status, not the session's derived one: only a show on air earns the tag. */
 export declare function liveCartAttributesFor(stream: {
     streamingId: string;
     status: LiveStreamStatus;
 } | null): CartLineAttribute[];
+/** A silent auction's wins are recorded under a key of their own, `silent_…` (0.12.0): no live show. */
+export declare const SILENT_AUCTION_KEY_PREFIX = "silent_";
+/**
+ * Where a won lot came from, for its line of the wins cart (0.16.0), so the order says what sold it: the
+ * live show's `_stream_id`, as an add during the show carries it, or a silent auction's
+ * `_silent_auction_id`. None without either.
+ */
+export declare function wonLotAttributesFor(streamingId: string | null | undefined): CartLineAttribute[];
 export declare function replayCartAttributesFor(replayId: string | null): CartLineAttribute[];
 export declare function addLiveLine(adapter: CommerceAdapter<unknown> | null, stream: {
     streamingId: string;

package/dist/cartAttributes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cartAttributes.d.ts","sourceRoot":"","sources":["../src/cartAttributes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,eAAO,MAAM,wBAAwB,eAAe,CAAC;AACrD,eAAO,MAAM,mBAAmB,eAAe,CAAC;AAEhD,yGAAyG;AACzG,wBAAgB,qBAAqB,CACnC,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,GAAG,IAAI,GAC/D,iBAAiB,EAAE,CAIrB;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,iBAAiB,EAAE,CAEpF;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,IAAI,EACxC,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,GAAG,IAAI,EAChE,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAGlB"}
+{"version":3,"file":"cartAttributes.d.ts","sourceRoot":"","sources":["../src/cartAttributes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,eAAO,MAAM,wBAAwB,eAAe,CAAC;AACrD,eAAO,MAAM,mBAAmB,eAAe,CAAC;AAChD,2FAA2F;AAC3F,eAAO,MAAM,2BAA2B,uBAAuB,CAAC;AAEhE,yGAAyG;AACzG,wBAAgB,qBAAqB,CACnC,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,GAAG,IAAI,GAC/D,iBAAiB,EAAE,CAIrB;AAED,wGAAwG;AACxG,eAAO,MAAM,yBAAyB,YAAY,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,iBAAiB,EAAE,CAM/F;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,iBAAiB,EAAE,CAEpF;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,IAAI,EACxC,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,GAAG,IAAI,EAChE,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAGlB"}

package/dist/cartAttributes.js

@@ -1,17 +1,36 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.REPLAY_ID_ATTRIBUTE = exports.LIVE_STREAM_ID_ATTRIBUTE = void 0;
+exports.SILENT_AUCTION_KEY_PREFIX = exports.SILENT_AUCTION_ID_ATTRIBUTE = exports.REPLAY_ID_ATTRIBUTE = exports.LIVE_STREAM_ID_ATTRIBUTE = void 0;
 exports.liveCartAttributesFor = liveCartAttributesFor;
+exports.wonLotAttributesFor = wonLotAttributesFor;
 exports.replayCartAttributesFor = replayCartAttributesFor;
 exports.addLiveLine = addLiveLine;
 exports.LIVE_STREAM_ID_ATTRIBUTE = '_stream_id';
 exports.REPLAY_ID_ATTRIBUTE = '_replay_id';
+/** A silent auction's win, by the auction's id (its `silent_…` key without the prefix). */
+exports.SILENT_AUCTION_ID_ATTRIBUTE = '_silent_auction_id';
 /** Gates on the record's own status, not the session's derived one: only a show on air earns the tag. */
 function liveCartAttributesFor(stream) {
     return (stream === null || stream === void 0 ? void 0 : stream.status) === 'live'
         ? [{ key: exports.LIVE_STREAM_ID_ATTRIBUTE, value: stream.streamingId }]
         : [];
 }
+/** A silent auction's wins are recorded under a key of their own, `silent_…` (0.12.0): no live show. */
+exports.SILENT_AUCTION_KEY_PREFIX = 'silent_';
+/**
+ * Where a won lot came from, for its line of the wins cart (0.16.0), so the order says what sold it: the
+ * live show's `_stream_id`, as an add during the show carries it, or a silent auction's
+ * `_silent_auction_id`. None without either.
+ */
+function wonLotAttributesFor(streamingId) {
+    const id = streamingId === null || streamingId === void 0 ? void 0 : streamingId.trim();
+    if (!id)
+        return [];
+    if (!id.startsWith(exports.SILENT_AUCTION_KEY_PREFIX))
+        return [{ key: exports.LIVE_STREAM_ID_ATTRIBUTE, value: id }];
+    const auctionId = id.slice(exports.SILENT_AUCTION_KEY_PREFIX.length).trim();
+    return auctionId ? [{ key: exports.SILENT_AUCTION_ID_ATTRIBUTE, value: auctionId }] : [];
+}
 function replayCartAttributesFor(replayId) {
     return replayId ? [{ key: exports.REPLAY_ID_ATTRIBUTE, value: replayId }] : [];
 }

package/dist/cartAttributes.js.map

@@ -1 +1 @@
-{"version":3,"file":"cartAttributes.js","sourceRoot":"","sources":["../src/cartAttributes.ts"],"names":[],"mappings":";;;AAYA,sDAMC;AAED,0DAEC;AAED,kCAOC;AAvBY,QAAA,wBAAwB,GAAG,YAAY,CAAC;AACxC,QAAA,mBAAmB,GAAG,YAAY,CAAC;AAEhD,yGAAyG;AACzG,SAAgB,qBAAqB,CACnC,MAAgE;IAEhE,OAAO,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,MAAM,MAAK,MAAM;QAC9B,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,gCAAwB,EAAE,KAAK,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;QAChE,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,SAAgB,uBAAuB,CAAC,QAAuB;IAC7D,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,2BAAmB,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACzE,CAAC;AAEM,KAAK,UAAU,WAAW,CAC/B,OAAwC,EACxC,MAAgE,EAChE,SAAiB;IAEjB,IAAI,CAAC,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,CAAA;QAAE,OAAO,KAAK,CAAC;IACpC,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;AACtE,CAAC"}
+{"version":3,"file":"cartAttributes.js","sourceRoot":"","sources":["../src/cartAttributes.ts"],"names":[],"mappings":";;;AAcA,sDAMC;AAUD,kDAMC;AAED,0DAEC;AAED,kCAOC;AAzCY,QAAA,wBAAwB,GAAG,YAAY,CAAC;AACxC,QAAA,mBAAmB,GAAG,YAAY,CAAC;AAChD,2FAA2F;AAC9E,QAAA,2BAA2B,GAAG,oBAAoB,CAAC;AAEhE,yGAAyG;AACzG,SAAgB,qBAAqB,CACnC,MAAgE;IAEhE,OAAO,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,MAAM,MAAK,MAAM;QAC9B,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,gCAAwB,EAAE,KAAK,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;QAChE,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,wGAAwG;AAC3F,QAAA,yBAAyB,GAAG,SAAS,CAAC;AAEnD;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,WAAsC;IACxE,MAAM,EAAE,GAAG,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,IAAI,EAAE,CAAC;IAC/B,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,iCAAyB,CAAC;QAAE,OAAO,CAAC,EAAE,GAAG,EAAE,gCAAwB,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IACrG,MAAM,SAAS,GAAG,EAAE,CAAC,KAAK,CAAC,iCAAyB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACpE,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,mCAA2B,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACnF,CAAC;AAED,SAAgB,uBAAuB,CAAC,QAAuB;IAC7D,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,2BAAmB,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACzE,CAAC;AAEM,KAAK,UAAU,WAAW,CAC/B,OAAwC,EACxC,MAAgE,EAChE,SAAiB;IAEjB,IAAI,CAAC,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,CAAA;QAAE,OAAO,KAAK,CAAC;IACpC,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;AACtE,CAAC"}

package/dist/checkoutRefused.d.ts

@@ -0,0 +1,9 @@
+/**
+ * A wins checkout refused rather than charge a wrong price or leave a lot unsettled (0.16.0, as Spark*l's
+ * 33.2.0 refused it): a won item that can't be bought any more, a win with no winning price, or no auction
+ * to settle. Its `message` is for the shopper, saying what to do; `useAuctionWins().error` shows it as it is.
+ */
+export declare class CheckoutRefusedError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=checkoutRefused.d.ts.map

package/dist/checkoutRefused.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkoutRefused.d.ts","sourceRoot":"","sources":["../src/checkoutRefused.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/checkoutRefused.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CheckoutRefusedError = void 0;
+/**
+ * A wins checkout refused rather than charge a wrong price or leave a lot unsettled (0.16.0, as Spark*l's
+ * 33.2.0 refused it): a won item that can't be bought any more, a win with no winning price, or no auction
+ * to settle. Its `message` is for the shopper, saying what to do; `useAuctionWins().error` shows it as it is.
+ */
+class CheckoutRefusedError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'CheckoutRefusedError';
+    }
+}
+exports.CheckoutRefusedError = CheckoutRefusedError;
+//# sourceMappingURL=checkoutRefused.js.map

package/dist/checkoutRefused.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkoutRefused.js","sourceRoot":"","sources":["../src/checkoutRefused.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,MAAa,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AALD,oDAKC"}

package/dist/clips.d.ts

@@ -1,7 +1,9 @@
 import type { ClipItem, ClipsAPI } from './types';
 /**
- * The featured clip among a product's clips: the first with `pdp_rank` 1 (the gateway puts it first),
- * active and with a playlist; null when the merchant has featured none. Pure, for tests.
+ * The featured clip among a product's clips (`rows`, or the gateway's `{ data: rows }`): the first ranked 1
+ * (`pdp_rank` 1 or "1"; the gateway puts it first), active, with a playlist and an id; null when the merchant
+ * has featured none. Its window, products and poster as above; `recordingId` / `streamingId` open it on
+ * Replay with its chat (0.16.0). Pure, for tests.
  */
 export declare function featuredClipOf(rows: unknown): ClipItem | null;
 /** A Shopify product video is the clip worker's copy of `clip` (its alt names the clip), so not shown twice. */

package/dist/clips.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clips.d.ts","sourceRoot":"","sources":["../src/clips.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAsClD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,CAgB7D;AAKD,gHAAgH;AAChH,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAGtI;AAKD,eAAO,MAAM,KAAK,EAAE,QAkCnB,CAAC"}
+{"version":3,"file":"clips.d.ts","sourceRoot":"","sources":["../src/clips.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AA+ElD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,CAoB7D;AAKD,gHAAgH;AAChH,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAGtI;AAKD,eAAO,MAAM,KAAK,EAAE,QA2DnB,CAAC"}

package/dist/clips.js

@@ -13,28 +13,65 @@ exports.isCopyOfClip = isCopyOfClip;
  * applied, and each clip silently plays a whole show from the top.
  */
 const client_1 = require("./client");
+/** Recordings read, and of those how many asked for their clips, by `clips.recent()`. */
+const RECENT_CLIPS_RECORDINGS = 10;
+const RECENT_CLIPS_PROBES = 4;
+function chunkToClip(chunk, index, recordingId) {
+    var _a, _b, _c;
+    const source = (chunk.streaming_url || chunk.url || '').trim();
+    if (!source)
+        return null;
+    return {
+        id: chunk._id || `${recordingId}-clip-${index}`,
+        title: ((_a = chunk.title) === null || _a === void 0 ? void 0 : _a.trim()) || '',
+        posterUrl: ((_b = chunk.thumbnail) === null || _b === void 0 ? void 0 : _b.trim()) || ((_c = chunk.thumbnail_image) === null || _c === void 0 ? void 0 : _c.trim()) || null,
+        productIds: clipProductIds(chunk),
+        recordingId: chunk.feed_id || recordingId,
+        ...clipWindowOf(source, chunk),
+    };
+}
 /**
- * Splits the trim window off the playlist URL. Read with a regex rather than `URL.searchParams`, which
- * React Native does not implement for reading a parsed URL back.
+ * A clip's window in its recording, and the playlist without the inert trim params: the row's own segment
+ * times when it has both (end after start), else the URL's `?start=&end=` (ms, each on its own). An end at or
+ * before the start is dropped. Read with a regex rather than `URL.searchParams`, which React Native does not
+ * implement for reading a parsed URL back.
  */
-function readTrimWindow(url) {
+function clipWindowOf(url, segment) {
     const [videoUrl, query = ''] = url.split('?');
+    const start = segment === null || segment === void 0 ? void 0 : segment.segment_start_time;
+    const end = segment === null || segment === void 0 ? void 0 : segment.segment_end_time;
+    if (typeof start === 'number' && typeof end === 'number' && end > start)
+        return { videoUrl, startMs: start, endMs: end };
     const readMs = (key) => {
-        const found = query.match(new RegExp(`(?:^|&)${key}=(\\d+)`));
+        const found = query.match(new RegExp(`(?:^|&)${key}=(\\d+(?:\\.\\d+)?)`));
         return found ? Number(found[1]) : null;
     };
-    return { videoUrl, startMs: readMs('start'), endMs: readMs('end') };
+    const startMs = readMs('start');
+    const endMs = readMs('end');
+    return { videoUrl, startMs, endMs: endMs !== null && startMs !== null && endMs <= startMs ? null : endMs };
+}
+/** The products a clip sells: its lots (`product_info`, links left out), else `product_ids`; as Shopify gids. */
+function clipProductIds(row) {
+    var _a, _b;
+    const lots = ((_a = row.product_info) !== null && _a !== void 0 ? _a : [])
+        .filter((info) => !!(info === null || info === void 0 ? void 0 : info.store_product_id) && info.product_type !== 'url')
+        .map((info) => info.store_product_id);
+    return (lots.length ? lots : (_b = row.product_ids) !== null && _b !== void 0 ? _b : []).map(client_1.toProductGid);
 }
 /**
- * The featured clip among a product's clips: the first with `pdp_rank` 1 (the gateway puts it first),
- * active and with a playlist; null when the merchant has featured none. Pure, for tests.
+ * The featured clip among a product's clips (`rows`, or the gateway's `{ data: rows }`): the first ranked 1
+ * (`pdp_rank` 1 or "1"; the gateway puts it first), active, with a playlist and an id; null when the merchant
+ * has featured none. Its window, products and poster as above; `recordingId` / `streamingId` open it on
+ * Replay with its chat (0.16.0). Pure, for tests.
  */
 function featuredClipOf(rows) {
-    var _a, _b, _c, _d, _e, _f, _g, _h;
-    if (!Array.isArray(rows))
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+    const list = Array.isArray(rows) ? rows : rows === null || rows === void 0 ? void 0 : rows.data;
+    if (!Array.isArray(list))
         return null;
-    for (const row of rows) {
-        if (!row || row.pdp_rank !== 1 || row.is_active === false)
+    for (const row of list) {
+        // eslint-disable-next-line eqeqeq -- the gateway sends the rank as a number or a string.
+        if (!row || row.pdp_rank == null || row.pdp_rank != 1 || row.is_active === false)
             continue;
         const url = ((_a = row.streaming_url) === null || _a === void 0 ? void 0 : _a.trim()) || ((_b = row.url) === null || _b === void 0 ? void 0 : _b.trim());
         const id = ((_c = row._id) === null || _c === void 0 ? void 0 : _c.trim()) || ((_d = row.feed_id) === null || _d === void 0 ? void 0 : _d.trim());
@@ -44,8 +81,10 @@ function featuredClipOf(rows) {
             id,
             title: ((_e = row.title) === null || _e === void 0 ? void 0 : _e.trim()) || '',
             posterUrl: ((_f = row.thumbnail) === null || _f === void 0 ? void 0 : _f.trim()) || ((_g = row.thumbnail_image) === null || _g === void 0 ? void 0 : _g.trim()) || null,
-            productIds: ((_h = row.product_ids) !== null && _h !== void 0 ? _h : []).map(client_1.toProductGid),
-            ...readTrimWindow(url),
+            productIds: clipProductIds(row),
+            recordingId: ((_h = row.feed_id) === null || _h === void 0 ? void 0 : _h.trim()) || null,
+            streamingId: ((_j = row.streaming_id) === null || _j === void 0 ? void 0 : _j.trim()) || null,
+            ...clipWindowOf(url, row),
         };
     }
     return null;
@@ -83,10 +122,32 @@ exports.clips = {
                 title: ((_a = item.title) === null || _a === void 0 ? void 0 : _a.trim()) || '',
                 posterUrl: ((_b = item.thumbnail) === null || _b === void 0 ? void 0 : _b.trim()) || null,
                 productIds: ((_c = item.product_ids) !== null && _c !== void 0 ? _c : []).map(client_1.toProductGid),
-                ...readTrimWindow(item.url),
+                ...clipWindowOf(item.url),
             });
         });
     },
+    async recent({ recordings = RECENT_CLIPS_RECORDINGS, probes = RECENT_CLIPS_PROBES } = {}) {
+        var _a, _b, _c, _d;
+        const body = await (0, client_1.liveSellingRequest)(
+        // The service resolves the company from the header and never reads this path segment.
+        '/widget/plugin/shoppable-feeds/app', { params: { limit: recordings } });
+        const recordingIds = ((_b = (_a = body.data) === null || _a === void 0 ? void 0 : _a.feeds) !== null && _b !== void 0 ? _b : []).map((feed) => feed === null || feed === void 0 ? void 0 : feed.feed_id).filter((id) => !!id);
+        for (const recordingId of recordingIds.slice(0, probes)) {
+            let rows = [];
+            try {
+                const page = await (0, client_1.liveSellingRequest)('/live-streaming/plugin/shoppable-feeds/chunks', { params: { shoppable_feed_id: recordingId, page: 1 } });
+                rows = (_d = (_c = page.data) === null || _c === void 0 ? void 0 : _c.streaming_shoppable_feeds) !== null && _d !== void 0 ? _d : [];
+            }
+            catch {
+                // A recording that can't be cut into clips isn't the reel failing: the next one is asked.
+                continue;
+            }
+            const found = rows.map((row, index) => chunkToClip(row, index, recordingId)).filter((clip) => !!clip);
+            if (found.length)
+                return found;
+        }
+        return [];
+    },
     async featuredForProduct(productId) {
         const productNumber = productNumberOf(productId);
         if (!productNumber)
@@ -94,7 +155,7 @@ exports.clips = {
         const body = await (0, client_1.liveSellingRequest)('/shoppable-feeds/product/v2', {
             params: { store_product_id: productNumber, company_id: (0, client_1.getConfig)().companyId },
         });
-        return featuredClipOf(body === null || body === void 0 ? void 0 : body.data);
+        return featuredClipOf(body);
     },
 };
 //# sourceMappingURL=clips.js.map

package/dist/clips.js.map

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

package/dist/giveawayPrizes.d.ts

@@ -0,0 +1,20 @@
+export interface GiveawayPrizesConfig {
+    /** The giveaway service's base URL. */
+    url: string;
+    /** The store's Apptile app id, which the service files claims under. */
+    appId: string;
+}
+export interface GiveawayPrizeCollection {
+    /** Prizes owed, delivered or not. */
+    pending: number;
+    /** Claims that landed in the cart on this call: re-read the cart when there are any. */
+    delivered: string[];
+}
+/** The service's answer, read. A 409 (the cart is gone) and any other refusal: nothing collected. */
+export declare function prizeCollectionFrom(status: number, body: unknown): GiveawayPrizeCollection | null;
+/**
+ * Collects what `customerId` (Shopify's numeric id or GID) has won into `cartId`, or reports what is owed
+ * when there is no cart. Null when unconfigured, refused or unreachable; never throws.
+ */
+export declare function collectGiveawayPrizes(customerId: string, cartId: string | null): Promise<GiveawayPrizeCollection | null>;
+//# sourceMappingURL=giveawayPrizes.d.ts.map

package/dist/giveawayPrizes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"giveawayPrizes.d.ts","sourceRoot":"","sources":["../src/giveawayPrizes.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,oBAAoB;IACnC,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,wFAAwF;IACxF,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,qGAAqG;AACrG,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,uBAAuB,GAAG,IAAI,CAOjG;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAoB9H"}

package/dist/giveawayPrizes.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prizeCollectionFrom = prizeCollectionFrom;
+exports.collectGiveawayPrizes = collectGiveawayPrizes;
+/**
+ * Giveaway prizes onto the shopper's current cart (0.16.0). A won prize stays a claim on Apptile's
+ * giveaway service until an order pays for it, so it can go into whatever cart the shopper has now
+ * (the one they entered with is usually checked out by then). Given a cart, the service adds the line,
+ * its code and its prize stamp, and says what it delivered; without one it only says what is owed.
+ */
+const client_1 = require("./client");
+/** The service's answer, read. A 409 (the cart is gone) and any other refusal: nothing collected. */
+function prizeCollectionFrom(status, body) {
+    if (status < 200 || status >= 300)
+        return null;
+    const record = (body !== null && body !== void 0 ? body : {});
+    return {
+        pending: typeof record.pending === 'number' ? record.pending : 0,
+        delivered: Array.isArray(record.delivered) ? record.delivered.filter((key) => typeof key === 'string') : [],
+    };
+}
+/**
+ * Collects what `customerId` (Shopify's numeric id or GID) has won into `cartId`, or reports what is owed
+ * when there is no cart. Null when unconfigured, refused or unreachable; never throws.
+ */
+async function collectGiveawayPrizes(customerId, cartId) {
+    const config = (0, client_1.isConfigured)() ? (0, client_1.getConfig)().giveawayPrizes : undefined;
+    if (!(config === null || config === void 0 ? void 0 : config.url) || !customerId)
+        return null;
+    const url = `${config.url.replace(/\/$/, '')}/hydrate`;
+    try {
+        return await (0, client_1.withRequestTimeout)(url, async (signal) => {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                body: JSON.stringify({ appId: config.appId, customerId: customerId.split('/').pop(), cartId }),
+                signal,
+            });
+            const body = await response.json().catch(() => null);
+            if (!response.ok && response.status !== 409)
+                (0, client_1.getLogger)().error(new Error(`giveaway prizes refused: ${response.status}`), { at: 'giveawayPrizes' });
+            return prizeCollectionFrom(response.status, body);
+        });
+    }
+    catch (caught) {
+        (0, client_1.getLogger)().error(caught, { at: 'giveawayPrizes' });
+        return null;
+    }
+}
+//# sourceMappingURL=giveawayPrizes.js.map

package/dist/giveawayPrizes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"giveawayPrizes.js","sourceRoot":"","sources":["../src/giveawayPrizes.ts"],"names":[],"mappings":";;AAuBA,kDAOC;AAMD,sDAoBC;AAxDD;;;;;GAKG;AACH,qCAAkF;AAgBlF,qGAAqG;AACrG,SAAgB,mBAAmB,CAAC,MAAc,EAAE,IAAa;IAC/D,IAAI,MAAM,GAAG,GAAG,IAAI,MAAM,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC;IAC/C,MAAM,MAAM,GAAG,CAAC,IAAI,aAAJ,IAAI,cAAJ,IAAI,GAAI,EAAE,CAA+C,CAAC;IAC1E,OAAO;QACL,OAAO,EAAE,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAChE,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAiB,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;KAC3H,CAAC;AACJ,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,qBAAqB,CAAC,UAAkB,EAAE,MAAqB;IACnF,MAAM,MAAM,GAAG,IAAA,qBAAY,GAAE,CAAC,CAAC,CAAC,IAAA,kBAAS,GAAE,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;IACvE,IAAI,CAAC,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,GAAG,CAAA,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAC7C,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC;IACvD,IAAI,CAAC;QACH,OAAO,MAAM,IAAA,2BAAkB,EAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACpD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC;gBAC9F,MAAM;aACP,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACrD,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;gBAAE,IAAA,kBAAS,GAAE,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,4BAA4B,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,gBAAgB,EAAE,CAAC,CAAC;YACnJ,OAAO,mBAAmB,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,IAAA,kBAAS,GAAE,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,gBAAgB,EAAE,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}