@in.pulse-crm/sdk 1.6.1 → 2.0.0

package/dist/{customer.d.ts → types/customers.types.d.ts}

@@ -1,4 +1,3 @@
-import { AxiosInstance } from "axios";
 export interface Customer {
     CODIGO: number;
     RAZAO: string;
@@ -66,44 +65,3 @@ export interface Customer {
 }
 export type CreateCustomerDTO = Pick<Customer, "RAZAO" | "FANTASIA" | "CPF_CNPJ" | "PESSOA" | "CIDADE" | "ESTADO" | "COD_ERP">;
 export type UpdateCustomerDTO = Partial<CreateCustomerDTO>;
-declare class CustomerSDK {
-    private readonly httpClient;
-    /**
-     * Cria uma instância do SDK de usuários.
-     * @param httpClient - A instância do cliente HTTP a ser usada para fazer requisições à API.
-     */
-    constructor(httpClient: AxiosInstance);
-    /**
-     * Cria um novo cliente.
-     * @param data - Os dados do cliente a serem criados.
-     * @returns Uma Promise que resolve para o cliente criado.
-     */
-    createCustomer(data: CreateCustomerDTO): Promise<any>;
-    /**
-     * Obtém um cliente pelo ID.
-     * @param customerId - O ID do cliente a ser obtido.
-     * @returns Uma Promise que resolve para o cliente obtido.
-     */
-    getCustomerById(customerId: number): Promise<any>;
-    /**
-     * Atualiza um cliente existente.
-     * @param customerId - O ID do cliente a ser atualizado.
-     * @param data - Os dados atualizados do cliente.
-     * @returns Uma Promise que resolve para o cliente atualizado.
-     */
-    updateCustomer(customerId: number, data: UpdateCustomerDTO): Promise<any>;
-    /**
-     * Obtém todos os clientes.
-     *
-     * @param filters - Filtros opcionais para a busca de clientes.
-     * @todo Implementar tipagem para os filtros.
-     * @returns Uma Promise que resolve para uma lista de clientes.
-     */
-    getAllCustomers(filters: Record<string, string>): Promise<any>;
-    /**
-     * Define o token de autenticação para as requisições.
-     * @param token - O token de autenticação a ser definido.
-     */
-    setAuth(token: string): void;
-}
-export default CustomerSDK;

package/dist/{file.d.ts → types/files.types.d.ts}

@@ -1,5 +1,6 @@
-import { AxiosInstance } from "axios";
-interface UploadFileOptions {
+/// <reference types="node" />
+/// <reference types="node" />
+export interface UploadFileOptions {
     /**
      * Nome da instância onde o arquivo está armazenado.
      */
@@ -65,39 +66,3 @@ export interface File {
      */
     created_at: Date;
 }
-/**
- * SDK para operações de arquivos.
- */
-declare class FileSDK {
-    private readonly httpClient;
-    /**
-     * Cria uma instância do SDK de arquivos.
-     * @param httpClient A instância do cliente HTTP a ser usada para fazer requisições à API.
-     */
-    constructor(httpClient: AxiosInstance);
-    /**
-     * Busca um arquivo pelo ID.
-     * @param {number} id - ID do arquivo.
-     * @returns {Promise<Buffer>} Um buffer contendo os dados do arquivo.
-     */
-    fetchFile(id: number): Promise<Buffer>;
-    /**
-     * Obtém a URL de download de um arquivo.
-     * @param {number} id - ID do arquivo.
-     * @returns {string} URL de download do arquivo.
-     */
-    getFileDownloadUrl(id: number): string;
-    /**
-     * Faz o upload de um arquivo.
-     * @param {UploadFileOptions} props - Opções para o upload do arquivo.
-     * @returns {Promise<File>} Os dados do arquivo enviado.
-     */
-    uploadFile(props: UploadFileOptions): Promise<File>;
-    /**
-     * Deleta um arquivo pelo ID.
-     * @param {number} id - ID do arquivo.
-     * @returns {Promise<void>}
-     */
-    deleteFile(id: number): Promise<void>;
-}
-export default FileSDK;

package/dist/types/files.types.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileDirType = void 0;
+/**
+ * Enum que representa os tipos de diretórios de arquivos.
+ *
+ * @enum {string}
+ * @property {string} PUBLIC - Representa o diretório público.
+ * @property {string} MODELS - Representa o diretório de modelos.
+ */
+var FileDirType;
+(function (FileDirType) {
+    FileDirType["PUBLIC"] = "public";
+    FileDirType["MODELS"] = "models";
+})(FileDirType || (exports.FileDirType = FileDirType = {}));

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./response.types";
+export * from "./socket-events.types";
+export * from "./socket-rooms.types";
+export * from "./auth.types";
+export * from "./user.types";
+export * from "./customers.types";
+export * from "./files.types";

package/dist/types/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./response.types"), exports);
+__exportStar(require("./socket-events.types"), exports);
+__exportStar(require("./socket-rooms.types"), exports);
+__exportStar(require("./auth.types"), exports);
+__exportStar(require("./user.types"), exports);
+__exportStar(require("./customers.types"), exports);
+__exportStar(require("./files.types"), exports);

package/dist/{report.d.ts → types/reports.types.d.ts}

@@ -1,5 +1,3 @@
-import { AxiosInstance } from "axios";
-import { DataResponse, MessageResponse } from "./response";
 export type ReportType = "chats";
 export type ChatsReportFormat = "txt" | "csv" | "pdf";
 export type ChatsReportStatus = "pending" | "completed" | "failed";
@@ -22,11 +20,3 @@ export interface GenerateChatsReportOptions {
     startDate: string;
     endDate: string;
 }
-export default class ReportSDK {
-    private readonly httpClient;
-    constructor(httpClient: AxiosInstance);
-    getChatsReports(): Promise<DataResponse<ChatsReport[]>>;
-    generateChatsReport(body: GenerateChatsReportOptions): Promise<DataResponse<ChatsReport>>;
-    deleteChatsReport(chatsReportId: number): Promise<MessageResponse>;
-    setAuth(token: string): void;
-}

package/dist/types/socket-events.types.d.ts

@@ -0,0 +1,72 @@
+import { SocketServerAdminRoom, SocketServerChatRoom, SocketServerReportsRoom, SocketServerRoom } from "./socket-rooms.types";
+import { MessageResponse } from "./response.types";
+export declare enum SocketEventType {
+    WppChatStarted = "wpp_chat_started",
+    WppChatFinished = "wpp_chat_finished",
+    WppMessage = "wpp_message",
+    WppMessageStatus = "wpp_message_status",
+    WppMessageReaction = "wpp_message_reaction",
+    WwebjsQr = "wwebjs_qr",
+    WwebjsAuth = "wwebjs_auth",
+    ReportStatus = "report_status"
+}
+export interface EmitSocketEventFn {
+    (type: SocketEventType.WwebjsQr, room: SocketServerAdminRoom, data: WWEBJSQrEventData): Promise<MessageResponse>;
+    (type: SocketEventType.WwebjsAuth, room: SocketServerAdminRoom, data: WWEBJSAuthEventData): Promise<MessageResponse>;
+    (type: SocketEventType.WppChatStarted, room: SocketServerRoom, data: WppChatStartedEventData): Promise<MessageResponse>;
+    (type: SocketEventType.WppChatFinished, room: SocketServerRoom, data: WppChatFinishedEventData): Promise<MessageResponse>;
+    (type: SocketEventType.WppMessage, room: SocketServerChatRoom, data: WppMessageEventData): Promise<MessageResponse>;
+    (type: SocketEventType.WppMessageStatus, room: SocketServerChatRoom, data: WppMessageStatusEventData): Promise<MessageResponse>;
+    (type: SocketEventType.WppMessageReaction, room: SocketServerChatRoom, data: WppMessageReactionEventData): Promise<MessageResponse>;
+    (type: SocketEventType.ReportStatus, room: SocketServerReportsRoom, data: ReportStatusEventData): Promise<MessageResponse>;
+}
+export interface ListenSocketEventFn {
+    (type: SocketEventType.WwebjsQr, callback: (data: WWEBJSQrEventData) => void): void;
+    (type: SocketEventType.WwebjsAuth, callback: (data: WWEBJSAuthEventData) => void): void;
+    (type: SocketEventType.WppChatStarted, callback: (data: WppChatStartedEventData) => void): void;
+    (type: SocketEventType.WppChatFinished, callback: (data: WppChatFinishedEventData) => void): void;
+    (type: SocketEventType.WppMessage, callback: (data: WppMessageEventData) => void): void;
+    (type: SocketEventType.WppMessageStatus, callback: (data: WppMessageStatusEventData) => void): void;
+    (type: SocketEventType.WppMessageReaction, callback: (data: WppMessageReactionEventData) => void): void;
+    (type: SocketEventType.ReportStatus, callback: (data: ReportStatusEventData) => void): void;
+}
+export interface UnlistenSocketEventFn {
+    (type: SocketEventType): void;
+}
+export interface WWEBJSQrEventData {
+    qr: string;
+    phone: string;
+}
+export interface WWEBJSAuthEventData {
+    phone: string;
+    success: boolean;
+    message?: string;
+}
+export interface WppChatStartedEventData {
+}
+export interface WppChatFinishedEventData {
+}
+export interface WppMessageEventData {
+}
+export interface WppMessageStatusEventData {
+}
+export interface WppMessageReactionEventData {
+}
+export type ReportStatusEventData = {
+    id: number;
+    type: string;
+} & ({
+    isCompleted: true;
+    isFailed: false;
+    fileId: number;
+    chats: number;
+    messages: number;
+} | {
+    isCompleted: false;
+    isFailed: true;
+    error: string;
+} | {
+    isCompleted: false;
+    isFailed: false;
+    progress: number;
+});

package/dist/types/socket-events.types.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SocketEventType = void 0;
+var SocketEventType;
+(function (SocketEventType) {
+    SocketEventType["WppChatStarted"] = "wpp_chat_started";
+    SocketEventType["WppChatFinished"] = "wpp_chat_finished";
+    SocketEventType["WppMessage"] = "wpp_message";
+    SocketEventType["WppMessageStatus"] = "wpp_message_status";
+    SocketEventType["WppMessageReaction"] = "wpp_message_reaction";
+    SocketEventType["WwebjsQr"] = "wwebjs_qr";
+    SocketEventType["WwebjsAuth"] = "wwebjs_auth";
+    SocketEventType["ReportStatus"] = "report_status";
+})(SocketEventType || (exports.SocketEventType = SocketEventType = {}));
+;
+;
+;
+;
+;

package/dist/types/socket-rooms.types.d.ts

@@ -0,0 +1,15 @@
+type ReportType = "chats";
+type PhoneNumber = string;
+export type SocketClientChatRoom = `chat:${PhoneNumber}`;
+export type SocketClientAdminRoom = "admin";
+export type SocketClientMonitorRoom = `monitor`;
+export type SocketClientReportsRoom = `reports:${ReportType}`;
+export type SocketClientRoom = SocketClientChatRoom | SocketClientAdminRoom | SocketClientReportsRoom | SocketClientMonitorRoom;
+type SocketRoomWithInstance<T extends string> = `${string}:${T}`;
+type SocketRoomWithSector<T extends string> = SocketRoomWithInstance<`${number}:${T}`>;
+export type SocketServerAdminRoom = SocketRoomWithSector<SocketClientAdminRoom>;
+export type SocketServerMonitorRoom = SocketRoomWithSector<SocketClientMonitorRoom>;
+export type SocketServerReportsRoom = SocketRoomWithSector<SocketClientReportsRoom>;
+export type SocketServerChatRoom = SocketRoomWithInstance<SocketClientChatRoom>;
+export type SocketServerRoom = SocketServerChatRoom | SocketServerAdminRoom | SocketServerMonitorRoom | SocketServerReportsRoom;
+export {};

package/dist/{user.d.ts → types/user.types.d.ts}

@@ -1,5 +1,3 @@
-import { AxiosInstance } from "axios";
-import { DataResponse, PaginatedResponse } from "./response";
 /**
  * Enum que representa os diferentes papéis de usuário dentro do sistema.
  *
@@ -148,42 +146,3 @@ export interface CreateUserDTO {
  * Interface que representa o objeto de transferência de dados para atualizar um usuário.
  */
 export type UpdateUserDTO = Partial<CreateUserDTO>;
-/**
- * SDK para operações de usuários.
- */
-declare class UserSDK {
-    private readonly httpClient;
-    /**
-     * Cria uma instância do SDK de usuários.
-     * @param httpClient - A instância do cliente HTTP a ser usada para fazer requisições à API.
-     */
-    constructor(httpClient: AxiosInstance);
-    /**
-     * Obtém a lista de usuários.
-     * @returns Uma resposta paginada contendo os usuários.
-     */
-    getUsers(): Promise<PaginatedResponse<User>>;
-    /**
-     * Obtém um usuário pelo ID.
-     * @param userId - O ID do usuário.
-     * @returns Uma resposta contendo os dados do usuário.
-     */
-    getUserById(userId: number): Promise<DataResponse<User>>;
-    /**
-     * Cria um novo usuário.
-     * @param data - Os dados para criação do usuário.
-     * @returns Uma resposta contendo os dados do usuário criado.
-     * @throws Um erro se a criação do usuário falhar.
-     */
-    createUser(data: CreateUserDTO): Promise<DataResponse<User>>;
-    /**
-     * Atualiza um usuário existente.
-     * @param userId - O ID do usuário.
-     * @param data - Os dados para atualização do usuário.
-     * @returns Uma resposta contendo os dados do usuário atualizado.
-     * @throws Um erro se a atualização do usuário falhar.
-     */
-    updateUser(userId: string, data: UpdateUserDTO): Promise<DataResponse<User>>;
-    setAuth(token: string): void;
-}
-export default UserSDK;

package/dist/types/user.types.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserRole = void 0;
+/**
+ * Enum que representa os diferentes papéis de usuário dentro do sistema.
+ *
+ * @enum {string}
+ * @property {string} ADMIN - Representa um papel de administrador.
+ * @property {string} ACTIVE - Representa um papel de usuário ativo.
+ * @property {string} RECEPTIONIST - Representa um papel de recepcionista.
+ * @property {string} BOTH - Representa um papel que combina tanto recepcionista quanto usuário ativo.
+ */
+var UserRole;
+(function (UserRole) {
+    UserRole["ADMIN"] = "ADMIN";
+    UserRole["ACTIVE"] = "ATIVO";
+    UserRole["RECEPTIONIST"] = "RECEP";
+    UserRole["BOTH"] = "AMBOS";
+})(UserRole || (exports.UserRole = UserRole = {}));

package/dist/users.client.d.ts

@@ -0,0 +1,40 @@
+import { DataResponse, PaginatedResponse } from "./types/response.types";
+import { CreateUserDTO, UpdateUserDTO, User } from "./types/user.types";
+import ApiClient from "./api-client";
+/**
+ * SDK para operações de usuários.
+ */
+export default class UsersClient extends ApiClient {
+    /**
+     * Obtém a lista de usuários.
+     * @returns Uma resposta paginada contendo os usuários.
+     */
+    getUsers(): Promise<PaginatedResponse<User>>;
+    /**
+     * Obtém um usuário pelo ID.
+     * @param userId - O ID do usuário.
+     * @returns Uma resposta contendo os dados do usuário.
+     */
+    getUserById(userId: number): Promise<DataResponse<User>>;
+    /**
+     * Cria um novo usuário.
+     * @param data - Os dados para criação do usuário.
+     * @returns Uma resposta contendo os dados do usuário criado.
+     * @throws Um erro se a criação do usuário falhar.
+     */
+    createUser(data: CreateUserDTO): Promise<DataResponse<User>>;
+    /**
+     * Atualiza um usuário existente.
+     * @param userId - O ID do usuário.
+     * @param data - Os dados para atualização do usuário.
+     * @returns Uma resposta contendo os dados do usuário atualizado.
+     * @throws Um erro se a atualização do usuário falhar.
+     */
+    updateUser(userId: string, data: UpdateUserDTO): Promise<DataResponse<User>>;
+    /**
+     * Sets the authorization token for HTTP requests.
+     *
+     * @param token - The authentication token to be used in the `Authorization` header.
+     */
+    setAuth(token: string): void;
+}

package/dist/{user.js → users.client.js}

@@ -1,34 +1,13 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UserRole = void 0;
-/**
- * Enum que representa os diferentes papéis de usuário dentro do sistema.
- *
- * @enum {string}
- * @property {string} ADMIN - Representa um papel de administrador.
- * @property {string} ACTIVE - Representa um papel de usuário ativo.
- * @property {string} RECEPTIONIST - Representa um papel de recepcionista.
- * @property {string} BOTH - Representa um papel que combina tanto recepcionista quanto usuário ativo.
- */
-var UserRole;
-(function (UserRole) {
-    UserRole["ADMIN"] = "ADMIN";
-    UserRole["ACTIVE"] = "ATIVO";
-    UserRole["RECEPTIONIST"] = "RECEP";
-    UserRole["BOTH"] = "AMBOS";
-})(UserRole || (exports.UserRole = UserRole = {}));
+const api_client_1 = __importDefault(require("./api-client"));
 /**
  * SDK para operações de usuários.
  */
-class UserSDK {
-    httpClient;
-    /**
-     * Cria uma instância do SDK de usuários.
-     * @param httpClient - A instância do cliente HTTP a ser usada para fazer requisições à API.
-     */
-    constructor(httpClient) {
-        this.httpClient = httpClient;
-    }
+class UsersClient extends api_client_1.default {
     /**
      * Obtém a lista de usuários.
      * @returns Uma resposta paginada contendo os usuários.
@@ -77,8 +56,13 @@ class UserSDK {
             throw new Error("Failed to update user", { cause: error });
         }
     }
+    /**
+     * Sets the authorization token for HTTP requests.
+     *
+     * @param token - The authentication token to be used in the `Authorization` header.
+     */
     setAuth(token) {
         this.httpClient.defaults.headers.common["Authorization"] = `Bearer ${token}`;
     }
 }
-exports.default = UserSDK;
+exports.default = UsersClient;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@in.pulse-crm/sdk",
-	"version": "1.6.1",
+	"version": "2.0.0",
 	"description": "SDKs for abstraction of api consumption of in.pulse-crm application",
 	"main": "./dist/index.js",
 	"types": "./dist/index.d.ts",

package/src/api-client.ts

@@ -0,0 +1,33 @@
+import axios, { AxiosInstance, AxiosError } from 'axios';
+import { ErrorResponse } from './types/response.types';
+
+export default class ApiClient {
+    protected readonly httpClient: AxiosInstance;
+    private baseUrl: string;
+
+    constructor(baseUrl: string) {
+        this.baseUrl = baseUrl;
+
+        this.httpClient = axios.create({
+            baseURL: `${this.baseUrl}`,
+            timeout: 10000,
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        });
+
+        this.initializeResponseInterceptor();
+    }
+
+    private initializeResponseInterceptor() {
+        this.httpClient.interceptors.response.use(
+            null,
+            this.handleError
+        );
+    }
+
+    protected handleError = (error: AxiosError<ErrorResponse>): Promise<never> => {
+        const errorMessage = error.response?.data?.message || error.message;
+        return Promise.reject(new Error(errorMessage));
+    };
+}

package/src/{auth.ts → auth.client.ts}

@@ -1,51 +1,12 @@
-import { AxiosInstance } from "axios";
-import { User } from "./user";
 import { sanitizeErrorMessage } from "@in.pulse-crm/utils";
-import { DataResponse } from "./response";
-
-export interface LoginData {
-    /**
-     * Token de autenticação.
-     */
-    token: string;
-    /**
-     * Dados do usuário.
-     */
-    user: User;
-}
-
-export interface SessionData {
-    /**
-     * ID do usuário.
-     */
-    userId: number;
-    /**
-     * ID do setor do usuário.
-     */
-    sectorId: number
-    /**
-     * Papel do usuário.
-     */
-    role: string;
-    /**
-     * Nome da instância.
-     */
-    instance: string;
-}
+import { DataResponse } from "./types/response.types";
+import ApiClient from "./api-client";
+import { LoginData, SessionData } from "./types/auth.types";
 
 /**
  * Classe AuthSDK para interagir com a API de autenticação.
  */
-export default class AuthSDK {
-
-    /**
-     * Cria uma instância do SDK de autenticação.
-     * @param {AxiosInstance} httpClient A instância do cliente HTTP a ser usada para fazer requisições à API.
-     */
-    constructor(private readonly httpClient: AxiosInstance) {
-
-    }
-
+export default class AuthClient extends ApiClient {
     /**
      * Realiza o login do usuário.
      * @param {string} instance Nome da instância do Inpulse.

package/src/customers.client.ts

@@ -0,0 +1,66 @@
+import ApiClient from "./api-client";
+import { CreateCustomerDTO, UpdateCustomerDTO } from "./types/customers.types";
+
+class CustomersClient extends ApiClient {
+    /**
+     * Cria um novo cliente.
+     * @param data - Os dados do cliente a serem criados.
+     * @returns Uma Promise que resolve para o cliente criado.
+     */
+    public async createCustomer(data: CreateCustomerDTO) {
+        const response = await this.httpClient.post(`/customers`, data);
+
+        return response.data;
+    }
+
+    /**
+     * Obtém um cliente pelo ID.
+     * @param customerId - O ID do cliente a ser obtido.
+     * @returns Uma Promise que resolve para o cliente obtido.
+     */
+    public async getCustomerById(customerId: number) {
+        const response = await this.httpClient.get(`/customers/${customerId}`);
+        return response.data;
+    }
+
+    /**
+     * Atualiza um cliente existente.
+     * @param customerId - O ID do cliente a ser atualizado.
+     * @param data - Os dados atualizados do cliente.
+     * @returns Uma Promise que resolve para o cliente atualizado.
+     */
+    public async updateCustomer(customerId: number, data: UpdateCustomerDTO) {
+        const response = await this.httpClient.patch(`/customers/${customerId}`, data);
+        return response.data;
+    }
+
+    /**
+     * Obtém todos os clientes.
+     * 
+     * @param filters - Filtros opcionais para a busca de clientes.
+     * @todo Implementar tipagem para os filtros.
+     * @returns Uma Promise que resolve para uma lista de clientes.
+     */
+    public async getAllCustomers(filters: Record<string, string>) {
+        let baseUrl = `/customers`;
+        const params = new URLSearchParams(filters);
+
+        if (params.toString()) {
+            baseUrl += `?${params.toString()}`;
+        }
+
+        const response = await this.httpClient.get(`/customers`);
+
+        return response.data;
+    }
+
+    /**
+     * Define o token de autenticação para as requisições.
+     * @param token - O token de autenticação a ser definido.
+     */
+    public setAuth(token: string) {
+        this.httpClient.defaults.headers.common["Authorization"] = `Bearer ${token}`;
+    }
+}
+
+export default CustomersClient;

package/src/files.client.ts

@@ -0,0 +1,57 @@
+import ApiClient from "./api-client";
+import { UploadFileOptions } from "./types/files.types";
+import { DataResponse } from "./types/response.types";
+
+class FilesClient extends ApiClient {
+    /**
+     * Busca um arquivo pelo ID.
+     * @param {number} id - ID do arquivo.
+     * @returns {Promise<Buffer>} Um buffer contendo os dados do arquivo.
+     */
+    public async fetchFile(id: number): Promise<Buffer> {
+        const response = await this.httpClient.get(`/files/${id}`, {
+            responseType: "arraybuffer"
+        });
+        const buffer = Buffer.from(response.data, "binary");
+
+        return buffer;
+    }
+
+    /**
+     * Obtém a URL de download de um arquivo.
+     * @param {number} id - ID do arquivo.
+     * @returns {string} URL de download do arquivo.
+     */
+    public getFileDownloadUrl(id: number): string {
+        return this.httpClient.defaults.baseURL + `/files/${id}`;
+    }
+
+    /**
+     * Faz o upload de um arquivo.
+     * @param {UploadFileOptions} props - Opções para o upload do arquivo.
+     * @returns {Promise<File>} Os dados do arquivo enviado.
+     */
+    public async uploadFile(props: UploadFileOptions): Promise<File> {
+        const form = new FormData();
+        form.append("instance", props.instance);
+        form.append("dirType", props.dirType);
+        form.append("file", new Blob([props.buffer]), props.fileName);
+
+        const response = await this.httpClient.post<DataResponse<File>>("/files", form, {
+            headers: { "Content-Type": "multipart/form-data" }
+        });
+
+        return response.data.data;
+    }
+
+    /**
+     * Deleta um arquivo pelo ID.
+     * @param {number} id - ID do arquivo.
+     * @returns {Promise<void>}
+     */
+    public async deleteFile(id: number): Promise<void> {
+        await this.httpClient.delete(`/files/${id}`);
+    }
+}
+
+export default FilesClient;