better-auth-asaas 0.1.0

package/README.md

@@ -0,0 +1,214 @@
+# better-auth-asaas
+
+A [Better Auth](https://www.better-auth.com/) plugin that integrates with [Asaas](https://www.asaas.com/), the Brazilian payment gateway.
+
+> **Currency:** Asaas operates exclusively in **BRL (Brazilian Reais, R$)**. All `value` fields throughout this plugin are in BRL.
+
+## Features
+
+- 🚀 **Auto-creates an Asaas customer** when a user signs up
+- 🔗 **Links** `asaasCustomerId` to the user record automatically
+- 💳 **Subscription management** — create & cancel subscriptions (Boleto, Pix, Credit Card)
+- 🔔 **Webhook handler** — keeps local subscription status in sync with Asaas events
+- 📬 **Billing event hooks** — disable ALL Asaas-side notifications (Email, SMS, WhatsApp, Voice robot, Correios) and handle everything yourself via any provider (Resend, SendGrid, Nodemailer…)
+- 🔒 **Session-protected endpoints** — all billing actions require an authenticated session
+- 🏖️ **Sandbox support** — test safely with your Asaas sandbox account
+
+## Installation
+
+```bash
+npm install better-auth-asaas
+```
+
+## Setup
+
+### Server
+
+```ts
+// auth.ts
+import { betterAuth } from "better-auth";
+import { asaas } from "better-auth-asaas";
+
+export const auth = betterAuth({
+  plugins: [
+    asaas({
+      apiKey: process.env.ASAAS_API_KEY!,
+      sandbox: process.env.NODE_ENV !== "production",
+    }),
+  ],
+});
+```
+
+### Client
+
+```ts
+// auth-client.ts
+import { createAuthClient } from "better-auth/client";
+import { asaasClient } from "better-auth-asaas/client";
+
+export const authClient = createAuthClient({
+  plugins: [asaasClient()],
+});
+```
+
+### Database migration
+
+Run Better Auth's migration to add the `asaasCustomerId` column to the `user` table and create the `asaasSubscription` table:
+
+```bash
+npx better-auth migrate
+```
+
+## Usage
+
+### Get Asaas customer
+
+```ts
+const { data } = await authClient.asaas.getCustomer();
+console.log(data.customer); // AsaasCustomer | null
+```
+
+### Create a subscription with a free trial
+
+Pass `trialDays` instead of `nextDueDate` — the plugin computes the billing start date automatically. The subscription is **ACTIVE immediately**; Asaas simply won't generate the first charge until the trial ends.
+
+```ts
+const { data } = await authClient.asaas.subscriptionCreate({
+  billingType: "PIX",
+  value: 49.9,
+  trialDays: 14,       // free for 14 days, then billed monthly
+  cycle: "MONTHLY",
+  description: "Pro plan (with trial)",
+});
+// data.trialEndsAt — date billing kicks in
+```
+
+### Create a subscription
+
+> **Currency:** All `value` fields are in **BRL (Brazilian Reais, R$)**. Asaas is a Brazilian payment gateway and only operates in BRL.
+
+```ts
+const { data } = await authClient.asaas.subscriptionCreate({
+  billingType: "PIX",
+  value: 49.9,
+  nextDueDate: "2026-03-01",
+  cycle: "MONTHLY",
+  description: "Pro plan",
+});
+```
+
+### Cancel a subscription
+
+```ts
+await authClient.asaas.subscriptionCancel({
+  subscriptionId: "sub_xxx",
+});
+```
+
+### Webhook
+
+Register `https://your-app.com/api/auth/asaas/webhook` as the webhook URL in your Asaas dashboard. The plugin will automatically keep subscription statuses in sync.
+
+## Billing event handlers
+
+By default, **all** Asaas-side customer notifications are disabled on every customer created by this plugin — that includes Email, SMS, WhatsApp, Voice robot (robô de voz), and Correios. This saves you the per-notification fees Asaas charges for each channel.
+
+You receive the raw webhook events via the `events` option and decide how to act on them (send emails, pause access, trigger CRM flows, etc.).
+
+```ts
+import { Resend } from "resend"; // or any provider
+
+const resend = new Resend(process.env.RESEND_API_KEY);
+
+export const auth = betterAuth({
+  plugins: [
+    asaas({
+      apiKey: process.env.ASAAS_API_KEY!,
+      sandbox: true,
+      events: {
+        // Set to false to re-enable Asaas-side notifications for all channels
+        // disableAsaasNotifications: false,
+
+        // ── Payment lifecycle ────────────────────────────────────────────────
+
+        // New charge created. For PIX: pixQrCode (encodedImage + payload) is included.
+        onPaymentCreated: async ({ payment, pixQrCode }) => {
+          await resend.emails.send({
+            from: "billing@myapp.com",
+            to: "user@myapp.com", // look up from your DB using payment.customer
+            subject: "New charge created",
+            html: pixQrCode
+              ? `<p>R$ ${payment!.value} — scan the PIX QR code below.</p>
+                 <img src="data:image/png;base64,${pixQrCode.encodedImage}" />`
+              : `<p>A new charge of R$ ${payment!.value} was created.</p>`,
+          });
+        },
+
+        // ~10 days before due date. PIX QR code included if applicable.
+        onPaymentDueSoon: async ({ payment }) => { /* send reminder */ },
+
+        // Due today and still unpaid
+        onPaymentDue: async ({ payment }) => { /* send urgent reminder */ },
+
+        // Overdue — fires on due date +1 day, then every 7 days
+        onPaymentOverdue: async ({ payment }) => { /* send dunning email, pause access */ },
+
+        // Payment confirmed / received
+        onPaymentConfirmed: async ({ payment }) => { /* send receipt, restore access */ },
+
+        // Payment refunded
+        onPaymentRefunded: async ({ payment }) => { /* send refund confirmation */ },
+
+        // Chargeback requested or under dispute
+        onPaymentChargeback: async ({ payment }) => { /* alert team, pause account */ },
+
+        // ── Subscription lifecycle ───────────────────────────────────────────
+
+        // New subscription created — great for onboarding / welcome sequence
+        onSubscriptionCreated: async ({ subscription }) => { /* send welcome email */ },
+
+        // Subscription renewed (new billing cycle auto-generated by Asaas)
+        onSubscriptionRenewed: async ({ subscription }) => { /* send renewal confirmation */ },
+
+        // Subscription canceled — trigger win-back campaign
+        onSubscriptionCanceled: async ({ subscription }) => { /* send cancellation email, revoke access */ },
+
+        // Catch-all for any Asaas event not handled above
+        onOtherEvent: async ({ event }) => {
+          console.log("Unhandled Asaas event:", event);
+        },
+      },
+    }),
+  ],
+});
+```
+
+> **Asaas webhook events mapped:**
+> | Handler | Asaas event(s) | When it fires |
+> |---|---|---|
+> | `onPaymentCreated` | `PAYMENT_CREATED` | New charge generated (one-time or subscription cycle) |
+> | `onPaymentDueSoon` | `PAYMENT_DUE_DATE_REMINDER` | ~10 days before due date |
+> | `onPaymentDue` | `PAYMENT_OVERDUE` (due today) | Due today, still unpaid |
+> | `onPaymentOverdue` | `PAYMENT_OVERDUE` (past due) | Overdue — repeats every 7 days |
+> | `onPaymentConfirmed` | `PAYMENT_CONFIRMED` / `PAYMENT_RECEIVED` | Payment confirmed |
+> | `onPaymentRefunded` | `PAYMENT_REFUNDED` / `PAYMENT_PARTIALLY_REFUNDED` | Refund issued |
+> | `onPaymentChargeback` | `PAYMENT_CHARGEBACK_*` | Chargeback requested or in dispute |
+> | `onSubscriptionCreated` | `SUBSCRIPTION_CREATED` | New subscription activated |
+> | `onSubscriptionRenewed` | `SUBSCRIPTION_RENEWED` | New billing cycle started |
+> | `onSubscriptionCanceled` | `SUBSCRIPTION_DELETED` | Subscription canceled |
+
+## Plugin options
+
+| Option | Type | Required | Description |
+|---|---|---|---|
+| `apiKey` | `string` | ✅ | Your Asaas API key |
+| `sandbox` | `boolean` | | Use sandbox environment (default: `true`) |
+| `userAgent` | `string` | | Value sent as `User-Agent` header (default: `"better-auth-asaas"`). Mandatory for Asaas accounts created after 06/11/2024. |
+| `disableAutoCreateCustomer` | `boolean` | | Skip auto-creating customer on sign-up |
+| `onCustomerCreated` | `(customerId, userId) => void` | | Callback after customer is created |
+| `events` | `AsaasEventHandlers` | | Billing event handlers — see [Billing event handlers](#billing-event-handlers) |
+| `events.disableAsaasNotifications` | `boolean` | | Disable ALL Asaas-side notifications — Email, SMS, WhatsApp, Voice, Correios (default: `true`) |
+
+## License
+
+MIT

package/dist/asaas.d.ts

@@ -0,0 +1,193 @@
+export interface AsaasClientOptions {
+    apiKey: string;
+    sandbox?: boolean;
+    /** Sent as the User-Agent header. Required for accounts created after 06/11/2024. */
+    userAgent?: string;
+}
+export interface AsaasCustomer {
+    id: string;
+    name: string;
+    email: string;
+    cpfCnpj?: string;
+    phone?: string;
+    mobilePhone?: string;
+    address?: string;
+    addressNumber?: string;
+    complement?: string;
+    province?: string;
+    city?: string;
+    state?: string;
+    postalCode?: string;
+    externalReference?: string;
+    notificationDisabled?: boolean;
+}
+export type AsaasCustomerInput = Omit<AsaasCustomer, "id">;
+export type AsaasBillingType = "BOLETO" | "CREDIT_CARD" | "PIX" | "UNDEFINED";
+export interface AsaasSubscriptionInput {
+    customer: string;
+    billingType: AsaasBillingType;
+    value: number;
+    nextDueDate: string;
+    cycle?: "WEEKLY" | "BIWEEKLY" | "MONTHLY" | "BIMONTHLY" | "QUARTERLY" | "SEMIANNUALLY" | "YEARLY";
+    description?: string;
+    externalReference?: string;
+    creditCard?: {
+        holderName: string;
+        number: string;
+        expiryMonth: string;
+        expiryYear: string;
+        ccv: string;
+    };
+    creditCardHolderInfo?: {
+        name: string;
+        email: string;
+        cpfCnpj: string;
+        postalCode: string;
+        addressNumber: string;
+        phone?: string;
+    };
+}
+export interface AsaasSubscription {
+    id: string;
+    customer: string;
+    billingType: AsaasBillingType;
+    value: number;
+    nextDueDate: string;
+    cycle: string;
+    description?: string;
+    status: "ACTIVE" | "INACTIVE" | "EXPIRED";
+}
+export interface AsaasPaymentInput {
+    customer: string;
+    billingType: AsaasBillingType;
+    value: number;
+    dueDate: string;
+    description?: string;
+    externalReference?: string;
+    installmentCount?: number;
+    installmentValue?: number;
+    discount?: {
+        value: number;
+        dueDateLimitDays?: number;
+        type?: "FIXED" | "PERCENTAGE";
+    };
+    interest?: {
+        value: number;
+    };
+    fine?: {
+        value: number;
+    };
+    postalService?: boolean;
+    creditCard?: {
+        holderName: string;
+        number: string;
+        expiryMonth: string;
+        expiryYear: string;
+        ccv: string;
+    };
+    creditCardHolderInfo?: {
+        name: string;
+        email: string;
+        cpfCnpj: string;
+        postalCode: string;
+        addressNumber: string;
+        phone?: string;
+    };
+}
+export interface AsaasPayment {
+    id: string;
+    customer: string;
+    billingType: AsaasBillingType;
+    value: number;
+    netValue?: number;
+    status: "PENDING" | "RECEIVED" | "CONFIRMED" | "OVERDUE" | "REFUNDED" | "RECEIVED_IN_CASH" | "REFUND_REQUESTED" | "CHARGEBACK_REQUESTED" | "CHARGEBACK_DISPUTE" | "AWAITING_CHARGEBACK_REVERSAL" | "DUNNING_REQUESTED" | "DUNNING_RECEIVED" | "AWAITING_RISK_ANALYSIS";
+    dueDate: string;
+    originalDueDate?: string;
+    description?: string;
+    externalReference?: string;
+    invoiceUrl?: string;
+    bankSlipUrl?: string;
+    pixQrCodeId?: string;
+    pixTransaction?: string;
+    deleted: boolean;
+}
+export interface AsaasWebhookEvent {
+    event: string;
+    payment?: Record<string, unknown>;
+    subscription?: Record<string, unknown>;
+}
+export declare class AsaasClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly userAgent;
+    constructor(options: AsaasClientOptions);
+    private request;
+    createCustomer(data: AsaasCustomerInput): Promise<AsaasCustomer>;
+    getCustomer(id: string): Promise<AsaasCustomer>;
+    createSubscription(data: AsaasSubscriptionInput): Promise<AsaasSubscription>;
+    cancelSubscription(id: string): Promise<{
+        deleted: boolean;
+        id: string;
+    }>;
+    getSubscription(id: string): Promise<AsaasSubscription>;
+    /**
+     * Lists all payments Asaas auto-generated for a subscription.
+     * Each billing cycle produces one payment. For PIX, use getPixQrCode() on the PENDING one.
+     */
+    getSubscriptionPayments(subscriptionId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        object: "list";
+        hasMore: boolean;
+        totalCount: number;
+        limit: number;
+        offset: number;
+        data: AsaasPayment[];
+    }>;
+    listCustomers(params?: {
+        limit?: number;
+        offset?: number;
+        name?: string;
+        email?: string;
+    }): Promise<{
+        object: "list";
+        hasMore: boolean;
+        totalCount: number;
+        limit: number;
+        offset: number;
+        data: AsaasCustomer[];
+    }>;
+    deleteCustomer(id: string): Promise<{
+        deleted: boolean;
+        id: string;
+    }>;
+    createPayment(data: AsaasPaymentInput): Promise<AsaasPayment>;
+    getPayment(id: string): Promise<AsaasPayment>;
+    listPayments(params?: {
+        customer?: string;
+        status?: string;
+        billingType?: AsaasBillingType;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        object: "list";
+        hasMore: boolean;
+        totalCount: number;
+        limit: number;
+        offset: number;
+        data: AsaasPayment[];
+    }>;
+    deletePayment(id: string): Promise<{
+        deleted: boolean;
+        id: string;
+    }>;
+    /** Returns both the base64 PNG QR code image and the Pix Copia e Cola payload string. */
+    getPixQrCode(paymentId: string): Promise<{
+        encodedImage: string;
+        payload: string;
+        expirationDate: string;
+        success: boolean;
+    }>;
+}
+//# sourceMappingURL=asaas.d.ts.map

package/dist/asaas.d.ts.map

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

package/dist/asaas.js

@@ -0,0 +1,118 @@
+// Asaas API base URLs
+const ASAAS_SANDBOX_URL = "https://api-sandbox.asaas.com/v3";
+const ASAAS_PRODUCTION_URL = "https://api.asaas.com/v3";
+export class AsaasClient {
+    baseUrl;
+    apiKey;
+    userAgent;
+    constructor(options) {
+        this.apiKey = options.apiKey;
+        this.baseUrl = options.sandbox !== false ? ASAAS_SANDBOX_URL : ASAAS_PRODUCTION_URL;
+        this.userAgent = options.userAgent ?? "better-auth-asaas";
+    }
+    async request(path, init = {}) {
+        const url = `${this.baseUrl}${path}`;
+        const res = await fetch(url, {
+            ...init,
+            headers: {
+                "Content-Type": "application/json",
+                "User-Agent": this.userAgent,
+                access_token: this.apiKey,
+                ...init.headers,
+            },
+        });
+        if (!res.ok) {
+            const body = await res.text();
+            throw new Error(`Asaas API error ${res.status}: ${body}`);
+        }
+        return res.json();
+    }
+    createCustomer(data) {
+        return this.request("/customers", {
+            method: "POST",
+            body: JSON.stringify(data),
+        });
+    }
+    getCustomer(id) {
+        return this.request(`/customers/${id}`);
+    }
+    createSubscription(data) {
+        return this.request("/subscriptions", {
+            method: "POST",
+            body: JSON.stringify(data),
+        });
+    }
+    cancelSubscription(id) {
+        return this.request(`/subscriptions/${id}`, {
+            method: "DELETE",
+        });
+    }
+    getSubscription(id) {
+        return this.request(`/subscriptions/${id}`);
+    }
+    /**
+     * Lists all payments Asaas auto-generated for a subscription.
+     * Each billing cycle produces one payment. For PIX, use getPixQrCode() on the PENDING one.
+     */
+    getSubscriptionPayments(subscriptionId, params) {
+        const qs = new URLSearchParams();
+        if (params?.limit != null)
+            qs.set("limit", String(params.limit));
+        if (params?.offset != null)
+            qs.set("offset", String(params.offset));
+        const query = qs.toString();
+        return this.request(`/subscriptions/${subscriptionId}/payments${query ? `?${query}` : ""}`);
+    }
+    listCustomers(params) {
+        const qs = new URLSearchParams();
+        if (params?.limit != null)
+            qs.set("limit", String(params.limit));
+        if (params?.offset != null)
+            qs.set("offset", String(params.offset));
+        if (params?.name)
+            qs.set("name", params.name);
+        if (params?.email)
+            qs.set("email", params.email);
+        const query = qs.toString();
+        return this.request(`/customers${query ? `?${query}` : ""}`);
+    }
+    deleteCustomer(id) {
+        return this.request(`/customers/${id}`, {
+            method: "DELETE",
+        });
+    }
+    createPayment(data) {
+        return this.request("/payments", {
+            method: "POST",
+            body: JSON.stringify(data),
+        });
+    }
+    getPayment(id) {
+        return this.request(`/payments/${id}`);
+    }
+    listPayments(params) {
+        const qs = new URLSearchParams();
+        if (params?.customer)
+            qs.set("customer", params.customer);
+        if (params?.status)
+            qs.set("status", params.status);
+        if (params?.billingType)
+            qs.set("billingType", params.billingType);
+        if (params?.limit != null)
+            qs.set("limit", String(params.limit));
+        if (params?.offset != null)
+            qs.set("offset", String(params.offset));
+        const query = qs.toString();
+        return this.request(`/payments${query ? `?${query}` : ""}`);
+    }
+    deletePayment(id) {
+        return this.request(`/payments/${id}`, {
+            method: "DELETE",
+        });
+    }
+    /** Returns both the base64 PNG QR code image and the Pix Copia e Cola payload string. */
+    getPixQrCode(paymentId) {
+        return this.request(`/payments/${paymentId}/pixQrCode`);
+    }
+}
+//# sourceMappingURL=asaas.js.map

package/dist/asaas.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,3 @@
+import type { BetterAuthClientPlugin } from "better-auth/client";
+export declare const asaasClient: () => BetterAuthClientPlugin;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAGjE,eAAO,MAAM,WAAW,QAAO,sBAK9B,CAAC"}

package/dist/client.js

@@ -0,0 +1,7 @@
+export const asaasClient = () => {
+    return {
+        id: "asaas",
+        $InferServerPlugin: {},
+    };
+};
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,WAAW,GAAG,GAA2B,EAAE;IACtD,OAAO;QACL,EAAE,EAAE,OAAO;QACX,kBAAkB,EAAE,EAA8B;KACnD,CAAC;AACJ,CAAC,CAAC"}

package/dist/endpoints/customer.d.ts

@@ -0,0 +1,32 @@
+import type { AsaasClient } from "../asaas.js";
+export declare const getCustomerEndpoint: (asaas: AsaasClient) => import("better-call").StrictEndpoint<"/asaas/customer", {
+    method: "GET";
+    use: ((inputContext: import("better-call").MiddlewareInputContext<import("better-call").MiddlewareOptions>) => Promise<{
+        session: {
+            session: Record<string, any> & {
+                id: string;
+                createdAt: Date;
+                updatedAt: Date;
+                userId: string;
+                expiresAt: Date;
+                token: string;
+                ipAddress?: string | null | undefined;
+                userAgent?: string | null | undefined;
+            };
+            user: Record<string, any> & {
+                id: string;
+                createdAt: Date;
+                updatedAt: Date;
+                email: string;
+                emailVerified: boolean;
+                name: string;
+                image?: string | null | undefined;
+            };
+        };
+    }>)[];
+}, {
+    customer: null;
+} | {
+    customer: import("../asaas.js").AsaasCustomer;
+}>;
+//# sourceMappingURL=customer.d.ts.map

package/dist/endpoints/customer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customer.d.ts","sourceRoot":"","sources":["../../src/endpoints/customer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,eAAO,MAAM,mBAAmB,GAAI,OAAO,WAAW;;;;;;;;;;;yBAmB26C,CAAC;yBAA4C,CAAC;;;;;;;;;qBAAwN,CAAC;;;;;;;;EADruD,CAAC"}

package/dist/endpoints/customer.js

@@ -0,0 +1,14 @@
+import { createAuthEndpoint, sessionMiddleware } from "better-auth/api";
+export const getCustomerEndpoint = (asaas) => createAuthEndpoint("/asaas/customer", {
+    method: "GET",
+    use: [sessionMiddleware],
+}, async (ctx) => {
+    const { user } = ctx.context.session;
+    const asaasCustomerId = user.asaasCustomerId;
+    if (!asaasCustomerId) {
+        return ctx.json({ customer: null });
+    }
+    const customer = await asaas.getCustomer(asaasCustomerId);
+    return ctx.json({ customer });
+});
+//# sourceMappingURL=customer.js.map

package/dist/endpoints/customer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customer.js","sourceRoot":"","sources":["../../src/endpoints/customer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGxE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAkB,EAAE,EAAE,CACxD,kBAAkB,CAChB,iBAAiB,EACjB;IACE,MAAM,EAAE,KAAK;IACb,GAAG,EAAE,CAAC,iBAAiB,CAAC;CACzB,EACD,KAAK,EAAE,GAAG,EAAE,EAAE;IACZ,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC;IACrC,MAAM,eAAe,GAAI,IAAgC,CAAC,eAAqC,CAAC;IAEhG,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IAC1D,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;AAChC,CAAC,CACF,CAAC"}