@kasuvia/sdk 0.0.1

package/src/services/service-booking.service.ts

@@ -0,0 +1,86 @@
+/**
+ * Service Booking Service
+ * 
+ * Handles service appointments and deliverables.
+ */
+import { storeManagementAxios } from '../client/httpClient'
+import type {
+  ServiceAppointment,
+  ServiceAppointmentCreatePayload,
+  AvailableSlot,
+  ServiceDeliverable,
+  DeliverableApprovalPayload,
+} from '../types/services'
+
+export async function getAvailableSlots(
+  product_id: string,
+  date_from: string,
+  date_to: string
+): Promise<AvailableSlot[]> {
+  const { data } = await storeManagementAxios.get<AvailableSlot[]>(
+    `service/available-slots/${product_id}`,
+    { params: { date_from, date_to } }
+  )
+  return data
+}
+
+export async function bookAppointment(
+  payload: ServiceAppointmentCreatePayload
+): Promise<ServiceAppointment> {
+  const { data } = await storeManagementAxios.post<ServiceAppointment>('service/appointments/', payload)
+  return data
+}
+
+export async function getAppointments(): Promise<ServiceAppointment[]> {
+  const { data } = await storeManagementAxios.get<ServiceAppointment[]>('service/bookings/my')
+  return data
+}
+
+export async function getAppointment(id: string): Promise<ServiceAppointment> {
+  const { data } = await storeManagementAxios.get<ServiceAppointment>(`service/bookings/${id}`)
+  return data
+}
+
+export async function cancelAppointment(id: string): Promise<void> {
+  await storeManagementAxios.delete(`service/bookings/${id}`)
+}
+
+export async function getDeliverables(order_id: string): Promise<ServiceDeliverable[]> {
+  const { data } = await storeManagementAxios.get<ServiceDeliverable[]>(`service/projects/${order_id}/deliverables/`)
+  return data
+}
+
+export async function approveDeliverable(
+  order_id: string,
+  deliverable_id: string
+): Promise<ServiceDeliverable> {
+  const { data } = await storeManagementAxios.post<ServiceDeliverable>(
+    `service/projects/${order_id}/deliverables/${deliverable_id}/approve`,
+    { approved: true }
+  )
+  return data
+}
+
+export async function requestRevision(
+  order_id: string,
+  deliverable_id: string,
+  feedback: string
+): Promise<ServiceDeliverable> {
+  const { data } = await storeManagementAxios.post<ServiceDeliverable>(
+    `service/projects/${order_id}/deliverables/${deliverable_id}/revision`,
+    { approved: false, feedback }
+  )
+  return data
+}
+
+// Service object export for backward compatibility
+export const serviceBookingService = {
+  getAvailableSlots,
+  bookAppointment,
+  getAppointments,
+  getAppointment,
+  cancelAppointment,
+  getDeliverables,
+  approveDeliverable,
+  requestRevision,
+}

package/src/services/wishlist.service.ts

@@ -0,0 +1,84 @@
+/**
+ * Wishlist Service
+ * 
+ * Handles wishlist operations.
+ */
+import { storeManagementAxios } from '../client/httpClient'
+import { getGraphQLClient } from '../client/graphqlClient'
+import type { WishlistItem, WishlistListResponse, WishlistCheckResponse } from '../types/store'
+
+const GET_WISHLIST = `
+  query GetWishlist($page: Int!, $pageSize: Int!) {
+    wishlist(page: $page, pageSize: $pageSize) {
+      items {
+        id
+        product_id
+        notes
+        created_at
+        product_name
+        product_slug
+        product_price
+        product_image
+      }
+      total
+      page
+      page_size
+      total_pages
+    }
+  }
+`
+
+const CHECK_IN_WISHLIST = `
+  query CheckInWishlist($productId: String!) {
+    check_in_wishlist(productId: $productId) {
+      in_wishlist
+    }
+  }
+`
+
+/**
+ * Fetch the customer's wishlist for the current business.
+ */
+export async function getWishlist(params?: { page?: number; pageSize?: number }): Promise<WishlistListResponse> {
+  const client = getGraphQLClient()
+  const variables = {
+    page: params?.page || 1,
+    pageSize: params?.pageSize || 20,
+  }
+  const data = await client.request(GET_WISHLIST, variables)
+  return data.wishlist
+}
+
+/**
+ * Check if a product is in the customer's wishlist.
+ */
+export async function checkInWishlist(productId: string): Promise<WishlistCheckResponse> {
+  const client = getGraphQLClient()
+  const data = await client.request(CHECK_IN_WISHLIST, { productId })
+  return data.check_in_wishlist
+}
+
+/**
+ * Add a product to the customer's wishlist.
+ */
+export async function addToWishlist(productId: string, notes?: string): Promise<WishlistItem> {
+  const { data } = await storeManagementAxios.post<WishlistItem>("wishlist/", {
+    product_id: productId,
+    notes: notes || undefined,
+  })
+  return data
+}
+
+/**
+ * Remove an item from the customer's wishlist by item ID.
+ */
+export async function removeFromWishlist(itemId: string): Promise<void> {
+  await storeManagementAxios.delete(`wishlist/${itemId}`)
+}
+
+/**
+ * Remove a product from the customer's wishlist by product ID.
+ */
+export async function removeProductFromWishlist(productId: string): Promise<void> {
+  await storeManagementAxios.delete(`wishlist/product/${productId}`)
+}

