@adonis-agora/payments 0.2.0

package/dist/src/telescope/payments_watcher.js

@@ -0,0 +1,58 @@
+import { subscribe, unsubscribe } from 'node:diagnostics_channel';
+import { PAYMENTS_DIAGNOSTIC_EVENTS, claimPaymentsDiagnostics, } from '../diagnostics.js';
+/** All payments milestones are low-frequency — record every one of them. */
+const RECORDED_EVENTS = [...PAYMENTS_DIAGNOSTIC_EVENTS];
+/** The `agora:payments:<event>` `node:diagnostics_channel` name — the cross-repo wire contract, replicated structurally (payments never imports `@adonis-agora/diagnostics`). */
+function paymentsChannelName(event) {
+    return `agora:payments:${event}`;
+}
+/**
+ * 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 class PaymentsWatcher {
+    type = 'payments';
+    disposers = [];
+    /** Claim the recorded channels and start recording a typed `payments` entry per event. */
+    register(ctx) {
+        this.disposers.push(claimPaymentsDiagnostics(RECORDED_EVENTS));
+        for (const event of RECORDED_EVENTS) {
+            const channel = paymentsChannelName(event);
+            const onMessage = (message) => {
+                const envelope = message;
+                if (envelope === null || typeof envelope !== 'object')
+                    return;
+                ctx.record({
+                    type: this.type,
+                    content: {
+                        event: envelope.event,
+                        ...(envelope.ts !== undefined ? { ts: envelope.ts } : {}),
+                        ...(envelope.traceId !== undefined ? { traceId: envelope.traceId } : {}),
+                        ...(envelope.payload ?? {}),
+                    },
+                });
+            };
+            subscribe(channel, onMessage);
+            this.disposers.push(() => unsubscribe(channel, onMessage));
+        }
+    }
+    /** Release the channel claims and detach every subscription (e.g. on shutdown). */
+    dispose() {
+        while (this.disposers.length)
+            this.disposers.pop()?.();
+    }
+}
+//# sourceMappingURL=payments_watcher.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"payments_watcher.js","sourceRoot":"","sources":["../../../src/telescope/payments_watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EACL,0BAA0B,EAE1B,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAG3B,4EAA4E;AAC5E,MAAM,eAAe,GAA8B,CAAC,GAAG,0BAA0B,CAAC,CAAC;AAEnF,iLAAiL;AACjL,SAAS,mBAAmB,CAAC,KAAa;IACxC,OAAO,kBAAkB,KAAK,EAAE,CAAC;AACnC,CAAC;AAUD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,eAAe;IACjB,IAAI,GAAG,UAAU,CAAC;IACV,SAAS,GAAsB,EAAE,CAAC;IAEnD,0FAA0F;IAC1F,QAAQ,CAAC,GAAmB;QAC1B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,wBAAwB,CAAC,eAAe,CAAC,CAAC,CAAC;QAE/D,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;YAC3C,MAAM,SAAS,GAAG,CAAC,OAAgB,EAAE,EAAE;gBACrC,MAAM,QAAQ,GAAG,OAAqC,CAAC;gBACvD,IAAI,QAAQ,KAAK,IAAI,IAAI,OAAO,QAAQ,KAAK,QAAQ;oBAAE,OAAO;gBAC9D,GAAG,CAAC,MAAM,CAAC;oBACT,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,OAAO,EAAE;wBACP,KAAK,EAAE,QAAQ,CAAC,KAAK;wBACrB,GAAG,CAAC,QAAQ,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBACzD,GAAG,CAAC,QAAQ,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBACxE,GAAG,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;qBAC5B;iBACF,CAAC,CAAC;YACL,CAAC,CAAC;YACF,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAC9B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,mFAAmF;IACnF,OAAO;QACL,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM;YAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC;IACzD,CAAC;CACF"}

package/dist/src/telescope/telescope-sdk.d.ts

