@mostajs/payment 0.1.0 → 0.3.0

package/dist/core/payment-engine.d.ts

@@ -0,0 +1,26 @@
+import type { PaymentProvider } from './provider.interface.js';
+/**
+ * Register a payment provider.
+ */
+export declare function registerProvider(provider: PaymentProvider): void;
+/**
+ * Set the default provider.
+ */
+export declare function setDefaultProvider(name: string): void;
+/**
+ * Get a registered provider by name.
+ */
+export declare function getProvider(name?: string): PaymentProvider;
+/**
+ * List registered provider names.
+ */
+export declare function listProviders(): string[];
+/**
+ * Get the best provider for a given currency.
+ */
+export declare function getProviderForCurrency(currency: string): PaymentProvider | null;
+/**
+ * Reset all providers (for testing).
+ */
+export declare function resetProviders(): void;
+//# sourceMappingURL=payment-engine.d.ts.map

package/dist/core/payment-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-engine.d.ts","sourceRoot":"","sources":["../../src/core/payment-engine.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAK9D;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAGhE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAGrD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,CAM1D;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAExC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAO/E;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAGrC"}

package/dist/core/payment-engine.js

@@ -0,0 +1,57 @@
+// @mostajs/payment — Payment Engine (provider router)
+// Author: Dr Hamid MADANI drmdh@msn.com
+const _providers = new Map();
+let _defaultProvider = null;
+/**
+ * Register a payment provider.
+ */
+export function registerProvider(provider) {
+    _providers.set(provider.name, provider);
+    if (!_defaultProvider)
+        _defaultProvider = provider.name;
+}
+/**
+ * Set the default provider.
+ */
+export function setDefaultProvider(name) {
+    if (!_providers.has(name))
+        throw new Error(`[payment] Provider '${name}' not registered`);
+    _defaultProvider = name;
+}
+/**
+ * Get a registered provider by name.
+ */
+export function getProvider(name) {
+    const key = name ?? _defaultProvider;
+    if (!key)
+        throw new Error('[payment] No provider registered');
+    const p = _providers.get(key);
+    if (!p)
+        throw new Error(`[payment] Provider '${key}' not registered`);
+    return p;
+}
+/**
+ * List registered provider names.
+ */
+export function listProviders() {
+    return Array.from(_providers.keys());
+}
+/**
+ * Get the best provider for a given currency.
+ */
+export function getProviderForCurrency(currency) {
+    for (const p of _providers.values()) {
+        if (p.supportedCurrencies.includes('*') || p.supportedCurrencies.includes(currency.toUpperCase())) {
+            return p;
+        }
+    }
+    return null;
+}
+/**
+ * Reset all providers (for testing).
+ */
+export function resetProviders() {
+    _providers.clear();
+    _defaultProvider = null;
+}
+//# sourceMappingURL=payment-engine.js.map

package/dist/core/payment-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-engine.js","sourceRoot":"","sources":["../../src/core/payment-engine.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,wCAAwC;AAIxC,MAAM,UAAU,GAAG,IAAI,GAAG,EAA2B,CAAA;AACrD,IAAI,gBAAgB,GAAkB,IAAI,CAAA;AAE1C;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAyB;IACxD,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IACvC,IAAI,CAAC,gBAAgB;QAAE,gBAAgB,GAAG,QAAQ,CAAC,IAAI,CAAA;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,kBAAkB,CAAC,CAAA;IACzF,gBAAgB,GAAG,IAAI,CAAA;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAa;IACvC,MAAM,GAAG,GAAG,IAAI,IAAI,gBAAgB,CAAA;IACpC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAA;IAC7D,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC7B,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,kBAAkB,CAAC,CAAA;IACrE,OAAO,CAAC,CAAA;AACV,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAA;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,KAAK,MAAM,CAAC,IAAI,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;QACpC,IAAI,CAAC,CAAC,mBAAmB,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,mBAAmB,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YAClG,OAAO,CAAC,CAAA;QACV,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,UAAU,CAAC,KAAK,EAAE,CAAA;IAClB,gBAAgB,GAAG,IAAI,CAAA;AACzB,CAAC"}

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

