@adonis-agora/payments 0.2.0 → 0.3.0

package/dist/src/testing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,YAAY,EACV,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,aAAa,GACd,MAAM,oBAAoB,CAAC"}

package/dist/src/testing/index.js

@@ -1,4 +1,5 @@
 export { FakePaymentsDriver } from './fake_payments_driver.js';
 export { InMemoryBillingStore } from './in_memory_billing_store.js';
 export { MutableClock } from './mutable_clock.js';
+export { fakePayments, swapPayments, swapBillingStore, flushWebhooks, } from './fake_payments.js';
 //# sourceMappingURL=index.js.map

package/dist/src/testing/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAMpE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AASpE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,aAAa,GACd,MAAM,oBAAoB,CAAC"}

package/dist/src/types.d.ts

@@ -9,18 +9,149 @@
 export type Money = number;
 /** ISO 4217 currency code, lowercase (e.g. `'brl'`, `'usd'`). */
 export type Currency = string;
-export type BillingStatus = 'pending' | 'paid' | 'failed' | 'refunded' | 'canceled' | 'disputed';
-export type SubscriptionStatus = 'trialing' | 'active' | 'past_due' | 'incomplete' | 'canceled' | 'ended';
-export type PaymentMethodType = 'card' | 'pix' | 'boleto' | 'debit_card' | 'unknown';
+/**
+ * Where a payment stands.
+ *
+ * `authorized` is NOT `paid`: the funds are held on the customer's card and nothing has
+ * moved until a capture. Card gateways that separate the two (Razorpay, Square, Adyen,
+ * PayPal) had no name for it, so it collapsed into `pending` — which understates it — or
+ * `paid`, which grants access against money that can still evaporate.
+ */
+export type BillingStatus = 'pending' | 'authorized' | 'paid' | 'failed' | 'refunded' | 'canceled' | 'disputed';
+/**
+ * `paused` is a real state, not a flavour of `active`: the subscription exists, will bill
+ * again, and must NOT entitle the subscriber right now. Mapping it to `active` — which
+ * several gateways forced — grants access to someone who is not paying.
+ */
+export type SubscriptionStatus = 'trialing' | 'active' | 'paused' | 'past_due' | 'incomplete' | 'canceled' | 'ended';
+/** How a payment was actually paid, as reported back on a {@link Payment}. */
+export type PaymentMethodType = 'card' | 'pix' | 'boleto' | 'debit_card' | 'wallet' | 'bank_transfer' | 'bank_debit' | 'upi' | 'bnpl' | 'voucher' | 'unknown';
 /**
  * Canonical payment method names used to route charges to a provider (`config.methods`).
  * `undefined` means "let the customer choose at checkout" (gateway's `UNDEFINED`).
+ *
+ * These are CATEGORIES, not brands, and deliberately so. Enumerating every local method a
+ * gateway offers — iDEAL, Bancontact, EPS, Przelewy24, BLIK, TWINT, MB Way, Multibanco,
+ * Klarna, paysafecard, and a new one every quarter — is a union that never closes, and a
+ * union that never closes cannot make routing a typo fail at the manager, which is the only
+ * reason this type is closed at all.
+ *
+ * So route by category and name the brand where it belongs: the gateway's own field, via
+ * `metadata`. `bank_transfer` covers the push-from-your-bank methods (iDEAL, Bancontact,
+ * Multibanco, Trustly); `bank_debit` the pull-from-your-account ones (SEPA Direct Debit,
+ * ACH); `wallet` the stored-balance and device wallets (PayPal, Apple Pay, Google Pay);
+ * `bnpl` the buy-now-pay-later ones; `upi` is named outright because in India it is the
+ * default way people pay, not a local alternative.
  */
