@adonis-agora/payments 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,27 @@
+# @adonis-agora/payments
+
+## 0.2.0
+
+### Minor Changes
+
+- [`c96f1cd`](https://github.com/DavideCarvalho/adonis-agora-payments/commit/c96f1cd6f7465053c37ff65d68932d37b13a762a) - Initial release of the payments library:
+
+  - **Multi-gateway drivers** — Stripe, AbacatePay, Asaas, Woovi (Pix Automático) with a
+    provider-agnostic `PaymentsDriver` contract, `supportedMethods` routing and capability
+    checks (refunds/invoices/subscriptions).
+  - **Method-based routing** — `config.methods` routes `pix`/`credit_card`/`boleto` to a
+    provider, with early validation of gateway support.
+  - **Invoice (NFe/NFSe) emission** — attached to the charge (`invoice: true` or
+    `invoice: 'tecnospeed'`), resolved by provider name independently of the payment
+    gateway; Focus provider built in, custom providers via factory.
+  - **Cashier-style billing** — Lucid mixins (`withBillable`, `withSubscription`),
+    migrations, and an idempotent webhook processor (ledger + shape guards) that syncs
+    payments/subscriptions; durable-backed dispatch when `@adonis-agora/durable` is
+    installed, in-process retry otherwise.
+  - **Custom providers** — exported building blocks (`httpRequest`, `toDecimal`,
+    `emitInvoiceIfRequested`) so apps can implement or extend gateways/invoice providers.
+  - **Diagnostics** — emits `agora:payments:*` events on `@adonis-agora/diagnostics`
+    (structural slot, no dependency), observable by Telescope's generic watcher.
+  - **Ace commands** — `make:billable`, `payments:webhook`, `payments:sync`.
+  - **Testing kit** — `FakePaymentsDriver`, `InMemoryBillingStore`, `MutableClock` under
+    `@adonis-agora/payments/testing`.

package/dist/commands/main.d.ts

@@ -0,0 +1,16 @@
+import { ListLoader } from '@adonisjs/core/ace';
+import MakeBillable from './make_billable.js';
+import PaymentsSync from './payments_sync.js';
+import PaymentsWebhook from './payments_webhook.js';
+/**
+ * The commands barrel for `@adonis-agora/payments`. Registered in an app's `adonisrc` via
+ * `rcFile.addCommand('@adonis-agora/payments/commands')` (done by this package's
+ * `configure`). The ace kernel imports this module and treats it as a commands loader: a
+ * {@link ListLoader} over the payments commands (`make:billable`, `make:webhook-handler`,
+ * `payments:webhook`, `payments:sync`) provides their metadata and constructors.
+ */
+declare const loader: ListLoader<typeof MakeBillable | typeof PaymentsSync | typeof PaymentsWebhook>;
+export declare const getMetaData: () => Promise<import("@adonisjs/core/types/ace").CommandMetaData[]>;
+export declare const getCommand: (metaData: import("@adonisjs/core/types/ace").CommandMetaData) => Promise<typeof MakeBillable | typeof PaymentsSync | typeof PaymentsWebhook | null>;
+export default loader;
+//# sourceMappingURL=main.d.ts.map

package/dist/commands/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../commands/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAE9C,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAC9C,OAAO,eAAe,MAAM,uBAAuB,CAAC;AAEpD;;;;;;GAMG;AACH,QAAA,MAAM,MAAM,gFAAoF,CAAC;AAEjG,eAAO,MAAM,WAAW,qEAAkC,CAAC;AAC3D,eAAO,MAAM,UAAU,sJAAiC,CAAC;AAEzD,eAAe,MAAM,CAAC"}

package/dist/commands/main.js

@@ -0,0 +1,17 @@
+import { ListLoader } from '@adonisjs/core/ace';
+import MakeBillable from './make_billable.js';
+import MakeWebhookHandler from './make_webhook_handler.js';
+import PaymentsSync from './payments_sync.js';
+import PaymentsWebhook from './payments_webhook.js';
+/**
+ * The commands barrel for `@adonis-agora/payments`. Registered in an app's `adonisrc` via
+ * `rcFile.addCommand('@adonis-agora/payments/commands')` (done by this package's
+ * `configure`). The ace kernel imports this module and treats it as a commands loader: a
+ * {@link ListLoader} over the payments commands (`make:billable`, `make:webhook-handler`,
+ * `payments:webhook`, `payments:sync`) provides their metadata and constructors.
+ */
+const loader = new ListLoader([MakeBillable, MakeWebhookHandler, PaymentsWebhook, PaymentsSync]);
+export const getMetaData = loader.getMetaData.bind(loader);
+export const getCommand = loader.getCommand.bind(loader);
+export default loader;
+//# sourceMappingURL=main.js.map

package/dist/commands/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../commands/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAC9C,OAAO,kBAAkB,MAAM,2BAA2B,CAAC;AAC3D,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAC9C,OAAO,eAAe,MAAM,uBAAuB,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,CAAC,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,CAAC,CAAC,CAAC;AAEjG,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAEzD,eAAe,MAAM,CAAC"}

package/dist/commands/make_billable.d.ts

@@ -0,0 +1,16 @@
+import { BaseCommand } from '@adonisjs/core/ace';
+import type { CommandOptions } from '@adonisjs/core/types/ace';
+/**
+ * `node ace make:billable <model>` — scaffold a Lucid model composed with the billing
+ * mixins (`withBillable`, `withSubscription`, `withPayment`) under `app/models/`. The
+ * generated model is the app-facing entry point to the billing layer: charge, subscribe,
+ * and manage payment methods straight off the model.
+ */
+export default class MakeBillable extends BaseCommand {
+    static commandName: string;
+    static description: string;
+    static options: CommandOptions;
+    name: string;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=make_billable.d.ts.map

package/dist/commands/make_billable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"make_billable.d.ts","sourceRoot":"","sources":["../../commands/make_billable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAQ,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG/D;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,WAAW;IACnD,OAAgB,WAAW,SAAmB;IAC9C,OAAgB,WAAW,SAA+D;IAC1F,OAAgB,OAAO,EAAE,cAAc,CAA+B;IAG9D,IAAI,EAAE,MAAM,CAAC;IAEN,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAOpC"}

package/dist/commands/make_billable.js

@@ -0,0 +1,30 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { BaseCommand, args } from '@adonisjs/core/ace';
+import { stubsRoot } from '../stubs/main.js';
+/**
+ * `node ace make:billable <model>` — scaffold a Lucid model composed with the billing
+ * mixins (`withBillable`, `withSubscription`, `withPayment`) under `app/models/`. The
+ * generated model is the app-facing entry point to the billing layer: charge, subscribe,
+ * and manage payment methods straight off the model.
+ */
+export default class MakeBillable extends BaseCommand {
+    static commandName = 'make:billable';
+    static description = 'Create a new billable Lucid model with the billing mixins';
+    static options = { allowUnknownFlags: true };
+    async run() {
+        const codemods = await this.createCodemods();
+        await codemods.makeUsingStub(stubsRoot(), 'make/billable/main.stub', {
+            flags: this.parsed.flags,
+            entity: this.app.generators.createEntity(this.name),
+        });
+    }
+}
+__decorate([
+    args.string({ description: 'Name of the model (e.g. user, customer)' })
+], MakeBillable.prototype, "name", void 0);
+//# sourceMappingURL=make_billable.js.map

package/dist/commands/make_billable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"make_billable.js","sourceRoot":"","sources":["../../commands/make_billable.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,WAAW;IACnD,MAAM,CAAU,WAAW,GAAG,eAAe,CAAC;IAC9C,MAAM,CAAU,WAAW,GAAG,2DAA2D,CAAC;IAC1F,MAAM,CAAU,OAAO,GAAmB,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;IAK7D,KAAK,CAAC,GAAG;QAChB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC7C,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,EAAE,yBAAyB,EAAE;YACnE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;YACxB,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;SACpD,CAAC,CAAC;IACL,CAAC;;AARO;IADP,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,yCAAyC,EAAE,CAAC;0CACnD"}

package/dist/commands/make_webhook_handler.d.ts

@@ -0,0 +1,20 @@
+import { BaseCommand } from '@adonisjs/core/ace';
+import type { CommandOptions } from '@adonisjs/core/types/ace';
+/**
+ * `node ace make:webhook-handler <event>` — scaffold a webhook handler under
+ * `app/payment_handlers/`, the parallel to durable's `make:workflow` (which scaffolds
+ * `app/workflows/`). The generated class declares `static eventType` (the normalized
+ * event it listens to, e.g. `payment.succeeded`) and a `handle(event)` method, and is
+ * auto-registered on the payments provider's webhook route at boot — no manual wiring.
+ *
+ * Register the Assembler `init` hook first so the folder is codegen'd:
+ * `hooks: { init: [() => import('@adonis-agora/payments/hooks/webhook_handlers')] }`.
+ */
+export default class MakeWebhookHandler extends BaseCommand {
+    static commandName: string;
+    static description: string;
+    static options: CommandOptions;
+    name: string;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=make_webhook_handler.d.ts.map

package/dist/commands/make_webhook_handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"make_webhook_handler.d.ts","sourceRoot":"","sources":["../../commands/make_webhook_handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAQ,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG/D;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,WAAW;IACzD,OAAgB,WAAW,SAA0B;IACrD,OAAgB,WAAW,SAA2D;IACtF,OAAgB,OAAO,EAAE,cAAc,CAA+B;IAG9D,IAAI,EAAE,MAAM,CAAC;IAEN,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAOpC"}

package/dist/commands/make_webhook_handler.js

@@ -0,0 +1,34 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { BaseCommand, args } from '@adonisjs/core/ace';
+import { stubsRoot } from '../stubs/main.js';
+/**
+ * `node ace make:webhook-handler <event>` — scaffold a webhook handler under
+ * `app/payment_handlers/`, the parallel to durable's `make:workflow` (which scaffolds
+ * `app/workflows/`). The generated class declares `static eventType` (the normalized
+ * event it listens to, e.g. `payment.succeeded`) and a `handle(event)` method, and is
+ * auto-registered on the payments provider's webhook route at boot — no manual wiring.
+ *
+ * Register the Assembler `init` hook first so the folder is codegen'd:
+ * `hooks: { init: [() => import('@adonis-agora/payments/hooks/webhook_handlers')] }`.
+ */
+export default class MakeWebhookHandler extends BaseCommand {
+    static commandName = 'make:webhook-handler';
+    static description = 'Create a new webhook handler in app/payment_handlers/';
+    static options = { allowUnknownFlags: true };
+    async run() {
+        const codemods = await this.createCodemods();
+        await codemods.makeUsingStub(stubsRoot(), 'make/webhook_handler/main.stub', {
+            flags: this.parsed.flags,
+            entity: this.app.generators.createEntity(this.name),
+        });
+    }
+}
+__decorate([
+    args.string({ description: 'Normalized event name (e.g. payment.succeeded)' })
+], MakeWebhookHandler.prototype, "name", void 0);
+//# sourceMappingURL=make_webhook_handler.js.map

package/dist/commands/make_webhook_handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"make_webhook_handler.js","sourceRoot":"","sources":["../../commands/make_webhook_handler.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,WAAW;IACzD,MAAM,CAAU,WAAW,GAAG,sBAAsB,CAAC;IACrD,MAAM,CAAU,WAAW,GAAG,uDAAuD,CAAC;IACtF,MAAM,CAAU,OAAO,GAAmB,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;IAK7D,KAAK,CAAC,GAAG;QAChB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC7C,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,EAAE,gCAAgC,EAAE;YAC1E,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;YACxB,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;SACpD,CAAC,CAAC;IACL,CAAC;;AARO;IADP,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,gDAAgD,EAAE,CAAC;gDAC1D"}

package/dist/commands/payments_sync.d.ts

@@ -0,0 +1,20 @@
+import { BaseCommand } from '@adonisjs/core/ace';
+import type { CommandOptions } from '@adonisjs/core/types/ace';
+/**
+ * `node ace payments:sync [--provider=stripe] [--customer=cus_123 | --all]` — reconcile
+ * local billing records with the gateway. Useful after missed webhooks or manual
+ * dashboard changes: pulls recent invoices for a customer (or every customer in
+ * `billing_customers` with `--all`) and upserts the paid ones into the local store, so
+ * the billing tables converge with the gateway.
+ */
+export default class PaymentsSync extends BaseCommand {
+    #private;
+    static commandName: string;
+    static description: string;
+    static options: CommandOptions;
+    provider?: string;
+    customer?: string;
+    all?: boolean;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=payments_sync.d.ts.map

package/dist/commands/payments_sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments_sync.d.ts","sourceRoot":"","sources":["../../commands/payments_sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAS,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAM/D;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,WAAW;;IACnD,OAAgB,WAAW,SAAmB;IAC9C,OAAgB,WAAW,SAA6D;IACxF,OAAgB,OAAO,EAAE,cAAc,CAA+B;IAG9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAKlB,GAAG,CAAC,EAAE,OAAO,CAAC;IAEP,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAqEpC"}

package/dist/commands/payments_sync.js

@@ -0,0 +1,95 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { BaseCommand, flags } from '@adonisjs/core/ace';
+import db from '@adonisjs/lucid/services/db';
+import { LucidBillingStore } from '../src/billing/lucid_billing_store.js';
+import { PaymentsManager } from '../src/payments_manager.js';
+/**
+ * `node ace payments:sync [--provider=stripe] [--customer=cus_123 | --all]` — reconcile
+ * local billing records with the gateway. Useful after missed webhooks or manual
+ * dashboard changes: pulls recent invoices for a customer (or every customer in
+ * `billing_customers` with `--all`) and upserts the paid ones into the local store, so
+ * the billing tables converge with the gateway.
+ */
+export default class PaymentsSync extends BaseCommand {
+    static commandName = 'payments:sync';
+    static description = 'Reconcile local billing records with a payment provider';
+    static options = { allowUnknownFlags: true };
+    async run() {
+        const config = this.app.config.get('payments', {});
+        if (config.billing?.enabled === false) {
+            this.logger.error('The billing layer is disabled (billing.enabled = false). Nothing to sync.');
+            return;
+        }
+        if (!this.customer && !this.all) {
+            this.logger.error('Pass --customer=<gateway customer id> to sync one customer, or --all to sync every customer in billing_customers.');
+            return;
+        }
+        const manager = await this.app.container.make(PaymentsManager);
+        const driver = manager.driver(this.provider);
+        // Some gateways (Woovi/OpenPix) have no invoice concept — fail early with a clear
+        // message instead of listing nothing.
+        manager.assertCapability(driver, 'invoices');
+        const store = new LucidBillingStore();
+        const customers = this.customer ? [this.customer] : await this.#listCustomers();
+        if (customers.length === 0) {
+            this.logger.info('No customers to sync (billing_customers is empty).');
+            return;
+        }
+        let synced = 0;
+        for (const customerId of customers) {
+            const invoices = await driver.listInvoices(customerId);
+            let skipped = 0;
+            for (const invoice of invoices) {
+                // Only sync invoices that represent a settled/paid billing event.
+                if (invoice.status === 'paid') {
+                    await store.savePayment({
+                        gatewayId: invoice.gatewayId,
+                        provider: invoice.provider,
+                        status: 'paid',
+                        amount: invoice.amount.amount,
+                        currency: invoice.amount.currency,
+                        ...(invoice.customerId !== undefined ? { customerId: invoice.customerId } : {}),
+                        ...(invoice.subscriptionId !== undefined
+                            ? { subscriptionId: invoice.subscriptionId }
+                            : {}),
+                        paidAt: new Date(),
+                        payload: invoice.payload,
+                    });
+                    synced += 1;
+                }
+                else {
+                    skipped += 1;
+                }
+            }
+            this.logger.info(`  ${customerId}: ${invoices.length} invoice(s), ${invoices.length - skipped} synced, ${skipped} skipped (non-paid)`);
+        }
+        this.logger.success(`Synced ${synced} paid invoice(s) across ${customers.length} customer(s).`);
+    }
+    /** Gateway customer ids from the `billing_customers` table (best-effort). */
+    async #listCustomers() {
+        try {
+            const rows = await db.from('billing_customers').select('gateway_id');
+            return rows.map((row) => row.gateway_id);
+        }
+        catch {
+            return [];
+        }
+    }
+}
+__decorate([
+    flags.string({ description: 'Provider to sync (a key of config/providers)' })
+], PaymentsSync.prototype, "provider", void 0);
+__decorate([
+    flags.string({ description: 'Gateway customer id to sync invoices for' })
+], PaymentsSync.prototype, "customer", void 0);
+__decorate([
+    flags.boolean({
+        description: 'Sync invoices for every customer in the billing_customers table',
+    })
+], PaymentsSync.prototype, "all", void 0);
+//# sourceMappingURL=payments_sync.js.map

package/dist/commands/payments_sync.js.map

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

package/dist/commands/payments_webhook.d.ts

@@ -0,0 +1,19 @@
+import { BaseCommand } from '@adonisjs/core/ace';
+import type { CommandOptions } from '@adonisjs/core/types/ace';
+/**
+ * `node ace payments:webhook` — print the webhook endpoints to register in each
+ * configured payment provider's dashboard, with the events each provider needs. The
+ * gateway dashboards require manual registration (unlike a `cashier:webhook`-style API
+ * call), so this command surfaces the exact URL + event list to paste. Events are
+ * filtered by the driver's declared capabilities.
+ */
+export default class PaymentsWebhook extends BaseCommand {
+    #private;
+    static commandName: string;
+    static description: string;
+    static options: CommandOptions;
+    provider?: string;
+    create?: boolean;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=payments_webhook.d.ts.map

package/dist/commands/payments_webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments_webhook.d.ts","sourceRoot":"","sources":["../../commands/payments_webhook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAS,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAiD/D;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,WAAW;;IACtD,OAAgB,WAAW,SAAsB;IACjD,OAAgB,WAAW,SAAqE;IAChG,OAAgB,OAAO,EAAE,cAAc,CAA+B;IAG9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAKlB,MAAM,CAAC,EAAE,OAAO,CAAC;IAEV,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAuEpC"}

package/dist/commands/payments_webhook.js

@@ -0,0 +1,123 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { BaseCommand, flags } from '@adonisjs/core/ace';
+import { PaymentsManager } from '../src/payments_manager.js';
+/**
+ * The webhook events each gateway needs, with the capability each event depends on.
+ * Events whose capability is `false` on the resolved driver are filtered out, so a
+ * Woovi provider never advertises refund events and an AbacatePay without billing
+ * subscriptions never advertises subscription events. Keyed by the driver's own
+ * `provider` id (not the config key), so custom providers built on top of a built-in
+ * factory get the right list too.
+ */
+const EVENTS_BY_PROVIDER = {
+    stripe: [
+        { event: 'checkout.session.completed' },
+        { event: 'invoice.payment_succeeded', requires: 'invoices' },
+        { event: 'customer.subscription.created', requires: 'subscriptions' },
+        { event: 'customer.subscription.updated', requires: 'subscriptions' },
+        { event: 'customer.subscription.deleted', requires: 'subscriptions' },
+    ],
+    asaas: [
+        { event: 'PAYMENT_CREATED' },
+        { event: 'PAYMENT_RECEIVED' },
+        { event: 'PAYMENT_OVERDUE' },
+        { event: 'PAYMENT_REFUNDED', requires: 'refunds' },
+        { event: 'SUBSCRIPTION_CREATED', requires: 'subscriptions' },
+        { event: 'SUBSCRIPTION_UPDATED', requires: 'subscriptions' },
+        { event: 'SUBSCRIPTION_DELETED', requires: 'subscriptions' },
+    ],
+    abacate: [
+        { event: 'checkout.completed' },
+        { event: 'checkout.refunded', requires: 'refunds' },
+        { event: 'subscription.completed', requires: 'subscriptions' },
+        { event: 'subscription.renewed', requires: 'subscriptions' },
+        { event: 'subscription.cancelled', requires: 'subscriptions' },
+    ],
+    woovi: [
+        { event: 'PIX_AUTOMATIC_APPROVED' },
+        { event: 'PIX_AUTOMATIC_REJECTED' },
+        { event: 'PIX_AUTOMATIC_COBR_COMPLETED' },
+        { event: 'CHARGE_COMPLETED' },
+        { event: 'CHARGE_EXPIRED' },
+    ],
+};
+/**
+ * `node ace payments:webhook` — print the webhook endpoints to register in each
+ * configured payment provider's dashboard, with the events each provider needs. The
+ * gateway dashboards require manual registration (unlike a `cashier:webhook`-style API
+ * call), so this command surfaces the exact URL + event list to paste. Events are
+ * filtered by the driver's declared capabilities.
+ */
+export default class PaymentsWebhook extends BaseCommand {
+    static commandName = 'payments:webhook';
+    static description = 'Show the webhook endpoints to register in each payment provider';
+    static options = { allowUnknownFlags: true };
+    async run() {
+        if (this.create) {
+            await this.#createStripeEndpoint();
+            return;
+        }
+        const config = this.app.config.get('payments', {});
+        const names = Object.keys(config.providers ?? {}).filter((name) => this.provider === undefined ? true : name === this.provider);
+        if (names.length === 0) {
+            this.logger.info('No payment providers configured. Add providers to config/payments.ts.');
+            return;
+        }
+        const manager = await this.app.container.make(PaymentsManager);
+        for (const name of names) {
+            // Resolve the real driver so custom providers (e.g. a wrapped Asaas) report the
+            // correct event list and capabilities instead of falling back to '*'.
+            const driver = manager.driver(name);
+            const all = EVENTS_BY_PROVIDER[driver.provider] ?? [];
+            const events = all
+                .filter((entry) => entry.requires === undefined || driver.capabilities?.[entry.requires] !== false)
+                .map((entry) => entry.event);
+            this.logger.info(`\n[${name}] (${driver.provider})`);
+            this.logger.info(`  URL: ${this.app.makeURL(`/payments/webhook/${name}`)}`);
+            this.logger.info(events.length > 0
+                ? `  Events: ${events.join(', ')}`
+                : '  Events: * (unknown driver — register all events)');
+        }
+        this.logger.info('\nRegister these endpoints in the provider dashboard. Webhook payloads are validated by the provider driver.');
+    }
+    /**
+     * Stripe is the one gateway whose dashboard lets you create webhook endpoints over the
+     * API — `node ace payments:webhook --create` does it for you (needs `STRIPE_KEY`; the
+     * signing secret `whsec_...` is echoed to print into `.env` as `STRIPE_WEBHOOK_SECRET`).
+     */
+    async #createStripeEndpoint() {
+        const apiKey = process.env.STRIPE_KEY;
+        if (!apiKey) {
+            this.logger.error('Missing STRIPE_KEY — needed to create the Stripe webhook endpoint.');
+            return;
+        }
+        const { default: Stripe } = await import('stripe');
+        const stripe = new Stripe(apiKey);
+        const url = this.app.makeURL('/payments/webhook/stripe').toString();
+        const events = EVENTS_BY_PROVIDER.stripe.map((entry) => entry.event);
+        this.logger.info(`Creating Stripe webhook endpoint for ${url}...`);
+        const endpoint = await stripe.webhookEndpoints.create({
+            url,
+            enabled_events: events,
+        });
+        this.logger.success(`Created Stripe webhook endpoint ${endpoint.id}`);
+        if (endpoint.secret) {
+            this.logger.info('Webhook signing secret (add to .env):');
+            this.logger.info(`  STRIPE_WEBHOOK_SECRET=${endpoint.secret}`);
+        }
+    }
+}
+__decorate([
+    flags.string({ description: 'Only show this provider (a key of config/providers)' })
+], PaymentsWebhook.prototype, "provider", void 0);
+__decorate([
+    flags.boolean({
+        description: 'Auto-create the Stripe webhook endpoint via the API (needs STRIPE_KEY)',
+    })
+], PaymentsWebhook.prototype, "create", void 0);
+//# sourceMappingURL=payments_webhook.js.map

package/dist/commands/payments_webhook.js.map

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

package/dist/configure.d.ts

@@ -0,0 +1,12 @@
+import type Configure from '@adonisjs/core/commands/configure';
+/**
+ * `node ace configure @adonis-agora/payments` — auto-wires the package:
+ *
+ * 1. registers the payments service provider in `adonisrc.ts`;
+ * 2. publishes `config/payments.ts`;
+ * 3. publishes the Lucid migrations for the billing tables (run `node ace migration:run`;
+ *    delete the file if you only use payments without the billing layer);
+ * 4. registers the env validations for the payment providers.
+ */
+export declare function configure(command: Configure): Promise<void>;
+//# sourceMappingURL=configure.d.ts.map

package/dist/configure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../configure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,mCAAmC,CAAC;AAG/D;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,SAAS,iBAyBjD"}

package/dist/configure.js

@@ -0,0 +1,34 @@
+import { stubsRoot } from './stubs/main.js';
+/**
+ * `node ace configure @adonis-agora/payments` — auto-wires the package:
+ *
+ * 1. registers the payments service provider in `adonisrc.ts`;
+ * 2. publishes `config/payments.ts`;
+ * 3. publishes the Lucid migrations for the billing tables (run `node ace migration:run`;
+ *    delete the file if you only use payments without the billing layer);
+ * 4. registers the env validations for the payment providers.
+ */
+export async function configure(command) {
+    const codemods = await command.createCodemods();
+    // biome-ignore lint/suspicious/noExplicitAny: `createCodemods` types the callback; matching media.
+    await codemods.updateRcFile((rcFile) => {
+        rcFile.addProvider('@adonis-agora/payments/payments_provider');
+        rcFile.addCommand('@adonis-agora/payments/commands');
+    });
+    const stubs = stubsRoot();
+    await codemods.makeUsingStub(stubs, 'config/payments.stub', {});
+    await codemods.makeUsingStub(stubs, 'database/migrations/create_billing_tables.stub', {});
+    await codemods.defineEnvValidations({
+        leadingComment: 'PAYMENTS_',
+        variables: {
+            STRIPE_KEY: 'Env.schema.string.optional()',
+            STRIPE_WEBHOOK_SECRET: 'Env.schema.string.optional()',
+            ABACATE_API_KEY: 'Env.schema.string.optional()',
+            ABACATE_PUBLIC_KEY: 'Env.schema.string.optional()',
+            ASAAS_API_KEY: 'Env.schema.string.optional()',
+            WOOVI_APP_ID: 'Env.schema.string.optional()',
+            FOCUS_NFE_TOKEN: 'Env.schema.string.optional()',
+        },
+    });
+}
+//# sourceMappingURL=configure.js.map

package/dist/configure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure.js","sourceRoot":"","sources":["../configure.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAkB;IAChD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC;IAEhD,mGAAmG;IACnG,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC,MAAW,EAAE,EAAE;QAC1C,MAAM,CAAC,WAAW,CAAC,0CAA0C,CAAC,CAAC;QAC/D,MAAM,CAAC,UAAU,CAAC,iCAAiC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,MAAM,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,sBAAsB,EAAE,EAAE,CAAC,CAAC;IAChE,MAAM,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,gDAAgD,EAAE,EAAE,CAAC,CAAC;IAE1F,MAAM,QAAQ,CAAC,oBAAoB,CAAC;QAClC,cAAc,EAAE,WAAW;QAC3B,SAAS,EAAE;YACT,UAAU,EAAE,8BAA8B;YAC1C,qBAAqB,EAAE,8BAA8B;YACrD,eAAe,EAAE,8BAA8B;YAC/C,kBAAkB,EAAE,8BAA8B;YAClD,aAAa,EAAE,8BAA8B;YAC7C,YAAY,EAAE,8BAA8B;YAC5C,eAAe,EAAE,8BAA8B;SAChD;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/providers/payments_provider.d.ts

@@ -0,0 +1,15 @@
+import type { ApplicationService } from '@adonisjs/core/types';
+/**
+ * Wires `@adonis-agora/payments` into the AdonisJS application: binds a singleton
+ * {@link PaymentsManager} built from `config/payments.ts`, wires the optional Lucid
+ * billing layer (store + webhook processor + dispatcher), and mounts the webhook route
+ * under `/payments/webhook/:provider`.
+ */
+export default class PaymentsProvider {
+    #private;
+    protected app: ApplicationService;
+    constructor(app: ApplicationService);
+    register(): void;
+    boot(): Promise<void>;
+}
+//# sourceMappingURL=payments_provider.d.ts.map

package/dist/providers/payments_provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments_provider.d.ts","sourceRoot":"","sources":["../../providers/payments_provider.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAqB,MAAM,sBAAsB,CAAC;AAkBlF;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,gBAAgB;;IAGvB,SAAS,CAAC,GAAG,EAAE,kBAAkB;gBAAvB,GAAG,EAAE,kBAAkB;IAE7C,QAAQ;IAwBF,IAAI;CAmHX"}