@@ -0,0 +1,21 @@
+/**
+ * A local, structural mirror of the `@adonis-agora/telescope` watcher contract.
+ *
+ * We deliberately do NOT import `@adonis-agora/telescope` — it lives in a separate repo,
+ * and is only an OPTIONAL peer (a host may run `@adonis-agora/payments` without any
+ * observability at all). Same cross-repo decoupling as the payments diagnostics slot
+ * itself and `@adonis-agora/media`'s `src/telescope/telescope-sdk.ts`. Keep these in
+ * lockstep with `@adonis-agora/telescope`'s watcher types.
+ */
+/**
+ * The recording surface a {@link PaymentsWatcher} is handed on `register`. Mirror of
+ * telescope's `WatcherContext` — a host wires the watcher to a real telescope store's
+ * `record`.
+ */
+export interface WatcherContext {
+    record(entry: {
+        type: string;
+        content: unknown;
+    }): void;
+}
+//# sourceMappingURL=telescope-sdk.d.ts.map

package/dist/src/telescope/telescope-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telescope-sdk.d.ts","sourceRoot":"","sources":["../../../src/telescope/telescope-sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;CACzD"}

package/dist/src/telescope/telescope-sdk.js

@@ -0,0 +1,11 @@
+/**
+ * A local, structural mirror of the `@adonis-agora/telescope` watcher contract.
+ *
+ * We deliberately do NOT import `@adonis-agora/telescope` — it lives in a separate repo,
+ * and is only an OPTIONAL peer (a host may run `@adonis-agora/payments` without any
+ * observability at all). Same cross-repo decoupling as the payments diagnostics slot
+ * itself and `@adonis-agora/media`'s `src/telescope/telescope-sdk.ts`. Keep these in
+ * lockstep with `@adonis-agora/telescope`'s watcher types.
+ */
+export {};
+//# sourceMappingURL=telescope-sdk.js.map

package/dist/src/telescope/telescope-sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telescope-sdk.js","sourceRoot":"","sources":["../../../src/telescope/telescope-sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/src/testing/fake_payments_driver.d.ts

@@ -0,0 +1,64 @@
+import type { PaymentsDriver, UpdateSubscriptionInput } from '../driver.js';
+import type { CheckoutSession, Customer, Invoice, Payment, Refund, Subscription, WebhookEvent } from '../types.js';
+export interface FakePaymentsDriverOptions {
+    provider?: string;
+    /** Queue of webhook events `parseWebhook` returns (in order). */
+    webhookEvents?: WebhookEvent[];
+}
+/**
+ * In-memory {@link PaymentsDriver} for tests and local development. Records every call and
+ * returns canned responses, so billing flows can be exercised without a gateway.
+ */
+export declare class FakePaymentsDriver implements PaymentsDriver {
+    readonly provider: string;
+    readonly supportedMethods: readonly ["pix", "credit_card", "boleto", "debit_card", "undefined"];
+    /** Canned webhook events returned by `parseWebhook`, in order. */
+    webhookEvents: WebhookEvent[];
+    createCustomerCalls: {
+        input: Parameters<PaymentsDriver['createCustomer']>[0];
+    }[];
+    chargeCalls: {
+        input: Parameters<PaymentsDriver['charge']>[0];
+    }[];
+    refundCalls: {
+        paymentGatewayId: string;
+        amount?: number;
+    }[];
+    createCheckoutCalls: {
+        input: Parameters<PaymentsDriver['createCheckout']>[0];
+    }[];
+    createSubscriptionCalls: {
+        input: Parameters<PaymentsDriver['createSubscription']>[0];
+    }[];
+    cancelSubscriptionCalls: {
+        id: string;
+        options?: {
+            atPeriodEnd?: boolean;
+        };
+    }[];
+    updateSubscriptionCalls: {
+        id: string;
+        input: UpdateSubscriptionInput;
+    }[];
+    customers: Map<string, Customer>;
+    payments: Map<string, Payment>;
+    subscriptions: Map<string, Subscription>;
+    invoices: Invoice[];
+    constructor(options?: FakePaymentsDriverOptions);
+    createCustomer(input: Parameters<PaymentsDriver['createCustomer']>[0]): Promise<Customer>;
+    findCustomer(customerId: string): Promise<Customer | null>;
+    updateCustomer(customerId: string, input: Parameters<PaymentsDriver['updateCustomer']>[1]): Promise<Customer>;
+    charge(input: Parameters<PaymentsDriver['charge']>[0]): Promise<Payment>;
+    findPayment(gatewayId: string): Promise<Payment | null>;
+    refund(paymentGatewayId: string, amount?: number): Promise<Refund>;
+    createCheckout(input: Parameters<PaymentsDriver['createCheckout']>[0]): Promise<CheckoutSession>;
+    createSubscription(input: Parameters<PaymentsDriver['createSubscription']>[0]): Promise<Subscription>;
+    cancelSubscription(subscriptionGatewayId: string, options?: {
+        atPeriodEnd?: boolean;
+    }): Promise<Subscription>;
+    findSubscription(gatewayId: string): Promise<Subscription | null>;
+    updateSubscription(subscriptionGatewayId: string, input: UpdateSubscriptionInput): Promise<Subscription>;
+    listInvoices(_customerId: string): Promise<Invoice[]>;
+    parseWebhook(_rawBody: string, _headers: Record<string, string | string[] | undefined>): WebhookEvent;
+}
+//# sourceMappingURL=fake_payments_driver.d.ts.map

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

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

