ixc-orm 1.4.3 → 1.4.4

package/README.md

@@ -6,8 +6,13 @@ Esta biblioteca não faz parte das bibliotecas oficiais da IXCsoft e foi desenvo
 
 ## 🚀 Novidades
 
-### v1.4.1 - 14 de agosto de 2025
+### v1.4.4 - 15 de agosto de 2025
+* **Melhorado:** Foi adicionado um método `find()` a classe `IXCClient`, para encontrar um registro pelo seu `id` de uma forma mais simples.
+
+### v1.4.3 - 15 de agosto de 2025
+* **Melhorado:** Os métodos `get()`, `post()` e `put()` da classe `IXCClient`, a partir de agora sempre retornarão um objeto `IXCResponse`, indepedente da requisição falhar ou não.
 
+### v1.4.1 - 14 de agosto de 2025
 * **Corrigido:** Resolvido o bug de leitura das variáveis de ambiente no arquivo .env na pasta raiz.
 * **Novo:** Foram adicionados 3 dos 44 recursos da API do IXC: `get_boleto`, `liberacao_temporaria` e `desbloqueio_confianca`. (Futuramente novos recursos serão adicionados)
 

package/dist/IXCClient.d.ts

@@ -27,7 +27,16 @@ export default abstract class IXCClient {
      */
     orderBy(column: string, order: keyof typeof IXCSortOrder): IXCClient;
     /**
-     * Envia uma solicitação GET para a API do IXC, com o header `ixcsoft` definico como `listar`
+     * Envia uma requisição GET para a API do IXC, com o header `ixcsoft` definico como `listar`\
+     * A `query` dessa requisição não será enviada para o IXC com o parâmetro `grid_param`\
+     * Ou seja, esta requisição executa uma busca simples, em vez do filtro de grid
+     *
+     * @param id O identificador numérico do registro que será buscado no IXC
+     * @returns Promise<IXCResponse>
+     */
+    find(id: any): Promise<IXCResponse>;
+    /**
+     * Envia uma requisição GET para a API do IXC, com o header `ixcsoft` definico como `listar`
      * Preenche o corpo da requisição com os dados passados pela função `where` no formado JSON
      *
      * @param pg O número da página que será solicitada ao IXC `padão = 1`

package/dist/IXCClient.js

@@ -76,7 +76,57 @@ class IXCClient {
         return this;
     }
     /**
-     * Envia uma solicitação GET para a API do IXC, com o header `ixcsoft` definico como `listar`
+     * Envia uma requisição GET para a API do IXC, com o header `ixcsoft` definico como `listar`\
+     * A `query` dessa requisição não será enviada para o IXC com o parâmetro `grid_param`\
+     * Ou seja, esta requisição executa uma busca simples, em vez do filtro de grid
+     *
+     * @param id O identificador numérico do registro que será buscado no IXC
+     * @returns Promise<IXCResponse>
+     */
+    find(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            const params = {
+                TB: 'id',
+                OP: '=',
+                P: id
+            };
+            const opts = {
+                page: 1,
+                rowsPerPage: 1,
+            };
+            const axios = (0, request_1.createAxiosInstance)('GET');
+            const data = (0, request_1.createRequestPayload)(this.table, params, opts);
+            try {
+                const response = yield axios.get(this.table, { data });
+                if (response.status === 200) {
+                    return response.data;
+                }
+                return (0, response_1.createResponse)({
+                    error: true,
+                    message: (_a = response.data) === null || _a === void 0 ? void 0 : _a.message
+                });
+            }
+            catch (error) {
+                console.error(error);
+                return (0, response_1.createResponse)({
+                    error: true,
+                    message: ((_b = error.response) === null || _b === void 0 ? void 0 : _b.statusText) || error.message || 'Erro desconhecido'
+                });
+            }
+            finally {
+                this.params = [];
+                this.options = {
+                    page: 1,
+                    rowsPerPage: 20,
+                    sortName: 'id',
+                    sortOrder: 'asc'
+                };
+            }
+        });
+    }
+    /**
+     * Envia uma requisição GET para a API do IXC, com o header `ixcsoft` definico como `listar`
      * Preenche o corpo da requisição com os dados passados pela função `where` no formado JSON
      *
      * @param pg O número da página que será solicitada ao IXC `padão = 1`
@@ -89,9 +139,9 @@ class IXCClient {
             const _c = this.options, { page, rowsPerPage } = _c, rest = __rest(_c, ["page", "rowsPerPage"]);
             const opts = Object.assign({ page: pg !== null && pg !== void 0 ? pg : page, rowsPerPage: rows !== null && rows !== void 0 ? rows : rowsPerPage }, rest);
             const axios = (0, request_1.createAxiosInstance)('GET');
-            const payload = (0, request_1.createRequestPayload)(this.table, this.params, opts);
+            const data = (0, request_1.createRequestPayload)(this.table, this.params, opts);
             try {
-                const response = yield axios.get(this.table, payload);
+                const response = yield axios.get(this.table, { data });
                 if (response.status === 200) {
                     return response.data;
                 }

package/dist/request.d.ts

@@ -1,16 +1,20 @@
-import { AxiosInstance, AxiosRequestConfig } from 'axios';
+import { AxiosInstance } from 'axios';
 import { IXCOptions, IXCQuery, IXCRequest, IXCRequestMethods } from './types';
 /**
+ * Cria uma instância de um objeto AxiosInstance, pré-configurado com os cabeçalhos necessários
+ * para executar uma requisição para a API do IXC
  *
  * @param method GET | POST | PUT | DELETE
- * @returns A instância de um objeto do tipo AxiosInstance, pré-configurado com os cabeçalhos necessários
+ * @returns AxiosInstance
  */
 export declare function createAxiosInstance(method?: keyof typeof IXCRequestMethods): AxiosInstance;
 /**
+ * Cria um objeto `IXCRequest` configurado para ser utilizado como payload de uma requisição
+ * para a API do IXC
  *
  * @param table Nome da tabela do IXC onde será feita a busca, atualização, inserção ou remoção
  * @param params Parâmetros da busca (desconsiderados quando a ação for a de inserir novos registros)
  * @param options Parâmetros de formatação dos dados da responsta (página, ítens por página e ordenação)
- * @returns
+ * @returns IXCRequest
  */
