@scryme/sdk 9.65.0 → 9.67.0

package/dist/client.d.mts

@@ -1,149 +1,211 @@
-import React from 'react';
 import { AxiosInstance, AxiosResponse } from 'axios';
-import { fR as RawAPI, cT as CatalogModule, en as InventoryModule, ff as OrdersModule, cI as CRMModule, fn as POSModule, bO as AccountingModule, eP as LoyaltyModule, f8 as MembersModule, cg as AdminModule, b7 as CartControllerGetCartParams, b8 as CartResponseDto, ba as AddToCartDto, bb as RemoveFromCartDto, b9 as CartControllerClearCartParams, cN as CartItemDto, aA as OrderResponseDto, af as CustomerResponseDto, aj as UpdateCustomerDto, ak as AddressDto, a0 as CreateBookingDto, gd as ServiceBookingItemDto, ct as AuthModule, ag as RegisterCustomerDto, s as AuthExchangeToken201 } from './base-DZWqHn_L.mjs';
+import { ae as CustomerResponseDto, G as ProductResponseDto, K as ServiceCatalogResponseDto, cM as CartItemDto, b7 as CartResponseDto, dK as CustomerSessionDto, fT as RawAPI, cT as CatalogModule, ep as InventoryModule, fh as OrdersModule, cH as CRMModule, fp as POSModule, bN as AccountingModule, eR as LoyaltyModule, fa as MembersModule, cf as AdminModule, b6 as CartControllerGetCartParams, b9 as AddToCartDto, ba as RemoveFromCartDto, b8 as CartControllerClearCartParams, az as OrderResponseDto, ai as UpdateCustomerDto, aj as AddressDto, af as RegisterCustomerDto, dJ as CustomerAuthResponseDto, a0 as CreateBookingDto, gf as ServiceBookingItemDto, cs as AuthModule, s as AuthExchangeToken201 } from './base-1B2-e5i_.mjs';
 
+/**
+ * Defines a storage contract for persisting authentication tokens and session data.
+ * Ideal for client-side environments (localStorage, secure storage, custom cookies).
+ */
 interface StorageProvider {
+    /**
+     * Retrieves an item from storage.
+     * @param key Unique storage key.
+     */
     getItem(key: string): string | null | Promise<string | null>;
+    /**
+     * Stores an item in storage.
+     * @param key Unique storage key.
+     * @param value Stringified value to store.
+     */
     setItem(key: string, value: string): void | Promise<void>;
+    /**
+     * Deletes an item from storage.
+     * @param key Unique storage key.
+     */
     removeItem(key: string): void | Promise<void>;
 }
+/**
+ * Configuration options for the stateful ScrymeClientSDK.
+ */
 interface ClientSDKConfig {
+    /**
+     * The client ID of your Storefront application.
+     */
     clientId: string;
+    /**
+     * The optional client secret. It is omitted on the client side for maximum security.
+     */
     clientSecret?: string;
+    /**
+     * The unique slug of the organization to target.
+     */
     orgSlug: string;
+    /**
+     * Optional base API URL. Defaults to "https://api.scryme.tech".
+     */
     baseURL?: string;
+    /**
+     * Custom storage provider to persist session tokens. Defaults to localStorage where available.
+     */
     storage?: StorageProvider;
 }
+/**
+ * Represents the authentication change events emitted by the SDK.
+ */
 type AuthChangeEvent = "SIGNED_IN" | "SIGNED_OUT" | "INITIAL_SESSION";
