ixc-orm 1.5.1 → 1.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +16 -1
- package/README.md +79 -13
- package/dist/IxcOrm.d.ts +81 -0
- package/dist/IxcOrm.js +186 -0
- package/dist/IxcResponse.d.ts +44 -0
- package/dist/IxcResponse.js +95 -0
- package/dist/api/Environment.d.ts +11 -0
- package/dist/api/Environment.js +34 -0
- package/dist/api/Operators.d.ts +9 -0
- package/dist/api/Operators.js +13 -0
- package/dist/api/Ordering.d.ts +13 -0
- package/dist/api/Ordering.js +40 -0
- package/dist/api/Pagination.d.ts +8 -0
- package/dist/api/Pagination.js +22 -0
- package/dist/api/Parameter.d.ts +18 -0
- package/dist/api/Parameter.js +41 -0
- package/dist/api/RequestEmitter.d.ts +84 -0
- package/dist/api/RequestEmitter.js +193 -0
- package/dist/api/Utils.d.ts +7 -0
- package/dist/api/Utils.js +11 -0
- package/dist/index.d.ts +12 -2
- package/dist/index.js +54 -5
- package/dist/recursos/index.d.ts +44 -7
- package/dist/recursos/index.js +44 -5
- package/dist/types.d.ts +1 -0
- package/jest.config.ts +33 -0
- package/package.json +14 -6
- package/tsconfig.json +11 -3
- package/tsconfig.tsbuildinfo +1 -0
- package/dist/tsconfig.tsbuildinfo +0 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,4 +1,6 @@
|
|
|
1
1
|
# 🔄 CHANGELOG
|
|
2
|
+
- [v1.7.0 - 10 de outubro de 2025](#v170)
|
|
3
|
+
- [v1.6.0 - 16 de agosto de 2025](#v150)
|
|
2
4
|
- [v1.5.0 - 16 de agosto de 2025](#v150)
|
|
3
5
|
- [v1.4.4 - 15 de agosto de 2025](#v144)
|
|
4
6
|
- [v1.4.3 - 15 de agosto de 2025](#v143)
|
|
@@ -6,6 +8,19 @@
|
|
|
6
8
|
|
|
7
9
|
## 🚀 Novidades
|
|
8
10
|
|
|
11
|
+
### v1.7.0
|
|
12
|
+
* **Atualização:** Novas classes adiconadas, para simplificar a manipulação dos filtros de busca e das respostas da API do **IXC Provedor**.
|
|
13
|
+
* A nova classe <a href="https://github.com/SousaFelipe/ixc-orm/blob/builders/src/IxcOrm.ts">IxcOrm</a> pode substituir a classe `IXCCliente` e fornece uma maneira mais dinâmica de construir a query de busca, através dos métodos `where()`, `like()`, `exactly()`, `lessThan()`, `lessThanEquals()`, `greaterThan()` e `greaterThanEquals()`.
|
|
14
|
+
* Toda a lógica de manipulação das requisições HTTP foi movida para a nova classe <a href="https://github.com/SousaFelipe/ixc-orm/blob/builders/src/api/RequestEmitter.ts">RequestEmitter</a>, deixando a classe <a href="https://github.com/SousaFelipe/ixc-orm/blob/builders/src/IxcOrm.ts">IxcOrm</a> apenas com a lógica de manipulação da query de busca.
|
|
15
|
+
* Os dados da resposta recebida da API do IXC Provedor agora estão todos concentrados na classe <a href="https://github.com/SousaFelipe/ixc-orm/blob/builders/src/IxcResponse.ts">IxcResponse</a>, quando instanciada pelos métodos `GET()`, `POST()`, `PUT()` e `DELETE()`, da classe <a href="https://github.com/SousaFelipe/ixc-orm/blob/builders/src/api/RequestEmitter.ts">RequestEmitter</a>.
|
|
16
|
+
* A classe <a href="https://github.com/SousaFelipe/ixc-orm/blob/builders/src/IxcOrm.ts">IxcOrm</a> é uma subclasse de <a href="https://github.com/SousaFelipe/ixcorm/blob/builders/src/api/RequestEmitter.ts">RequestEmitter</a>.
|
|
17
|
+
|
|
18
|
+
### v1.6.0
|
|
19
|
+
* **Melhoria**: Métodos específicos para chamadas de recursos da API do **IXC Provedor**
|
|
20
|
+
* `desbloqueioDeConfianca()`: Envia uma requisição para o recurso de desbloqueio de confiança de um contrato.
|
|
21
|
+
* `liberacaoTemporaria()`: Envia uma requisição para o recurso de liberação temporária de um contrato.
|
|
22
|
+
* `getArquivoBoleto()`: Recupera o arquivo de uma fatura, no formato PDF, codificado em <a href="https://en.wikipedia.org/wiki/Base64">Base64</a>.
|
|
23
|
+
|
|
9
24
|
### v1.5.0
|
|
10
25
|
* **Melhoria:** A chamada de recursos da API agora pode ser feita de forma mais simplificada, através da função `RecursoIXC`:
|
|
11
26
|
* Basta importar assim: `import { RecursoIXC } from 'ixc-orm'`;
|
|
@@ -21,4 +36,4 @@
|
|
|
21
36
|
* **Correção:** Resolvido o bug de leitura das variáveis de ambiente no arquivo .env da pasta raiz do projeto.
|
|
22
37
|
* **Melhoria:** Foram adicionados 3 dos 44 recursos da API do IXC: `get_boleto`, `liberacao_temporaria` e `desbloqueio_confianca`. (Futuramente novos recursos serão adicionados)
|
|
23
38
|
|
|
24
|
-
> Consulte todos os recursos disponíveis: [Doc. API IXCSoft](https://wikiapiprovedor.ixcsoft.com.br/)
|
|
39
|
+
> Consulte todos os recursos disponíveis: [Doc. API IXCSoft](https://wikiapiprovedor.ixcsoft.com.br/)
|
package/README.md
CHANGED
|
@@ -1,8 +1,16 @@
|
|
|
1
|
-
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
# IXC-ORM
|
|
2
4
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
+

|
|
6
|
+
[](https://www.npmjs.com/package/ixc-orm)
|
|
7
|
+

|
|
8
|
+

|
|
9
|
+
|
|
10
|
+
Esse ORM visa facilitar o consumo de dados da API oficial do [IXC Provedor](https://ixcsoft.com/ixc-provedor).\
|
|
11
|
+
Essa biblioteca não faz parte das bibliotecas oficiais da [IXCsoft](https://ixcsoft.com/) e foi desenvolvida de forma independente e sem fins lucrativos.
|
|
5
12
|
|
|
13
|
+
</div>
|
|
6
14
|
|
|
7
15
|
|
|
8
16
|
## Instalação
|
|
@@ -16,10 +24,24 @@ yarn add ixc-orm
|
|
|
16
24
|
```
|
|
17
25
|
|
|
18
26
|
|
|
27
|
+
## Como utilizar
|
|
19
28
|
|
|
20
|
-
|
|
29
|
+
As classes que representarão as tabelas dentro do banco de dados do seu servidor IXC, deverão herdar da classe `IxcOrm` (nova versão), como no exemplo a seguir:
|
|
21
30
|
|
|
22
|
-
>
|
|
31
|
+
> [!NOTE]\
|
|
32
|
+
> Versão 1.7.0 `stable`
|
|
33
|
+
|
|
34
|
+
```typescript
|
|
35
|
+
import { IxcOrm } from 'ixc-orm';
|
|
36
|
+
|
|
37
|
+
class Contrato extends IxcOrm {
|
|
38
|
+
constructor() {
|
|
39
|
+
super('cliente_contrato');
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
> Versão 1.6.0 ou anterior
|
|
23
45
|
|
|
24
46
|
```typescript
|
|
25
47
|
import { IXCClient } 'ixc-orm';
|
|
@@ -31,7 +53,26 @@ class Contrato extends IXCClient {
|
|
|
31
53
|
}
|
|
32
54
|
```
|
|
33
55
|
|
|
34
|
-
|
|
56
|
+
Após instanciar um objeto com o tipo que você criou (`Contrato, como no exemplo a cima`), você poderá acessar os métodos de construção da query de busca.
|
|
57
|
+
|
|
58
|
+
> [!NOTE]\
|
|
59
|
+
> Versão 1.7.0 `stable`
|
|
60
|
+
|
|
61
|
+
```typescript
|
|
62
|
+
import { IxcResponse, Sort } from 'ixc-orm';
|
|
63
|
+
|
|
64
|
+
const contrato = new Contrato();
|
|
65
|
+
|
|
66
|
+
IxcResponse response = await contrato
|
|
67
|
+
.where('data_ativacao')
|
|
68
|
+
.greaterThanEquals('2024-09-24')
|
|
69
|
+
.orderBy('data_ativacao', Sort.DESC)
|
|
70
|
+
.GET();
|
|
71
|
+
|
|
72
|
+
const contratos = response.registros();
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
> Versão 1.6.0 ou anterior
|
|
35
76
|
|
|
36
77
|
```typescript
|
|
37
78
|
const contrato = new Contrato();
|
|
@@ -45,6 +86,9 @@ const contratos = await contrato
|
|
|
45
86
|
|
|
46
87
|
Ou quando você já possui o ID do registro que procura, a opção mais simples será utilizar o método `find()`. Este método também está implementado na classe `IXCClient`
|
|
47
88
|
|
|
89
|
+
> [!NOTE]
|
|
90
|
+
> Método disponível apenas para as subclasses de `IXCClient`.
|
|
91
|
+
|
|
48
92
|
```typescript
|
|
49
93
|
const contrato = new Contrato();
|
|
50
94
|
|
|
@@ -54,7 +98,6 @@ const contratos = await contrato.find(id_contrato)
|
|
|
54
98
|
```
|
|
55
99
|
|
|
56
100
|
|
|
57
|
-
|
|
58
101
|
## Recursos da API do IXC Provedor
|
|
59
102
|
|
|
60
103
|
Existem alguns `endpoints` que a API do IXC disponibiliza, a fim de "encurtar o caminho" para chegar até algumas informações. Como por exemplo, obter o arquivo PDF de uma fatura.\
|
|
@@ -62,11 +105,11 @@ Você não precisará se preocupar em criar uma classe `Boleto` que herde da cla
|
|
|
62
105
|
nem encadear chamadas `where`. Basta seguir o exemplo abaixo:
|
|
63
106
|
|
|
64
107
|
```typescript
|
|
65
|
-
import {
|
|
108
|
+
import { Recurso } from 'ixc-orm';
|
|
66
109
|
|
|
67
|
-
const
|
|
110
|
+
const id_contrato = 45852;
|
|
68
111
|
|
|
69
|
-
const response = await
|
|
112
|
+
const response = await Recurso.desbloqueioDeConfianca(id_contrato);
|
|
70
113
|
```
|
|
71
114
|
|
|
72
115
|
> Dos recursos disponibilizados pela API do **IXC Provedor**, esta biblioteca já implementou os seguintes recursos:\
|
|
@@ -74,15 +117,38 @@ const response = await RecursoIXC('get_boleto', { id_fatura })
|
|
|
74
117
|
> Obs: Os nomes dos recursos estão de acordo com a API do **IXC Provedor** a fim de facilitar o estudo de sua documentação oficial.
|
|
75
118
|
|
|
76
119
|
|
|
77
|
-
|
|
78
120
|
## Variáveis de Ambiente
|
|
79
121
|
|
|
80
122
|
Para configurar a comunicação da biblioteca com seu servidor IXC, é necessário adicionar as seguintes variáveis de ambiente a um arquivo `.env`, que esteja localizado no diretório raiz do seu projeto.
|
|
81
123
|
|
|
82
|
-
>
|
|
83
|
-
>
|
|
124
|
+
> [!NOTE]\
|
|
125
|
+
> Versão 1.7.0 `stable`
|
|
126
|
+
|
|
127
|
+
- **IXC_ACCESS_TOKEN** Um token de API gerado dentro do IXC Provedor.
|
|
128
|
+
- **IXC_SERVER_DOMAIN** O domínio do seu servidor IXC Provedor.
|
|
129
|
+
|
|
130
|
+
```ini
|
|
131
|
+
IXC_ACCESS_TOKEN=conteúdo-do-token-gerado-dentro-do-ixC
|
|
132
|
+
IXC_SERVER_DOMAIN=www.dominio-do-seu-servidor-ixc.com.br
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
|
|
136
|
+
> Versão 1.6.0 ou anterior:
|
|
137
|
+
|
|
138
|
+
- **IXC_HOST** A url do seu servidor **IXC Provedor**.
|
|
139
|
+
- **IXC_TOKEN** Um token de API gerado dentro do **IXC Provedor**.
|
|
84
140
|
|
|
85
141
|
```ini
|
|
86
142
|
IXC_HOST="https://dominiodoservidorixc.com.br/webservice/v1"
|
|
87
143
|
IXC_TOKEN="8:k4n8wk1946j7mimthei869cq1zz2u940f2gqobqg081y2oefl80mzhtq2wud3gqp"
|
|
88
144
|
```
|
|
145
|
+
|
|
146
|
+
|
|
147
|
+
# Contribuições
|
|
148
|
+
|
|
149
|
+
Contribuições são sempre bem-vindas!\
|
|
150
|
+
Se você conhece uma maneira melhor de fazer algo, por favor, me avise!
|
|
151
|
+
Caso contrário, é sempre melhor fazer um PR na branch main.
|
|
152
|
+
|
|
153
|
+
At.te,\
|
|
154
|
+
<b>Felipe S. Carmo</b>.
|
package/dist/IxcOrm.d.ts
ADDED
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
import { Sort } from './api/Ordering';
|
|
2
|
+
import RequestEmitter from './api/RequestEmitter';
|
|
3
|
+
export default abstract class IxcOrm extends RequestEmitter {
|
|
4
|
+
private ordering;
|
|
5
|
+
private pagination;
|
|
6
|
+
private parameters;
|
|
7
|
+
private parameterStub;
|
|
8
|
+
/**
|
|
9
|
+
* Método construtor da classe.
|
|
10
|
+
*
|
|
11
|
+
* @param table Representa o o nome da tabela que será manipulada, no IXC Provedor.
|
|
12
|
+
*/
|
|
13
|
+
protected constructor(table: string);
|
|
14
|
+
/**
|
|
15
|
+
* Inicia um novo objeto de parâmetro de busca do filtro da grid.
|
|
16
|
+
*
|
|
17
|
+
* @param column O nome da coluna onde o filtro de busca será executado.
|
|
18
|
+
* @returns A própria instância.
|
|
19
|
+
*/
|
|
20
|
+
where(column: string): IxcOrm;
|
|
21
|
+
/**
|
|
22
|
+
* Adiciona, ao último objeto de parâmetro iniciado, um valor a ser filtrado com o operador (**L**) = LIKE.
|
|
23
|
+
*
|
|
24
|
+
* @param value O valor a ser filtrado.
|
|
25
|
+
* @returns A própria instância.
|
|
26
|
+
*/
|
|
27
|
+
like(value: string | number): IxcOrm;
|
|
28
|
+
/**
|
|
29
|
+
* Adiciona, ao último objeto de parâmetro iniciado, um valor a ser filtrado com o operador (**=**) = EQUALS.
|
|
30
|
+
*
|
|
31
|
+
* @param value O valor a ser filtrado.
|
|
32
|
+
* @returns A própria instância.
|
|
33
|
+
*/
|
|
34
|
+
exactly(value: string | number): IxcOrm;
|
|
35
|
+
/**
|
|
36
|
+
* Adiciona, ao último objeto de parâmetro iniciado, um valor a ser filtrado com o operador (**<**) = LESS_THAN.
|
|
37
|
+
*
|
|
38
|
+
* @param value O valor a ser filtrado.
|
|
39
|
+
* @returns A própria instância.
|
|
40
|
+
*/
|
|
41
|
+
lessThan(value: string | number): IxcOrm;
|
|
42
|
+
/**
|
|
43
|
+
* Adiciona, ao último objeto de parâmetro iniciado, um valor a ser filtrado com o operador (**<=**) = LESS_THAN_EQUALS.
|
|
44
|
+
*
|
|
45
|
+
* @param value O valor a ser filtrado.
|
|
46
|
+
* @returns A própria instância.
|
|
47
|
+
*/
|
|
48
|
+
lessThanEquals(value: string | number): IxcOrm;
|
|
49
|
+
/**
|
|
50
|
+
* Adiciona, ao último objeto de parâmetro iniciado, um valor a ser filtrado com o operador (**>**) = GREATER_THAN.
|
|
51
|
+
*
|
|
52
|
+
* @param value O valor a ser filtrado.
|
|
53
|
+
* @returns A própria instância.
|
|
54
|
+
*/
|
|
55
|
+
greaterThan(value: string | number): IxcOrm;
|
|
56
|
+
/**
|
|
57
|
+
* Adiciona, ao último objeto de parâmetro iniciado, um valor a ser filtrado com o operador (**>=**) = GREATER_THAN_EQUALS.
|
|
58
|
+
*
|
|
59
|
+
* @param value O valor a ser filtrado.
|
|
60
|
+
* @returns A própria instância.
|
|
61
|
+
*/
|
|
62
|
+
greaterThanEquals(value: string | number): IxcOrm;
|
|
63
|
+
/**
|
|
64
|
+
* Define o número da página e a quantidade de registros por página que serão retornados pelo IXc Provedor.
|
|
65
|
+
*
|
|
66
|
+
* @param page A página a ser buscada.
|
|
67
|
+
* @param rows A quantidade de registros por página.
|
|
68
|
+
* @returns A própria instância.
|
|
69
|
+
*/
|
|
70
|
+
paginate(page: number, rows: number): this;
|
|
71
|
+
/**
|
|
72
|
+
* Define o tipo de ordenação dos registros retornados pela API do IXC Provedor.
|
|
73
|
+
*
|
|
74
|
+
* @param sort **ASC** ou **DESC**.
|
|
75
|
+
* @param column A coluna que será utilizada para ordenar os registros.
|
|
76
|
+
* @returns A própria instância.
|
|
77
|
+
*/
|
|
78
|
+
orderBy(column: string, sort: Sort): this;
|
|
79
|
+
private createQueryObject;
|
|
80
|
+
private addParamToGridAndResetStub;
|
|
81
|
+
}
|
package/dist/IxcOrm.js
ADDED
|
@@ -0,0 +1,186 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
|
3
|
+
if (k2 === undefined) k2 = k;
|
|
4
|
+
var desc = Object.getOwnPropertyDescriptor(m, k);
|
|
5
|
+
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
|
6
|
+
desc = { enumerable: true, get: function() { return m[k]; } };
|
|
7
|
+
}
|
|
8
|
+
Object.defineProperty(o, k2, desc);
|
|
9
|
+
}) : (function(o, m, k, k2) {
|
|
10
|
+
if (k2 === undefined) k2 = k;
|
|
11
|
+
o[k2] = m[k];
|
|
12
|
+
}));
|
|
13
|
+
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
|
|
14
|
+
Object.defineProperty(o, "default", { enumerable: true, value: v });
|
|
15
|
+
}) : function(o, v) {
|
|
16
|
+
o["default"] = v;
|
|
17
|
+
});
|
|
18
|
+
var __importStar = (this && this.__importStar) || (function () {
|
|
19
|
+
var ownKeys = function(o) {
|
|
20
|
+
ownKeys = Object.getOwnPropertyNames || function (o) {
|
|
21
|
+
var ar = [];
|
|
22
|
+
for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
|
|
23
|
+
return ar;
|
|
24
|
+
};
|
|
25
|
+
return ownKeys(o);
|
|
26
|
+
};
|
|
27
|
+
return function (mod) {
|
|
28
|
+
if (mod && mod.__esModule) return mod;
|
|
29
|
+
var result = {};
|
|
30
|
+
if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
|
|
31
|
+
__setModuleDefault(result, mod);
|
|
32
|
+
return result;
|
|
33
|
+
};
|
|
34
|
+
})();
|
|
35
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
36
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
37
|
+
};
|
|
38
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
39
|
+
const Operators_1 = __importDefault(require("./api/Operators"));
|
|
40
|
+
const Ordering_1 = __importStar(require("./api/Ordering"));
|
|
41
|
+
const Pagination_1 = __importDefault(require("./api/Pagination"));
|
|
42
|
+
const Parameter_1 = __importDefault(require("./api/Parameter"));
|
|
43
|
+
const RequestEmitter_1 = __importDefault(require("./api/RequestEmitter"));
|
|
44
|
+
class IxcOrm extends RequestEmitter_1.default {
|
|
45
|
+
/**
|
|
46
|
+
* Método construtor da classe.
|
|
47
|
+
*
|
|
48
|
+
* @param table Representa o o nome da tabela que será manipulada, no IXC Provedor.
|
|
49
|
+
*/
|
|
50
|
+
constructor(table) {
|
|
51
|
+
super(table);
|
|
52
|
+
this.ordering = Ordering_1.default.ascBy(table, "id");
|
|
53
|
+
this.pagination = Pagination_1.default.defaults();
|
|
54
|
+
this.parameters = [];
|
|
55
|
+
this.parameterStub = new Parameter_1.default(table);
|
|
56
|
+
}
|
|
57
|
+
/**
|
|
58
|
+
* Inicia um novo objeto de parâmetro de busca do filtro da grid.
|
|
59
|
+
*
|
|
60
|
+
* @param column O nome da coluna onde o filtro de busca será executado.
|
|
61
|
+
* @returns A própria instância.
|
|
62
|
+
*/
|
|
63
|
+
where(column) {
|
|
64
|
+
this.parameterStub.withType(column);
|
|
65
|
+
return this;
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* Adiciona, ao último objeto de parâmetro iniciado, um valor a ser filtrado com o operador (**L**) = LIKE.
|
|
69
|
+
*
|
|
70
|
+
* @param value O valor a ser filtrado.
|
|
71
|
+
* @returns A própria instância.
|
|
72
|
+
*/
|
|
73
|
+
like(value) {
|
|
74
|
+
this.parameterStub.withOperator(Operators_1.default.LIKE);
|
|
75
|
+
this.parameterStub.withValue(value);
|
|
76
|
+
this.addParamToGridAndResetStub();
|
|
77
|
+
super.setupQuery(this.createQueryObject());
|
|
78
|
+
return this;
|
|
79
|
+
}
|
|
80
|
+
/**
|
|
81
|
+
* Adiciona, ao último objeto de parâmetro iniciado, um valor a ser filtrado com o operador (**=**) = EQUALS.
|
|
82
|
+
*
|
|
83
|
+
* @param value O valor a ser filtrado.
|
|
84
|
+
* @returns A própria instância.
|
|
85
|
+
*/
|
|
86
|
+
exactly(value) {
|
|
87
|
+
this.parameterStub.withOperator(Operators_1.default.EQUALS);
|
|
88
|
+
this.parameterStub.withValue(value);
|
|
89
|
+
this.addParamToGridAndResetStub();
|
|
90
|
+
super.setupQuery(this.createQueryObject());
|
|
91
|
+
return this;
|
|
92
|
+
}
|
|
93
|
+
/**
|
|
94
|
+
* Adiciona, ao último objeto de parâmetro iniciado, um valor a ser filtrado com o operador (**<**) = LESS_THAN.
|
|
95
|
+
*
|
|
96
|
+
* @param value O valor a ser filtrado.
|
|
97
|
+
* @returns A própria instância.
|
|
98
|
+
*/
|
|
99
|
+
lessThan(value) {
|
|
100
|
+
this.parameterStub.withOperator(Operators_1.default.LESS_THAN);
|
|
101
|
+
this.parameterStub.withValue(value);
|
|
102
|
+
this.addParamToGridAndResetStub();
|
|
103
|
+
super.setupQuery(this.createQueryObject());
|
|
104
|
+
return this;
|
|
105
|
+
}
|
|
106
|
+
/**
|
|
107
|
+
* Adiciona, ao último objeto de parâmetro iniciado, um valor a ser filtrado com o operador (**<=**) = LESS_THAN_EQUALS.
|
|
108
|
+
*
|
|
109
|
+
* @param value O valor a ser filtrado.
|
|
110
|
+
* @returns A própria instância.
|
|
111
|
+
*/
|
|
112
|
+
lessThanEquals(value) {
|
|
113
|
+
this.parameterStub.withOperator(Operators_1.default.LESS_THAN_EQUALS);
|
|
114
|
+
this.parameterStub.withValue(value);
|
|
115
|
+
this.addParamToGridAndResetStub();
|
|
116
|
+
super.setupQuery(this.createQueryObject());
|
|
117
|
+
return this;
|
|
118
|
+
}
|
|
119
|
+
/**
|
|
120
|
+
* Adiciona, ao último objeto de parâmetro iniciado, um valor a ser filtrado com o operador (**>**) = GREATER_THAN.
|
|
121
|
+
*
|
|
122
|
+
* @param value O valor a ser filtrado.
|
|
123
|
+
* @returns A própria instância.
|
|
124
|
+
*/
|
|
125
|
+
greaterThan(value) {
|
|
126
|
+
this.parameterStub.withOperator(Operators_1.default.GREATER_THAN);
|
|
127
|
+
this.parameterStub.withValue(value);
|
|
128
|
+
this.addParamToGridAndResetStub();
|
|
129
|
+
super.setupQuery(this.createQueryObject());
|
|
130
|
+
return this;
|
|
131
|
+
}
|
|
132
|
+
/**
|
|
133
|
+
* Adiciona, ao último objeto de parâmetro iniciado, um valor a ser filtrado com o operador (**>=**) = GREATER_THAN_EQUALS.
|
|
134
|
+
*
|
|
135
|
+
* @param value O valor a ser filtrado.
|
|
136
|
+
* @returns A própria instância.
|
|
137
|
+
*/
|
|
138
|
+
greaterThanEquals(value) {
|
|
139
|
+
this.parameterStub.withOperator(Operators_1.default.GREATER_THAN_EQUALS);
|
|
140
|
+
this.parameterStub.withValue(value);
|
|
141
|
+
this.addParamToGridAndResetStub();
|
|
142
|
+
super.setupQuery(this.createQueryObject());
|
|
143
|
+
return this;
|
|
144
|
+
}
|
|
145
|
+
/**
|
|
146
|
+
* Define o número da página e a quantidade de registros por página que serão retornados pelo IXc Provedor.
|
|
147
|
+
*
|
|
148
|
+
* @param page A página a ser buscada.
|
|
149
|
+
* @param rows A quantidade de registros por página.
|
|
150
|
+
* @returns A própria instância.
|
|
151
|
+
*/
|
|
152
|
+
paginate(page, rows) {
|
|
153
|
+
this.pagination = new Pagination_1.default(page, rows);
|
|
154
|
+
return this;
|
|
155
|
+
}
|
|
156
|
+
/**
|
|
157
|
+
* Define o tipo de ordenação dos registros retornados pela API do IXC Provedor.
|
|
158
|
+
*
|
|
159
|
+
* @param sort **ASC** ou **DESC**.
|
|
160
|
+
* @param column A coluna que será utilizada para ordenar os registros.
|
|
161
|
+
* @returns A própria instância.
|
|
162
|
+
*/
|
|
163
|
+
orderBy(column, sort) {
|
|
164
|
+
this.ordering = (sort === Ordering_1.Sort.ASC)
|
|
165
|
+
? Ordering_1.default.ascBy(super.getTable(), column)
|
|
166
|
+
: Ordering_1.default.descBy(super.getTable(), column);
|
|
167
|
+
return this;
|
|
168
|
+
}
|
|
169
|
+
createQueryObject() {
|
|
170
|
+
return {
|
|
171
|
+
qtype: super.getTable(),
|
|
172
|
+
query: "",
|
|
173
|
+
oper: "",
|
|
174
|
+
page: this.pagination.getPage(),
|
|
175
|
+
rp: this.pagination.getRows(),
|
|
176
|
+
sortname: this.ordering.getSortName(),
|
|
177
|
+
sortorder: this.ordering.getSortOrder().toString(),
|
|
178
|
+
grid_param: JSON.stringify(this.parameters)
|
|
179
|
+
};
|
|
180
|
+
}
|
|
181
|
+
addParamToGridAndResetStub() {
|
|
182
|
+
this.parameters.push(this.parameterStub.toJsonObject());
|
|
183
|
+
this.parameterStub = new Parameter_1.default(super.getTable());
|
|
184
|
+
}
|
|
185
|
+
}
|
|
186
|
+
exports.default = IxcOrm;
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
export default class IxcResponse {
|
|
2
|
+
private data;
|
|
3
|
+
/**
|
|
4
|
+
* Cria um novo objeto no formato de uma resposta padrão do IXC Provedor.
|
|
5
|
+
*
|
|
6
|
+
* @param error Uma exceção capturada por um bloco try-catch.
|
|
7
|
+
* @returns Um objeto de resposta do IXC Provedor.
|
|
8
|
+
*/
|
|
9
|
+
static createPropsWithError(error: any): string;
|
|
10
|
+
/**
|
|
11
|
+
* Método construtor da classe.
|
|
12
|
+
*
|
|
13
|
+
* @param text O conteúdo da resposta do IXc Provedor, no formato de texto.
|
|
14
|
+
*/
|
|
15
|
+
constructor(text: string);
|
|
16
|
+
/**
|
|
17
|
+
* Obtém a quantidade total dos registros encontrados no banco de dados, além dos retornados na página atual.
|
|
18
|
+
*
|
|
19
|
+
* @returns O total de registros encontrados.
|
|
20
|
+
*/
|
|
21
|
+
total(): number;
|
|
22
|
+
/**
|
|
23
|
+
* Obtém o número da página atual dos registros retornados.
|
|
24
|
+
*
|
|
25
|
+
* @returns O valor numérico da página.
|
|
26
|
+
*/
|
|
27
|
+
page(): number;
|
|
28
|
+
/**
|
|
29
|
+
* Obtém uma mensagem retornada pelo IXC quando a requisição falha.
|
|
30
|
+
*
|
|
31
|
+
* @returns Uma mensagem de falha.
|
|
32
|
+
*/
|
|
33
|
+
message(): string;
|
|
34
|
+
/**
|
|
35
|
+
* Obtém a lista de registros retornados por uma consulta à API do IXC Provedor.
|
|
36
|
+
*
|
|
37
|
+
* @returns Uma lista de objetos.
|
|
38
|
+
*/
|
|
39
|
+
registros(): Array<{
|
|
40
|
+
[key: string]: any;
|
|
41
|
+
}>;
|
|
42
|
+
private parseDataFromText;
|
|
43
|
+
private parseDataFromHTML;
|
|
44
|
+
}
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
const jsdom_1 = require("jsdom");
|
|
4
|
+
class IxcResponse {
|
|
5
|
+
/**
|
|
6
|
+
* Cria um novo objeto no formato de uma resposta padrão do IXC Provedor.
|
|
7
|
+
*
|
|
8
|
+
* @param error Uma exceção capturada por um bloco try-catch.
|
|
9
|
+
* @returns Um objeto de resposta do IXC Provedor.
|
|
10
|
+
*/
|
|
11
|
+
static createPropsWithError(error) {
|
|
12
|
+
var _a;
|
|
13
|
+
const response = {
|
|
14
|
+
type: 'error',
|
|
15
|
+
page: 0,
|
|
16
|
+
total: 0,
|
|
17
|
+
registros: [],
|
|
18
|
+
message: ((_a = error.response) === null || _a === void 0 ? void 0 : _a.statusText) || error.message || 'Erro desconhecido'
|
|
19
|
+
};
|
|
20
|
+
return JSON.stringify(response);
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* Método construtor da classe.
|
|
24
|
+
*
|
|
25
|
+
* @param text O conteúdo da resposta do IXc Provedor, no formato de texto.
|
|
26
|
+
*/
|
|
27
|
+
constructor(text) {
|
|
28
|
+
this.data = this.parseDataFromText(text);
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
* Obtém a quantidade total dos registros encontrados no banco de dados, além dos retornados na página atual.
|
|
32
|
+
*
|
|
33
|
+
* @returns O total de registros encontrados.
|
|
34
|
+
*/
|
|
35
|
+
total() {
|
|
36
|
+
var _a;
|
|
37
|
+
if (!((_a = this.data) === null || _a === void 0 ? void 0 : _a.total)) {
|
|
38
|
+
return 0;
|
|
39
|
+
}
|
|
40
|
+
return this.data.total;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* Obtém o número da página atual dos registros retornados.
|
|
44
|
+
*
|
|
45
|
+
* @returns O valor numérico da página.
|
|
46
|
+
*/
|
|
47
|
+
page() {
|
|
48
|
+
var _a;
|
|
49
|
+
if (!((_a = this.data) === null || _a === void 0 ? void 0 : _a.page)) {
|
|
50
|
+
return 0;
|
|
51
|
+
}
|
|
52
|
+
return this.data.page;
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* Obtém uma mensagem retornada pelo IXC quando a requisição falha.
|
|
56
|
+
*
|
|
57
|
+
* @returns Uma mensagem de falha.
|
|
58
|
+
*/
|
|
59
|
+
message() {
|
|
60
|
+
var _a;
|
|
61
|
+
if (!((_a = this.data) === null || _a === void 0 ? void 0 : _a.message)) {
|
|
62
|
+
return '';
|
|
63
|
+
}
|
|
64
|
+
return this.data.message;
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* Obtém a lista de registros retornados por uma consulta à API do IXC Provedor.
|
|
68
|
+
*
|
|
69
|
+
* @returns Uma lista de objetos.
|
|
70
|
+
*/
|
|
71
|
+
registros() {
|
|
72
|
+
var _a;
|
|
73
|
+
if (!((_a = this.data) === null || _a === void 0 ? void 0 : _a.registros)) {
|
|
74
|
+
return [];
|
|
75
|
+
}
|
|
76
|
+
return this.data.registros;
|
|
77
|
+
}
|
|
78
|
+
parseDataFromText(text) {
|
|
79
|
+
const isValidHTML = (text === null || text === void 0 ? void 0 : text.length) && text.includes('<div style=');
|
|
80
|
+
if (isValidHTML) {
|
|
81
|
+
return this.parseDataFromHTML(text);
|
|
82
|
+
}
|
|
83
|
+
return JSON.parse(text);
|
|
84
|
+
}
|
|
85
|
+
parseDataFromHTML(html) {
|
|
86
|
+
const dom = new jsdom_1.JSDOM(html);
|
|
87
|
+
return {
|
|
88
|
+
type: 'error',
|
|
89
|
+
page: 0,
|
|
90
|
+
total: 0,
|
|
91
|
+
message: dom.window.document.body.textContent
|
|
92
|
+
};
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
exports.default = IxcResponse;
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
export default class Environment {
|
|
2
|
+
private static instance;
|
|
3
|
+
private domain;
|
|
4
|
+
private token;
|
|
5
|
+
static getInstance(): Environment;
|
|
6
|
+
private constructor();
|
|
7
|
+
getDomain(): string;
|
|
8
|
+
getToken(): string;
|
|
9
|
+
setDomain(domain?: string): void;
|
|
10
|
+
setToken(token?: string): void;
|
|
11
|
+
}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
class Environment {
|
|
4
|
+
static getInstance() {
|
|
5
|
+
if (!Environment.instance) {
|
|
6
|
+
Environment.instance = new Environment();
|
|
7
|
+
}
|
|
8
|
+
return Environment.instance;
|
|
9
|
+
}
|
|
10
|
+
constructor() { }
|
|
11
|
+
getDomain() {
|
|
12
|
+
return this.domain;
|
|
13
|
+
}
|
|
14
|
+
getToken() {
|
|
15
|
+
return this.token;
|
|
16
|
+
}
|
|
17
|
+
setDomain(domain) {
|
|
18
|
+
var _a;
|
|
19
|
+
const newDomainIsValid = !(!(domain === null || domain === void 0 ? void 0 : domain.length));
|
|
20
|
+
const oldDomainIsValid = !((_a = this.domain) === null || _a === void 0 ? void 0 : _a.length);
|
|
21
|
+
if (newDomainIsValid && oldDomainIsValid) {
|
|
22
|
+
this.domain = domain;
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
setToken(token) {
|
|
26
|
+
var _a;
|
|
27
|
+
const newTokenIsValid = !(!(token === null || token === void 0 ? void 0 : token.length));
|
|
28
|
+
const oldTokenisValid = !((_a = this.token) === null || _a === void 0 ? void 0 : _a.length);
|
|
29
|
+
if (newTokenIsValid && oldTokenisValid) {
|
|
30
|
+
this.token = token;
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
exports.default = Environment;
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
var Operators;
|
|
4
|
+
(function (Operators) {
|
|
5
|
+
Operators["EQUALS"] = "=";
|
|
6
|
+
Operators["LIKE"] = "L";
|
|
7
|
+
Operators["LESS_THAN"] = "<";
|
|
8
|
+
Operators["LESS_THAN_EQUALS"] = "<=";
|
|
9
|
+
Operators["GREATER_THAN"] = ">";
|
|
10
|
+
Operators["GREATER_THAN_EQUALS"] = ">=";
|
|
11
|
+
})(Operators || (Operators = {}));
|
|
12
|
+
;
|
|
13
|
+
exports.default = Operators;
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
export declare enum Sort {
|
|
2
|
+
ASC = "asc",
|
|
3
|
+
DESC = "desc"
|
|
4
|
+
}
|
|
5
|
+
export default class Ordering {
|
|
6
|
+
private sortName;
|
|
7
|
+
private sortOrder;
|
|
8
|
+
static ascBy(table: string, column: string): Ordering;
|
|
9
|
+
static descBy(table: string, column: string): Ordering;
|
|
10
|
+
constructor(sortName: string, sortOrder: Sort);
|
|
11
|
+
getSortName(): string;
|
|
12
|
+
getSortOrder(): Sort;
|
|
13
|
+
}
|