@adonis-agora/payments 0.2.0

package/dist/src/define_config.d.ts

@@ -0,0 +1,251 @@
+import type { WebhookHandler } from './billing/webhook_processor.js';
+import type { PaymentsDriver } from './driver.js';
+import type { InvoiceProvider } from './invoice/invoice_provider.js';
+import type { InvoiceOptions, PaymentMethodName } from './types.js';
+import type { WebhookHandlerService } from './webhook_handlers.js';
+/**
+ * A lazy factory that builds a {@link PaymentsDriver}. Each driver factory imports its
+ * peer dependency (the Stripe SDK, etc.) lazily inside the thunk, so it only loads when
+ * that driver is actually selected — making every gateway SDK an optional peer.
+ */
+export type PaymentsDriverFactory = (ctx: PaymentsContext) => Promise<PaymentsDriver>;
+/** A lazy factory that builds an {@link InvoiceProvider} (Focus, Tecnospeed, eNotas, PlugNotas). */
+export type InvoiceProviderFactory = (ctx: InvoiceContext) => Promise<InvoiceProvider>;
+/** `config.billing.handlers` — normalized webhook event type → handler. */
+export type BillingHandlers = Record<string, WebhookHandler | WebhookHandlerService>;
+/** Context handed to driver factories when the provider resolves them. */
+export interface PaymentsContext {
+    /** Lazy import of the package's own config (circular-import safe). */
+    config: () => PaymentsConfig;
+    /** Resolve an invoice provider by name (falls back to the configured default). */
+    invoice?: (name?: string) => InvoiceProvider;
+}
+/** Context handed to invoice provider factories. */
+export interface InvoiceContext {
+    /** Lazy import of the package's own invoice config section. */
+    config: () => InvoiceSectionConfig;
+}
+export interface StripeDriverConfig {
+    /** Stripe secret key. Defaults to `env.get('STRIPE_KEY')`. */
+    apiKey?: string;
+    /** Default currency. Defaults to `'brl'`. */
+    currency?: string;
+    /**
+     * Webhook signing secret (`whsec_...`) used to verify `stripe-signature`. Defaults
+     * to `env.get('STRIPE_WEBHOOK_SECRET')`. Required to parse Stripe webhooks.
+     */
+    webhookSecret?: string;
+}
+export interface AbacateDriverConfig {
+    /** AbacatePay API token. Defaults to `env.get('ABACATE_API_KEY')`. */
+    apiKey?: string;
+    /** Public key used to verify webhook HMAC signatures. */
+    publicKey?: string;
+    /**
+     * HMAC secret that signs AbacatePay webhooks (the dashboard's "public key").
+     * Alias of {@link publicKey}; defaults to `env.get('ABACATE_PUBLIC_KEY')`. When set,
+     * webhooks without a valid `x-webhook-signature` are rejected.
+     */
+    webhookSecret?: string;
+}
+export interface AsaasDriverConfig {
+    /** Asaas API key. Defaults to `env.get('ASAAS_API_KEY')`. */
+    apiKey?: string;
+    /** Use the Asaas sandbox environment. Defaults to `NODE_ENV !== 'production'`. */
+    sandbox?: boolean;
+    /**
+     * Shared webhook token configured in the Asaas dashboard. Defaults to
+     * `env.get('ASAAS_WEBHOOK_ACCESS_TOKEN')` (or `ASAAS_WEBHOOK_TOKEN`). When set,
+     * webhooks without the matching token header are rejected.
+     */
+    webhookToken?: string;
+}
+export interface FocusInvoiceConfig {
+    /** Focus NFe API token. Defaults to `env.get('FOCUS_NFE_TOKEN')`. */
+    token?: string;
+    /** Focus NFe API URL. Defaults to the production endpoint. */
+    baseUrl?: string;
+}
+export interface ENotasInvoiceConfig {
+    /** eNotas API key. Defaults to `env.get('ENOTAS_API_KEY')`. */
+    apiKey?: string;
+    /** eNotas API URL. Defaults to the production endpoint. */
+    baseUrl?: string;
+}
+export interface PlugNotasInvoiceConfig {
+    /** PlugNotas API key. Defaults to `env.get('PLUGNOTAS_API_KEY')`. */
+    apiKey?: string;
+    /** PlugNotas API URL. Defaults to the production endpoint. */
+    baseUrl?: string;
+}
+export interface AsaasInvoiceConfig {
+    /** Asaas API key. Defaults to `env.get('ASAAS_API_KEY')`. */
+    apiKey?: string;
+    /** Use the Asaas sandbox environment. Defaults to `NODE_ENV !== 'production'`. */
+    sandbox?: boolean;
+}
+export interface TecnospeedInvoiceConfig {
+    /** Tecnospeed API token. Defaults to `env.get('TECNOSPEED_TOKEN')`. */
+    token?: string;
+    /** Tecnospeed API base URL (per-municipality/plan). Defaults to the generic v1 base. */
+    baseUrl?: string;
+}
+export interface WooviDriverConfig {
+    /** Woovi/OpenPix app id. Defaults to `env.get('WOOVI_APP_ID')`. */
+    appId?: string;
+    /** Base URL of the OpenPix API. Defaults to production. */
+    baseUrl?: string;
+    /**
+     * Per-webhook HMAC secret (dashboard → API/Plugins). Verifies the deprecated
+     * `X-OpenPix-Signature` header. Defaults to `env.get('WOOVI_WEBHOOK_SECRET')`.
+     * Prefer {@link webhookPublicKey}.
+     */
+    webhookSecret?: string;
+    /**
+     * Woovi account public key, used to verify the recommended `x-webhook-signature`
+     * header (RSA-SHA256). PEM or base64-encoded PEM; defaults to
+     * `env.get('WOOVI_WEBHOOK_PUBLIC_KEY')`.
+     */
+    webhookPublicKey?: string;
+}
+/**
+ * Shape of `config/payments.ts`.
+ *
+ * Both payment gateways and invoice providers are named maps with a `default` — so a
+ * charge call either just works with the defaults, or names a specific provider per call.
+ *
+ * ```ts
+ * import { defineConfig, payments, invoice } from '@adonis-agora/payments'
+ *
+ * export default defineConfig({
+ *   default: 'stripe',
+ *   providers: {
+ *     stripe: payments.stripe(),
+ *     asaas: payments.asaas({ sandbox: true }),
+ *   },
+ *   invoice: {
+ *     default: 'focus',
+ *     providers: {
+ *       focus: invoice.focus(),
+ *       // Custom providers are plain factories too.
+ *       myProvider: () => import('#services/my_invoice').then((m) => new m.MyInvoiceProvider()),
+ *     },
+ *     defaults: {
+ *       service: { description: 'Software license' },
+ *     },
+ *   },
+ *   billing: {
+ *     enabled: true,
+ *     durable: 'auto',
+ *   },
+ * })
+ * ```
+ */
+export interface PaymentsConfig {
+    /** Name of the default payment provider (a key of `providers`). */
+    default?: string;
+    /** Named payment providers, built with the {@link payments} factory. */
+    providers?: Record<string, PaymentsDriverFactory>;
+    /**
+     * Route a payment method to a provider name (a key of `providers`). Resolves the
+     * driver per method on a charge call.
+     *
+     * ```ts
+     * methods: {
+     *   pix: 'woovi',           // Pix via Woovi/OpenPix
+     *   credit_card: 'stripe',  // card via Stripe
+     *   boleto: 'asaas',        // boleto via Asaas
+     *   debit_card: 'asaas',
+     *   undefined: 'asaas',     // customer picks at checkout
+     * }
+     * ```
+     */
+    methods?: Partial<Record<PaymentMethodName, string>>;
+    /** Invoice emission settings. */
+    invoice?: InvoiceSectionConfig;
+    /** Billing (subscription) layer settings. */
+    billing?: {
+        /**
+         * Whether the Lucid billing layer is enabled. When enabled the provider wires the
+         * billing stores, mixins and webhook processor. Defaults to true.
+         */
+        enabled?: boolean;
+        /**
+         * Legacy alias for {@link dispatcher}: `'auto'` (default) or a boolean (`true` =
+         * `'durable'`, `false` = `'in-process'`). Prefer `dispatcher` for the full set of
+         * backends.
+         */
+        durable?: 'auto' | boolean;
+        /**
+         * How webhook events are processed:
+         *
+         * - `'auto'` (default) — `@adonis-agora/durable` when its provider is registered;
+         *   else `@adonisjs/queue` when it's installed; else in-process with retries.
+         * - `'durable'` — a durable workflow run (requires `@adonis-agora/durable`, throws when missing).
+         * - `'queue'` — an `@adonisjs/queue` job (requires the queue provider, throws when missing).
+         * - `'in-process'` — inline with exponential-backoff retries.
+         *
+         * Mirrors how other Agora libraries pick a backend (`durable`'s `store`, etc.).
+         */
+        dispatcher?: 'auto' | 'durable' | 'queue' | 'in-process';
+        /** Queue name the `'queue'` dispatcher enqueues to. Defaults to the queue's default. */
+        queue?: string;
+        /**
+         * Business webhook handlers run INSIDE the lib-mounted `/payments/webhook/:provider`
+         * route, by the {@link WebhookProcessor}. Errors mark the event failed in the ledger
+         * and trigger the dispatcher's retry. An alternative to subscribing to the
+         * `agora:payments:billing:*` events — pick whichever fits the app (events for
+         * fire-and-forget, handlers here for error-driven retry).
+         *
+         * Keyed by the normalized event type (e.g. `'payment.succeeded'`). Each factory
+         * receives the AdonisJS container and returns the handler, so it can resolve DI
+         * services lazily:
+         *
+         * ```ts
+         * handlers: {
+         *   'payment.succeeded': async ({ app }) => {
+         *     const svc = await app.container.make(MeetingPackageService)
+         *     return (event) => svc.handlePayment(event)
+         *   },
+         * }
+         * ```
+         */
+        handlers?: BillingHandlers;
+    };
+}
+/**
+ * Identity helper giving `config/payments.ts` full type-checking (media/durable pattern).
+ */
+export declare function defineConfig<const T extends PaymentsConfig>(config: T): T;
+/** Built-in driver factories. Each lazily imports its gateway SDK. */
+export declare const payments: {
+    stripe(config?: StripeDriverConfig): PaymentsDriverFactory;
+    abacate(config?: AbacateDriverConfig): PaymentsDriverFactory;
+    asaas(config?: AsaasDriverConfig): PaymentsDriverFactory;
+    woovi(config?: WooviDriverConfig): PaymentsDriverFactory;
+};
+/** Built-in invoice provider factories. Each lazily imports its provider module. */
+export declare const invoice: {
+    focus(config?: FocusInvoiceConfig): InvoiceProviderFactory;
+    enotas(config?: ENotasInvoiceConfig): InvoiceProviderFactory;
+    plugnotas(config?: PlugNotasInvoiceConfig): InvoiceProviderFactory;
+    asaas(config?: AsaasInvoiceConfig): InvoiceProviderFactory;
+    tecnospeed(config?: TecnospeedInvoiceConfig): InvoiceProviderFactory;
+};
+export type { PaymentsDriver, InvoiceProvider };
+/** Invoice emission settings (the `invoice` key of {@link PaymentsConfig}). */
+export interface InvoiceSectionConfig {
+    /** Name of the default invoice provider (a key of `invoice.providers`). */
+    default?: string;
+    /** Named invoice providers, built with the {@link invoice} factory. */
+    providers?: Record<string, InvoiceProviderFactory>;
+    /** Defaults merged into every `invoice` option. */
+    defaults?: {
+        service?: InvoiceOptions['service'];
+        tax?: InvoiceOptions['tax'];
+        metadata?: InvoiceOptions['metadata'];
+    };
+}
+export type { InvoiceConfig };
+type InvoiceConfig = InvoiceSectionConfig;
+//# sourceMappingURL=define_config.d.ts.map

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

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

