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

package/dist/shopifyCommerce.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WIN_INDEX_KEY = exports.WINNING_BID_KEY = exports.AUCTION_CART_SOURCE_TYPE = void 0;
+exports.liveProductFromShopify = liveProductFromShopify;
+exports.chargedVariantId = chargedVariantId;
+exports.createShopifyLiveCommerce = createShopifyLiveCommerce;
+const shopifyIds_1 = require("./shopifyIds");
+/** The attributes the order webhook matches on (`source_type`, `auction_id`). They must never change. */
+exports.AUCTION_CART_SOURCE_TYPE = 'auction';
+/** The line attribute the store's cart transform reprices a won lot to. */
+exports.WINNING_BID_KEY = '_winningBid';
+/** The line attribute that keeps two identical wins on two lines. */
+exports.WIN_INDEX_KEY = '_winIndex';
+/** A Shopify product as the session's thinner shape, with the product itself kept on `raw`. */
+function liveProductFromShopify(product) {
+    var _a, _b;
+    return {
+        id: product.id,
+        storeProductId: (0, shopifyIds_1.bareId)(product.id),
+        title: product.title,
+        price: product.priceRange.min.amount,
+        currencyCode: product.priceRange.min.currencyCode,
+        imageUrl: (_b = (_a = product.featuredImage) === null || _a === void 0 ? void 0 : _a.url) !== null && _b !== void 0 ? _b : null,
+        variants: product.variants.map((variant) => {
+            var _a, _b;
+            return ({
+                id: variant.id,
+                title: variant.title,
+                price: variant.price.amount,
+                available: variant.availableForSale,
+                imageUrl: (_b = (_a = variant.image) === null || _a === void 0 ? void 0 : _a.url) !== null && _b !== void 0 ? _b : null,
+            });
+        }),
+        raw: product,
+    };
+}
+/**
+ * The variant a win is charged on, chosen as `useAuctionWins` chooses the one it shows: the recorded
+ * one when it belongs to the product, else the first that can be sold, else the first. The checkout
+ * can be handed the raw ledger, so it chooses again rather than trusting the id. Null when the product
+ * is gone from the store.
+ */
+function chargedVariantId(product, win) {
+    var _a, _b, _c;
+    if (!product)
+        return null;
+    if (win.variantId) {
+        const wanted = (0, shopifyIds_1.bareId)(String(win.variantId));
+        const recorded = product.variants.find((variant) => (0, shopifyIds_1.bareId)(variant.id) === wanted);
+        if (recorded)
+            return recorded.id;
+    }
+    return (_c = (_b = ((_a = product.variants.find((variant) => variant.availableForSale)) !== null && _a !== void 0 ? _a : product.variants[0])) === null || _b === void 0 ? void 0 : _b.id) !== null && _c !== void 0 ? _c : null;
+}
+/**
+ * The commerce adapter for a store on `@tiledev/sdk-shopify`.
+ *
+ * - **`productsByIds`:** one `products.byIds` read, the bare ids made into product GIDs, the photos at
+ *   `imageTransform`.
+ * - **`createAuctionCheckout`:** a cart of its own for the wins, never the shopping cart, so a stepper
+ *   can't change a settled price.
+ *   - **Each win is a line of one,** stamped for the store's cart transform: `_winningBid` (the bid it
+ *     reprices the line to) or `prizeWriteKey` (a prize), plus `_winIndex`, which stops Shopify merging
+ *     two identical wins into one line (the same lot won twice must cost twice).
+ *   - **The giveaway discount codes** go on the cart.
+ *   - **The cart says what it is:** `source_name`, `source_type: "auction"` and `auction_id` (the
+ *     show), which the order webhook matches to clear the winner's record. A checkout it can't match
+ *     leaves the shopper blocked from bidding after paying.
+ *   - **The buyer** is attached when there is one, so the checkout is theirs; a guest cart when there
+ *     isn't, or when reading it fails.
+ */
+function createShopifyLiveCommerce(options) {
+    const { shopify, cartSourceName, prizeWriteKey, buyer, imageTransform, extraLineAttributes, extraCartAttributes } = options;
+    async function productsByIds(storeProductIds) {
+        if (storeProductIds.length === 0)
+            return [];
+        const products = await shopify.products.byIds(storeProductIds.map(shopifyIds_1.productGid), imageTransform ? { imageTransform } : undefined);
+        return products.map(liveProductFromShopify);
+    }
+    async function createAuctionCheckout(wins, auctionId) {
+        if (wins.length === 0)
+            throw new Error('Nothing to check out');
+        const products = await shopify.products.byIds([...new Set(wins.map((win) => (0, shopifyIds_1.productGid)(win.productGid)))]);
+        const productsById = new Map(products.map((product) => [(0, shopifyIds_1.bareId)(product.id), product]));
+        const discountCodes = new Set();
+        const lines = [];
+        wins.forEach((win, index) => {
+            const variantId = chargedVariantId(productsById.get((0, shopifyIds_1.bareId)(win.productGid)), win);
+            if (!variantId)
+                return;
+            if (win.discountCode)
+                discountCodes.add(win.discountCode);
+            lines.push({
+                merchandiseId: variantId,
+                quantity: 1,
+                attributes: [
+                    win.isGiveaway
+                        ? { key: prizeWriteKey, value: 'true' }
+                        : { key: exports.WINNING_BID_KEY, value: String(win.winningBid) },
+                    { key: exports.WIN_INDEX_KEY, value: String(index) },
+                    ...(extraLineAttributes ? extraLineAttributes(win) : []),
+                ],
+            });
+        });
+        if (lines.length === 0)
+            throw new Error('None of the won items can be sold');
+        const buyerIdentity = await buyer().catch(() => null);
+        const cart = await shopify.cart.create({
+            lines,
+            discountCodes: [...discountCodes],
+            attributes: [
+                { key: 'source_name', value: cartSourceName },
+                { key: 'source_type', value: exports.AUCTION_CART_SOURCE_TYPE },
+                { key: 'auction_id', value: auctionId },
+                ...(extraCartAttributes ? extraCartAttributes(lines) : []),
+            ],
+            ...(buyerIdentity ? { buyerIdentity } : {}),
+        });
+        return { checkoutUrl: cart.checkoutUrl, cartId: cart.id };
+    }
+    return { productsByIds, createAuctionCheckout };
+}
+//# sourceMappingURL=shopifyCommerce.js.map

