@sharpfy/nextapi 0.0.0-stage → 0.2.1

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.
@@ -0,0 +1,85 @@
1
+ export * from './models.js';
2
+ /** Opções do cliente. Todas são opcionais: a chave pode vir de `NEXTAPI_KEY`. */
3
+ export interface NextApiClientOptions {
4
+ /** Chave de API (`nxa_live_…` em produção, `nxa_test_…` no sandbox). Padrão: `process.env.NEXTAPI_KEY`. */
5
+ apiKey?: string;
6
+ /** Endereço da API. Padrão `https://api.nextapi.com.br`; só `https` (ou `http://localhost`). */
7
+ baseUrl?: string;
8
+ /** Tempo máximo de cada tentativa, em ms. Padrão 30 000. */
9
+ timeoutMs?: number;
10
+ /** Novas tentativas em falha transitória (429, 502, 503, 504, rede), só em leituras. Padrão 2. */
11
+ maxRetries?: number;
12
+ /** `fetch` alternativo (testes, proxies, runtimes sem `fetch` global). */
13
+ fetch?: typeof fetch;
14
+ /** Complemento do User-Agent, para identificar a sua aplicação (ex.: `"minha-app/1.2"`). */
15
+ appInfo?: string;
16
+ }
17
+ /** Opções de cada chamada. */
18
+ export interface RequestOptions {
19
+ /** Cancela a chamada (ex.: `AbortSignal.timeout(5000)` ou o sinal da requisição HTTP de entrada). */
20
+ signal?: AbortSignal;
21
+ }
22
+ export interface PageParams {
23
+ /** Página, a partir de 1. */
24
+ page?: number;
25
+ /** Itens por página (o máximo depende da rota, em geral 100). */
26
+ pageSize?: number;
27
+ }
28
+ export interface ConsultarCnpjParams extends RequestOptions {
29
+ /** Idade máxima aceita do dado em cache, em dias (0 a 45). 0 força a consulta em tempo real ao provedor. */
30
+ toleranceDays?: number;
31
+ }
32
+ export interface ListarRelacionadosParams extends PageParams, RequestOptions {
33
+ /** Inclui empresas baixadas, inaptas e suspensas. Padrão `false`. */
34
+ incluirInativas?: boolean;
35
+ }
36
+ export interface BuscarCepsParams extends PageParams, RequestOptions {
37
+ uf?: string;
38
+ /** Código do município (o `id` de `/v1/municipios`). */
39
+ idMunicipio?: number;
40
+ nomeMunicipio?: string;
41
+ logradouro?: string;
42
+ /** Busca livre por texto. Não combina com `logradouro`. */
43
+ q?: string;
44
+ }
45
+ export interface BuscarProximosParams extends PageParams, RequestOptions {
46
+ latitude: number;
47
+ longitude: number;
48
+ /** Raio da busca em metros (maior que zero). */
49
+ raioMetro: number;
50
+ }
51
+ export interface BuscarProximosDoCepParams extends PageParams, RequestOptions {
52
+ /** Raio da busca em metros (maior que zero). */
53
+ raioMetro: number;
54
+ }
55
+ export interface PesquisarEmpresasParams extends PageParams, RequestOptions {
56
+ /** Busca livre por razão social ou nome fantasia. */
57
+ q?: string;
58
+ uf?: string;
59
+ codigoMunicipio?: string;
60
+ cnpjRaiz?: string;
61
+ cnpj?: string;
62
+ /** Data mínima de abertura (`Date` ou `AAAA-MM-DD`). */
63
+ dataAberturaInicio?: Date | string;
64
+ dataAberturaFim?: Date | string;
65
+ codigoSituacaoCadastral?: string;
66
+ /** CEPs separados por vírgula. */
67
+ ceps?: string;
68
+ /** CNAEs separados por vírgula. */
69
+ cnaes?: string;
70
+ }
71
+ export interface ListarMunicipiosParams extends PageParams, RequestOptions {
72
+ uf?: string;
73
+ }
74
+ export interface MercadoCnaeParams extends RequestOptions {
75
+ uf?: string;
76
+ /** Meses da série de aberturas e baixas (padrão 24, máximo 60). */
77
+ meses?: number;
78
+ }
79
+ export interface MercadoIndicadorParams extends RequestOptions {
80
+ /** Primeiro período, `AAAAMM`. */
81
+ inicio?: string;
82
+ /** Último período, `AAAAMM`. */
83
+ fim?: string;
84
+ }
85
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAE5B,iFAAiF;AACjF,MAAM,WAAW,oBAAoB;IACnC,2GAA2G;IAC3G,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gGAAgG;IAChG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kGAAkG;IAClG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,4FAA4F;IAC5F,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,8BAA8B;AAC9B,MAAM,WAAW,cAAc;IAC7B,qGAAqG;IACrG,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAoB,SAAQ,cAAc;IACzD,4GAA4G;IAC5G,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,wBAAyB,SAAQ,UAAU,EAAE,cAAc;IAC1E,qEAAqE;IACrE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAiB,SAAQ,UAAU,EAAE,cAAc;IAClE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,oBAAqB,SAAQ,UAAU,EAAE,cAAc;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAA0B,SAAQ,UAAU,EAAE,cAAc;IAC3E,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAwB,SAAQ,UAAU,EAAE,cAAc;IACzE,qDAAqD;IACrD,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,kBAAkB,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IACnC,eAAe,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAChC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAuB,SAAQ,UAAU,EAAE,cAAc;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd"}
@@ -0,0 +1,23 @@
1
+ /**
2
+ * Normaliza o CNPJ: tira pontuação e espaços e põe em maiúsculas. Aceita o CNPJ alfanumérico
3
+ * (12 caracteres alfanuméricos e 2 dígitos verificadores), que a Receita emite desde julho de 2026.
4
+ */
5
+ export declare function normalizeCnpj(cnpj: string): string;
6
+ /** Normaliza o CEP para 8 dígitos (aceita "01001-000"). */
7
+ export declare function normalizeCep(cep: string): string;
8
+ /** hashSocio: 20 caracteres hexadecimais, como vem de `socios[].hashSocio`. */
9
+ export declare function normalizeHashSocio(hash: string): string;
10
+ /** Segmento de caminho livre (ex.: tipo do indicador): só letras, dígitos, "_" e "-". */
11
+ export declare function pathSegment(value: string | number, name: string): string;
12
+ /** Inteiro positivo para caminho (ex.: id do município). */
13
+ export declare function positiveInt(value: number, name: string): string;
14
+ export declare function requirePositive(value: number | undefined, name: string): void;
15
+ export declare function requireRange(value: number | undefined, min: number, max: number, name: string): void;
16
+ export declare function batch(cnpjs: readonly string[]): string[];
17
+ /** Query string sem os valores ausentes, na ordem informada. */
18
+ export declare function query(params?: object): string;
19
+ /** Espera de `attempt` (1, 2, …): exponencial com jitter, limitada a 8 s. */
20
+ export declare function backoffMs(attempt: number): number;
21
+ /** `Retry-After` em segundos ou data HTTP; limitado a 60 s. */
22
+ export declare function retryAfterMs(header: string | null): number | undefined;
23
+ //# sourceMappingURL=utils.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED,yFAAyF;AACzF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIxE;AAED,4DAA4D;AAC5D,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAE7E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAGpG;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAIxD;AAED,gEAAgE;AAChE,wBAAgB,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAS7C;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAKtE"}
package/package.json CHANGED
@@ -1,6 +1,56 @@
1
1
  {
2
2
  "name": "@sharpfy/nextapi",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.2.1",
4
+ "description": "SDK oficial da NextAPI (CNPJ, CEP, sócios, mercado) para Node.js, Deno, Bun e edge. Sem dependências.",
5
+ "keywords": [
6
+ "nextapi",
7
+ "sharpfy",
8
+ "cnpj",
9
+ "consulta-cnpj",
10
+ "simples-nacional",
11
+ "inscricao-estadual",
12
+ "cep",
13
+ "sdk"
14
+ ],
15
+ "author": "Sharpfy <contato@sharpfy.com.br>",
16
+ "license": "MIT",
17
+ "repository": {
18
+ "type": "git",
19
+ "url": "git+https://github.com/sharpfytecnologia/nextapi-sdk-node.git"
20
+ },
21
+ "type": "module",
22
+ "main": "./dist/index.cjs",
23
+ "module": "./dist/index.js",
24
+ "types": "./dist/index.d.ts",
25
+ "exports": {
26
+ ".": {
27
+ "types": "./dist/index.d.ts",
28
+ "import": "./dist/index.js",
29
+ "require": "./dist/index.cjs"
30
+ }
31
+ },
32
+ "files": [
33
+ "dist",
34
+ "README.md",
35
+ "LICENSE"
36
+ ],
37
+ "scripts": {
38
+ "build": "node scripts/build.js",
39
+ "typecheck": "tsc --noEmit",
40
+ "test": "node --test dist-test/tests/*.test.js && node scripts/test-cjs.cjs",
41
+ "prepublishOnly": "npm run typecheck && npm run build && npm test"
42
+ },
43
+ "devDependencies": {
44
+ "@types/node": "^22.0.0",
45
+ "esbuild": "^0.28.2",
46
+ "typescript": "^5.7.0"
47
+ },
48
+ "engines": {
49
+ "node": ">=22.0.0"
50
+ },
51
+ "sideEffects": false,
52
+ "homepage": "https://nextapi.com.br",
53
+ "bugs": {
54
+ "url": "https://github.com/sharpfytecnologia/nextapi-sdk-node/issues"
55
+ }
56
+ }