@meeovi/layer-commerce 1.0.10 → 1.0.13

package/app/composables/models/index.ts

@@ -0,0 +1,94 @@
+import type { SfCart, SfCartCoupon, SfCartCouponCustom, SfCartLineItemCustom } from "./cart";
+import type { SfCategory, SfCategoryCustom } from "./category";
+import type { SfShippingMethod, SfShippingMethodCustom, SfShippingMethods } from "./checkout";
+import type { SfCustomer, SfCustomerAddress, SfCustomerCustom } from "./customer";
+import type { SfFacet, SfFacetCustom, SfFacetItem, SfFacetType, SfFacetTypes } from "./facets";
+import type {
+  SfOrder,
+  SfOrderCustom,
+  SfOrderLineItem,
+  SfOrderLineItemCustom,
+  SfOrderListItem,
+  SfOrderListItemCustom,
+} from "./order";
+import type {
+  SfPagination,
+  SfPaginationCustom,
+  SfProduct,
+  SfProductCatalogItem,
+  SfProductCatalogItemCustom,
+  SfProductCustom,
+  SfProductReview,
+  SfProductReviewCustom,
+  SfProductVariant,
+} from "./product";
+import type {
+  SfAddress,
+  SfAddressCustom,
+  SfAttribute,
+  SfAttributeCustom,
+  SfCreateAddressBody,
+  SfCurrency,
+  SfDiscountablePrice,
+  SfDiscountablePriceCustom,
+  SfImage,
+  SfImageCustom,
+  SfMoney,
+  SfMoneyCustom,
+} from "./shared";
+
+export * from "./cart";
+export * from "./category";
+export * from "./checkout";
+export * from "./customer";
+export * from "./facets";
+export * from "./product";
+export * from "./shared";
+export * from "./order";
+
+export interface SfContract {
+  SfCartLineItemCustom: SfCartLineItemCustom;
+  SfCartCouponCustom: SfCartCouponCustom;
+  SfCartCoupon: SfCartCoupon;
+  SfCart: SfCart;
+  SfCategoryCustom: SfCategoryCustom;
+  SfCategory: SfCategory;
+  SfShippingMethodCustom: SfShippingMethodCustom;
+  SfShippingMethod: SfShippingMethod;
+  SfShippingMethods: SfShippingMethods;
+  SfCustomerCustom: SfCustomerCustom;
+  SfCustomer: SfCustomer;
+  SfCustomerAddress: SfCustomerAddress;
+  SfFacetTypes: SfFacetTypes;
+  SfFacetType: SfFacetType;
+  SfFacetItem: SfFacetItem;
+  SfFacetCustom: SfFacetCustom;
+  SfFacet: SfFacet;
+  SfOrderLineItemCustom: SfOrderLineItemCustom;
+  SfOrderLineItem: SfOrderLineItem;
+  SfOrderCustom: SfOrderCustom;
+  SfOrder: SfOrder;
+  SfOrderListItemCustom: SfOrderListItemCustom;
+  SfOrderListItem: SfOrderListItem;
+  SfProductVariant: SfProductVariant;
+  SfProductReviewCustom: SfProductReviewCustom;
+  SfProductReview: SfProductReview;
+  SfProductCustom: SfProductCustom;
+  SfProduct: SfProduct;
+  SfProductCatalogItemCustom: SfProductCatalogItemCustom;
+  SfProductCatalogItem: SfProductCatalogItem;
+  SfPaginationCustom: SfPaginationCustom;
+  SfPagination: SfPagination;
+  SfMoneyCustom: SfMoneyCustom;
+  SfMoney: SfMoney;
+  SfDiscountablePriceCustom: SfDiscountablePriceCustom;
+  SfDiscountablePrice: SfDiscountablePrice;
+  SfImageCustom: SfImageCustom;
+  SfImage: SfImage;
+  SfAttributeCustom: SfAttributeCustom;
+  SfAttribute: SfAttribute;
+  SfCreateAddressBody: SfCreateAddressBody;
+  SfAddressCustom: SfAddressCustom;
+  SfAddress: SfAddress;
+  SfCurrency: SfCurrency;
+}

package/app/composables/models/order.ts

