@adonis-agora/payments 0.2.0

package/dist/src/index.d.ts

@@ -0,0 +1,29 @@
+export { defineConfig, payments, invoice } from './define_config.js';
+export type { PaymentsConfig, PaymentsContext, PaymentsDriverFactory, InvoiceContext, InvoiceProviderFactory, StripeDriverConfig, AbacateDriverConfig, AsaasDriverConfig, WooviDriverConfig, FocusInvoiceConfig, ENotasInvoiceConfig, PlugNotasInvoiceConfig, AsaasInvoiceConfig, TecnospeedInvoiceConfig, } from './define_config.js';
+export { PaymentsManager, resolveDrivers } from './payments_manager.js';
+export type { WooviSubAccount } from './drivers/woovi.js';
+export type { PaymentsDriver, CreateCustomerInput, UpdateCustomerInput, ChargeInput, CheckoutInput, CreateSubscriptionInput, UpdateSubscriptionInput, } from './driver.js';
+export { InvoiceManager, resolveInvoiceProviders } from './invoice/invoice_manager.js';
+export type { InvoiceProvider, InvoiceEmitInput } from './invoice/invoice_provider.js';
+export { emitInvoice, emitInvoiceIfRequested } from './invoice/emit_invoice.js';
+export type { EmitInvoiceContext, EmitInvoiceData } from './invoice/emit_invoice.js';
+export { httpRequest, headerValue, isNotFound } from './http.js';
+export type { HttpRequestOptions } from './http.js';
+export { toDecimal, fromDecimal } from './money.js';
+export { ensureCustomer } from './ensure_customer.js';
+export { isWebhookHandlerService, resolveWebhookHandler, normalizeWebhookHandlerModule, discoverWebhookHandlers, loadWebhookHandlersFromBarrel, pickModuleExt, } from './webhook_handlers.js';
+export type { WebhookHandlerService, WebhookHandlerModule, DiscoveredWebhookHandler, WebhookHandlersBarrel, } from './webhook_handlers.js';
+export { PAYMENTS_DIAGNOSTIC_EVENTS, publishPayments, publishPaymentDiagnostics, publishRefundDiagnostics, publishSubscriptionDiagnostics, publishInvoiceEmittedDiagnostics, claimPaymentsDiagnostics, isPaymentsDiagnosticClaimed, tracePayments, } from './diagnostics.js';
+export type { PaymentsDiagnosticEvent, PaymentsDiagnosticPayloads, } from './diagnostics.js';
+export { WebhookProcessor } from './billing/webhook_processor.js';
+export type { WebhookHandler } from './billing/webhook_processor.js';
+export { LucidBillingStore, lucidBillingStore } from './billing/lucid_billing_store.js';
+export type { BillingModels } from './billing/lucid_billing_store.js';
+export type { BillingStore } from './billing/billing_store.js';
+export { BillingUsageEvent } from './billing/mixins/with_usage_event.js';
+export { billingOverview } from './billing/billing_overview.js';
+export type { BillingOverview, BillingOverviewMetric } from './billing/billing_overview.js';
+export { meteredBill, meteredBillForSubscription } from './billing/metered_bill.js';
+export type { MeterRate, MeteredBill, MeteredBillLine } from './billing/metered_bill.js';
+export type { Money, Currency, BillingStatus, SubscriptionStatus, PaymentMethodType, PaymentMethodName, MoneyAmount, Customer, Payment, Refund, CheckoutSession, Subscription, Invoice, InvoiceOptions, WebhookEvent, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACrE,YAAY,EACV,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACxE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,aAAa,EACb,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvF,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAChF,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACjE,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,6BAA6B,EAC7B,uBAAuB,EACvB,6BAA6B,EAC7B,aAAa,GACd,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,0BAA0B,EAC1B,eAAe,EACf,yBAAyB,EACzB,wBAAwB,EACxB,8BAA8B,EAC9B,gCAAgC,EAChC,wBAAwB,EACxB,2BAA2B,EAC3B,aAAa,GACd,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,YAAY,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACxF,YAAY,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACpF,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACzF,YAAY,EACV,KAAK,EACL,QAAQ,EACR,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,QAAQ,EACR,OAAO,EACP,MAAM,EACN,eAAe,EACf,YAAY,EACZ,OAAO,EACP,cAAc,EACd,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,15 @@
+export { defineConfig, payments, invoice } from './define_config.js';
+export { PaymentsManager, resolveDrivers } from './payments_manager.js';
+export { InvoiceManager, resolveInvoiceProviders } from './invoice/invoice_manager.js';
+export { emitInvoice, emitInvoiceIfRequested } from './invoice/emit_invoice.js';
+export { httpRequest, headerValue, isNotFound } from './http.js';
+export { toDecimal, fromDecimal } from './money.js';
+export { ensureCustomer } from './ensure_customer.js';
+export { isWebhookHandlerService, resolveWebhookHandler, normalizeWebhookHandlerModule, discoverWebhookHandlers, loadWebhookHandlersFromBarrel, pickModuleExt, } from './webhook_handlers.js';
+export { PAYMENTS_DIAGNOSTIC_EVENTS, publishPayments, publishPaymentDiagnostics, publishRefundDiagnostics, publishSubscriptionDiagnostics, publishInvoiceEmittedDiagnostics, claimPaymentsDiagnostics, isPaymentsDiagnosticClaimed, tracePayments, } from './diagnostics.js';
+export { WebhookProcessor } from './billing/webhook_processor.js';
+export { LucidBillingStore, lucidBillingStore } from './billing/lucid_billing_store.js';
+export { BillingUsageEvent } from './billing/mixins/with_usage_event.js';
+export { billingOverview } from './billing/billing_overview.js';
+export { meteredBill, meteredBillForSubscription } from './billing/metered_bill.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAiBrE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAWxE,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvF,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAEhF,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,6BAA6B,EAC7B,uBAAuB,EACvB,6BAA6B,EAC7B,aAAa,GACd,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EACL,0BAA0B,EAC1B,eAAe,EACf,yBAAyB,EACzB,wBAAwB,EACxB,8BAA8B,EAC9B,gCAAgC,EAChC,wBAAwB,EACxB,2BAA2B,EAC3B,aAAa,GACd,MAAM,kBAAkB,CAAC;AAK1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAGxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,OAAO,EAAE,WAAW,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/src/invoice/drivers/asaas.d.ts

@@ -0,0 +1,23 @@
+import type { Invoice } from '../../types.js';
+import type { InvoiceEmitInput, InvoiceProvider } from '../invoice_provider.js';
+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;
+}
+/**
+ * Asaas native NFS-e invoice provider — emits the fiscal note through Asaas's own
+ * invoice API (`/v3/invoices`), so a charge through Asaas with `invoice: true` uses the
+ * same gateway that took the payment. Uses `fetch` directly (no SDK dependency).
+ */
+export declare class AsaasInvoiceProvider implements InvoiceProvider {
+    #private;
+    readonly provider = "asaas";
+    constructor(_ctx: {
+        config: () => unknown;
+    }, config?: AsaasInvoiceConfig);
+    emit(input: InvoiceEmitInput): Promise<Invoice>;
+    find(invoiceId: string): Promise<Invoice | null>;
+}
+//# sourceMappingURL=asaas.d.ts.map

