@hazeljs/payment 0.2.0-alpha.4

package/dist/providers/provider.interface.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Payment provider interface. Implement this to add new payment methods (Stripe, PayPal, Paddle, etc.).
+ */
+import type { CreateCheckoutSessionOptions, CreateCheckoutSessionResult, CreateCustomerOptions, Customer, CheckoutSessionInfo, Subscription, SubscriptionStatusFilter } from '../types/payment.types';
+export interface ListSubscriptionsResult {
+    data: Subscription[];
+}
+/**
+ * Implement this interface to add a payment provider to @hazeljs/payment.
+ */
+export interface PaymentProvider {
+    /** Provider identifier (e.g. 'stripe', 'paypal'). */
+    readonly name: string;
+    /** Create a checkout session; returns URL to redirect the customer. */
+    createCheckoutSession(options: CreateCheckoutSessionOptions): Promise<CreateCheckoutSessionResult>;
+    /** Create a customer in the provider's system. */
+    createCustomer(options: CreateCustomerOptions): Promise<Customer>;
+    /** Retrieve a customer by ID. */
+    getCustomer(customerId: string): Promise<Customer | null>;
+    /** List subscriptions for a customer. */
+    listSubscriptions(customerId: string, status?: SubscriptionStatusFilter): Promise<ListSubscriptionsResult>;
+    /** Retrieve a checkout session (e.g. after success redirect). */
+    getCheckoutSession(sessionId: string): Promise<CheckoutSessionInfo>;
+    /** Whether webhook verification is configured for this provider. */
+    isWebhookConfigured(): boolean;
+    /**
+     * Verify and parse a webhook event from raw body and signature.
+     * Returns provider-specific event object. Throws if signature invalid or not configured.
+     */
+    parseWebhookEvent(payload: string | Buffer, signature: string): unknown;
+}
+//# sourceMappingURL=provider.interface.d.ts.map

package/dist/providers/provider.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.interface.d.ts","sourceRoot":"","sources":["../../src/providers/provider.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,4BAA4B,EAC5B,2BAA2B,EAC3B,qBAAqB,EACrB,QAAQ,EACR,mBAAmB,EACnB,YAAY,EACZ,wBAAwB,EACzB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,YAAY,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,uEAAuE;IACvE,qBAAqB,CACnB,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAExC,kDAAkD;IAClD,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAElE,iCAAiC;IACjC,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAE1D,yCAAyC;IACzC,iBAAiB,CACf,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAEpC,iEAAiE;IACjE,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEpE,oEAAoE;IACpE,mBAAmB,IAAI,OAAO,CAAC;IAE/B;;;OAGG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;CACzE"}

package/dist/providers/provider.interface.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * Payment provider interface. Implement this to add new payment methods (Stripe, PayPal, Paddle, etc.).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/providers/stripe/stripe.provider.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Stripe implementation of PaymentProvider.
+ */
+import Stripe from 'stripe';
+import type { PaymentProvider } from '../provider.interface';
+import type { StripeProviderOptions } from './stripe.types';
+import type { ListSubscriptionsResult } from '../provider.interface';
+import type { CreateCheckoutSessionOptions, CreateCheckoutSessionResult, CreateCustomerOptions, Customer, CheckoutSessionInfo, SubscriptionStatusFilter } from '../../types/payment.types';
+export declare const STRIPE_PROVIDER_NAME = "stripe";
+export declare class StripePaymentProvider implements PaymentProvider {
+    readonly name = "stripe";
+    private readonly stripe;
+    private readonly webhookSecret;
+    constructor(options: StripeProviderOptions);
+    /** Raw Stripe client for advanced usage. */
+    getClient(): Stripe;
+    createCheckoutSession(options: CreateCheckoutSessionOptions): Promise<CreateCheckoutSessionResult>;
+    createCustomer(options: CreateCustomerOptions): Promise<Customer>;
+    getCustomer(customerId: string): Promise<Customer | null>;
+    listSubscriptions(customerId: string, status?: SubscriptionStatusFilter): Promise<ListSubscriptionsResult>;
+    getCheckoutSession(sessionId: string): Promise<CheckoutSessionInfo>;
+    isWebhookConfigured(): boolean;
+    parseWebhookEvent(payload: string | Buffer, signature: string): Stripe.Event;
+    private toCustomer;
+}
+//# sourceMappingURL=stripe.provider.d.ts.map

