@radardata/sdk 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RadarData
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,203 @@
-# Temporary Holding Version
+# RadarData SDK para Node e TypeScript
 
-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.
+SDK oficial do [RadarData](https://radardata.com.br) para Node 18+, em
+TypeScript, **sem dependência em tempo de execução**. Embrulha a API pública
+(`/api/v2`): consultas, Verify (verificação de identidade), Motor de Análises e
+webhooks.
+
+A API continua disponível para quem preferir chamá-la direto. Este pacote
+existe para você não precisar.
+
+```bash
+npm i @radardata/sdk
+```
+
+## Começando
+
+```ts
+import { RadarData, emReais } from "@radardata/sdk";
+
+const radar = new RadarData({ token: process.env.RADARDATA_TOKEN! });
+
+const saldo = await radar.catalogo.saldo();
+console.log(emReais(saldo.centavos));   // 5.000,00
+console.log(saldo.disponivelCentavos);  // 500000
+```
+
+O token é o **token de API**, criado no painel, e não o da sua sessão do
+painel. Ele carrega escopos (`consultas`, `verify`, `analises`, `leitura`,
+`webhooks`): uma chamada fora do escopo volta `SemEscopo`.
+
+Funciona em ESM e em CommonJS:
+
+```js
+const { RadarData } = require("@radardata/sdk");
+```
+
+## Consultas
+
+```ts
+const resultado = await radar.consultas.executar("cpf", "12345678909");
+```
+
+Gasta saldo. O retorno não é tipado porque cada serviço devolve um corpo
+diferente e a lista cresce: tipar tudo aqui faria o SDK desatualizar a cada
+serviço novo sem ninguém perceber.
+
+Para saber o que a **sua** conta pode consultar, e por quanto:
+
+```ts
+for (const s of await radar.catalogo.servicos()) {
+  console.log(`${s.slug}: ${s.nome} (${s.precoCentavos} centavos)`);
+}
+```
+
+## Verify
+
+```ts
+const sessao = await radar.verify.criarSessao(
+  "kyc-cnpj",                               // uuid do fluxo ou o alias dele
+  { cnpj: "11222333000181" },
+  { reference_id: "pedido-4471", redirect_url: "https://seusite.com/ok" },
+);
+
+console.log(sessao.url);   // mande a pessoa para cá
+```
+
+O resultado chega por **webhook**. Dá para consultar também:
+
+```ts
+const atual = await radar.verify.sessao(sessao.id);
+
+if (atual.status === "completed" && atual.resultado === "APROVADO") {
+  // ...
+}
+```
+
+> **Criar sessão não é idempotente.** Se der timeout, **não chame de novo às
+> cegas**: você pagaria duas sessões. Mande um `reference_id` seu e procure por
+> ele antes de criar outra.
+
+## Análises
+
+Assíncrono: criar devolve o id, o resultado chega por webhook.
+
+```ts
+const analise = await radar.analises.criar("kyc-pf", { cpf: "12345678909" });
+const estado = await radar.analises.mostrar(String(analise.id));
+```
+
+Um `NaoEncontrado` aqui pode querer dizer **"o Motor não está liberado para a
+sua conta"**, e não "caminho errado": enquanto ele não está liberado, nada dele
+aparece para o cliente, de propósito.
+
+## Webhooks: conferir que o aviso é nosso
+
+```ts
+import express from "express";
+import { exigirAssinatura } from "@radardata/sdk";
+
+const app = express();
+
+// `express.raw`, NÃO `express.json`: a assinatura é do corpo cru.
+app.post("/radardata/webhook", express.raw({ type: "application/json" }), (req, res) => {
+  const evento = exigirAssinatura(
+    req.body,                                   // Buffer, o corpo CRU
+    req.header("X-RadarData-Signature"),
+    process.env.RADARDATA_WEBHOOK_SECRET!,
+  );
+
+  // Deduplique: reenviamos em caso de falha.
+  const entrega = req.header("X-RadarData-Delivery");
+
+  res.status(204).end();
+});
+```
+
+Três coisas que costumam dar errado aqui, e valem a leitura:
+
+**Use o corpo cru.** `express.raw()`, não `express.json()`. Reserializar muda
+espaços e ordem das chaves, o HMAC muda junto e a conferência falha sem motivo
+aparente. É o erro mais comum de qualquer integração deste tipo, e há um teste
+neste repositório que o demonstra.
+
+**Deduplique pelo `X-RadarData-Delivery`.** Reenviamos quando a entrega falha,
+então o mesmo evento pode chegar duas vezes.
+
+**A assinatura prova origem e conteúdo, não a hora.** O timestamp e o id de
+entrega viajam em cabeçalho, fora do corpo assinado, então ela não protege
+contra o reenvio de um aviso antigo e autêntico por quem o tenha interceptado.
+A dedup acima é a defesa prática.
+
+## Erros
+
+Cada situação tem a sua classe, para você não comparar strings:
+
+| Classe | Quando |
+|---|---|
+| `NaoAutenticado` | 401, token ausente, inválido ou revogado |
+| `SaldoInsuficiente` | 402, a conta não tem saldo para a operação |
+| `SemEscopo` | 403, o token não tem o escopo daquela rota |
+| `NaoEncontrado` | 404 |
+| `EntradaInvalida` | 422, veja `.corpo` para os campos |
+| `MuitasTentativas` | 429, teto de chamadas |
+| `ErroDoServidor` | 5xx, falha nossa |
+| `FalhaDeRede` | **sem resposta**: timeout, DNS, conexão recusada |
+
+Todas estendem `ErroRadarData`, que traz `.codigo`, `.status` e `.corpo`. O
+`.codigo` é o que vale para decidir no código; a mensagem é escrita para pessoa
+e muda.
+
+`FalhaDeRede` é separado de propósito: ali o SDK **não sabe** se a operação
+aconteceu. Numa chamada que gasta saldo isso importa, e o caminho é consultar
+pela mesma chave de idempotência, não repetir às cegas.
+
+## Teto de chamadas
+
+A API limita por token, **5 requisições por segundo** no plano padrão, e o
+grupo de webhooks tem teto próprio. Ao passar do teto vem `MuitasTentativas`
+(429); o SDK já respeita o `Retry-After` quando ele aparece.
+
+## Repetição automática, e por que ela não é global
+
+O SDK repete em 429 e 5xx **somente** nas chamadas em que manda
+`Idempotency-Key`: consultas, análises e operações. A mesma chave faz a API
+devolver a resposta anterior em vez de cobrar de novo.
+
+Criar sessão de Verify **não** tem idempotência na API, então o SDK **não
+repete** ali, qualquer que seja a configuração. Repetir criaria uma segunda
+sessão faturável, e um SDK que cobra duas vezes do seu cliente é pior do que
+um SDK que devolve erro.
+
+A chave é gerada automaticamente quando você não passa uma. Guarde a sua se
+quiser poder reconsultar o resultado depois de um timeout:
+
+```ts
+import { chaveIdempotencia } from "@radardata/sdk";
+
+const chave = chaveIdempotencia();
+await radar.consultas.executar("cpf", "12345678909", {}, chave);
+```
+
+## Apontando para outro ambiente
+
+```ts
+const radar = new RadarData({
+  token: process.env.RADARDATA_TOKEN!,
+  base: "https://api.radardata.dev.local/api/v2",
+  timeoutMs: 10_000,
+});
+```
+
+## Desenvolvimento
+
+```bash
+npm install
+npm test
+npm run typecheck
+npm run build
+```
+
+## Licença
+
+MIT.

package/dist/cjs/configuracao.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSAO = void 0;
+exports.resolver = resolver;
+exports.userAgent = userAgent;
+exports.VERSAO = "0.1.0";
+/** @internal */
+function resolver(c) {
+    if (!c.token)
+        throw new Error("RadarData: token de API é obrigatório.");
+    const buscar = c.fetch ?? globalThis.fetch;
+    if (typeof buscar !== "function") {
+        throw new Error("RadarData: `fetch` não existe neste runtime. Use Node 18 ou mais novo, ou passe um `fetch` na configuração.");
+    }
+    return {
+        token: c.token,
+        base: (c.base ?? "https://api.radardata.com.br/api/v2").replace(/\/+$/, ""),
+        timeoutMs: c.timeoutMs ?? 30_000,
+        tentativas: c.tentativas ?? 3,
+        fetch: buscar,
+    };
+}
+/** @internal */
+function userAgent() {
+    const v = typeof process !== "undefined" ? process.versions?.node : undefined;
+    return `radardata-sdk-node/${exports.VERSAO}${v ? ` node/${v}` : ""}`;
+}
+//# sourceMappingURL=configuracao.js.map

package/dist/cjs/configuracao.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuracao.js","sourceRoot":"","sources":["../../src/configuracao.ts"],"names":[],"mappings":";;;AA0BA,4BAiBC;AAGD,8BAGC;AA/BY,QAAA,MAAM,GAAG,OAAO,CAAC;AAO9B,gBAAgB;AAChB,SAAgB,QAAQ,CAAC,CAAe;IACtC,IAAI,CAAC,CAAC,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAExE,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC;IAC3C,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,6GAA6G,CAC9G,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,qCAAqC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QAC3E,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,MAAM;QAChC,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,CAAC;QAC7B,KAAK,EAAE,MAAM;KACd,CAAC;AACJ,CAAC;AAED,gBAAgB;AAChB,SAAgB,SAAS;IACvB,MAAM,CAAC,GAAG,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9E,OAAO,sBAAsB,cAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAChE,CAAC"}

package/dist/cjs/dados.js

@@ -0,0 +1,44 @@
+"use strict";
+/** Tipos do que a api devolve, onde tipar compensa. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paraSaldo = paraSaldo;
+exports.paraServico = paraServico;
+exports.paraSessao = paraSessao;
+exports.emReais = emReais;
+/** @internal */
+function paraSaldo(d) {
+    return {
+        centavos: Number(d.saldo ?? 0),
+        disponivelCentavos: Number(d.saldo_disponivel ?? 0),
+        modoCobranca: String(d.modo_cobranca ?? ""),
+    };
+}
+/** @internal */
+function paraServico(d) {
+    return {
+        slug: String(d.slug ?? ""),
+        nome: String(d.nome ?? ""),
+        categoria: d.categoria ?? null,
+        descricao: d.descricao ?? null,
+        tipoDocumento: d.tipo_documento ?? null,
+        precoCentavos: Number(d.preco ?? 0),
+    };
+}
+/** @internal */
+function paraSessao(d) {
+    return {
+        id: String(d.session_id ?? ""),
+        status: String(d.status ?? ""),
+        url: d.url ?? null,
+        resultado: d.outcome ?? null,
+        expiraEm: d.expires_at ?? null,
+        referenceId: d.reference_id ?? null,
+        custoCentavos: Number(d.custo_total_centavos ?? 0),
+        cru: d,
+    };
+}
+/** Em reais, para exibir. O calculo continua em centavos. */
+function emReais(centavos) {
+    return (centavos / 100).toLocaleString("pt-BR", { minimumFractionDigits: 2, maximumFractionDigits: 2 });
+}
+//# sourceMappingURL=dados.js.map

package/dist/cjs/dados.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dados.js","sourceRoot":"","sources":["../../src/dados.ts"],"names":[],"mappings":";AAAA,uDAAuD;;AAuDvD,8BAMC;AAGD,kCASC;AAGD,gCAWC;AAGD,0BAEC;AAtCD,gBAAgB;AAChB,SAAgB,SAAS,CAAC,CAA0B;IAClD,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QAC9B,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAC,gBAAgB,IAAI,CAAC,CAAC;QACnD,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,aAAa,IAAI,EAAE,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED,gBAAgB;AAChB,SAAgB,WAAW,CAAC,CAA0B;IACpD,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;QAC1B,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;QAC1B,SAAS,EAAG,CAAC,CAAC,SAA2B,IAAI,IAAI;QACjD,SAAS,EAAG,CAAC,CAAC,SAA2B,IAAI,IAAI;QACjD,aAAa,EAAG,CAAC,CAAC,cAAgC,IAAI,IAAI;QAC1D,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;KACpC,CAAC;AACJ,CAAC;AAED,gBAAgB;AAChB,SAAgB,UAAU,CAAC,CAA0B;IACnD,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC;QAC9B,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC;QAC9B,GAAG,EAAG,CAAC,CAAC,GAAqB,IAAI,IAAI;QACrC,SAAS,EAAG,CAAC,CAAC,OAAyB,IAAI,IAAI;QAC/C,QAAQ,EAAG,CAAC,CAAC,UAA4B,IAAI,IAAI;QACjD,WAAW,EAAG,CAAC,CAAC,YAA8B,IAAI,IAAI;QACtD,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,oBAAoB,IAAI,CAAC,CAAC;QAClD,GAAG,EAAE,CAAC;KACP,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,SAAgB,OAAO,CAAC,QAAgB;IACtC,OAAO,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,qBAAqB,EAAE,CAAC,EAAE,qBAAqB,EAAE,CAAC,EAAE,CAAC,CAAC;AAC1G,CAAC"}

package/dist/cjs/erros.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FalhaDeRede = exports.ErroDoServidor = exports.MuitasTentativas = exports.EntradaInvalida = exports.NaoEncontrado = exports.SemEscopo = exports.SaldoInsuficiente = exports.NaoAutenticado = exports.ErroRadarData = void 0;
+exports.erroDoStatus = erroDoStatus;
+/**
+ * Erros do SDK, um por situacao.
+ *
+ * A api devolve sempre `{"error": {"code": "...", "message": "..."}}`, e o
+ * `code` e o que vale para decidir no codigo: a `message` e escrita para
+ * pessoa e muda. Por isso ele fica acessivel aqui, e cada classe existe para
+ * um `catch` especifico, em vez de obrigar quem integra a comparar strings.
+ */
+class ErroRadarData extends Error {
+    codigo;
+    status;
+    corpo;
+    constructor(mensagem, codigo = null, status = null, 
+    /** O corpo cru, para quando o SDK nao previu algo. */
+    corpo = {}, opcoes) {
+        super(mensagem, opcoes);
+        this.codigo = codigo;
+        this.status = status;
+        this.corpo = corpo;
+        this.name = new.target.name;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.ErroRadarData = ErroRadarData;
+/** 401, token ausente, invalido ou revogado. */
+class NaoAutenticado extends ErroRadarData {
+}
+exports.NaoAutenticado = NaoAutenticado;
+/** 402, a conta nao tem saldo para esta operacao. */
+class SaldoInsuficiente extends ErroRadarData {
+}
+exports.SaldoInsuficiente = SaldoInsuficiente;
+/** 403, o token existe mas nao tem o escopo daquela rota. */
+class SemEscopo extends ErroRadarData {
+}
+exports.SemEscopo = SemEscopo;
+/** 404, recurso inexistente ou de outra empresa. */
+class NaoEncontrado extends ErroRadarData {
+}
+exports.NaoEncontrado = NaoEncontrado;
+/** 422, o que foi enviado nao passou na validacao. Veja `corpo`. */
+class EntradaInvalida extends ErroRadarData {
+}
+exports.EntradaInvalida = EntradaInvalida;
+/** 429, teto de chamadas atingido. */
+class MuitasTentativas extends ErroRadarData {
+}
+exports.MuitasTentativas = MuitasTentativas;
+/** 5xx, falha nossa. */
+class ErroDoServidor extends ErroRadarData {
+}
+exports.ErroDoServidor = ErroDoServidor;
+/**
+ * Nao houve resposta: timeout, DNS, conexao recusada.
+ *
+ * Separado dos erros com status de proposito: aqui o SDK NAO SABE se a
+ * operacao aconteceu. Numa chamada que gasta saldo isso importa, e o jeito de
+ * descobrir e consultar pela mesma chave de idempotencia, nao repetir as
+ * cegas.
+ */
+class FalhaDeRede extends ErroRadarData {
+}
+exports.FalhaDeRede = FalhaDeRede;
+/** @internal */
+function erroDoStatus(status, mensagem, codigo, corpo) {
+    if (status === 401)
+        return new NaoAutenticado(mensagem, codigo, status, corpo);
+    if (status === 402)
+        return new SaldoInsuficiente(mensagem, codigo, status, corpo);
+    if (status === 403)
+        return new SemEscopo(mensagem, codigo, status, corpo);
+    if (status === 404)
+        return new NaoEncontrado(mensagem, codigo, status, corpo);
+    if (status === 422)
+        return new EntradaInvalida(mensagem, codigo, status, corpo);
+    if (status === 429)
+        return new MuitasTentativas(mensagem, codigo, status, corpo);
+    if (status >= 500)
+        return new ErroDoServidor(mensagem, codigo, status, corpo);
+    return new ErroRadarData(mensagem, codigo, status, corpo);
+}
+//# sourceMappingURL=erros.js.map

package/dist/cjs/erros.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"erros.js","sourceRoot":"","sources":["../../src/erros.ts"],"names":[],"mappings":";;;AAuDA,oCAcC;AArED;;;;;;;GAOG;AACH,MAAa,aAAc,SAAQ,KAAK;IAG3B;IACA;IAEA;IALX,YACE,QAAgB,EACP,SAAwB,IAAI,EAC5B,SAAwB,IAAI;IACrC,sDAAsD;IAC7C,QAAiC,EAAE,EAC5C,MAA4B;QAE5B,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QANf,WAAM,GAAN,MAAM,CAAsB;QAC5B,WAAM,GAAN,MAAM,CAAsB;QAE5B,UAAK,GAAL,KAAK,CAA8B;QAI5C,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAC5B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAbD,sCAaC;AAED,gDAAgD;AAChD,MAAa,cAAe,SAAQ,aAAa;CAAG;AAApD,wCAAoD;AAEpD,qDAAqD;AACrD,MAAa,iBAAkB,SAAQ,aAAa;CAAG;AAAvD,8CAAuD;AAEvD,6DAA6D;AAC7D,MAAa,SAAU,SAAQ,aAAa;CAAG;AAA/C,8BAA+C;AAE/C,oDAAoD;AACpD,MAAa,aAAc,SAAQ,aAAa;CAAG;AAAnD,sCAAmD;AAEnD,oEAAoE;AACpE,MAAa,eAAgB,SAAQ,aAAa;CAAG;AAArD,0CAAqD;AAErD,sCAAsC;AACtC,MAAa,gBAAiB,SAAQ,aAAa;CAAG;AAAtD,4CAAsD;AAEtD,wBAAwB;AACxB,MAAa,cAAe,SAAQ,aAAa;CAAG;AAApD,wCAAoD;AAEpD;;;;;;;GAOG;AACH,MAAa,WAAY,SAAQ,aAAa;CAAG;AAAjD,kCAAiD;AAEjD,gBAAgB;AAChB,SAAgB,YAAY,CAC1B,MAAc,EACd,QAAgB,EAChB,MAAqB,EACrB,KAA8B;IAE9B,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC/E,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAClF,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC1E,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9E,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAChF,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACjF,IAAI,MAAM,IAAI,GAAG;QAAE,OAAO,IAAI,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9E,OAAO,IAAI,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAC5D,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Webhooks = exports.Verify = exports.Consultas = exports.Catalogo = exports.Analises = exports.SemEscopo = exports.SaldoInsuficiente = exports.NaoEncontrado = exports.NaoAutenticado = exports.MuitasTentativas = exports.FalhaDeRede = exports.ErroRadarData = exports.ErroDoServidor = exports.EntradaInvalida = exports.emReais = exports.exigirAssinatura = exports.confereAssinatura = exports.chaveIdempotencia = exports.RadarData = void 0;
+const configuracao_js_1 = require("./configuracao.js");
+const analises_js_1 = require("./recursos/analises.js");
+const catalogo_js_1 = require("./recursos/catalogo.js");
+const consultas_js_1 = require("./recursos/consultas.js");
+const verify_js_1 = require("./recursos/verify.js");
+const webhooks_js_1 = require("./recursos/webhooks.js");
+const transporte_js_1 = require("./transporte.js");
+/**
+ * Ponto de entrada do SDK.
+ *
+ * ```ts
+ * import { RadarData } from "@radardata/sdk";
+ *
+ * const radar = new RadarData({ token: process.env.RADARDATA_TOKEN! });
+ * const saldo = await radar.catalogo.saldo();
+ * ```
+ *
+ * O token e o de API, criado no painel, e NAO o de sessao do painel. Ele
+ * carrega escopos: uma chamada fora do escopo do token volta `SemEscopo`, e
+ * isso e proposital, para um token de servidor nao poder redirecionar os seus
+ * webhooks.
+ */
+class RadarData {
+    catalogo;
+    consultas;
+    verify;
+    analises;
+    webhooks;
+    constructor(config) {
+        const t = new transporte_js_1.Transporte((0, configuracao_js_1.resolver)(config));
+        this.catalogo = new catalogo_js_1.Catalogo(t);
+        this.consultas = new consultas_js_1.Consultas(t);
+        this.verify = new verify_js_1.Verify(t);
+        this.analises = new analises_js_1.Analises(t);
+        this.webhooks = new webhooks_js_1.Webhooks(t);
+    }
+}
+exports.RadarData = RadarData;
+var transporte_js_2 = require("./transporte.js");
+Object.defineProperty(exports, "chaveIdempotencia", { enumerable: true, get: function () { return transporte_js_2.chaveIdempotencia; } });
+var assinatura_js_1 = require("./webhooks/assinatura.js");
+Object.defineProperty(exports, "confereAssinatura", { enumerable: true, get: function () { return assinatura_js_1.confereAssinatura; } });
+Object.defineProperty(exports, "exigirAssinatura", { enumerable: true, get: function () { return assinatura_js_1.exigirAssinatura; } });
+var dados_js_1 = require("./dados.js");
+Object.defineProperty(exports, "emReais", { enumerable: true, get: function () { return dados_js_1.emReais; } });
+var erros_js_1 = require("./erros.js");
+Object.defineProperty(exports, "EntradaInvalida", { enumerable: true, get: function () { return erros_js_1.EntradaInvalida; } });
+Object.defineProperty(exports, "ErroDoServidor", { enumerable: true, get: function () { return erros_js_1.ErroDoServidor; } });
+Object.defineProperty(exports, "ErroRadarData", { enumerable: true, get: function () { return erros_js_1.ErroRadarData; } });
+Object.defineProperty(exports, "FalhaDeRede", { enumerable: true, get: function () { return erros_js_1.FalhaDeRede; } });
+Object.defineProperty(exports, "MuitasTentativas", { enumerable: true, get: function () { return erros_js_1.MuitasTentativas; } });
+Object.defineProperty(exports, "NaoAutenticado", { enumerable: true, get: function () { return erros_js_1.NaoAutenticado; } });
+Object.defineProperty(exports, "NaoEncontrado", { enumerable: true, get: function () { return erros_js_1.NaoEncontrado; } });
+Object.defineProperty(exports, "SaldoInsuficiente", { enumerable: true, get: function () { return erros_js_1.SaldoInsuficiente; } });
+Object.defineProperty(exports, "SemEscopo", { enumerable: true, get: function () { return erros_js_1.SemEscopo; } });
+var analises_js_2 = require("./recursos/analises.js");
+Object.defineProperty(exports, "Analises", { enumerable: true, get: function () { return analises_js_2.Analises; } });
+var catalogo_js_2 = require("./recursos/catalogo.js");
+Object.defineProperty(exports, "Catalogo", { enumerable: true, get: function () { return catalogo_js_2.Catalogo; } });
+var consultas_js_2 = require("./recursos/consultas.js");
+Object.defineProperty(exports, "Consultas", { enumerable: true, get: function () { return consultas_js_2.Consultas; } });
+var verify_js_2 = require("./recursos/verify.js");
+Object.defineProperty(exports, "Verify", { enumerable: true, get: function () { return verify_js_2.Verify; } });
+var webhooks_js_2 = require("./recursos/webhooks.js");
+Object.defineProperty(exports, "Webhooks", { enumerable: true, get: function () { return webhooks_js_2.Webhooks; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,uDAAgE;AAChE,wDAAkD;AAClD,wDAAkD;AAClD,0DAAoD;AACpD,oDAA8C;AAC9C,wDAAkD;AAClD,mDAA6C;AAE7C;;;;;;;;;;;;;;GAcG;AACH,MAAa,SAAS;IACX,QAAQ,CAAW;IAEnB,SAAS,CAAY;IAErB,MAAM,CAAS;IAEf,QAAQ,CAAW;IAEnB,QAAQ,CAAW;IAE5B,YAAY,MAAoB;QAC9B,MAAM,CAAC,GAAG,IAAI,0BAAU,CAAC,IAAA,0BAAQ,EAAC,MAAM,CAAC,CAAC,CAAC;QAE3C,IAAI,CAAC,QAAQ,GAAG,IAAI,sBAAQ,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,IAAI,wBAAS,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,IAAI,kBAAM,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,IAAI,sBAAQ,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,IAAI,sBAAQ,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;CACF;AApBD,8BAoBC;AAED,iDAAoD;AAA3C,kHAAA,iBAAiB,OAAA;AAC1B,0DAA+E;AAAtE,kHAAA,iBAAiB,OAAA;AAAE,iHAAA,gBAAgB,OAAA;AAC5C,uCAAqC;AAA5B,mGAAA,OAAO,OAAA;AAGhB,uCAUoB;AATlB,2GAAA,eAAe,OAAA;AACf,0GAAA,cAAc,OAAA;AACd,yGAAA,aAAa,OAAA;AACb,uGAAA,WAAW,OAAA;AACX,4GAAA,gBAAgB,OAAA;AAChB,0GAAA,cAAc,OAAA;AACd,yGAAA,aAAa,OAAA;AACb,6GAAA,iBAAiB,OAAA;AACjB,qGAAA,SAAS,OAAA;AAEX,sDAAkD;AAAzC,uGAAA,QAAQ,OAAA;AACjB,sDAAkD;AAAzC,uGAAA,QAAQ,OAAA;AACjB,wDAAoD;AAA3C,yGAAA,SAAS,OAAA;AAClB,kDAA8C;AAArC,mGAAA,MAAM,OAAA;AACf,sDAAkD;AAAzC,uGAAA,QAAQ,OAAA"}

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/cjs/recursos/analises.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Analises = void 0;
+const transporte_js_1 = require("../transporte.js");
+/**
+ * Motor de Analises. Escopo `analises`. GASTA SALDO.
+ *
+ * E ASSINCRONO: criar devolve o id e o resultado chega por webhook. Consultar
+ * em laco funciona, mas o webhook e o caminho previsto; veja
+ * `confereAssinatura` para conferir que o aviso e nosso.
+ *
+ * Um 404 aqui pode querer dizer "o Motor nao esta liberado para a sua conta",
+ * e nao "caminho errado": enquanto ele nao esta liberado, nada dele aparece
+ * para o cliente, de proposito.
+ */
+class Analises {
+    t;
+    constructor(t) {
+        this.t = t;
+    }
+    /** Produtos liberados para esta conta. */
+    async produtos() {
+        return this.t.pedir("GET", "analises/produtos");
+    }
+    async criar(slug, campos, opcoes = {}, chave) {
+        return this.t.pedir("POST", `analises/${encodeURIComponent(slug)}`, {
+            corpo: { campos, ...opcoes },
+            chaveIdempotencia: chave ?? (0, transporte_js_1.chaveIdempotencia)(),
+        });
+    }
+    async mostrar(id) {
+        return this.t.pedir("GET", `analises/${encodeURIComponent(id)}`);
+    }
+    async decidir(id, decisao, motivo) {
+        const corpo = { decisao };
+        if (motivo !== undefined)
+            corpo.motivo = motivo;
+        return this.t.pedir("POST", `analises/${encodeURIComponent(id)}/decisao`, { corpo });
+    }
+    async monitorar(slug, campos, opcoes = {}) {
+        return this.t.pedir("POST", `analises/monitorar/${encodeURIComponent(slug)}`, {
+            corpo: { campos, ...opcoes },
+        });
+    }
+    async monitoramentos() {
+        return this.t.pedir("GET", "analises/monitoramentos");
+    }
+    async cancelarMonitoramento(id) {
+        return this.t.pedir("DELETE", `analises/monitoramentos/${encodeURIComponent(id)}`);
+    }
+}
+exports.Analises = Analises;
+//# sourceMappingURL=analises.js.map

package/dist/cjs/recursos/analises.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analises.js","sourceRoot":"","sources":["../../../src/recursos/analises.ts"],"names":[],"mappings":";;;AAAA,oDAAsE;AAEtE;;;;;;;;;;GAUG;AACH,MAAa,QAAQ;IACU;IAA7B,YAA6B,CAAa;QAAb,MAAC,GAAD,CAAC,CAAY;IAAG,CAAC;IAE9C,0CAA0C;IAC1C,KAAK,CAAC,QAAQ;QACZ,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,CAA4B,KAAK,EAAE,mBAAmB,CAAC,CAAC;IAC7E,CAAC;IAED,KAAK,CAAC,KAAK,CACT,IAAY,EACZ,MAA+B,EAC/B,SAAkC,EAAE,EACpC,KAAc;QAEd,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAAE;YAClE,KAAK,EAAE,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;YAC5B,iBAAiB,EAAE,KAAK,IAAI,IAAA,iCAAiB,GAAE;SAChD,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,EAAU;QACtB,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,YAAY,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,EAAU,EAAE,OAAe,EAAE,MAAe;QACxD,MAAM,KAAK,GAA4B,EAAE,OAAO,EAAE,CAAC;QACnD,IAAI,MAAM,KAAK,SAAS;YAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;QAChD,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,KAAK,CAAC,SAAS,CACb,IAAY,EACZ,MAA+B,EAC/B,SAAkC,EAAE;QAEpC,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,sBAAsB,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAAE;YAC5E,KAAK,EAAE,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;SAC7B,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,CAA4B,KAAK,EAAE,yBAAyB,CAAC,CAAC;IACnF,CAAC;IAED,KAAK,CAAC,qBAAqB,CAAC,EAAU;QACpC,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,2BAA2B,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACrF,CAAC;CACF;AA/CD,4BA+CC"}

package/dist/cjs/recursos/catalogo.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Catalogo = void 0;
+const dados_js_1 = require("../dados.js");
+/** Catalogo e saldo. Escopo `leitura`, nao gasta nada. */
+class Catalogo {
+    t;
+    constructor(t) {
+        this.t = t;
+    }
+    /** O que ESTA conta pode consultar, com o preco dela. */
+    async servicos() {
+        const dados = await this.t.pedir("GET", "servicos");
+        return dados.map(dados_js_1.paraServico);
+    }
+    async saldo() {
+        return (0, dados_js_1.paraSaldo)(await this.t.pedir("GET", "saldo"));
+    }
+}
+exports.Catalogo = Catalogo;
+//# sourceMappingURL=catalogo.js.map

package/dist/cjs/recursos/catalogo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogo.js","sourceRoot":"","sources":["../../../src/recursos/catalogo.ts"],"names":[],"mappings":";;;AAAA,0CAA+E;AAG/E,0DAA0D;AAC1D,MAAa,QAAQ;IACU;IAA7B,YAA6B,CAAa;QAAb,MAAC,GAAD,CAAC,CAAY;IAAG,CAAC;IAE9C,yDAAyD;IACzD,KAAK,CAAC,QAAQ;QACZ,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,KAAK,CAA4B,KAAK,EAAE,UAAU,CAAC,CAAC;QAC/E,OAAO,KAAK,CAAC,GAAG,CAAC,sBAAW,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,OAAO,IAAA,oBAAS,EAAC,MAAM,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,CAAC;CACF;AAZD,4BAYC"}

package/dist/cjs/recursos/consultas.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Consultas = void 0;
+const transporte_js_1 = require("../transporte.js");
+/**
+ * Consultas. Escopo `consultas`. GASTA SALDO.
+ *
+ * O retorno vem como objeto solto e nao tipado de proposito: cada servico
+ * devolve um corpo diferente, a lista cresce, e tipar tudo aqui faria o SDK
+ * desatualizar a cada servico novo sem ninguem perceber.
+ */
+class Consultas {
+    t;
+    constructor(t) {
+        this.t = t;
+    }
+    /**
+     * Executa uma consulta pelo slug do servico.
+     *
+     * A chave de idempotencia e GERADA quando voce nao passa uma, e e ela que
+     * torna seguro repetir: a mesma chave devolve a mesma resposta em vez de
+     * cobrar de novo. Guarde a sua se quiser poder reconsultar o resultado
+     * depois de um timeout.
+     */
+    async executar(slug, documento, extras = {}, chave) {
+        return this.t.pedir("POST", slug, {
+            corpo: { documento, ...extras },
+            chaveIdempotencia: chave ?? (0, transporte_js_1.chaveIdempotencia)(),
+        });
+    }
+}
+exports.Consultas = Consultas;
+//# sourceMappingURL=consultas.js.map

package/dist/cjs/recursos/consultas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consultas.js","sourceRoot":"","sources":["../../../src/recursos/consultas.ts"],"names":[],"mappings":";;;AAAA,oDAAsE;AAEtE;;;;;;GAMG;AACH,MAAa,SAAS;IACS;IAA7B,YAA6B,CAAa;QAAb,MAAC,GAAD,CAAC,CAAY;IAAG,CAAC;IAE9C;;;;;;;OAOG;IACH,KAAK,CAAC,QAAQ,CACZ,IAAY,EACZ,SAAiB,EACjB,SAAkC,EAAE,EACpC,KAAc;QAEd,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE;YAChC,KAAK,EAAE,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE;YAC/B,iBAAiB,EAAE,KAAK,IAAI,IAAA,iCAAiB,GAAE;SAChD,CAAC,CAAC;IACL,CAAC;CACF;AAtBD,8BAsBC"}

package/dist/cjs/recursos/verify.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Verify = void 0;
+const dados_js_1 = require("../dados.js");
+/**
+ * Verify: verificacao de identidade. Escopo `verify`. GASTA SALDO.
+ *
+ * ATENCAO ao criar: esta rota NAO tem idempotencia na api, entao o SDK nao
+ * repete a chamada sozinho. Se der timeout, NAO chame de novo as cegas: mande
+ * um `reference_id` seu na criacao e, na duvida, procure por ele antes de
+ * criar outra, senao voce paga duas sessoes.
+ */
+class Verify {
+    t;
+    constructor(t) {
+        this.t = t;
+    }
+    /**
+     * Cria a sessao e devolve a URL para mandar a pessoa.
+     *
+     * @param fluxo uuid do fluxo ou o alias dele (ex.: "kyc-cnpj")
+     * @param input o que o fluxo pede de entrada (ex.: cpf)
+     * @param opcoes prefill, consent, redirect_url, webhook_url, reference_id
+     */
+    async criarSessao(fluxo, input = {}, opcoes = {}) {
+        const corpo = { flow_id: fluxo, ...opcoes };
+        if (Object.keys(input).length > 0)
+            corpo.input = input;
+        return (0, dados_js_1.paraSessao)(await this.t.pedir("POST", "verify/sessions", { corpo }));
+    }
+    async sessao(id) {
+        return (0, dados_js_1.paraSessao)(await this.t.pedir("GET", `verify/sessions/${encodeURIComponent(id)}`));
+    }
+    async cancelar(id) {
+        return (0, dados_js_1.paraSessao)(await this.t.pedir("POST", `verify/sessions/${encodeURIComponent(id)}/cancel`));
+    }
+}
+exports.Verify = Verify;
+//# sourceMappingURL=verify.js.map

package/dist/cjs/recursos/verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../../src/recursos/verify.ts"],"names":[],"mappings":";;;AAAA,0CAA4D;AAG5D;;;;;;;GAOG;AACH,MAAa,MAAM;IACY;IAA7B,YAA6B,CAAa;QAAb,MAAC,GAAD,CAAC,CAAY;IAAG,CAAC;IAE9C;;;;;;OAMG;IACH,KAAK,CAAC,WAAW,CACf,KAAa,EACb,QAAiC,EAAE,EACnC,SAAkC,EAAE;QAEpC,MAAM,KAAK,GAA4B,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,CAAC;QACrE,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QAEvD,OAAO,IAAA,qBAAU,EAAC,MAAM,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,iBAAiB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,OAAO,IAAA,qBAAU,EAAC,MAAM,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,mBAAmB,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5F,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,EAAU;QACvB,OAAO,IAAA,qBAAU,EAAC,MAAM,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,mBAAmB,kBAAkB,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IACpG,CAAC;CACF;AA5BD,wBA4BC"}