import { createHttpClient } from './lib/fetch' import { Session, AuthError } from './lib/types' import { ValidatedApiClient } from './lib/validated-client' import { SessionManager } from './lib/session-manager' import * as Types from './types/admin-api' import * as Schemas from './schemas/admin-api.schemas' /** Admin API client - handles administrative operations */ export class AdminApi { private api: ValidatedApiClient private sessionManager: SessionManager constructor(baseURL: string, config: any, sessionManager?: SessionManager) { this.sessionManager = sessionManager ?? new SessionManager({ authBaseURL: config.authBaseURL, apiKey: config.apiKey, headers: config.headers, autoRefreshToken: config.autoRefreshToken, persistSession: config.persistSession, storage: config.storage, storageKey: config.storageKey, crossTabRefreshLock: config.crossTabRefreshLock, refreshLockKey: config.refreshLockKey, debug: config.debug, timeout: config.timeout, onSessionRefreshed: config.onSessionRefreshed }) this.api = new ValidatedApiClient({ refreshTokenFn: async () => (await this.sessionManager.refreshSession()) !== null, baseURL, ...config }) this.sessionManager.registerTokenConsumer((token) => { this.api.setAuth(token) }) queueMicrotask(() => { void this.sessionManager.initialize() }) } /** Get current access token */ async getToken(): Promise { return this.sessionManager.getAccessToken() } /** Check if admin client is authenticated */ async isAuthenticated(): Promise { return this.sessionManager.hasSession() } /** Get current session */ async getSession(): Promise { return this.sessionManager.getSession() } // SAML SSO Management async createSAMLProvider(provider: Types.CreateSAMLProviderRequest): Promise { const { data, error } = await this.api.postWithValidation( '/saml/providers', provider, Schemas.CreateSAMLProviderRequestSchema, Schemas.SAMLProviderResponseSchema ) if (error || !data) { return Promise.reject(error || { message: 'No data returned', key: 'no_data' }) } return data } async listSAMLProviders(): Promise { const { data, error } = await this.api.getWithValidation( '/saml/providers', Schemas.ListSAMLProvidersResponseSchema ) if (error || !data) { return Promise.reject(error || { message: 'No data returned', key: 'no_data' }) } return data } async getSAMLProvider(id: string): Promise { const { data, error } = await this.api.getWithValidation( `/saml/providers/${id}`, Schemas.SAMLProviderResponseSchema ) if (error || !data) { return Promise.reject(error || { message: 'No data returned', key: 'no_data' }) } return data } async updateSAMLProvider(id: string, provider: Types.UpdateSAMLProviderRequest): Promise { const { data, error } = await this.api.putWithValidation( `/saml/providers/${id}`, provider, Schemas.UpdateSAMLProviderRequestSchema, Schemas.SAMLProviderResponseSchema ) if (error || !data) { return Promise.reject(error || { message: 'No data returned', key: 'no_data' }) } return data } async deleteSAMLProvider(id: string): Promise { const { error } = await this.api.delete(`/saml/providers/${id}`) if (error) { return Promise.reject(error) } } async testSAMLProvider(id: string): Promise { const { error } = await this.api.post(`/saml/providers/${id}/test`, {}) if (error) { return Promise.reject(error) } } // User Management /** * Query users with filters, sorting, and pagination * @param params Query parameters (filters, sort, pagination) */ async queryUsers(params?: { filters?: Record sort?: string[] pagination?: { page?: number pageSize?: number } }): Promise { const { data, error } = await this.api.post('/users/query', params || {}) if (error || !data) { return Promise.reject(error || { message: 'No data returned', key: 'no_data' }) } return data } /** * @deprecated Use queryUsers() instead * List all users (simple query without filters) */ async listUsers(): Promise { return this.queryUsers({}) } async getUser(id: string): Promise { const { data, error } = await this.api.getWithValidation( `/users/${id}`, Schemas.AdminUserResponseSchema ) if (error || !data) { return Promise.reject(error || { message: 'No data returned', key: 'no_data' }) } return data } async updateUser(id: string, updates: Types.AdminUpdateUserRequest): Promise { const { data, error } = await this.api.putWithValidation( `/users/${id}`, updates, Schemas.AdminUpdateUserRequestSchema, Schemas.AdminUserResponseSchema ) if (error || !data) { return Promise.reject(error || { message: 'No data returned', key: 'no_data' }) } return data } async deleteUser(id: string): Promise { const { error } = await this.api.delete(`/users/${id}`) if (error) { return Promise.reject(error) } } async createUser(userData: Types.AdminCreateUserRequest): Promise { const { data, error } = await this.api.postWithValidation( '/users', userData, Schemas.AdminCreateUserRequestSchema, Schemas.AdminUserResponseSchema ) if (error || !data) { return Promise.reject(error || { message: 'No data returned', key: 'no_data' }) } return data } async resetUserPassword(userId: string, passwordData: Types.AdminResetPasswordRequest): Promise { const { error } = await this.api.postWithValidation( `/users/${userId}/reset-password`, passwordData, Schemas.AdminResetPasswordRequestSchema ) if (error) { return Promise.reject(error) } } async setUserEmailConfirmed(userId: string, confirmed: boolean): Promise { const { error } = await this.api.put(`/users/${userId}/email-confirmed`, { confirmed }) if (error) { return Promise.reject(error) } } async setUserPhoneConfirmed(userId: string, confirmed: boolean): Promise { const { error } = await this.api.put(`/users/${userId}/phone-confirmed`, { confirmed }) if (error) { return Promise.reject(error) } } // Session Management async listAllSessions(): Promise { const { data, error } = await this.api.getWithValidation( '/sessions', Schemas.ListSessionsResponseSchema ) if (error || !data) { return Promise.reject(error || { message: 'No data returned', key: 'no_data' }) } return data } async listUserSessions(userId: string): Promise { const { data, error } = await this.api.getWithValidation( `/users/${userId}/sessions`, Schemas.ListSessionsResponseSchema ) if (error || !data) { return Promise.reject(error || { message: 'No data returned', key: 'no_data' }) } return data } async revokeSession(sessionId: string): Promise { const { error } = await this.api.delete(`/sessions/${sessionId}`) if (error) { return Promise.reject(error) } } async revokeAllUserSessions(userId: string): Promise { const { error } = await this.api.delete(`/users/${userId}/sessions`) if (error) { return Promise.reject(error) } } // Identity Management async listUserIdentities(userId: string): Promise { const { data, error } = await this.api.get(`/users/${userId}/identities`) if (error || !data) { return Promise.reject(error || { message: 'No data returned', key: 'no_data' }) } return data } async deleteUserIdentity(userId: string, identityId: string): Promise { const { error } = await this.api.delete(`/users/${userId}/identities/${identityId}`) if (error) { return Promise.reject(error) } } // System Stats async getUserCount(): Promise { const { data, error } = await this.api.getWithValidation( '/stats/users', Schemas.StatsResponseSchema ) if (error || !data) { return Promise.reject(error || { message: 'No data returned', key: 'no_data' }) } return data } async getActiveSessionCount(): Promise { const { data, error } = await this.api.getWithValidation( '/stats/sessions', Schemas.SessionStatsResponseSchema ) if (error || !data) { return Promise.reject(error || { message: 'No data returned', key: 'no_data' }) } return data } async getRecentSignups(): Promise { const { data, error } = await this.api.get('/stats/recent-signups') if (error || !data) { return Promise.reject(error || { message: 'No data returned', key: 'no_data' }) } return data } async getRecentSignins(): Promise { const { data, error } = await this.api.get('/stats/recent-signins') if (error || !data) { return Promise.reject(error || { message: 'No data returned', key: 'no_data' }) } return data } /** * Get instance configuration */ async getInstanceConfig(): Promise<{ data: Types.GetInstanceConfigResponse | null; error: AuthError | null }> { return this.api.get('/config') } /** * Update instance configuration */ async updateInstanceConfig(config: any) { return this.api.put('/config', { config }) } }