@felipepasc/core-sdk 0.0.0-stage → 0.2.0

package/README.md

@@ -1,3 +1,39 @@
-# Temporary Holding Version
+# @felipepasc/core-sdk
 
-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.
+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:
+
+```sh
+npm install @felipepasc/core-sdk
+# ou: pnpm add @felipepasc/core-sdk / yarn add @felipepasc/core-sdk
+```
+
+## Uso
+
+```ts
+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.

package/dist/index.d.ts

@@ -0,0 +1,684 @@
+/**
+ * SDK do sistema financeiro: o que cada serviço usa pra reportar os próprios
+ * dados e gerar orçamentos e cobranças. Sem dependências: só `fetch` e `crypto` (Node 20+).
+ *
+ *   const core = createClient({ baseUrl: process.env.CORE_API_URL, apiKey: process.env.CORE_API_KEY });
+ *   await core.metrics.report("2026-10-12", { subscribers_active: 120 });
+ *   const charge = await core.charges.upsert("inv_981", { customer, items, dueDate: "2026-10-20" });
+ *   charge.pdfUrl; // link do PDF pra mandar ao cliente
+ *   const pix = await core.charges.createPayment("inv_981", { method: "pix" });
+ *   pix.pixCopyPaste; // o provedor é o que estiver configurado no CNPJ
+ *
+ * Dinheiro é sempre em centavos, inteiro. Tudo é idempotente pelo id que o
+ * serviço manda: repetir a chamada troca o que estava, não duplica.
+ */
+export type SubscriberStatus = "trial" | "active" | "past_due" | "paused" | "canceled";
+export type TransactionType = "payment" | "refund" | "fee" | "cost";
+export type QuoteStatus = "open" | "accepted" | "rejected" | "canceled";
+export type ChargeStatus = "open" | "paid" | "canceled";
+/** Data com hora: `Date` ou texto ISO 8601 com fuso. */
+export type DateInput = Date | string;
+export interface Subscriber {
+    name: string;
+    status: SubscriberStatus;
+    email?: string | null;
+    document?: string | null;
+    plan?: string | null;
+    /** Quanto paga por mês, em centavos. Plano anual entra dividido por 12. */
+    mrrCents?: number;
+    startedAt?: DateInput | null;
+    canceledAt?: DateInput | null;
+    metadata?: Record<string, string | number | boolean | null>;
+}
+export interface Transaction {
+    type: TransactionType;
+    /** Sempre positivo: o tipo dá o sinal. */
+    amountCents: number;
+    occurredAt: DateInput;
+    description?: string | null;
+    subscriberExternalId?: string | null;
+    method?: string | null;
+    /** Do que é o custo (ia, sms, armazenamento…): abre o custo por tipo no relatório. */
+    category?: string | null;
+}
+/** O custo de um assinante num mês, de um tipo. */
+export interface SubscriberCost {
+    /** Id do assinante no seu sistema (o mesmo de `subscribers.upsert`). */
+    subscriberExternalId: string;
+    /** Do que é o custo: "ia", "sms", "armazenamento"… */
+    category: string;
+    amountCents: number;
+}
+export interface BillingCustomer {
+    name: string;
+    document?: string | null;
+    email?: string | null;
+    phone?: string | null;
+    address?: string | null;
+    /** Endereço em campos, que a nota fiscal pede. Sem ele a nota sai sem endereço do cliente. */
+    fiscalAddress?: {
+        /** Só números (8). */
+        postalCode: string;
+        /** Código IBGE do município (7 números). */
+        cityCode: string;
+        street: string;
+        number: string;
+        complement?: string | null;
+        district: string;
+    } | null;
+}
+export interface BillingItem {
+    description: string;
+    /** Padrão 1. Aceita fração (horas, mês proporcional). */
+    quantity?: number;
+    unitPriceCents: number;
+}
+export interface QuoteInput {
+    customer: BillingCustomer;
+    items: BillingItem[];
+    discountCents?: number;
+    /** Texto do rodapé do PDF: condições, observações. */
+    notes?: string | null;
+    /** Até quando vale, `AAAA-MM-DD`. */
+    validUntil?: string | null;
+}
+export interface ChargeInput {
+    customer: BillingCustomer;
+    items: BillingItem[];
+    discountCents?: number;
+    notes?: string | null;
+    /** Vencimento, `AAAA-MM-DD`. */
+    dueDate: string;
+    /** Onde o cliente paga (boleto, Pix, checkout). Vai no PDF. */
+    paymentUrl?: string | null;
+    /** Id do orçamento que virou esta cobrança. */
+    quoteExternalId?: string | null;
+    /** Id do assinante (o mesmo de `subscribers.upsert`). Paga, a receita entra na linha dele no relatório. */
+    subscriberExternalId?: string | null;
+}
+export interface Invoice {
+    number: string;
+    url: string | null;
+    issuedAt: string | null;
+}
+/** O documento como o sistema guardou: com número, totais calculados e o link do PDF. */
+export interface BillingDocument<TStatus extends string> {
+    id: number;
+    kind: "quote" | "charge";
+    externalId: string;
+    number: number;
+    status: TStatus;
+    /** Em aberto e com a data vencida. */
+    overdue: boolean;
+    customer: BillingCustomer;
+    items: Required<BillingItem>[];
+    subtotalCents: number;
+    discountCents: number;
+    totalCents: number;
+    notes: string | null;
+    validUntil: string | null;
+    dueDate: string | null;
+    paymentUrl: string | null;
+    paymentMethod: string | null;
+    paidAt: string | null;
+    invoice: Invoice | null;
+    /** Link público do PDF, com a logo do serviço. */
+    pdfUrl: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export type PaymentProvider = "asaas" | "inter" | "stripe" | "mercadopago" | "woovi" | "abacatepay";
+export type PaymentMethod = "pix" | "boleto" | "card" | "checkout";
+export type PaymentStatus = "pending" | "paid" | "expired" | "canceled" | "refunded" | "failed";
+/** O pagamento de uma cobrança num provedor: o que mandar pro cliente pagar. */
+export interface Payment {
+    id: number;
+    provider: PaymentProvider;
+    method: PaymentMethod;
+    status: PaymentStatus;
+    amountCents: number;
+    /** Página do provedor onde o cliente paga (fatura, checkout). */
+    paymentUrl: string | null;
+    /** Pix copia e cola. */
+    pixCopyPaste: string | null;
+    /** QR code do Pix: `data:image/png;base64,…` ou endereço https da imagem. */
+    pixQrCodeImage: string | null;
+    boletoUrl: string | null;
+    /** Linha digitável do boleto. */
+    boletoLine: string | null;
+    expiresAt: string | null;
+    paidAt: string | null;
+    createdAt: string;
+}
+/** `pix` é o Pix Automático (Woovi); `card` é cartão recorrente (Asaas ou Stripe). */
+export type SubscriptionMethod = "pix" | "card";
+export type SubscriptionInterval = "weekly" | "monthly" | "quarterly" | "semiannual" | "yearly";
+/**
+ * `pending_authorization`: o cliente ainda não autorizou no banco dele.
+ * `active`: autorizada, os débitos acontecem sozinhos.
+ */
+export type SubscriptionStatus = "pending_authorization" | "active" | "rejected" | "canceled" | "expired";
+export interface SubscriptionAddress {
+    /** CEP, 8 números. */
+    zipCode: string;
+    street: string;
+    number: string;
+    complement?: string | null;
+    neighborhood: string;
+    city: string;
+    /** UF, 2 letras. */
+    state: string;
+}
+export interface SubscriptionCustomer {
+    name: string;
+    /** CPF ou CNPJ: a recorrência é autorizada na conta desse documento. */
+    document: string;
+    email?: string | null;
+    phone?: string | null;
+    /** Obrigatório no Pix Automático (a Woovi exige). No cartão é opcional. */
+    address?: SubscriptionAddress | null;
+}
+export interface SubscriptionInput {
+    customer: SubscriptionCustomer;
+    /** O que o cliente vê no banco ao autorizar e em cada cobrança gerada. */
+    description: string;
+    amountCents: number;
+    /** Padrão: `pix`. */
+    method?: SubscriptionMethod;
+    /** Padrão: `monthly`. */
+    interval?: SubscriptionInterval;
+    /** Dia do primeiro débito, `AAAA-MM-DD`. */
+    startDate: string;
+    /** Id do assinante (o mesmo de `subscribers.upsert`). Cada débito pago entra na linha dele no relatório. */
+    subscriberExternalId?: string | null;
+    /** Qual provedor usar. Vazio: a conta padrão do CNPJ do serviço. */
+    provider?: PaymentProvider;
+}
+/** Pagamento recorrente: Pix Automático ou cartão. */
+export interface Subscription {
+    id: number;
+    externalId: string;
+    provider: PaymentProvider;
+    status: SubscriptionStatus;
+    description: string;
+    amountCents: number;
+    method: SubscriptionMethod;
+    interval: SubscriptionInterval;
+    startDate: string;
+    customer: SubscriptionCustomer;
+    /** Página onde o cliente autoriza a recorrência (no cartão: onde ele cadastra o cartão). */
+    authorizationUrl: string | null;
+    /** Pix copia e cola da autorização. Só no Pix Automático. */
+    pixCopyPaste: string | null;
+    pixQrCodeImage: string | null;
+    /** Quantos débitos já foram pagos. */
+    paidCycles: number;
+    lastPaidAt: string | null;
+    canceledAt: string | null;
+    createdAt: string;
+}
+export type FiscalInvoiceStatus = "pending" | "issued" | "rejected" | "cancelled";
+/** Recusa (ou aviso) do governo: o código dele e o texto. */
+export interface FiscalInvoiceMessage {
+    code: string;
+    message: string;
+    detail: string | null;
+}
+/** A NFS-e de uma cobrança, emitida pelo Emissor Nacional. */
+export interface FiscalInvoice {
+    id: number;
+    /** `pending`: o governo ainda não confirmou (consulte de novo); `rejected`: veja `messages`. */
+    status: FiscalInvoiceStatus;
+    environment: "restricted" | "production";
+    series: string;
+    dpsNumber: number;
+    dpsId: string;
+    accessKey: string | null;
+    nfseNumber: string | null;
+    amountCents: number;
+    description: string;
+    competenceDate: string;
+    issuedAt: string | null;
+    cancelledAt: string | null;
+    cancelReason: string | null;
+    messages: FiscalInvoiceMessage[];
+    /** Link público do PDF (DANFSe), só com a nota autorizada. */
+    pdfUrl: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface IssueInvoiceOptions {
+    /** Descrição do serviço nesta nota; vazio, a padrão do serviço. */
+    description?: string | null;
+    /** Quando o serviço foi prestado, `AAAA-MM-DD`; vazio, hoje. */
+    competenceDate?: string | null;
+}
+export type InvestmentType = "fixed_income" | "treasury" | "fund" | "stock" | "reit" | "etf" | "crypto" | "pension" | "savings" | "other";
+export type InvestmentLiquidity = "immediate" | "at_maturity" | "locked";
+export type InvestmentStatus = "active" | "closed";
+export type InvestmentMovementType = "contribution" | "redemption" | "income" | "fee";
+/** Um investimento como o serviço o enxerga agora. */
+export interface InvestmentPosition {
+    name: string;
+    type: InvestmentType;
+    /** Valor aplicado, em centavos. */
+    investedCents: number;
+    /** Valor de hoje, em centavos. */
+    currentCents: number;
+    /** CPF ou CNPJ (com ou sem pontuação) de quem é o investimento, já cadastrado no sistema. Sem ele, é da empresa dona do serviço. */
+    holderDocument?: string | null;
+    ticker?: string | null;
+    institution?: string | null;
+    /** Cotas, ações ou moedas: aceita decimal. */
+    quantity?: number | null;
+    /** Quando o valor foi medido (ISO 8601). Sem ele, vale o momento em que a api recebe. Serve pra mandar histórico. */
+    referenceAt?: DateInput;
+    /** Sem ele, na criação vale o padrão do tipo e na atualização fica o que estava. */
+    liquidity?: InvestmentLiquidity;
+    /** `AAAA-MM-DD`. */
+    maturityDate?: string | null;
+    /** Taxa ou indexador em texto livre: "110% do CDI". */
+    rate?: string | null;
+    /** Padrão `active`. `closed` encerra a posição (o histórico fica). */
+    status?: InvestmentStatus;
+    /** Só vale na criação: depois a observação é da pessoa, na tela. */
+    notes?: string | null;
+}
+export interface InvestmentHistoryPoint {
+    referenceAt: DateInput;
+    currentCents: number;
+    investedCents: number;
+    quantity?: number | null;
+}
+export interface InvestmentMovement {
+    /** Id da posição no seu sistema (o mesmo de `investments.positions.upsert`). */
+    positionExternalId: string;
+    type: InvestmentMovementType;
+    /** `AAAA-MM-DD`. */
+    date: string;
+    /** Sempre positivo: o tipo dá o sentido. */
+    amountCents: number;
+    quantity?: number | null;
+    description?: string | null;
+}
+export interface InvestmentPositionView {
+    id: number;
+    entityId: number;
+    entityName: string;
+    externalId: string | null;
+    name: string;
+    ticker: string | null;
+    type: InvestmentType;
+    institution: string | null;
+    quantity: number | null;
+    investedCents: number;
+    currentCents: number;
+    returnCents: number;
+    returnRatio: number | null;
+    valueAt: string;
+    liquidity: InvestmentLiquidity;
+    maturityDate: string | null;
+    rate: string | null;
+    status: InvestmentStatus;
+    closedAt: string | null;
+}
+export interface UpsertedInvestmentPosition {
+    id: number;
+    externalId: string;
+    created: boolean;
+    /** Se virou um ponto novo no histórico (idêntico a um que já existia, não vira). */
+    recorded: boolean;
+}
+export type Quote = BillingDocument<QuoteStatus>;
+export type Charge = BillingDocument<ChargeStatus>;
+/** Tipo de aviso: `<objeto>.<situação nova>`. */
+export type WebhookEventType = `charge.${ChargeStatus}` | `quote.${QuoteStatus}` | `payment.${PaymentStatus}` | `subscription.${SubscriptionStatus}` | `invoice.${Exclude<FiscalInvoiceStatus, "pending">}` | "webhook.test";
+/** O que um endereço quer receber: um tipo exato, `<objeto>.*` (ex.: `charge.*`) ou `*` (tudo). */
+export type WebhookEventFilter = WebhookEventType | "charge.*" | "quote.*" | "payment.*" | "subscription.*" | "invoice.*" | "*";
+interface WebhookEventBase<TType extends string, TData> {
+    /** Id do aviso: o mesmo em todas as tentativas. Use pra não processar duas vezes. */
+    id: string;
+    type: TType;
+    /** Quando aconteceu (ISO 8601). */
+    timestamp: string;
+    /** A situação antes desta mudança. */
+    previousStatus: string | null;
+    /** O objeto como está agora, no mesmo formato do GET dele. */
+    data: TData;
+}
+/** Todo aviso que o Core manda. Discrimine por `type`. */
+export type CoreWebhookEvent = WebhookEventBase<`charge.${ChargeStatus}`, Charge> | WebhookEventBase<`quote.${QuoteStatus}`, Quote> | WebhookEventBase<`payment.${PaymentStatus}`, Payment & {
+    chargeExternalId: string;
+}> | WebhookEventBase<`subscription.${SubscriptionStatus}`, Subscription> | WebhookEventBase<`invoice.${Exclude<FiscalInvoiceStatus, "pending">}`, FiscalInvoice & {
+    chargeExternalId: string | null;
+}> | WebhookEventBase<"webhook.test", {
+    message: string;
+    endpointId: number;
+}>;
+export interface WebhookEndpointInput {
+    /** Endereço que recebe o POST. Em produção, https público. */
+    url: string;
+    /** Sem isto, recebe tudo. */
+    events?: WebhookEventFilter[];
+    description?: string | null;
+}
+export interface WebhookEndpoint {
+    id: number;
+    url: string;
+    events: WebhookEventFilter[];
+    description: string | null;
+    /** Desativado não recebe, mas guarda os avisos e manda tudo ao reativar. */
+    active: boolean;
+    /** Avisos esperando o endereço aceitar. */
+    pendingDeliveries: number;
+    oldestPendingAt: string | null;
+    lastDeliveredAt: string | null;
+    /** O último erro de um aviso ainda pendente (ex.: `HTTP 500: ...`). */
+    lastError: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface WebhookDelivery {
+    id: number;
+    eventId: string;
+    eventType: WebhookEventType;
+    status: "pending" | "delivered";
+    attempts: number;
+    /** Quando sai a próxima tentativa (só pendente). */
+    nextAttemptAt: string | null;
+    lastAttemptAt: string | null;
+    lastStatusCode: number | null;
+    lastError: string | null;
+    deliveredAt: string | null;
+    createdAt: string;
+}
+export interface Page<T> {
+    items: T[];
+    total: number;
+    page: number;
+    limit: number;
+    nextPage: number | null;
+}
+export interface ClientOptions {
+    /** Endereço da api, sem o `/v1` (ex.: `https://felipepasc.com`). */
+    baseUrl: string;
+    /** A chave do serviço (`fk_…`), criada na aba Integração. */
+    apiKey: string;
+    /** Tempo máximo por chamada. Padrão: 15 s. */
+    timeoutMs?: number;
+    /** Quantas vezes repetir depois de falha de rede, 429 ou 5xx. Padrão: 2. */
+    retries?: number;
+    /** Pra testes: troca o `fetch` global. */
+    fetch?: typeof fetch;
+}
+/** Erro que a api devolveu (4xx/5xx) ou falha de rede (`status` 0). */
+export declare class CoreApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    /** No 400 de validação: a mensagem de cada campo. */
+    readonly fields: Record<string, string>;
+    constructor(status: number, code: string, message: string, fields?: Record<string, string>);
+}
+export declare function createClient(options: ClientOptions): {
+    /** Confere a chave e diz qual serviço ela representa. */
+    ping: () => Promise<{
+        service: {
+            id: number;
+            name: string;
+        };
+        time: string;
+    }>;
+    metrics: {
+        /** Os números de um dia. Reenviar o dia troca os valores das métricas enviadas. */
+        report: (date: DateInput, metrics: Record<string, number>) => Promise<{
+            date: string;
+            saved: number;
+        }>;
+    };
+    subscribers: {
+        /** Um assinante como está agora. */
+        upsert: (externalId: string, subscriber: Subscriber) => Promise<{
+            externalId: string;
+            saved: number;
+        }>;
+        /** Qualquer quantidade: o SDK divide em lotes de 500. */
+        upsertMany: (subscribers: (Subscriber & {
+            externalId: string;
+        })[]) => Promise<{
+            saved: number;
+        }>;
+    };
+    transactions: {
+        /** Um lançamento de dinheiro: entrada, estorno, taxa ou custo. */
+        upsert: (externalId: string, transaction: Transaction) => Promise<{
+            externalId: string;
+            saved: number;
+        }>;
+        /** Qualquer quantidade: o SDK divide em lotes de 500. */
+        upsertMany: (transactions: (Transaction & {
+            externalId: string;
+        })[]) => Promise<{
+            saved: number;
+        }>;
+    };
+    costs: {
+        /**
+         * Quanto cada assinante custou no mês, por tipo de custo. É o que faz o
+         * relatório do serviço mostrar a margem de cada assinante e abater o
+         * custo do resultado. Reenviar o mês troca os valores (mande o
+         * acumulado do mês, não o do dia). Zero remove o custo daquele tipo.
+         *
+         * `month` é `AAAA-MM`. Não mande o mesmo custo de novo em
+         * `transactions` nem na métrica `usage_cost_cents`: contaria em dobro.
+         */
+        reportMonth: (month: string, costs: SubscriberCost[]) => Promise<{
+            saved: number;
+        }>;
+    };
+    quotes: {
+        /** Cria ou troca o orçamento. Devolve o número, os totais e o `pdfUrl`. */
+        upsert: (externalId: string, quote: QuoteInput) => Promise<Quote>;
+        get: (externalId: string) => Promise<Quote>;
+        accept: (externalId: string) => Promise<Quote>;
+        reject: (externalId: string) => Promise<Quote>;
+        cancel: (externalId: string) => Promise<Quote>;
+    };
+    charges: {
+        /** Cria ou troca a cobrança. Devolve o número, os totais e o `pdfUrl`. */
+        upsert: (externalId: string, charge: ChargeInput) => Promise<Charge>;
+        get: (externalId: string) => Promise<Charge>;
+        /**
+         * Marca como paga. O valor entra sozinho como receita do serviço nos
+         * relatórios: não mande o mesmo pagamento de novo em `transactions`.
+         */
+        markPaid: (externalId: string, payment?: {
+            paidAt?: DateInput;
+            method?: string;
+        }) => Promise<Charge>;
+        /** Volta pra em aberto (pagamento estornado ou marcado por engano). */
+        reopen: (externalId: string) => Promise<Charge>;
+        cancel: (externalId: string) => Promise<Charge>;
+        /**
+         * Gera o pagamento da cobrança no provedor configurado no CNPJ do serviço
+         * (o padrão, ou o `provider` pedido). Devolve o Pix, o boleto ou o link.
+         * Quando o cliente paga, o provedor avisa o sistema e a cobrança vira paga
+         * sozinha: não precisa chamar `markPaid`. Pedir de novo a mesma forma
+         * devolve o pagamento que já está aguardando.
+         */
+        createPayment: (externalId: string, options?: {
+            method?: PaymentMethod;
+            provider?: PaymentProvider;
+        }) => Promise<Payment>;
+        /** Os pagamentos já gerados pra cobrança, do mais novo pro mais antigo. */
+        listPayments: (externalId: string) => Promise<Payment[]>;
+        /** Liga a nota fiscal emitida à cobrança: o número (e o link) passam a sair no PDF. */
+        attachInvoice: (externalId: string, invoice: {
+            number: string;
+            url?: string | null;
+            issuedAt?: DateInput | null;
+        }) => Promise<Charge>;
+        /**
+         * Emite a NFS-e da cobrança pelo Emissor Nacional, com o certificado da empresa. O valor é o
+         * total da cobrança e o tomador é o cliente dela. Repetir não gera outra nota: devolve a que
+         * existe. Fique de olho no `status`: `issued` (autorizada), `pending` (o governo não respondeu;
+         * chame `invoice` mais tarde) ou `rejected` (veja `messages`; corrija e chame de novo). Faltando
+         * configuração fiscal da empresa ou do serviço, vem 400 com `fields`.
+         */
+        issueInvoice: (externalId: string, options?: IssueInvoiceOptions) => Promise<FiscalInvoice>;
+        /** A nota da cobrança. Pendente, consulta o governo antes de responder. */
+        invoice: (externalId: string) => Promise<FiscalInvoice>;
+        /** Cancela a nota autorizada. `reasonCode`: 1 erro na emissão, 2 serviço não prestado, 9 outros. `reason` tem de 15 a 255 letras. */
+        cancelInvoice: (externalId: string, cancellation: {
+            reasonCode: 1 | 2 | 9;
+            reason: string;
+        }) => Promise<FiscalInvoice>;
+    };
+    investments: {
+        positions: {
+            /**
+             * Uma posição como está agora. O investimento é de um titular (CPF ou CNPJ cadastrado), não do
+             * serviço: `holderDocument` diz de quem; sem ele, é da empresa dona do serviço. Documento que não
+             * existe no cadastro vira erro 400 com `fields` (o sistema não cria titular). Cada reporte vira um
+             * ponto do histórico; só o de referência mais recente é o valor atual.
+             */
+            upsert: (externalId: string, position: InvestmentPosition) => Promise<UpsertedInvestmentPosition>;
+            /** Qualquer quantidade: o SDK divide em lotes de 200. Cada lote é tudo ou nada. */
+            upsertMany: (positions: (InvestmentPosition & {
+                externalId: string;
+            })[]) => Promise<{
+                saved: number;
+                positions: UpsertedInvestmentPosition[];
+            }>;
+            /** As posições que este serviço reportou (e só elas). */
+            list: (query?: {
+                status?: "active" | "closed" | "all";
+                page?: number;
+                limit?: number;
+            }) => Promise<{
+                items: InvestmentPositionView[];
+                total: number;
+                page: number;
+                limit: number;
+            }>;
+            /** Encerra a posição (o histórico fica). Reportar de novo como ativa reabre. */
+            close: (externalId: string) => Promise<InvestmentPositionView>;
+            /**
+             * Pontos de histórico de uma posição já reportada, em lote (até 500 por chamada), pra preencher o passado.
+             * Ponto antigo entra no histórico e não troca o valor atual; só o ponto de referência mais recente o troca.
+             * Repetir um ponto idêntico não duplica.
+             */
+            reportHistory: (externalId: string, points: InvestmentHistoryPoint[]) => Promise<{
+                received: number;
+                recorded: number;
+                skipped: number;
+                currentUpdated: boolean;
+            }>;
+        };
+        movements: {
+            /** Aporte, resgate, rendimento ou taxa de uma posição que o serviço já reportou. */
+            upsert: (externalId: string, movement: InvestmentMovement) => Promise<{
+                saved: number;
+            }>;
+            /** Qualquer quantidade: o SDK divide em lotes de 500. */
+            upsertMany: (movements: (InvestmentMovement & {
+                externalId: string;
+            })[]) => Promise<{
+                saved: number;
+            }>;
+        };
+    };
+    subscriptions: {
+        /**
+         * Cria o pagamento recorrente no provedor do CNPJ: Pix Automático
+         * (`method: "pix"`, pela Woovi) ou cartão (`method: "card"`, pelo Asaas ou
+         * pela Stripe). O cliente autoriza uma vez (`pixCopyPaste` no banco dele, ou
+         * `authorizationUrl` pra cadastrar o cartão) e os débitos seguintes acontecem sozinhos: cada um
+         * pago vira uma cobrança paga do serviço, sem chamada nenhuma. Pedir de
+         * novo o mesmo id devolve a recorrência que já existe; pra mudar valor ou
+         * intervalo, cancele e crie outra.
+         */
+        create: (externalId: string, subscription: SubscriptionInput) => Promise<Subscription>;
+        get: (externalId: string) => Promise<Subscription>;
+        /** Encerra a recorrência: não há mais débitos. */
+        cancel: (externalId: string) => Promise<Subscription>;
+    };
+    /**
+     * Avisos do Core pro seu serviço. Cadastre o endereço uma vez e guarde o `secret` (só aparece ao criar):
+     * cada mudança de situação (cobrança paga, nota emitida, recorrência ativada...) chega por POST, assinada.
+     * Responda 2xx pra confirmar. Qualquer outra resposta, erro ou demora (15 s) faz o Core tentar de novo,
+     * esperando 2 s, 4 s, 8 s, 16 s... até 1 hora entre tentativas, pra sempre, até você aceitar.
+     * Confira cada aviso com `verifyWebhook`.
+     */
+    webhooks: {
+        list: () => Promise<WebhookEndpoint[]>;
+        get: (endpointId: number) => Promise<WebhookEndpoint>;
+        /** Devolve o endereço com o `secret`. Endereço repetido dá 409 `webhook_exists`. */
+        create: (endpoint: WebhookEndpointInput) => Promise<WebhookEndpoint & {
+            secret: string;
+        }>;
+        /** Trocar o endereço ou reativar manda na hora o que estava esperando. */
+        update: (endpointId: number, changes: Partial<WebhookEndpointInput> & {
+            active?: boolean;
+        }) => Promise<WebhookEndpoint>;
+        /** Apaga o endereço e descarta o que ainda não foi entregue nele. */
+        delete: (endpointId: number) => Promise<{
+            deleted: true;
+        }>;
+        /** Segredo novo, valendo na hora. */
+        rotateSecret: (endpointId: number) => Promise<{
+            secret: string;
+        }>;
+        /** Manda um `webhook.test` pra este endereço. */
+        test: (endpointId: number) => Promise<{
+            eventId: string;
+        }>;
+        deliveries: (endpointId: number, query?: {
+            status?: "pending" | "delivered";
+            page?: number;
+            limit?: number;
+        }) => Promise<Page<WebhookDelivery>>;
+        /** Manda de novo agora (também a já entregue). */
+        resend: (endpointId: number, deliveryId: number) => Promise<WebhookDelivery>;
+    };
+    /** Todos os avisos já gerados pro serviço, do mais novo ao mais antigo: pra conferir o que pode ter passado. */
+    events: {
+        list: (query?: {
+            type?: WebhookEventFilter;
+            since?: DateInput;
+            page?: number;
+            limit?: number;
+        }) => Promise<Page<CoreWebhookEvent>>;
+        get: (eventId: string) => Promise<CoreWebhookEvent>;
+    };
+};
+/** Aviso com assinatura que não confere, velho demais ou malformado: responda 400 e não processe. */
+export declare class WebhookVerificationError extends Error {
+    constructor(message: string);
+}
+export type WebhookHeaders = Headers | Record<string, string | string[] | undefined>;
+export interface VerifyWebhookOptions {
+    /** O corpo CRU, exatamente como chegou (texto ou bytes). JSON já interpretado e reescrito não confere. */
+    payload: string | Uint8Array;
+    headers: WebhookHeaders;
+    /** O `secret` do endereço (`whsec_...`). */
+    secret: string;
+    /** Diferença máxima entre o relógio do aviso e o seu, em segundos (padrão 300). */
+    toleranceSeconds?: number;
+}
+/**
+ * Confere a assinatura de um aviso do Core (padrão Standard Webhooks: cabeçalhos `webhook-id`,
+ * `webhook-timestamp` e `webhook-signature`) e devolve o aviso já interpretado. Falhou, lança
+ * `WebhookVerificationError`.
+ *
+ *   app.post("/core/webhook", express.raw({ type: "application/json" }), async (req, res) => {
+ *       const event = await verifyWebhook({ payload: req.body, headers: req.headers, secret: process.env.CORE_WEBHOOK_SECRET });
+ *       if (event.type === "charge.paid") await releaseOrder(event.data.externalId);
+ *       res.sendStatus(204);
+ *   });
+ *
+ * O mesmo aviso pode chegar mais de uma vez (o Core repete até ter 2xx): use `event.id` pra não processar duas vezes.
+ */
+export declare function verifyWebhook(options: VerifyWebhookOptions): Promise<CoreWebhookEvent>;
+export type CoreClient = ReturnType<typeof createClient>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,373 @@
+/**
+ * SDK do sistema financeiro: o que cada serviço usa pra reportar os próprios
+ * dados e gerar orçamentos e cobranças. Sem dependências: só `fetch` e `crypto` (Node 20+).
+ *
+ *   const core = createClient({ baseUrl: process.env.CORE_API_URL, apiKey: process.env.CORE_API_KEY });
+ *   await core.metrics.report("2026-10-12", { subscribers_active: 120 });
+ *   const charge = await core.charges.upsert("inv_981", { customer, items, dueDate: "2026-10-20" });
+ *   charge.pdfUrl; // link do PDF pra mandar ao cliente
+ *   const pix = await core.charges.createPayment("inv_981", { method: "pix" });
+ *   pix.pixCopyPaste; // o provedor é o que estiver configurado no CNPJ
+ *
+ * Dinheiro é sempre em centavos, inteiro. Tudo é idempotente pelo id que o
+ * serviço manda: repetir a chamada troca o que estava, não duplica.
+ */
+/** Erro que a api devolveu (4xx/5xx) ou falha de rede (`status` 0). */
+export class CoreApiError extends Error {
+    status;
+    code;
+    /** No 400 de validação: a mensagem de cada campo. */
+    fields;
+    constructor(status, code, message, fields = {}) {
+        super(message);
+        this.name = "CoreApiError";
+        this.status = status;
+        this.code = code;
+        this.fields = fields;
+    }
+}
+// ─── Cliente ────────────────────────────────────────────────────────
+const BATCH_SIZE = 500;
+function isoDay(date) {
+    return typeof date === "string" ? date.slice(0, 10) : date.toISOString().slice(0, 10);
+}
+function chunk(items, size) {
+    const parts = [];
+    for (let index = 0; index < items.length; index += size)
+        parts.push(items.slice(index, index + size));
+    return parts;
+}
+const wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+export function createClient(options) {
+    const baseUrl = options.baseUrl.replace(/\/+$/, "");
+    const timeoutMs = options.timeoutMs ?? 15_000;
+    const retries = options.retries ?? 2;
+    const doFetch = options.fetch ?? fetch;
+    if (!baseUrl)
+        throw new Error("createClient: informe o baseUrl da api");
+    if (!options.apiKey)
+        throw new Error("createClient: informe a apiKey do serviço");
+    async function request(method, path, body) {
+        let lastError = null;
+        for (let attempt = 0; attempt <= retries; attempt += 1) {
+            if (attempt > 0)
+                await wait(300 * 2 ** (attempt - 1));
+            let response;
+            try {
+                response = await doFetch(`${baseUrl}/v1${path}`, {
+                    method,
+                    headers: { Authorization: `Bearer ${options.apiKey}`, ...(body === undefined ? {} : { "Content-Type": "application/json" }) },
+                    body: body === undefined ? undefined : JSON.stringify(body),
+                    signal: AbortSignal.timeout(timeoutMs),
+                });
+            }
+            catch (err) {
+                lastError = new CoreApiError(0, "network_error", err instanceof Error ? err.message : "falha de rede");
+                continue;
+            }
+            if (response.ok)
+                return (await response.json());
+            const payload = (await response.json().catch(() => null));
+            lastError = new CoreApiError(response.status, payload?.error?.code ?? "request_error", payload?.error?.message ?? `a api respondeu ${response.status}`, payload?.error?.fields);
+            // Erro de quem chamou (400, 401, 404, 409) não melhora repetindo.
+            const retryable = response.status === 429 || response.status >= 500;
+            if (!retryable)
+                throw lastError;
+        }
+        throw lastError ?? new CoreApiError(0, "network_error", "falha de rede");
+    }
+    const id = (externalId) => encodeURIComponent(externalId);
+    return {
+        /** Confere a chave e diz qual serviço ela representa. */
+        ping: () => request("GET", "/ping"),
+        metrics: {
+            /** Os números de um dia. Reenviar o dia troca os valores das métricas enviadas. */
+            report: (date, metrics) => request("PUT", `/metrics/${isoDay(date)}`, { metrics }),
+        },
+        subscribers: {
+            /** Um assinante como está agora. */
+            upsert: (externalId, subscriber) => request("PUT", `/subscribers/${id(externalId)}`, subscriber),
+            /** Qualquer quantidade: o SDK divide em lotes de 500. */
+            upsertMany: async (subscribers) => {
+                let saved = 0;
+                for (const part of chunk(subscribers, BATCH_SIZE)) {
+                    const result = await request("POST", "/subscribers/batch", { subscribers: part });
+                    saved += result.saved;
+                }
+                return { saved };
+            },
+        },
+        transactions: {
+            /** Um lançamento de dinheiro: entrada, estorno, taxa ou custo. */
+            upsert: (externalId, transaction) => request("PUT", `/transactions/${id(externalId)}`, transaction),
+            /** Qualquer quantidade: o SDK divide em lotes de 500. */
+            upsertMany: async (transactions) => {
+                let saved = 0;
+                for (const part of chunk(transactions, BATCH_SIZE)) {
+                    const result = await request("POST", "/transactions/batch", { transactions: part });
+                    saved += result.saved;
+                }
+                return { saved };
+            },
+        },
+        costs: {
+            /**
+             * Quanto cada assinante custou no mês, por tipo de custo. É o que faz o
+             * relatório do serviço mostrar a margem de cada assinante e abater o
+             * custo do resultado. Reenviar o mês troca os valores (mande o
+             * acumulado do mês, não o do dia). Zero remove o custo daquele tipo.
+             *
+             * `month` é `AAAA-MM`. Não mande o mesmo custo de novo em
+             * `transactions` nem na métrica `usage_cost_cents`: contaria em dobro.
+             */
+            reportMonth: async (month, costs) => {
+                if (!/^\d{4}-(0[1-9]|1[0-2])$/.test(month))
+                    throw new Error("costs.reportMonth: month no formato AAAA-MM");
+                // Meio-dia do dia 1 em Brasília: cai dentro do mês em qualquer fuso do servidor.
+                const occurredAt = `${month}-01T12:00:00-03:00`;
+                const slug = (text) => text.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").slice(0, 30);
+                const transactions = costs.map((cost) => ({ externalId: `cost:${month}:${cost.subscriberExternalId}:${slug(cost.category)}`.slice(0, 120), type: "cost", amountCents: cost.amountCents, occurredAt, subscriberExternalId: cost.subscriberExternalId, category: cost.category, description: `Custo de ${cost.category}` }));
+                let saved = 0;
+                for (const part of chunk(transactions, BATCH_SIZE)) {
+                    const result = await request("POST", "/transactions/batch", { transactions: part });
+                    saved += result.saved;
+                }
+                return { saved };
+            },
+        },
+        quotes: {
+            /** Cria ou troca o orçamento. Devolve o número, os totais e o `pdfUrl`. */
+            upsert: (externalId, quote) => request("PUT", `/quotes/${id(externalId)}`, quote),
+            get: (externalId) => request("GET", `/quotes/${id(externalId)}`),
+            accept: (externalId) => request("PUT", `/quotes/${id(externalId)}/status`, { status: "accepted" }),
+            reject: (externalId) => request("PUT", `/quotes/${id(externalId)}/status`, { status: "rejected" }),
+            cancel: (externalId) => request("PUT", `/quotes/${id(externalId)}/status`, { status: "canceled" }),
+        },
+        charges: {
+            /** Cria ou troca a cobrança. Devolve o número, os totais e o `pdfUrl`. */
+            upsert: (externalId, charge) => request("PUT", `/charges/${id(externalId)}`, charge),
+            get: (externalId) => request("GET", `/charges/${id(externalId)}`),
+            /**
+             * Marca como paga. O valor entra sozinho como receita do serviço nos
+             * relatórios: não mande o mesmo pagamento de novo em `transactions`.
+             */
+            markPaid: (externalId, payment = {}) => request("PUT", `/charges/${id(externalId)}/status`, { status: "paid", ...payment }),
+            /** Volta pra em aberto (pagamento estornado ou marcado por engano). */
+            reopen: (externalId) => request("PUT", `/charges/${id(externalId)}/status`, { status: "open" }),
+            cancel: (externalId) => request("PUT", `/charges/${id(externalId)}/status`, { status: "canceled" }),
+            /**
+             * Gera o pagamento da cobrança no provedor configurado no CNPJ do serviço
+             * (o padrão, ou o `provider` pedido). Devolve o Pix, o boleto ou o link.
+             * Quando o cliente paga, o provedor avisa o sistema e a cobrança vira paga
+             * sozinha: não precisa chamar `markPaid`. Pedir de novo a mesma forma
+             * devolve o pagamento que já está aguardando.
+             */
+            createPayment: (externalId, options = {}) => request("POST", `/charges/${id(externalId)}/payments`, options),
+            /** Os pagamentos já gerados pra cobrança, do mais novo pro mais antigo. */
+            listPayments: (externalId) => request("GET", `/charges/${id(externalId)}/payments`),
+            /** Liga a nota fiscal emitida à cobrança: o número (e o link) passam a sair no PDF. */
+            attachInvoice: (externalId, invoice) => request("PUT", `/charges/${id(externalId)}/invoice`, invoice),
+            /**
+             * Emite a NFS-e da cobrança pelo Emissor Nacional, com o certificado da empresa. O valor é o
+             * total da cobrança e o tomador é o cliente dela. Repetir não gera outra nota: devolve a que
+             * existe. Fique de olho no `status`: `issued` (autorizada), `pending` (o governo não respondeu;
+             * chame `invoice` mais tarde) ou `rejected` (veja `messages`; corrija e chame de novo). Faltando
+             * configuração fiscal da empresa ou do serviço, vem 400 com `fields`.
+             */
+            issueInvoice: (externalId, options = {}) => request("POST", `/charges/${id(externalId)}/invoice`, options),
+            /** A nota da cobrança. Pendente, consulta o governo antes de responder. */
+            invoice: (externalId) => request("GET", `/charges/${id(externalId)}/invoice`),
+            /** Cancela a nota autorizada. `reasonCode`: 1 erro na emissão, 2 serviço não prestado, 9 outros. `reason` tem de 15 a 255 letras. */
+            cancelInvoice: (externalId, cancellation) => request("POST", `/charges/${id(externalId)}/invoice/cancel`, cancellation),
+        },
+        investments: {
+            positions: {
+                /**
+                 * Uma posição como está agora. O investimento é de um titular (CPF ou CNPJ cadastrado), não do
+                 * serviço: `holderDocument` diz de quem; sem ele, é da empresa dona do serviço. Documento que não
+                 * existe no cadastro vira erro 400 com `fields` (o sistema não cria titular). Cada reporte vira um
+                 * ponto do histórico; só o de referência mais recente é o valor atual.
+                 */
+                upsert: async (externalId, position) => {
+                    const result = await request("PUT", "/investments/positions", { positions: [{ ...position, externalId }] });
+                    return result.positions[0];
+                },
+                /** Qualquer quantidade: o SDK divide em lotes de 200. Cada lote é tudo ou nada. */
+                upsertMany: async (positions) => {
+                    const saved = [];
+                    for (const part of chunk(positions, 200)) {
+                        const result = await request("PUT", "/investments/positions", { positions: part });
+                        saved.push(...result.positions);
+                    }
+                    return { saved: saved.length, positions: saved };
+                },
+                /** As posições que este serviço reportou (e só elas). */
+                list: (query = {}) => {
+                    const params = new URLSearchParams();
+                    if (query.status)
+                        params.set("status", query.status);
+                    if (query.page)
+                        params.set("page", String(query.page));
+                    if (query.limit)
+                        params.set("limit", String(query.limit));
+                    const suffix = params.size > 0 ? `?${params}` : "";
+                    return request("GET", `/investments/positions${suffix}`);
+                },
+                /** Encerra a posição (o histórico fica). Reportar de novo como ativa reabre. */
+                close: (externalId) => request("DELETE", `/investments/positions/${id(externalId)}`),
+                /**
+                 * Pontos de histórico de uma posição já reportada, em lote (até 500 por chamada), pra preencher o passado.
+                 * Ponto antigo entra no histórico e não troca o valor atual; só o ponto de referência mais recente o troca.
+                 * Repetir um ponto idêntico não duplica.
+                 */
+                reportHistory: async (externalId, points) => {
+                    const total = { received: 0, recorded: 0, skipped: 0, currentUpdated: false };
+                    for (const part of chunk(points, BATCH_SIZE)) {
+                        const result = await request("PUT", `/investments/positions/${id(externalId)}/history`, { points: part });
+                        total.received += result.received;
+                        total.recorded += result.recorded;
+                        total.skipped += result.skipped;
+                        total.currentUpdated = total.currentUpdated || result.currentUpdated;
+                    }
+                    return total;
+                },
+            },
+            movements: {
+                /** Aporte, resgate, rendimento ou taxa de uma posição que o serviço já reportou. */
+                upsert: (externalId, movement) => request("PUT", "/investments/movements", { movements: [{ ...movement, externalId }] }),
+                /** Qualquer quantidade: o SDK divide em lotes de 500. */
+                upsertMany: async (movements) => {
+                    let saved = 0;
+                    for (const part of chunk(movements, BATCH_SIZE)) {
+                        const result = await request("PUT", "/investments/movements", { movements: part });
+                        saved += result.saved;
+                    }
+                    return { saved };
+                },
+            },
+        },
+        subscriptions: {
+            /**
+             * Cria o pagamento recorrente no provedor do CNPJ: Pix Automático
+             * (`method: "pix"`, pela Woovi) ou cartão (`method: "card"`, pelo Asaas ou
+             * pela Stripe). O cliente autoriza uma vez (`pixCopyPaste` no banco dele, ou
+             * `authorizationUrl` pra cadastrar o cartão) e os débitos seguintes acontecem sozinhos: cada um
+             * pago vira uma cobrança paga do serviço, sem chamada nenhuma. Pedir de
+             * novo o mesmo id devolve a recorrência que já existe; pra mudar valor ou
+             * intervalo, cancele e crie outra.
+             */
+            create: (externalId, subscription) => request("PUT", `/subscriptions/${id(externalId)}`, subscription),
+            get: (externalId) => request("GET", `/subscriptions/${id(externalId)}`),
+            /** Encerra a recorrência: não há mais débitos. */
+            cancel: (externalId) => request("POST", `/subscriptions/${id(externalId)}/cancel`, {}),
+        },
+        /**
+         * Avisos do Core pro seu serviço. Cadastre o endereço uma vez e guarde o `secret` (só aparece ao criar):
+         * cada mudança de situação (cobrança paga, nota emitida, recorrência ativada...) chega por POST, assinada.
+         * Responda 2xx pra confirmar. Qualquer outra resposta, erro ou demora (15 s) faz o Core tentar de novo,
+         * esperando 2 s, 4 s, 8 s, 16 s... até 1 hora entre tentativas, pra sempre, até você aceitar.
+         * Confira cada aviso com `verifyWebhook`.
+         */
+        webhooks: {
+            list: () => request("GET", "/webhooks"),
+            get: (endpointId) => request("GET", `/webhooks/${endpointId}`),
+            /** Devolve o endereço com o `secret`. Endereço repetido dá 409 `webhook_exists`. */
+            create: (endpoint) => request("POST", "/webhooks", endpoint),
+            /** Trocar o endereço ou reativar manda na hora o que estava esperando. */
+            update: (endpointId, changes) => request("PATCH", `/webhooks/${endpointId}`, changes),
+            /** Apaga o endereço e descarta o que ainda não foi entregue nele. */
+            delete: (endpointId) => request("DELETE", `/webhooks/${endpointId}`),
+            /** Segredo novo, valendo na hora. */
+            rotateSecret: (endpointId) => request("POST", `/webhooks/${endpointId}/rotate-secret`, {}),
+            /** Manda um `webhook.test` pra este endereço. */
+            test: (endpointId) => request("POST", `/webhooks/${endpointId}/test`, {}),
+            deliveries: (endpointId, query = {}) => request("GET", `/webhooks/${endpointId}/deliveries${queryString(query)}`),
+            /** Manda de novo agora (também a já entregue). */
+            resend: (endpointId, deliveryId) => request("POST", `/webhooks/${endpointId}/deliveries/${deliveryId}/resend`, {}),
+        },
+        /** Todos os avisos já gerados pro serviço, do mais novo ao mais antigo: pra conferir o que pode ter passado. */
+        events: {
+            list: (query = {}) => {
+                const since = query.since === undefined ? undefined : typeof query.since === "string" ? query.since : query.since.toISOString();
+                return request("GET", `/events${queryString({ ...query, since })}`);
+            },
+            get: (eventId) => request("GET", `/events/${encodeURIComponent(eventId)}`),
+        },
+    };
+}
+function queryString(query) {
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(query)) {
+        if (value !== undefined && value !== "")
+            params.set(key, String(value));
+    }
+    const text = params.toString();
+    return text ? `?${text}` : "";
+}
+// ─── Conferir um aviso ──────────────────────────────────────────────
+/** Aviso com assinatura que não confere, velho demais ou malformado: responda 400 e não processe. */
+export class WebhookVerificationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "WebhookVerificationError";
+    }
+}
+function headerOf(headers, name) {
+    if (typeof Headers !== "undefined" && headers instanceof Headers)
+        return headers.get(name);
+    const record = headers;
+    const key = Object.keys(record).find((candidate) => candidate.toLowerCase() === name);
+    const value = key === undefined ? undefined : record[key];
+    return Array.isArray(value) ? (value[0] ?? null) : (value ?? null);
+}
+function base64ToBytes(value) {
+    const binary = atob(value);
+    const bytes = new Uint8Array(binary.length);
+    for (let index = 0; index < binary.length; index += 1)
+        bytes[index] = binary.charCodeAt(index);
+    return bytes;
+}
+/**
+ * Confere a assinatura de um aviso do Core (padrão Standard Webhooks: cabeçalhos `webhook-id`,
+ * `webhook-timestamp` e `webhook-signature`) e devolve o aviso já interpretado. Falhou, lança
+ * `WebhookVerificationError`.
+ *
+ *   app.post("/core/webhook", express.raw({ type: "application/json" }), async (req, res) => {
+ *       const event = await verifyWebhook({ payload: req.body, headers: req.headers, secret: process.env.CORE_WEBHOOK_SECRET });
+ *       if (event.type === "charge.paid") await releaseOrder(event.data.externalId);
+ *       res.sendStatus(204);
+ *   });
+ *
+ * O mesmo aviso pode chegar mais de uma vez (o Core repete até ter 2xx): use `event.id` pra não processar duas vezes.
+ */
+export async function verifyWebhook(options) {
+    const eventId = headerOf(options.headers, "webhook-id");
+    const timestamp = headerOf(options.headers, "webhook-timestamp");
+    const signatures = headerOf(options.headers, "webhook-signature");
+    if (!eventId || !timestamp || !signatures)
+        throw new WebhookVerificationError("faltam os cabeçalhos webhook-id, webhook-timestamp ou webhook-signature");
+    const seconds = Number(timestamp);
+    const tolerance = options.toleranceSeconds ?? 300;
+    if (!Number.isInteger(seconds) || Math.abs(Date.now() / 1000 - seconds) > tolerance)
+        throw new WebhookVerificationError("aviso fora da janela de tempo (relógio errado ou reenvio antigo)");
+    const body = typeof options.payload === "string" ? options.payload : new TextDecoder().decode(options.payload);
+    const subtle = globalThis.crypto.subtle;
+    const key = await subtle.importKey("raw", base64ToBytes(options.secret.replace(/^whsec_/, "")), { name: "HMAC", hash: "SHA-256" }, false, ["verify"]);
+    const signed = new TextEncoder().encode(`${eventId}.${timestamp}.${body}`);
+    for (const entry of signatures.split(" ")) {
+        const [version, signature] = entry.split(",");
+        if (version !== "v1" || !signature)
+            continue;
+        let bytes;
+        try {
+            bytes = base64ToBytes(signature);
+        }
+        catch {
+            continue;
+        }
+        if (await subtle.verify("HMAC", key, bytes, signed))
+            return JSON.parse(body);
+    }
+    throw new WebhookVerificationError("assinatura não confere");
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,42 @@
 {
   "name": "@felipepasc/core-sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Cliente da API de integração do Core: métricas, assinantes, lançamentos, orçamentos, cobranças e avisos (webhooks).",
+  "license": "UNLICENSED",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/felipepasc/core.git",
+    "directory": "sdk"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "clean": "rimraf dist tsconfig.tsbuildinfo",
+    "build": "npm run clean && tsc -b",
+    "dev": "tsc -b --watch --preserveWatchOutput",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "rimraf": "^6.1.3",
+    "typescript": "^6.0.3"
+  }
+}