Nove SDK (JavaScript e TypeScript)

O SDK oficial da Nove API para JavaScript e TypeScript: semanas da gestação, DPP, busca e enxoval, com paginação, limites, idempotência e OAuth já resolvidos.

Instalar

npm i nove-care

Sem dependências: Node 18+, Deno, Bun, Cloudflare Workers e navegador. Tipos TypeScript inclusos.

Usar

import { Nove } from 'nove-care';

const nove = new Nove();                        // new Nove({ sandbox: true }) para testar
const semana = await nove.semana(20);           // { week, fruit, cm, g, baby, body, tips, ask, exams, url }
const dpp = await nove.dpp({ dum: '2026-09-01' });
const achados = await nove.buscar('enjoo');
for await (const s of nove.todasSemanas()) console.log(s.week, s.fruit);       // segue o next_cursor
const lista = await nove.enxoval({ due_date: '2027-06-08', city: 'Curitiba' }); // job 202 + espera

O que o SDK resolve

  • Erros viram NoveError com status, code estável e detail.
  • 429 e falha de rede: tenta de novo respeitando Retry-After. Os últimos limites ficam em nove.rateLimit.
  • enxoval() manda Idempotency-Key e consulta o job até terminar.
  • OAuth: const c = await Nove.register('meu agente') e new Nove({ clientId: c.client_id, clientSecret: c.client_secret }) (600 pedidos/min).

Pacote: nove-care no npm. Código (MIT): github.com/wevemedeiros/nove-sdk.