@tiledev/sdk-shopify 0.9.0 → 0.10.0

package/dist/react/useProductPage.js

@@ -0,0 +1,178 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useVariantSelection = useVariantSelection;
+exports.useAddToCart = useAddToCart;
+exports.useProductPage = useProductPage;
+/**
+ * Product page hooks, from small to whole:
+ *
+ * - `useVariantSelection(product)`: the selection, every option value's state, the chosen variant,
+ *   its price and stock. For any surface that sells a variant (a page, a buy sheet, a quick add).
+ * - `useAddToCart(variant)`: add with the stock ceiling checked first, the `adding` state, the result.
+ * - `useProductPage(handle)`: both, on `useProduct`'s cache-first product, plus the gallery's media,
+ *   the parsed description, the favourite, the share link and, when asked, "You may also like"
+ *   (`useProductRecommendations`).
+ *
+ * Everything is overridable: each rule takes an option, each returned section is plain data a
+ * screen can ignore, and the pure helpers (`../productPage`) are there for a page of its own.
+ */
+const react_1 = require("react");
+const productPage_1 = require("../productPage");
+const ShopifyProvider_1 = require("./ShopifyProvider");
+const useProduct_1 = require("./useProduct");
+const useProductRecommendations_1 = require("./useProductRecommendations");
+function useVariantSelection(product, options = {}) {
+    var _a, _b, _c;
+    const variants = (0, react_1.useMemo)(() => { var _a; return (_a = product === null || product === void 0 ? void 0 : product.variants) !== null && _a !== void 0 ? _a : []; }, [product === null || product === void 0 ? void 0 : product.variants]);
+    const known = variants.length > 0;
+    const isUnavailable = (_a = options.isUnavailable) !== null && _a !== void 0 ? _a : productPage_1.isVariantUnavailable;
+    const orderKey = ((_b = options.optionOrder) !== null && _b !== void 0 ? _b : []).join('\u0001');
+    const includeRef = (0, react_1.useRef)(options.includeOption);
+    includeRef.current = options.includeOption;
+    const selectable = (0, react_1.useMemo)(() => (0, productPage_1.selectableOptions)(product === null || product === void 0 ? void 0 : product.options, { order: options.optionOrder, include: includeRef.current }), 
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [product === null || product === void 0 ? void 0 : product.options, orderKey]);
+    const startRef = (0, react_1.useRef)(options.initialSelection);
+    startRef.current = options.initialSelection;
+    const initial = (0, react_1.useMemo)(() => {
+        var _a;
+        const linked = options.initialVariantId ? variants.find((v) => v.id === options.initialVariantId) : null;
+        if (linked)
+            return (0, productPage_1.selectionForVariant)(linked);
+        return ((_a = startRef.current) !== null && _a !== void 0 ? _a : productPage_1.initialSelection)(variants);
+    }, [variants, options.initialVariantId]);
+    const [chosen, setChosen] = (0, react_1.useState)(null);
+    const resetKey = options.resetKey !== undefined ? options.resetKey : ((_c = product === null || product === void 0 ? void 0 : product.id) !== null && _c !== void 0 ? _c : null);
+    (0, react_1.useEffect)(() => setChosen(null), [resetKey]);
+    const selection = chosen !== null && chosen !== void 0 ? chosen : initial;
+    const variant = known ? (0, productPage_1.findVariant)(variants, selection) : null;
+    const setOption = (0, react_1.useCallback)((name, value) => setChosen((current) => ({ ...(current !== null && current !== void 0 ? current : initial), [name]: value })), [initial]);
+    const selectVariant = (0, react_1.useCallback)((variantId) => {
+        const found = variants.find((v) => v.id === variantId);
+        if (found)
+            setChosen((0, productPage_1.selectionForVariant)(found));
+    }, [variants]);
+    const reset = (0, react_1.useCallback)(() => setChosen(null), []);
+    const states = (0, react_1.useMemo)(() => (0, productPage_1.optionStates)(selectable, variants, selection, isUnavailable), 
+    // isUnavailable is a rule, read each time; its identity isn't part of the key.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [selectable, variants, selection]);
+    const threshold = options.lowStockThreshold === undefined ? productPage_1.DEFAULT_LOW_STOCK_THRESHOLD : options.lowStockThreshold;
+    return {
+        options: selectable,
+        optionStates: states,
+        selection,
+        setOption,
+        selectVariant,
+        reset,
+        variant,
+        label: (0, productPage_1.selectionLabel)(selectable, selection, options.separator),
+        known,
+        price: (0, productPage_1.variantPrice)(variant, product),
+        unavailable: known && (!(product === null || product === void 0 ? void 0 : product.availableForSale) || isUnavailable(variant)),
+        lowStock: known && (0, productPage_1.isLowStock)(product === null || product === void 0 ? void 0 : product.totalInventory, product === null || product === void 0 ? void 0 : product.availableForSale, threshold),
+    };
+}
+function useAddToCart(variant, options = {}) {
+    const { addLine, cart } = (0, ShopifyProvider_1.useCart)();
+    const [adding, setAdding] = (0, react_1.useState)(false);
+    const optionsRef = (0, react_1.useRef)(options);
+    optionsRef.current = options;
+    const ceiling = variant ? (options.maxQuantity ? options.maxQuantity(variant) : (0, productPage_1.stockCeiling)(variant)) : 0;
+    const inCart = (0, productPage_1.quantityInCart)(cart, variant === null || variant === void 0 ? void 0 : variant.id);
+    const add = (0, react_1.useCallback)(async (input = {}) => {
+        var _a, _b, _c, _d, _e;
+        const o = optionsRef.current;
+        const done = (result) => {
+            var _a;
+            (_a = (result.ok ? o.onAdded : o.onRefused)) === null || _a === void 0 ? void 0 : _a(result);
+            return result;
+        };
+        if (!variant)
+            return done({ ok: false, reason: 'no-variant', cart });
+        const max = o.maxQuantity ? o.maxQuantity(variant) : (0, productPage_1.stockCeiling)(variant);
+        setAdding(true);
+        try {
+            const result = await addLine({
+                merchandiseId: variant.id,
+                quantity: (_b = (_a = input.quantity) !== null && _a !== void 0 ? _a : o.quantity) !== null && _b !== void 0 ? _b : 1,
+                attributes: (_c = input.attributes) !== null && _c !== void 0 ? _c : o.attributes,
+                sellingPlanId: (_d = input.sellingPlanId) !== null && _d !== void 0 ? _d : o.sellingPlanId,
+                maxQuantity: max,
+                source: (_e = input.source) !== null && _e !== void 0 ? _e : o.source,
+            });
+            return done(result);
+        }
+        catch (error) {
+            // Shopify refused the line: the provider has raised cart:outOfStock already.
+            return done({ ok: false, reason: 'outOfStock', error, cart });
+        }
+        finally {
+            setAdding(false);
+        }
+    }, [variant, addLine, cart]);
+    return { add, adding, inCart, canAddMore: !!variant && (0, productPage_1.withinCeiling)(ceiling, inCart, 1) };
+}
+function useProductPage(handle, options = {}) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+    const result = (0, useProduct_1.useProduct)(handle, { imageTransform: options.imageTransform, onError: options.onError });
+    const { product, preview } = result;
+    const shown = (_a = product !== null && product !== void 0 ? product : preview) !== null && _a !== void 0 ? _a : null;
+    const selection = useVariantSelection(shown, { ...options, resetKey: options.resetKey !== undefined ? options.resetKey : (handle !== null && handle !== void 0 ? handle : null) });
+    const cart = useAddToCart(selection.variant, options);
+    const wishlist = (0, ShopifyProvider_1.useWishlist)();
+    // Once per product, when the full product lands.
+    const viewed = (0, react_1.useRef)(null);
+    const onViewRef = (0, react_1.useRef)(options.onView);
+    onViewRef.current = options.onView;
+    (0, react_1.useEffect)(() => {
+        var _a;
+        if (!product || viewed.current === product.id)
+            return;
+        viewed.current = product.id;
+        (_a = onViewRef.current) === null || _a === void 0 ? void 0 : _a.call(onViewRef, product);
+    }, [product]);
+    const html = (shown === null || shown === void 0 ? void 0 : shown.descriptionHtml) || (shown === null || shown === void 0 ? void 0 : shown.description) || '';
+    const parse = (_b = options.parseDescription) !== null && _b !== void 0 ? _b : true;
+    const blocks = (0, react_1.useMemo)(() => (parse === false ? [] : typeof parse === 'function' ? parse(html) : (0, productPage_1.parseDescriptionHtml)(html)), [parse, html]);
+    const blocked = !!shown && !!((_c = options.isBlocked) === null || _c === void 0 ? void 0 : _c.call(options, shown));
+    const status = !shown
+        ? 'loading'
+        : blocked
+            ? 'blocked'
+            : !selection.known
+                ? 'unknown'
+                : selection.unavailable
+                    ? 'unavailable'
+                    : 'available';
+    const toggle = (0, react_1.useCallback)(() => (shown ? wishlist.toggle(product !== null && product !== void 0 ? product : shown.id) : Promise.resolve(false)), [wishlist, product, shown]);
+    const asked = options.recommendations;
+    const recommendationOptions = typeof asked === 'object' ? asked : {};
+    const isBlocked = options.isBlocked;
+    const recommendations = (0, useProductRecommendations_1.useProductRecommendations)(shown === null || shown === void 0 ? void 0 : shown.id, {
+        ...recommendationOptions,
+        enabled: !!asked && ((_d = recommendationOptions.enabled) !== null && _d !== void 0 ? _d : true),
+        exclude: (_e = recommendationOptions.exclude) !== null && _e !== void 0 ? _e : (isBlocked ? (p) => isBlocked(p) : undefined),
+        onError: (_f = recommendationOptions.onError) !== null && _f !== void 0 ? _f : (options.onError ? (error, ctx) => options.onError(error, { at: ctx.at, handle: handle !== null && handle !== void 0 ? handle : '' }) : undefined),
+    });
+    return {
+        ...result,
+        product,
+        preview,
+        shown,
+        status,
+        selection,
+        cart,
+        media: {
+            items: (_g = product === null || product === void 0 ? void 0 : product.media) !== null && _g !== void 0 ? _g : [],
+            initialIndex: product ? (0, productPage_1.initialMediaIndex)(product.media, options.playVideo) : 0,
+            firstImageUrl: product ? (0, productPage_1.firstImageUrl)(product) : ((_j = (_h = preview === null || preview === void 0 ? void 0 : preview.featuredImage) === null || _h === void 0 ? void 0 : _h.url) !== null && _j !== void 0 ? _j : null),
+            previewImageUrl: (_l = (_k = preview === null || preview === void 0 ? void 0 : preview.featuredImage) === null || _k === void 0 ? void 0 : _k.url) !== null && _l !== void 0 ? _l : null,
+        },
+        description: { html, blocks },
+        favorite: { isFavorite: !!shown && wishlist.has(shown.id), toggle },
+        shareUrl: (0, productPage_1.productShareUrl)(product !== null && product !== void 0 ? product : shown, options.storeDomain),
+        recommendations,
+    };
+}
+//# sourceMappingURL=useProductPage.js.map