package/dist/src/invoice/drivers/asaas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asaas.d.ts","sourceRoot":"","sources":["../../../../src/invoice/drivers/asaas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEhF,MAAM,WAAW,kBAAkB;IACjC,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAaD;;;;GAIG;AACH,qBAAa,oBAAqB,YAAW,eAAe;;IAC1D,QAAQ,CAAC,QAAQ,WAAW;gBAKhB,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,OAAO,CAAA;KAAE,EAAE,MAAM,GAAE,kBAAuB;IAYtE,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IA+B/C,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;CAqCvD"}

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

@@ -0,0 +1,85 @@
+/**
+ * Asaas native NFS-e invoice provider — emits the fiscal note through Asaas's own
+ * invoice API (`/v3/invoices`), so a charge through Asaas with `invoice: true` uses the
+ * same gateway that took the payment. Uses `fetch` directly (no SDK dependency).
+ */
+export class AsaasInvoiceProvider {
+    provider = 'asaas';
+    #apiKey;
+    #baseUrl;
+    constructor(_ctx, config = {}) {
+        const apiKey = config.apiKey ?? process.env.ASAAS_API_KEY;
+        if (!apiKey) {
+            throw new Error('[payments] Asaas invoice provider requires an API key. Set `ASAAS_API_KEY` env or pass `apiKey` to `invoice.asaas()`.');
+        }
+        const sandbox = config.sandbox ?? process.env.NODE_ENV !== 'production';
+        this.#baseUrl = sandbox ? 'https://api-sandbox.asaas.com/v3' : 'https://api.asaas.com/v3';
+        this.#apiKey = apiKey;
+    }
+    async emit(input) {
+        const body = {
+            customer: input.customer.taxId.replace(/\D/g, ''),
+            value: input.amount / 100,
+            serviceDescription: input.service.description,
+            ...(input.service.code !== undefined ? { serviceCode: input.service.code } : {}),
+            ...(input.service.cityServiceCode !== undefined
+                ? { municipalServiceCode: input.service.cityServiceCode }
+                : {}),
+            ...(input.customer.name !== undefined ? { description: input.customer.name } : {}),
+            ...(input.customer.email !== undefined ? { notes: input.customer.email } : {}),
+            ...(input.tax !== undefined ? { taxes: input.tax } : {}),
+            ...(input.metadata !== undefined ? { observations: JSON.stringify(input.metadata) } : {}),
+        };
+        const response = await fetch(`${this.#baseUrl}/invoices`, {
+            method: 'POST',
+            headers: {
+                access_token: this.#apiKey,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`[payments] Asaas invoice request failed (${response.status}): ${text}`);
+        }
+        const data = (await response.json());
+        return this.#mapInvoice(data);
+    }
+    async find(invoiceId) {
+        const response = await fetch(`${this.#baseUrl}/invoices/${encodeURIComponent(invoiceId)}`, {
+            headers: { access_token: this.#apiKey },
+        });
+        if (response.status === 404)
+            return null;
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`[payments] Asaas invoice request failed (${response.status}): ${text}`);
+        }
+        const data = (await response.json());
+        return this.#mapInvoice(data);
+    }
+    #mapInvoice(data) {
+        const status = data.status ?? 'PENDING';
+        const normalized = status === 'AUTHORIZED' || status === 'PAID'
+            ? 'issued'
+            : status === 'CANCELED' || status === 'REJECTED'
+                ? 'canceled'
+                : 'pending';
+        return {
+            id: data.id,
+            gatewayId: data.id,
+            provider: this.provider,
+            ...(data.nfseNumber !== undefined ? { number: data.nfseNumber } : {}),
+            ...(data.nfseAccessKey !== undefined ? { key: data.nfseAccessKey } : {}),
+            ...(data.invoiceUrl !== undefined
+                ? { url: data.invoiceUrl, hostedPdfUrl: data.invoiceUrl }
+                : {}),
+            status: normalized,
+            ...(data.pdfUrl !== undefined ? { hostedPdfUrl: data.pdfUrl } : {}),
+            amount: { amount: Math.round(Number(data.value ?? 0) * 100), currency: 'brl' },
+            createdAt: new Date().toISOString(),
+            payload: data,
+        };
+    }
+}
+//# sourceMappingURL=asaas.js.map

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

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

