@gymspace/sdk 1.9.1 → 1.9.3

package/dist/index.d.mts

@@ -1,8 +1,30 @@
 import { AxiosRequestConfig } from 'axios';
-import { PaginationParams as PaginationParams$1, ListCollaboratorsParams, Collaborator, UpdateCollaboratorDto, UpdateCollaboratorRoleDto, UpdateCollaboratorStatusDto, ActivityQueryParams, ActivityItem, StatsQueryParams, CollaboratorStats, Role, ContractStatus, CancellationReason, SuspensionType, CreateInvitationDto, Invitation, ValidateByCodeDto, ValidateByTokenDto, AcceptInvitationDto, BulkMessage, BulkMessageVariable } from '@gymspace/shared';
+import { TemplateCode as TemplateCode$2, ListCollaboratorsParams, Collaborator, UpdateCollaboratorDto, UpdateCollaboratorRoleDto, UpdateCollaboratorStatusDto, ActivityQueryParams, ActivityItem, StatsQueryParams, CollaboratorStats, Role, ContractStatus, ContractInstallmentStatus, CancellationReason, SuspensionType, CreateInvitationDto, Invitation, ValidateByCodeDto, ValidateByTokenDto, AcceptInvitationDto, BulkMessage, BulkMessageVariable, FeatureType } from '@gymspace/shared';
 export * from '@gymspace/shared';
 export { BulkMessage, BulkMessageVariable } from '@gymspace/shared';
 
+declare class GymSpaceError extends Error {
+    statusCode?: number;
+    code?: string;
+    details?: any;
+    constructor(message: string, statusCode?: number, code?: string, details?: any);
+}
+declare class AuthenticationError extends GymSpaceError {
+    constructor(message?: string);
+}
+declare class AuthorizationError extends GymSpaceError {
+    constructor(message?: string);
+}
+declare class NotFoundError extends GymSpaceError {
+    constructor(resource: string, id?: string);
+}
+declare class ValidationError extends GymSpaceError {
+    constructor(message: string, errors?: any);
+}
+declare class NetworkError extends GymSpaceError {
+    constructor(message?: string);
+}
+
 interface GymSpaceConfig {
     baseURL: string;
     apiKey?: string;
@@ -12,6 +34,7 @@ interface GymSpaceConfig {
 }
 interface RequestOptions {
     gymId?: string;
+    gymContextMode?: 'scoped' | 'global';
     headers?: Record<string, string>;
     skipAuth?: boolean;
 }
@@ -31,14 +54,17 @@ interface PaginatedResponse<T> {
     };
 }
 type PaginatedResponseDto<T> = PaginatedResponse<T>;