package/dist/shopifyCommerce.js.map

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

package/dist/shopifyIdentity.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Who is watching, bidding and paying, for an app signed in through `@tiledev/sdk-shopify`.
+ *
+ * A function the app calls with a reader, not a hook: a hook would have to call sdk-shopify's
+ * `useCustomer()` itself, from whichever copy of sdk-shopify this package found, which may not be the
+ * one the app signed in with (see `shopifyCommerce.ts`). The app keeps its own `useCustomer()` result
+ * in a ref and passes `() => ref.current`.
+ */
+import type { CustomerAccountRequest } from './types';
+import type { IdentityAdapter } from './sessionTypes';
+import type { ShopifyBuyer } from './shopifyCommerce';
+/** The parts of sdk-shopify's `useCustomer()` result this file reads. */
+export interface ShopifyCustomerSession {
+    loggedIn: boolean;
+    /** How the shopper signed in: `'shopify'` (Shopify's own sign-in) or `'password'`; null when signed out. */
+    sessionKind: string | null;
+    customer: {
+        id: string;
+        email: string | null;
+        firstName: string | null;
+        lastName: string | null;
+    } | null;
+    /** A usable access token, refreshed when needed; null when signed out. */
+    getAccessToken(): Promise<string | null>;
+    /** A Customer Account API call for the signed-in shopper. */
+    request<T>(query: string, variables?: Record<string, unknown>): Promise<T>;
+}
+export interface ShopifyLiveIdentity {
+    /** For `LiveSellingConfig.identity`. */
+    identity: Required<IdentityAdapter>;
+    /** For `LiveSellingConfig.customerAccountRequest`: the customer's own `request`. */
+    customerAccountRequest: CustomerAccountRequest;
+    /** For `createShopifyLiveCommerce`'s `buyer`: the customer's access token and email; null when signed out. */
+    buyer: () => Promise<ShopifyBuyer | null>;
+}
+/**
+ * The identity, the Customer Account transport and the buyer, from the signed-in customer.
+ *
+ * `readCustomer` is called each time the SDK asks, so each answer is about the customer as they are
+ * then: sign in or out and the next bid, entry or checkout sees it.
+ *
+ * - **The bidder** is the customer's bare numeric id, the id the host's broadcast echoes back, and the
+ *   customer reference is their GID. Both only for a Shopify sign-in: the winner's record is on the
+ *   Customer Account API, so an email-and-password session can't bid or enter.
+ * - **The name** is first and last name, else the first name, else the part of their email before the
+ *   @ (`viewerNameFor`, 0.9.0); never the whole email. Null when signed out. Before 0.9.0 it was first
+ *   and last name or null, and a first name typed as an email was published whole.
+ * - **The buyer** is the customer's access token and email, for the wins cart.
+ */
+export declare function createShopifyLiveIdentity(readCustomer: () => ShopifyCustomerSession): ShopifyLiveIdentity;
+//# sourceMappingURL=shopifyIdentity.d.ts.map

