@kasuvia/sdk 0.0.8 → 0.0.9

package/src/graphql/operations/collections.graphql

@@ -0,0 +1,32 @@
+fragment CollectionFields on Collection {
+  id
+  business_id
+  name
+  slug
+  description
+  image_url
+  collection_type
+  rules
+  status
+  sort_order
+  created_at
+  updated_at
+}
+
+query GetStorefrontCollections($page: Int!, $pageSize: Int!) {
+  storefront_collections(page: $page, pageSize: $pageSize) {
+    items {
+      ...CollectionFields
+    }
+    total
+    page
+    page_size
+    total_pages
+  }
+}
+
+query GetStorefrontCollectionBySlug($slug: String!) {
+  storefront_collection_by_slug(slug: $slug) {
+    ...CollectionFields
+  }
+}

package/src/graphql/operations/products.graphql

@@ -0,0 +1,197 @@
+# Shared field selection for every storefront product query. Replaces 7
+# hand-duplicated copies of this exact selection that used to live inline in
+# product.service.ts (see that file's normaliseProductType doc comment for
+# why keeping them in sync by hand was the root cause of a platform-wide bug).
+fragment ProductFields on Product {
+  id
+  business_id
+  name
+  slug
+  description
+  brand
+  product_type
+  requires_shipping
+  is_consumable
+  is_bespoke
+  is_physical
+  is_non_returnable
+  deposit_percentage
+  base_price
+  currency
+  sale_price
+  sale_start
+  sale_end
+  images
+  tags
+  custom_fields {
+    label
+    unit
+    required
+    field_type
+    options
+  }
+  is_published
+  is_featured
+  is_popular
+  is_new
+  is_temporary
+  average_rating
+  rating_count
+  source_channel
+  source_channel_ref_id
+  service_type
+  service_duration_minutes
+  service_location_type
+  service_coverage_radius_km
+  service_requires_consultation
+  service_max_capacity_per_slot
+  service_buffer_minutes
+  service_is_recurring
+  service_recurring_interval
+  service_project_based
+  digital_files {
+    id
+    file_key
+    display_name
+    sort_order
+  }
+  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
+    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
+    collection_type
+    rules
+    status
+    sort_order
+    created_at
+    updated_at
+  }
+}
+
+query GetStorefrontProducts(
+  $page: Int!
+  $pageSize: Int!
+  $collectionSlug: String
+  $search: String
+  $productType: String
+) {
+  storefront_products(
+    page: $page
+    pageSize: $pageSize
+    collectionSlug: $collectionSlug
+    search: $search
+    productType: $productType
+  ) {
+    items {
+      ...ProductFields
+    }
+    total
+    page
+    page_size
+    total_pages
+  }
+}
+
+query GetStorefrontProductBySlug($slug: String!) {
+  storefront_product_by_slug(slug: $slug) {
+    ...ProductFields
+  }
+}
+
+query GetStorefrontPopular($page: Int!, $pageSize: Int!) {
+  storefront_popular(page: $page, pageSize: $pageSize) {
+    items {
+      ...ProductFields
+    }
+    total
+    page
+    page_size
+    total_pages
+  }
+}
+
+query GetStorefrontFeatured($page: Int!, $pageSize: Int!) {
+  storefront_featured(page: $page, pageSize: $pageSize) {
+    items {
+      ...ProductFields
+    }
+    total
+    page
+    page_size
+    total_pages
+  }
+}
+
+query GetStorefrontNew($page: Int!, $pageSize: Int!) {
+  storefront_new(page: $page, pageSize: $pageSize) {
+    items {
+      ...ProductFields
+    }
+    total
+    page
+    page_size
+    total_pages
+  }
+}
+
+query GetStorefrontOnSale($page: Int!, $pageSize: Int!) {
+  storefront_on_sale(page: $page, pageSize: $pageSize) {
+    items {
+      ...ProductFields
+    }
+    total
+    page
+    page_size
+    total_pages
+  }
+}
+
+query GetStorefrontRecommended($page: Int!, $pageSize: Int!, $excludeProductId: String) {
+  storefront_recommended(page: $page, pageSize: $pageSize, excludeProductId: $excludeProductId) {
+    items {
+      ...ProductFields
+    }
+    total
+    page
+    page_size
+    total_pages
+  }
+}

package/src/graphql/operations/wishlist.graphql

