/** * Admin user management service. * Orchestrates user repository access, email decryption, and wallet balances for admin APIs. */ import { RoleName } from '../models'; import type { AdminSortBy, UserActivityFilter } from '../repositories/userRepository'; /** Query options for the admin user list. */ export type AdminListUsersOptions = { search?: string; roleName?: RoleName; emailVerified?: boolean; country?: string; inactiveSinceDays?: number; activityFilter?: UserActivityFilter; activityPeriodFrom?: string; activityPeriodTo?: string; minMainBalance?: string; maxMainBalance?: string; minBonusReceived?: string; maxBonusReceived?: string; accountStatus?: 'active' | 'disabled' | 'suspended'; hasReceivedBonus?: boolean; createdFrom?: string; createdTo?: string; minAge?: number; maxAge?: number; totpEnabled?: boolean; underSurveillance?: boolean; sortBy?: AdminSortBy; sortDir?: 'asc' | 'desc'; limit: number; offset?: number; cursor?: string; includeTotal?: boolean; userIds?: string[]; }; /** API-facing user row with decrypted email (admin list). */ export type AdminUserListItem = { id: string; email: string | null; first_name: string | null; middle_name: string | null; last_name: string | null; date_of_birth: string | null; role_id: number; role_name: string; email_verified: boolean; totp_enabled: boolean; is_enabled: boolean; is_account_non_expired: boolean; is_account_non_locked: boolean; is_credentials_non_expired: boolean; country_of_residence: string | null; nationality: string | null; referral_code: string | null; first_deposit_at: Date | null; first_deposit_transaction_id: string | null; withdrawals_suspended: boolean; under_surveillance: boolean; security_suspended_at: Date | null; created_at: Date; updated_at: Date; main_balance_raw: string; bonus_balance_raw: string; total_bonus_received_raw: string; prediction_count: number; total_stake_raw: string; total_payout_raw: string; net_pnl_raw: string; last_login_at: Date | null; last_activity_at: Date; account_status: 'active' | 'disabled' | 'suspended'; }; /** Account flags accepted from the admin API (camelCase). */ export type AdminAccountFlagsInput = { isEnabled?: boolean; isAccountNonExpired?: boolean; isAccountNonLocked?: boolean; isCredentialsNonExpired?: boolean; }; export type BatchOperationResult = { succeeded: string[]; failed: Array<{ userId: string; error: string; }>; }; /** * Lists users for the admin panel with decrypted emails and aggregated stats. */ export declare function listUsers(options: AdminListUsersOptions): Promise<{ users: AdminUserListItem[]; total: number | null; totalIsExact: boolean; nextCursor: string | null; hasMore: boolean; }>; export declare function updateUserAccountFlags(userId: string, flags: AdminAccountFlagsInput, actor?: { adminUserId: string; ipAddress?: string; userAgent?: string; }): Promise; export declare function batchUpdateUserAccountFlags(userIds: string[], flags: AdminAccountFlagsInput, actor?: { adminUserId: string; ipAddress?: string; userAgent?: string; }): Promise; export declare function batchUpdateUserSecurity(userIds: string[], body: { withdrawalsSuspended?: boolean; underSurveillance?: boolean; reactivateWithdrawals?: boolean; reason?: string; }, actor?: { adminUserId: string; ipAddress?: string; userAgent?: string; }): Promise; export declare function batchGrantLedgerCredit(userIds: string[], input: { walletTypeId: number; adjustmentType: 'bonus' | 'admin_adjustment'; amountRaw: string; reason: string; }, requestedBy: string): Promise; /** * Marks a user's email as verified (admin support action). */ export declare function markUserEmailVerified(userId: string, adminUserId: string): Promise<{ message: string; emailVerified: boolean; }>; export declare function deleteUser(targetUserId: string, adminUserId: string, opts?: { reason?: string; ipAddress?: string; userAgent?: string; }): Promise<{ message: string; }>; /** * Loads full admin user details including wallet balances. */ export declare function getUserDetails(userId: string): Promise<{ user: { id: string; email: string | null; role_id: number; role_name: string; roles: UserRoleName[]; email_verified: boolean; totp_enabled: boolean; is_enabled: boolean; is_account_non_expired: boolean; is_account_non_locked: boolean; is_credentials_non_expired: boolean; withdrawals_suspended: boolean; under_surveillance: boolean; security_suspended_at: Date | null; created_at: Date; }; balances: Array<{ wallet_type: string; wallet_name: string; available: string; locked: string; }>; }>; export type UserRoleName = 'user' | 'moderator' | 'admin' | 'super_admin'; export declare function updateUserRole(targetUserId: string, role: UserRoleName, adminUserId: string, notifyCtx?: { ipAddress?: string; userAgent?: string; }): Promise<{ userId: string; role: UserRoleName; }>; export declare function updateUserRoles(targetUserId: string, roles: UserRoleName[], adminUserId: string, notifyCtx?: { ipAddress?: string; userAgent?: string; }): Promise<{ userId: string; roles: UserRoleName[]; }>; //# sourceMappingURL=adminService.d.ts.map