package/dist/shopifyIdentity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shopifyIdentity.d.ts","sourceRoot":"","sources":["../src/shopifyIdentity.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAItD,yEAAyE;AACzE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,4GAA4G;IAC5G,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACzG,0EAA0E;IAC1E,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,6DAA6D;IAC7D,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC5E;AAED,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,QAAQ,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IACpC,oFAAoF;IACpF,sBAAsB,EAAE,sBAAsB,CAAC;IAC/C,8GAA8G;IAC9G,KAAK,EAAE,MAAM,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;CAC3C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,sBAAsB,GAAG,mBAAmB,CA8BzG"}

package/dist/shopifyIdentity.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createShopifyLiveIdentity = createShopifyLiveIdentity;
+const shopifyIds_1 = require("./shopifyIds");
+const showNames_1 = require("./showNames");
+/**
+ * The identity, the Customer Account transport and the buyer, from the signed-in customer.
+ *
+ * `readCustomer` is called each time the SDK asks, so each answer is about the customer as they are
+ * then: sign in or out and the next bid, entry or checkout sees it.
+ *
+ * - **The bidder** is the customer's bare numeric id, the id the host's broadcast echoes back, and the
+ *   customer reference is their GID. Both only for a Shopify sign-in: the winner's record is on the
+ *   Customer Account API, so an email-and-password session can't bid or enter.
+ * - **The name** is first and last name, else the first name, else the part of their email before the
+ *   @ (`viewerNameFor`, 0.9.0); never the whole email. Null when signed out. Before 0.9.0 it was first
+ *   and last name or null, and a first name typed as an email was published whole.
+ * - **The buyer** is the customer's access token and email, for the wins cart.
+ */
+function createShopifyLiveIdentity(readCustomer) {
+    const signedInWithShopify = () => {
+        const current = readCustomer();
+        return current.loggedIn && current.sessionKind === 'shopify';
+    };
+    function customerAccountRequest(query, variables) {
+        return readCustomer().request(query, variables);
+    }
+    return {
+        identity: {
+            bidderId: () => {
+                const customer = readCustomer().customer;
+                return signedInWithShopify() && customer ? (0, shopifyIds_1.bareId)(customer.id) : null;
+            },
+            customerRef: () => { var _a, _b; return (signedInWithShopify() ? (_b = (_a = readCustomer().customer) === null || _a === void 0 ? void 0 : _a.id) !== null && _b !== void 0 ? _b : null : null); },
+            customerName: () => (0, showNames_1.viewerNameFor)(readCustomer().customer),
+            customerEmail: () => { var _a, _b; return (_b = (_a = readCustomer().customer) === null || _a === void 0 ? void 0 : _a.email) !== null && _b !== void 0 ? _b : null; },
+        },
+        customerAccountRequest,
+        buyer: async () => {
+            var _a;
+            const current = readCustomer();
+            if (!current.loggedIn)
+                return null;
+            const token = await current.getAccessToken();
+            if (!token)
+                return null;
+            const email = (_a = current.customer) === null || _a === void 0 ? void 0 : _a.email;
+            return { customerAccessToken: token, ...(email ? { email } : {}) };
+        },
+    };
+}
+//# sourceMappingURL=shopifyIdentity.js.map

