@felipepasc/core-sdk

Cliente, sem dependências, da API de integração do Core: métricas do dia, assinantes, lançamentos, orçamentos, cobranças, pagamentos, notas e avisos (webhooks) com verifyWebhook. Usa o fetch e o crypto do Node 20+.

Instalação

O pacote é público no npm. Não precisa de token nem de configuração:

npm install @felipepasc/core-sdk
# ou: pnpm add @felipepasc/core-sdk / yarn add @felipepasc/core-sdk

Uso

import { createClient, CoreApiError } from "@felipepasc/core-sdk";

const core = createClient({ baseUrl: process.env.CORE_API_URL ?? "", apiKey: process.env.CORE_API_KEY ?? "" });

await core.metrics.report(new Date(), { subscribers_active: 120, mrr_cents: 5964000 });

try {
    await core.charges.markPaid("cob_981", { method: "pix" });
} catch (err) {
    if (err instanceof CoreApiError) console.error(err.status, err.code, err.fields);
}

A chave (fk_...) identifica o serviço; ele nunca vai no corpo. A referência completa das rotas está em docs/api-integracao.md, na raiz do repositório. O guia completo de integração (módulos, receitas, checklists) está em docs/sdk.md.

Lançar uma versão nova

1. Suba o version em sdk/package.json.
2. Mande para a main.

O workflow publish-sdk compila, publica no npm se essa versão ainda não existir no registro e cria a tag sdk-v<versão>. Se a versão já existe, ele termina sem publicar.

Requisito: o segredo NPM_TOKEN (token do npm com permissão de publicar em @felipepasc) no repositório. O pacote é público: nada sensível pode entrar nele.