@adonis-agora/payments 0.2.0

package/dist/src/driver.d.ts

@@ -0,0 +1,222 @@
+import type { CheckoutSession, Customer, Invoice, InvoiceOptions, Money, Payment, PaymentMethodName, Refund, Subscription, WebhookEvent } from './types.js';
+/**
+ * The provider-agnostic payment driver contract (Omnipay-style).
+ *
+ * Every gateway driver (Stripe, AbacatePay, Asaas, Woovi) implements this interface,
+ * normalizing its own API onto the shared domain types. The billing layer and application
+ * code depend only on this contract, so swapping gateways is a config change.
+ */
+export interface PaymentsDriver {
+    /** Stable provider name, e.g. `'stripe'`, `'abacate'`, `'asaas'`, `'woovi'`. */
+    readonly provider: string;
+    /**
+     * The payment methods this gateway supports (canonical names). Used by the router to
+     * reject a method the provider can't handle — e.g. routing `credit_card` to a Pix-only
+     * gateway (AbacatePay, Woovi) throws a clear error.
+     */
+    readonly supportedMethods: readonly PaymentMethodName[];
+    /**
+     * Optional capabilities beyond the core contract. A driver that lacks a capability
+     * still implements the method (it must — the interface demands it) but throws a clear
+     * "not supported" error; the manager checks this before delegating so callers discover
+     * the limitation early instead of at the gateway.
+     */
+    readonly capabilities?: {
+        /** Full refunds against a payment. Woovi/OpenPix lacks it. */
+        refunds?: boolean;
+        /** Lists gateway invoices. Woovi/OpenPix has no invoice concept. */
+        invoices?: boolean;
+        /** Recurring subscriptions. InfinitePay-style links lack it. */
+        subscriptions?: boolean;
+    };
+    /** Create a customer at the gateway. Returns the gateway customer. */
+    createCustomer(input: CreateCustomerInput): Promise<Customer>;
+    /** Look up a customer by its gateway id. */
+    findCustomer(customerId: string): Promise<Customer | null>;
+    /** Update customer details at the gateway. */
+    updateCustomer(customerId: string, input: UpdateCustomerInput): Promise<Customer>;
+    /** Charge a customer (or a standalone amount) and return the payment. */
+    charge(input: ChargeInput): Promise<Payment>;
+    /** Find a payment by its gateway id. */
+    findPayment(gatewayId: string): Promise<Payment | null>;
+    /** Refund a payment, optionally a partial amount. */
+    refund(paymentGatewayId: string, amount?: Money): Promise<Refund>;
+    /** Create a hosted checkout session and return the redirect URL. */
+    createCheckout(input: CheckoutInput): Promise<CheckoutSession>;
+    /** Create a recurring subscription at the gateway. */
+    createSubscription(input: CreateSubscriptionInput): Promise<Subscription>;
+    /** Cancel a subscription (optionally immediately, skipping the grace period). */
+    cancelSubscription(subscriptionGatewayId: string, options?: {
+        atPeriodEnd?: boolean;
+    }): Promise<Subscription>;
+    /** Update a subscription's amount/description at the gateway. */
+    updateSubscription(subscriptionGatewayId: string, input: UpdateSubscriptionInput): Promise<Subscription>;
+    /** Find a subscription by its gateway id. */
+    findSubscription(gatewayId: string): Promise<Subscription | null>;
+    /** List invoices for a customer. */
+    listInvoices(customerId: string): Promise<Invoice[]>;
+    /**
+     * Verify the webhook signature and normalize the raw payload into a {@link WebhookEvent}.
+     * Throws when the signature is invalid.
+     */
+    parseWebhook(rawBody: string, headers: Record<string, string | string[] | undefined>): WebhookEvent;
+}
+export interface CreateCustomerInput {
+    email?: string;
+    name?: string;
+    /** CPF/CNPJ (BR gateways) or tax id. */
+    taxId?: string;
+    /** Extra provider-specific fields, e.g. phone, address. */
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateCustomerInput {
+    email?: string;
+    name?: string;
+    taxId?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Checkout transparente: a card tokenized in the frontend, plus the holder info most BR
+ * gateways require (Asaas `creditCardToken`/`creditCardHolderInfo`, Stripe
+ * `payment_method`). First-class so drivers map it without metadata hacks — shared by
+ * one-off {@link ChargeInput.card} and recurring {@link CreateSubscriptionInput.card}.
+ */
+export interface CardInput {
+    token: string;
+    holder?: {
+        name: string;
+        email: string;
+        cpfCnpj: string;
+        postalCode: string;
+        addressNumber: string;
+        phone: string;
+    };
+    remoteIp?: string;
+}
+export interface ChargeInput {
+    /** Gateway customer id. When absent, some gateways charge without a customer. */
+    customerId?: string;
+    amount: Money;
+    /** ISO 4217 code, lowercase (defaults to the driver's configured currency). */
+    currency?: string;
+    description?: string;
+    /** Payment method (e.g. `'pix'`, `'credit_card'`, `'boleto'`). Gateway-dependent. */
+    method?: string;
+    /** For card payments: the payment method/token id at the gateway. */
+    paymentMethodId?: string;
+    /**
+     * Checkout transparente: card tokenized in the frontend, plus the holder info most BR
+     * gateways require. First-class so drivers map it without metadata hacks.
+     */
+    card?: CardInput;
+    /**
+     * The payer's fiscal data — the single source used when an invoice is emitted with
+     * this charge. Falls back to `card.holder` (cpfCnpj/name/email) when absent, so a
+     * card checkout that also wants a fiscal note doesn't restate the holder.
+     */
+    customer?: {
+        name?: string;
+        taxId?: string;
+        email?: string;
+    };
+    /** Idempotency key — reusing it must not double-charge. */
+    idempotencyKey?: string;
+    /**
+     * Split the payment across recipients (marketplace-style). Each entry names the gateway
+     * wallet/account receiving a share, by percent and/or a fixed amount. Asaas maps it to
+     * the `split` array on the charge; other gateways accept it when supported.
+     */
+    split?: Array<{
+        /** Gateway wallet/recipient id. */
+        walletId: string;
+        /** Percent of the charge value this wallet receives (0–100). */
+        percentualValue?: number;
+        /** Fixed amount (cents) this wallet receives. */
+        fixedValue?: number;
+    }>;
+    /**
+     * Your own reference echoed back on the gateway payment — the stable id webhook
+     * handlers use to route a payment back to your local record. Many BR gateways expose
+     * it as `externalReference` (Asaas) or `correlationID` (Woovi); Stripe maps it into
+     * metadata. Distinct from `idempotencyKey`: idempotency protects against duplicate
+     * charges, `externalReference` is for routing. Prefer it over digging into `event.raw`.
+     */
+    externalReference?: string;
+    /**
+     * Emit an invoice for this charge: `true` uses the default invoice provider, a string
+     * names one from `invoice.providers`, or pass {@link InvoiceOptions} for overrides.
+     */
+    invoice?: boolean | string | InvoiceOptions;
+    /** Extra provider-specific fields. */
+    metadata?: Record<string, unknown>;
+}
+export interface CheckoutInput {
+    /** Gateway customer id. */
+    customerId?: string;
+    amount: Money;
+    currency?: string;
+    description?: string;
+    successUrl: string;
+    cancelUrl?: string;
+    /** For subscription checkouts: the price/plan id. */
+    planId?: string;
+    /** Trial days for a subscription checkout. */
+    trialDays?: number;
+    /** Idempotency key — reusing it must not create a duplicate session. */
+    idempotencyKey?: string;
+    /** Emit an invoice for this checkout: `true`/name/options. */
+    invoice?: boolean | string | InvoiceOptions;
+    /** Extra provider-specific fields. */
+    metadata?: Record<string, unknown>;
+}
+export interface CreateSubscriptionInput {
+    customerId: string;
+    /** Price/plan id at the gateway. */
+    planId: string;
+    /** Amount in the currency's smallest unit (e.g. cents) — required by BR gateways. */
+    amount?: Money;
+    /** Billing cycle. Defaults to `'MONTHLY'` (Asaas, AbacatePay). */
+    cycle?: 'WEEKLY' | 'BIWEEKLY' | 'MONTHLY' | 'QUARTERLY' | 'SEMIANNUALLY' | 'YEARLY';
+    /** Payment method for the recurring charges (e.g. `'pix'`, `'credit_card'`). */
+    method?: string;
+    /** Description shown on the recurring charges. */
+    description?: string;
+    /** Trial days before the first charge. */
+    trialDays?: number;
+    /** First due date (ISO date) — required by some BR gateways (e.g. Asaas). */
+    startDate?: string;
+    /**
+     * Checkout transparente for recurring charges: a card tokenized in the frontend (plus
+     * holder info) so the gateway auto-charges the card each cycle. Asaas maps it to
+     * `creditCardToken`/`creditCardHolderInfo`; other gateways accept it when supported.
+     */
+    card?: CardInput;
+    /**
+     * The payer's fiscal/identity data. Gateways that create subscriptions with an inline
+     * customer (Woovi, AbacatePay) use it instead of a pre-created `customerId`.
+     */
+    customer?: {
+        name?: string;
+        email?: string;
+        taxId?: string;
+    };
+    /**
+     * Your own reference echoed on the gateway subscription (and its generated charges) —
+     * the stable id webhook handlers use to route a subscription payment back to your
+     * local record. Asaas propagates it to every installment payment's `externalReference`.
+     */
+    externalReference?: string;
+    /** Emit an invoice for this subscription's charges: `true`/name/options. */
+    invoice?: boolean | string | InvoiceOptions;
+    /** Extra provider-specific fields. */
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateSubscriptionInput {
+    /** New amount in the currency's smallest unit. */
+    amount?: Money;
+    /** New description. */
+    description?: string;
+    /** Extra provider-specific fields. */
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=driver.d.ts.map

package/dist/src/driver.d.ts.map

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

package/dist/src/driver.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=driver.js.map

package/dist/src/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../src/driver.ts"],"names":[],"mappings":""}

package/dist/src/drivers/abacate.d.ts

@@ -0,0 +1,35 @@
+import type { AbacateDriverConfig } from '../define_config.js';
+import type { ChargeInput, CheckoutInput, CreateCustomerInput, CreateSubscriptionInput, PaymentsDriver, UpdateCustomerInput, UpdateSubscriptionInput } from '../driver.js';
+import type { EmitInvoiceContext } from '../invoice/emit_invoice.js';
+import type { CheckoutSession, Customer, Invoice, Money, Payment, Refund, Subscription, WebhookEvent } from '../types.js';
+/**
+ * AbacatePay driver — Brazilian gateway for Pix and card payments with a developer-first
+ * API (REST v2, `https://api.abacatepay.com/v2`). Uses `fetch` directly (no SDK
+ * dependency). Webhooks are validated with an HMAC-SHA256 signature using the public key.
+ */
+export declare class AbacateDriver implements PaymentsDriver {
+    #private;
+    readonly provider = "abacate";
+    readonly supportedMethods: readonly ["pix", "boleto", "undefined"];
+    readonly capabilities: {
+        refunds: boolean;
+        subscriptions: boolean;
+    };
+    constructor(ctx: EmitInvoiceContext, config?: AbacateDriverConfig);
+    createCustomer(input: CreateCustomerInput): Promise<Customer>;
+    findCustomer(customerId: string): Promise<Customer | null>;
+    updateCustomer(customerId: string, input: UpdateCustomerInput): Promise<Customer>;
+    charge(input: ChargeInput): Promise<Payment>;
+    findPayment(gatewayId: string): Promise<Payment | null>;
+    refund(paymentGatewayId: string, _amount?: Money): Promise<Refund>;
+    createCheckout(input: CheckoutInput): Promise<CheckoutSession>;
+    createSubscription(input: CreateSubscriptionInput): Promise<Subscription>;
+    cancelSubscription(subscriptionGatewayId: string, _options?: {
+        atPeriodEnd?: boolean;
+    }): Promise<Subscription>;
+    findSubscription(gatewayId: string): Promise<Subscription | null>;
+    updateSubscription(subscriptionGatewayId: string, input: UpdateSubscriptionInput): Promise<Subscription>;
+    listInvoices(customerId: string): Promise<Invoice[]>;
+    parseWebhook(rawBody: string, headers: Record<string, string | string[] | undefined>): WebhookEvent;
+}
+//# sourceMappingURL=abacate.d.ts.map

package/dist/src/drivers/abacate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abacate.d.ts","sourceRoot":"","sources":["../../../src/drivers/abacate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAM/D,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,cAAc,CAAC;AAGtB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,OAAO,KAAK,EACV,eAAe,EACf,QAAQ,EACR,OAAO,EACP,KAAK,EACL,OAAO,EACP,MAAM,EACN,YAAY,EACZ,YAAY,EACb,MAAM,aAAa,CAAC;AA+CrB;;;;GAIG;AACH,qBAAa,aAAc,YAAW,cAAc;;IAClD,QAAQ,CAAC,QAAQ,aAAa;IAE9B,QAAQ,CAAC,gBAAgB,0CAA2C;IACpE,QAAQ,CAAC,YAAY;;;MAA0C;gBAOnD,GAAG,EAAE,kBAAkB,EAAE,MAAM,GAAE,mBAAwB;IAiB/D,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAY7D,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAU1D,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAcjF,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAyE5C,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAUvD,MAAM,CAAC,gBAAgB,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAyBlE,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC;IA6B9D,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC;IAgBzE,kBAAkB,CACtB,qBAAqB,EAAE,MAAM,EAC7B,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GACnC,OAAO,CAAC,YAAY,CAAC;IAUlB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAYjE,kBAAkB,CACtB,qBAAqB,EAAE,MAAM,EAC7B,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,YAAY,CAAC;IAgBlB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAsB1D,YAAY,CACV,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,YAAY;CAuIhB"}

package/dist/src/drivers/abacate.js

@@ -0,0 +1,381 @@
+import { publishPaymentDiagnostics, publishRefundDiagnostics, publishSubscriptionDiagnostics, } from '../diagnostics.js';
+import { headerValue, httpRequest, isNotFound } from '../http.js';
+import { emitInvoiceIfRequested } from '../invoice/emit_invoice.js';
+import { fromDecimal, toDecimal } from '../money.js';
+import { verifyHmacSignature } from '../webhook_security.js';
+/**
+ * AbacatePay driver — Brazilian gateway for Pix and card payments with a developer-first
+ * API (REST v2, `https://api.abacatepay.com/v2`). Uses `fetch` directly (no SDK
+ * dependency). Webhooks are validated with an HMAC-SHA256 signature using the public key.
+ */
+export class AbacateDriver {
+    provider = 'abacate';
+    // AbacatePay is Pix-first — no credit card.
+    supportedMethods = ['pix', 'boleto', 'undefined'];
+    capabilities = { refunds: true, subscriptions: true };
+    #baseUrl;
+    #publicKey;
+    #invoiceCtx;
+    #bearerToken;
+    constructor(ctx, config = {}) {
+        this.#invoiceCtx = ctx;
+        const apiKey = config.apiKey ?? process.env.ABACATE_API_KEY;
+        if (!apiKey) {
+            throw new Error('[payments] AbacatePay driver requires an API key. Set `ABACATE_API_KEY` env or pass `apiKey` to `payments.abacate()`.');
+        }
+        this.#baseUrl = 'https://api.abacatepay.com/v2';
+        // `webhookSecret` is the Agora-convention alias for AbacatePay's dashboard
+        // "public key" (the HMAC secret used to sign webhooks).
+        this.#publicKey = config.webhookSecret ?? config.publicKey ?? process.env.ABACATE_PUBLIC_KEY;
+        this.#bearerToken = apiKey;
+    }
+    // ── Customers ────────────────────────────────────────────────────────────────────────
+    async createCustomer(input) {
+        const data = await this.#request('/customer/create', {
+            method: 'POST',
+            body: {
+                ...(input.name !== undefined ? { name: input.name } : {}),
+                ...(input.email !== undefined ? { email: input.email } : {}),
+                ...(input.taxId !== undefined ? { taxId: input.taxId } : {}),
+            },
+        });
+        return this.#mapCustomer(data);
+    }
+    async findCustomer(customerId) {
+        try {
+            const data = await this.#request(`/customer/get/${customerId}`);
+            return this.#mapCustomer(data);
+        }
+        catch (error) {
+            if (isNotFound(error))
+                return null;
+            throw error;
+        }
+    }
+    async updateCustomer(customerId, input) {
+        const data = await this.#request(`/customer/update/${customerId}`, {
+            method: 'PATCH',
+            body: {
+                ...(input.name !== undefined ? { name: input.name } : {}),
+                ...(input.email !== undefined ? { email: input.email } : {}),
+                ...(input.taxId !== undefined ? { taxId: input.taxId } : {}),
+            },
+        });
+        return this.#mapCustomer(data);
+    }
+    // ── Payments ─────────────────────────────────────────────────────────────────────────
+    async charge(input) {
+        if (!input.customerId) {
+            throw new Error('[payments] AbacatePay requires a customer for every charge.');
+        }
+        // Transparent checkout (`POST /v2/transparents/create`): PIX/Boleto inline, no
+        // redirect — the response carries the QR/barcode directly. Needs the payer's
+        // name + taxId, resolved from the charge's fiscal `customer` or the gateway customer.
+        const method = input.method ?? 'pix';
+        const customer = await this.#resolveTransparentCustomer(input);
+        const data = await this.#request('/v2/transparents/create', {
+            method: 'POST',
+            body: {
+                method: this.#mapMethod(method),
+                data: {
+                    amount: input.amount,
+                    ...(input.description !== undefined ? { description: input.description } : {}),
+                    ...(input.externalReference !== undefined ? { externalId: input.externalReference } : {}),
+                    ...(input.externalReference === undefined && input.idempotencyKey !== undefined
+                        ? { externalId: input.idempotencyKey }
+                        : {}),
+                    customer,
+                },
+            },
+        });
+        const payment = this.#mapTransparentPayment(data, input);
+        await emitInvoiceIfRequested(this.#invoiceCtx, input, payment, this);
+        publishPaymentDiagnostics(payment);
+        return payment;
+    }
+    /** The transparent checkout needs `{ name, taxId }` — from `input.customer` or the gateway customer. */
+    async #resolveTransparentCustomer(input) {
+        if (input.customer?.name && input.customer.taxId) {
+            return {
+                name: input.customer.name,
+                taxId: input.customer.taxId,
+                ...(input.customer.email !== undefined ? { email: input.customer.email } : {}),
+            };
+        }
+        const customer = await this.findCustomer(input.customerId);
+        if (!customer?.name || !customer.taxId) {
+            throw new Error('[payments] AbacatePay transparent checkout needs the payer name + taxId — pass `customer` on the charge, or create the gateway customer with them.');
+        }
+        return {
+            name: customer.name,
+            taxId: customer.taxId,
+            ...(customer.email !== undefined ? { email: customer.email } : {}),
+        };
+    }
+    #mapTransparentPayment(data, input) {
+        const method = input.method === 'boleto' ? 'boleto' : 'pix';
+        const result = {
+            id: data.id,
+            gatewayId: data.id,
+            provider: this.provider,
+            amount: { amount: input.amount, currency: 'brl' },
+            status: 'pending',
+            ...(input.customerId !== undefined ? { customerId: input.customerId } : {}),
+            method,
+            createdAt: new Date().toISOString(),
+            payload: data,
+        };
+        if (data.brCodeBase64)
+            result.pixQrCode = data.brCodeBase64;
+        if (data.brCode)
+            result.pixCopiaECola = data.brCode;
+        if (data.url)
+            result.hostedUrl = data.url;
+        return result;
+    }
+    async findPayment(gatewayId) {
+        try {
+            const data = await this.#request(`/billing/get/${gatewayId}`);
+            return this.#mapPayment(data);
+        }
+        catch (error) {
+            if (isNotFound(error))
+                return null;
+            throw error;
+        }
+    }
+    async refund(paymentGatewayId, _amount) {
+        const data = await this.#request(`/billing/refund/${paymentGatewayId}`, {
+            method: 'POST',
+            body: {},
+        });
+        const refund = {
+            id: data.id,
+            gatewayId: data.id,
+            provider: this.provider,
+            amount: {
+                amount: data.amount !== undefined ? fromDecimal(data.amount) : 0,
+                currency: data.currency ?? 'brl',
+            },
+            status: 'succeeded',
+            createdAt: data.createdAt ?? new Date().toISOString(),
+        };
+        publishRefundDiagnostics(refund);
+        return refund;
+    }
+    // ── Checkout ─────────────────────────────────────────────────────────────────────────
+    async createCheckout(input) {
+        if (!input.customerId) {
+            throw new Error('[payments] AbacatePay requires a customer for checkout.');
+        }
+        const data = await this.#request('/billing/create', {
+            method: 'POST',
+            body: {
+                customerId: input.customerId,
+                amount: toDecimal(input.amount),
+                ...(input.description !== undefined ? { description: input.description } : {}),
+            },
+        });
+        return {
+            id: data.id,
+            gatewayId: data.id,
+            provider: this.provider,
+            url: data.url ?? '',
+            status: 'open',
+            amount: {
+                amount: data.amount !== undefined ? fromDecimal(data.amount) : input.amount,
+                currency: data.currency ?? 'brl',
+            },
+            customerId: input.customerId,
+            ...(data.pix?.copiaECola !== undefined ? { pixCopiaECola: data.pix.copiaECola } : {}),
+        };
+    }
+    // ── Subscriptions ────────────────────────────────────────────────────────────────────
+    async createSubscription(input) {
+        const data = await this.#request('/subscription/create', {
+            method: 'POST',
+            body: {
+                customerId: input.customerId,
+                ...(input.amount !== undefined ? { amount: toDecimal(input.amount) } : {}),
+                frequency: input.cycle ?? 'MONTHLY',
+                ...(input.startDate !== undefined ? { nextBillingAt: input.startDate } : {}),
+                ...(input.description !== undefined ? { description: input.description } : {}),
+            },
+        });
+        const subscription = this.#mapSubscription(data, input.customerId);
+        publishSubscriptionDiagnostics(subscription, 'subscription.created');
+        return subscription;
+    }
+    async cancelSubscription(subscriptionGatewayId, _options) {
+        const data = await this.#request(`/subscription/cancel/${subscriptionGatewayId}`, { method: 'POST', body: {} });
+        const subscription = this.#mapSubscription(data);
+        publishSubscriptionDiagnostics(subscription, 'subscription.canceled');
+        return subscription;
+    }
+    async findSubscription(gatewayId) {
+        try {
+            const data = await this.#request(`/subscription/get/${gatewayId}`);
+            return this.#mapSubscription(data);
+        }
+        catch (error) {
+            if (isNotFound(error))
+                return null;
+            throw error;
+        }
+    }
+    async updateSubscription(subscriptionGatewayId, input) {
+        const data = await this.#request(`/subscription/update/${subscriptionGatewayId}`, {
+            method: 'PATCH',
+            body: {
+                ...(input.amount !== undefined ? { amount: toDecimal(input.amount) } : {}),
+                ...(input.description !== undefined ? { description: input.description } : {}),
+            },
+        });
+        return this.#mapSubscription(data);
+    }
+    // ── Invoices ─────────────────────────────────────────────────────────────────────────
+    async listInvoices(customerId) {
+        const data = await this.#request(`/billing/list?customerId=${encodeURIComponent(customerId)}`);
+        return (data.billings ?? []).map((billing) => ({
+            id: billing.id,
+            gatewayId: billing.id,
+            provider: this.provider,
+            customerId,
+            status: billing.status === 'PAID' ? 'paid' : billing.status === 'CANCELED' ? 'void' : 'open',
+            amount: {
+                amount: billing.amount !== undefined ? fromDecimal(billing.amount) : 0,
+                currency: billing.currency ?? 'brl',
+            },
+            createdAt: billing.createdAt ?? new Date().toISOString(),
+            ...(billing.url !== undefined ? { hostedPdfUrl: billing.url } : {}),
+            payload: billing,
+        }));
+    }
+    // ── Webhooks ─────────────────────────────────────────────────────────────────────────
+    parseWebhook(rawBody, headers) {
+        // AbacatePay signs the raw body with HMAC-SHA256 (base64) in `x-webhook-signature`,
+        // keyed by the public key from the dashboard. Strict when a key is configured.
+        if (this.#publicKey !== undefined) {
+            const signature = headerValue(headers, 'x-webhook-signature');
+            if (!verifyHmacSignature(rawBody, signature, this.#publicKey, 'sha256')) {
+                throw new Error('[payments] Invalid or missing AbacatePay webhook signature.');
+            }
+        }
+        const payload = JSON.parse(rawBody);
+        const event = payload.event ?? 'unknown';
+        return {
+            id: payload.id ?? `${event}-${Math.random()}`,
+            provider: this.provider,
+            type: this.#mapWebhookType(event),
+            createdAt: new Date().toISOString(),
+            data: payload.data ?? {},
+            raw: payload,
+        };
+    }
+    // ── Mappers ──────────────────────────────────────────────────────────────────────────
+    #mapCustomer(data) {
+        return {
+            id: data.id,
+            ...(data.name !== undefined ? { name: data.name } : {}),
+            ...(data.email !== undefined ? { email: data.email } : {}),
+            ...(data.taxId !== undefined ? { taxId: data.taxId } : {}),
+        };
+    }
+    #mapPayment(data, fallbackCustomerId) {
+        const customerId = data.customer?.id ?? fallbackCustomerId;
+        const result = {
+            id: data.id,
+            gatewayId: data.id,
+            provider: this.provider,
+            amount: {
+                amount: data.amount !== undefined ? fromDecimal(data.amount) : 0,
+                currency: data.currency ?? 'brl',
+            },
+            status: data.status === 'PAID' || data.status === 'COMPLETED'
+                ? 'paid'
+                : data.status === 'REFUNDED'
+                    ? 'refunded'
+                    : data.status === 'CANCELED'
+                        ? 'canceled'
+                        : 'pending',
+            payload: data,
+            createdAt: data.createdAt ?? new Date().toISOString(),
+        };
+        if (customerId !== undefined)
+            result.customerId = customerId;
+        if (data.pix?.qrCode !== undefined)
+            result.pixQrCode = data.pix.qrCode;
+        if (data.pix?.copiaECola !== undefined)
+            result.pixCopiaECola = data.pix.copiaECola;
+        if (data.url !== undefined)
+            result.hostedUrl = data.url;
+        if (data.paidAt !== undefined)
+            result.paidAt = data.paidAt;
+        return result;
+    }
+    #mapSubscription(data, fallbackCustomerId) {
+        const statusMap = {
+            ACTIVE: 'active',
+            COMPLETED: 'active',
+            CANCELLED: 'canceled',
+            EXPIRED: 'ended',
+        };
+        return {
+            id: data.id,
+            gatewayId: data.id,
+            provider: this.provider,
+            customerId: data.customer?.id ?? fallbackCustomerId ?? '',
+            status: statusMap[data.status] ?? 'active',
+            planId: data.frequency ?? '',
+            amount: {
+                amount: data.amount !== undefined ? fromDecimal(data.amount) : 0,
+                currency: 'brl',
+            },
+            ...(data.nextBillingAt !== undefined ? { endsAt: data.nextBillingAt } : {}),
+            payload: data,
+            createdAt: data.createdAt ?? new Date().toISOString(),
+        };
+    }
+    #mapWebhookType(event) {
+        switch (event) {
+            case 'checkout.completed':
+            case 'transparent.completed':
+                return 'payment.succeeded';
+            case 'checkout.refunded':
+            case 'transparent.refunded':
+                return 'payment.refunded';
+            case 'checkout.disputed':
+            case 'transparent.disputed':
+                return 'payment.failed';
+            case 'subscription.completed':
+                return 'subscription.created';
+            case 'subscription.renewed':
+                return 'subscription.updated';
+            case 'subscription.cancelled':
+                return 'subscription.canceled';
+            default:
+                return event;
+        }
+    }
+    #mapMethod(method) {
+        switch (method) {
+            case 'pix':
+                return 'PIX';
+            case 'credit_card':
+                return 'CARD';
+            case 'boleto':
+                return 'BOLETO';
+            default:
+                return 'PIX';
+        }
+    }
+    async #request(path, options = {}) {
+        return httpRequest(path, {
+            baseUrl: this.#baseUrl,
+            ...(options.method !== undefined ? { method: options.method } : {}),
+            ...(options.body !== undefined ? { body: options.body } : {}),
+            bearerToken: this.#bearerToken,
+        });
+    }
+}
+//# sourceMappingURL=abacate.js.map