@adonis-agora/payments 0.2.0

package/dist/src/drivers/woovi.js

@@ -0,0 +1,339 @@
+import { createClient } from '@woovi/node-sdk';
+import { publishPaymentDiagnostics, publishSubscriptionDiagnostics } from '../diagnostics.js';
+import { headerValue } from '../http.js';
+import { emitInvoiceIfRequested } from '../invoice/emit_invoice.js';
+import { fromDecimal, toDecimal } from '../money.js';
+import { verifyHmacSignature, verifyRsaSha256Signature } from '../webhook_security.js';
+export class WooviDriver {
+    provider = 'woovi';
+    // Woovi/OpenPix is Pix-only and has no refunds or invoice concept.
+    supportedMethods = ['pix', 'undefined'];
+    capabilities = { subscriptions: true };
+    #client;
+    #invoiceCtx;
+    /** HMAC secret of the specific webhook config (dashboard → API/Plugins). */
+    #webhookSecret;
+    /** Woovi account public key, used to verify `x-webhook-signature` (recommended). */
+    #webhookPublicKey;
+    #appId;
+    constructor(ctx, config = {}) {
+        this.#invoiceCtx = ctx;
+        const appId = config.appId ?? process.env.WOOVI_APP_ID;
+        if (!appId) {
+            throw new Error('[payments] Woovi driver requires an app id. Set `WOOVI_APP_ID` env or pass `appId` to `payments.woovi()`.');
+        }
+        this.#appId = appId;
+        this.#webhookSecret = config.webhookSecret ?? process.env.WOOVI_WEBHOOK_SECRET;
+        this.#webhookPublicKey = config.webhookPublicKey ?? process.env.WOOVI_WEBHOOK_PUBLIC_KEY;
+        // Lazy import happens in the factory (see `define_config.ts`), so the SDK module is
+        // only loaded when this driver is actually selected.
+        this.#client = createClient({ appId });
+    }
+    // ── Customers ────────────────────────────────────────────────────────────────────────
+    async createCustomer(input) {
+        const data = await this.#client.customer.create({
+            name: input.name ?? input.email ?? 'Customer',
+            ...(input.email !== undefined ? { email: input.email } : {}),
+            ...(input.taxId !== undefined ? { taxID: { taxID: input.taxId, type: 'BR:CPF' } } : {}),
+        });
+        return this.#mapCustomer(data);
+    }
+    async findCustomer(customerId) {
+        try {
+            const data = await this.#client.customer.get({ id: customerId });
+            return this.#mapCustomer(data);
+        }
+        catch {
+            return null;
+        }
+    }
+    async updateCustomer(customerId, input) {
+        // OpenPix customers are immutable; return the existing customer best-effort.
+        const data = await this.#client.customer.create({
+            correlationID: customerId,
+            name: input.name ?? 'Customer',
+            ...(input.email !== undefined ? { email: input.email } : {}),
+        });
+        return this.#mapCustomer(data);
+    }
+    // ── Payments ─────────────────────────────────────────────────────────────────────────
+    async charge(input) {
+        const data = await this.#client.charge.create({
+            // Woovi's `correlationID` is the app's own reference — the routing key webhook
+            // handlers read. Prefer the explicit `externalReference`, fall back to the
+            // idempotency key (legacy behavior).
+            correlationID: input.externalReference ?? input.idempotencyKey ?? `charge_${Date.now()}`,
+            value: toDecimal(input.amount),
+            ...(input.description !== undefined ? { comment: input.description } : {}),
+            ...(input.customerId !== undefined ? { customer: input.customerId } : {}),
+        });
+        const payment = this.#mapPayment(data);
+        await emitInvoiceIfRequested(this.#invoiceCtx, input, payment, this);
+        publishPaymentDiagnostics(payment);
+        return payment;
+    }
+    async findPayment(gatewayId) {
+        try {
+            const data = await this.#client.charge.get({ id: gatewayId });
+            return this.#mapPayment(data);
+        }
+        catch {
+            return null;
+        }
+    }
+    async refund(_paymentGatewayId, _amount) {
+        throw new Error('[payments] Woovi/OpenPix does not support refunds via API.');
+    }
+    // ── Subaccounts (Woovi for Platforms) ────────────────────────────────────────────────
+    /** Create a subaccount (marketplace receiver) keyed by a Pix key. */
+    async createSubAccount(input) {
+        const data = await this.#client.subAccount.create(input);
+        return this.#mapSubAccount(data.SubAccount);
+    }
+    /** Find a subaccount by its id. */
+    async findSubAccount(id) {
+        try {
+            const data = await this.#client.subAccount.get({ id });
+            return this.#mapSubAccount(data.SubAccount);
+        }
+        catch {
+            return null;
+        }
+    }
+    /** List every subaccount. */
+    async listSubAccounts() {
+        const data = await this.#client.subAccount.list();
+        return data.subAccounts.map((s) => this.#mapSubAccount(s));
+    }
+    #mapSubAccount(data) {
+        return {
+            name: data.name ?? '',
+            pixKey: data.pixKey ?? '',
+            balance: Number(data.balance ?? 0),
+        };
+    }
+    // ── Checkout ─────────────────────────────────────────────────────────────────────────
+    async createCheckout(input) {
+        const data = await this.#client.charge.create({
+            correlationID: input.idempotencyKey ?? `checkout_${Date.now()}`,
+            value: toDecimal(input.amount),
+            ...(input.description !== undefined ? { comment: input.description } : {}),
+        });
+        const charge = data;
+        const brCode = charge.pixQrCode?.brCode ?? charge.brCode?.brCode ?? '';
+        return {
+            id: String(charge.id ?? ''),
+            gatewayId: String(charge.id ?? ''),
+            provider: this.provider,
+            url: '',
+            status: 'open',
+            amount: { amount: input.amount, currency: 'brl' },
+            ...(brCode !== '' ? { pixCopiaECola: brCode } : {}),
+        };
+    }
+    // ── Subscriptions (Pix Automático) ──────────────────────────────────────────────────
+    async createSubscription(input) {
+        // Woovi creates subscriptions with an inline customer (no customer-id flow).
+        const customer = await this.#resolveSubscriptionCustomer(input);
+        const body = {
+            customer,
+            value: toDecimal(input.amount ?? 0),
+            dayGenerateCharge: this.#dayOfMonth(input.startDate) ?? 1,
+            ...(input.cycle !== undefined ? { frequency: this.#mapFrequency(input.cycle) } : {}),
+            // Pix Automático journey 3 (pay-on-approval): `DYNAMIC` generates each charge and
+            // asks the payer to approve it. Override via `metadata.chargeType` if needed.
+            ...(input.metadata?.chargeType !== undefined
+                ? { chargeType: input.metadata.chargeType }
+                : { chargeType: 'DYNAMIC' }),
+            ...(input.metadata?.dayDue !== undefined ? { dayDue: input.metadata.dayDue } : {}),
+        };
+        const data = await this.#client.subscription.create(body);
+        // The SDK wraps the created subscription in `{ subscription }` (get/find return it bare).
+        const subscription = this.#mapSubscription(data.subscription ??
+            data);
+        publishSubscriptionDiagnostics(subscription, 'subscription.created');
+        return subscription;
+    }
+    /** Woovi's inline customer: `input.customer`, else the gateway customer (needs name+taxId). */
+    async #resolveSubscriptionCustomer(input) {
+        if (input.customer?.name && input.customer.taxId) {
+            return {
+                name: input.customer.name,
+                email: input.customer.email ?? '',
+                taxID: input.customer.taxId.replace(/\D/g, ''),
+            };
+        }
+        if (input.customerId) {
+            const customer = await this.findCustomer(input.customerId);
+            if (customer?.name && customer.taxId) {
+                return {
+                    name: customer.name,
+                    email: customer.email ?? '',
+                    taxID: customer.taxId.replace(/\D/g, ''),
+                };
+            }
+        }
+        throw new Error('[payments] Woovi subscription needs the payer name + taxId — pass `customer` on the subscription, or create the gateway customer with them.');
+    }
+    #mapFrequency(cycle) {
+        switch (cycle) {
+            case 'WEEKLY':
+                return 'WEEKLY';
+            case 'MONTHLY':
+                return 'MONTHLY';
+            case 'QUARTERLY':
+                return 'TRIMONTHLY';
+            case 'SEMIANNUALLY':
+                return 'SEMIANNUALY';
+            case 'YEARLY':
+                return 'ANNUALY';
+            default:
+                return 'MONTHLY';
+        }
+    }
+    async cancelSubscription(subscriptionGatewayId, _options) {
+        const data = await this.#client.subscription.get({ id: subscriptionGatewayId });
+        const subscription = this.#mapSubscription({ ...data, status: 'INACTIVE' });
+        publishSubscriptionDiagnostics(subscription, 'subscription.canceled');
+        return subscription;
+    }
+    async findSubscription(gatewayId) {
+        try {
+            const data = await this.#client.subscription.get({ id: gatewayId });
+            return this.#mapSubscription(data);
+        }
+        catch {
+            return null;
+        }
+    }
+    async updateSubscription(subscriptionGatewayId, input) {
+        // OpenPix subscriptions are immutable — best-effort: fetch and return with the new
+        // amount/description applied locally (the change takes effect on the next cycle by
+        // recreating the subscription in a real integration).
+        const data = await this.#client.subscription.get({ id: subscriptionGatewayId });
+        const updated = {
+            ...data,
+            ...(input.amount !== undefined ? { value: toDecimal(input.amount) } : {}),
+            ...(input.description !== undefined ? { comment: input.description } : {}),
+        };
+        return this.#mapSubscription(updated);
+    }
+    // ── Invoices ─────────────────────────────────────────────────────────────────────────
+    async listInvoices(_customerId) {
+        // OpenPix has no invoice concept — charges are the billing record.
+        return [];
+    }
+    // ── Webhooks ─────────────────────────────────────────────────────────────────────────
+    parseWebhook(rawBody, headers) {
+        // Woovi signs webhooks two ways: the recommended `x-webhook-signature`
+        // (RSA-SHA256 with Woovi's account public key — validates the SENDER) and the
+        // per-webhook HMAC (`X-OpenPix-Signature`, deprecated but validates YOUR webhook
+        // config). Whichever credential is configured is enforced strictly; without one
+        // only the app id header (when set) guards the endpoint.
+        if (this.#webhookPublicKey !== undefined) {
+            const signature = headerValue(headers, 'x-webhook-signature');
+            if (!verifyRsaSha256Signature(rawBody, signature, this.#webhookPublicKey)) {
+                throw new Error('[payments] Invalid or missing Woovi webhook signature.');
+            }
+        }
+        else if (this.#webhookSecret !== undefined) {
+            const hmac = headerValue(headers, 'x-openpix-signature');
+            if (!verifyHmacSignature(rawBody, hmac, this.#webhookSecret, 'sha1')) {
+                throw new Error('[payments] Invalid or missing Woovi webhook HMAC.');
+            }
+        }
+        const appId = headerValue(headers, 'app_id') ?? headerValue(headers, 'x-woovi-app-id');
+        if (this.#appId && appId && appId !== this.#appId) {
+            throw new Error('[payments] Invalid Woovi webhook app id.');
+        }
+        const payload = JSON.parse(rawBody);
+        const event = String(payload.event ?? 'unknown');
+        return {
+            id: String(payload.id ?? payload.globalID ?? `${event}-${Math.random()}`),
+            provider: this.provider,
+            type: this.#mapWebhookType(event),
+            createdAt: new Date().toISOString(),
+            data: payload,
+            raw: payload,
+        };
+    }
+    // ── Mappers ──────────────────────────────────────────────────────────────────────────
+    #mapCustomer(data) {
+        const taxId = data.taxID?.taxID;
+        return {
+            id: String(data.id ?? data.correlationID ?? ''),
+            ...(typeof data.name === 'string' ? { name: data.name } : {}),
+            ...(typeof data.email === 'string' ? { email: data.email } : {}),
+            ...(taxId !== undefined ? { taxId } : {}),
+        };
+    }
+    #mapPayment(data) {
+        const value = typeof data.value === 'number' ? data.value : 0;
+        const status = String(data.status ?? 'ACTIVE').toUpperCase();
+        const pixQrCode = data.pixQrCode?.brCode ??
+            data.brCode?.brCode;
+        return {
+            id: String(data.id ?? data.globalID ?? ''),
+            gatewayId: String(data.globalID ?? data.id ?? ''),
+            provider: this.provider,
+            amount: { amount: fromDecimal(value), currency: 'brl' },
+            status: status === 'COMPLETED' || status === 'PAID'
+                ? 'paid'
+                : status === 'EXPIRED' || status === 'CANCELED' || status === 'REJECTED'
+                    ? 'canceled'
+                    : 'pending',
+            ...(pixQrCode !== undefined ? { pixCopiaECola: pixQrCode } : {}),
+            ...(typeof data.correlationID === 'string' ? { customerId: data.correlationID } : {}),
+            payload: data,
+            createdAt: typeof data.createdAt === 'string' ? data.createdAt : new Date().toISOString(),
+        };
+    }
+    #mapSubscription(data) {
+        const value = typeof data.value === 'number' ? data.value : 0;
+        const status = String(data.status ?? 'ACTIVE').toUpperCase();
+        const globalId = String(data.globalID ?? data.id ?? '');
+        return {
+            id: globalId,
+            gatewayId: globalId,
+            provider: this.provider,
+            customerId: String(data.correlationID ?? ''),
+            status: status === 'ACTIVE' || status === 'APPROVED'
+                ? 'active'
+                : status === 'INACTIVE' || status === 'CANCELED'
+                    ? 'canceled'
+                    : status === 'REJECTED'
+                        ? 'past_due'
+                        : 'trialing',
+            planId: String(data.pixRecurring?.recurrencyId ?? ''),
+            amount: { amount: fromDecimal(value), currency: 'brl' },
+            payload: data,
+            createdAt: typeof data.createdAt === 'string' ? data.createdAt : new Date().toISOString(),
+        };
+    }
+    #mapWebhookType(event) {
+        switch (event) {
+            case 'PIX_AUTOMATIC_APPROVED':
+                return 'subscription.created';
+            case 'PIX_AUTOMATIC_REJECTED':
+                return 'subscription.canceled';
+            case 'PIX_AUTOMATIC_COBR_COMPLETED':
+                return 'payment.succeeded';
+            case 'PIX_AUTOMATIC_COBR_REJECTED':
+            case 'PIX_AUTOMATIC_COBR_TRY_REJECTED':
+                return 'payment.failed';
+            case 'CHARGE_COMPLETED':
+                return 'payment.succeeded';
+            case 'CHARGE_EXPIRED':
+                return 'payment.failed';
+            default:
+                return event.toLowerCase();
+        }
+    }
+    #dayOfMonth(date) {
+        if (!date)
+            return undefined;
+        const day = new Date(date).getDate();
+        return Number.isNaN(day) ? undefined : day;
+    }
+}
+//# sourceMappingURL=woovi.js.map

