@putiikkipalvelu/storefront-sdk 0.2.3 → 0.2.5

package/dist/index.d.ts

@@ -91,7 +91,7 @@ interface FeatureFlags {
     reviewsEnabled: boolean;
 }
 /** Campaign type */
-type CampaignType = "FREE_SHIPPING" | "BUY_X_PAY_Y";
+type CampaignType = "BUY_X_PAY_Y";
 /**
  * Store campaign (promotion)
  */
@@ -116,24 +116,9 @@ interface Campaign {
     createdAt: string;
     /** Last update timestamp (ISO 8601) */
     updatedAt: string;
-    /** Free shipping campaign details (if type is FREE_SHIPPING) */
-    FreeShippingCampaign: FreeShippingCampaign | null;
     /** Buy X Pay Y campaign details (if type is BUY_X_PAY_Y) */
     BuyXPayYCampaign: BuyXPayYCampaign | null;
 }
-/**
- * Free shipping campaign details
- */
-interface FreeShippingCampaign {
-    /** Unique identifier */
-    id: string;
-    /** Parent campaign ID */
-    campaignId: string;
-    /** Minimum spend in cents to qualify for free shipping */
-    minimumSpend: number;
-    /** Shipping methods eligible for free shipping */
-    shipmentMethods: ShipmentMethod[];
-}
 /**
  * Buy X Pay Y campaign details (e.g., "Buy 3, Pay 2")
  */