@@ -0,0 +1,43 @@
+import type { InferCustom } from "../defs";
+import type { SfShippingMethod } from "./checkout";
+import type { Maybe, SfAddress, SfAttribute, SfId, SfImage, SfMoney } from "./shared";
+
+export interface SfOrderLineItemCustom extends InferCustom<"normalizeOrderLineItem"> {}
+
+export interface SfOrderLineItem {
+  id: SfId;
+  attributes: SfAttribute[];
+  unitPrice: SfMoney;
+  totalPrice: SfMoney;
+  quantity: number;
+  image: Maybe<SfImage>;
+  productId: SfId;
+  productName: string;
+  sku: Maybe<string>;
+  $custom?: SfOrderLineItemCustom;
+}
+
+export interface SfOrderCustom extends InferCustom<"normalizeOrder"> {}
+
+export interface SfOrder {
+  id: SfId;
+  orderDate: string;
+  status: string;
+  lineItems: SfOrderLineItem[];
+  subtotalPrice: SfMoney;
+  totalShippingPrice: SfMoney;
+  totalTax: SfMoney;
+  totalPrice: SfMoney;
+  shippingAddress: SfAddress;
+  billingAddress: Maybe<SfAddress>;
+  shippingMethod: SfShippingMethod;
+  paymentMethod: string;
+  $custom?: SfOrderCustom;
+}
+
+export interface SfOrderListItemCustom extends InferCustom<"normalizeOrder"> {}
+
+export interface SfOrderListItem
+  extends Pick<SfOrder, "id" | "orderDate" | "totalPrice" | "status"> {
+  $custom?: SfOrderListItemCustom;
+}

package/app/composables/models/product.ts

@@ -0,0 +1,73 @@
+import type { InferCustom } from "../defs";
+import type { Maybe, SfAttribute, SfDiscountablePrice, SfId, SfImage } from "./shared";
+
+export interface SfProductVariant {
+  id: SfId;
+  slug: string;
+  sku: Maybe<string>;
+  name: Maybe<string>;
+  /*
+   * Maximum available quantity for variant, null if unlimited
+   */
+  quantityLimit: Maybe<number>;
+  attributes: SfAttribute[];
+}
+
+export interface SfProductReviewCustom extends InferCustom<"normalizeProductReview"> {}
+
+export interface SfProductReview {
+  id: SfId;
+  title: Maybe<string>;
+  text: Maybe<string>;
+  rating: Maybe<number>;
+  /*
+   * Name of the reviewer (Full name or nickname)
+   */
+  reviewer: Maybe<string>;
+  /*
+   * Creation date in ISO 8601 format
+   */
+  createdAt: string;
+  $custom?: SfProductReviewCustom;
+}
+
+export interface SfProductCustom extends InferCustom<"normalizeProduct"> {}
+
+export interface SfProduct {
+  id: SfId;
+  sku: Maybe<string>;
+  name: Maybe<string>;
+  slug: string;
+  description: Maybe<string>;
+  price: Maybe<SfDiscountablePrice>;
+  primaryImage: Maybe<SfImage>;
+  gallery: SfImage[];
+  rating: Maybe<{
+    average: number;
+    count: number;
+  }>;
+  variants: SfProductVariant[];
+  attributes: SfAttribute[];
+  /*
+   * Maximum available quantity for product, null if unlimited
+   */
+  quantityLimit: Maybe<number>;
+  $custom?: SfProductCustom;
+}
+
+export interface SfProductCatalogItemCustom extends InferCustom<"normalizeProductCatalogItem"> {}
+
+export interface SfProductCatalogItem
+  extends Omit<SfProduct, "variants" | "gallery" | "description" | "attributes"> {
+  $custom?: SfProductCatalogItemCustom;
+}
+
+export interface SfPaginationCustom extends InferCustom<"normalizePagination"> {}
+
+export interface SfPagination {
+  currentPage: number;
+  pageSize: Maybe<number>;
+  totalResults: number;
+  totalPages: number;
+  $custom?: SfPaginationCustom;
+}

package/app/composables/models/shared.ts

