@adonis-agora/payments 0.2.0

package/dist/src/invoice/drivers/tecnospeed.js

@@ -0,0 +1,87 @@
+/**
+ * Tecnospeed invoice provider — NFS-e across municipalities. Uses `fetch` directly (no
+ * SDK dependency). The exact JSON layout varies per municipality and standard (Tecnospeed
+ * also offers an XML DPS flow and steers toward PlugNotas for JSON NFS-e) — this adapter
+ * sends the common JSON shape and normalizes the response; if your municipality differs,
+ * extend this driver (see Custom providers).
+ */
+export class TecnospeedInvoiceProvider {
+    provider = 'tecnospeed';
+    #token;
+    #baseUrl;
+    constructor(_ctx, config = {}) {
+        const token = config.token ?? process.env.TECNOSPEED_TOKEN;
+        if (!token) {
+            throw new Error('[payments] Tecnospeed invoice provider requires a token. Set `TECNOSPEED_TOKEN` env or pass `token` to `invoice.tecnospeed()`.');
+        }
+        this.#token = token;
+        this.#baseUrl = config.baseUrl ?? 'https://api-tecnospeed.com.br/v1';
+    }
+    async emit(input) {
+        const body = {
+            tomador: {
+                cpf_cnpj: input.customer.taxId.replace(/\D/g, ''),
+                razao_social: input.customer.name ?? 'Cliente',
+                ...(input.customer.email !== undefined ? { email: input.customer.email } : {}),
+                ...(input.customer.address !== undefined ? { endereco: input.customer.address } : {}),
+            },
+            servico: {
+                descricao: input.service.description,
+                ...(input.service.code !== undefined ? { codigo_servico: input.service.code } : {}),
+                ...(input.service.cityServiceCode !== undefined
+                    ? { codigo_servico_municipio: input.service.cityServiceCode }
+                    : {}),
+            },
+            valor: input.amount / 100,
+            ...(input.tax !== undefined ? { impostos: input.tax } : {}),
+        };
+        const response = await fetch(`${this.#baseUrl}/nfse`, {
+            method: 'POST',
+            headers: {
+                Authorization: this.#token,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`[payments] Tecnospeed invoice request failed (${response.status}): ${text}`);
+        }
+        const data = (await response.json());
+        return this.#mapInvoice(data);
+    }
+    async find(invoiceId) {
+        const response = await fetch(`${this.#baseUrl}/nfse/${encodeURIComponent(invoiceId)}`, {
+            headers: { Authorization: this.#token },
+        });
+        if (response.status === 404)
+            return null;
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`[payments] Tecnospeed invoice request failed (${response.status}): ${text}`);
+        }
+        const data = (await response.json());
+        return this.#mapInvoice(data);
+    }
+    #mapInvoice(data) {
+        const status = data.status ?? '';
+        const normalized = status === 'autorizado' || status === 'AUTORIZADO' || status === 'emitido'
+            ? 'issued'
+            : status === 'cancelado' || status === 'CANCELADO' || status === 'rejeitado'
+                ? 'canceled'
+                : 'pending';
+        return {
+            id: data.id ?? data.chave ?? data.numero ?? String(Math.random()),
+            gatewayId: data.id ?? data.chave ?? data.numero ?? '',
+            provider: this.provider,
+            ...(data.numero !== undefined ? { number: data.numero } : {}),
+            ...(data.chave !== undefined ? { key: data.chave } : {}),
+            ...(data.url !== undefined ? { url: data.url, hostedPdfUrl: data.url } : {}),
+            status: normalized,
+            amount: { amount: Math.round(Number(data.valor ?? 0) * 100), currency: 'brl' },
+            createdAt: new Date().toISOString(),
+            payload: data,
+        };
+    }
+}
+//# sourceMappingURL=tecnospeed.js.map

package/dist/src/invoice/drivers/tecnospeed.js.map

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

package/dist/src/invoice/emit_invoice.d.ts