package/dist/react/useProductPage.js.map

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

package/dist/react/useProductRecommendations.d.ts

@@ -0,0 +1,27 @@
+import type { ImageTransform, Product } from '../types';
+export interface UseProductRecommendationsOptions {
+    /** Read them. Below the fold on most pages: pass false until the page has settled. @default true */
+    enabled?: boolean;
+    /** At most this many. @default 10 */
+    limit?: number;
+    /** For the cards' images. A grid's card size keeps them in the same image cache as the grids. */
+    imageTransform?: ImageTransform;
+    /** Leave a product out (e.g. one that can't be bought). The product itself is always left out. */
+    exclude?: (product: Product) => boolean;
+    onError?: (error: unknown, context: {
+        at: string;
+        productId: string;
+    }) => void;
+}
+export interface ProductRecommendations {
+    products: Product[];
+    /** Reading, with nothing to show yet. */
+    loading: boolean;
+    /** The read failed; whatever was shown stays. */
+    error: boolean;
+}
+export declare const DEFAULT_RECOMMENDATION_LIMIT = 10;
+export declare function useProductRecommendations(productId: string | null | undefined, options?: UseProductRecommendationsOptions): ProductRecommendations;
+/** Tests only: forget this session's reads. */
+export declare function clearRecommendationSession(): void;
+//# sourceMappingURL=useProductRecommendations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useProductRecommendations.d.ts","sourceRoot":"","sources":["../../src/react/useProductRecommendations.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGxD,MAAM,WAAW,gCAAgC;IAC/C,oGAAoG;IACpG,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iGAAiG;IACjG,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,kGAAkG;IAClG,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;IACxC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAChF;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,iDAAiD;IACjD,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAY/C,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,OAAO,GAAE,gCAAqC,GAC7C,sBAAsB,CA4CxB;AAED,+CAA+C;AAC/C,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD"}