package/dist/src/drivers/woovi.js.map

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

package/dist/src/ensure_customer.d.ts

@@ -0,0 +1,23 @@
+import type { CreateCustomerInput, PaymentsDriver } from './driver.js';
+import type { Customer } from './types.js';
+/**
+ * Get-or-create a gateway customer: when the app already stores a gateway customer id,
+ * return it as-is; otherwise create the customer at the gateway and return the created
+ * record (so the caller persists the new id).
+ *
+ * The app owns the mapping between its users and gateway customer ids — this helper only
+ * does the "reuse or create" branch every payments flow needs:
+ *
+ * ```ts
+ * const customer = await ensureCustomer(driver, user.asaasCustomerId, {
+ *   name: user.fullName,
+ *   email: user.email,
+ *   taxId: user.cpfCnpj ?? undefined,
+ *   metadata: { phone: user.phone },
+ * })
+ * user.asaasCustomerId = customer.id
+ * await user.save()
+ * ```
+ */
+export declare function ensureCustomer(driver: PaymentsDriver, existingId: string | null | undefined, input: CreateCustomerInput): Promise<Customer>;
+//# sourceMappingURL=ensure_customer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ensure_customer.d.ts","sourceRoot":"","sources":["../../src/ensure_customer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACrC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,QAAQ,CAAC,CAGnB"}

