Initial commit

src/lib/api/example/admin/permissions/service.ts

@@ -0,0 +1,30 @@
+import { apiRequest } from "@/lib/api/api-service";
+import { ApiResponse } from "@/types/api-response";
+import { PermissionResponseDto, CreatePermissionDto } from "./types";
+
+/**
+ * Admin Permissions Service - Example Implementation
+ * Matches Backend: /api/admin/permissions/*
+ */
+
+const getAll = () => {
+  return apiRequest<ApiResponse<PermissionResponseDto[]>>({
+    url: "/admin/permissions",
+    client: "admin",
+    method: "get",
+  });
+};
+
+const create = (data: CreatePermissionDto) => {
+  return apiRequest<ApiResponse<PermissionResponseDto>>({
+    url: "/admin/permissions",
+    client: "admin",
+    method: "post",
+    data,
+  });
+};
+
+export const adminPermissionsService = {
+  getAll,
+  create,
+};

src/lib/api/example/admin/permissions/types.ts

@@ -0,0 +1,18 @@
+// Permission DTOs - Matches Backend
+export interface PermissionResponseDto {
+  id: string;
+  name: string;
+  description?: string;
+  resource: string;
+  action: string;
+  createdAt: string;
+  updatedAt: string;
+}
+
+// Create Permission
+export interface CreatePermissionDto {
+  name: string;
+  description?: string;
+  resource: string;
+  action: string;
+}

src/lib/api/example/admin/permissions/use-hooks.ts

@@ -0,0 +1,40 @@
+import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
+import { ApiResponse } from "@/types/api-response";
+import { adminPermissionsService } from "./service";
+import { PermissionResponseDto, CreatePermissionDto } from "./types";
+
+export const AdminPermissionsQueryKeys = {
+  all: ["admin-permissions"] as const,
+  list: () => [...AdminPermissionsQueryKeys.all, "list"] as const,
+};
+
+export function useGetAllPermissions() {
+  const queryKey = AdminPermissionsQueryKeys.list();
+
+  const { data, ...rest } = useQuery<ApiResponse<PermissionResponseDto[]>>({
+    queryKey: queryKey,
+    queryFn: adminPermissionsService.getAll,
+  });
+
+  return { data: data?.data, ...rest };
+}
+
+export function useCreatePermission() {
+  const queryClient = useQueryClient();
+
+  const { data, ...rest } = useMutation<
+    ApiResponse<PermissionResponseDto>,
+    Error,
+    CreatePermissionDto
+  >({
+    mutationFn: (permissionData) =>
+      adminPermissionsService.create(permissionData),
+    onSuccess: () => {
+      queryClient.invalidateQueries({
+        queryKey: AdminPermissionsQueryKeys.all,
+      });
+    },
+  });
+
+  return { data: data?.data, ...rest };
+}

src/lib/api/example/admin/roles/service.ts

@@ -0,0 +1,72 @@
+import { apiRequest } from "@/lib/api/api-service";
+import { ApiResponse } from "@/types/api-response";
+import {
+  RoleResponseDto,
+  CreateRoleDto,
+  UpdateRoleDto,
+  RolePermissionResponseDto,
+} from "./types";
+
+/**
+ * Admin Roles Service - Example Implementation
+ * Matches Backend: /api/admin/roles/*
+ */
+
+const getAll = () => {
+  return apiRequest<ApiResponse<RoleResponseDto[]>>({
+    url: "/admin/roles",
+    client: "admin",
+    method: "get",
+  });
+};
+
+const create = (data: CreateRoleDto) => {
+  return apiRequest<ApiResponse<RoleResponseDto>>({
+    url: "/admin/roles",
+    client: "admin",
+    method: "post",
+    data,
+  });
+};
+
+const update = (roleId: string, data: UpdateRoleDto) => {
+  return apiRequest<ApiResponse<RoleResponseDto>>({
+    url: `/admin/roles/${roleId}`,
+    client: "admin",
+    method: "put",
+    data,
+  });
+};
+
+const remove = (roleId: string) => {
+  return apiRequest<ApiResponse<null>>({
+    url: `/admin/roles/${roleId}`,
+    client: "admin",
+    method: "delete",
+  });
+};
+
+const assignPermission = (roleId: string, permissionId: string) => {
+  return apiRequest<ApiResponse<RolePermissionResponseDto>>({
+    url: `/admin/roles/${roleId}/permissions/${permissionId}`,
+    client: "admin",
+    method: "post",
+  });
+};
+
+const removePermission = (roleId: string, permissionId: string) => {
+  return apiRequest<ApiResponse<null>>({
+    url: `/admin/roles/${roleId}/permissions/${permissionId}`,
+    client: "admin",
+    method: "delete",
+  });
+};
+
+export const adminRolesService = {
+  getAll,
+  create,
+  update,
+  remove,
+  assignPermission,
+  removePermission,
+};