@@ -0,0 +1,101 @@
+export interface CheckoutParams {
+    orderId: string;
+    amount: number;
+    currency?: string;
+    description?: string;
+    successUrl: string;
+    cancelUrl: string;
+    webhookUrl?: string;
+    metadata?: Record<string, string>;
+    /** For subscription billing */
+    customerId?: string;
+    priceId?: string;
+    trialDays?: number;
+}
+export interface CheckoutResult {
+    url: string | null;
+    sessionId: string;
+}
+export interface CustomerParams {
+    email: string;
+    name: string;
+    metadata?: Record<string, string>;
+}
+export interface SubscriptionParams {
+    customerId: string;
+    priceId: string;
+    trialDays?: number;
+    metadata?: Record<string, string>;
+}
+export interface SubscriptionResult {
+    id: string;
+    status: string;
+    customerId: string;
+    currentPeriodEnd?: string;
+}
+export interface RefundParams {
+    paymentId: string;
+    amount?: number;
+    reason?: string;
+    metadata?: Record<string, string>;
+}
+export interface RefundResult {
+    id: string;
+    amount: number;
+    status: string;
+}
+export interface InvoiceResult {
+    id: string;
+    amount: number;
+    currency: string;
+    status: string;
+    paidAt?: string;
+    pdfUrl?: string;
+}
+export interface WebhookEvent {
+    type: string;
+    data: Record<string, unknown>;
+    raw?: unknown;
+}
+/**
+ * PaymentProvider — contract for all payment providers.
+ * Implemented by: Satim, PayPal, Chargily, Stripe, Manual
+ */
+export interface PaymentProvider {
+    readonly name: string;
+    readonly supportedCurrencies: string[];
+    readonly supportedMethods: string[];
+    /** Create a checkout session (redirect user to payment page) */
+    createCheckout(params: CheckoutParams): Promise<CheckoutResult>;
+    /** Verify and parse a webhook payload */
+    verifyWebhook(body: string, signature: string): Promise<WebhookEvent>;
+    /** Create a customer (optional — not all providers support) */
+    createCustomer?(params: CustomerParams): Promise<string>;
+    /** Get customer details */
+    getCustomer?(customerId: string): Promise<Record<string, unknown>>;
+    /** Update customer */
+    updateCustomer?(customerId: string, params: Partial<CustomerParams>): Promise<Record<string, unknown>>;
+    /** Create a subscription */
+    createSubscription?(params: SubscriptionParams): Promise<SubscriptionResult>;
+    /** Get subscription details */
+    getSubscription?(subscriptionId: string): Promise<SubscriptionResult>;
+    /** Cancel a subscription */
+    cancelSubscription?(subscriptionId: string, immediate?: boolean): Promise<void>;
+    /** Change subscription plan */
+    changeSubscription?(subscriptionId: string, newPriceId: string): Promise<SubscriptionResult>;
+    /** Pause subscription */
+    pauseSubscription?(subscriptionId: string): Promise<void>;
+    /** Resume subscription */
+    resumeSubscription?(subscriptionId: string): Promise<void>;
+    /** Create a refund */
+    createRefund?(params: RefundParams): Promise<RefundResult>;
+    /** List invoices for a customer */
+    listInvoices?(customerId: string, limit?: number): Promise<InvoiceResult[]>;
+    /** Get upcoming invoice */
+    getUpcomingInvoice?(customerId: string): Promise<InvoiceResult | null>;
+    /** Create a billing portal session (self-service) */
+    createPortal?(customerId: string, returnUrl: string): Promise<{
+        url: string;
+    }>;
+}
+//# sourceMappingURL=provider.interface.d.ts.map

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

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

package/dist/core/provider.interface.js

@@ -0,0 +1,4 @@
+// @mostajs/payment — PaymentProvider interface (contrat commun)
+// Author: Dr Hamid MADANI drmdh@msn.com
+export {};
+//# sourceMappingURL=provider.interface.js.map

