@kasuvia/sdk 0.0.2 → 0.0.4

package/src/constants.ts

@@ -0,0 +1,13 @@
+/**
+ * SDK Constants
+ * 
+ * Centralized constants to avoid hardcoded strings across the codebase.
+ */
+
+export const STORAGE_KEYS = {
+  ACCESS_TOKEN: 'kasuvia_access_token',
+  REFRESH_TOKEN: 'kasuvia_refresh_token',
+  CHECKOUT_STATE: 'kasuvia_checkout_state',
+  ORDERS_LINKED: 'kasuvia_orders_linked',
+  STOREFRONT_STATE: 'storefront_state_v3',
+} as const;

package/src/context/sdk-context.tsx

@@ -0,0 +1,70 @@
+'use client';
+
+/**
+ * SdkContext
+ *
+ * Provides SdkConfig and the current access token to all SDK hooks
+ * in the component tree, so individual hooks do not require explicit
+ * config/accessToken parameters when called from client components.
+ *
+ * Usage in storefront:
+ *   // In your AuthProvider or root layout:
+ *   <SdkProvider config={sdkConfig} accessToken={accessToken}>
+ *     {children}
+ *   </SdkProvider>
+ *
+ *   // In any client component:
+ *   const { items, addItem } = useCart()  // no args needed
+ */
+
+import React, { createContext, useContext, type ReactNode } from 'react';
+import type { SdkConfig } from '../config';
+
+export interface SdkContextValue {
+  config: SdkConfig;
+  accessToken: string | null;
+}
+
+const SdkContext = createContext<SdkContextValue | null>(null);
+
+export interface SdkProviderProps {
+  config: SdkConfig;
+  accessToken: string | null;
+  children: ReactNode;
+}
+
+export function SdkProvider({ config, accessToken, children }: SdkProviderProps) {
+  return (
+    <SdkContext.Provider value={{ config, accessToken }}>
+      {children}
+    </SdkContext.Provider>
+  );
+}
+
+/**
+ * Returns the SdkContext value, or null if no SdkProvider is present.
+ * SDK hooks use this internally to fall back to context when explicit
+ * parameters are not provided.
+ */
+export function useSdkContext(): SdkContextValue | null {
+  return useContext(SdkContext);
+}
+
+/**
+ * Resolves config and accessToken from explicit arguments or SdkContext.
+ * Throws if neither source is available.
+ */
+export function resolveHookArgs(
+  explicitConfig: SdkConfig | undefined,
+  explicitToken: string | null | undefined,
+  ctx: SdkContextValue | null
+): { config: SdkConfig; accessToken: string | null } {
+  const config = explicitConfig ?? ctx?.config;
+  if (!config) {
+    throw new Error(
+      '[kasuvia-sdk] No SdkConfig found. Either pass config explicitly or wrap your app with <SdkProvider config={...}>.'
+    );
+  }
+  const accessToken = explicitToken !== undefined ? explicitToken : (ctx?.accessToken ?? null);
+  return { config, accessToken };
+}

package/src/graphql/collections.graphql.ts

@@ -14,11 +14,7 @@ export const GET_STOREFRONT_COLLECTIONS = gql`
         description
         collection_type
         rules
-        image {
-          id
-          url
-          alt
-        }
+        image
         status
         sort_order
         created_at
@@ -42,11 +38,7 @@ export const GET_STOREFRONT_COLLECTION_BY_SLUG = gql`
       description
       collection_type
       rules
-      image {
-        id
-        url
-        alt
-      }
+      image
       status
       sort_order
       created_at

package/src/graphql/products.graphql.ts

@@ -29,11 +29,10 @@ export const GET_STOREFRONT_PRODUCTS = gql`
         is_bespoke
         base_price
         currency
-        images {
-          id
-          url
-          alt
-        }
+        sale_price
+        sale_start
+        sale_end
+        images
         tags
         custom_fields {
           label
@@ -58,11 +57,7 @@ export const GET_STOREFRONT_PRODUCTS = gql`
           sku
           attributes
           price
