@reactionary/provider-medusa 0.1.2 → 0.1.4

package/core/client.js

@@ -122,7 +122,7 @@ class MedusaClient {
     const productsResponse = await adminClient.admin.product.list({
       limit: 1,
       offset: 0,
-      fields: "+categories.metadata.*",
+      fields: "+metadata.*,+categories.metadata.*",
       variants: {
         $or: [{ ean: sku }, { upc: sku }, { barcode: sku }]
       }

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@reactionary/provider-medusa",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "type": "module",
   "main": "index.js",
   "types": "src/index.d.ts",
   "dependencies": {
     "zod": "4.1.9",
-    "@reactionary/core": "0.1.2",
+    "@reactionary/core": "0.1.4",
     "@medusajs/js-sdk": "^2.0.0",
     "debug": "^4.3.4",
     "@medusajs/types": "^2.11.0",

package/providers/cart.provider.js

@@ -10,33 +10,37 @@ var __decorateClass = (decorators, target, key, kind) => {
   return result;
 };
 import {
-  CartItemSchema,
-  CartProvider,
-  CartSchema,
   CartIdentifierSchema,
-  CartQueryByIdSchema,
+  CartMutationApplyCouponSchema,
+  CartMutationChangeCurrencySchema,
+  CartMutationDeleteCartSchema,
   CartMutationItemAddSchema,
-  CartMutationItemRemoveSchema,
   CartMutationItemQuantityChangeSchema,
-  CartMutationDeleteCartSchema,
-  CartMutationApplyCouponSchema,
+  CartMutationItemRemoveSchema,
   CartMutationRemoveCouponSchema,
-  CartMutationChangeCurrencySchema,
+  CartProvider,
+  CartQueryByIdSchema,
+  CartSchema,
   ProductVariantIdentifierSchema,
   Reactionary
 } from "@reactionary/core";
 import createDebug from "debug";
-import { MedusaAdminClient } from "../core/client.js";
 import {
-  MedusaCartIdentifierSchema,
-  MedusaOrderIdentifierSchema,
-  MedusaSessionSchema
+  MedusaCartIdentifierSchema
 } from "../schema/medusa.schema.js";
+import { handleProviderError, parseMedusaCostBreakdown, parseMedusaItemPrice } from "../utils/medusa-helpers.js";
 const debug = createDebug("reactionary:medusa:cart");
 class MedusaCartProvider extends CartProvider {
   constructor(config, cache, context, client) {
     super(cache, context);
     this.client = client;
+    /**
+     * This controls which fields are always included when fetching a cart
+     * You can override this in a subclass to add more fields as needed.
+     *
+     * example: this.includedFields = [includedFields, '+discounts.*'].join(',');
+     */
+    this.includedFields = ["+items.*"].join(",");
     this.config = config;
   }
   async getById(payload) {
@@ -78,7 +82,6 @@ class MedusaCartProvider extends CartProvider {
         );
       }
       const variantId = await this.client.resolveVariantId(payload.variant.sku);
-      const cc = this.context.languageContext;
       const response = await client.store.cart.createLineItem(
         medusaId.key,
         {
@@ -86,7 +89,7 @@ class MedusaCartProvider extends CartProvider {
           quantity: payload.quantity
         },
         {
-          fields: "+items.*"
+          fields: this.includedFields
         }
       );
       if (debug.enabled) {
@@ -97,10 +100,7 @@ class MedusaCartProvider extends CartProvider {
       }
       throw new Error("Failed to add item to cart");
     } catch (error) {
-      debug("Failed to add item to cart:", error);
-      throw new Error(
-        `Failed to add item to cart: ${error instanceof Error ? error.message : "Unknown error"}`
-      );
+      handleProviderError("add item to cart", error);
     }
   }
   async remove(payload) {
@@ -111,7 +111,7 @@ class MedusaCartProvider extends CartProvider {
         medusaId.key,
         payload.item.key,
         {
-          fields: "+items.*"
+          fields: this.includedFields
         }
       );
       if (response.parent) {
@@ -119,10 +119,7 @@ class MedusaCartProvider extends CartProvider {
       }
       throw new Error("Failed to remove item from cart");
     } catch (error) {
-      debug("Failed to remove item from cart:", error);
-      throw new Error(
-        `Failed to remove item from cart: ${error instanceof Error ? error.message : "Unknown error"}`
-      );
+      handleProviderError("remove item from cart", error);
     }
   }
   async changeQuantity(payload) {
@@ -141,7 +138,7 @@ class MedusaCartProvider extends CartProvider {
           quantity: payload.quantity
         },
         {
-          fields: "+items.*"
+          fields: this.includedFields
         }
       );
       if (response.cart) {
@@ -149,10 +146,7 @@ class MedusaCartProvider extends CartProvider {
       }
       throw new Error("Failed to change item quantity");
     } catch (error) {
-      debug("Failed to change item quantity:", error);
-      throw new Error(
-        `Failed to change item quantity: ${error instanceof Error ? error.message : "Unknown error"}`
-      );
+      handleProviderError("change item quantity", error);
     }
   }
   async getActiveCartId() {
@@ -217,7 +211,7 @@ class MedusaCartProvider extends CartProvider {
           promo_codes: [payload.couponCode]
         },
         {
-          fields: "+items.*"
+          fields: this.includedFields
         }
       );
       if (response.cart) {
@@ -225,10 +219,7 @@ class MedusaCartProvider extends CartProvider {
       }
       throw new Error("Failed to apply coupon code");
     } catch (error) {
-      debug("Failed to apply coupon code:", error);
-      throw new Error(
-        `Failed to apply coupon code: ${error instanceof Error ? error.message : "Unknown error"}`
-      );
+      handleProviderError("apply coupon code", error);
     }
   }
   async removeCouponCode(payload) {
@@ -243,6 +234,8 @@ class MedusaCartProvider extends CartProvider {
         const remainingCodes = manualDiscounts.filter((x) => x.code !== payload.couponCode).map((promotion) => promotion.code) || [];
         const response = await client.store.cart.update(medusaId.key, {
           promo_codes: remainingCodes || []
+        }, {
+          fields: this.includedFields
         });
         if (response.cart) {
           return this.parseSingle(response.cart);
@@ -250,10 +243,7 @@ class MedusaCartProvider extends CartProvider {
       }
       throw new Error("Failed to remove coupon code");
     } catch (error) {
-      debug("Failed to remove coupon code:", error);
-      throw new Error(
-        `Failed to remove coupon code: ${error instanceof Error ? error.message : "Unknown error"}`
-      );
+      handleProviderError("remove coupon code", error);
     }
   }
   async changeCurrency(payload) {
@@ -268,7 +258,7 @@ class MedusaCartProvider extends CartProvider {
           region_id: (await this.client.getActiveRegion()).id
         },
         {
-          fields: "+items.*"
+          fields: this.includedFields
         }
       );
       if (!currentCartResponse.cart) {
@@ -285,10 +275,7 @@ class MedusaCartProvider extends CartProvider {
       }
       throw new Error("Failed to change currency");
     } catch (error) {
-      debug("Failed to change currency:", error);
-      throw new Error(
-        `Failed to change currency: ${error instanceof Error ? error.message : "Unknown error"}`
-      );
+      handleProviderError("change currency", error);
     }
   }
   async createCart(currency) {
@@ -299,7 +286,7 @@ class MedusaCartProvider extends CartProvider {
           currency_code: (currency || this.context.languageContext.currencyCode || "").toLowerCase()
         },
         {
-          fields: "+items.*"
+          fields: this.includedFields
         }
       );
       if (response.cart) {
@@ -314,19 +301,36 @@ class MedusaCartProvider extends CartProvider {
       }
       throw new Error("Failed to create cart");
     } catch (error) {
-      debug("Failed to create cart:", error);
-      throw new Error(
-        `Failed to create cart: ${error instanceof Error ? error.message : "Unknown error"}`
-      );
+      handleProviderError("create cart", error);
     }
   }
   async getClient() {
     return this.client.getClient();
   }
+  /**
+   * Extension point to control the parsing of a single cart item price
+   * @param remoteItem
+   * @param currency
+   * @returns
+   */
+  parseItemPrice(remoteItem, currency) {
+    return parseMedusaItemPrice(remoteItem, currency);
+  }
+  /**
+   * Extension point to control the parsing of the cost breakdown of a cart
+   * @param remote
+   * @returns
+   */
+  parseCostBreakdown(remote) {
+    return parseMedusaCostBreakdown(remote);
+  }
+  /**
+   * Extension point to control the parsing of a single cart item
+   * @param remoteItem
+   * @param currency
+   * @returns
+   */
   parseCartItem(remoteItem, currency) {
-    const unitPrice = remoteItem.unit_price || 0;
-    const totalPrice = unitPrice * remoteItem.quantity || 0;
-    const discountTotal = remoteItem.discount_total || 0;
     const item = {
       identifier: {
         key: remoteItem.id
@@ -338,27 +342,15 @@ class MedusaCartProvider extends CartProvider {
         sku: remoteItem.variant_sku || ""
       }),
       quantity: remoteItem.quantity || 1,
-      price: {
-        unitPrice: {
-          value: unitPrice,
-          currency
-        },
-        unitDiscount: {
-          value: discountTotal / remoteItem.quantity,
-          currency
-        },
-        totalPrice: {
-          value: totalPrice,
-          currency
-        },
-        totalDiscount: {
-          value: discountTotal,
-          currency
-        }
-      }
+      price: parseMedusaItemPrice(remoteItem, currency)
     };
     return item;
   }
+  /**
+   * Extension point to control the parsing of a single cart
+   * @param remote
+   * @returns
+   */
   parseSingle(remote) {
     const identifier = MedusaCartIdentifierSchema.parse({
       key: remote.id,
@@ -366,43 +358,12 @@ class MedusaCartProvider extends CartProvider {
     });
     const name = "" + (remote.metadata?.["name"] || "");
     const description = "" + (remote.metadata?.["description"] || "");
-    const grandTotal = remote.total || 0;
-    const shippingTotal = remote.shipping_total || 0;
-    const taxTotal = remote.tax_total || 0;
-    const discountTotal = remote.discount_total || 0;
-    const subtotal = remote.subtotal || 0;
-    const currency = (remote.currency_code || "EUR").toUpperCase();
-    const price = {
-      totalTax: {
-        value: taxTotal,
-        currency
-      },
-      totalDiscount: {
-        value: discountTotal,
-        currency
-      },
-      totalSurcharge: {
-        value: 0,
-        currency
-      },
-      totalShipping: {
-        value: shippingTotal,
-        currency
-      },
-      totalProductPrice: {
-        value: subtotal,
-        currency
-      },
-      grandTotal: {
-        value: grandTotal,
-        currency
-      }
-    };
+    const price = this.parseCostBreakdown(remote);
     const items = new Array();
     const allItems = remote.items || [];
     allItems.sort((a, b) => a.created_at && b.created_at ? new Date(a.created_at).getTime() - new Date(b.created_at).getTime() : 0);
     for (const remoteItem of allItems) {
-      items.push(this.parseCartItem(remoteItem, remote.currency_code.toUpperCase()));
+      items.push(this.parseCartItem(remoteItem, price.grandTotal.currency));
     }
     const meta = {
       cache: {

package/providers/checkout.provider.js

@@ -30,6 +30,7 @@ import {
 } from "@reactionary/core";
 import createDebug from "debug";
 import z from "zod";
+import { handleProviderError, parseMedusaCostBreakdown, parseMedusaItemPrice } from "../utils/medusa-helpers.js";
 import {
 } from "../schema/medusa.schema.js";
 const debug = createDebug("reactionary:medusa:checkout");
@@ -46,7 +47,13 @@ class MedusaCheckoutProvider extends CheckoutProvider {
   constructor(config, cache, context, client) {
     super(cache, context);
     this.client = client;
-    this.returnedCheckoutFields = "+items.*";
+    /**
+     * This controls which fields are always included when fetching a cart
+     * You can override this in a subclass to add more fields as needed.
+     *
+     * example: this.includedFields = [includedFields, '+discounts.*'].join(',');
+     */
+    this.includedFields = ["+items.*"].join(",");
     this.config = config;
   }
   async initiateCheckoutForCart(payload) {
@@ -67,7 +74,7 @@ class MedusaCheckoutProvider extends CheckoutProvider {
         }
       },
       {
-        fields: this.returnedCheckoutFields
+        fields: this.includedFields
       }
     );
     return this.parseSingle(response.cart);
@@ -75,7 +82,7 @@ class MedusaCheckoutProvider extends CheckoutProvider {
   async getById(payload) {
     const client = await this.client.getClient();
     const response = await client.store.cart.retrieve(payload.identifier.key, {
-      fields: this.returnedCheckoutFields
+      fields: this.includedFields
     });
     return this.parseSingle(response.cart);
   }
@@ -89,7 +96,7 @@ class MedusaCheckoutProvider extends CheckoutProvider {
         )
       },
       {
-        fields: this.returnedCheckoutFields
+        fields: this.includedFields
       }
     );
     return this.parseSingle(response.cart);
@@ -189,7 +196,7 @@ class MedusaCheckoutProvider extends CheckoutProvider {
       const updatedCartResponse = await client.store.cart.retrieve(
         payload.checkout.key,
         {
-          fields: this.returnedCheckoutFields
+          fields: this.includedFields
         }
       );
       return this.parseSingle(updatedCartResponse.cart);
@@ -224,17 +231,14 @@ class MedusaCheckoutProvider extends CheckoutProvider {
         }
       });
       const response = await client.store.cart.retrieve(medusaId.key, {
-        fields: this.returnedCheckoutFields
+        fields: this.includedFields
       });
       if (response.cart) {
         return this.parseSingle(response.cart);
       }
-      throw new Error("Failed to set shipping info");
+      throw new Error("Failed to set shipping method");
     } catch (error) {
-      debug("Failed to set shipping info:", error);
-      throw new Error(
-        `Failed to set shipping info: ${error instanceof Error ? error.message : "Unknown error"}`
-      );
+      handleProviderError("set shipping method", error);
     }
   }
   async finalizeCheckout(payload) {
@@ -258,6 +262,11 @@ class MedusaCheckoutProvider extends CheckoutProvider {
     }
     throw new Error("Something failed during order creation");
   }
+  /**
+   * Extension point to map an Address to a Store Address
+   * @param address
+   * @returns
+   */
   mapAddressToStoreAddress(address) {
     return {
       first_name: address.firstName,
@@ -269,6 +278,11 @@ class MedusaCheckoutProvider extends CheckoutProvider {
       country_code: address.countryCode?.toLowerCase()
     };
   }
+  /**
+   * Extension point to control the parsing of an address from a store cart address
+   * @param storeAddress
+   * @returns
+   */
   composeAddressFromStoreAddress(storeAddress) {
     return {
       identifier: AddressIdentifierSchema.parse({
@@ -291,6 +305,29 @@ class MedusaCheckoutProvider extends CheckoutProvider {
       region: ""
     };
   }
+  /**
+   * Extension point to control the parsing of a single cart item price
+   * @param remoteItem
+   * @param currency
+   * @returns
+   */
+  parseItemPrice(remoteItem, currency) {
+    return parseMedusaItemPrice(remoteItem, currency);
+  }
+  /**
+   * Extension point to control the parsing of the cost breakdown of a cart
+   * @param remote
+   * @returns
+   */
+  parseCostBreakdown(remote) {
+    return parseMedusaCostBreakdown(remote);
+  }
+  /**
+   * Extension point to control the parsing of a single checkout item
+   * @param remoteItem
+   * @param currency
+   * @returns
+   */
   parseCheckoutItem(remoteItem, currency) {
     const unitPrice = remoteItem.unit_price || 0;
     const totalPrice = unitPrice * remoteItem.quantity || 0;
@@ -303,27 +340,15 @@ class MedusaCheckoutProvider extends CheckoutProvider {
         sku: remoteItem.variant_sku || ""
       },
       quantity: remoteItem.quantity || 1,
-      price: {
-        unitPrice: {
-          value: unitPrice,
-          currency
-        },
-        unitDiscount: {
-          value: discountTotal / remoteItem.quantity,
-          currency
-        },
-        totalPrice: {
-          value: totalPrice,
-          currency
-        },
-        totalDiscount: {
-          value: discountTotal,
-          currency
-        }
-      }
+      price: this.parseItemPrice(remoteItem, currency)
     };
     return item;
   }
+  /**
+   * Extension point to control the parsing of the Checkout object
+   * @param remote
+   * @returns
+   */
   parseSingle(remote) {
     const identifier = {
       key: remote.id
@@ -331,41 +356,10 @@ class MedusaCheckoutProvider extends CheckoutProvider {
     };
     const name = "" + (remote.metadata?.["name"] || "");
     const description = "" + (remote.metadata?.["description"] || "");
-    const grandTotal = remote.total || 0;
-    const shippingTotal = remote.shipping_total || 0;
-    const taxTotal = remote.tax_total || 0;
-    const discountTotal = remote.discount_total || 0;
-    const subtotal = remote.subtotal || 0;
-    const currency = (remote.currency_code || "EUR").toUpperCase();
-    const price = {
-      totalTax: {
-        value: taxTotal,
-        currency
-      },
-      totalDiscount: {
-        value: discountTotal,
-        currency
-      },
-      totalSurcharge: {
-        value: 0,
-        currency
-      },
-      totalShipping: {
-        value: shippingTotal,
-        currency
-      },
-      totalProductPrice: {
-        value: subtotal,
-        currency
-      },
-      grandTotal: {
-        value: grandTotal,
-        currency
-      }
-    };
+    const price = this.parseCostBreakdown(remote);
     const items = new Array();
     for (const remoteItem of remote.items || []) {
-      items.push(this.parseCheckoutItem(remoteItem, currency));
+      items.push(this.parseCheckoutItem(remoteItem, price.grandTotal.currency));
     }
     const meta = {
       cache: {

package/providers/product.provider.js

@@ -34,7 +34,9 @@ class MedusaProductProvider extends ProductProvider {
     }
     let response;
     try {
-      response = await client.store.product.retrieve(payload.identifier.key);
+      response = await client.store.product.retrieve(payload.identifier.key, {
+        fields: "+metadata,+categories.metadata.*"
+      });
     } catch (error) {
       if (debug.enabled) {
         debug(`Product with ID: ${payload.identifier.key} not found, returning empty product. Error %O `, error);
@@ -51,7 +53,8 @@ class MedusaProductProvider extends ProductProvider {
     const response = await client.store.product.list({
       handle: payload.slug,
       limit: 1,
-      offset: 0
+      offset: 0,
+      fields: "+metadata.*"
     });
     if (debug.enabled) {
       debug(`Found ${response.count} products for slug: ${payload.slug}`);
@@ -183,6 +186,11 @@ class MedusaProductProvider extends ProductProvider {
     if (_body.material) {
       sharedAttributes.push(this.createSynthAttribute("material", "Material", _body.material));
     }
+    if (_body.metadata) {
+      for (const [key, value] of Object.entries(_body.metadata)) {
+        sharedAttributes.push(this.createSynthAttribute(key, key, String(value)));
+      }
+    }
     return sharedAttributes;
   }
 }

package/src/providers/cart.provider.d.ts

@@ -1,4 +1,4 @@
-import type { Cache, Cart, CartIdentifier, CartMutationApplyCoupon, CartMutationChangeCurrency, CartMutationDeleteCart, CartMutationItemAdd, CartMutationItemQuantityChange, CartMutationItemRemove, CartMutationRemoveCoupon, CartQueryById, Currency, RequestContext, CartItem } from '@reactionary/core';
+import type { Cache, Cart, CartIdentifier, CartItem, CartMutationApplyCoupon, CartMutationChangeCurrency, CartMutationDeleteCart, CartMutationItemAdd, CartMutationItemQuantityChange, CartMutationItemRemove, CartMutationRemoveCoupon, CartQueryById, CostBreakDown, Currency, ItemCostBreakdown, RequestContext } from '@reactionary/core';
 import { CartProvider } from '@reactionary/core';
 import type { MedusaClient } from '../core/client.js';
 import type { MedusaConfiguration } from '../schema/configuration.schema.js';
@@ -6,6 +6,13 @@ import type MedusaTypes = require('@medusajs/types');
 export declare class MedusaCartProvider extends CartProvider {
     client: MedusaClient;
     protected config: MedusaConfiguration;
+    /**
+     * This controls which fields are always included when fetching a cart
+     * You can override this in a subclass to add more fields as needed.
+     *
+     * example: this.includedFields = [includedFields, '+discounts.*'].join(',');
+     */
+    protected includedFields: string;
     constructor(config: MedusaConfiguration, cache: Cache, context: RequestContext, client: MedusaClient);
     getById(payload: CartQueryById): Promise<Cart>;
     add(payload: CartMutationItemAdd): Promise<Cart>;
@@ -23,6 +30,30 @@ export declare class MedusaCartProvider extends CartProvider {
         store: import("@medusajs/js-sdk").Store;
         auth: import("@medusajs/js-sdk").Auth;
     }>;
+    /**
+     * Extension point to control the parsing of a single cart item price
+     * @param remoteItem
+     * @param currency
+     * @returns
+     */
+    protected parseItemPrice(remoteItem: MedusaTypes.StoreCartLineItem, currency: Currency): ItemCostBreakdown;
+    /**
+     * Extension point to control the parsing of the cost breakdown of a cart
+     * @param remote
+     * @returns
+     */
+    protected parseCostBreakdown(remote: MedusaTypes.StoreCart): CostBreakDown;
+    /**
+     * Extension point to control the parsing of a single cart item
+     * @param remoteItem
+     * @param currency
+     * @returns
+     */
     protected parseCartItem(remoteItem: MedusaTypes.StoreCartLineItem, currency: Currency): CartItem;
+    /**
+     * Extension point to control the parsing of a single cart
+     * @param remote
+     * @returns
+     */
     protected parseSingle(remote: MedusaTypes.StoreCart): Cart;
 }

package/src/providers/checkout.provider.d.ts

@@ -1,5 +1,5 @@
-import type { StoreCart } from '@medusajs/types';
-import type { Address, Cache, Checkout, CheckoutIdentifier, CheckoutItem, CheckoutMutationAddPaymentInstruction, CheckoutMutationFinalizeCheckout, CheckoutMutationInitiateCheckout, CheckoutMutationRemovePaymentInstruction, CheckoutMutationSetShippingAddress, CheckoutMutationSetShippingInstruction, CheckoutQueryById, CheckoutQueryForAvailablePaymentMethods, CheckoutQueryForAvailableShippingMethods, Currency, PaymentMethod, RequestContext, ShippingMethod } from '@reactionary/core';
+import type { StoreCart, StoreCartAddress, StoreCartLineItem } from '@medusajs/types';
+import type { Address, Cache, Checkout, CheckoutIdentifier, CheckoutItem, CheckoutMutationAddPaymentInstruction, CheckoutMutationFinalizeCheckout, CheckoutMutationInitiateCheckout, CheckoutMutationRemovePaymentInstruction, CheckoutMutationSetShippingAddress, CheckoutMutationSetShippingInstruction, CheckoutQueryById, CheckoutQueryForAvailablePaymentMethods, CheckoutQueryForAvailableShippingMethods, CostBreakDown, Currency, ItemCostBreakdown, PaymentMethod, RequestContext, ShippingMethod } from '@reactionary/core';
 import { CheckoutProvider } from '@reactionary/core';
 import type { MedusaClient } from '../core/client.js';
 import type { MedusaConfiguration } from '../schema/configuration.schema.js';
@@ -10,7 +10,13 @@ export declare class CheckoutNotReadyForFinalizationError extends Error {
 export declare class MedusaCheckoutProvider extends CheckoutProvider {
     client: MedusaClient;
     protected config: MedusaConfiguration;
-    protected returnedCheckoutFields: string;
+    /**
+     * This controls which fields are always included when fetching a cart
+     * You can override this in a subclass to add more fields as needed.
+     *
+     * example: this.includedFields = [includedFields, '+discounts.*'].join(',');
+     */
+    protected includedFields: string;
     constructor(config: MedusaConfiguration, cache: Cache, context: RequestContext, client: MedusaClient);
     initiateCheckoutForCart(payload: CheckoutMutationInitiateCheckout): Promise<Checkout>;
     getById(payload: CheckoutQueryById): Promise<Checkout | null>;
@@ -21,6 +27,11 @@ export declare class MedusaCheckoutProvider extends CheckoutProvider {
     removePaymentInstruction(payload: CheckoutMutationRemovePaymentInstruction): Promise<Checkout>;
     setShippingInstruction(payload: CheckoutMutationSetShippingInstruction): Promise<Checkout>;
     finalizeCheckout(payload: CheckoutMutationFinalizeCheckout): Promise<Checkout>;
+    /**
+     * Extension point to map an Address to a Store Address
+     * @param address
+     * @returns
+     */
     protected mapAddressToStoreAddress(address: Partial<Address>): {
         first_name: string | undefined;
         last_name: string | undefined;
@@ -30,7 +41,36 @@ export declare class MedusaCheckoutProvider extends CheckoutProvider {
         postal_code: string | undefined;
         country_code: string | undefined;
     };
-    protected composeAddressFromStoreAddress(storeAddress: any): Address;
-    protected parseCheckoutItem(remoteItem: any, currency: Currency): CheckoutItem;
+    /**
+     * Extension point to control the parsing of an address from a store cart address
+     * @param storeAddress
+     * @returns
+     */
+    protected composeAddressFromStoreAddress(storeAddress: StoreCartAddress): Address;
+    /**
+     * Extension point to control the parsing of a single cart item price
+     * @param remoteItem
+     * @param currency
+     * @returns
+     */
+    protected parseItemPrice(remoteItem: StoreCartLineItem, currency: Currency): ItemCostBreakdown;
+    /**
+     * Extension point to control the parsing of the cost breakdown of a cart
+     * @param remote
+     * @returns
+     */
+    protected parseCostBreakdown(remote: StoreCart): CostBreakDown;
+    /**
+     * Extension point to control the parsing of a single checkout item
+     * @param remoteItem
+     * @param currency
+     * @returns
+     */
+    protected parseCheckoutItem(remoteItem: StoreCartLineItem, currency: Currency): CheckoutItem;
+    /**
+     * Extension point to control the parsing of the Checkout object
+     * @param remote
+     * @returns
+     */
     protected parseSingle(remote: StoreCart): Checkout;
 }

package/src/utils/medusa-helpers.d.ts

@@ -0,0 +1,35 @@
+import type { StoreCart } from '@medusajs/types';
+import type { CostBreakDown, Currency } from '@reactionary/core';
+/**
+ * Parses cost breakdown from Medusa StoreCart
+ */
+export declare function parseMedusaCostBreakdown(remote: StoreCart): CostBreakDown;
+/**
+ * Parses item price structure from Medusa line item
+ */
+export declare function parseMedusaItemPrice(remoteItem: {
+    unit_price?: number;
+    quantity: number;
+    discount_total?: number;
+}, currency: Currency): {
+    unitPrice: {
+        value: number;
+        currency: Currency;
+    };
+    unitDiscount: {
+        value: number;
+        currency: Currency;
+    };
+    totalPrice: {
+        value: number;
+        currency: Currency;
+    };
+    totalDiscount: {
+        value: number;
+        currency: Currency;
+    };
+};
+/**
+ * Handles provider errors with consistent formatting
+ */
+export declare function handleProviderError(action: string, error: unknown): never;

package/test/cart.provider.spec.js

@@ -1,8 +1,8 @@
-import { CartSchema, NoOpCache, createInitialRequestContext } from "@reactionary/core";
-import { beforeAll, beforeEach, describe, expect, it } from "vitest";
+import { NoOpCache, createInitialRequestContext } from "@reactionary/core";
+import { beforeEach, describe, expect, it } from "vitest";
+import { MedusaClient } from "../core/client.js";
 import { MedusaCartProvider } from "../providers/cart.provider.js";
 import { getMedusaTestConfiguration } from "./test-utils.js";
-import { MedusaClient } from "../core/client.js";
 const testData = {
   skuWithoutTiers: "4047443491480",
   skuWithTiers: "0819927012825"

package/test/product.provider.spec.js

@@ -31,6 +31,9 @@ describe("Medusa Product Provider", () => {
     expect(result.mainVariant).toBeDefined();
     expect(result.mainVariant.identifier.sku).toBe(testData.product.sku);
     expect(result.mainVariant.images[0].sourceUrl).toBe(testData.product.image);
+    expect(result.sharedAttributes.length).toBeGreaterThan(1);
+    expect(result.sharedAttributes[1].values.length).toBeGreaterThan(0);
+    expect(result.sharedAttributes[1].values[0].value).toBeTruthy();
   });
   it("should be able to get a product by slug", async () => {
     const result = await provider.getBySlug({ slug: testData.product.slug });
@@ -58,12 +61,22 @@ describe("Medusa Product Provider", () => {
       expect(result.mainVariant).toBeDefined();
       expect(result.mainVariant.identifier.sku).toBe(testData.product.sku);
       expect(result.mainVariant.images[0].sourceUrl).toBe(testData.product.image);
+      expect(result.sharedAttributes.length).toBeGreaterThan(1);
+      expect(result.sharedAttributes[1].values.length).toBeGreaterThan(0);
+      expect(result.sharedAttributes[1].values[0].value).toBeTruthy();
     }
   });
   it("should return null for unknown slug", async () => {
     const result = await provider.getBySlug({ slug: "unknown-slug" });
     expect(result).toBeNull();
   });
+  it("should contain both product level and variant level attributes", async () => {
+    const result = await provider.getBySlug({ slug: testData.product.slug });
+    expect(result).toBeTruthy();
+    expect(result.sharedAttributes.length).toBeGreaterThan(1);
+    expect(result.sharedAttributes[1].values.length).toBeGreaterThan(0);
+    expect(result.sharedAttributes[1].values[0].value).toBeTruthy();
+  });
   it("should return a placeholder product for unknown id", async () => {
     const result = await provider.getById({ identifier: { key: "unknown-id" } });
     expect(result).toBeTruthy();

package/utils/medusa-helpers.js

@@ -0,0 +1,72 @@
+import createDebug from "debug";
+const debug = createDebug("reactionary:medusa:helpers");
+function parseMedusaCostBreakdown(remote) {
+  const grandTotal = remote.total || 0;
+  const shippingTotal = remote.shipping_total || 0;
+  const taxTotal = remote.tax_total || 0;
+  const discountTotal = remote.discount_total || 0;
+  const subtotal = remote.subtotal || 0;
+  const currency = (remote.currency_code || "EUR").toUpperCase();
+  return {
+    totalTax: {
+      value: taxTotal,
+      currency
+    },
+    totalDiscount: {
+      value: discountTotal,
+      currency
+    },
+    totalSurcharge: {
+      value: 0,
+      currency
+    },
+    totalShipping: {
+      value: shippingTotal,
+      currency
+    },
+    totalProductPrice: {
+      value: subtotal,
+      currency
+    },
+    grandTotal: {
+      value: grandTotal,
+      currency
+    }
+  };
+}
+function parseMedusaItemPrice(remoteItem, currency) {
+  const unitPrice = remoteItem.unit_price || 0;
+  const totalPrice = unitPrice * remoteItem.quantity || 0;
+  const discountTotal = remoteItem.discount_total || 0;
+  return {
+    unitPrice: {
+      value: unitPrice,
+      currency
+    },
+    unitDiscount: {
+      value: discountTotal / remoteItem.quantity,
+      currency
+    },
+    totalPrice: {
+      value: totalPrice,
+      currency
+    },
+    totalDiscount: {
+      value: discountTotal,
+      currency
+    }
+  };
+}
+function handleProviderError(action, error) {
+  if (debug.enabled) {
+    debug(`Failed to ${action}:`, error);
+  }
+  throw new Error(
+    `Failed to ${action}: ${error instanceof Error ? error.message : "Unknown error"}`
+  );
+}
+export {
+  handleProviderError,
+  parseMedusaCostBreakdown,
+  parseMedusaItemPrice
+};