@putiikkipalvelu/storefront-sdk 0.2.5 → 0.3.0

package/dist/index.d.cts

@@ -507,21 +507,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 +519,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 +541,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 HomeDeliveryOption {
+    /** ShipmentMethods.id - unique identifier for this method */
+    id: string;
+    /** 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 PickupLocation {
-    /** Unique location ID from Shipit */
+interface PickupPointOption {
+    /** Unique pickup point ID from carrier */
     id: string;
-    /** Shipit service ID */
+    /** 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[];
 }
 
 /**
@@ -1126,6 +1133,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
@@ -1686,9 +1695,13 @@ 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[];
+    /** Country code (default: "FI") */
+    country?: string;
 }
 /**
  * Shipping resource for fetching shipment methods and pickup locations
@@ -1696,40 +1709,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"
+     * });
+     * ```
+     */
+    getOptions(postalCode: string, options?: GetShippingOptionsParams): Promise<ShipmentMethodsResponse>;
+    /**
+     * @deprecated Use getOptions() instead. This method is kept for backwards compatibility.
      */
-    getWithLocations(postalCode: string, options?: GetMethodsOptions): Promise<ShipmentMethodsWithLocationsResponse>;
+    getWithLocations(postalCode: string, options?: GetShippingOptionsParams): Promise<ShipmentMethodsResponse>;
 };
 /**
  * Type for the shipping resource
@@ -2378,13 +2406,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 +2418,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 }) => {
@@ -2445,4 +2470,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, 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 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 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, createStorefrontClient, getPriceInfo, isSaleActive };

package/dist/index.d.ts

@@ -507,21 +507,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 +519,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 +541,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 HomeDeliveryOption {
+    /** ShipmentMethods.id - unique identifier for this method */
+    id: string;
+    /** 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 PickupLocation {
-    /** Unique location ID from Shipit */
+interface PickupPointOption {
+    /** Unique pickup point ID from carrier */
     id: string;
-    /** Shipit service ID */
+    /** 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[];
 }
 
 /**
@@ -1126,6 +1133,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
@@ -1686,9 +1695,13 @@ 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[];
+    /** Country code (default: "FI") */
+    country?: string;
 }
 /**
  * Shipping resource for fetching shipment methods and pickup locations
@@ -1696,40 +1709,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"
+     * });
+     * ```
+     */
+    getOptions(postalCode: string, options?: GetShippingOptionsParams): Promise<ShipmentMethodsResponse>;
+    /**
+     * @deprecated Use getOptions() instead. This method is kept for backwards compatibility.
      */
-    getWithLocations(postalCode: string, options?: GetMethodsOptions): Promise<ShipmentMethodsWithLocationsResponse>;
+    getWithLocations(postalCode: string, options?: GetShippingOptionsParams): Promise<ShipmentMethodsResponse>;
 };
 /**
  * Type for the shipping resource
@@ -2378,13 +2406,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 +2418,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 }) => {
@@ -2445,4 +2470,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, 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 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 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, createStorefrontClient, getPriceInfo, isSaleActive };