@adonis-agora/payments 0.2.0

package/dist/src/billing/webhook_dispatcher.d.ts

@@ -0,0 +1,79 @@
+import type { WebhookEvent } from '../types.js';
+import type { WebhookProcessor } from './webhook_processor.js';
+/**
+ * Strategy used to run a webhook event through the {@link WebhookProcessor}.
+ *
+ * - `durable` — the event is dispatched as a fire-and-forget durable workflow run
+ *   (`@adonis-agora/durable`), so processing survives crashes and retries deterministically.
+ * - `queue` — the event is dispatched as an `@adonisjs/queue` job (`queueDispatch`).
+ * - `in-process` — the event runs inline (awaited); on failure it is retried with
+ *   exponential backoff in the background.
+ * - `auto` — uses `durable` when its provider is registered, else `queue` when the queue
+ *   provider is, else `in-process`.
+ */
+export type WebhookDispatchMode = 'durable' | 'queue' | 'in-process' | 'auto';
+export interface WebhookDispatcherOptions {
+    processor: WebhookProcessor;
+    /**
+     * How webhooks are processed. `'auto'` (default) lazily resolves
+     * `@adonis-agora/durable` and uses it when installed AND available (the app has the
+     * durable provider registered), else `@adonisjs/queue` when available, else
+     * `in-process`. `'durable'`/`'queue'` require their backend (throw when missing).
+     * `'in-process'` never touches either.
+     */
+    mode?: WebhookDispatchMode;
+    /**
+     * In-process retry settings (exponential backoff). Ignored when durable/queue processes
+     * the event, which rely on their own retries.
+     */
+    retries?: {
+        /** Max attempts including the first. Default 5. */
+        max?: number;
+        /** Base delay in ms. Default 500. */
+        baseDelayMs?: number;
+        /** Max delay in ms. Default 30_000. */
+        maxDelayMs?: number;
+    };
+    /**
+     * Optional availability check used in `auto` mode: resolves to `true` only when durable
+     * is installed AND its engine is resolvable in the app (provider registered). Defaults
+     * to "installed" only. The provider injects the real check.
+     */
+    durableAvailable?: () => Promise<boolean>;
+    /**
+     * Dispatch a webhook event as an `@adonisjs/queue` job. The provider wires this (it owns
+     * the job class, its container binding and the queue-manager registration). Absent =
+     * queue mode is unavailable.
+     */
+    queueDispatch?: (event: WebhookEvent) => Promise<{
+        jobId?: string;
+    }>;
+}
+/** The minimal durable surface we use: a workflow class with a static `dispatch`. */
+export interface DurableWorkflowLike {
+    dispatch(input: {
+        event: WebhookEvent;
+    }): Promise<{
+        runId: string;
+    }>;
+}
+/**
+ * Runs webhook events through the {@link WebhookProcessor}. In `auto` mode (the default)
+ * it tries to import `@adonis-agora/durable` lazily — only when the app has it installed
+ * do webhooks run as durable workflows; otherwise they fall back to an in-process
+ * dispatcher with exponential-backoff retries.
+ */
+export declare class WebhookDispatcher {
+    #private;
+    constructor(options: WebhookDispatcherOptions);
+    /**
+     * Dispatch a webhook event for processing. Resolves once the event is accepted (durable)
+     * or fully processed (in-process).
+     */
+    dispatch(event: WebhookEvent): Promise<{
+        runId?: string;
+    }>;
+    /** Whether durable-backed processing is active. */
+    get mode(): WebhookDispatchMode;
+}
+//# sourceMappingURL=webhook_dispatcher.d.ts.map

package/dist/src/billing/webhook_dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook_dispatcher.d.ts","sourceRoot":"","sources":["../../../src/billing/webhook_dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;;;;;;;;;GAUG;AACH,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,OAAO,GAAG,YAAY,GAAG,MAAM,CAAC;AAE9E,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,gBAAgB,CAAC;IAC5B;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B;;;OAGG;IACH,OAAO,CAAC,EAAE;QACR,mDAAmD;QACnD,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,qCAAqC;QACrC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,uCAAuC;QACvC,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtE;AAED,qFAAqF;AACrF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,YAAY,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtE;AAED;;;;;GAKG;AACH,qBAAa,iBAAiB;;gBAUhB,OAAO,EAAE,wBAAwB;IAS7C;;;OAGG;IACG,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAUhE,mDAAmD;IACnD,IAAI,IAAI,IAAI,mBAAmB,CAE9B;CAkFF"}