package/dist/src/ensure_customer.js

@@ -0,0 +1,25 @@
+/**
+ * Get-or-create a gateway customer: when the app already stores a gateway customer id,
+ * return it as-is; otherwise create the customer at the gateway and return the created
+ * record (so the caller persists the new id).
+ *
+ * The app owns the mapping between its users and gateway customer ids — this helper only
+ * does the "reuse or create" branch every payments flow needs:
+ *
+ * ```ts
+ * const customer = await ensureCustomer(driver, user.asaasCustomerId, {
+ *   name: user.fullName,
+ *   email: user.email,
+ *   taxId: user.cpfCnpj ?? undefined,
+ *   metadata: { phone: user.phone },
+ * })
+ * user.asaasCustomerId = customer.id
+ * await user.save()
+ * ```
+ */
+export async function ensureCustomer(driver, existingId, input) {
+    if (existingId)
+        return { id: existingId };
+    return driver.createCustomer(input);
+}
+//# sourceMappingURL=ensure_customer.js.map

package/dist/src/ensure_customer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure_customer.js","sourceRoot":"","sources":["../../src/ensure_customer.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAsB,EACtB,UAAqC,EACrC,KAA0B;IAE1B,IAAI,UAAU;QAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC;IAC1C,OAAO,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;AACtC,CAAC"}