package/src/types/auth/index.ts

@@ -0,0 +1,126 @@
+/**
+ * Simplified customer auth types for luxe-storefront.
+ * Customers only need enough to track their orders — no RBAC, MFA, or complex profiles.
+ */
+
+// ── Customer Identity ─────────────────────────────────────────────────────────
+
+/**
+ * Media System response object for avatar/profile picture.
+ * Stored as JSON in the backend Profile model.
+ */
+export interface AvatarObject {
+  id: string;
+  alt: string;
+  url: string;
+}
+
+export interface CustomerProfileFields {
+  firstname: string;
+  lastname: string;
+  phone: string;
+}
+
+export 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 luxe-auth UserSerializer */
+export 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;
+  };
+}
+
+export interface UpdateProfilePayload {
+  firstname?: string;
+  lastname?: string;
+  phone?: string;
+}
+
+// ── Business Context (storefront is scoped to one business) ──────────────────
+
+export interface BusinessContext {
+  id: string;             // UUID
+  business_id: string;    // B-XXXXXXXX — permanent, never changes
+  name: string;
+  logo_picture?: string | null;
+  display_currency?: string;
+}
+
+// ── API Responses ─────────────────────────────────────────────────────────────
+
+export interface CustomerAuthResponse {
+  access: string;
+  refresh: string;
+  user: CustomerUser;
+  business: BusinessContext;
+  is_new?: boolean;
+}
+
+export interface RefreshTokenResponse {
+  access: string;
+  refresh?: string;
+}
+
+// ── Request Payloads ──────────────────────────────────────────────────────────
+
+/** POST /auth/login/customer/ — field name is `tenant_id` (the business_id) */
+export interface CustomerLoginPayload {
+  tenant_id: string;    // config.api.storefrontBusinessId
+  email: string;
+  password: string;
+}
+
+/** POST /auth/register/customer/ */
+export interface CustomerRegisterPayload {
+  tenant_id: string;    // config.api.storefrontBusinessId
+  /** Full name — backend splits this into firstname and lastname on the Profile */
+  full_name: string;
+  email: string;
+  password: string;
+}
+
+/** POST /auth/verify-otp/ */
+export interface OTPVerifyPayload {
+  email: string;
+  code: string;
+  purpose?: 'verify' | 'password_reset';
+}
+
+/** POST /auth/resend-otp/ */
+export interface ResendOTPPayload {
+  email: string;
+}
+
+/** POST /auth/logout/ */
+export interface LogoutPayload {
+  refresh?: string;
+}
+
+// ── Auth Context ──────────────────────────────────────────────────────────────
+
+export interface AuthContextValue {
+  customer: CustomerUser | null;
+  isLoading: boolean;
+  isModalOpen: boolean;
+  openModal: () => void;
+  closeModal: () => void;
+  setCustomer: (user: CustomerUser | null) => void;
+  logout: () => Promise<void>;
+}

package/src/types/bespoke/index.ts