package/dist/src/invoice/drivers/enotas.d.ts

@@ -0,0 +1,23 @@
+import type { Invoice } from '../../types.js';
+import type { InvoiceEmitInput, InvoiceProvider } from '../invoice_provider.js';
+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;
+}
+/**
+ * eNotas invoice provider — REST API for NFS-e/NF-e across Brazilian municipalities.
+ * Uses `fetch` directly (no SDK dependency). Exact field names follow the eNotas API;
+ * if a municipality/plan variant differs, extend this driver (see Custom providers).
+ */
+export declare class ENotasInvoiceProvider implements InvoiceProvider {
+    #private;
+    readonly provider = "enotas";
+    constructor(_ctx: {
+        config: () => unknown;
+    }, config?: ENotasInvoiceConfig);
+    emit(input: InvoiceEmitInput): Promise<Invoice>;
+    find(invoiceId: string): Promise<Invoice | null>;
+}
+//# sourceMappingURL=enotas.d.ts.map

package/dist/src/invoice/drivers/enotas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enotas.d.ts","sourceRoot":"","sources":["../../../../src/invoice/drivers/enotas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEhF,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAYD;;;;GAIG;AACH,qBAAa,qBAAsB,YAAW,eAAe;;IAC3D,QAAQ,CAAC,QAAQ,YAAY;gBAKjB,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,OAAO,CAAA;KAAE,EAAE,MAAM,GAAE,mBAAwB;IAWvE,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAiC/C,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;CAkCvD"}

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

