@tiledev/sdk-shopify 0.4.1 → 0.7.0

package/dist/react/useProduct.js.map

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

package/dist/react/useProductFeed.d.ts

@@ -0,0 +1,57 @@
+import type { Filter, PageInfo, Product, ProductFilter } from '../types';
+/** A cached first page younger than this is shown without asking the network again. */
+export declare const REVALIDATE_AFTER_MS: number;
+export interface FeedPage {
+    nodes: Product[];
+    pageInfo: PageInfo;
+    filters?: Filter[];
+    title?: string | null;
+    totalCount?: number;
+}
+export interface FeedSource {
+    /** Which feed this is (`collection:<handle>`, `search:<term>`); null when there is nothing to read. */
+    id: string | null;
+    /** What else shapes the first page: sort, page size. Fixed filters are passed separately. */
+    paramsKey: string;
+    /** Filters the app always applies; the shopper's selection goes on top. */
+    fixedFilters?: ProductFilter[];
+    fetch(args: {
+        after?: string;
+        filters: ProductFilter[] | undefined;
+        fresh: boolean;
+    }): Promise<FeedPage>;
+    onError?: (error: unknown, phase: 'first' | 'more') => void;
+}
+export interface ProductFeedState {
+    products: Product[];
+    /** Null until a first page is known, so a screen can render its own heading first. */
+    title: string | null;
+    /** The facets Shopify offers for these products under the current filters. */
+    availableFilters: Filter[];
+    /** Search only: how many products match. */
+    totalCount?: number;
+    /** Nothing to show yet: no cached page, and the first read is in flight. */
+    loading: boolean;
+    /** A later page is in flight: the grid keeps what it has and shows a footer spinner. */
+    loadingMore: boolean;
+    /** A cached page is on screen while the fresh one is read. No spinner needed. */
+    refreshing: boolean;
+    hasMore: boolean;
+    error: boolean;
+}
+export interface ProductFeedResult extends ProductFeedState {
+    loadMore: () => void;
+    /** Re-reads the first page from the network. The name for an error state's button. */
+    retry: () => void;
+    /** Re-reads the first page from the network, keeping what is on screen until it lands. */
+    refresh: () => void;
+    /** The shopper's filter selection, as the `input` strings of the values they picked. */
+    selectedFilters: string[];
+    /** Replace the selection. An input that isn't a Shopify filter (unparseable JSON) is dropped. */
+    setFilters: (inputs: string[]) => void;
+    clearFilters: () => void;
+    /** True while the shopper has at least one filter selected. */
+    filterActive: boolean;
+}
+export declare function useProductFeed(source: FeedSource): ProductFeedResult;
+//# sourceMappingURL=useProductFeed.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useProductFeed.d.ts","sourceRoot":"","sources":["../../src/react/useProductFeed.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzE,uFAAuF;AACvF,eAAO,MAAM,mBAAmB,QAAY,CAAC;AAE7C,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,uGAAuG;IACvG,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,6FAA6F;IAC7F,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,aAAa,EAAE,CAAC;IAC/B,KAAK,CAAC,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,aAAa,EAAE,GAAG,SAAS,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzG,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,KAAK,IAAI,CAAC;CAC7D;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,sFAAsF;IACtF,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,8EAA8E;IAC9E,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,OAAO,EAAE,OAAO,CAAC;IACjB,wFAAwF;IACxF,WAAW,EAAE,OAAO,CAAC;IACrB,iFAAiF;IACjF,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,sFAAsF;IACtF,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,0FAA0F;IAC1F,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,wFAAwF;IACxF,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iGAAiG;IACjG,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACvC,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,+DAA+D;IAC/D,YAAY,EAAE,OAAO,CAAC;CACvB;AAwCD,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,iBAAiB,CA4KpE"}

package/dist/react/useProductFeed.js

