Stage M2

2026-08-13 23:20:22 +07:00
parent 3d6b0e0d4e
commit 5386bc51d1
65 changed files with 4058 additions and 161 deletions
@@ -0,0 +1,84 @@
+import type { OffsetPaginated, PermissionGroup, RoleDetail, UserSummary } from '@sport/types';
+
+import type { HttpClient } from '../http-client';
+
+export interface UserListParams {
+  page?: number;
+  perPage?: number;
+  q?: string;
+  type?: string;
+  status?: string;
+}
+
+export interface CreateUserPayload {
+  email: string;
+  password: string;
+  firstName: string;
+  lastName: string;
+  phone?: string;
+  type: 'STAFF' | 'ADMIN' | 'SUPER_ADMIN';
+  roleIds: string[];
+}
+
+export interface UpdateUserPayload {
+  firstName?: string;
+  lastName?: string;
+  phone?: string | null;
+  status?: 'ACTIVE' | 'INVITED' | 'SUSPENDED';
+  type?: 'STAFF' | 'ADMIN' | 'SUPER_ADMIN';
+  roleIds?: string[];
+}
+
+export interface RolePayload {
+  key?: string;
+  name?: string;
+  description?: string | null;
+  permissions?: string[];
+}
+
+/** Back-office administration. Every call requires an admin-audience token. */
+export interface AdminResource {
+  listUsers(params?: UserListParams): Promise<OffsetPaginated<UserSummary>>;
+  getUser(id: string): Promise<UserSummary>;
+  createUser(payload: CreateUserPayload): Promise<UserSummary>;
+  updateUser(id: string, payload: UpdateUserPayload): Promise<UserSummary>;
+  resetUserPassword(id: string, password: string): Promise<{ ok: true }>;
+
+  listRoles(): Promise<RoleDetail[]>;
+  getRole(id: string): Promise<RoleDetail>;
+  listPermissions(): Promise<PermissionGroup[]>;
+  createRole(
+    payload: Required<Pick<RolePayload, 'key' | 'name'>> & RolePayload,
+  ): Promise<RoleDetail>;
+  updateRole(id: string, payload: RolePayload): Promise<RoleDetail>;
+  deleteRole(id: string): Promise<void>;
+}
+
+export function createAdminResource(http: HttpClient): AdminResource {
+  // Administration data is never cached: an operator editing permissions must
+  // see the result of their own change immediately.
+  const uncached = { cache: 'no-store' } as const;
+
+  return {
+    listUsers: (params = {}) =>
+      http.get<OffsetPaginated<UserSummary>>('/admin/users', { ...uncached, query: { ...params } }),
+    getUser: (id) => http.get<UserSummary>(`/admin/users/${encodeURIComponent(id)}`, uncached),
+    createUser: (payload) => http.post<UserSummary>('/admin/users', payload, uncached),
+    updateUser: (id, payload) =>
+      http.patch<UserSummary>(`/admin/users/${encodeURIComponent(id)}`, payload, uncached),
+    resetUserPassword: (id, password) =>
+      http.post<{ ok: true }>(
+        `/admin/users/${encodeURIComponent(id)}/password`,
+        { password },
+        uncached,
+      ),
+
+    listRoles: () => http.get<RoleDetail[]>('/admin/roles', uncached),
+    getRole: (id) => http.get<RoleDetail>(`/admin/roles/${encodeURIComponent(id)}`, uncached),
+    listPermissions: () => http.get<PermissionGroup[]>('/admin/roles/permissions', uncached),
+    createRole: (payload) => http.post<RoleDetail>('/admin/roles', payload, uncached),
+    updateRole: (id, payload) =>
+      http.patch<RoleDetail>(`/admin/roles/${encodeURIComponent(id)}`, payload, uncached),
+    deleteRole: (id) => http.delete<void>(`/admin/roles/${encodeURIComponent(id)}`, uncached),
+  };
+}