package/dist/src/billing/webhook_dispatcher.js

@@ -0,0 +1,125 @@
+/**
+ * Runs webhook events through the {@link WebhookProcessor}. In `auto` mode (the default)
+ * it tries to import `@adonis-agora/durable` lazily — only when the app has it installed
+ * do webhooks run as durable workflows; otherwise they fall back to an in-process
+ * dispatcher with exponential-backoff retries.
+ */
+export class WebhookDispatcher {
+    #processor;
+    #mode;
+    #maxAttempts;
+    #baseDelayMs;
+    #maxDelayMs;
+    #workflow;
+    #durableChecked = false;
+    #durableAvailable;
+    constructor(options) {
+        this.#processor = options.processor;
+        this.#mode = options.mode ?? 'auto';
+        this.#maxAttempts = options.retries?.max ?? 5;
+        this.#baseDelayMs = options.retries?.baseDelayMs ?? 500;
+        this.#maxDelayMs = options.retries?.maxDelayMs ?? 30_000;
+        this.#durableAvailable = options.durableAvailable;
+    }
+    /**
+     * Dispatch a webhook event for processing. Resolves once the event is accepted (durable)
+     * or fully processed (in-process).
+     */
+    async dispatch(event) {
+        if (await this.#useDurable()) {
+            const workflow = await this.#resolveDurable();
+            const { runId } = await workflow.dispatch({ event });
+            return { runId };
+        }
+        return this.#processWithRetry(event);
+    }
+    /** Whether durable-backed processing is active. */
+    get mode() {
+        return this.#mode;
+    }
+    /**
+     * Decide whether durable handles this event. `auto` performs the lazy import once and
+     * caches the answer; `durable` forces it (throwing when missing); `in-process` never.
+     */
+    async #useDurable() {
+        if (this.#mode === 'in-process')
+            return false;
+        if (this.#mode === 'durable')
+            return true;
+        // 'auto'
+        if (this.#durableChecked)
+            return this.#workflow !== undefined;
+        this.#durableChecked = true;
+        try {
+            if (this.#durableAvailable && !(await this.#durableAvailable())) {
+                this.#workflow = undefined;
+                return false;
+            }
+            await import('@adonis-agora/durable');
+            this.#workflow = await this.#buildWorkflow();
+            return true;
+        }
+        catch {
+            this.#workflow = undefined;
+            return false;
+        }
+    }
+    /**
+     * Lazily build a durable workflow class that runs the event through the shared
+     * processor hook. Only called when durable is actually installed.
+     */
+    async #buildWorkflow() {
+        const durable = await import('@adonis-agora/durable');
+        const { BaseWorkflow } = durable;
+        const processor = this.#processor;
+        // The workflow's `run(ctx, input)` is the durable body; `dispatch` (static, inherited)
+        // enqueues it fire-and-forget. Input is the webhook event.
+        const workflow = class PaymentsWebhookWorkflow extends BaseWorkflow {
+            async run(_ctx, input) {
+                await processor.process(input.event);
+            }
+        };
+        return workflow;
+    }
+    async #resolveDurable() {
+        const workflow = this.#workflow ?? (await this.#buildWorkflow());
+        if (!workflow) {
+            throw new Error('[payments] billing.durable is set to true/auto but @adonis-agora/durable is not installed. ' +
+                'Install it (`node ace add @adonis-agora/durable`) or set billing.durable to false.');
+        }
+        return workflow;
+    }
+    /**
+     * In-process fallback: run through the processor, retrying with exponential backoff on
+     * failure (up to `#maxAttempts`). Retries run in the background — the first attempt is
+     * awaited so the webhook endpoint can respond.
+     */
+    async #processWithRetry(event) {
+        try {
+            await this.#processor.process(event);
+            return {};
+        }
+        catch (error) {
+            // Retry in the background (don't block the webhook response). The processor itself
+            // publishes `webhook.failed` on the diagnostics channel.
+            void this.#retry(event, 2);
+            return {};
+        }
+    }
+    async #retry(event, attempt) {
+        if (attempt > this.#maxAttempts)
+            return;
+        const delay = Math.min(this.#baseDelayMs * 2 ** (attempt - 2), this.#maxDelayMs);
+        await sleep(delay);
+        try {
+            await this.#processor.process(event);
+        }
+        catch {
+            await this.#retry(event, attempt + 1);
+        }
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=webhook_dispatcher.js.map

package/dist/src/billing/webhook_dispatcher.js.map

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

package/dist/src/billing/webhook_events.d.ts

@@ -0,0 +1,49 @@
+import type { WebhookEvent } from '../types.js';
+/**
+ * The canonical normalized webhook event types. Every driver's `#mapWebhookType` maps
+ * its gateway events onto these, and the `WebhookProcessor`'s built-in sync switches on
+ * them. Shared constant so a typo in one driver can't silently degrade to the no-op
+ * branch.
+ */
+export declare const WEBHOOK_EVENT_TYPES: readonly ["payment.succeeded", "payment.failed", "payment.refunded", "payment.updated", "subscription.created", "subscription.updated", "subscription.canceled"];
+export type WebhookEventType = (typeof WEBHOOK_EVENT_TYPES)[number];
+/** Shape the built-in sync handlers expect from a payment event's `data`. */
+export interface PaymentWebhookData {
+    gatewayId: string;
+    amount: number;
+    currency: string;
+    customerId?: string;
+    subscriptionId?: string;
+    /**
+     * The `externalReference` the app set on the charge/subscription, echoed back by the
+     * gateway. First-class so app handlers route payments to their local records without
+     * digging into `event.raw` — the reason {@link ChargeInput.externalReference} exists.
+     */
+    externalReference?: string;
+    /** Gateway-echoed metadata, when the gateway includes it in the webhook payload. */
+    metadata?: Record<string, unknown>;
+}
+/** Shape the built-in sync handlers expect from a subscription event's `data`. */
+export interface SubscriptionWebhookData {
+    gatewayId: string;
+    customerId: string;
+    status: string;
+    planId?: string;
+    trialEndsAt?: string;
+    endsAt?: string;
+}
+/**
+ * Guard: is this event's `data` shaped like a payment event? The drivers normalize their
+ * payloads onto this shape (see the Asaas driver's `#mapWebhookData`); the processor
+ * checks it before writing a row so a malformed event can't produce garbage rows.
+ */
+export declare function isPaymentWebhookData(data: unknown): data is PaymentWebhookData;
+/** Guard: is this event's `data` shaped like a subscription event? */
+export declare function isSubscriptionWebhookData(data: unknown): data is SubscriptionWebhookData;
+/** Assert a webhook event's type is one of the canonical types (or a passthrough). */
+export declare function isWebhookEventType(type: string): type is WebhookEventType;
+/** Narrow a {@link WebhookEvent} to one of the canonical types. */
+export declare function asWebhookEvent(event: WebhookEvent): WebhookEvent<unknown> & {
+    type: WebhookEventType;
+};
+//# sourceMappingURL=webhook_events.d.ts.map

package/dist/src/billing/webhook_events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook_events.d.ts","sourceRoot":"","sources":["../../../src/billing/webhook_events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,kKAQtB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,kFAAkF;AAClF,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,kBAAkB,CAQ9E;AAED,sEAAsE;AACtE,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,uBAAuB,CAIxF;AAED,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,gBAAgB,CAEzE;AAED,mEAAmE;AACnE,wBAAgB,cAAc,CAC5B,KAAK,EAAE,YAAY,GAClB,YAAY,CAAC,OAAO,CAAC,GAAG;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAEpD"}

package/dist/src/billing/webhook_events.js

@@ -0,0 +1,44 @@
+/**
+ * The canonical normalized webhook event types. Every driver's `#mapWebhookType` maps
+ * its gateway events onto these, and the `WebhookProcessor`'s built-in sync switches on
+ * them. Shared constant so a typo in one driver can't silently degrade to the no-op
+ * branch.
+ */
+export const WEBHOOK_EVENT_TYPES = [
+    'payment.succeeded',
+    'payment.failed',
+    'payment.refunded',
+    'payment.updated',
+    'subscription.created',
+    'subscription.updated',
+    'subscription.canceled',
+];
+/**
+ * Guard: is this event's `data` shaped like a payment event? The drivers normalize their
+ * payloads onto this shape (see the Asaas driver's `#mapWebhookData`); the processor
+ * checks it before writing a row so a malformed event can't produce garbage rows.
+ */
+export function isPaymentWebhookData(data) {
+    if (typeof data !== 'object' || data === null)
+        return false;
+    const d = data;
+    return (typeof d.gatewayId === 'string' &&
+        typeof d.amount === 'number' &&
+        typeof d.currency === 'string');
+}
+/** Guard: is this event's `data` shaped like a subscription event? */
+export function isSubscriptionWebhookData(data) {
+    if (typeof data !== 'object' || data === null)
+        return false;
+    const d = data;
+    return typeof d.gatewayId === 'string' && typeof d.customerId === 'string';
+}
+/** Assert a webhook event's type is one of the canonical types (or a passthrough). */
+export function isWebhookEventType(type) {
+    return WEBHOOK_EVENT_TYPES.includes(type);
+}
+/** Narrow a {@link WebhookEvent} to one of the canonical types. */
+export function asWebhookEvent(event) {
+    return event;
+}
+//# sourceMappingURL=webhook_events.js.map

package/dist/src/billing/webhook_events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook_events.js","sourceRoot":"","sources":["../../../src/billing/webhook_events.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,mBAAmB;IACnB,gBAAgB;IAChB,kBAAkB;IAClB,iBAAiB;IACjB,sBAAsB;IACtB,sBAAsB;IACtB,uBAAuB;CACf,CAAC;AA+BX;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAa;IAChD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC5D,MAAM,CAAC,GAAG,IAA+B,CAAC;IAC1C,OAAO,CACL,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ;QAC/B,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ;QAC5B,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAC/B,CAAC;AACJ,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,yBAAyB,CAAC,IAAa;IACrD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC5D,MAAM,CAAC,GAAG,IAA+B,CAAC;IAC1C,OAAO,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,CAAC;AAC7E,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAQ,mBAAyC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACnE,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,cAAc,CAC5B,KAAmB;IAEnB,OAAO,KAA2D,CAAC;AACrE,CAAC"}

package/dist/src/billing/webhook_processor.d.ts

@@ -0,0 +1,39 @@
+import type { PaymentsDriver } from '../driver.js';
+import type { WebhookEvent } from '../types.js';
+import type { BillingStore } from './billing_store.js';
+/**
+ * A handler for a gateway webhook event type (e.g. `'invoice.payment_succeeded'`).
+ * Receives the normalized event plus the raw gateway payload. Return normally to mark the
+ * event processed; throw to mark it failed (and trigger the dispatcher's retry).
+ */
+export type WebhookHandler = (event: WebhookEvent) => void | Promise<void>;
+export interface WebhookProcessorOptions {
+    store: BillingStore;
+    /**
+     * The driver that received the webhook — used for lookups and sync. Optional: the
+     * built-in handlers persist through the store and don't call the gateway.
+     */
+    driver?: PaymentsDriver;
+    /** Map of gateway event type → handler. Apps register their business logic here. */
+    handlers?: Record<string, WebhookHandler>;
+}
+/**
+ * Routes normalized webhook events to handlers, enforcing idempotency through the
+ * `billing_webhook_events` ledger (keyed by gateway event id), and keeps the local
+ * billing tables in sync (payments, subscriptions).
+ *
+ * Built-in handlers keep the store in sync and publish the normalized business events on
+ * the `@adonis-agora/diagnostics` channel (`agora:payments:payment.succeeded`, ...) —
+ * apps react with `onDiagnostic('payments', ...)` (or the `handlers` below). App
+ * handlers (via `handlers`) run after the built-in sync and can dispatch work.
+ */
+export declare class WebhookProcessor {
+    #private;
+    constructor(options: WebhookProcessorOptions);
+    /**
+     * Process a webhook event. Returns `false` when the event was already processed
+     * (idempotent replay). Throws when the event handler throws.
+     */
+    process(event: WebhookEvent): Promise<boolean>;
+}
+//# sourceMappingURL=webhook_processor.d.ts.map

package/dist/src/billing/webhook_processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook_processor.d.ts","sourceRoot":"","sources":["../../../src/billing/webhook_processor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE3E,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,YAAY,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC3C;AAED;;;;;;;;;GASG;AACH,qBAAa,gBAAgB;;gBAKf,OAAO,EAAE,uBAAuB;IAM5C;;;OAGG;IACG,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;CA6LrD"}

package/dist/src/billing/webhook_processor.js

@@ -0,0 +1,209 @@
+import { publishPayments } from '../diagnostics.js';
+import { isPaymentWebhookData, isSubscriptionWebhookData } from './webhook_events.js';
+/**
+ * Routes normalized webhook events to handlers, enforcing idempotency through the
+ * `billing_webhook_events` ledger (keyed by gateway event id), and keeps the local
+ * billing tables in sync (payments, subscriptions).
+ *
+ * Built-in handlers keep the store in sync and publish the normalized business events on
+ * the `@adonis-agora/diagnostics` channel (`agora:payments:payment.succeeded`, ...) —
+ * apps react with `onDiagnostic('payments', ...)` (or the `handlers` below). App
+ * handlers (via `handlers`) run after the built-in sync and can dispatch work.
+ */
+export class WebhookProcessor {
+    #store;
+    #driver;
+    #handlers;
+    constructor(options) {
+        this.#store = options.store;
+        this.#driver = options.driver;
+        this.#handlers = options.handlers ?? {};
+    }
+    /**
+     * Process a webhook event. Returns `false` when the event was already processed
+     * (idempotent replay). Throws when the event handler throws.
+     */
+    async process(event) {
+        const ledger = await this.#store.recordWebhookEvent({
+            gatewayEventId: event.id,
+            provider: event.provider,
+            type: event.type,
+            payload: event.raw,
+        });
+        // Already seen → idempotent replay, skip.
+        if (ledger === null)
+            return false;
+        publishPayments('webhook.received', {
+            id: event.id,
+            provider: event.provider,
+            type: event.type,
+        });
+        try {
+            await this.#runBuiltIn(event);
+            const handler = this.#handlers[event.type];
+            if (handler)
+                await handler(event);
+            await this.#store.markWebhookProcessed(ledger.id);
+            publishPayments('webhook.processed', {
+                id: event.id,
+                provider: event.provider,
+                type: event.type,
+            });
+            return true;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            await this.#store.markWebhookFailed(ledger.id, message);
+            publishPayments('webhook.failed', {
+                id: event.id,
+                provider: event.provider,
+                type: event.type,
+                error: message,
+            });
+            throw error;
+        }
+    }
+    /** Built-in sync handlers, keyed by the normalized event type (shared constants). */
+    #runBuiltIn(event) {
+        switch (event.type) {
+            case 'payment.succeeded':
+                return this.#onPaymentSucceeded(event);
+            case 'payment.failed':
+                return this.#onPaymentFailed(event);
+            case 'payment.refunded':
+                return this.#onPaymentRefunded(event);
+            case 'subscription.created':
+            case 'subscription.updated':
+                return this.#onSubscriptionChanged(event);
+            case 'subscription.canceled':
+                return this.#onSubscriptionCanceled(event);
+            default:
+                return Promise.resolve();
+        }
+    }
+    async #onPaymentSucceeded(event) {
+        if (!isPaymentWebhookData(event.data)) {
+            throw new Error(`[payments] Malformed payment.succeeded payload for event ${event.id}.`);
+        }
+        const { gatewayId, amount, currency, customerId, subscriptionId } = event.data;
+        await this.#store.savePayment({
+            gatewayId,
+            provider: event.provider,
+            status: 'paid',
+            amount,
+            currency,
+            ...(customerId !== undefined ? { customerId } : {}),
+            ...(subscriptionId !== undefined ? { subscriptionId } : {}),
+            paidAt: new Date(),
+            payload: event.raw,
+        });
+        publishPayments('payment.succeeded', {
+            gatewayId,
+            provider: event.provider,
+            amount,
+            currency,
+            ...(event.data.externalReference !== undefined
+                ? { externalReference: event.data.externalReference }
+                : {}),
+        });
+    }
+    async #onPaymentFailed(event) {
+        if (!isPaymentWebhookData(event.data)) {
+            throw new Error(`[payments] Malformed payment.failed payload for event ${event.id}.`);
+        }
+        const { gatewayId, amount, currency, customerId, subscriptionId } = event.data;
+        await this.#store.savePayment({
+            gatewayId,
+            provider: event.provider,
+            status: 'failed',
+            amount,
+            currency,
+            ...(customerId !== undefined ? { customerId } : {}),
+            ...(subscriptionId !== undefined ? { subscriptionId } : {}),
+            payload: event.raw,
+        });
+        publishPayments('payment.failed', {
+            gatewayId,
+            provider: event.provider,
+            amount,
+            currency,
+            ...(event.data.externalReference !== undefined
+                ? { externalReference: event.data.externalReference }
+                : {}),
+        });
+    }
+    async #onPaymentRefunded(event) {
+        if (!isPaymentWebhookData(event.data)) {
+            throw new Error(`[payments] Malformed payment.refunded payload for event ${event.id}.`);
+        }
+        const { gatewayId, amount, currency } = event.data;
+        const existing = await this.#store.findPaymentByGatewayId(gatewayId);
+        if (existing) {
+            await this.#store.savePayment({
+                gatewayId,
+                provider: event.provider,
+                status: 'refunded',
+                amount,
+                currency,
+                ...(existing.customerId !== undefined ? { customerId: existing.customerId } : {}),
+                ...(existing.subscriptionId !== undefined
+                    ? { subscriptionId: existing.subscriptionId }
+                    : {}),
+                payload: event.raw,
+            });
+        }
+        publishPayments('payment.refunded', {
+            gatewayId,
+            provider: event.provider,
+            amount,
+            currency,
+        });
+    }
+    async #onSubscriptionChanged(event) {
+        if (!isSubscriptionWebhookData(event.data)) {
+            throw new Error(`[payments] Malformed subscription payload for event ${event.id}.`);
+        }
+        const data = event.data;
+        await this.#store.saveSubscription({
+            gatewayId: data.gatewayId,
+            provider: event.provider,
+            customerId: data.customerId,
+            status: data.status,
+            planId: data.planId ?? '',
+            ...(data.trialEndsAt !== undefined ? { trialEndsAt: new Date(data.trialEndsAt) } : {}),
+            ...(data.endsAt !== undefined ? { endsAt: new Date(data.endsAt) } : {}),
+            payload: event.raw,
+        });
+        const type = event.type === 'subscription.created' ? 'subscription.created' : 'subscription.updated';
+        publishPayments(type, {
+            gatewayId: data.gatewayId,
+            provider: event.provider,
+            customerId: data.customerId,
+            status: data.status,
+        });
+    }
+    async #onSubscriptionCanceled(event) {
+        if (!isSubscriptionWebhookData(event.data)) {
+            throw new Error(`[payments] Malformed subscription.canceled payload for event ${event.id}.`);
+        }
+        const data = event.data;
+        const existing = await this.#store.findSubscriptionByGatewayId(data.gatewayId);
+        if (existing) {
+            await this.#store.saveSubscription({
+                gatewayId: data.gatewayId,
+                provider: event.provider,
+                customerId: data.customerId,
+                status: 'canceled',
+                planId: existing.planId,
+                ...(data.trialEndsAt !== undefined ? { trialEndsAt: new Date(data.trialEndsAt) } : {}),
+                ...(data.endsAt !== undefined ? { endsAt: new Date(data.endsAt) } : {}),
+                payload: event.raw,
+            });
+        }
+        publishPayments('subscription.canceled', {
+            gatewayId: data.gatewayId,
+            provider: event.provider,
+        });
+    }
+}
+//# sourceMappingURL=webhook_processor.js.map

package/dist/src/billing/webhook_processor.js.map

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