@@ -0,0 +1,231 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REVALIDATE_AFTER_MS = void 0;
+exports.useProductFeed = useProductFeed;
+/**
+ * The engine behind `useCollectionProducts` and `useSearch`: a cursor-paged product list that shows
+ * its cached first page first and revalidates in the background.
+ *
+ * - **Cache first.** The first page last seen for this feed (memory, else the device store: MMKV on
+ *   native) renders immediately, on the first frame after a cold start too. Then the network answer
+ *   replaces it in place, with `refreshing` true in between rather than a spinner. A cached page
+ *   younger than `REVALIDATE_AFTER_MS` is not re-read at all.
+ * - **Cursor paging that appends,** never growing `first`: the Storefront API rejects `first > 250`,
+ *   and a failed `loadMore` only stops growth instead of replacing the grid.
+ * - **Stale answers are dropped.** Every response is checked against the request that is current
+ *   (`requestId`), so a page resolving after the query, sort or filters changed can't merge in.
+ * - **The shopper's filter selection** (`setFilters`) is held as the `FilterValue.input` strings a
+ *   filter sheet works with, and belongs to the feed it was made on.
+ */
+const react_1 = require("react");
+const client_1 = require("../client");
+const productStore_1 = require("../productStore");
+const ShopifyProvider_1 = require("./ShopifyProvider");
+/** A cached first page younger than this is shown without asking the network again. */
+exports.REVALIDATE_AFTER_MS = 60 * 1000;
+/** One stable empty selection, so a screen's memo on `selectedFilters` holds across renders. */
+const NO_INPUTS = [];
+/** A `FilterValue.input` as the `ProductFilter` it encodes, or null when it isn't one. */
+function parseFilterInput(input) {
+    try {
+        const value = JSON.parse(input);
+        return value && typeof value === 'object' && !Array.isArray(value) ? value : null;
+    }
+    catch {
+        return null;
+    }
+}
+const IDLE = {
+    products: [],
+    title: null,
+    availableFilters: [],
+    loading: false,
+    loadingMore: false,
+    refreshing: false,
+    hasMore: false,
+    error: false,
+};
+function fromList(list, refreshing) {
+    return {
+        products: list.products,
+        title: list.title,
+        availableFilters: list.filters,
+        totalCount: list.totalCount,
+        loading: false,
+        loadingMore: false,
+        refreshing,
+        hasMore: list.pageInfo.hasNextPage,
+        error: false,
+    };
+}
+function useProductFeed(source) {
+    var _a;
+    const { ready } = (0, ShopifyProvider_1.useShopify)();
+    // The provider sets the config on its first render, so reads can start before its own startup
+    // (cart, wishlist, customer) finishes; `ready` re-runs the effect if the config came later.
+    const configured = ready || (0, client_1.isConfigured)();
+    // The latest source, so the effect and `loadMore` don't depend on a fetch function's identity.
+    const sourceRef = (0, react_1.useRef)(source);
+    sourceRef.current = source;
+    /**
+     * Stored with the feed it was made on. Read against another feed it is empty: facets belong to a
+     * collection or a query, and resetting it in an effect would first read the new feed with the old
+     * filters.
+     */
+    const [selection, setSelection] = (0, react_1.useState)({
+        id: source.id,
+        inputs: NO_INPUTS,
+    });
+    const selectedFilters = selection.id === source.id ? selection.inputs : NO_INPUTS;
+    const allFilters = [
+        ...((_a = source.fixedFilters) !== null && _a !== void 0 ? _a : []),
+        ...selectedFilters.map(parseFilterInput).filter((f) => f !== null),
+    ];
+    // Filters and sort objects are rebuilt every render; the effect keys on their serialisation.
+    const filterKey = allFilters.length ? JSON.stringify(allFilters) : '';
+    const listKey = source.id ? `${source.id}|${source.paramsKey}|${filterKey}` : null;
+    // First render: the cached page, if there is one, so the grid paints on frame one.
+    const [state, setState] = (0, react_1.useState)(() => {
+        const cached = configured && listKey ? (0, productStore_1.peekList)(listKey) : null;
+        return cached ? fromList(cached, true) : IDLE;
+    });
+    const [attempt, setAttempt] = (0, react_1.useState)(0);
+    const requestId = (0, react_1.useRef)(0);
+    /** The cursor for the next page. Null while a first page is being (re)read, which pauses paging. */
+    const cursor = (0, react_1.useRef)(null);
+    /** Set by `refresh`/`retry` so the next first-page read skips every cache. */
+    const freshNext = (0, react_1.useRef)(false);
+    (0, react_1.useEffect)(() => {
+        // No client yet, or nothing to read, is not a failed load — it is no load.
+        if (!configured || !listKey) {
+            requestId.current += 1;
+            cursor.current = null;
+            setState(IDLE);
+            return;
+        }
+        const id = (requestId.current += 1);
+        const fresh = freshNext.current;
+        freshNext.current = false;
+        const cached = (0, productStore_1.peekList)(listKey);
+        if (cached && !fresh && Date.now() - cached.at < exports.REVALIDATE_AFTER_MS) {
+            // Recent enough: show it and page on from its cursor, without a network read.
+            cursor.current = cached.pageInfo.endCursor;
+            setState(fromList(cached, false));
+            return;
+        }
+        // Paging waits for the fresh first page: a cached cursor may no longer match it.
+        cursor.current = null;
+        setState((current) => {
+            if (cached)
+                return fromList(cached, true);
+            // A refresh keeps what is on screen until the fresh page lands.
+            if (fresh && current.products.length)
+                return { ...current, refreshing: true, error: false };
+            return { ...IDLE, loading: true };
+        });
+        sourceRef.current
+            .fetch({ filters: allFilters.length ? allFilters : undefined, fresh })
+            .then((page) => {
+            var _a, _b, _c, _d;
+            if (requestId.current !== id)
+                return;
+            cursor.current = page.pageInfo.endCursor;
+            (0, productStore_1.rememberList)(listKey, {
+                products: page.nodes,
+                pageInfo: page.pageInfo,
+                title: (_a = page.title) !== null && _a !== void 0 ? _a : null,
+                filters: (_b = page.filters) !== null && _b !== void 0 ? _b : [],
+                totalCount: page.totalCount,
+            });
+            setState({
+                products: page.nodes,
+                title: (_c = page.title) !== null && _c !== void 0 ? _c : null,
+                availableFilters: (_d = page.filters) !== null && _d !== void 0 ? _d : [],
+                totalCount: page.totalCount,
+                loading: false,
+                loadingMore: false,
+                refreshing: false,
+                hasMore: page.pageInfo.hasNextPage,
+                error: false,
+            });
+        })
+            .catch((caught) => {
+            var _a, _b;
+            (_b = (_a = sourceRef.current).onError) === null || _b === void 0 ? void 0 : _b.call(_a, caught, 'first');
+            if (requestId.current !== id)
+                return;
+            setState((current) => {
+                var _a;
+                // A failed revalidation leaves the cached page usable: keep it, and page on from it.
+                if (current.products.length) {
+                    cursor.current = (_a = cached === null || cached === void 0 ? void 0 : cached.pageInfo.endCursor) !== null && _a !== void 0 ? _a : null;
+                    return { ...current, refreshing: false };
+                }
+                return { ...IDLE, error: true };
+            });
+        });
+        // Keyed on the serialised feed; filter and sort objects change identity every render.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [configured, listKey, attempt]);
+    /**
+     * Guarded on the in-flight flags and `hasMore`: a list's `onEndReached` fires every time the end
+     * stays in view, so an ungated version would run through the feed a page a frame.
+     */
+    const loadMore = (0, react_1.useCallback)(() => {
+        if (state.loading || state.loadingMore || state.refreshing || !state.hasMore || !cursor.current)
+            return;
+        const id = requestId.current;
+        const after = cursor.current;
+        // Claim the cursor synchronously: a second call in the same frame would otherwise fetch this
+        // same page again and append it twice. The fetch restores it; a failure leaves it null.
+        cursor.current = null;
+        setState((current) => ({ ...current, loadingMore: true }));
+        sourceRef.current
+            .fetch({ after, filters: allFilters.length ? allFilters : undefined, fresh: false })
+            .then((page) => {
+            if (requestId.current !== id)
+                return;
+            cursor.current = page.pageInfo.endCursor;
+            setState((current) => {
+                // Defensive against any overlap between pages: never append a product already held.
+                const seen = new Set(current.products.map((p) => p.id));
+                const added = page.nodes.filter((p) => !seen.has(p.id));
+                return {
+                    ...current,
+                    products: added.length ? [...current.products, ...added] : current.products,
+                    loadingMore: false,
+                    hasMore: page.pageInfo.hasNextPage,
+                };
+            });
+        })
+            .catch((caught) => {
+            var _a, _b;
+            (_b = (_a = sourceRef.current).onError) === null || _b === void 0 ? void 0 : _b.call(_a, caught, 'more');
+            if (requestId.current !== id)
+                return;
+            // A failed page is not a failed feed: what is on screen stays, and it stops growing.
+            setState((current) => ({ ...current, loadingMore: false, hasMore: false }));
+        });
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [state.loading, state.loadingMore, state.refreshing, state.hasMore, listKey]);
+    const setFilters = (0, react_1.useCallback)((inputs) => {
+        const valid = Array.from(new Set(inputs)).filter((input) => parseFilterInput(input) !== null);
+        setSelection({ id: source.id, inputs: valid.length ? valid : NO_INPUTS });
+    }, [source.id]);
+    const clearFilters = (0, react_1.useCallback)(() => setSelection({ id: source.id, inputs: NO_INPUTS }), [source.id]);
+    const refresh = (0, react_1.useCallback)(() => {
+        freshNext.current = true;
+        setAttempt((n) => n + 1);
+    }, []);
+    return {
+        ...state,
+        loadMore,
+        retry: refresh,
+        refresh,
+        selectedFilters,
+        setFilters,
+        clearFilters,
+        filterActive: selectedFilters.length > 0,
+    };
+}
+//# sourceMappingURL=useProductFeed.js.map

package/dist/react/useProductFeed.js.map

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

package/dist/react/useSearch.d.ts

@@ -0,0 +1,30 @@
+import { type ProductFeedResult, type ProductFeedState } from './useProductFeed';
+import type { ImageTransform, ProductFilter } from '../types';
+/** `key` is a Storefront `SearchSortKeys` value: `RELEVANCE` or `PRICE`. */
+export interface SearchSort {
+    key: string;
+    reverse?: boolean;
+}
+export declare const SEARCH_PAGE_SIZE = 12;
+export declare const SEARCH_DEBOUNCE_MS = 300;
+export interface UseSearchOptions {
+    sort?: SearchSort;
+    /** Filters the app always applies; the shopper's selection (`setFilters`) goes on top. */
+    filters?: ProductFilter[];
+    pageSize?: number;
+    /** How long typing must pause before the term is searched. Default 300 ms. */
+    debounceMs?: number;
+    /** Resize/convert the results' images on Shopify's CDN. */
+    imageTransform?: ImageTransform;
+    onError?: (error: unknown, context: {
+        at: string;
+        query: string;
+    }) => void;
+}
+export interface UseSearchResult extends ProductFeedResult {
+    /** The term actually searched: the input, trimmed, after the debounce. */
+    query: string;
+}
+export type SearchState = ProductFeedState;
+export declare function useSearch(term: string, options?: UseSearchOptions): UseSearchResult;
+//# sourceMappingURL=useSearch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useSearch.d.ts","sourceRoot":"","sources":["../../src/react/useSearch.ts"],"names":[],"mappings":"AAaA,OAAO,EAAkB,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACjG,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9D,4EAA4E;AAC5E,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,0FAA0F;IAC1F,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAC5E;AAED,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACxD,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,WAAW,GAAG,gBAAgB,CAAC;AAE3C,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,eAAe,CAwCvF"}

package/dist/react/useSearch.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SEARCH_DEBOUNCE_MS = exports.SEARCH_PAGE_SIZE = void 0;
+exports.useSearch = useSearch;
+/**
+ * useSearch — product search (a search page), cache first.
+ *
+ * The same engine as `useCollectionProducts` (`useProductFeed`): the last first page for this query
+ * renders immediately, the network answer replaces it in place, and paging is by cursor. The typed
+ * term is debounced, so each keystroke is not a request; the first render uses the term as given, so
+ * a search page opened with a query paints from cache at once.
+ *
+ * Every product a search returns records its base keys in the product store, so tapping a result
+ * opens its product page with title, image and price already there.
+ */
+const react_1 = require("react");
+const shopify_1 = require("../shopify");
+const useProductFeed_1 = require("./useProductFeed");
+exports.SEARCH_PAGE_SIZE = 12;
+exports.SEARCH_DEBOUNCE_MS = 300;
+function useSearch(term, options = {}) {
+    const { sort, filters, pageSize = exports.SEARCH_PAGE_SIZE, debounceMs = exports.SEARCH_DEBOUNCE_MS, imageTransform, onError } = options;
+    const [query, setQuery] = (0, react_1.useState)(() => term.trim());
+    (0, react_1.useEffect)(() => {
+        const next = term.trim();
+        if (next === query)
+            return;
+        const timer = setTimeout(() => setQuery(next), Math.max(0, debounceMs));
+        return () => clearTimeout(timer);
+    }, [term, debounceMs, query]);
+    const sortKey = sort ? `${sort.key}:${sort.reverse ? 'desc' : 'asc'}` : '';
+    const feed = (0, useProductFeed_1.useProductFeed)({
+        id: query ? `search:${query.toLowerCase()}` : null,
+        paramsKey: `${sortKey}|${pageSize}|${imageTransform ? JSON.stringify(imageTransform) : ''}`,
+        fixedFilters: filters,
+        fetch: async ({ after, filters: applied, fresh }) => {
+            var _a;
+            const page = await shopify_1.shopify.products.search(query, {
+                first: pageSize,
+                after,
+                sortKey: sort === null || sort === void 0 ? void 0 : sort.key,
+                reverse: sort === null || sort === void 0 ? void 0 : sort.reverse,
+                filters: applied,
+                fresh,
+                imageTransform,
+            });
+            return {
+                nodes: page.nodes,
+                pageInfo: page.pageInfo,
+                filters: (_a = page.filters) !== null && _a !== void 0 ? _a : [],
+                title: null,
+                totalCount: page.totalCount,
+            };
+        },
+        onError: onError
+            ? (error, phase) => onError(error, { at: phase === 'first' ? 'useSearch' : 'useSearch.loadMore', query })
+            : undefined,
+    });
+    return { ...feed, query };
+}
+//# sourceMappingURL=useSearch.js.map

package/dist/react/useSearch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSearch.js","sourceRoot":"","sources":["../../src/react/useSearch.ts"],"names":[],"mappings":";;;AA4CA,8BAwCC;AApFD;;;;;;;;;;GAUG;AACH,iCAA4C;AAC5C,wCAAqC;AACrC,qDAAiG;AASpF,QAAA,gBAAgB,GAAG,EAAE,CAAC;AACtB,QAAA,kBAAkB,GAAG,GAAG,CAAC;AAqBtC,SAAgB,SAAS,CAAC,IAAY,EAAE,UAA4B,EAAE;IACpE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,GAAG,wBAAgB,EAAE,UAAU,GAAG,0BAAkB,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACzH,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAEtD,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACzB,IAAI,IAAI,KAAK,KAAK;YAAE,OAAO;QAC3B,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;QACxE,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;IAE9B,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3E,MAAM,IAAI,GAAG,IAAA,+BAAc,EAAC;QAC1B,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI;QAClD,SAAS,EAAE,GAAG,OAAO,IAAI,QAAQ,IAAI,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE;QAC3F,YAAY,EAAE,OAAO;QACrB,KAAK,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;;YAClD,MAAM,IAAI,GAAG,MAAM,iBAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE;gBAChD,KAAK,EAAE,QAAQ;gBACf,KAAK;gBACL,OAAO,EAAE,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,GAAG;gBAClB,OAAO,EAAE,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,OAAO;gBACtB,OAAO,EAAE,OAAO;gBAChB,KAAK;gBACL,cAAc;aACf,CAAC,CAAC;YACH,OAAO;gBACL,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,OAAO,EAAE,MAAA,IAAI,CAAC,OAAO,mCAAI,EAAE;gBAC3B,KAAK,EAAE,IAAI;gBACX,UAAU,EAAE,IAAI,CAAC,UAAU;aAC5B,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,OAAO;YACd,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,oBAAoB,EAAE,KAAK,EAAE,CAAC;YACzG,CAAC,CAAC,SAAS;KACd,CAAC,CAAC;IAEH,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC"}

package/dist/requestCache.d.ts

@@ -0,0 +1,48 @@
+/**
+ * One network call per identical Storefront read.
+ *
+ * Every read goes through `request()`, and before this each call was its own `fetch`: six places
+ * showing the same collection meant six identical requests. Two layers fix that.
+ *
+ * 1. **In flight.** An identical query already on the wire is joined, not repeated. This applies to
+ *    every query, including the cart and customer ones: identical variables (same cart id, same
+ *    token) mean an identical answer. Mutations are never joined; each one is a separate write.
+ * 2. **Recent answers.** A catalogue read answered in the last little while (`DEFAULT_CACHE_TTL_MS`)
+ *    is answered again from memory. Only operations listed there are kept. Anything personal or
+ *    stock-sensitive (cart, customer, orders, variant stock) is in-flight sharing only.
+ *
+ * Responses are kept as the raw JSON text, and every caller parses its own copy, so one caller
+ * mutating what it got cannot change what the next caller gets. Nothing here is persisted: this is
+ * memory only, and it is cleared whenever `init` sets a new config.
+ */
+/**
+ * How long an answer to each operation is reused. Anything absent is shared only while in flight.
+ * Catalogue data is the same for every shopper in a market (the market is part of the key), and a
+ * price shown a minute old is corrected by the cart, which is always read fresh.
+ */
+export declare const DEFAULT_CACHE_TTL_MS: Readonly<Record<string, number>>;
+export interface RequestCacheOptions {
+    /** Per-operation reuse time in ms, merged over `DEFAULT_CACHE_TTL_MS`. `0` means in-flight only. */
+    ttl?: Partial<Record<string, number>>;
+    /** Most answers kept at once; the least recently used go first. Default 50. */
+    maxEntries?: number;
+}
+/**
+ * Set from `ShopifyConfig.cache`. `false` turns off reuse of recent answers; identical requests in
+ * flight are still shared, since that never changes what a caller sees.
+ */
+export declare function configureRequestCache(options: false | RequestCacheOptions | undefined): void;
+/** Forget every kept answer. Requests in flight still reach their callers, but aren't kept. */
+export declare function clearRequestCache(): void;
+/** `query Name`, `mutation Name`, or an anonymous/shorthand query, ignoring leading fragments. */
+export declare function operationOf(query: string): {
+    kind: 'query' | 'mutation';
+    name: string | null;
+};
+/**
+ * The response text for `query` + `variables`: a recent answer, the identical request already in
+ * flight, or a new call to `send`. `scope` separates stores and tokens. `fresh` skips recent answers
+ * (pull-to-refresh) but still joins a request already on the wire.
+ */
+export declare function readThrough(scope: string, query: string, variables: Record<string, unknown> | undefined, fresh: boolean, send: () => Promise<string>): Promise<string>;
+//# sourceMappingURL=requestCache.d.ts.map

package/dist/requestCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestCache.d.ts","sourceRoot":"","sources":["../src/requestCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgBjE,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,oGAAoG;IACpG,GAAG,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtC,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAoBD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,KAAK,GAAG,mBAAmB,GAAG,SAAS,GAAG,IAAI,CAS5F;AAED,+FAA+F;AAC/F,wBAAgB,iBAAiB,IAAI,IAAI,CAKxC;AAED,kGAAkG;AAClG,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAI9F;AAyCD;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC9C,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAC1B,OAAO,CAAC,MAAM,CAAC,CAqCjB"}

package/dist/requestCache.js

@@ -0,0 +1,173 @@
+"use strict";
+/**
+ * One network call per identical Storefront read.
+ *
+ * Every read goes through `request()`, and before this each call was its own `fetch`: six places
+ * showing the same collection meant six identical requests. Two layers fix that.
+ *
+ * 1. **In flight.** An identical query already on the wire is joined, not repeated. This applies to
+ *    every query, including the cart and customer ones: identical variables (same cart id, same
+ *    token) mean an identical answer. Mutations are never joined; each one is a separate write.
+ * 2. **Recent answers.** A catalogue read answered in the last little while (`DEFAULT_CACHE_TTL_MS`)
+ *    is answered again from memory. Only operations listed there are kept. Anything personal or
+ *    stock-sensitive (cart, customer, orders, variant stock) is in-flight sharing only.
+ *
+ * Responses are kept as the raw JSON text, and every caller parses its own copy, so one caller
+ * mutating what it got cannot change what the next caller gets. Nothing here is persisted: this is
+ * memory only, and it is cleared whenever `init` sets a new config.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CACHE_TTL_MS = void 0;
+exports.configureRequestCache = configureRequestCache;
+exports.clearRequestCache = clearRequestCache;
+exports.operationOf = operationOf;
+exports.readThrough = readThrough;
+const SECOND = 1000;
+const MINUTE = 60 * SECOND;
+/**
+ * How long an answer to each operation is reused. Anything absent is shared only while in flight.
+ * Catalogue data is the same for every shopper in a market (the market is part of the key), and a
+ * price shown a minute old is corrected by the cart, which is always read fresh.
+ */
+exports.DEFAULT_CACHE_TTL_MS = {
+    ShopInfo: 30 * MINUTE,
+    ShopLocalization: 30 * MINUTE,
+    Collections: 10 * MINUTE,
+    CollectionByHandle: 10 * MINUTE,
+    Blogs: 10 * MINUTE,
+    BlogByHandle: 10 * MINUTE,
+    BlogArticles: 10 * MINUTE,
+    BlogArticleByHandle: 10 * MINUTE,
+    Recommended: 5 * MINUTE,
+    CollectionProducts: MINUTE,
+    Products: MINUTE,
+    ProductByHandle: MINUTE,
+    ProductById: MINUTE,
+    WishlistNodes: MINUTE,
+    SearchProducts: 30 * SECOND,
+};
+const DEFAULT_MAX_ENTRIES = 50;
+/** A ceiling on kept text, so a few huge product lists can't hold megabytes on a low-end phone. */
+const MAX_CHARS = 2000000;
+let enabled = true;
+let ttl = { ...exports.DEFAULT_CACHE_TTL_MS };
+let maxEntries = DEFAULT_MAX_ENTRIES;
+const inflight = new Map();
+const answers = new Map();
+let chars = 0;
+/** Bumped by `clearRequestCache`, so a request that was in flight across a clear isn't kept. */
+let generation = 0;
+/**
+ * Set from `ShopifyConfig.cache`. `false` turns off reuse of recent answers; identical requests in
+ * flight are still shared, since that never changes what a caller sees.
+ */
+function configureRequestCache(options) {
+    var _a;
+    enabled = options !== false;
+    const o = options || {};
+    ttl = { ...exports.DEFAULT_CACHE_TTL_MS };
+    for (const [name, ms] of Object.entries((_a = o.ttl) !== null && _a !== void 0 ? _a : {})) {
+        if (typeof ms === 'number' && Number.isFinite(ms) && ms >= 0)
+            ttl[name] = ms;
+    }
+    maxEntries = o.maxEntries && o.maxEntries > 0 ? Math.floor(o.maxEntries) : DEFAULT_MAX_ENTRIES;
+    clearRequestCache();
+}
+/** Forget every kept answer. Requests in flight still reach their callers, but aren't kept. */
+function clearRequestCache() {
+    answers.clear();
+    inflight.clear();
+    chars = 0;
+    generation += 1;
+}
+/** `query Name`, `mutation Name`, or an anonymous/shorthand query, ignoring leading fragments. */
+function operationOf(query) {
+    var _a;
+    const m = query.match(/(^|\n)[ \t]*(query|mutation)\b[ \t]*([A-Za-z_][A-Za-z0-9_]*)?/);
+    if (!m)
+        return { kind: 'query', name: null };
+    return { kind: m[2], name: (_a = m[3]) !== null && _a !== void 0 ? _a : null };
+}
+/** JSON with object keys sorted, so `{a, b}` and `{b, a}` are one key. */
+function stable(value) {
+    var _a;
+    if (Array.isArray(value))
+        return `[${value.map(stable).join(',')}]`;
+    if (value && typeof value === 'object') {
+        const keys = Object.keys(value)
+            .filter((k) => value[k] !== undefined)
+            .sort();
+        return `{${keys.map((k) => `${JSON.stringify(k)}:${stable(value[k])}`).join(',')}}`;
+    }
+    return (_a = JSON.stringify(value)) !== null && _a !== void 0 ? _a : 'null';
+}
+/** Only a clean answer is worth keeping: parseable, with data and without GraphQL errors. */
+function isKeepable(text) {
+    try {
+        const json = JSON.parse(text);
+        return json.data != null && !(json.errors && json.errors.length > 0);
+    }
+    catch {
+        return false;
+    }
+}
+function keep(key, text, ms) {
+    const old = answers.get(key);
+    if (old) {
+        chars -= old.text.length;
+        answers.delete(key);
+    }
+    answers.set(key, { text, expires: Date.now() + ms });
+    chars += text.length;
+    // Map order is insertion order, and a hit re-inserts, so the first key is the least recently used.
+    while (answers.size > maxEntries || chars > MAX_CHARS) {
+        const oldest = answers.keys().next();
+        if (oldest.done)
+            break;
+        chars -= answers.get(oldest.value).text.length;
+        answers.delete(oldest.value);
+    }
+}
+/**
+ * The response text for `query` + `variables`: a recent answer, the identical request already in
+ * flight, or a new call to `send`. `scope` separates stores and tokens. `fresh` skips recent answers
+ * (pull-to-refresh) but still joins a request already on the wire.
+ */
+function readThrough(scope, query, variables, fresh, send) {
+    var _a;
+    const { kind, name } = operationOf(query);
+    if (kind === 'mutation')
+        return send();
+    const key = `${scope}\n${query}\n${stable(variables !== null && variables !== void 0 ? variables : {})}`;
+    const ms = enabled && name ? (_a = ttl[name]) !== null && _a !== void 0 ? _a : 0 : 0;
+    if (ms > 0 && !fresh) {
+        const hit = answers.get(key);
+        if (hit && hit.expires > Date.now()) {
+            answers.delete(key);
+            answers.set(key, hit);
+            return Promise.resolve(hit.text);
+        }
+        if (hit) {
+            chars -= hit.text.length;
+            answers.delete(key);
+        }
+    }
+    const pending = inflight.get(key);
+    if (pending)
+        return pending;
+    const startedIn = generation;
+    const call = send().then((text) => {
+        if (inflight.get(key) === call)
+            inflight.delete(key);
+        if (ms > 0 && startedIn === generation && isKeepable(text))
+            keep(key, text, ms);
+        return text;
+    }, (error) => {
+        if (inflight.get(key) === call)
+            inflight.delete(key);
+        throw error;
+    });
+    inflight.set(key, call);
+    return call;
+}
+//# sourceMappingURL=requestCache.js.map