@kasuvia/sdk 0.0.1

package/src/services/product.service.ts

@@ -0,0 +1,678 @@
+/**
+ * Product Service
+ * 
+ * Handles product operations using GraphQL.
+ */
+import { getGraphQLClient } from '../client/graphqlClient'
+import type { Product, PaginatedResponse, ListParams } from '../types/store'
+
+// GraphQL queries would be defined here or imported
+// For now, we'll use placeholder queries that need to be replaced with actual GraphQL
+
+const GET_STOREFRONT_PRODUCTS = `
+  query GetStorefrontProducts($page: Int!, $pageSize: Int!, $collectionSlug: String, $search: String) {
+    storefront_products(page: $page, pageSize: $pageSize, collectionSlug: $collectionSlug, search: $search) {
+      items {
+        id
+        business_id
+        name
+        slug
+        description
+        brand
+        product_type
+        requires_shipping
+        is_consumable
+        is_bespoke
+        base_price
+        currency
+        images { url alt id }
+        tags
+        custom_fields { label unit required }
+        is_published
+        is_featured
+        is_popular
+        is_new
+        is_temporary
+        digital_file_key
+        download_limit
+        download_expires_at
+        weight_kg
+        length_cm
+        width_cm
+        height_cm
+        created_at
+        updated_at
+        variants {
+          id
+          product_id
+          sku
+          attributes
+          price
+          images { url alt id }
+          weight_kg
+          is_active
+          inventory {
+            id
+            product_id
+            variant_id
+            quantity
+            reserved
+            reorder_point
+            reorder_quantity
+            track_quantity
+            allow_backorder
+            available
+            is_in_stock
+            is_low_stock
+            updated_at
+          }
+          created_at
+          updated_at
+        }
+        collections {
+          id
+          business_id
+          name
+          slug
+          description
+          image { url alt id }
+          collection_type
+          rules
+          status
+          sort_order
+          created_at
+          updated_at
+        }
+      }
+      total
+      page
+      page_size
+      total_pages
+    }
+  }
+`
+
+const GET_STOREFRONT_PRODUCT_BY_SLUG = `
+  query GetStorefrontProductBySlug($slug: String!) {
+    storefront_product_by_slug(slug: $slug) {
+      id
+      business_id
+      name
+      slug
+      description
+      brand
+      product_type
+      requires_shipping
+      is_consumable
+      is_bespoke
+      base_price
+      currency
+      images { url alt id }
+      tags
+      custom_fields { label unit required }
+      is_published
+      is_featured
+      is_popular
+      is_new
+      is_temporary
+      digital_file_key
+      download_limit
+      download_expires_at
+      weight_kg
+      length_cm
+      width_cm
+      height_cm
+      created_at
+      updated_at
+      variants {
+        id
+        product_id
+        sku
+        attributes
+        price
+        images { url alt id }
+        weight_kg
+        is_active
+        inventory {
+          id
+          product_id
+          variant_id
+          quantity
+          reserved
+          reorder_point
+          reorder_quantity
+          track_quantity
+          allow_backorder
+          available
+          is_in_stock
+          is_low_stock
+          updated_at
+        }
+        created_at
+        updated_at
+      }
+      collections {
+        id
+        business_id
+        name
+        slug
+        description
+        image { url alt id }
+        collection_type
+        rules
+        status
+        sort_order
+        created_at
+        updated_at
+      }
+    }
+  }
+`
+
+const GET_STOREFRONT_LATEST = `
+  query GetStorefrontLatest($page: Int!, $pageSize: Int!) {
+    storefront_latest(page: $page, pageSize: $pageSize) {
+      items {
+        id
+        business_id
+        name
+        slug
+        description
+        brand
+        product_type
+        requires_shipping
+        is_consumable
+        is_bespoke
+        base_price
+        currency
+        images { url alt id }
+        tags
+        custom_fields { label unit required }
+        is_published
+        is_featured
+        is_popular
+        is_new
+        is_temporary
+        digital_file_key
+        download_limit
+        download_expires_at
+        weight_kg
+        length_cm
+        width_cm
+        height_cm
+        created_at
+        updated_at
+        variants {
+          id
+          product_id
+          sku
+          attributes
+          price
+          images { url alt id }
+          weight_kg
+          is_active
+          inventory {
+            id
+            product_id
+            variant_id
+            quantity
+            reserved
+            reorder_point
+            reorder_quantity
+            track_quantity
+            allow_backorder
+            available
+            is_in_stock
+            is_low_stock
+            updated_at
+          }
+          created_at
+          updated_at
+        }
+        collections {
+          id
+          business_id
+          name
+          slug
+          description
+          image { url alt id }
+          collection_type
+          rules
+          status
+          sort_order
+          created_at
+          updated_at
+        }
+      }
+      total
+      page
+      page_size
+      total_pages
+    }
+  }
+`
+
+const GET_STOREFRONT_POPULAR = `
+  query GetStorefrontPopular($page: Int!, $pageSize: Int!) {
+    storefront_popular(page: $page, pageSize: $pageSize) {
+      items {
+        id
+        business_id
+        name
+        slug
+        description
+        brand
+        product_type
+        requires_shipping
+        is_consumable
+        is_bespoke
+        base_price
+        currency
+        images { url alt id }
+        tags
+        custom_fields { label unit required }
+        is_published
+        is_featured
+        is_popular
+        is_new
+        is_temporary
+        digital_file_key
+        download_limit
+        download_expires_at
+        weight_kg
+        length_cm
+        width_cm
+        height_cm
+        created_at
+        updated_at
+        variants {
+          id
+          product_id
+          sku
+          attributes
+          price
+          images { url alt id }
+          weight_kg
+          is_active
+          inventory {
+            id
+            product_id
+            variant_id
+            quantity
+            reserved
+            reorder_point
+            reorder_quantity
+            track_quantity
+            allow_backorder
+            available
+            is_in_stock
+            is_low_stock
+            updated_at
+          }
+          created_at
+          updated_at
+        }
+        collections {
+          id
+          business_id
+          name
+          slug
+          description
+          image { url alt id }
+          collection_type
+          rules
+          status
+          sort_order
+          created_at
+          updated_at
+        }
+      }
+      total
+      page
+      page_size
+      total_pages
+    }
+  }
+`
+
+const GET_STOREFRONT_FEATURED = `
+  query GetStorefrontFeatured($page: Int!, $pageSize: Int!) {
+    storefront_featured(page: $page, pageSize: $pageSize) {
+      items {
+        id
+        business_id
+        name
+        slug
+        description
+        brand
+        product_type
+        requires_shipping
+        is_consumable
+        is_bespoke
+        base_price
+        currency
+        images { url alt id }
+        tags
+        custom_fields { label unit required }
+        is_published
+        is_featured
+        is_popular
+        is_new
+        is_temporary
+        digital_file_key
+        download_limit
+        download_expires_at
+        weight_kg
+        length_cm
+        width_cm
+        height_cm
+        created_at
+        updated_at
+        variants {
+          id
+          product_id
+          sku
+          attributes
+          price
+          images { url alt id }
+          weight_kg
+          is_active
+          inventory {
+            id
+            product_id
+            variant_id
+            quantity
+            reserved
+            reorder_point
+            reorder_quantity
+            track_quantity
+            allow_backorder
+            available
+            is_in_stock
+            is_low_stock
+            updated_at
+          }
+          created_at
+          updated_at
+        }
+        collections {
+          id
+          business_id
+          name
+          slug
+          description
+          image { url alt id }
+          collection_type
+          rules
+          status
+          sort_order
+          created_at
+          updated_at
+        }
+      }
+      total
+      page
+      page_size
+      total_pages
+    }
+  }
+`
+
+const GET_STOREFRONT_NEW = `
+  query GetStorefrontNew($page: Int!, $pageSize: Int!) {
+    storefront_new(page: $page, pageSize: $pageSize) {
+      items {
+        id
+        business_id
+        name
+        slug
+        description
+        brand
+        product_type
+        requires_shipping
+        is_consumable
+        is_bespoke
+        base_price
+        currency
+        images { url alt id }
+        tags
+        custom_fields { label unit required }
+        is_published
+        is_featured
+        is_popular
+        is_new
+        is_temporary
+        digital_file_key
+        download_limit
+        download_expires_at
+        weight_kg
+        length_cm
+        width_cm
+        height_cm
+        created_at
+        updated_at
+        variants {
+          id
+          product_id
+          sku
+          attributes
+          price
+          images { url alt id }
+          weight_kg
+          is_active
+          inventory {
+            id
+            product_id
+            variant_id
+            quantity
+            reserved
+            reorder_point
+            reorder_quantity
+            track_quantity
+            allow_backorder
+            available
+            is_in_stock
+            is_low_stock
+            updated_at
+          }
+          created_at
+          updated_at
+        }
+        collections {
+          id
+          business_id
+          name
+          slug
+          description
+          image { url alt id }
+          collection_type
+          rules
+          status
+          sort_order
+          created_at
+          updated_at
+        }
+      }
+      total
+      page
+      page_size
+      total_pages
+    }
+  }
+`
+
+const GET_STOREFRONT_RECOMMENDED = `
+  query GetStorefrontRecommended($page: Int!, $pageSize: Int!, $excludeProductId: String) {
+    storefront_recommended(page: $page, pageSize: $pageSize, excludeProductId: $excludeProductId) {
+      items {
+        id
+        business_id
+        name
+        slug
+        description
+        brand
+        product_type
+        requires_shipping
+        is_consumable
+        is_bespoke
+        base_price
+        currency
+        images { url alt id }
+        tags
+        custom_fields { label unit required }
+        is_published
+        is_featured
+        is_popular
+        is_new
+        is_temporary
+        digital_file_key
+        download_limit
+        download_expires_at
+        weight_kg
+        length_cm
+        width_cm
+        height_cm
+        created_at
+        updated_at
+        variants {
+          id
+          product_id
+          sku
+          attributes
+          price
+          images { url alt id }
+          weight_kg
+          is_active
+          inventory {
+            id
+            product_id
+            variant_id
+            quantity
+            reserved
+            reorder_point
+            reorder_quantity
+            track_quantity
+            allow_backorder
+            available
+            is_in_stock
+            is_low_stock
+            updated_at
+          }
+          created_at
+          updated_at
+        }
+        collections {
+          id
+          business_id
+          name
+          slug
+          description
+          image { url alt id }
+          collection_type
+          rules
+          status
+          sort_order
+          created_at
+          updated_at
+        }
+      }
+      total
+      page
+      page_size
+      total_pages
+    }
+  }
+`
+
+/**
+ * Fetch all active products for the storefront.
+ */
+export async function getStorefrontProducts(params?: ListParams): Promise<PaginatedResponse<Product>> {
+  const client = getGraphQLClient()
+  const variables = {
+    page: params?.page || 1,
+    pageSize: params?.pageSize || 20,
+    collectionSlug: params?.collectionSlug,
+    search: params?.search,
+  }
+  const data = await client.request(GET_STOREFRONT_PRODUCTS, variables)
+  return data.storefront_products
+}
+
+/**
+ * Fetch a single product by slug for the storefront.
+ */
+export async function getStorefrontProductBySlug(slug: string): Promise<Product> {
+  const client = getGraphQLClient()
+  const data = await client.request(GET_STOREFRONT_PRODUCT_BY_SLUG, { slug })
+  return data.storefront_product_by_slug
+}
+
+/**
+ * Fetch latest products for the storefront.
+ */
+export async function getLatestProducts(params?: ListParams): Promise<PaginatedResponse<Product>> {
+  const client = getGraphQLClient()
+  const variables = {
+    page: params?.page || 1,
+    pageSize: params?.pageSize || 4,
+  }
+  const data = await client.request(GET_STOREFRONT_LATEST, variables)
+  return data.storefront_latest
+}
+
+/**
+ * Fetch popular products for the storefront.
+ */
+export async function getPopularProducts(params?: ListParams): Promise<PaginatedResponse<Product>> {
+  const client = getGraphQLClient()
+  const variables = {
+    page: params?.page || 1,
+    pageSize: params?.pageSize || 4,
+  }
+  const data = await client.request(GET_STOREFRONT_POPULAR, variables)
+  return data.storefront_popular
+}
+
+/**
+ * Fetch featured products for the storefront.
+ */
+export async function getFeaturedProducts(params?: ListParams): Promise<PaginatedResponse<Product>> {
+  const client = getGraphQLClient()
+  const variables = {
+    page: params?.page || 1,
+    pageSize: params?.pageSize || 4,
+  }
+  const data = await client.request(GET_STOREFRONT_FEATURED, variables)
+  return data.storefront_featured
+}
+
+/**
+ * Fetch new products for the storefront.
+ */
+export async function getNewProducts(params?: ListParams): Promise<PaginatedResponse<Product>> {
+  const client = getGraphQLClient()
+  const variables = {
+    page: params?.page || 1,
+    pageSize: params?.pageSize || 4,
+  }
+  const data = await client.request(GET_STOREFRONT_NEW, variables)
+  return data.storefront_new
+}
+
+/**
+ * Fetch recommended products for the storefront.
+ * Returns featured, popular, and new products.
+ * Optionally excludes a specific product ID.
+ */
+export async function getRecommendedProducts(params?: ListParams & { excludeProductId?: string }): Promise<PaginatedResponse<Product>> {
+  const client = getGraphQLClient()
+  const variables = {
+    page: params?.page || 1,
+    pageSize: params?.pageSize || 4,
+    excludeProductId: params?.excludeProductId,
+  }
+  const data = await client.request(GET_STOREFRONT_RECOMMENDED, variables)
+  return data.storefront_recommended
+}
+