src/lib/api/example/admin/roles/types.ts

@@ -0,0 +1,38 @@
+// Role DTOs - Matches Backend
+export interface RoleResponseDto {
+  id: string;
+  name: string;
+  description?: string;
+  permissions: PermissionInfo[];
+  _count?: {
+    users: number;
+  };
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface PermissionInfo {
+  id: string;
+  name: string;
+  resource: string;
+  action: string;
+}
+
+// Create/Update Role
+export interface CreateRoleDto {
+  name: string;
+  description?: string;
+}
+
+export interface UpdateRoleDto {
+  name?: string;
+  description?: string;
+}
+
+// Role Permission Assignment
+export interface RolePermissionResponseDto {
+  id: string;
+  roleId: string;
+  permissionId: string;
+  createdAt: string;
+}

src/lib/api/example/admin/roles/use-hooks.ts

@@ -0,0 +1,112 @@
+import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
+import { ApiResponse } from "@/types/api-response";
+import { adminRolesService } from "./service";
+import {
+  RoleResponseDto,
+  CreateRoleDto,
+  UpdateRoleDto,
+  RolePermissionResponseDto,
+} from "./types";
+
+export const AdminRolesQueryKeys = {
+  all: ["admin-roles"] as const,
+  list: () => [...AdminRolesQueryKeys.all, "list"] as const,
+};
+
+export function useGetAllRoles() {
+  const queryKey = AdminRolesQueryKeys.list();
+
+  const { data, ...rest } = useQuery<ApiResponse<RoleResponseDto[]>>({
+    queryKey: queryKey,
+    queryFn: adminRolesService.getAll,
+  });
+
+  return { data: data?.data, ...rest };
+}
+
+export function useCreateRole() {
+  const queryClient = useQueryClient();
+
+  const { data, ...rest } = useMutation<
+    ApiResponse<RoleResponseDto>,
+    Error,
+    CreateRoleDto
+  >({
+    mutationFn: (roleData) => adminRolesService.create(roleData),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: AdminRolesQueryKeys.all });
+    },
+  });
+
+  return { data: data?.data, ...rest };
+}
+
+export function useUpdateRole() {
+  const queryClient = useQueryClient();
+
+  const { data, ...rest } = useMutation<
+    ApiResponse<RoleResponseDto>,
+    Error,
+    { roleId: string; data: UpdateRoleDto }
+  >({
+    mutationFn: ({ roleId, data }) => adminRolesService.update(roleId, data),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: AdminRolesQueryKeys.all });
+    },
+  });
+
+  return { data: data?.data, ...rest };
+}
+
+export function useDeleteRole() {
+  const queryClient = useQueryClient();
+
+  const { data, ...rest } = useMutation<
+    ApiResponse<null>,
+    Error,
+    { roleId: string }
+  >({
+    mutationFn: ({ roleId }) => adminRolesService.remove(roleId),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: AdminRolesQueryKeys.all });
+    },
+  });
+
+  return { data: data?.data, ...rest };
+}
+
+export function useAssignPermission() {
+  const queryClient = useQueryClient();
+
+  const { data, ...rest } = useMutation<
+    ApiResponse<RolePermissionResponseDto>,
+    Error,
+    { roleId: string; permissionId: string }
+  >({
+    mutationFn: ({ roleId, permissionId }) =>
+      adminRolesService.assignPermission(roleId, permissionId),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: AdminRolesQueryKeys.all });
+    },
+  });
+
+  return { data: data?.data, ...rest };
+}
+
+export function useRemovePermission() {
+  const queryClient = useQueryClient();
+
+  const { data, ...rest } = useMutation<
+    ApiResponse<null>,
+    Error,
+    { roleId: string; permissionId: string }
+  >({
+    mutationFn: ({ roleId, permissionId }) =>
+      adminRolesService.removePermission(roleId, permissionId),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: AdminRolesQueryKeys.all });
+    },
+  });
+
+  return { data: data?.data, ...rest };
+}

src/lib/api/example/admin/users/service.ts

