@kasuvia/sdk 0.0.8 → 0.0.9

package/dist/media.service-mrBFJ2UQ.d.ts

@@ -0,0 +1,1393 @@
+import { S as SdkConfig } from './index-NkI10J_E.js';
+import { O as Order, C as CreateOrderParams, F as FindOrderParams } from './index-CNW_LINy.js';
+
+/**
+ * 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 {
+    /** Scoped to this business only — the same email is a fully separate identity (and id) at any other business/storefront. Never a platform-wide user id. */
+    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;
+    profile_picture?: 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 CustomerAuthResponse {
+    access: string;
+    refresh: string;
+    user: CustomerUser;
+    business: StorefrontBusinessInfo;
+    is_new?: boolean;
+}
+interface RefreshTokenResponse {
+    access: string;
+    refresh?: string;
+}
+/**
+ * POST /auth/login/customer/ — business is identified by the
+ * X-Storefront-Key + X-Business-ID headers (config.storefrontApiKey /
+ * config.businessId), not a body field (see plan: Customer Storefront
+ * Identity Enforcement).
+ */
+interface CustomerLoginPayload {
+    email: string;
+    password: string;
+}
+/** POST /auth/register/customer/ — business identified via headers, see CustomerLoginPayload. */
+interface CustomerRegisterPayload {
+    first_name?: string;
+    last_name?: string;
+    email: string;
+    password: string;
+}
+/** POST /auth/login/customer/passwordless/request/ — business identified via headers, see CustomerLoginPayload. */
+interface CustomerPasswordlessRequestPayload {
+    email: string;
+}
+/** POST /auth/login/customer/passwordless/verify/ — business identified via headers, see CustomerLoginPayload. */
+interface CustomerPasswordlessVerifyPayload {
+    email: string;
+    code: 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;
+}
+/** POST /auth/forgot-password/customer/ */
+interface CustomerForgotPasswordPayload {
+    email: string;
+}
+/** POST /auth/reset-password/customer/ */
+interface CustomerResetPasswordPayload {
+    email: string;
+    code: string;
+    new_password: string;
+}
+/** POST /auth/customer/deactivate/ */
+interface CustomerDeactivatePayload {
+    reason?: string;
+    confirmation_code?: string;
+}
+/**
+ * The real backend (require_destructive_confirmation, kasuvia-auth/common/
+ * utils/destructive_confirmation.py:76) ALWAYS returns this shape with
+ * HTTP 409 on the first deactivate call (no confirmation_code yet) — this
+ * is not an error case, it's step 1 of a required two-step confirmation.
+ * The code is generated and returned by the server itself (not sent via
+ * email) — it exists to require an explicit second, deliberate action in
+ * the UI, not to verify identity out-of-band. Resubmit the identical
+ * request with `confirmation_code` set to this value to actually deactivate.
+ */
+interface DeactivateConfirmationRequired {
+    message: string;
+    impact: string[];
+    confirmation_code: string;
+    expires_in_minutes: number;
+}
+type DeactivateAccountResult = {
+    status: 'confirmation_required';
+    data: DeactivateConfirmationRequired;
+} | {
+    status: 'success';
+    detail: string;
+};
+/** POST /auth/change-password/ — identity-mode-agnostic (owner/staff/customer). */
+interface ChangePasswordPayload {
+    /** Omit only when the account has no password yet (social/passwordless-only). */
+    old_password?: string;
+    new_password: string;
+    confirm_password: string;
+}
+/** POST /auth/customer/reactivate/ */
+interface CustomerReactivatePayload {
+    email: string;
+}
+/** POST /auth/customer/reactivate/verify/ */
+interface CustomerReactivateVerifyPayload {
+    email: string;
+    code: string;
+}
+/**
+ * One entry in a customer's saved-address book.
+ * GET/POST /auth/profile/addresses/, PATCH/DELETE /auth/profile/addresses/{id}/.
+ * Field names mirror `DeliveryAddress`/`ShippingLocation` exactly so a saved
+ * address can be used directly at checkout with no remapping.
+ */
+interface CustomerAddress {
+    id: string;
+    label: string;
+    first_name: string;
+    last_name: string;
+    phone: string;
+    street: string;
+    city: string;
+    state: string;
+    lga: string;
+    country: string;
+    postal: string;
+    is_default: boolean;
+    created_at: string;
+}
+/** Fields a caller may set when creating a saved address - `id`/`created_at` are server-assigned. */
+type CreateCustomerAddressPayload = Omit<CustomerAddress, "id" | "created_at">;
+/** Partial update to an existing saved address. */
+type UpdateCustomerAddressPayload = Partial<CreateCustomerAddressPayload>;
+/**
+ * GET /auth/storefront/business-info/ response.
+ * Public, unauthenticated (storefront-key-gated) business info for a
+ * storefront to render — e.g. footer/about section. An explicit allow-list
+ * on the backend (kasuvia-auth's PublicBusinessInfoView) — never owner
+ * identity, financial, or internal integration/logistics fields.
+ */
+interface StorefrontBusinessInfo {
+    business_id: string;
+    name: string;
+    tagline: string | null;
+    business_type: string;
+    country: string;
+    business_contact_phone: string;
+    business_contact_email: string;
+    business_physical_address: string;
+    logo_picture: string | null;
+    social_links: Record<string, string>;
+    currency: string;
+    brand_color_primary: string | null;
+    brand_color_secondary: string | null;
+    brand_color_accent: string | null;
+    brand_color_tertiary: string | null;
+}
+interface AuthContextValue {
+    customer: CustomerUser | null;
+    isLoading: boolean;
+    isModalOpen: boolean;
+    openModal: () => void;
+    closeModal: () => void;
+    setCustomer: (user: CustomerUser | null) => void;
+    logout: () => Promise<void>;
+    login: (payload: CustomerLoginPayload) => Promise<void>;
+    register: (payload: CustomerRegisterPayload) => Promise<void>;
+    /** Current browser's guest cart session id — pass through to any auth call (e.g. OTP verify) not already routed through login()/register(), so kasuvia-auth's server-side post-login cart merge (see loginCustomer's doc comment) actually fires. */
+    guestSessionId: string | null;
+    /** Call after any auth flow not routed through login()/register() succeeds (e.g. OTP verify), once the server-side merge above has run — rotates to a fresh guest session id. */
+    rotateGuestSessionId: () => void;
+}
+
+/**
+ * @file types/payments/index.ts
+ * @description All customer-facing payment types for the Kasuvia Payment System.
+ *
+ * Auth model:
+ *   - X-Storefront-Key  → identifies the business storefront
+ *   - X-Business-ID     → tenant context
+ * No business-owner JWT used here — these are CUSTOMER-facing types.
+ *
+ * Payment flow:
+ *   Customer → Business Owner : Monnify (NGN) | Flutterwave (non-NGN)
+ *   Business Owner → Kasuvia     : Subscription (separate, JWT-auth)
+ *   Kasuvia → Business Owner     : Payout (separate, JWT-auth)
+ */
+interface Currency {
+    code: string;
+    name: string;
+    symbol: string;
+    decimals: number;
+    is_active: boolean;
+}
+interface SupportedCurrenciesResponse {
+    currencies: Currency[];
+}
+interface BackendLanguage {
+    code: string;
+    label: string;
+    flag: string;
+}
+interface SupportedLang {
+    code: string;
+    appCode: string;
+    label: string;
+    native: string;
+    flag: string;
+}
+interface SupportedLanguagesResponse {
+    languages: BackendLanguage[];
+}
+declare enum PaymentGatewayEnum {
+    MONNIFY = "monnify",
+    FLUTTERWAVE = "flutterwave",
+    PAYSTACK = "paystack"
+}
+type PaymentGateway = PaymentGatewayEnum | "monnify" | "flutterwave" | "paystack";
+declare enum PaymentMethodTypeEnum {
+    CARD = "card",
+    TRANSFER = "transfer",
+    BANK_TRANSFER = "bank_transfer",
+    ACCOUNT = "account",
+    USSD = "ussd"
+}
+type PaymentMethodType = PaymentMethodTypeEnum | "card" | "transfer" | "bank_transfer" | "account" | "ussd";
+interface PaymentMethodOption {
+    method: PaymentMethodType | string;
+    display_name: string;
+    description: string;
+}
+interface GatewayMethods {
+    gateway: PaymentGateway | string;
+    display_name: string;
+    methods: PaymentMethodOption[];
+}
+interface WalletBalanceResponse {
+    balance: number;
+    currency: string;
+}
+interface WalletLedgerEntry {
+    id: string;
+    entry_type: string;
+    amount: number;
+    currency: string;
+    refund_id?: string | null;
+    transaction_id?: string | null;
+    balance_after: number;
+    created_at: string;
+}
+interface WalletLedgerResponse {
+    items: WalletLedgerEntry[];
+    total: number;
+    page: number;
+    page_size: number;
+}
+interface ClaimWalletCreditRequest {
+    claim_token: string;
+}
+interface OutstandingClaimResponse {
+    wallet_id: string;
+    claim_email: string;
+    balance: number;
+    currency: string;
+    created_at: string;
+}
+interface DVACreateRequest {
+    order_id?: string;
+    /** Ignored by the backend — the real order total is always charged instead. Only meaningful (and required) if order_id is omitted. */
+    amount?: number;
+    customer_email: string;
+    customer_name?: string;
+    /** Defaults to NGN — DVA is Monnify-only */
+    currency?: string;
+    /** Gateway identifier — the backend requires this explicitly, no default */
+    gateway: string;
+    /** Window origin of the storefront */
+    storefront_origin?: string;
+    /** Idempotency key to prevent duplicate DVA creation */
+    idempotency_key?: string;
+}
+interface PaymentInitiateRequest {
+    /** Ignored by the backend when order_id is set — the real order total is always charged instead. Required only if order_id is omitted. */
+    amount?: number;
+    currency?: string;
+    customer_email: string;
+    customer_name?: string;
+    order_id?: string;
+    quote_id?: string;
+    /** ISO 2-letter country code (defaults to 'NG') */
+    country_code?: string;
+    /** Gateway chosen by customer (e.g., 'monnify', 'flutterwave', 'paystack') — the backend requires this explicitly, no default */
+    gateway: string;
+    /** Window origin of the storefront — used as gateway redirect base URL */
+    storefront_origin?: string;
+    metadata?: Record<string, string | number | boolean>;
+    /** Idempotency key to prevent duplicate payment initiation */
+    idempotency_key?: string;
+}
+interface DVADetails {
+    account_number: string;
+    bank_name: string;
+    account_name: string;
+    reference: string;
+    amount: number;
+    transaction_id: string;
+    expires_at: string;
+}
+interface PaymentInitiateResponse {
+    id: string;
+    gateway_ref: string;
+    gateway: string;
+    status: string;
+    /** Normalised top-level checkout URL for gateway redirect */
+    checkout_url: string;
+}
+interface TransactionVerifyResponse {
+    id: string;
+    status: string;
+    amount: number;
+    currency: string;
+    gateway_ref: string;
+    gateway?: string;
+    order_id?: string;
+    escrow_status?: string;
+    escrow_release_date?: string;
+    metadata_json?: Record<string, unknown>;
+}
+
+/**
+ * Bespoke commission types for the customer-facing storefront.
+ *
+ * REAL BUG FIXED (2026-09-21): this file used to also declare a fictional
+ * "Consultation" resource (ConsultationStatus/Consultation/ConsultationMessage/
+ * etc.) — confirmed there is no /social/consultations/* route or Consultation
+ * model anywhere in kasuvia-store-management. The owner confirmed the
+ * feature no longer exists there. Removed along with its dead SDK service,
+ * hooks, and storefront pages/components — only the real bespoke types
+ * (used by bespoke.service.ts against real backend endpoints) remain here.
+ */
+interface BespokeAvailability {
+    available_slots: number;
+    next_available_date: string | null;
+    period_end: string;
+    blocked_dates: string[];
+    production_days: number;
+    is_available: boolean;
+}
+/**
+ * Returned by all 3 bespoke deliverable-proofing action endpoints (POST
+ * .../bespoke/submit-deliverable, .../approve, .../request-revision) —
+ * matches BespokeStatusResponse (kasuvia-store-management/app/schemas/
+ * bespoke.py:120-128) exactly.
+ */
+interface BespokeDeliverableStatus {
+    id: string;
+    order_status: string;
+    bespoke_status: string;
+    bespoke_deliverable_submitted_at: string | null;
+    bespoke_deliverable_url: string | null;
+    bespoke_deliverable_notes: string | null;
+    bespoke_buyer_approved_at: string | null;
+    bespoke_revision_count: number;
+    /**
+     * REAL GAP FIXED (2026-09-23) via the REST codegen initiative: the real
+     * backend response (BespokeStatusResponse, kasuvia-store-management's
+     * app/schemas/bespoke.py) has always included this field - this hand-
+     * written interface simply never declared it, so it was silently
+     * unavailable to every consumer even though the backend was already
+     * returning it on every deliverable-status response.
+     */
+    bespoke_revision_notes: string | null;
+}
+/**
+ * Embedded on an Order as `order.bespoke_fulfillment` — matches
+ * BespokeFulfillmentResponse (kasuvia-store-management/app/schemas/
+ * order.py:150-168) exactly. This is the real source of a bespoke order's
+ * current deliverable state; there is no separate list/GET endpoint for it.
+ */
+interface BespokeFulfillment {
+    brief: string | null;
+    reference_images: string[] | null;
+    measurements: Record<string, unknown> | null;
+    preferred_timeline: string | null;
+    special_instructions: string | null;
+    deposit_ratio: number | null;
+    deposit_amount: number | null;
+    balance_amount: number | null;
+    status: string | null;
+    deliverable_submitted_at: string | null;
+    deliverable_url: string | null;
+    deliverable_notes: string | null;
+    buyer_approved_at: string | null;
+    revision_count: number;
+    revision_notes: string | null;
+    timeline_breached_at: string | null;
+}
+
+/**
+ * Service booking types for customer-facing storefront.
+ *
+ * REAL BUG FIXED (2026-09-20): this entire file used to describe a fictional
+ * API shape that never matched kasuvia-store-management's real service-
+ * booking backend (`app/schemas/service.py`, `app/api/v1/endpoints/service/
+ * bookings.py`) — wrong field names (`appointment_date` vs the real
+ * `scheduled_date`), a status enum with values the backend never emits
+ * ("pending" vs the real "scheduled"), fields that don't exist on the real
+ * response (`location_type`, `customer_address`, `meeting_link`, `price`),
+ * and a whole "deliverables" concept (`ServiceDeliverable`,
+ * `DeliverableApprovalPayload`) that has no backend counterpart at all — the
+ * real analogous feature is the milestone/escrow system below, a different
+ * shape entirely. Rebuilt field-for-field against the real Pydantic schemas.
+ */
+type ServiceBookingStatus = "scheduled" | "confirmed" | "in_progress" | "completed" | "voided" | "no_show";
+/** GET /catalog/products/{product_id}/available-slots response. */
+interface AvailableSlotsResponse {
+    product_id: string;
+    date: string;
+    staff_id: string | null;
+    duration_minutes: number | null;
+    /** false when the business has no/ambiguous location config for this
+     * product — check `reason` for why, `available_slots` is always empty. */
+    serviceable: boolean;
+    reason: string | null;
+    /** ISO time strings (e.g. "14:30:00"), not slot objects. */
+    available_slots: string[];
+}
+/** Matches ServiceBookingResponse exactly (kasuvia-store-management/app/schemas/service.py:66-90). */
+interface ServiceAppointment {
+    id: string;
+    business_id: string;
+    product_id: string;
+    customer_id: string;
+    order_id: string | null;
+    transaction_id: string | null;
+    scheduled_date: string;
+    scheduled_time: string;
+    duration_minutes: number | null;
+    status: ServiceBookingStatus;
+    notes: string | null;
+    reminder_sent: boolean;
+    reminder_scheduled_at: string | null;
+    location_id: string | null;
+    started_at: string | null;
+    completed_at: string | null;
+    buyer_confirmed_at: string | null;
+    no_show_at: string | null;
+    voided_at: string | null;
+    cancellation_reason: string | null;
+    cancellation_window_hours: number;
+    refund_due: boolean | null;
+    refund_processed_at: string | null;
+    is_milestone_based: boolean;
+    assigned_staff_id: string | null;
+    assigned_at: string | null;
+    assignment_method: string | null;
+    created_at: string;
+    updated_at: string;
+}
+/** POST /service/bookings/schedule payload (ScheduleServiceRequest). */
+interface ServiceAppointmentCreatePayload {
+    product_id: string;
+    scheduled_date: string;
+    scheduled_time: string;
+    notes?: string;
+    staff_id?: string;
+    /** Required when the product is service_location_type='at_business' and the business runs more than one active location (see useAvailableSlots/logisticsService.listBusinessLocations). */
+    location_id?: string;
+}
+/** POST /service/bookings/{id}/cancel payload (CustomerCancelBookingRequest). */
+interface CancelAppointmentPayload {
+    reason?: string;
+}
+/** POST /service/bookings/{id}/reschedule payload (CustomerRescheduleBookingRequest). */
+interface RescheduleAppointmentPayload {
+    scheduled_date: string;
+    scheduled_time: string;
+    staff_id?: string;
+}
+/** POST /service/bookings/{id}/dispute payload (CustomerOpenDisputeRequest). */
+interface DisputeAppointmentPayload {
+    reason: string;
+}
+/** POST /service/bookings/{id}/confirm payload (BuyerConfirmRequest). */
+interface ConfirmAppointmentPayload {
+    notes?: string;
+}
+type MilestoneStatus = "pending" | "funded" | "submitted" | "approved" | "released" | "disputed" | "refunded";
+/** Matches ServiceMilestoneResponse + its ServiceMilestoneBase parent
+ * (kasuvia-store-management/app/schemas/service.py:169-173,208-222). */
+interface ServiceMilestone {
+    id: string;
+    booking_id: string;
+    title: string;
+    description: string | null;
+    /**
+     * Milestone amount in the order currency.
+     *
+     * REAL BUG FIXED (2026-09-23) via the REST codegen initiative: this was
+     * typed `number`, but the real backend field (ServiceMilestoneBase.amount,
+     * kasuvia-store-management's app/schemas/service.py) is a Pydantic
+     * `Decimal`, which serializes to JSON as a STRING (e.g. "150000.00"), not
+     * a number - confirmed against the generated OpenAPI schema
+     * (`ServiceMilestoneResponse.amount: string`). The one real consumer
+     * (ProjectDeliverables.tsx) called `.toLocaleString()` directly on it,
+     * which on a string just returns the string unchanged (no thousands
+     * separators) rather than the number-formatted value it looked like it
+     * was producing for any amount under 4 digits.
+     */
+    amount: string;
+    sequence: number;
+    status: MilestoneStatus;
+    funded_at: string | null;
+    submitted_at: string | null;
+    approved_at: string | null;
+    completion_event_at: string | null;
+    released_at: string | null;
+    dispute_reason: string | null;
+    transaction_id: string | null;
+    created_at: string;
+    updated_at: string;
+}
+/** POST /service/bookings/{id}/milestones/{milestone_id}/approve payload. */
+interface ApproveMilestonePayload {
+    notes?: string;
+}
+
+/**
+ * Review and Comment types for CRM service
+ */
+declare enum ModerationStatus {
+    PENDING = "pending",
+    APPROVED = "approved",
+    REJECTED = "rejected"
+}
+interface Review {
+    id: string;
+    business_id: string;
+    product_id: string;
+    order_id?: string;
+    customer_id: string;
+    /** Real field (kasuvia-crm-go's ReviewResponse.customer_name_masked) — the raw customer_id is never exposed to other storefront visitors. */
+    customer_name_masked: string;
+    rating: number;
+    body: string;
+    media: string[];
+    media_ids: string[];
+    verified_purchase: boolean;
+    moderation_status: ModerationStatus;
+    merchant_reply?: string;
+    merchant_reply_at?: string;
+    created_at: string;
+    edited_at?: string;
+    edit_count: number;
+}
+interface Comment {
+    id: string;
+    business_id: string;
+    product_id: string;
+    customer_id?: string;
+    /** Real field (kasuvia-crm-go's CommentResponse.customer_name_masked). */
+    customer_name_masked: string;
+    body: string;
+    parent_comment_id?: string;
+    moderation_status: ModerationStatus;
+    is_merchant_reply: boolean;
+    created_at: string;
+    updated_at: string;
+}
+interface ReviewCreate {
+    product_id: string;
+    /** Required: reviews are purchase-verified — must reference a completed order for this product. */
+    order_id: string;
+    rating: number;
+    body: string;
+    /**
+     * `media` (asset URLs) and `media_ids` (the matching MediaAsset ids) must
+     * be two parallel, order-paired arrays of the SAME length — the real
+     * backend (kasuvia-crm-go's validateMediaPairing) 400s otherwise. Omit
+     * both together, or populate both together in the same order.
+     */
+    media?: string[];
+    media_ids?: string[];
+}
+interface ReviewUpdate {
+    rating?: number;
+    body?: string;
+    /** See ReviewCreate's identical doc comment — media/media_ids must be order-paired, same length. */
+    media?: string[];
+    media_ids?: string[];
+}
+interface CommentCreate {
+    product_id: string;
+    body: string;
+    parent_comment_id?: string;
+}
+interface CommentUpdate {
+    body?: string;
+}
+interface MerchantReplyCreate {
+    body: string;
+}
+interface ReviewModerationAction {
+    status: ModerationStatus;
+    reason?: string;
+}
+interface CommentModerationAction {
+    status: ModerationStatus;
+    reason?: string;
+}
+interface ProductReviewsResponse {
+    results: Review[];
+    count: number;
+    page: number;
+    page_size: number;
+    total_pages: number;
+    average_rating: number | null;
+    rating_distribution: Record<number, number>;
+}
+interface ProductCommentsResponse {
+    results: Comment[];
+    count: number;
+    page: number;
+    page_size: number;
+    total_pages: number;
+}
+
+/**
+ * CMS Types
+ *
+ * Types for kasuvia-cms integration - dynamic content models and entries
+ */
+interface CmsField {
+    name: string;
+    label: string;
+    type: string;
+    required: boolean;
+    config: Record<string, unknown>;
+    sub_fields?: CmsField[];
+}
+interface CmsModelPermissions {
+    read: boolean;
+    create: boolean;
+    update: boolean;
+    delete: boolean;
+}
+interface CmsModelPublicApiPermissions {
+    public_api: CmsModelPermissions;
+}
+interface CmsModel {
+    id: string;
+    business_id: string;
+    model_slug: string;
+    display_name: string;
+    description: string | null;
+    fields: CmsField[];
+    permissions: CmsModelPublicApiPermissions;
+}
+interface CmsEntry {
+    id: string;
+    business_id: string;
+    model_slug: string;
+    data: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+    created_by: string | null;
+}
+/** Real value shape of a CmsField with type "media" (kasuvia-media-system asset reference). */
+interface CmsMediaValue {
+    id: string;
+    url: string;
+    alt?: string;
+}
+/** Real value shape of a CmsField with type "icon". */
+interface CmsIconValue {
+    package: string;
+    name: string;
+}
+/**
+ * The "blogs" CMS model's real field shape, as created by a merchant through
+ * kasuvia-cms's dynamic model builder. Field names are merchant-defined
+ * (this is a dynamic CMS, not a fixed schema) — this type documents the
+ * specific field set kasuvia-storefront's dedicated /blog pages render,
+ * confirmed live against a real "blogs" model. A storefront whose merchant
+ * named these fields differently needs its own type — this is a rendering
+ * convenience, not a backend contract.
+ */
+interface BlogEntryData {
+    blog_title: string;
+    blog_slug: string;
+    blog_content: string;
+    excerpt?: string;
+    author: string;
+    category: string;
+    tags?: string;
+    featured_image?: CmsMediaValue;
+    published_date: string;
+    is_published: boolean;
+    is_featured?: boolean;
+    featured_icon?: CmsIconValue;
+}
+/**
+ * The "store-locations" CMS model's real field shape (kasuvia-cms/scripts/
+ * seed_dummy_models.py's STORE_LOCATIONS_MODEL — merchant-defined, dynamic
+ * CMS, this documents the real shape as configured, not a fixed schema).
+ */
+interface StoreLocationEntryData {
+    store_name: string;
+    address: string;
+    city: string;
+    store_type: 'Flagship' | 'Outlet' | 'Pop-up' | 'Franchise';
+    phone?: string;
+    is_open: boolean;
+    opening_time: string;
+    closing_time: string;
+    store_image?: CmsMediaValue;
+    store_icon?: CmsIconValue;
+}
+/** The "flash-sales" CMS model's real field shape (same source as above). */
+interface FlashSaleEntryData {
+    event_title: string;
+    event_description: string;
+    start_date: string;
+    end_date: string;
+    countdown_datetime: string;
+    discount_percentage: number;
+    is_active: boolean;
+    banner_image?: CmsMediaValue;
+}
+/** The "product-faqs" CMS model's real field shape (same source as above). */
+interface ProductFaqEntryData {
+    category: string;
+    question: string;
+    answer: string;
+    is_featured: boolean;
+    /** Free-text merchant-typed field (e.g. "Shipping Policy: /policies/shipping, Track Your Order: /orders/track") — not structured, rendered as plain text. */
+    related_links?: string;
+}
+interface CmsEntryListResponse {
+    results: CmsEntry[];
+    count: number;
+    page: number;
+    page_size: number;
+    total_pages: number;
+}
+interface CmsIcon {
+    id: string;
+    name: string;
+    category: string;
+    tags: string[];
+}
+interface CmsIconListResponse {
+    icons: CmsIcon[];
+    total: number;
+}
+interface ListCmsEntriesParams {
+    page?: number;
+    page_size?: number;
+}
+interface CreateCmsEntryParams {
+    data: Record<string, unknown>;
+}
+interface UpdateCmsEntryParams {
+    data: Record<string, unknown>;
+}
+
+/**
+ * Media types for the storefront
+ *
+ * Mirrors `Affiliation` in `kasuvia-media-system/app/models/media.py`, the real
+ * source of truth. Re-synced 2026-09-04 (media affiliation recheck): this mirror
+ * was missing `Business` and `Review` entirely, and wrongly described
+ * `BusinessOwner` as covering logos too.
+ *
+ * Canonical affiliations:
+ * - Content: CMS and website builder content — the ONE shared tag for both
+ * - Product: Product images
+ * - Collection: Collection images
+ * - Chat: AI/customer chat interactions
+ * - Review: photos a customer attaches to a product review (kasuvia-crm) —
+ *   distinct from Customer (a person's own identity photo, not
+ *   customer-GENERATED content)
+ * - Business: a business's own logo
+ * - BusinessOwner: the business owner's OWN personal avatar — distinct from
+ *   Business (the business's logo); never the same asset
+ * - Staff: staff avatars
+ * - Customer: customer avatars
+ * - General: General use cases
+ */
+type MediaAffiliation = 'Content' | 'Product' | 'Collection' | 'Chat' | 'Review' | 'Business' | 'BusinessOwner' | 'Staff' | 'Customer' | 'General';
+interface MediaAsset {
+    id: string;
+    url: string;
+    filename: string;
+    content_type: string;
+    size: number;
+    business_id: string;
+    affiliation: MediaAffiliation;
+    created_at: string;
+    alt?: string;
+    description?: string;
+}
+interface MediaUploadParams {
+    business_id?: string;
+    owner_id?: string;
+    uploaded_by_name?: string;
+    affiliation?: MediaAffiliation;
+    context: string;
+    entity_id: string;
+    alt?: string;
+    description?: string;
+    idempotency_key?: string;
+}
+interface MediaAssetUpdatePayload {
+    alt?: string;
+    description?: string;
+    affiliation?: MediaAffiliation;
+}
+interface StorageStats {
+    total_bytes: number;
+    used_bytes: number;
+    available_bytes: number;
+    asset_count: number;
+}
+
+interface BusinessConfig {
+    business_id: string;
+    storefront_business_id: string;
+    name: string;
+    currency: string;
+    settlement_currency: string;
+    country: string;
+    region: string;
+    has_completed_onboarding: boolean;
+    owner_kyc_verified: boolean;
+    is_active: boolean;
+}
+
+/**
+ * Order Service
+ *
+ * Handles order operations including creation, lookup, and tracking.
+ * Stateless - all configuration passed as parameters.
+ */
+
+/**
+ * Request body for the real POST /orders/storefront/bespoke atomic checkout
+ * (kasuvia-store-management's BespokeBookingCheckoutRequest). Bespoke
+ * products can never be added to a cart (ErrBespokeNotCartable) — this is
+ * the only real path to a paid bespoke commission from the storefront.
+ */
+interface CreateBespokeOrderParams {
+    product_id: string;
+    brief: string;
+    reference_images?: string[];
+    measurements?: Record<string, string>;
+    preferred_timeline?: string;
+    special_instructions?: string;
+    deposit_ratio?: number;
+    physical?: {
+        shipping_address: Record<string, unknown>;
+    };
+    notes?: string;
+    discount_code?: string;
+    guest_email?: string;
+    guest_name?: string;
+    guest_phone?: string;
+    checkout_session_id?: string;
+}
+/**
+ * Request body for the real POST /orders/storefront/service atomic PAID
+ * checkout (kasuvia-store-management's ServiceBookingCheckoutRequest) —
+ * distinct from the free self-service `bookAppointment` flow
+ * (service-booking.service.ts, POST /service/bookings/schedule). Service
+ * products can never be added to a cart (ErrServiceNotCartable) — this is
+ * the only path to a PAID service booking from the storefront.
+ */
+interface CreateServiceBookingOrderParams {
+    product_id: string;
+    scheduled_date: string;
+    scheduled_time: string;
+    staff_id?: string;
+    notes?: string;
+    discount_code?: string;
+    guest_email?: string;
+    guest_name?: string;
+    guest_phone?: string;
+    checkout_session_id?: string;
+}
+/**
+ * REAL BUG FIXED (2026-09-22): `accessToken` was mandatory (`string`, not
+ * optional) — the real backend endpoint (`POST /orders/storefront`,
+ * create_storefront_order) explicitly supports guest checkout: `if not
+ * user_id and not x_guest_session: raise 401`, matching the same
+ * X-Guest-Session pattern cart.service.ts already uses. This endpoint
+ * redeems the customer's real server-side cart (guest or authenticated) —
+ * `payload.items`/`payload.product_type` are ignored by the backend
+ * entirely regardless (see CreateOrderParams' own doc comment) — so a
+ * guest with items already in their guest cart had no way to check out at
+ * all through this SDK, even though the backend was built for exactly
+ * that. `guestSessionId` is a separate parameter (not a body field) since
+ * the backend reads it as a header, not JSON.
+ */
+declare function createOrder(config: SdkConfig, accessToken: string | undefined, payload: CreateOrderParams, guestSessionId?: string): Promise<Order>;
+/** Atomic, cart-less bespoke commission checkout — POST /orders/storefront/bespoke. */
+declare function createBespokeOrder(config: SdkConfig, accessToken: string | undefined, payload: CreateBespokeOrderParams): Promise<Order>;
+/** Atomic, cart-less PAID service booking checkout — POST /orders/storefront/service. */
+declare function createServiceBookingOrder(config: SdkConfig, accessToken: string | undefined, payload: CreateServiceBookingOrderParams): Promise<Order>;
+/**
+ * REAL BUG FIXED (2026-09-22): called `GET /orders/find/?email=...&order_id=
+ * ...&guest_token=...` — this route does not exist anywhere on the real
+ * backend (confirmed against every route in app/api/v1/endpoints/sales/
+ * orders.py). Every real call 404'd — the entire "track my order by email +
+ * order ID" flow (`/track-order`, the actual page kasuvia-storefront's own
+ * checkout confirmation links to) has been broken. The real, working
+ * mechanism is `POST /orders/track` with a `GuestTrackRequest` body
+ * (`{order_id, email}` — both required, no `guest_token` field exists on
+ * this or any other real request shape). Fixed to match.
+ */
+declare function findOrder(config: SdkConfig, params: FindOrderParams): 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>;
+/**
+ * REAL BUG FIXED (2026-09-22): called `GET /orders/track/{orderId}?token=
+ * ...` — this route does not exist on the real backend at all (confirmed
+ * against every route in orders.py). The `token` query param has no
+ * corresponding capability anywhere: the real single-order lookup (`GET
+ * /{order_id}`) requires a genuine authenticated JWT
+ * (`Depends(get_current_user_claims)`) and grants access only to the
+ * order's own customer (matching customer_id, or matching guest_email
+ * against the JWT's email for a guest-checkout order that later registered)
+ * — it has no anonymous/guest-token path at all. There is no real backend
+ * capability today for "look up one order by ID + a standalone token, no
+ * login required" — the only real guest lookup is findOrder (email +
+ * order_id via POST /orders/track, a different, plural-sounding but
+ * distinct endpoint). Fixed to call the real endpoint with its real,
+ * mandatory-JWT contract; the fictional guest-token parameter is removed
+ * rather than kept as a parameter that can never do anything.
+ */
+declare function trackOrder(config: SdkConfig, orderId: string, accessToken: string): Promise<Order>;
+interface PromoValidationResult {
+    valid: boolean;
+    discount_amount: number;
+    discount_type: 'percentage' | 'fixed';
+    message: string;
+}
+/**
+ * Validate a promo / discount code against kasuvia-store-management.
+ *
+ * Routes directly to POST /sales/discounts/validate on the store backend
+ * using X-Storefront-Key + X-Business-ID for tenant isolation.
+ * The backend is the single source of truth for discount validity,
+ * amount calculation, and usage tracking.
+ */
+declare function validatePromoCode(config: SdkConfig, code: string, cartTotal: number): Promise<PromoValidationResult>;
+interface DigitalDownloadRedirect {
+    type: 'redirect';
+    url: string;
+}
+interface DigitalDownloadFileEntry {
+    id: string;
+    display_name: string;
+    sort_order: number;
+    /** Raw backend URL - never render this directly; resolve it via resolveDigitalDownloadFile instead. */
+    download_url: string;
+}
+interface DigitalDownloadListing {
+    type: 'listing';
+    order_id: string;
+    product_name: string;
+    download_count: number;
+    max_downloads: number;
+    expires_at: string | null;
+    files: DigitalDownloadFileEntry[];
+}
+type DigitalDownloadResult = DigitalDownloadRedirect | DigitalDownloadListing;
+/** GET /orders/{order_id}/download/{token} - server-only, no config beyond backendUrls.store needed. */
+declare function resolveDigitalDownload(config: Pick<SdkConfig, 'backendUrls'>, orderId: string, token: string): Promise<DigitalDownloadResult>;
+/** GET /orders/{order_id}/download/{token}/{file_id} - resolves ONE file's real, freshly-presigned URL. */
+declare function resolveDigitalDownloadFile(config: Pick<SdkConfig, 'backendUrls'>, orderId: string, token: string, fileId: string): Promise<string>;
+
+/**
+ * Consultation Service
+ *
+ * REAL BUG FIXED (2026-09-21): a "consultation" service existed earlier this
+ * session pointed at a fictional `/social/consultations/...` route that
+ * matched nothing in any backend — deleted along with its dead storefront
+ * pages. That deletion was correct (the URL was wrong), but a later audit
+ * of kasuvia-crm-go found the underlying feature is real:
+ * `POST /api/v1/consultations/` (customer-JWT-gated, real bespoke-slot-
+ * reservation side effect when product_id references a bespoke product).
+ * There is deliberately no list/get function here — kasuvia-crm-go's own
+ * code comment confirms "there is no customer-facing GET/list consultation
+ * endpoint at all" (admin_consultations.go). Create-only, by design.
+ */
+
+interface CreateConsultationParams {
+    product_id?: string;
+    structured_details?: Record<string, unknown>;
+}
+interface Consultation {
+    id: string;
+    business_id: string;
+    customer_id: string | null;
+    product_id: string | null;
+    status: string;
+    quote_amount: number | null;
+    structured_details: Record<string, unknown>;
+    capacity_config_id: string | null;
+    slot_booking_id: string | null;
+    created_at: string;
+    updated_at: string;
+}
+declare function createConsultation(config: SdkConfig, accessToken: string, params: CreateConsultationParams): Promise<Consultation>;
+
+/**
+ * Feedback Service
+ *
+ * REAL FEATURE WIRED (2026-09-21): kasuvia-crm-go's feedback.go (`POST
+ * /api/v1/feedback/`, `GET /api/v1/feedback/my`) is a complete, real,
+ * customer-JWT-gated support-ticket system — private business<->customer
+ * correspondence, distinct from a public, purchase-verified product Review —
+ * with zero SDK coverage anywhere before this file.
+ */
+
+/** Mirrors kasuvia-crm-go's models.ValidFeedbackCategories exactly. */
+type FeedbackCategory = 'general' | 'complaint' | 'suggestion';
+/** Mirrors kasuvia-crm-go's models.ValidFeedbackStatuses exactly. */
+type FeedbackStatus = 'open' | 'in_progress' | 'resolved';
+interface CreateFeedbackParams {
+    subject: string;
+    body: string;
+    /** Defaults to 'general' server-side if omitted. */
+    category?: FeedbackCategory;
+    order_id?: string;
+}
+interface Feedback {
+    id: string;
+    business_id: string;
+    customer_id: string;
+    order_id: string | null;
+    category: FeedbackCategory;
+    subject: string;
+    body: string;
+    status: FeedbackStatus;
+    merchant_reply: string | null;
+    merchant_reply_at: string | null;
+    replied_by: string | null;
+    created_at: string;
+    updated_at: string;
+}
+interface FeedbackListResponse {
+    results: Feedback[];
+    count: number;
+    page: number;
+    page_size: number;
+    total_pages: number;
+}
+declare function createFeedback(config: SdkConfig, accessToken: string, params: CreateFeedbackParams): Promise<Feedback>;
+declare function getMyFeedback(config: SdkConfig, accessToken: string, params?: {
+    page?: number;
+    page_size?: number;
+}): Promise<FeedbackListResponse>;
+
+/**
+ * Service Booking Service
+ *
+ * Handles service appointments (bookings) and their milestone/escrow
+ * sub-resource. Stateless - all configuration passed as parameters.
+ *
+ * REAL BUGS FIXED (2026-09-20) — every function in this file was rewritten
+ * against the real backend (kasuvia-store-management/app/api/v1/endpoints/
+ * service/bookings.py, app/schemas/service.py). Before this fix:
+ *   - getAvailableSlots called a nonexistent route (/service/available-slots/
+ *     {id}) with the wrong params (date_from/date_to) — the real route is
+ *     GET /catalog/products/{id}/available-slots?date=..., a single date.
+ *   - bookAppointment POSTed to a nonexistent route (/service/appointments/)
+ *     — the real route is POST /service/bookings/schedule.
+ *   - getAppointments typed its result as a plain array, but the real
+ *     response is the standard Kasuvia paginated envelope
+ *     ({results,count,page,page_size,total_pages}) — this was a CONFIRMED
+ *     LIVE CRASH: DashboardClient.tsx/DashboardAppointments.tsx called
+ *     .length/.filter() directly on the envelope object.
+ *   - cancelAppointment sent DELETE /service/bookings/{id} — that route is
+ *     owner/staff-only (require_permission("services:manage")), so a
+ *     customer got a 403; the real customer route is POST .../{id}/cancel.
+ *     It also never checked response.ok at all, silently swallowing failures.
+ *   - getDeliverables/approveDeliverable/requestRevision referenced a
+ *     "/service/projects/{order_id}/deliverables/..." resource that does not
+ *     exist anywhere in the codebase — replaced with the real milestone
+ *     endpoints (a different resource: escrow-style payment milestones on
+ *     a booking, not free-form deliverable files).
+ *   - No coverage existed for reschedule, dispute, or buyer-confirm — all
+ *     real, customer-facing routes.
+ */
+
+/** Standard Kasuvia pagination envelope — matches app/core/pagination.py's PaginatedResponse exactly. */
+interface ServiceBookingsPage {
+    results: ServiceAppointment[];
+    count: number;
+    page: number;
+    page_size: number;
+    total_pages: number;
+}
+/**
+ * GET /catalog/products/{product_id}/available-slots — real "what times are
+ * open" for a SERVICE product on one date. `serviceable: false` means the
+ * business has no/ambiguous location config for this product (check
+ * `reason`); `available_slots` is always empty in that case, not an error.
+ */
+declare function getAvailableSlots(config: SdkConfig, productId: string, date: string, params?: {
+    staffId?: string;
+    locationId?: string;
+    customerLatitude?: number;
+    customerLongitude?: number;
+}): Promise<AvailableSlotsResponse>;
+/** POST /service/bookings/schedule */
+declare function bookAppointment(config: SdkConfig, accessToken: string, payload: ServiceAppointmentCreatePayload): Promise<ServiceAppointment>;
+/** GET /service/bookings/my — paginated. */
+declare function getAppointments(config: SdkConfig, accessToken: string, params?: {
+    status?: ServiceAppointment['status'];
+    page?: number;
+    page_size?: number;
+}): Promise<ServiceBookingsPage>;
+/**
+ * GET /service/bookings/{id} — customer-reachable single-booking lookup,
+ * used by the paginated list's detail view (PATCH .../{id} is a separate,
+ * owner/staff-only route).
+ *
+ * REAL BUG FIXED (2026-09-22): this call shape was already correct, but the
+ * backend route it targeted didn't exist at all — `ServiceBookingRepository
+ * .get_by_id_and_business` was used internally by every merchant action
+ * (cancel/reschedule/dispute/assign/etc.) but never exposed as a customer
+ * GET route. Every real call to `AppointmentDetail.tsx` (via `useAppointment`)
+ * 404'd. Fixed by adding `GET /{booking_id}` to kasuvia-store-management's
+ * `service/bookings.py` (customer_id-scoped, same pattern as
+ * `customer_cancel_booking` — service bookings have no guest-checkout path,
+ * so no guest_email fallback is needed here unlike orders).
+ */
+declare function getAppointment(config: SdkConfig, accessToken: string, id: string): Promise<ServiceAppointment>;
+/** POST /service/bookings/{id}/cancel — the real customer-cancel route (DELETE .../{id} is owner/staff-only). */
+declare function cancelAppointment(config: SdkConfig, accessToken: string, id: string, payload?: CancelAppointmentPayload): Promise<ServiceAppointment>;
+/** POST /service/bookings/{id}/reschedule — subject to the same cancellation_window_hours as a cancel. */
+declare function rescheduleAppointment(config: SdkConfig, accessToken: string, id: string, payload: RescheduleAppointmentPayload): Promise<ServiceAppointment>;
+/** POST /service/bookings/{id}/dispute — freezes the escrow auto-release timer; requires a real reason. */
+declare function disputeAppointment(config: SdkConfig, accessToken: string, id: string, payload: DisputeAppointmentPayload): Promise<ServiceAppointment>;
+/** POST /service/bookings/{id}/confirm — buyer confirms the service was completed. */
+declare function confirmAppointmentCompletion(config: SdkConfig, accessToken: string, id: string, payload?: ConfirmAppointmentPayload): Promise<ServiceAppointment>;
+/** GET /service/bookings/{id}/milestones — escrow-style payment milestones for a milestone-based booking. */
+declare function getMilestones(config: SdkConfig, accessToken: string, bookingId: string): Promise<ServiceMilestone[]>;
+/** POST /service/bookings/{id}/milestones/{milestone_id}/approve — buyer approves a submitted milestone, triggering escrow release. */
+declare function approveMilestone(config: SdkConfig, accessToken: string, bookingId: string, milestoneId: string, payload?: ApproveMilestonePayload): Promise<ServiceMilestone>;
+declare const serviceBookingService: {
+    getAvailableSlots: typeof getAvailableSlots;
+    bookAppointment: typeof bookAppointment;
+    getAppointments: typeof getAppointments;
+    getAppointment: typeof getAppointment;
+    cancelAppointment: typeof cancelAppointment;
+    rescheduleAppointment: typeof rescheduleAppointment;
+    disputeAppointment: typeof disputeAppointment;
+    confirmAppointmentCompletion: typeof confirmAppointmentCompletion;
+    getMilestones: typeof getMilestones;
+    approveMilestone: typeof approveMilestone;
+};
+
+/**
+ * Notification Service
+ *
+ * Handles contact form submissions, email notifications, and notification
+ * channel preferences (customer self-service + merchant-level policy).
+ * Stateless - all configuration passed as parameters.
+ */
+
+interface ContactFormData {
+    name: string;
+    email: string;
+    subject: string;
+    message: string;
+    source?: string;
+    company_name?: string;
+    current_year?: number;
+}
+/**
+ * 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: ContactFormData): Promise<{
+    detail: string;
+}>;
+/**
+ * Get the caller's own notification preferences (customer or business
+ * owner self-service — whoever's access token is passed).
+ * GET /notifications/preferences/
+ */
+declare function getNotificationPreferences(config: SdkConfig, accessToken: string): Promise<NotificationPreferences>;
+/**
+ * Update the caller's own notification preferences.
+ * PATCH /notifications/preferences/
+ */
+declare function updateNotificationPreferences(config: SdkConfig, accessToken: string, payload: Partial<NotificationPreferences>): Promise<NotificationPreferences>;
+interface VapidPublicKeyResponse {
+    public_key: string;
+    subject: string;
+}
+interface PushSubscriptionKeys {
+    p256dh: string;
+    auth: string;
+}
+interface SubscribeToPushParams {
+    subscription: {
+        endpoint: string;
+        keys: PushSubscriptionKeys;
+    };
+    user_agent: string;
+}
+declare function getVapidPublicKey(config: SdkConfig): Promise<VapidPublicKeyResponse>;
+declare function subscribeToPush(config: SdkConfig, accessToken: string, params: SubscribeToPushParams): Promise<{
+    status: string;
+    subscription_id: string;
+    vapid_key_version: number;
+}>;
+declare function unsubscribeFromPush(config: SdkConfig, accessToken: string, endpoint: string): Promise<{
+    status: string;
+}>;
+type NotificationPriority = 'urgent' | 'normal' | 'low';
+interface NotificationInboxItem {
+    id: string;
+    title: string;
+    body: string;
+    icon_url?: string | null;
+    image_url?: string | null;
+    priority: NotificationPriority;
+    action_type?: string | null;
+    action_url?: string | null;
+    entity_id?: string | null;
+    entity_type?: string | null;
+    category: string;
+    source_event_type: string;
+    read: boolean;
+    read_at?: string | null;
+    clicked: boolean;
+    clicked_at?: string | null;
+    action_performed: boolean;
+    created_at: string;
+    expires_at?: string | null;
+}
+interface NotificationInboxResponse {
+    results: NotificationInboxItem[];
+    count: number;
+    page: number;
+    page_size: number;
+    total_pages: number;
+}
+declare function getNotificationInbox(config: SdkConfig, accessToken: string, params?: {
+    page?: number;
+    limit?: number;
+    unread_only?: boolean;
+}): Promise<NotificationInboxResponse>;
+declare function markNotificationRead(config: SdkConfig, accessToken: string, notificationId: string): Promise<{
+    status: string;
+}>;
+declare function markAllNotificationsRead(config: SdkConfig, accessToken: string): Promise<{
+    status: string;
+}>;
+declare function trackNotificationClick(config: SdkConfig, accessToken: string, notificationId: string): Promise<{
+    status: string;
+}>;
+declare const notificationsService: {
+    readonly sendContactEmail: typeof sendContactEmail;
+    readonly sendContactConfirmation: typeof sendContactConfirmation;
+    readonly getNotificationPreferences: typeof getNotificationPreferences;
+    readonly updateNotificationPreferences: typeof updateNotificationPreferences;
+    readonly getVapidPublicKey: typeof getVapidPublicKey;
+    readonly subscribeToPush: typeof subscribeToPush;
+    readonly unsubscribeFromPush: typeof unsubscribeFromPush;
+    readonly getNotificationInbox: typeof getNotificationInbox;
+    readonly markNotificationRead: typeof markNotificationRead;
+    readonly markAllNotificationsRead: typeof markAllNotificationsRead;
+    readonly trackNotificationClick: typeof trackNotificationClick;
+};
+
+interface UploadMediaFileParams {
+    file: File;
+    /** e.g. "review", "digital_product" — matches kasuvia-media-system's context_validation.py. */
+    context: string;
+    entityId: string;
+    affiliation?: string;
+    ownerId?: string;
+    presignedUrlEndpoint?: string;
+    confirmUploadEndpoint?: string;
+}
+/**
+ * Upload one file end-to-end: request a presigned URL, PUT the file
+ * directly to R2, then confirm the upload to get back a real MediaAsset.
+ */
+declare function uploadMediaFile(params: UploadMediaFileParams): Promise<MediaAsset>;
+interface UploadMediaFilesResult {
+    assets: MediaAsset[];
+    errors: {
+        file: string;
+        message: string;
+    }[];
+}
+/**
+ * Upload several files, one at a time (sequential — real progress feedback
+ * per file rather than an opaque Promise.all batch). A single file's
+ * failure does not abort the rest: matches the original BespokeStep/
+ * ProductReviews behaviour of keeping whatever succeeded before a later
+ * file failed, rather than discarding it. The caller decides how to present
+ * `errors` (e.g. one toast per failed filename).
+ */
+declare function uploadMediaFiles(files: File[], params: Omit<UploadMediaFileParams, 'file'>): Promise<UploadMediaFilesResult>;
+
+export { type DVADetails as $, type AuthUserResponse as A, type BespokeDeliverableStatus as B, type CreateBespokeOrderParams as C, type DeactivateAccountResult as D, type ApproveMilestonePayload as E, type Feedback as F, type AvailableSlotsResponse as G, type ServiceAppointmentCreatePayload as H, type CancelAppointmentPayload as I, type ConfirmAppointmentPayload as J, type DisputeAppointmentPayload as K, type Comment as L, type CommentCreate as M, type Review as N, type ReviewCreate as O, type MerchantReplyCreate as P, type CommentModerationAction as Q, type RescheduleAppointmentPayload as R, type StorefrontBusinessInfo as S, type ReviewModerationAction as T, type UpdateCustomerAddressPayload as U, type ProductCommentsResponse as V, type ProductReviewsResponse as W, type CommentUpdate as X, type ReviewUpdate as Y, type GatewayMethods as Z, type WalletBalanceResponse as _, type CreateServiceBookingOrderParams as a, type StorageStats as a$, type DVACreateRequest as a0, type PaymentInitiateResponse as a1, type PaymentInitiateRequest as a2, type TransactionVerifyResponse as a3, type WalletLedgerResponse as a4, type CmsEntry as a5, type CreateCmsEntryParams as a6, type UpdateCmsEntryParams as a7, type ListCmsEntriesParams as a8, type BusinessConfig as a9, type DeactivateConfirmationRequired as aA, type DigitalDownloadFileEntry as aB, type DigitalDownloadListing as aC, type DigitalDownloadRedirect as aD, type DigitalDownloadResult as aE, type FeedbackCategory as aF, type FeedbackStatus as aG, type FlashSaleEntryData as aH, type LogoutPayload as aI, type MediaAffiliation as aJ, type MediaAssetUpdatePayload as aK, type MediaUploadParams as aL, ModerationStatus as aM, type NotificationInboxItem as aN, type NotificationPriority as aO, type OTPVerifyPayload as aP, type OutstandingClaimResponse as aQ, type PaymentGateway as aR, PaymentGatewayEnum as aS, type PaymentMethodOption as aT, type PaymentMethodType as aU, PaymentMethodTypeEnum as aV, type ProductFaqEntryData as aW, type PromoValidationResult as aX, type PushSubscriptionKeys as aY, type RefreshTokenResponse as aZ, type ResendOTPPayload as a_, type NotificationInboxResponse as aa, type NotificationPreferences as ab, type ContactFormData as ac, type SubscribeToPushParams as ad, type VapidPublicKeyResponse as ae, type MediaAsset as af, type UploadMediaFileParams as ag, type UploadMediaFilesResult as ah, type ServiceBookingStatus as ai, type MilestoneStatus as aj, type AuthContextValue as ak, type AvatarObject as al, type BackendLanguage as am, type BespokeFulfillment as an, type BlogEntryData as ao, type ClaimWalletCreditRequest as ap, type CmsEntryListResponse as aq, type CmsField as ar, type CmsIcon as as, type CmsIconListResponse as at, type CmsIconValue as au, type CmsMediaValue as av, type CmsModel as aw, type CmsModelPermissions as ax, type CmsModelPublicApiPermissions as ay, type CustomerProfileFields as az, type Consultation as b, type StoreLocationEntryData as b0, type SupportedCurrenciesResponse as b1, type SupportedLanguagesResponse as b2, type WalletLedgerEntry as b3, approveMilestone as b4, bookAppointment as b5, cancelAppointment as b6, cancelOrder as b7, confirmAppointmentCompletion as b8, createBespokeOrder as b9, trackOrder as bA, unsubscribeFromPush as bB, updateNotificationPreferences as bC, uploadMediaFile as bD, uploadMediaFiles as bE, validatePromoCode as bF, createConsultation as ba, createFeedback as bb, createOrder as bc, createServiceBookingOrder as bd, disputeAppointment as be, findOrder as bf, getAppointment as bg, getAppointments as bh, getAvailableSlots as bi, getMilestones as bj, getMyFeedback as bk, getNotificationInbox as bl, getNotificationPreferences as bm, getOrders as bn, getVapidPublicKey as bo, markAllNotificationsRead as bp, markNotificationRead as bq, notificationsService as br, rescheduleAppointment as bs, resolveDigitalDownload as bt, resolveDigitalDownloadFile as bu, sendContactConfirmation as bv, sendContactEmail as bw, serviceBookingService as bx, subscribeToPush as by, trackNotificationClick as bz, type CreateConsultationParams as c, type CreateFeedbackParams as d, type FeedbackListResponse as e, type CustomerAddress as f, type CreateCustomerAddressPayload as g, type ChangePasswordPayload as h, type CustomerDeactivatePayload as i, type CustomerForgotPasswordPayload as j, type CustomerReactivatePayload as k, type CustomerReactivateVerifyPayload as l, type CustomerResetPasswordPayload as m, type CustomerAuthResponse as n, type CustomerLoginPayload as o, type CustomerRegisterPayload as p, type CustomerPasswordlessRequestPayload as q, type CustomerUser as r, type UpdateProfilePayload as s, type CustomerPasswordlessVerifyPayload as t, type SupportedLang as u, type Currency as v, type BespokeAvailability as w, type ServiceAppointment as x, type ServiceBookingsPage as y, type ServiceMilestone as z };