@@ -0,0 +1,39 @@
+/**
+ * Bespoke slot booking types for customer-facing storefront
+ */
+
+export type SlotBookingStatus = "reserved" | "confirmed" | "completed" | "voided";
+
+export interface BespokeSlotBooking {
+  id: string;
+  product_id: string;
+  capacity_config_id: string | null;
+  consultation_id: string | null;
+  order_id: string | null;
+  customer_id: string;
+  status: SlotBookingStatus;
+  preferred_start_date: string | null;
+  preferred_end_date: string | null;
+  estimated_completion_date: string | null;
+  notes: string | null;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface BespokeCapacityConfig {
+  id: string;
+  business_id: string;
+  product_id: string;
+  slot_period: "weekly" | "monthly" | "yearly";
+  total_slots: number;
+  slots_used: number;
+  period_start_date: string;
+  period_end_date: string;
+  production_days_per_order: number;
+  buffer_days_between_orders: number;
+  blocked_dates: string[];
+  auto_reset: boolean;
+  is_active: boolean;
+  created_at: string;
+  updated_at: string;
+}

package/src/types/business/index.ts

@@ -0,0 +1,6 @@
+export interface BusinessConfig {
+  business_id: string;
+  store_name: string;
+  store_currency: string;
+  is_active: boolean;
+}

package/src/types/cms/index.ts

@@ -0,0 +1,77 @@
+/**
+ * CMS Types
+ * 
+ * Types for kasuvia-cms integration - dynamic content models and entries
+ */
+
+export interface CmsField {
+  name: string
+  label: string
+  type: string
+  required: boolean
+  config: Record<string, any>
+  sub_fields?: CmsField[]
+}
+
+export interface CmsModelPermissions {
+  read: boolean
+  create: boolean
+  update: boolean
+  delete: boolean
+}
+
+export interface CmsModelPublicApiPermissions {
+  public_api: CmsModelPermissions
+}
+
+export interface CmsModel {
+  id: string
+  business_id: string
+  model_slug: string
+  display_name: string
+  description: string | null
+  fields: CmsField[]
+  permissions: CmsModelPublicApiPermissions
+}
+
+export interface CmsEntry {
+  id: string
+  business_id: string
+  model_slug: string
+  data: Record<string, any>
+  created_at: string
+  updated_at: string
+  created_by: string | null
+}
+
+export interface CmsEntryListResponse {
+  entries: CmsEntry[]
+  total: number
+  page: number
+  page_size: number
+}
+
+export interface CmsIcon {
+  id: string
+  name: string
+  category: string
+  tags: string[]
+}
+
+export interface CmsIconListResponse {
+  icons: CmsIcon[]
+  total: number
+}
+
+export interface ListCmsEntriesParams {
+  page?: number
+  page_size?: number
+}
+
+export interface CreateCmsEntryParams {
+  data: Record<string, any>
+}
+
+export interface UpdateCmsEntryParams {
+  data: Record<string, any>
+}

package/src/types/consultations/index.ts

@@ -0,0 +1,79 @@
+/**
+ * Consultation types for customer-facing storefront
+ */
+
+export type ConsultationStatus =
+  | "pending"
+  | "quoted"
+  | "negotiating"
+  | "deposit_pending"
+  | "deposit_paid"
+  | "converting"
+  | "converted"
+  | "rejected";
+
+export type ConsultationProductType = "bespoke" | "service";
+
+export 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;
+}
+
+export 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[];
+}
+
+export 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;
+}
+
+export interface ConsultationMessagePayload {
+  message: string;
+  attachments?: string[];
+}
+
+export interface ConsultationQuoteAcceptPayload {
+  agreed_price: number;
+}
+
+export interface BespokeAvailability {
+  available_slots: number;
+  next_available_date: string | null;
+  period_end: string;
+  blocked_dates: string[];
+  production_days: number;
+  is_available: boolean;
+}

package/src/types/index.ts

