@kasuvia/sdk 0.0.2 → 0.0.5

package/dist/index-Dowl5224.d.mts

@@ -0,0 +1,786 @@
+import { H as ServiceLocationType, S as SdkConfig, d as CartResponse, c as CartItem, O as Order, p as CreateOrderParams, F as FindOrderParams, u as ListParams, P as PaginatedResponse, z as Product, m as Collection, _ as WishlistItem, Z as WishlistCheckResponse, $ as WishlistListResponse, s as DVACreateRequest, t as DVADetails, X as TransactionVerifyResponse, x as PaymentInitiateRequest, y as PaymentInitiateResponse, n as ConversionQuote, G as ProductVariant, T as ShippingRatesResponse, W as SupportedLanguagesResponse, U as SupportedCurrenciesResponse, o as CreateCmsEntryParams, e as CmsEntry, L as ListCmsEntriesParams, f as CmsEntryListResponse, Y as UpdateCmsEntryParams } from './index-CzVMyUs4.mjs';
+
+/**
+ * Simplified customer auth types for kasuvia-storefront.
+ * Customers only need enough to track their orders — no RBAC, MFA, or complex profiles.
+ */
+/**
+ * Media System response object for avatar/profile picture.
+ * Stored as JSON in the backend Profile model.
+ */
+interface AvatarObject {
+    id: string;
+    alt: string;
+    url: string;
+}
+interface CustomerProfileFields {
+    firstname: string;
+    lastname: string;
+    phone: string;
+}
+interface CustomerUser {
+    id: string;
+    email: string;
+    firstname?: string;
+    lastname?: string;
+    phone?: string;
+    /** Derived display name — prefer firstname + lastname when available */
+    full_name?: string;
+    avatar: string | null;
+    provider: 'google' | 'facebook' | 'email';
+}
+/** GET/PUT /auth/profile/ — matches kasuvia-auth UserSerializer */
+interface AuthUserResponse {
+    id: string;
+    email: string;
+    is_google_auth_enabled?: boolean;
+    is_facebook_auth_enabled?: boolean;
+    profile?: {
+        firstname?: string;
+        lastname?: string;
+        phone?: string;
+        profile_picture?: string | null;
+    };
+}
+interface UpdateProfilePayload {
+    firstname?: string;
+    lastname?: string;
+    phone?: string;
+}
+interface NotificationPreferences {
+    email_enabled: boolean;
+    sms_enabled: boolean;
+    whatsapp_enabled: boolean;
+    push_enabled: boolean;
+    email_order_confirmations: boolean;
+    email_delivery_updates: boolean;
+    email_low_stock_alerts: boolean;
+    email_payment_received: boolean;
+    push_order_confirmations: boolean;
+    push_delivery_updates: boolean;
+    push_low_stock_alerts: boolean;
+    push_payment_received: boolean;
+    whatsapp_order_confirmations: boolean;
+    whatsapp_delivery_updates: boolean;
+    whatsapp_payment_received: boolean;
+    sms_order_confirmations: boolean;
+    sms_delivery_updates: boolean;
+}
+interface BusinessContext {
+    id: string;
+    business_id: string;
+    name: string;
+    logo_picture?: string | null;
+    display_currency?: string;
+}
+interface CustomerAuthResponse {
+    access: string;
+    refresh: string;
+    user: CustomerUser;
+    business: BusinessContext;
+    is_new?: boolean;
+}
+interface RefreshTokenResponse {
+    access: string;
+    refresh?: string;
+}
+/** POST /auth/login/customer/ — field name is `tenant_id` (the business_id) */
+interface CustomerLoginPayload {
+    tenant_id: string;
+    email: string;
+    password: string;
+}
+/** POST /auth/register/customer/ */
+interface CustomerRegisterPayload {
+    tenant_id: string;
+    first_name?: string;
+    last_name?: string;
+    email: string;
+    password: string;
+}
+/** POST /auth/verify-otp/ */
+interface OTPVerifyPayload {
+    email: string;
+    code: string;
+    purpose?: 'verify' | 'password_reset';
+}
+/** POST /auth/resend-otp/ */
+interface ResendOTPPayload {
+    email: string;
+}
+/** POST /auth/logout/ */
+interface LogoutPayload {
+    refresh?: string;
+}
+interface AuthContextValue {
+    customer: CustomerUser | null;
+    isLoading: boolean;
+    isModalOpen: boolean;
+    openModal: () => void;
+    closeModal: () => void;
+    setCustomer: (user: CustomerUser | null) => void;
+    logout: () => Promise<void>;
+    login: (payload: Omit<CustomerLoginPayload, 'tenant_id'>) => Promise<void>;
+    register: (payload: Omit<CustomerRegisterPayload, 'tenant_id'>) => Promise<{
+        requires_verification: boolean;
+    }>;
+}
+
+/**
+ * Consultation types for customer-facing storefront
+ */
+type ConsultationStatus = "pending" | "quoted" | "negotiating" | "deposit_pending" | "deposit_paid" | "converting" | "converted" | "rejected";
+type ConsultationProductType = "bespoke" | "service";
+interface ConsultationMessage {
+    id: string;
+    consultation_id: string;
+    sender_id: string;
+    sender_role: "customer" | "merchant" | "system";
+    message: string;
+    attachments: string[];
+    is_read: boolean;
+    created_at: string;
+}
+interface Consultation {
+    id: string;
+    business_id: string;
+    customer_id: string;
+    product_id: string | null;
+    title: string;
+    status: ConsultationStatus;
+    product_type: ConsultationProductType;
+    quote_amount: number | null;
+    agreed_price: number | null;
+    deposit_amount: number | null;
+    deposit_required: boolean;
+    is_physical_delivery: boolean;
+    expected_delivery_type: string | null;
+    structured_details: Record<string, unknown>;
+    rejection_reason: string | null;
+    converted_order_id: string | null;
+    slot_booking_id: string | null;
+    capacity_config_id: string | null;
+    created_at: string;
+    updated_at: string;
+    messages: ConsultationMessage[];
+}
+interface ConsultationCreatePayload {
+    product_id?: string;
+    title: string;
+    description: string;
+    reference_images?: string[];
+    custom_measurements?: Record<string, string | number>;
+    preferred_timeline?: string;
+    special_instructions?: string;
+    product_type?: ConsultationProductType;
+}
+interface ConsultationMessagePayload {
+    message: string;
+    attachments?: string[];
+}
+interface ConsultationQuoteAcceptPayload {
+    agreed_price: number;
+}
+interface BespokeAvailability {
+    available_slots: number;
+    next_available_date: string | null;
+    period_end: string;
+    blocked_dates: string[];
+    production_days: number;
+    is_available: boolean;
+}
+
+/**
+ * Service booking types for customer-facing storefront
+ */
+type AppointmentStatus = "pending" | "confirmed" | "in_progress" | "completed" | "voided" | "no_show";
+interface AvailableSlot {
+    date: string;
+    start_time: string;
+    end_time: string;
+    slots_remaining: number;
+}
+interface ServiceAppointment {
+    id: string;
+    product_id: string;
+    customer_id: string;
+    order_id: string | null;
+    status: AppointmentStatus;
+    appointment_date: string;
+    start_time: string;
+    end_time: string;
+    location_type: ServiceLocationType;
+    customer_address: Record<string, unknown> | null;
+    meeting_link: string | null;
+    customer_notes: string | null;
+    price: number;
+    created_at: string;
+    updated_at: string;
+    completed_at: string | null;
+    voided_at: string | null;
+    cancellation_reason: string | null;
+}
+interface ServiceAppointmentCreatePayload {
+    product_id: string;
+    scheduled_date: string;
+    scheduled_time: string;
+    location_type?: ServiceLocationType;
+    customer_address?: Record<string, unknown>;
+    customer_notes?: string;
+}
+interface DeliverableStatus {
+    pending: "pending";
+    in_progress: "in_progress";
+    review: "review";
+    approved: "approved";
+    rejected: "rejected";
+}
+type DeliverableStatusType = DeliverableStatus[keyof DeliverableStatus];
+interface ServiceDeliverable {
+    id: string;
+    order_id: string;
+    title: string;
+    description: string;
+    status: DeliverableStatusType;
+    due_date: string | null;
+    submitted_at: string | null;
+    attachments: string[];
+    customer_feedback: string | null;
+    created_at: string;
+    updated_at: string;
+}
+interface DeliverableApprovalPayload {
+    approved: boolean;
+    feedback?: string;
+}
+
+interface BusinessConfig {
+    business_id: string;
+    storefront_business_id: string;
+    name: string;
+    currency: string;
+    settlement_currency: string;
+    country: string;
+    region: string;
+    is_verified: boolean;
+    is_active: boolean;
+}
+
+/**
+ * Cart Service
+ *
+ * Handles cart operations for both guest and authenticated users.
+ * Stateless - all configuration passed as parameters.
+ */
+
+/**
+ * Fetch guest cart from backend (Redis-backed).
+ */
+declare function getGuestCart(config: SdkConfig, guestSessionId: string): Promise<CartItem[]>;
+/**
+ * Add item to guest cart (Redis-backed).
+ */
+declare function addToGuestCart(config: SdkConfig, guestSessionId: string, item: CartItem): Promise<CartItem[]>;
+/**
+ * Update quantity of a guest cart item.
+ */
+declare function updateGuestCartItemQuantity(config: SdkConfig, guestSessionId: string, itemId: string, quantity: number): Promise<CartItem[]>;
+/**
+ * Remove an item from the guest cart.
+ */
+declare function removeFromGuestCart(config: SdkConfig, guestSessionId: string, itemId: string): Promise<CartItem[]>;
+/**
+ * Clear the entire guest cart.
+ */
+declare function clearGuestCart(config: SdkConfig, guestSessionId: string): Promise<void>;
+/**
+ * Fetch authenticated user's cart from backend.
+ */
+declare function getCart(config: SdkConfig, accessToken?: string | null): Promise<CartResponse>;
+/**
+ * Add item to authenticated user's cart.
+ */
+declare function addToCart(config: SdkConfig, accessToken: string, item: {
+    product_id: string;
+    product_slug: string;
+    product_name: string;
+    image?: string;
+    variant_id?: string;
+    variant_attributes?: string;
+    unit_price: number;
+    quantity: number;
+    custom_measurements?: string;
+    is_bespoke: boolean;
+}): Promise<CartResponse>;
+/**
+ * Update item quantity in authenticated user's cart.
+ */
+declare function updateCartItem(config: SdkConfig, accessToken: string, itemId: string, quantity: number): Promise<CartResponse>;
+/**
+ * Remove item from authenticated user's cart.
+ */
+declare function removeFromCart(config: SdkConfig, accessToken: string, itemId: string): Promise<CartResponse>;
+/**
+ * Clear authenticated user's cart.
+ */
+declare function clearCart(config: SdkConfig, accessToken: string): Promise<void>;
+/**
+ * Merge guest cart (from Redis) into authenticated user's DB cart.
+ */
+declare function mergeGuestCart(config: SdkConfig, accessToken: string, guestSessionId: string): Promise<CartResponse>;
+/**
+ * Convenience wrapper: merge guest cart if it has items (called post-login).
+ */
+declare function mergeGuestCartIfPresent(config: SdkConfig, accessToken: string, guestSessionId: string): Promise<void>;
+/**
+ * Returns 0 — count is now server-driven. Use the hook instead.
+ * Kept for backward compatibility.
+ */
+declare function getGuestCartCount(): number;
+/**
+ * Returns 0 — subtotal is now server-driven.
+ * Kept for backward compatibility.
+ */
+declare function getGuestCartSubtotal(): number;
+/**
+ * Derive product type from items (guest cart, no backend lookup needed).
+ */
+declare function getGuestCartProductType(): "physical" | "digital" | "bespoke";
+
+/**
+ * Order Service
+ *
+ * Handles order operations including creation, lookup, and tracking.
+ * Stateless - all configuration passed as parameters.
+ */
+
+declare function createOrder(config: SdkConfig, accessToken: string, payload: CreateOrderParams): Promise<Order>;
+declare function findOrder(config: SdkConfig, params: FindOrderParams & {
+    guest_token?: string;
+}): Promise<Order>;
+declare function findOrderByToken(config: SdkConfig, token: string): Promise<Order>;
+declare function getOrders(config: SdkConfig, accessToken: string, params?: {
+    email?: string;
+    page?: number;
+    page_size?: number;
+}): Promise<Order[]>;
+declare function cancelOrder(config: SdkConfig, accessToken: string, orderId: string, reason: string): Promise<Order>;
+declare function trackOrder(config: SdkConfig, orderId: string, token?: string): Promise<Order>;
+
+/**
+ * Customer auth service — all API calls scoped to this storefront's business tenant.
+ * Stateless - all configuration passed as parameters.
+ */
+
+/**
+ * POST /auth/login/customer/
+ * The `tenant_id` is automatically filled from config.businessId.
+ */
+declare function loginCustomer(config: SdkConfig, payload: Omit<CustomerLoginPayload, 'tenant_id'>): Promise<CustomerAuthResponse>;
+/**
+ * POST /auth/register/customer/
+ * The `tenant_id` is automatically filled from config.businessId.
+ */
+declare function registerCustomer(config: SdkConfig, payload: Omit<CustomerRegisterPayload, 'tenant_id'>): Promise<CustomerAuthResponse>;
+/** POST /auth/token/refresh/
+ */
+declare function refreshToken(config: SdkConfig, refresh: string): Promise<RefreshTokenResponse>;
+/** POST /auth/logout/ — revokes the server-side session. */
+declare function logout(config: SdkConfig, refresh?: string): Promise<void>;
+/**
+ * Verify a social provider id_token (or access_token for Facebook) with the backend.
+ */
+declare function verifySocialToken(config: SdkConfig, provider: 'google' | 'facebook', token: string): Promise<CustomerAuthResponse>;
+/** Map kasuvia-auth UserSerializer response to storefront CustomerUser. */
+declare function mapAuthUserToCustomer(data: AuthUserResponse, provider?: CustomerUser['provider']): CustomerUser;
+/** GET /auth/profile/ */
+declare function getMe(config?: SdkConfig, accessToken?: string): Promise<CustomerUser>;
+/** GET /auth/profile/ - alias for getMe for backward compatibility */
+declare function getAuthUser(config?: SdkConfig, accessToken?: string): Promise<AuthUserResponse>;
+/** PUT /auth/profile/ — update firstname, lastname, phone */
+declare function updateProfile(configOrPayload: SdkConfig | UpdateProfilePayload, accessTokenOrPayload?: string | UpdateProfilePayload, payloadParam?: UpdateProfilePayload): Promise<CustomerUser>;
+/**
+ * Silently refresh the access token on app boot.
+ * Builds CustomerUser from JWT claims — no additional profile API call needed.
+ * Returns null if no refresh token exists or if the refresh fails.
+ */
+declare function silentRefresh(config: SdkConfig, refresh: string): Promise<{
+    user: CustomerUser;
+    provider: CustomerUser['provider'];
+    newAccessToken: string;
+    newRefreshToken: string;
+} | null>;
+/**
+ * Store tokens in localStorage (client-side utility)
+ * This is a convenience function for storefronts to store auth tokens
+ */
+declare function storeTokens(accessToken: string, refreshToken: string): void;
+/**
+ * Clear tokens from localStorage (client-side utility)
+ */
+declare function clearTokens(): void;
+/**
+ * Get stored tokens from localStorage (client-side utility)
+ */
+declare function getStoredTokens(): {
+    accessToken: string | null;
+    refreshToken: string | null;
+};
+
+/**
+ * Fetch all active products for the storefront.
+ */
+declare function getStorefrontProducts(config: SdkConfig, params?: ListParams): Promise<PaginatedResponse<Product>>;
+/**
+ * Fetch a single product by slug for the storefront.
+ */
+declare function getStorefrontProductBySlug(config: SdkConfig, slug: string): Promise<Product>;
+/**
+ * Fetch latest products for the storefront.
+ */
+declare function getLatestProducts(config: SdkConfig, params?: ListParams): Promise<PaginatedResponse<Product>>;
+/**
+ * Fetch popular products for the storefront.
+ */
+declare function getPopularProducts(config: SdkConfig, params?: ListParams): Promise<PaginatedResponse<Product>>;
+/**
+ * Fetch featured products for the storefront.
+ */
+declare function getFeaturedProducts(config: SdkConfig, params?: ListParams): Promise<PaginatedResponse<Product>>;
+/**
+ * Fetch new products for the storefront.
+ */
+declare function getNewProducts(config: SdkConfig, params?: ListParams): Promise<PaginatedResponse<Product>>;
+/**
+ * Fetch products currently on sale for the storefront.
+ */
+declare function getOnSaleProducts(config: SdkConfig, params?: ListParams): Promise<PaginatedResponse<Product>>;
+/**
+ * Fetch products with low stock for the storefront.
+ */
+declare function getLowStockProducts(config: SdkConfig, params?: ListParams): Promise<PaginatedResponse<Product>>;
+/**
+ * Fetch recommended products for the storefront.
+ * Returns featured, popular, and new products.
+ * Optionally excludes a specific product ID.
+ */
+declare function getRecommendedProducts(config: SdkConfig, params?: ListParams & {
+    excludeProductId?: string;
+}): Promise<PaginatedResponse<Product>>;
+
+/**
+ * Fetch paginated active collections for the storefront.
+ */
+declare function getStorefrontCollections(config: SdkConfig, params?: ListParams): Promise<PaginatedResponse<Collection>>;
+/**
+ * Fetch a single collection by its slug.
+ */
+declare function getStorefrontCollectionBySlug(config: SdkConfig, slug: string): Promise<Collection>;
+
+/**
+ * Fetch the customer's wishlist for the current business.
+ */
+declare function getWishlist(config: SdkConfig, accessToken: string, params?: {
+    page?: number;
+    pageSize?: number;
+}): Promise<WishlistListResponse>;
+/**
+ * Check if a product is in the customer's wishlist.
+ */
+declare function checkInWishlist(config: SdkConfig, accessToken: string, productId: string): Promise<WishlistCheckResponse>;
+/**
+ * Add a product to the customer's wishlist.
+ */
+declare function addToWishlist(config: SdkConfig, accessToken: string, productId: string, notes?: string): Promise<WishlistItem>;
+/**
+ * Remove an item from the customer's wishlist by item ID.
+ */
+declare function removeFromWishlist(config: SdkConfig, accessToken: string, itemId: string): Promise<void>;
+/**
+ * Remove a product from the customer's wishlist by product ID.
+ */
+declare function removeProductFromWishlist(config: SdkConfig, accessToken: string, productId: string): Promise<void>;
+
+/**
+ * Payment Service
+ *
+ * Customer-facing payment API for payment initiation and verification.
+ * Stateless - all configuration passed as parameters.
+ */
+
+/**
+ * Create a Monnify Dedicated Virtual Account so the customer can pay via
+ * bank transfer. Note: Monnify DVA only supports NGN currency - the backend
+ * will reject non-NGN requests for this payment method.
+ */
+declare function createDedicatedAccount(config: SdkConfig, accessToken: string, request: DVACreateRequest): Promise<DVADetails>;
+/**
+ * Initiate a card payment (customer → business owner).
+ * Routes to Monnify (NGN) or Flutterwave (non-NGN) on the backend.
+ * Returns a checkout_url to redirect the customer to the gateway.
+ */
+declare function initiatePayment(config: SdkConfig, accessToken: string, request: PaymentInitiateRequest): Promise<PaymentInitiateResponse>;
+/**
+ * Request a 15-minute rate-locked conversion quote for non-NGN transactions.
+ */
+declare function requestQuote(config: SdkConfig, amount: number): Promise<ConversionQuote>;
+/**
+ * Verify a payment after the gateway redirects back to /checkout/verify.
+ */
+declare function verifyTransaction(configOrReference: SdkConfig | string, reference?: string): Promise<TransactionVerifyResponse>;
+/**
+ * Poll transaction status by internal transaction ID.
+ */
+declare function getTransactionStatus(config: SdkConfig, transactionId: string): Promise<TransactionVerifyResponse>;
+declare const paymentService: {
+    readonly createDedicatedAccount: typeof createDedicatedAccount;
+    readonly initiatePayment: typeof initiatePayment;
+    readonly requestQuote: typeof requestQuote;
+    readonly verifyTransaction: typeof verifyTransaction;
+    readonly getTransactionStatus: typeof getTransactionStatus;
+};
+
+/**
+ * Consultation Service
+ *
+ * Handles consultation operations for bespoke and service products.
+ * Stateless - all configuration passed as parameters.
+ */
+
+declare function createConsultation(config: SdkConfig, accessToken: string, payload: ConsultationCreatePayload): Promise<Consultation>;
+declare function getConsultations(config: SdkConfig, accessToken: string): Promise<Consultation[]>;
+declare function getConsultation(config: SdkConfig, accessToken: string, id: string): Promise<Consultation>;
+declare function sendMessage(config: SdkConfig, accessToken: string, id: string, payload: ConsultationMessagePayload): Promise<void>;
+declare function acceptQuote(config: SdkConfig, accessToken: string, id: string, payload: ConsultationQuoteAcceptPayload): Promise<Consultation>;
+declare function rejectQuote(config: SdkConfig, accessToken: string, id: string, reason?: string): Promise<Consultation>;
+declare const consultationService: {
+    createConsultation: typeof createConsultation;
+    getConsultations: typeof getConsultations;
+    getConsultation: typeof getConsultation;
+    sendMessage: typeof sendMessage;
+    acceptQuote: typeof acceptQuote;
+    rejectQuote: typeof rejectQuote;
+};
+
+/**
+ * Logistics Service
+ *
+ * Handles shipping rates and address validation.
+ * Stateless - all configuration passed as parameters.
+ */
+
+interface CartItemPayload {
+    product: {
+        name: string;
+        price: number;
+        weight: number;
+    };
+    variant: ProductVariant | null;
+    quantity: number;
+}
+interface RateAddress {
+    city: string;
+    state: string;
+    country: string;
+}
+interface ShippingRatesRequest {
+    cart_items: CartItemPayload[];
+    origin_address: RateAddress;
+    destination_address: RateAddress;
+    currency?: string;
+}
+/**
+ * Fetch shipping rates for a cart.
+ */
+declare function getShippingRates(config: SdkConfig, payload: ShippingRatesRequest): Promise<ShippingRatesResponse>;
+/**
+ * Fetch the seller's registered shipping address.
+ */
+declare function getSellerShippingAddress(config: SdkConfig): Promise<{
+    terminal_address_id: string | null;
+    address_details: {
+        city: string;
+        state: string;
+        country: string;
+        line1: string;
+        line2: string;
+        zip: string;
+    } | null;
+    business_id: string;
+    message: string;
+}>;
+/**
+ * Validate a shipping address.
+ */
+declare function validateShippingAddress(config: SdkConfig, payload: {
+    first_name: string;
+    last_name: string;
+    phone: string;
+    address_line1: string;
+    address_line2?: string;
+    city: string;
+    state: string;
+    country: string;
+    postal_code?: string;
+}): Promise<{
+    valid: boolean;
+    message?: string;
+    data?: Array<{
+        name: string;
+        city_id: string;
+        stateCode: string;
+        countryCode: string;
+    }>;
+}>;
+declare const logisticsService: {
+    getShippingRates: typeof getShippingRates;
+    getSellerShippingAddress: typeof getSellerShippingAddress;
+    validateShippingAddress: typeof validateShippingAddress;
+};
+
+/**
+ * Bespoke Service
+ *
+ * Handles bespoke product availability checks.
+ * Stateless - all configuration passed as parameters.
+ */
+
+declare function checkAvailability(config: SdkConfig, product_id: string): Promise<BespokeAvailability>;
+declare const bespokeService: {
+    checkAvailability: typeof checkAvailability;
+};
+
+/**
+ * Service Booking Service
+ *
+ * Handles service appointments and deliverables.
+ * Stateless - all configuration passed as parameters.
+ */
+
+declare function getAvailableSlots(config: SdkConfig, product_id: string, date_from: string, date_to: string): Promise<AvailableSlot[]>;
+declare function bookAppointment(config: SdkConfig, accessToken: string, payload: ServiceAppointmentCreatePayload): Promise<ServiceAppointment>;
+declare function getAppointments(config: SdkConfig, accessToken: string): Promise<ServiceAppointment[]>;
+declare function getAppointment(config: SdkConfig, accessToken: string, id: string): Promise<ServiceAppointment>;
+declare function cancelAppointment(config: SdkConfig, accessToken: string, id: string): Promise<void>;
+declare function getDeliverables(config: SdkConfig, accessToken: string, order_id: string): Promise<ServiceDeliverable[]>;
+declare function approveDeliverable(config: SdkConfig, accessToken: string, order_id: string, deliverable_id: string): Promise<ServiceDeliverable>;
+declare function requestRevision(config: SdkConfig, accessToken: string, order_id: string, deliverable_id: string, feedback: string): Promise<ServiceDeliverable>;
+declare const serviceBookingService: {
+    getAvailableSlots: typeof getAvailableSlots;
+    bookAppointment: typeof bookAppointment;
+    getAppointments: typeof getAppointments;
+    getAppointment: typeof getAppointment;
+    cancelAppointment: typeof cancelAppointment;
+    getDeliverables: typeof getDeliverables;
+    approveDeliverable: typeof approveDeliverable;
+    requestRevision: typeof requestRevision;
+};
+
+/**
+ * Notification Service
+ *
+ * Handles contact form submissions and email notifications.
+ * Stateless - all configuration passed as parameters.
+ */
+
+interface ContactFormData {
+    name: string;
+    email: string;
+    subject: string;
+    message: string;
+    source?: string;
+    company_name?: string;
+    current_year?: number;
+    turnstile_token?: string;
+}
+/**
+ * Send contact email to Kasuvia team.
+ * POST /contact/send-contact-email
+ */
+declare function sendContactEmail(config: SdkConfig, payload: ContactFormData): Promise<{
+    detail: string;
+}>;
+/**
+ * Send confirmation email to user.
+ * POST /contact/send-contact-confirmation
+ */
+declare function sendContactConfirmation(config: SdkConfig, payload: Omit<ContactFormData, 'turnstile_token'>): Promise<{
+    detail: string;
+}>;
+declare const notificationsService: {
+    readonly sendContactEmail: typeof sendContactEmail;
+    readonly sendContactConfirmation: typeof sendContactConfirmation;
+};
+
+/**
+ * App Service
+ *
+ * Handles translation and other app-level utilities.
+ */
+declare function googleTranslate(text: string, target: string, source?: string): Promise<string>;
+
+/**
+ * Config Service
+ *
+ * Handles configuration endpoints (languages, currencies, locales, business config).
+ * Stateless - all configuration passed as parameters.
+ */
+
+/**
+ * Fetch supported languages from the payment system.
+ * Resolves to: {kasuviaPaymentBackendUrl}/config/supported-languages
+ */
+declare function getSupportedLanguages(config: SdkConfig): Promise<SupportedLanguagesResponse>;
+/**
+ * Fetch supported currencies from the payment system.
+ * Resolves to: {kasuviaPaymentBackendUrl}/config/supported-currencies
+ */
+declare function getSupportedCurrencies(config: SdkConfig): Promise<SupportedCurrenciesResponse>;
+/**
+ * Fetch the business's public configuration, including store_currency.
+ * Uses storefront API key header (X-Storefront-Key).
+ * Resolves to: {kasuviaAuthBackendUrl}/internal/businesses/{business_id}/
+ * This endpoint is designed for storefronts to fetch business config using their storefront API key.
+ */
+declare function getBusinessConfig(config: SdkConfig): Promise<BusinessConfig>;
+declare const configService: {
+    readonly getSupportedLanguages: typeof getSupportedLanguages;
+    readonly getSupportedCurrencies: typeof getSupportedCurrencies;
+    readonly getBusinessConfig: typeof getBusinessConfig;
+};
+
+/**
+ * CMS Service
+ *
+ * Handles CMS model and entry operations using the kasuvia-cms SDK endpoints.
+ * Protected by X-Storefront-Key and X-Business-ID headers.
+ * Stateless - all configuration passed as parameters.
+ */
+
+/**
+ * List CMS entries for a specific model.
+ * Requires public_api.read permission on the model.
+ */
+declare function listCmsEntries(config: SdkConfig, modelSlug: string, params?: ListCmsEntriesParams): Promise<CmsEntryListResponse>;
+/**
+ * Get a single CMS entry by ID.
+ * Requires public_api.read permission on the model.
+ */
+declare function getCmsEntry(config: SdkConfig, modelSlug: string, entryId: string): Promise<CmsEntry>;
+/**
+ * Create a new CMS entry.
+ * Requires public_api.create permission on the model.
+ */
+declare function createCmsEntry(config: SdkConfig, accessToken: string, modelSlug: string, params: CreateCmsEntryParams): Promise<CmsEntry>;
+/**
+ * Update an existing CMS entry.
+ * Requires public_api.update permission on the model.
+ */
+declare function updateCmsEntry(config: SdkConfig, accessToken: string, modelSlug: string, entryId: string, params: UpdateCmsEntryParams): Promise<CmsEntry>;
+/**
+ * Delete a CMS entry.
+ * Requires public_api.delete permission on the model.
+ */
+declare function deleteCmsEntry(config: SdkConfig, accessToken: string, modelSlug: string, entryId: string): Promise<void>;
+
+export { createConsultation as $, type AppointmentStatus as A, type BespokeAvailability as B, type CustomerUser as C, type DeliverableApprovalPayload as D, acceptQuote as E, addToCart as F, addToGuestCart as G, addToWishlist as H, approveDeliverable as I, bespokeService as J, bookAppointment as K, type LogoutPayload as L, cancelAppointment as M, type NotificationPreferences as N, type OTPVerifyPayload as O, cancelOrder as P, checkAvailability as Q, type RateAddress as R, type ServiceAppointment as S, checkInWishlist as T, type UpdateProfilePayload as U, clearCart as V, clearGuestCart as W, clearTokens as X, configService as Y, consultationService as Z, createCmsEntry as _, type AuthContextValue as a, silentRefresh as a$, createDedicatedAccount as a0, createOrder as a1, deleteCmsEntry as a2, findOrder as a3, findOrderByToken as a4, getAppointment as a5, getAppointments as a6, getAuthUser as a7, getAvailableSlots as a8, getBusinessConfig as a9, getSupportedLanguages as aA, getTransactionStatus as aB, getWishlist as aC, googleTranslate as aD, initiatePayment as aE, listCmsEntries as aF, loginCustomer as aG, logisticsService as aH, logout as aI, mapAuthUserToCustomer as aJ, mergeGuestCart as aK, mergeGuestCartIfPresent as aL, notificationsService as aM, paymentService as aN, refreshToken as aO, registerCustomer as aP, rejectQuote as aQ, removeFromCart as aR, removeFromGuestCart as aS, removeFromWishlist as aT, removeProductFromWishlist as aU, requestQuote as aV, requestRevision as aW, sendContactConfirmation as aX, sendContactEmail as aY, sendMessage as aZ, serviceBookingService as a_, getCart as aa, getCmsEntry as ab, getConsultation as ac, getConsultations as ad, getDeliverables as ae, getFeaturedProducts as af, getGuestCart as ag, getGuestCartCount as ah, getGuestCartProductType as ai, getGuestCartSubtotal as aj, getLatestProducts as ak, getLowStockProducts as al, getMe as am, getNewProducts as an, getOnSaleProducts as ao, getOrders as ap, getPopularProducts as aq, getRecommendedProducts as ar, getSellerShippingAddress as as, getShippingRates as at, getStoredTokens as au, getStorefrontCollectionBySlug as av, getStorefrontCollections as aw, getStorefrontProductBySlug as ax, getStorefrontProducts as ay, getSupportedCurrencies as az, type AuthUserResponse as b, storeTokens as b0, trackOrder as b1, updateCartItem as b2, updateCmsEntry as b3, updateGuestCartItemQuantity as b4, updateProfile as b5, validateShippingAddress as b6, verifySocialToken as b7, verifyTransaction as b8, type AvailableSlot as c, type AvatarObject as d, type BusinessConfig as e, type BusinessContext as f, type CartItemPayload as g, type Consultation as h, type ConsultationCreatePayload as i, type ConsultationMessage as j, type ConsultationMessagePayload as k, type ConsultationProductType as l, type ConsultationQuoteAcceptPayload as m, type ConsultationStatus as n, type ContactFormData as o, type CustomerAuthResponse as p, type CustomerLoginPayload as q, type CustomerProfileFields as r, type CustomerRegisterPayload as s, type DeliverableStatus as t, type DeliverableStatusType as u, type RefreshTokenResponse as v, type ResendOTPPayload as w, type ServiceAppointmentCreatePayload as x, type ServiceDeliverable as y, type ShippingRatesRequest as z };