package/dist/shopifyIdentity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shopifyIdentity.js","sourceRoot":"","sources":["../src/shopifyIdentity.ts"],"names":[],"mappings":";;AAiDA,8DA8BC;AApED,6CAAsC;AACtC,2CAA4C;AAuB5C;;;;;;;;;;;;;GAaG;AACH,SAAgB,yBAAyB,CAAC,YAA0C;IAClF,MAAM,mBAAmB,GAAG,GAAG,EAAE;QAC/B,MAAM,OAAO,GAAG,YAAY,EAAE,CAAC;QAC/B,OAAO,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC;IAC/D,CAAC,CAAC;IAEF,SAAS,sBAAsB,CAAI,KAAa,EAAE,SAAmC;QACnF,OAAO,YAAY,EAAE,CAAC,OAAO,CAAI,KAAK,EAAE,SAAS,CAAC,CAAC;IACrD,CAAC;IAED,OAAO;QACL,QAAQ,EAAE;YACR,QAAQ,EAAE,GAAG,EAAE;gBACb,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC,QAAQ,CAAC;gBACzC,OAAO,mBAAmB,EAAE,IAAI,QAAQ,CAAC,CAAC,CAAC,IAAA,mBAAM,EAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACxE,CAAC;YACD,WAAW,EAAE,GAAG,EAAE,eAAC,OAAA,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,MAAA,MAAA,YAAY,EAAE,CAAC,QAAQ,0CAAE,EAAE,mCAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA,EAAA;YACvF,YAAY,EAAE,GAAG,EAAE,CAAC,IAAA,yBAAa,EAAC,YAAY,EAAE,CAAC,QAAQ,CAAC;YAC1D,aAAa,EAAE,GAAG,EAAE,eAAC,OAAA,MAAA,MAAA,YAAY,EAAE,CAAC,QAAQ,0CAAE,KAAK,mCAAI,IAAI,CAAA,EAAA;SAC5D;QACD,sBAAsB;QACtB,KAAK,EAAE,KAAK,IAAI,EAAE;;YAChB,MAAM,OAAO,GAAG,YAAY,EAAE,CAAC;YAC/B,IAAI,CAAC,OAAO,CAAC,QAAQ;gBAAE,OAAO,IAAI,CAAC;YACnC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC;YAC7C,IAAI,CAAC,KAAK;gBAAE,OAAO,IAAI,CAAC;YACxB,MAAM,KAAK,GAAG,MAAA,OAAO,CAAC,QAAQ,0CAAE,KAAK,CAAC;YACtC,OAAO,EAAE,mBAAmB,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACrE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/shopifyIds.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shopify ids, in the two forms they arrive in. The gateway and the host's dashboard use the bare
+ * number (`42`); the Storefront API uses the GID (`gid://shopify/Product/42`).
+ */
+/** The bare number at the end of an id, whichever form it arrives in: `gid://shopify/Product/42` and `42` are both `42`. */
+export declare function bareId(id: string): string;
+/** A product GID, from a bare id or a GID. */
+export declare function productGid(id: string): string;
+//# sourceMappingURL=shopifyIds.d.ts.map

package/dist/shopifyIds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shopifyIds.d.ts","sourceRoot":"","sources":["../src/shopifyIds.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,4HAA4H;AAC5H,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,8CAA8C;AAC9C,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE7C"}

package/dist/shopifyIds.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * Shopify ids, in the two forms they arrive in. The gateway and the host's dashboard use the bare
+ * number (`42`); the Storefront API uses the GID (`gid://shopify/Product/42`).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bareId = bareId;
+exports.productGid = productGid;
+/** The bare number at the end of an id, whichever form it arrives in: `gid://shopify/Product/42` and `42` are both `42`. */
+function bareId(id) {
+    var _a;
+    return (_a = id.split('/').pop()) !== null && _a !== void 0 ? _a : id;
+}
+/** A product GID, from a bare id or a GID. */
+function productGid(id) {
+    return id.startsWith('gid://') ? id : `gid://shopify/Product/${bareId(id)}`;
+}
+//# sourceMappingURL=shopifyIds.js.map

package/dist/shopifyIds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shopifyIds.js","sourceRoot":"","sources":["../src/shopifyIds.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAGH,wBAEC;AAGD,gCAEC;AARD,4HAA4H;AAC5H,SAAgB,MAAM,CAAC,EAAU;;IAC/B,OAAO,MAAA,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,mCAAI,EAAE,CAAC;AACnC,CAAC;AAED,8CAA8C;AAC9C,SAAgB,UAAU,CAAC,EAAU;IACnC,OAAO,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,yBAAyB,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;AAC9E,CAAC"}

package/dist/showLinks.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Where a link about a show should go (0.9.0): `streams.destinationFor`'s rule, moved from amore-v2's
+ * and Freckled Poppy's `resolveLiveTarget`.
+ *
+ * Every push a store sends about a show points at the show (`live-selling/<streamingId>`), and most are
+ * opened after it ended, so what the shopper wants is usually its recording. One read of the record
+ * answers it: it carries the recording's id (`replayFeedId`, the same as `Replay.id`). No search of the
+ * replay feed is needed, and one wouldn't do: the feed is paged, and an old show is past the pages read.
+ *
+ * Pure, so it loads in plain Node for tests and in an app's own test runner.
+ */
+import type { LiveStream, ShowLinkDestination } from './types';
+/**
+ * The destination for a show's record:
+ *
+ * - none (unknown, unreadable, or hidden from this viewer, which `destinationFor` treats as none):
+ *   the list of shows;
+ * - on air: the live player;
+ * - ended, with a recording: its replay;
+ * - anything else (scheduled, or ended with no recording): the list of shows, which says what is on
+ *   now and what has been.
+ */
+export declare function showLinkDestination(show: Pick<LiveStream, 'status' | 'replayFeedId'> | null): ShowLinkDestination;
+//# sourceMappingURL=showLinks.d.ts.map

package/dist/showLinks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"showLinks.d.ts","sourceRoot":"","sources":["../src/showLinks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE/D;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,cAAc,CAAC,GAAG,IAAI,GAAG,mBAAmB,CAKjH"}