-export type PaymentMethodName = 'pix' | 'credit_card' | 'debit_card' | 'boleto' | 'undefined';
+export declare const PAYMENT_METHOD_NAMES: readonly ["pix", "credit_card", "debit_card", "boleto", "wallet", "bank_transfer", "bank_debit", "upi", "bnpl", "voucher", "undefined"];
+/**
+ * The union, derived from the list above rather than written twice.
+ *
+ * The list exists because the routing error message used to spell the members out by hand,
+ * and said "pix, credit_card, debit_card, boleto, undefined" long after six more were added
+ * — so a reader routing `wallet` was told, by the library, that it was not a known method.
+ */
+export type PaymentMethodName = (typeof PAYMENT_METHOD_NAMES)[number];
 export interface MoneyAmount {
     amount: Money;
     currency: Currency;
 }
+/**
+ * Where a dispute stands. A chargeback is the only thing in this library that takes money
+ * back AFTER it settled, and the window to answer is measured in days.
+ *
+ * `warning` is not a dispute yet — it is the pre-chargeback alert the card networks relay
+ * (Stripe's Early Fraud Warning, Adyen's `NOTIFICATION_OF_FRAUD`), where refunding inside
+ * the window stops the chargeback from ever being filed. That matters beyond the one sale:
+ * a chargeback counts against the ratio that puts a merchant into a card network's
+ * monitoring programme, so it can be worth refunding a dispute you would have won.
+ */
+export type DisputeStatus = 'warning' | 'open' | 'under_review' | 'won' | 'lost' | 'canceled' | 'expired';
+/** A chargeback or pre-chargeback alert, normalized across gateways. */
+export interface Dispute {
+    /** The gateway's id for the dispute itself — NOT the payment's. */
+    id: string;
+    provider: string;
+    /** The disputed payment's gateway id. */
+    paymentGatewayId: string;
+    status: DisputeStatus;
+    /**
+     * How much is being disputed, in the currency's smallest unit. Not always the whole
+     * payment: a partial chargeback is normal.
+     */
+    amount?: MoneyAmount;
+    /** The gateway's own reason code, verbatim — the vocabulary is per-network. */
+    reason?: string;
+    /**
+     * When evidence must be submitted by. The single most operationally important field
+     * here: past it, the dispute is lost by default and nothing can be done.
+     */
+    evidenceDueBy?: string;
+    /** Whether this gateway will still accept evidence — most accept it ONCE. */
+    canSubmitEvidence?: boolean;
+    createdAt?: string;
+    payload: Record<string, unknown>;
+}
+/**
+ * Evidence for a representment.
+ *
+ * Every field is optional because no gateway wants all of them and no app has all of them,
+ * but the shape is deliberately concrete rather than a bag: a driver has to map onto the
+ * gateway's own field names, and it cannot map what it cannot recognize.
+ */
+export interface DisputeEvidence {
+    /** Free-text explanation. Most gateways weigh this heavily. */
+    explanation?: string;
+    shippingCarrier?: string;
+    shippingTrackingNumber?: string;
+    shippingDate?: string;
+    serviceDate?: string;
+    /** When the customer accepted the terms. The terms themselves are a {@link DisputeDocument}. */
+    termsAcceptedAt?: string;
+    customerName?: string;
+    customerEmail?: string;
+    customerIpAddress?: string;
+    /**
+     * Prior charges to the same customer that were never disputed — the strongest signal the
+     * card networks accept, and the reason this is a list of transactions rather than a count.
+     * Visa's Compelling Evidence 3.0 wants the charges themselves, each with the account, device
+     * and IP it was made from; a number is not evidence of anything.
+     */
+    priorUndisputedPayments?: PriorUndisputedPayment[];
+    /** Documents already uploaded to the gateway, each addressed by what it proves. */
+    documents?: DisputeDocument[];
+    /** Anything gateway-specific the shape above has no name for. */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * What a piece of evidence proves, which is what every gateway files it by.
+ *
+ * Not a free-form label: a bare list of upload ids cannot be submitted anywhere, because
+ * the gateway needs to know which id is the receipt and which is the shipping proof. Stripe
+ * has nine separate file fields, Adyen has a `defenseDocumentTypeCode`, and neither can be
+ * reached with "here are some files".
+ */
+export type DisputeDocumentKind = 'receipt' | 'invoice' | 'customer_communication' | 'customer_signature' | 'shipping' | 'service' | 'refund_policy' | 'cancellation_policy' | 'terms' | 'duplicate_charge' | 'other';
+/**
+ * A document already uploaded to the gateway, by its own file id.
+ *
+ * A file id, never a URL. The banks reviewing a dispute do not follow links, and no gateway
+ * in this package accepts one — the evidence has to be bytes the gateway already holds.
+ */
+export interface DisputeDocument {
+    kind: DisputeDocumentKind;
+    /** The gateway's own id for the uploaded file. */
+    id: string;
+}
+/** A prior charge to the same customer that was never disputed. */
+export interface PriorUndisputedPayment {
+    /** The gateway's id for that charge. */
+    paymentGatewayId: string;
+    /** The account the customer was signed into, if the gateway asks for one. */
+    customerAccountId?: string;
+    customerIpAddress?: string;
+    customerDeviceId?: string;
+}
 /** A customer as seen by the gateway. */
 export interface Customer {
     id: string;
@@ -46,8 +177,26 @@ export interface Payment {
     payload: Record<string, unknown>;
     createdAt: string;
     paidAt?: string;
-    /** Pix QR code / copy-paste code when the gateway provides one. */
+    /**
+     * Base64-encoded PNG of the Pix QR code, when the gateway returns one.
+     * Render it directly (`data:image/png;base64,${pixQrCodeImage}`) — it is an image,
+     * not something the customer can copy.
+     */
+    pixQrCodeImage?: string;
+    /**
+     * The Pix BR Code (EMV payload) — the plain-text string behind the QR code, and the
+     * one the customer copies and pastes into their bank app ("Pix copia e cola").
+     */
+    pixCode?: string;
+    /**
+     * @deprecated Misleading name — it holds the QR **image**, not a code. Use {@link Payment.pixQrCodeImage}.
+     * Still populated with the same value for backward compatibility.
+     */
     pixQrCode?: string;
+    /**
+     * @deprecated Portuguese name for the BR Code payload. Use {@link Payment.pixCode}.
+     * Still populated with the same value for backward compatibility.
+     */
     pixCopiaECola?: string;
     /** URL to a hosted checkout/charge page when the gateway provides one. */
     hostedUrl?: string;
@@ -70,6 +219,13 @@ export interface CheckoutSession {
     provider: string;
     /** URL to redirect the customer to (hosted checkout). */
     url: string;
+    /**
+     * Pix BR Code (EMV payload) for a checkout the gateway settles over Pix — the
+     * string the payer copies. Same field as {@link Payment.pixCode}.
+     */
+    pixCode?: string;
+    /** @deprecated Renamed to {@link CheckoutSession.pixCode}. Still populated. */
+    pixCopiaECola?: string;
     status: 'open' | 'complete' | 'expired';
     amount?: MoneyAmount;
     /** The subscription created by this checkout, when it was a subscription checkout. */

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

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

package/dist/src/types.js

@@ -5,5 +5,34 @@
  * (Stripe, AbacatePay, Asaas, Woovi) maps its own API response onto these types, so the
  * billing layer and application code never touch gateway-specific payloads.
  */
-export {};
+/**
+ * Canonical payment method names used to route charges to a provider (`config.methods`).
+ * `undefined` means "let the customer choose at checkout" (gateway's `UNDEFINED`).
+ *
+ * These are CATEGORIES, not brands, and deliberately so. Enumerating every local method a
+ * gateway offers — iDEAL, Bancontact, EPS, Przelewy24, BLIK, TWINT, MB Way, Multibanco,
+ * Klarna, paysafecard, and a new one every quarter — is a union that never closes, and a
+ * union that never closes cannot make routing a typo fail at the manager, which is the only
+ * reason this type is closed at all.
+ *
+ * So route by category and name the brand where it belongs: the gateway's own field, via
+ * `metadata`. `bank_transfer` covers the push-from-your-bank methods (iDEAL, Bancontact,
+ * Multibanco, Trustly); `bank_debit` the pull-from-your-account ones (SEPA Direct Debit,
+ * ACH); `wallet` the stored-balance and device wallets (PayPal, Apple Pay, Google Pay);
+ * `bnpl` the buy-now-pay-later ones; `upi` is named outright because in India it is the
+ * default way people pay, not a local alternative.
+ */
+export const PAYMENT_METHOD_NAMES = [
+    'pix',
+    'credit_card',
+    'debit_card',
+    'boleto',
+    'wallet',
+    'bank_transfer',
+    'bank_debit',
+    'upi',
+    'bnpl',
+    'voucher',
+    'undefined',
+];
 //# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqDH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,KAAK;IACL,aAAa;IACb,YAAY;IACZ,QAAQ;IACR,QAAQ;IACR,eAAe;IACf,YAAY;IACZ,KAAK;IACL,MAAM;IACN,SAAS;IACT,WAAW;CACH,CAAC"}

package/dist/src/webhook_handlers.d.ts

@@ -1,5 +1,67 @@
+import type { DisputeWebhookData, PaymentWebhookData, SubscriptionWebhookData, WebhookEventType } from './billing/webhook_events.js';
 import type { WebhookHandler } from './billing/webhook_processor.js';
 import type { WebhookEvent } from './types.js';
+/**
+ * Which normalized payload each canonical event type carries.
+ *
+ * The map exists because `WebhookEvent<T = unknown>` made every handler open with a cast —
+ * `const data = event.data as PaymentWebhookData` — and a cast is a claim nothing checks.
+ * `payment.disputed` carries a {@link DisputeWebhookData}, not a payment payload, so the
+ * copy-pasted cast was simply WRONG on that one handler: it read `amount`/`currency` as
+ * required off a shape where a Stripe early fraud warning has neither.
+ *
+ * Pair a type with its payload here once and {@link defineWebhookHandler} infers it, so the
+ * wrong pairing is a compile error instead of a runtime `undefined`.
+ */
+export interface WebhookEventDataMap {
+    'payment.succeeded': PaymentWebhookData;
+    'payment.failed': PaymentWebhookData;
+    'payment.refunded': PaymentWebhookData;
+    'payment.updated': PaymentWebhookData;
+    'payment.disputed': DisputeWebhookData;
+    'payment.dispute_warning': DisputeWebhookData;
+    'payment.dispute_closed': DisputeWebhookData;
+    'subscription.created': SubscriptionWebhookData;
+    'subscription.updated': SubscriptionWebhookData;
+    'subscription.canceled': SubscriptionWebhookData;
+}
+/**
+ * The payload a handler for `T` receives. Canonical types resolve through
+ * {@link WebhookEventDataMap}; anything else is a driver passthrough (drivers lowercase the
+ * gateway events they cannot map) whose shape this library cannot know, so it stays
+ * `unknown` — which is honest, and forces a narrowing the app can see.
+ */
+export type WebhookEventDataFor<T extends string> = T extends WebhookEventType ? WebhookEventDataMap[T] : unknown;
+/** A {@link WebhookEvent} narrowed to one event type, payload included. */
+export type WebhookEventFor<T extends string> = WebhookEvent<WebhookEventDataFor<T>> & {
+    type: T;
+};
+/** A handler that knows which event it is for — and therefore what `event.data` is. */
+export type TypedWebhookHandler<T extends string> = (event: WebhookEventFor<T>) => void | Promise<void>;
+/**
+ * What {@link defineWebhookHandler} returns: callable as a plain {@link WebhookHandler} (so
+ * it drops straight into `billing.handlers`) AND carrying `type`/`handle` (so it is a valid
+ * default export for the `app/payment_handlers/` convention). One value, both wiring styles.
+ */
+export interface WebhookHandlerDefinition<T extends string = string> {
+    (event: WebhookEvent): void | Promise<void>;
+    readonly type: T;
+    readonly handle: WebhookHandler;
+}
+/**
+ * Declare a webhook handler for ONE event type, with `event.data` inferred from the type.
+ *
+ * ```ts
+ * export default defineWebhookHandler('payment.disputed', async (event) => {
+ *   event.data.actionableUntil // DisputeWebhookData — no cast
+ *   event.data.paidAt          // compile error: that is a payment payload
+ * })
+ * ```
+ *
+ * A passthrough type the driver did not map is accepted (it is a real thing a gateway
+ * sends), and its `data` is `unknown` because nothing normalized it.
+ */
+export declare function defineWebhookHandler<T extends WebhookEventType | (string & {})>(type: T, handle: TypedWebhookHandler<T>): WebhookHandlerDefinition<T>;
 /**
  * A webhook-handler service constructor: the lib resolves it from the Adonis container
  * (DI works) and calls `handle(event)` for each event of the registered type. A class
@@ -34,6 +96,13 @@ export declare function resolveWebhookHandler(entry: WebhookHandler | WebhookHan
 export interface DiscoveredWebhookHandler {
     type: string;
     entry: WebhookHandler | WebhookHandlerService;
+    /**
+     * Where it came from — the module path for a scan, the barrel key for a build-time
+     * barrel, `config.billing.handlers` for a configured one. Only ever used in messages, and
+     * that is the point: "two handlers claim payment.succeeded" is not actionable without the
+     * two file names.
+     */
+    source?: string;
 }
 /** Shape each file in the conventions folder must default-export. */
 export interface WebhookHandlerModule {
@@ -41,14 +110,39 @@ export interface WebhookHandlerModule {
      * Normalized event type this handler listens to (e.g. `'payment.succeeded'`). A service
      * class declares it as `static eventType` instead.
      */
-    type?: string;
+    type?: WebhookEventType | (string & {});
     /** Event-type static on a service class form. */
-    eventType?: string;
+    eventType?: WebhookEventType | (string & {});
     /** The handler function (object form). */
     handle?: WebhookHandler;
 }
 /** Normalize a module's default export into a {@link DiscoveredWebhookHandler}, or null. */
 export declare function normalizeWebhookHandlerModule(mod: unknown): DiscoveredWebhookHandler | null;
+/**
+ * One handler registration, as the boot-time check sees it: which type it claims and where
+ * it came from.
+ */
+export interface WebhookHandlerRegistration {
+    type: string;
+    source: string;
+}
+/**
+ * Refuse, at boot, a handler registered for an event type nothing will ever deliver.
+ *
+ * The failure this closes is silent end to end: `normalizeWebhookHandlerModule` accepted any
+ * string, the provider did `handlers[type] = ...`, and the processor looked up
+ * `#handlers[event.type]` and skipped a miss. So `'payment.suceeded'` registered a handler
+ * nothing called, the ledger still marked the delivery `processed`, and the grant simply
+ * never happened — with a 200 to the gateway promising it never has to send that event
+ * again.
+ *
+ * Two registrations of the SAME type are refused for the same reason: `handlers[type] = ...`
+ * overwrites, so the second file silently replaced the first and one of the two handlers
+ * never ran again.
+ */
+export declare function assertWebhookHandlerTypes(registrations: readonly WebhookHandlerRegistration[], options?: {
+    passthroughEvents?: readonly string[];
+}): void;
 /** The build-time barrel the Assembler `init` hook generates — a map of key → lazy import. */
 export type WebhookHandlersBarrel = Record<string, () => Promise<Record<string, unknown>>>;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"webhook_handlers.d.ts","sourceRoot":"","sources":["../../src/webhook_handlers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG;QAAE,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;CAC/E;AAED,sDAAsD;AACtD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACrC;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB,CAKtF;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,cAAc,GAAG,qBAAqB,EAC7C,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,cAAc,CAAC,CAMzB;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,cAAc,GAAG,qBAAqB,CAAC;CAC/C;AAED,qEAAqE;AACrE,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED,4FAA4F;AAC5F,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,OAAO,GAAG,wBAAwB,GAAG,IAAI,CAa3F;AAED,8FAA8F;AAC9F,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAE3F;;;;GAIG;AACH,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAcrC;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,CAY9E;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAyB9F"}
+{"version":3,"file":"webhook_handlers.d.ts","sourceRoot":"","sources":["../../src/webhook_handlers.ts"],"names":[],"mappings":"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"}

package/dist/src/webhook_handlers.js

@@ -1,6 +1,30 @@
 import { readdir } from 'node:fs/promises';
 import { extname, join } from 'node:path';
 import { pathToFileURL } from 'node:url';
+import { WEBHOOK_EVENT_TYPES } from './billing/webhook_events.js';
+/**
+ * Declare a webhook handler for ONE event type, with `event.data` inferred from the type.
+ *
+ * ```ts
+ * export default defineWebhookHandler('payment.disputed', async (event) => {
+ *   event.data.actionableUntil // DisputeWebhookData — no cast
+ *   event.data.paidAt          // compile error: that is a payment payload
+ * })
+ * ```
+ *
+ * A passthrough type the driver did not map is accepted (it is a real thing a gateway
+ * sends), and its `data` is `unknown` because nothing normalized it.
+ */
+export function defineWebhookHandler(type, handle) {
+    // The ONE cast, here, instead of one in every application handler. It is sound in exactly
+    // the way the app-side cast was not: the type is checked against the same map the payload
+    // came from, and validated at boot by `assertWebhookHandlerTypes`.
+    const wrapped = (event) => handle(event);
+    return Object.assign(wrapped, {
+        type,
+        handle: wrapped,
+    });
+}
 /**
  * Detect a {@link WebhookHandlerService} (a class with a `handle` method) vs a plain
  * handler function. Arrow functions have no prototype; named functions have one without
@@ -31,17 +55,74 @@ export function normalizeWebhookHandlerModule(mod) {
     const type = candidate.type ?? candidate.eventType;
     if (typeof type !== 'string')
         return null;
-    if (typeof mod === 'function') {
-        // Service class form: `static eventType` + instance `handle`.
-        if (isWebhookHandlerService(mod))
-            return { type, entry: mod };
-        return null;
-    }
-    // Object form: `{ type, handle }`.
+    // Service class form: `static eventType` + instance `handle` (on the prototype, so the
+    // class itself has no own `handle` and never reaches the branch below).
+    if (typeof mod === 'function' && isWebhookHandlerService(mod))
+        return { type, entry: mod };
+    // Object form `{ type, handle }` — and the function form {@link defineWebhookHandler}
+    // returns, which is a callable carrying the same two members.
     if (typeof candidate.handle !== 'function')
         return null;
     return { type, entry: candidate.handle };
 }
+/**
+ * A type that LOOKS canonical: same namespace as the library's own types, so a typo lands
+ * here rather than being waved through as a gateway passthrough.
+ *
+ * This is the whole honest rule. A driver that cannot map a gateway event passes it through
+ * lowercased — Asaas turns `PAYMENT_ANTICIPATED` into `payment_anticipated`, Adyen turns
+ * `REPORT_AVAILABLE` into `report_available` — and a library cannot enumerate every event
+ * eighteen gateways can send. What it CAN say is that `payment.` and `subscription.`
+ * followed by a dot are ITS namespace: every member of {@link WEBHOOK_EVENT_TYPES} is in it,
+ * a passthrough of an unmapped event is not (`payment_anticipated` has no dot), and
+ * `payment.suceeded` is a misspelling of something the library owns.
+ */
+function isCanonicalNamespace(type) {
+    return /^(payment|subscription)\.[a-z_]+$/.test(type);
+}
+/**
+ * Refuse, at boot, a handler registered for an event type nothing will ever deliver.
+ *
+ * The failure this closes is silent end to end: `normalizeWebhookHandlerModule` accepted any
+ * string, the provider did `handlers[type] = ...`, and the processor looked up
+ * `#handlers[event.type]` and skipped a miss. So `'payment.suceeded'` registered a handler
+ * nothing called, the ledger still marked the delivery `processed`, and the grant simply
+ * never happened — with a 200 to the gateway promising it never has to send that event
+ * again.
+ *
+ * Two registrations of the SAME type are refused for the same reason: `handlers[type] = ...`
+ * overwrites, so the second file silently replaced the first and one of the two handlers
+ * never ran again.
+ */
+export function assertWebhookHandlerTypes(registrations, options = {}) {
+    const allowed = new Set(options.passthroughEvents ?? []);
+    const seen = new Map();
+    for (const { type, source } of registrations) {
+        const known = WEBHOOK_EVENT_TYPES.includes(type);
+        if (!known && !allowed.has(type) && isCanonicalNamespace(type)) {
+            throw new Error([
+                `[payments] Webhook handler (${source}) is registered for "${type}", which is not a`,
+                'normalized event type — nothing will ever call it, and the delivery will still be',
+                `recorded as processed. Normalized types: ${WEBHOOK_EVENT_TYPES.join(', ')}.`,
+                'A type in the `payment.*`/`subscription.*` namespace must be one of those, because',
+                "that namespace is the library's own. A gateway type the driver could not map arrives",
+                'lowercased as the gateway spells it (Asaas `PAYMENT_ANTICIPATED` →',
+                '"payment_anticipated"), which is accepted as-is; if your gateway really does spell one',
+                'with a dot in this namespace, list it in `billing.passthroughEvents`.',
+            ].join(' '));
+        }
+        const previous = seen.get(type);
+        if (previous !== undefined) {
+            throw new Error([
+                `[payments] Two webhook handlers claim "${type}": ${previous} and ${source}.`,
+                'Registration is a map keyed by event type, so the second silently replaced the first',
+                'and one of them would never run. Keep one handler per type (call the other from it)',
+                'or give them different types.',
+            ].join(' '));
+        }
+        seen.set(type, source);
+    }
+}
 /**
  * Load the generated barrel (`.adonisjs/payments/webhook_handlers.js`) — the build-time
  * equivalent of a directory scan, with no runtime `readdir`. Each module's default export
@@ -50,7 +131,7 @@ export function normalizeWebhookHandlerModule(mod) {
 export async function loadWebhookHandlersFromBarrel(barrel) {
     const found = [];
     const seen = new Set();
-    for (const load of Object.values(barrel)) {
+    for (const [key, load] of Object.entries(barrel)) {
         const mod = await load();
         for (const exported of Object.values(mod)) {
             if (seen.has(exported))
@@ -59,7 +140,7 @@ export async function loadWebhookHandlersFromBarrel(barrel) {
             if (!normalized)
                 continue;
             seen.add(exported);
-            found.push(normalized);
+            found.push({ ...normalized, source: key });
         }
     }
     return found;
@@ -121,7 +202,7 @@ export async function discoverWebhookHandlers(dir) {
         if (seen.has(normalized.entry))
             continue;
         seen.add(normalized.entry);
-        found.push(normalized);
+        found.push({ ...normalized, source: join(dir, entry) });
     }
     return found;
 }

package/dist/src/webhook_handlers.js.map

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