@vtex/faststore 0.0.8 → 0.0.10

package/dist/schema.graphql

@@ -503,6 +503,36 @@ extend type Query {
   ): CustomerOrdersConnection! @cacheControl(maxAge: 0, scope: PRIVATE)
 }
 
+extend type Query {
+  """
+  The signed-in shopper's own saved cards. Takes no id — the identity comes from
+  the session. Resolves to the shopper's entity, with an empty list when no card
+  is saved. Null only when the read fails, alongside an UNAUTHORIZED,
+  UPSTREAM_ERROR, or UPSTREAM_TIMEOUT error at this path (ADR-00007), so the
+  failure does not null the rest of the operation.
+  """
+  customerSavedCards: CustomerSavedCards
+}
+
+extend type Query {
+  """
+  The credit-card networks the store accepts on the request's sales channel,
+  with their validation rules, for adding a saved card. Requires a signed-in
+  shopper. Null when the read fails, alongside an UNAUTHORIZED, UPSTREAM_ERROR,
+  UPSTREAM_TIMEOUT, or NO_CARD_NETWORKS error at this path (ADR-00007).
+  NO_CARD_NETWORKS means the store accepts no credit-card network on this
+  sales channel; the list is never empty.
+  """
+  savedCardNetworks: [CardNetworkRule!]
+  """
+  The signed-in shopper's saved addresses a new card can be billed to, in the
+  platform's order. Takes no id. Empty when none is saved. Null only when the
+  read fails, alongside an UNAUTHORIZED, UPSTREAM_ERROR, or UPSTREAM_TIMEOUT
+  error at this path.
+  """
+  customerSavedCardBillingAddresses: [CardBillingAddress!]
+}
+
 """
 Root mutation type. Cart and checkout operations are declared via
 `extend type Mutation` in the checkout module.
@@ -526,14 +556,14 @@ extend type Mutation {
     """Item details to add."""
     input: CartItemAddInput!
   ): CartItemAddPayload!
-  """Remove an item from the cart entirely (sets quantity to 0)."""
+  """Remove a line from the cart entirely (sets quantity to 0)."""
   cartItemRemove(
     """Item to remove."""
     input: CartItemRemoveInput!
   ): CartItemRemovePayload!
   """
   Remove multiple items from the cart in a single upstream write (each line's
-  quantity is set to 0). Tolerant: variants absent from the cart are skipped.
+  quantity is set to 0). Tolerant: lines absent from the cart are skipped.
   """
   cartItemsRemove(
     """Items to remove."""
@@ -577,6 +607,15 @@ extend type Mutation {
   context and is never created.
   """
   cartValidate: CartValidatePayload!
+  """
+  Move the active cart onto the request's sales channel, then reconcile its locale. Takes no
+  arguments: the cart is resolved from the request context and is never created. An empty cart, or
+  a cart already on the active channel, does not send `sc`. Otherwise one POST to `items/update`
+  with `sc` re-sends every item's index and current quantity, so Checkout reprocesses that order
+  form and drops lines the destination cannot sell. An upstream failure is reported in `userErrors`
+  and does not throw.
+  """
+  cartSalesChannelSync: CartSalesChannelSyncPayload!
 }
 
 extend type Mutation {
@@ -743,6 +782,18 @@ extend type Mutation {
   ): CustomerOrderCancelPayload!
 }
 
+extend type Mutation {
+  """
+  Removes one of the signed-in shopper's saved cards, by the id the
+  customerSavedCards read returned. Returns the refreshed list on success.
+  Throws UNAUTHORIZED / UPSTREAM_ERROR / UPSTREAM_TIMEOUT (ADR-00007).
+  """
+  customerSavedCardRemove(
+    """The card's id, as customerSavedCards returned it."""
+    id: ID!
+  ): CustomerSavedCardRemovePayload!
+}
+
 """
 A manufacturer or designer brand.
 Maps to VTEX Brand entity.
@@ -1804,10 +1855,10 @@ type Cart implements Node @cacheControl(maxAge: 0, scope: PRIVATE) {
   freeShippingProgress: FreeShippingProgress
   """
   Non-null when the cart belongs to a different sales channel than the request's active context. The
-  cart is left exactly as it was: nothing here reprices it or removes an item. Converging it is a
-  write, and the first write that carries the active channel makes Checkout reprocess the same
-  orderForm — prices, promotions, coupons and logistics are recomputed and items not sellable in the
-  destination channel are removed by Checkout, while orderFormId, attachments and addresses survive.
+  cart is left exactly as it was: nothing here reprices it or removes an item. Converging it is the
+  `cartSalesChannelSync` write, and that write makes Checkout reprocess the same orderForm — prices,
+  promotions, coupons and logistics are recomputed and items not sellable in the destination channel
+  are removed by Checkout, while orderFormId, attachments and addresses survive.
   """
   salesChannelMismatch: CartSalesChannelMismatch
 }
@@ -2212,30 +2263,32 @@ input CartItemAddInput {
   seller: ID = "U2VsbGVyOjE="
 }
 
-"""Input for removing an item from a cart."""
+"""Input for removing a line from a cart."""
 input CartItemRemoveInput {
-  """The variant's global Node ID to remove."""
-  variantId: ID!
+  """The line to remove: its `CartItem.lineId`."""
+  lineId: String!
 }
 
