@cartbase/storefront 0.9.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.",
+  },
 }