@@ -0,0 +1,75 @@
+import type { InferCustom } from "../defs";
+
+export type Maybe<TType> = TType | null;
+
+export type SfId = string;
+
+export interface SfMoneyCustom extends InferCustom<"normalizeMoney"> {}
+
+export interface SfMoney {
+  currency: string;
+  amount: number;
+  precisionAmount: string;
+  $custom?: SfMoneyCustom;
+}
+
+export interface SfDiscountablePriceCustom extends InferCustom<"normalizeDiscountablePrice"> {}
+
+export interface SfDiscountablePrice {
+  isDiscounted: boolean;
+  regularPrice: SfMoney;
+  /**
+   * Price with discounts. If there is no discount, it will be the same as regularPrice
+   */
+  value: SfMoney;
+  $custom?: SfDiscountablePriceCustom;
+}
+
+export interface SfImageCustom extends InferCustom<"normalizeImage"> {}
+
+export interface SfImage {
+  alt: Maybe<string>;
+  url: string;
+  $custom?: SfImageCustom;
+}
+
+export interface SfAttributeCustom extends InferCustom<"normalizeAttribute"> {}
+
+export interface SfAttribute {
+  label: string;
+  name: string;
+  value: string;
+  valueLabel: string;
+  $custom?: SfAttributeCustom;
+}
+
+export interface SfCreateAddressBody {
+  address1: string;
+  address2?: Maybe<string>;
+  city: string;
+  country: string;
+  firstName: string;
+  lastName: string;
+  phoneNumber: string;
+  postalCode: string;
+  state: string;
+  titleCode: string;
+}
+
+export interface SfAddressCustom extends InferCustom<"normalizeAddress"> {}
+
+export interface SfAddress {
+  address1: Maybe<string>;
+  address2?: Maybe<string>;
+  city: Maybe<string>;
+  country: Maybe<string>;
+  firstName: Maybe<string>;
+  lastName: Maybe<string>;
+  phoneNumber: Maybe<string>;
+  postalCode: Maybe<string>;
+  state: Maybe<string>;
+  titleCode: Maybe<string>;
+  $custom?: SfAddressCustom;
+}
+
+export type SfCurrency = string;

package/app/composables/products/registry.ts

@@ -0,0 +1,20 @@
+import { ProductProvider } from "./types"
+
+const providers: Record<string, ProductProvider> = {}
+
+export function registerProductProvider(name: string, provider: ProductProvider) {
+  providers[name] = provider
+}
+
+export function getProductProvider(name: string) {
+  const provider = providers[name]
+  if (!provider) throw new Error(`Product provider "${name}" not found`)
+  return provider
+}
+
+// Runtime helper for adapter packages to register themselves when the
+// app boots. Adapter packages can import this and call it from their
+// plugin entry to wire into the commerce product provider registry.
+export function registerProductProviderRuntime(name: string, provider: ProductProvider) {
+  registerProductProvider(name, provider)
+}

package/app/composables/products/types.ts

@@ -0,0 +1,13 @@
+export interface Product {
+  id: string
+  title: string
+  description?: string
+  price: number
+  images: string[]
+  [key: string]: any
+}
+
+export interface ProductProvider {
+  getProduct(id: string): Promise<Product>
+  listProducts(params?: Record<string, any>): Promise<Product[]>
+}

package/app/composables/products/useProducts.ts

@@ -0,0 +1,12 @@
+import { getCommerceConfig } from '../config'
+import { getProductProvider } from './registry'
+
+export function useProducts() {
+  const { productProvider } = getCommerceConfig()
+  const provider = getProductProvider(productProvider)
+
+  return {
+    getProduct: provider.getProduct,
+    listProducts: provider.listProducts
+  }
+}

package/app/composables/registry.ts

@@ -0,0 +1,21 @@
+import type { ProductProvider } from './products/types'
+import type { CartProvider } from './cart/types'
+import { registerProductProvider } from './products/registry'
+import { registerCartProvider } from './cart/registry'
+
+export interface CommerceProviderBundle {
+  product?: ProductProvider
+  cart?: CartProvider
+  // future: category?: CategoryProvider
+}
+
+// Register multiple domain providers at once from an adapter package.
+// Example adapter entrypoint can call this during app boot.
+export function registerCommerceProviderRuntime(name: string, bundle: CommerceProviderBundle) {
+  if (bundle.product) registerProductProvider(name, bundle.product)
+  if (bundle.cart) registerCartProvider(name, bundle.cart)
+}
+
+// Also re-export individual runtime helpers for convenience
+export { registerProductProviderRuntime } from './products/registry'
+export { registerCartProviderRuntime } from './cart/registry'

package/app/composables/stores/cart.ts