@@ -0,0 +1,25 @@
+query GetStorefrontWishlist($page: Int!, $pageSize: Int!) {
+  storefront_wishlist(page: $page, pageSize: $pageSize) {
+    items {
+      id
+      product_id
+      notes
+      created_at
+      product_name
+      product_slug
+      product_price
+      currency
+      product_image
+    }
+    total
+    page
+    page_size
+    total_pages
+  }
+}
+
+query CheckInStorefrontWishlist($productId: String!) {
+  check_in_storefront_wishlist(productId: $productId) {
+    in_wishlist
+  }
+}

package/src/hooks/index.ts

@@ -6,6 +6,9 @@
 
 export * from './use-cart'
 export * from './use-orders'
+export * from './use-consultations'
+export * from './use-feedback'
+export * from './use-customer-address'
 export * from './use-auth'
 export * from './use-countries'
 export * from './use-states'
@@ -16,13 +19,17 @@ export * from './use-collections'
 export * from './use-products'
 export * from './use-wishlist'
 export * from './use-service-booking'
-export * from './use-consultations'
-export * from './use-consultation-stream'
 export * from './use-order-stream'
+export * from './use-reviews'
 export * from './use-is-mounted'
 export * from './use-mobile'
 export * from './use-google-translate'
 export * from './use-payment'
 export * from './use-cms'
+export * from './use-business-config'
+export * from './use-notifications'
+export * from './use-notification-stream'
+export * from './use-push-notifications'
+export * from './use-media-upload'
 export * from '../context/sdk-context'
 

package/src/hooks/use-auth.ts

@@ -6,13 +6,34 @@
  * tokens and passes config to these hooks.
  */
 import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query'
-import { getAuthUser, loginCustomer, registerCustomer, updateProfile, logout as logoutService } from '../services/auth.service'
-import { logger } from '../utils/logger'
+import {
+  getAuthUser,
+  loginCustomer,
+  registerCustomer,
+  requestCustomerOtp,
+  verifyCustomerOtp,
+  updateProfile,
+  logout as logoutService,
+  forgotPasswordCustomer,
+  resetPasswordCustomer,
+  deactivateCustomerAccount,
+  requestCustomerReactivation,
+  verifyCustomerReactivation,
+  getStorefrontBusinessInfo,
+  changePassword,
+} from '../services/auth.service'
 import type {
   CustomerLoginPayload,
   CustomerRegisterPayload,
+  CustomerPasswordlessRequestPayload,
+  CustomerPasswordlessVerifyPayload,
+  CustomerForgotPasswordPayload,
+  CustomerResetPasswordPayload,
+  CustomerDeactivatePayload,
+  CustomerReactivatePayload,
+  CustomerReactivateVerifyPayload,
   UpdateProfilePayload,
-  CustomerUser,
+  ChangePasswordPayload,
 } from '../types/auth'
 import type { SdkConfig } from '../config'
 import { useSdkContext, resolveHookArgs } from '../context/sdk-context'