@@ -0,0 +1,45 @@
+import type { ChargeInput, PaymentsDriver } from '../driver.js';
+import type { InvoiceOptions, Payment } from '../types.js';
+import type { InvoiceProvider } from './invoice_provider.js';
+/** The invoice-resolution surface a payment driver receives (from the factory ctx). */
+export interface EmitInvoiceContext {
+    /** Resolve an invoice provider by name; falls back to the configured default. */
+    invoice?: (name?: string) => InvoiceProvider;
+}
+export interface EmitInvoiceData {
+    /** The billing customer's fiscal data. */
+    customer: {
+        name?: string;
+        taxId: string;
+        email?: string;
+        address?: Record<string, unknown>;
+    };
+    /** Amount in the currency's smallest unit (e.g. cents). */
+    amount: number;
+    currency: string;
+    /** The gateway payment this invoice is attached to, when available. */
+    payment?: {
+        gatewayId: string;
+        provider: string;
+    };
+}
+/**
+ * Emit an invoice for a charge when the call asked for one. The `invoice` option on a
+ * charge/subscription/checkout resolves the provider by NAME, independent of the payment
+ * gateway:
+ *
+ * - `true` — use the default invoice provider from `config.invoice.providers`.
+ * - `'tecnospeed'` — use the named invoice provider (a key of `invoice.providers`).
+ * - `{ provider?, ... }` — named provider (or default) with these overrides.
+ *
+ * Returns `undefined` when the call did not request an invoice.
+ */
+export declare function emitInvoice(ctx: EmitInvoiceContext, option: boolean | string | InvoiceOptions | undefined, data: EmitInvoiceData): Promise<ReturnType<InvoiceProvider['emit']> | undefined>;
+/**
+ * The per-driver charge helper: when `input.invoice` is present, resolve the payer's
+ * fiscal data from `input.customer` (falling back to `card.holder`), emit through the
+ * configured invoice provider, and attach the result to the payment. One call replaces
+ * the ~15-line block that used to be copy-pasted in every driver's `charge()`.
+ */
+export declare function emitInvoiceIfRequested(ctx: EmitInvoiceContext, input: Pick<ChargeInput, 'invoice' | 'customer' | 'card'>, payment: Payment, driver: Pick<PaymentsDriver, 'provider'>): Promise<void>;
+//# sourceMappingURL=emit_invoice.d.ts.map

package/dist/src/invoice/emit_invoice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit_invoice.d.ts","sourceRoot":"","sources":["../../../src/invoice/emit_invoice.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,uFAAuF;AACvF,MAAM,WAAW,kBAAkB;IACjC,iFAAiF;IACjF,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,eAAe,CAAC;CAC9C;AAED,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,QAAQ,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC;IACF,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,OAAO,CAAC,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,kBAAkB,EACvB,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,cAAc,GAAG,SAAS,EACrD,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,CA6B1D;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,kBAAkB,EACvB,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC,EACzD,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,GACvC,OAAO,CAAC,IAAI,CAAC,CA2Bf"}

package/dist/src/invoice/emit_invoice.js