@@ -0,0 +1,218 @@
+import { ref, computed, readonly } from 'vue'
+import type { Cart, CartItem, Product } from '../types'
+import { useCart } from '../cart/useCart'
+import { defineStore } from 'pinia'
+
+export const useCartStore = defineStore('cart', () => {
+  const cart = ref<Cart | null>(null)
+  const loading = ref(false)
+  const error = ref<string | null>(null)
+  
+  // Import cart composable
+  const { 
+    fetchCart, 
+    addToCart, 
+    removeFromCart, 
+    updateCartItem, 
+    applyCoupon, 
+    removeCoupon, 
+    clearCart,
+    setShippingOption: setShippingOptionFn
+    ,createCheckoutSession: createCheckoutSessionFn
+  } = useCart() as any
+  
+  const initializeCart = async () => {
+    loading.value = true
+    error.value = null
+    try {
+      await fetchCart()
+    } catch (err: any) {
+      error.value = err.message
+      console.error('Error initializing cart:', err)
+    } finally {
+      loading.value = false
+    }
+  }
+  
+  const addProductToCart = async (productId: string, quantity: number = 1, variantId?: string) => {
+    loading.value = true
+    error.value = null
+    try {
+      await addToCart(productId, quantity, variantId)
+    } catch (err: any) {
+      error.value = err.message
+      console.error('Error adding product to cart:', err)
+      throw err
+    } finally {
+      loading.value = false
+    }
+  }
+  
+  const removeProductFromCart = async (itemId: string) => {
+    loading.value = true
+    error.value = null
+    try {
+      await removeFromCart(itemId)
+    } catch (err: any) {
+      error.value = err.message
+      console.error('Error removing product from cart:', err)
+      throw err
+    } finally {
+      loading.value = false
+    }
+  }
+  
+  const updateProductQuantity = async (itemId: string, quantity: number) => {
+    loading.value = true
+    error.value = null
+    try {
+      await updateCartItem(itemId, quantity)
+    } catch (err: any) {
+      error.value = err.message
+      console.error('Error updating cart item:', err)
+      throw err
+    } finally {
+      loading.value = false
+    }
+  }
+  
+  const applyCartCoupon = async (couponCode: string) => {
+    loading.value = true
+    error.value = null
+    try {
+      const success = await applyCoupon(couponCode)
+      if (!success) {
+        throw new Error('Failed to apply coupon')
+      }
+    } catch (err: any) {
+      error.value = err.message
+      console.error('Error applying coupon:', err)
+      throw err
+    } finally {
+      loading.value = false
+    }
+  }
+  
+  const removeCartCoupon = async () => {
+    loading.value = true
+    error.value = null
+    try {
+      await removeCoupon()
+    } catch (err: any) {
+      error.value = err.message
+      console.error('Error removing coupon:', err)
+      throw err
+    } finally {
+      loading.value = false
+    }
+  }
+  
+  const emptyCart = async () => {
+    loading.value = true
+    error.value = null
+    try {
+      await clearCart()
+    } catch (err: any) {
+      error.value = err.message
+      console.error('Error clearing cart:', err)
+      throw err
+    } finally {
+      loading.value = false
+    }
+  }
+
+  const setShippingOption = async (option: any) => {
+    loading.value = true
+    error.value = null
+    try {
+      if (!setShippingOptionFn) throw new Error('Shipping setter unavailable')
+      await setShippingOptionFn(option)
+    } catch (err: any) {
+      error.value = err.message
+      console.error('Error setting shipping option:', err)
+      throw err
+    } finally {
+      loading.value = false
+    }
+  }
+
+  const createCheckoutSession = async (cartId?: string) => {
+    loading.value = true
+    error.value = null
+    try {
+      const data = await createCheckoutSessionFn(cartId)
+      return data
+    } catch (err: any) {
+      error.value = err.message
+      throw err
+    } finally {
+      loading.value = false
+    }
+  }
+  
+  // Computed properties
+  const itemCount = computed(() => {
+    return cart.value?.items?.reduce((count: any, item: { quantity: any }) => count + item.quantity, 0) || 0
+  })
+  
+  const isEmpty = computed(() => {
+    return !cart.value?.items?.length
+  })
+  
+  const hasItems = computed(() => {
+    return !isEmpty.value
+  })
+  
+  const subtotal = computed(() => {
+    return cart.value?.subtotal || 0
+  })
+  
+  const total = computed(() => {
+    return cart.value?.total || 0
+  })
+  
+  const taxAmount = computed(() => {
+    return cart.value?.tax_amount || 0
+  })
+  
+  const shippingAmount = computed(() => {
+    return cart.value?.shipping_amount || 0
+  })
+  
+  const discountAmount = computed(() => {
+    return cart.value?.discount_amount || 0
+  })
+  
+  const hasCoupon = computed(() => {
+    return !!cart.value?.coupon_code
+  })
+  
+  return {
+    // State
+    cart: readonly(cart),
+    loading: readonly(loading),
+    error: readonly(error),
+    
+    // Computed
+    itemCount,
+    isEmpty,
+    hasItems,
+    subtotal,
+    total,
+    taxAmount,
+    shippingAmount,
+    discountAmount,
+    hasCoupon,
+    
+    // Actions
+    initializeCart,
+    addProductToCart,
+    removeProductFromCart,
+    updateProductQuantity,
+    applyCartCoupon,
+    removeCartCoupon,
+    emptyCart
+    ,setShippingOption
+    ,createCheckoutSession
+  }
+})