bitsnap-react 1.11.0 → 1.12.0

package/dist/index.d.mts

@@ -28,6 +28,8 @@ type Props$3 = {
         name: string;
         id: string;
         price: number;
+        /** Currency of `price` (minor units); defaults to PLN. */
+        currency?: string;
         quantity: number;
         isDeliverable?: boolean;
         metadata?: {
@@ -95,7 +97,7 @@ type CheckoutAppearanceTokens = {
  * Stable slot names. They are exposed as `data-bitsnap-checkout-slot`
  * attributes so they can also be targeted from plain CSS.
  */
-declare const CHECKOUT_SLOT_NAMES: readonly ["root", "overlay", "panel", "header", "title", "closeButton", "productList", "product", "productImage", "productName", "productPrice", "quantityControl", "quantityInput", "quantityButton", "removeButton", "summary", "totalLabel", "totalValue", "deliveryText", "countryLabel", "countryTrigger", "countryDropdown", "countrySearch", "countryOption", "paymentButtons", "checkoutButton", "emptyState", "error", "skeleton"];
+declare const CHECKOUT_SLOT_NAMES: readonly ["root", "overlay", "panel", "header", "title", "closeButton", "productList", "product", "productImage", "productName", "productPrice", "quantityControl", "quantityInput", "quantityButton", "removeButton", "summary", "totalLabel", "totalValue", "deliveryText", "summaryNote", "countryLabel", "countryTrigger", "countryDropdown", "countrySearch", "countryOption", "paymentButtons", "checkoutButton", "emptyState", "error", "skeleton"];
 type CheckoutSlotName = (typeof CHECKOUT_SLOT_NAMES)[number];
 type CheckoutSlotAppearance = SlotAppearance;
 type CheckoutAppearanceElements = AppearanceElements<CheckoutSlotName>;
@@ -145,6 +147,44 @@ type CheckoutTexts = {
     currencyUnsupported: string;
     /** Error shown when a price changed after the product was added. */
     priceChanged: string;
+    /** Accessible name of the close button of the drawer. */
+    close: string;
+    /** Remove button of a cart line (also read together with the product name). */
+    remove: string;
+    /** Accessible name of the quantity control and its input. */
+    quantity: string;
+    /** Accessible name of the "+" quantity button. */
+    increaseQuantity: string;
+    /** Accessible name of the "-" quantity button. */
+    decreaseQuantity: string;
+    /** Accessible name of the cart button when it only shows an icon. */
+    openCart: string;
+    /** Hidden label of the number of products badge; the number is appended after a colon. */
+    cartItemsCount: string;
+    /** Label before the lowest price of the last 30 days; the price is appended. */
+    lowestPrice30Days: string;
+    /** Shown instead of the lowest price when the price has no history. */
+    noPriceHistory: string;
+    /** Error shown when redirecting to the payment failed. */
+    redirectFailed: string;
+    /** Error shown when a subscription is added to the cart. */
+    subscriptionUnsupported: string;
+    /** Country search placeholder. */
+    searchCountry: string;
+    /** Shown when the country search has no match. */
+    noCountriesFound: string;
+    /** Hint under the checkout button when no country is chosen. */
+    countryRequired: string;
+    /** Title of the Apple Pay and Google Pay sheet total. */
+    paymentForCart: string;
+    /** Coupon label in the Google Pay sheet; the code is appended. */
+    coupon: string;
+    /** Note under the cart total. */
+    extrasCalculatedNext: string;
+    /** Error shown when the products of the cart could not be loaded. */
+    loadFailed: string;
+    /** Button that loads the cart again. */
+    retry: string;
 };
 
 type BitsnapCartProps = {
@@ -454,8 +494,14 @@ declare namespace Bitsnap {
      * Adds a product or variant to the cart. Returns an `Err` instead of adding
      * anything when the backend does not know the id
      * (`item-ids-not-found`, with the unknown ids in `data`).
+     *
+     * `args.url` is the product page: the cart links the item's image and name
+     * to it. A relative URL is resolved against the current page; only `http`
+     * and `https` links are kept.
      */
     function addProductToCart(id: string, quantity?: number, metadata?: Record<string, string | undefined>, args?: {
+        /** Product page the cart item links to. */
+        url?: string;
         name?: string;
         price?: number;
         currency?: string;
@@ -466,6 +512,8 @@ declare namespace Bitsnap {
     function hideCart(): void;
 }
 declare function createPaymentURL(request: LinkRequest): Promise<Err | {
+    projectId?: string | undefined;
+    orderId?: string | undefined;
     url: string;
 }>;
 /**

package/dist/index.d.ts

@@ -28,6 +28,8 @@ type Props$3 = {
         name: string;
         id: string;
         price: number;
+        /** Currency of `price` (minor units); defaults to PLN. */
+        currency?: string;
         quantity: number;
         isDeliverable?: boolean;
         metadata?: {
@@ -95,7 +97,7 @@ type CheckoutAppearanceTokens = {
  * Stable slot names. They are exposed as `data-bitsnap-checkout-slot`
  * attributes so they can also be targeted from plain CSS.
  */
-declare const CHECKOUT_SLOT_NAMES: readonly ["root", "overlay", "panel", "header", "title", "closeButton", "productList", "product", "productImage", "productName", "productPrice", "quantityControl", "quantityInput", "quantityButton", "removeButton", "summary", "totalLabel", "totalValue", "deliveryText", "countryLabel", "countryTrigger", "countryDropdown", "countrySearch", "countryOption", "paymentButtons", "checkoutButton", "emptyState", "error", "skeleton"];
+declare const CHECKOUT_SLOT_NAMES: readonly ["root", "overlay", "panel", "header", "title", "closeButton", "productList", "product", "productImage", "productName", "productPrice", "quantityControl", "quantityInput", "quantityButton", "removeButton", "summary", "totalLabel", "totalValue", "deliveryText", "summaryNote", "countryLabel", "countryTrigger", "countryDropdown", "countrySearch", "countryOption", "paymentButtons", "checkoutButton", "emptyState", "error", "skeleton"];
 type CheckoutSlotName = (typeof CHECKOUT_SLOT_NAMES)[number];
 type CheckoutSlotAppearance = SlotAppearance;
 type CheckoutAppearanceElements = AppearanceElements<CheckoutSlotName>;
@@ -145,6 +147,44 @@ type CheckoutTexts = {
     currencyUnsupported: string;
     /** Error shown when a price changed after the product was added. */
     priceChanged: string;
+    /** Accessible name of the close button of the drawer. */
+    close: string;
+    /** Remove button of a cart line (also read together with the product name). */
+    remove: string;
+    /** Accessible name of the quantity control and its input. */
+    quantity: string;
+    /** Accessible name of the "+" quantity button. */
+    increaseQuantity: string;
+    /** Accessible name of the "-" quantity button. */
+    decreaseQuantity: string;
+    /** Accessible name of the cart button when it only shows an icon. */
+    openCart: string;
+    /** Hidden label of the number of products badge; the number is appended after a colon. */
+    cartItemsCount: string;
+    /** Label before the lowest price of the last 30 days; the price is appended. */
+    lowestPrice30Days: string;
+    /** Shown instead of the lowest price when the price has no history. */
+    noPriceHistory: string;
+    /** Error shown when redirecting to the payment failed. */
+    redirectFailed: string;
+    /** Error shown when a subscription is added to the cart. */
+    subscriptionUnsupported: string;
+    /** Country search placeholder. */
+    searchCountry: string;
+    /** Shown when the country search has no match. */
+    noCountriesFound: string;
+    /** Hint under the checkout button when no country is chosen. */
+    countryRequired: string;
+    /** Title of the Apple Pay and Google Pay sheet total. */
+    paymentForCart: string;
+    /** Coupon label in the Google Pay sheet; the code is appended. */
+    coupon: string;
+    /** Note under the cart total. */
+    extrasCalculatedNext: string;
+    /** Error shown when the products of the cart could not be loaded. */
+    loadFailed: string;
+    /** Button that loads the cart again. */
+    retry: string;
 };
 
 type BitsnapCartProps = {
@@ -454,8 +494,14 @@ declare namespace Bitsnap {
      * Adds a product or variant to the cart. Returns an `Err` instead of adding
      * anything when the backend does not know the id
      * (`item-ids-not-found`, with the unknown ids in `data`).
+     *
+     * `args.url` is the product page: the cart links the item's image and name
+     * to it. A relative URL is resolved against the current page; only `http`
+     * and `https` links are kept.
      */
     function addProductToCart(id: string, quantity?: number, metadata?: Record<string, string | undefined>, args?: {
+        /** Product page the cart item links to. */
+        url?: string;
         name?: string;
         price?: number;
         currency?: string;
@@ -466,6 +512,8 @@ declare namespace Bitsnap {
     function hideCart(): void;
 }
 declare function createPaymentURL(request: LinkRequest): Promise<Err | {
+    projectId?: string | undefined;
+    orderId?: string | undefined;
     url: string;
 }>;
 /**