package/dist/providers/stripe/stripe.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe.provider.d.ts","sourceRoot":"","sources":["../../../src/providers/stripe/stripe.provider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EACV,4BAA4B,EAC5B,2BAA2B,EAC3B,qBAAqB,EACrB,QAAQ,EACR,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,2BAA2B,CAAC;AAEnC,eAAO,MAAM,oBAAoB,WAAW,CAAC;AAE7C,qBAAa,qBAAsB,YAAW,eAAe;IAC3D,QAAQ,CAAC,IAAI,YAAwB;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;gBAEvC,OAAO,EAAE,qBAAqB;IAa1C,4CAA4C;IAC5C,SAAS,IAAI,MAAM;IAIb,qBAAqB,CACzB,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,2BAA2B,CAAC;IAyDjC,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IASjE,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAMzD,iBAAiB,CACrB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC;IAgB7B,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAkBzE,mBAAmB,IAAI,OAAO;IAI9B,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK;IAa5E,OAAO,CAAC,UAAU;CAQnB"}

package/dist/providers/stripe/stripe.provider.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * Stripe implementation of PaymentProvider.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StripePaymentProvider = exports.STRIPE_PROVIDER_NAME = void 0;
+const stripe_1 = __importDefault(require("stripe"));
+exports.STRIPE_PROVIDER_NAME = 'stripe';
+class StripePaymentProvider {
+    constructor(options) {
+        this.name = exports.STRIPE_PROVIDER_NAME;
+        const secretKey = options.secretKey ?? process.env.STRIPE_SECRET_KEY;
+        if (!secretKey) {
+            throw new Error('Stripe secret key is required. Set STRIPE_SECRET_KEY or pass secretKey in StripeProviderOptions.');
+        }
+        this.stripe = new stripe_1.default(secretKey, {
+            apiVersion: options.apiVersion,
+        });
+        this.webhookSecret = options.webhookSecret ?? process.env.STRIPE_WEBHOOK_SECRET;
+    }
+    /** Raw Stripe client for advanced usage. */
+    getClient() {
+        return this.stripe;
+    }
+    async createCheckoutSession(options) {
+        const mode = options.mode ?? (options.subscription ? 'subscription' : 'payment');
+        const stripeOptions = (options.providerOptions?.stripe ??
+            {});
+        const params = {
+            success_url: options.successUrl,
+            cancel_url: options.cancelUrl,
+            mode,
+            ...(options.clientReferenceId && { client_reference_id: options.clientReferenceId }),
+            ...(options.customerId && { customer: options.customerId }),
+            ...(options.customerEmail &&
+                !options.customerId && { customer_email: options.customerEmail }),
+            ...(options.allowPromotionCodes && { allow_promotion_codes: true }),
+            ...stripeOptions,
+        };
+        if (mode === 'subscription' && options.subscription) {
+            params.line_items = [
+                {
+                    price: options.subscription.priceId,
+                    quantity: options.subscription.quantity ?? 1,
+                },
+            ];
+            if (options.subscription.trialPeriodDays) {
+                params.subscription_data = {
+                    trial_period_days: options.subscription.trialPeriodDays,
+                };
+            }
+        }
+        else if (options.lineItems && options.lineItems.length > 0) {
+            params.line_items = options.lineItems.map((item) => {
+                if (item.priceId) {
+                    return { price: item.priceId, quantity: item.quantity ?? 1 };
+                }
+                if (item.priceData) {
+                    return {
+                        price_data: {
+                            currency: item.priceData.currency,
+                            unit_amount: item.priceData.unitAmount,
+                            product_data: {
+                                name: item.priceData.productData.name,
+                                description: item.priceData.productData.description,
+                                images: item.priceData.productData.images,
+                            },
+                        },
+                        quantity: item.quantity ?? 1,
+                    };
+                }
+                throw new Error('Each line item must have priceId or priceData');
+            });
+        }
+        const session = await this.stripe.checkout.sessions.create(params);
+        return { sessionId: session.id, url: session.url ?? null };
+    }
+    async createCustomer(options) {
+        const customer = await this.stripe.customers.create({
+            email: options.email,
+            name: options.name,
+            metadata: options.metadata,
+        });
+        return this.toCustomer(customer);
+    }
+    async getCustomer(customerId) {
+        const customer = await this.stripe.customers.retrieve(customerId);
+        if (customer.deleted)
+            return null;
+        return this.toCustomer(customer);
+    }
+    async listSubscriptions(customerId, status) {
+        const list = await this.stripe.subscriptions.list({
+            customer: customerId,
+            status: status ?? 'all',
+            expand: ['data.items.data.price'],
+        });
+        return {
+            data: list.data.map((s) => ({
+                ...s,
+                id: s.id,
+                status: s.status,
+                customerId: s.customer,
+            })),
+        };
+    }
+    async getCheckoutSession(sessionId) {
+        const session = await this.stripe.checkout.sessions.retrieve(sessionId, {
+            expand: ['customer', 'subscription'],
+        });
+        return {
+            ...session,
+            id: session.id,
+            url: session.url ?? null,
+            customerId: typeof session.customer === 'string' ? session.customer : (session.customer?.id ?? null),
+            subscriptionId: typeof session.subscription === 'string'
+                ? session.subscription
+                : (session.subscription?.id ?? null),
+            status: session.status ?? undefined,
+        };
+    }
+    isWebhookConfigured() {
+        return Boolean(this.webhookSecret);
+    }
+    parseWebhookEvent(payload, signature) {
+        if (!this.webhookSecret) {
+            throw new Error('Stripe webhook secret is required. Set STRIPE_WEBHOOK_SECRET or pass webhookSecret in StripeProviderOptions.');
+        }
+        return this.stripe.webhooks.constructEvent(payload, signature, this.webhookSecret);
+    }
+    toCustomer(c) {
+        return {
+            id: c.id,
+            email: c.email ?? null,
+            name: c.name ?? null,
+            metadata: c.metadata,
+        };
+    }
+}
+exports.StripePaymentProvider = StripePaymentProvider;