package/dist/src/hooks/webhook_handlers.d.ts

@@ -0,0 +1,50 @@
+import type { IndexGenerator } from '@adonisjs/assembler/index_generator';
+/**
+ * Where the generated webhook-handlers barrel is written, relative to the app root. The
+ * payments provider imports THIS path at boot (build-time codegen) instead of scanning
+ * `app/payment_handlers` with `readdir` at runtime. Kept in sync with the provider.
+ */
+export declare const GENERATED_WEBHOOK_HANDLERS_OUTPUT = ".adonisjs/payments/webhook_handlers.ts";
+/**
+ * Options for {@link webhookHandlersHook} — mirror the relevant `IndexGenerator.add`
+ * knobs so an app can point the generator at a non-default handlers directory or import
+ * alias.
+ */
+export interface WebhookHandlersHookOptions {
+    /** Directory the generator scans for handler modules, relative to the app root. Default `app/payment_handlers`. */
+    source?: string;
+    /** Import alias the generated barrel uses for each handler module. Default `#payment_handlers`. */
+    importAlias?: string;
+    /** Output path for the generated barrel, relative to the app root. Default `.adonisjs/payments/webhook_handlers.ts`. */
+    output?: string;
+}
+/**
+ * An AdonisJS **Assembler `init` hook** that generates a typed barrel of the app's
+ * `app/payment_handlers/` directory at build/dev time — exactly how the durable package
+ * generates `app/workflows` and `@adonisjs/core` generates the controllers/events
+ * barrels (`indexEntities`). The build-time barrel replaces the provider's runtime
+ * `readdir` scan; the file watcher re-runs the generator whenever a handler file
+ * changes.
+ *
+ * The generated file is a lazy barrel — `export const webhookHandlers = { Name: () =>
+ * import('#payment_handlers/…') }` — which the payments provider imports at boot and
+ * registers alongside `config.billing.handlers`.
+ *
+ * Register it in `adonisrc.ts`:
+ *
+ * ```ts
+ * export default defineConfig({
+ *   hooks: {
+ *     init: [() => import('@adonis-agora/payments/hooks/webhook_handlers')],
+ *   },
+ * })
+ * ```
+ */
+export declare function webhookHandlersHook(options?: WebhookHandlersHookOptions): (parent: unknown, hooksManager: unknown, indexGenerator: IndexGenerator) => void;
+/** The default export is the hook itself, so `() => import('@adonis-agora/payments/hooks/webhook_handlers')`
+ *  in `adonisrc.ts` resolves to a ready hook (the assembler calls it). Annotated
+ *  explicitly so the declaration emit stays portable (same as collaboration's
+ *  `codegen_init`). */
+declare const _default: (parent: unknown, hooksManager: unknown, indexGenerator: IndexGenerator) => void;
+export default _default;
+//# sourceMappingURL=webhook_handlers.d.ts.map