package/dist/src/testing/fake_payments_driver.js

@@ -0,0 +1,171 @@
+/**
+ * In-memory {@link PaymentsDriver} for tests and local development. Records every call and
+ * returns canned responses, so billing flows can be exercised without a gateway.
+ */
+export class FakePaymentsDriver {
+    provider;
+    supportedMethods = ['pix', 'credit_card', 'boleto', 'debit_card', 'undefined'];
+    /** Canned webhook events returned by `parseWebhook`, in order. */
+    webhookEvents;
+    // Call records for assertions.
+    createCustomerCalls = [];
+    chargeCalls = [];
+    refundCalls = [];
+    createCheckoutCalls = [];
+    createSubscriptionCalls = [];
+    cancelSubscriptionCalls = [];
+    updateSubscriptionCalls = [];
+    // Canned results.
+    customers = new Map();
+    payments = new Map();
+    subscriptions = new Map();
+    invoices = [];
+    constructor(options = {}) {
+        this.provider = options.provider ?? 'fake';
+        this.webhookEvents = options.webhookEvents ?? [];
+    }
+    async createCustomer(input) {
+        this.createCustomerCalls.push({ input });
+        const customer = {
+            id: `cus_${this.customers.size + 1}`,
+            ...(input.email !== undefined ? { email: input.email } : {}),
+            ...(input.name !== undefined ? { name: input.name } : {}),
+            ...(input.taxId !== undefined ? { taxId: input.taxId } : {}),
+        };
+        this.customers.set(customer.id, customer);
+        return customer;
+    }
+    async findCustomer(customerId) {
+        return this.customers.get(customerId) ?? null;
+    }
+    async updateCustomer(customerId, input) {
+        const existing = this.customers.get(customerId) ?? { id: customerId };
+        const updated = {
+            id: customerId,
+            ...(input.email !== undefined ? { email: input.email } : {}),
+            ...(input.name !== undefined ? { name: input.name } : {}),
+            ...(input.taxId !== undefined ? { taxId: input.taxId } : {}),
+        };
+        void existing;
+        this.customers.set(customerId, updated);
+        return updated;
+    }
+    async charge(input) {
+        this.chargeCalls.push({ input });
+        const payment = {
+            id: `pi_${this.payments.size + 1}`,
+            gatewayId: `pi_${this.payments.size + 1}`,
+            provider: this.provider,
+            amount: { amount: input.amount, currency: input.currency ?? 'brl' },
+            status: 'paid',
+            ...(input.customerId !== undefined ? { customerId: input.customerId } : {}),
+            payload: {},
+            createdAt: new Date().toISOString(),
+            paidAt: new Date().toISOString(),
+        };
+        this.payments.set(payment.gatewayId, payment);
+        return payment;
+    }
+    async findPayment(gatewayId) {
+        return this.payments.get(gatewayId) ?? null;
+    }
+    async refund(paymentGatewayId, amount) {
+        this.refundCalls.push(amount !== undefined ? { paymentGatewayId, amount } : { paymentGatewayId });
+        const payment = this.payments.get(paymentGatewayId);
+        return {
+            id: `re_${this.refundCalls.length}`,
+            gatewayId: `re_${this.refundCalls.length}`,
+            provider: this.provider,
+            amount: {
+                amount: amount ?? payment?.amount.amount ?? 0,
+                currency: payment?.amount.currency ?? 'brl',
+            },
+            status: 'succeeded',
+            createdAt: new Date().toISOString(),
+        };
+    }
+    async createCheckout(input) {
+        this.createCheckoutCalls.push({ input });
+        return {
+            id: `cs_${this.createCheckoutCalls.length}`,
+            gatewayId: `cs_${this.createCheckoutCalls.length}`,
+            provider: this.provider,
+            url: 'https://checkout.example.test/session',
+            status: 'open',
+            ...(input.customerId !== undefined ? { customerId: input.customerId } : {}),
+            ...(input.planId !== undefined
+                ? { subscriptionId: `sub_${this.createCheckoutCalls.length}` }
+                : {}),
+        };
+    }
+    async createSubscription(input) {
+        this.createSubscriptionCalls.push({ input });
+        const subscription = {
+            id: `sub_${this.subscriptions.size + 1}`,
+            gatewayId: `sub_${this.subscriptions.size + 1}`,
+            provider: this.provider,
+            customerId: input.customerId,
+            status: 'active',
+            planId: input.planId,
+            payload: {},
+            createdAt: new Date().toISOString(),
+        };
+        this.subscriptions.set(subscription.gatewayId, subscription);
+        return subscription;
+    }
+    async cancelSubscription(subscriptionGatewayId, options) {
+        this.cancelSubscriptionCalls.push(options !== undefined
+            ? { id: subscriptionGatewayId, options }
+            : { id: subscriptionGatewayId });
+        const existing = this.subscriptions.get(subscriptionGatewayId);
+        const canceled = {
+            ...(existing ?? {
+                id: subscriptionGatewayId,
+                gatewayId: subscriptionGatewayId,
+                provider: this.provider,
+                customerId: '',
+                status: 'canceled',
+                planId: '',
+                payload: {},
+                createdAt: new Date().toISOString(),
+            }),
+            status: 'canceled',
+            ...(options?.atPeriodEnd === false ? { endsAt: new Date().toISOString() } : {}),
+        };
+        this.subscriptions.set(subscriptionGatewayId, canceled);
+        return canceled;
+    }
+    async findSubscription(gatewayId) {
+        return this.subscriptions.get(gatewayId) ?? null;
+    }
+    async updateSubscription(subscriptionGatewayId, input) {
+        this.updateSubscriptionCalls.push({ id: subscriptionGatewayId, input });
+        const existing = this.subscriptions.get(subscriptionGatewayId);
+        const updated = {
+            ...(existing ?? {
+                id: subscriptionGatewayId,
+                gatewayId: subscriptionGatewayId,
+                provider: this.provider,
+                customerId: '',
+                status: 'active',
+                planId: '',
+                payload: {},
+                createdAt: new Date().toISOString(),
+            }),
+            ...(input.amount !== undefined ? { amount: { amount: input.amount, currency: 'brl' } } : {}),
+        };
+        this.subscriptions.set(subscriptionGatewayId, updated);
+        return updated;
+    }
+    async listInvoices(_customerId) {
+        return this.invoices;
+    }
+    parseWebhook(_rawBody, _headers) {
+        const event = this.webhookEvents.shift();
+        if (!event) {
+            throw new Error('[payments] FakePaymentsDriver.parseWebhook: no webhookEvents queued.');
+        }
+        return event;
+    }
+}
+//# sourceMappingURL=fake_payments_driver.js.map

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

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

