@tiledev/sdk-shopify 0.2.6 → 0.2.7

package/dist/index.d.ts

@@ -7,5 +7,5 @@ export { classifyAuthFailure, isOutOfStockError, isUserErrorRejection, userError
 export { TileCreditClient, configureTileCredit, getTileCreditClient, redeemAndApplyToCart, centsToMoney, moneyToCents, } from './tileCredit';
 export { TileCreditError } from './types';
 export type * from './types';
-export { ShopifyProvider, useShopify, useCart, useWishlist, useCustomer, useCheckout, useShopifyMessage, useTileCredit, type ShopifyProviderProps, type ShopifyEvent, type ShopifyEventType, type CartState, type WishlistState, type CustomerState, type CheckoutState, type UseTileCreditOptions, type UseTileCreditState, } from './react';
+export { ShopifyProvider, useShopify, useCart, useWishlist, useCustomer, useCheckout, useShopifyMessage, useTileCredit, useCollectionProducts, COLLECTION_PAGE_SIZE, type ShopifyProviderProps, type ShopifyEvent, type ShopifyEventType, type CartState, type WishlistState, type CustomerState, type CheckoutState, type UseTileCreditOptions, type UseTileCreditState, type CollectionSort, type UseCollectionProductsOptions, type CollectionProductsState, type UseCollectionProductsResult, } from './react';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,EACL,gBAAgB,EAChB,OAAO,EACP,WAAW,EACX,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,GACb,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,mBAAmB,SAAS,CAAC;AAO7B,OAAO,EACL,eAAe,EACf,UAAU,EACV,OAAO,EACP,WAAW,EACX,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,GACxB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,EACL,gBAAgB,EAChB,OAAO,EACP,WAAW,EACX,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,GACb,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,mBAAmB,SAAS,CAAC;AAO7B,OAAO,EACL,eAAe,EACf,UAAU,EACV,OAAO,EACP,WAAW,EACX,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,4BAA4B,EACjC,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,GACjC,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useTileCredit = exports.useShopifyMessage = exports.useCheckout = exports.useCustomer = exports.useWishlist = exports.useCart = exports.useShopify = exports.ShopifyProvider = exports.TileCreditError = exports.moneyToCents = exports.centsToMoney = exports.redeemAndApplyToCart = exports.getTileCreditClient = exports.configureTileCredit = exports.TileCreditClient = exports.userErrorsOf = exports.isUserErrorRejection = exports.isOutOfStockError = exports.classifyAuthFailure = exports.wouldExceedLineLimit = exports.projectedLineCount = exports.maxLineItems = exports.getCartPolicy = exports.setCartPolicy = exports.limitExceededMessage = exports.setMessageResolver = exports.patchMessages = exports.setMessages = exports.getMessages = exports.message = exports.DEFAULT_MESSAGES = exports.getCurrencyCode = exports.getMoneyFormat = exports.shop = exports.applyMoneyFormat = exports.formatMoney = exports.default = exports.shopify = void 0;
+exports.COLLECTION_PAGE_SIZE = exports.useCollectionProducts = exports.useTileCredit = exports.useShopifyMessage = exports.useCheckout = exports.useCustomer = exports.useWishlist = exports.useCart = exports.useShopify = exports.ShopifyProvider = exports.TileCreditError = exports.moneyToCents = exports.centsToMoney = exports.redeemAndApplyToCart = exports.getTileCreditClient = exports.configureTileCredit = exports.TileCreditClient = exports.userErrorsOf = exports.isUserErrorRejection = exports.isOutOfStockError = exports.classifyAuthFailure = exports.wouldExceedLineLimit = exports.projectedLineCount = exports.maxLineItems = exports.getCartPolicy = exports.setCartPolicy = exports.limitExceededMessage = exports.setMessageResolver = exports.patchMessages = exports.setMessages = exports.getMessages = exports.message = exports.DEFAULT_MESSAGES = exports.getCurrencyCode = exports.getMoneyFormat = exports.shop = exports.applyMoneyFormat = exports.formatMoney = exports.default = exports.shopify = void 0;
 var shopify_1 = require("./shopify");
 Object.defineProperty(exports, "shopify", { enumerable: true, get: function () { return shopify_1.shopify; } });
 Object.defineProperty(exports, "default", { enumerable: true, get: function () { return shopify_1.shopify; } });
@@ -53,4 +53,6 @@ Object.defineProperty(exports, "useCustomer", { enumerable: true, get: function
 Object.defineProperty(exports, "useCheckout", { enumerable: true, get: function () { return react_1.useCheckout; } });
 Object.defineProperty(exports, "useShopifyMessage", { enumerable: true, get: function () { return react_1.useShopifyMessage; } });
 Object.defineProperty(exports, "useTileCredit", { enumerable: true, get: function () { return react_1.useTileCredit; } });
+Object.defineProperty(exports, "useCollectionProducts", { enumerable: true, get: function () { return react_1.useCollectionProducts; } });
+Object.defineProperty(exports, "COLLECTION_PAGE_SIZE", { enumerable: true, get: function () { return react_1.COLLECTION_PAGE_SIZE; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qCAAwD;AAA/C,kGAAA,OAAO,OAAA;AAAE,kGAAA,OAAO,OAAW;AACpC,iCAA8D;AAArD,oGAAA,WAAW,OAAA;AAAE,yGAAA,gBAAgB,OAAA;AAAE,6FAAA,IAAI,OAAA;AAC5C,mCAA2D;AAAlD,wGAAA,cAAc,OAAA;AAAE,yGAAA,eAAe,OAAA;AACxC,uCAQoB;AAPlB,4GAAA,gBAAgB,OAAA;AAChB,mGAAA,OAAO,OAAA;AACP,uGAAA,WAAW,OAAA;AACX,uGAAA,WAAW,OAAA;AACX,yGAAA,aAAa,OAAA;AACb,8GAAA,kBAAkB,OAAA;AAClB,gHAAA,oBAAoB,OAAA;AAEtB,2CAMsB;AALpB,2GAAA,aAAa,OAAA;AACb,2GAAA,aAAa,OAAA;AACb,0GAAA,YAAY,OAAA;AACZ,gHAAA,kBAAkB,OAAA;AAClB,kHAAA,oBAAoB,OAAA;AAEtB,mCAKkB;AAJhB,6GAAA,mBAAmB,OAAA;AACnB,2GAAA,iBAAiB,OAAA;AACjB,8GAAA,oBAAoB,OAAA;AACpB,sGAAA,YAAY,OAAA;AAEd,2CAOsB;AANpB,8GAAA,gBAAgB,OAAA;AAChB,iHAAA,mBAAmB,OAAA;AACnB,iHAAA,mBAAmB,OAAA;AACnB,kHAAA,oBAAoB,OAAA;AACpB,0GAAA,YAAY,OAAA;AACZ,0GAAA,YAAY,OAAA;AAEd,iCAA0C;AAAjC,wGAAA,eAAe,OAAA;AAGxB,uEAAuE;AACvE,qEAAqE;AACrE,yEAAyE;AACzE,kEAAkE;AAClE,gEAAgE;AAChE,iCAkBiB;AAjBf,wGAAA,eAAe,OAAA;AACf,mGAAA,UAAU,OAAA;AACV,gGAAA,OAAO,OAAA;AACP,oGAAA,WAAW,OAAA;AACX,oGAAA,WAAW,OAAA;AACX,oGAAA,WAAW,OAAA;AACX,0GAAA,iBAAiB,OAAA;AACjB,sGAAA,aAAa,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qCAAwD;AAA/C,kGAAA,OAAO,OAAA;AAAE,kGAAA,OAAO,OAAW;AACpC,iCAA8D;AAArD,oGAAA,WAAW,OAAA;AAAE,yGAAA,gBAAgB,OAAA;AAAE,6FAAA,IAAI,OAAA;AAC5C,mCAA2D;AAAlD,wGAAA,cAAc,OAAA;AAAE,yGAAA,eAAe,OAAA;AACxC,uCAQoB;AAPlB,4GAAA,gBAAgB,OAAA;AAChB,mGAAA,OAAO,OAAA;AACP,uGAAA,WAAW,OAAA;AACX,uGAAA,WAAW,OAAA;AACX,yGAAA,aAAa,OAAA;AACb,8GAAA,kBAAkB,OAAA;AAClB,gHAAA,oBAAoB,OAAA;AAEtB,2CAMsB;AALpB,2GAAA,aAAa,OAAA;AACb,2GAAA,aAAa,OAAA;AACb,0GAAA,YAAY,OAAA;AACZ,gHAAA,kBAAkB,OAAA;AAClB,kHAAA,oBAAoB,OAAA;AAEtB,mCAKkB;AAJhB,6GAAA,mBAAmB,OAAA;AACnB,2GAAA,iBAAiB,OAAA;AACjB,8GAAA,oBAAoB,OAAA;AACpB,sGAAA,YAAY,OAAA;AAEd,2CAOsB;AANpB,8GAAA,gBAAgB,OAAA;AAChB,iHAAA,mBAAmB,OAAA;AACnB,iHAAA,mBAAmB,OAAA;AACnB,kHAAA,oBAAoB,OAAA;AACpB,0GAAA,YAAY,OAAA;AACZ,0GAAA,YAAY,OAAA;AAEd,iCAA0C;AAAjC,wGAAA,eAAe,OAAA;AAGxB,uEAAuE;AACvE,qEAAqE;AACrE,yEAAyE;AACzE,kEAAkE;AAClE,gEAAgE;AAChE,iCAwBiB;AAvBf,wGAAA,eAAe,OAAA;AACf,mGAAA,UAAU,OAAA;AACV,gGAAA,OAAO,OAAA;AACP,oGAAA,WAAW,OAAA;AACX,oGAAA,WAAW,OAAA;AACX,oGAAA,WAAW,OAAA;AACX,0GAAA,iBAAiB,OAAA;AACjB,sGAAA,aAAa,OAAA;AACb,8GAAA,qBAAqB,OAAA;AACrB,6GAAA,oBAAoB,OAAA"}

package/dist/react/index.d.ts

@@ -1,3 +1,4 @@
 export { ShopifyProvider, useShopify, useCart, useWishlist, useCustomer, useCheckout, useShopifyMessage, type ShopifyProviderProps, type ShopifyEvent, type ShopifyEventType, type CartState, type WishlistState, type CustomerState, type CheckoutState, } from "./ShopifyProvider";
 export { useTileCredit, type UseTileCreditOptions, type UseTileCreditState, } from "./useTileCredit";
+export { useCollectionProducts, COLLECTION_PAGE_SIZE, type CollectionSort, type UseCollectionProductsOptions, type CollectionProductsState, type UseCollectionProductsResult, } from "./useCollectionProducts";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,UAAU,EACV,OAAO,EACP,WAAW,EACX,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,UAAU,EACV,OAAO,EACP,WAAW,EACX,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,4BAA4B,EACjC,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,GACjC,MAAM,yBAAyB,CAAC"}

package/dist/react/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useTileCredit = exports.useShopifyMessage = exports.useCheckout = exports.useCustomer = exports.useWishlist = exports.useCart = exports.useShopify = exports.ShopifyProvider = void 0;
+exports.COLLECTION_PAGE_SIZE = exports.useCollectionProducts = exports.useTileCredit = exports.useShopifyMessage = exports.useCheckout = exports.useCustomer = exports.useWishlist = exports.useCart = exports.useShopify = exports.ShopifyProvider = void 0;
 var ShopifyProvider_1 = require("./ShopifyProvider");
 Object.defineProperty(exports, "ShopifyProvider", { enumerable: true, get: function () { return ShopifyProvider_1.ShopifyProvider; } });
 Object.defineProperty(exports, "useShopify", { enumerable: true, get: function () { return ShopifyProvider_1.useShopify; } });
@@ -11,4 +11,7 @@ Object.defineProperty(exports, "useCheckout", { enumerable: true, get: function
 Object.defineProperty(exports, "useShopifyMessage", { enumerable: true, get: function () { return ShopifyProvider_1.useShopifyMessage; } });
 var useTileCredit_1 = require("./useTileCredit");
 Object.defineProperty(exports, "useTileCredit", { enumerable: true, get: function () { return useTileCredit_1.useTileCredit; } });
+var useCollectionProducts_1 = require("./useCollectionProducts");
+Object.defineProperty(exports, "useCollectionProducts", { enumerable: true, get: function () { return useCollectionProducts_1.useCollectionProducts; } });
+Object.defineProperty(exports, "COLLECTION_PAGE_SIZE", { enumerable: true, get: function () { return useCollectionProducts_1.COLLECTION_PAGE_SIZE; } });
 //# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":";;;AAAA,qDAe2B;AAdzB,kHAAA,eAAe,OAAA;AACf,6GAAA,UAAU,OAAA;AACV,0GAAA,OAAO,OAAA;AACP,8GAAA,WAAW,OAAA;AACX,8GAAA,WAAW,OAAA;AACX,8GAAA,WAAW,OAAA;AACX,oHAAA,iBAAiB,OAAA;AASnB,iDAIyB;AAHvB,8GAAA,aAAa,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":";;;AAAA,qDAe2B;AAdzB,kHAAA,eAAe,OAAA;AACf,6GAAA,UAAU,OAAA;AACV,0GAAA,OAAO,OAAA;AACP,8GAAA,WAAW,OAAA;AACX,8GAAA,WAAW,OAAA;AACX,8GAAA,WAAW,OAAA;AACX,oHAAA,iBAAiB,OAAA;AASnB,iDAIyB;AAHvB,8GAAA,aAAa,OAAA;AAIf,iEAOiC;AAN/B,8HAAA,qBAAqB,OAAA;AACrB,6HAAA,oBAAoB,OAAA"}

package/dist/react/useCollectionProducts.d.ts

@@ -0,0 +1,43 @@
+import type { Filter, Product, ProductFilter } from '../types';
+/** How a collection is ordered. `key` is a Storefront `ProductCollectionSortKeys` value. */
+export interface CollectionSort {
+    key: string;
+    reverse?: boolean;
+}
+/** Default page size — 12 is six rows of two, a full first screenful on a phone. */
+export declare const COLLECTION_PAGE_SIZE = 12;
+export interface UseCollectionProductsOptions {
+    handle: string | null | undefined;
+    /** Storefront sort. Omit for the merchant's own collection order. */
+    sort?: CollectionSort;
+    /** Shopify's own product filters — a `FilterValue.input` parsed and handed back, never hand-built. */
+    filters?: ProductFilter[];
+    pageSize?: number;
+    /**
+     * Called with any transport error (first page or paging) so the host app can log it — the hook has
+     * no logger of its own. Optional; when omitted the error only surfaces as `error` / a stopped feed.
+     */
+    onError?: (error: unknown, context: {
+        at: string;
+        handle: string;
+    }) => void;
+}
+export interface CollectionProductsState {
+    products: Product[];
+    /** Null until the first read resolves, so a screen can render its own heading first. */
+    title: string | null;
+    /** The facets Shopify offers for this collection under the current filters. */
+    availableFilters: Filter[];
+    /** A first page is in flight: the grid has nothing to show yet. */
+    loading: boolean;
+    /** A later page is in flight: the grid keeps what it has and shows a footer spinner. */
+    loadingMore: boolean;
+    hasMore: boolean;
+    error: boolean;
+}
+export interface UseCollectionProductsResult extends CollectionProductsState {
+    loadMore: () => void;
+    retry: () => void;
+}
+export declare function useCollectionProducts({ handle, sort, filters, pageSize, onError, }: UseCollectionProductsOptions): UseCollectionProductsResult;
+//# sourceMappingURL=useCollectionProducts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCollectionProducts.d.ts","sourceRoot":"","sources":["../../src/react/useCollectionProducts.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE/D,4FAA4F;AAC5F,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,oFAAoF;AACpF,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClC,qEAAqE;IACrE,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,sGAAsG;IACtG,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAC7E;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,wFAAwF;IACxF,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,+EAA+E;IAC/E,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,mEAAmE;IACnE,OAAO,EAAE,OAAO,CAAC;IACjB,wFAAwF;IACxF,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,2BAA4B,SAAQ,uBAAuB;IAC1E,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAYD,wBAAgB,qBAAqB,CAAC,EACpC,MAAM,EACN,IAAI,EACJ,OAAO,EACP,QAA+B,EAC/B,OAAO,GACR,EAAE,4BAA4B,GAAG,2BAA2B,CAwH5D"}

package/dist/react/useCollectionProducts.js

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COLLECTION_PAGE_SIZE = void 0;
+exports.useCollectionProducts = useCollectionProducts;
+/**
+ * useCollectionProducts — one collection's products, cursor-paginated.
+ *
+ * Pages on a cursor (`after: endCursor`) and APPENDS, rather than growing `first` and refetching the
+ * whole list each step. Growing `first` breaks on large collections: the Storefront API rejects
+ * `first > 250`, so a shopper scrolling deep eventually sends an over-cap request that errors — and a
+ * screen that replaces its grid on that error destroys everything already loaded, with a retry that
+ * re-sends the same failing request. Cursor paging has no such cap, never re-downloads earlier pages,
+ * and — because `loadMore` failing only stops growth — leaves the loaded products in place.
+ *
+ * Every response is checked against the request that is current (`requestId`), so a page resolving
+ * after the sort or filters changed cannot merge into the new list.
+ */
+const react_1 = require("react");
+const shopify_1 = require("../shopify");
+const ShopifyProvider_1 = require("./ShopifyProvider");
+/** Default page size — 12 is six rows of two, a full first screenful on a phone. */
+exports.COLLECTION_PAGE_SIZE = 12;
+const IDLE = {
+    products: [],
+    title: null,
+    availableFilters: [],
+    loading: false,
+    loadingMore: false,
+    hasMore: false,
+    error: false,
+};
+function useCollectionProducts({ handle, sort, filters, pageSize = exports.COLLECTION_PAGE_SIZE, onError, }) {
+    const { ready } = (0, ShopifyProvider_1.useShopify)();
+    const [state, setState] = (0, react_1.useState)(IDLE);
+    const [attempt, setAttempt] = (0, react_1.useState)(0);
+    /**
+     * Identifies the request the state belongs to. Bumped on every fresh read; an append carries the
+     * value it started with, so a response whose counter has moved on is dropped rather than merged.
+     */
+    const requestId = (0, react_1.useRef)(0);
+    /** The cursor for the next page, held in a ref so `loadMore` does not need a fresh callback. */
+    const cursor = (0, react_1.useRef)(null);
+    /**
+     * The filter array and sort object are rebuilt on every render of the screen that owns them, so the
+     * effect depends on their serialisation rather than their identity — otherwise every keystroke
+     * elsewhere on the screen would refetch.
+     */
+    const filterKey = (filters === null || filters === void 0 ? void 0 : filters.length) ? JSON.stringify(filters) : '';
+    const sortKey = sort ? `${sort.key}:${sort.reverse ? 'desc' : 'asc'}` : '';
+    (0, react_1.useEffect)(() => {
+        var _a;
+        // A client that is not up yet, or no handle to read, is not a failed load — it is no load.
+        if (!ready || !handle) {
+            requestId.current += 1;
+            cursor.current = null;
+            setState(IDLE);
+            return;
+        }
+        const id = (requestId.current += 1);
+        cursor.current = null;
+        setState({ ...IDLE, loading: true });
+        shopify_1.shopify.collections
+            .products(handle, {
+            first: pageSize,
+            sortKey: sort === null || sort === void 0 ? void 0 : sort.key,
+            reverse: (_a = sort === null || sort === void 0 ? void 0 : sort.reverse) !== null && _a !== void 0 ? _a : false,
+            filters: (filters === null || filters === void 0 ? void 0 : filters.length) ? filters : undefined,
+        })
+            .then((page) => {
+            var _a, _b, _c;
+            if (requestId.current !== id)
+                return;
+            cursor.current = page.pageInfo.endCursor;
+            setState({
+                products: page.nodes,
+                title: (_b = (_a = page.collection) === null || _a === void 0 ? void 0 : _a.title) !== null && _b !== void 0 ? _b : null,
+                availableFilters: (_c = page.filters) !== null && _c !== void 0 ? _c : [],
+                loading: false,
+                loadingMore: false,
+                hasMore: page.pageInfo.hasNextPage,
+                error: false,
+            });
+        })
+            .catch((caught) => {
+            onError === null || onError === void 0 ? void 0 : onError(caught, { at: 'useCollectionProducts', handle });
+            if (requestId.current !== id)
+                return;
+            // A first-page failure genuinely has nothing to show, so the consumer renders its error state.
+            setState({ ...IDLE, error: true });
+        });
+        // Keyed on the serialised filters and sort; both change identity every render.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [ready, handle, sortKey, filterKey, pageSize, attempt]);
+    /**
+     * Guarded on both in-flight flags as well as on `hasMore`: a list's `onEndReached` fires every
+     * time the end stays in view, so an ungated version would run through the collection a page a frame.
+     */
+    const loadMore = (0, react_1.useCallback)(() => {
+        var _a;
+        if (state.loading || state.loadingMore || !state.hasMore || !cursor.current)
+            return;
+        const id = requestId.current;
+        const after = cursor.current;
+        // Claim the cursor synchronously. `onEndReached` fires repeatedly and the `loadingMore` guard
+        // reads a `state` snapshot that is stale until the next render, so a second call in the same frame
+        // would otherwise fetch this SAME page again and append it twice — duplicate keys. Nulling the ref
+        // now makes the re-entrant call bail on `!cursor.current`; the fetch restores it, a failure leaves
+        // it null (paging has stopped anyway).
+        cursor.current = null;
+        setState((current) => ({ ...current, loadingMore: true }));
+        shopify_1.shopify.collections
+            .products(handle, {
+            first: pageSize,
+            after,
+            sortKey: sort === null || sort === void 0 ? void 0 : sort.key,
+            reverse: (_a = sort === null || sort === void 0 ? void 0 : sort.reverse) !== null && _a !== void 0 ? _a : false,
+            filters: (filters === null || filters === void 0 ? void 0 : filters.length) ? filters : undefined,
+        })
+            .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 fresh = page.nodes.filter((p) => !seen.has(p.id));
+                return {
+                    ...current,
+                    products: fresh.length ? [...current.products, ...fresh] : current.products,
+                    loadingMore: false,
+                    hasMore: page.pageInfo.hasNextPage,
+                };
+            });
+        })
+            .catch((caught) => {
+            onError === null || onError === void 0 ? void 0 : onError(caught, { at: 'useCollectionProducts.loadMore', handle: handle });
+            if (requestId.current !== id)
+                return;
+            // A failed page is not a failed collection: what is on screen stays, and the end simply stops
+            // growing rather than the grid being replaced by an error.
+            setState((current) => ({ ...current, loadingMore: false, hasMore: false }));
+        });
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [state.loading, state.loadingMore, state.hasMore, handle, sortKey, filterKey, pageSize]);
+    return {
+        ...state,
+        loadMore,
+        retry: () => setAttempt((n) => n + 1),
+    };
+}
+//# sourceMappingURL=useCollectionProducts.js.map

package/dist/react/useCollectionProducts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCollectionProducts.js","sourceRoot":"","sources":["../../src/react/useCollectionProducts.ts"],"names":[],"mappings":";;;AAsEA,sDA8HC;AApMD;;;;;;;;;;;;GAYG;AACH,iCAAiE;AACjE,wCAAqC;AACrC,uDAA+C;AAS/C,oFAAoF;AACvE,QAAA,oBAAoB,GAAG,EAAE,CAAC;AAmCvC,MAAM,IAAI,GAA4B;IACpC,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE,IAAI;IACX,gBAAgB,EAAE,EAAE;IACpB,OAAO,EAAE,KAAK;IACd,WAAW,EAAE,KAAK;IAClB,OAAO,EAAE,KAAK;IACd,KAAK,EAAE,KAAK;CACb,CAAC;AAEF,SAAgB,qBAAqB,CAAC,EACpC,MAAM,EACN,IAAI,EACJ,OAAO,EACP,QAAQ,GAAG,4BAAoB,EAC/B,OAAO,GACsB;IAC7B,MAAM,EAAE,KAAK,EAAE,GAAG,IAAA,4BAAU,GAAE,CAAC;IAE/B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAA0B,IAAI,CAAC,CAAC;IAClE,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,IAAA,gBAAQ,EAAC,CAAC,CAAC,CAAC;IAE1C;;;OAGG;IACH,MAAM,SAAS,GAAG,IAAA,cAAM,EAAC,CAAC,CAAC,CAAC;IAC5B,gGAAgG;IAChG,MAAM,MAAM,GAAG,IAAA,cAAM,EAAgB,IAAI,CAAC,CAAC;IAE3C;;;;OAIG;IACH,MAAM,SAAS,GAAG,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM,EAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,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;IAE3E,IAAA,iBAAS,EAAC,GAAG,EAAE;;QACb,2FAA2F;QAC3F,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;YACtB,SAAS,CAAC,OAAO,IAAI,CAAC,CAAC;YACvB,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;YACtB,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,OAAO;QACT,CAAC;QAED,MAAM,EAAE,GAAG,CAAC,SAAS,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,QAAQ,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAErC,iBAAO,CAAC,WAAW;aAChB,QAAQ,CAAC,MAAM,EAAE;YAChB,KAAK,EAAE,QAAQ;YACf,OAAO,EAAE,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,GAAG;YAClB,OAAO,EAAE,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,OAAO,mCAAI,KAAK;YAC/B,OAAO,EAAE,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM,EAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;SAC/C,CAAC;aACD,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;;YACb,IAAI,SAAS,CAAC,OAAO,KAAK,EAAE;gBAAE,OAAO;YACrC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;YACzC,QAAQ,CAAC;gBACP,QAAQ,EAAE,IAAI,CAAC,KAAK;gBACpB,KAAK,EAAE,MAAA,MAAA,IAAI,CAAC,UAAU,0CAAE,KAAK,mCAAI,IAAI;gBACrC,gBAAgB,EAAE,MAAA,IAAI,CAAC,OAAO,mCAAI,EAAE;gBACpC,OAAO,EAAE,KAAK;gBACd,WAAW,EAAE,KAAK;gBAClB,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW;gBAClC,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE;YAChB,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAG,MAAM,EAAE,EAAE,EAAE,EAAE,uBAAuB,EAAE,MAAM,EAAE,CAAC,CAAC;YAC3D,IAAI,SAAS,CAAC,OAAO,KAAK,EAAE;gBAAE,OAAO;YACrC,+FAA+F;YAC/F,QAAQ,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QACL,+EAA+E;QAC/E,uDAAuD;IACzD,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAE3D;;;OAGG;IACH,MAAM,QAAQ,GAAG,IAAA,mBAAW,EAAC,GAAG,EAAE;;QAChC,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO;QAEpF,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC;QAC7B,8FAA8F;QAC9F,mGAAmG;QACnG,mGAAmG;QACnG,mGAAmG;QACnG,uCAAuC;QACvC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAE3D,iBAAO,CAAC,WAAW;aAChB,QAAQ,CAAC,MAAgB,EAAE;YAC1B,KAAK,EAAE,QAAQ;YACf,KAAK;YACL,OAAO,EAAE,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,GAAG;YAClB,OAAO,EAAE,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,OAAO,mCAAI,KAAK;YAC/B,OAAO,EAAE,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM,EAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;SAC/C,CAAC;aACD,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;YACb,IAAI,SAAS,CAAC,OAAO,KAAK,EAAE;gBAAE,OAAO;YACrC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;YACzC,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE;gBACnB,oFAAoF;gBACpF,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACxD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACxD,OAAO;oBACL,GAAG,OAAO;oBACV,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,QAAQ,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ;oBAC3E,WAAW,EAAE,KAAK;oBAClB,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW;iBACnC,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE;YAChB,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAG,MAAM,EAAE,EAAE,EAAE,EAAE,gCAAgC,EAAE,MAAM,EAAE,MAAgB,EAAE,CAAC,CAAC;YACtF,IAAI,SAAS,CAAC,OAAO,KAAK,EAAE;gBAAE,OAAO;YACrC,8FAA8F;YAC9F,2DAA2D;YAC3D,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC9E,CAAC,CAAC,CAAC;QACL,uDAAuD;IACzD,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE5F,OAAO;QACL,GAAG,KAAK;QACR,QAAQ;QACR,KAAK,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;KACtC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiledev/sdk-shopify",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "Type-safe Shopify Storefront API client for React Native (web, iOS, Android). Products, collections, cart, customer session, blogs, a local-storage-backed wishlist, and configurable shopper alerts. Zero deps beyond fetch.",
   "license": "MIT",
   "sideEffects": false,