package/dist/core/provider.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.interface.js","sourceRoot":"","sources":["../../src/core/provider.interface.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,wCAAwC"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export type { PaymentConfig, PaymentStatus, PaymentMethodType, LineItem, CheckoutRequest, CheckoutResult, OrderSummary, PaymentDTO, } from './types/index.js';
+export type { WebhookHandlers } from './lib/stripe.js';
 export { PaymentSchema, createPaymentSchema } from './schemas/payment.schema.js';
 export { PaymentPage } from './components/PaymentPage.js';
 export { moduleInfo } from './lib/module-info.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,YAAY,EACV,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,QAAQ,EACR,eAAe,EACf,cAAc,EACd,YAAY,EACZ,UAAU,GACX,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAGhF,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAGzD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,YAAY,EACV,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,QAAQ,EACR,eAAe,EACf,cAAc,EACd,YAAY,EACZ,UAAU,GACX,MAAM,kBAAkB,CAAA;AAGzB,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAGtD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAGhF,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAGzD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,gDAAgD;AAChD,wCAAwC;AAcxC,SAAS;AACT,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAEhF,aAAa;AACb,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAEzD,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,gDAAgD;AAChD,wCAAwC;AAiBxC,SAAS;AACT,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAEhF,aAAa;AACb,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAEzD,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/lib/module-info.js

@@ -8,7 +8,7 @@ export const moduleInfo = {
     name: 'payment',
     label: 'Payment',
     description: 'Payment processing — Stripe, bank transfer, cash',
-    version: '0.1.0',
+    version: '0.3.0',
     schemas: ['Payment'],
 };
 //# sourceMappingURL=module-info.js.map

package/dist/lib/stripe.d.ts

