Começar

Instale o pacoteCopy Anchor Link

npm install dunas pg

Configure as variáveis de ambienteCopy Anchor Link

Coloque só as do provedor que você vai usar.

DATABASE_URL=postgres://...

WOOVI_APP_ID=...

ABACATEPAY_API_KEY=...
ABACATEPAY_WEBHOOK_SECRET=...

CRON_SECRET=uma-string-longa-e-aleatoria

Declare os planosCopy Anchor Link

Cada plano diz o que inclui. Aqui, o grátis manda 100 mensagens por mês e o Pro manda 5.000 e libera os modelos avançados.

import { feature, plan } from "dunas"

export const messages = feature({ id: "messages", type: "metered" })
export const proModels = feature({ id: "pro_models", type: "boolean" })

export const free = plan({
  id: "free",
  default: true,
  includes: [messages({ limit: 100 })],
})

export const pro = plan({
  id: "pro",
  price: { amountInCents: 4_990, interval: "month" },
  includes: [messages({ limit: 5_000 }), proModels()],
})

Crie a instânciaCopy Anchor Link

import { createDunas, pg, woovi } from "dunas"
import { Pool } from "pg"
import { free, pro } from "./plans"

export const billing = createDunas({
  database: pg(new Pool({ connectionString: process.env.DATABASE_URL })),
  plans: [free, pro],
  providers: [woovi({ appId: process.env.WOOVI_APP_ID, sandbox: true })],
  identify: (request) => getUser(request),
})

identify recebe a requisição e devolve quem é o cliente ({ id, name, email }) ou null. Ligue na autenticação que você já tem.

Crie as tabelasCopy Anchor Link

await billing.migrate()

Cria as tabelas dunas_* no seu banco. Pode rodar a cada deploy: o que já existe não muda.

Monte a rotaCopy Anchor Link

Uma rota só atende o navegador, os webhooks dos provedores e o cron de renovações.

import { billing } from "@/billing/dunas"

export const GET = billing.handler
export const POST = billing.handler

Crie o clienteCopy Anchor Link

No navegador, o cliente conversa com essa rota e herda os tipos do servidor.

import { createDunasClient } from "dunas/client"
import type { billing } from "@/billing/dunas"

export const dunas = createDunasClient<typeof billing>()

ProntoCopy Anchor Link

O dunas está ligado. Agora:

• Limite o uso de uma feature no servidor.
• Monte a página de preços e cobre a primeira assinatura.
• Pague a cobrança no sandbox para ver o plano mudar.