awesome-node-checkout 1.0.1 → 1.0.2

package/dist/abstract/base-payment-provider.abstract.d.ts

@@ -0,0 +1,30 @@
+import { IPaymentProvider, PaymentFlow } from '../interfaces/payment-provider.interface';
+import { PaymentRequest } from '../models/payment-request.model';
+import { PaymentResult } from '../models/payment-result.model';
+/**
+ * Convenience base class for building custom payment providers.
+ * Provides the `errorResult` helper to normalize error handling.
+ *
+ * Usage:
+ * ```typescript
+ * export class MyProvider extends BasePaymentProvider {
+ *   readonly name = 'myprovider';
+ *   readonly flow = 'redirect' as const;
+ *   // ... implement abstract methods
+ * }
+ * ```
+ */
+export declare abstract class BasePaymentProvider implements IPaymentProvider {
+    abstract readonly name: string;
+    abstract readonly flow: PaymentFlow;
+    abstract createPayment(request: PaymentRequest): Promise<PaymentResult>;
+    abstract executePayment(paymentId: string, data?: Record<string, string>): Promise<PaymentResult>;
+    abstract getPaymentDetails(paymentId: string): Promise<PaymentResult>;
+    abstract refundPayment(paymentId: string, amount?: number): Promise<PaymentResult>;
+    /**
+     * Helper to produce a normalized error PaymentResult.
+     * Extracts message from Error instances automatically.
+     */
+    protected errorResult(error: unknown, fallback?: string): PaymentResult;
+}
+//# sourceMappingURL=base-payment-provider.abstract.d.ts.map

package/dist/abstract/base-payment-provider.abstract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-payment-provider.abstract.d.ts","sourceRoot":"","sources":["../../src/abstract/base-payment-provider.abstract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAE/D;;;;;;;;;;;;GAYG;AACH,8BAAsB,mBAAoB,YAAW,gBAAgB;IACnE,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAEpC,QAAQ,CAAC,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IACvE,QAAQ,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IACjG,QAAQ,CAAC,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IACrE,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAElF;;;OAGG;IACH,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAkB,GAAG,aAAa;CAIjF"}

package/dist/abstract/base-payment-provider.abstract.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BasePaymentProvider = void 0;
+/**
+ * Convenience base class for building custom payment providers.
+ * Provides the `errorResult` helper to normalize error handling.
+ *
+ * Usage:
+ * ```typescript
+ * export class MyProvider extends BasePaymentProvider {
+ *   readonly name = 'myprovider';
+ *   readonly flow = 'redirect' as const;
+ *   // ... implement abstract methods
+ * }
+ * ```
+ */
+class BasePaymentProvider {
+    /**
+     * Helper to produce a normalized error PaymentResult.
+     * Extracts message from Error instances automatically.
+     */
+    errorResult(error, fallback = 'Unknown error') {
+        const message = error instanceof Error ? error.message : fallback;
+        return { success: false, error: message };
+    }
+}
+exports.BasePaymentProvider = BasePaymentProvider;
+//# sourceMappingURL=base-payment-provider.abstract.js.map

package/dist/abstract/base-payment-provider.abstract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-payment-provider.abstract.js","sourceRoot":"","sources":["../../src/abstract/base-payment-provider.abstract.ts"],"names":[],"mappings":";;;AAIA;;;;;;;;;;;;GAYG;AACH,MAAsB,mBAAmB;IASvC;;;OAGG;IACO,WAAW,CAAC,KAAc,EAAE,QAAQ,GAAG,eAAe;QAC9D,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;QAClE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAC5C,CAAC;CACF;AAjBD,kDAiBC"}

package/dist/adapters/express/index.d.ts

