@shoppexio/storefront-react 0.3.0 → 0.5.0

package/dist/index.d.ts

@@ -469,6 +469,25 @@ interface SdkCustomerDeliverable {
     value: string;
     href: string | null;
     created_at: string;
+    /**
+     * What the buyer can still do with a FILE: downloads left, until when, or why
+     * it closed. Null on keys and codes. Optional only because the backend that
+     * sends it may deploy after this package; a missing value reads as null.
+     */
+    access?: SdkCustomerFileAccess | null;
+}
+/**
+ * One file's access, as `BuyerFileAccess` emits it. `ends_at` is an ISO instant
+ * and `time_zone` the SHOP's IANA zone: the end date is a day in the shop's
+ * calendar, so it is printed in that zone and never in the viewer's.
+ */
+interface SdkCustomerFileAccess {
+    state: 'open' | 'limit_reached' | 'expired' | 'revoked' | 'refunded';
+    downloads_left: number | null;
+    download_limit: number | null;
+    downloads_used: number;
+    ends_at: string | null;
+    time_zone: string;
 }
 /**
  * One subscription, with the actions the SERVER says are possible on it.
@@ -509,6 +528,68 @@ interface SdkCustomerSubscription {
         can_cancel: boolean;
         can_manage_payment_method: boolean;
     };
+    /**
+     * The day an unpaid renewal's hold ends the subscription (PAST_DUE: access is
+     * off until the buyer pays). Null without a hold; optional only for deploy order.
+     */
+    hold_ends_at?: string | null;
+    /**
+     * Set to end without renewing (cancelled at the period end, or a voided
+     * renewal): the instant it ends. Null while it renews; optional only for deploy order.
+     */
+    ends_at?: string | null;
+    /**
+     * The open renewal invoice: what it costs, the day to pay by, and its hosted
+     * checkout. A plain link: the invoice already exists, so following it creates
+     * nothing. Null when nothing is open; optional only for deploy order.
+     */
+    open_renewal?: SdkCustomerOpenRenewal | null;
+    /**
+     * The open pause: `scheduled` while the plan still runs until `starts_at`, then
+     * `paused`. Null without one; optional only for deploy order (an older SDK strips it).
+     */
+    pause?: SdkCustomerPause | null;
+    /** What a new pause would be; null when the buyer cannot pause now. Optional for deploy order. */
+    pause_options?: SdkCustomerPauseOptions | null;
+    /** Set only when every pause of the last 12 months is used. Optional for deploy order. */
+    pause_limit?: {
+        pauses_per_year: number;
+        available_again_at: string;
+    } | null;
+    /** The Discord roles a pause takes ([] none); null when not known. Optional for deploy order. */
+    pause_access_roles?: string[] | null;
+}
+/** Why a buyer pauses (`SUBSCRIPTION_PAUSE_REASONS`). */
+type SdkCustomerPauseReason = 'taking_a_break' | 'too_expensive' | 'not_using' | 'not_working' | 'other';
+/** `PauseWire` on the dashboard wire. ISO instants. */
+interface SdkCustomerPause {
+    state: 'scheduled' | 'paused';
+    starts_at: string;
+    /** Null: paused until someone resumes it (merchant and Developer API pauses). */
+    resume_at: string | null;
+    reason: SdkCustomerPauseReason | null;
+}
+/** `BuyerPauseView.pause_options`: the start, the lengths with their resume dates, and the pauses left after this one. */
+interface SdkCustomerPauseOptions {
+    starts_at: string;
+    lengths: Array<{
+        days: 7 | 14 | 30 | 60 | 90;
+        resume_at: string;
+    }>;
+    reason_enabled: boolean;
+    pauses_left_after: number;
+}
+/** An open renewal invoice of a subscription (`CustomerOpenRenewal` on the dashboard wire). */
+interface SdkCustomerOpenRenewal {
+    uniqid: string;
+    amount: string;
+    currency: string;
+    /** ISO instant: renewal date plus the shop's time to pay, or the hold end while on hold. */
+    pay_by: string;
+    pay_url: string;
+    /** The plan this invoice bills, which differs from `plan` while a scheduled interval change waits for it. */
+    interval: string;
+    interval_count: number;
 }
 /** One earned reward. `created_at` and `expires_at` are epoch SECONDS. */
 interface SdkCustomerRewardActivity {
@@ -555,6 +636,21 @@ type SdkCustomerAffiliateLedgerStatus = 'waiting_payment' | 'earned' | 'in_payou
  * "money paths do not belong on the account API"), so this template renders
  * what the buyer has earned and says where the payout lives.
  */