package/dist/src/define_config.js

@@ -0,0 +1,67 @@
+/**
+ * Identity helper giving `config/payments.ts` full type-checking (media/durable pattern).
+ */
+export function defineConfig(config) {
+    return config;
+}
+/** Built-in driver factories. Each lazily imports its gateway SDK. */
+export const payments = {
+    stripe(config = {}) {
+        return async (ctx) => {
+            const { StripeDriver } = await import('./drivers/stripe.js');
+            return new StripeDriver(ctx, config);
+        };
+    },
+    abacate(config = {}) {
+        return async (ctx) => {
+            const { AbacateDriver } = await import('./drivers/abacate.js');
+            return new AbacateDriver(ctx, config);
+        };
+    },
+    asaas(config = {}) {
+        return async (ctx) => {
+            const { AsaasDriver } = await import('./drivers/asaas.js');
+            return new AsaasDriver(ctx, config);
+        };
+    },
+    woovi(config = {}) {
+        return async (ctx) => {
+            const { WooviDriver } = await import('./drivers/woovi.js');
+            return new WooviDriver(ctx, config);
+        };
+    },
+};
+/** Built-in invoice provider factories. Each lazily imports its provider module. */
+export const invoice = {
+    focus(config = {}) {
+        return async (ctx) => {
+            const { FocusInvoiceProvider } = await import('./invoice/drivers/focus.js');
+            return new FocusInvoiceProvider(ctx, config);
+        };
+    },
+    enotas(config = {}) {
+        return async (ctx) => {
+            const { ENotasInvoiceProvider } = await import('./invoice/drivers/enotas.js');
+            return new ENotasInvoiceProvider(ctx, config);
+        };
+    },
+    plugnotas(config = {}) {
+        return async (ctx) => {
+            const { PlugNotasInvoiceProvider } = await import('./invoice/drivers/plugnotas.js');
+            return new PlugNotasInvoiceProvider(ctx, config);
+        };
+    },
+    asaas(config = {}) {
+        return async (ctx) => {
+            const { AsaasInvoiceProvider } = await import('./invoice/drivers/asaas.js');
+            return new AsaasInvoiceProvider(ctx, config);
+        };
+    },
+    tecnospeed(config = {}) {
+        return async (ctx) => {
+            const { TecnospeedInvoiceProvider } = await import('./invoice/drivers/tecnospeed.js');
+            return new TecnospeedInvoiceProvider(ctx, config);
+        };
+    },
+};
+//# sourceMappingURL=define_config.js.map

