@shoppexio/storefront-react 0.1.4 → 0.1.5

package/dist/index.d.ts

@@ -826,10 +826,16 @@ interface ShoppexSdk {
         data?: SdkPage[];
         message?: string;
     }>;
+    /**
+     * On a failure, `status` is the HTTP status (404 for a page that does not
+     * exist) and is absent when the request never reached a server. SDK 1.0.87
+     * and later; earlier builds send no `status` at all.
+     */
     getPage(slug: string): Promise<{
         success: boolean;
         data?: SdkPage;
         message?: string;
+        status?: number;
     }>;
     /** Merchant-configured navigation menus, keyed by slot (header/footer/…). */
     getMenus(): Promise<{
@@ -896,7 +902,9 @@ interface ShoppexSdk {
      * One page of the same feed, newest first. `cursor` is the previous page's
      * `pagination.next_cursor`; omit it for the first page.
      */
-    getShopReviewsPage(cursor?: string | null): Promise<{
+    getShopReviewsPage(cursor?: string | null, options?: {
+        product?: string | null;
+    }): Promise<{
         success: boolean;
         data?: {
             feedback: SdkShopReview[];
@@ -904,7 +912,16 @@ interface ShoppexSdk {
                 next_cursor: string | null;
                 has_more: boolean;
             };
+            /** Counts over the whole list, or over one product's reviews when filtered. */
+            summary?: SdkShopReviewsSummary;
+            /**
+             * The product filter the API applied, echoed back. Absent from an API that
+             * predates the filter and ignored it; see `loadShopReviewsPage`.
+             */
+            product?: string | null;
         };
+        message?: string;
+        status?: number;
     }>;
     /** Starts an in-page sign-in. Sends the email and nothing else. */
     requestOtp(email: string): Promise<SdkResponse<unknown>>;
@@ -1054,6 +1071,14 @@ interface ShoppexSdk {
     /** Lists the buyer's reseller API keys without plaintext secrets. */
     resellerApiKeys(): Promise<SdkResponse<unknown>>;
 }
+interface SdkShopReviewsSummary {
+    total: number;
+    positive: number;
+    neutral: number;
+    negative: number;
+    /** 1-5 average of the scores (5/3/1), null for an empty list. */
+    average_score: number | null;
+}
 interface SdkShopReview {
     id: string;
     /** 1-5, normalized by the SDK from the shop-feedback score (5/3/1). */
@@ -2888,6 +2913,8 @@ interface ShopReview {
     productTitle: string | null;
     /** True when the review is tied to a real completed purchase. */
     verified: boolean;
+    /** Left by the shop's review automation, not written by the buyer. */
+    automated: boolean;
 }
 type ShopReviewsState = {
     status: 'loading';
@@ -2925,14 +2952,62 @@ declare function toShopReviews(rows: readonly SdkShopReview[], labels: ShopRevie
  * derive a number from them.
  */
 declare function reviewsForProduct(reviews: readonly ShopReview[], productTitle: string): ShopReview[];
+/** One page of the shop's reviews, newest first. */
+interface ShopReviewsPageResult {
+    reviews: ShopReview[];
+    /** Pass to the next call; null on the last page. */
+    nextCursor: string | null;
+    /** Counts over the whole list (or the product's reviews), null when the API sent none. */
+    summary: SdkShopReviewsSummary | null;
+}
+/**
+ * One page of reviews from the feed, optionally for one product (its catalog
+ * `id`). Throws when the request fails.
+ *
+ * A product page must never show another product's reviews, so a filtered
+ * request also requires the API to echo the filter back: an API that predates
+ * `product` ignores it and would answer with the whole shop's list.
+ */
+declare function loadShopReviewsPage(options: {
+    cursor?: string | null;
+    product?: string | null;
+    labels: ShopReviewLabels;
+}): Promise<ShopReviewsPageResult>;
 /**
  * The newest WRITTEN reviews, at most `limit`, for a sample such as a home
- * section. Pages through the feed only until it has enough: a shop with a
- * thousand reviews costs one request, not ten. Automated entries and ratings
- * without words are skipped, since a sample of quotes needs quotes.
- * Resolves null when a page request fails.
+ * section or a product's review tab. Pages through the feed only until it has
+ * enough. Automated entries and ratings without words are skipped, since a
+ * sample of quotes needs quotes. Resolves null when a page request fails.
+ */
+declare function loadLatestWrittenReviews(limit: number, labels: ShopReviewLabels, options?: {
+    product?: string | null;
+}): Promise<ShopReview[] | null>;
+type PagedShopReviewsState = {
+    status: 'loading';
+} | {
+    status: 'error';
+} | {
+    status: 'ready';
+    reviews: ShopReview[];
+    summary: SdkShopReviewsSummary | null;
+    hasMore: boolean;
+    /** True while the next page is on its way. */
+    loadingMore: boolean;
+    /** Set when the NEXT page failed; the pages already shown stay. */
+    moreFailed: boolean;
+};
+/**
+ * The shop's reviews, one page at a time: the first page on mount (or when
+ * `product` changes), the next only when `loadMore` is called. The summary is
+ * the API's, so the score and breakdown describe the whole list, not the pages
+ * loaded so far.
  */
-declare function loadLatestWrittenReviews(limit: number, labels: ShopReviewLabels): Promise<ShopReview[] | null>;
+declare function usePagedShopReviews(options: {
+    product?: string | null;
+    labels: ShopReviewLabels;
+}): PagedShopReviewsState & {
+    loadMore: () => void;
+};
 declare function averageRating(reviews: readonly ShopReview[]): number | null;
 declare function useShopReviews(labels: ShopReviewLabels): ShopReviewsState;
 
@@ -3033,16 +3108,24 @@ type ShopPageState = {
     status: 'ready';
     page: ShopPageModel;
 }
-/** The slug resolved to nothing, or the request failed. Same screen either way. */
+/** The API answered that no such page exists (404), or the page has no name. */
  | {
     status: 'missing';
+}
+/**
+ * The page could not be loaded: the API failed or could not be reached, or
+ * the page's body could not be rendered. Not "missing": the page may exist.
+ */
+ | {
+    status: 'error';
 };
 /**
  * Loads one CMS page by slug.
  *
- * A slug the API does not know, a page without a name, and a failed request all
- * end in `missing`: there is no page to show, and inventing a title from the
- * slug would publish a heading the merchant never wrote.
+ * `missing` only when the API says so (404) or the page it returns has no name
+ * to show; inventing a title from the slug would publish a heading the merchant
+ * never wrote. Any other failure is `error`, so an outage never tells a buyer a
+ * real page does not exist.
  */
 declare function loadShopPage(slug: string): Promise<ShopPageState>;
 
@@ -3123,4 +3206,4 @@ declare function useOnlineUserCount(): number | null;
  */
 declare function resolveProductVideoEmbedSrc(value: unknown): string | null;
 
-export { ACCOUNT_ARTIFACT_CAPABILITIES, ACCOUNT_PATH, ACCOUNT_PATH_ALIAS, ACCOUNT_ROUTE_MESSAGE_KEYS, ACCOUNT_STOREFRONT_ROUTES, ACCOUNT_TABS, type AccountRouteMessageKey, type AccountRouteParts, type AccountTab, type AccountView, type BuyBoxVariantModel, CATALOG_PAGE_SIZE, CATALOG_SORTS, CATALOG_SORT_LABELS, type CartBoundsHeal, CartProvider, type CartQuoteLineBounds, type CartTotals, type CartView, type CartViewLine, type CatalogCardModel, type CatalogPage, type CatalogSort, type CheckoutFieldGroup, type CheckoutFieldValues, type CheckoutFields, type ContactFormValues, type ContactSubmissionContext, DEFAULT_ACCOUNT_TAB, DEFAULT_LOW_STOCK_THRESHOLD, DELIVERY_TIME_UNITS, type DeliveryPromise, type DeliveryTimeUnit, type GroupCardModel, IMPLEMENTED_ACCOUNT_TABS, type ImplementedAccountTab, type LicenseStatement, type LicenseTerm, type LinePricing, MAX_PAY_WHAT_YOU_WANT_PRICE, type MenuNavLink, type MenuSlot, type NavLink, type NavigationLinks, PRODUCT_BADGE_ICON_NAMES, type ProductAddon, type ProductAutomaticDeal, type ProductBadge, type ProductBadgeIconName, type ProductBundle, type ProductBundleItem, type ProductCardModel, type ProductCategoryRef, type ProductContentTab, type ProductCustomField, type ProductDetailModel, type ProductFaq, type ProductRatingModel, type ProductSubscription, type ProductType, QUOTE_UNAVAILABLE_CHECKOUT_ERROR, type RatingStars, type ResellerProgramSummary, type RewardProgramItem, type RewardProgramSummary, SERVING_CONTEXT_HINT, SHOP_REVIEW_PAGE_SIZE, STOREFRONT_SORT_KEYS, type SdkCartAddOptions, type SdkCartAddon, type SdkCartAppliedDiscount, type SdkCartCodeSource, type SdkCartItem, type SdkCartQuote, type SdkCartQuoteLine, type SdkCheckoutResult, type SdkCustomerAffiliateLink, type SdkCustomerAffiliateSummary, type SdkCustomerDashboard, type SdkCustomerDashboardOrder, type SdkCustomerDeliverable, type SdkCustomerDeliveryStatus, type SdkCustomerDeliverySummary, type SdkCustomerLicense, type SdkCustomerLoyalty, type SdkCustomerLoyaltyRedeem, type SdkCustomerLoyaltyTransactionType, type SdkCustomerOrderDetail, type SdkCustomerOrderPage, type SdkCustomerOrderSummary, type SdkCustomerRewardActivity, type SdkCustomerRewards, type SdkCustomerSubscription, type SdkCustomerTicketSummary, type SdkCustomerWarranty, type SdkCustomerWarrantyClaim, type SdkCustomerWarrantyClaimStatus, type SdkCustomerWarrantyList, type SdkCustomerWarrantyStatus, type SdkEligibleCartDeal, type SdkInitOptions, type SdkMenu, type SdkMenuItem, type SdkPage, type SdkRecentSaleEntry, type SdkResponse, type SdkShopReview, type ShopPageFaqItem, type ShopPageModel, type ShopPageState, type ShopReview, type ShopReviewLabels, type ShopReviewsState, type ShoppexSdk, type SocialLink, type SocialNetwork, type StockChip, type StockTone, type StorefrontAddon, type StorefrontCatalog, type StorefrontCategory, type StorefrontData, type StorefrontGroup, type StorefrontListingItem, type StorefrontPriceVariant, type StorefrontProduct, StorefrontProvider, type StorefrontSettings, type StorefrontShop, type StorefrontShopStats, type StorefrontSortKey, type SubscriptionIntervalUnit, type SupportChannel, type VolumeDiscountRule, accountOrderHref, accountRouteMessage, accountTabHref, accountTabLabelKey, averageRating, badgesForCard, badgesForProductPage, buildCartTotals, buildCartView, buildCustomFieldPayload, buildInitialCheckoutFieldValues, buildProductDetail, buildStorefrontCatalog, calculateDisplayLineTotal, calculateLinePricing, canonicalAccountPath, checkoutFieldKey, checkoutFieldWriteRepriced, checkoutNeedsDetails, clampQuantity, clearRecoveredQuoteCheckoutError, filterCatalogCards, findStorefrontProduct, firstOptionalString, flattenMerchantHtmlToText, formatCompactCount, formatDeliveryTime, formatLicenseTerm, formatMoney, formatSubscriptionCadence, formatSubscriptionTrial, getAuthoredContent, getBuyerCurrency, getProductGroups, getProducts, getShoppex, getStorefrontAddons, getStorefrontCategories, getStorefrontListing, getStorefrontSettings, getStorefrontShop, hasInjectedStorefrontData, isAccountTab, isBlankMerchantHtml, isCardSoldOut, isCheckboxValueChecked, isImplementedAccountTab, isProductSoldOut, isRecord, isSelectionSoldOut, loadLatestWrittenReviews, loadShopPage, missingRequiredCheckoutValues, optionalBoolean, optionalString, optionalStringWithDefault, paginateCatalogCards, parseAccountPath, parseCartQuoteLines, parseEnum, parseFiniteNumber, parseProductBadges, parseStorefrontSortKey, readCheckoutNeedsDetails, readStorefrontData, requireArray, requireBoolean, requireNumber, requireRecord, requireString, requireStringFromKeys, requireUnknownRecord, resolveAccountView, resolveBadgeForeground, resolveCartBoundsHeals, resolveCategorySelection, resolveCheckoutFields, resolveDeliveryPromise, resolveDisplayStock, resolveHideStockCounter, resolveLicenseTerm, resolveMenuLinksForSlot, resolvePayWhatYouWantMinimum, resolveProductVideoEmbedSrc, resolveQuantityBounds, resolveSupportChannels, resolveUnsellableLineIds, resolveVariantStock, reviewsForProduct, roundCurrency, sanitizeMerchantHtml, sortCatalogCards, startCartMutation, stripMerchantHtmlImages, submitContactTicket, toShopReviews, toStarCount, useCart, useNavigationLinks, useOnlineUserCount, useShopReviews, useStorefront, validateCheckoutFieldValue, validateCheckoutFields, validateContactSubmission, withRequiredAddons };
+export { ACCOUNT_ARTIFACT_CAPABILITIES, ACCOUNT_PATH, ACCOUNT_PATH_ALIAS, ACCOUNT_ROUTE_MESSAGE_KEYS, ACCOUNT_STOREFRONT_ROUTES, ACCOUNT_TABS, type AccountRouteMessageKey, type AccountRouteParts, type AccountTab, type AccountView, type BuyBoxVariantModel, CATALOG_PAGE_SIZE, CATALOG_SORTS, CATALOG_SORT_LABELS, type CartBoundsHeal, CartProvider, type CartQuoteLineBounds, type CartTotals, type CartView, type CartViewLine, type CatalogCardModel, type CatalogPage, type CatalogSort, type CheckoutFieldGroup, type CheckoutFieldValues, type CheckoutFields, type ContactFormValues, type ContactSubmissionContext, DEFAULT_ACCOUNT_TAB, DEFAULT_LOW_STOCK_THRESHOLD, DELIVERY_TIME_UNITS, type DeliveryPromise, type DeliveryTimeUnit, type GroupCardModel, IMPLEMENTED_ACCOUNT_TABS, type ImplementedAccountTab, type LicenseStatement, type LicenseTerm, type LinePricing, MAX_PAY_WHAT_YOU_WANT_PRICE, type MenuNavLink, type MenuSlot, type NavLink, type NavigationLinks, PRODUCT_BADGE_ICON_NAMES, type PagedShopReviewsState, type ProductAddon, type ProductAutomaticDeal, type ProductBadge, type ProductBadgeIconName, type ProductBundle, type ProductBundleItem, type ProductCardModel, type ProductCategoryRef, type ProductContentTab, type ProductCustomField, type ProductDetailModel, type ProductFaq, type ProductRatingModel, type ProductSubscription, type ProductType, QUOTE_UNAVAILABLE_CHECKOUT_ERROR, type RatingStars, type ResellerProgramSummary, type RewardProgramItem, type RewardProgramSummary, SERVING_CONTEXT_HINT, SHOP_REVIEW_PAGE_SIZE, STOREFRONT_SORT_KEYS, type SdkCartAddOptions, type SdkCartAddon, type SdkCartAppliedDiscount, type SdkCartCodeSource, type SdkCartItem, type SdkCartQuote, type SdkCartQuoteLine, type SdkCheckoutResult, type SdkCustomerAffiliateLink, type SdkCustomerAffiliateSummary, type SdkCustomerDashboard, type SdkCustomerDashboardOrder, type SdkCustomerDeliverable, type SdkCustomerDeliveryStatus, type SdkCustomerDeliverySummary, type SdkCustomerLicense, type SdkCustomerLoyalty, type SdkCustomerLoyaltyRedeem, type SdkCustomerLoyaltyTransactionType, type SdkCustomerOrderDetail, type SdkCustomerOrderPage, type SdkCustomerOrderSummary, type SdkCustomerRewardActivity, type SdkCustomerRewards, type SdkCustomerSubscription, type SdkCustomerTicketSummary, type SdkCustomerWarranty, type SdkCustomerWarrantyClaim, type SdkCustomerWarrantyClaimStatus, type SdkCustomerWarrantyList, type SdkCustomerWarrantyStatus, type SdkEligibleCartDeal, type SdkInitOptions, type SdkMenu, type SdkMenuItem, type SdkPage, type SdkRecentSaleEntry, type SdkResponse, type SdkShopReview, type SdkShopReviewsSummary, type ShopPageFaqItem, type ShopPageModel, type ShopPageState, type ShopReview, type ShopReviewLabels, type ShopReviewsPageResult, type ShopReviewsState, type ShoppexSdk, type SocialLink, type SocialNetwork, type StockChip, type StockTone, type StorefrontAddon, type StorefrontCatalog, type StorefrontCategory, type StorefrontData, type StorefrontGroup, type StorefrontListingItem, type StorefrontPriceVariant, type StorefrontProduct, StorefrontProvider, type StorefrontSettings, type StorefrontShop, type StorefrontShopStats, type StorefrontSortKey, type SubscriptionIntervalUnit, type SupportChannel, type VolumeDiscountRule, accountOrderHref, accountRouteMessage, accountTabHref, accountTabLabelKey, averageRating, badgesForCard, badgesForProductPage, buildCartTotals, buildCartView, buildCustomFieldPayload, buildInitialCheckoutFieldValues, buildProductDetail, buildStorefrontCatalog, calculateDisplayLineTotal, calculateLinePricing, canonicalAccountPath, checkoutFieldKey, checkoutFieldWriteRepriced, checkoutNeedsDetails, clampQuantity, clearRecoveredQuoteCheckoutError, filterCatalogCards, findStorefrontProduct, firstOptionalString, flattenMerchantHtmlToText, formatCompactCount, formatDeliveryTime, formatLicenseTerm, formatMoney, formatSubscriptionCadence, formatSubscriptionTrial, getAuthoredContent, getBuyerCurrency, getProductGroups, getProducts, getShoppex, getStorefrontAddons, getStorefrontCategories, getStorefrontListing, getStorefrontSettings, getStorefrontShop, hasInjectedStorefrontData, isAccountTab, isBlankMerchantHtml, isCardSoldOut, isCheckboxValueChecked, isImplementedAccountTab, isProductSoldOut, isRecord, isSelectionSoldOut, loadLatestWrittenReviews, loadShopPage, loadShopReviewsPage, missingRequiredCheckoutValues, optionalBoolean, optionalString, optionalStringWithDefault, paginateCatalogCards, parseAccountPath, parseCartQuoteLines, parseEnum, parseFiniteNumber, parseProductBadges, parseStorefrontSortKey, readCheckoutNeedsDetails, readStorefrontData, requireArray, requireBoolean, requireNumber, requireRecord, requireString, requireStringFromKeys, requireUnknownRecord, resolveAccountView, resolveBadgeForeground, resolveCartBoundsHeals, resolveCategorySelection, resolveCheckoutFields, resolveDeliveryPromise, resolveDisplayStock, resolveHideStockCounter, resolveLicenseTerm, resolveMenuLinksForSlot, resolvePayWhatYouWantMinimum, resolveProductVideoEmbedSrc, resolveQuantityBounds, resolveSupportChannels, resolveUnsellableLineIds, resolveVariantStock, reviewsForProduct, roundCurrency, sanitizeMerchantHtml, sortCatalogCards, startCartMutation, stripMerchantHtmlImages, submitContactTicket, toShopReviews, toStarCount, useCart, useNavigationLinks, useOnlineUserCount, usePagedShopReviews, useShopReviews, useStorefront, validateCheckoutFieldValue, validateCheckoutFields, validateContactSubmission, withRequiredAddons };

package/dist/index.js

@@ -2542,7 +2542,7 @@ function useNavigationLinks(slot, themeLinks, authored) {
 }
 
 // src/reviews.ts
-import { useEffect as useEffect3, useState as useState3 } from "react";
+import { useCallback as useCallback2, useEffect as useEffect3, useRef as useRef2, useState as useState3 } from "react";
 var SHOP_REVIEW_PAGE_SIZE = 12;
 function toTimestamp(value) {
   if (typeof value === "number" && Number.isFinite(value)) {
@@ -2582,7 +2582,8 @@ function toShopReviews(rows, labels) {
       dateLabel: formatDateLabel(timestamp),
       timestamp,
       productTitle: row.product_title?.trim() || null,
-      verified: row.verified === true
+      verified: row.verified === true,
+      automated: row.is_automated === true
     };
   }).sort((a, b) => b.timestamp - a.timestamp);
 }
@@ -2591,20 +2592,83 @@ function reviewsForProduct(reviews, productTitle) {
   if (!title) return [];
   return reviews.filter((review) => review.productTitle === title);
 }
-async function loadLatestWrittenReviews(limit, labels) {
+async function loadShopReviewsPage(options) {
+  const product = options.product?.trim() || null;
+  const result = await getShoppex().getShopReviewsPage(options.cursor ?? null, product ? { product } : void 0);
+  if (!result.success || !result.data) {
+    throw new Error(result.message?.trim() || "Reviews could not be loaded.");
+  }
+  if (product !== null && result.data.product !== product) {
+    throw new Error("This store does not filter reviews by product yet.");
+  }
+  const { pagination } = result.data;
+  return {
+    reviews: toShopReviews(result.data.feedback, options.labels),
+    nextCursor: pagination.has_more ? pagination.next_cursor : null,
+    summary: result.data.summary ?? null
+  };
+}
+async function loadLatestWrittenReviews(limit, labels, options = {}) {
   const written = [];
   const seen = /* @__PURE__ */ new Set();
   let cursor = null;
-  while (written.length < limit) {
-    const result = await getShoppex().getShopReviewsPage(cursor);
-    if (!result.success || !result.data) return null;
-    written.push(...result.data.feedback.filter((row) => !row.is_automated && (row.comment ?? row.message ?? "").trim() !== ""));
-    const next = result.data.pagination.has_more ? result.data.pagination.next_cursor : null;
-    if (!next || seen.has(next)) break;
-    seen.add(next);
-    cursor = next;
+  try {
+    while (written.length < limit) {
+      const page = await loadShopReviewsPage({ cursor, product: options.product, labels: { anonymousAuthor: labels.anonymousAuthor, emptyComment: "" } });
+      written.push(...page.reviews.filter((review) => !review.automated && review.comment !== ""));
+      if (!page.nextCursor || seen.has(page.nextCursor)) break;
+      seen.add(page.nextCursor);
+      cursor = page.nextCursor;
+    }
+  } catch {
+    return null;
   }
-  return toShopReviews(written, labels).slice(0, limit);
+  return written.slice(0, limit).map((review) => ({ ...review, comment: review.comment || labels.emptyComment }));
+}
+function usePagedShopReviews(options) {
+  const product = options.product?.trim() || null;
+  const { anonymousAuthor, emptyComment } = options.labels;
+  const [state, setState] = useState3({ status: "loading" });
+  const [cursor, setCursor] = useState3(null);
+  const generation = useRef2(0);
+  useEffect3(() => {
+    const current = generation.current += 1;
+    setState({ status: "loading" });
+    setCursor(null);
+    loadShopReviewsPage({ product, labels: { anonymousAuthor, emptyComment } }).then((page) => {
+      if (generation.current !== current) return;
+      setCursor(page.nextCursor);
+      setState({
+        status: "ready",
+        reviews: page.reviews,
+        summary: page.summary,
+        hasMore: page.nextCursor !== null,
+        loadingMore: false,
+        moreFailed: false
+      });
+    }).catch(() => {
+      if (generation.current === current) setState({ status: "error" });
+    });
+  }, [product, anonymousAuthor, emptyComment]);
+  const loadMore = useCallback2(() => {
+    if (state.status !== "ready" || state.loadingMore || cursor === null) return;
+    const current = generation.current;
+    setState({ ...state, loadingMore: true, moreFailed: false });
+    loadShopReviewsPage({ cursor, product, labels: { anonymousAuthor, emptyComment } }).then((page) => {
+      if (generation.current !== current) return;
+      setCursor(page.nextCursor);
+      setState((previous) => previous.status !== "ready" ? previous : {
+        ...previous,
+        reviews: [...previous.reviews, ...page.reviews],
+        hasMore: page.nextCursor !== null,
+        loadingMore: false
+      });
+    }).catch(() => {
+      if (generation.current !== current) return;
+      setState((previous) => previous.status !== "ready" ? previous : { ...previous, loadingMore: false, moreFailed: true });
+    });
+  }, [state, cursor, product, anonymousAuthor, emptyComment]);
+  return { ...state, loadMore };
 }
 function averageRating(reviews) {
   if (reviews.length === 0) return null;
@@ -2663,15 +2727,19 @@ async function buildShopPageModel(page) {
   };
 }
 async function loadShopPage(slug) {
+  let result;
+  try {
+    result = await getShoppex().getPage(slug);
+  } catch {
+    return { status: "error" };
+  }
+  if (!result.success) return result.status === 404 ? { status: "missing" } : { status: "error" };
+  const page = result.data;
+  if (!page || typeof page.name !== "string" || !page.name.trim()) return { status: "missing" };
   try {
-    const result = await getShoppex().getPage(slug);
-    const page = result.success ? result.data : void 0;
-    if (!page || typeof page.name !== "string" || !page.name.trim()) {
-      return { status: "missing" };
-    }
     return { status: "ready", page: await buildShopPageModel(page) };
   } catch {
-    return { status: "missing" };
+    return { status: "error" };
   }
 }
 
@@ -2781,6 +2849,7 @@ export {
   isSelectionSoldOut,
   loadLatestWrittenReviews,
   loadShopPage,
+  loadShopReviewsPage,
   missingRequiredCheckoutValues,
   optionalBoolean,
   optionalString,
@@ -2829,6 +2898,7 @@ export {
   useCart,
   useNavigationLinks,
   useOnlineUserCount,
+  usePagedShopReviews,
   useShopReviews,
   useStorefront,
   validateCheckoutFieldValue,