@@ -21,86 +42,159 @@ import { useSdkContext, resolveHookArgs } from '../context/sdk-context'
 
 export function useAuthUser(config?: SdkConfig, accessToken?: string) {
   const ctx = useSdkContext()
-  try {
-    const { config: cfg, accessToken: token } = resolveHookArgs(config, accessToken ?? null, ctx)
-    return useQuery({
-      queryKey: ['auth-user'],
-      queryFn: () => getAuthUser(cfg, token ?? ''),
-      enabled: !!token,
-    })
-  } catch (error) {
-    logger.warn('[useAuthUser] Called outside QueryClientProvider, returning empty user')
-    return { data: undefined, isLoading: false, error: null, isFetching: false, refetch: () => Promise.resolve({ data: undefined }) } as any
-  }
+  const { config: cfg, accessToken: token } = resolveHookArgs(config, accessToken ?? null, ctx)
+  return useQuery({
+    queryKey: ['auth-user'],
+    queryFn: () => getAuthUser(cfg, token ?? ''),
+    enabled: !!token,
+  })
+}
+
+/**
+ * Real gap fixed 2026-09-17: GET /auth/storefront/business-info/ had no SDK
+ * hook — public/unauthenticated (only needs the storefront key), so unlike
+ * useAuthUser this is always enabled, never gated on an access token.
+ */
+export function useStorefrontBusinessInfo(config?: SdkConfig) {
+  const ctx = useSdkContext()
+  const { config: cfg } = resolveHookArgs(config, undefined, ctx)
+  return useQuery({
+    queryKey: ['storefront-business-info', cfg.businessId],
+    queryFn: () => getStorefrontBusinessInfo(cfg),
+    staleTime: 5 * 60 * 1000, // business branding info changes rarely
+  })
 }
 
 export function useLogin(config?: SdkConfig) {
   const ctx = useSdkContext()
-  try {
-    const { config: cfg } = resolveHookArgs(config, undefined, ctx)
-    const queryClient = useQueryClient()
-    return useMutation({
-      mutationFn: (payload: Omit<CustomerLoginPayload, 'tenant_id'>) => loginCustomer(cfg, payload),
-      onSuccess: () => {
-        queryClient.invalidateQueries({ queryKey: ['auth-user'] })
-        queryClient.invalidateQueries({ queryKey: ['cart'] })
-      },
-    })
-  } catch (error) {
-    logger.warn('[useLogin] Called outside QueryClientProvider, returning no-op mutation')
-    return { mutate: () => {}, mutateAsync: () => Promise.resolve(undefined) } as any
-  }
+  const { config: cfg } = resolveHookArgs(config, undefined, ctx)
+  const queryClient = useQueryClient()
+  return useMutation({
+    mutationFn: (payload: CustomerLoginPayload) => loginCustomer(cfg, payload),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ['auth-user'] })
+      queryClient.invalidateQueries({ queryKey: ['cart'] })
+    },
+  })
 }
 
 export function useRegister(config?: SdkConfig) {
   const ctx = useSdkContext()
-  try {
-    const { config: cfg } = resolveHookArgs(config, undefined, ctx)
-    const queryClient = useQueryClient()
-    return useMutation({
-      mutationFn: (payload: Omit<CustomerRegisterPayload, 'tenant_id'>) => registerCustomer(cfg, payload),
-      onSuccess: () => {
-        queryClient.invalidateQueries({ queryKey: ['auth-user'] })
-        queryClient.invalidateQueries({ queryKey: ['cart'] })
-      },
-    })
-  } catch (error) {
-    logger.warn('[useRegister] Called outside QueryClientProvider, returning no-op mutation')
-    return { mutate: () => {}, mutateAsync: () => Promise.resolve(undefined) } as any
-  }
+  const { config: cfg } = resolveHookArgs(config, undefined, ctx)
+  const queryClient = useQueryClient()
+  return useMutation({
+    mutationFn: (payload: CustomerRegisterPayload) => registerCustomer(cfg, payload),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ['auth-user'] })
+      queryClient.invalidateQueries({ queryKey: ['cart'] })
+    },
+  })
+}
+
+export function useRequestOtp(config?: SdkConfig) {
+  const ctx = useSdkContext()
+  const { config: cfg } = resolveHookArgs(config, undefined, ctx)
+  return useMutation({
+    mutationFn: (payload: CustomerPasswordlessRequestPayload) => requestCustomerOtp(cfg, payload),
+  })
+}
+
+export function useVerifyOtp(config?: SdkConfig) {
+  const ctx = useSdkContext()
+  const { config: cfg } = resolveHookArgs(config, undefined, ctx)
+  const queryClient = useQueryClient()
+  return useMutation({
+    mutationFn: (payload: CustomerPasswordlessVerifyPayload) => verifyCustomerOtp(cfg, payload),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ['auth-user'] })
+      queryClient.invalidateQueries({ queryKey: ['cart'] })
+    },
+  })
+}
+
+export function useCustomerForgotPassword(config?: SdkConfig) {
+  const ctx = useSdkContext()
+  const { config: cfg } = resolveHookArgs(config, undefined, ctx)
+  return useMutation({
+    mutationFn: (payload: CustomerForgotPasswordPayload) => forgotPasswordCustomer(cfg, payload),
+  })
+}
+
+export function useCustomerResetPassword(config?: SdkConfig) {
+  const ctx = useSdkContext()
+  const { config: cfg } = resolveHookArgs(config, undefined, ctx)
+  return useMutation({
+    mutationFn: (payload: CustomerResetPasswordPayload) => resetPasswordCustomer(cfg, payload),
+  })
+}
+
+export function useCustomerDeactivateAccount(config?: SdkConfig, accessToken?: string | null) {
+  const ctx = useSdkContext()
+  const { config: cfg, accessToken: token } = resolveHookArgs(config, accessToken, ctx)
+  const queryClient = useQueryClient()
+  return useMutation({
+    mutationFn: (payload?: CustomerDeactivatePayload) =>
+      token ? deactivateCustomerAccount(cfg, token, payload) : Promise.reject(new Error('No access token available')),
+    onSuccess: () => {
+      queryClient.clear()
+    },
+  })
+}
+
+export function useCustomerReactivateRequest(config?: SdkConfig) {
+  const ctx = useSdkContext()
+  const { config: cfg } = resolveHookArgs(config, undefined, ctx)
+  return useMutation({
+    mutationFn: (payload: CustomerReactivatePayload) => requestCustomerReactivation(cfg, payload),
+  })
+}
+
+export function useCustomerReactivateVerify(config?: SdkConfig) {
+  const ctx = useSdkContext()
+  const { config: cfg } = resolveHookArgs(config, undefined, ctx)
+  return useMutation({
+    mutationFn: (payload: CustomerReactivateVerifyPayload) => verifyCustomerReactivation(cfg, payload),
+  })
 }
 
 export function useUpdateProfile(config?: SdkConfig, accessToken?: string | null) {
   const ctx = useSdkContext()
-  try {
-    const { config: cfg, accessToken: token } = resolveHookArgs(config, accessToken, ctx)
-    const queryClient = useQueryClient()
-    return useMutation({
-      mutationFn: (payload: UpdateProfilePayload) =>
-        token ? updateProfile(cfg, token, payload) : Promise.reject('No access token'),
-      onSuccess: () => {
-        queryClient.invalidateQueries({ queryKey: ['auth-user'] })
-      },
-    })
-  } catch (error) {
-    logger.warn('[useUpdateProfile] Called outside QueryClientProvider, returning no-op mutation')
-    return { mutate: () => {}, mutateAsync: () => Promise.resolve(undefined) } as any
-  }
+  const { config: cfg, accessToken: token } = resolveHookArgs(config, accessToken, ctx)
+  const queryClient = useQueryClient()
+  return useMutation({
+    mutationFn: (payload: UpdateProfilePayload) =>
+      token ? updateProfile(cfg, token, payload) : Promise.reject(new Error('No access token available')),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ['auth-user'] })
+    },
+  })
+}
+
+/**
+ * POST /auth/change-password/ — REAL GAP FIXED (2026-09-20): this endpoint
+ * is fully customer-reachable on the real backend (ChangePasswordView
+ * branches on identity_mode) but had zero SDK coverage at all until now —
+ * no storefront customer had any way to change their password once logged
+ * in (only the logged-out forgot/reset-password OTP flow existed).
+ */
+export function useChangePassword(config?: SdkConfig, accessToken?: string | null) {
+  const ctx = useSdkContext()
+  const { config: cfg, accessToken: token } = resolveHookArgs(config, accessToken, ctx)
+  return useMutation({
+    mutationFn: (payload: ChangePasswordPayload) =>
+      token ? changePassword(cfg, token, payload) : Promise.reject(new Error('No access token available')),
+  })
 }
 
 export function useLogout(config?: SdkConfig, refreshToken?: string) {
   const ctx = useSdkContext()
-  try {
-    const { config: cfg } = resolveHookArgs(config, undefined, ctx)
-    const queryClient = useQueryClient()
-    return useMutation({
-      mutationFn: () => logoutService(cfg, refreshToken),
-      onSuccess: () => {
-        queryClient.clear()
-      },
-    })
-  } catch (error) {
-    logger.warn('[useLogout] Called outside QueryClientProvider, returning no-op mutation')
-    return { mutate: () => {}, mutateAsync: () => Promise.resolve(undefined) } as any
-  }
+  const { config: cfg } = resolveHookArgs(config, undefined, ctx)
+  const queryClient = useQueryClient()
+  return useMutation({
+    mutationFn: () => logoutService(cfg, refreshToken),
+    onSuccess: () => {
+      queryClient.clear()
+    },
+  })
 }