-interface SessionState {
+/**
+ * Represents the active customer session status.
+ * @template TUser Custom User profile type.
+ */
+interface SessionState<TUser = CustomerResponseDto> {
+    /**
+     * The current customer authentication JWT token.
+     */
     token: string | null;
-    user: CustomerResponseDto | null;
+    /**
+     * The deserialized customer profile details.
+     */
+    user: TUser | null;
+    /**
+     * Epoch millisecond expiration timestamp of the token.
+     */
     expiresAt?: number | null;
 }
-type AuthStateCallback = (event: AuthChangeEvent, session: SessionState) => void;
-declare class ScrymeClientSDK {
+/**
+ * Callback signature triggered whenever the customer authentication status changes.
+ */
+type AuthStateCallback<TUser = CustomerResponseDto> = (event: AuthChangeEvent, session: SessionState<TUser>) => void;
+/**
+ * Stateful, reactive Client-Side SDK for Scryme V3.
+ *
+ * Automatically handles JWT token exchanges, reactive customer session refreshes,
+ * stateful shopping cart synchronization, and real-time authentication state updates.
+ *
+ * @template TProduct Custom Product DTO type override. Defaults to ProductResponseDto.
+ * @template TService Custom Service DTO type override. Defaults to ServiceCatalogResponseDto.
+ * @template TCartItem Custom Cart Item DTO type override. Defaults to CartItemDto.
+ * @template TCartResponse Custom Cart Response DTO type override. Defaults to CartResponseDto.
+ * @template TUser Custom User Profile DTO type override. Defaults to CustomerResponseDto.
+ * @template TSession Custom Customer Session DTO type override. Defaults to CustomerSessionDto.
+ */
+declare class ScrymeClientSDK<TProduct = ProductResponseDto, TService = ServiceCatalogResponseDto, TCartItem = CartItemDto, TCartResponse = CartResponseDto, TUser = CustomerResponseDto, TSession = CustomerSessionDto> {
+    /**
+     * Underlying Axios instance initialized with the customized baseUrl and automatic interceptors.
+     */
     axiosInstance: AxiosInstance;
+    /**
+     * Raw proxy API client exposing all standard endpoints auto-bound with the configured orgSlug.
+     */
     api: RawAPI;
-    catalog: CatalogModule;
+    /** Catalog operations submodule (products, services, categories, bookings, staff schedules). */
+    catalog: CatalogModule<TProduct, TService>;
+    /** Traceability, split/merge, physical reconciliation, and partner wallet operations submodule. */
     inventory: InventoryModule;
+    /** Cart management, sales order orchestration, checkout processing, and payments submodule. */
     orders: OrdersModule;
+    /** Custom fields, relationships, note logging, associations, and CRM timeline submodule. */
     crm: CRMModule;
+    /** Cash flow register, sale processing, terminal synchronization, and device provision submodule. */
     pos: POSModule;
+    /** Balance sheets, Profit & Loss reports, expenses, invoices, and utility account submodule. */
     accounting: AccountingModule;
+    /** Rewards, voucher validation, point balances, and customer favorite records submodule. */
     loyalty: LoyaltyModule;
+    /** Staff members, department directories, check-in logs, and broadcast announcements submodule. */
     members: MembersModule;
+    /** Global setup parameters, organization definitions, audit trails, and tier limit submodule. */
     admin: AdminModule;
+    /**
+     * Stateful Shopping Cart Submodule.
+     * Leverages internal tracking and smart delta calculations for optimized storefront shopping.
+     */
     cart: {
-        get(params?: CartControllerGetCartParams): Promise<AxiosResponse<CartResponseDto & Record<string, any>>>;
+        get<T = TCartResponse>(params?: CartControllerGetCartParams): Promise<AxiosResponse<T & Record<string, any>>>;
         add(dto: AddToCartDto): Promise<AxiosResponse<void>>;
         remove(dto: RemoveFromCartDto): Promise<AxiosResponse<void>>;
         clear(params?: CartControllerClearCartParams): Promise<AxiosResponse<void>>;
-        update(dto: AddToCartDto & {
+        update<T = TCartResponse>(dto: AddToCartDto & {
             quantity: number;
-        }): Promise<AxiosResponse<void> | AxiosResponse<CartResponseDto> | undefined>;
-        getItems(params?: CartControllerGetCartParams): Promise<CartItemDto[]>;
-        getTotals(params?: CartControllerGetCartParams): Promise<{
+        }): Promise<AxiosResponse<void> | AxiosResponse<T> | undefined>;
+        getItems<T = TCartItem>(params?: CartControllerGetCartParams): Promise<T[]>;
+        getTotals<TItem = TCartItem, TRaw = TCartResponse>(params?: CartControllerGetCartParams): Promise<{
             itemsCount: number;
-            items: CartItemDto[];
-            raw: CartResponseDto;
+            items: TItem[];
+            raw: TRaw;
         }>;
-        mergeGuestCart(guestSessionId: string, customerId: string): Promise<AxiosResponse<CartResponseDto & Record<string, any>>>;
+        mergeGuestCart<T = TCartResponse>(guestSessionId: string, customerId: string): Promise<AxiosResponse<T & Record<string, any>>>;
         checkout(params: {
             locationId: string;
             notes?: string;
             channel?: string;
         }): Promise<OrderResponseDto>;
     };
+    /**
+     * Storefront Customer Profile Submodule.
+     * Manages the authenticated user's self-serve account, update workflows, and shipping/billing directories.
+     */
     customer: {
-        getProfile(): Promise<CustomerResponseDto>;
-        updateProfile(dto: UpdateCustomerDto): Promise<AxiosResponse<CustomerResponseDto>>;
+        getProfile<T = TUser>(): Promise<T>;
+        updateProfile<T = TUser>(dto: UpdateCustomerDto): Promise<AxiosResponse<T>>;
         getAddresses(): Promise<AxiosResponse<AddressDto[]>>;
         addAddress(dto: AddressDto): Promise<AxiosResponse<void>>;
+        auth: {
+            signUp<T = TUser>(dto: RegisterCustomerDto): Promise<AxiosResponse<T>>;
+            signIn<TSess = TSession, TU = TUser>(credentials: {
+                email: string;
+                password?: string;
+            }): Promise<CustomerAuthResponseDto<TU, TSess>>;
+            signOut(): Promise<void>;
+            getSession<TU = TUser>(): Promise<SessionState<TU>>;
+            onAuthStateChange<TU = TUser>(callback: AuthStateCallback<TU>): {
+                unsubscribe(): void;
+            };
+            getSessions<TSess = TSession>(): Promise<TSess[]>;
+            revokeSession(id: string): Promise<AxiosResponse<void>>;
+            revokeAllSessions(mode?: string): Promise<AxiosResponse<void>>;
+            getCurrentSession<TU = TUser>(): Promise<TU>;
+            refreshSession<TSess = TSession, TU = TUser>(): Promise<CustomerAuthResponseDto<TU, TSess>>;
+        };
     };
+    /**
+     * Service Bookings & Appointments Submodule.
+     */
     bookings: {
         create(dto: CreateBookingDto): Promise<AxiosResponse<void>>;
         get(id: string): Promise<AxiosResponse<ServiceBookingItemDto>>;
         list(): Promise<AxiosResponse<ServiceBookingItemDto[]>>;
         cancel(id: string): Promise<AxiosResponse<void>>;
     };
+    /**
+     * Authentication & Customer Session Submodule.
+     */
     auth: AuthModule & {
-        signUp(dto: RegisterCustomerDto): Promise<AxiosResponse<CustomerResponseDto>>;
+        signUp<T = TUser>(dto: RegisterCustomerDto): Promise<AxiosResponse<T>>;
         authenticate(): Promise<AuthExchangeToken201>;
-        signIn(credentials: {
+        signIn<TSess = TSession, TU = TUser>(credentials: {
             email: string;
             password?: string;
-        }): Promise<{
-            token: string;
-            session?: any;
-            user?: any;
-        }>;
+        }): Promise<CustomerAuthResponseDto<TU, TSess>>;
         signOut(): Promise<void>;
-        getSession(): Promise<SessionState>;
-        onAuthStateChange(callback: AuthStateCallback): {
+        getSession<TU = TUser>(): Promise<SessionState<TU>>;
+        onAuthStateChange<TU = TUser>(callback: AuthStateCallback<TU>): {
             unsubscribe(): void;
         };
-        getSessions(): Promise<any[]>;
-        revokeSession(id: string): Promise<any>;
-        revokeAllSessions(mode?: string): Promise<any>;
-        getCurrentSession(): Promise<CustomerResponseDto>;
-        refreshSession(): Promise<{
-            token: string;
-            session?: any;
-        }>;
-        swapZitadel(zitadelToken: string): Promise<{
-            token: string;
-            session?: any;
-        }>;
+        getSessions<TSess = TSession>(): Promise<TSess[]>;
+        revokeSession(id: string): Promise<AxiosResponse<void>>;
+        revokeAllSessions(mode?: string): Promise<AxiosResponse<void>>;
+        getCurrentSession<TU = TUser>(): Promise<TU>;
+        refreshSession<TSess = TSession, TU = TUser>(): Promise<CustomerAuthResponseDto<TU, TSess>>;
     };
+    /**
+     * Initializes the ScrymeClientSDK.
+     * @param config Application and organization configuration parameters.
+     */
     constructor(config: ClientSDKConfig);
 }
-declare function createClientSDK(config?: any): ScrymeClientSDK;
-interface AuthContextType {
-    sdk: ScrymeClientSDK;
-    session: SessionState;
-    user: CustomerResponseDto | null;
-    token: string | null;
-    isLoading: boolean;
-    signIn: (credentials: {
-        email: string;
-        password?: string;
-    }) => Promise<{
-        token: string;
-        session?: any;
-        user?: any;
-    }>;
-    signUp: (dto: RegisterCustomerDto) => Promise<AxiosResponse<CustomerResponseDto>>;
-    signOut: () => Promise<void>;
-    cart: CartResponseDto | null;
-    cartLoading: boolean;
-    addToCart: (dto: AddToCartDto) => Promise<void>;
-    removeFromCart: (dto: RemoveFromCartDto) => Promise<void>;
-    updateCartItem: (dto: AddToCartDto & {
-        quantity: number;
-    }) => Promise<void>;
-    clearCart: (params?: CartControllerClearCartParams) => Promise<void>;
-    refreshCart: () => Promise<void>;
-    customerProfile: CustomerResponseDto | null;
-    customerAddresses: AddressDto[];
-    bookings: ServiceBookingItemDto[];
-    bookingsLoading: boolean;
-    addAddress: (dto: AddressDto) => Promise<AxiosResponse<void>>;
-    updateProfile: (dto: UpdateCustomerDto) => Promise<AxiosResponse<CustomerResponseDto>>;
-    createBooking: (dto: CreateBookingDto) => Promise<AxiosResponse<void>>;
-    cancelBooking: (id: string) => Promise<AxiosResponse<void>>;
-    checkoutCart: (params: {
-        locationId: string;
-        notes?: string;
-        channel?: string;
-    }) => Promise<OrderResponseDto>;
-    refreshProfile: () => Promise<void>;
-    refreshBookings: () => Promise<void>;
-}
-interface ScrymeAuthProviderProps {
-    sdk: ScrymeClientSDK;
-    children: React.ReactNode;
-}
-declare const ScrymeAuthProvider: React.FC<ScrymeAuthProviderProps>;
-declare const useScrymeAuth: () => AuthContextType;
+/**
+ * Factory helper function to instantiate a ScrymeClientSDK.
+ * Retains backward compatibility while enforcing strict ClientSDKConfig types.
+ */
+declare function createClientSDK<TProduct = ProductResponseDto, TService = ServiceCatalogResponseDto, TCartItem = CartItemDto, TCartResponse = CartResponseDto, TUser = CustomerResponseDto, TSession = CustomerSessionDto>(config?: Partial<ClientSDKConfig>): ScrymeClientSDK<TProduct, TService, TCartItem, TCartResponse, TUser, TSession>;
 
-export { type AuthChangeEvent, type AuthContextType, type AuthStateCallback, type ClientSDKConfig, ScrymeAuthProvider, type ScrymeAuthProviderProps, ScrymeClientSDK, type SessionState, type StorageProvider, createClientSDK, useScrymeAuth };
+export { type AuthChangeEvent, type AuthStateCallback, type ClientSDKConfig, ScrymeClientSDK, type SessionState, type StorageProvider, createClientSDK };

package/dist/client.d.ts

@@ -1,149 +1,211 @@
-import React from 'react';
 import { AxiosInstance, AxiosResponse } from 'axios';
-import { fR as RawAPI, cT as CatalogModule, en as InventoryModule, ff as OrdersModule, cI as CRMModule, fn as POSModule, bO as AccountingModule, eP as LoyaltyModule, f8 as MembersModule, cg as AdminModule, b7 as CartControllerGetCartParams, b8 as CartResponseDto, ba as AddToCartDto, bb as RemoveFromCartDto, b9 as CartControllerClearCartParams, cN as CartItemDto, aA as OrderResponseDto, af as CustomerResponseDto, aj as UpdateCustomerDto, ak as AddressDto, a0 as CreateBookingDto, gd as ServiceBookingItemDto, ct as AuthModule, ag as RegisterCustomerDto, s as AuthExchangeToken201 } from './base-DZWqHn_L.js';
+import { ae as CustomerResponseDto, G as ProductResponseDto, K as ServiceCatalogResponseDto, cM as CartItemDto, b7 as CartResponseDto, dK as CustomerSessionDto, fT as RawAPI, cT as CatalogModule, ep as InventoryModule, fh as OrdersModule, cH as CRMModule, fp as POSModule, bN as AccountingModule, eR as LoyaltyModule, fa as MembersModule, cf as AdminModule, b6 as CartControllerGetCartParams, b9 as AddToCartDto, ba as RemoveFromCartDto, b8 as CartControllerClearCartParams, az as OrderResponseDto, ai as UpdateCustomerDto, aj as AddressDto, af as RegisterCustomerDto, dJ as CustomerAuthResponseDto, a0 as CreateBookingDto, gf as ServiceBookingItemDto, cs as AuthModule, s as AuthExchangeToken201 } from './base-1B2-e5i_.js';
 
+/**
+ * Defines a storage contract for persisting authentication tokens and session data.
+ * Ideal for client-side environments (localStorage, secure storage, custom cookies).
+ */
 interface StorageProvider {
+    /**
+     * Retrieves an item from storage.
+     * @param key Unique storage key.
+     */
     getItem(key: string): string | null | Promise<string | null>;
+    /**
+     * Stores an item in storage.
+     * @param key Unique storage key.
+     * @param value Stringified value to store.
+     */
     setItem(key: string, value: string): void | Promise<void>;
+    /**
+     * Deletes an item from storage.
+     * @param key Unique storage key.
+     */
     removeItem(key: string): void | Promise<void>;
 }
+/**
+ * Configuration options for the stateful ScrymeClientSDK.
+ */
 interface ClientSDKConfig {
+    /**
+     * The client ID of your Storefront application.
+     */
     clientId: string;
+    /**
+     * The optional client secret. It is omitted on the client side for maximum security.
+     */
     clientSecret?: string;
+    /**
+     * The unique slug of the organization to target.
+     */
     orgSlug: string;
+    /**
+     * Optional base API URL. Defaults to "https://api.scryme.tech".
+     */
     baseURL?: string;
+    /**
+     * Custom storage provider to persist session tokens. Defaults to localStorage where available.
+     */
     storage?: StorageProvider;
 }
+/**
+ * Represents the authentication change events emitted by the SDK.
+ */
 type AuthChangeEvent = "SIGNED_IN" | "SIGNED_OUT" | "INITIAL_SESSION";
-interface SessionState {
+/**
+ * Represents the active customer session status.
+ * @template TUser Custom User profile type.
+ */
+interface SessionState<TUser = CustomerResponseDto> {
+    /**
+     * The current customer authentication JWT token.
+     */
     token: string | null;
-    user: CustomerResponseDto | null;
+    /**
+     * The deserialized customer profile details.
+     */
+    user: TUser | null;
+    /**
+     * Epoch millisecond expiration timestamp of the token.
+     */
     expiresAt?: number | null;
 }
-type AuthStateCallback = (event: AuthChangeEvent, session: SessionState) => void;
-declare class ScrymeClientSDK {
+/**
+ * Callback signature triggered whenever the customer authentication status changes.
+ */
+type AuthStateCallback<TUser = CustomerResponseDto> = (event: AuthChangeEvent, session: SessionState<TUser>) => void;
+/**
+ * Stateful, reactive Client-Side SDK for Scryme V3.
+ *
+ * Automatically handles JWT token exchanges, reactive customer session refreshes,
+ * stateful shopping cart synchronization, and real-time authentication state updates.
+ *
+ * @template TProduct Custom Product DTO type override. Defaults to ProductResponseDto.
+ * @template TService Custom Service DTO type override. Defaults to ServiceCatalogResponseDto.
+ * @template TCartItem Custom Cart Item DTO type override. Defaults to CartItemDto.
+ * @template TCartResponse Custom Cart Response DTO type override. Defaults to CartResponseDto.
+ * @template TUser Custom User Profile DTO type override. Defaults to CustomerResponseDto.
+ * @template TSession Custom Customer Session DTO type override. Defaults to CustomerSessionDto.
+ */
+declare class ScrymeClientSDK<TProduct = ProductResponseDto, TService = ServiceCatalogResponseDto, TCartItem = CartItemDto, TCartResponse = CartResponseDto, TUser = CustomerResponseDto, TSession = CustomerSessionDto> {
+    /**
+     * Underlying Axios instance initialized with the customized baseUrl and automatic interceptors.
+     */
     axiosInstance: AxiosInstance;
+    /**
+     * Raw proxy API client exposing all standard endpoints auto-bound with the configured orgSlug.
+     */
     api: RawAPI;
-    catalog: CatalogModule;
+    /** Catalog operations submodule (products, services, categories, bookings, staff schedules). */
+    catalog: CatalogModule<TProduct, TService>;
+    /** Traceability, split/merge, physical reconciliation, and partner wallet operations submodule. */
     inventory: InventoryModule;
+    /** Cart management, sales order orchestration, checkout processing, and payments submodule. */
     orders: OrdersModule;
+    /** Custom fields, relationships, note logging, associations, and CRM timeline submodule. */
     crm: CRMModule;
+    /** Cash flow register, sale processing, terminal synchronization, and device provision submodule. */
     pos: POSModule;
+    /** Balance sheets, Profit & Loss reports, expenses, invoices, and utility account submodule. */
     accounting: AccountingModule;
+    /** Rewards, voucher validation, point balances, and customer favorite records submodule. */
     loyalty: LoyaltyModule;
+    /** Staff members, department directories, check-in logs, and broadcast announcements submodule. */
     members: MembersModule;
+    /** Global setup parameters, organization definitions, audit trails, and tier limit submodule. */
     admin: AdminModule;
+    /**
+     * Stateful Shopping Cart Submodule.
+     * Leverages internal tracking and smart delta calculations for optimized storefront shopping.
+     */
     cart: {
-        get(params?: CartControllerGetCartParams): Promise<AxiosResponse<CartResponseDto & Record<string, any>>>;
+        get<T = TCartResponse>(params?: CartControllerGetCartParams): Promise<AxiosResponse<T & Record<string, any>>>;
         add(dto: AddToCartDto): Promise<AxiosResponse<void>>;
         remove(dto: RemoveFromCartDto): Promise<AxiosResponse<void>>;
         clear(params?: CartControllerClearCartParams): Promise<AxiosResponse<void>>;
-        update(dto: AddToCartDto & {
+        update<T = TCartResponse>(dto: AddToCartDto & {
             quantity: number;
-        }): Promise<AxiosResponse<void> | AxiosResponse<CartResponseDto> | undefined>;
-        getItems(params?: CartControllerGetCartParams): Promise<CartItemDto[]>;
-        getTotals(params?: CartControllerGetCartParams): Promise<{
+        }): Promise<AxiosResponse<void> | AxiosResponse<T> | undefined>;
+        getItems<T = TCartItem>(params?: CartControllerGetCartParams): Promise<T[]>;
+        getTotals<TItem = TCartItem, TRaw = TCartResponse>(params?: CartControllerGetCartParams): Promise<{
             itemsCount: number;
-            items: CartItemDto[];
-            raw: CartResponseDto;
+            items: TItem[];
+            raw: TRaw;
         }>;
-        mergeGuestCart(guestSessionId: string, customerId: string): Promise<AxiosResponse<CartResponseDto & Record<string, any>>>;
+        mergeGuestCart<T = TCartResponse>(guestSessionId: string, customerId: string): Promise<AxiosResponse<T & Record<string, any>>>;
         checkout(params: {
             locationId: string;
             notes?: string;
             channel?: string;
         }): Promise<OrderResponseDto>;
     };
+    /**
+     * Storefront Customer Profile Submodule.
+     * Manages the authenticated user's self-serve account, update workflows, and shipping/billing directories.
+     */
     customer: {
-        getProfile(): Promise<CustomerResponseDto>;
-        updateProfile(dto: UpdateCustomerDto): Promise<AxiosResponse<CustomerResponseDto>>;
+        getProfile<T = TUser>(): Promise<T>;
+        updateProfile<T = TUser>(dto: UpdateCustomerDto): Promise<AxiosResponse<T>>;
         getAddresses(): Promise<AxiosResponse<AddressDto[]>>;
         addAddress(dto: AddressDto): Promise<AxiosResponse<void>>;
+        auth: {
+            signUp<T = TUser>(dto: RegisterCustomerDto): Promise<AxiosResponse<T>>;
+            signIn<TSess = TSession, TU = TUser>(credentials: {
+                email: string;
+                password?: string;
+            }): Promise<CustomerAuthResponseDto<TU, TSess>>;
+            signOut(): Promise<void>;
+            getSession<TU = TUser>(): Promise<SessionState<TU>>;
+            onAuthStateChange<TU = TUser>(callback: AuthStateCallback<TU>): {
+                unsubscribe(): void;
+            };
+            getSessions<TSess = TSession>(): Promise<TSess[]>;
+            revokeSession(id: string): Promise<AxiosResponse<void>>;
+            revokeAllSessions(mode?: string): Promise<AxiosResponse<void>>;
+            getCurrentSession<TU = TUser>(): Promise<TU>;
+            refreshSession<TSess = TSession, TU = TUser>(): Promise<CustomerAuthResponseDto<TU, TSess>>;
+        };
     };
+    /**
+     * Service Bookings & Appointments Submodule.
+     */
     bookings: {
         create(dto: CreateBookingDto): Promise<AxiosResponse<void>>;
         get(id: string): Promise<AxiosResponse<ServiceBookingItemDto>>;
         list(): Promise<AxiosResponse<ServiceBookingItemDto[]>>;
         cancel(id: string): Promise<AxiosResponse<void>>;
     };
+    /**
+     * Authentication & Customer Session Submodule.
+     */
     auth: AuthModule & {
-        signUp(dto: RegisterCustomerDto): Promise<AxiosResponse<CustomerResponseDto>>;
+        signUp<T = TUser>(dto: RegisterCustomerDto): Promise<AxiosResponse<T>>;
         authenticate(): Promise<AuthExchangeToken201>;
-        signIn(credentials: {
+        signIn<TSess = TSession, TU = TUser>(credentials: {
             email: string;
             password?: string;
-        }): Promise<{
-            token: string;
-            session?: any;
-            user?: any;
-        }>;
+        }): Promise<CustomerAuthResponseDto<TU, TSess>>;
         signOut(): Promise<void>;
-        getSession(): Promise<SessionState>;
-        onAuthStateChange(callback: AuthStateCallback): {
+        getSession<TU = TUser>(): Promise<SessionState<TU>>;
+        onAuthStateChange<TU = TUser>(callback: AuthStateCallback<TU>): {
             unsubscribe(): void;
         };
-        getSessions(): Promise<any[]>;
-        revokeSession(id: string): Promise<any>;
-        revokeAllSessions(mode?: string): Promise<any>;
-        getCurrentSession(): Promise<CustomerResponseDto>;
-        refreshSession(): Promise<{
-            token: string;
-            session?: any;
-        }>;
-        swapZitadel(zitadelToken: string): Promise<{
-            token: string;
-            session?: any;
-        }>;
+        getSessions<TSess = TSession>(): Promise<TSess[]>;
+        revokeSession(id: string): Promise<AxiosResponse<void>>;
+        revokeAllSessions(mode?: string): Promise<AxiosResponse<void>>;
+        getCurrentSession<TU = TUser>(): Promise<TU>;
+        refreshSession<TSess = TSession, TU = TUser>(): Promise<CustomerAuthResponseDto<TU, TSess>>;
     };
+    /**
+     * Initializes the ScrymeClientSDK.
+     * @param config Application and organization configuration parameters.
+     */
     constructor(config: ClientSDKConfig);
 }
-declare function createClientSDK(config?: any): ScrymeClientSDK;
-interface AuthContextType {
-    sdk: ScrymeClientSDK;
-    session: SessionState;
-    user: CustomerResponseDto | null;
-    token: string | null;
-    isLoading: boolean;
-    signIn: (credentials: {
-        email: string;
-        password?: string;
-    }) => Promise<{
-        token: string;
-        session?: any;
-        user?: any;
-    }>;
-    signUp: (dto: RegisterCustomerDto) => Promise<AxiosResponse<CustomerResponseDto>>;
-    signOut: () => Promise<void>;
-    cart: CartResponseDto | null;
-    cartLoading: boolean;
-    addToCart: (dto: AddToCartDto) => Promise<void>;
-    removeFromCart: (dto: RemoveFromCartDto) => Promise<void>;
-    updateCartItem: (dto: AddToCartDto & {
-        quantity: number;
-    }) => Promise<void>;
-    clearCart: (params?: CartControllerClearCartParams) => Promise<void>;
-    refreshCart: () => Promise<void>;
-    customerProfile: CustomerResponseDto | null;
-    customerAddresses: AddressDto[];
-    bookings: ServiceBookingItemDto[];
-    bookingsLoading: boolean;
-    addAddress: (dto: AddressDto) => Promise<AxiosResponse<void>>;
-    updateProfile: (dto: UpdateCustomerDto) => Promise<AxiosResponse<CustomerResponseDto>>;
-    createBooking: (dto: CreateBookingDto) => Promise<AxiosResponse<void>>;
-    cancelBooking: (id: string) => Promise<AxiosResponse<void>>;
-    checkoutCart: (params: {
-        locationId: string;
-        notes?: string;
-        channel?: string;
-    }) => Promise<OrderResponseDto>;
-    refreshProfile: () => Promise<void>;
-    refreshBookings: () => Promise<void>;
-}
-interface ScrymeAuthProviderProps {
-    sdk: ScrymeClientSDK;
-    children: React.ReactNode;
-}
-declare const ScrymeAuthProvider: React.FC<ScrymeAuthProviderProps>;
-declare const useScrymeAuth: () => AuthContextType;
+/**
+ * Factory helper function to instantiate a ScrymeClientSDK.
+ * Retains backward compatibility while enforcing strict ClientSDKConfig types.
+ */
+declare function createClientSDK<TProduct = ProductResponseDto, TService = ServiceCatalogResponseDto, TCartItem = CartItemDto, TCartResponse = CartResponseDto, TUser = CustomerResponseDto, TSession = CustomerSessionDto>(config?: Partial<ClientSDKConfig>): ScrymeClientSDK<TProduct, TService, TCartItem, TCartResponse, TUser, TSession>;
 
-export { type AuthChangeEvent, type AuthContextType, type AuthStateCallback, type ClientSDKConfig, ScrymeAuthProvider, type ScrymeAuthProviderProps, ScrymeClientSDK, type SessionState, type StorageProvider, createClientSDK, useScrymeAuth };
+export { type AuthChangeEvent, type AuthStateCallback, type ClientSDKConfig, ScrymeClientSDK, type SessionState, type StorageProvider, createClientSDK };