@@ -0,0 +1,72 @@
+import { publishInvoiceEmittedDiagnostics } from '../diagnostics.js';
+/**
+ * Emit an invoice for a charge when the call asked for one. The `invoice` option on a
+ * charge/subscription/checkout resolves the provider by NAME, independent of the payment
+ * gateway:
+ *
+ * - `true` — use the default invoice provider from `config.invoice.providers`.
+ * - `'tecnospeed'` — use the named invoice provider (a key of `invoice.providers`).
+ * - `{ provider?, ... }` — named provider (or default) with these overrides.
+ *
+ * Returns `undefined` when the call did not request an invoice.
+ */
+export async function emitInvoice(ctx, option, data) {
+    if (option === undefined || option === false)
+        return undefined;
+    const providerName = typeof option === 'string' ? option : typeof option === 'object' ? option.provider : undefined;
+    const provider = ctx.invoice?.(providerName);
+    if (!provider) {
+        throw new Error('[payments] invoice was requested but no invoice provider is configured. ' +
+            'Add `invoice.providers` to config/payments.ts (and an `invoice.default`).');
+    }
+    const overrides = typeof option === 'object' ? option : {};
+    return provider.emit({
+        customer: {
+            ...data.customer,
+            ...(overrides.customer !== undefined ? overrides.customer : {}),
+        },
+        amount: data.amount,
+        currency: data.currency,
+        service: {
+            description: 'Payment',
+            ...(overrides.service !== undefined ? overrides.service : {}),
+        },
+        ...(overrides.tax !== undefined ? { tax: overrides.tax } : {}),
+        ...(data.payment !== undefined ? { payment: data.payment } : {}),
+        ...(overrides.metadata !== undefined ? { metadata: overrides.metadata } : {}),
+    });
+}
+/**
+ * The per-driver charge helper: when `input.invoice` is present, resolve the payer's
+ * fiscal data from `input.customer` (falling back to `card.holder`), emit through the
+ * configured invoice provider, and attach the result to the payment. One call replaces
+ * the ~15-line block that used to be copy-pasted in every driver's `charge()`.
+ */
+export async function emitInvoiceIfRequested(ctx, input, payment, driver) {
+    if (input.invoice === undefined || input.invoice === false)
+        return;
+    const holder = input.card?.holder;
+    const taxId = input.customer?.taxId ?? holder?.cpfCnpj ?? '';
+    const name = input.customer?.name ?? holder?.name;
+    const email = input.customer?.email ?? holder?.email;
+    const invoice = await emitInvoice(ctx, input.invoice, {
+        customer: {
+            taxId,
+            ...(name !== undefined ? { name } : {}),
+            ...(email !== undefined ? { email } : {}),
+        },
+        amount: payment.amount.amount,
+        currency: payment.amount.currency,
+        payment: { gatewayId: payment.gatewayId, provider: driver.provider },
+    });
+    if (invoice) {
+        payment.invoice = invoice;
+        publishInvoiceEmittedDiagnostics({
+            gatewayId: invoice.gatewayId,
+            provider: invoice.provider,
+            ...(invoice.number !== undefined ? { number: invoice.number } : {}),
+            ...(invoice.hostedPdfUrl !== undefined ? { url: invoice.hostedPdfUrl } : {}),
+        });
+    }
+}
+//# sourceMappingURL=emit_invoice.js.map

package/dist/src/invoice/emit_invoice.js.map

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

package/dist/src/invoice/invoice_manager.d.ts

@@ -0,0 +1,12 @@
+import type { InvoiceConfig } from '../define_config.js';
+import type { InvoiceProvider } from './invoice_provider.js';
+/** Resolves named invoice providers from config, mirroring the payment providers map. */
+export declare class InvoiceManager {
+    #private;
+    constructor(providers: Map<string, InvoiceProvider>);
+    /** Resolve a provider by name. Falls back to the configured default when `name` is omitted. */
+    provider(name?: string): InvoiceProvider;
+}
+/** Build the invoice provider map from config. */
+export declare function resolveInvoiceProviders(config: InvoiceConfig): Promise<Map<string, InvoiceProvider>>;
+//# sourceMappingURL=invoice_manager.d.ts.map

package/dist/src/invoice/invoice_manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice_manager.d.ts","sourceRoot":"","sources":["../../../src/invoice/invoice_manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,yFAAyF;AACzF,qBAAa,cAAc;;gBAGb,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC;IAInD,+FAA+F;IAC/F,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe;CAqBzC;AAED,kDAAkD;AAClD,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAQvC"}

package/dist/src/invoice/invoice_manager.js

@@ -0,0 +1,35 @@
+/** Resolves named invoice providers from config, mirroring the payment providers map. */
+export class InvoiceManager {
+    #providers;
+    constructor(providers) {
+        this.#providers = providers;
+    }
+    /** Resolve a provider by name. Falls back to the configured default when `name` is omitted. */
+    provider(name) {
+        const resolved = name ?? this.#defaultName;
+        const driver = this.#providers.get(resolved);
+        if (!driver) {
+            throw new Error(`[payments] Invoice provider "${resolved}" is not configured. ` +
+                `Available providers: ${[...this.#providers.keys()].join(', ') || '(none)'}.`);
+        }
+        return driver;
+    }
+    get #defaultName() {
+        const names = [...this.#providers.keys()];
+        if (names.length === 0) {
+            throw new Error('[payments] No invoice providers configured. Add a provider to invoice.providers in config/payments.ts.');
+        }
+        return names[0];
+    }
+}
+/** Build the invoice provider map from config. */
+export async function resolveInvoiceProviders(config) {
+    const factories = config.providers ?? {};
+    const ctx = { config: () => config };
+    const map = new Map();
+    for (const [name, factory] of Object.entries(factories)) {
+        map.set(name, await factory(ctx));
+    }
+    return map;
+}
+//# sourceMappingURL=invoice_manager.js.map