package/dist/showLinks.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.showLinkDestination = showLinkDestination;
+/**
+ * The destination for a show's record:
+ *
+ * - none (unknown, unreadable, or hidden from this viewer, which `destinationFor` treats as none):
+ *   the list of shows;
+ * - on air: the live player;
+ * - ended, with a recording: its replay;
+ * - anything else (scheduled, or ended with no recording): the list of shows, which says what is on
+ *   now and what has been.
+ */
+function showLinkDestination(show) {
+    if (!show)
+        return { to: 'showList' };
+    if (show.status === 'live')
+        return { to: 'livePlayer' };
+    if (show.status === 'ended' && show.replayFeedId)
+        return { to: 'replay', feedId: show.replayFeedId };
+    return { to: 'showList' };
+}
+//# sourceMappingURL=showLinks.js.map

package/dist/showLinks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"showLinks.js","sourceRoot":"","sources":["../src/showLinks.ts"],"names":[],"mappings":";;AAuBA,kDAKC;AAfD;;;;;;;;;GASG;AACH,SAAgB,mBAAmB,CAAC,IAAwD;IAC1F,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC;IACrC,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC;IACxD,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,IAAI,IAAI,CAAC,YAAY;QAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;IACrG,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC;AAC5B,CAAC"}

package/dist/showLots.d.ts

@@ -0,0 +1,28 @@
+/**
+ * A show's lots as a screen lists them (0.9.0).
+ *
+ * Pure, so it loads in plain Node for tests and in an app's own test runner.
+ */
+import type { LiveProduct } from './sessionTypes';
+import type { LiveStreamProduct } from './types';
+/**
+ * The list with the featured item lifted to the front, the rest in the host's order: a shopper who
+ * opens the shop wants what the host is holding up. It lifts one item; it doesn't sort. The same
+ * array when there is nothing to move (no featured item, not in the list, or already first). Works on
+ * the session's products or on the catalogue's own (`raw`), matched by `id`.
+ *
+ * Amore's shop sheet and Freckled Poppy's (`LiveShopSheet01`) each did this.
+ */
+export declare function featuredFirst<Item extends {
+    id: string;
+}>(items: Item[], featuredId: string | null | undefined): Item[];
+/**
+ * The record's per-lot fields joined onto the commerce adapter's products: the lot number (`sellId`)
+ * and, on an auction, the opening bid (`baseBidPrice`). The adapter is asked for products by id and
+ * knows nothing of either. Matched by `storeProductId`.
+ *
+ * The same array when the record has neither field for any lot, so an app on a gateway that issues
+ * none keeps the adapter's own objects.
+ */
+export declare function withLotFieldsFromRecord<Raw>(products: LiveProduct<Raw>[], recordLots: Pick<LiveStreamProduct, 'storeProductId' | 'sellId' | 'baseBidPrice'>[]): LiveProduct<Raw>[];
+//# sourceMappingURL=showLots.d.ts.map

package/dist/showLots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"showLots.d.ts","sourceRoot":"","sources":["../src/showLots.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,EAAE,CAKvH;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EACzC,QAAQ,EAAE,WAAW,CAAC,GAAG,CAAC,EAAE,EAC5B,UAAU,EAAE,IAAI,CAAC,iBAAiB,EAAE,gBAAgB,GAAG,QAAQ,GAAG,cAAc,CAAC,EAAE,GAClF,WAAW,CAAC,GAAG,CAAC,EAAE,CAiBpB"}