package/dist/src/define_config.js.map

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

package/dist/src/diagnostics.d.ts

@@ -0,0 +1,155 @@
+/**
+ * The `@adonis-agora/diagnostics` emit capability, published on this global slot at that
+ * package's module load. `@adonis-agora/payments` reads it STRUCTURALLY — it never imports
+ * or depends on the diagnostics package. When diagnostics isn't installed the slot is
+ * empty and emitting is an inert no-op. (Same pattern as `@adonis-agora/media`.)
+ */
+import type { Payment, Subscription } from './types.js';
+/**
+ * Every payments milestone published on `agora:payments:<event>`. The single runtime
+ * source for the {@link PaymentsDiagnosticEvent} union — a Telescope watcher iterates
+ * this to subscribe/claim, and apps subscribe with `onDiagnostic('payments', ...)`.
+ *
+ * Two layers:
+ * - **Gateway-action** events, emitted by the drivers on API calls (`charge.created`,
+ *   `charge.refunded`, `subscription.created`/`canceled`, `invoice.emitted`).
+ * - **Business** events, emitted by the `WebhookProcessor` when a webhook confirms a
+ *   state change (`payment.succeeded`/`failed`/`refunded`/`updated`,
+ *   `subscription.updated`, plus `subscription.created`/`canceled` from webhooks) and
+ *   the webhook lifecycle (`webhook.received`/`processed`/`failed`).
+ */
+export declare const PAYMENTS_DIAGNOSTIC_EVENTS: readonly ["charge.created", "charge.refunded", "subscription.created", "subscription.updated", "subscription.canceled", "payment.succeeded", "payment.failed", "payment.refunded", "payment.updated", "invoice.emitted", "webhook.received", "webhook.processed", "webhook.failed"];
+export type PaymentsDiagnosticEvent = (typeof PAYMENTS_DIAGNOSTIC_EVENTS)[number];
+/**
+ * Claim `payments:<event>` for every event, so the generic diagnostics→telescope bridge
+ * skips them. Reference-counted (mirrors `@adonis-agora/diagnostics`'
+ * `claimDiagnostics`).
+ */
+export declare function claimPaymentsDiagnostics(events: readonly string[]): () => void;
+/** Whether `payments:<event>` is currently claimed. */
+export declare function isPaymentsDiagnosticClaimed(event: string): boolean;
+export interface ChargeCreatedPayload {
+    gatewayId: string;
+    provider: string;
+    amount: number;
+    currency: string;
+    method?: string;
+}
+export interface ChargeRefundedPayload {
+    gatewayId: string;
+    provider: string;
+    amount: number;
+    currency: string;
+}
+export interface SubscriptionCreatedPayload {
+    gatewayId: string;
+    provider: string;
+    customerId: string;
+    planId: string;
+}
+export interface SubscriptionUpdatedPayload {
+    gatewayId: string;
+    provider: string;
+    customerId: string;
+    status: string;
+}
+export interface SubscriptionCanceledPayload {
+    gatewayId: string;
+    provider: string;
+}
+/** Webhook-confirmed payment (normalized business event). */
+export interface PaymentSucceededPayload {
+    gatewayId: string;
+    provider: string;
+    amount: number;
+    currency: string;
+    /** The `externalReference` the app set on the charge, echoed back by the gateway. */
+    externalReference?: string;
+}
+export interface PaymentFailedPayload {
+    gatewayId: string;
+    provider: string;
+    amount: number;
+    currency: string;
+    reason?: string;
+    externalReference?: string;
+}
+export interface PaymentRefundedPayload {
+    gatewayId: string;
+    provider: string;
+    amount: number;
+    currency: string;
+}
+export interface PaymentUpdatedPayload {
+    gatewayId: string;
+    provider: string;
+    status: string;
+}
+export interface InvoiceEmittedPayload {
+    gatewayId: string;
+    provider: string;
+    number?: string;
+    url?: string;
+}
+export interface WebhookReceivedPayload {
+    id: string;
+    provider: string;
+    type: string;
+}
+export interface WebhookProcessedPayload {
+    id: string;
+    provider: string;
+    type: string;
+}
+export interface WebhookFailedPayload {
+    id: string;
+    provider: string;
+    type: string;
+    error: string;
+}
+/** Maps each event to its payload type, so {@link publishPayments} is checked at the call site. */
+export interface PaymentsDiagnosticPayloads {
+    'charge.created': ChargeCreatedPayload;
+    'charge.refunded': ChargeRefundedPayload;
+    'subscription.created': SubscriptionCreatedPayload;
+    'subscription.updated': SubscriptionUpdatedPayload;
+    'subscription.canceled': SubscriptionCanceledPayload;
+    'payment.succeeded': PaymentSucceededPayload;
+    'payment.failed': PaymentFailedPayload;
+    'payment.refunded': PaymentRefundedPayload;
+    'payment.updated': PaymentUpdatedPayload;
+    'invoice.emitted': InvoiceEmittedPayload;
+    'webhook.received': WebhookReceivedPayload;
+    'webhook.processed': WebhookProcessedPayload;
+    'webhook.failed': WebhookFailedPayload;
+}
+/**
+ * Publish a payments event on `agora:payments:<event>` via the structural diagnostics
+ * slot. No-op when diagnostics isn't installed (the slot is empty) — and it never throws
+ * back into the library.
+ */
+export declare function publishPayments<E extends PaymentsDiagnosticEvent>(event: E, payload: PaymentsDiagnosticPayloads[E]): void;
+/** Wrap a unit of payments work in a structural trace span. */
+export declare function tracePayments<T>(event: string, fn: () => T, payload?: unknown): T;
+/**
+ * Emit the `charge.created` / `charge.refunded` / `subscription.created` /
+ * `subscription.canceled` diagnostics for a normalized payment/subscription. Called by
+ * the drivers after a successful gateway call; a no-op when diagnostics isn't installed.
+ */
+export declare function publishPaymentDiagnostics(payment: Payment): void;
+export declare function publishRefundDiagnostics(refund: {
+    gatewayId: string;
+    provider: string;
+    amount: {
+        amount: number;
+        currency: string;
+    };
+}): void;
+export declare function publishSubscriptionDiagnostics(subscription: Subscription, event: 'subscription.created' | 'subscription.canceled'): void;
+export declare function publishInvoiceEmittedDiagnostics(invoice: {
+    gatewayId: string;
+    provider: string;
+    number?: string;
+    url?: string;
+}): void;
+//# sourceMappingURL=diagnostics.d.ts.map

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

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

