@cartbase/storefront 0.1.2 → 0.3.0

package/src/cart-drawer/template.tsx

@@ -29,7 +29,7 @@ import { isProductLine } from "../lib/cart-helpers"
  * body inside a `<CartDrawer>` shell. That way the store owns its
  * composition and still gets library updates to every primitive.
  *
- * Ported from `@1click/ui/src/cart-drawer/template.tsx` (v2.3.1). Barter
+ * Ported from `@1click/ui/src/cart-drawer/template.tsx` (v2.3.1). Cartbase
  * adaptations:
  * - Amounts are EUR major units — `rewards.pointsPerCurrency` is points
  *   per 1 EUR (the source's `/100` minor-unit division is gone), and
@@ -130,7 +130,7 @@ export function CartDrawerTemplate({
       .finally(() => setCrossSellLoaded(true))
   }, [hasItems, crossSellLoaded, config.crossSell?.loader])
 
-  // Cross-sell add → the provider's SDK addItem (barter adds by variant
+  // Cross-sell add → the provider's SDK addItem (Cartbase adds by variant
   // id). Cards built without a variantId no-op.
   const handleCrossSellAdd = useCallback(
     (_productId: string, variantId?: string) => {

package/src/cart-drawer/tiered-progress.tsx

@@ -11,7 +11,7 @@ import { useCartDrawer } from "./context"
  * originally extracted from mindpages-storefront
  * src/modules/cart-drawer/cart-tiered-progress.tsx.
  *
- * Barter money note: `cart.total` and tier `threshold`s are EUR decimal
+ * Cartbase money note: `cart.total` and tier `threshold`s are EUR decimal
  * major units (e.g. `{ threshold: 50 }` = €50) — configure tiers in major
  * units, not cents.
  */

package/src/checkout/address-error-copy.ts

@@ -3,7 +3,7 @@
  * checkout address surface.
  *
  * Ported from `@1click/ui/src/checkout/address-error-copy.ts` (v2.3.1) and
- * adapted to the barter error envelope: `StoreApiError` carries a structured
+ * adapted to the Cartbase error envelope: `StoreApiError` carries a structured
  * `code` (POST /api/store/carts/:id — docs/storefront/carts.md), so
  * translation is code-first; the substring patterns stay as the fallback for
  * network failures and any legacy wire.
@@ -20,7 +20,7 @@ const NETWORK_FALLBACK =
   "Няма връзка със сървъра. Моля, проверете интернет връзката и опитайте отново."
 
 /**
- * Barter cart-update error codes → BG copy (POST /api/store/carts/:id,
+ * Cartbase cart-update error codes → BG copy (POST /api/store/carts/:id,
  * docs/storefront/carts.md). Code-first, matched before any pattern.
  */
 export const ADDRESS_ERROR_CODE_COPY: Record<string, string> = {
@@ -76,7 +76,7 @@ const PATTERNS: Array<{ match: RegExp; copy: string }> = [
     copy: NETWORK_FALLBACK,
   },
   // The Next.js canned Server Components production message — surface a
-  // clean fallback instead of the English placeholder. (The barter SDK
+  // clean fallback instead of the English placeholder. (The Cartbase SDK
   // throws from the browser, so this only fires for stores that proxy the
   // save through a server action.)
   {

package/src/checkout/address-form.tsx

@@ -17,9 +17,9 @@ import { ErrorMessage } from "./error-message"
  * (`CheckoutClient` / `useCheckoutOrchestration`).
  *
  * Ported from `@1click/ui/src/checkout/address-form.tsx` (v2.3.1) with the
- * barter type seam only: `@medusajs/types` → the SDK's `CustomerAddress` /
+ * Cartbase type seam only: `@medusajs/types` → the SDK's `CustomerAddress` /
  * `CartAddress` partials. The `countries` list comes from the orchestration
- * hook's `regionCountries` — barter regions carry NO embedded countries
+ * hook's `regionCountries` — Cartbase regions carry NO embedded countries
  * array (api/regions.ts divergence), so the host supplies the list via the
  * hook's `countries` option (single-entry `countryCode` fallback).
  */

package/src/checkout/address-select.tsx

@@ -15,7 +15,7 @@ import { useCheckoutLabels } from "./context"
  * replace this one file locally.
  *
  * Ported from `@1click/ui/src/checkout/address-select.tsx` (v2.3.1) with
- * the barter type seam: `@medusajs/types` address DTOs → the SDK's
+ * the Cartbase type seam: `@medusajs/types` address DTOs → the SDK's
  * `CustomerAddress` (GET /api/store/customers/me — addresses embedded,
  * docs/storefront/customers.md) and `CartAddress` partials. Field names are
  * identical across both wires, so the compare/format logic is unchanged.

package/src/checkout/boxnow-locker-selector.tsx

@@ -17,11 +17,11 @@ import { useCheckoutLabels } from "./context"
  * BoxNowLockerSelector — full BoxNow locker picker for Bulgarian shipping.
  *
  * Ported from `@1click/ui/src/checkout/boxnow-locker-selector.tsx` (v2.3.1)
- * with the barter data seam: the locker directory comes from
+ * with the Cartbase data seam: the locker directory comes from
  * `listBoxNowLockers(client)` (`@cartbase/storefront/api/integrations`,
  * GET /api/store/integrations/boxnow/lockers — backend owns BoxNow API auth
  * + the 10-min cache; docs/storefront/integrations.md). The @1click data
- * helper returned `{ok, lockers}`; the barter SDK THROWS on 503 (not
+ * helper returned `{ok, lockers}`; the Cartbase SDK THROWS on 503 (not
  * configured) / 502 (carrier failure), so the fetch wrapper catches and
  * maps both to the same "temporarily unavailable" state. Availability
  * should be discovered via `carriers.boxnow.lockers_url` on the
@@ -38,7 +38,7 @@ import { useCheckoutLabels } from "./context"
  *  - title (not name)
  *  - addressLine1 / addressLine2 (not address.street/num)
  *  - postalCode (not address.city.name)
- *  - lat / lng on the root (numbers or null — the barter route coerces
+ *  - lat / lng on the root (numbers or null — the Cartbase route coerces
  *    malformed carrier coordinates to null, never NaN)
  *  - No isAPS / code / phones
  *

package/src/checkout/checkout-client.tsx

@@ -13,7 +13,6 @@ import { CheckoutShippingMethodList } from "./shipping-method-list"
 import { PaymentWrapper } from "./payment-wrapper"
 import {
   useCheckoutOrchestration,
-  type CheckoutCodConfig,
   type CheckoutLogError,
   type PaymentProviderLike,
 } from "./use-checkout-orchestration"
@@ -27,7 +26,7 @@ import {
  * automatically.
  *
  * Ported from `@1click/ui/src/checkout/checkout-client.tsx` (v2.3.1) with
- * the barter data seam:
+ * the Cartbase data seam:
  *
  *  - Takes the SDK `client` — every server call (address autosave,
  *    prepare-checkout, sync, complete, promo/gift-card apply, quantity
@@ -35,9 +34,9 @@ import {
  *  - The listings arrive as SDK DTOs: `listShippingOptions` /
  *    `listPaymentProviders` (both rule-filtered server-side) — fetch them
  *    in the host and pass down (docs/storefront/checkout.md).
- *  - `codConfig` = the integrations config `cod` block
- *    (`getIntegrationsConfig(client).cod`) — the COD fee prediction is
- *    NEVER hardcoded (docs/storefront/integrations.md).
+ *  - Fee prediction is NEVER hardcoded: the payment listing entries carry
+ *    each method's own `fee_amount`/`fee_label` (the integrations `cod`
+ *    block died 2026-08-11 — any method may carry a fee).
  *  - `onCartChange` closes the loop for summary mutations: the decorated
  *    cart returned by promo/gift-card/quantity calls is handed up so the
  *    host updates its cart state (`router.refresh()` in an RSC app) AND
@@ -55,14 +54,12 @@ type CheckoutClientProps = {
   availableShippingMethods: StoreShippingOption[] | null
   availablePaymentMethods: PaymentProviderLike[] | null
   countryCode: string
-  /** Countries for the address form (barter regions embed none). */
+  /** Countries for the address form (Cartbase regions embed none). */
   countries?: Array<{ iso_2: string; display_name: string }>
   paymentMethodFilter?: (
     methods: PaymentProviderLike[] | null,
     selectedShippingOption: StoreShippingOption | null
   ) => PaymentProviderLike[] | null
-  /** The integrations config `cod` block — drives the optimistic COD fee. */
-  codConfig?: CheckoutCodConfig
   /** Show the gift-card widget in the summary (default true). */
   showGiftCards?: boolean
   logoByFulfillmentOptionId?: Record<string, { src: string; alt: string }>
@@ -81,6 +78,12 @@ type CheckoutClientProps = {
   logError?: CheckoutLogError
   /** Receives every decorated cart returned by a summary mutation. */
   onCartChange?: (cart: Cart) => void
+  /**
+   * Extra payment tabs forwarded to CheckoutPaymentMethodList — the seam
+   * for embedded third-party providers rendered in the same radio-card
+   * style as card/cod. See the prop's JSDoc there.
+   */
+  extraPaymentTabs?: Array<{ id: string; label: string; content: React.ReactNode }>
 }
 
 export function CheckoutClient({
@@ -92,7 +95,6 @@ export function CheckoutClient({
   countryCode,
   countries,
   paymentMethodFilter,
-  codConfig,
   showGiftCards = true,
   logoByFulfillmentOptionId,
   appearance,
@@ -102,6 +104,7 @@ export function CheckoutClient({
   resolveTrackingMetadata,
   logError,
   onCartChange,
+  extraPaymentTabs,
 }: CheckoutClientProps) {
   const o = useCheckoutOrchestration({
     client,
@@ -112,7 +115,6 @@ export function CheckoutClient({
     countryCode,
     countries,
     paymentMethodFilter,
-    codConfig,
     orderConfirmedPath,
     onOrderPlaced,
     resolveTrackingMetadata,
@@ -195,6 +197,7 @@ export function CheckoutClient({
               }
               total={o.optimisticTotal}
               logError={logError}
+              extraTabs={extraPaymentTabs}
             />
           </div>
 
@@ -208,8 +211,8 @@ export function CheckoutClient({
                 onOptimisticShippingClear={() =>
                   o.setOptimisticShippingCost(null)
                 }
-                optimisticCodFee={o.optimisticCodFee}
-                onOptimisticCodFeeClear={() => o.setOptimisticCodFee(null)}
+                optimisticMethodFee={o.optimisticMethodFee}
+                onOptimisticMethodFeeClear={() => o.setOptimisticMethodFee(null)}
                 showGiftCards={showGiftCards}
                 onCartChange={handleCartChange}
               />

package/src/checkout/company-details.tsx

@@ -13,7 +13,7 @@ import { useCheckoutLabels } from "./context"
  * Ported from `@1click/ui/src/checkout/company-details.tsx` (v2.3.1)
  * unchanged — pure form UI; the values ride `formData` and the
  * orchestration hook persists them into `cart.metadata`
- * (company_name/company_vat/company_mol/company_address). Barter upgrade
+ * (company_name/company_vat/company_mol/company_address). Cartbase upgrade
  * over the @1click KNOWN_ISSUES state: the hook ALSO syncs
  * `company_name`/`company_eik` onto the signed-in customer profile
  * (PATCH /api/store/customers/me — first-class columns,

package/src/checkout/compare-addresses.ts

@@ -3,7 +3,7 @@
  * shipping-address fields. Returns true if every field matches.
  *
  * Ported from `@1click/ui/src/data/util/compare-addresses.ts` (v2.3.1)
- * unchanged. Lives in the checkout family because the barter SDK has no
+ * unchanged. Lives in the checkout family because the Cartbase SDK has no
  * data/util layer (the @1click data layer became `@cartbase/storefront/api`).
  * Extra file beyond the pre-declared export list → exported from the
  * family barrel only.

package/src/checkout/discount-section.tsx

@@ -15,16 +15,16 @@ import { translatePromotionError } from "./promotion-error-copy"
  * amount.
  *
  * Ported from `@1click/ui/src/checkout/discount-section.tsx` (v2.3.1) with
- * the barter data seam:
+ * the Cartbase data seam:
  *
  *  - `applyPromotions(codes)` (Medusa js-sdk server action, full-list
  *    replace) → `POST /api/store/carts/:id/promotions {promo_codes}` — the
- *    barter route is ADDITIVE (upserts each code's link, then re-applies),
+ *    Cartbase route is ADDITIVE (upserts each code's link, then re-applies),
  *    so only the NEW code is sent; already-applied codes stay put. The SDK
  *    carts module ships no wrapper for this route yet, so the component
  *    calls it through the client transport with the documented DTO
  *    (verified against src/app/api/store/carts/[id]/promotions/route.ts).
- *  - `cart.promotions` on the barter wire is the raw pivot embed
+ *  - `cart.promotions` on the Cartbase wire is the raw pivot embed
  *    (`[{promotion: {..., application_method}}]`) — unwrapped here, with a
  *    flat-row fallback should the decoration ever flatten it.
  *  - Errors are code-first (`promotion_not_found` / `promotion_inactive` /
@@ -46,7 +46,7 @@ type AppliedPromotion = {
   } | null
 }
 
-/** Unwrap the barter pivot embed; tolerate an already-flat row. */
+/** Unwrap the Cartbase pivot embed; tolerate an already-flat row. */
 function extractPromotions(cart: Cart): AppliedPromotion[] {
   const raw = (cart.promotions ?? []) as Array<Record<string, unknown>>
   return raw
@@ -84,7 +84,7 @@ export function DiscountSection({
     setLoading(true)
     setError("")
     try {
-      // Additive apply — the barter route upserts the new code's link and
+      // Additive apply — the Cartbase route upserts the new code's link and
       // re-applies every cart promotion; already-applied codes stay.
       const { cart: updated } = await applyPromotions(client, cart.id, [code.trim()])
       onCartChange?.(updated)

package/src/checkout/econt-office-selector.tsx

@@ -10,13 +10,13 @@ import { useCheckoutLabels } from "./context"
  * EcontOfficeSelector — full Econt office picker for Bulgarian shipping.
  *
  * Ported from `@1click/ui/src/checkout/econt-office-selector.tsx` (v2.3.1)
- * verbatim — this component has NO barter data seam: the office directory
+ * verbatim — this component has NO Cartbase data seam: the office directory
  * comes straight from Econt's public Nomenclatures endpoint (client-side,
  * cached globally per page load), and the CHOSEN office is handed to the
  * orchestration hook, which writes it into `carrier_metadata` exactly once
  * at Buy click (POST /api/store/carts/:id/prepare-checkout —
  * docs/storefront/checkout.md). The geocode helpers moved into the checkout
- * family (`./geocode`) because the barter lib family doesn't ship one.
+ * family (`./geocode`) because the Cartbase lib family doesn't ship one.
  *
  * Behavior:
  * - On mount, fetches the full Econt offices list from the public Econt

package/src/checkout/gift-card-section.tsx

@@ -15,8 +15,8 @@ import { translateGiftCardError } from "./payment-error-copy"
  * summary card, plus the applied-cards chip list (masked `last4`, per-card
  * coverage, remove).
  *
- * NEW in the barter port (no @1click equivalent — gift-card tender is a
- * barter feature, docs/storefront/gift-cards.md). Built in the
+ * NEW in the Cartbase port (no @1click equivalent — gift-card tender is a
+ * Cartbase feature, docs/storefront/gift-cards.md). Built in the
  * DiscountSection idiom so the two summary widgets read as one family.
  *
  * Contract discipline baked in:

package/src/checkout/index.ts

@@ -45,7 +45,6 @@ export {
   useCheckoutOrchestration,
   resolveOrderConfirmedPath,
   type UseCheckoutOrchestrationOptions,
-  type CheckoutCodConfig,
   type CheckoutLogError,
   type PaymentProviderLike,
 } from "./use-checkout-orchestration"

package/src/checkout/labels-bg.ts

@@ -3,7 +3,7 @@ import type { CheckoutLabels } from "./labels"
 /**
  * Bulgarian translations for the checkout.
  *
- * Ported from `@1click/ui/src/checkout/labels-bg.ts` (v2.3.1) + the barter
+ * Ported from `@1click/ui/src/checkout/labels-bg.ts` (v2.3.1) + the Cartbase
  * gift-card keys. Strings match the originals from mindpages-storefront's
  * checkout-client monolith.
  *
@@ -73,7 +73,7 @@ export const bulgarianCheckoutLabels: CheckoutLabels = {
   discount: "Отстъпка",
   discountCode: "Код за отстъпка",
   discountSub: "Спестете с промо код",
-  codFee: "Такса наложен платеж",
+  paymentMethodFee: "Такса за плащане",
   recommended: "Препоръчано за вас",
   recommendedSoon: "Скоро тук",
   recommendedSoonSub: "Персонализирани предложения за вас",