@@ -0,0 +1,27 @@
+/**
+ * SDK Types Barrel Export
+ * 
+ * Central export point for all domain types.
+ * Organized by backend service:
+ * - auth: kasuvia-auth
+ * - store: kasuvia-store-management
+ * - payments: kasuvia-payment-system
+ * - cms: kasuvia-cms
+ * - media: kasuvia-media-system
+ * - consultations: kasuvia-store-management (consultations feature)
+ * - services: kasuvia-store-management (service booking feature)
+ * - bespoke: kasuvia-store-management (bespoke slot booking feature)
+ * - business: business configuration
+ * - ui: UI/app state types
+ */
+
+export * from './auth'
+export * from './store'
+export * from './payments'
+export * from './consultations'
+export * from './services'
+export * from './bespoke'
+export * from './cms'
+export * from './media'
+export * from './business'
+export * from './ui'

package/src/types/media/index.ts

@@ -0,0 +1,41 @@
+/**
+ * Media types for the storefront
+ */
+
+export interface MediaAsset {
+  id: string
+  url: string
+  filename: string
+  content_type: string
+  size: number
+  business_id: string
+  affiliation: string
+  created_at: string
+  alt?: string
+  description?: string
+}
+
+export interface MediaUploadParams {
+  business_id?: string
+  owner_id?: string
+  uploaded_by_name?: string
+  affiliation?: string
+  context: string  // Required for security: describes the upload context (e.g., product, user, business)
+  entity_id: string  // Required for security: ID of the entity this file belongs to
+  alt?: string
+  description?: string
+  idempotency_key?: string
+}
+
+export interface MediaAssetUpdatePayload {
+  alt?: string
+  description?: string
+  affiliation?: string
+}
+
+export interface StorageStats {
+  total_bytes: number
+  used_bytes: number
+  available_bytes: number
+  asset_count: number
+}

package/src/types/payments/index.ts

@@ -0,0 +1,120 @@
+/**
+ * @file types/payments/index.ts
+ * @description All customer-facing payment types for the Luxe 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 → Luxe     : Subscription (separate, JWT-auth)
+ *   Luxe → Business Owner     : Payout (separate, JWT-auth)
+ */
+
+// ── Configuration Types ─────────────────────────────────────────────────────────
+
+export interface Currency {
+  code: string; // ISO 4217 currency code (e.g., USD, NGN, EUR)
+  name: string; // Full currency name (e.g., US Dollar, Nigerian Naira)
+  symbol: string; // Currency symbol (e.g., $, ₦, €)
+  decimals: number; // Number of decimal places (e.g., 2 for USD, 0 for JPY)
+  is_active: boolean; // Whether this currency is active
+}
+
+export interface SupportedCurrenciesResponse {
+  currencies: Currency[];
+}
+
+export interface BackendLanguage {
+  code: string; // Language code (e.g., en, ar, fr)
+  label: string; // Language label (e.g., English, Arabic, French)
+  flag: string; // Flag emoji or icon
+}
+
+export interface SupportedLang {
+  code: string; // Google Translate code
+  appCode: string; // Internal app code
+  label: string;
+  native: string;
+  flag: string;
+}
+
+export interface SupportedLanguagesResponse {
+  languages: BackendLanguage[];
+}
+
+// ── Request Types ─────────────────────────────────────────────────────────────
+
+export interface DVACreateRequest {
+  order_id?: string;
+  amount: number;
+  customer_email: string;
+  customer_name?: string;
+  /** Defaults to NGN — DVA is Monnify-only */
+  currency?: string;
+  /** Idempotency key to prevent duplicate DVA creation */
+  idempotency_key?: string;
+}
+
+export interface PaymentInitiateRequest {
+  amount: number;
+  currency: string;
+  customer_email: string;
+  customer_name?: string;
+  order_id?: string;
+  quote_id?: 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;
+}
+
+export interface ConversionQuote {
+  id: string;
+  business_id: string;
+  from_currency: string;
+  to_currency: string;
+  rate: number;
+  original_amount: number;
+  converted_amount: number;
+  is_used: boolean;
+  expires_at: string;
+  created_at: string;
+}
+
+// ── Response Types ─────────────────────────────────────────────────────────────
+
+export interface DVADetails {
+  account_number: string;
+  bank_name: string;
+  account_name: string;
+  reference: string;
+  amount: number;
+  transaction_id: string;
+  expires_at: string;
+}
+
+export interface PaymentInitiateResponse {
+  id: string;
+  gateway_ref: string;
+  gateway: string;
+  status: string;
+  /** Normalised top-level checkout URL for gateway redirect */
+  checkout_url: string;
+}
+
+export 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>;
+}