@tiledev/sdk-shopify 0.9.1 → 0.10.1

package/dist/react/useCartStoreCredit.js

@@ -0,0 +1,292 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useCartStoreCredit = useCartStoreCredit;
+/**
+ * Store credit on the cart: the balance, what is on the cart, and Apply / Remove, from the source the
+ * app chose on `ShopifyProvider` (`storeCredit.source`). One hook either way, so a cart screen needs no
+ * idea where the credit comes from.
+ *
+ * - **`tile`** (Tile Credit): Apply mints a gift card for the amount (`/public/me/redeem`) and adds it to
+ *   the cart through the provider's cart queue (`useCart().addGiftCardCodes`). Remove takes the app's
+ *   own card off and leaves every other gift card. Redeeming only reserves the credit: the wallet is
+ *   charged for what the order uses, so the balance doesn't move on Apply.
+ * - **`shopify`** (Shopify's store credit): only Shopify's checkout can take it, so the hook reads the
+ *   balance and says `atCheckout`; `apply` and `remove` do nothing.
+ *
+ * Rules (decided 2026-10-05, Head of Engineering):
+ * - **One Apply or Remove at a time.** A second call while one runs gets the running one's promise: two
+ *   redeems at once with different keys would mint two cards (the service's idempotency isn't atomic).
+ * - **Every Apply mints a new card** with a new idempotency key. The key is reused only to retry the
+ *   same attempt (same shopper, same amount, right after it failed), so a retry after a lost answer
+ *   gets the card already minted instead of another. A new card disables the previous one, so any
+ *   earlier card of the app's still on the cart is taken off once the new one is on.
+ * - **The app's card on the cart** is found by its last characters (`appliedGiftCards[].lastCharacters`):
+ *   the last four of the card this hook minted, or after a restart the shopper's active card
+ *   (`/public/me/gift-cards`). `applied` is what that card takes off this cart (`presentmentAmountUsed`).
+ * - **The balance is read** when the hook mounts, for each new shopper (nothing from the one before
+ *   shows, not even for a render), when the app comes back to the foreground, after every Apply and
+ *   Remove, and on `refresh()`.
+ * - Failures never reject: `apply` and `remove` resolve false and set `error`, a `TileCreditError`
+ *   whose `code` the app words. A 401 renews the token once and never signs the shopper out.
+ */
+const react_1 = require("react");
+const client_1 = require("../client");
+const cart_1 = require("../cart");
+const storeCredit_1 = require("../auth/storeCredit");
+const tileCredit_1 = require("../tileCredit");
+const types_1 = require("../types");
+const appForeground_1 = require("./appForeground");
+const ShopifyProvider_1 = require("./ShopifyProvider");
+const useOrders_1 = require("./useOrders");
+const tileCreditClient_1 = require("./tileCreditClient");
+const nothingHeld = (owner) => ({
+    owner, balance: null, activeCardEnding: null, answered: false, readError: null,
+});
+/** Unique per attempt on this device; not a secret. */
+function newIdempotencyKey() {
+    return `app-cart-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+}
+/** Every failure as a `TileCreditError`, so the app words one kind of error. */
+function asCreditError(error, fallback = 'internal') {
+    if (error instanceof types_1.TileCreditError)
+        return error;
+    const message = error instanceof Error ? error.message : String(error);
+    if (error instanceof types_1.ShopifyError && error.errors.length)
+        return new types_1.TileCreditError('cart_refused', message);
+    if (/network|fetch|request failed|timed? ?out|offline/i.test(message))
+        return new types_1.TileCreditError('network', message);
+    return new types_1.TileCreditError(fallback, message);
+}
+/** The total the app's cards take off the cart, in its currency. */
+function totalUsed(cards) {
+    var _a, _b, _c;
+    if (cards.length === 0)
+        return null;
+    const cents = cards.reduce((sum, card) => { var _a, _b; return sum + Math.round((Number.parseFloat((_b = (_a = card.presentmentAmountUsed) === null || _a === void 0 ? void 0 : _a.amount) !== null && _b !== void 0 ? _b : '0') || 0) * 100); }, 0);
+    const currencyCode = (_c = (_b = (_a = cards[0].presentmentAmountUsed) === null || _a === void 0 ? void 0 : _a.currencyCode) !== null && _b !== void 0 ? _b : (0, client_1.getCurrencyCode)()) !== null && _c !== void 0 ? _c : '';
+    return { amount: (0, tileCredit_1.centsToMoney)(cents), currencyCode };
+}
+function useCartStoreCredit() {
+    var _a, _b;
+    const { storeCredit } = (0, ShopifyProvider_1.useShopify)();
+    const customer = (0, ShopifyProvider_1.useCustomer)();
+    const cartState = (0, ShopifyProvider_1.useCart)();
+    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 credit 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 cartRef = (0, react_1.useRef)(cartState);
+    cartRef.current = cartState;
+    const ownerRef = (0, react_1.useRef)(owner);
+    ownerRef.current = owner;
+    const [stored, setStored] = (0, react_1.useState)(() => nothingHeld(owner));
+    // Another shopper's balance never shows, not even for the render before the effect below clears it.
+    const held = stored.owner === owner ? stored : nothingHeld(owner);
+    const heldRef = (0, react_1.useRef)(held);
+    heldRef.current = held;
+    // The last characters of the card this hook minted, for this shopper.
+    const [minted, setMinted] = (0, react_1.useState)(null);
+    const mintedEnding = minted && minted.owner === owner ? minted.ending : null;
+    const mintedRef = (0, react_1.useRef)(mintedEnding);
+    mintedRef.current = mintedEnding;
+    const [running, setRunning] = (0, react_1.useState)(null);
+    const runningRef = (0, react_1.useRef)(null);
+    const [actionError, setActionError] = (0, react_1.useState)(null);
+    const attempt = (0, react_1.useRef)(null);
+    const reading = (0, react_1.useRef)(null);
+    const update = (0, react_1.useCallback)((forOwner, change) => {
+        setStored((state) => (state.owner === forOwner ? { ...state, ...change } : { ...nothingHeld(forOwner), ...change }));
+    }, []);
+    /** Reads the balance (and, for Tile Credit, the active card) for the shopper now. */
+    const read = (0, react_1.useCallback)((forOwner) => {
+        const flight = { owner: forOwner, done: Promise.resolve() };
+        flight.done = (async () => {
+            var _a, _b, _c, _d, _e;
+            try {
+                const now = customerRef.current;
+                const currency = (_a = (0, client_1.getCurrencyCode)()) !== null && _a !== void 0 ? _a : '';
+                if (source === 'shopify') {
+                    const data = await now.request(storeCredit_1.STORE_CREDIT_QUERY);
+                    if (ownerRef.current !== forOwner)
+                        return;
+                    update(forOwner, { balance: (0, storeCredit_1.sumStoreCredit)((_c = (_b = data.customer) === null || _b === void 0 ? void 0 : _b.storeCreditAccounts.nodes) !== null && _c !== void 0 ? _c : [], currency), answered: true, readError: null });
+                    return;
+                }
+                const client = (0, tileCreditClient_1.tileCreditClientFor)(now, baseUrl);
+                const [wallet, cards] = await Promise.allSettled([client.getWallet(), client.listGiftCards()]);
+                if (ownerRef.current !== forOwner)
+                    return;
+                if (wallet.status === 'rejected')
+                    throw wallet.reason;
+                const change = {
+                    balance: { amount: (0, tileCredit_1.centsToMoney)(wallet.value.balanceCents), currencyCode: currency },
+                    answered: true,
+                    readError: null,
+                };
+                // The cards list is what finds the app's card after a restart; a failure keeps what was known.
+                if (cards.status === 'fulfilled') {
+                    change.activeCardEnding = (_e = (_d = cards.value.giftCards.find((card) => card.status === 'active')) === null || _d === void 0 ? void 0 : _d.last4) !== null && _e !== void 0 ? _e : null;
+                }
+                update(forOwner, change);
+            }
+            catch (error) {
+                if (ownerRef.current === forOwner)
+                    update(forOwner, { answered: true, readError: asCreditError(error, 'network') });
+            }
+            finally {
+                if (reading.current === flight)
+                    reading.current = null;
+            }
+        })();
+        reading.current = flight;
+        return flight.done;
+    }, [source, baseUrl, update]);
+    const refresh = (0, react_1.useCallback)(() => {
+        var _a;
+        const forOwner = ownerRef.current;
+        if (!forOwner)
+            return Promise.resolve();
+        if (((_a = reading.current) === null || _a === void 0 ? void 0 : _a.owner) === forOwner)
+            return reading.current.done;
+        return read(forOwner);
+    }, [read]);
+    /** After a write: a new read, not one that started before the write. */
+    const readAfterWrite = (0, react_1.useCallback)((forOwner) => {
+        if (ownerRef.current === forOwner)
+            void read(forOwner);
+    }, [read]);
+    // Each shopper (or none) starts from nothing; signed out, nothing is read.
+    (0, react_1.useEffect)(() => {
+        setStored((state) => (state.owner === owner ? state : nothingHeld(owner)));
+        if (owner)
+            void refresh();
+    }, [owner, refresh]);
+    // Back in the foreground: the balance may have moved (an order, the web store's own redeem).
+    (0, react_1.useEffect)(() => {
+        if (!owner)
+            return undefined;
+        return (0, appForeground_1.onAppForeground)(() => void refresh());
+    }, [owner, refresh]);
+    /** Runs `work` as the one Apply or Remove, or hands back the one already running. */
+    const runOne = (0, react_1.useCallback)((kind, forOwner, work) => {
+        const now = runningRef.current;
+        if (now)
+            return now.done;
+        setActionError(null);
+        const entry = { owner: forOwner, kind, done: Promise.resolve(false) };
+        entry.done = (async () => {
+            try {
+                return await work();
+            }
+            catch (error) {
+                if (ownerRef.current === forOwner)
+                    setActionError({ owner: forOwner, error: asCreditError(error) });
+                return false;
+            }
+            finally {
+                runningRef.current = null;
+                setRunning(null);
+                readAfterWrite(forOwner);
+            }
+        })();
+        runningRef.current = entry;
+        setRunning(entry);
+        return entry.done;
+    }, [readAfterWrite]);
+    const apply = (0, react_1.useCallback)((amountCents) => {
+        const forOwner = ownerRef.current;
+        if (!forOwner || source !== 'tile')
+            return Promise.resolve(false);
+        return runOne('applying', forOwner, async () => {
+            if (!Number.isSafeInteger(amountCents) || amountCents <= 0) {
+                throw new types_1.TileCreditError('validation', 'The amount must be more than zero');
+            }
+            // A retry of the attempt that just failed keeps its key; anything else is a new attempt.
+            const last = attempt.current;
+            const thisAttempt = last && last.owner === forOwner && last.amountCents === amountCents
+                ? last
+                : { owner: forOwner, amountCents, idempotencyKey: newIdempotencyKey() };
+            attempt.current = thisAttempt;
+            const earlierEndings = [mintedRef.current, heldRef.current.activeCardEnding].filter((ending) => !!ending);
+            const redeemed = await (0, tileCreditClient_1.tileCreditClientFor)(customerRef.current, baseUrl).redeem({
+                amountCents,
+                idempotencyKey: thisAttempt.idempotencyKey,
+                reason: 'Applied to the cart in the app',
+            });
+            if (ownerRef.current !== forOwner)
+                return false;
+            setMinted({ owner: forOwner, ending: redeemed.last4 });
+            mintedRef.current = redeemed.last4;
+            let onCart;
+            try {
+                onCart = await cartRef.current.addGiftCardCodes([redeemed.code]);
+            }
+            catch (error) {
+                // A card handed back for this key that won't go on (disabled since) is never retried with it.
+                if (redeemed.duplicate)
+                    attempt.current = null;
+                const failure = asCreditError(error, 'cart_refused');
+                throw failure.code === 'network' ? failure : new types_1.TileCreditError('cart_refused', failure.message);
+            }
+            if (!onCart)
+                throw new types_1.TileCreditError('cart_refused', 'There is no cart to put the credit on');
+            attempt.current = null;
+            // The new card disabled the app's earlier one; if that is still on the cart, it comes off.
+            const newCard = new Set((0, cart_1.giftCardsEndingIn)(onCart, [redeemed.last4]).map((card) => card.id));
+            const stale = (0, cart_1.giftCardsEndingIn)(onCart, earlierEndings).filter((card) => !newCard.has(card.id));
+            if (stale.length) {
+                await cartRef.current.removeGiftCards(stale.map((card) => card.id)).catch(() => undefined);
+            }
+            return true;
+        });
+    }, [source, baseUrl, runOne]);
+    const remove = (0, react_1.useCallback)(() => {
+        const forOwner = ownerRef.current;
+        if (!forOwner || source !== 'tile')
+            return Promise.resolve(false);
+        return runOne('removing', forOwner, async () => {
+            const endings = [mintedRef.current, heldRef.current.activeCardEnding].filter((ending) => !!ending);
+            const ours = (0, cart_1.giftCardsEndingIn)(cartRef.current.cart, endings);
+            if (ours.length === 0)
+                return true;
+            await cartRef.current.removeGiftCards(ours.map((card) => card.id));
+            return true;
+        });
+    }, [source, runOne]);
+    const endings = [mintedEnding, held.activeCardEnding].filter((ending) => !!ending);
+    const ourCards = source === 'tile' && owner ? (0, cart_1.giftCardsEndingIn)(cartState.cart, endings) : [];
+    const appliedKey = ourCards.map((card) => { var _a; return `${card.id}:${(_a = card.presentmentAmountUsed) === null || _a === void 0 ? void 0 : _a.amount}`; }).join('|');
+    const applied = (0, react_1.useMemo)(() => totalUsed(ourCards), [appliedKey]); // eslint-disable-line react-hooks/exhaustive-deps
+    const runningNow = running && running.owner === owner ? running.kind : null;
+    const error = (_b = (actionError && actionError.owner === owner ? actionError.error : null)) !== null && _b !== void 0 ? _b : held.readError;
+    let status;
+    if (!owner)
+        status = 'hidden';
+    else if (source === 'shopify')
+        status = held.balance ? 'atCheckout' : held.readError ? 'error' : 'loading';
+    else if (runningNow)
+        status = runningNow;
+    else if (ourCards.length > 0)
+        status = 'applied';
+    else if (held.balance)
+        status = 'ready';
+    else if (held.readError)
+        status = 'error';
+    else
+        status = 'loading';
+    return (0, react_1.useMemo)(() => ({
+        source,
+        status,
+        balance: owner ? held.balance : null,
+        applied: status === 'hidden' ? null : applied,
+        error: owner ? error : null,
+        apply,
+        remove,
+        refresh,
+    }), [source, status, owner, held.balance, applied, error, apply, remove, refresh]);
+}
+//# sourceMappingURL=useCartStoreCredit.js.map

package/dist/react/useCartStoreCredit.js.map

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

package/dist/react/useOrders.d.ts

@@ -0,0 +1,104 @@
+import { type CustomerState } from './ShopifyProvider';
+import type { OrderDetails, OrderSummary } from '../types';
+/** Orders per page, unless `useOrders({ pageSize })` says otherwise. */
+export declare const ORDERS_PAGE_SIZE = 25;
+export interface UseOrdersOptions {
+    /** Orders per page. Default `ORDERS_PAGE_SIZE` (25). */
+    pageSize?: number;
+}
+export interface OrdersState {
+    /** Newest first. Empty when signed out. */
+    orders: OrderSummary[];
+    /**
+     * 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;
+    /** The last read failed. Whatever was shown stays. Cleared by the next read that works. */
+    error: Error | null;
+    /** More orders than are loaded. */
+    hasMore: boolean;
+    /** Reads the next page. Does nothing while another read is on its way, or when there is no more. */
+    loadMore: () => void;
+    /**
+     * Reads the first page again (pull to refresh, a screen coming back into view), keeping the list on
+     * screen and the pages loaded after the first. Joins a read already on its way. Never rejects.
+     */
+    refresh: () => Promise<void>;
+}
+export interface BuyAgainResult {
+    /**
+     * Lines that went into the cart, some perhaps fewer than ordered: cut to the stock left, or by the
+     * cart's guard (Cart Hold takes only the units still free). A cut isn't reported.
+     */
+    added: number;
+    /**
+     * Lines that didn't: no variant any more, not for sale, `skipVariant` said so, no stock left, or
+     * refused by the cart.
+     */
+    skipped: number;
+}
+export interface OrderState {
+    order: OrderDetails | null;
+    /** True only before the first answer (and while a stored session is read on app open). */
+    loading: boolean;
+    /** The last read failed. An order already shown stays. */
+    error: Error | null;
+    /** Shopify answered, and this shopper has no order with that id. */
+    notFound: boolean;
+    /** Reads the order again, keeping it on screen. Joins a read already on its way. Never rejects. */
+    refresh: () => Promise<void>;
+    /**
+     * Puts the order's lines back in the cart through the cart's own add (`addLines`: its guard, its
+     * line limit, one `cart:add`). Stock is read fresh first: a line whose variant is gone or not for
+     * sale is skipped, and a quantity over what is left (counting what the cart holds) is cut to it.
+     * Never throws; anything that fails counts as skipped.
+     *
+     * `options.skipVariant`: lines whose variant it returns true for are skipped before anything is
+     * claimed (the app passes Cart Hold's `isHeldOut`). The add is quiet (`addLines(…, { quiet: true })`):
+     * the guard and the line-by-line retry say nothing per line, and the caller shows one summary.
+     */
+    buyAgain: (options?: {
+        skipVariant?: (variantId: string) => boolean;
+    }) => Promise<BuyAgainResult>;
+}
+/**
+ * Whose orders these are: a new value for each session, and for a different customer within one.
+ * Null when signed out. The profile arriving after the session began (app open, sign-in) is the same
+ * shopper, so it doesn't count; keying on the profile would read everything twice. Also keys
+ * `useStoreCreditHistory`.
+ */
+export declare function useShopper(customer: CustomerState): string | null;
+/** The signed-in shopper's orders, newest first, a page at a time. */
+export declare function useOrders(options?: UseOrdersOptions): OrdersState;
+/**
+ * Shopify can take a few seconds to list a new order: until it does, the newest order is read again
+ * after these many seconds.
+ */
+export declare const LATEST_ORDER_READ_AGAIN_SECONDS: readonly number[];
+export interface UseLatestOrderSinceOptions {
+    /** Seconds after which the newest order is read again while it isn't the new one yet. Default 3 and 8. */
+    readAgainAfterSeconds?: readonly number[];
+    /** How far the phone's clock may be ahead of Shopify's, in ms. Default `ORDER_CLOCK_LEEWAY_MS` (2 minutes). */
+    clockLeewayMs?: number;
+}
+export interface LatestOrderSince {
+    /**
+     * The shopper's newest order, once it was placed at or after `since` (less the clock leeway). Null
+     * until Shopify lists it, when it never does, and when signed out: no number rather than a wrong one.
+     */
+    order: OrderSummary | null;
+}
+/**
+ * The order the shopper just placed, for an Order Confirmed page: the newest order, but only once it
+ * was placed at or after `since` (when checkout opened, on the phone's clock). Until then the newest
+ * is the order before, which production showed. While it isn't listed yet, the newest is read again
+ * after 3 and 8 seconds. Signed out, nothing is read and `order` is null (a guest's order isn't known
+ * here). `since` left out takes the newest order, whatever its date.
+ */
+export declare function useLatestOrderSince(since: number | null | undefined, options?: UseLatestOrderSinceOptions): LatestOrderSince;
+/** One of the signed-in shopper's orders, by the `id` `useOrders` gave. Nothing is read without an id. */
+export declare function useOrder(id: string | undefined): OrderState;
+//# sourceMappingURL=useOrders.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useOrders.d.ts","sourceRoot":"","sources":["../../src/react/useOrders.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE3D,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,WAAW,EAAE,OAAO,CAAC;IACrB,2FAA2F;IAC3F,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,oGAAoG;IACpG,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB;;;OAGG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,0FAA0F;IAC1F,OAAO,EAAE,OAAO,CAAC;IACjB,0DAA0D;IAC1D,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,oEAAoE;IACpE,QAAQ,EAAE,OAAO,CAAC;IAClB,mGAAmG;IACnG,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B;;;;;;;;;OASG;IACH,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CACnG;AAUD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAgBjE;AAwBD,sEAAsE;AACtE,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,WAAW,CA4FrE;AAID;;;GAGG;AACH,eAAO,MAAM,+BAA+B,EAAE,SAAS,MAAM,EAAW,CAAC;AAEzE,MAAM,WAAW,0BAA0B;IACzC,0GAA0G;IAC1G,qBAAqB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,+GAA+G;IAC/G,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,OAAO,GAAE,0BAA+B,GACvC,gBAAgB,CAmBlB;AAcD,0GAA0G;AAC1G,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CA0F3D"}