package/dist/src/invoice/invoice_manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice_manager.js","sourceRoot":"","sources":["../../../src/invoice/invoice_manager.ts"],"names":[],"mappings":"AAGA,yFAAyF;AACzF,MAAM,OAAO,cAAc;IACzB,UAAU,CAA+B;IAEzC,YAAY,SAAuC;QACjD,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED,+FAA+F;IAC/F,QAAQ,CAAC,IAAa;QACpB,MAAM,QAAQ,GAAG,IAAI,IAAI,IAAI,CAAC,YAAY,CAAC;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACb,gCAAgC,QAAQ,uBAAuB;gBAC7D,wBAAwB,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,GAAG,CAChF,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,YAAY;QACd,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,wGAAwG,CACzG,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC,CAAC,CAAE,CAAC;IACnB,CAAC;CACF;AAED,kDAAkD;AAClD,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAAqB;IAErB,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;IACzC,MAAM,GAAG,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC;IACrC,MAAM,GAAG,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACxD,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/src/invoice/invoice_provider.d.ts

@@ -0,0 +1,48 @@
+import type { Invoice, InvoiceOptions } from '../types.js';
+/** Context handed to invoice provider factories. */
+export interface InvoiceContext {
+    config: () => unknown;
+}
+/**
+ * The invoice emission provider contract. Gateways that emit invoices natively and
+ * dedicated providers (Focus, Tecnospeed, eNotas, PlugNotas) implement this so a charge
+ * call with `invoice: true` can emit an invoice no matter which gateway backs the payment.
+ */
+export interface InvoiceProvider {
+    readonly provider: string;
+    /** Emit an invoice. Returns the issued/pending invoice. */
+    emit(input: InvoiceEmitInput): Promise<Invoice>;
+    /** Look up an issued invoice by its id at the provider. */
+    find(invoiceId: string): Promise<Invoice | null>;
+}
+export interface InvoiceEmitInput {
+    /** The billing customer's data (name, taxId, address...). */
+    customer: {
+        name?: string;
+        taxId: string;
+        email?: string;
+        address?: Record<string, unknown>;
+    };
+    /** Amount in the currency's smallest unit (e.g. cents). */
+    amount: number;
+    currency: string;
+    /** Service details for service invoices. */
+    service: {
+        description: string;
+        /** Service code. */
+        code?: string;
+        /** Municipal service code. */
+        cityServiceCode?: string;
+    };
+    /** Tax configuration (ISS, etc.). */
+    tax?: Record<string, unknown>;
+    /** The gateway payment this invoice is attached to, when available. */
+    payment?: {
+        gatewayId: string;
+        provider: string;
+    };
+    /** Extra provider-specific fields. */
+    metadata?: Record<string, unknown>;
+}
+export type { Invoice, InvoiceOptions };
+//# sourceMappingURL=invoice_provider.d.ts.map

package/dist/src/invoice/invoice_provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice_provider.d.ts","sourceRoot":"","sources":["../../../src/invoice/invoice_provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,OAAO,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,2DAA2D;IAC3D,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhD,2DAA2D;IAC3D,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,QAAQ,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC;IACF,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,oBAAoB;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,8BAA8B;QAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,qCAAqC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,uEAAuE;IACvE,OAAO,CAAC,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/src/invoice/invoice_provider.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=invoice_provider.js.map

package/dist/src/invoice/invoice_provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice_provider.js","sourceRoot":"","sources":["../../../src/invoice/invoice_provider.ts"],"names":[],"mappings":""}