-"""Input for removing multiple items from a cart in one call."""
+"""Input for removing multiple lines from a cart in one call."""
 input CartItemsRemoveInput {
-  """The variants' global Node IDs to remove. Duplicates are collapsed."""
-  variantIds: [ID!]!
+  """
+  The lines to remove: their `CartItem.lineId` values. Duplicates are collapsed.
+  """
+  lineIds: [String!]!
 }
 
-"""Input for increasing the quantity of a cart item."""
+"""Input for increasing the quantity of a cart line."""
 input CartItemQuantityIncreaseInput {
-  """The variant's global Node ID whose quantity to increase."""
-  variantId: ID!
+  """The line whose quantity to increase: its `CartItem.lineId`."""
+  lineId: String!
   """Amount to add to the current quantity. Defaults to 1."""
   quantityToAdd: Int = 1
 }
 
-"""Input for decreasing the quantity of a cart item."""
+"""Input for decreasing the quantity of a cart line."""
 input CartItemQuantityDecreaseInput {
-  """The variant's global Node ID whose quantity to decrease."""
-  variantId: ID!
+  """The line whose quantity to decrease: its `CartItem.lineId`."""
+  lineId: String!
   """Amount to subtract from the current quantity. Defaults to 1."""
   quantityToRemove: Int = 1
 }
