settingsPage Init selfhost (#4734)

# Description of Changes  --- ## Checklist ### General - [ ] I have read the [Contribution Guidelines](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/CONTRIBUTING.md) - [ ] I have read the [Stirling-PDF Developer Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/DeveloperGuide.md) (if applicable) - [ ] I have read the [How to add new languages to Stirling-PDF](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/HowToAddNewLanguage.md) (if applicable) - [ ] I have performed a self-review of my own code - [ ] My changes generate no new warnings ### Documentation - [ ] I have updated relevant docs on [Stirling-PDF's doc repo](https://github.com/Stirling-Tools/Stirling-Tools.github.io/blob/main/docs/) (if functionality has heavily changed) - [ ] I have read the section [Add New Translation Tags](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/HowToAddNewLanguage.md#add-new-translation-tags) (for new translation tags only) ### UI Changes (if applicable) - [ ] Screenshots or videos demonstrating the UI changes are attached (e.g., as comments or direct attachments in the PR) ### Testing (if applicable) - [ ] I have tested my changes locally. Refer to the [Testing Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/DeveloperGuide.md#6-testing) for more details. --------- Co-authored-by: James Brunton <[email protected]>
2026-07-15 19:10:47 +02:00 · 2025-10-28 14:47:41 +00:00
parent d2b38ef4b8
commit d0c5d74471
68 changed files with 9133 additions and 282 deletions
@@ -0,0 +1,34 @@
+import apiClient from '@app/services/apiClient';
+
+export interface AccountData {
+  username: string;
+  role: string;
+  settings: string; // JSON string of settings
+  changeCredsFlag: boolean;
+  oAuth2Login: boolean;
+  saml2Login: boolean;
+}
+
+/**
+ * Account Service
+ * Provides functions to interact with account-related backend APIs
+ */
+export const accountService = {
+  /**
+   * Get current user account data
+   */
+  async getAccountData(): Promise<AccountData> {
+    const response = await apiClient.get<AccountData>('/api/v1/proprietary/ui-data/account');
+    return response.data;
+  },
+
+  /**
+   * Change user password
+   */
+  async changePassword(currentPassword: string, newPassword: string): Promise<void> {
+    const formData = new FormData();
+    formData.append('currentPassword', currentPassword);
+    formData.append('newPassword', newPassword);
+    await apiClient.post('/api/v1/user/change-password', formData);
+  },
+};
@@ -88,6 +88,10 @@ const SPECIAL_SUPPRESS_MS = 1500; // brief window to suppress generic duplicate
 * Returns true if the error should be suppressed (deduplicated), false otherwise
 */
 export async function handleHttpError(error: any): Promise<boolean> {
+  // Check if this error should skip the global toast (component will handle it)
+  if (error?.config?.suppressErrorToast === true) {
+    return false; // Don't show global toast, but continue rejection
+  }
  // Compute title/body (friendly) from the error object
  const { title, body } = extractAxiosErrorMessage(error);

@@ -0,0 +1,107 @@
+import apiClient from '@app/services/apiClient';
+
+export interface Team {
+  id: number;
+  name: string;
+  userCount?: number;
+}
+
+export interface TeamMember {
+  id: number;
+  username: string;
+  email?: string;
+  roleName: string;
+  enabled: boolean;
+  team?: {
+    id: number;
+    name: string;
+  };
+  lastRequest?: Date | null;
+}
+
+export interface TeamDetailsResponse {
+  team: Team;
+  members: TeamMember[];
+  availableUsers: TeamMember[];
+}
+
+/**
+ * Team Management Service
+ * Provides functions to interact with team-related backend APIs
+ */
+export const teamService = {
+  /**
+   * Get all teams with user counts
+   */
+  async getTeams(): Promise<Team[]> {
+    const response = await apiClient.get<{ teamsWithCounts: Team[] }>('/api/v1/proprietary/ui-data/teams');
+    return response.data.teamsWithCounts;
+  },
+
+  /**
+   * Get team details including members
+   */
+  async getTeamDetails(teamId: number): Promise<any> {
+    const response = await apiClient.get(`/api/v1/proprietary/ui-data/teams/${teamId}`);
+    return response.data;
+  },
+
+  /**
+   * Create a new team
+   */
+  async createTeam(name: string): Promise<void> {
+    const formData = new FormData();
+    formData.append('name', name);
+    await apiClient.post('/api/v1/team/create', formData, {
+      suppressErrorToast: true,
+    } as any);
+  },
+
+  /**
+   * Rename an existing team
+   */
+  async renameTeam(teamId: number, newName: string): Promise<void> {
+    const formData = new FormData();
+    formData.append('teamId', teamId.toString());
+    formData.append('newName', newName);
+    await apiClient.post('/api/v1/team/rename', formData, {
+      suppressErrorToast: true,
+    } as any);
+  },
+
+  /**
+   * Delete a team (only if it has no members)
+   */
+  async deleteTeam(teamId: number): Promise<void> {
+    const formData = new FormData();
+    formData.append('teamId', teamId.toString());
+    await apiClient.post('/api/v1/team/delete', formData, {
+      suppressErrorToast: true,
+    } as any);
+  },
+
+  /**
+   * Add a user to a team
+   */
+  async addUserToTeam(teamId: number, userId: number): Promise<void> {
+    const formData = new FormData();
+    formData.append('teamId', teamId.toString());
+    formData.append('userId', userId.toString());
+    await apiClient.post('/api/v1/team/addUser', formData, {
+      suppressErrorToast: true,
+    } as any);
+  },
+
+  /**
+   * Move a user to a specific team (used when "removing" from a team - moves to Default)
+   */
+  async moveUserToTeam(username: string, currentRole: string, teamId: number): Promise<void> {
+    const formData = new FormData();
+    formData.append('username', username);
+    formData.append('role', currentRole);
+    formData.append('teamId', teamId.toString());
+    await apiClient.post('/api/v1/user/admin/changeRole', formData, {
+      suppressErrorToast: true,
+    } as any);
+  },
+};
@@ -0,0 +1,166 @@
+import apiClient from '@app/services/apiClient';
+
+export interface User {
+  id: number;
+  username: string;
+  email?: string;
+  roleName: string; // Translation key like "adminUserSettings.admin"
+  rolesAsString?: string; // Actual role ID like "ROLE_ADMIN"
+  enabled: boolean;
+  isFirstLogin?: boolean;
+  authenticationType?: string;
+  team?: {
+    id: number;
+    name: string;
+  };
+  createdAt?: string;
+  updatedAt?: string;
+  // Enriched client-side fields
+  isActive?: boolean;
+  lastRequest?: number; // timestamp in milliseconds
+}
+
+export interface AdminSettingsData {
+  users: User[];
+  userSessions: Record<string, boolean>;
+  userLastRequest: Record<string, number>; // username -> timestamp in milliseconds
+  totalUsers: number;
+  activeUsers: number;
+  disabledUsers: number;
+  currentUsername?: string;
+  roleDetails?: Record<string, string>;
+  teams?: any[];
+  maxPaidUsers?: number;
+}
+
+export interface CreateUserRequest {
+  username: string;
+  password?: string;
+  role: string;
+  teamId?: number;
+  authType: 'password' | 'SSO';
+  forceChange?: boolean;
+}
+
+export interface UpdateUserRoleRequest {
+  username: string;
+  role: string;
+  teamId?: number;
+}
+
+export interface InviteUsersRequest {
+  emails: string; // Comma-separated email addresses
+  role: string;
+  teamId?: number;
+}
+
+export interface InviteUsersResponse {
+  successCount: number;
+  failureCount: number;
+  message?: string;
+  errors?: string;
+  error?: string;
+}
+
+/**
+ * User Management Service
+ * Provides functions to interact with user management backend APIs
+ */
+export const userManagementService = {
+  /**
+   * Get all users with session data (admin only)
+   */
+  async getUsers(): Promise<AdminSettingsData> {
+    const response = await apiClient.get<AdminSettingsData>('/api/v1/proprietary/ui-data/admin-settings');
+    return response.data;
+  },
+
+  /**
+   * Get users without a team
+   */
+  async getUsersWithoutTeam(): Promise<User[]> {
+    const response = await apiClient.get<User[]>('/api/v1/users/without-team');
+    return response.data;
+  },
+
+  /**
+   * Create a new user (admin only)
+   */
+  async createUser(data: CreateUserRequest): Promise<void> {
+    const formData = new FormData();
+    formData.append('username', data.username);
+    if (data.password) {
+      formData.append('password', data.password);
+    }
+    formData.append('role', data.role);
+    if (data.teamId) {
+      formData.append('teamId', data.teamId.toString());
+    }
+    formData.append('authType', data.authType);
+    if (data.forceChange !== undefined) {
+      formData.append('forceChange', data.forceChange.toString());
+    }
+    await apiClient.post('/api/v1/user/admin/saveUser', formData, {
+      suppressErrorToast: true, // Component will handle error display
+    } as any);
+  },
+
+  /**
+   * Update user role and/or team (admin only)
+   */
+  async updateUserRole(data: UpdateUserRoleRequest): Promise<void> {
+    const formData = new FormData();
+    formData.append('username', data.username);
+    formData.append('role', data.role);
+    if (data.teamId) {
+      formData.append('teamId', data.teamId.toString());
+    }
+    await apiClient.post('/api/v1/user/admin/changeRole', formData, {
+      suppressErrorToast: true,
+    } as any);
+  },
+
+  /**
+   * Enable or disable a user (admin only)
+   */
+  async toggleUserEnabled(username: string, enabled: boolean): Promise<void> {
+    const formData = new FormData();
+    formData.append('enabled', enabled.toString());
+    await apiClient.post(`/api/v1/user/admin/changeUserEnabled/${username}`, formData, {
+      suppressErrorToast: true,
+    } as any);
+  },
+
+  /**
+   * Delete a user (admin only)
+   */
+  async deleteUser(username: string): Promise<void> {
+    await apiClient.post(`/api/v1/user/admin/deleteUser/${username}`, null, {
+      suppressErrorToast: true,
+    } as any);
+  },
+
+  /**
+   * Invite users via email (admin only)
+   * Sends comma-separated email addresses, creates accounts with random passwords,
+   * and sends invitation emails
+   */
+  async inviteUsers(data: InviteUsersRequest): Promise<InviteUsersResponse> {
+    const formData = new FormData();
+    formData.append('emails', data.emails);
+    formData.append('role', data.role);
+    if (data.teamId) {
+      formData.append('teamId', data.teamId.toString());
+    }
+
+    const response = await apiClient.post<InviteUsersResponse>(
+      '/api/v1/user/admin/inviteUsers',
+      formData,
+      {
+        suppressErrorToast: true, // Component will handle error display
+      } as any
+    );
+
+    return response.data;
+  },
+};