@@ -0,0 +1,83 @@
+/**
+ * eNotas invoice provider — REST API for NFS-e/NF-e across Brazilian municipalities.
+ * Uses `fetch` directly (no SDK dependency). Exact field names follow the eNotas API;
+ * if a municipality/plan variant differs, extend this driver (see Custom providers).
+ */
+export class ENotasInvoiceProvider {
+    provider = 'enotas';
+    #apiKey;
+    #baseUrl;
+    constructor(_ctx, config = {}) {
+        const apiKey = config.apiKey ?? process.env.ENOTAS_API_KEY;
+        if (!apiKey) {
+            throw new Error('[payments] eNotas invoice provider requires an API key. Set `ENOTAS_API_KEY` env or pass `apiKey` to `invoice.enotas()`.');
+        }
+        this.#apiKey = apiKey;
+        this.#baseUrl = config.baseUrl ?? 'https://api.enotasgw.com.br/v1';
+    }
+    async emit(input) {
+        const body = {
+            cliente: {
+                nome: input.customer.name ?? 'Cliente',
+                email: input.customer.email,
+                pessoaFisica: input.customer.taxId.length <= 11,
+                cpf: input.customer.taxId.replace(/\D/g, ''),
+                endereco: input.customer.address ?? undefined,
+            },
+            servico: {
+                descricao: input.service.description,
+                codigoServico: input.service.code,
+                valor: input.amount / 100,
+            },
+            ...(input.tax !== undefined ? { impostos: input.tax } : {}),
+        };
+        const response = await fetch(`${this.#baseUrl}/empresas/nfes`, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${this.#apiKey}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`[payments] eNotas invoice request failed (${response.status}): ${text}`);
+        }
+        const data = (await response.json());
+        return this.#mapInvoice(data);
+    }
+    async find(invoiceId) {
+        const response = await fetch(`${this.#baseUrl}/nfes/${encodeURIComponent(invoiceId)}`, {
+            headers: { Authorization: `Bearer ${this.#apiKey}` },
+        });
+        if (response.status === 404)
+            return null;
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`[payments] eNotas 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 === 'AUTORIZADA'
+            ? 'issued'
+            : status === 'CANCELADO' || status === 'REJEITADO'
+                ? 'canceled'
+                : 'pending';
+        return {
+            id: data.id ?? data.numero ?? String(Math.random()),
+            gatewayId: data.id ?? data.numero ?? '',
+            provider: this.provider,
+            ...(data.numero !== undefined ? { number: data.numero } : {}),
+            ...(data.urlDanfe !== undefined ? { url: data.urlDanfe, hostedPdfUrl: data.urlDanfe } : {}),
+            status: normalized,
+            ...(data.dataEmissao !== undefined ? { issuedAt: data.dataEmissao } : {}),
+            amount: { amount: Math.round(Number(data.valor ?? 0) * 100), currency: 'brl' },
+            createdAt: data.dataEmissao ?? new Date().toISOString(),
+            payload: data,
+        };
+    }
+}
+//# sourceMappingURL=enotas.js.map

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

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

package/dist/src/invoice/drivers/focus.d.ts

@@ -0,0 +1,23 @@
+import type { Invoice } from '../../types.js';
+import type { InvoiceEmitInput, InvoiceProvider } from '../invoice_provider.js';
+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;
+}
+/**
+ * Focus NFe invoice provider — REST API for electronic invoices across hundreds of
+ * municipalities. Uses `fetch` directly (no SDK dependency), so Focus is not a peer
+ * dependency. (The `NFe`/`nfse` names below are Focus's own API identifiers.)
+ */
+export declare class FocusInvoiceProvider implements InvoiceProvider {
+    #private;
+    readonly provider = "focus";
+    constructor(_ctx: {
+        config: () => unknown;
+    }, config?: FocusInvoiceConfig);
+    emit(input: InvoiceEmitInput): Promise<Invoice>;
+    find(invoiceId: string): Promise<Invoice | null>;
+}
+//# sourceMappingURL=focus.d.ts.map

package/dist/src/invoice/drivers/focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.d.ts","sourceRoot":"","sources":["../../../../src/invoice/drivers/focus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEhF,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAYD;;;;GAIG;AACH,qBAAa,oBAAqB,YAAW,eAAe;;IAC1D,QAAQ,CAAC,QAAQ,WAAW;gBAKhB,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,OAAO,CAAA;KAAE,EAAE,MAAM,GAAE,kBAAuB;IAWtE,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAqC/C,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;CAqCvD"}

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

@@ -0,0 +1,90 @@
+/**
+ * Focus NFe invoice provider — REST API for electronic invoices across hundreds of
+ * municipalities. Uses `fetch` directly (no SDK dependency), so Focus is not a peer
+ * dependency. (The `NFe`/`nfse` names below are Focus's own API identifiers.)
+ */
+export class FocusInvoiceProvider {
+    provider = 'focus';
+    #token;
+    #baseUrl;
+    constructor(_ctx, config = {}) {
+        const token = config.token ?? process.env.FOCUS_NFE_TOKEN;
+        if (!token) {
+            throw new Error('[payments] Focus invoice provider requires a token. Set `FOCUS_NFE_TOKEN` env or pass `token` to `invoice.focus()`.');
+        }
+        this.#token = token;
+        this.#baseUrl = config.baseUrl ?? 'https://api.focusnfe.com.br';
+    }
+    async emit(input) {
+        // Focus service-invoice endpoint.
+        const body = {
+            tomador: {
+                cpf_cnpj: input.customer.taxId.replace(/\D/g, ''),
+                nome: 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).toFixed(2),
+            ...(input.tax !== undefined ? { impostos: input.tax } : {}),
+            ...(input.metadata !== undefined ? { metadados: input.metadata } : {}),
+        };
+        const response = await fetch(`${this.#baseUrl}/v2/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] Focus NFe request failed (${response.status}): ${text}`);
+        }
+        const data = (await response.json());
+        return this.#mapInvoice(data);
+    }
+    async find(invoiceId) {
+        const response = await fetch(`${this.#baseUrl}/v2/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] Focus NFe request failed (${response.status}): ${text}`);
+        }
+        const data = (await response.json());
+        return this.#mapInvoice(data);
+    }
+    #mapInvoice(data) {
+        const status = data.status ?? 'pendente';
+        const normalized = status === 'autorizado'
+            ? 'issued'
+            : status === 'cancelado' || status === 'rejeitado'
+                ? 'canceled'
+                : 'pending';
+        return {
+            id: data.ref ?? data.numero ?? String(Math.random()),
+            gatewayId: data.ref ?? data.numero ?? '',
+            provider: this.provider,
+            number: data.numero ?? '',
+            ...(data.chave !== undefined ? { key: data.chave } : {}),
+            ...(data.caminho_danfe !== undefined
+                ? { url: data.caminho_danfe, hostedPdfUrl: data.caminho_danfe }
+                : {}),
+            status: normalized,
+            ...(data.data_emissao !== undefined ? { issuedAt: data.data_emissao } : {}),
+            amount: { amount: Math.round(Number(data.valor ?? 0) * 100), currency: 'brl' },
+            createdAt: data.data_emissao ?? new Date().toISOString(),
+            payload: data,
+        };
+    }
+}
+//# sourceMappingURL=focus.js.map

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

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