package/dist/src/diagnostics.js

@@ -0,0 +1,153 @@
+const EMIT_SLOT = Symbol.for('@agora/diagnostics:emit');
+/**
+ * The `@adonis-agora/diagnostics` trace capability. Like {@link EMIT_SLOT} it is read
+ * STRUCTURALLY — payments never imports the diagnostics package.
+ */
+const TRACE_SLOT = Symbol.for('@agora/diagnostics:trace');
+/**
+ * Every payments milestone published on `agora:payments:<event>`. The single runtime
+ * source for the {@link PaymentsDiagnosticEvent} union — a Telescope watcher iterates
+ * this to subscribe/claim, and apps subscribe with `onDiagnostic('payments', ...)`.
+ *
+ * Two layers:
+ * - **Gateway-action** events, emitted by the drivers on API calls (`charge.created`,
+ *   `charge.refunded`, `subscription.created`/`canceled`, `invoice.emitted`).
+ * - **Business** events, emitted by the `WebhookProcessor` when a webhook confirms a
+ *   state change (`payment.succeeded`/`failed`/`refunded`/`updated`,
+ *   `subscription.updated`, plus `subscription.created`/`canceled` from webhooks) and
+ *   the webhook lifecycle (`webhook.received`/`processed`/`failed`).
+ */
+export const PAYMENTS_DIAGNOSTIC_EVENTS = [
+    'charge.created',
+    'charge.refunded',
+    'subscription.created',
+    'subscription.updated',
+    'subscription.canceled',
+    'payment.succeeded',
+    'payment.failed',
+    'payment.refunded',
+    'payment.updated',
+    'invoice.emitted',
+    'webhook.received',
+    'webhook.processed',
+    'webhook.failed',
+];
+/**
+ * The claim registry, published by `@adonis-agora/diagnostics` under this global slot as
+ * a reference-counted `Map<`${lib}:${event}`, number>`. Read STRUCTURALLY — same
+ * decoupling as {@link EMIT_SLOT}. A lib-specific Telescope watcher claims the channels
+ * it records here so the generic `DiagnosticsWatcher` skips them (its `recordClaimed:
+ * false` default), avoiding double-recording.
+ */
+const CLAIMS_SLOT = Symbol.for('@agora/diagnostics:claims');
+function claimsRegistry() {
+    const g = globalThis;
+    let registry = g[CLAIMS_SLOT];
+    if (registry === undefined) {
+        registry = new Map();
+        g[CLAIMS_SLOT] = registry;
+    }
+    return registry;
+}
+/**
+ * Claim `payments:<event>` for every event, so the generic diagnostics→telescope bridge
+ * skips them. Reference-counted (mirrors `@adonis-agora/diagnostics`'
+ * `claimDiagnostics`).
+ */
+export function claimPaymentsDiagnostics(events) {
+    const registry = claimsRegistry();
+    const keys = events.map((event) => `payments:${event}`);
+    for (const key of keys)
+        registry.set(key, (registry.get(key) ?? 0) + 1);
+    let released = false;
+    return () => {
+        if (released)
+            return;
+        released = true;
+        for (const key of keys) {
+            const count = registry.get(key);
+            if (count === undefined)
+                continue;
+            if (count <= 1)
+                registry.delete(key);
+            else
+                registry.set(key, count - 1);
+        }
+    };
+}
+/** Whether `payments:<event>` is currently claimed. */
+export function isPaymentsDiagnosticClaimed(event) {
+    const registry = globalThis[CLAIMS_SLOT];
+    return registry?.has(`payments:${event}`) ?? false;
+}
+/**
+ * Publish a payments event on `agora:payments:<event>` via the structural diagnostics
+ * slot. No-op when diagnostics isn't installed (the slot is empty) — and it never throws
+ * back into the library.
+ */
+export function publishPayments(event, payload) {
+    const emit = globalThis[EMIT_SLOT];
+    if (typeof emit === 'function') {
+        try {
+            emit('payments', event, payload);
+        }
+        catch {
+            // diagnostics must never break a payment operation
+        }
+    }
+}
+/** Wrap a unit of payments work in a structural trace span. */
+export function tracePayments(event, fn, payload) {
+    const trace = globalThis[TRACE_SLOT];
+    if (typeof trace === 'function') {
+        return trace('payments', event, fn, payload);
+    }
+    return fn();
+}
+/**
+ * Emit the `charge.created` / `charge.refunded` / `subscription.created` /
+ * `subscription.canceled` diagnostics for a normalized payment/subscription. Called by
+ * the drivers after a successful gateway call; a no-op when diagnostics isn't installed.
+ */
+export function publishPaymentDiagnostics(payment) {
+    publishPayments('charge.created', {
+        gatewayId: payment.gatewayId,
+        provider: payment.provider,
+        amount: payment.amount.amount,
+        currency: payment.amount.currency,
+        ...(payment.method !== undefined ? { method: payment.method } : {}),
+    });
+}
+export function publishRefundDiagnostics(refund) {
+    publishPayments('charge.refunded', {
+        gatewayId: refund.gatewayId,
+        provider: refund.provider,
+        amount: refund.amount.amount,
+        currency: refund.amount.currency,
+    });
+}
+export function publishSubscriptionDiagnostics(subscription, event) {
+    if (event === 'subscription.created') {
+        publishPayments('subscription.created', {
+            gatewayId: subscription.gatewayId,
+            provider: subscription.provider,
+            customerId: subscription.customerId,
+            planId: subscription.planId,
+        });
+    }
+    else {
+        publishPayments('subscription.canceled', {
+            gatewayId: subscription.gatewayId,
+            provider: subscription.provider,
+        });
+    }
+}
+export function publishInvoiceEmittedDiagnostics(invoice) {
+    publishPayments('invoice.emitted', {
+        gatewayId: invoice.gatewayId,
+        provider: invoice.provider,
+        ...(invoice.number !== undefined ? { number: invoice.number } : {}),
+        ...(invoice.url !== undefined ? { url: invoice.url } : {}),
+    });
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/src/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/diagnostics.ts"],"names":[],"mappings":"AAQA,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AAGxD;;;GAGG;AACH,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AAG1D;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,gBAAgB;IAChB,iBAAiB;IACjB,sBAAsB;IACtB,sBAAsB;IACtB,uBAAuB;IACvB,mBAAmB;IACnB,gBAAgB;IAChB,kBAAkB;IAClB,iBAAiB;IACjB,iBAAiB;IACjB,kBAAkB;IAClB,mBAAmB;IACnB,gBAAgB;CACR,CAAC;AAIX;;;;;;GAMG;AACH,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;AAE5D,SAAS,cAAc;IACrB,MAAM,CAAC,GAAG,UAAqC,CAAC;IAChD,IAAI,QAAQ,GAAG,CAAC,CAAC,WAAW,CAAoC,CAAC;IACjE,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;QACrC,CAAC,CAAC,WAAW,CAAC,GAAG,QAAQ,CAAC;IAC5B,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAyB;IAChE,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,KAAK,EAAE,CAAC,CAAC;IACxD,KAAK,MAAM,GAAG,IAAI,IAAI;QAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACxE,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,OAAO,GAAG,EAAE;QACV,IAAI,QAAQ;YAAE,OAAO;QACrB,QAAQ,GAAG,IAAI,CAAC;QAChB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChC,IAAI,KAAK,KAAK,SAAS;gBAAE,SAAS;YAClC,IAAI,KAAK,IAAI,CAAC;gBAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;;gBAChC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACpC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,2BAA2B,CAAC,KAAa;IACvD,MAAM,QAAQ,GAAI,UAAsC,CAAC,WAAW,CAEvD,CAAC;IACd,OAAO,QAAQ,EAAE,GAAG,CAAC,YAAY,KAAK,EAAE,CAAC,IAAI,KAAK,CAAC;AACrD,CAAC;AAmGD;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAQ,EACR,OAAsC;IAEtC,MAAM,IAAI,GAAI,UAAsC,CAAC,SAAS,CAAuB,CAAC;IACtF,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,mDAAmD;QACrD,CAAC;IACH,CAAC;AACH,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,aAAa,CAAI,KAAa,EAAE,EAAW,EAAE,OAAiB;IAC5E,MAAM,KAAK,GAAI,UAAsC,CAAC,UAAU,CAAwB,CAAC;IACzF,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,EAAE,EAAE,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,eAAe,CAAC,gBAAgB,EAAE;QAChC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM;QAC7B,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ;QACjC,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpE,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAIxC;IACC,eAAe,CAAC,iBAAiB,EAAE;QACjC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;QAC5B,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ;KACjC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,YAA0B,EAC1B,KAAuD;IAEvD,IAAI,KAAK,KAAK,sBAAsB,EAAE,CAAC;QACrC,eAAe,CAAC,sBAAsB,EAAE;YACtC,SAAS,EAAE,YAAY,CAAC,SAAS;YACjC,QAAQ,EAAE,YAAY,CAAC,QAAQ;YAC/B,UAAU,EAAE,YAAY,CAAC,UAAU;YACnC,MAAM,EAAE,YAAY,CAAC,MAAM;SAC5B,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,eAAe,CAAC,uBAAuB,EAAE;YACvC,SAAS,EAAE,YAAY,CAAC,SAAS;YACjC,QAAQ,EAAE,YAAY,CAAC,QAAQ;SAChC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,OAKhD;IACC,eAAe,CAAC,iBAAiB,EAAE;QACjC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,GAAG,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3D,CAAC,CAAC;AACL,CAAC"}