package/dist/react/useProductRecommendations.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_RECOMMENDATION_LIMIT = void 0;
+exports.useProductRecommendations = useProductRecommendations;
+exports.clearRecommendationSession = clearRecommendationSession;
+/**
+ * "You may also like": Shopify's related products for a product (Storefront `productRecommendations`,
+ * the same list the online store's product page shows).
+ *
+ * Read once per product and kept for the session, so reopening a product shows them at once. Every
+ * product read also lands in the product store (base keys, variants included), so a recommendation
+ * tapped opens with its picker and Add to Cart in the first frame, like a grid's card.
+ */
+const react_1 = require("react");
+const client_1 = require("../client");
+const shopify_1 = require("../shopify");
+const ShopifyProvider_1 = require("./ShopifyProvider");
+exports.DEFAULT_RECOMMENDATION_LIMIT = 10;
+/** This session's reads, by product and image size: the first render of a reopened product has them. */
+const session = new Map();
+const keyOf = (productId, transform) => `${productId}|${transform ? JSON.stringify(transform) : ''}`;
+function pick(list, productId, limit, exclude) {
+    return list.filter((product) => product.id !== productId && !(exclude === null || exclude === void 0 ? void 0 : exclude(product))).slice(0, limit);
+}
+function useProductRecommendations(productId, options = {}) {
+    var _a, _b;
+    const { ready } = (0, ShopifyProvider_1.useShopify)();
+    const configured = ready || (0, client_1.isConfigured)();
+    const enabled = (_a = options.enabled) !== null && _a !== void 0 ? _a : true;
+    const limit = Math.max(1, Math.round((_b = options.limit) !== null && _b !== void 0 ? _b : exports.DEFAULT_RECOMMENDATION_LIMIT));
+    const transformKey = options.imageTransform ? JSON.stringify(options.imageTransform) : '';
+    const latest = (0, react_1.useRef)(options);
+    latest.current = options;
+    const cached = productId ? session.get(keyOf(productId, options.imageTransform)) : undefined;
+    const [state, setState] = (0, react_1.useState)(() => ({
+        products: cached ? pick(cached, productId, limit, options.exclude) : [],
+        loading: false,
+        error: false,
+    }));
+    (0, react_1.useEffect)(() => {
+        if (!productId || !enabled || !configured)
+            return;
+        const { imageTransform, exclude } = latest.current;
+        const key = keyOf(productId, imageTransform);
+        const known = session.get(key);
+        if (known) {
+            setState({ products: pick(known, productId, limit, exclude), loading: false, error: false });
+            return;
+        }
+        let live = true;
+        setState((current) => ({ ...current, loading: current.products.length === 0, error: false }));
+        shopify_1.shopify.products
+            .recommended(productId, { imageTransform })
+            .then((list) => {
+            session.set(key, list);
+            if (live)
+                setState({ products: pick(list, productId, limit, latest.current.exclude), loading: false, error: false });
+        })
+            .catch((error) => {
+            var _a, _b;
+            (_b = (_a = latest.current).onError) === null || _b === void 0 ? void 0 : _b.call(_a, error, { at: 'useProductRecommendations', productId });
+            if (live)
+                setState((current) => ({ ...current, loading: false, error: true }));
+        });
+        return () => {
+            live = false;
+        };
+        // The options object is new every render; what it changes is read through `latest`.
+    }, [productId, enabled, configured, limit, transformKey]);
+    return state;
+}
+/** Tests only: forget this session's reads. */
+function clearRecommendationSession() {
+    session.clear();
+}
+//# sourceMappingURL=useProductRecommendations.js.map