package/dist/src/testing/in_memory_billing_store.d.ts

@@ -0,0 +1,110 @@
+import type { BillingStore } from '../billing/billing_store.js';
+/** A minimal in-memory row shape (mirrors the Lucid models' columns). */
+export interface InMemorySubscriptionRow {
+    id: string;
+    gatewayId: string;
+    provider: string;
+    customerId: string;
+    status: string;
+    planId: string;
+    trialEndsAt: Date | null;
+    endsAt: Date | null;
+    payload: Record<string, unknown>;
+}
+export interface InMemoryPaymentRow {
+    id: string;
+    gatewayId: string;
+    provider: string;
+    status: string;
+    amount: number;
+    currency: string;
+    customerId: string | null;
+    subscriptionId: string | null;
+    paidAt: Date | null;
+    payload: Record<string, unknown>;
+}
+export interface InMemoryWebhookEventRow {
+    id: string;
+    gatewayEventId: string;
+    provider: string;
+    type: string;
+    status: 'received' | 'processed' | 'failed';
+    payload: Record<string, unknown>;
+    error: string | null;
+}
+/** A plain in-memory metered-usage row (mirrors the Lucid model's columns). */
+export interface InMemoryUsageEventRow {
+    id: string;
+    subscriptionId: string | null;
+    customerId: string | null;
+    meter: string;
+    quantity: number;
+    metadata?: Record<string, unknown>;
+    recordedAt: Date;
+}
+/**
+ * In-memory {@link BillingStore} for tests — no database required. Mirrors the shape of
+ * the Lucid models so the billing layer behaves identically.
+ */
+export declare class InMemoryBillingStore implements BillingStore<InMemorySubscriptionRow, InMemoryPaymentRow, InMemoryWebhookEventRow, InMemoryUsageEventRow> {
+    #private;
+    subscriptions: Map<string, InMemorySubscriptionRow>;
+    payments: Map<string, InMemoryPaymentRow>;
+    webhookEvents: Map<string, InMemoryWebhookEventRow>;
+    usageEvents: Map<string, InMemoryUsageEventRow>;
+    saveSubscription(sub: {
+        gatewayId: string;
+        provider: string;
+        customerId: string;
+        status: string;
+        planId: string;
+        trialEndsAt?: Date | null;
+        endsAt?: Date | null;
+        payload?: Record<string, unknown>;
+    }): Promise<InMemorySubscriptionRow>;
+    findSubscriptionByGatewayId(gatewayId: string): Promise<InMemorySubscriptionRow | null>;
+    savePayment(payment: {
+        gatewayId: string;
+        provider: string;
+        status: string;
+        amount: number;
+        currency: string;
+        customerId?: string | null;
+        subscriptionId?: string | null;
+        paidAt?: Date | null;
+        payload?: Record<string, unknown>;
+    }): Promise<InMemoryPaymentRow>;
+    findPaymentByGatewayId(gatewayId: string): Promise<InMemoryPaymentRow | null>;
+    recordWebhookEvent(event: {
+        gatewayEventId: string;
+        provider: string;
+        type: string;
+        payload: Record<string, unknown>;
+    }): Promise<InMemoryWebhookEventRow | null>;
+    markWebhookProcessed(id: string): Promise<void>;
+    markWebhookFailed(id: string, error: string): Promise<void>;
+    recordUsage(event: {
+        subscriptionId?: string | null;
+        customerId?: string;
+        meter: string;
+        quantity: number;
+        metadata?: Record<string, unknown>;
+        recordedAt?: Date;
+    }): Promise<InMemoryUsageEventRow>;
+    usageReport(query: {
+        subscriptionId?: string;
+        customerId?: string;
+        meter?: string;
+        from?: Date;
+        to?: Date;
+    }): Promise<Array<{
+        meter: string;
+        quantity: number;
+    }>>;
+    revenue(query: {
+        from?: Date;
+        to?: Date;
+    }): Promise<number>;
+    countActiveSubscriptions(): Promise<number>;
+}
+//# sourceMappingURL=in_memory_billing_store.d.ts.map

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

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