@@ -0,0 +1,53 @@
+import { apiRequest } from "@/lib/api/api-service";
+import { ApiResponse } from "@/types/api-response";
+import { UserResponseDto } from "@/types/user";
+import {
+  UsersQueryParams,
+  PaginatedUsersResponse,
+  UserRoleResponseDto,
+} from "./types";
+
+/**
+ * Admin Users Service - Example Implementation
+ * Matches Backend: /api/admin/users/*
+ */
+
+const getAll = (params?: UsersQueryParams) => {
+  return apiRequest<ApiResponse<PaginatedUsersResponse>>({
+    url: "/admin/users",
+    client: "admin",
+    method: "get",
+    params,
+  });
+};
+
+const toggleActive = (userId: string) => {
+  return apiRequest<ApiResponse<UserResponseDto>>({
+    url: `/admin/users/${userId}/toggle-active`,
+    client: "admin",
+    method: "put",
+  });
+};
+
+const assignRole = (userId: string, roleId: string) => {
+  return apiRequest<ApiResponse<UserRoleResponseDto>>({
+    url: `/admin/users/${userId}/roles/${roleId}`,
+    client: "admin",
+    method: "post",
+  });
+};
+
+const removeRole = (userId: string, roleId: string) => {
+  return apiRequest<ApiResponse<null>>({
+    url: `/admin/users/${userId}/roles/${roleId}`,
+    client: "admin",
+    method: "delete",
+  });
+};
+
+export const adminUsersService = {
+  getAll,
+  toggleActive,
+  assignRole,
+  removeRole,
+};

src/lib/api/example/admin/users/types.ts

@@ -0,0 +1,18 @@
+import { PaginatedData, PaginationDto } from "@/types/api-response";
+import { UserResponseDto } from "../../users/types";
+export type { UserResponseDto };
+export type { PaginationDto };
+
+// User Role Assignment
+export interface UserRoleResponseDto {
+  id: string;
+  userId: string;
+  roleId: string;
+  createdAt: string;
+}
+
+// Pagination params
+export type UsersQueryParams = PaginationDto;
+
+// Response type for paginated users
+export type PaginatedUsersResponse = PaginatedData<UserResponseDto>;

src/lib/api/example/admin/users/use-hooks.ts

@@ -0,0 +1,79 @@
+import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
+import { ApiResponse } from "@/types/api-response";
+import { adminUsersService } from "./service";
+import {
+  UserRoleResponseDto,
+  UsersQueryParams,
+  PaginatedUsersResponse,
+} from "./types";
+import { UserResponseDto } from "@/types/user";
+
+export const AdminUsersQueryKeys = {
+  all: ["admin-users"] as const,
+  list: (params?: UsersQueryParams) =>
+    [...AdminUsersQueryKeys.all, "list", params] as const,
+};
+
+export function useGetAllUsers(params?: UsersQueryParams) {
+  const queryKey = AdminUsersQueryKeys.list(params);
+
+  const { data, ...rest } = useQuery<ApiResponse<PaginatedUsersResponse>>({
+    queryKey: queryKey,
+    queryFn: () => adminUsersService.getAll(params),
+  });
+
+  return { data: data?.data, ...rest };
+}
+
+export function useToggleUserActive() {
+  const queryClient = useQueryClient();
+
+  const { data, ...rest } = useMutation<
+    ApiResponse<UserResponseDto>,
+    Error,
+    { userId: string }
+  >({
+    mutationFn: ({ userId }) => adminUsersService.toggleActive(userId),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: AdminUsersQueryKeys.all });
+    },
+  });
+
+  return { data: data?.data, ...rest };
+}
+
+export function useAssignRole() {
+  const queryClient = useQueryClient();
+
+  const { data, ...rest } = useMutation<
+    ApiResponse<UserRoleResponseDto>,
+    Error,
+    { userId: string; roleId: string }
+  >({
+    mutationFn: ({ userId, roleId }) =>
+      adminUsersService.assignRole(userId, roleId),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: AdminUsersQueryKeys.all });
+    },
+  });
+
+  return { data: data?.data, ...rest };
+}
+
+export function useRemoveRole() {
+  const queryClient = useQueryClient();
+
+  const { data, ...rest } = useMutation<
+    ApiResponse<null>,
+    Error,
+    { userId: string; roleId: string }
+  >({
+    mutationFn: ({ userId, roleId }) =>
+      adminUsersService.removeRole(userId, roleId),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: AdminUsersQueryKeys.all });
+    },
+  });
+
+  return { data: data?.data, ...rest };
+}