package/dist/src/money.d.ts

@@ -0,0 +1,11 @@
+import type { Money } from './types.js';
+/**
+ * Money helpers shared by the fetch-based drivers.
+ *
+ * The billing layer and the `PaymentsDriver` contract work in the currency's smallest
+ * unit (cents); the BR gateway APIs (Asaas, AbacatePay, Woovi) work in decimal reais.
+ * These two conversions are the only place that mapping lives.
+ */
+export declare function toDecimal(amount: Money): number;
+export declare function fromDecimal(value: number): Money;
+//# sourceMappingURL=money.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"money.d.ts","sourceRoot":"","sources":["../../src/money.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,CAE/C;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAEhD"}

package/dist/src/money.js

@@ -0,0 +1,14 @@
+/**
+ * Money helpers shared by the fetch-based drivers.
+ *
+ * The billing layer and the `PaymentsDriver` contract work in the currency's smallest
+ * unit (cents); the BR gateway APIs (Asaas, AbacatePay, Woovi) work in decimal reais.
+ * These two conversions are the only place that mapping lives.
+ */
+export function toDecimal(amount) {
+    return amount / 100;
+}
+export function fromDecimal(value) {
+    return Math.round(value * 100);
+}
+//# sourceMappingURL=money.js.map

package/dist/src/money.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"money.js","sourceRoot":"","sources":["../../src/money.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,MAAa;IACrC,OAAO,MAAM,GAAG,GAAG,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;AACjC,CAAC"}

package/dist/src/payments_manager.d.ts

@@ -0,0 +1,40 @@
+import type { PaymentsConfig } from './define_config.js';
+import type { PaymentsDriver } from './driver.js';
+import type { InvoiceManager } from './invoice/invoice_manager.js';
+import type { PaymentMethodName } from './types.js';
+export interface PaymentsManagerOptions {
+    drivers: Map<string, PaymentsDriver>;
+    invoices?: InvoiceManager;
+    /** Method → provider name routing (`config.methods`). */
+    methods?: Partial<Record<PaymentMethodName, string>>;
+    /** Explicit default provider name (`config.default`). */
+    defaultName?: string;
+}
+export declare class PaymentsManager {
+    #private;
+    constructor(options: PaymentsManagerOptions);
+    /**
+     * Resolve a driver by payment method (e.g. `'pix'`), by provider name, or by the
+     * configured default when nothing is given.
+     *
+     * ```ts
+     * payments.driver()          // default provider
+     * payments.driver('pix')     // provider routed in config.methods.pix
+     * payments.driver('stripe')  // provider by name
+     * ```
+     */
+    driver(methodOrName?: PaymentMethodName | string): PaymentsDriver;
+    /**
+     * Resolve an invoice provider by name (falls back to the configured default). Throws
+     * when no invoice provider is configured — a charge with `invoice: true` needs one.
+     */
+    invoice(name?: string): import("./define_config.js").InvoiceProvider;
+    /**
+     * Check a driver capability before delegating, so callers discover the limitation
+     * early (e.g. Woovi/OpenPix has no refunds) instead of at the gateway.
+     */
+    assertCapability(driver: PaymentsDriver, capability: 'refunds' | 'invoices' | 'subscriptions'): void;
+}
+/** Build the driver map from config, resolving every configured factory. */
+export declare function resolveDrivers(config: PaymentsConfig, invoices?: InvoiceManager): Promise<Map<string, PaymentsDriver>>;
+//# sourceMappingURL=payments_manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"payments_manager.d.ts","sourceRoot":"","sources":["../../src/payments_manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,yDAAyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,eAAe;;gBAMd,OAAO,EAAE,sBAAsB;IAW3C;;;;;;;;;OASG;IACH,MAAM,CAAC,YAAY,CAAC,EAAE,iBAAiB,GAAG,MAAM,GAAG,cAAc;IAqBjE;;;OAGG;IACH,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM;IASrB;;;OAGG;IACH,gBAAgB,CACd,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,SAAS,GAAG,UAAU,GAAG,eAAe,GACnD,IAAI;CA6BR;AAED,4EAA4E;AAC5E,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,EACtB,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAatC"}

