@mostajs/payment 0.1.0 → 0.3.0

package/dist/providers/paypal.provider.js

@@ -0,0 +1,160 @@
+// @mostajs/payment — PayPal REST API v2 provider
+// Author: Dr Hamid MADANI drmdh@msn.com
+// Ref: https://developer.paypal.com/docs/api/orders/v2/
+export class PayPalProvider {
+    config;
+    name = 'paypal';
+    supportedCurrencies = ['USD', 'EUR', 'GBP', 'CAD', 'AUD', 'JPY', 'CHF'];
+    supportedMethods = ['paypal'];
+    baseUrl;
+    tokenCache = null;
+    constructor(config) {
+        this.config = config;
+        this.baseUrl = config.testMode
+            ? 'https://api-m.sandbox.paypal.com'
+            : 'https://api-m.paypal.com';
+    }
+    async getAccessToken() {
+        if (this.tokenCache && Date.now() < this.tokenCache.expiresAt) {
+            return this.tokenCache.token;
+        }
+        const auth = Buffer.from(`${this.config.clientId}:${this.config.secret}`).toString('base64');
+        const res = await fetch(`${this.baseUrl}/v1/oauth2/token`, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Basic ${auth}`,
+                'Content-Type': 'application/x-www-form-urlencoded',
+            },
+            body: 'grant_type=client_credentials',
+        });
+        if (!res.ok)
+            throw new Error(`[paypal] Token failed: ${res.statusText}`);
+        const data = await res.json();
+        this.tokenCache = {
+            token: data.access_token,
+            expiresAt: Date.now() + (data.expires_in - 60) * 1000, // refresh 1 min before expiry
+        };
+        return data.access_token;
+    }
+    async api(method, path, body) {
+        const token = await this.getAccessToken();
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            method,
+            headers: {
+                'Authorization': `Bearer ${token}`,
+                'Content-Type': 'application/json',
+            },
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({}));
+            throw new Error(`[paypal] ${method} ${path} failed: ${err.message ?? err.error ?? res.statusText}`);
+        }
+        return res.status === 204 ? null : res.json();
+    }
+    async createCheckout(params) {
+        const currency = (params.currency ?? 'USD').toUpperCase();
+        const data = await this.api('POST', '/v2/checkout/orders', {
+            intent: 'CAPTURE',
+            purchase_units: [{
+                    reference_id: params.orderId,
+                    description: params.description,
+                    amount: {
+                        currency_code: currency,
+                        value: params.amount.toFixed(2),
+                    },
+                }],
+            application_context: {
+                return_url: params.successUrl ?? this.config.returnUrl,
+                cancel_url: params.cancelUrl ?? this.config.cancelUrl,
+                brand_name: 'OctoNet Cloud',
+                landing_page: 'LOGIN',
+                user_action: 'PAY_NOW',
+            },
+            ...(params.metadata ? { metadata: params.metadata } : {}),
+        });
+        const approveLink = data.links?.find((l) => l.rel === 'approve');
+        return { url: approveLink?.href ?? null, sessionId: data.id };
+    }
+    /**
+     * Capture a PayPal order after user approval.
+     * Call this when PayPal redirects back to returnUrl with ?token=ORDER_ID
+     */
+    async captureOrder(orderId) {
+        const data = await this.api('POST', `/v2/checkout/orders/${orderId}/capture`, {});
+        return { status: data.status, data };
+    }
+    /**
+     * Get order details.
+     */
+    async getOrder(orderId) {
+        return this.api('GET', `/v2/checkout/orders/${orderId}`);
+    }
+    async createRefund(params) {
+        // PayPal refunds work on captures, not orders
+        const body = {};
+        if (params.amount) {
+            body.amount = { value: params.amount.toFixed(2), currency_code: 'USD' };
+        }
+        if (params.reason)
+            body.note_to_payer = params.reason;
+        const data = await this.api('POST', `/v2/payments/captures/${params.paymentId}/refund`, body);
+        return {
+            id: data.id,
+            amount: parseFloat(data.amount?.value ?? '0'),
+            status: data.status,
+        };
+    }
+    async verifyWebhook(body, signature) {
+        // PayPal webhook verification requires calling their API
+        // For simplicity, parse the event and validate via API
+        const event = JSON.parse(body);
+        // In production, verify via POST /v1/notifications/verify-webhook-signature
+        // For now, trust the parsed event
+        const type = event.event_type === 'CHECKOUT.ORDER.APPROVED' ? 'payment.approved'
+            : event.event_type === 'PAYMENT.CAPTURE.COMPLETED' ? 'payment.success'
+                : event.event_type === 'PAYMENT.CAPTURE.DENIED' ? 'payment.failed'
+                    : event.event_type ?? 'unknown';
+        return {
+            type,
+            data: {
+                orderId: event.resource?.id,
+                status: event.resource?.status,
+                amount: event.resource?.amount?.value,
+                currency: event.resource?.amount?.currency_code,
+            },
+            raw: event,
+        };
+    }
+    /**
+     * Verify webhook signature via PayPal API (production).
+     */
+    async verifyWebhookSignature(headers, body) {
+        if (!this.config.webhookId)
+            return false;
+        const data = await this.api('POST', '/v1/notifications/verify-webhook-signature', {
+            auth_algo: headers['paypal-auth-algo'],
+            cert_url: headers['paypal-cert-url'],
+            transmission_id: headers['paypal-transmission-id'],
+            transmission_sig: headers['paypal-transmission-sig'],
+            transmission_time: headers['paypal-transmission-time'],
+            webhook_id: this.config.webhookId,
+            webhook_event: JSON.parse(body),
+        });
+        return data.verification_status === 'SUCCESS';
+    }
+}
+/**
+ * Create a PayPal provider from environment variables.
+ */
+export function createPayPalProvider(config) {
+    return new PayPalProvider({
+        clientId: config?.clientId ?? process.env.PAYPAL_CLIENT_ID ?? '',
+        secret: config?.secret ?? process.env.PAYPAL_SECRET ?? '',
+        testMode: config?.testMode ?? process.env.PAYPAL_TEST_MODE !== 'false',
+        returnUrl: config?.returnUrl ?? process.env.PAYPAL_RETURN_URL ?? '/payment/success',
+        cancelUrl: config?.cancelUrl ?? process.env.PAYPAL_CANCEL_URL ?? '/payment/canceled',
+        webhookId: config?.webhookId ?? process.env.PAYPAL_WEBHOOK_ID,
+    });
+}
+//# sourceMappingURL=paypal.provider.js.map

package/dist/providers/paypal.provider.js.map

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

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

@@ -0,0 +1,38 @@
+import type { PaymentProvider, CheckoutParams, CheckoutResult, WebhookEvent } from '../core/provider.interface.js';
+export interface SatimConfig {
+    merchantId: string;
+    password: string;
+    testMode?: boolean;
+    returnUrl: string;
+    failUrl: string;
+    /** ISO 4217 currency code, default '012' (DZD) */
+    currencyCode?: string;
+}
+export declare class SatimProvider implements PaymentProvider {
+    private config;
+    readonly name = "satim";
+    readonly supportedCurrencies: string[];
+    readonly supportedMethods: string[];
+    private baseUrl;
+    constructor(config: SatimConfig);
+    createCheckout(params: CheckoutParams): Promise<CheckoutResult>;
+    /**
+     * Confirm an order after redirect callback.
+     * Call this when Satim redirects back to returnUrl.
+     */
+    confirmOrder(orderId: string): Promise<{
+        paid: boolean;
+        actionCode: string;
+        errorMessage?: string;
+    }>;
+    /**
+     * Get order status.
+     */
+    getOrderStatus(orderId: string): Promise<Record<string, unknown>>;
+    verifyWebhook(body: string, _signature: string): Promise<WebhookEvent>;
+}
+/**
+ * Create a Satim provider from environment variables.
+ */
+export declare function createSatimProvider(config?: Partial<SatimConfig>): SatimProvider;
+//# sourceMappingURL=satim.provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"satim.provider.d.ts","sourceRoot":"","sources":["../../src/providers/satim.provider.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAElH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,qBAAa,aAAc,YAAW,eAAe;IAOvC,OAAO,CAAC,MAAM;IAN1B,QAAQ,CAAC,IAAI,WAAU;IACvB,QAAQ,CAAC,mBAAmB,WAAU;IACtC,QAAQ,CAAC,gBAAgB,WAAU;IAEnC,OAAO,CAAC,OAAO,CAAQ;gBAEH,MAAM,EAAE,WAAW;IAMjC,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IA6BrE;;;OAGG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAsB1G;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAiBjE,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAgB7E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,aAAa,CAQhF"}

package/dist/providers/satim.provider.js

@@ -0,0 +1,107 @@
+// @mostajs/payment — Satim/GIE Monetique provider (CIB — Algerie)
+// Author: Dr Hamid MADANI drmdh@msn.com
+// Ref: https://test.satim.dz/payment/rest/ (sandbox)
+export class SatimProvider {
+    config;
+    name = 'satim';
+    supportedCurrencies = ['DZD'];
+    supportedMethods = ['cib'];
+    baseUrl;
+    constructor(config) {
+        this.config = config;
+        this.baseUrl = config.testMode
+            ? 'https://test.satim.dz/payment/rest'
+            : 'https://cib.satim.dz/payment/rest';
+    }
+    async createCheckout(params) {
+        const body = new URLSearchParams({
+            orderNumber: params.orderId,
+            amount: String(Math.round(params.amount * 100)), // centimes DZD
+            currency: this.config.currencyCode ?? '012', // ISO 4217 DZD
+            returnUrl: params.successUrl ?? this.config.returnUrl,
+            failUrl: params.cancelUrl ?? this.config.failUrl,
+            userName: this.config.merchantId,
+            password: this.config.password,
+            language: 'FR',
+        });
+        if (params.description)
+            body.set('description', params.description);
+        const res = await fetch(`${this.baseUrl}/register.do`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body,
+        });
+        const data = await res.json();
+        if (data.errorCode && data.errorCode !== '0') {
+            throw new Error(`[satim] ${data.errorMessage ?? 'Registration failed'} (code: ${data.errorCode})`);
+        }
+        return { url: data.formUrl, sessionId: data.orderId };
+    }
+    /**
+     * Confirm an order after redirect callback.
+     * Call this when Satim redirects back to returnUrl.
+     */
+    async confirmOrder(orderId) {
+        const body = new URLSearchParams({
+            orderId,
+            userName: this.config.merchantId,
+            password: this.config.password,
+            language: 'FR',
+        });
+        const res = await fetch(`${this.baseUrl}/confirmOrder.do`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body,
+        });
+        const data = await res.json();
+        return {
+            paid: data.actionCode === 0 || data.actionCode === '0',
+            actionCode: String(data.actionCode),
+            errorMessage: data.ErrorMessage ?? data.errorMessage,
+        };
+    }
+    /**
+     * Get order status.
+     */
+    async getOrderStatus(orderId) {
+        const body = new URLSearchParams({
+            orderId,
+            userName: this.config.merchantId,
+            password: this.config.password,
+            language: 'FR',
+        });
+        const res = await fetch(`${this.baseUrl}/getOrderStatus.do`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body,
+        });
+        return res.json();
+    }
+    async verifyWebhook(body, _signature) {
+        // Satim uses redirect-based callbacks, not webhooks
+        // Parse the callback params
+        const params = new URLSearchParams(body);
+        const orderId = params.get('orderId') ?? '';
+        if (orderId) {
+            const status = await this.confirmOrder(orderId);
+            return {
+                type: status.paid ? 'payment.success' : 'payment.failed',
+                data: { orderId, ...status },
+            };
+        }
+        return { type: 'unknown', data: {} };
+    }
+}
+/**
+ * Create a Satim provider from environment variables.
+ */
+export function createSatimProvider(config) {
+    return new SatimProvider({
+        merchantId: config?.merchantId ?? process.env.SATIM_MERCHANT_ID ?? '',
+        password: config?.password ?? process.env.SATIM_PASSWORD ?? '',
+        testMode: config?.testMode ?? process.env.SATIM_TEST_MODE === 'true',
+        returnUrl: config?.returnUrl ?? process.env.SATIM_RETURN_URL ?? '/payment/callback',
+        failUrl: config?.failUrl ?? process.env.SATIM_FAIL_URL ?? '/payment/failed',
+    });
+}
+//# sourceMappingURL=satim.provider.js.map

package/dist/providers/satim.provider.js.map

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

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

@@ -0,0 +1,36 @@
+import Stripe from 'stripe';
+import type { PaymentProvider, CheckoutParams, CheckoutResult, CustomerParams, SubscriptionParams, SubscriptionResult, RefundParams, RefundResult, InvoiceResult, WebhookEvent } from '../core/provider.interface.js';
+export interface StripeConfig {
+    secretKey: string;
+    webhookSecret?: string;
+}
+export declare class StripeProvider implements PaymentProvider {
+    private config;
+    readonly name = "stripe";
+    readonly supportedCurrencies: string[];
+    readonly supportedMethods: string[];
+    stripe: Stripe;
+    constructor(config: StripeConfig);
+    createCheckout(params: CheckoutParams): Promise<CheckoutResult>;
+    createCustomer(params: CustomerParams): Promise<string>;
+    getCustomer(customerId: string): Promise<Record<string, unknown>>;
+    updateCustomer(customerId: string, params: Partial<CustomerParams>): Promise<Record<string, unknown>>;
+    createSubscription(params: SubscriptionParams): Promise<SubscriptionResult>;
+    getSubscription(subscriptionId: string): Promise<SubscriptionResult>;
+    cancelSubscription(subscriptionId: string, immediate?: boolean): Promise<void>;
+    changeSubscription(subscriptionId: string, newPriceId: string): Promise<SubscriptionResult>;
+    pauseSubscription(subscriptionId: string): Promise<void>;
+    resumeSubscription(subscriptionId: string): Promise<void>;
+    createRefund(params: RefundParams): Promise<RefundResult>;
+    listInvoices(customerId: string, limit?: number): Promise<InvoiceResult[]>;
+    getUpcomingInvoice(customerId: string): Promise<InvoiceResult | null>;
+    createPortal(customerId: string, returnUrl: string): Promise<{
+        url: string;
+    }>;
+    verifyWebhook(body: string, signature: string): Promise<WebhookEvent>;
+}
+/**
+ * Create a Stripe provider from environment variables.
+ */
+export declare function createStripeProvider(config?: Partial<StripeConfig>): StripeProvider;
+//# sourceMappingURL=stripe.provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stripe.provider.d.ts","sourceRoot":"","sources":["../../src/providers/stripe.provider.ts"],"names":[],"mappings":"AAGA,OAAO,MAAM,MAAM,QAAQ,CAAA;AAC3B,OAAO,KAAK,EACV,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAC/D,kBAAkB,EAAE,kBAAkB,EAAE,YAAY,EAAE,YAAY,EAClE,aAAa,EAAE,YAAY,EAC5B,MAAM,+BAA+B,CAAA;AAEtC,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,qBAAa,cAAe,YAAW,eAAe;IAOxC,OAAO,CAAC,MAAM;IAN1B,QAAQ,CAAC,IAAI,YAAW;IACxB,QAAQ,CAAC,mBAAmB,WAAQ;IACpC,QAAQ,CAAC,gBAAgB,WAAW;IAE7B,MAAM,EAAE,MAAM,CAAA;gBAED,MAAM,EAAE,YAAY;IAOlC,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAsC/D,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IASvD,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAKjE,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAWrG,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAe3E,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAUpE,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ9E,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAa3F,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxD,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzD,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAezD,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAY1E,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAgBrE,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAU7E,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAmB5E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,cAAc,CAKnF"}

package/dist/providers/stripe.provider.js

@@ -0,0 +1,203 @@
+// @mostajs/payment — Stripe provider (refactored from lib/stripe.ts)
+// Author: Dr Hamid MADANI drmdh@msn.com
+import Stripe from 'stripe';
+export class StripeProvider {
+    config;
+    name = 'stripe';
+    supportedCurrencies = ['*']; // all currencies
+    supportedMethods = ['card'];
+    stripe;
+    constructor(config) {
+        this.config = config;
+        if (!config.secretKey)
+            throw new Error('[stripe] secretKey is required');
+        this.stripe = new Stripe(config.secretKey);
+    }
+    // ─── Checkout ─────────────────────────────────
+    async createCheckout(params) {
+        if (params.priceId && params.customerId) {
+            // Subscription billing
+            const sessionParams = {
+                customer: params.customerId,
+                mode: 'subscription',
+                line_items: [{ price: params.priceId, quantity: 1 }],
+                success_url: params.successUrl,
+                cancel_url: params.cancelUrl,
+                metadata: params.metadata,
+            };
+            if (params.trialDays)
+                sessionParams.subscription_data = { trial_period_days: params.trialDays };
+            const session = await this.stripe.checkout.sessions.create(sessionParams);
+            return { url: session.url, sessionId: session.id };
+        }
+        // One-time payment
+        const currency = (params.currency ?? 'usd').toLowerCase();
+        const session = await this.stripe.checkout.sessions.create({
+            payment_method_types: ['card'],
+            line_items: [{
+                    price_data: {
+                        currency,
+                        product_data: { name: params.description ?? `Order ${params.orderId}` },
+                        unit_amount: Math.round(params.amount * 100),
+                    },
+                    quantity: 1,
+                }],
+            mode: 'payment',
+            success_url: params.successUrl,
+            cancel_url: params.cancelUrl,
+            metadata: { orderId: params.orderId, ...params.metadata },
+        });
+        return { url: session.url, sessionId: session.id };
+    }
+    // ─── Customers ────────────────────────────────
+    async createCustomer(params) {
+        const customer = await this.stripe.customers.create({
+            email: params.email,
+            name: params.name,
+            metadata: params.metadata,
+        });
+        return customer.id;
+    }
+    async getCustomer(customerId) {
+        const c = await this.stripe.customers.retrieve(customerId);
+        return c;
+    }
+    async updateCustomer(customerId, params) {
+        const c = await this.stripe.customers.update(customerId, {
+            ...(params.name ? { name: params.name } : {}),
+            ...(params.email ? { email: params.email } : {}),
+            ...(params.metadata ? { metadata: params.metadata } : {}),
+        });
+        return c;
+    }
+    // ─── Subscriptions ────────────────────────────
+    async createSubscription(params) {
+        const sub = await this.stripe.subscriptions.create({
+            customer: params.customerId,
+            items: [{ price: params.priceId }],
+            trial_period_days: params.trialDays,
+            metadata: params.metadata,
+        });
+        return {
+            id: sub.id,
+            status: sub.status,
+            customerId: sub.customer,
+            currentPeriodEnd: new Date(sub.current_period_end * 1000).toISOString(),
+        };
+    }
+    async getSubscription(subscriptionId) {
+        const sub = await this.stripe.subscriptions.retrieve(subscriptionId);
+        return {
+            id: sub.id,
+            status: sub.status,
+            customerId: sub.customer,
+            currentPeriodEnd: new Date(sub.current_period_end * 1000).toISOString(),
+        };
+    }
+    async cancelSubscription(subscriptionId, immediate) {
+        if (immediate) {
+            await this.stripe.subscriptions.cancel(subscriptionId);
+        }
+        else {
+            await this.stripe.subscriptions.update(subscriptionId, { cancel_at_period_end: true });
+        }
+    }
+    async changeSubscription(subscriptionId, newPriceId) {
+        const sub = await this.stripe.subscriptions.retrieve(subscriptionId);
+        const updated = await this.stripe.subscriptions.update(subscriptionId, {
+            items: [{ id: sub.items.data[0].id, price: newPriceId }],
+            proration_behavior: 'always_invoice',
+        });
+        return {
+            id: updated.id,
+            status: updated.status,
+            customerId: updated.customer,
+        };
+    }
+    async pauseSubscription(subscriptionId) {
+        await this.stripe.subscriptions.update(subscriptionId, {
+            pause_collection: { behavior: 'void' },
+        });
+    }
+    async resumeSubscription(subscriptionId) {
+        await this.stripe.subscriptions.update(subscriptionId, {
+            pause_collection: '',
+        });
+    }
+    // ─── Refunds ──────────────────────────────────
+    async createRefund(params) {
+        const refund = await this.stripe.refunds.create({
+            payment_intent: params.paymentId,
+            ...(params.amount ? { amount: Math.round(params.amount * 100) } : {}),
+            ...(params.metadata ? { metadata: params.metadata } : {}),
+        });
+        return {
+            id: refund.id,
+            amount: (refund.amount ?? 0) / 100,
+            status: refund.status ?? 'pending',
+        };
+    }
+    // ─── Invoices ─────────────────────────────────
+    async listInvoices(customerId, limit) {
+        const invoices = await this.stripe.invoices.list({ customer: customerId, limit: limit ?? 10 });
+        return invoices.data.map(inv => ({
+            id: inv.id,
+            amount: (inv.amount_paid ?? 0) / 100,
+            currency: inv.currency ?? 'usd',
+            status: inv.status ?? 'draft',
+            paidAt: inv.status_transitions?.paid_at ? new Date(inv.status_transitions.paid_at * 1000).toISOString() : undefined,
+            pdfUrl: inv.invoice_pdf ?? undefined,
+        }));
+    }
+    async getUpcomingInvoice(customerId) {
+        try {
+            const inv = await this.stripe.invoices.retrieveUpcoming({ customer: customerId });
+            return {
+                id: 'upcoming',
+                amount: (inv.amount_due ?? 0) / 100,
+                currency: inv.currency ?? 'usd',
+                status: 'upcoming',
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    // ─── Portal ───────────────────────────────────
+    async createPortal(customerId, returnUrl) {
+        const session = await this.stripe.billingPortal.sessions.create({
+            customer: customerId,
+            return_url: returnUrl,
+        });
+        return { url: session.url };
+    }
+    // ─── Webhooks ─────────────────────────────────
+    async verifyWebhook(body, signature) {
+        if (!this.config.webhookSecret)
+            throw new Error('[stripe] webhookSecret required for webhook verification');
+        const event = this.stripe.webhooks.constructEvent(body, signature, this.config.webhookSecret);
+        const typeMap = {
+            'checkout.session.completed': 'payment.success',
+            'customer.subscription.created': 'subscription.created',
+            'customer.subscription.updated': 'subscription.updated',
+            'customer.subscription.deleted': 'subscription.deleted',
+            'invoice.paid': 'invoice.paid',
+            'invoice.payment_failed': 'invoice.failed',
+        };
+        return {
+            type: typeMap[event.type] ?? event.type,
+            data: event.data.object,
+            raw: event,
+        };
+    }
+}
+/**
+ * Create a Stripe provider from environment variables.
+ */
+export function createStripeProvider(config) {
+    return new StripeProvider({
+        secretKey: config?.secretKey ?? process.env.STRIPE_SECRET_KEY ?? '',
+        webhookSecret: config?.webhookSecret ?? process.env.STRIPE_WEBHOOK_SECRET,
+    });
+}
+//# sourceMappingURL=stripe.provider.js.map

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

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

package/dist/schemas/payment.schema.d.ts

@@ -5,11 +5,15 @@ import type { EntitySchema } from '@mostajs/orm';
  * @param options.currency   - Default currency (default: 'USD')
  * @param options.relationTarget - Related entity name (e.g. 'Reservation', 'Order')
  * @param options.relationRequired - Whether the relation is required
+ * @param options.subscriptionTarget - Optional relation to Subscription entity
+ * @param options.invoiceTarget - Optional relation to Invoice entity
  */
 export declare function createPaymentSchema(options?: {
     currency?: string;
     relationTarget?: string;
     relationRequired?: boolean;
+    subscriptionTarget?: string;
+    invoiceTarget?: string;
 }): EntitySchema;
 /** Default Payment schema (no relation, USD currency) */
 export declare const PaymentSchema: EntitySchema;

package/dist/schemas/payment.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payment.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/payment.schema.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAEhD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B,GAAG,YAAY,CAiCf;AAED,yDAAyD;AACzD,eAAO,MAAM,aAAa,cAAwB,CAAA"}
+{"version":3,"file":"payment.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/payment.schema.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAEhD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,GAAG,YAAY,CAqDf;AAED,yDAAyD;AACzD,eAAO,MAAM,aAAa,cAAwB,CAAA"}

package/dist/schemas/payment.schema.js

@@ -4,6 +4,8 @@
  * @param options.currency   - Default currency (default: 'USD')
  * @param options.relationTarget - Related entity name (e.g. 'Reservation', 'Order')
  * @param options.relationRequired - Whether the relation is required
+ * @param options.subscriptionTarget - Optional relation to Subscription entity
+ * @param options.invoiceTarget - Optional relation to Invoice entity
  */
 export function createPaymentSchema(options) {
     const schema = {
@@ -32,6 +34,24 @@ export function createPaymentSchema(options) {
         };
         schema.indexes.push({ fields: { [relKey]: 'asc' } });
     }
+    if (options?.subscriptionTarget) {
+        const relKey = options.subscriptionTarget.toLowerCase();
+        schema.relations[relKey] = {
+            target: options.subscriptionTarget,
+            type: 'many-to-one',
+            required: false,
+        };
+        schema.indexes.push({ fields: { [relKey]: 'asc' } });
+    }
+    if (options?.invoiceTarget) {
+        const relKey = options.invoiceTarget.toLowerCase();
+        schema.relations[relKey] = {
+            target: options.invoiceTarget,
+            type: 'many-to-one',
+            required: false,
+        };
+        schema.indexes.push({ fields: { [relKey]: 'asc' } });
+    }
     return schema;
 }
 /** Default Payment schema (no relation, USD currency) */