package/dist/src/testing/in_memory_billing_store.js

@@ -0,0 +1,136 @@
+/**
+ * In-memory {@link BillingStore} for tests — no database required. Mirrors the shape of
+ * the Lucid models so the billing layer behaves identically.
+ */
+export class InMemoryBillingStore {
+    subscriptions = new Map();
+    payments = new Map();
+    webhookEvents = new Map();
+    usageEvents = new Map();
+    #nextId = 1;
+    async saveSubscription(sub) {
+        const existing = this.subscriptions.get(sub.gatewayId);
+        const row = {
+            id: existing?.id ?? `sub_${this.#nextId++}`,
+            gatewayId: sub.gatewayId,
+            provider: sub.provider,
+            customerId: sub.customerId,
+            status: sub.status,
+            planId: sub.planId,
+            trialEndsAt: sub.trialEndsAt ?? null,
+            endsAt: sub.endsAt ?? null,
+            payload: sub.payload ?? {},
+        };
+        this.subscriptions.set(sub.gatewayId, row);
+        return row;
+    }
+    async findSubscriptionByGatewayId(gatewayId) {
+        return this.subscriptions.get(gatewayId) ?? null;
+    }
+    async savePayment(payment) {
+        const existing = this.payments.get(payment.gatewayId);
+        const row = {
+            id: existing?.id ?? `pay_${this.#nextId++}`,
+            gatewayId: payment.gatewayId,
+            provider: payment.provider,
+            status: payment.status,
+            amount: payment.amount,
+            currency: payment.currency,
+            customerId: payment.customerId ?? null,
+            subscriptionId: payment.subscriptionId ?? null,
+            paidAt: payment.paidAt ?? null,
+            payload: payment.payload ?? {},
+        };
+        this.payments.set(payment.gatewayId, row);
+        return row;
+    }
+    async findPaymentByGatewayId(gatewayId) {
+        return this.payments.get(gatewayId) ?? null;
+    }
+    async recordWebhookEvent(event) {
+        const existing = this.webhookEvents.get(event.gatewayEventId);
+        if (existing)
+            return null;
+        const row = {
+            id: `wh_${this.#nextId++}`,
+            gatewayEventId: event.gatewayEventId,
+            provider: event.provider,
+            type: event.type,
+            status: 'received',
+            payload: event.payload,
+            error: null,
+        };
+        this.webhookEvents.set(event.gatewayEventId, row);
+        return row;
+    }
+    async markWebhookProcessed(id) {
+        for (const row of this.webhookEvents.values()) {
+            if (row.id === id) {
+                row.status = 'processed';
+                return;
+            }
+        }
+    }
+    async markWebhookFailed(id, error) {
+        for (const row of this.webhookEvents.values()) {
+            if (row.id === id) {
+                row.status = 'failed';
+                row.error = error;
+                return;
+            }
+        }
+    }
+    async recordUsage(event) {
+        const row = {
+            id: `usage_${this.#nextId++}`,
+            subscriptionId: event.subscriptionId ?? null,
+            customerId: event.customerId ?? null,
+            meter: event.meter,
+            quantity: event.quantity,
+            ...(event.metadata !== undefined ? { metadata: event.metadata } : {}),
+            recordedAt: event.recordedAt ?? new Date(),
+        };
+        this.usageEvents.set(row.id, row);
+        return row;
+    }
+    async usageReport(query) {
+        const totals = new Map();
+        for (const row of this.usageEvents.values()) {
+            if (query.subscriptionId !== undefined && row.subscriptionId !== query.subscriptionId)
+                continue;
+            if (query.customerId !== undefined && row.customerId !== query.customerId) {
+                continue;
+            }
+            if (query.meter !== undefined && row.meter !== query.meter)
+                continue;
+            if (query.from !== undefined && row.recordedAt < query.from)
+                continue;
+            if (query.to !== undefined && row.recordedAt >= query.to)
+                continue;
+            totals.set(row.meter, (totals.get(row.meter) ?? 0) + row.quantity);
+        }
+        return [...totals.entries()].map(([meter, quantity]) => ({ meter, quantity }));
+    }
+    async revenue(query) {
+        let total = 0;
+        for (const row of this.payments.values()) {
+            if (row.status !== 'paid')
+                continue;
+            if (query.from !== undefined && row.paidAt !== null && row.paidAt < query.from)
+                continue;
+            if (query.to !== undefined && row.paidAt !== null && row.paidAt >= query.to)
+                continue;
+            total += row.amount;
+        }
+        return total;
+    }
+    async countActiveSubscriptions() {
+        let count = 0;
+        for (const row of this.subscriptions.values()) {
+            if (row.status === 'active' || row.status === 'trialing')
+                count += 1;
+        }
+        return count;
+    }
+}
+//# sourceMappingURL=in_memory_billing_store.js.map

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

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

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

@@ -0,0 +1,6 @@
+export { FakePaymentsDriver } from './fake_payments_driver.js';
+export type { FakePaymentsDriverOptions } from './fake_payments_driver.js';
+export { InMemoryBillingStore } from './in_memory_billing_store.js';
+export type { InMemorySubscriptionRow, InMemoryPaymentRow, InMemoryWebhookEventRow, } from './in_memory_billing_store.js';
+export { MutableClock } from './mutable_clock.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,YAAY,EACV,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/src/testing/index.js

@@ -0,0 +1,4 @@
+export { FakePaymentsDriver } from './fake_payments_driver.js';
+export { InMemoryBillingStore } from './in_memory_billing_store.js';
+export { MutableClock } from './mutable_clock.js';
+//# sourceMappingURL=index.js.map

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

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