-          images {
-            id
-            url
-            alt
-          }
+          images
           weight_kg
           is_active
           inventory {
@@ -156,11 +151,7 @@ export const GET_STOREFRONT_PRODUCT_BY_SLUG = gql`
         sku
         attributes
         price
-        images {
-          id
-          url
-          alt
-        }
+        images
         weight_kg
         is_active
         inventory {
@@ -189,11 +180,7 @@ export const GET_STOREFRONT_PRODUCT_BY_SLUG = gql`
         description
         collection_type
         rules
-        image {
-          id
-          url
-          alt
-        }
+        image
         status
         sort_order
         created_at
@@ -221,11 +208,10 @@ export const GET_STOREFRONT_LATEST = gql`
         is_bespoke
         base_price
         currency
-        images {
-          id
-          url
-          alt
-        }
+        sale_price
+        sale_start
+        sale_end
+        images
         tags
         custom_fields {
           label
@@ -250,11 +236,7 @@ export const GET_STOREFRONT_LATEST = gql`
           sku
           attributes
           price
-          images {
-            id
-            url
-            alt
-          }
+          images
           weight_kg
           is_active
           inventory {
@@ -320,11 +302,10 @@ export const GET_STOREFRONT_POPULAR = gql`
         is_bespoke
         base_price
         currency
-        images {
-          id
-          url
-          alt
-        }
+        sale_price
+        sale_start
+        sale_end
+        images
         tags
         custom_fields {
           label
@@ -349,11 +330,7 @@ export const GET_STOREFRONT_POPULAR = gql`
           sku
           attributes
           price
-          images {
-            id
-            url
-            alt
-          }
+          images
           weight_kg
           is_active
           inventory {
@@ -419,11 +396,10 @@ export const GET_STOREFRONT_FEATURED = gql`
         is_bespoke
         base_price
         currency
-        images {
-          id
-          url
-          alt
-        }
+        sale_price
+        sale_start
+        sale_end
+        images
         tags
         custom_fields {
           label
@@ -448,11 +424,7 @@ export const GET_STOREFRONT_FEATURED = gql`
           sku
           attributes
           price
-          images {
-            id
-            url
-            alt
-          }
+          images
           weight_kg
           is_active
           inventory {
@@ -518,11 +490,104 @@ export const GET_STOREFRONT_NEW = gql`
         is_bespoke
         base_price
         currency
-        images {
+        sale_price
+        sale_start
+        sale_end
+        images
+        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
+        variants {
           id
-          url
-          alt
+          product_id
+          sku
+          attributes
+          price
+          images
+          weight_kg
+          is_active
+          inventory {
+            id
+            product_id
+            variant_id
+            quantity
+            reserved
+            available
+            is_in_stock
+            is_low_stock
+            reorder_point
+            reorder_quantity
+            track_quantity
+            allow_backorder
+            updated_at
+          }
+          created_at
+          updated_at
+        }
+        collections {
+          id
+          business_id
+          name
+          slug
+          description
+          collection_type
+          rules
+          image {
+            id
+            url
+            alt
+          }
+          status
+          sort_order
+          created_at
+          updated_at
         }
+        created_at
+        updated_at
+      }
+      total
+      page
+      page_size
+      total_pages
+    }
+  }
+`
+
+export const GET_STOREFRONT_ON_SALE = gql`
+  query GetStorefrontOnSale($page: Int = 1, $pageSize: Int = 4) {
+    storefront_on_sale(page: $page, pageSize: $pageSize) {
+      items {
+        id
+        business_id
+        name
+        slug
+        description
+        brand
+        product_type
+        requires_shipping
+        is_consumable
+        is_bespoke
+        base_price
+        currency
+        sale_price
+        sale_start
+        sale_end
+        images
         tags
         custom_fields {
           label
@@ -547,11 +612,101 @@ export const GET_STOREFRONT_NEW = gql`
           sku
           attributes
           price
-          images {
+          images
+          weight_kg
+          is_active
+          inventory {
+            id
+            product_id
+            variant_id
+            quantity
+            reserved
+            available
+            is_in_stock
+            is_low_stock
+            reorder_point
+            reorder_quantity
+            track_quantity
+            allow_backorder
+            updated_at
+          }
+          created_at
+          updated_at
+        }
+        collections {
+          id
+          business_id
+          name
+          slug
+          description
+          collection_type
+          rules
+          image {
             id
             url
             alt
           }
+          status
+          sort_order
+          created_at
+          updated_at
+        }
+        created_at
+        updated_at
+      }
+      total
+      page
+      page_size
+      total_pages
+    }
+  }
+`
+
+export const GET_STOREFRONT_LOW_STOCK = gql`
+  query GetStorefrontLowStock($page: Int = 1, $pageSize: Int = 4) {
+    storefront_low_stock(page: $page, pageSize: $pageSize) {
+      items {
+        id
+        business_id
+        name
+        slug
+        description
+        brand
+        product_type
+        requires_shipping
+        is_consumable
+        is_bespoke
+        base_price
+        currency
+        sale_price
+        sale_start
+        sale_end
+        images
+        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
+        variants {
+          id
+          product_id
+          sku
+          attributes
+          price
+          images
           weight_kg
           is_active
           inventory {
@@ -625,11 +780,10 @@ export const GET_STOREFRONT_RECOMMENDED = gql`
         is_bespoke
         base_price
         currency
-        images {
-          id
-          url
-          alt
-        }
+        sale_price
+        sale_start
+        sale_end
+        images
         tags
         custom_fields {
           label
@@ -654,11 +808,7 @@ export const GET_STOREFRONT_RECOMMENDED = gql`
           sku
           attributes
           price
-          images {
-            id
-            url
-            alt
-          }
+          images
           weight_kg
           is_active
           inventory {
@@ -707,4 +857,4 @@ export const GET_STOREFRONT_RECOMMENDED = gql`
     }
   }
 `
-
+

package/src/graphql/wishlist.graphql.ts

@@ -3,9 +3,9 @@
  */
 import { gql } from 'graphql-request'
 
-export const GET_WISHLIST = gql`
-  query GetWishlist($page: Int = 1, $pageSize: Int = 20) {
-    wishlist(page: $page, pageSize: $pageSize) {
+export const GET_STOREFRONT_WISHLIST = gql`
+  query GetStorefrontWishlist($page: Int = 1, $pageSize: Int = 20) {
+    storefront_wishlist(page: $page, pageSize: $pageSize) {
       items {
         id
         product_id
@@ -14,6 +14,7 @@ export const GET_WISHLIST = gql`
         product_name
         product_slug
         product_price
+        currency
         product_image
       }
       total
@@ -24,9 +25,9 @@ export const GET_WISHLIST = gql`
   }
 `
 
-export const CHECK_IN_WISHLIST = gql`
-  query CheckInWishlist($productId: String!) {
-    check_in_wishlist(productId: $productId) {
+export const CHECK_IN_STOREFRONT_WISHLIST = gql`
+  query CheckInStorefrontWishlist($productId: String!) {
+    check_in_storefront_wishlist(productId: $productId) {
       in_wishlist
     }
   }

package/src/hooks/index.ts

@@ -20,7 +20,9 @@ export * from './use-consultations'
 export * from './use-consultation-stream'
 export * from './use-order-stream'
 export * from './use-is-mounted'
+export * from './use-mobile'
 export * from './use-google-translate'
 export * from './use-payment'
 export * from './use-cms'
+export * from '../context/sdk-context'