+

package/src/hooks/use-bespoke-availability.ts

@@ -4,11 +4,9 @@
  * React Query hook for checking bespoke service availability.
  * Stateless - requires config parameter.
  */
-import { useQuery } from '@tanstack/react-query'
-import { checkAvailability } from '../services/bespoke.service'
+import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query'
+import { checkAvailability, approveBespokeDeliverable, requestBespokeRevision } from '../services/bespoke.service'
 import type { SdkConfig } from '../config'
-import type { BespokeAvailability } from '../types/consultations'
-import { logger } from '../utils'
 import { useSdkContext, resolveHookArgs } from '../context/sdk-context'
 
 /**
@@ -16,22 +14,41 @@ import { useSdkContext, resolveHookArgs } from '../context/sdk-context'
  */
 export function useBespokeAvailability(product_id: string, config?: SdkConfig) {
   const ctx = useSdkContext()
-  try {
-    const { config: cfg } = resolveHookArgs(config, undefined, ctx)
-    return useQuery({
-      queryKey: ['bespoke-availability', product_id],
-      queryFn: () => checkAvailability(cfg, product_id),
-      enabled: !!product_id,
-      retry: false,
-    })
-  } catch (error) {
-    logger.warn('[useBespokeAvailability] Called outside QueryClientProvider, returning undefined')
-    return {
-      data: undefined,
-      isLoading: false,
-      error: null,
-      isFetching: false,
-      refetch: () => Promise.resolve({ data: undefined }),
-    } as any
-  }
+  const { config: cfg } = resolveHookArgs(config, undefined, ctx)
+  return useQuery({
+    queryKey: ['bespoke-availability', product_id],
+    queryFn: () => checkAvailability(cfg, product_id),
+    enabled: !!product_id,
+    retry: false,
+  })
+}
+
+/** Buyer approves a bespoke order's submitted deliverable. */
+export function useApproveBespokeDeliverable(config?: SdkConfig, accessToken?: string | null) {
+  const ctx = useSdkContext()
+  const { config: cfg, accessToken: token } = resolveHookArgs(config, accessToken, ctx)
+  const queryClient = useQueryClient()
+  return useMutation({
+    mutationFn: (orderId: string) =>
+      token ? approveBespokeDeliverable(cfg, token, orderId) : Promise.reject(new Error('No access token available')),
+    onSuccess: (_data, orderId) => {
+      queryClient.invalidateQueries({ queryKey: ['order', orderId] })
+      queryClient.invalidateQueries({ queryKey: ['orders'] })
+    },
+  })
+}
+
+/** Buyer requests a revision on a bespoke order's submitted deliverable. */
+export function useRequestBespokeRevision(config?: SdkConfig, accessToken?: string | null) {
+  const ctx = useSdkContext()
+  const { config: cfg, accessToken: token } = resolveHookArgs(config, accessToken, ctx)
+  const queryClient = useQueryClient()
+  return useMutation({
+    mutationFn: ({ orderId, notes }: { orderId: string; notes: string }) =>
+      token ? requestBespokeRevision(cfg, token, orderId, notes) : Promise.reject(new Error('No access token available')),
+    onSuccess: (_data, variables) => {
+      queryClient.invalidateQueries({ queryKey: ['order', variables.orderId] })
+      queryClient.invalidateQueries({ queryKey: ['orders'] })
+    },
+  })
 }