package/dist/providers/stripe/stripe.provider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stripe.provider.test.d.ts.map

package/dist/providers/stripe/stripe.provider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe.provider.test.d.ts","sourceRoot":"","sources":["../../../src/providers/stripe/stripe.provider.test.ts"],"names":[],"mappings":""}

package/dist/providers/stripe/stripe.provider.test.js

@@ -0,0 +1,383 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const stripe_provider_1 = require("./stripe.provider");
+const mockCheckoutSessionsCreate = jest.fn();
+const mockCustomersCreate = jest.fn();
+const mockCustomersRetrieve = jest.fn();
+const mockSubscriptionsList = jest.fn();
+const mockCheckoutSessionsRetrieve = jest.fn();
+const mockWebhooksConstructEvent = jest.fn();
+jest.mock('stripe', () => {
+    return jest.fn().mockImplementation(() => ({
+        checkout: {
+            sessions: {
+                create: mockCheckoutSessionsCreate,
+                retrieve: mockCheckoutSessionsRetrieve,
+            },
+        },
+        customers: {
+            create: mockCustomersCreate,
+            retrieve: mockCustomersRetrieve,
+        },
+        subscriptions: {
+            list: mockSubscriptionsList,
+        },
+        webhooks: {
+            constructEvent: mockWebhooksConstructEvent,
+        },
+    }));
+});
+describe('StripePaymentProvider', () => {
+    const baseOptions = { secretKey: 'sk_test_xxx' };
+    beforeEach(() => {
+        jest.clearAllMocks();
+        delete process.env.STRIPE_SECRET_KEY;
+        delete process.env.STRIPE_WEBHOOK_SECRET;
+        mockCheckoutSessionsCreate.mockResolvedValue({
+            id: 'cs_123',
+            url: 'https://checkout.stripe.com/pay',
+        });
+        mockCustomersCreate.mockResolvedValue({
+            id: 'cus_123',
+            email: 'u@example.com',
+            name: 'User',
+            metadata: {},
+            deleted: false,
+        });
+        mockCustomersRetrieve.mockResolvedValue({
+            id: 'cus_123',
+            email: 'u@example.com',
+            name: 'User',
+            metadata: {},
+            deleted: false,
+        });
+        mockSubscriptionsList.mockResolvedValue({
+            data: [{ id: 'sub_1', status: 'active', customer: 'cus_123' }],
+        });
+        mockCheckoutSessionsRetrieve.mockResolvedValue({
+            id: 'cs_123',
+            url: null,
+            customer: 'cus_123',
+            subscription: 'sub_1',
+            status: 'complete',
+        });
+        mockWebhooksConstructEvent.mockReturnValue({ type: 'checkout.session.completed' });
+    });
+    describe('constructor', () => {
+        it('throws when no secret key', () => {
+            expect(() => new stripe_provider_1.StripePaymentProvider({})).toThrow('Stripe secret key is required');
+        });
+        it('uses options.secretKey', () => {
+            const provider = new stripe_provider_1.StripePaymentProvider(baseOptions);
+            expect(provider).toBeDefined();
+            expect(provider.getClient()).toBeDefined();
+        });
+        it('uses STRIPE_SECRET_KEY env when secretKey not in options', () => {
+            process.env.STRIPE_SECRET_KEY = 'sk_env_xxx';
+            const provider = new stripe_provider_1.StripePaymentProvider({});
+            expect(provider).toBeDefined();
+            delete process.env.STRIPE_SECRET_KEY;
+        });
+        it('sets webhookSecret from options', () => {
+            const provider = new stripe_provider_1.StripePaymentProvider({ ...baseOptions, webhookSecret: 'whsec_xxx' });
+            expect(provider.isWebhookConfigured()).toBe(true);
+        });
+        it('sets webhookSecret from env', () => {
+            process.env.STRIPE_SECRET_KEY = 'sk_xxx';
+            process.env.STRIPE_WEBHOOK_SECRET = 'whsec_env';
+            const provider = new stripe_provider_1.StripePaymentProvider({});
+            expect(provider.isWebhookConfigured()).toBe(true);
+            delete process.env.STRIPE_SECRET_KEY;
+            delete process.env.STRIPE_WEBHOOK_SECRET;
+        });
+    });
+    describe('name', () => {
+        it('has correct provider name', () => {
+            const provider = new stripe_provider_1.StripePaymentProvider(baseOptions);
+            expect(provider.name).toBe(stripe_provider_1.STRIPE_PROVIDER_NAME);
+            expect(stripe_provider_1.STRIPE_PROVIDER_NAME).toBe('stripe');
+        });
+    });
+    describe('createCheckoutSession', () => {
+        it('creates one-time payment session with lineItems', async () => {
+            const provider = new stripe_provider_1.StripePaymentProvider(baseOptions);
+            const result = await provider.createCheckoutSession({
+                successUrl: 'https://a.com/s',
+                cancelUrl: 'https://a.com/c',
+                lineItems: [
+                    {
+                        priceData: {
+                            currency: 'usd',
+                            unitAmount: 1999,
+                            productData: { name: 'Pro Plan' },
+                        },
+                        quantity: 1,
+                    },
+                ],
+            });
+            expect(result).toEqual({ sessionId: 'cs_123', url: 'https://checkout.stripe.com/pay' });
+            expect(mockCheckoutSessionsCreate).toHaveBeenCalledWith(expect.objectContaining({
+                success_url: 'https://a.com/s',
+                cancel_url: 'https://a.com/c',
+                mode: 'payment',
+                line_items: expect.any(Array),
+            }));
+        });
+        it('creates session with priceId line items', async () => {
+            const provider = new stripe_provider_1.StripePaymentProvider(baseOptions);
+            await provider.createCheckoutSession({
+                successUrl: 'https://a.com/s',
+                cancelUrl: 'https://a.com/c',
+                lineItems: [{ priceId: 'price_xxx', quantity: 2 }],
+            });
+            expect(mockCheckoutSessionsCreate).toHaveBeenCalledWith(expect.objectContaining({
+                line_items: [{ price: 'price_xxx', quantity: 2 }],
+            }));
+        });
+        it('creates subscription session with trial', async () => {
+            const provider = new stripe_provider_1.StripePaymentProvider(baseOptions);
+            await provider.createCheckoutSession({
+                successUrl: 'https://a.com/s',
+                cancelUrl: 'https://a.com/c',
+                subscription: { priceId: 'price_sub', quantity: 1, trialPeriodDays: 14 },
+            });
+            expect(mockCheckoutSessionsCreate).toHaveBeenCalledWith(expect.objectContaining({
+                mode: 'subscription',
+                line_items: [{ price: 'price_sub', quantity: 1 }],
+                subscription_data: { trial_period_days: 14 },
+            }));
+        });
+        it('passes customerId and clientReferenceId', async () => {
+            const provider = new stripe_provider_1.StripePaymentProvider(baseOptions);
+            await provider.createCheckoutSession({
+                successUrl: 'https://a.com/s',
+                cancelUrl: 'https://a.com/c',
+                customerId: 'cus_existing',
+                clientReferenceId: 'order_123',
+            });
+            expect(mockCheckoutSessionsCreate).toHaveBeenCalledWith(expect.objectContaining({
+                customer: 'cus_existing',
+                client_reference_id: 'order_123',
+            }));
+        });
+        it('passes customerEmail when no customerId', async () => {
+            const provider = new stripe_provider_1.StripePaymentProvider(baseOptions);
+            await provider.createCheckoutSession({
+                successUrl: 'https://a.com/s',
+                cancelUrl: 'https://a.com/c',
+                customerEmail: 'new@example.com',
+            });
+            expect(mockCheckoutSessionsCreate).toHaveBeenCalledWith(expect.objectContaining({
+                customer_email: 'new@example.com',
+            }));
+        });
+        it('does not pass customer_email when customerId is set', async () => {
+            const provider = new stripe_provider_1.StripePaymentProvider(baseOptions);
+            await provider.createCheckoutSession({
+                successUrl: 'https://a.com/s',
+                cancelUrl: 'https://a.com/c',
+                customerId: 'cus_exist',
+                customerEmail: 'ignore@example.com',
+            });
+            const call = mockCheckoutSessionsCreate.mock.calls[0][0];
+            expect(call.customer).toBe('cus_exist');
+            expect(call.customer_email).toBeUndefined();
+        });
+        it('passes allowPromotionCodes when true', async () => {
+            const provider = new stripe_provider_1.StripePaymentProvider(baseOptions);
+            await provider.createCheckoutSession({
+                successUrl: 'https://a.com/s',
+                cancelUrl: 'https://a.com/c',
+                allowPromotionCodes: true,
+            });
+            expect(mockCheckoutSessionsCreate).toHaveBeenCalledWith(expect.objectContaining({
+                allow_promotion_codes: true,
+            }));
+        });
+        it('creates subscription session without trial', async () => {
+            const provider = new stripe_provider_1.StripePaymentProvider(baseOptions);
+            await provider.createCheckoutSession({
+                successUrl: 'https://a.com/s',
+                cancelUrl: 'https://a.com/c',
+                subscription: { priceId: 'price_sub', quantity: 2 },
+            });
+            expect(mockCheckoutSessionsCreate).toHaveBeenCalledWith(expect.objectContaining({
+                mode: 'subscription',
+                line_items: [{ price: 'price_sub', quantity: 2 }],
+            }));
+            const call = mockCheckoutSessionsCreate.mock.calls[0][0];
+            expect(call.subscription_data).toBeUndefined();
+        });
+        it('passes description and images in priceData productData', async () => {
+            const provider = new stripe_provider_1.StripePaymentProvider(baseOptions);
+            await provider.createCheckoutSession({
+                successUrl: 'https://a.com/s',
+                cancelUrl: 'https://a.com/c',
+                lineItems: [
+                    {
+                        priceData: {
+                            currency: 'eur',
+                            unitAmount: 999,
+                            productData: {
+                                name: 'Pro',
+                                description: 'Pro plan',
+                                images: ['https://example.com/img.png'],
+                            },
+                        },
+                        quantity: 1,
+                    },
+                ],
+            });
+            expect(mockCheckoutSessionsCreate).toHaveBeenCalledWith(expect.objectContaining({
+                line_items: [
+                    expect.objectContaining({
+                        price_data: expect.objectContaining({
+                            product_data: expect.objectContaining({
+                                name: 'Pro',
+                                description: 'Pro plan',
+                                images: ['https://example.com/img.png'],
+                            }),
+                        }),
+                    }),
+                ],
+            }));
+        });
+        it('merges providerOptions.stripe', async () => {
+            const provider = new stripe_provider_1.StripePaymentProvider(baseOptions);
+            await provider.createCheckoutSession({
+                successUrl: 'https://a.com/s',
+                cancelUrl: 'https://a.com/c',
+                providerOptions: {
+                    stripe: { payment_intent_data: { setup_future_usage: 'off_session' } },
+                },
+            });
+            expect(mockCheckoutSessionsCreate).toHaveBeenCalledWith(expect.objectContaining({
+                payment_intent_data: { setup_future_usage: 'off_session' },
+            }));
+        });
+        it('throws when line item has neither priceId nor priceData', async () => {
+            const provider = new stripe_provider_1.StripePaymentProvider(baseOptions);
+            await expect(provider.createCheckoutSession({
+                successUrl: 'https://a.com/s',
+                cancelUrl: 'https://a.com/c',
+                lineItems: [{}],
+            })).rejects.toThrow('Each line item must have priceId or priceData');
+        });
+    });
+    describe('createCustomer', () => {
+        it('creates customer and maps to Customer type', async () => {
+            const provider = new stripe_provider_1.StripePaymentProvider(baseOptions);
+            const customer = await provider.createCustomer({
+                email: 'u@example.com',
+                name: 'Alice',
+                metadata: { userId: 'u1' },
+            });
+            expect(customer).toEqual({
+                id: 'cus_123',
+                email: 'u@example.com',
+                name: 'User',
+                metadata: {},
+            });
+            expect(mockCustomersCreate).toHaveBeenCalledWith({
+                email: 'u@example.com',
+                name: 'Alice',
+                metadata: { userId: 'u1' },
+            });
+        });
+        it('maps customer with undefined metadata', async () => {
+            mockCustomersCreate.mockResolvedValueOnce({
+                id: 'cus_no_meta',
+                email: 'n@example.com',
+                name: null,
+                metadata: undefined,
+                deleted: false,
+            });
+            const provider = new stripe_provider_1.StripePaymentProvider(baseOptions);
+            const customer = await provider.createCustomer({ email: 'n@example.com' });
+            expect(customer.metadata).toBeUndefined();
+        });
+    });
+    describe('getCustomer', () => {
+        it('returns null for deleted customer', async () => {
+            mockCustomersRetrieve.mockResolvedValueOnce({ id: 'cus_del', deleted: true });
+            const provider = new stripe_provider_1.StripePaymentProvider(baseOptions);
+            const customer = await provider.getCustomer('cus_del');
+            expect(customer).toBeNull();
+        });
+        it('returns mapped customer for existing', async () => {
+            const provider = new stripe_provider_1.StripePaymentProvider(baseOptions);
+            const customer = await provider.getCustomer('cus_123');
+            expect(customer).not.toBeNull();
+            expect(customer?.id).toBe('cus_123');
+        });
+    });
+    describe('listSubscriptions', () => {
+        it('returns list with data array', async () => {
+            const provider = new stripe_provider_1.StripePaymentProvider(baseOptions);
+            const result = await provider.listSubscriptions('cus_123');
+            expect(result.data).toHaveLength(1);
+            expect(result.data[0].id).toBe('sub_1');
+            expect(result.data[0].status).toBe('active');
+            expect(result.data[0].customerId).toBe('cus_123');
+        });
+        it('passes status filter', async () => {
+            const provider = new stripe_provider_1.StripePaymentProvider(baseOptions);
+            await provider.listSubscriptions('cus_123', 'active');
+            expect(mockSubscriptionsList).toHaveBeenCalledWith(expect.objectContaining({ status: 'active' }));
+        });
+    });
+    describe('getCheckoutSession', () => {
+        it('returns CheckoutSessionInfo with id, url, customerId, subscriptionId, status', async () => {
+            const provider = new stripe_provider_1.StripePaymentProvider(baseOptions);
+            const session = await provider.getCheckoutSession('cs_123');
+            expect(session.id).toBe('cs_123');
+            expect(session.url).toBeNull();
+            expect(session.customerId).toBe('cus_123');
+            expect(session.subscriptionId).toBe('sub_1');
+            expect(session.status).toBe('complete');
+        });
+        it('handles expanded customer and subscription objects', async () => {
+            mockCheckoutSessionsRetrieve.mockResolvedValueOnce({
+                id: 'cs_expand',
+                url: 'https://checkout.stripe.com',
+                customer: { id: 'cus_expanded', object: 'customer' },
+                subscription: { id: 'sub_expanded', object: 'subscription' },
+                status: 'complete',
+            });
+            const provider = new stripe_provider_1.StripePaymentProvider(baseOptions);
+            const session = await provider.getCheckoutSession('cs_expand');
+            expect(session.customerId).toBe('cus_expanded');
+            expect(session.subscriptionId).toBe('sub_expanded');
+        });
+    });
+    describe('isWebhookConfigured', () => {
+        it('returns false when no webhook secret', () => {
+            const provider = new stripe_provider_1.StripePaymentProvider(baseOptions);
+            expect(provider.isWebhookConfigured()).toBe(false);
+        });
+        it('returns true when webhook secret set', () => {
+            const provider = new stripe_provider_1.StripePaymentProvider({ ...baseOptions, webhookSecret: 'whsec_xxx' });
+            expect(provider.isWebhookConfigured()).toBe(true);
+        });
+    });
+    describe('parseWebhookEvent', () => {
+        it('throws when webhook secret not configured', () => {
+            const provider = new stripe_provider_1.StripePaymentProvider(baseOptions);
+            expect(() => provider.parseWebhookEvent('payload', 'sig')).toThrow('Stripe webhook secret is required');
+        });
+        it('calls stripe.webhooks.constructEvent and returns event', () => {
+            const provider = new stripe_provider_1.StripePaymentProvider({ ...baseOptions, webhookSecret: 'whsec_xxx' });
+            const event = provider.parseWebhookEvent('payload', 'sig');
+            expect(mockWebhooksConstructEvent).toHaveBeenCalledWith('payload', 'sig', 'whsec_xxx');
+            expect(event).toEqual({ type: 'checkout.session.completed' });
+        });
+    });
+    describe('getClient', () => {
+        it('returns Stripe instance', () => {
+            const provider = new stripe_provider_1.StripePaymentProvider(baseOptions);
+            const client = provider.getClient();
+            expect(client).toBeDefined();
+            expect(client.checkout.sessions.create).toBe(mockCheckoutSessionsCreate);
+        });
+    });
+});

package/dist/providers/stripe/stripe.types.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Stripe-specific configuration and types.
+ */
+import type Stripe from 'stripe';
+export interface StripeProviderOptions {
+    /** Secret key (e.g. sk_test_...). Defaults to process.env.STRIPE_SECRET_KEY. */
+    secretKey?: string;
+    /** Webhook signing secret (e.g. whsec_...). Defaults to process.env.STRIPE_WEBHOOK_SECRET. */
+    webhookSecret?: string;
+    /** Optional Stripe API version. */
+    apiVersion?: Stripe.LatestApiVersion;
+}
+/** Re-export Stripe Event for webhook handlers. */
+export type StripeWebhookEvent = Stripe.Event;
+//# sourceMappingURL=stripe.types.d.ts.map

package/dist/providers/stripe/stripe.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe.types.d.ts","sourceRoot":"","sources":["../../../src/providers/stripe/stripe.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC,MAAM,WAAW,qBAAqB;IACpC,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8FAA8F;IAC9F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC,gBAAgB,CAAC;CACtC;AAED,mDAAmD;AACnD,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,KAAK,CAAC"}

package/dist/providers/stripe/stripe.types.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * Stripe-specific configuration and types.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });