UsersService is part of the shared library (projects/shared/src/lib/users.service.ts) and is injectable at the root level — you do not need to add it to any module’s providers array.
All endpoints require an authenticated session. The authInterceptor automatically attaches the Bearer token to every request. See AuthService for details.
Method summary
| Method | HTTP | Description |
|---|
listUsers | GET /api/auth/users | Retrieve all system users |
createUser | POST /api/auth/users | Create a new user account |
updateUser | PATCH /api/auth/users/:id | Update an existing user account |
deleteUser | DELETE /api/auth/users/:id | Delete a user account |
Source
import { Injectable, inject } from '@angular/core';
import { HttpClient } from '@angular/common/http';
import { Observable } from 'rxjs';
export type UserRole = 'ADMIN' | 'MESA' | 'AREA' | 'USUARIO';
export interface UserDto {
id: string;
email: string;
nombre: string;
rol: UserRole;
area?: string | null;
telefono?: string | null;
is_active: boolean;
}
export interface UserCreatePayload {
email: string;
nombre: string;
password: string;
rol: UserRole;
area?: string | null;
telefono?: string | null;
}
export interface UserUpdatePayload {
email?: string;
nombre?: string;
password?: string;
rol?: UserRole;
area?: string | null;
telefono?: string | null;
is_active?: boolean;
}
@Injectable({ providedIn: 'root' })
export class UsersService {
private http = inject(HttpClient);
private base = 'http://127.0.0.1:8000';
listUsers(): Observable<UserDto[]> {
return this.http.get<UserDto[]>(`${this.base}/api/auth/users`);
}
createUser(payload: UserCreatePayload): Observable<{ message: string; id: string }> {
return this.http.post<{ message: string; id: string }>(`${this.base}/api/auth/users`, payload);
}
updateUser(userId: string, payload: UserUpdatePayload): Observable<{ message: string }> {
return this.http.patch<{ message: string }>(`${this.base}/api/auth/users/${userId}`, payload);
}
deleteUser(userId: string): Observable<{ message: string }> {
return this.http.delete<{ message: string }>(`${this.base}/api/auth/users/${userId}`);
}
}
Methods
listUsers
listUsers(): Observable<UserDto[]>
GET /api/auth/users
Parameters: None.
Returns: Observable<UserDto[]> — array of all user objects. See UserDto for field details.
createUser
createUser(payload: UserCreatePayload): Observable<{ message: string; id: string }>
POST /api/auth/users
Parameters
payload
UserCreatePayload
required
Observable<{ message: string; id: string }> — confirmation message and the UUID of the newly created user.
Confirmation message from the server.
UUID of the newly created user account.
updateUser
updateUser(userId: string, payload: UserUpdatePayload): Observable<{ message: string }>
PATCH /api/auth/users/:id
Parameters
UUID of the user account to update.
payload
UserUpdatePayload
required
Partial update payload. All fields are optional. See UserUpdatePayload for all fields. Observable<{ message: string }>
deleteUser
deleteUser(userId: string): Observable<{ message: string }>
DELETE /api/auth/users/:id
This action is irreversible. Consider setting is_active to false via updateUser if you want to deactivate the account without deleting it.
UUID of the user account to delete.
Observable<{ message: string }>
Usage example
Inject UsersService into any component or service using Angular’s inject function or constructor injection.
import { Component, inject, OnInit } from '@angular/core';
// UsersService is not part of the public 'shared' path alias.
// Import directly via the relative path from your component.
import { UsersService, UserDto, UserCreatePayload } from '../../../../../shared/src/lib/users.service';
@Component({
selector: 'app-user-management',
templateUrl: './user-management.component.html',
})
export class UserManagementComponent implements OnInit {
private usersService = inject(UsersService);
users: UserDto[] = [];
ngOnInit(): void {
this.usersService.listUsers().subscribe({
next: (users) => (this.users = users),
error: (err) => console.error('Failed to load users', err),
});
}
createUser(): void {
const payload: UserCreatePayload = {
email: '[email protected]',
nombre: 'Nuevo Agente',
password: 'SecurePass123',
rol: 'MESA',
};
this.usersService.createUser(payload).subscribe({
next: (res) => console.log('Created user with id:', res.id),
error: (err) => console.error(err),
});
}
deactivateUser(userId: string): void {
this.usersService.updateUser(userId, { is_active: false }).subscribe({
next: (res) => console.log(res.message),
});
}
}