CLAUDE.md

1# Services Directory
2 
3## Structure
4 
5```
6services/
7├── api/
8│   ├── client.ts        # Axios instance setup
9│   ├── interceptors.ts  # Request/response interceptors
10│   └── endpoints.ts     # API endpoint constants
11├── authService.ts       # Auth-related API calls
12├── userService.ts       # User-related API calls
13└── index.ts             # Barrel exports
14```
15 
16## Factory Function Pattern
17 
18Create service instances with configured client:
19 
20```ts
21// authService.ts
22import { apiClient } from "./api/client";
23import { AUTH_ENDPOINTS } from "./api/endpoints";
24 
25interface iLoginPayload {
26  email: string;
27  password: string;
28}
29 
30interface iLoginResponse {
31  token: string;
32  user: iUser;
33}
34 
35export const authService = {
36  login: async (payload: iLoginPayload): Promise<iLoginResponse> => {
37    const response = await apiClient.post(AUTH_ENDPOINTS.LOGIN, payload);
38    return response.data;
39  },
40 
41  logout: async (): Promise<void> => {
42    await apiClient.post(AUTH_ENDPOINTS.LOGOUT);
43  },
44 
45  refreshToken: async (): Promise<string> => {
46    const response = await apiClient.post(AUTH_ENDPOINTS.REFRESH);
47    return response.data.token;
48  },
49};
50```
51 
52## Endpoint Constants
53 
54```ts
55// endpoints.ts
56export const AUTH_ENDPOINTS = {
57  LOGIN: "/auth/login",
58  LOGOUT: "/auth/logout",
59  REFRESH: "/auth/refresh",
60} as const;
61 
62export const USER_ENDPOINTS = {
63  GET_PROFILE: "/users/profile",
64  UPDATE_PROFILE: "/users/profile",
65} as const;
66```
67 
68## Axios Client Setup
69 
70```ts
71// client.ts
72import axios from "axios";
73import { setupInterceptors } from "./interceptors";
74 
75export const apiClient = axios.create({
76  baseURL: process.env.NEXT_PUBLIC_API_URL,
77  timeout: 10000,
78  headers: {
79    "Content-Type": "application/json",
80  },
81});
82 
83setupInterceptors(apiClient);
84```
85 
86## Response Types
87 
88Always type API responses:
89 
90```ts
91interface iApiResponse<T> {
92  data: T;
93  message: string;
94  success: boolean;
95}
96 
97interface iPaginatedResponse<T> extends iApiResponse<T[]> {
98  pagination: {
99    page: number;
100    limit: number;
101    total: number;
102  };
103}
104```
105 
106## Error Handling
107 
108Use async/await with try/catch in thunks, let interceptors handle common errors.
109