+/** What a referral earns the affiliate. Amounts are USD, like the affiliate ledger. */
+interface SdkCustomerAffiliateRates {
+    /** The affiliate's rate (link, affiliate or tier), else the shop default. */
+    percent: number;
+    /** Up to three products set to No Commission, by title; `disabled_product_count` is the full count. */
+    disabled_products: string[];
+    disabled_product_count: number;
+    /** Products paying their own rate instead of `percent`; 0 when the affiliate's own rate overrides them. */
+    custom_rate_product_count: number;
+    cap_usd: string | null;
+    minimum_order_usd: string | null;
+    binding_mode: 'PER_ORDER' | 'LIFETIME_FIRST' | 'LIFETIME_LAST';
+    /** Null keeps a referred buyer for good. */
+    binding_days: number | null;
+}
 interface SdkCustomerAffiliateSummary {
     /** `not_enrolled` is the availability gate for the whole referrals panel. */
     state: string;
@@ -571,6 +667,8 @@ interface SdkCustomerAffiliateSummary {
         converted: string;
         paid: string;
     };
+    /** "Your rates" (`readAffiliateRatesSummary`); null until the main link is approved and active. */
+    rates: SdkCustomerAffiliateRates | null;
     links: SdkCustomerAffiliateLink[];
     commissions: Array<{
         id: string;
@@ -654,6 +752,30 @@ interface SdkCustomerWarrantyClaim {
         claim_status: 'REQUESTED';
     };
 }
+/**
+ * The buyer's review of one order. `can_review` is the server's call (paid,
+ * reviews on, inside the edit window); a storefront never derives it.
+ */
+interface SdkCustomerOrderReview {
+    can_review: boolean;
+    already_submitted: boolean;
+    feedback_uniqid: string | null;
+    product_title: string | null;
+    score: 1 | 3 | 5 | null;
+    /** The automatic positive review the shop posts when the buyer left none. */
+    is_automated: boolean;
+    message: string | null;
+    submitted_at: string | null;
+    /** The name the review would show; null when the shop shows none. */
+    reviewer_name: string | null;
+    anonymous: boolean;
+    /**
+     * The hosted review page on the checkout host, null unless `can_review`. The
+     * review is written there, never posted from a storefront (#1152). Absent on
+     * a backend that predates it.
+     */
+    review_url?: string | null;
+}
 interface SdkCustomerDashboard {
     shop: {
         name: string;
@@ -679,6 +801,8 @@ interface SdkCustomerDashboard {
         hold: string;
         currency: string;
         enabled: boolean;
+        /** The shop takes top-ups; the account's "Top up" link to the hosted top-up page shows only then. */
+        topups_allowed: boolean;
     } | null;
     invoices: SdkCustomerDashboardOrder[];
     rewards: SdkCustomerRewards;
@@ -746,6 +870,12 @@ interface SdkCustomerOrderDetail {
     taxPercentage: string;
     currency: string;
     createdAt: string;
+    /** The goods went to a gift recipient or wait for a reveal; absent from a backend older than the field. */
+    deliveryWithheld?: boolean;
+    /** What became of money an expired order took: NONE when none was recorded; null unless EXPIRED. */
+    expiredPayment?: 'NONE' | 'IN_REVIEW' | 'HELD' | 'SETTLED' | 'REFUNDED' | null;
+    /** When the paying attempt completed; kept on a disputed order, so the status decides whether it reads as paid. */
+    paidAt?: string | null;
     lineItems: Array<{
         id: string;
         productTitle: string;
@@ -754,6 +884,8 @@ interface SdkCustomerOrderDetail {
         quantity: number;
         total: string;
         deliveryText: string | null;
+        /** When the line was delivered; null until it was. */
+        deliveredAt: string | null;
         deliveryStatus: SdkCustomerDeliveryStatus;
         deliverySummary: SdkCustomerDeliverySummary | null;
     }>;
@@ -1004,6 +1136,8 @@ interface ShoppexSdk {
         page?: number;
         limit?: number;
         status?: string;
+        /** One order-list group of the buyer status table: "paid" holds COMPLETED and AWAITING_STOCK. */
+        statusGroup?: 'awaiting_payment' | 'paid' | 'refunded';
         search?: string;
     }): Promise<SdkResponse<SdkCustomerOrderPage>>;
     /** One order, by the `uniqid` the list rows carry. */
@@ -1023,6 +1157,8 @@ interface ShoppexSdk {
      */
     warranties(invoiceUniqid?: string): Promise<SdkResponse<SdkCustomerWarrantyList>>;
     claimWarranty(uniqid: string, message?: string): Promise<SdkResponse<SdkCustomerWarrantyClaim>>;
+    /** The buyer's review of one order, by the order's `uniqid`. */
+    orderReview(uniqid: string): Promise<SdkResponse<SdkCustomerOrderReview>>;
     /** Clears a license's hardware lock so the next activation claims it. */
     resetLicenseHwid(uniqid: string): Promise<SdkResponse<unknown>>;
     /** Renewal invoices for one subscription. */
@@ -1035,7 +1171,12 @@ interface ShoppexSdk {
         cancel_at_period_end?: boolean;
         reason?: string | null;
     }): Promise<SdkResponse<unknown>>;
-    pauseSubscription(uniqid: string): Promise<SdkResponse<unknown>>;
+    /** Pauses from `pause_options.starts_at` for one of its lengths, with a reason when the shop asks for one. */
+    pauseSubscription(uniqid: string, options?: {
+        length_days?: 7 | 14 | 30 | 60 | 90;
+        reason?: SdkCustomerPauseReason | null;
+    }): Promise<SdkResponse<unknown>>;
+    /** "Resume now" on a paused plan; "Don't pause" on a scheduled pause. */
     resumeSubscription(uniqid: string): Promise<SdkResponse<unknown>>;
     /** The buyer's saved products. */
     favorites(): Promise<SdkResponse<unknown>>;
@@ -1108,12 +1249,6 @@ interface ShoppexSdk {
         page?: number;
         per_page?: number;
     }): Promise<SdkResponse<unknown>>;
-    /** Server-prices a basket, including volume discounts, without writing. */
-    quoteResellerOrder(items: Array<{
-        product_id: string;
-        variant_id?: string;
-        quantity: number;
-    }>): Promise<SdkResponse<unknown>>;
     /** Page-based wholesale order history. */
     resellerOrders(options?: {
         page?: number;
@@ -1138,7 +1273,7 @@ interface SdkShopReview {
     id: string;
     /** 1-5, normalized by the SDK from the shop-feedback score (5/3/1). */
     rating: number;
-    /** Buyer names are anonymized by the API to "Customer Hidden". */
+    /** The name the buyer chose to post under, or "Anonymous". */
     author?: string;
     customer_name?: string;
     comment?: string;
@@ -1147,6 +1282,8 @@ interface SdkShopReview {
     /** True when the review is tied to a real completed purchase. */
     verified?: boolean;
     is_automated?: boolean;
+    /** The shop's reply under the review; null when it has not replied. */
+    reply?: string | null;
     created_at: string;
 }
 type AddonBarPreset = 'brand_blue' | 'emerald' | 'sunset' | 'rose' | 'charcoal' | 'custom';
@@ -1407,6 +1544,16 @@ interface StorefrontPriceVariant {
     quantityMax: number | null;
     imageUrl: string | null;
     isFeatured: boolean;
+    /** The option's own billing cadence; null bills at the product's (`subscriptionForVariant`). */
+    billingInterval: {
+        unit: SubscriptionIntervalUnit;
+        count: number;
+    } | null;
+    /**
+     * The option's own trial (`'none'`: the option has no trial); null starts it
+     * with the product's (`subscriptionForVariant`).
+     */
+    ownTrial: SubscriptionTrial | 'none' | null;
 }
 interface VolumeDiscountRule {
     quantity: number;
@@ -1586,7 +1733,7 @@ type YouReceive = {
 };
 declare function resolveYouReceive(product: Pick<StorefrontProduct, 'deliverable' | 'unitLabelSingular'>): YouReceive | null;
 /**
- * How often a subscription product is charged, and how long it is free first.
+ * How often a subscription product is charged, and the trial it starts with.
  *
  * PARITY CONTRACT. The Easy lane derives the same three facts from the same
  * flat wire fields in
@@ -1605,13 +1752,38 @@ interface ProductSubscription {
     intervalUnit: SubscriptionIntervalUnit | null;
     /** Intervals per charge, at least 1. */
     intervalCount: number;
-    /** Free-trial length in days; 0 when the merchant set none. */
-    trialDays: number;
+    /** The trial the plan starts with; null when it has none. */
+    trial: SubscriptionTrial | null;
 }
+/**
+ * A free trial, or a paid intro: `price` in `currency` (the product currency,
+ * as the wire states it) for the first `days`. The trial checkout bills
+ * (`resolveProductTrial`).
+ */
+type SubscriptionTrial = {
+    kind: 'free';
+    days: number;
+} | {
+    kind: 'paid';
+    days: number;
+    price: number;
+    currency: string;
+};
 /** The cadence as it reads next to a price: "per month", "every 3 months". */
 declare function formatSubscriptionCadence(subscription: ProductSubscription): string;
-/** "7-day free trial" — the plan charges nothing for those days. */
-declare function formatSubscriptionTrial(subscription: ProductSubscription): string;
+/**
+ * "7-day free trial" for a free trial, "$4.99 for 7 days" for a paid intro
+ * (`formatAmount` prints its price); empty when the plan has no trial.
+ */
+declare function formatSubscriptionTrial(subscription: ProductSubscription, formatAmount: (amount: number, currency: string) => string): string;
+/**
+ * The subscription as the selected option bills it: an option with its own
+ * interval (`billing_interval`, stored with its count or not at all) is charged
+ * at that cadence, every other one at the product's. An option with its own
+ * trial ("No trial" included) starts with it, every other one with the
+ * product's: the rule checkout's `resolveProductTrial` applies.
+ */
+declare function subscriptionForVariant(subscription: ProductSubscription, variant: Pick<StorefrontPriceVariant, 'billingInterval' | 'ownTrial'> | null | undefined): ProductSubscription;
 /**
  * What a product image shows, from the backend's pixel analysis. `art` is a
  * cover, artwork or photo; `logo` is a flat mark, drawn on a contrasting plate.
@@ -3204,6 +3376,8 @@ interface ShopReview {
     verified: boolean;
     /** Left by the shop's review automation, not written by the buyer. */
     automated: boolean;
+    /** The shop's reply under the review; null when it has not replied. */
+    reply: string | null;
 }
 type ShopReviewsState = {
     status: 'loading';
@@ -3531,4 +3705,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, FAVORITES_CHANGED_EVENT, type FavoriteToggleResult, type FavoritesApi, FavoritesProvider, type FavoritesSnapshot, type FavoritesStatus, type FavoritesStore, type FavoritesTransport, 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 ProductDeliverable, type ProductDeliveryType, type ProductDetailModel, type ProductFaq, type ProductImage, type ProductImageKind, type ProductRatingModel, type ProductServiceStatus, type ProductSubscription, type ProductType, QUOTE_UNAVAILABLE_CHECKOUT_ERROR, type RatingStars, type ResellerProgramSummary, type RewardProgramItem, type RewardProgramSummary, SERVICE_STATES, 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 SdkCustomerAffiliateLedgerStatus, type SdkCustomerAffiliateLink, type SdkCustomerAffiliateLinkCreated, type SdkCustomerAffiliateSummary, type SdkCustomerDashboard, type SdkCustomerDashboardOrder, type SdkCustomerDeliverable, type SdkCustomerDeliveryStatus, type SdkCustomerDeliverySummary, type SdkCustomerInvoicePdf, type SdkCustomerLicense, type SdkCustomerLoyalty, type SdkCustomerLoyaltyRedeem, type SdkCustomerLoyaltyTransactionType, type SdkCustomerNotificationPreferences, 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 ServiceState, type ShopPageFaqItem, type ShopPageModel, type ShopPageState, type ShopReview, type ShopReviewLabels, type ShopReviewsPageResult, type ShopReviewsState, type ShoppexSdk, type SocialLink, type SocialNetwork, type StatusPageEntry, type StatusPageModel, type StockAlertRequest, type StockAlertResult, type StockChip, type StockTone, type StorefrontAddon, type StorefrontCatalog, type StorefrontCategory, type StorefrontData, type StorefrontGroup, type StorefrontListingItem, type StorefrontPaymentMethod, type StorefrontPaymentMethodKind, type StorefrontPriceVariant, type StorefrontProduct, StorefrontProvider, type StorefrontSettings, type StorefrontShop, type StorefrontShopStats, type StorefrontSortKey, type SubscriptionIntervalUnit, type SupportChannel, type VolumeDiscountRule, type YouReceive, accountOrderHref, accountRouteMessage, accountTabHref, accountTabLabelKey, addonChoiceMissing, averageRating, badgesForCard, badgesForProductPage, buildCartTotals, buildCartView, buildCustomFieldPayload, buildInitialCheckoutFieldValues, buildProductDetail, buildStatusPageModel, buildStorefrontCatalog, calculateDisplayLineTotal, calculateLinePricing, canRequestStockAlert, canonicalAccountPath, checkoutFieldKey, checkoutFieldWriteRepriced, checkoutNeedsDetails, clampQuantity, clearRecoveredQuoteCheckoutError, createFavoritesStore, 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, notifyFavoritesChanged, optionalBoolean, optionalString, optionalStringWithDefault, paginateCatalogCards, parseAccountPath, parseCartQuoteLines, parseEnum, parseFiniteNumber, parseProductBadges, parseServiceStatus, parseStorefrontSortKey, readCheckoutNeedsDetails, readStorefrontData, requestStockAlert, requireArray, requireBoolean, requireNumber, requireRecord, requireString, requireStringFromKeys, requireUnknownRecord, resolveAccountView, resolveBadgeForeground, resolveCartBoundsHeals, resolveCategorySelection, resolveCheckoutFields, resolveDeliveryPromise, resolveDisplayStock, resolveHideStockCounter, resolveLicenseTerm, resolveMenuLinksForSlot, resolvePayWhatYouWantMinimum, resolveProductVideoEmbedSrc, resolveQuantityBounds, resolveSupportChannels, resolveUnsellableLineIds, resolveVariantStock, resolveYouReceive, reviewsForProduct, roundCurrency, sanitizeMerchantHtml, sdkFavoritesTransport, sortCatalogCards, startCartMutation, stripMerchantHtmlImages, submitContactTicket, toShopReviews, toStarCount, useCart, useFavorites, useNavigationLinks, useOnlineUserCount, usePagedShopReviews, 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, FAVORITES_CHANGED_EVENT, type FavoriteToggleResult, type FavoritesApi, FavoritesProvider, type FavoritesSnapshot, type FavoritesStatus, type FavoritesStore, type FavoritesTransport, 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 ProductDeliverable, type ProductDeliveryType, type ProductDetailModel, type ProductFaq, type ProductImage, type ProductImageKind, type ProductRatingModel, type ProductServiceStatus, type ProductSubscription, type ProductType, QUOTE_UNAVAILABLE_CHECKOUT_ERROR, type RatingStars, type ResellerProgramSummary, type RewardProgramItem, type RewardProgramSummary, SERVICE_STATES, 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 SdkCustomerAffiliateLedgerStatus, type SdkCustomerAffiliateLink, type SdkCustomerAffiliateLinkCreated, type SdkCustomerAffiliateRates, type SdkCustomerAffiliateSummary, type SdkCustomerDashboard, type SdkCustomerDashboardOrder, type SdkCustomerDeliverable, type SdkCustomerDeliveryStatus, type SdkCustomerDeliverySummary, type SdkCustomerFileAccess, type SdkCustomerInvoicePdf, type SdkCustomerLicense, type SdkCustomerLoyalty, type SdkCustomerLoyaltyRedeem, type SdkCustomerLoyaltyTransactionType, type SdkCustomerNotificationPreferences, type SdkCustomerOpenRenewal, type SdkCustomerOrderDetail, type SdkCustomerOrderPage, type SdkCustomerOrderReview, type SdkCustomerOrderSummary, type SdkCustomerPause, type SdkCustomerPauseOptions, type SdkCustomerPauseReason, 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 ServiceState, type ShopPageFaqItem, type ShopPageModel, type ShopPageState, type ShopReview, type ShopReviewLabels, type ShopReviewsPageResult, type ShopReviewsState, type ShoppexSdk, type SocialLink, type SocialNetwork, type StatusPageEntry, type StatusPageModel, type StockAlertRequest, type StockAlertResult, type StockChip, type StockTone, type StorefrontAddon, type StorefrontCatalog, type StorefrontCategory, type StorefrontData, type StorefrontGroup, type StorefrontListingItem, type StorefrontPaymentMethod, type StorefrontPaymentMethodKind, type StorefrontPriceVariant, type StorefrontProduct, StorefrontProvider, type StorefrontSettings, type StorefrontShop, type StorefrontShopStats, type StorefrontSortKey, type SubscriptionIntervalUnit, type SubscriptionTrial, type SupportChannel, type VolumeDiscountRule, type YouReceive, accountOrderHref, accountRouteMessage, accountTabHref, accountTabLabelKey, addonChoiceMissing, averageRating, badgesForCard, badgesForProductPage, buildCartTotals, buildCartView, buildCustomFieldPayload, buildInitialCheckoutFieldValues, buildProductDetail, buildStatusPageModel, buildStorefrontCatalog, calculateDisplayLineTotal, calculateLinePricing, canRequestStockAlert, canonicalAccountPath, checkoutFieldKey, checkoutFieldWriteRepriced, checkoutNeedsDetails, clampQuantity, clearRecoveredQuoteCheckoutError, createFavoritesStore, 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, notifyFavoritesChanged, optionalBoolean, optionalString, optionalStringWithDefault, paginateCatalogCards, parseAccountPath, parseCartQuoteLines, parseEnum, parseFiniteNumber, parseProductBadges, parseServiceStatus, parseStorefrontSortKey, readCheckoutNeedsDetails, readStorefrontData, requestStockAlert, requireArray, requireBoolean, requireNumber, requireRecord, requireString, requireStringFromKeys, requireUnknownRecord, resolveAccountView, resolveBadgeForeground, resolveCartBoundsHeals, resolveCategorySelection, resolveCheckoutFields, resolveDeliveryPromise, resolveDisplayStock, resolveHideStockCounter, resolveLicenseTerm, resolveMenuLinksForSlot, resolvePayWhatYouWantMinimum, resolveProductVideoEmbedSrc, resolveQuantityBounds, resolveSupportChannels, resolveUnsellableLineIds, resolveVariantStock, resolveYouReceive, reviewsForProduct, roundCurrency, sanitizeMerchantHtml, sdkFavoritesTransport, sortCatalogCards, startCartMutation, stripMerchantHtmlImages, submitContactTicket, subscriptionForVariant, toShopReviews, toStarCount, useCart, useFavorites, useNavigationLinks, useOnlineUserCount, usePagedShopReviews, useShopReviews, useStorefront, validateCheckoutFieldValue, validateCheckoutFields, validateContactSubmission, withRequiredAddons };

package/dist/index.js

@@ -575,9 +575,21 @@ function formatSubscriptionCadence(subscription) {
   const noun = SUBSCRIPTION_INTERVAL_NOUNS[unit];
   return subscription.intervalCount === 1 ? `per ${noun}` : `every ${subscription.intervalCount} ${noun}s`;
 }
-function formatSubscriptionTrial(subscription) {
-  const days = subscription.trialDays;
-  return days > 0 ? `${days}-day free trial` : "";
+function formatSubscriptionTrial(subscription, formatAmount) {
+  const trial = subscription.trial;
+  if (!trial) return "";
+  if (trial.kind === "free") return `${trial.days}-day free trial`;
+  return `${formatAmount(trial.price, trial.currency)} for ${trial.days} ${trial.days === 1 ? "day" : "days"}`;
+}
+function subscriptionForVariant(subscription, variant) {
+  const own = variant?.billingInterval;
+  const ownTrial = variant?.ownTrial;
+  if (!own && !ownTrial) return subscription;
+  return {
+    ...subscription,
+    ...own ? { intervalUnit: own.unit, intervalCount: own.count } : {},
+    ...ownTrial ? { trial: ownTrial === "none" ? null : ownTrial } : {}
+  };
 }
 function parseSubscription(product, productType) {
   if (productType !== "SUBSCRIPTION") return null;
@@ -587,9 +599,29 @@ function parseSubscription(product, productType) {
   return {
     intervalUnit: unit,
     intervalCount: count,
-    trialDays: normalizePositiveDays(product.trial_period) ?? 0
+    trial: parseTrial(product)
   };
 }
+function parseVariantBillingInterval(variant) {
+  const unit = SUBSCRIPTION_INTERVAL_UNITS.find((entry) => entry === variant.billing_interval);
+  const count = normalizePositiveDays(variant.billing_interval_count);
+  return unit && count ? { unit, count } : null;
+}
+function parseTrial(record) {
+  const days = record.trial_days;
+  if (typeof days !== "number" || !Number.isInteger(days) || days < 1) return null;
+  if (record.trial_kind === "free") return { kind: "free", days };
+  const price = typeof record.trial_price === "string" ? Number(record.trial_price) : Number.NaN;
+  if (record.trial_kind === "paid" && price > 0 && typeof record.trial_price_currency === "string") {
+    return { kind: "paid", days, price, currency: record.trial_price_currency };
+  }
+  return null;
+}
+function parseVariantTrial(variant) {
+  const kind = variant.trial_kind;
+  if (kind !== "none" && kind !== "free" && kind !== "paid") return null;
+  return parseTrial(variant) ?? "none";
+}
 var PAYMENT_METHOD_KINDS = ["card", "wallet", "crypto"];
 function parsePaymentMethods(value) {
   if (!Array.isArray(value)) {
@@ -896,11 +928,7 @@ function parseProduct(value, index) {
     imageUrl: resolveProductImage(product),
     imageUrls: images.map((image) => image.url),
     images,
-    stock: applyOrderable(
-      normalizeStock(product.stock, `${context}.stock`),
-      product.orderable,
-      product.supplier_backed
-    ),
+    stock: normalizeStock(product.stock, `${context}.stock`),
     lowStockThreshold: normalizeLowStockThreshold(
       normalizeOptionalNonNegativeNumber(product.quantity_warning)
     ),
@@ -1019,13 +1047,11 @@ function parsePriceVariants(value, productContext) {
       label: requireStringFromKeys(variant, ["label", "title"], context),
       description: optionalString(variant.description),
       license: parseVariantLicense(variant),
+      billingInterval: parseVariantBillingInterval(variant),
+      ownTrial: parseVariantTrial(variant),
       price: unitPrice,
       baseUnitPrice: unitPrice,
-      stock: applyOrderable(
-        normalizeStock(variant.stock, `${context}.stock`),
-        variant.orderable,
-        variant.supplier_backed
-      ),
+      stock: normalizeStock(variant.stock, `${context}.stock`),
       quantityMin,
       quantityMax: normalizeMaximum(variant.quantity_max, quantityMin ?? 1, `${context}.quantity_max`),
       imageUrl: optionalString(variant.image_url),
@@ -1294,11 +1320,6 @@ function normalizeStock(value, context) {
   const stock = parseFiniteNumber(value, context);
   return stock < 0 ? null : Math.floor(stock);
 }
-function applyOrderable(stock, orderable, supplierBacked) {
-  if (orderable !== true) return stock;
-  if (supplierBacked === true) return null;
-  return stock === 0 ? null : stock;
-}
 function normalizeOptionalNonNegativeNumber(value) {
   if (value === null || value === void 0 || value === "") return null;
   const parsed = Number(value);
@@ -2821,7 +2842,8 @@ function toShopReviews(rows, labels) {
       timestamp,
       productTitle: row.product_title?.trim() || null,
       verified: row.verified === true,
-      automated: row.is_automated === true
+      automated: row.is_automated === true,
+      reply: row.reply?.trim() || null
     };
   }).sort((a, b) => b.timestamp - a.timestamp);
 }
@@ -3190,6 +3212,7 @@ export {
   startCartMutation,
   stripMerchantHtmlImages,
   submitContactTicket,
+  subscriptionForVariant,
   toShopReviews,
   toStarCount,
   useCart,