package/dist/src/hooks/webhook_handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook_handlers.d.ts","sourceRoot":"","sources":["../../../src/hooks/webhook_handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAG1E;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,2CAA2C,CAAC;AAE1F;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,mHAAmH;IACnH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mGAAmG;IACnG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wHAAwH;IACxH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,0BAA+B,GACvC,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,KAAK,IAAI,CA0BlF;AAED;;;uBAGuB;wBACiB,CACtC,MAAM,EAAE,OAAO,EACf,YAAY,EAAE,OAAO,EACrB,cAAc,EAAE,cAAc,KAC3B,IAAI;AAJT,wBAIU"}

package/dist/src/hooks/webhook_handlers.js

@@ -0,0 +1,53 @@
+import { hooks } from '@adonisjs/core/app';
+/**
+ * Where the generated webhook-handlers barrel is written, relative to the app root. The
+ * payments provider imports THIS path at boot (build-time codegen) instead of scanning
+ * `app/payment_handlers` with `readdir` at runtime. Kept in sync with the provider.
+ */
+export const GENERATED_WEBHOOK_HANDLERS_OUTPUT = '.adonisjs/payments/webhook_handlers.ts';
+/**
+ * An AdonisJS **Assembler `init` hook** that generates a typed barrel of the app's
+ * `app/payment_handlers/` directory at build/dev time — exactly how the durable package
+ * generates `app/workflows` and `@adonisjs/core` generates the controllers/events
+ * barrels (`indexEntities`). The build-time barrel replaces the provider's runtime
+ * `readdir` scan; the file watcher re-runs the generator whenever a handler file
+ * changes.
+ *
+ * The generated file is a lazy barrel — `export const webhookHandlers = { Name: () =>
+ * import('#payment_handlers/…') }` — which the payments provider imports at boot and
+ * registers alongside `config.billing.handlers`.
+ *
+ * Register it in `adonisrc.ts`:
+ *
+ * ```ts
+ * export default defineConfig({
+ *   hooks: {
+ *     init: [() => import('@adonis-agora/payments/hooks/webhook_handlers')],
+ *   },
+ * })
+ * ```
+ */
+export function webhookHandlersHook(options = {}) {
+    const source = options.source ?? 'app/payment_handlers';
+    const importAlias = options.importAlias ?? '#payment_handlers';
+    const output = options.output ?? GENERATED_WEBHOOK_HANDLERS_OUTPUT;
+    return hooks.init((_parent, _hooksManager, indexGenerator) => {
+        indexGenerator.add('webhookHandlers', {
+            source,
+            as: 'barrelFile',
+            exportName: 'webhookHandlers',
+            importAlias,
+            // `app/payment_handlers/payment_succeeded.ts` → barrel key `Payment/Succeeded`;
+            // the event type itself comes from each module's `type`/`eventType`.
+            skipSegments: ['payment_handlers'],
+            output,
+            comment: true,
+        });
+    });
+}
+/** The default export is the hook itself, so `() => import('@adonis-agora/payments/hooks/webhook_handlers')`
+ *  in `adonisrc.ts` resolves to a ready hook (the assembler calls it). Annotated
+ *  explicitly so the declaration emit stays portable (same as collaboration's
+ *  `codegen_init`). */
+export default webhookHandlersHook();
+//# sourceMappingURL=webhook_handlers.js.map