@@ -0,0 +1,35 @@
+import { Router, RequestHandler } from 'express';
+import { CheckoutConfigurator } from '../../checkout-configurator';
+export interface ExpressCheckoutOptions {
+    /**
+     * Middleware applied to ALL checkout routes (e.g. API key auth).
+     * Webhooks are typically public — use `publicPaths` to exclude them.
+     */
+    middleware?: RequestHandler[];
+    /**
+     * Route suffixes that bypass `middleware` (e.g. [':provider/webhook']).
+     * Matched against the path suffix after the mount point.
+     */
+    publicPaths?: string[];
+}
+/**
+ * Creates an Express Router with all checkout endpoints pre-wired.
+ *
+ * Routes mounted:
+ * ```
+ * POST   /:provider              → createPayment
+ * POST   /:provider/execute      → executePayment
+ * GET    /:provider/redirect     → handleRedirect  (must come before /:provider/:id)
+ * GET    /:provider/:id          → getPaymentDetails
+ * POST   /:provider/refund       → refundPayment
+ * POST   /:provider/webhook      → handleWebhook
+ * ```
+ *
+ * Usage:
+ * ```typescript
+ * import { createCheckoutRouter } from 'awesome-node-checkout/express';
+ * app.use('/checkout', createCheckoutRouter(checkout));
+ * ```
+ */
+export declare function createCheckoutRouter(checkout: CheckoutConfigurator, options?: ExpressCheckoutOptions): Router;
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/express/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/express/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAqB,cAAc,EAAE,MAAM,SAAS,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAE9B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,GAAE,sBAA2B,GACnC,MAAM,CA8FR"}

