@putiikkipalvelu/storefront-sdk 0.2.5 → 0.4.0

package/dist/index.d.ts

@@ -419,6 +419,10 @@ interface CartResponse {
     /** Cart ID for guest users (undefined for logged-in users) */
     cartId?: string;
 }
+/**
+ * Reason why a discount code was removed during validation
+ */
+type DiscountRemovalReason = "CAMPAIGN_ACTIVE" | "MIN_ORDER_NOT_MET" | "CODE_INVALID";
 /**
  * Changes detected during cart validation
  */
@@ -429,9 +433,16 @@ interface CartValidationChanges {
     quantityAdjusted: number;
     /** Number of items with changed price */
     priceChanged: number;
+    /** Whether discount code was removed */
+    discountCouponRemoved: boolean;
+    /** Reason why discount was removed (only present if discountCouponRemoved is true) */
+    discountRemovalReason?: DiscountRemovalReason;
 }
 /**
  * Response from GET /cart/validate
+ *
+ * Returns validated cart items and change metadata.
+ * No totals or discount data - those are calculated client-side or fetched separately.
  */
 interface CartValidationResponse {
     /** Validated cart items (with auto-fixed quantities/prices) */
@@ -507,21 +518,6 @@ interface CalculatedCartItem {
     /** Total quantity in cart */
     totalQuantity: number;
 }
-/**
- * Free shipping eligibility status
- */
-interface FreeShippingStatus {
-    /** Whether the cart qualifies for free shipping */
-    isEligible: boolean;
-    /** Minimum spend required for free shipping (in cents) */
-    minimumSpend: number;
-    /** Amount remaining to qualify for free shipping (in cents) */
-    remainingAmount: number;
-    /** Name of the free shipping campaign */
-    campaignName?: string;
-    /** IDs of shipment methods eligible for free shipping (when isEligible is true) */
-    eligibleShipmentMethodIds?: string[];
-}
 /**
  * Result of cart calculation with campaigns applied
  */
@@ -534,21 +530,18 @@ interface CartCalculationResult {
     originalTotal: number;
     /** Total savings from campaigns (in cents) */
     totalSavings: number;
-    /** Free shipping eligibility status */
-    freeShipping: FreeShippingStatus;
 }
 
 /**
  * Shipping Types
  *
  * Types for shipment methods and pickup locations.
- * ShipmentMethod and ShipitShippingMethod are re-exported from storeconfig.
+ * Uses unified response format that works with any provider (Shipit, custom, future integrations).
  */
-
 /**
  * Opening hours for a pickup location
  */
-interface PickupLocationOpeningHours {
+interface OpeningHours {
     monday: string[];
     tuesday: string[];
     wednesday: string[];
@@ -559,57 +552,82 @@ interface PickupLocationOpeningHours {
     exceptions: string[];
 }
 /**
- * A pickup location (parcel locker, pickup point, etc.)
- * Returned from Shipit API with shipmentMethodId and price attached
+ * A home delivery option (works for any provider)
  */
-interface PickupLocation {
-    /** Unique location ID from Shipit */
+interface HomeDeliveryOption {
+    /** ShipmentMethods.id - unique identifier for this method */
     id: string;
-    /** Shipit service ID */
+    /** Display name (e.g., "Posti Kotipaketti") */
+    name: string;
+    /** Optional description */
+    description: string | null;
+    /** Price in cents (0 if free shipping applies) */
+    price: number;
+    /** Original price in cents (always the base price before free shipping) */
+    originalPrice: number;
+    /** Free shipping threshold in cents, null = no free shipping available for this method */
+    freeShippingThreshold: number | null;
+    /** Carrier logo URL */
+    logo: string | null;
+    /** Provider type */
+    provider: "shipit" | "custom";
+    /** Carrier name (e.g., "Posti", "Matkahuolto") - null for custom methods */
+    carrier: string | null;
+    /** Estimated delivery time (e.g., "1-3") - null if not available */
+    estimatedDelivery: string | null;
+}
+/**
+ * A pickup point option (parcel locker, service point, etc.)
+ * Works for any provider that supports pickup locations.
+ */
+interface PickupPointOption {
+    /** Unique pickup point ID from carrier */
+    id: string;
+    /** ShipmentMethods.id - needed for checkout */
+    shipmentMethodId: string;
+    /** Shipit service ID - needed for checkout and shipment creation */
     serviceId: string;
-    /** Location name */
+    /** Location name (e.g., "Lidl Graniittitalo") */
     name: string;
     /** Street address */
-    address1: string;
+    address: string;
     /** City */
     city: string;
     /** Postal code */
-    zipcode: string;
-    /** Country code (e.g., "FI") */
-    countryCode: string;
-    /** Carrier name (e.g., "Posti", "Matkahuolto") */
-    carrier: string;
+    postalCode: string;
+    /** Price in cents (0 if free shipping applies) */
+    price: number;
+    /** Original price in cents (always the base price before free shipping) */
+    originalPrice: number;
+    /** Free shipping threshold in cents, null = no free shipping available for this method */
+    freeShippingThreshold: number | null;
     /** Carrier logo URL */
-    carrierLogo: string;
-    /** GPS latitude */
-    latitude?: number;
-    /** GPS longitude */
-    longitude?: number;
-    /** Distance from postal code in meters */
-    distanceInMeters: number;
-    /** Distance from postal code in kilometers */
-    distanceInKilometers: number;
-    /** Location type (e.g., "parcel_locker", "service_point", "outdoor_parcel_locker") */
-    type?: string;
+    logo: string | null;
+    /** Provider type */
+    provider: "shipit" | "custom";
+    /** Carrier name (e.g., "Posti", "Matkahuolto") */
+    carrier: string | null;
+    /** Distance from customer's postal code in meters */
+    distance: number | null;
     /** Structured opening hours */
-    openingHours?: PickupLocationOpeningHours | null;
-    /** Raw opening hours string from Shipit */
-    openingHoursRaw?: string | null;
-    /** Additional metadata */
-    metadata?: unknown | null;
-    /** The shipment method ID this location belongs to */
-    shipmentMethodId: string;
-    /** Price in cents (from store settings) */
-    price: number;
+    openingHours: OpeningHours | null;
+    /** GPS coordinates */
+    coordinates: {
+        lat: number;
+        lng: number;
+    } | null;
 }
 /**
  * Response from GET /shipment-methods/[postalCode]
+ *
+ * Returns unified shipping options regardless of provider.
+ * Pickup points are sorted by distance, home delivery by price.
  */
-interface ShipmentMethodsWithLocationsResponse {
-    /** Home delivery methods (custom methods + Shipit home delivery) */
-    homeDeliveryMethods: ShipmentMethod[];
-    /** Pickup locations with shipmentMethodId and price attached */
-    pickupLocations: PickupLocation[];
+interface ShipmentMethodsResponse {
+    /** Home delivery options (sorted by price) */
+    homeDelivery: HomeDeliveryOption[];
+    /** Pickup point options (sorted by distance) */
+    pickupPoints: PickupPointOption[];
 }
 
 /**
@@ -717,7 +735,7 @@ interface Order {
     storeId: string;
     /** Order creation timestamp */
     createdAt: string;
-    /** Total order amount in cents */
+    /** Total order amount in cents (subtotal before discount) */
     totalAmount: number;
     /** Current order status */
     status: OrderStatus;
@@ -729,6 +747,12 @@ interface Order {
     orderCustomerData: ConfirmationOrderCustomerData | null;
     /** Shipment method with tracking info */
     orderShipmentMethod: ConfirmationOrderShipmentMethod | null;
+    /** Discount code string (e.g., "SUMMER20") - null if no discount applied */
+    discountCodeValue: string | null;
+    /** Discount amount in cents - null if no discount applied */
+    discountAmount: number | null;
+    /** VAT rate used for the discount calculation */
+    discountVatRate: number | null;
 }
 
 /**
@@ -1126,6 +1150,8 @@ interface CheckoutShipmentMethod {
     shipmentMethodId: string;
     /** ID of pickup point (for pickup delivery methods) */
     pickupId: string | null;
+    /** Shipit service ID (for Shipit pickup points) */
+    serviceId: string | null;
 }
 /**
  * Parameters for creating a checkout session
@@ -1223,6 +1249,104 @@ interface CheckoutErrorDetails {
     [key: string]: unknown;
 }
 
+/**
+ * Discount Code Types
+ *
+ * Types for discount code API endpoints.
+ */
+/**
+ * Type of discount
+ */
+type DiscountType = "PERCENTAGE" | "FIXED_AMOUNT";
+/**
+ * Applied discount code information (stored in cart)
+ */
+interface AppliedDiscount {
+    /** The discount code string */
+    code: string;
+    /** Type of discount */
+    discountType: DiscountType;
+    /** Discount value (percentage 1-100 or cents for fixed amount) */
+    discountValue: number;
+}
+/**
+ * Parameters for applying a discount code
+ */
+interface ApplyDiscountParams {
+    /** The discount code to apply */
+    code: string;
+    /** Cart ID for guest users */
+    cartId?: string;
+    /** Session ID for logged-in users */
+    sessionId?: string;
+    /** Cart items for campaign conflict check (SDK uses this for instant validation) */
+    cartItems?: CartItem[];
+    /** Active campaigns for campaign conflict check (SDK uses this for instant validation) */
+    campaigns?: Campaign[];
+}
+/**
+ * Parameters for removing a discount code
+ */
+interface RemoveDiscountParams {
+    /** Cart ID for guest users */
+    cartId?: string;
+    /** Session ID for logged-in users */
+    sessionId?: string;
+}
+/**
+ * Parameters for getting current discount
+ */
+interface GetDiscountParams {
+    /** Cart ID for guest users */
+    cartId?: string;
+    /** Session ID for logged-in users */
+    sessionId?: string;
+}
+/**
+ * Response from POST /discount-code/apply
+ *
+ * Note: No discountAmount returned - cart can change before checkout.
+ * Calculate locally or get from cart validate if needed.
+ */
+interface ApplyDiscountResponse {
+    /** Whether the discount was applied successfully */
+    success: boolean;
+    /** Applied discount details */
+    discount: {
+        code: string;
+        discountType: DiscountType;
+        discountValue: number;
+        /** Minimum order amount for this code (in cents) - for UI display */
+        minOrderAmount: number | null;
+    };
+}
+/**
+ * Response from GET /discount-code/apply (get current discount)
+ *
+ * Returns stored discount data without re-validation.
+ * Use /cart/validate for full validation.
+ */
+interface GetDiscountResponse {
+    /** Current discount (null if none applied) */
+    discount: AppliedDiscount | null;
+}
+/**
+ * Response from DELETE /discount-code/apply
+ */
+interface RemoveDiscountResponse {
+    /** Whether the discount was removed successfully */
+    success: boolean;
+}
+/**
+ * Error response from discount code endpoints
+ */
+interface DiscountCodeError {
+    /** Error message (Finnish, user-friendly) */
+    error: string;
+    /** Error code for programmatic use */
+    code: "MISSING_CODE" | "MISSING_CART_TOTAL" | "CART_MISSING" | "NOT_FOUND" | "INACTIVE" | "NOT_STARTED" | "EXPIRED" | "MAX_USES_REACHED" | "MIN_ORDER_NOT_MET" | "CAMPAIGN_ACTIVE" | "INTERNAL_ERROR";
+}
+
 /**
  * Putiikkipalvelu Storefront SDK Types
  *
@@ -1649,28 +1773,35 @@ declare function createCartResource(fetcher: Fetcher): {
      * Checks product availability, stock levels, and prices.
      * Auto-fixes issues (removes unavailable items, adjusts quantities).
      *
+     * Campaign conflict detection:
+     * - SDK calculates if BuyXPayY campaigns apply using calculateCartWithCampaigns()
+     * - Sends x-campaigns-apply header to backend
+     * - If campaigns apply AND discount code exists, backend removes it
+     * - Returns changes.discountCouponRemoved = true
+     *
      * @param options - Cart session options
+     * @param cartItems - Current cart items for campaign calculation
+     * @param campaigns - Active campaigns for conflict check
      * @param fetchOptions - Fetch options
      * @returns Validated cart with change metadata
      *
      * @example Validate before checkout
      * ```typescript
-     * const { items, hasChanges, changes } = await client.cart.validate({ cartId });
+     * const result = await client.cart.validate(
+     *   { cartId },
+     *   cartItems,
+     *   storeConfig.campaigns
+     * );
      *
-     * if (hasChanges) {
-     *   if (changes.removedItems > 0) {
-     *     notify('Some items were removed (out of stock)');
-     *   }
-     *   if (changes.quantityAdjusted > 0) {
-     *     notify('Some quantities were adjusted');
-     *   }
-     *   if (changes.priceChanged > 0) {
-     *     notify('Some prices have changed');
+     * if (result.hasChanges) {
+     *   if (result.changes.discountCouponRemoved) {
+     *     notify("Alennuskoodi poistettu - kampanja-alennus aktivoitui");
      *   }
+     *   // Handle other changes...
      * }
      * ```
      */
-    validate(options?: CartSessionOptions, fetchOptions?: FetchOptions): Promise<CartValidationResponse>;
+    validate(options?: CartSessionOptions, cartItems?: CartItem[], campaigns?: Campaign[], fetchOptions?: FetchOptions): Promise<CartValidationResponse>;
 };
 /**
  * Type for the cart resource
@@ -1686,9 +1817,15 @@ type CartResource = ReturnType<typeof createCartResource>;
 /**
  * Options for fetching shipment methods with weight-based filtering
  */
-interface GetMethodsOptions extends FetchOptions {
-    /** Cart items - weight will be calculated automatically */
+interface GetShippingOptionsParams extends FetchOptions {
+    /** Cart items - weight and total will be calculated automatically */
     cartItems?: CartItem[];
+    /** Active campaigns - used to calculate cart total with discounts for free shipping */
+    campaigns?: Campaign[];
+    /** Discount amount in cents (from discount code) - subtracted from cart total for free shipping threshold */
+    discountAmount?: number;
+    /** Country code (default: "FI") */
+    country?: string;
 }
 /**
  * Shipping resource for fetching shipment methods and pickup locations
@@ -1696,40 +1833,55 @@ interface GetMethodsOptions extends FetchOptions {
 declare function createShippingResource(fetcher: Fetcher): {
     /**
      * Get shipping options for a specific postal code.
-     * Returns home delivery methods and pickup locations.
+     * Returns pickup points and home delivery options in a unified format.
+     *
+     * **Pickup points are returned first** as they are more popular in Finland.
      *
      * @param postalCode - Customer's postal code (e.g., "00100")
      * @param options - Fetch options including optional cartItems for weight-based filtering
-     * @returns Home delivery methods and pickup locations
+     * @returns Unified shipping options (pickupPoints sorted by distance, homeDelivery sorted by price)
      *
      * @example
      * ```typescript
-     * const { homeDeliveryMethods, pickupLocations } = await client.shipping.getWithLocations("00100");
-     *
-     * // Show home delivery options
-     * homeDeliveryMethods.forEach(method => {
-     *   console.log(`${method.name}: ${method.price / 100}€`);
+     * const { pickupPoints, homeDelivery } = await client.shipping.getOptions("00100");
+     *
+     * // Show pickup points (more popular in Finland)
+     * pickupPoints.forEach(point => {
+     *   console.log(`${point.name} - ${point.carrier}`);
+     *   console.log(`  ${point.address}, ${point.city}`);
+     *   console.log(`  ${(point.distance! / 1000).toFixed(1)} km away`);
+     *   console.log(`  Price: ${point.price / 100}€`);
      * });
      *
-     * // Show pickup locations
-     * pickupLocations.forEach(location => {
-     *   console.log(`${location.name} - ${location.carrier}`);
-     *   console.log(`  ${location.address1}, ${location.city}`);
-     *   console.log(`  ${location.distanceInKilometers.toFixed(1)} km away`);
-     *   console.log(`  Price: ${location.price / 100}€`);
+     * // Show home delivery options
+     * homeDelivery.forEach(option => {
+     *   console.log(`${option.name}: ${option.price / 100}€`);
+     *   if (option.estimatedDelivery) {
+     *     console.log(`  Delivery: ${option.estimatedDelivery} days`);
+     *   }
      * });
      * ```
      *
      * @example Weight-based filtering
      * ```typescript
-     * const { homeDeliveryMethods, pickupLocations } = await client.shipping.getWithLocations(
-     *   "00100",
-     *   { cartItems: cartItems }
-     * );
+     * const options = await client.shipping.getOptions("00100", {
+     *   cartItems: cartItems
+     * });
      * // Only shows methods that support the cart's total weight
      * ```
+     *
+     * @example International shipping
+     * ```typescript
+     * const options = await client.shipping.getOptions("112 22", {
+     *   country: "SE"
+     * });
+     * ```
      */
-    getWithLocations(postalCode: string, options?: GetMethodsOptions): Promise<ShipmentMethodsWithLocationsResponse>;
+    getOptions(postalCode: string, options?: GetShippingOptionsParams): Promise<ShipmentMethodsResponse>;
+    /**
+     * @deprecated Use getOptions() instead. This method is kept for backwards compatibility.
+     */
+    getWithLocations(postalCode: string, options?: GetShippingOptionsParams): Promise<ShipmentMethodsResponse>;
 };
 /**
  * Type for the shipping resource
@@ -2275,6 +2427,70 @@ declare function createCheckoutResource(fetcher: Fetcher): {
  */
 type CheckoutResource = ReturnType<typeof createCheckoutResource>;
 
+/**
+ * Discount Code Resource
+ *
+ * Provides methods for managing discount codes in the cart.
+ */
+
+/**
+ * Creates the discount code resource with methods for managing discount codes.
+ */
+declare function createDiscountCodeResource(fetcher: Fetcher): {
+    /**
+     * Apply a discount code to the cart
+     *
+     * Checks for BuyXPayY campaign conflict before calling API.
+     * Discount codes cannot be used when a campaign discount is active.
+     *
+     * @param params - Parameters including code, session info, and cart/campaign data for conflict check
+     * @returns Applied discount details
+     * @throws {StorefrontError} With code "CAMPAIGN_ACTIVE" if a BuyXPayY campaign is active
+     *
+     * @example
+     * ```typescript
+     * const result = await client.discountCode.apply({
+     *   code: "SUMMER20",
+     *   cartId: cartId,
+     *   cartItems: cart.items,
+     *   campaigns: storeConfig.campaigns,
+     * });
+     * ```
+     */
+    apply(params: ApplyDiscountParams): Promise<ApplyDiscountResponse>;
+    /**
+     * Get the currently applied discount code
+     *
+     * @param params - Session info (cartId or sessionId)
+     * @returns Current discount or null if none applied
+     *
+     * @example
+     * ```typescript
+     * const { discount } = await client.discountCode.get({ cartId });
+     * if (discount) {
+     *   console.log(`Code ${discount.code}: ${discount.discountValue}${discount.discountType === 'PERCENTAGE' ? '%' : '¢'} off`);
+     * }
+     * ```
+     */
+    get(params?: GetDiscountParams): Promise<GetDiscountResponse>;
+    /**
+     * Remove the currently applied discount code
+     *
+     * @param params - Session info (cartId or sessionId)
+     * @returns Success status
+     *
+     * @example
+     * ```typescript
+     * await client.discountCode.remove({ cartId });
+     * ```
+     */
+    remove(params?: RemoveDiscountParams): Promise<RemoveDiscountResponse>;
+};
+/**
+ * Type for the discount code resource
+ */
+type DiscountCodeResource = ReturnType<typeof createDiscountCodeResource>;
+
 /**
  * The Storefront API client
  */
@@ -2315,6 +2531,10 @@ interface StorefrontClient {
      * Checkout resource for payment processing
      */
     readonly checkout: CheckoutResource;
+    /**
+     * Discount code resource for applying/removing discount codes
+     */
+    readonly discountCode: DiscountCodeResource;
 }
 /**
  * Create a new Storefront API client
@@ -2378,13 +2598,11 @@ declare function getPriceInfo(product: ProductDetail, variation?: ProductVariati
 /**
  * Calculate cart totals with campaign discounts applied.
  *
- * Supports two campaign types:
- * - **FREE_SHIPPING**: Free shipping when cart total exceeds minimum spend
- * - **BUY_X_PAY_Y**: Buy X items, pay for Y (e.g., Buy 3 Pay 2 = 1 free item)
+ * Supports BUY_X_PAY_Y campaigns: Buy X items, pay for Y (e.g., Buy 3 Pay 2 = 1 free item)
  *
  * @param items - Cart items to calculate
  * @param campaigns - Active campaigns to apply
- * @returns Calculation result with totals, savings, and free shipping status
+ * @returns Calculation result with totals and savings
  *
  * @example
  * ```typescript
@@ -2392,7 +2610,6 @@ declare function getPriceInfo(product: ProductDetail, variation?: ProductVariati
  *
  * console.log(result.cartTotal);     // 4990 (cents)
  * console.log(result.totalSavings);  // 1990 (cents)
- * console.log(result.freeShipping.isEligible); // true
  *
  * // Render calculated items
  * result.calculatedItems.forEach(({ item, paidQuantity, freeQuantity }) => {
@@ -2402,6 +2619,126 @@ declare function getPriceInfo(product: ProductDetail, variation?: ProductVariati
  */
 declare function calculateCartWithCampaigns(items: CartItem[], campaigns: Campaign[]): CartCalculationResult;
 
+/**
+ * Discount Code Utilities
+ *
+ * Helper functions for working with discount codes.
+ */
+
+/**
+ * Options for formatting discount values
+ */
+interface FormatDiscountOptions {
+    /**
+     * Currency symbol to use for fixed amount discounts
+     * @default "€"
+     */
+    currencySymbol?: string;
+    /**
+     * Whether to show the currency symbol before or after the value
+     * @default "after"
+     */
+    currencyPosition?: "before" | "after";
+    /**
+     * Number of decimal places for fixed amount
+     * @default 2
+     */
+    decimals?: number;
+    /**
+     * Whether to include the minus sign prefix
+     * @default true
+     */
+    showMinus?: boolean;
+}
+/**
+ * Format a discount value for display.
+ *
+ * @param discount - The applied discount (or just type and value)
+ * @param options - Formatting options
+ * @returns Formatted discount string (e.g., "-20%" or "-5,00 €")
+ *
+ * @example
+ * ```typescript
+ * // Percentage discount
+ * formatDiscountValue({ discountType: "PERCENTAGE", discountValue: 20 });
+ * // Returns: "-20%"
+ *
+ * // Fixed amount discount (value in cents)
+ * formatDiscountValue({ discountType: "FIXED_AMOUNT", discountValue: 500 });
+ * // Returns: "-5,00 €"
+ *
+ * // Custom currency
+ * formatDiscountValue(
+ *   { discountType: "FIXED_AMOUNT", discountValue: 1000 },
+ *   { currencySymbol: "$", currencyPosition: "before" }
+ * );
+ * // Returns: "-$10.00"
+ * ```
+ */
+declare function formatDiscountValue(discount: Pick<AppliedDiscount, "discountType" | "discountValue">, options?: FormatDiscountOptions): string;
+/**
+ * Calculate the discount amount in cents.
+ *
+ * @param subtotal - Cart subtotal in cents (before discount)
+ * @param discount - The applied discount
+ * @returns Discount amount in cents (always positive)
+ *
+ * @example
+ * ```typescript
+ * // 20% off 100€ subtotal
+ * calculateDiscountAmount(10000, { discountType: "PERCENTAGE", discountValue: 20 });
+ * // Returns: 2000 (20€ in cents)
+ *
+ * // Fixed 5€ discount
+ * calculateDiscountAmount(10000, { discountType: "FIXED_AMOUNT", discountValue: 500 });
+ * // Returns: 500 (5€ in cents)
+ *
+ * // Fixed discount larger than subtotal (capped)
+ * calculateDiscountAmount(300, { discountType: "FIXED_AMOUNT", discountValue: 500 });
+ * // Returns: 300 (capped to subtotal)
+ * ```
+ */
+declare function calculateDiscountAmount(subtotal: number, discount: Pick<AppliedDiscount, "discountType" | "discountValue">): number;
+/**
+ * Supported locales for error messages
+ */
+type DiscountMessageLocale = "fi" | "en";
+/**
+ * Get a user-friendly message for discount removal reason.
+ *
+ * @param reason - The removal reason from cart validation
+ * @param locale - Locale for the message (fi or en)
+ * @returns Localized user-friendly message
+ *
+ * @example
+ * ```typescript
+ * getDiscountRemovalMessage("CAMPAIGN_ACTIVE", "fi");
+ * // Returns: "Alennuskoodi poistettu - kampanja-alennus aktivoitui"
+ *
+ * getDiscountRemovalMessage("MIN_ORDER_NOT_MET", "en");
+ * // Returns: "Discount code removed - cart total below minimum order"
+ * ```
+ */
+declare function getDiscountRemovalMessage(reason: DiscountRemovalReason | undefined, locale?: DiscountMessageLocale): string;
+/**
+ * Error codes from discount code apply endpoint
+ */
+type DiscountApplyErrorCode = "NOT_FOUND" | "INACTIVE" | "NOT_STARTED" | "EXPIRED" | "MAX_USES_REACHED" | "MIN_ORDER_NOT_MET" | "CAMPAIGN_ACTIVE";
+/**
+ * Get a user-friendly message for discount apply error.
+ *
+ * @param errorCode - The error code from apply endpoint
+ * @param locale - Locale for the message (fi or en)
+ * @returns Localized user-friendly message
+ *
+ * @example
+ * ```typescript
+ * getDiscountApplyErrorMessage("EXPIRED", "fi");
+ * // Returns: "Alennuskoodi on vanhentunut"
+ * ```
+ */
+declare function getDiscountApplyErrorMessage(errorCode: DiscountApplyErrorCode | string | undefined, locale?: DiscountMessageLocale): string;
+
 /**
  * Base error class for all Storefront API errors
  */
@@ -2445,4 +2782,4 @@ declare class VerificationRequiredError extends StorefrontError {
     constructor(message: string, customerId: string);
 }
 
-export { type AddToCartParams, type AddToWishlistResponse, AuthError, type BuyXPayYCampaign, type CalculatedCartItem, type Campaign, type CampaignType, type CartCalculationResult, type CartItem, type CartResponse, type CartSessionOptions, type CartValidationChanges, type CartValidationResponse, type Category, type CategoryReference, type CategoryResponse, type CheckoutCustomerData, type CheckoutErrorCode, type CheckoutErrorDetails, type CheckoutOptions, type CheckoutParams, type CheckoutShipmentMethod, type ConfirmationItemType, type ConfirmationOrderCustomerData, type ConfirmationOrderLineItem, type ConfirmationOrderShipmentMethod, type Customer, type CustomerOrder, type DeleteAccountResponse, type FeatureFlags, type FetchOptions, type ForgotPasswordResponse, type FreeShippingStatus, type GetOrdersResponse, type GetUserResponse, type LoginOptions, type LoginResponse, type LoginVerificationRequiredResponse, type LogoutResponse, NotFoundError, type Order, type OrderLineItem, type OrderProductInfo, type OrderShipmentMethod, type OrderStatus, type PaymentConfig, type PaytrailCheckoutResponse, type PaytrailGroup, type PaytrailProvider, type PickupLocation, type PriceInfo, type Product, type ProductCountResponse, type ProductDetail, type ProductListParams, type ProductListResponse, type ProductSortOption, type ProductVariation, type ProductVariationListing, RateLimitError, type RegisterData, type RegisterResponse, type RemoveFromCartParams, type RemoveFromWishlistResponse, type ResendVerificationResponse, type ResetPasswordResponse, type ShipitShippingMethod, type ShipmentMethod, type ShipmentMethodsWithLocationsResponse, type StoreConfig, type StoreInfo, type StoreSeo, type StorefrontClient, type StorefrontClientConfig, StorefrontError, type StripeCheckoutResponse, type UpdateCartQuantityParams, type UpdateProfileData, type UpdateProfileResponse, ValidationError, type VariationOption, VerificationRequiredError, type VerifyEmailResponse, type WishlistItem, type WishlistProduct, type WishlistResponse, type WishlistVariation, type WishlistVariationOption, calculateCartWithCampaigns, createStorefrontClient, getPriceInfo, isSaleActive };
+export { type AddToCartParams, type AddToWishlistResponse, type AppliedDiscount, type ApplyDiscountParams, type ApplyDiscountResponse, AuthError, type BuyXPayYCampaign, type CalculatedCartItem, type Campaign, type CampaignType, type CartCalculationResult, type CartItem, type CartResponse, type CartSessionOptions, type CartValidationChanges, type CartValidationResponse, type Category, type CategoryReference, type CategoryResponse, type CheckoutCustomerData, type CheckoutErrorCode, type CheckoutErrorDetails, type CheckoutOptions, type CheckoutParams, type CheckoutShipmentMethod, type ConfirmationItemType, type ConfirmationOrderCustomerData, type ConfirmationOrderLineItem, type ConfirmationOrderShipmentMethod, type Customer, type CustomerOrder, type DeleteAccountResponse, type DiscountApplyErrorCode, type DiscountCodeError, type DiscountMessageLocale, type DiscountRemovalReason, type DiscountType, type FeatureFlags, type FetchOptions, type ForgotPasswordResponse, type FormatDiscountOptions, type GetDiscountParams, type GetDiscountResponse, type GetOrdersResponse, type GetUserResponse, type HomeDeliveryOption, type LoginOptions, type LoginResponse, type LoginVerificationRequiredResponse, type LogoutResponse, NotFoundError, type OpeningHours, type Order, type OrderLineItem, type OrderProductInfo, type OrderShipmentMethod, type OrderStatus, type PaymentConfig, type PaytrailCheckoutResponse, type PaytrailGroup, type PaytrailProvider, type PickupPointOption, type PriceInfo, type Product, type ProductCountResponse, type ProductDetail, type ProductListParams, type ProductListResponse, type ProductSortOption, type ProductVariation, type ProductVariationListing, RateLimitError, type RegisterData, type RegisterResponse, type RemoveDiscountParams, type RemoveDiscountResponse, type RemoveFromCartParams, type RemoveFromWishlistResponse, type ResendVerificationResponse, type ResetPasswordResponse, type ShipitShippingMethod, type ShipmentMethod, type ShipmentMethodsResponse, type StoreConfig, type StoreInfo, type StoreSeo, type StorefrontClient, type StorefrontClientConfig, StorefrontError, type StripeCheckoutResponse, type UpdateCartQuantityParams, type UpdateProfileData, type UpdateProfileResponse, ValidationError, type VariationOption, VerificationRequiredError, type VerifyEmailResponse, type WishlistItem, type WishlistProduct, type WishlistResponse, type WishlistVariation, type WishlistVariationOption, calculateCartWithCampaigns, calculateDiscountAmount, createStorefrontClient, formatDiscountValue, getDiscountApplyErrorMessage, getDiscountRemovalMessage, getPriceInfo, isSaleActive };