package/dist/react/useProductRecommendations.js.map

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

package/dist/react/useStoreCredit.d.ts

@@ -0,0 +1,58 @@
+import type { Money, StoreCreditEntry } from '../types';
+export interface StoreCreditState {
+    /** The app's choice; null when it shows no store credit. */
+    source: 'shopify' | 'tile' | null;
+    /**
+     * The balance can be read for this shopper: signed in, and for `shopify`, signed in with Shopify.
+     * Shopify store credit is only readable through the Customer Account API, so it is unavailable
+     * to a password session (App Store review mode).
+     */
+    available: boolean;
+    balance: Money | null;
+    loading: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+}
+export declare function useStoreCredit(): StoreCreditState;
+export interface UseStoreCreditHistoryOptions {
+    /** Lines per page. Default `STORE_CREDIT_HISTORY_PAGE_SIZE` (25). */
+    pageSize?: number;
+}
+export interface StoreCreditHistoryState {
+    /** The app's choice; null when it shows no store credit. */
+    source: 'shopify' | 'tile' | null;
+    /** The history can be read for this shopper: the same rule as the balance (`useStoreCredit`). */
+    available: boolean;
+    /** Newest first. Empty when it can't be read. */
+    entries: StoreCreditEntry[];
+    /**
+     * True only before the first answer: while a stored session is read on app open, then until the
+     * first page arrives. A refresh never sets it; the list stays on screen.
+     */
+    loading: boolean;
+    /** A next page is on its way (`loadMore`). */
+    loadingMore: boolean;
+    /** More lines than are loaded. */
+    hasMore: boolean;
+    /** The last read failed. Whatever was shown stays. Cleared by the next read that works. */
+    error: Error | null;
+    /** Reads the next page. Does nothing while another read is on its way, or at the end. */
+    loadMore: () => void;
+    /**
+     * Reads the newest page again (pull to refresh, a screen coming back into view) and starts the
+     * list over from it. Joins a first read already on its way. Never rejects.
+     */
+    refresh: () => Promise<void>;
+}
+/**
+ * The history behind the balance, from the same source as `useStoreCredit`, newest first, a page at a
+ * time:
+ * - `tile`: Tile Credit's ledger (`/public/me/ledger`), with the same service, token and shop as the
+ *   balance. Either sign-in.
+ * - `shopify`: the Customer Account API's store-credit transactions, for a Shopify sign-in only.
+ *
+ * Signed out, or with no source, it is empty with no error and reads nothing. Loads when it becomes
+ * readable, and starts over for another shopper.
+ */
+export declare function useStoreCreditHistory(options?: UseStoreCreditHistoryOptions): StoreCreditHistoryState;
+//# sourceMappingURL=useStoreCredit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useStoreCredit.d.ts","sourceRoot":"","sources":["../../src/react/useStoreCredit.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAExD,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAAC;IAClC;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,KAAK,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,wBAAgB,cAAc,IAAI,gBAAgB,CAqDjD;AAID,MAAM,WAAW,4BAA4B;IAC3C,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,4DAA4D;IAC5D,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAAC;IAClC,iGAAiG;IACjG,SAAS,EAAE,OAAO,CAAC;IACnB,iDAAiD;IACjD,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,WAAW,EAAE,OAAO,CAAC;IACrB,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,2FAA2F;IAC3F,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,yFAAyF;IACzF,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB;;;OAGG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAyBD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,4BAAiC,GAAG,uBAAuB,CA8GzG"}

package/dist/react/useStoreCredit.js