package/src/hooks/use-business-config.ts

@@ -0,0 +1,51 @@
+/**
+ * Business Config Hook
+ *
+ * Resolves the business's internal UUID (and currency/branding fields) via
+ * kasuvia-auth's internal business-detail endpoint. Several other backends
+ * (kasuvia-cms's SDK routes, notably) key their data by this UUID rather
+ * than the public BID a storefront's own config carries — this hook is the
+ * shared, cached way to resolve it instead of every caller re-fetching.
+ * Cached aggressively: a business's UUID never changes.
+ */
+import { useCallback } from 'react'
+import { useQuery } from '@tanstack/react-query'
+import { getBusinessConfig } from '../services/config.service'
+import type { SdkConfig } from '../config'
+import { useSdkContext, resolveHookArgs } from '../context/sdk-context'
+import { formatPrice as formatPriceFn } from '../utils/format'
+
+export function useBusinessConfig(config?: SdkConfig) {
+  const ctx = useSdkContext()
+  const { config: cfg } = resolveHookArgs(config, undefined, ctx)
+  return useQuery({
+    queryKey: ['business-config', cfg.businessId],
+    queryFn: () => getBusinessConfig(cfg),
+    staleTime: Infinity,
+    gcTime: Infinity,
+  })
+}
+
+/**
+ * REAL GAP FIXED (2026-09-22): `formatPrice(amount, currency)` is stateless
+ * and requires the caller to already have the real business currency in
+ * hand — every consuming app was left to resolve that currency itself, and
+ * kasuvia-storefront's `AppProvider` ended up hand-rolling its own,
+ * slightly different copy of the same `Intl.NumberFormat` currency logic
+ * (silently falling back to a bare number instead of formatPrice's
+ * explicit "N/A" marker when currency is unresolved). This hook is the one
+ * real, complete answer: resolves the business's currency via
+ * `useBusinessConfig` and returns a ready-to-call formatter, so no
+ * consuming app ever needs to reimplement currency formatting again.
+ */
+export function useFormatPrice(config?: SdkConfig) {
+  const { data: businessConfig } = useBusinessConfig(config)
+  const currency = businessConfig?.currency ?? null
+
+  const formatPrice = useCallback(
+    (amount: number | null | undefined) => formatPriceFn(amount, currency),
+    [currency]
+  )
+
+  return { formatPrice, currency }
+}