package/dist/src/invoice/drivers/plugnotas.d.ts

@@ -0,0 +1,22 @@
+import type { Invoice } from '../../types.js';
+import type { InvoiceEmitInput, InvoiceProvider } from '../invoice_provider.js';
+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;
+}
+/**
+ * PlugNotas invoice provider — NFS-e API. Uses `fetch` directly (no SDK dependency).
+ * Exact field names follow the PlugNotas API; if a variant differs, extend this driver.
+ */
+export declare class PlugNotasInvoiceProvider implements InvoiceProvider {
+    #private;
+    readonly provider = "plugnotas";
+    constructor(_ctx: {
+        config: () => unknown;
+    }, config?: PlugNotasInvoiceConfig);
+    emit(input: InvoiceEmitInput): Promise<Invoice>;
+    find(invoiceId: string): Promise<Invoice | null>;
+}
+//# sourceMappingURL=plugnotas.d.ts.map

package/dist/src/invoice/drivers/plugnotas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugnotas.d.ts","sourceRoot":"","sources":["../../../../src/invoice/drivers/plugnotas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEhF,MAAM,WAAW,sBAAsB;IACrC,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAYD;;;GAGG;AACH,qBAAa,wBAAyB,YAAW,eAAe;;IAC9D,QAAQ,CAAC,QAAQ,eAAe;gBAKpB,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,OAAO,CAAA;KAAE,EAAE,MAAM,GAAE,sBAA2B;IAW1E,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAgC/C,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;CAkCvD"}

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