@@ -2270,26 +2323,24 @@ enum CartItemAddErrorCode {
 enum CartItemRemoveErrorCode {
   """No cart context was provided (x-order-form-id header/cookie)."""
   MISSING_CART_CONTEXT
-  """The specified variant was not found in the cart."""
+  """The specified line was not found in the cart."""
   ITEM_NOT_FOUND
   """The cart was not found."""
   CART_NOT_FOUND
-  """The provided variant ID is not a valid Variant Node ID."""
-  INVALID_VARIANT_ID
+  """The upstream checkout API returned an unusable response."""
+  UPSTREAM_ERROR
 }
 
 """Error codes for cart items batch remove operations."""
 enum CartItemsRemoveErrorCode {
   """No cart context was provided (x-order-form-id header/cookie)."""
   MISSING_CART_CONTEXT
-  """None of the specified variants were found in the cart."""
+  """None of the specified lines were found in the cart."""
   ITEM_NOT_FOUND
   """The cart was not found."""
   CART_NOT_FOUND
-  """A provided variant ID is not a valid Variant Node ID."""
-  INVALID_VARIANT_ID
-  """The input contained no variant IDs."""
-  NO_VARIANT_IDS_PROVIDED
+  """The input contained no line IDs."""
+  NO_LINE_IDS_PROVIDED
   """The upstream checkout API returned an unusable response."""
   UPSTREAM_ERROR
 }
@@ -2300,12 +2351,12 @@ enum CartItemQuantityIncreaseErrorCode {
   MISSING_CART_CONTEXT
   """The quantity must be a positive integer."""
   INVALID_QUANTITY
-  """The specified variant was not found in the cart."""
+  """The specified line was not found in the cart."""
   ITEM_NOT_FOUND
   """The cart was not found."""
   CART_NOT_FOUND
-  """The provided variant ID is not a valid Variant Node ID."""
-  INVALID_VARIANT_ID
+  """The upstream checkout API returned an unusable response."""
+  UPSTREAM_ERROR
 }
 
 """Error codes for cart item quantity decrease operations."""
@@ -2314,12 +2365,12 @@ enum CartItemQuantityDecreaseErrorCode {
   MISSING_CART_CONTEXT
   """The quantity must be a positive integer."""
   INVALID_QUANTITY
-  """The specified variant was not found in the cart."""
+  """The specified line was not found in the cart."""
   ITEM_NOT_FOUND
   """The cart was not found."""
   CART_NOT_FOUND
-  """The provided variant ID is not a valid Variant Node ID."""
-  INVALID_VARIANT_ID
+  """The upstream checkout API returned an unusable response."""
+  UPSTREAM_ERROR
 }
 
 """A domain error returned from a cart item add mutation."""
@@ -2412,6 +2463,11 @@ enum CartCouponApplyErrorCode {
   COUPON_NOT_FOUND
   """The coupon code has expired."""
   COUPON_EXPIRED
+  """
+  The code was rejected while another coupon was applied, and the applied coupons were kept. The
+  platform does not say whether the code is unknown or cannot be combined with them.
+  """
+  COUPON_NOT_COMBINED
 }
 
 """Error codes for cart coupon remove operations."""
@@ -2488,6 +2544,44 @@ type CartValidatePayload {
   userErrors: [CartValidateError!]!
 }
 
+"""Error codes for moving a cart onto the active sales channel."""
+enum CartSalesChannelSyncErrorCode {
+  """No cart context was provided (x-order-form-id header/cookie)."""
+  MISSING_CART_CONTEXT
+  """The cart was not found."""
+  CART_NOT_FOUND
+  """
+  The upstream checkout API could not be reached or returned an unusable response.
+  """
+  UPSTREAM_ERROR
+}
+
+"""A domain error returned from the cartSalesChannelSync mutation."""
+type CartSalesChannelSyncError {
+  """Machine-readable error code."""
+  code: CartSalesChannelSyncErrorCode!
+  """Human-readable error message."""
+  message: String!
+}
+
+"""
+Payload returned by the cartSalesChannelSync mutation.
+
+The cart comes from the request context and is never created. An empty cart, or a cart already on
+the active sales channel, does not send `sc`. Otherwise one POST to `items/update` with `sc`
+re-sends every item's index and current quantity, so Checkout reprocesses that order form and drops
+lines the destination cannot sell, and then the locale is reconciled. An upstream failure is
+reported in `userErrors` and does not throw.
+"""
+type CartSalesChannelSyncPayload {
+  """
+  The cart after the channel move and locale reconciliation, or null if errors occurred.
+  """
+  cart: Cart
+  """Domain errors that occurred during the operation."""
+  userErrors: [CartSalesChannelSyncError!]!
+}
+
 """The delivery channel for a shipping option."""
 enum DeliveryChannel {
   """Home delivery."""
@@ -2883,8 +2977,10 @@ input ShippingAddressUpdateInput {
   Saved address reference. Present when the shopper picked (and possibly edited) a saved address.
   """
   savedAddressId: ID
-  """Recipient name for the delivery address."""
-  recipientName: String!
+  """
+  Recipient name for the delivery address. Omit it for a destination-only write: the cart keeps its current recipient name. A blank string is rejected with MISSING_RECIPIENT_NAME.
+  """
+  recipientName: String
   """Postal code for the delivery address."""
   postalCode: String!
   """ISO 3166-1 alpha-3 country code (e.g. "BRA")."""
@@ -4675,3 +4771,171 @@ type CustomerOrderCancelPayload {
   """Typed, expected failures. Empty on success."""
   userErrors: [CustomerOrderCancelError!]!
 }
+
+"""
+The signed-in shopper's saved cards, read from their persistent checkout
+profile. Never cart-scoped.
+"""
+type CustomerSavedCards @cacheControl(maxAge: 0, scope: PRIVATE) {
+  """
+  Stable identity for cache normalization. Not a Relay Node ID: derived from the
+  session, with no id argument and no Query.node entry.
+  """
+  id: ID!
+  """
+  Every card the shopper saved, in the platform's order, including expired and
+  unusable ones. Empty when none is saved.
+  """
+  cards: [CustomerSavedCard!]!
+}
+
+"""
+One of the shopper's saved cards, as the account sees it. Distinct from the
+cart-scoped SavedCard. Never carries a card number beyond its last four digits,
+a BIN, or a security code.
+"""
+type CustomerSavedCard @cacheControl(maxAge: 0, scope: PRIVATE) {
+  """Opaque, stable cache key. Not a Relay Node ID."""
+  id: ID!
+  """The card network the card belongs to."""
+  network: CardNetwork!
+  """
+  The card number's last four digits. Empty when the platform's record has none.
+  """
+  lastDigits: String!
+  """When the card expires. Null when the platform's record has no date."""
+  expiry: CardExpiry
+  """
+  Whether the card can still be used, derived once here so the UI never re-derives it.
+  """
+  status: CustomerSavedCardStatus!
+}
+
+"""A card network, such as Visa or Mastercard."""
+type CardNetwork {
+  """
+  The platform's payment-system id for the network. Empty when the record has none.
+  """
+  id: String!
+  """
+  Display name of the network (e.g. "Visa"). Falls back to the id when the record has no name.
+  """
+  name: String!
+}
+
+"""A card's expiry month and year."""
+type CardExpiry {
+  """Expiry month, from 1 to 12."""
+  month: Int!
+  """Four-digit expiry year."""
+  year: Int!
+}
+
+"""Whether a saved card can still be used."""
+enum CustomerSavedCardStatus {
+  """The card has not expired and the platform reports nothing against it."""
+  USABLE
+  """
+  The card's expiry date has passed. Wins over any other platform report.
+  """
+  EXPIRED
+  """The card has not expired, but the platform reports it cannot be used."""
+  UNUSABLE
+}
+
+"""
+A card network the store accepts on the request's sales channel, with the
+rules card entry validates a card by. Read from the store's payment systems,
+never from a cart.
+"""
+type CardNetworkRule @cacheControl(maxAge: 0, scope: PRIVATE) {
+  """
+  The network. Its id is the platform's payment-system id, the same id a saved
+  card's network carries.
+  """
+  network: CardNetwork!
+  """
+  Pattern a full card number of this network matches. Null when the store sets none.
+  """
+  numberRegex: String
+  """
+  Display mask for the card number, with 9 standing for a digit. Null when the store sets none.
+  """
+  numberMask: String
+  """Pattern the security code matches. Null when the store sets none."""
+  securityCodeRegex: String
+  """Display mask for the security code. Null when the store sets none."""
+  securityCodeMask: String
+  """Whether the card asks for a security code."""
+  securityCodeRequired: Boolean!
+  """Whether the card asks for an expiry date."""
+  expirationRequired: Boolean!
+  """Whether the card asks for the holder's name."""
+  holderNameRequired: Boolean!
+  """Whether a cardholder document is required for this network."""
+  requiresDocument: Boolean!
+  """
+  Whether a cardholder document field is shown for this network. Distinct from requiresDocument.
+  """
+  displayDocument: Boolean!
+}
+
+"""
+One of the signed-in shopper's saved addresses a new card can be billed to.
+"""
+type CardBillingAddress @cacheControl(maxAge: 0, scope: PRIVATE) {
+  """Opaque, stable cache key. Not a Relay Node ID."""
+  id: ID!
+  """
+  Name of the person the address belongs to. Null when the platform's record has none.
+  """
+  receiverName: String
+  """Street name. Null when the platform's record has none."""
+  street: String
+  """Street number. Null when the platform's record has none."""
+  number: String
+  """
+  Complement, such as an apartment. Null when the platform's record has none.
+  """
+  complement: String
+  """Neighborhood. Null when the platform's record has none."""
+  neighborhood: String
+  """City. Null when the platform's record has none."""
+  city: String
+  """State or province. Null when the platform's record has none."""
+  state: String
+  """Postal code. Null when the platform's record has none."""
+  postalCode: String
+  """
+  Country of the address, as the platform stores it (ISO 3166-1 alpha-3).
+  """
+  country: String!
+}
+
+"""Payload returned by customerSavedCardRemove."""
+type CustomerSavedCardRemovePayload {
+  """
+  The shopper's saved cards after the removal. Null when userErrors is non-empty.
+  """
+  customerSavedCards: CustomerSavedCards
+  """Domain errors that stopped the removal. Empty on success."""
+  userErrors: [CustomerSavedCardRemoveError!]!
+}
+
+"""A domain error returned by customerSavedCardRemove."""
+type CustomerSavedCardRemoveError {
+  """Machine-readable error code."""
+  code: CustomerSavedCardRemoveErrorCode!
+  """Human-readable error message."""
+  message: String!
+}
+
+"""Why a saved card was not removed."""
+enum CustomerSavedCardRemoveErrorCode {
+  """The id names no saved card of the signed-in shopper."""
+  CARD_NOT_FOUND
+  """
+  The platform refused the removal, or the card is still listed after it.
+  """
+  REMOVAL_REFUSED
+}

package/dist/sdk/actions/index.d.ts

@@ -3,9 +3,11 @@ import { AddressActionProvider, AddressActionProviderProps } from "./address-act
 import { AnalyticsActionProvider, AnalyticsActionProviderProps } from "./analytics-action-provider.js";
 import { CartActionProvider, CartActionProviderProps } from "./cart-action-provider.js";
 import { IdentityActionProvider, IdentityActionProviderProps } from "./identity-action-provider.js";
+import { LocaleActionProvider, LocaleActionProviderProps } from "./locale-action-provider.js";
 import { OrderActionProvider, OrderActionProviderProps } from "./order-action-provider.js";
 import { PaymentActionProvider, PaymentActionProviderProps } from "./payment-action-provider.js";
 import { RegionActionProvider, RegionActionProviderProps } from "./region-action-provider.js";
+import { SavedCardActionProvider, SavedCardActionProviderProps } from "./saved-card-action-provider.js";
 import { SessionActionProvider, SessionActionProviderProps } from "./session-action-provider.js";
 import { ShippingActionProvider, ShippingActionProviderProps } from "./shipping-action-provider.js";
-export { AddressActionProvider, type AddressActionProviderProps, AnalyticsActionProvider, type AnalyticsActionProviderProps, CartActionProvider, type CartActionProviderProps, IdentityActionProvider, type IdentityActionProviderProps, OrderActionProvider, type OrderActionProviderProps, PaymentActionProvider, type PaymentActionProviderProps, RegionActionProvider, type RegionActionProviderProps, SessionActionProvider, type SessionActionProviderProps, ShippingActionProvider, type ShippingActionProviderProps };
+export { AddressActionProvider, type AddressActionProviderProps, AnalyticsActionProvider, type AnalyticsActionProviderProps, CartActionProvider, type CartActionProviderProps, IdentityActionProvider, type IdentityActionProviderProps, LocaleActionProvider, type LocaleActionProviderProps, OrderActionProvider, type OrderActionProviderProps, PaymentActionProvider, type PaymentActionProviderProps, RegionActionProvider, type RegionActionProviderProps, SavedCardActionProvider, type SavedCardActionProviderProps, SessionActionProvider, type SessionActionProviderProps, ShippingActionProvider, type ShippingActionProviderProps };

package/dist/sdk/actions/index.js

@@ -2,9 +2,11 @@ import { AddressActionProvider } from "./address-action-provider.js";
 import { AnalyticsActionProvider } from "./analytics-action-provider.js";
 import { CartActionProvider } from "./cart-action-provider.js";
 import { IdentityActionProvider } from "./identity-action-provider.js";
+import { LocaleActionProvider } from "./locale-action-provider.js";
 import { OrderActionProvider } from "./order-action-provider.js";
 import { PaymentActionProvider } from "./payment-action-provider.js";
 import { RegionActionProvider } from "./region-action-provider.js";
+import { SavedCardActionProvider } from "./saved-card-action-provider.js";
 import { SessionActionProvider } from "./session-action-provider.js";
 import { ShippingActionProvider } from "./shipping-action-provider.js";
-export { AddressActionProvider, AnalyticsActionProvider, CartActionProvider, IdentityActionProvider, OrderActionProvider, PaymentActionProvider, RegionActionProvider, SessionActionProvider, ShippingActionProvider };
+export { AddressActionProvider, AnalyticsActionProvider, CartActionProvider, IdentityActionProvider, LocaleActionProvider, OrderActionProvider, PaymentActionProvider, RegionActionProvider, SavedCardActionProvider, SessionActionProvider, ShippingActionProvider };

package/dist/sdk/actions/locale-action-provider.d.ts

@@ -0,0 +1,16 @@
+import { ActionProviderProps } from "./inject-actions.js";
+import { ReactNode } from "react";
+//#region src/sdk/actions/locale-action-provider.d.ts
+export type LocaleActionProviderProps = ActionProviderProps;
+/**
+ * Compiler-emitted runtime wrapper for the `locale` action namespace — a line-for-line mirror of
+ * `RegionActionProvider`. The compiler wraps every element whose definition declares
+ * `actions: { locale: [...] }` with `<LocaleActionProvider methods={[...]}>`, calls `useLocaleActions`
+ * once, narrows the surface to the declared `methods`, and publishes it through
+ * `ActionsOverrideContext` (merging with any outer namespace provider) for `useActionsOverride` to
+ * read further down. A namespace a component does not declare is never wrapped, so its hook is never
+ * called.
+ */
+export declare function LocaleActionProvider(props: LocaleActionProviderProps): ReactNode;
+//#endregion
+//# sourceMappingURL=locale-action-provider.d.ts.map

package/dist/sdk/actions/locale-action-provider.js

@@ -0,0 +1,20 @@
+"use client";
+import { useInjectActions } from "./inject-actions.js";
+import { useLocaleActions } from "../locale/use-locale-actions.js";
+//#region src/sdk/actions/locale-action-provider.tsx
+/**
+* Compiler-emitted runtime wrapper for the `locale` action namespace — a line-for-line mirror of
+* `RegionActionProvider`. The compiler wraps every element whose definition declares
+* `actions: { locale: [...] }` with `<LocaleActionProvider methods={[...]}>`, calls `useLocaleActions`
+* once, narrows the surface to the declared `methods`, and publishes it through
+* `ActionsOverrideContext` (merging with any outer namespace provider) for `useActionsOverride` to
+* read further down. A namespace a component does not declare is never wrapped, so its hook is never
+* called.
+*/
+function LocaleActionProvider(props) {
+	return useInjectActions("locale", useLocaleActions(), props);
+}
+//#endregion
+export { LocaleActionProvider };
+
+//# sourceMappingURL=locale-action-provider.js.map

package/dist/sdk/actions/locale-action-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-action-provider.js","names":[],"sources":["../../../src/sdk/actions/locale-action-provider.tsx"],"sourcesContent":["'use client';\n\nimport type { ReactNode } from 'react';\nimport { useLocaleActions } from '../locale/use-locale-actions.js';\nimport { type ActionProviderProps, useInjectActions } from './inject-actions.js';\n\nexport type LocaleActionProviderProps = ActionProviderProps;\n\n/**\n * Compiler-emitted runtime wrapper for the `locale` action namespace — a line-for-line mirror of\n * `RegionActionProvider`. The compiler wraps every element whose definition declares\n * `actions: { locale: [...] }` with `<LocaleActionProvider methods={[...]}>`, calls `useLocaleActions`\n * once, narrows the surface to the declared `methods`, and publishes it through\n * `ActionsOverrideContext` (merging with any outer namespace provider) for `useActionsOverride` to\n * read further down. A namespace a component does not declare is never wrapped, so its hook is never\n * called.\n */\nexport function LocaleActionProvider(props: LocaleActionProviderProps): ReactNode {\n  return useInjectActions('locale', useLocaleActions(), props);\n}\n"],"mappings":";;;;;;;;;;;;;AAiBA,SAAgB,qBAAqB,OAA6C;CAChF,OAAO,iBAAiB,UAAU,iBAAiB,GAAG,KAAK;AAC7D"}

package/dist/sdk/actions/saved-card-action-provider.d.ts

@@ -0,0 +1,12 @@
+import { ActionProviderProps } from "./inject-actions.js";
+import { ReactNode } from "react";
+//#region src/sdk/actions/saved-card-action-provider.d.ts
+export type SavedCardActionProviderProps = ActionProviderProps;
+/**
+ * Compiler-emitted runtime wrapper for the `savedCard` action namespace, structurally identical to
+ * `IdentityActionProvider`: calls `useSavedCardActions` once, narrows it to the declared `methods`,
+ * and publishes it through `ActionsOverrideContext`.
+ */
+export declare function SavedCardActionProvider(props: SavedCardActionProviderProps): ReactNode;
+//#endregion
+//# sourceMappingURL=saved-card-action-provider.d.ts.map

package/dist/sdk/actions/saved-card-action-provider.js

@@ -0,0 +1,16 @@
+"use client";
+import { useInjectActions } from "./inject-actions.js";
+import { useSavedCardActions } from "../saved-cards/use-saved-card-actions.js";
+//#region src/sdk/actions/saved-card-action-provider.tsx
+/**
+* Compiler-emitted runtime wrapper for the `savedCard` action namespace, structurally identical to
+* `IdentityActionProvider`: calls `useSavedCardActions` once, narrows it to the declared `methods`,
+* and publishes it through `ActionsOverrideContext`.
+*/
+function SavedCardActionProvider(props) {
+	return useInjectActions("savedCard", useSavedCardActions(), props);
+}
+//#endregion
+export { SavedCardActionProvider };
+
+//# sourceMappingURL=saved-card-action-provider.js.map

package/dist/sdk/actions/saved-card-action-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"saved-card-action-provider.js","names":[],"sources":["../../../src/sdk/actions/saved-card-action-provider.tsx"],"sourcesContent":["'use client';\n\nimport type { ReactNode } from 'react';\nimport { useSavedCardActions } from '../saved-cards/use-saved-card-actions.js';\nimport { type ActionProviderProps, useInjectActions } from './inject-actions.js';\n\nexport type SavedCardActionProviderProps = ActionProviderProps;\n\n/**\n * Compiler-emitted runtime wrapper for the `savedCard` action namespace, structurally identical to\n * `IdentityActionProvider`: calls `useSavedCardActions` once, narrows it to the declared `methods`,\n * and publishes it through `ActionsOverrideContext`.\n */\nexport function SavedCardActionProvider(props: SavedCardActionProviderProps): ReactNode {\n  return useInjectActions('savedCard', useSavedCardActions(), props);\n}\n"],"mappings":";;;;;;;;;AAaA,SAAgB,wBAAwB,OAAgD;CACtF,OAAO,iBAAiB,aAAa,oBAAoB,GAAG,KAAK;AACnE"}

package/dist/sdk/actions/types.d.ts

@@ -2,26 +2,30 @@ import { AddressActions } from "../address/use-address-actions.js";
 import { AnalyticsActions } from "../analytics/use-analytics-actions.js";
 import { CartActions } from "../cart/use-cart-actions.js";
 import { IdentityActions } from "../identity/use-identity-actions.js";
+import { LocaleActions } from "../locale/use-locale-actions.js";
 import { OrderActions } from "../orders/use-order-actions.js";
 import { PaymentActions } from "../payment/use-payment-actions.js";
 import { RegionActions } from "../region/use-region-actions.js";
+import { SavedCardActions } from "../saved-cards/use-saved-card-actions.js";
 import { SessionActions } from "../session/use-session-actions.js";
 import { ShippingActions } from "../shipping/use-shipping-actions.js";
 //#region src/sdk/actions/types.d.ts
 /**
  * The `$actions` prop the compiler injects (and `mockAction` builds for tests). Each namespace is
  * optional and each method is optional within it, because a component only receives the methods it
- * declared under `actions: { ... }`. Ships the `address`, `analytics`, `cart`, `identity`, `order`,
- * `payment`, `region`, `session`, and `shipping` namespaces.
+ * declared under `actions: { ... }`. Ships the `address`, `analytics`, `cart`, `identity`, `locale`,
+ * `order`, `payment`, `region`, `savedCard`, `session`, and `shipping` namespaces.
  */
 export type ComponentActions = {
   address?: Partial<AddressActions>;
   analytics?: Partial<AnalyticsActions>;
   cart?: Partial<CartActions>;
   identity?: Partial<IdentityActions>;
+  locale?: Partial<LocaleActions>;
   order?: Partial<OrderActions>;
   payment?: Partial<PaymentActions>;
   region?: Partial<RegionActions>;
+  savedCard?: Partial<SavedCardActions>;
   session?: Partial<SessionActions>;
   shipping?: Partial<ShippingActions>;
 };

package/dist/sdk/cache/storefront-cache.js

@@ -32,7 +32,8 @@ const typePolicies = {
 	Shipping: { fields: { savedAddresses: replaceList } },
 	Order: { fields: { totals: replaceList } },
 	SellerOrder: { fields: { totals: replaceList } },
-	OrderItem: { fields: { customizations: replaceList } }
+	OrderItem: { fields: { customizations: replaceList } },
+	CardNetwork: { keyFields: false }
 };
 /**
 * The single source of truth for InMemoryCache configuration. Both the

package/dist/sdk/cache/storefront-cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"storefront-cache.js","names":[],"sources":["../../../src/sdk/cache/storefront-cache.ts"],"sourcesContent":["import { InMemoryCache, type InMemoryCacheConfig, type TypePolicies } from '@apollo/client';\nimport { possibleTypes } from '../generated/fragment-types.js';\n\n/**\n * Per-entity normalization and field-merge rules for the Storefront cache.\n *\n * The cart and the order share three types whose ids neither can scope\n * (docs/features/order-placed/rfc.md, 3.4): a totalizer's id is its category\n * (\"Items\"), which the cart's totalizer line selects by; an address's id is the\n * saved address itself, masked on the order and not on the cart; and a\n * customization's id is the assembly (\"Engraving\"), which two lines of one cart\n * already share. Normalized, one record would overwrite the other, so each is\n * stored inside the record that holds it, and replaced on every write: safe\n * while every fragment selects the same subfields of each.\n *\n * The lists that hold them are the server's whole answer, so each write\n * replaces the list (`merge: false`). Apollo does the same by default, but warns\n * that data may be lost whenever such a list shrinks, as when a discount line\n * leaves the cart's totalizers; a merge by id would keep that stale line.\n *\n * Other domain entries arrive with the particles that need them — see\n * docs/storefront-core/reference-free-particle-model.md § Typed documents and the shared cache.\n */\nconst replaceList = { merge: false } as const;\n\nexport const typePolicies: TypePolicies = {\n  CartTotalizer: { keyFields: false },\n  Address: { keyFields: false },\n  CartItemCustomization: { keyFields: false },\n  Cart: { fields: { totalizers: replaceList } },\n  CartItem: { fields: { customizations: replaceList } },\n  CartItemComposition: { fields: { customizations: replaceList } },\n  Shipping: { fields: { savedAddresses: replaceList } },\n  Order: { fields: { totals: replaceList } },\n  SellerOrder: { fields: { totals: replaceList } },\n  OrderItem: { fields: { customizations: replaceList } },\n};\n\nexport { possibleTypes };\n\n/**\n * The single source of truth for InMemoryCache configuration. Both the\n * server-side `createClient` and the client-side `StorefrontProvider`\n * consume this so SSR and CSR normalize entities identically.\n */\nexport function getCacheConfig(): InMemoryCacheConfig {\n  return {\n    typePolicies,\n    possibleTypes,\n  };\n}\n\n/**\n * The only place an `InMemoryCache` is constructed on the server path.\n * The client-side provider builds its cache from `getCacheConfig()` so the\n * config is shared verbatim without coupling to a specific InMemoryCache\n * subclass (the Next.js integration ships its own SSR-aware variant).\n */\nexport function buildCache(): InMemoryCache {\n  return new InMemoryCache(getCacheConfig());\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAuBA,MAAM,cAAc,EAAE,OAAO,MAAM;AAEnC,MAAa,eAA6B;CACxC,eAAe,EAAE,WAAW,MAAM;CAClC,SAAS,EAAE,WAAW,MAAM;CAC5B,uBAAuB,EAAE,WAAW,MAAM;CAC1C,MAAM,EAAE,QAAQ,EAAE,YAAY,YAAY,EAAE;CAC5C,UAAU,EAAE,QAAQ,EAAE,gBAAgB,YAAY,EAAE;CACpD,qBAAqB,EAAE,QAAQ,EAAE,gBAAgB,YAAY,EAAE;CAC/D,UAAU,EAAE,QAAQ,EAAE,gBAAgB,YAAY,EAAE;CACpD,OAAO,EAAE,QAAQ,EAAE,QAAQ,YAAY,EAAE;CACzC,aAAa,EAAE,QAAQ,EAAE,QAAQ,YAAY,EAAE;CAC/C,WAAW,EAAE,QAAQ,EAAE,gBAAgB,YAAY,EAAE;AACvD;;;;;;AASA,SAAgB,iBAAsC;CACpD,OAAO;EACL;EACA;CACF;AACF;;;;;;;AAQA,SAAgB,aAA4B;CAC1C,OAAO,IAAI,cAAc,eAAe,CAAC;AAC3C"}
+{"version":3,"file":"storefront-cache.js","names":[],"sources":["../../../src/sdk/cache/storefront-cache.ts"],"sourcesContent":["import { InMemoryCache, type InMemoryCacheConfig, type TypePolicies } from '@apollo/client';\nimport { possibleTypes } from '../generated/fragment-types.js';\n\n/**\n * Per-entity normalization and field-merge rules for the Storefront cache.\n *\n * The cart and the order share three types whose ids neither can scope\n * (docs/features/order-placed/rfc.md, 3.4): a totalizer's id is its category\n * (\"Items\"), which the cart's totalizer line selects by; an address's id is the\n * saved address itself, masked on the order and not on the cart; and a\n * customization's id is the assembly (\"Engraving\"), which two lines of one cart\n * already share. Normalized, one record would overwrite the other, so each is\n * stored inside the record that holds it, and replaced on every write: safe\n * while every fragment selects the same subfields of each.\n *\n * The lists that hold them are the server's whole answer, so each write\n * replaces the list (`merge: false`). Apollo does the same by default, but warns\n * that data may be lost whenever such a list shrinks, as when a discount line\n * leaves the cart's totalizers; a merge by id would keep that stale line.\n *\n * Other domain entries arrive with the particles that need them — see\n * docs/storefront-core/reference-free-particle-model.md § Typed documents and the shared cache.\n */\nconst replaceList = { merge: false } as const;\n\nexport const typePolicies: TypePolicies = {\n  CartTotalizer: { keyFields: false },\n  Address: { keyFields: false },\n  CartItemCustomization: { keyFields: false },\n  Cart: { fields: { totalizers: replaceList } },\n  CartItem: { fields: { customizations: replaceList } },\n  CartItemComposition: { fields: { customizations: replaceList } },\n  Shipping: { fields: { savedAddresses: replaceList } },\n  Order: { fields: { totals: replaceList } },\n  SellerOrder: { fields: { totals: replaceList } },\n  OrderItem: { fields: { customizations: replaceList } },\n  // A card network's id is the platform's payment-system id and is empty when a saved card has none,\n  // so two networks would collide on one entry. Each stays embedded in its own card.\n  CardNetwork: { keyFields: false },\n};\n\nexport { possibleTypes };\n\n/**\n * The single source of truth for InMemoryCache configuration. Both the\n * server-side `createClient` and the client-side `StorefrontProvider`\n * consume this so SSR and CSR normalize entities identically.\n */\nexport function getCacheConfig(): InMemoryCacheConfig {\n  return {\n    typePolicies,\n    possibleTypes,\n  };\n}\n\n/**\n * The only place an `InMemoryCache` is constructed on the server path.\n * The client-side provider builds its cache from `getCacheConfig()` so the\n * config is shared verbatim without coupling to a specific InMemoryCache\n * subclass (the Next.js integration ships its own SSR-aware variant).\n */\nexport function buildCache(): InMemoryCache {\n  return new InMemoryCache(getCacheConfig());\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAuBA,MAAM,cAAc,EAAE,OAAO,MAAM;AAEnC,MAAa,eAA6B;CACxC,eAAe,EAAE,WAAW,MAAM;CAClC,SAAS,EAAE,WAAW,MAAM;CAC5B,uBAAuB,EAAE,WAAW,MAAM;CAC1C,MAAM,EAAE,QAAQ,EAAE,YAAY,YAAY,EAAE;CAC5C,UAAU,EAAE,QAAQ,EAAE,gBAAgB,YAAY,EAAE;CACpD,qBAAqB,EAAE,QAAQ,EAAE,gBAAgB,YAAY,EAAE;CAC/D,UAAU,EAAE,QAAQ,EAAE,gBAAgB,YAAY,EAAE;CACpD,OAAO,EAAE,QAAQ,EAAE,QAAQ,YAAY,EAAE;CACzC,aAAa,EAAE,QAAQ,EAAE,QAAQ,YAAY,EAAE;CAC/C,WAAW,EAAE,QAAQ,EAAE,gBAAgB,YAAY,EAAE;CAGrD,aAAa,EAAE,WAAW,MAAM;AAClC;;;;;;AASA,SAAgB,iBAAsC;CACpD,OAAO;EACL;EACA;CACF;AACF;;;;;;;AAQA,SAAgB,aAA4B;CAC1C,OAAO,IAAI,cAAc,eAAe,CAAC;AAC3C"}

package/dist/sdk/cart/operations.d.ts

@@ -1,4 +1,4 @@
-import { CartFragmentFragment, CartItemFragmentFragment, CartItemQuantityDecreaseMutation, CartItemQuantityIncreaseMutation, CartItemRemoveMutation, MoneyFragmentFragment } from "../generated/graphql.js";
+import { CartFragmentFragment, CartFreeShippingProgressFragmentFragment, CartItemFragmentFragment, CartItemQuantityDecreaseMutation, CartItemQuantityIncreaseMutation, CartItemRemoveMutation, MoneyFragmentFragment } from "../generated/graphql.js";
 import "./operations.js";
 import { TypedDocumentNode } from "@apollo/client";
 //#region src/sdk/cart/operations.d.ts
@@ -20,6 +20,7 @@ export type Money = MoneyFragmentFragment;
 export type CartItemEntity = CartItemFragmentFragment;
 export type CartEntity = CartFragmentFragment;
 export type CartTotalizer = CartFragmentFragment['totalizers'][number];
+export type CartFreeShippingProgress = CartFreeShippingProgressFragmentFragment['freeShippingProgress'];
 export type CartUserError = Readonly<{
   code: string;
   message: string;