@cartbase/storefront 0.8.0 → 0.10.0

package/src/checkout/labels.ts

@@ -152,6 +152,110 @@ export type CheckoutLabels = {
   boxnowChange: string
   boxnowUnavailable: string
   boxnowNoLockersInCity: string
+  /**
+   * What a shopper reads when saving the address fails. It used to be
+   * hardcoded BULGARIAN inside `address-error-copy.ts` with no way to
+   * override it, so a merchant anywhere on earth showed Bulgarian on the
+   * one screen where a shopper is about to pay (found 2026-09-13). It is
+   * copy, so it belongs in the label pack like all other copy.
+   *
+   * The PATTERNS that recognize each failure stay in code: they match the
+   * API's own English error text, which is not translated and must not be.
+   */
+  addressErrors: AddressErrorCopy
+  /**
+   * The rest of the checkout's failure copy, lifted out of
+   * `payment-error-copy.ts` and `promotion-error-copy.ts` on 2026-09-13
+   * for the same reason as `addressErrors`: they held 54 hardcoded
+   * Bulgarian sentences that every merchant shipped and none could
+   * override. The recognition stays in those modules; only the words
+   * live here.
+   */
+  paymentErrors: PaymentErrorCopy
+  giftCardErrors: GiftCardErrorCopy
+  promotionErrors: PromotionErrorCopy
+}
+
+/** The eleven things that can go wrong saving a checkout address. */
+export type AddressErrorCopy = {
+  /** Anything unrecognized. Never leaks the technical message. */
+  generic: string
+  network: string
+  validationFailed: string
+  invalidRegion: string
+  regionRequired: string
+  cartCompleted: string
+  cartNotFound: string
+  invalidEmail: string
+  invalidPostalCode: string
+  invalidPhone: string
+  invalidCountry: string
+}
+
+export type PaymentErrorCopy = {
+  genericCard: string
+  genericCod: string
+  cartEmailRequired: string
+  cartEmpty: string
+  shippingAddressRequired: string
+  shippingMethodRequired: string
+  paymentCollectionRequired: string
+  paymentSessionRequired: string
+  insufficientInventory: string
+  checkoutMethodHidden: string
+  requiresAction: string
+  paymentNotAuthorized: string
+  paymentNotInitiated: string
+  paymentIncomplete: string
+  giftCardInsufficientBalance: string
+  giftCardNotRedeemable: string
+  accountRequired: string
+  cartLocked: string
+  cartCompleted: string
+  cartNotFound: string
+  shippingOptionNotFound: string
+  invalidProvider: string
+  shippingPriceMissing: string
+  stripeNotConfigured: string
+  validationFailed: string
+  cardDeclined: string
+  insufficientFunds: string
+  expiredCard: string
+  incorrectCvc: string
+  incorrectCardNumber: string
+  invalidExpiry: string
+  authenticationRequired: string
+  processingError: string
+  rateLimited: string
+  paymentExpired: string
+  amountMismatch: string
+  networkError: string
+  cartAlreadyCompleted: string
+  outOfStock: string
+  invalidRegion: string
+  shippingMethodMissing: string
+}
+
+export type GiftCardErrorCopy = {
+  invalidGiftCard: string
+  rateLimited: string
+  cartCompleted: string
+  cartNotFound: string
+  validationFailed: string
+  generic: string
+}
+
+export type PromotionErrorCopy = {
+  generic: string
+  needsEmail: string
+  exhausted: string
+  promotionNotFound: string
+  promotionInactive: string
+  promotionMisconfigured: string
+  promotionUnsupportedType: string
+  cartCompleted: string
+  cartNotFound: string
+  validationFailed: string
 }
 
 export const defaultCheckoutLabels: CheckoutLabels = {
@@ -260,4 +364,118 @@ export const defaultCheckoutLabels: CheckoutLabels = {
     "BoxNow is temporarily unavailable, please choose a different shipping method.",
   boxnowNoLockersInCity:
     "No BoxNow lockers found in your city. Please choose a different shipping method.",
+  addressErrors: {
+    generic:
+      "We could not save your address. Please check the details and try again.",
+    network:
+      "We cannot reach the server. Please check your connection and try again.",
+    validationFailed:
+      "One of the fields is not valid. Please check the details and try again.",
+    invalidRegion: "That country is not valid. Please reload the page.",
+    regionRequired: "The delivery region is not valid. Please reload the page.",
+    cartCompleted:
+      "This order is already placed. Please check your email for the confirmation.",
+    cartNotFound: "Your cart session expired. Please reload the page.",
+    invalidEmail: "That email address is not valid. Please check the spelling.",
+    // NOT "four digits": the postcode length is the country's business, and
+    // the Bulgarian original said four, which is wrong everywhere else.
+    invalidPostalCode: "That postal code is not valid. Please check it.",
+    invalidPhone: "That phone number is not valid. Please check the digits.",
+    invalidCountry: "That country is not valid. Please reload the page.",
+  },
+  paymentErrors: {
+    genericCard:
+      "The payment could not be processed right now. Try again or choose another payment method.",
+    genericCod: "The order could not be placed right now. Try again in a moment.",
+    cartEmailRequired:
+      "An email address is needed to place the order. Add one to continue.",
+    cartEmpty: "Your cart is empty. Add a product to continue.",
+    shippingAddressRequired:
+      "A delivery address is needed to place the order. Add one to continue.",
+    shippingMethodRequired: "Choose a delivery method to continue.",
+    paymentCollectionRequired: "The payment is not ready yet. Try again.",
+    paymentSessionRequired: "The payment is not ready yet. Try again.",
+    insufficientInventory:
+      "One of the products is no longer available in the quantity you chose. Update your cart to continue.",
+    checkoutMethodHidden:
+      "The method you chose is no longer available for this order. Choose another one and try again.",
+    requiresAction:
+      "Your bank needs to confirm this payment. Follow the steps it shows to continue.",
+    paymentNotAuthorized:
+      "The payment was not approved. Try again or choose another payment method.",
+    paymentNotInitiated:
+      "The payment expired before it went through. Reload the page and try again.",
+    paymentIncomplete:
+      "Your gift cards no longer cover the full amount. Choose a payment method for the rest.",
+    giftCardInsufficientBalance:
+      "The balance on that gift card no longer covers the amount. Remove it or choose another payment method.",
+    giftCardNotRedeemable:
+      "That gift card can no longer be used. Remove it and try again.",
+    accountRequired: "This order needs you to be signed in. Sign in to continue.",
+    cartLocked:
+      "This order is being processed right now. Wait a few seconds before trying again.",
+    cartCompleted:
+      "This order has already gone through. Check your email for the confirmation.",
+    cartNotFound: "Your cart is no longer available. Reload the page to start again.",
+    shippingOptionNotFound:
+      "The delivery method you chose is no longer available. Choose another one.",
+    invalidProvider: "The payment method you chose cannot be used. Choose another one.",
+    shippingPriceMissing:
+      "The delivery cost could not be worked out. Choose another delivery method.",
+    stripeNotConfigured:
+      "Card payments are unavailable at the moment. Choose another payment method.",
+    validationFailed: "Some order details are missing. Check the form and try again.",
+    cardDeclined:
+      "That card was declined by the bank. Try another card or contact your bank.",
+    insufficientFunds: "That card does not have enough funds. Try another card.",
+    expiredCard: "That card has expired. Try another card.",
+    incorrectCvc:
+      "The security code does not match. Check the security code on your card and try again.",
+    incorrectCardNumber:
+      "That card number does not look right. Check the digits and try again.",
+    invalidExpiry: "The expiry date does not look right. Check the month and the year.",
+    authenticationRequired:
+      "Your bank needs to confirm this payment. Follow the steps it shows to continue.",
+    processingError: "The card could not be processed. Try again in a moment.",
+    rateLimited:
+      "There have been too many payment attempts. Wait a few minutes and try again.",
+    paymentExpired:
+      "The payment expired before it went through. Reload the page and try again.",
+    amountMismatch: "The order total changed. Reload the page and try again.",
+    networkError:
+      "The connection was lost. Check your internet connection and try again.",
+    cartAlreadyCompleted:
+      "This order has already gone through. Check your email for the confirmation.",
+    outOfStock:
+      "One of the products is no longer available in the quantity you chose. Update your cart to continue.",
+    invalidRegion:
+      "This delivery destination is not available. Reload the page and try again.",
+    shippingMethodMissing: "Choose a delivery method to continue.",
+  },
+  giftCardErrors: {
+    invalidGiftCard: "That gift card code is not valid. Check the code and try again.",
+    rateLimited: "Too many attempts. Wait a few minutes and try again.",
+    cartCompleted:
+      "This order is already placed. Check your email for the confirmation.",
+    cartNotFound: "Your cart timed out. Reload the page and try again.",
+    validationFailed: "That code is not valid. Check it and try again.",
+    generic: "The gift card could not be applied right now. Try again in a moment.",
+  },
+  promotionErrors: {
+    generic:
+      "This discount code can't be applied right now. Check the code and try again.",
+    needsEmail:
+      "This discount code needs an email address. Add yours above and try again.",
+    exhausted: "This promotion has been fully used and is no longer available.",
+    promotionNotFound: "This discount code isn't valid. Check it and try again.",
+    promotionInactive: "This discount code is no longer active.",
+    promotionMisconfigured:
+      "This discount code can't be applied right now. Check the code and try again.",
+    promotionUnsupportedType:
+      "This discount code can't be applied right now. Check the code and try again.",
+    cartCompleted:
+      "This order has already been placed. Check your email for the confirmation.",
+    cartNotFound: "We couldn't find your cart. Reload the page and try again.",
+    validationFailed: "This discount code isn't valid. Check it and try again.",
+  },
 }

package/src/checkout/line-item-card.tsx

@@ -4,14 +4,14 @@ import { useState } from "react"
 
 import type { StorefrontClient } from "../api/http"
 import { updateLineItem, type Cart, type CartLineItem } from "../api/carts"
-import { DualPrice } from "../lib/dual-price"
+import { Price } from "../lib/price"
 import { cn } from "../lib/utils"
 import { useCheckoutLabels } from "./context"
 
 /**
  * LineItemCard — a single cart line shown inside the checkout order
  * summary card. Includes thumbnail, title, variant, quantity select,
- * and dual-currency price.
+ * and price.
  *
  * Ported from `@1click/ui/src/checkout/line-item-card.tsx` (v2.3.1) with
  * the Cartbase data seam: the cookie-bound `updateLineItem` server action →
@@ -141,7 +141,7 @@ export function LineItemCard({
       </div>
 
       <div className="flex flex-col items-end justify-center flex-shrink-0">
-        <DualPrice
+        <Price
           amount={total}
           currencyCode={currencyCode}
           className="text-sm font-bold text-foreground"

package/src/checkout/order-summary.tsx

@@ -4,7 +4,7 @@ import { useEffect, useMemo, useState } from "react"
 
 import type { StorefrontClient } from "../api/http"
 import { updateLineItem, type Cart, type CartLineItem } from "../api/carts"
-import { DualPrice } from "../lib/dual-price"
+import { Price } from "../lib/price"
 import { isProductLine } from "../lib/cart-helpers"
 import { cn } from "../lib/utils"
 import { useCheckoutLabels } from "./context"
@@ -170,7 +170,7 @@ export function CheckoutLineItem({
       <div className="hidden sm:flex flex-1 min-w-0 flex-col gap-2.5">
         <div className="flex items-baseline justify-between gap-3">
           {titleBlock}
-          <DualPrice
+          <Price
             amount={item.total ?? 0}
             currencyCode={currencyCode}
             className="text-sm font-bold text-foreground text-right flex-shrink-0"
@@ -185,7 +185,7 @@ export function CheckoutLineItem({
         {titleBlock}
         <div className="flex items-center justify-between gap-3">
           {qtyPill}
-          <DualPrice
+          <Price
             amount={item.total ?? 0}
             currencyCode={currencyCode}
             className="text-sm font-bold text-foreground text-right"
@@ -376,7 +376,7 @@ export function OrderSummary({
         <div className="px-5 sm:px-6 space-y-3">
           <div className="flex justify-between text-sm">
             <span className="text-muted-foreground">{labels.subtotal}</span>
-            <DualPrice
+            <Price
               amount={productSubtotal}
               currencyCode={cart.currency_code}
               className="font-medium text-foreground"
@@ -391,7 +391,7 @@ export function OrderSummary({
                   {labels.shippingFree}
                 </span>
               ) : (
-                <DualPrice
+                <Price
                   amount={shippingCost ?? 0}
                   currencyCode={cart.currency_code}
                   className="font-medium text-foreground"
@@ -409,7 +409,7 @@ export function OrderSummary({
               <span className="text-muted-foreground">
                 {methodFeeLabel ?? cart.payment_method_fee_label ?? labels.paymentMethodFee}
               </span>
-              <DualPrice
+              <Price
                 amount={methodFeeAmount}
                 currencyCode={cart.currency_code}
                 className="font-medium text-foreground"
@@ -422,7 +422,7 @@ export function OrderSummary({
               <span>{labels.discount}</span>
               <span className="font-medium">
                 -
-                <DualPrice
+                <Price
                   amount={cart.discount_total}
                   currencyCode={cart.currency_code}
                 />
@@ -450,7 +450,7 @@ export function OrderSummary({
                 {labels.taxTooltip}
               </span>
             </span>
-            <DualPrice
+            <Price
               amount={cart.tax_total ?? 0}
               currencyCode={cart.currency_code}
               className="font-medium text-foreground"
@@ -464,11 +464,10 @@ export function OrderSummary({
               {labels.total}
             </span>
             <div className="text-right">
-              <DualPrice
+              <Price
                 amount={displayTotal ?? 0}
                 currencyCode={cart.currency_code}
                 className="text-2xl font-bold text-foreground tracking-tight"
-                bgnClassName="ml-2 text-sm text-muted-foreground/70 font-normal"
               />
             </div>
           </div>
@@ -482,7 +481,7 @@ export function OrderSummary({
                 <span>{labels.giftCardApplied}</span>
                 <span className="font-medium">
                   -
-                  <DualPrice
+                  <Price
                     amount={giftCardTotal}
                     currencyCode={cart.currency_code}
                   />
@@ -492,7 +491,7 @@ export function OrderSummary({
                 <span className="text-muted-foreground">
                   {labels.giftCardRemaining}
                 </span>
-                <DualPrice
+                <Price
                   amount={giftCardRemainder}
                   currencyCode={cart.currency_code}
                   className="font-semibold text-foreground"