@@ -13,4 +13,41 @@ export declare function createCheckoutSession(stripe: Stripe, request: CheckoutR
  * Construct and verify a Stripe webhook event.
  */
 export declare function handleWebhook(stripe: Stripe, body: string | Buffer, signature: string, secret: string): Promise<Stripe.Event>;
+/**
+ * Create a Stripe Billing (subscription) session.
+ */
+export declare function createBillingSession(stripe: Stripe, request: {
+    customerId: string;
+    priceId: string;
+    successUrl: string;
+    cancelUrl: string;
+    trialDays?: number;
+    metadata?: Record<string, string>;
+}): Promise<{
+    url: string | null;
+    sessionId: string;
+}>;
+/**
+ * Create a Stripe Customer Portal session.
+ */
+export declare function createPortalSession(stripe: Stripe, customerId: string, returnUrl: string): Promise<{
+    url: string;
+}>;
+/**
+ * Webhook handler callbacks for Stripe billing events.
+ */
+export interface WebhookHandlers {
+    onCheckoutCompleted?: (session: any) => Promise<void>;
+    onInvoicePaid?: (invoice: any) => Promise<void>;
+    onSubscriptionUpdated?: (subscription: any) => Promise<void>;
+    onSubscriptionDeleted?: (subscription: any) => Promise<void>;
+    onPaymentFailed?: (invoice: any) => Promise<void>;
+}
+/**
+ * Handle Stripe billing webhooks with event-type dispatch.
+ */
+export declare function handleBillingWebhook(stripe: Stripe, body: string | Buffer, signature: string, secret: string, handlers: WebhookHandlers): Promise<{
+    received: boolean;
+    type: string;
+}>;
 //# sourceMappingURL=stripe.d.ts.map

package/dist/lib/stripe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stripe.d.ts","sourceRoot":"","sources":["../../src/lib/stripe.ts"],"names":[],"mappings":"AAEA,OAAO,MAAM,MAAM,QAAQ,CAAA;AAC3B,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEvF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAKhE;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,cAAc,CAAC,CA0BzB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAEvB"}
+{"version":3,"file":"stripe.d.ts","sourceRoot":"","sources":["../../src/lib/stripe.ts"],"names":[],"mappings":"AAEA,OAAO,MAAM,MAAM,QAAQ,CAAA;AAC3B,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEvF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAKhE;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,cAAc,CAAC,CA0BzB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAEvB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC7I,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAcpD;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAM1B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACrD,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/C,qBAAqB,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D,qBAAqB,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAClD;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAsB9C"}

package/dist/lib/stripe.js

@@ -15,7 +15,7 @@ export function createStripeClient(config) {
  * Generalized from booking-baloon /api/checkout — works with any line items.
  */
 export async function createCheckoutSession(stripe, request, config) {
-    const currency = (request.currency ?? config.currency ?? 'usd').toLowerCase();
+    const currency = (request.currency ?? config.defaultCurrency ?? config.currency ?? 'usd').toLowerCase();
     const session = await stripe.checkout.sessions.create({
         payment_method_types: ['card'],
         line_items: request.lineItems.map(item => ({
@@ -45,4 +45,56 @@ export async function createCheckoutSession(stripe, request, config) {
 export async function handleWebhook(stripe, body, signature, secret) {
     return stripe.webhooks.constructEvent(body, signature, secret);
 }
+/**
+ * Create a Stripe Billing (subscription) session.
+ */
+export async function createBillingSession(stripe, request) {
+    const params = {
+        customer: request.customerId,
+        mode: 'subscription',
+        line_items: [{ price: request.priceId, quantity: 1 }],
+        success_url: request.successUrl,
+        cancel_url: request.cancelUrl,
+        metadata: request.metadata,
+    };
+    if (request.trialDays) {
+        params.subscription_data = { trial_period_days: request.trialDays };
+    }
+    const session = await stripe.checkout.sessions.create(params);
+    return { url: session.url, sessionId: session.id };
+}
+/**
+ * Create a Stripe Customer Portal session.
+ */
+export async function createPortalSession(stripe, customerId, returnUrl) {
+    const session = await stripe.billingPortal.sessions.create({
+        customer: customerId,
+        return_url: returnUrl,
+    });
+    return { url: session.url };
+}
+/**
+ * Handle Stripe billing webhooks with event-type dispatch.
+ */
+export async function handleBillingWebhook(stripe, body, signature, secret, handlers) {
+    const event = stripe.webhooks.constructEvent(body, signature, secret);
+    switch (event.type) {
+        case 'checkout.session.completed':
+            await handlers.onCheckoutCompleted?.(event.data.object);
+            break;
+        case 'invoice.paid':
+            await handlers.onInvoicePaid?.(event.data.object);
+            break;
+        case 'customer.subscription.updated':
+            await handlers.onSubscriptionUpdated?.(event.data.object);
+            break;
+        case 'customer.subscription.deleted':
+            await handlers.onSubscriptionDeleted?.(event.data.object);
+            break;
+        case 'invoice.payment_failed':
+            await handlers.onPaymentFailed?.(event.data.object);
+            break;
+    }
+    return { received: true, type: event.type };
+}
 //# sourceMappingURL=stripe.js.map

package/dist/lib/stripe.js.map

@@ -1 +1 @@
-{"version":3,"file":"stripe.js","sourceRoot":"","sources":["../../src/lib/stripe.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,wCAAwC;AACxC,OAAO,MAAM,MAAM,QAAQ,CAAA;AAG3B;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAqB;IACtD,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;IAC1D,CAAC;IACD,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAA;AAC3C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAc,EACd,OAAwB,EACxB,MAAqB;IAErB,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAA;IAE7E,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;QACpD,oBAAoB,EAAE,CAAC,MAAM,CAAC;QAC9B,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACzC,UAAU,EAAE;gBACV,QAAQ;gBACR,YAAY,EAAE;oBACZ,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC/D;gBACD,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC,EAAE,mBAAmB;aACpE;YACD,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;QACH,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,MAAM,CAAC,kBAAkB,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC;QAC5E,UAAU,EAAE,MAAM,CAAC,iBAAiB,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC;QAC1E,QAAQ,EAAE;YACR,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,GAAG,OAAO,CAAC,QAAQ;SACpB;KACF,CAAC,CAAA;IAEF,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,CAAA;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAc,EACd,IAAqB,EACrB,SAAiB,EACjB,MAAc;IAEd,OAAO,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,CAAA;AAChE,CAAC"}
+{"version":3,"file":"stripe.js","sourceRoot":"","sources":["../../src/lib/stripe.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,30 @@
+import type { PaymentProvider, CheckoutParams, CheckoutResult, CustomerParams, WebhookEvent } from '../core/provider.interface.js';
+export interface ChargilyConfig {
+    apiKey: string;
+    testMode?: boolean;
+    successUrl: string;
+    failureUrl: string;
+    webhookUrl?: string;
+}
+export declare class ChargilyProvider implements PaymentProvider {
+    private config;
+    readonly name = "chargily";
+    readonly supportedCurrencies: string[];
+    readonly supportedMethods: string[];
+    private baseUrl;
+    constructor(config: ChargilyConfig);
+    private headers;
+    createCheckout(params: CheckoutParams): Promise<CheckoutResult>;
+    createCustomer(params: CustomerParams): Promise<string>;
+    getCustomer(customerId: string): Promise<Record<string, unknown>>;
+    /**
+     * Get payment details by checkout ID.
+     */
+    getPayment(checkoutId: string): Promise<Record<string, unknown>>;
+    verifyWebhook(body: string, signature: string): Promise<WebhookEvent>;
+}
+/**
+ * Create a Chargily provider from environment variables.
+ */
+export declare function createChargilyProvider(config?: Partial<ChargilyConfig>): ChargilyProvider;
+//# sourceMappingURL=chargily.provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chargily.provider.d.ts","sourceRoot":"","sources":["../../src/providers/chargily.provider.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAGlI,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,qBAAa,gBAAiB,YAAW,eAAe;IAO1C,OAAO,CAAC,MAAM;IAN1B,QAAQ,CAAC,IAAI,cAAa;IAC1B,QAAQ,CAAC,mBAAmB,WAAU;IACtC,QAAQ,CAAC,gBAAgB,WAAsB;IAE/C,OAAO,CAAC,OAAO,CAAQ;gBAEH,MAAM,EAAE,cAAc;IAM1C,OAAO,CAAC,OAAO;IAOT,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAwB/D,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBvD,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAMvE;;OAEG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAMhE,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CA0B5E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,gBAAgB,CAQzF"}

package/dist/providers/chargily.provider.js

@@ -0,0 +1,112 @@
+// @mostajs/payment — Chargily Pay V2 provider (CIB + EDAHABIA — Algerie)
+// Author: Dr Hamid MADANI drmdh@msn.com
+// Ref: https://dev.chargily.com/pay-v2/api-reference/
+// GitHub: https://github.com/chargily
+import { createHmac } from 'node:crypto';
+export class ChargilyProvider {
+    config;
+    name = 'chargily';
+    supportedCurrencies = ['DZD'];
+    supportedMethods = ['cib', 'edahabia'];
+    baseUrl;
+    constructor(config) {
+        this.config = config;
+        this.baseUrl = config.testMode
+            ? 'https://pay.chargily.net/test/api/v2'
+            : 'https://pay.chargily.net/api/v2';
+    }
+    headers() {
+        return {
+            'Authorization': `Bearer ${this.config.apiKey}`,
+            'Content-Type': 'application/json',
+        };
+    }
+    async createCheckout(params) {
+        const res = await fetch(`${this.baseUrl}/checkouts`, {
+            method: 'POST',
+            headers: this.headers(),
+            body: JSON.stringify({
+                amount: params.amount, // DZD (pas centimes — Chargily attend le montant reel)
+                currency: 'dzd',
+                success_url: params.successUrl ?? this.config.successUrl,
+                failure_url: params.cancelUrl ?? this.config.failureUrl,
+                webhook_endpoint: params.webhookUrl ?? this.config.webhookUrl,
+                description: params.description ?? `Commande ${params.orderId}`,
+                metadata: { orderId: params.orderId, ...params.metadata },
+            }),
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({}));
+            throw new Error(`[chargily] Checkout failed: ${err.message ?? res.statusText}`);
+        }
+        const data = await res.json();
+        return { url: data.checkout_url, sessionId: data.id };
+    }
+    async createCustomer(params) {
+        const res = await fetch(`${this.baseUrl}/customers`, {
+            method: 'POST',
+            headers: this.headers(),
+            body: JSON.stringify({
+                name: params.name,
+                email: params.email,
+                metadata: params.metadata,
+            }),
+        });
+        if (!res.ok)
+            throw new Error(`[chargily] Create customer failed: ${res.statusText}`);
+        const data = await res.json();
+        return data.id;
+    }
+    async getCustomer(customerId) {
+        const res = await fetch(`${this.baseUrl}/customers/${customerId}`, { headers: this.headers() });
+        if (!res.ok)
+            throw new Error(`[chargily] Get customer failed: ${res.statusText}`);
+        return res.json();
+    }
+    /**
+     * Get payment details by checkout ID.
+     */
+    async getPayment(checkoutId) {
+        const res = await fetch(`${this.baseUrl}/checkouts/${checkoutId}`, { headers: this.headers() });
+        if (!res.ok)
+            throw new Error(`[chargily] Get payment failed: ${res.statusText}`);
+        return res.json();
+    }
+    async verifyWebhook(body, signature) {
+        // Chargily signs with HMAC-SHA256 using the API key as secret
+        const computed = createHmac('sha256', this.config.apiKey).update(body).digest('hex');
+        if (computed !== signature) {
+            throw new Error('[chargily] Invalid webhook signature');
+        }
+        const data = JSON.parse(body);
+        const type = data.status === 'paid' ? 'payment.success'
+            : data.status === 'failed' ? 'payment.failed'
+                : data.status === 'canceled' ? 'payment.canceled'
+                    : 'payment.pending';
+        return {
+            type,
+            data: {
+                checkoutId: data.id,
+                amount: data.amount,
+                currency: data.currency,
+                status: data.status,
+                metadata: data.metadata,
+                orderId: data.metadata?.orderId,
+            },
+            raw: data,
+        };
+    }
+}
+/**
+ * Create a Chargily provider from environment variables.
+ */
+export function createChargilyProvider(config) {
+    return new ChargilyProvider({
+        apiKey: config?.apiKey ?? process.env.CHARGILY_API_KEY ?? '',
+        testMode: config?.testMode ?? process.env.CHARGILY_TEST_MODE !== 'false',
+        successUrl: config?.successUrl ?? process.env.CHARGILY_SUCCESS_URL ?? '/payment/success',
+        failureUrl: config?.failureUrl ?? process.env.CHARGILY_FAILURE_URL ?? '/payment/failed',
+        webhookUrl: config?.webhookUrl ?? process.env.CHARGILY_WEBHOOK_URL,
+    });
+}
+//# sourceMappingURL=chargily.provider.js.map

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

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

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

@@ -0,0 +1,20 @@
+import type { PaymentProvider, CheckoutParams, CheckoutResult, WebhookEvent } from '../core/provider.interface.js';
+export interface ManualConfig {
+    bankInfo?: {
+        rib: string;
+        bankName: string;
+        holder: string;
+    };
+    confirmationUrl?: string;
+}
+export declare class ManualProvider implements PaymentProvider {
+    private config;
+    readonly name = "manual";
+    readonly supportedCurrencies: string[];
+    readonly supportedMethods: string[];
+    constructor(config?: ManualConfig);
+    createCheckout(params: CheckoutParams): Promise<CheckoutResult>;
+    verifyWebhook(body: string, _signature: string): Promise<WebhookEvent>;
+}
+export declare function createManualProvider(config?: ManualConfig): ManualProvider;
+//# sourceMappingURL=manual.provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manual.provider.d.ts","sourceRoot":"","sources":["../../src/providers/manual.provider.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAElH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,qBAAa,cAAe,YAAW,eAAe;IAKxC,OAAO,CAAC,MAAM;IAJ1B,QAAQ,CAAC,IAAI,YAAW;IACxB,QAAQ,CAAC,mBAAmB,WAAQ;IACpC,QAAQ,CAAC,gBAAgB,WAA8B;gBAEnC,MAAM,GAAE,YAAiB;IAEvC,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAQ/D,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAI7E;AAED,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,cAAc,CAE1E"}

package/dist/providers/manual.provider.js

@@ -0,0 +1,26 @@
+// @mostajs/payment — Manual provider (cash, bank transfer, TPE)
+// Author: Dr Hamid MADANI drmdh@msn.com
+export class ManualProvider {
+    config;
+    name = 'manual';
+    supportedCurrencies = ['*'];
+    supportedMethods = ['cash', 'transfer', 'tpe'];
+    constructor(config = {}) {
+        this.config = config;
+    }
+    async createCheckout(params) {
+        // No external redirect — return confirmation page URL
+        const url = this.config.confirmationUrl
+            ? `${this.config.confirmationUrl}?orderId=${params.orderId}`
+            : params.successUrl;
+        return { url, sessionId: `manual_${params.orderId}` };
+    }
+    async verifyWebhook(body, _signature) {
+        const data = JSON.parse(body);
+        return { type: 'payment.manual', data };
+    }
+}
+export function createManualProvider(config) {
+    return new ManualProvider(config);
+}
+//# sourceMappingURL=manual.provider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manual.provider.js","sourceRoot":"","sources":["../../src/providers/manual.provider.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,wCAAwC;AASxC,MAAM,OAAO,cAAc;IAKL;IAJX,IAAI,GAAG,QAAQ,CAAA;IACf,mBAAmB,GAAG,CAAC,GAAG,CAAC,CAAA;IAC3B,gBAAgB,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,CAAA;IAEvD,YAAoB,SAAuB,EAAE;QAAzB,WAAM,GAAN,MAAM,CAAmB;IAAG,CAAC;IAEjD,KAAK,CAAC,cAAc,CAAC,MAAsB;QACzC,sDAAsD;QACtD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe;YACrC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,YAAY,MAAM,CAAC,OAAO,EAAE;YAC5D,CAAC,CAAC,MAAM,CAAC,UAAU,CAAA;QACrB,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,MAAM,CAAC,OAAO,EAAE,EAAE,CAAA;IACvD,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,IAAY,EAAE,UAAkB;QAClD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC7B,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAA;IACzC,CAAC;CACF;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAqB;IACxD,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,CAAA;AACnC,CAAC"}

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

@@ -0,0 +1,44 @@
+import type { PaymentProvider, CheckoutParams, CheckoutResult, RefundParams, RefundResult, WebhookEvent } from '../core/provider.interface.js';
+export interface PayPalConfig {
+    clientId: string;
+    secret: string;
+    testMode?: boolean;
+    returnUrl: string;
+    cancelUrl: string;
+    webhookId?: string;
+}
+export declare class PayPalProvider implements PaymentProvider {
+    private config;
+    readonly name = "paypal";
+    readonly supportedCurrencies: string[];
+    readonly supportedMethods: string[];
+    private baseUrl;
+    private tokenCache;
+    constructor(config: PayPalConfig);
+    private getAccessToken;
+    private api;
+    createCheckout(params: CheckoutParams): Promise<CheckoutResult>;
+    /**
+     * Capture a PayPal order after user approval.
+     * Call this when PayPal redirects back to returnUrl with ?token=ORDER_ID
+     */
+    captureOrder(orderId: string): Promise<{
+        status: string;
+        data: Record<string, unknown>;
+    }>;
+    /**
+     * Get order details.
+     */
+    getOrder(orderId: string): Promise<Record<string, unknown>>;
+    createRefund(params: RefundParams): Promise<RefundResult>;
+    verifyWebhook(body: string, signature: string): Promise<WebhookEvent>;
+    /**
+     * Verify webhook signature via PayPal API (production).
+     */
+    verifyWebhookSignature(headers: Record<string, string>, body: string): Promise<boolean>;
+}
+/**
+ * Create a PayPal provider from environment variables.
+ */
+export declare function createPayPalProvider(config?: Partial<PayPalConfig>): PayPalProvider;
+//# sourceMappingURL=paypal.provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paypal.provider.d.ts","sourceRoot":"","sources":["../../src/providers/paypal.provider.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAG9I,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,qBAAa,cAAe,YAAW,eAAe;IAQxC,OAAO,CAAC,MAAM;IAP1B,QAAQ,CAAC,IAAI,YAAW;IACxB,QAAQ,CAAC,mBAAmB,WAAoD;IAChF,QAAQ,CAAC,gBAAgB,WAAa;IAEtC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,UAAU,CAAoD;gBAElD,MAAM,EAAE,YAAY;YAM1B,cAAc;YAwBd,GAAG;IAiBX,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IA0BrE;;;OAGG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAK/F;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI3D,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAgBzD,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAwB3E;;OAEG;IACG,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAa9F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,cAAc,CASnF"}