package/dist/src/payments_manager.js

@@ -0,0 +1,94 @@
+export class PaymentsManager {
+    #drivers;
+    #invoices;
+    #methods;
+    #defaultName;
+    constructor(options) {
+        this.#drivers = options.drivers;
+        this.#invoices = options.invoices;
+        this.#methods = options.methods ?? {};
+        const names = [...this.#drivers.keys()];
+        if (names.length === 0) {
+            throw new Error('[payments] No drivers configured. Add a provider to config/payments.ts.');
+        }
+        this.#defaultName = options.defaultName ?? names[0];
+    }
+    /**
+     * Resolve a driver by payment method (e.g. `'pix'`), by provider name, or by the
+     * configured default when nothing is given.
+     *
+     * ```ts
+     * payments.driver()          // default provider
+     * payments.driver('pix')     // provider routed in config.methods.pix
+     * payments.driver('stripe')  // provider by name
+     * ```
+     */
+    driver(methodOrName) {
+        const { name: resolved, method } = this.#resolveName(methodOrName);
+        const driver = this.#drivers.get(resolved);
+        if (!driver) {
+            throw new Error(`[payments] Driver "${resolved}" is not configured. ` +
+                `Available drivers: ${[...this.#drivers.keys()].join(', ') || '(none)'}.`);
+        }
+        // When the call routed a payment method, make sure the provider actually supports it —
+        // e.g. routing credit_card to a Pix-only gateway (AbacatePay, Woovi) is a config error.
+        if (method !== undefined && !driver.supportedMethods.includes(method)) {
+            throw new Error(`[payments] Driver "${resolved}" does not support payment method "${method}". ` +
+                `Supported methods: ${[...driver.supportedMethods].join(', ')}. ` +
+                `Route "${method}" to a different provider in config.methods.`);
+        }
+        return driver;
+    }
+    /**
+     * Resolve an invoice provider by name (falls back to the configured default). Throws
+     * when no invoice provider is configured — a charge with `invoice: true` needs one.
+     */
+    invoice(name) {
+        if (!this.#invoices) {
+            throw new Error('[payments] No invoice providers configured. Add `invoice.providers` to config/payments.ts.');
+        }
+        return this.#invoices.provider(name);
+    }
+    /**
+     * Check a driver capability before delegating, so callers discover the limitation
+     * early (e.g. Woovi/OpenPix has no refunds) instead of at the gateway.
+     */
+    assertCapability(driver, capability) {
+        if (driver.capabilities?.[capability] === false ||
+            driver.capabilities?.[capability] === undefined) {
+            throw new Error(`[payments] Driver "${driver.provider}" does not support ${capability}. ` +
+                `Supported capabilities: ${Object.keys(driver.capabilities ?? {}).join(', ') || '(none)'}.`);
+        }
+    }
+    #resolveName(methodOrName) {
+        if (methodOrName === undefined)
+            return { name: this.#defaultName };
+        // If it names a configured provider, use it directly.
+        if (this.#drivers.has(methodOrName))
+            return { name: methodOrName };
+        // Otherwise treat it as a payment method and route via config.methods.
+        const method = methodOrName;
+        const routed = this.#methods[method];
+        if (routed !== undefined)
+            return { name: routed, method };
+        // Unknown method/name: throw a helpful error pointing at the routing config.
+        const providers = [...this.#drivers.keys()].join(', ') || '(none)';
+        throw new Error(`[payments] "${methodOrName}" is neither a configured provider nor a method routed in config.methods. Configured providers: ${providers}. Known methods: pix, credit_card, debit_card, boleto, undefined.`);
+    }
+}
+/** Build the driver map from config, resolving every configured factory. */
+export async function resolveDrivers(config, invoices) {
+    const factories = config.providers ?? {};
+    const ctx = {
+        config: () => config,
+        // Hand drivers the invoice resolver so a charge with `invoice: true|'name'` can emit
+        // a fiscal note through the configured invoice provider — independent of the gateway.
+        ...(invoices !== undefined ? { invoice: (name) => invoices.provider(name) } : {}),
+    };
+    const map = new Map();
+    for (const [name, factory] of Object.entries(factories)) {
+        map.set(name, await factory(ctx));
+    }
+    return map;
+}
+//# sourceMappingURL=payments_manager.js.map

package/dist/src/payments_manager.js.map

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

package/dist/src/services/main.d.ts

@@ -0,0 +1,6 @@
+import { PaymentsManager } from '../payments_manager.js';
+export declare function getPayments(): PaymentsManager;
+/** Set by the provider once the manager is built. */
+export declare function setPayments(manager: PaymentsManager): void;
+export default getPayments;
+//# sourceMappingURL=main.d.ts.map

package/dist/src/services/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/services/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAQzD,wBAAgB,WAAW,IAAI,eAAe,CAO7C;AAED,qDAAqD;AACrD,wBAAgB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAE1D;AAED,eAAe,WAAW,CAAC"}

package/dist/src/services/main.js

@@ -0,0 +1,17 @@
+/**
+ * Lazy singleton accessor for the payments manager. Set by the provider when it builds
+ * the manager; importing this module never triggers the app boot (media/authkit pattern).
+ */
+let payments;
+export function getPayments() {
+    if (!payments) {
+        throw new Error('[payments] PaymentsManager is not ready yet. Make sure the PaymentsProvider is registered and the app has booted.');
+    }
+    return payments;
+}
+/** Set by the provider once the manager is built. */
+export function setPayments(manager) {
+    payments = manager;
+}
+export default getPayments;
+//# sourceMappingURL=main.js.map

package/dist/src/services/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../../src/services/main.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,IAAI,QAAqC,CAAC;AAE1C,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,mHAAmH,CACpH,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,WAAW,CAAC,OAAwB;IAClD,QAAQ,GAAG,OAAO,CAAC;AACrB,CAAC;AAED,eAAe,WAAW,CAAC"}

package/dist/src/telescope/index.d.ts

@@ -0,0 +1,3 @@
+export { PaymentsWatcher } from './payments_watcher.js';
+export type { WatcherContext } from './telescope-sdk.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/telescope/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/src/telescope/index.js

@@ -0,0 +1,2 @@
+export { PaymentsWatcher } from './payments_watcher.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/telescope/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/src/telescope/payments_watcher.d.ts

@@ -0,0 +1,27 @@
+import type { WatcherContext } from './telescope-sdk.js';
+/**
+ * A payments-specific Telescope watcher: records a typed `payments` entry for every
+ * milestone `agora:payments:*` event the library emits (charges, refunds,
+ * subscriptions, invoice emission, webhook lifecycle), flattening the event's payload
+ * into structured content rather than storing the raw envelope like the generic
+ * diagnostics bridge does.
+ *
+ * Zero coupling: payments publishes via the structural `@adonis-agora/diagnostics`
+ * emit slot; this subscribes to the same `node:diagnostics_channel` channels — neither
+ * package is imported.
+ *
+ * De-dup: `register()` CLAIMS every recorded channel via
+ * {@link claimPaymentsDiagnostics} (the reference-counted
+ * `Symbol.for('@agora/diagnostics:claims')` registry), so the generic
+ * `DiagnosticsWatcher` (its `recordClaimed: false` default) skips them and no event is
+ * recorded twice. `dispose()` releases the claim and detaches every subscription.
+ */
+export declare class PaymentsWatcher {
+    readonly type = "payments";
+    private readonly disposers;
+    /** Claim the recorded channels and start recording a typed `payments` entry per event. */
+    register(ctx: WatcherContext): void;
+    /** Release the channel claims and detach every subscription (e.g. on shutdown). */
+    dispose(): void;
+}
+//# sourceMappingURL=payments_watcher.d.ts.map

package/dist/src/telescope/payments_watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments_watcher.d.ts","sourceRoot":"","sources":["../../../src/telescope/payments_watcher.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAkBzD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAe;IAC1B,QAAQ,CAAC,IAAI,cAAc;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IAEnD,0FAA0F;IAC1F,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI;IAuBnC,mFAAmF;IACnF,OAAO,IAAI,IAAI;CAGhB"}