@@ -0,0 +1,81 @@
+/**
+ * PlugNotas invoice provider — NFS-e API. Uses `fetch` directly (no SDK dependency).
+ * Exact field names follow the PlugNotas API; if a variant differs, extend this driver.
+ */
+export class PlugNotasInvoiceProvider {
+    provider = 'plugnotas';
+    #apiKey;
+    #baseUrl;
+    constructor(_ctx, config = {}) {
+        const apiKey = config.apiKey ?? process.env.PLUGNOTAS_API_KEY;
+        if (!apiKey) {
+            throw new Error('[payments] PlugNotas invoice provider requires an API key. Set `PLUGNOTAS_API_KEY` env or pass `apiKey` to `invoice.plugnotas()`.');
+        }
+        this.#apiKey = apiKey;
+        this.#baseUrl = config.baseUrl ?? 'https://api.plugnotas.com.br';
+    }
+    async emit(input) {
+        const body = {
+            tomador: {
+                cpfCnpj: input.customer.taxId.replace(/\D/g, ''),
+                razaoSocial: input.customer.name ?? 'Cliente',
+                email: input.customer.email,
+                endereco: input.customer.address ?? undefined,
+            },
+            servico: {
+                descricao: input.service.description,
+                codigoServico: input.service.code,
+            },
+            valor: input.amount / 100,
+            ...(input.tax !== undefined ? { impostos: input.tax } : {}),
+        };
+        const response = await fetch(`${this.#baseUrl}/nfse`, {
+            method: 'POST',
+            headers: {
+                'X-API-KEY': this.#apiKey,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`[payments] PlugNotas 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: { 'X-API-KEY': this.#apiKey },
+        });
+        if (response.status === 404)
+            return null;
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`[payments] PlugNotas 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 === 'AUTORIZADA' || status === 'emitido'
+            ? 'issued'
+            : status === 'CANCELADO' || status === 'REJEITADO' || status === 'cancelado'
+                ? 'canceled'
+                : 'pending';
+        return {
+            id: data.id ?? data.numero ?? String(Math.random()),
+            gatewayId: data.id ?? data.numero ?? '',
+            provider: this.provider,
+            ...(data.numero !== undefined ? { number: data.numero } : {}),
+            ...(data.urlPdf !== undefined ? { url: data.urlPdf, hostedPdfUrl: data.urlPdf } : {}),
+            status: normalized,
+            ...(data.dataEmissao !== undefined ? { issuedAt: data.dataEmissao } : {}),
+            amount: { amount: Math.round(Number(data.valor ?? 0) * 100), currency: 'brl' },
+            createdAt: data.dataEmissao ?? new Date().toISOString(),
+            payload: data,
+        };
+    }
+}
+//# sourceMappingURL=plugnotas.js.map

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

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

package/dist/src/invoice/drivers/tecnospeed.d.ts

@@ -0,0 +1,29 @@
+import type { Invoice } from '../../types.js';
+import type { InvoiceEmitInput, InvoiceProvider } from '../invoice_provider.js';
+export interface TecnospeedInvoiceConfig {
+    /** Tecnospeed API token. Defaults to `env.get('TECNOSPEED_TOKEN')`. */
+    token?: string;
+    /**
+     * Tecnospeed API base URL. The NFS-e API is per-municipality (and the national layout
+     * moved to an XML DPS at `https://tributario.speedgov.com.br/{municipio}/api/v1`), so
+     * point this at your municipality/plan endpoint. Defaults to the generic v1 base.
+     */
+    baseUrl?: string;
+}
+/**
+ * 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 declare class TecnospeedInvoiceProvider implements InvoiceProvider {
+    #private;
+    readonly provider = "tecnospeed";
+    constructor(_ctx: {
+        config: () => unknown;
+    }, config?: TecnospeedInvoiceConfig);
+    emit(input: InvoiceEmitInput): Promise<Invoice>;
+    find(invoiceId: string): Promise<Invoice | null>;
+}
+//# sourceMappingURL=tecnospeed.d.ts.map

package/dist/src/invoice/drivers/tecnospeed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tecnospeed.d.ts","sourceRoot":"","sources":["../../../../src/invoice/drivers/tecnospeed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEhF,MAAM,WAAW,uBAAuB;IACtC,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAWD;;;;;;GAMG;AACH,qBAAa,yBAA0B,YAAW,eAAe;;IAC/D,QAAQ,CAAC,QAAQ,gBAAgB;gBAKrB,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,OAAO,CAAA;KAAE,EAAE,MAAM,GAAE,uBAA4B;IAW3E,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAmC/C,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;CAkCvD"}