package/dist/showLots.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.featuredFirst = featuredFirst;
+exports.withLotFieldsFromRecord = withLotFieldsFromRecord;
+/**
+ * The list with the featured item lifted to the front, the rest in the host's order: a shopper who
+ * opens the shop wants what the host is holding up. It lifts one item; it doesn't sort. The same
+ * array when there is nothing to move (no featured item, not in the list, or already first). Works on
+ * the session's products or on the catalogue's own (`raw`), matched by `id`.
+ *
+ * Amore's shop sheet and Freckled Poppy's (`LiveShopSheet01`) each did this.
+ */
+function featuredFirst(items, featuredId) {
+    if (!featuredId)
+        return items;
+    const at = items.findIndex((item) => item.id === featuredId);
+    if (at <= 0)
+        return items;
+    return [items[at], ...items.slice(0, at), ...items.slice(at + 1)];
+}
+/**
+ * The record's per-lot fields joined onto the commerce adapter's products: the lot number (`sellId`)
+ * and, on an auction, the opening bid (`baseBidPrice`). The adapter is asked for products by id and
+ * knows nothing of either. Matched by `storeProductId`.
+ *
+ * The same array when the record has neither field for any lot, so an app on a gateway that issues
+ * none keeps the adapter's own objects.
+ */
+function withLotFieldsFromRecord(products, recordLots) {
+    var _a, _b;
+    const byLot = new Map();
+    for (const lot of recordLots) {
+        if (lot.sellId || lot.baseBidPrice != null) {
+            byLot.set(lot.storeProductId, { sellId: (_a = lot.sellId) !== null && _a !== void 0 ? _a : null, baseBidPrice: (_b = lot.baseBidPrice) !== null && _b !== void 0 ? _b : null });
+        }
+    }
+    if (!byLot.size)
+        return products;
+    return products.map((product) => {
+        var _a, _b, _c, _d;
+        const fields = byLot.get(product.storeProductId);
+        if (!fields)
+            return product;
+        return {
+            ...product,
+            sellId: (_b = (_a = fields.sellId) !== null && _a !== void 0 ? _a : product.sellId) !== null && _b !== void 0 ? _b : null,
+            baseBidPrice: (_d = (_c = fields.baseBidPrice) !== null && _c !== void 0 ? _c : product.baseBidPrice) !== null && _d !== void 0 ? _d : null,
+        };
+    });
+}
+//# sourceMappingURL=showLots.js.map