-export declare function createRequestPayload(table: string, params: IXCQuery | IXCQuery[], options?: IXCOptions): AxiosRequestConfig<IXCRequest>;
+export declare function createRequestPayload(table: string, params: IXCQuery | IXCQuery[], options?: IXCOptions): IXCRequest;

package/dist/request.js

@@ -7,9 +7,11 @@ exports.createAxiosInstance = createAxiosInstance;
 exports.createRequestPayload = createRequestPayload;
 const axios_1 = __importDefault(require("axios"));
 /**
+ * Cria uma instância de um objeto AxiosInstance, pré-configurado com os cabeçalhos necessários
+ * para executar uma requisição para a API do IXC
  *
  * @param method GET | POST | PUT | DELETE
- * @returns A instância de um objeto do tipo AxiosInstance, pré-configurado com os cabeçalhos necessários
+ * @returns AxiosInstance
  */
 function createAxiosInstance(method = 'GET') {
     const host = process.env.IXC_HOST;
@@ -25,11 +27,13 @@ function createAxiosInstance(method = 'GET') {
     });
 }
 /**
+ * Cria um objeto `IXCRequest` configurado para ser utilizado como payload de uma requisição
+ * para a API do IXC
  *
  * @param table Nome da tabela do IXC onde será feita a busca, atualização, inserção ou remoção
  * @param params Parâmetros da busca (desconsiderados quando a ação for a de inserir novos registros)
  * @param options Parâmetros de formatação dos dados da responsta (página, ítens por página e ordenação)
- * @returns
+ * @returns IXCRequest
  */
 function createRequestPayload(table, params, options) {
     var _a, _b, _c, _d;
@@ -46,24 +50,24 @@ function createRequestPayload(table, params, options) {
                 P: p.P
             });
         });
-        return { data: {
-                qtype: table,
-                query: '',
-                oper: '',
-                page: page,
-                rp: rowsPerPage,
-                sortname: `${table}.${sortName}`,
-                sortorder: sortOrder,
-                grid_param: JSON.stringify(grid_param)
-            } };
-    }
-    return { data: {
-            qtype: `${table}.${params.TB}`,
-            query: params.P,
-            oper: params.OP || '=',
+        return {
+            qtype: table,
+            query: '',
+            oper: '',
             page: page,
             rp: rowsPerPage,
             sortname: `${table}.${sortName}`,
-            sortorder: sortOrder
-        } };
+            sortorder: sortOrder,
+            grid_param: JSON.stringify(grid_param)
+        };
+    }
+    return {
+        qtype: `${table}.${params.TB}`,
+        query: params.P,
+        oper: params.OP || '=',
+        page: page,
+        rp: rowsPerPage,
+        sortname: `${table}.${sortName}`,
+        sortorder: sortOrder
+    };
 }

package/dist/types.d.ts

@@ -40,7 +40,7 @@ export interface IXCRequest {
 }
 export interface IXCResponse {
     error?: boolean | object;
-    message?: string | null;
+    message?: string;
     id?: string | number;
     page: number | string;
     total: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ixc-orm",
-  "version": "1.4.3",
+  "version": "1.4.4",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "license": "MIT",