@putiikkipalvelu/storefront-sdk 0.2.4 → 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,63 +541,82 @@ interface PickupLocationOpeningHours {
     exceptions: string[];
 }
 /**
- * A pickup location (parcel locker, pickup point, etc.)
- * Returned from Shipit API with merchant pricing added
+ * 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 */
-    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;
-    /** Merchant's price in cents (from store settings) */
-    merchantPrice: number | null;
-}
-/**
- * Response from GET /shipment-methods
- */
-interface ShipmentMethodsResponse {
-    /** Available shipment methods */
-    shipmentMethods: ShipmentMethod[];
+    openingHours: OpeningHours | null;
+    /** GPS coordinates */
+    coordinates: {
+        lat: number;
+        lng: number;
+    } | null;
 }
 /**
  * Response from GET /shipment-methods/[postalCode]
- * Includes pickup locations near the postal code
+ *
+ * Returns unified shipping options regardless of provider.
+ * Pickup points are sorted by distance, home delivery by price.
  */
-interface ShipmentMethodsWithLocationsResponse {
-    /** Available shipment methods */
-    shipmentMethods: ShipmentMethod[];
-    /** Pickup locations near the postal code with merchant pricing */
-    pricedLocations: PickupLocation[];
+interface ShipmentMethodsResponse {
+    /** Home delivery options (sorted by price) */
+    homeDelivery: HomeDeliveryOption[];
+    /** Pickup point options (sorted by distance) */
+    pickupPoints: PickupPointOption[];
 }
 
 /**
@@ -1132,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
@@ -1692,71 +1695,69 @@ 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
  */
 declare function createShippingResource(fetcher: Fetcher): {
     /**
-     * Get all available shipment methods for the store.
-     * Returns methods without pickup locations - use `getWithLocations` for postal code specific data.
+     * Get shipping options for a specific postal code.
+     * 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 Available shipment methods
+     * @returns Unified shipping options (pickupPoints sorted by distance, homeDelivery sorted by price)
      *
      * @example
      * ```typescript
-     * const { shipmentMethods } = await client.shipping.getMethods();
+     * 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}€`);
+     * });
      *
-     * shipmentMethods.forEach(method => {
-     *   console.log(`${method.name}: ${method.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
-     * // Pass cart items - SDK calculates weight automatically
-     * const { shipmentMethods } = await client.shipping.getMethods({
+     * const options = await client.shipping.getOptions("00100", {
      *   cartItems: cartItems
      * });
+     * // Only shows methods that support the cart's total weight
      * ```
-     */
-    getMethods(options?: GetMethodsOptions): Promise<ShipmentMethodsResponse>;
-    /**
-     * Get shipment methods with pickup locations for a specific postal code.
-     * Calls the Shipit API to fetch nearby pickup points (parcel lockers, etc.)
      *
-     * @param postalCode - Customer's postal code (e.g., "00100")
-     * @param options - Fetch options including optional cartItems for weight-based filtering
-     * @returns Shipment methods and nearby pickup locations with pricing
-     *
-     * @example
+     * @example International shipping
      * ```typescript
-     * const { shipmentMethods, pricedLocations } = await client.shipping.getWithLocations("00100");
-     *
-     * // Show pickup locations
-     * pricedLocations.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.merchantPrice ?? 0) / 100}€`);
+     * const options = await client.shipping.getOptions("112 22", {
+     *   country: "SE"
      * });
      * ```
-     *
-     * @example Weight-based filtering with postal code
-     * ```typescript
-     * const { shipmentMethods, pricedLocations } = await client.shipping.getWithLocations(
-     *   "00100",
-     *   { cartItems: cartItems }
-     * );
-     *
-     * // Only shows methods that support the cart's total weight
-     * ```
      */
-    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
@@ -2405,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
@@ -2419,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 }) => {
@@ -2472,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 ShipmentMethodsResponse, 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,63 +541,82 @@ interface PickupLocationOpeningHours {
     exceptions: string[];
 }
 /**
- * A pickup location (parcel locker, pickup point, etc.)
- * Returned from Shipit API with merchant pricing added
+ * 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 */
-    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;
-    /** Merchant's price in cents (from store settings) */
-    merchantPrice: number | null;
-}
-/**
- * Response from GET /shipment-methods
- */
-interface ShipmentMethodsResponse {
-    /** Available shipment methods */
-    shipmentMethods: ShipmentMethod[];
+    openingHours: OpeningHours | null;
+    /** GPS coordinates */
+    coordinates: {
+        lat: number;
+        lng: number;
+    } | null;
 }
 /**
  * Response from GET /shipment-methods/[postalCode]
- * Includes pickup locations near the postal code
+ *
+ * Returns unified shipping options regardless of provider.
+ * Pickup points are sorted by distance, home delivery by price.
  */
-interface ShipmentMethodsWithLocationsResponse {
-    /** Available shipment methods */
-    shipmentMethods: ShipmentMethod[];
-    /** Pickup locations near the postal code with merchant pricing */
-    pricedLocations: PickupLocation[];
+interface ShipmentMethodsResponse {
+    /** Home delivery options (sorted by price) */
+    homeDelivery: HomeDeliveryOption[];
+    /** Pickup point options (sorted by distance) */
+    pickupPoints: PickupPointOption[];
 }
 
 /**
@@ -1132,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
@@ -1692,71 +1695,69 @@ 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
  */
 declare function createShippingResource(fetcher: Fetcher): {
     /**
-     * Get all available shipment methods for the store.
-     * Returns methods without pickup locations - use `getWithLocations` for postal code specific data.
+     * Get shipping options for a specific postal code.
+     * 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 Available shipment methods
+     * @returns Unified shipping options (pickupPoints sorted by distance, homeDelivery sorted by price)
      *
      * @example
      * ```typescript
-     * const { shipmentMethods } = await client.shipping.getMethods();
+     * 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}€`);
+     * });
      *
-     * shipmentMethods.forEach(method => {
-     *   console.log(`${method.name}: ${method.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
-     * // Pass cart items - SDK calculates weight automatically
-     * const { shipmentMethods } = await client.shipping.getMethods({
+     * const options = await client.shipping.getOptions("00100", {
      *   cartItems: cartItems
      * });
+     * // Only shows methods that support the cart's total weight
      * ```
-     */
-    getMethods(options?: GetMethodsOptions): Promise<ShipmentMethodsResponse>;
-    /**
-     * Get shipment methods with pickup locations for a specific postal code.
-     * Calls the Shipit API to fetch nearby pickup points (parcel lockers, etc.)
      *
-     * @param postalCode - Customer's postal code (e.g., "00100")
-     * @param options - Fetch options including optional cartItems for weight-based filtering
-     * @returns Shipment methods and nearby pickup locations with pricing
-     *
-     * @example
+     * @example International shipping
      * ```typescript
-     * const { shipmentMethods, pricedLocations } = await client.shipping.getWithLocations("00100");
-     *
-     * // Show pickup locations
-     * pricedLocations.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.merchantPrice ?? 0) / 100}€`);
+     * const options = await client.shipping.getOptions("112 22", {
+     *   country: "SE"
      * });
      * ```
-     *
-     * @example Weight-based filtering with postal code
-     * ```typescript
-     * const { shipmentMethods, pricedLocations } = await client.shipping.getWithLocations(
-     *   "00100",
-     *   { cartItems: cartItems }
-     * );
-     *
-     * // Only shows methods that support the cart's total weight
-     * ```
      */
-    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
@@ -2405,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
@@ -2419,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 }) => {
@@ -2472,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 ShipmentMethodsResponse, 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 };