-
-type PaginationQueryDto = PaginationParams$1;
+type PaginationQueryDto = PaginationParams;
 
 declare class ApiClient {
     private axiosInstance;
     private config;
     private refreshToken;
+    private rememberMe;
     private onTokenRefreshed?;
+    private onAuthFailure?;
+    private isRefreshing;
+    private failedRequestsQueue;
     getAccessToken(): string | null;
     constructor(config: GymSpaceConfig);
     private setupInterceptors;
@@ -53,6 +79,14 @@ declare class ApiClient {
     setAuthToken(token: string): void;
     setRefreshToken(token: string | null): void;
     getRefreshToken(): string | null;
+    /**
+     * Set rememberMe preference from login response
+     */
+    setRememberMe(value: boolean): void;
+    /**
+     * Get rememberMe preference
+     */
+    getRememberMe(): boolean | null;
     /**
      * Set callback for when tokens are refreshed by backend
      */
@@ -61,9 +95,31 @@ declare class ApiClient {
      * Get the token refresh callback
      */
     getOnTokenRefreshed(): ((accessToken: string, refreshToken?: string) => void) | undefined;
+    /**
+     * Set callback for when authentication fails irrecoverably
+     */
+    setOnAuthFailure(callback: (error: AuthenticationError) => void): void;
     setGymId(gymId: string): void;
     clearAuth(): void;
     getBaseUrl(): string;
+    /**
+     * Get config for creating scoped SDK instances
+     * Exposes minimal config needed without exposing internal structure
+     */
+    getConfigForScoped(): {
+        baseURL: string;
+        apiKey?: string;
+        refreshToken?: string;
+        headers?: Record<string, string>;
+    };
+    /**
+     * Get axios instance defaults for scoped SDK
+     */
+    getAxiosDefaults(): Record<string, unknown>;
+    /**
+     * Set common headers on axios instance (for scoped SDK setup)
+     */
+    setCommonHeaders(headers: Record<string, string>): void;
 }
 
 interface RegisterOwnerDto {
@@ -80,6 +136,7 @@ interface RegisterOwnerDto {
 interface LoginDto {
     email: string;
     password: string;
+    rememberMe?: boolean;
 }
 interface LoginResponseDto {
     access_token: string;
@@ -167,9 +224,7 @@ interface CollaboratorRoleDto {
     gymId: string;
     gymName: string;
 }
-interface CurrentSessionResponse {
-    accessToken: string;
-    refreshToken?: string;
+interface CurrentSessionBase {
     user: {
         id: string;
         email: string;
@@ -227,6 +282,131 @@ interface CurrentSessionResponse {
     collaborator?: CollaboratorRoleDto;
     isAuthenticated: boolean;
 }
+type CurrentSessionResponse = CurrentSessionBase & {
+    access_token: string;
+    refresh_token?: string;
+    accessToken?: string;
+    refreshToken?: string;
+};
+type CurrentSessionResponseLegacy = CurrentSessionBase & {
+    accessToken: string;
+    refreshToken?: string;
+};
+
+interface CreateMemberInviteDto {
+    sendWhatsApp?: boolean;
+    customMessage?: string;
+    expiresInHours?: number;
+}
+interface MemberInvite {
+    id: string;
+    token: string;
+    code: string;
+    status: 'pending' | 'used' | 'expired';
+    expiresAt: string;
+    usedAt?: string;
+    createdAt: string;
+}
+interface MemberInviteResponse {
+    invite: MemberInvite;
+    whatsappSent?: boolean;
+}
+interface MemberInviteValidationResponse {
+    valid: boolean;
+    status: 'pending' | 'used' | 'expired';
+    gym: {
+        name: string;
+        logo?: string;
+        address?: string;
+        slug: string;
+    };
+    client: {
+        email: string;
+        name: string;
+    };
+    invite: {
+        id: string;
+        expiresAt: string;
+        status: 'pending' | 'used' | 'expired';
+    };
+}
+interface MemberPinLoginDto {
+    identifier: string;
+    identifierType: 'phone' | 'email' | 'document';
+    documentType?: string;
+    pin: string;
+    gymSlug?: string;
+    gymId?: string;
+    rememberMe?: boolean;
+}
+interface SetPinDto {
+    token: string;
+    pin: string;
+    pinConfirm: string;
+}
+interface MemberLoginResponse {
+    accessToken: string;
+    refreshToken: string;
+    member: MemberProfile;
+}
+interface MemberProfile {
+    id: string;
+    gymId: string;
+    clientNumber: string;
+    name: string;
+    phone?: string;
+    email?: string;
+    documentValue?: string;
+    documentType?: string;
+    status: 'active' | 'inactive';
+    pinSet: boolean;
+    lastLoginAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface MemberMembership {
+    contract: {
+        id: string;
+        status: string;
+        startDate: string;
+        endDate: string;
+    };
+    plan: {
+        id: string;
+        name: string;
+        description?: string;
+    };
+    status: 'active' | 'inactive' | 'suspended' | 'cancelled';
+    daysRemaining: number;
+    checkInsRemaining?: number;
+}
+interface MemberCheckIn {
+    id: string;
+    timestamp: string;
+    createdAt: string;
+    contract?: {
+        id: string;
+        planName: string;
+    };
+}
+interface QrTokenResponse {
+    qrToken: string;
+    expiresAt: string;
+}
+interface CheckInResponse {
+    success: boolean;
+    message: string;
+    checkIn: {
+        id: string;
+        gymClientId: string;
+        gymId: string;
+        timestamp: string;
+        createdAt: string;
+    };
+}
+interface CheckInDto {
+    qrToken: string;
+}
 
 interface SubscriptionPlan {
     id: string;
@@ -314,7 +494,7 @@ declare abstract class BaseResource {
 declare class AuthResource extends BaseResource {
     private basePath;
     registerOwner(data: RegisterOwnerDto, options?: RequestOptions): Promise<void>;
-    login(data: LoginDto, options?: RequestOptions): Promise<LoginResponseDto>;
+    login(data: LoginDto, options?: RequestOptions, rememberMe?: boolean): Promise<LoginResponseDto>;
     refreshToken(refreshToken: string, options?: RequestOptions): Promise<LoginResponseDto>;
     verifyEmail(data: VerifyEmailDto, options?: RequestOptions): Promise<{
         success: boolean;
@@ -335,6 +515,25 @@ declare class AuthResource extends BaseResource {
     verifyResetCode(data: VerifyResetCodeDto, options?: RequestOptions): Promise<VerifyResetCodeResponseDto>;
     resetPassword(data: ResetPasswordDto, options?: RequestOptions): Promise<ResetPasswordResponseDto>;
     resendResetCode(data: ResendResetCodeDto, options?: RequestOptions): Promise<ResendResetCodeResponseDto>;
+    /**
+     * Member login with PIN
+     * POST /auth/members/pin/login
+     */
+    memberPinLogin(data: MemberPinLoginDto, options?: RequestOptions): Promise<MemberLoginResponse>;
+    /**
+     * Consume member invite and set initial PIN
+     * POST /auth/members/invite/consume
+     */
+    consumeMemberInvite(data: SetPinDto, options?: RequestOptions): Promise<{
+        success: boolean;
+        message: string;
+        gymSlug?: string;
+    }>;
+    /**
+     * Refresh member access token
+     * POST /auth/members/refresh
+     */
+    refreshMemberToken(refreshToken: string, options?: RequestOptions): Promise<MemberLoginResponse>;
 }
 
 interface UpdateOrganizationDto {
@@ -509,6 +708,15 @@ interface ContractSettings {
     expiringSoonDays?: number;
     gracePeriodDays?: number;
     enableExpirationNotifications?: boolean;
+    installmentsEnabled?: boolean;
+    defaultInstallmentsCount?: number;
+    defaultDownPaymentAmount?: number;
+    allowContractInstallmentOverride?: boolean;
+    allowReminderOverride?: boolean;
+    reminderDaysBeforeDue?: number[];
+    reminderDaysAfterDue?: number[];
+    reminderTemplateCode?: TemplateCode$2;
+    debtAccessPolicy?: 'allow_always' | 'block_overdue';
 }
 /**
  * Update gym inventory settings DTO
@@ -525,6 +733,15 @@ interface UpdateGymContractSettingsDto {
     expiringSoonDays?: number;
     gracePeriodDays?: number;
     enableExpirationNotifications?: boolean;
+    installmentsEnabled?: boolean;
+    defaultInstallmentsCount?: number;
+    defaultDownPaymentAmount?: number;
+    allowContractInstallmentOverride?: boolean;
+    allowReminderOverride?: boolean;
+    reminderDaysBeforeDue?: number[];
+    reminderDaysAfterDue?: number[];
+    reminderTemplateCode?: TemplateCode$2;
+    debtAccessPolicy?: 'allow_always' | 'block_overdue';
 }
 interface Gym {
     id: string;
@@ -781,6 +998,8 @@ interface Client {
     medicalConditions?: string;
     createdAt: string;
     updatedAt: string;
+    pinSet?: boolean;
+    lastLoginAt?: string;
     contracts?: Array<{
         id: string;
         status: string;
@@ -851,6 +1070,44 @@ interface SearchClientsParams {
     includeTags?: boolean;
 }
 
+interface SearchGlobalResult {
+    found: boolean;
+    clientData?: {
+        id: string;
+        name: string;
+        photoUrl?: string;
+        documentValue: string;
+        phone?: string;
+        email?: string;
+        gymId: string;
+        gymName: string;
+        status: 'active' | 'inactive';
+    };
+    contractData?: {
+        id: string;
+        contractNumber: string;
+        planName: string;
+        status: 'active' | 'expired' | 'cancelled' | 'suspended';
+        endDate: string;
+        allowedGymIds: string[];
+    };
+    canAccessCurrentGym: boolean;
+    currentGymAccessStatus?: string;
+}
+interface ImportFromGymResult {
+    localClientId: string;
+    imported: boolean;
+    clientData: {
+        id: string;
+        name: string;
+        photoUrl?: string;
+        documentValue: string;
+        phone?: string;
+        email?: string;
+        birthDate?: string;
+    };
+    message: string;
+}
 declare class ClientsResource extends BaseResource {
     private basePath;
     createClient(data: CreateClientDto, options?: RequestOptions): Promise<Client>;
@@ -863,6 +1120,12 @@ declare class ClientsResource extends BaseResource {
     getClientStatsByCategory(id: string, category: string, options?: RequestOptions): Promise<ClientStat[]>;
     getAvailableStats(options?: RequestOptions): Promise<ClientStat[]>;
     searchClientsForCheckIn(params?: SearchClientsParams, options?: RequestOptions): Promise<Client[]>;
+    searchGlobal(params: {
+        document: string;
+    }, options?: RequestOptions): Promise<SearchGlobalResult>;
+    importFromGym(params: {
+        sourceGymClientId: string;
+    }, options?: RequestOptions): Promise<ImportFromGymResult>;
 }
 
 interface CreateMembershipPlanDto {
@@ -879,6 +1142,7 @@ interface CreateMembershipPlanDto {
     features?: string[];
     status?: 'active' | 'inactive' | 'archived';
     assetsIds?: string[];
+    allowAccessToGymIds?: string[];
 }
 interface UpdateMembershipPlanDto {
     name?: string;
@@ -895,6 +1159,7 @@ interface UpdateMembershipPlanDto {
     status?: 'active' | 'inactive' | 'archived';
     isActive?: boolean;
     assetsIds?: string[];
+    allowAccessToGymIds?: string[];
 }
 interface MembershipPlan {
     id: string;
@@ -920,6 +1185,7 @@ interface MembershipPlan {
     status: 'active' | 'inactive' | 'archived';
     isActive: boolean;
     assetsIds?: string[];
+    allowAccessToGymIds?: string[];
     createdAt: string;
     updatedAt: string;
     _count?: {
@@ -1016,6 +1282,17 @@ interface CreateContractDto {
     customPrice?: number;
     receiptIds?: string[];
     metadata?: Record<string, any>;
+    paymentPlan?: ContractPaymentPlanInput;
+}
+interface ContractInstallmentScheduleDto {
+    dueDate: string;
+    amount: number;
+}
+interface ContractPaymentPlanInput {
+    installmentsCount?: number;
+    downPaymentAmount?: number;
+    firstDueDate?: string;
+    schedule?: ContractInstallmentScheduleDto[];
 }
 interface RenewContractDto {
     startDate?: string;
@@ -1089,6 +1366,7 @@ interface Contract {
     contractDocumentId?: string | null;
     paymentReceiptIds?: string[] | null;
     receiptIds?: string[];
+    accessGymIds?: string[];
     metadata?: Record<string, any>;
     createdByUserId?: string;
     updatedByUserId?: string | null;
@@ -1150,6 +1428,70 @@ interface Contract {
         email: string;
     };
 }
+interface ContractInstallment {
+    id: string;
+    contractId: string;
+    paymentPlanId: string;
+    installmentNumber: number;
+    dueDate: string;
+    amount: string;
+    paidAmount: string;
+    status: ContractInstallmentStatus;
+    paidAt?: string | null;
+    lastReminderAt?: string | null;
+    createdAt: string;
+    updatedAt: string;
+    deletedAt?: string | null;
+}
+interface ContractPayment {
+    id: string;
+    contractId: string;
+    installmentId?: string | null;
+    paymentMethodId: string;
+    amount: string;
+    paidAt: string;
+    receiptIds?: string[];
+    notes?: string | null;
+    createdByUserId: string;
+    createdAt: string;
+    updatedAt: string;
+    deletedAt?: string | null;
+    paymentMethod?: {
+        id: string;
+        name: string;
+    };
+    installment?: {
+        id: string;
+        installmentNumber: number;
+        dueDate: string;
+    };
+}
+interface ContractInstallmentsResponse {
+    contractId: string;
+    totalAmount: number;
+    totalPaid: number;
+    outstandingAmount: number;
+    nextDueDate?: string | null;
+    installments: ContractInstallment[];
+}
+interface ContractPaymentsResponse {
+    contractId: string;
+    totalPaid: number;
+    payments: ContractPayment[];
+}
+interface RegisterContractPaymentDto {
+    amount: number;
+    paymentMethodId: string;
+    paidAt?: string;
+    receiptIds?: string[];
+    notes?: string;
+    installmentId?: string;
+    applyMode?: 'oldest_due' | 'installment';
+}
+interface RegisterContractPaymentResponse {
+    success: boolean;
+    payments: ContractPayment[];
+}
 interface GetContractsParams extends PaginationQueryDto {
     status?: ContractStatus;
     clientName?: string;
@@ -1197,7 +1539,15 @@ declare class ContractsResource extends BaseResource {
     createContract(data: CreateContractDto, options?: RequestOptions): Promise<Contract>;
     getGymContracts(params?: GetContractsParams, options?: RequestOptions): Promise<PaginatedResponseDto<Contract>>;
     getContract(id: string, options?: RequestOptions): Promise<Contract>;
+    getContractInstallments(id: string, options?: RequestOptions): Promise<ContractInstallmentsResponse>;
+    getContractPayments(id: string, options?: RequestOptions): Promise<ContractPaymentsResponse>;
+    registerContractPayment(id: string, data: RegisterContractPaymentDto, options?: RequestOptions): Promise<RegisterContractPaymentResponse>;
+    sendInstallmentReminder(id: string, installmentId: string, options?: RequestOptions): Promise<{
+        success: boolean;
+        message: string;
+    }>;
     getClientContracts(clientId: string, options?: RequestOptions): Promise<Contract[]>;
+    getMyContracts(options?: RequestOptions): Promise<Contract[]>;
     renewContract(id: string, data: RenewContractDto, options?: RequestOptions): Promise<Contract>;
     freezeContract(id: string, data: FreezeContractDto, options?: RequestOptions): Promise<Contract>;
     cancelContract(id: string, data: CancelContractDto, options?: RequestOptions): Promise<Contract>;
@@ -1241,11 +1591,20 @@ interface SalesRevenue {
 }
 interface Debts {
     totalDebt: number;
+    salesDebt?: number;
+    contractsDebt?: number;
     clientsWithDebt: number;
     averageDebt: number;
     startDate: string;
     endDate: string;
 }
+interface Collections {
+    totalCollected: number;
+    salesCollected: number;
+    contractsCollected: number;
+    startDate: string;
+    endDate: string;
+}
 interface CheckIns {
     totalCheckIns: number;
     uniqueClients: number;
@@ -1319,6 +1678,12 @@ declare class DashboardResource extends BaseResource {
      * @returns Outstanding debts data for the specified period
      */
     getDebts(params?: DateRangeParams): Promise<Debts>;
+    /**
+     * Get total collections within date range
+     * @param params Optional date range parameters
+     * @returns Collections data for the specified period
+     */
+    getCollections(params?: DateRangeParams): Promise<Collections>;
     /**
      * Get check-ins count within date range
      * @param params Optional date range parameters
@@ -1415,6 +1780,20 @@ interface ClientCheckInHistory {
     };
 }
 
+interface ExternalCheckInResult {
+    checkInId: string;
+    clientName: string;
+    gymName: string;
+    timestamp: string;
+    message: string;
+    isExternal: boolean;
+    contractNumber?: string;
+    originGymName?: string;
+}
+interface CreateExternalCheckInDto {
+    documentValue: string;
+    sourceGymClientId?: string;
+}
 declare class CheckInsResource extends BaseResource {
     private basePath;
     /**
@@ -1456,6 +1835,19 @@ declare class CheckInsResource extends BaseResource {
     deleteCheckIn(id: string, options?: RequestOptions): Promise<void>;
     getGymCheckInStats(params: GetCheckInStatsParams, options?: RequestOptions): Promise<CheckInStats>;
     getClientCheckInHistory(clientId: string, params?: GetClientCheckInHistoryParams, options?: RequestOptions): Promise<ClientCheckInHistory>;
+    /**
+     * Creates a check-in for an external client (from another gym in the same organization).
+     *
+     * **Permissions Required:**
+     * - Gym owners with full gym access
+     * - Active collaborators with CHECKINS_CREATE permission
+     *
+     * @param data - The external check-in data including document value
+     * @param options - Optional request configuration
+     * @returns The created check-in record with external client details
+     * @throws {ValidationError} When client is not found or contract doesn't allow access
+     */
+    createExternal(data: CreateExternalCheckInDto, options?: RequestOptions): Promise<ExternalCheckInResult>;
 }
 
 interface GetGymInvitationsParams {
@@ -3957,10 +4349,6 @@ declare class MessagesResource extends BaseResource {
     cancelMessage(id: string, options?: RequestOptions): Promise<Message>;
 }
 
-declare enum FeatureType {
-    AI_GENERATION = "ai_generation",
-    BULK_WHATSAPP = "bulk_whatsapp"
-}
 interface CreditAccount {
     id: string;
     organizationId: string;
@@ -4245,6 +4633,118 @@ declare class PromoCodesResource extends BaseResource {
     deletePromoCode(id: string, options?: RequestOptions): Promise<void>;
 }
 
+declare class MembersResource extends BaseResource {
+    /**
+     * Create and send member invite
+     * POST /admin/members/clients/:id/invites
+     */
+    createInvite(clientId: string, data: CreateMemberInviteDto, options?: RequestOptions): Promise<MemberInviteResponse>;
+    /**
+     * Validate member invite token
+     * GET /members/invites/validate/:token
+     */
+    validateInvite(token: string, options?: RequestOptions): Promise<MemberInviteValidationResponse>;
+    /**
+     * Generate QR token for member check-ins
+     * GET /admin/members/check-in-qr
+     */
+    generateQrToken(options?: RequestOptions): Promise<QrTokenResponse>;
+    /**
+     * Self check-in with QR token
+     * POST /members/checkins
+     */
+    checkIn(data: CheckInDto, options?: RequestOptions): Promise<CheckInResponse>;
+}
+
+interface ReceivableInstallmentDto {
+    id: string;
+    contractId: string;
+    contractNumber: string;
+    clientId: string;
+    clientName: string;
+    clientDocument?: string;
+    gymId: string;
+    gymName: string;
+    amount: number;
+    paidAmount: number;
+    remainingAmount: number;
+    dueDate: string;
+    status: 'pending' | 'partially_paid' | 'overdue';
+    planName: string;
+    contractStartDate: string;
+    contractEndDate: string;
+}
+interface ReceivableInstallmentsResponseDto {
+    data: ReceivableInstallmentDto[];
+    meta: ReceivablesMetaDto;
+    summary: ReceivablesSummaryDto;
+}
+interface ReceivableSaleDto {
+    id: string;
+    saleNumber: string;
+    clientId: string;
+    clientName: string;
+    clientDocument?: string;
+    gymId: string;
+    gymName: string;
+    total: number;
+    paidAmount: number;
+    remainingAmount: number;
+    saleDate: string;
+    paymentStatus: 'unpaid' | 'partially_paid';
+    products: string[];
+}
+interface ReceivableSalesResponseDto {
+    data: ReceivableSaleDto[];
+    meta: ReceivablesMetaDto;
+    summary: ReceivablesSummaryDto;
+}
+interface ReceivablesMetaDto {
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+    hasNext: boolean;
+    hasPrevious: boolean;
+}
+interface ReceivablesSummaryDto {
+    totalAmount: number;
+    totalPending: number;
+}
+interface ReceivableInstallmentsQueryParams {
+    scope?: 'gym' | 'organization';
+    startDate?: string;
+    endDate?: string;
+    page?: number;
+    limit?: number;
+    status?: 'pending' | 'partially_paid' | 'overdue' | 'all_unpaid';
+    sortBy?: 'dueDate' | 'amount' | 'clientName';
+    sortOrder?: 'asc' | 'desc';
+}
+interface ReceivableSalesQueryParams {
+    scope?: 'gym' | 'organization';
+    startDate?: string;
+    endDate?: string;
+    page?: number;
+    limit?: number;
+    sortBy?: 'saleDate' | 'amount' | 'clientName';
+    sortOrder?: 'asc' | 'desc';
+}
+declare class ReceivablesResource extends BaseResource {
+    /**
+     * Get paginated list of pending contract installments with filtering, sorting, and organization scope support.
+     * @param params Optional query parameters for filtering, pagination, and sorting
+     * @returns Paginated list of installment receivables with summary
+     */
+    getInstallmentReceivables(params?: ReceivableInstallmentsQueryParams): Promise<ReceivableInstallmentsResponseDto>;
+    /**
+     * Get paginated list of unpaid sales with filtering, sorting, and organization scope support.
+     * @param params Optional query parameters for filtering, pagination, and sorting
+     * @returns Paginated list of sale receivables with summary
+     */
+    getSaleReceivables(params?: ReceivableSalesQueryParams): Promise<ReceivableSalesResponseDto>;
+}
+
 declare class GymSpaceSdk {
     client: ApiClient;
     private expoFetch?;
@@ -4287,6 +4787,8 @@ declare class GymSpaceSdk {
     credits: CreditsResource;
     pricingPackages: PricingPackagesResource;
     promoCodes: PromoCodesResource;
+    members: MembersResource;
+    receivables: ReceivablesResource;
     constructor(config: GymSpaceConfig);
     /**
      * Set the authentication token
@@ -4327,6 +4829,15 @@ declare class GymSpaceSdk {
      * Get the underlying API client
      */
     getClient(): ApiClient;
+    /**
+     * Create a scoped SDK instance that sends X-Gym-Id and X-Gym-Context-Mode: scoped
+     * for all requests WITHOUT modifying the global gym context.
+     *
+     * Usage:
+     *   const scopedSdk = sdk.withGymId('gym-123');
+     *   const sales = await scopedSdk.sales.searchSales({ ... });
+     */
+    withGymId(gymId: string): GymSpaceSdk;
 }
 
 interface ApiResponse<T> {
@@ -4334,26 +4845,4 @@ interface ApiResponse<T> {
     meta?: any;
 }
 
-declare class GymSpaceError extends Error {
-    statusCode?: number;
-    code?: string;
-    details?: any;
-    constructor(message: string, statusCode?: number, code?: string, details?: any);
-}
-declare class AuthenticationError extends GymSpaceError {
-    constructor(message?: string);
-}
-declare class AuthorizationError extends GymSpaceError {
-    constructor(message?: string);
-}
-declare class NotFoundError extends GymSpaceError {
-    constructor(resource: string, id?: string);
-}
-declare class ValidationError extends GymSpaceError {
-    constructor(message: string, errors?: any);
-}
-declare class NetworkError extends GymSpaceError {
-    constructor(message?: string);
-}
-
-export { type ActivateRenewalDto, ActivitiesResource, type Activity, type ActivityNotificationDto, type ActivityPlanRestriction, type ActivityStats, type ActivityStatsParams, AdminCatalogResource, AdminSubscriptionManagementResource, type AdminSubscriptionStatusDto, type AffiliateOrganizationDto, type Amenities, ApiClient, type ApiResponse, type AssetResponseDto, AssetsResource, type AssignTagsDto, type AssignTagsResponse, AuthResource, AuthenticationError, AuthorizationError, type AvailablePlanDto, type BulkLogsResponse, type BulkLogsResponseDto, type BulkMessageDto, type BulkMessageLog, type BulkMessageLogDto, type BulkMessageResult, type BulkMessageResultDto, BulkMessagingResource, type BulkTemplate, type BusinessHours, type CancelContractDto, type CancelSubscriptionDto, type CancellationAnalytics, type CatalogActivity, type CatalogGym, type CatalogHeroSection, type CatalogLead, type CatalogLocation, type CatalogPlan, type CatalogResponse, type CatalogSocialMedia, type ChangePasswordDto, type ChangePasswordResponseDto, type CheckIn, type CheckInDetail, type CheckInListResponse, type CheckInStats, type CheckInSystemFeatures, type CheckIns, type CheckInsList, CheckInsResource, type CheckLimitResponse, type CityWithGyms, type Client, type ClientCheckInHistory, type ClientManagementFeatures, type ClientStat, type ClientStats, type ClientTag, type ClientTagsResponse, ClientsResource, type CollaboratorReportDto, type CollaboratorRoleDto, CollaboratorsResource, type CommissionCalculationDto, CommissionCalculationsResource, CommissionChangeType, type CommissionComparisonDto, type CommissionConfigDto, CommissionConfigResource, CommissionEntityType, type CommissionFiltersDto, type CommissionHistoryDto, type CommissionHistoryFiltersDto, CommissionPromotionsResource, CommissionReportsResource, type CommissionRuleDto, type CommissionRuleFiltersDto, CommissionRuleType, CommissionRulesResource, type CommissionSimulationDto, CommissionStatus, type CommissionSummaryDto, type CommissionSummaryReportDto, type CompleteGuidedSetupData, type ConfigureFeaturesData, type ConnectionStatusResponse, type Contact, type Contract, type ContractLifecycleEvent, type ContractSettings, ContractsResource, type ContractsRevenue, type CreateActivityDto, type CreateActivityNotificationDto, type CreateBulkTemplateDto, type CreateCheckInDto, type CreateClientDto, type CreateCommissionConfigDto, type CreateCommissionRuleDto, type CreateContractDto, type CreateGymDto, type CreateLeadDto, type CreateMembershipPlanDto, type CreatePaymentMethodDto, type CreatePricingPackageDto, type CreateProductCategoryDto, type CreateProductDto, type CreatePromoCodeDto, type CreateSaleDto, type CreateServiceDto, type CreateSubscriptionPlanDto, type CreateSupplierDto, type CreateTagDto, type CreateTemplateDto, type CreateWhatsAppConfigDto, type CreditAccount, type CreditAccountWithOrgName, type CreditAdjustment, type CreditAdjustmentResponse, type CreditStats, type CreditTransaction, type CreditUsageReport, type CreditUsageReportQuery, CreditsResource, type CurrentSessionResponse, type CurrentlyInGymResponse, type CustomerSalesReport, DashboardResource, type DashboardStats, type DateRangeParams, type DaySchedule, type Debts, type DeleteActivityParams, type DeleteTagResponse, type DisconnectResponse, DiscountType, type EligibleClient, type EligibleClientsResponse, type ExpiringContract, FeatureType, type FileResponseDto, FilesResource, type FormattedSchedule, type FreezeContractDto, type GenerateAIMessageDto, type GenerateAIMessageParams, type GenerateAIMessageResponse, type GenerateAIMessageResponseDto, type GetBulkLogsQueryDto, type GetCheckInStatsParams, type GetClientCheckInHistoryParams, type GetContractsParams, type GetGymInvitationsParams, type GetMembershipPlansParams, type GetMessagesParams, type GetTagClientsParams, type Gym, type GymAmenities, type GymCatalog, type GymSchedule, type GymSettings, type GymSocialMedia, type GymSpaceConfig, GymSpaceError, GymSpaceSdk, type GymStats, GymsResource, HealthResource, type HealthResponse, type InitializeConnectionResponse, type InventorySettings, type InvitationValidationResponse, InvitationsResource, type LeadFiltersDto, LeadGender, type LeadSubmissionResponse, type ListContactsResponse, type LoginDto, type LoginResponseDto, type MembershipManagementFeatures, type MembershipPlan, type MembershipPlanStats, MembershipPlansResource, type Message, type MessageStatusUpdate, MessagesResource, type MyOrganization, NetworkError, type NewClients, NotFoundError, type NotificationSettings, OnboardingCacheStatus, OnboardingResource, type OnboardingResponse, type OnboardingStatus, type OnboardingStatusResponse, OnboardingStep, type Organization, type OrganizationAdminDetails, type OrganizationStats, type OrganizationWithDetails, OrganizationsResource, type PaginatedCommissionResult, type PaginatedResponse, type PaginatedResponseDto, type PaginationParams, type PaginationQueryDto, type PaySaleDto, type PaymentMethod, type PaymentMethodStats, PaymentMethodsResource, type PermissionsGroup, type PreviewTemplateResponse, type PriceDto, type PricingDto, type PricingPackage, PricingPackagesResource, type Product, type ProductCategory, ProductsResource, type PromoCode, type PromoCodeAnalytics, PromoCodesResource, type PromotionReportDto, type PromotionReportFiltersDto, PublicCatalogResource, type ReactivateContractDto, type ReadyResponse, type RegisterCollaboratorDto, type RegisterOwnerDto, type RejectedClient, type RejectedClientDto, type RemoveTagsDto, type RemoveTagsResponse, type RenewContractDto, type ReorderCommissionRulesDto, type ReportFiltersDto, type RequestOptions, type RequestPasswordResetDto, type RequestPasswordResetResponseDto, type ResendResetCodeDto, type ResendResetCodeResponseDto, type ResendVerificationDto, type ResetPasswordDto, type ResetPasswordResponseDto, type ResumeContractDto, RolesResource, type RuleCriteria, type RuleReportDto, type Sale, type SaleItem, type SaleItemDto, SalesResource, type SalesRevenue, type SalesStats, type SearchActivitiesParams, type SearchCatalogParams, type SearchCatalogResponse, type SearchCheckInsParams, type SearchClientsParams, type SearchPaymentMethodsParams, type SearchPricingPackagesParams, type SearchProductsParams, type SearchPromoCodesParams, type SearchSalesParams, type SearchSuppliersParams, type SearchTagsParams, type SearchTemplatesDto, type SearchWhatsAppMessagesDto, type SendBulkMessagesDto, type SendCatalogMessageDto, type SendCatalogMessageResponse, type SendWhatsAppMessageDto, type SentActivityNotification, type SimulateCommissionDto, type SocialMedia, type StartOnboardingData, type StartOnboardingResponse, type StockMovement, type Subscription, type SubscriptionHistoryDto, type SubscriptionPlan, type SubscriptionPlanDto, SubscriptionPlansResource, type SubscriptionStatusDto, SubscriptionsResource, type Supplier, SuppliersResource, type SuppliersStats, type SuspendContractDto, type SwitchOrganizationDto, type SwitchOrganizationResponse, type Tag, type TagClientsResponse, type TagStatsResponse, type TagWithAssignment, TagsResource, type TimeSlot, type TopSellingProduct, type UpdateActivityDto, type UpdateActivityNotificationDto, type UpdateBulkTemplateDto, type UpdateCatalogConfigDto, type UpdateClientDto, type UpdateCommissionConfigDto, type UpdateCommissionRuleDto, type UpdateGymContractSettingsDto, type UpdateGymDto, type UpdateGymInventorySettingsDto, type UpdateGymScheduleDto, type UpdateGymSettingsData, type UpdateGymSocialMediaDto, type UpdateMembershipPlanDto, type UpdateOrganizationDto, type UpdatePaymentMethodDto, type UpdatePaymentStatusDto, type UpdatePricingPackageDto, type UpdateProductCategoryDto, type UpdateProductDto, type UpdateProfileDto, type UpdatePromoCodeDto, type UpdateSaleDto, type UpdateStockDto, type UpdateSubscriptionPlanDto, type UpdateSupplierDto, type UpdateTagDto, type UpdateTemplateDto, type UpdateWhatsAppConfigDto, type UpgradeSubscriptionDto, type UploadAssetDto, type UploadFileDto, type UserProfileDto, UsersResource, type ValidatePromoCodeDto, type ValidatePromoCodeResponseDto, ValidationError, type VerifyEmailDto, type VerifyResetCodeDto, type VerifyResetCodeResponseDto, type WeeklySchedule, type WhatsAppConfig, type WhatsAppMessage, WhatsAppResource, type WhatsAppTemplate, WhatsAppTemplatesResource };
+export { type ActivateRenewalDto, ActivitiesResource, type Activity, type ActivityNotificationDto, type ActivityPlanRestriction, type ActivityStats, type ActivityStatsParams, AdminCatalogResource, AdminSubscriptionManagementResource, type AdminSubscriptionStatusDto, type AffiliateOrganizationDto, type Amenities, ApiClient, type ApiResponse, type AssetResponseDto, AssetsResource, type AssignTagsDto, type AssignTagsResponse, AuthResource, AuthenticationError, AuthorizationError, type AvailablePlanDto, type BulkLogsResponse, type BulkLogsResponseDto, type BulkMessageDto, type BulkMessageLog, type BulkMessageLogDto, type BulkMessageResult, type BulkMessageResultDto, BulkMessagingResource, type BulkTemplate, type BusinessHours, type CancelContractDto, type CancelSubscriptionDto, type CancellationAnalytics, type CatalogActivity, type CatalogGym, type CatalogHeroSection, type CatalogLead, type CatalogLocation, type CatalogPlan, type CatalogResponse, type CatalogSocialMedia, type ChangePasswordDto, type ChangePasswordResponseDto, type CheckIn, type CheckInDetail, type CheckInDto, type CheckInListResponse, type CheckInResponse, type CheckInStats, type CheckInSystemFeatures, type CheckIns, type CheckInsList, CheckInsResource, type CheckLimitResponse, type CityWithGyms, type Client, type ClientCheckInHistory, type ClientManagementFeatures, type ClientStat, type ClientStats, type ClientTag, type ClientTagsResponse, ClientsResource, type CollaboratorReportDto, type CollaboratorRoleDto, CollaboratorsResource, type Collections, type CommissionCalculationDto, CommissionCalculationsResource, CommissionChangeType, type CommissionComparisonDto, type CommissionConfigDto, CommissionConfigResource, CommissionEntityType, type CommissionFiltersDto, type CommissionHistoryDto, type CommissionHistoryFiltersDto, CommissionPromotionsResource, CommissionReportsResource, type CommissionRuleDto, type CommissionRuleFiltersDto, CommissionRuleType, CommissionRulesResource, type CommissionSimulationDto, CommissionStatus, type CommissionSummaryDto, type CommissionSummaryReportDto, type CompleteGuidedSetupData, type ConfigureFeaturesData, type ConnectionStatusResponse, type Contact, type Contract, type ContractInstallment, type ContractInstallmentScheduleDto, type ContractInstallmentsResponse, type ContractLifecycleEvent, type ContractPayment, type ContractPaymentPlanInput, type ContractPaymentsResponse, type ContractSettings, ContractsResource, type ContractsRevenue, type CreateActivityDto, type CreateActivityNotificationDto, type CreateBulkTemplateDto, type CreateCheckInDto, type CreateClientDto, type CreateCommissionConfigDto, type CreateCommissionRuleDto, type CreateContractDto, type CreateExternalCheckInDto, type CreateGymDto, type CreateLeadDto, type CreateMemberInviteDto, type CreateMembershipPlanDto, type CreatePaymentMethodDto, type CreatePricingPackageDto, type CreateProductCategoryDto, type CreateProductDto, type CreatePromoCodeDto, type CreateSaleDto, type CreateServiceDto, type CreateSubscriptionPlanDto, type CreateSupplierDto, type CreateTagDto, type CreateTemplateDto, type CreateWhatsAppConfigDto, type CreditAccount, type CreditAccountWithOrgName, type CreditAdjustment, type CreditAdjustmentResponse, type CreditStats, type CreditTransaction, type CreditUsageReport, type CreditUsageReportQuery, CreditsResource, type CurrentSessionBase, type CurrentSessionResponse, type CurrentSessionResponseLegacy, type CurrentlyInGymResponse, type CustomerSalesReport, DashboardResource, type DashboardStats, type DateRangeParams, type DaySchedule, type Debts, type DeleteActivityParams, type DeleteTagResponse, type DisconnectResponse, DiscountType, type EligibleClient, type EligibleClientsResponse, type ExpiringContract, type ExternalCheckInResult, type FileResponseDto, FilesResource, type FormattedSchedule, type FreezeContractDto, type GenerateAIMessageDto, type GenerateAIMessageParams, type GenerateAIMessageResponse, type GenerateAIMessageResponseDto, type GetBulkLogsQueryDto, type GetCheckInStatsParams, type GetClientCheckInHistoryParams, type GetContractsParams, type GetGymInvitationsParams, type GetMembershipPlansParams, type GetMessagesParams, type GetTagClientsParams, type Gym, type GymAmenities, type GymCatalog, type GymSchedule, type GymSettings, type GymSocialMedia, type GymSpaceConfig, GymSpaceError, GymSpaceSdk, type GymStats, GymsResource, HealthResource, type HealthResponse, type ImportFromGymResult, type InitializeConnectionResponse, type InventorySettings, type InvitationValidationResponse, InvitationsResource, type LeadFiltersDto, LeadGender, type LeadSubmissionResponse, type ListContactsResponse, type LoginDto, type LoginResponseDto, type MemberCheckIn, type MemberInvite, type MemberInviteResponse, type MemberInviteValidationResponse, type MemberLoginResponse, type MemberMembership, type MemberPinLoginDto, type MemberProfile, MembersResource, type MembershipManagementFeatures, type MembershipPlan, type MembershipPlanStats, MembershipPlansResource, type Message, type MessageStatusUpdate, MessagesResource, type MyOrganization, NetworkError, type NewClients, NotFoundError, type NotificationSettings, OnboardingCacheStatus, OnboardingResource, type OnboardingResponse, type OnboardingStatus, type OnboardingStatusResponse, OnboardingStep, type Organization, type OrganizationAdminDetails, type OrganizationStats, type OrganizationWithDetails, OrganizationsResource, type PaginatedCommissionResult, type PaginatedResponse, type PaginatedResponseDto, type PaginationParams, type PaginationQueryDto, type PaySaleDto, type PaymentMethod, type PaymentMethodStats, PaymentMethodsResource, type PermissionsGroup, type PreviewTemplateResponse, type PriceDto, type PricingDto, type PricingPackage, PricingPackagesResource, type Product, type ProductCategory, ProductsResource, type PromoCode, type PromoCodeAnalytics, PromoCodesResource, type PromotionReportDto, type PromotionReportFiltersDto, PublicCatalogResource, type QrTokenResponse, type ReactivateContractDto, type ReadyResponse, type ReceivableInstallmentDto, type ReceivableInstallmentsQueryParams, type ReceivableInstallmentsResponseDto, type ReceivableSaleDto, type ReceivableSalesQueryParams, type ReceivableSalesResponseDto, type ReceivablesMetaDto, ReceivablesResource, type ReceivablesSummaryDto, type RegisterCollaboratorDto, type RegisterContractPaymentDto, type RegisterContractPaymentResponse, type RegisterOwnerDto, type RejectedClient, type RejectedClientDto, type RemoveTagsDto, type RemoveTagsResponse, type RenewContractDto, type ReorderCommissionRulesDto, type ReportFiltersDto, type RequestOptions, type RequestPasswordResetDto, type RequestPasswordResetResponseDto, type ResendResetCodeDto, type ResendResetCodeResponseDto, type ResendVerificationDto, type ResetPasswordDto, type ResetPasswordResponseDto, type ResumeContractDto, RolesResource, type RuleCriteria, type RuleReportDto, type Sale, type SaleItem, type SaleItemDto, SalesResource, type SalesRevenue, type SalesStats, type SearchActivitiesParams, type SearchCatalogParams, type SearchCatalogResponse, type SearchCheckInsParams, type SearchClientsParams, type SearchGlobalResult, type SearchPaymentMethodsParams, type SearchPricingPackagesParams, type SearchProductsParams, type SearchPromoCodesParams, type SearchSalesParams, type SearchSuppliersParams, type SearchTagsParams, type SearchTemplatesDto, type SearchWhatsAppMessagesDto, type SendBulkMessagesDto, type SendCatalogMessageDto, type SendCatalogMessageResponse, type SendWhatsAppMessageDto, type SentActivityNotification, type SetPinDto, type SimulateCommissionDto, type SocialMedia, type StartOnboardingData, type StartOnboardingResponse, type StockMovement, type Subscription, type SubscriptionHistoryDto, type SubscriptionPlan, type SubscriptionPlanDto, SubscriptionPlansResource, type SubscriptionStatusDto, SubscriptionsResource, type Supplier, SuppliersResource, type SuppliersStats, type SuspendContractDto, type SwitchOrganizationDto, type SwitchOrganizationResponse, type Tag, type TagClientsResponse, type TagStatsResponse, type TagWithAssignment, TagsResource, type TimeSlot, type TopSellingProduct, type UpdateActivityDto, type UpdateActivityNotificationDto, type UpdateBulkTemplateDto, type UpdateCatalogConfigDto, type UpdateClientDto, type UpdateCommissionConfigDto, type UpdateCommissionRuleDto, type UpdateGymContractSettingsDto, type UpdateGymDto, type UpdateGymInventorySettingsDto, type UpdateGymScheduleDto, type UpdateGymSettingsData, type UpdateGymSocialMediaDto, type UpdateMembershipPlanDto, type UpdateOrganizationDto, type UpdatePaymentMethodDto, type UpdatePaymentStatusDto, type UpdatePricingPackageDto, type UpdateProductCategoryDto, type UpdateProductDto, type UpdateProfileDto, type UpdatePromoCodeDto, type UpdateSaleDto, type UpdateStockDto, type UpdateSubscriptionPlanDto, type UpdateSupplierDto, type UpdateTagDto, type UpdateTemplateDto, type UpdateWhatsAppConfigDto, type UpgradeSubscriptionDto, type UploadAssetDto, type UploadFileDto, type UserProfileDto, UsersResource, type ValidatePromoCodeDto, type ValidatePromoCodeResponseDto, ValidationError, type VerifyEmailDto, type VerifyResetCodeDto, type VerifyResetCodeResponseDto, type WeeklySchedule, type WhatsAppConfig, type WhatsAppMessage, WhatsAppResource, type WhatsAppTemplate, WhatsAppTemplatesResource };