@@ -152,18 +137,19 @@ interface BuyXPayYCampaign {
 /**
  * Shipit shipping method details
  * Represents a shipping service synced from the Shipit API
+ * Supports multiple carriers in a single method for multi-carrier shipping
  */
 interface ShipitShippingMethod {
     /** Unique ID */
     id: string;
-    /** Shipit service identifier */
-    serviceId: string;
+    /** Shipit service identifiers for all selected carriers */
+    serviceIds: string[];
     /** Service name */
     name: string;
-    /** Carrier name (e.g., "Posti", "Matkahuolto") */
-    carrier: string;
-    /** Carrier logo URL */
-    logo: string;
+    /** Carrier names (e.g., ["Posti", "Matkahuolto"]) */
+    carriers: string[];
+    /** Carrier logo URLs */
+    logos: string[];
     /** Whether pickup is included */
     pickUpIncluded: boolean;
     /** Whether home delivery is available */
@@ -192,10 +178,8 @@ interface ShipitShippingMethod {
     type: string;
     /** Shipit price in cents */
     price: number;
-    /** Whether pickup point selection is available */
-    pickupPoint: boolean;
-    /** Whether only parcel locker delivery is available */
-    onlyParchelLocker: boolean;
+    /** Whether to show pickup point selector (true) or home delivery only (false) */
+    showPickupPoints: boolean;
     /** Reference to parent shipment method */
     shipmentMethodId: string;
     /** Created timestamp */
@@ -576,7 +560,7 @@ interface PickupLocationOpeningHours {
 }
 /**
  * A pickup location (parcel locker, pickup point, etc.)
- * Returned from Shipit API with merchant pricing added
+ * Returned from Shipit API with shipmentMethodId and price attached
  */
 interface PickupLocation {
     /** Unique location ID from Shipit */
@@ -605,7 +589,7 @@ interface PickupLocation {
     distanceInMeters: number;
     /** Distance from postal code in kilometers */
     distanceInKilometers: number;
-    /** Location type */
+    /** Location type (e.g., "parcel_locker", "service_point", "outdoor_parcel_locker") */
     type?: string;
     /** Structured opening hours */
     openingHours?: PickupLocationOpeningHours | null;
@@ -613,25 +597,19 @@ interface PickupLocation {
     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[];
+    /** The shipment method ID this location belongs to */
+    shipmentMethodId: string;
+    /** Price in cents (from store settings) */
+    price: number;
 }
 /**
  * Response from GET /shipment-methods/[postalCode]
- * Includes pickup locations near the postal code
  */
 interface ShipmentMethodsWithLocationsResponse {
-    /** Available shipment methods */
-    shipmentMethods: ShipmentMethod[];
-    /** Pickup locations near the postal code with merchant pricing */
-    pricedLocations: PickupLocation[];
+    /** Home delivery methods (custom methods + Shipit home delivery) */
+    homeDeliveryMethods: ShipmentMethod[];
+    /** Pickup locations with shipmentMethodId and price attached */
+    pickupLocations: PickupLocation[];
 }
 
 /**
@@ -1717,58 +1695,37 @@ interface GetMethodsOptions extends FetchOptions {
  */
 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 home delivery methods and pickup locations.
      *
+     * @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 Home delivery methods and pickup locations
      *
      * @example
      * ```typescript
-     * const { shipmentMethods } = await client.shipping.getMethods();
+     * const { homeDeliveryMethods, pickupLocations } = await client.shipping.getWithLocations("00100");
      *
-     * shipmentMethods.forEach(method => {
+     * // Show home delivery options
+     * homeDeliveryMethods.forEach(method => {
      *   console.log(`${method.name}: ${method.price / 100}€`);
      * });
-     * ```
-     *
-     * @example Weight-based filtering
-     * ```typescript
-     * // Pass cart items - SDK calculates weight automatically
-     * const { shipmentMethods } = await client.shipping.getMethods({
-     *   cartItems: cartItems
-     * });
-     * ```
-     */
-    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
-     * ```typescript
-     * const { shipmentMethods, pricedLocations } = await client.shipping.getWithLocations("00100");
      *
      * // Show pickup locations
-     * pricedLocations.forEach(location => {
+     * 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.merchantPrice ?? 0) / 100}€`);
+     *   console.log(`  Price: ${location.price / 100}€`);
      * });
      * ```
      *
-     * @example Weight-based filtering with postal code
+     * @example Weight-based filtering
      * ```typescript
-     * const { shipmentMethods, pricedLocations } = await client.shipping.getWithLocations(
+     * const { homeDeliveryMethods, pickupLocations } = await client.shipping.getWithLocations(
      *   "00100",
      *   { cartItems: cartItems }
      * );
-     *
      * // Only shows methods that support the cart's total weight
      * ```
      */
@@ -2488,4 +2445,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 FreeShippingCampaign, 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 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 };

package/dist/index.js

@@ -620,70 +620,37 @@ function calculateCartWeight(items) {
 function createShippingResource(fetcher) {
   return {
     /**
-     * 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 home delivery methods and pickup locations.
      *
+     * @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 Home delivery methods and pickup locations
      *
      * @example
      * ```typescript
-     * const { shipmentMethods } = await client.shipping.getMethods();
+     * const { homeDeliveryMethods, pickupLocations } = await client.shipping.getWithLocations("00100");
      *
-     * shipmentMethods.forEach(method => {
+     * // Show home delivery options
+     * homeDeliveryMethods.forEach(method => {
      *   console.log(`${method.name}: ${method.price / 100}€`);
      * });
-     * ```
-     *
-     * @example Weight-based filtering
-     * ```typescript
-     * // Pass cart items - SDK calculates weight automatically
-     * const { shipmentMethods } = await client.shipping.getMethods({
-     *   cartItems: cartItems
-     * });
-     * ```
-     */
-    async getMethods(options) {
-      const params = new URLSearchParams();
-      if (options?.cartItems?.length) {
-        const cartWeight = calculateCartWeight(options.cartItems);
-        params.set("cartWeight", cartWeight.toString());
-      }
-      const queryString = params.toString();
-      const url = `/api/storefront/v1/shipment-methods${queryString ? `?${queryString}` : ""}`;
-      return fetcher.request(url, {
-        method: "GET",
-        ...options
-      });
-    },
-    /**
-     * 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
-     * ```typescript
-     * const { shipmentMethods, pricedLocations } = await client.shipping.getWithLocations("00100");
      *
      * // Show pickup locations
-     * pricedLocations.forEach(location => {
+     * 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.merchantPrice ?? 0) / 100}€`);
+     *   console.log(`  Price: ${location.price / 100}€`);
      * });
      * ```
      *
-     * @example Weight-based filtering with postal code
+     * @example Weight-based filtering
      * ```typescript
-     * const { shipmentMethods, pricedLocations } = await client.shipping.getWithLocations(
+     * const { homeDeliveryMethods, pickupLocations } = await client.shipping.getWithLocations(
      *   "00100",
      *   { cartItems: cartItems }
      * );
-     *
      * // Only shows methods that support the cart's total weight
      * ```
      */
@@ -1471,9 +1438,6 @@ function getPriceInfo(product, variation) {
 
 // src/utils/cart-calculations.ts
 function calculateCartWithCampaigns(items, campaigns) {
-  const freeShippingCampaign = campaigns.find(
-    (c) => c.type === "FREE_SHIPPING" && c.isActive
-  );
   const buyXPayYCampaign = campaigns.find(
     (c) => c.type === "BUY_X_PAY_Y" && c.isActive
   );
@@ -1481,6 +1445,11 @@ function calculateCartWithCampaigns(items, campaigns) {
     const priceInfo = getPriceInfo(product, variation);
     return total + priceInfo.effectivePrice * cartQuantity;
   }, 0);
+  const freeShipping = {
+    isEligible: false,
+    minimumSpend: 0,
+    remainingAmount: 0
+  };
   if (!buyXPayYCampaign?.BuyXPayYCampaign) {
     const calculatedItems2 = items.map((item) => ({
       item,
@@ -1488,16 +1457,12 @@ function calculateCartWithCampaigns(items, campaigns) {
       freeQuantity: 0,
       totalQuantity: item.cartQuantity
     }));
-    const freeShipping2 = calculateFreeShipping(
-      originalTotal,
-      freeShippingCampaign
-    );
     return {
       calculatedItems: calculatedItems2,
       cartTotal: originalTotal,
       originalTotal,
       totalSavings: 0,
-      freeShipping: freeShipping2
+      freeShipping
     };
   }
   const { buyQuantity, payQuantity, applicableCategories } = buyXPayYCampaign.BuyXPayYCampaign;
@@ -1528,16 +1493,12 @@ function calculateCartWithCampaigns(items, campaigns) {
       freeQuantity: 0,
       totalQuantity: item.cartQuantity
     }));
-    const freeShipping2 = calculateFreeShipping(
-      originalTotal,
-      freeShippingCampaign
-    );
     return {
       calculatedItems: calculatedItems2,
       cartTotal: originalTotal,
       originalTotal,
       totalSavings: 0,
-      freeShipping: freeShipping2
+      freeShipping
     };
   }
   eligibleUnits.sort((a, b) => a.price - b.price);
@@ -1564,7 +1525,6 @@ function calculateCartWithCampaigns(items, campaigns) {
     };
   });
   const cartTotal = originalTotal - totalSavings;
-  const freeShipping = calculateFreeShipping(cartTotal, freeShippingCampaign);
   return {
     calculatedItems,
     cartTotal,
@@ -1573,28 +1533,6 @@ function calculateCartWithCampaigns(items, campaigns) {
     freeShipping
   };
 }
-function calculateFreeShipping(cartTotal, campaign) {
-  if (!campaign?.FreeShippingCampaign) {
-    return {
-      isEligible: false,
-      minimumSpend: 0,
-      remainingAmount: 0
-    };
-  }
-  const minimumSpend = campaign.FreeShippingCampaign.minimumSpend;
-  const isEligible = cartTotal >= minimumSpend;
-  const remainingAmount = isEligible ? 0 : minimumSpend - cartTotal;
-  const eligibleShipmentMethodIds = campaign.FreeShippingCampaign.shipmentMethods?.map(
-    (method) => method.id
-  );
-  return {
-    isEligible,
-    minimumSpend,
-    remainingAmount,
-    campaignName: campaign.name,
-    eligibleShipmentMethodIds
-  };
-}
 export {
   AuthError,
   NotFoundError,