package/dist/src/hooks/webhook_handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook_handlers.js","sourceRoot":"","sources":["../../../src/hooks/webhook_handlers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C;;;;GAIG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,wCAAwC,CAAC;AAgB1F;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,mBAAmB,CACjC,UAAsC,EAAE;IAExC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,sBAAsB,CAAC;IACxD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,mBAAmB,CAAC;IAC/D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,iCAAiC,CAAC;IAEnE,OAAO,KAAK,CAAC,IAAI,CACf,CACE,OAAgB,EAChB,aAAsB,EACtB,cAEC,EACD,EAAE;QACF,cAAc,CAAC,GAAG,CAAC,iBAAiB,EAAE;YACpC,MAAM;YACN,EAAE,EAAE,YAAY;YAChB,UAAU,EAAE,iBAAiB;YAC7B,WAAW;YACX,gFAAgF;YAChF,qEAAqE;YACrE,YAAY,EAAE,CAAC,kBAAkB,CAAC;YAClC,MAAM;YACN,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;IACL,CAAC,CACkF,CAAC;AACxF,CAAC;AAED;;;uBAGuB;AACvB,eAAe,mBAAmB,EAIzB,CAAC"}

package/dist/src/http.d.ts

@@ -0,0 +1,24 @@
+export interface HttpRequestOptions {
+    method?: string;
+    body?: Record<string, unknown>;
+    /** Auth header sent as `Authorization: Bearer <token>`. */
+    bearerToken?: string;
+    /** Auth header sent as a raw header name/value (e.g. Asaas `access_token`). */
+    authHeader?: {
+        name: string;
+        value: string;
+    };
+    /** Base URL the path is resolved against. */
+    baseUrl: string;
+}
+/**
+ * Thin `fetch` wrapper shared by the fetch-based drivers (Asaas, AbacatePay, Woovi).
+ * Normalizes errors into an `Error` with a `status` property so `isNotFound` can check
+ * it uniformly.
+ */
+export declare function httpRequest<T>(path: string, options: HttpRequestOptions): Promise<T>;
+/** Read a header value (handles arrays, case variants and multiple spellings). */
+export declare function headerValue(headers: Record<string, string | string[] | undefined>, name: string): string | undefined;
+/** Whether an error is an HTTP 404 (resource not found). */
+export declare function isNotFound(error: unknown): boolean;
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/http.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC,CA2B1F;AAED,kFAAkF;AAClF,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,EACtD,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CAWpB;AAED,4DAA4D;AAC5D,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAOlD"}