@@ -0,0 +1,209 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useStoreCredit = useStoreCredit;
+exports.useStoreCreditHistory = useStoreCreditHistory;
+/**
+ * The signed-in shopper's store credit, from the source the app chose on `ShopifyProvider`
+ * (`storeCredit.source`): Shopify's own store credit, or the Tile Credit wallet. One hook either
+ * way, so an account screen shows a balance without knowing where it comes from.
+ *
+ * Putting credit on the cart is `useCartStoreCredit`; Shopify store credit is spent at Shopify's
+ * checkout. `useStoreCreditHistory`, below, reads the lines behind the balance.
+ */
+const react_1 = require("react");
+const client_1 = require("../client");
+const storeCredit_1 = require("../auth/storeCredit");
+const tileCredit_1 = require("../tileCredit");
+const ShopifyProvider_1 = require("./ShopifyProvider");
+const tileCreditClient_1 = require("./tileCreditClient");
+const useOrders_1 = require("./useOrders");
+function useStoreCredit() {
+    var _a, _b, _c;
+    const { storeCredit } = (0, ShopifyProvider_1.useShopify)();
+    const customer = (0, ShopifyProvider_1.useCustomer)();
+    const source = (_a = storeCredit === null || storeCredit === void 0 ? void 0 : storeCredit.source) !== null && _a !== void 0 ? _a : null;
+    const available = source !== null && customer.loggedIn && (source === 'tile' || customer.sessionKind === 'shopify');
+    const [balance, setBalance] = (0, react_1.useState)(null);
+    const [loading, setLoading] = (0, react_1.useState)(false);
+    const [error, setError] = (0, react_1.useState)(null);
+    // Read through refs so `refresh` keeps one identity across renders.
+    const customerRef = (0, react_1.useRef)(customer);
+    customerRef.current = customer;
+    const baseUrl = (storeCredit === null || storeCredit === void 0 ? void 0 : storeCredit.tileCreditBaseUrl) || tileCredit_1.DEFAULT_TILE_CREDIT_BASE_URL;
+    const request = (0, react_1.useRef)(0);
+    const refresh = (0, react_1.useCallback)(async () => {
+        var _a, _b, _c, _d;
+        const id = ++request.current;
+        if (!available) {
+            setBalance(null);
+            setError(null);
+            return;
+        }
+        setLoading(true);
+        setError(null);
+        try {
+            let next;
+            if (source === 'shopify') {
+                const data = await customerRef.current.request(storeCredit_1.STORE_CREDIT_QUERY);
+                next = (0, storeCredit_1.sumStoreCredit)((_b = (_a = data.customer) === null || _a === void 0 ? void 0 : _a.storeCreditAccounts.nodes) !== null && _b !== void 0 ? _b : [], (_c = (0, client_1.getCurrencyCode)()) !== null && _c !== void 0 ? _c : '');
+            }
+            else {
+                const wallet = await (0, tileCreditClient_1.tileCreditClientFor)(customerRef.current, baseUrl).getWallet();
+                next = { amount: (0, tileCredit_1.centsToMoney)(wallet.balanceCents), currencyCode: (_d = (0, client_1.getCurrencyCode)()) !== null && _d !== void 0 ? _d : '' };
+            }
+            if (id === request.current)
+                setBalance(next);
+        }
+        catch (e) {
+            if (id === request.current)
+                setError(e instanceof Error ? e : new Error(String(e)));
+        }
+        finally {
+            if (id === request.current)
+                setLoading(false);
+        }
+    }, [available, source, baseUrl]);
+    // Loads when it becomes readable, and again for a different shopper.
+    const customerId = (_c = (_b = customer.customer) === null || _b === void 0 ? void 0 : _b.id) !== null && _c !== void 0 ? _c : null;
+    (0, react_1.useEffect)(() => {
+        void refresh();
+    }, [refresh, customerId]);
+    return (0, react_1.useMemo)(() => ({ source, available, balance: available ? balance : null, loading, error, refresh }), [source, available, balance, loading, error, refresh]);
+}
+const emptyHistory = (owner) => ({
+    owner, entries: [], cursor: null, answered: false, loadingMore: false, error: null,
+});
+/** The lines shown so far and a next page, in date order, each line once. */
+function withPage(entries, page) {
+    const seen = new Set(entries.map((entry) => entry.id));
+    const merged = [...entries, ...page.filter((entry) => !seen.has(entry.id))];
+    // Already in order from one source; Shopify's accounts in several currencies can interleave.
+    return merged.sort((a, b) => (Date.parse(b.createdAt) || 0) - (Date.parse(a.createdAt) || 0));
+}
+const asError = (error) => (error instanceof Error ? error : new Error(String(error)));
+/**
+ * The history behind the balance, from the same source as `useStoreCredit`, newest first, a page at a
+ * time:
+ * - `tile`: Tile Credit's ledger (`/public/me/ledger`), with the same service, token and shop as the
+ *   balance. Either sign-in.
+ * - `shopify`: the Customer Account API's store-credit transactions, for a Shopify sign-in only.
+ *
+ * Signed out, or with no source, it is empty with no error and reads nothing. Loads when it becomes
+ * readable, and starts over for another shopper.
+ */
+function useStoreCreditHistory(options = {}) {
+    var _a, _b;
+    const { storeCredit } = (0, ShopifyProvider_1.useShopify)();
+    const customer = (0, ShopifyProvider_1.useCustomer)();
+    const source = (_a = storeCredit === null || storeCredit === void 0 ? void 0 : storeCredit.source) !== null && _a !== void 0 ? _a : null;
+    const available = source !== null && customer.loggedIn && (source === 'tile' || customer.sessionKind === 'shopify');
+    const baseUrl = (storeCredit === null || storeCredit === void 0 ? void 0 : storeCredit.tileCreditBaseUrl) || tileCredit_1.DEFAULT_TILE_CREDIT_BASE_URL;
+    const shopper = (0, useOrders_1.useShopper)(customer);
+    // Whose history is held, and from where: anything else starts from nothing.
+    const owner = available && shopper ? `${shopper}|${source}|${baseUrl}` : null;
+    const customerRef = (0, react_1.useRef)(customer);
+    customerRef.current = customer;
+    const ownerRef = (0, react_1.useRef)(owner);
+    ownerRef.current = owner;
+    const pageSizeRef = (0, react_1.useRef)(storeCredit_1.STORE_CREDIT_HISTORY_PAGE_SIZE);
+    pageSizeRef.current = Math.max(1, Math.floor((_b = options.pageSize) !== null && _b !== void 0 ? _b : storeCredit_1.STORE_CREDIT_HISTORY_PAGE_SIZE)) || storeCredit_1.STORE_CREDIT_HISTORY_PAGE_SIZE;
+    const [stored, setStored] = (0, react_1.useState)(() => emptyHistory(owner));
+    // Another shopper's lines never show, not even for the render before the effect below clears them.
+    const shown = stored.owner === owner ? stored : emptyHistory(owner);
+    const shownRef = (0, react_1.useRef)(shown);
+    shownRef.current = shown;
+    const firstPage = (0, react_1.useRef)(null);
+    const nextPage = (0, react_1.useRef)(null);
+    const update = (0, react_1.useCallback)((forOwner, change) => {
+        setStored((state) => (state.owner === forOwner ? { ...state, ...change(state) } : state));
+    }, []);
+    /** The source for this shopper now. Tile Credit's client reads a fresh token for each request. */
+    const historySource = (0, react_1.useCallback)(async () => {
+        var _a;
+        const now = customerRef.current;
+        const currency = (_a = (0, client_1.getCurrencyCode)()) !== null && _a !== void 0 ? _a : '';
+        if (source === 'shopify')
+            return (0, storeCredit_1.shopifyStoreCreditHistory)(now.request, currency);
+        return (0, storeCredit_1.tileCreditHistory)((0, tileCreditClient_1.tileCreditClientFor)(now, baseUrl), currency);
+    }, [source, baseUrl]);
+    const refresh = (0, react_1.useCallback)(() => {
+        const forOwner = ownerRef.current;
+        if (!forOwner)
+            return Promise.resolve();
+        const running = firstPage.current;
+        if ((running === null || running === void 0 ? void 0 : running.owner) === forOwner)
+            return running.done;
+        // The list starts over, so a next page still on its way would land on the wrong list.
+        nextPage.current = null;
+        const flight = { owner: forOwner, done: Promise.resolve() };
+        flight.done = (async () => {
+            try {
+                const page = await (await historySource()).page(pageSizeRef.current, null);
+                update(forOwner, () => ({
+                    entries: withPage([], page.entries), cursor: page.nextCursor, answered: true, loadingMore: false, error: null,
+                }));
+            }
+            catch (error) {
+                update(forOwner, () => ({ answered: true, loadingMore: false, error: asError(error) }));
+            }
+            finally {
+                if (firstPage.current === flight)
+                    firstPage.current = null;
+            }
+        })();
+        firstPage.current = flight;
+        return flight.done;
+    }, [historySource, update]);
+    const loadMore = (0, react_1.useCallback)(() => {
+        var _a, _b;
+        const forOwner = ownerRef.current;
+        const now = shownRef.current;
+        if (!forOwner || !now.answered || !now.cursor)
+            return;
+        if (((_a = firstPage.current) === null || _a === void 0 ? void 0 : _a.owner) === forOwner || ((_b = nextPage.current) === null || _b === void 0 ? void 0 : _b.owner) === forOwner)
+            return;
+        const flight = { owner: forOwner };
+        nextPage.current = flight;
+        const cursor = now.cursor;
+        update(forOwner, () => ({ loadingMore: true }));
+        void (async () => {
+            try {
+                const page = await (await historySource()).page(pageSizeRef.current, cursor);
+                if (nextPage.current !== flight)
+                    return;
+                update(forOwner, (state) => ({
+                    entries: withPage(state.entries, page.entries), cursor: page.nextCursor, loadingMore: false, error: null,
+                }));
+            }
+            catch (error) {
+                if (nextPage.current !== flight)
+                    return;
+                update(forOwner, () => ({ loadingMore: false, error: asError(error) }));
+            }
+            finally {
+                if (nextPage.current === flight)
+                    nextPage.current = null;
+            }
+        })();
+    }, [historySource, update]);
+    // A new shopper (or none) starts from nothing; signed out, nothing is read.
+    (0, react_1.useEffect)(() => {
+        setStored((state) => (state.owner === owner ? state : emptyHistory(owner)));
+        if (owner)
+            void refresh();
+    }, [owner, refresh]);
+    const restoring = customer.restoring && owner === null;
+    const loading = restoring || (owner !== null && !shown.answered);
+    return (0, react_1.useMemo)(() => ({
+        source,
+        available,
+        entries: shown.entries,
+        loading,
+        loadingMore: shown.loadingMore,
+        hasMore: !!shown.cursor,
+        error: shown.error,
+        loadMore,
+        refresh,
+    }), [source, available, shown.entries, loading, shown.loadingMore, shown.cursor, shown.error, loadMore, refresh]);
+}
+//# sourceMappingURL=useStoreCredit.js.map