package/dist/adapters/express/index.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCheckoutRouter = createCheckoutRouter;
+const express_1 = require("express");
+const errors_1 = require("../../models/errors");
+/**
+ * Creates an Express Router with all checkout endpoints pre-wired.
+ *
+ * Routes mounted:
+ * ```
+ * POST   /:provider              → createPayment
+ * POST   /:provider/execute      → executePayment
+ * GET    /:provider/redirect     → handleRedirect  (must come before /:provider/:id)
+ * GET    /:provider/:id          → getPaymentDetails
+ * POST   /:provider/refund       → refundPayment
+ * POST   /:provider/webhook      → handleWebhook
+ * ```
+ *
+ * Usage:
+ * ```typescript
+ * import { createCheckoutRouter } from 'awesome-node-checkout/express';
+ * app.use('/checkout', createCheckoutRouter(checkout));
+ * ```
+ */
+function createCheckoutRouter(checkout, options = {}) {
+    const router = (0, express_1.Router)();
+    // Apply shared middleware (skipping public paths)
+    if (options.middleware?.length) {
+        const publicPaths = options.publicPaths ?? [];
+        router.use((req, res, next) => {
+            const providerParam = String(req.params?.provider ?? '');
+            const isPublic = publicPaths.some((p) => req.path.endsWith(p) || req.path.includes(p.replace(':provider', providerParam)));
+            if (isPublic)
+                return next();
+            // Chain all middleware in sequence
+            const handlers = options.middleware;
+            const run = (i) => {
+                if (i >= handlers.length)
+                    return next();
+                handlers[i](req, res, () => run(i + 1));
+            };
+            run(0);
+        });
+    }
+    // ---- POST /:provider — create payment ------------------------------------
+    router.post('/:provider', async (req, res) => {
+        try {
+            const result = await checkout.createPayment(String(req.params.provider), req.body);
+            res.status(result.success ? 201 : 400).json(result);
+        }
+        catch (err) {
+            sendError(res, err);
+        }
+    });
+    // ---- POST /:provider/execute — execute payment ---------------------------
+    router.post('/:provider/execute', async (req, res) => {
+        try {
+            const { paymentId, data } = req.body;
+            const result = await checkout.executePayment(String(req.params.provider), paymentId, data);
+            res.status(result.success ? 200 : 400).json(result);
+        }
+        catch (err) {
+            sendError(res, err);
+        }
+    });
+    // ---- POST /:provider/refund — refund payment -----------------------------
+    router.post('/:provider/refund', async (req, res) => {
+        try {
+            const { paymentId, amount } = req.body;
+            const result = await checkout.refundPayment(String(req.params.provider), paymentId, amount);
+            res.status(result.success ? 200 : 400).json(result);
+        }
+        catch (err) {
+            sendError(res, err);
+        }
+    });
+    // ---- POST /:provider/webhook — handle webhook ----------------------------
+    router.post('/:provider/webhook', async (req, res) => {
+        try {
+            const result = await checkout.handleWebhook(String(req.params.provider), req.body, req.headers);
+            res.status(result.success ? 200 : 400).json(result);
+        }
+        catch (err) {
+            sendError(res, err);
+        }
+    });
+    // ---- GET /:provider/redirect — handle redirect callback ------------------
+    // NOTE: must be defined BEFORE /:provider/:id to avoid "redirect" being
+    // treated as a paymentId.
+    router.get('/:provider/redirect', async (req, res) => {
+        try {
+            const result = await checkout.handleRedirect(String(req.params.provider), req.query);
+            res.status(result.success ? 200 : 400).json(result);
+        }
+        catch (err) {
+            sendError(res, err);
+        }
+    });
+    // ---- GET /:provider/:id — get payment details ----------------------------
+    router.get('/:provider/:id', async (req, res) => {
+        try {
+            const result = await checkout.getPaymentDetails(String(req.params.provider), String(req.params.id));
+            res.status(result.success ? 200 : 404).json(result);
+        }
+        catch (err) {
+            sendError(res, err);
+        }
+    });
+    return router;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function sendError(res, err) {
+    if (err instanceof errors_1.CheckoutError) {
+        const statusMap = {
+            PROVIDER_NOT_FOUND: 404,
+            WEBHOOK_NOT_SUPPORTED: 422,
+            REDIRECT_NOT_SUPPORTED: 422,
+        };
+        const status = statusMap[err.code] ?? 500;
+        res.status(status).json({ success: false, error: err.message, code: err.code });
+    }
+    else {
+        const message = err instanceof Error ? err.message : 'Internal server error';
+        res.status(500).json({ success: false, error: message });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/express/index.js.map

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

package/dist/checkout-configurator.d.ts

@@ -0,0 +1,66 @@
+import { IPaymentProvider } from './interfaces/payment-provider.interface';
+import { PaymentRequest } from './models/payment-request.model';
+import { PaymentResult, WebhookResult } from './models/payment-result.model';
+import { CheckoutConfig } from './models/checkout-config.model';
+import { CheckoutEventBus } from './events/checkout-event-bus';
+/**
+ * Main entry point for awesome-node-checkout.
+ *
+ * Usage (framework-agnostic):
+ * ```typescript
+ * const checkout = new CheckoutConfigurator();
+ * checkout
+ *   .registerProvider(new PayPalProvider({ clientId, clientSecret }))
+ *   .registerProvider(new NexiProvider({ merchantId, macKey }))
+ *   .registerProvider(new SatispayProvider({ keyId, privateKey }));
+ *
+ * // Use directly in any framework
+ * const result = await checkout.createPayment('paypal', request);
+ * ```
+ *
+ * Usage with Express adapter:
+ * ```typescript
+ * import { createCheckoutRouter } from 'awesome-node-checkout/express';
+ * app.use('/checkout', createCheckoutRouter(checkout));
+ * ```
+ */
+export declare class CheckoutConfigurator {
+    private readonly config;
+    private readonly providers;
+    /** Event bus — subscribe to payment lifecycle events */
+    readonly events: CheckoutEventBus;
+    constructor(config?: CheckoutConfig);
+    /** Emits an event only when `config.emitEvents` is not explicitly `false`. */
+    private emit;
+    /**
+     * Register a payment provider. Chainable.
+     * @throws CheckoutError if a provider with the same name is already registered.
+     */
+    registerProvider(provider: IPaymentProvider): this;
+    /**
+     * Retrieve a registered provider by name.
+     * @throws CheckoutError if the provider is not found.
+     */
+    getProvider(name: string): IPaymentProvider;
+    /** Returns the names of all registered providers */
+    getRegisteredProviders(): string[];
+    /** Create a new payment via the specified provider */
+    createPayment(providerName: string, request: PaymentRequest): Promise<PaymentResult>;
+    /** Execute/capture a previously created payment */
+    executePayment(providerName: string, paymentId: string, data?: Record<string, string>): Promise<PaymentResult>;
+    /** Retrieve the current status and details of a payment */
+    getPaymentDetails(providerName: string, paymentId: string): Promise<PaymentResult>;
+    /** Issue a full or partial refund */
+    refundPayment(providerName: string, paymentId: string, amount?: number): Promise<PaymentResult>;
+    /**
+     * Handle an incoming webhook from the provider.
+     * @throws CheckoutError if the provider does not support webhooks.
+     */
+    handleWebhook(providerName: string, body: Record<string, unknown>, headers: Record<string, string>): Promise<WebhookResult>;
+    /**
+     * Handle the redirect callback from the provider (query params).
+     * @throws CheckoutError if the provider does not support redirect handling.
+     */
+    handleRedirect(providerName: string, query: Record<string, string>): Promise<PaymentResult>;
+}
+//# sourceMappingURL=checkout-configurator.d.ts.map

package/dist/checkout-configurator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout-configurator.d.ts","sourceRoot":"","sources":["../src/checkout-configurator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAEhE,OAAO,EAAE,gBAAgB,EAA2C,MAAM,6BAA6B,CAAC;AAExG;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,oBAAoB;IAMnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IALnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4C;IAEtE,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAA0B;gBAE9B,MAAM,GAAE,cAAmB;IAExD,8EAA8E;YAChE,IAAI;IASlB;;;OAGG;IACH,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAalD;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAY3C,oDAAoD;IACpD,sBAAsB,IAAI,MAAM,EAAE;IAIlC,sDAAsD;IAChD,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAa1F,mDAAmD;IAC7C,cAAc,CAClB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,OAAO,CAAC,aAAa,CAAC;IAYzB,2DAA2D;IACrD,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAKxF,qCAAqC;IAC/B,aAAa,CACjB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,CAAC;IAYzB;;;OAGG;IACG,aAAa,CACjB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,OAAO,CAAC,aAAa,CAAC;IAoBzB;;;OAGG;IACG,cAAc,CAClB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,OAAO,CAAC,aAAa,CAAC;CAkB1B"}

package/dist/checkout-configurator.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CheckoutConfigurator = void 0;
+const errors_1 = require("./models/errors");
+const checkout_event_bus_1 = require("./events/checkout-event-bus");
+/**
+ * Main entry point for awesome-node-checkout.
+ *
+ * Usage (framework-agnostic):
+ * ```typescript
+ * const checkout = new CheckoutConfigurator();
+ * checkout
+ *   .registerProvider(new PayPalProvider({ clientId, clientSecret }))
+ *   .registerProvider(new NexiProvider({ merchantId, macKey }))
+ *   .registerProvider(new SatispayProvider({ keyId, privateKey }));
+ *
+ * // Use directly in any framework
+ * const result = await checkout.createPayment('paypal', request);
+ * ```
+ *
+ * Usage with Express adapter:
+ * ```typescript
+ * import { createCheckoutRouter } from 'awesome-node-checkout/express';
+ * app.use('/checkout', createCheckoutRouter(checkout));
+ * ```
+ */
+class CheckoutConfigurator {
+    constructor(config = {}) {
+        this.config = config;
+        this.providers = new Map();
+        /** Event bus — subscribe to payment lifecycle events */
+        this.events = new checkout_event_bus_1.CheckoutEventBus();
+    }
+    /** Emits an event only when `config.emitEvents` is not explicitly `false`. */
+    async emit(event, data) {
+        if (this.config.emitEvents !== false) {
+            await this.events.emit(event, data);
+        }
+    }
+    /**
+     * Register a payment provider. Chainable.
+     * @throws CheckoutError if a provider with the same name is already registered.
+     */
+    registerProvider(provider) {
+        const key = provider.name.toLowerCase();
+        if (this.providers.has(key)) {
+            throw new errors_1.CheckoutError(`Provider '${provider.name}' is already registered`, 'PROVIDER_ALREADY_REGISTERED', provider.name);
+        }
+        this.providers.set(key, provider);
+        return this;
+    }
+    /**
+     * Retrieve a registered provider by name.
+     * @throws CheckoutError if the provider is not found.
+     */
+    getProvider(name) {
+        const provider = this.providers.get(name.toLowerCase());
+        if (!provider) {
+            throw new errors_1.CheckoutError(`Payment provider '${name}' not found. Did you call registerProvider()?`, 'PROVIDER_NOT_FOUND', name);
+        }
+        return provider;
+    }
+    /** Returns the names of all registered providers */
+    getRegisteredProviders() {
+        return Array.from(this.providers.keys());
+    }
+    /** Create a new payment via the specified provider */
+    async createPayment(providerName, request) {
+        const provider = this.getProvider(providerName);
+        const result = await provider.createPayment(request);
+        await this.emit(result.success ? 'payment.created' : 'payment.failed', {
+            provider: providerName,
+            paymentId: result.paymentId,
+            orderId: request.orderId,
+            status: result.status,
+            error: result.error,
+        });
+        return result;
+    }
+    /** Execute/capture a previously created payment */
+    async executePayment(providerName, paymentId, data) {
+        const provider = this.getProvider(providerName);
+        const result = await provider.executePayment(paymentId, data);
+        await this.emit(result.success ? 'payment.completed' : 'payment.failed', {
+            provider: providerName,
+            paymentId,
+            status: result.status,
+            error: result.error,
+        });
+        return result;
+    }
+    /** Retrieve the current status and details of a payment */
+    async getPaymentDetails(providerName, paymentId) {
+        const provider = this.getProvider(providerName);
+        return provider.getPaymentDetails(paymentId);
+    }
+    /** Issue a full or partial refund */
+    async refundPayment(providerName, paymentId, amount) {
+        const provider = this.getProvider(providerName);
+        const result = await provider.refundPayment(paymentId, amount);
+        await this.emit('payment.refunded', {
+            provider: providerName,
+            paymentId,
+            status: result.status,
+            error: result.error,
+        });
+        return result;
+    }
+    /**
+     * Handle an incoming webhook from the provider.
+     * @throws CheckoutError if the provider does not support webhooks.
+     */
+    async handleWebhook(providerName, body, headers) {
+        const provider = this.getProvider(providerName);
+        if (!provider.handleWebhook) {
+            throw new errors_1.CheckoutError(`Provider '${providerName}' does not support webhook handling`, 'WEBHOOK_NOT_SUPPORTED', providerName);
+        }
+        const result = await provider.handleWebhook(body, headers);
+        await this.emit('webhook.received', {
+            provider: providerName,
+            paymentId: result.paymentId,
+            status: result.status,
+            error: result.error,
+            data: body,
+        });
+        return result;
+    }
+    /**
+     * Handle the redirect callback from the provider (query params).
+     * @throws CheckoutError if the provider does not support redirect handling.
+     */
+    async handleRedirect(providerName, query) {
+        const provider = this.getProvider(providerName);
+        if (!provider.handleRedirect) {
+            throw new errors_1.CheckoutError(`Provider '${providerName}' does not support redirect handling`, 'REDIRECT_NOT_SUPPORTED', providerName);
+        }
+        const result = await provider.handleRedirect(query);
+        await this.emit(result.success ? 'payment.completed' : 'payment.failed', {
+            provider: providerName,
+            paymentId: result.paymentId,
+            status: result.status,
+            error: result.error,
+        });
+        return result;
+    }
+}
+exports.CheckoutConfigurator = CheckoutConfigurator;
+//# sourceMappingURL=checkout-configurator.js.map

package/dist/checkout-configurator.js.map

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

package/dist/events/checkout-event-bus.d.ts

@@ -0,0 +1,29 @@
+export type CheckoutEventName = 'payment.created' | 'payment.completed' | 'payment.failed' | 'payment.refunded' | 'webhook.received';
+export interface CheckoutEventPayload {
+    provider: string;
+    paymentId?: string;
+    orderId?: string;
+    status?: string;
+    error?: string;
+    data?: any;
+    timestamp: Date;
+}
+type EventListener = (payload: CheckoutEventPayload) => void | Promise<void>;
+/**
+ * Simple event bus for checkout lifecycle events.
+ *
+ * Usage:
+ * ```typescript
+ * checkout.events.on('payment.completed', ({ provider, paymentId }) => {
+ *   console.log(`Payment ${paymentId} completed via ${provider}`);
+ * });
+ * ```
+ */
+export declare class CheckoutEventBus {
+    private readonly listeners;
+    on(event: CheckoutEventName, listener: EventListener): this;
+    off(event: CheckoutEventName, listener: EventListener): this;
+    emit(event: CheckoutEventName, payload: Omit<CheckoutEventPayload, 'timestamp'>): Promise<void>;
+}
+export {};
+//# sourceMappingURL=checkout-event-bus.d.ts.map

package/dist/events/checkout-event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout-event-bus.d.ts","sourceRoot":"","sources":["../../src/events/checkout-event-bus.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GACzB,iBAAiB,GACjB,mBAAmB,GACnB,gBAAgB,GAChB,kBAAkB,GAClB,kBAAkB,CAAC;AAEvB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,KAAK,aAAa,GAAG,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE7E;;;;;;;;;GASG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsD;IAEhF,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAM3D,GAAG,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAQtD,IAAI,CACR,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,IAAI,CAAC,oBAAoB,EAAE,WAAW,CAAC,GAC/C,OAAO,CAAC,IAAI,CAAC;CAKjB"}

package/dist/events/checkout-event-bus.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CheckoutEventBus = void 0;
+/**
+ * Simple event bus for checkout lifecycle events.
+ *
+ * Usage:
+ * ```typescript
+ * checkout.events.on('payment.completed', ({ provider, paymentId }) => {
+ *   console.log(`Payment ${paymentId} completed via ${provider}`);
+ * });
+ * ```
+ */
+class CheckoutEventBus {
+    constructor() {
+        this.listeners = new Map();
+    }
+    on(event, listener) {
+        const handlers = this.listeners.get(event) ?? [];
+        this.listeners.set(event, [...handlers, listener]);
+        return this;
+    }
+    off(event, listener) {
+        const handlers = this.listeners.get(event);
+        if (handlers) {
+            this.listeners.set(event, handlers.filter((h) => h !== listener));
+        }
+        return this;
+    }
+    async emit(event, payload) {
+        const handlers = this.listeners.get(event) ?? [];
+        const fullPayload = { ...payload, timestamp: new Date() };
+        await Promise.all(handlers.map((h) => h(fullPayload)));
+    }
+}
+exports.CheckoutEventBus = CheckoutEventBus;
+//# sourceMappingURL=checkout-event-bus.js.map

package/dist/events/checkout-event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout-event-bus.js","sourceRoot":"","sources":["../../src/events/checkout-event-bus.ts"],"names":[],"mappings":";;;AAmBA;;;;;;;;;GASG;AACH,MAAa,gBAAgB;IAA7B;QACmB,cAAS,GAA4C,IAAI,GAAG,EAAE,CAAC;IAwBlF,CAAC;IAtBC,EAAE,CAAC,KAAwB,EAAE,QAAuB;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACjD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAC,KAAwB,EAAE,QAAuB;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,IAAI,CACR,KAAwB,EACxB,OAAgD;QAEhD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACjD,MAAM,WAAW,GAAyB,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC;QAChF,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;CACF;AAzBD,4CAyBC"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export { CheckoutConfigurator } from './checkout-configurator';
+export type { IPaymentProvider, PaymentFlow } from './interfaces/payment-provider.interface';
+export type { ITransactionStore, TransactionData } from './interfaces/transaction-store.interface';
+export type { PaymentRequest } from './models/payment-request.model';
+export type { PaymentResult, WebhookResult } from './models/payment-result.model';
+export type { CheckoutConfig } from './models/checkout-config.model';
+export { CheckoutError } from './models/errors';
+export type { CheckoutErrorCode } from './models/errors';
+export { BasePaymentProvider } from './abstract/base-payment-provider.abstract';
+export { CheckoutEventBus } from './events/checkout-event-bus';
+export type { CheckoutEventName, CheckoutEventPayload } from './events/checkout-event-bus';
+export { InMemoryTransactionStore } from './stores/in-memory-transaction.store';
+export { PayPalProvider } from './providers/paypal/paypal.provider';
+export type { PayPalProviderConfig } from './providers/paypal/paypal.provider';
+export { NexiProvider } from './providers/nexi/nexi.provider';
+export type { NexiProviderConfig } from './providers/nexi/nexi.provider';
+export { SatispayProvider } from './providers/satispay/satispay.provider';
+export type { SatispayProviderConfig } from './providers/satispay/satispay.provider';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAG/D,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAC7F,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAGnG,YAAY,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAClF,YAAY,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAGhF,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAG3F,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAGhF,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,YAAY,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAE/E,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,YAAY,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC1E,YAAY,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SatispayProvider = exports.NexiProvider = exports.PayPalProvider = exports.InMemoryTransactionStore = exports.CheckoutEventBus = exports.BasePaymentProvider = exports.CheckoutError = exports.CheckoutConfigurator = void 0;
+// ---- Configurator ----------------------------------------------------------
+var checkout_configurator_1 = require("./checkout-configurator");
+Object.defineProperty(exports, "CheckoutConfigurator", { enumerable: true, get: function () { return checkout_configurator_1.CheckoutConfigurator; } });
+var errors_1 = require("./models/errors");
+Object.defineProperty(exports, "CheckoutError", { enumerable: true, get: function () { return errors_1.CheckoutError; } });
+// ---- Abstract --------------------------------------------------------------
+var base_payment_provider_abstract_1 = require("./abstract/base-payment-provider.abstract");
+Object.defineProperty(exports, "BasePaymentProvider", { enumerable: true, get: function () { return base_payment_provider_abstract_1.BasePaymentProvider; } });
+// ---- Events ----------------------------------------------------------------
+var checkout_event_bus_1 = require("./events/checkout-event-bus");
+Object.defineProperty(exports, "CheckoutEventBus", { enumerable: true, get: function () { return checkout_event_bus_1.CheckoutEventBus; } });
+// ---- Stores ----------------------------------------------------------------
+var in_memory_transaction_store_1 = require("./stores/in-memory-transaction.store");
+Object.defineProperty(exports, "InMemoryTransactionStore", { enumerable: true, get: function () { return in_memory_transaction_store_1.InMemoryTransactionStore; } });
+// ---- Providers -------------------------------------------------------------
+var paypal_provider_1 = require("./providers/paypal/paypal.provider");
+Object.defineProperty(exports, "PayPalProvider", { enumerable: true, get: function () { return paypal_provider_1.PayPalProvider; } });
+var nexi_provider_1 = require("./providers/nexi/nexi.provider");
+Object.defineProperty(exports, "NexiProvider", { enumerable: true, get: function () { return nexi_provider_1.NexiProvider; } });
+var satispay_provider_1 = require("./providers/satispay/satispay.provider");
+Object.defineProperty(exports, "SatispayProvider", { enumerable: true, get: function () { return satispay_provider_1.SatispayProvider; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,+EAA+E;AAC/E,iEAA+D;AAAtD,6HAAA,oBAAoB,OAAA;AAU7B,0CAAgD;AAAvC,uGAAA,aAAa,OAAA;AAGtB,+EAA+E;AAC/E,4FAAgF;AAAvE,qIAAA,mBAAmB,OAAA;AAE5B,+EAA+E;AAC/E,kEAA+D;AAAtD,sHAAA,gBAAgB,OAAA;AAGzB,+EAA+E;AAC/E,oFAAgF;AAAvE,uIAAA,wBAAwB,OAAA;AAEjC,+EAA+E;AAC/E,sEAAoE;AAA3D,iHAAA,cAAc,OAAA;AAGvB,gEAA8D;AAArD,6GAAA,YAAY,OAAA;AAGrB,4EAA0E;AAAjE,qHAAA,gBAAgB,OAAA"}

package/dist/interfaces/payment-provider.interface.d.ts

@@ -0,0 +1,33 @@
+import { PaymentRequest } from '../models/payment-request.model';
+import { PaymentResult, WebhookResult } from '../models/payment-result.model';
+export type PaymentFlow = 'redirect' | 'webhook' | 'direct';
+export interface IPaymentProvider {
+    /** Unique provider name, lowercase (e.g. 'paypal', 'nexi', 'satispay') */
+    readonly name: string;
+    /**
+     * Declares the confirmation flow used by this provider:
+     * - `redirect`: user is redirected to provider and returns with query params
+     * - `webhook`: provider calls a webhook URL asynchronously after payment
+     * - `direct`: payment is processed synchronously (e.g. card tokenization)
+     */
+    readonly flow: PaymentFlow;
+    /** Create a new payment and return a result (may include an approvalUrl for redirect flow) */
+    createPayment(request: PaymentRequest): Promise<PaymentResult>;
+    /** Execute/capture a previously created payment */
+    executePayment(paymentId: string, data?: Record<string, string>): Promise<PaymentResult>;
+    /** Retrieve the current status and details of a payment */
+    getPaymentDetails(paymentId: string): Promise<PaymentResult>;
+    /** Issue a full or partial refund on a completed payment */
+    refundPayment(paymentId: string, amount?: number): Promise<PaymentResult>;
+    /**
+     * Handle an incoming webhook notification from the provider.
+     * Optional — implement only for providers that use the `webhook` flow.
+     */
+    handleWebhook?(body: Record<string, unknown>, headers: Record<string, string>): Promise<WebhookResult>;
+    /**
+     * Handle the redirect callback from the provider (query params from returnUrl).
+     * Optional — implement only for providers that use the `redirect` flow.
+     */
+    handleRedirect?(query: Record<string, string>): Promise<PaymentResult>;
+}
+//# sourceMappingURL=payment-provider.interface.d.ts.map