@sharpfy/nextapi 0.0.0-stage → 0.2.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/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Sharpfy
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,256 @@
1
- # Temporary Holding Version
1
+ # NextAPI para Node.js e TypeScript (`@sharpfy/nextapi`)
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ SDK oficial da [NextAPI](https://nextapi.com.br) para Node.js 22+: CNPJ (inclusive alfanumérico), Simples Nacional, inscrições estaduais, conformidade, sócios, CEP com busca geográfica, pesquisa de empresas, localidades, mercado e créditos. Sem dependências: usa o `fetch` nativo. Tipos inclusos, ESM e CommonJS.
4
+
5
+ ## Requisitos
6
+
7
+ - Node.js 22 ou mais recente (testado no 22 e no 26)
8
+ - Uma chave de API (veja abaixo)
9
+
10
+ ## Instalação
11
+
12
+ ```bash
13
+ npm install @sharpfy/nextapi
14
+ ```
15
+
16
+ ## Chave de API
17
+
18
+ Crie a sua em [app.nextapi.com.br](https://app.nextapi.com.br). São dois tipos:
19
+
20
+ | Prefixo | Ambiente | Custo |
21
+ |---|---|---|
22
+ | `nxa_test_…` | Sandbox: dados de um subconjunto real, limites próprios e CNPJs de teste que provocam cada erro | Nenhum: nada é debitado |
23
+ | `nxa_live_…` | Produção | Créditos do seu plano |
24
+
25
+ O ambiente sai do prefixo da chave; o endereço da API é o mesmo. Guarde a chave na variável de ambiente
26
+ `NEXTAPI_KEY`, que o cliente lê quando você não passa a chave. **Nunca** a coloque no código, no repositório ou num
27
+ front-end: quem tem a chave consome os seus créditos.
28
+
29
+ ## Início rápido
30
+
31
+ ```ts
32
+ import { NextApiClient } from '@sharpfy/nextapi';
33
+
34
+ const nextapi = new NextApiClient(); // lê NEXTAPI_KEY
35
+
36
+ const empresa = await nextapi.cnpj.consultar('11.222.333/0001-81');
37
+ console.log(empresa.razaoSocial, empresa.situacaoCadastral);
38
+ ```
39
+
40
+ CommonJS: `const { NextApiClient } = require('@sharpfy/nextapi');`
41
+
42
+ ## Configuração
43
+
44
+ ```ts
45
+ const nextapi = new NextApiClient({
46
+ apiKey: process.env.NEXTAPI_KEY, // padrão: NEXTAPI_KEY
47
+ baseUrl: 'https://api.nextapi.com.br', // só https (http apenas para localhost)
48
+ timeoutMs: 15_000, // por tentativa; padrão 30 000
49
+ maxRetries: 3, // padrão 2; 0 desliga
50
+ appInfo: 'minha-app/1.4.0', // identifica a sua aplicação
51
+ // fetch: undiciFetch, // fetch próprio (proxy, instrumentação, testes)
52
+ });
53
+ ```
54
+
55
+ | Opção | Padrão | Efeito |
56
+ |---|---|---|
57
+ | `apiKey` | `NEXTAPI_KEY` | Chave de API; o prefixo define o ambiente (`nextapi.environment`) |
58
+ | `baseUrl` | `https://api.nextapi.com.br` | Endereço da API |
59
+ | `timeoutMs` | 30 000 | Tempo limite de cada tentativa, em ms |
60
+ | `maxRetries` | 2 | Novas tentativas em falha transitória, só em GET |
61
+ | `appInfo` | — | Nome e versão da sua aplicação, nos cabeçalhos |
62
+ | `fetch` | `globalThis.fetch` | Implementação de `fetch` |
63
+
64
+ ### Cancelamento
65
+
66
+ Todo método aceita `signal` (um `AbortSignal`), que interrompe a chamada e as novas tentativas:
67
+
68
+ ```ts
69
+ const empresa = await nextapi.cnpj.consultar(cnpj, { signal: AbortSignal.timeout(5_000) });
70
+ ```
71
+
72
+ ### Express, Fastify, Next.js
73
+
74
+ Crie o cliente uma vez, no carregamento do módulo, e use em todas as rotas:
75
+
76
+ <!-- readme-check: ignorar (depende do framework) -->
77
+ ```ts
78
+ // lib/nextapi.ts
79
+ export const nextapi = new NextApiClient({ appInfo: 'loja/3.1' });
80
+
81
+ // app.get('/fornecedores/:cnpj', ...)
82
+ res.json(await nextapi.cnpj.consultar(req.params.cnpj));
83
+ ```
84
+
85
+ **Não use no navegador:** a chave ficaria visível a qualquer visitante. Chame a NextAPI do seu servidor.
86
+
87
+ ## Exemplos
88
+
89
+ ### CNPJ
90
+
91
+ ```ts
92
+ // Cadastro (1 crédito). toleranceDays: idade máxima aceita do dado em cache (0 a 45); 0 força tempo real.
93
+ const empresa = await nextapi.cnpj.consultar('11222333000181', { toleranceDays: 30 });
94
+ const aoVivo = await nextapi.cnpj.consultarAoVivo('11222333000181'); // tempo real; exige plano que permita
95
+
96
+ const simples = await nextapi.cnpj.obterSimples('11222333000181');
97
+ const ies = await nextapi.cnpj.obterInscricoesEstaduais('11222333000181');
98
+ const conformidade = await nextapi.cnpj.obterConformidade('11222333000181'); // sanções e dívida ativa
99
+ const alfanumerico = await nextapi.cnpj.consultar('12.ABC.345/01DE-35');
100
+ ```
101
+
102
+ ### Lotes (até 100 CNPJs)
103
+
104
+ ```ts
105
+ const lote = await nextapi.cnpj.consultarLote(['11222333000181', '45997418000153']); // 1 crédito por CNPJ encontrado
106
+ const simplesLote = await nextapi.cnpj.obterSimplesLote(['11222333000181']);
107
+
108
+ // Mais de 100: divida em blocos. Lote nunca é repetido sozinho; decida você numa falha.
109
+ for (let i = 0; i < todos.length; i += 100) {
110
+ resultados.push(...(await nextapi.cnpj.consultarLote(todos.slice(i, i + 100))));
111
+ }
112
+ ```
113
+
114
+ ### Sócios e grupo econômico
115
+
116
+ ```ts
117
+ const rel = await nextapi.cnpj.obterRelacionamentos('11222333000181', { page: 1, pageSize: 50 });
118
+ for (const socio of rel.socios ?? []) {
119
+ // hashSocio só é estável quando vinculoVerificavel é true: não guarde os provisórios.
120
+ const empresas = await nextapi.socios.listarEmpresas(socio.hashSocio!);
121
+ }
122
+ ```
123
+
124
+ ### CEP
125
+
126
+ ```ts
127
+ const cep = await nextapi.ceps.consultar('01001-000');
128
+ const porRua = await nextapi.ceps.buscar({ uf: 'SP', nomeMunicipio: 'São Paulo', logradouro: 'Paulista' });
129
+ const raio = await nextapi.ceps.buscarProximos({ latitude: -23.5505, longitude: -46.6333, raioMetro: 500 });
130
+ const vizinhos = await nextapi.ceps.buscarProximosDoCep('01001000', { raioMetro: 1000, pageSize: 100 });
131
+ ```
132
+
133
+ ### Pesquisa de empresas, com paginação
134
+
135
+ ```ts
136
+ for (let page = 1; ; page++) {
137
+ const pagina = await nextapi.empresas.pesquisar({
138
+ uf: 'SP',
139
+ cnaes: '1091101', // vários: separados por vírgula
140
+ dataAberturaInicio: '2024-01-01',
141
+ page,
142
+ pageSize: 100,
143
+ });
144
+ for (const e of pagina.items) console.log(e.cnpj, e.razaoSocial);
145
+ if (page * pagina.pageSize >= pagina.total) break;
146
+ }
147
+ ```
148
+
149
+ ### Localidades, mercado e créditos
150
+
151
+ ```ts
152
+ const estados = await nextapi.estados.listar();
153
+ const municipios = await nextapi.municipios.listar({ uf: 'MG', pageSize: 100 });
154
+ const bh = await nextapi.municipios.obterPorId(3106200);
155
+ const cnaes = await nextapi.cnaes.listar({ page: 1, pageSize: 50 });
156
+
157
+ const mercado = await nextapi.mercado.obterCnae('1091101', { uf: 'SP', meses: 12 });
158
+ const creditos = await nextapi.creditos.consultar();
159
+ console.log(`restam ${creditos.totalRemainingCredits} créditos`);
160
+ ```
161
+
162
+ ## Erros
163
+
164
+ Toda falha vira uma exceção do SDK; a classe diz o que fazer, e o código detalha.
165
+
166
+ | Classe | Quando | Status / código | O que fazer |
167
+ |---|---|---|---|
168
+ | `NextApiAuthenticationError` | Chave ausente, inválida ou revogada | 401 / 1002, 400 / 1001 | Confira a chave e o ambiente |
169
+ | `NextApiInsufficientCreditsError` | Créditos do período acabaram | 405 / 1004, 1006 | Aguarde a renovação ou compre créditos avulsos |
170
+ | `NextApiPaidPlanRequiredError` | Recurso exige plano pago | 405 / 1012, 1005 | Mude de plano |
171
+ | `NextApiNotFoundError` | CNPJ, CEP ou município não existe | 404 / 1000 | Trate como resultado, não como falha |
172
+ | `NextApiValidationError` | Entrada recusada pela API ou pelo SDK | 400 / 1007, ou status 0 | Corrija a entrada; não repita |
173
+ | `NextApiRateLimitError` | Limite de requisições por minuto | 429 / 1003 | Já repetido sozinho; diminua o ritmo |
174
+ | `NextApiServerError` | Falha da API ou do provedor externo | 5xx / 1014, 9999 | 503 é repetido sozinho; persistindo, fale com o suporte |
175
+ | `NextApiConnectionError` | Rede, tempo esgotado ou redirecionamento | status 0 | Verifique a conexão; GETs já foram repetidos |
176
+
177
+ Todas trazem o status HTTP, o código da API, a mensagem, o corpo da resposta e o **request id**. Ao falar com o
178
+ suporte, mande o request id: ele localiza a requisição nos nossos logs.
179
+
180
+ ```ts
181
+ import {
182
+ NextApiError, NextApiNotFoundError, NextApiInsufficientCreditsError, NextApiRateLimitError,
183
+ } from '@sharpfy/nextapi';
184
+
185
+ try {
186
+ const empresa = await nextapi.cnpj.consultar(cnpj);
187
+ } catch (err) {
188
+ if (err instanceof NextApiNotFoundError) return null;
189
+ if (err instanceof NextApiInsufficientCreditsError) alertar(`sem créditos (${err.requestId})`);
190
+ else if (err instanceof NextApiRateLimitError) await esperar(err.retryAfterMs ?? 5_000);
191
+ else if (err instanceof NextApiError) console.error(err.status, err.code, err.message, err.requestId);
192
+ else throw err;
193
+ }
194
+ ```
195
+
196
+ ## Comportamento
197
+
198
+ **Novas tentativas.** Só requisições `GET` são repetidas, e só em falha transitória: `429`, `502`, `503`, `504` e
199
+ erro de rede. O cliente respeita o `Retry-After` da resposta (até 60 s); sem ele, espera de 0,5 s a 8 s, com
200
+ crescimento exponencial e variação aleatória. Os lotes (`POST`) **nunca** são repetidos sozinhos, porque consomem
201
+ créditos: numa falha, decida você se repete. O padrão é 2 novas tentativas; `maxRetries: 0` desliga.
202
+
203
+ **Tempo limite.** `timeoutMs` por tentativa (padrão 30 s). Com novas tentativas, o tempo total pode passar disso.
204
+
205
+ **Validação local.** Entrada que a API recusaria com certeza nem sai do processo: vira
206
+ `NextApiValidationError` (status 0) antes da requisição. É o caso de CNPJ com tamanho ou dígitos verificadores errados,
207
+ lote vazio ou acima de 100, CEP sem 8 dígitos, raio menor ou igual a zero e latitude ou longitude fora da faixa.
208
+ CNPJ e CEP aceitam pontuação (`11.222.333/0001-81`, `01001-000`).
209
+
210
+ **CNPJ alfanumérico.** O formato novo da Receita (IN RFB 2.229/2024, a partir de julho de 2026) é aceito em todos os
211
+ métodos de CNPJ: `12.ABC.345/01DE-35` vira `12ABC34501DE35`, com letras em maiúsculas.
212
+
213
+ **Segurança.** A chave não aparece em logs, mensagens de erro nem na representação do cliente. O cliente não segue
214
+ redirecionamento, para a chave nunca ir para outro host, e só aceita `https` no `baseUrl` (`http` apenas para
215
+ `localhost`).
216
+
217
+ **Cabeçalhos enviados.** Além da autorização, cada requisição leva `User-Agent`, `X-NextApi-Client`
218
+ (`typescript/<versão>`) e `X-NextApi-Client-Info` (runtime, sistema e o seu `appInfo`). Servem para o suporte e para
219
+ medirmos o uso de cada versão; não carregam dado do seu negócio. O `appInfo` passa por um filtro: só
220
+ `A-Za-z0-9._/@+-`, até 64 caracteres.
221
+
222
+ **Reuso.** Crie um cliente e reutilize: ele não guarda estado entre chamadas e pode ser usado em paralelo (`Promise.all`).
223
+
224
+ ## Sandbox
225
+
226
+ Com a chave `nxa_test_`, estes CNPJs provocam cada resposta da API, para você testar o tratamento de erro sem
227
+ gastar nada:
228
+
229
+ | CNPJ | Resposta |
230
+ |---|---|
231
+ | `99999991000125` | 404, não encontrado |
232
+ | `99999992000170` | 405 / 1004, sem créditos |
233
+ | `99999993000114` | 429 / 1003, limite por minuto |
234
+ | `99999994000169` | 503 / 1014, falha do provedor |
235
+ | `99999995000103` | sucesso depois de 8 s (consulta lenta) |
236
+ | `99999996000158` | 405 / 1012, exige plano pago |
237
+ | `99999997000100` | 401 / 1002, chave inválida |
238
+
239
+ O sandbox tem limite próprio de requisições por minuto e por dia, e os dados vêm de um subconjunto real: um CNPJ ou
240
+ CEP pode existir em produção e não no sandbox.
241
+
242
+ ## Testes
243
+
244
+ Os testes não usam rede: conferem cada método contra o contrato da API, em `contract/cases.json` (rota, parâmetros, corpo, respostas e erros).
245
+
246
+ ```bash
247
+ docker run --rm -v "$PWD":/src -w /src node:22 sh -c "npm ci && npm test"
248
+ ```
249
+
250
+ Com `NEXTAPI_SMOKE_KEY` definida (e `NEXTAPI_SMOKE_ENV=sandbox` ou `production`), roda também a fumaça contra a API
251
+ publicada, com os passos de `contract/smoke.json`.
252
+
253
+ ## Suporte e licença
254
+
255
+ Dúvidas e problemas: abra uma issue neste repositório ou escreva pelo [app.nextapi.com.br](https://app.nextapi.com.br),
256
+ com o request id do erro. Licença MIT.
@@ -0,0 +1,53 @@
1
+ import type { NextApiClientOptions } from './types.js';
2
+ import { CnpjResource } from './resources/cnpj.js';
3
+ import { SociosResource } from './resources/socios.js';
4
+ import { CepsResource } from './resources/ceps.js';
5
+ import { EmpresasResource } from './resources/empresas.js';
6
+ import { CnaesResource, EstadosResource, MunicipiosResource } from './resources/localidades.js';
7
+ import { MercadoResource } from './resources/mercado.js';
8
+ import { CreditosResource } from './resources/creditos.js';
9
+ export declare const VERSION = "0.2.0";
10
+ /** @internal */
11
+ export interface Call {
12
+ method: 'GET' | 'POST';
13
+ path: string;
14
+ body?: unknown;
15
+ signal?: AbortSignal;
16
+ }
17
+ /**
18
+ * Cliente da NextAPI. Sem dependências: usa o `fetch` do runtime (Node.js 22+, Deno, Bun, Workers).
19
+ *
20
+ * @example
21
+ * ```ts
22
+ * const nextapi = new NextApiClient(); // lê NEXTAPI_KEY
23
+ * const empresa = await nextapi.cnpj.consultar('11.222.333/0001-81');
24
+ * ```
25
+ */
26
+ export declare class NextApiClient {
27
+ #private;
28
+ readonly cnpj: CnpjResource;
29
+ readonly socios: SociosResource;
30
+ readonly ceps: CepsResource;
31
+ readonly empresas: EmpresasResource;
32
+ readonly cnaes: CnaesResource;
33
+ readonly estados: EstadosResource;
34
+ readonly municipios: MunicipiosResource;
35
+ readonly mercado: MercadoResource;
36
+ readonly creditos: CreditosResource;
37
+ /** `sandbox` para chaves `nxa_test_`, `production` para as demais. O endereço é o mesmo: a API decide pela chave. */
38
+ readonly environment: 'sandbox' | 'production';
39
+ readonly baseUrl: string;
40
+ constructor(options?: NextApiClientOptions);
41
+ /** @internal Usado pelos recursos. */
42
+ request<T>(call: Call): Promise<T>;
43
+ /** Não mostra a chave. */
44
+ toJSON(): {
45
+ baseUrl: string;
46
+ environment: "sandbox" | "production";
47
+ };
48
+ }
49
+ /** Atalho: `new NextApi()` é o mesmo que `new NextApiClient()`. */
50
+ export declare const NextApi: typeof NextApiClient;
51
+ /** Só caracteres seguros num cabeçalho: CR/LF ou espaço no appInfo quebrariam a requisição. */
52
+ export declare function sanitizeAppInfo(info: string | undefined): string;
53
+ //# sourceMappingURL=client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAwB,aAAa,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACtH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,eAAO,MAAM,OAAO,UAAU,CAAC;AAI/B,gBAAgB;AAChB,MAAM,WAAW,IAAI;IACnB,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,qBAAa,aAAa;;IACxB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IAEpC,qHAAqH;IACrH,QAAQ,CAAC,WAAW,EAAE,SAAS,GAAG,YAAY,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAUb,OAAO,GAAE,oBAAyB;IAmD9C,sCAAsC;IAChC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC;IA0DxC,0BAA0B;IAC1B,MAAM;;;;CAGP;AAmDD,mEAAmE;AACnE,eAAO,MAAM,OAAO,sBAAgB,CAAC;AAErC,+FAA+F;AAC/F,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAEhE"}
@@ -0,0 +1,67 @@
1
+ /**
2
+ * Erros do SDK. Toda falha da API vira um {@link NextApiError}; a subclasse diz o que fazer.
3
+ * O código numérico da API (`code`) é o que distingue casos com o mesmo status HTTP
4
+ * (405 tanto para "sem créditos" quanto para "plano pago obrigatório").
5
+ */
6
+ /** Códigos de erro devolvidos pela NextAPI no corpo `{ status, code, message }`. */
7
+ export declare const ErrorCodes: {
8
+ readonly NotFound: 1000;
9
+ readonly TokenNotProvided: 1001;
10
+ readonly TokenInvalid: 1002;
11
+ readonly TooManyRequests: 1003;
12
+ readonly MissingCredits: 1004;
13
+ readonly LiveSearchNotAllowed: 1005;
14
+ readonly LiveSearchMissingCredits: 1006;
15
+ readonly InvalidCep: 1007;
16
+ readonly RequiresPaidPlan: 1012;
17
+ readonly ExternalProviderFailure: 1014;
18
+ readonly SandboxDailyLimit: 1015;
19
+ readonly SandboxDisabled: 1016;
20
+ };
21
+ export interface NextApiErrorInit {
22
+ status: number;
23
+ code?: number;
24
+ message: string;
25
+ body?: unknown;
26
+ requestId?: string;
27
+ retryAfterMs?: number;
28
+ }
29
+ export declare class NextApiError extends Error {
30
+ /** Status HTTP (0 quando a requisição nem chegou à API). */
31
+ readonly status: number;
32
+ /** Código de erro da NextAPI (ver {@link ErrorCodes}), quando a API o informou. */
33
+ readonly code?: number;
34
+ /** Corpo da resposta de erro, já interpretado como JSON quando possível. */
35
+ readonly body?: unknown;
36
+ /** Identificador da requisição (cabeçalho `x-request-id`), para o suporte. */
37
+ readonly requestId?: string;
38
+ constructor(init: NextApiErrorInit);
39
+ }
40
+ /** Chave ausente, inválida ou revogada (401; 400 com código 1001). */
41
+ export declare class NextApiAuthenticationError extends NextApiError {
42
+ }
43
+ /** Sem créditos para a consulta (códigos 1004 e 1006). */
44
+ export declare class NextApiInsufficientCreditsError extends NextApiError {
45
+ }
46
+ /** O recurso exige plano pago ou créditos avulsos (códigos 1012 e 1005). */
47
+ export declare class NextApiPaidPlanRequiredError extends NextApiError {
48
+ }
49
+ /** O CNPJ, CEP ou sócio pesquisado não existe (404). */
50
+ export declare class NextApiNotFoundError extends NextApiError {
51
+ }
52
+ /** Parâmetro rejeitado pela API (400) ou pelo próprio SDK antes de enviar (status 0). */
53
+ export declare class NextApiValidationError extends NextApiError {
54
+ }
55
+ /** Limite de requisições do plano ou do sandbox (429). */
56
+ export declare class NextApiRateLimitError extends NextApiError {
57
+ /** Quanto esperar antes de tentar de novo, pelo cabeçalho `Retry-After`. */
58
+ readonly retryAfterMs?: number;
59
+ constructor(init: NextApiErrorInit);
60
+ }
61
+ /** Falha do lado da API (5xx), inclusive a do provedor em tempo real (1014). */
62
+ export declare class NextApiServerError extends NextApiError {
63
+ }
64
+ /** Não houve resposta: rede, DNS, TLS, tempo esgotado ou redirecionamento recusado. */
65
+ export declare class NextApiConnectionError extends NextApiError {
66
+ }
67
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,oFAAoF;AACpF,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAab,CAAC;AAEX,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,YAAa,SAAQ,KAAK;IACrC,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mFAAmF;IACnF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEhB,IAAI,EAAE,gBAAgB;CASnC;AAED,sEAAsE;AACtE,qBAAa,0BAA2B,SAAQ,YAAY;CAAG;AAC/D,0DAA0D;AAC1D,qBAAa,+BAAgC,SAAQ,YAAY;CAAG;AACpE,4EAA4E;AAC5E,qBAAa,4BAA6B,SAAQ,YAAY;CAAG;AACjE,wDAAwD;AACxD,qBAAa,oBAAqB,SAAQ,YAAY;CAAG;AACzD,yFAAyF;AACzF,qBAAa,sBAAuB,SAAQ,YAAY;CAAG;AAC3D,0DAA0D;AAC1D,qBAAa,qBAAsB,SAAQ,YAAY;IACrD,4EAA4E;IAC5E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBACnB,IAAI,EAAE,gBAAgB;CAInC;AACD,gFAAgF;AAChF,qBAAa,kBAAmB,SAAQ,YAAY;CAAG;AACvD,uFAAuF;AACvF,qBAAa,sBAAuB,SAAQ,YAAY;CAAG"}