package/dist/react/useStoreCredit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStoreCredit.js","sourceRoot":"","sources":["../../src/react/useStoreCredit.ts"],"names":[],"mappings":";;AAwCA,wCAqDC;AAqED,sDA8GC;AAhRD;;;;;;;GAOG;AACH,iCAA0E;AAC1E,sCAA4C;AAC5C,qDAQ6B;AAC7B,8CAA2E;AAC3E,uDAA4D;AAC5D,yDAAyD;AACzD,2CAAyC;AAkBzC,SAAgB,cAAc;;IAC5B,MAAM,EAAE,WAAW,EAAE,GAAG,IAAA,4BAAU,GAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAA,6BAAW,GAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,MAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,MAAM,mCAAI,IAAI,CAAC;IAC3C,MAAM,SAAS,GACb,MAAM,KAAK,IAAI,IAAI,QAAQ,CAAC,QAAQ,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,QAAQ,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC;IAEpG,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,IAAA,gBAAQ,EAAe,IAAI,CAAC,CAAC;IAC3D,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,IAAA,gBAAQ,EAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAe,IAAI,CAAC,CAAC;IAEvD,oEAAoE;IACpE,MAAM,WAAW,GAAG,IAAA,cAAM,EAAC,QAAQ,CAAC,CAAC;IACrC,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAC;IAC/B,MAAM,OAAO,GAAG,CAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,iBAAiB,KAAI,yCAA4B,CAAC;IAC/E,MAAM,OAAO,GAAG,IAAA,cAAM,EAAC,CAAC,CAAC,CAAC;IAE1B,MAAM,OAAO,GAAG,IAAA,mBAAW,EAAC,KAAK,IAAI,EAAE;;QACrC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,UAAU,CAAC,IAAI,CAAC,CAAC;YACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,OAAO;QACT,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,IAAI,CAAC;YACH,IAAI,IAAW,CAAC;YAChB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,OAAO,CAAoF,gCAAkB,CAAC,CAAC;gBACtJ,IAAI,GAAG,IAAA,4BAAc,EAAC,MAAA,MAAA,IAAI,CAAC,QAAQ,0CAAE,mBAAmB,CAAC,KAAK,mCAAI,EAAE,EAAE,MAAA,IAAA,wBAAe,GAAE,mCAAI,EAAE,CAAC,CAAC;YACjG,CAAC;iBAAM,CAAC;gBACN,MAAM,MAAM,GAAG,MAAM,IAAA,sCAAmB,EAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC;gBACnF,IAAI,GAAG,EAAE,MAAM,EAAE,IAAA,yBAAY,EAAC,MAAM,CAAC,YAAY,CAAC,EAAE,YAAY,EAAE,MAAA,IAAA,wBAAe,GAAE,mCAAI,EAAE,EAAE,CAAC;YAC9F,CAAC;YACD,IAAI,EAAE,KAAK,OAAO,CAAC,OAAO;gBAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,EAAE,KAAK,OAAO,CAAC,OAAO;gBAAE,QAAQ,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACtF,CAAC;gBAAS,CAAC;YACT,IAAI,EAAE,KAAK,OAAO,CAAC,OAAO;gBAAE,UAAU,CAAC,KAAK,CAAC,CAAC;QAChD,CAAC;IACH,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAEjC,qEAAqE;IACrE,MAAM,UAAU,GAAG,MAAA,MAAA,QAAQ,CAAC,QAAQ,0CAAE,EAAE,mCAAI,IAAI,CAAC;IACjD,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,KAAK,OAAO,EAAE,CAAC;IACjB,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;IAE1B,OAAO,IAAA,eAAO,EACZ,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAC3F,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CACtD,CAAC;AACJ,CAAC;AA6CD,MAAM,YAAY,GAAG,CAAC,KAAoB,EAAe,EAAE,CAAC,CAAC;IAC3D,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI;CACnF,CAAC,CAAC;AAEH,6EAA6E;AAC7E,SAAS,QAAQ,CAAC,OAA2B,EAAE,IAAwB;IACrE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5E,6FAA6F;IAC7F,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAChG,CAAC;AAED,MAAM,OAAO,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEhG;;;;;;;;;GASG;AACH,SAAgB,qBAAqB,CAAC,UAAwC,EAAE;;IAC9E,MAAM,EAAE,WAAW,EAAE,GAAG,IAAA,4BAAU,GAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAA,6BAAW,GAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,MAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,MAAM,mCAAI,IAAI,CAAC;IAC3C,MAAM,SAAS,GACb,MAAM,KAAK,IAAI,IAAI,QAAQ,CAAC,QAAQ,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,QAAQ,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC;IACpG,MAAM,OAAO,GAAG,CAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,iBAAiB,KAAI,yCAA4B,CAAC;IAC/E,MAAM,OAAO,GAAG,IAAA,sBAAU,EAAC,QAAQ,CAAC,CAAC;IACrC,4EAA4E;IAC5E,MAAM,KAAK,GAAG,SAAS,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,MAAM,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAE9E,MAAM,WAAW,GAAG,IAAA,cAAM,EAAC,QAAQ,CAAC,CAAC;IACrC,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAC;IAC/B,MAAM,QAAQ,GAAG,IAAA,cAAM,EAAC,KAAK,CAAC,CAAC;IAC/B,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC;IACzB,MAAM,WAAW,GAAG,IAAA,cAAM,EAAC,4CAA8B,CAAC,CAAC;IAC3D,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAA,OAAO,CAAC,QAAQ,mCAAI,4CAA8B,CAAC,CAAC,IAAI,4CAA8B,CAAC;IAEpI,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAA,gBAAQ,EAAc,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7E,mGAAmG;IACnG,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,IAAA,cAAM,EAAC,KAAK,CAAC,CAAC;IAC/B,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC;IAEzB,MAAM,SAAS,GAAG,IAAA,cAAM,EAAgD,IAAI,CAAC,CAAC;IAC9E,MAAM,QAAQ,GAAG,IAAA,cAAM,EAA2B,IAAI,CAAC,CAAC;IAExD,MAAM,MAAM,GAAG,IAAA,mBAAW,EAAC,CAAC,QAAgB,EAAE,MAAoD,EAAE,EAAE;QACpG,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5F,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,kGAAkG;IAClG,MAAM,aAAa,GAAG,IAAA,mBAAW,EAAC,KAAK,IAAuC,EAAE;;QAC9E,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC;QAChC,MAAM,QAAQ,GAAG,MAAA,IAAA,wBAAe,GAAE,mCAAI,EAAE,CAAC;QACzC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,IAAA,uCAAyB,EAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAClF,OAAO,IAAA,+BAAiB,EAAC,IAAA,sCAAmB,EAAC,GAAG,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;IACxE,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAEtB,MAAM,OAAO,GAAG,IAAA,mBAAW,EAAC,GAAkB,EAAE;QAC9C,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC;QAClC,IAAI,CAAC,QAAQ;YAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC;QAClC,IAAI,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,MAAK,QAAQ;YAAE,OAAO,OAAO,CAAC,IAAI,CAAC;QACrD,sFAAsF;QACtF,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;QACxB,MAAM,MAAM,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QAC5D,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE;YACxB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAC3E,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;oBACtB,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI;iBAC9G,CAAC,CAAC,CAAC;YACN,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;YAC1F,CAAC;oBAAS,CAAC;gBACT,IAAI,SAAS,CAAC,OAAO,KAAK,MAAM;oBAAE,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;YAC7D,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QACL,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;QAC3B,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC;IAE5B,MAAM,QAAQ,GAAG,IAAA,mBAAW,EAAC,GAAG,EAAE;;QAChC,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC;QAClC,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,MAAM;YAAE,OAAO;QACtD,IAAI,CAAA,MAAA,SAAS,CAAC,OAAO,0CAAE,KAAK,MAAK,QAAQ,IAAI,CAAA,MAAA,QAAQ,CAAC,OAAO,0CAAE,KAAK,MAAK,QAAQ;YAAE,OAAO;QAC1F,MAAM,MAAM,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QACnC,QAAQ,CAAC,OAAO,GAAG,MAAM,CAAC;QAC1B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QAC1B,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAChD,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC7E,IAAI,QAAQ,CAAC,OAAO,KAAK,MAAM;oBAAE,OAAO;gBACxC,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBAC3B,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI;iBACzG,CAAC,CAAC,CAAC;YACN,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,QAAQ,CAAC,OAAO,KAAK,MAAM;oBAAE,OAAO;gBACxC,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;YAC1E,CAAC;oBAAS,CAAC;gBACT,IAAI,QAAQ,CAAC,OAAO,KAAK,MAAM;oBAAE,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;YAC3D,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;IACP,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC;IAE5B,4EAA4E;IAC5E,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC5E,IAAI,KAAK;YAAE,KAAK,OAAO,EAAE,CAAC;IAC5B,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IAErB,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;IACvD,MAAM,OAAO,GAAG,SAAS,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACjE,OAAO,IAAA,eAAO,EACZ,GAAG,EAAE,CAAC,CAAC;QACL,MAAM;QACN,SAAS;QACT,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,OAAO;QACP,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM;QACvB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ;QACR,OAAO;KACR,CAAC,EACF,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAC7G,CAAC;AACJ,CAAC"}

