@scryme/sdk 9.65.0 → 9.67.0

package/dist/index.mjs

@@ -33,7 +33,6 @@ import {
   RegisterPettyCashDtoPaymentMethod,
   ReviewPriceChangeDtoStatus,
   RoleManagementControllerGetCustomRolesSortOrder,
-  ScrymeAuthProvider,
   ScrymeClientSDK,
   ScrymeServerSDK,
   ServicesUpdateBookingStatusBodyStatus,
@@ -66,9 +65,8 @@ import {
   ordersMapping,
   posMapping,
   publicServicesMapping,
-  servicesMapping,
-  useScrymeAuth
-} from "./chunk-PPNV4D3M.mjs";
+  servicesMapping
+} from "./chunk-QS5K7GIL.mjs";
 export {
   AddDepartmentMemberDtoRole,
   AttendanceControllerGetLogsSortOrder,
@@ -104,7 +102,6 @@ export {
   RegisterPettyCashDtoPaymentMethod,
   ReviewPriceChangeDtoStatus,
   RoleManagementControllerGetCustomRolesSortOrder,
-  ScrymeAuthProvider,
   ScrymeClientSDK,
   ScrymeServerSDK,
   ServicesUpdateBookingStatusBodyStatus,
@@ -137,6 +134,5 @@ export {
   ordersMapping,
   posMapping,
   publicServicesMapping,
-  servicesMapping,
-  useScrymeAuth
+  servicesMapping
 };

package/dist/server.d.mts

@@ -1,41 +1,123 @@
 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, gF as ServicesModule, 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, a2 as CompleteBookingDto, ct as AuthModule, ag as RegisterCustomerDto, s as AuthExchangeToken201 } from './base-DZWqHn_L.mjs';
+import { G as ProductResponseDto, K as ServiceCatalogResponseDto, cM as CartItemDto, b7 as CartResponseDto, ae as CustomerResponseDto, 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, gH as ServicesModule, 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, a2 as CompleteBookingDto, cs as AuthModule, s as AuthExchangeToken201 } from './base-1B2-e5i_.mjs';
 
+/**
+ * Configuration options for the isolated ScrymeServerSDK.
+ */
 interface ServerSDKConfig {
+    /**
+     * The client ID of your Server application credentials.
+     */
     clientId: string;
+    /**
+     * The client secret of your Server application credentials.
+     */
     clientSecret: string;
+    /**
+     * The unique slug of the organization to target.
+     */
     orgSlug: string;
+    /**
+     * Optional base API URL. Defaults to "https://api.scryme.tech".
+     */
     baseURL?: string;
+    /**
+     * Optional high-performance customer session or admin JWT token.
+     */
     token?: string;
+    /**
+     * Optional organization API key for system-level integrations.
+     */
     apiKey?: string;
 }
-declare class ScrymeServerSDK {
+/**
+ * Isolated, Multi-Tenant Safe Server-Side SDK for Scryme V3.
+ *
+ * Allocates strict request/session isolation to prevent token leakages, supporting
+ * backoffice orchestration, batch catalog syncs, scheduling updates, and administrative audits.
+ *
+ * @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 ScrymeServerSDK<TProduct = ProductResponseDto, TService = ServiceCatalogResponseDto, TCartItem = CartItemDto, TCartResponse = CartResponseDto, TUser = CustomerResponseDto, TSession = CustomerSessionDto> {
+    /** Underlying Axios instance allocated exclusively to this server instance. */
     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;
+    /** Scheduling operations, break/shift management, staff schedules, and resource utilization submodule. */
     services: ServicesModule;
+    /**
+     * Server Cart Submodule.
+     * Enables backend processes to orchestrate customer checkout sessions, retrieve active item lists, and manage shopping states.
+     */
     cart: {
-        get(params?: CartControllerGetCartParams): Promise<AxiosResponse<CartResponseDto>>;
+        /**
+         * Retrieves a customer shopping cart.
+         * @param params Query arguments containing guest session or customer identifier.
+         */
+        get<T = TCartResponse>(params?: CartControllerGetCartParams): Promise<AxiosResponse<T>>;
+        /**
+         * Adds an item to a target shopping cart.
+         * @param dto Item and target cart identifier details.
+         */
         add(dto: AddToCartDto): Promise<AxiosResponse<void>>;
+        /**
+         * Removes an item from a target shopping cart.
+         * @param dto Item and target cart identifier details.
+         */
         remove(dto: RemoveFromCartDto): Promise<AxiosResponse<void>>;
+        /**
+         * Clears all items from a target shopping cart.
+         * @param params Query arguments containing target session/customer identifiers.
+         */
         clear(params?: CartControllerClearCartParams): Promise<AxiosResponse<void>>;
-        update(dto: AddToCartDto & {
+        /**
+         * Performs a smart delta-based update of item quantities in a shopping cart.
+         * @param dto Item, quantity, and cart identifier details.
+         */
+        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>;
+        /**
+         * Returns a flat list of all items present in a shopping cart.
+         * @param params Query arguments containing target session/customer identifiers.
+         */
+        getItems<T = TCartItem>(params?: CartControllerGetCartParams): Promise<T[]>;
+        /**
+         * Calculates totals including items counts and returns full raw cart response details.
+         * @param params Query arguments containing target session/customer identifiers.
+         */
+        getTotals<TItem = TCartItem, TRaw = TCartResponse>(params?: CartControllerGetCartParams): Promise<{
             itemsCount: number;
-            items: CartItemDto[];
-            raw: CartResponseDto;
+            items: TItem[];
+            raw: TRaw;
         }>;
+        /**
+         * Orchestrates cart checkouts, finalizes shopping workflows, and outputs a registered sales order.
+         * @param params Target customer, location, and metadata details.
+         */
         checkout(params: {
             sessionId?: string;
             customerId?: string;
@@ -44,45 +126,133 @@ declare class ScrymeServerSDK {
             channel?: string;
         }): Promise<OrderResponseDto>;
     };
+    /**
+     * Server Customer Management Submodule.
+     * Provides administrative lookup, profile updates, and shipping/billing address configurations.
+     */
     customer: {
-        getProfile(customerId: string): Promise<AxiosResponse<CustomerResponseDto>>;
-        updateProfile(customerId: string, dto: UpdateCustomerDto): Promise<AxiosResponse<CustomerResponseDto>>;
+        /**
+         * Fetches detailed profile information for a specific customer.
+         * @param customerId Customer database identifier.
+         */
+        getProfile<T = TUser>(customerId: string): Promise<AxiosResponse<T>>;
+        /**
+         * Modifies profile attributes for a specific customer.
+         * @param customerId Customer database identifier.
+         * @param dto Updated fields.
+         */
+        updateProfile<T = TUser>(customerId: string, dto: UpdateCustomerDto): Promise<AxiosResponse<T>>;
+        /**
+         * Retrieves shipping and billing addresses for a specific customer.
+         * @param customerId Customer database identifier.
+         */
         getAddresses(customerId: string): Promise<AxiosResponse<AddressDto[]>>;
+        /**
+         * Adds an address to a customer's directory.
+         * @param customerId Customer database identifier.
+         * @param dto Address details.
+         */
         addAddress(customerId: string, dto: AddressDto): Promise<AxiosResponse<void>>;
+        /**
+         * Server Customer Authentication Submodule.
+         */
+        auth: {
+            /**
+             * Administer registration of a new customer account.
+             * @param dto Customer credentials and details.
+             */
+            signUp<T = TUser>(dto: RegisterCustomerDto): Promise<AxiosResponse<T>>;
+            /**
+             * Swaps credentials for an active, high-performance customer session token.
+             * @param credentials Email and password.
+             */
+            signIn<TSess = TSession, TU = TUser>(credentials: {
+                email: string;
+                password?: string;
+            }): Promise<CustomerAuthResponseDto<TU, TSess>>;
+            /**
+             * Fetches details of the customer session associated with the active token.
+             */
+            getCurrentSession<TU = TUser>(headers?: any | Record<string, string | string[]>): Promise<TU>;
+            /**
+             * Refreshes the current active customer session token.
+             */
+            refreshSession<TSess = TSession, TU = TUser>(): Promise<CustomerAuthResponseDto<TU, TSess>>;
+        };
     };
+    /**
+     * Server Bookings & Appointment Submodule.
+     * Enables booking creation, history audits, cancellations, and secure completion workflows.
+     */
     bookings: {
+        /**
+         * Schedules a new booking reservation.
+         * @param dto Booking specifications.
+         */
         create(dto: CreateBookingDto): Promise<AxiosResponse<void>>;
+        /**
+         * Looks up detailed configuration and status details for a specific booking.
+         * @param id Booking database identifier.
+         */
         get(id: string): Promise<AxiosResponse<ServiceBookingItemDto>>;
+        /**
+         * Lists the full history of booking reservations inside the organization.
+         */
         list(): Promise<AxiosResponse<ServiceBookingItemDto[]>>;
+        /**
+         * Cancels an active reservation, marking its status as CANCELLED.
+         * @param id Booking database identifier.
+         */
         cancel(id: string): Promise<AxiosResponse<void>>;
+        /**
+         * Securely completes a booking reservation (including post-service audits and QC reports).
+         * @param id Booking database identifier.
+         * @param dto Completion data.
+         */
         complete(id: string, dto: CompleteBookingDto & Record<string, any>): Promise<AxiosResponse<void>>;
     };
+    /**
+     * Server Authentication & Customer Session Submodule.
+     * Handles server-orchestrated sign-ups, credential-based customer login, token validations.
+     */
     auth: AuthModule & {
-        signUp(dto: RegisterCustomerDto): Promise<AxiosResponse<CustomerResponseDto>>;
+        /**
+         * Administer registration of a new customer account.
+         * @param dto Customer credentials and details.
+         */
+        signUp<T = TUser>(dto: RegisterCustomerDto): Promise<AxiosResponse<T>>;
+        /**
+         * Triggers client credentials exchange for your Server credentials.
+         */
         authenticate(): Promise<AuthExchangeToken201>;
-        signIn(credentials: {
+        /**
+         * Swaps credentials for an active, high-performance customer session token.
+         * @param credentials Email and password.
+         */
+        signIn<TSess = TSession, TU = TUser>(credentials: {
             email: string;
             password?: string;
-        }): Promise<{
-            token: string;
-            session?: any;
-            user?: any;
-        }>;
-        getCurrentSession(): Promise<CustomerResponseDto>;
-        refreshSession(): Promise<{
-            token: string;
-            session?: any;
-        }>;
-        swapZitadel(zitadelToken: string): Promise<{
-            token: string;
-            session?: any;
-        }>;
+        }): Promise<CustomerAuthResponseDto<TU, TSess>>;
+        /**
+         * Fetches details of the customer session associated with the active token.
+         */
+        getCurrentSession<TU = TUser>(headers?: any | Record<string, string | string[]>): Promise<TU>;
+        /**
+         * Refreshes the current active customer session token.
+         */
+        refreshSession<TSess = TSession, TU = TUser>(): Promise<CustomerAuthResponseDto<TU, TSess>>;
     };
     private token;
     private expiresAt;
     private activeAuthPromise;
     constructor(config: ServerSDKConfig);
 }
-declare function createServerSDK(config?: any): ScrymeServerSDK;
+/**
+ * Factory helper function to instantiate a ScrymeServerSDK.
+ * Retains backward compatibility while enforcing strict ServerSDKConfig types.
+ *
+ * @param config Server configuration overrides.
+ */
+declare function createServerSDK<TProduct = ProductResponseDto, TService = ServiceCatalogResponseDto, TCartItem = CartItemDto, TCartResponse = CartResponseDto, TUser = CustomerResponseDto, TSession = CustomerSessionDto>(config?: Partial<ServerSDKConfig>): ScrymeServerSDK<TProduct, TService, TCartItem, TCartResponse, TUser, TSession>;
 
 export { ScrymeServerSDK, type ServerSDKConfig, createServerSDK };

package/dist/server.d.ts

@@ -1,41 +1,123 @@
 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, gF as ServicesModule, 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, a2 as CompleteBookingDto, ct as AuthModule, ag as RegisterCustomerDto, s as AuthExchangeToken201 } from './base-DZWqHn_L.js';
+import { G as ProductResponseDto, K as ServiceCatalogResponseDto, cM as CartItemDto, b7 as CartResponseDto, ae as CustomerResponseDto, 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, gH as ServicesModule, 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, a2 as CompleteBookingDto, cs as AuthModule, s as AuthExchangeToken201 } from './base-1B2-e5i_.js';
 
+/**
+ * Configuration options for the isolated ScrymeServerSDK.
+ */
 interface ServerSDKConfig {
+    /**
+     * The client ID of your Server application credentials.
+     */
     clientId: string;
+    /**
+     * The client secret of your Server application credentials.
+     */
     clientSecret: string;
+    /**
+     * The unique slug of the organization to target.
+     */
     orgSlug: string;
+    /**
+     * Optional base API URL. Defaults to "https://api.scryme.tech".
+     */
     baseURL?: string;
+    /**
+     * Optional high-performance customer session or admin JWT token.
+     */
     token?: string;
+    /**
+     * Optional organization API key for system-level integrations.
+     */
     apiKey?: string;
 }
-declare class ScrymeServerSDK {
+/**
+ * Isolated, Multi-Tenant Safe Server-Side SDK for Scryme V3.
+ *
+ * Allocates strict request/session isolation to prevent token leakages, supporting
+ * backoffice orchestration, batch catalog syncs, scheduling updates, and administrative audits.
+ *
+ * @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 ScrymeServerSDK<TProduct = ProductResponseDto, TService = ServiceCatalogResponseDto, TCartItem = CartItemDto, TCartResponse = CartResponseDto, TUser = CustomerResponseDto, TSession = CustomerSessionDto> {
+    /** Underlying Axios instance allocated exclusively to this server instance. */
     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;
+    /** Scheduling operations, break/shift management, staff schedules, and resource utilization submodule. */
     services: ServicesModule;
+    /**
+     * Server Cart Submodule.
+     * Enables backend processes to orchestrate customer checkout sessions, retrieve active item lists, and manage shopping states.
+     */
     cart: {
-        get(params?: CartControllerGetCartParams): Promise<AxiosResponse<CartResponseDto>>;
+        /**
+         * Retrieves a customer shopping cart.
+         * @param params Query arguments containing guest session or customer identifier.
+         */
+        get<T = TCartResponse>(params?: CartControllerGetCartParams): Promise<AxiosResponse<T>>;
+        /**
+         * Adds an item to a target shopping cart.
+         * @param dto Item and target cart identifier details.
+         */
         add(dto: AddToCartDto): Promise<AxiosResponse<void>>;
+        /**
+         * Removes an item from a target shopping cart.
+         * @param dto Item and target cart identifier details.
+         */
         remove(dto: RemoveFromCartDto): Promise<AxiosResponse<void>>;
+        /**
+         * Clears all items from a target shopping cart.
+         * @param params Query arguments containing target session/customer identifiers.
+         */
         clear(params?: CartControllerClearCartParams): Promise<AxiosResponse<void>>;
-        update(dto: AddToCartDto & {
+        /**
+         * Performs a smart delta-based update of item quantities in a shopping cart.
+         * @param dto Item, quantity, and cart identifier details.
+         */
+        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>;
+        /**
+         * Returns a flat list of all items present in a shopping cart.
+         * @param params Query arguments containing target session/customer identifiers.
+         */
+        getItems<T = TCartItem>(params?: CartControllerGetCartParams): Promise<T[]>;
+        /**
+         * Calculates totals including items counts and returns full raw cart response details.
+         * @param params Query arguments containing target session/customer identifiers.
+         */
+        getTotals<TItem = TCartItem, TRaw = TCartResponse>(params?: CartControllerGetCartParams): Promise<{
             itemsCount: number;
-            items: CartItemDto[];
-            raw: CartResponseDto;
+            items: TItem[];
+            raw: TRaw;
         }>;
+        /**
+         * Orchestrates cart checkouts, finalizes shopping workflows, and outputs a registered sales order.
+         * @param params Target customer, location, and metadata details.
+         */
         checkout(params: {
             sessionId?: string;
             customerId?: string;
@@ -44,45 +126,133 @@ declare class ScrymeServerSDK {
             channel?: string;
         }): Promise<OrderResponseDto>;
     };
+    /**
+     * Server Customer Management Submodule.
+     * Provides administrative lookup, profile updates, and shipping/billing address configurations.
+     */
     customer: {
-        getProfile(customerId: string): Promise<AxiosResponse<CustomerResponseDto>>;
-        updateProfile(customerId: string, dto: UpdateCustomerDto): Promise<AxiosResponse<CustomerResponseDto>>;
+        /**
+         * Fetches detailed profile information for a specific customer.
+         * @param customerId Customer database identifier.
+         */
+        getProfile<T = TUser>(customerId: string): Promise<AxiosResponse<T>>;
+        /**
+         * Modifies profile attributes for a specific customer.
+         * @param customerId Customer database identifier.
+         * @param dto Updated fields.
+         */
+        updateProfile<T = TUser>(customerId: string, dto: UpdateCustomerDto): Promise<AxiosResponse<T>>;
+        /**
+         * Retrieves shipping and billing addresses for a specific customer.
+         * @param customerId Customer database identifier.
+         */
         getAddresses(customerId: string): Promise<AxiosResponse<AddressDto[]>>;
+        /**
+         * Adds an address to a customer's directory.
+         * @param customerId Customer database identifier.
+         * @param dto Address details.
+         */
         addAddress(customerId: string, dto: AddressDto): Promise<AxiosResponse<void>>;
+        /**
+         * Server Customer Authentication Submodule.
+         */
+        auth: {
+            /**
+             * Administer registration of a new customer account.
+             * @param dto Customer credentials and details.
+             */
+            signUp<T = TUser>(dto: RegisterCustomerDto): Promise<AxiosResponse<T>>;
+            /**
+             * Swaps credentials for an active, high-performance customer session token.
+             * @param credentials Email and password.
+             */
+            signIn<TSess = TSession, TU = TUser>(credentials: {
+                email: string;
+                password?: string;
+            }): Promise<CustomerAuthResponseDto<TU, TSess>>;
+            /**
+             * Fetches details of the customer session associated with the active token.
+             */
+            getCurrentSession<TU = TUser>(headers?: any | Record<string, string | string[]>): Promise<TU>;
+            /**
+             * Refreshes the current active customer session token.
+             */
+            refreshSession<TSess = TSession, TU = TUser>(): Promise<CustomerAuthResponseDto<TU, TSess>>;
+        };
     };
+    /**
+     * Server Bookings & Appointment Submodule.
+     * Enables booking creation, history audits, cancellations, and secure completion workflows.
+     */
     bookings: {
+        /**
+         * Schedules a new booking reservation.
+         * @param dto Booking specifications.
+         */
         create(dto: CreateBookingDto): Promise<AxiosResponse<void>>;
+        /**
+         * Looks up detailed configuration and status details for a specific booking.
+         * @param id Booking database identifier.
+         */
         get(id: string): Promise<AxiosResponse<ServiceBookingItemDto>>;
+        /**
+         * Lists the full history of booking reservations inside the organization.
+         */
         list(): Promise<AxiosResponse<ServiceBookingItemDto[]>>;
+        /**
+         * Cancels an active reservation, marking its status as CANCELLED.
+         * @param id Booking database identifier.
+         */
         cancel(id: string): Promise<AxiosResponse<void>>;
+        /**
+         * Securely completes a booking reservation (including post-service audits and QC reports).
+         * @param id Booking database identifier.
+         * @param dto Completion data.
+         */
         complete(id: string, dto: CompleteBookingDto & Record<string, any>): Promise<AxiosResponse<void>>;
     };
+    /**
+     * Server Authentication & Customer Session Submodule.
+     * Handles server-orchestrated sign-ups, credential-based customer login, token validations.
+     */
     auth: AuthModule & {
-        signUp(dto: RegisterCustomerDto): Promise<AxiosResponse<CustomerResponseDto>>;
+        /**
+         * Administer registration of a new customer account.
+         * @param dto Customer credentials and details.
+         */
+        signUp<T = TUser>(dto: RegisterCustomerDto): Promise<AxiosResponse<T>>;
+        /**
+         * Triggers client credentials exchange for your Server credentials.
+         */
         authenticate(): Promise<AuthExchangeToken201>;
-        signIn(credentials: {
+        /**
+         * Swaps credentials for an active, high-performance customer session token.
+         * @param credentials Email and password.
+         */
+        signIn<TSess = TSession, TU = TUser>(credentials: {
             email: string;
             password?: string;
-        }): Promise<{
-            token: string;
-            session?: any;
-            user?: any;
-        }>;
-        getCurrentSession(): Promise<CustomerResponseDto>;
-        refreshSession(): Promise<{
-            token: string;
-            session?: any;
-        }>;
-        swapZitadel(zitadelToken: string): Promise<{
-            token: string;
-            session?: any;
-        }>;
+        }): Promise<CustomerAuthResponseDto<TU, TSess>>;
+        /**
+         * Fetches details of the customer session associated with the active token.
+         */
+        getCurrentSession<TU = TUser>(headers?: any | Record<string, string | string[]>): Promise<TU>;
+        /**
+         * Refreshes the current active customer session token.
+         */
+        refreshSession<TSess = TSession, TU = TUser>(): Promise<CustomerAuthResponseDto<TU, TSess>>;
     };
     private token;
     private expiresAt;
     private activeAuthPromise;
     constructor(config: ServerSDKConfig);
 }
-declare function createServerSDK(config?: any): ScrymeServerSDK;
+/**
+ * Factory helper function to instantiate a ScrymeServerSDK.
+ * Retains backward compatibility while enforcing strict ServerSDKConfig types.
+ *
+ * @param config Server configuration overrides.
+ */
+declare function createServerSDK<TProduct = ProductResponseDto, TService = ServiceCatalogResponseDto, TCartItem = CartItemDto, TCartResponse = CartResponseDto, TUser = CustomerResponseDto, TSession = CustomerSessionDto>(config?: Partial<ServerSDKConfig>): ScrymeServerSDK<TProduct, TService, TCartItem, TCartResponse, TUser, TSession>;
 
 export { ScrymeServerSDK, type ServerSDKConfig, createServerSDK };