package/dist/src/http.js

@@ -0,0 +1,52 @@
+/**
+ * Thin `fetch` wrapper shared by the fetch-based drivers (Asaas, AbacatePay, Woovi).
+ * Normalizes errors into an `Error` with a `status` property so `isNotFound` can check
+ * it uniformly.
+ */
+export async function httpRequest(path, options) {
+    const headers = { 'Content-Type': 'application/json' };
+    if (options.bearerToken !== undefined) {
+        headers.Authorization = `Bearer ${options.bearerToken}`;
+    }
+    if (options.authHeader !== undefined) {
+        headers[options.authHeader.name] = options.authHeader.value;
+    }
+    const requestInit = {
+        method: options.method ?? 'GET',
+        headers,
+    };
+    if (options.body !== undefined) {
+        requestInit.body = JSON.stringify(options.body);
+    }
+    const response = await fetch(`${options.baseUrl}${path}`, requestInit);
+    if (!response.ok) {
+        const text = await response.text();
+        const status = response.status;
+        throw Object.assign(new Error(`[payments] HTTP request failed (${status}): ${text}`), {
+            status,
+        });
+    }
+    return (await response.json());
+}
+/** Read a header value (handles arrays, case variants and multiple spellings). */
+export function headerValue(headers, name) {
+    const direct = headers[name];
+    if (direct !== undefined)
+        return Array.isArray(direct) ? direct[0] : direct;
+    // Case-insensitive fallback: scan the actual keys.
+    const lower = name.toLowerCase();
+    for (const [key, value] of Object.entries(headers)) {
+        if (key.toLowerCase() === lower) {
+            return Array.isArray(value) ? value[0] : value;
+        }
+    }
+    return undefined;
+}
+/** Whether an error is an HTTP 404 (resource not found). */
+export function isNotFound(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'status' in error &&
+        error.status === 404);
+}
+//# sourceMappingURL=http.js.map

package/dist/src/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/http.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAI,IAAY,EAAE,OAA2B;IAC5E,MAAM,OAAO,GAA2B,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC;IAC/E,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO,CAAC,aAAa,GAAG,UAAU,OAAO,CAAC,WAAW,EAAE,CAAC;IAC1D,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC;IAC9D,CAAC;IAED,MAAM,WAAW,GAAgB;QAC/B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;QAC/B,OAAO;KACR,CAAC;IACF,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/B,WAAW,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE,WAAW,CAAC,CAAC;IAEvE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;QAC/B,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,mCAAmC,MAAM,MAAM,IAAI,EAAE,CAAC,EAAE;YACpF,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IACD,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAC;AACtC,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,WAAW,CACzB,OAAsD,EACtD,IAAY;IAEZ,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC5E,mDAAmD;IACnD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,KAAK,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACjD,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,QAAQ,IAAI,KAAK;QAChB,KAA6B,CAAC,MAAM,KAAK,GAAG,CAC9C,CAAC;AACJ,CAAC"}