package/dist/react/useTileCredit.d.ts

@@ -17,17 +17,18 @@ export interface UseTileCreditState {
     loading: boolean;
     error: Error | null;
     refresh: () => Promise<void>;
-    /** Redeem N cents and apply to the current cart (from `useCart`).
-     *  Throws if no cart is loaded yet. */
+    /** Redeem N cents and add the card to the current cart (from `useCart`).
+     *  Throws if no cart is loaded yet, or `TileCreditError('cart_refused')` when the card didn't go on. */
     redeemAndApply: (amountCents: number, opts?: {
         idempotencyKey?: string;
         reason?: string;
+        /** No longer used: the provider sets the cart's country (its `config.country`, else the shop's). */
         countryFallback?: string;
     }) => Promise<{
         redeemed: TileCreditRedeemResult;
         cart: Cart;
     }>;
-    /** Remove one or more applied gift cards from the current cart. */
+    /** Remove one or more applied gift cards from the current cart, by `AppliedGiftCard.id`. */
     removeAppliedGiftCards: (appliedGiftCardIds: string[]) => Promise<Cart>;
 }
 export declare function useTileCredit(opts: UseTileCreditOptions): UseTileCreditState;

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

@@ -1 +1 @@
-{"version":3,"file":"useTileCredit.d.ts","sourceRoot":"","sources":["../../src/react/useTileCredit.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,IAAI,EACJ,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,oBAAoB;IACnC;6DACyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B;2CACuC;IACvC,cAAc,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,KAAK,OAAO,CAAC;QAAE,QAAQ,EAAE,sBAAsB,CAAC;QAAC,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC;IAChE,mEAAmE;IACnE,sBAAsB,EAAE,CAAC,kBAAkB,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,kBAAkB,CAuF5E"}
+{"version":3,"file":"useTileCredit.d.ts","sourceRoot":"","sources":["../../src/react/useTileCredit.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EACV,IAAI,EACJ,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,oBAAoB;IACnC;6DACyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B;4GACwG;IACxG,cAAc,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,oGAAoG;QACpG,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,KAAK,OAAO,CAAC;QAAE,QAAQ,EAAE,sBAAsB,CAAC;QAAC,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC;IAChE,4FAA4F;IAC5F,sBAAsB,EAAE,CAAC,kBAAkB,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzE;AAUD,wBAAgB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,kBAAkB,CAmF5E"}