package/dist/showLots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"showLots.js","sourceRoot":"","sources":["../src/showLots.ts"],"names":[],"mappings":";;AAgBA,sCAKC;AAUD,0DAoBC;AA3CD;;;;;;;GAOG;AACH,SAAgB,aAAa,CAA8B,KAAa,EAAE,UAAqC;IAC7G,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,MAAM,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC;IAC7D,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1B,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,uBAAuB,CACrC,QAA4B,EAC5B,UAAmF;;IAEnF,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkE,CAAC;IACxF,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,YAAY,IAAI,IAAI,EAAE,CAAC;YAC3C,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,MAAA,GAAG,CAAC,MAAM,mCAAI,IAAI,EAAE,YAAY,EAAE,MAAA,GAAG,CAAC,YAAY,mCAAI,IAAI,EAAE,CAAC,CAAC;QACxG,CAAC;IACH,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,IAAI;QAAE,OAAO,QAAQ,CAAC;IACjC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;;QAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM;YAAE,OAAO,OAAO,CAAC;QAC5B,OAAO;YACL,GAAG,OAAO;YACV,MAAM,EAAE,MAAA,MAAA,MAAM,CAAC,MAAM,mCAAI,OAAO,CAAC,MAAM,mCAAI,IAAI;YAC/C,YAAY,EAAE,MAAA,MAAA,MAAM,CAAC,YAAY,mCAAI,OAAO,CAAC,YAAY,mCAAI,IAAI;SAClE,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/showNames.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Names the room shows to everyone, made safe to show (0.9.0).
+ *
+ * A live room publishes each viewer's name to everyone watching, so this is a privacy boundary, not
+ * formatting: an email address must never reach a screen. The SDK applies `publicName` to every name
+ * it hands out (comments and the room's history, cart cards, reactions, the auction's leader and
+ * winner, the giveaway's winner and entrants, a replay's chat) and to the name it publishes for this
+ * viewer. Names from older apps, or already stored in a room's history, arrive as whatever they sent,
+ * which is how a full address was once shown to a room (Freckled Poppy's DEL-2758).
+ *
+ * Pure, so it loads in plain Node for tests and in an app's own test runner.
+ */
+/**
+ * A name as it may be shown: trimmed; an email keeps only the part before the @ ("jane@x.com" →
+ * "jane"); a name that starts with @ is a handle the viewer chose ("@jane") and stays whole; a real
+ * name ("Jane Doe") is unchanged. Null when nothing usable is left.
+ */
+export declare function publicName(name: string | null | undefined): string | null;
+/**
+ * The first word of a name, for a place with no room for the rest (a card that shares one line with a
+ * product title): "Jane Doe" → "Jane". Made safe first, so never an email. Null when nothing is left.
+ */
+export declare function firstNameOf(name: string | null | undefined): string | null;
+/** What a signed-in viewer is called in the room: the parts of a customer this reads. */
+export interface NamedCustomer {
+    firstName?: string | null;
+    lastName?: string | null;
+    email?: string | null;
+}
+/**
+ * The name a signed-in customer comments, bids and enters under: first and last name, else the first
+ * name alone, else the part of their email before the @. Never the whole email. Null when signed out
+ * (or nothing is usable), which leaves the session's own choice in charge: a name typed on this phone.
+ *
+ * The same rule amore-v2 (`liveViewerName`) and Freckled Poppy (`LiveSessionHost`) kept apart; pass it
+ * to `LiveSessionProvider`'s `viewerName`, and `createShopifyLiveIdentity`'s `customerName` uses it.
+ */
+export declare function viewerNameFor(customer: NamedCustomer | null | undefined): string | null;
+/**
+ * Two names the room shows, compared as a person reads them: spaces and capitals aside ("Jane  Doe "
+ * is "jane doe"). False when either is empty. How a giveaway's winner is matched to this shopper when
+ * the record doesn't name them by id (`isYourGiveawayWin`); amore-v2's rule.
+ */
+export declare function sameRoomName(first: string | null | undefined, second: string | null | undefined): boolean;
+//# sourceMappingURL=showNames.d.ts.map

package/dist/showNames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"showNames.d.ts","sourceRoot":"","sources":["../src/showNames.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAKzE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAE1E;AAED,yFAAyF;AACzF,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAOvF;AAQD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAGzG"}

package/dist/showNames.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * Names the room shows to everyone, made safe to show (0.9.0).
+ *
+ * A live room publishes each viewer's name to everyone watching, so this is a privacy boundary, not
+ * formatting: an email address must never reach a screen. The SDK applies `publicName` to every name
+ * it hands out (comments and the room's history, cart cards, reactions, the auction's leader and
+ * winner, the giveaway's winner and entrants, a replay's chat) and to the name it publishes for this
+ * viewer. Names from older apps, or already stored in a room's history, arrive as whatever they sent,
+ * which is how a full address was once shown to a room (Freckled Poppy's DEL-2758).
+ *
+ * Pure, so it loads in plain Node for tests and in an app's own test runner.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.publicName = publicName;
+exports.firstNameOf = firstNameOf;
+exports.viewerNameFor = viewerNameFor;
+exports.sameRoomName = sameRoomName;
+/**
+ * A name as it may be shown: trimmed; an email keeps only the part before the @ ("jane@x.com" →
+ * "jane"); a name that starts with @ is a handle the viewer chose ("@jane") and stays whole; a real
+ * name ("Jane Doe") is unchanged. Null when nothing usable is left.
+ */
+function publicName(name) {
+    var _a;
+    const trimmed = typeof name === 'string' ? name.trim() : '';
+    if (!trimmed)
+        return null;
+    if (trimmed.startsWith('@'))
+        return trimmed;
+    return ((_a = trimmed.split('@')[0]) === null || _a === void 0 ? void 0 : _a.trim()) || null;
+}
+/**
+ * The first word of a name, for a place with no room for the rest (a card that shares one line with a
+ * product title): "Jane Doe" → "Jane". Made safe first, so never an email. Null when nothing is left.
+ */
+function firstNameOf(name) {
+    var _a;
+    return ((_a = publicName(name)) === null || _a === void 0 ? void 0 : _a.split(/\s+/)[0]) || null;
+}
+/**
+ * The name a signed-in customer comments, bids and enters under: first and last name, else the first
+ * name alone, else the part of their email before the @. Never the whole email. Null when signed out
+ * (or nothing is usable), which leaves the session's own choice in charge: a name typed on this phone.
+ *
+ * The same rule amore-v2 (`liveViewerName`) and Freckled Poppy (`LiveSessionHost`) kept apart; pass it
+ * to `LiveSessionProvider`'s `viewerName`, and `createShopifyLiveIdentity`'s `customerName` uses it.
+ */
+function viewerNameFor(customer) {
+    var _a, _b;
+    if (!customer)
+        return null;
+    const fullName = [customer.firstName, customer.lastName]
+        .map((part) => (typeof part === 'string' ? part.trim() : ''))
+        .filter(Boolean)
+        .join(' ');
+    return (_b = (_a = publicName(fullName)) !== null && _a !== void 0 ? _a : publicName(customer.firstName)) !== null && _b !== void 0 ? _b : partBeforeTheAt(customer.email);
+}
+/** An email's part before the @, never a bare "@example.com" (which `publicName` would keep as a handle). */
+function partBeforeTheAt(email) {
+    var _a;
+    const trimmed = typeof email === 'string' ? email.trim() : '';
+    return ((_a = trimmed.split('@')[0]) === null || _a === void 0 ? void 0 : _a.trim()) || null;
+}
+/**
+ * Two names the room shows, compared as a person reads them: spaces and capitals aside ("Jane  Doe "
+ * is "jane doe"). False when either is empty. How a giveaway's winner is matched to this shopper when
+ * the record doesn't name them by id (`isYourGiveawayWin`); amore-v2's rule.
+ */
+function sameRoomName(first, second) {
+    const plain = (name) => (name !== null && name !== void 0 ? name : '').trim().replace(/\s+/g, ' ').toLowerCase();
+    return plain(first) !== '' && plain(first) === plain(second);
+}
+//# sourceMappingURL=showNames.js.map

package/dist/showNames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"showNames.js","sourceRoot":"","sources":["../src/showNames.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;AAOH,gCAKC;AAMD,kCAEC;AAiBD,sCAOC;AAaD,oCAGC;AA1DD;;;;GAIG;AACH,SAAgB,UAAU,CAAC,IAA+B;;IACxD,MAAM,OAAO,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IAC5C,OAAO,CAAA,MAAA,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,0CAAE,IAAI,EAAE,KAAI,IAAI,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,SAAgB,WAAW,CAAC,IAA+B;;IACzD,OAAO,CAAA,MAAA,UAAU,CAAC,IAAI,CAAC,0CAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,KAAI,IAAI,CAAC;AACnD,CAAC;AASD;;;;;;;GAOG;AACH,SAAgB,aAAa,CAAC,QAA0C;;IACtE,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,MAAM,QAAQ,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC;SACrD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SAC5D,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,OAAO,MAAA,MAAA,UAAU,CAAC,QAAQ,CAAC,mCAAI,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,mCAAI,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACnG,CAAC;AAED,6GAA6G;AAC7G,SAAS,eAAe,CAAC,KAAgC;;IACvD,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,OAAO,CAAA,MAAA,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,0CAAE,IAAI,EAAE,KAAI,IAAI,CAAC;AAC/C,CAAC;AAED;;;;GAIG;AACH,SAAgB,YAAY,CAAC,KAAgC,EAAE,MAAiC;IAC9F,MAAM,KAAK,GAAG,CAAC,IAA+B,EAAE,EAAE,CAAC,CAAC,IAAI,aAAJ,IAAI,cAAJ,IAAI,GAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1G,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC;AAC/D,CAAC"}

package/dist/streams.d.ts

@@ -14,6 +14,8 @@ type RawStreamProduct = {
     sell_id?: string | number | null;
     start_time?: number | null;
     base_bid_price?: number | string | null;
+    /** The lot's bid step: how much each bid must add. */
+    bid_incrementer?: number | string | null;
     auction_winner?: unknown[] | null;
     /** `"url"` marks a lot that is a link rather than a catalogue product. */
     product_type?: string | null;
@@ -24,14 +26,31 @@ type RawGiveawayProduct = {
     variant_id?: string | null;
     giveawayStatus?: string | null;
     product_name?: string | null;
-    product_thumbnail?: string | null;
+    /** A bare string on the rows seen so far, but the same field is `{ url }` on a catalogue lot. */
+    product_thumbnail?: string | {
+        url?: string | null;
+    } | null;
     product_variant_title?: string | null;
+    /** The given-away variant's price (`"22.0"`): what every record seen carries (2026-10-06). */
+    variant_price?: number | string | null;
+    /** The name the SDK read before 0.9.0, kept as a fallback; no record seen has it. */
     product_variant_price?: number | string | null;
+    /** The given-away variant's own photo. */
+    variant_image?: string | {
+        url?: string | null;
+    } | null;
+    /** When the host started this giveaway, an ISO time (`"2026-10-05T06:26:49.473Z"`). */
+    giveawayStartTime?: string | number | null;
     users?: {
         displayName?: string | null;
         userId?: string | null;
     }[] | null;
     moderatorInCharge?: string | null;
+    /**
+     * Who won, once drawn: a customer GID (`"gid://shopify/Customer/42"`), or `"No One Joined"` for a
+     * draw nobody entered; absent while open (shows `h2rorgm7po`, `dq9r6hd8ml`, read 2026-10-06).
+     */
+    winner?: string | null;
 };
 type RawProductSegment = {
     product_id: string;
@@ -58,6 +77,8 @@ type RawLiveStream = {
     product_info?: RawStreamProduct[] | null;
     product_segments?: RawProductSegment[] | null;
     meta?: Record<string, unknown> | null;
+    /** `{ id, comment, name }` while something is pinned; null or absent otherwise. */
+    pinned_comment?: unknown;
 };
 /** A co-host slot on the record. `status` is the host's own, and only `active` is on air. */
 type RawGuestHost = {
@@ -67,6 +88,11 @@ type RawGuestHost = {
 type RawLiveStreams = {
     data?: RawLiveStream[] | null;
 };
+/**
+ * The winner's bare customer id from the record's `winner`: the number at the end of a GID, or a bare
+ * number. Anything else (`"No One Joined"`, absent) is no winner.
+ */
+export declare function winnerIdOf(winner: unknown): string | null;
 export declare function toLiveStreamProduct(raw: RawStreamProduct): LiveStreamProduct | null;
 /**
  * Entrants for one giveaway lot, out of the flat `meta` bag. The host writes one