@kasuvia/sdk 0.0.8 → 0.0.9

package/dist/hooks/index.d.ts

@@ -1,13 +1,22 @@
-import React, { ReactNode } from 'react';
-import { d as CartResponse, c as CartItem, z as Product, H as SdkConfig, F as FindOrderParams, W as SupportedLang, q as Currency, u as ListParams, e as CmsEntry, o as CreateCmsEntryParams, Z as UpdateCmsEntryParams, L as ListCmsEntriesParams } from '../index-C5YO9gTl.js';
-import { C as Country, S as State } from '../index-C1chUA3P.js';
+import React__default, { ReactNode } from 'react';
+import { b as CartResponse, a as CartItem, P as Product, O as Order, C as CreateOrderParams, F as FindOrderParams, L as ListParams, c as Collection, d as PaginatedResponse, W as WishlistItem, e as WishlistCheckResponse, f as WishlistListResponse } from '../index-CNW_LINy.js';
+import { S as SdkConfig } from '../index-NkI10J_E.js';
+import * as _tanstack_react_query from '@tanstack/react-query';
 import { UseQueryResult } from '@tanstack/react-query';
+import { C as CreateBespokeOrderParams, a as CreateServiceBookingOrderParams, b as Consultation, c as CreateConsultationParams, F as Feedback, d as CreateFeedbackParams, e as FeedbackListResponse, f as CustomerAddress, g as CreateCustomerAddressPayload, U as UpdateCustomerAddressPayload, A as AuthUserResponse, h as ChangePasswordPayload, D as DeactivateAccountResult, i as CustomerDeactivatePayload, j as CustomerForgotPasswordPayload, k as CustomerReactivatePayload, l as CustomerReactivateVerifyPayload, m as CustomerResetPasswordPayload, n as CustomerAuthResponse, o as CustomerLoginPayload, p as CustomerRegisterPayload, q as CustomerPasswordlessRequestPayload, S as StorefrontBusinessInfo, r as CustomerUser, s as UpdateProfilePayload, t as CustomerPasswordlessVerifyPayload, u as SupportedLang, v as Currency, B as BespokeDeliverableStatus, w as BespokeAvailability, x as ServiceAppointment, y as ServiceBookingsPage, z as ServiceMilestone, E as ApproveMilestonePayload, G as AvailableSlotsResponse, H as ServiceAppointmentCreatePayload, I as CancelAppointmentPayload, J as ConfirmAppointmentPayload, K as DisputeAppointmentPayload, R as RescheduleAppointmentPayload, L as Comment, M as CommentCreate, N as Review, O as ReviewCreate, P as MerchantReplyCreate, Q as CommentModerationAction, T as ReviewModerationAction, V as ProductCommentsResponse, W as ProductReviewsResponse, X as CommentUpdate, Y as ReviewUpdate, Z as GatewayMethods, _ as WalletBalanceResponse, $ as DVADetails, a0 as DVACreateRequest, a1 as PaymentInitiateResponse, a2 as PaymentInitiateRequest, a3 as TransactionVerifyResponse, a4 as WalletLedgerResponse, a5 as CmsEntry, a6 as CreateCmsEntryParams, a7 as UpdateCmsEntryParams, a8 as ListCmsEntriesParams, a9 as BusinessConfig, aa as NotificationInboxResponse, ab as NotificationPreferences, ac as ContactFormData, ad as SubscribeToPushParams, ae as VapidPublicKeyResponse, af as MediaAsset, ag as UploadMediaFileParams, ah as UploadMediaFilesResult } from '../media.service-mrBFJ2UQ.js';
+import { C as Country, S as State } from '../index-F7N6UItS.js';
 
 /**
  * Cart Hook & Context Provider
  *
  * React Query hooks for cart operations with unified drawer state sharing.
- * config and accessToken are optional — if omitted, they are read from SdkContext.
+ * All cart operations route directly to kasuvia-cart-management via the SDK
+ * service functions — never through framework-coupled proxy routes.
+ *
+ * - Authenticated users: use Authorization Bearer token
+ * - Guest users:         use guestSessionId (X-Guest-Session header)
+ *
+ * config and accessToken are optional — if omitted they are read from SdkContext.
  */
 
 interface UseCartReturn {
@@ -20,15 +29,15 @@ interface UseCartReturn {
     error: Error | null;
     addToCart: (item: {
         product_id: string;
-        product_slug: string;
-        product_name: string;
+        product_slug?: string;
+        product_name?: string;
         image?: string;
         variant_id?: string;
         variant_attributes?: string;
-        unit_price: number;
+        unit_price?: number;
         quantity: number;
         custom_measurements?: string;
-        is_bespoke: boolean;
+        is_bespoke?: boolean;
     }) => void;
     updateCartItem: (variables: {
         itemId: string;
@@ -39,63 +48,150 @@ interface UseCartReturn {
     clear: () => void;
     mergeGuestCart: (guestSessionId: string) => void;
     addItem: (product: Product, variantId?: string, quantity?: number, customMeasurements?: Record<string, string>) => void;
-    updateQty: (itemId: string, quantity: number) => void;
-    removeItem: (itemId: string) => void;
+    /** Rejects with the real backend error on failure — the optimistic UI update it made is already rolled back by then; catch this to show why. */
+    updateQty: (itemId: string, quantity: number) => Promise<CartResponse>;
+    /** Rejects with the real backend error on failure — the optimistic UI update it made is already rolled back by then; catch this to show why. */
+    removeItem: (itemId: string) => Promise<void>;
     subtotal: number;
-    productTypeMismatch: {
-        message: string;
-        existing_type: string;
-        new_type: string;
-    } | null;
+    productTypeMismatch: ProductTypeMismatchDetail | null;
     handleClearCartAndAdd: () => void;
     handleKeepCurrentCart: () => void;
 }
+interface ProductTypeMismatchDetail {
+    message: string;
+    existing_type: string;
+    new_type: string;
+}
 interface CartContextValue {
     isOpen: boolean;
     setOpen: (open: boolean) => void;
+    productTypeMismatch: ProductTypeMismatchDetail | null;
+    setProductTypeMismatch: (detail: ProductTypeMismatchDetail | null) => void;
 }
-declare const CartCtx: React.Context<CartContextValue | null> | null;
+declare const CartCtx: React__default.Context<CartContextValue | null> | null;
 declare function CartProvider({ children }: {
     children: ReactNode;
-}): string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | React.FunctionComponentElement<React.ProviderProps<CartContextValue | null>> | null | undefined;
-declare function useCart(config?: SdkConfig, accessToken?: string | null): UseCartReturn;
+}): string | number | bigint | boolean | React__default.ReactElement<unknown, string | React__default.JSXElementConstructor<any>> | Iterable<React__default.ReactNode> | Promise<string | number | bigint | boolean | React__default.ReactPortal | React__default.ReactElement<unknown, string | React__default.JSXElementConstructor<any>> | Iterable<React__default.ReactNode> | null | undefined> | React__default.FunctionComponentElement<React__default.ProviderProps<CartContextValue | null>> | null | undefined;
+declare function useCart(config?: SdkConfig, accessToken?: string | null, guestSessionId?: string | null): UseCartReturn;
 
 declare function useOrders(arg1?: SdkConfig | {
     page?: number;
-    pageSize?: number;
+    page_size?: number;
 }, arg2?: string | null, arg3?: {
     page?: number;
-    pageSize?: number;
-}): any;
-declare function useOrdersList(arg1?: any, arg2?: any, arg3?: any): any;
-declare function useFindOrder(arg1?: SdkConfig | string | FindOrderParams, arg2?: FindOrderParams): any;
-declare function useOrder(arg1?: SdkConfig | string | FindOrderParams, arg2?: FindOrderParams): any;
-declare function useOrderTracking(arg1?: SdkConfig | string, arg2?: string, arg3?: string): any;
-declare function useCreateOrder(config?: SdkConfig, accessToken?: string | null): any;
-declare function useCancelOrder(config?: SdkConfig, accessToken?: string | null): any;
+    page_size?: number;
+}): _tanstack_react_query.UseQueryResult<NoInfer<Order[]>, Error>;
+declare function useOrdersList(arg1?: unknown, arg2?: unknown, arg3?: unknown): _tanstack_react_query.UseQueryResult<NoInfer<Order[]>, Error>;
+declare function useFindOrder(arg1?: SdkConfig | string | FindOrderParams, arg2?: FindOrderParams): _tanstack_react_query.UseQueryResult<NoInfer<Order>, Error>;
+declare function useOrder(arg1?: SdkConfig | string | FindOrderParams, arg2?: FindOrderParams): _tanstack_react_query.UseQueryResult<NoInfer<Order>, Error>;
+/**
+ * REAL BUG FIXED (2026-09-22): took an arbitrary "guestToken" string —
+ * trackOrder's real backend endpoint (GET /orders/{id}) has no guest-token
+ * concept at all, it requires a genuine authenticated JWT belonging to the
+ * order's own customer (see trackOrder's doc comment). Resolves a real
+ * accessToken from SdkContext like every other authenticated hook instead.
+ */
+declare function useOrderTracking(config?: SdkConfig, accessToken?: string | null, orderId?: string): _tanstack_react_query.UseQueryResult<NoInfer<Order>, Error>;
+/**
+ * REAL BUG FIXED (2026-09-22): passed `token || ''` — an empty string
+ * `accessToken`, which used to produce a malformed `Authorization: Bearer `
+ * header instead of genuinely omitting it. Combined with createOrder's own
+ * fix (see its doc comment), guest checkout through this hook has never
+ * actually worked even though the real backend endpoint was built to
+ * support it via X-Guest-Session — the same guestSessionId SdkContext
+ * already resolves for every useCart() call site now also reaches here.
+ */
+declare function useCreateOrder(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<Order, Error, CreateOrderParams, unknown>;
+declare function useCreateBespokeOrder(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<Order, Error, CreateBespokeOrderParams, unknown>;
+declare function useCreateServiceBookingOrder(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<Order, Error, CreateServiceBookingOrderParams, unknown>;
+declare function useCancelOrder(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<Order, Error, {
+    orderId: string;
+    reason?: string;
+}, unknown>;
+
+declare function useCreateConsultation(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<Consultation, Error, CreateConsultationParams, unknown>;
 
-declare function useAuthUser(config?: SdkConfig, accessToken?: string): any;
-declare function useLogin(config?: SdkConfig): any;
-declare function useRegister(config?: SdkConfig): any;
-declare function useUpdateProfile(config?: SdkConfig, accessToken?: string | null): any;
-declare function useLogout(config?: SdkConfig, refreshToken?: string): any;
+declare function useCreateFeedback(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<Feedback, Error, CreateFeedbackParams, unknown>;
+declare function useMyFeedback(params?: {
+    page?: number;
+    page_size?: number;
+}, config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseQueryResult<NoInfer<FeedbackListResponse>, Error>;
+
+declare function useCustomerAddresses(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseQueryResult<NoInfer<CustomerAddress[]>, Error>;
+declare function useCreateCustomerAddress(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<CustomerAddress, Error, CreateCustomerAddressPayload, unknown>;
+declare function useUpdateCustomerAddress(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<CustomerAddress, Error, {
+    addressId: string;
+    payload: UpdateCustomerAddressPayload;
+}, unknown>;
+declare function useDeleteCustomerAddress(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
 
+declare function useAuthUser(config?: SdkConfig, accessToken?: string): _tanstack_react_query.UseQueryResult<NoInfer<AuthUserResponse>, Error>;
+/**
+ * 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.
+ */
+declare function useStorefrontBusinessInfo(config?: SdkConfig): _tanstack_react_query.UseQueryResult<NoInfer<StorefrontBusinessInfo>, Error>;
+declare function useLogin(config?: SdkConfig): _tanstack_react_query.UseMutationResult<CustomerAuthResponse, Error, CustomerLoginPayload, unknown>;
+declare function useRegister(config?: SdkConfig): _tanstack_react_query.UseMutationResult<CustomerAuthResponse, Error, CustomerRegisterPayload, unknown>;
+declare function useRequestOtp(config?: SdkConfig): _tanstack_react_query.UseMutationResult<void, Error, CustomerPasswordlessRequestPayload, unknown>;
+declare function useVerifyOtp(config?: SdkConfig): _tanstack_react_query.UseMutationResult<CustomerAuthResponse, Error, CustomerPasswordlessVerifyPayload, unknown>;
+declare function useCustomerForgotPassword(config?: SdkConfig): _tanstack_react_query.UseMutationResult<{
+    detail: string;
+}, Error, CustomerForgotPasswordPayload, unknown>;
+declare function useCustomerResetPassword(config?: SdkConfig): _tanstack_react_query.UseMutationResult<{
+    detail: string;
+}, Error, CustomerResetPasswordPayload, unknown>;
+declare function useCustomerDeactivateAccount(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<DeactivateAccountResult, Error, CustomerDeactivatePayload | undefined, unknown>;
+declare function useCustomerReactivateRequest(config?: SdkConfig): _tanstack_react_query.UseMutationResult<{
+    detail: string;
+}, Error, CustomerReactivatePayload, unknown>;
+declare function useCustomerReactivateVerify(config?: SdkConfig): _tanstack_react_query.UseMutationResult<{
+    detail: string;
+}, Error, CustomerReactivateVerifyPayload, unknown>;
+declare function useUpdateProfile(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<CustomerUser, Error, UpdateProfilePayload, unknown>;
+/**
+ * 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).
+ */
+declare function useChangePassword(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<{
+    detail: string;
+}, Error, ChangePasswordPayload, unknown>;
+declare function useLogout(config?: SdkConfig, refreshToken?: string): _tanstack_react_query.UseMutationResult<void, Error, void, unknown>;
+
+/**
+ * REAL BUG FIXED (2026-09-22): raw fetch() with a generic `HTTP ${status}`
+ * error — this file predates apiRequest and was missed when every other
+ * REST call site in the SDK was migrated onto it (it lives in a hook file,
+ * not services/*.ts, which is how the original migration pass missed it).
+ */
 declare function getCountries(config: SdkConfig): Promise<Country[]>;
-declare function useCountries(config?: SdkConfig): any;
+declare function useCountries(config?: SdkConfig): _tanstack_react_query.UseQueryResult<NoInfer<Country[]>, Error>;
 
+/** Raw fetch() -> apiRequest, same fix as use-countries.ts. */
 declare function getStates(config: SdkConfig, countryIso: string): Promise<State[]>;
-declare function useStates(countryIso: string, config?: SdkConfig): any;
+declare function useStates(countryIso: string, config?: SdkConfig): _tanstack_react_query.UseQueryResult<NoInfer<State[]>, Error>;
 
 declare function getSupportedLanguagesList(config: SdkConfig): Promise<SupportedLang[]>;
 declare function useSupportedLanguages(config?: SdkConfig): UseQueryResult<SupportedLang[], Error>;
 
 declare function getSupportedCurrenciesList(config: SdkConfig): Promise<Currency[]>;
-declare function useCurrencies(config?: SdkConfig): any;
+declare function useCurrencies(config?: SdkConfig): _tanstack_react_query.UseQueryResult<NoInfer<Currency[]>, Error>;
 
 /**
  * Get bespoke availability for a product
  */
-declare function useBespokeAvailability(product_id: string, config?: SdkConfig): any;
+declare function useBespokeAvailability(product_id: string, config?: SdkConfig): _tanstack_react_query.UseQueryResult<NoInfer<BespokeAvailability>, Error>;
+/** Buyer approves a bespoke order's submitted deliverable. */
+declare function useApproveBespokeDeliverable(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<BespokeDeliverableStatus, Error, string, unknown>;
+/** Buyer requests a revision on a bespoke order's submitted deliverable. */
+declare function useRequestBespokeRevision(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<BespokeDeliverableStatus, Error, {
+    orderId: string;
+    notes: string;
+}, unknown>;
 
 declare const collectionKeys: {
     all: readonly ["core", "collections"];
@@ -104,72 +200,45 @@ declare const collectionKeys: {
 };
 /**
  * Hook to fetch paginated collections for the storefront.
- * Fetches from Next.js API route to avoid exposing backend URLs.
  */
-declare function useStorefrontCollections(params?: ListParams): any;
+declare function useStorefrontCollections(params?: ListParams, config?: SdkConfig): _tanstack_react_query.UseQueryResult<NoInfer<PaginatedResponse<Collection>>, Error>;
 /**
  * Hook to fetch a single collection by slug for the storefront.
- * Fetches from Next.js API route to avoid exposing backend URLs.
  */
-declare function useStorefrontCollection(slug: string): any;
+declare function useStorefrontCollection(slug: string, config?: SdkConfig): _tanstack_react_query.UseQueryResult<NoInfer<Collection>, Error>;
 
 declare const productKeys: {
     all: readonly ["products"];
     list: (params?: ListParams) => readonly ["products", "list", ListParams | undefined];
     detail: (slug: string) => readonly ["products", "detail", string];
     recommended: (params?: ListParams) => readonly ["products", "recommended", ListParams | undefined];
-    latest: (params?: ListParams) => readonly ["products", "latest", ListParams | undefined];
     popular: (params?: ListParams) => readonly ["products", "popular", ListParams | undefined];
     featured: (params?: ListParams) => readonly ["products", "featured", ListParams | undefined];
     new: (params?: ListParams) => readonly ["products", "new", ListParams | undefined];
     onSale: (params?: ListParams) => readonly ["products", "onSale", ListParams | undefined];
-    lowStock: (params?: ListParams) => readonly ["products", "lowStock", ListParams | undefined];
 };
-/**
- * Hook for fetching latest products.
- * Fetches from Next.js API route to avoid exposing backend URLs.
- */
-declare function useLatestProducts(params?: ListParams): any;
 /**
  * Hook for fetching popular products.
- * Fetches from Next.js API route to avoid exposing backend URLs.
  */
-declare function usePopularProducts(params?: ListParams): any;
+declare function usePopularProducts(params?: ListParams, config?: SdkConfig): _tanstack_react_query.UseQueryResult<NoInfer<PaginatedResponse<Product>>, Error>;
 /**
  * Hook for fetching featured products.
- * Fetches from Next.js API route to avoid exposing backend URLs.
  */
-declare function useFeaturedProducts(params?: ListParams): any;
+declare function useFeaturedProducts(params?: ListParams, config?: SdkConfig): _tanstack_react_query.UseQueryResult<NoInfer<PaginatedResponse<Product>>, Error>;
 /**
  * Hook for fetching new products.
- * Fetches from Next.js API route to avoid exposing backend URLs.
  */
-declare function useNewProducts(params?: ListParams): any;
+declare function useNewProducts(params?: ListParams, config?: SdkConfig): _tanstack_react_query.UseQueryResult<NoInfer<PaginatedResponse<Product>>, Error>;
 /**
  * Hook for fetching products currently on sale.
- * Fetches from Next.js API route to avoid exposing backend URLs.
  */
-declare function useOnSaleProducts(params?: ListParams): any;
-/**
- * Hook for fetching products with low stock.
- * Fetches from Next.js API route to avoid exposing backend URLs.
- */
-declare function useLowStockProducts(params?: ListParams): any;
-/**
- * Hook for fetching all active storefront products.
- * Fetches from Next.js API route to avoid exposing backend URLs.
- */
-declare function useStorefrontProducts(params?: ListParams): any;
-/**
- * Hook for fetching a single product by slug.
- * Fetches from Next.js API route to avoid exposing backend URLs.
- */
-declare function useProduct(slug: string): any;
+declare function useOnSaleProducts(params?: ListParams, config?: SdkConfig): _tanstack_react_query.UseQueryResult<NoInfer<PaginatedResponse<Product>>, Error>;
 /**
  * Hook for fetching recommended products.
- * Fetches from Next.js API route to avoid exposing backend URLs.
  */
-declare function useRecommendedProducts(params?: ListParams): any;
+declare function useRecommendedProducts(params?: ListParams & {
+    excludeProductId?: string;
+}, config?: SdkConfig): _tanstack_react_query.UseQueryResult<NoInfer<PaginatedResponse<Product>>, Error>;
 
 declare const wishlistKeys: {
     all: readonly ["wishlist"];
@@ -182,83 +251,68 @@ declare function useWishlist(arg1?: SdkConfig | {
 }, arg2?: string | null, arg3?: {
     page?: number;
     pageSize?: number;
-}): any;
-declare function useCheckInWishlist(arg1?: SdkConfig | string, arg2?: string | null, arg3?: string): any;
-declare function useAddToWishlist(config?: SdkConfig, accessToken?: string | null): any;
-declare function useRemoveFromWishlist(config?: SdkConfig, accessToken?: string | null): any;
-declare function useRemoveProductFromWishlist(config?: SdkConfig, accessToken?: string | null): any;
-
-declare function useAvailableSlots(arg1?: SdkConfig | string, arg2?: string, arg3?: string, arg4?: string): any;
-declare function useBookAppointment(config?: SdkConfig, accessToken?: string | null): any;
-declare function useAppointments(config?: SdkConfig, accessToken?: string | null): any;
-declare function useAppointment(arg1?: SdkConfig | string, arg2?: string | null, arg3?: string): any;
-declare function useCancelAppointment(config?: SdkConfig, accessToken?: string | null): any;
-declare function useDeliverables(arg1?: SdkConfig | string, arg2?: string | null, arg3?: string): any;
-declare function useApproveDeliverable(config?: SdkConfig, accessToken?: string | null, order_id?: string, deliverable_id?: string): any;
-declare function useRequestRevision(config?: SdkConfig, accessToken?: string | null, order_id?: string, deliverable_id?: string): any;
+}): _tanstack_react_query.UseQueryResult<NoInfer<WishlistListResponse>, Error>;
+declare function useCheckInWishlist(arg1?: SdkConfig | string, arg2?: string | null, arg3?: string): _tanstack_react_query.UseQueryResult<NoInfer<WishlistCheckResponse>, Error>;
+declare function useAddToWishlist(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<WishlistItem, Error, {
+    productId: string;
+    notes?: string;
+}, unknown>;
+declare function useRemoveFromWishlist(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
+declare function useRemoveProductFromWishlist(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
 
-declare function useConsultations(config?: SdkConfig, accessToken?: string | null): any;
-declare function useConsultation(arg1?: SdkConfig | string, arg2?: string | null, arg3?: string): any;
-declare function useCreateConsultation(config?: SdkConfig, accessToken?: string | null): any;
-declare function useSendMessage(arg1?: SdkConfig | string, arg2?: string | null, arg3?: string): any;
-declare function useAcceptQuote(arg1?: SdkConfig | string, arg2?: string | null, arg3?: string): any;
-declare function useRejectQuote(arg1?: SdkConfig | string, arg2?: string | null, arg3?: string): any;
+declare function useAvailableSlots(config: SdkConfig | undefined, productId: string | undefined, date: string | undefined, params?: {
+    staffId?: string;
+    locationId?: string;
+    customerLatitude?: number;
+    customerLongitude?: number;
+}): _tanstack_react_query.UseQueryResult<NoInfer<AvailableSlotsResponse>, Error>;
+declare function useBookAppointment(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<ServiceAppointment, Error, ServiceAppointmentCreatePayload, unknown>;
+declare function useAppointments(config?: SdkConfig, accessToken?: string | null, params?: {
+    status?: ServiceAppointment['status'];
+    page?: number;
+    page_size?: number;
+}): _tanstack_react_query.UseQueryResult<NoInfer<ServiceBookingsPage>, Error>;
+declare function useAppointment(config: SdkConfig | undefined, accessToken: string | null | undefined, id: string | undefined): _tanstack_react_query.UseQueryResult<NoInfer<ServiceAppointment>, Error>;
+declare function useCancelAppointment(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<ServiceAppointment, Error, {
+    id: string;
+    payload?: CancelAppointmentPayload;
+}, unknown>;
+declare function useRescheduleAppointment(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<ServiceAppointment, Error, {
+    id: string;
+    payload: RescheduleAppointmentPayload;
+}, unknown>;
+declare function useDisputeAppointment(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<ServiceAppointment, Error, {
+    id: string;
+    payload: DisputeAppointmentPayload;
+}, unknown>;
+declare function useConfirmAppointmentCompletion(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<ServiceAppointment, Error, {
+    id: string;
+    payload?: ConfirmAppointmentPayload;
+}, unknown>;
+declare function useMilestones(config: SdkConfig | undefined, accessToken: string | null | undefined, bookingId: string | undefined): _tanstack_react_query.UseQueryResult<NoInfer<ServiceMilestone[]>, Error>;
+declare function useApproveMilestone(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<ServiceMilestone, Error, {
+    bookingId: string;
+    milestoneId: string;
+    payload?: ApproveMilestonePayload;
+}, unknown>;
 
-interface ConsultationMessageData {
-    event: string;
-    data: {
-        consultation_id: string;
-        message_id: string;
-        sender_id: string;
-        sender_role: string;
-        message: string;
-        attachments?: Array<{
-            url: string;
-            type: string;
-            name: string;
-        }>;
-        created_at: string;
-    };
-}
-interface ConsultationQuoteData {
-    event: string;
-    data: {
-        consultation_id: string;
-        quote_amount: number;
-        deposit_amount?: number;
-        merchant_notes?: string;
-        updated_at: string;
-    };
-}
-interface ConsultationStatusData {
+interface PaymentSuccessData {
     event: string;
     data: {
-        consultation_id: string;
+        transaction_id: string;
+        order_id: string;
+        amount: number;
+        currency: string;
         status: string;
-        updated_at: string;
     };
 }
-interface UseConsultationStreamOptions {
-    config: SdkConfig;
-    consultationId: string;
-    onMessage?: (data: ConsultationMessageData) => void;
-    onQuote?: (data: ConsultationQuoteData) => void;
-    onStatusChange?: (data: ConsultationStatusData) => void;
-    onError?: (error: Error) => void;
-}
-declare function useConsultationStream({ config, consultationId, onMessage, onQuote, onStatusChange, onError, }: UseConsultationStreamOptions): {
-    isConnected: boolean;
-    lastEvent: any;
-};
-
-interface PaymentSuccessData {
+interface PaymentFailedData {
     event: string;
     data: {
         transaction_id: string;
         order_id: string;
-        amount: number;
-        currency: string;
         status: string;
+        gateway: string;
     };
 }
 interface DigitalReadyData {
@@ -289,17 +343,6 @@ interface BespokeUpdateData {
         updated_at: string;
     };
 }
-interface ConsultationUpdateData {
-    event: string;
-    data: {
-        consultation_id: string;
-        business_id: string;
-        customer_id: string;
-        status: string;
-        message?: string;
-        updated_at: string;
-    };
-}
 interface ServiceBookingUpdateData {
     event: string;
     data: {
@@ -316,13 +359,80 @@ interface UseOrderStreamOptions {
     config?: SdkConfig;
     orderId: string;
     onPaymentComplete?: (data: PaymentSuccessData) => void;
+    /** Fires on a real "payment.failed" event from the order-scoped stream (kasuvia-payment-system-go's webhook services now publish this — see monnify_webhook_service.go/flutterwave_webhook_service.go). */
+    onPaymentFailed?: (data: PaymentFailedData) => void;
     onDigitalReady?: (data: DigitalReadyData) => void;
     onBespokeUpdate?: (data: BespokeUpdateData) => void;
-    onConsultationUpdate?: (data: ConsultationUpdateData) => void;
     onServiceBookingUpdate?: (data: ServiceBookingUpdateData) => void;
     onError?: (error: Error) => void;
 }
-declare function useOrderStream({ config: explicitConfig, orderId, onPaymentComplete, onDigitalReady, onBespokeUpdate, onConsultationUpdate, onServiceBookingUpdate, onError }: UseOrderStreamOptions): null;
+declare function useOrderStream({ config: explicitConfig, orderId, onPaymentComplete, onPaymentFailed, onDigitalReady, onBespokeUpdate, onServiceBookingUpdate, onError }: UseOrderStreamOptions): null;
+
+/**
+ * Hook to create a new review
+ */
+declare function useCreateReview(config?: SdkConfig): _tanstack_react_query.UseMutationResult<Review, Error, ReviewCreate, unknown>;
+/**
+ * Hook to update an existing review
+ */
+declare function useUpdateReview(config?: SdkConfig): _tanstack_react_query.UseMutationResult<Review, Error, {
+    reviewId: string;
+    reviewData: ReviewUpdate;
+}, unknown>;
+/**
+ * Hook to get product reviews
+ */
+declare function useProductReviews(productId: string, params?: {
+    page?: number;
+    page_size?: number;
+}, config?: SdkConfig): _tanstack_react_query.UseQueryResult<NoInfer<ProductReviewsResponse>, Error>;
+/**
+ * Hook to create a new comment
+ */
+declare function useCreateComment(config?: SdkConfig): _tanstack_react_query.UseMutationResult<Comment, Error, CommentCreate, unknown>;
+/**
+ * Hook to update an existing comment
+ */
+declare function useUpdateComment(config?: SdkConfig): _tanstack_react_query.UseMutationResult<Comment, Error, {
+    commentId: string;
+    commentData: CommentUpdate;
+}, unknown>;
+/**
+ * Hook to get product comments
+ */
+declare function useProductComments(productId: string, params?: {
+    page?: number;
+    page_size?: number;
+}, config?: SdkConfig): _tanstack_react_query.UseQueryResult<NoInfer<ProductCommentsResponse>, Error>;
+/**
+ * Hook to get pending reviews (merchant/staff only)
+ */
+declare function usePendingReviews(config?: SdkConfig): _tanstack_react_query.UseQueryResult<NoInfer<Review[]>, Error>;
+/**
+ * Hook to get pending comments (merchant/staff only)
+ */
+declare function usePendingComments(config?: SdkConfig): _tanstack_react_query.UseQueryResult<NoInfer<Comment[]>, Error>;
+/**
+ * Hook to moderate a review (merchant/staff only)
+ */
+declare function useModerateReview(config?: SdkConfig): _tanstack_react_query.UseMutationResult<Review, Error, {
+    reviewId: string;
+    action: ReviewModerationAction;
+}, unknown>;
+/**
+ * Hook to moderate a comment (merchant/staff only)
+ */
+declare function useModerateComment(config?: SdkConfig): _tanstack_react_query.UseMutationResult<Comment, Error, {
+    commentId: string;
+    action: CommentModerationAction;
+}, unknown>;
+/**
+ * Hook to post a merchant reply to a review (merchant/staff only)
+ */
+declare function useMerchantReplyToReview(config?: SdkConfig): _tanstack_react_query.UseMutationResult<Review, Error, {
+    reviewId: string;
+    replyData: MerchantReplyCreate;
+}, unknown>;
 
 declare function useIsMounted(): boolean;
 
@@ -352,37 +462,63 @@ declare function useGoogleTranslate(configOrLang?: SdkConfig | string, appLang?:
     isLoaded: boolean;
 };
 
+/**
+ * Hook for fetching available payment methods for a region.
+ *
+ * `currency`/`countryCode` are optional with no SDK-level default — see
+ * getAvailablePaymentMethods' doc comment: the real backend already
+ * declares its own default for this route, so leaving them unset here
+ * lets that be the single source of truth instead of risking a second,
+ * independently-hardcoded copy drifting out of sync with it.
+ */
+declare function useAvailablePaymentMethods(config?: SdkConfig, currency?: string, countryCode?: string): _tanstack_react_query.UseQueryResult<NoInfer<GatewayMethods[]>, Error>;
+/**
+ * Hook for fetching authenticated customer's wallet balance.
+ */
+declare function useWalletBalance(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseQueryResult<NoInfer<WalletBalanceResponse>, Error>;
+/**
+ * Hook for fetching authenticated customer's wallet ledger history.
+ */
+declare function useWalletLedger(config?: SdkConfig, accessToken?: string | null, params?: {
+    page?: number;
+    page_size?: number;
+}): _tanstack_react_query.UseQueryResult<NoInfer<WalletLedgerResponse>, Error>;
+/**
+ * Hook for claiming pending guest wallet credit into customer's wallet.
+ */
+declare function useClaimWalletCredit(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<WalletBalanceResponse, Error, string, unknown>;
 /**
  * Hook for creating a Dedicated Virtual Account (DVA)
- * Optional config and accessToken — read from SdkContext if omitted.
+ * Supports both authenticated users and guest checkout.
  */
-declare function useCreateDVA(config?: SdkConfig, accessToken?: string | null): any;
+declare function useCreateDVA(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<DVADetails, Error, DVACreateRequest, unknown>;
 /**
- * Hook for initiating card payment
- * Optional config and accessToken — read from SdkContext if omitted.
+ * Hook for initiating payment (card, transfer, etc.)
+ * Supports both authenticated users and guest checkout.
  */
-declare function useInitiatePayment(config?: SdkConfig, accessToken?: string | null): any;
+declare function useInitiatePayment(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<PaymentInitiateResponse, Error, PaymentInitiateRequest, unknown>;
 /**
  * Hook for verifying a transaction
  * Optional config — read from SdkContext if omitted.
  */
-declare function useVerifyTransaction(config?: SdkConfig): any;
+declare function useVerifyTransaction(config?: SdkConfig): _tanstack_react_query.UseMutationResult<TransactionVerifyResponse, Error, string, unknown>;
 /**
  * Hook for getting transaction status
  * Optional config — read from SdkContext if omitted.
  */
-declare function useTransactionStatus(arg1?: SdkConfig | string, arg2?: string | boolean, arg3?: boolean): any;
+declare function useTransactionStatus(arg1?: SdkConfig | string, arg2?: string | boolean, arg3?: boolean): _tanstack_react_query.UseQueryResult<NoInfer<TransactionVerifyResponse>, Error>;
 /**
  * Hook for checking transaction status with automatic polling
  * Optional config — read from SdkContext if omitted.
  */
-declare function usePollTransactionStatus(arg1?: SdkConfig | string, arg2?: string | boolean, arg3?: boolean): any;
+declare function usePollTransactionStatus(arg1?: SdkConfig | string, arg2?: string | boolean, arg3?: boolean): _tanstack_react_query.UseQueryResult<NoInfer<TransactionVerifyResponse>, Error>;
 
 interface UseCmsEntriesReturn {
     entries: CmsEntry[];
     total: number;
     page: number;
     page_size: number;
+    total_pages: number;
     isLoading: boolean;
     error: Error | null;
     refetch: () => void;
@@ -426,6 +562,100 @@ interface UseDeleteCmsEntryReturn {
 }
 declare function useDeleteCmsEntry(config?: SdkConfig, accessToken?: string | null, modelSlug?: string): UseDeleteCmsEntryReturn;
 
+declare function useBusinessConfig(config?: SdkConfig): _tanstack_react_query.UseQueryResult<NoInfer<BusinessConfig>, Error>;
+/**
+ * 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.
+ */
+declare function useFormatPrice(config?: SdkConfig): {
+    formatPrice: (amount: number | null | undefined) => string;
+    currency: string | null;
+};
+
+declare function useNotificationPreferences(config?: SdkConfig, accessToken?: string): _tanstack_react_query.UseQueryResult<NoInfer<NotificationPreferences>, Error>;
+declare function useUpdateNotificationPreferences(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<NotificationPreferences, Error, Partial<NotificationPreferences>, unknown>;
+declare function useVapidPublicKey(config?: SdkConfig): _tanstack_react_query.UseQueryResult<NoInfer<VapidPublicKeyResponse>, Error>;
+declare function useSubscribeToPush(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<{
+    status: string;
+    subscription_id: string;
+    vapid_key_version: number;
+}, Error, SubscribeToPushParams, unknown>;
+declare function useUnsubscribeFromPush(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<{
+    status: string;
+}, Error, string, unknown>;
+declare function useNotificationInbox(params?: {
+    page?: number;
+    limit?: number;
+    unread_only?: boolean;
+}, config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseQueryResult<NoInfer<NotificationInboxResponse>, Error>;
+declare function useMarkNotificationRead(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<{
+    status: string;
+}, Error, string, unknown>;
+declare function useMarkAllNotificationsRead(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<{
+    status: string;
+}, Error, void, unknown>;
+declare function useTrackNotificationClick(config?: SdkConfig, accessToken?: string | null): _tanstack_react_query.UseMutationResult<{
+    status: string;
+}, Error, string, unknown>;
+/**
+ * Submit contact form hook — sends contact email to merchant and confirmation to sender.
+ */
+declare function useSubmitContactForm(config?: SdkConfig): _tanstack_react_query.UseMutationResult<{
+    detail: string;
+}, Error, ContactFormData, unknown>;
+
+interface NotificationStreamMessage {
+    type: string;
+    title?: string;
+    body?: string;
+    data?: Record<string, unknown>;
+    timestamp?: string;
+}
+interface UseNotificationStreamOptions {
+    config?: SdkConfig;
+    accessToken?: string | null;
+    onNotification?: (message: NotificationStreamMessage) => void;
+    onError?: (error: Error) => void;
+}
+/**
+ * Live connection to the authenticated customer's real-time notification
+ * stream (kasuvia-notification-system-go's /notifications/sse — now
+ * Authorization-header-gated, see realtime.go's 2026-09-21 fix). Mirrors
+ * use-order-stream.ts's proven fetch-event-source pattern exactly.
+ */
+declare function useNotificationStream({ config: explicitConfig, accessToken: explicitToken, onNotification, onError, }: UseNotificationStreamOptions): void;
+
+type PushPermissionState = 'unsupported' | 'default' | 'granted' | 'denied';
+/**
+ * Orchestrates the full Web Push subscribe/unsubscribe flow: registers
+ * /sw.js (the storefront app's own service worker — see its doc comment),
+ * requests Notification permission, subscribes via PushManager with the
+ * real VAPID key from the backend, and POSTs the subscription to
+ * kasuvia-notification-system-go. Returns current state + trigger functions
+ * — no UI of its own, so any storefront can build its own "enable
+ * notifications" affordance around it.
+ */
+declare function usePushNotifications(config?: SdkConfig, accessToken?: string | null): {
+    permission: PushPermissionState;
+    isSubscribed: boolean;
+    isBusy: boolean;
+    subscribe: () => Promise<void>;
+    unsubscribe: () => Promise<void>;
+};
+
+declare function useUploadMediaFile(): _tanstack_react_query.UseMutationResult<MediaAsset, Error, UploadMediaFileParams, unknown>;
+declare function useUploadMediaFiles(): _tanstack_react_query.UseMutationResult<UploadMediaFilesResult, Error, Omit<UploadMediaFileParams, "file"> & {
+    files: File[];
+}, unknown>;
+
 /**
  * SdkContext
  *
@@ -446,13 +676,16 @@ declare function useDeleteCmsEntry(config?: SdkConfig, accessToken?: string | nu
 interface SdkContextValue {
     config: SdkConfig;
     accessToken: string | null;
+    /** Current browser's guest cart session id (see utils/guest-session.ts) — null when unauthenticated context hasn't resolved one yet, or when the caller is authenticated and doesn't need one. */
+    guestSessionId?: string | null;
 }
 interface SdkProviderProps {
     config: SdkConfig;
     accessToken: string | null;
+    guestSessionId?: string | null;
     children: ReactNode;
 }
-declare function SdkProvider({ config, accessToken, children }: SdkProviderProps): React.JSX.Element;
+declare function SdkProvider({ config, accessToken, guestSessionId, children }: SdkProviderProps): React__default.JSX.Element;
 /**
  * Returns the SdkContext value, or null if no SdkProvider is present.
  * SDK hooks use this internally to fall back to context when explicit
@@ -468,4 +701,4 @@ declare function resolveHookArgs(explicitConfig: SdkConfig | undefined, explicit
     accessToken: string | null;
 };
 
-export { type CartContextValue, CartCtx, CartProvider, type SdkContextValue, SdkProvider, type SdkProviderProps, type UseCartReturn, type UseCmsEntriesReturn, type UseCmsEntryReturn, type UseCreateCmsEntryReturn, type UseDeleteCmsEntryReturn, type UseOrderStreamOptions, type UseUpdateCmsEntryReturn, collectionKeys, getCountries, getStates, getSupportedCurrenciesList, getSupportedLanguagesList, productKeys, resolveHookArgs, useAcceptQuote, useAddToWishlist, useAppointment, useAppointments, useApproveDeliverable, useAuthUser, useAvailableSlots, useBespokeAvailability, useBookAppointment, useCancelAppointment, useCancelOrder, useCart, useCheckInWishlist, useCmsEntries, useCmsEntry, useConsultation, useConsultationStream, useConsultations, useCountries, useCreateCmsEntry, useCreateConsultation, useCreateDVA, useCreateOrder, useCurrencies, useDeleteCmsEntry, useDeliverables, useFeaturedProducts, useFindOrder, useGoogleTranslate, useInitiatePayment, useIsMobile, useIsMounted, useLatestProducts, useLogin, useLogout, useLowStockProducts, useNewProducts, useOnSaleProducts, useOrder, useOrderStream, useOrderTracking, useOrders, useOrdersList, usePollTransactionStatus, usePopularProducts, useProduct, useRecommendedProducts, useRegister, useRejectQuote, useRemoveFromWishlist, useRemoveProductFromWishlist, useRequestRevision, useSdkContext, useSendMessage, useStates, useStorefrontCollection, useStorefrontCollections, useStorefrontProducts, useSupportedLanguages, useTransactionStatus, useUpdateCmsEntry, useUpdateProfile, useVerifyTransaction, useWishlist, wishlistKeys };
+export { type CartContextValue, CartCtx, CartProvider, type ProductTypeMismatchDetail, type PushPermissionState, type SdkContextValue, SdkProvider, type SdkProviderProps, type UseCartReturn, type UseCmsEntriesReturn, type UseCmsEntryReturn, type UseCreateCmsEntryReturn, type UseDeleteCmsEntryReturn, type UseNotificationStreamOptions, type UseOrderStreamOptions, type UseUpdateCmsEntryReturn, collectionKeys, getCountries, getStates, getSupportedCurrenciesList, getSupportedLanguagesList, productKeys, resolveHookArgs, useAddToWishlist, useAppointment, useAppointments, useApproveBespokeDeliverable, useApproveMilestone, useAuthUser, useAvailablePaymentMethods, useAvailableSlots, useBespokeAvailability, useBookAppointment, useBusinessConfig, useCancelAppointment, useCancelOrder, useCart, useChangePassword, useCheckInWishlist, useClaimWalletCredit, useCmsEntries, useCmsEntry, useConfirmAppointmentCompletion, useCountries, useCreateBespokeOrder, useCreateCmsEntry, useCreateComment, useCreateConsultation, useCreateCustomerAddress, useCreateDVA, useCreateFeedback, useCreateOrder, useCreateReview, useCreateServiceBookingOrder, useCurrencies, useCustomerAddresses, useCustomerDeactivateAccount, useCustomerForgotPassword, useCustomerReactivateRequest, useCustomerReactivateVerify, useCustomerResetPassword, useDeleteCmsEntry, useDeleteCustomerAddress, useDisputeAppointment, useFeaturedProducts, useFindOrder, useFormatPrice, useGoogleTranslate, useInitiatePayment, useIsMobile, useIsMounted, useLogin, useLogout, useMarkAllNotificationsRead, useMarkNotificationRead, useMerchantReplyToReview, useMilestones, useModerateComment, useModerateReview, useMyFeedback, useNewProducts, useNotificationInbox, useNotificationPreferences, useNotificationStream, useOnSaleProducts, useOrder, useOrderStream, useOrderTracking, useOrders, useOrdersList, usePendingComments, usePendingReviews, usePollTransactionStatus, usePopularProducts, useProductComments, useProductReviews, usePushNotifications, useRecommendedProducts, useRegister, useRemoveFromWishlist, useRemoveProductFromWishlist, useRequestBespokeRevision, useRequestOtp, useRescheduleAppointment, useSdkContext, useStates, useStorefrontBusinessInfo, useStorefrontCollection, useStorefrontCollections, useSubmitContactForm, useSubscribeToPush, useSupportedLanguages, useTrackNotificationClick, useTransactionStatus, useUnsubscribeFromPush, useUpdateCmsEntry, useUpdateComment, useUpdateCustomerAddress, useUpdateNotificationPreferences, useUpdateProfile, useUpdateReview, useUploadMediaFile, useUploadMediaFiles, useVapidPublicKey, useVerifyOtp, useVerifyTransaction, useWalletBalance, useWalletLedger, useWishlist, wishlistKeys };