awesome-node-checkout 1.0.1 → 1.1.0

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"payment-provider.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/payment-provider.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAE9E,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAE3B,8FAA8F;IAC9F,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAE/D,mDAAmD;IACnD,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEzF,2DAA2D;IAC3D,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAE7D,4DAA4D;IAC5D,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAE1E;;;OAGG;IACH,aAAa,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEvG;;;OAGG;IACH,cAAc,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACxE"}

package/dist/interfaces/payment-provider.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=payment-provider.interface.js.map

package/dist/interfaces/payment-provider.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-provider.interface.js","sourceRoot":"","sources":["../../src/interfaces/payment-provider.interface.ts"],"names":[],"mappings":""}

package/dist/interfaces/transaction-store.interface.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Arbitrary data associated with a transaction.
+ * Extended by providers that need to persist state across async flows
+ * (e.g. correlating a Satispay webhook with the original order).
+ */
+export interface TransactionData {
+    provider: string;
+    orderId?: string;
+    paymentId?: string;
+    createdAt: string;
+    metadata?: Record<string, any>;
+    [key: string]: any;
+}
+/**
+ * Abstraction over transaction state persistence.
+ * Built-in: InMemoryTransactionStore.
+ * Implement this interface to use Redis, PostgreSQL, MongoDB, etc.
+ */
+export interface ITransactionStore {
+    save(key: string, data: TransactionData): Promise<void>;
+    get(key: string): Promise<TransactionData | null>;
+    delete(key: string): Promise<void>;
+}
+//# sourceMappingURL=transaction-store.interface.d.ts.map

package/dist/interfaces/transaction-store.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-store.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/transaction-store.interface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAClD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC"}

package/dist/interfaces/transaction-store.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=transaction-store.interface.js.map

package/dist/interfaces/transaction-store.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-store.interface.js","sourceRoot":"","sources":["../../src/interfaces/transaction-store.interface.ts"],"names":[],"mappings":""}

package/dist/models/checkout-config.model.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Global configuration for CheckoutConfigurator.
+ */
+export interface CheckoutConfig {
+    /**
+     * When `true`, the event bus emits lifecycle events for every payment
+     * operation (payment.created, payment.completed, payment.failed, etc.).
+     * @default true
+     */
+    emitEvents?: boolean;
+}
+//# sourceMappingURL=checkout-config.model.d.ts.map

package/dist/models/checkout-config.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout-config.model.d.ts","sourceRoot":"","sources":["../../src/models/checkout-config.model.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}

package/dist/models/checkout-config.model.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=checkout-config.model.js.map

package/dist/models/checkout-config.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout-config.model.js","sourceRoot":"","sources":["../../src/models/checkout-config.model.ts"],"names":[],"mappings":""}

package/dist/models/errors.d.ts

@@ -0,0 +1,7 @@
+export type CheckoutErrorCode = 'PROVIDER_NOT_FOUND' | 'PROVIDER_ALREADY_REGISTERED' | 'PAYMENT_FAILED' | 'WEBHOOK_NOT_SUPPORTED' | 'REDIRECT_NOT_SUPPORTED' | 'TRANSACTION_NOT_FOUND';
+export declare class CheckoutError extends Error {
+    readonly code: CheckoutErrorCode;
+    readonly provider?: string | undefined;
+    constructor(message: string, code: CheckoutErrorCode, provider?: string | undefined);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/models/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/models/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GACzB,oBAAoB,GACpB,6BAA6B,GAC7B,gBAAgB,GAChB,uBAAuB,GACvB,wBAAwB,GACxB,uBAAuB,CAAC;AAE5B,qBAAa,aAAc,SAAQ,KAAK;aAGpB,IAAI,EAAE,iBAAiB;aACvB,QAAQ,CAAC,EAAE,MAAM;gBAFjC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,iBAAiB,EACvB,QAAQ,CAAC,EAAE,MAAM,YAAA;CASpC"}

package/dist/models/errors.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CheckoutError = void 0;
+class CheckoutError extends Error {
+    constructor(message, code, provider) {
+        super(message);
+        this.code = code;
+        this.provider = provider;
+        this.name = 'CheckoutError';
+        // Maintains proper stack trace in V8
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, CheckoutError);
+        }
+    }
+}
+exports.CheckoutError = CheckoutError;
+//# sourceMappingURL=errors.js.map

package/dist/models/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/models/errors.ts"],"names":[],"mappings":";;;AAQA,MAAa,aAAc,SAAQ,KAAK;IACtC,YACE,OAAe,EACC,IAAuB,EACvB,QAAiB;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAmB;QACvB,aAAQ,GAAR,QAAQ,CAAS;QAGjC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,qCAAqC;QACrC,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;CACF;AAbD,sCAaC"}

package/dist/models/payment-request.model.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Unified payment request passed to any provider.
+ * All monetary values are in major currency units (e.g. 9.99 for €9.99).
+ */
+export interface PaymentRequest {
+    /** Amount in major currency units (e.g. 9.99) */
+    amount: number;
+    /** ISO 4217 currency code (e.g. 'EUR', 'USD') */
+    currency: string;
+    /** Human-readable description of the payment */
+    description?: string;
+    /** URL to redirect the user to after a successful payment */
+    returnUrl: string;
+    /** URL to redirect the user to if the payment is cancelled */
+    cancelUrl: string;
+    /** External order identifier from the merchant's system */
+    orderId?: string;
+    /** Arbitrary key-value pairs forwarded to the provider when supported */
+    metadata?: Record<string, any>;
+}
+//# sourceMappingURL=payment-request.model.d.ts.map

package/dist/models/payment-request.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-request.model.d.ts","sourceRoot":"","sources":["../../src/models/payment-request.model.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IAEf,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IAEjB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAElB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAElB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC"}

package/dist/models/payment-request.model.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=payment-request.model.js.map

package/dist/models/payment-request.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-request.model.js","sourceRoot":"","sources":["../../src/models/payment-request.model.ts"],"names":[],"mappings":""}

package/dist/models/payment-result.model.d.ts

@@ -0,0 +1,23 @@
+/** Unified result returned by all payment operations */
+export interface PaymentResult {
+    success: boolean;
+    /** Provider-specific payment identifier */
+    paymentId?: string;
+    /** Redirect URL for the user (redirect-flow providers: PayPal, Nexi) */
+    approvalUrl?: string;
+    /** Current payment status (provider-specific string, e.g. 'COMPLETED', 'ACCEPTED') */
+    status?: string;
+    /** Error message if success is false */
+    error?: string;
+    /** Raw provider response — useful for debugging or provider-specific fields */
+    raw?: any;
+}
+/** Result returned by handleWebhook() */
+export interface WebhookResult {
+    success: boolean;
+    paymentId?: string;
+    status?: string;
+    error?: string;
+    raw?: any;
+}
+//# sourceMappingURL=payment-result.model.d.ts.map

package/dist/models/payment-result.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-result.model.d.ts","sourceRoot":"","sources":["../../src/models/payment-result.model.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IAEjB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,+EAA+E;IAC/E,GAAG,CAAC,EAAE,GAAG,CAAC;CACX;AAED,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,GAAG,CAAC;CACX"}

package/dist/models/payment-result.model.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=payment-result.model.js.map

package/dist/models/payment-result.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-result.model.js","sourceRoot":"","sources":["../../src/models/payment-result.model.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,64 @@
+import { BasePaymentProvider } from '../../abstract/base-payment-provider.abstract';
+import { PaymentRequest } from '../../models/payment-request.model';
+import { PaymentResult } from '../../models/payment-result.model';
+export interface NexiProviderConfig {
+    merchantId: string;
+    macKey: string;
+    /** Optional group identifier */
+    group?: string;
+    /** @default 'sandbox' */
+    environment?: 'sandbox' | 'production';
+}
+/**
+ * Nexi eCommerce provider.
+ * Flow: `redirect` — builds a signed checkout URL, redirects the user to Nexi,
+ * then handles the POST-back via `handleRedirect`.
+ *
+ * Note: Nexi XPay mandates SHA-1 for MAC computation. This is a requirement of
+ * the Nexi API and cannot be changed on the client side.
+ */
+export declare class NexiProvider extends BasePaymentProvider {
+    private readonly config;
+    readonly name = "nexi";
+    readonly flow: "redirect";
+    private readonly apiUrl;
+    constructor(config: NexiProviderConfig);
+    /**
+     * Computes the SHA-1 MAC required by Nexi to authenticate the payment request.
+     * Format: `codTrans={val}divisa={val}importo={val}{macKey}`
+     *
+     * SHA-1 is used here because Nexi XPay mandates it for MAC computation.
+     */
+    private generateMac;
+    /**
+     * Computes the SHA-1 MAC for the status (getPaymentDetails) API call.
+     * Format: `alias={alias}codTrans={codTrans}timestamp={timestamp}{macKey}`
+     */
+    private generateStatusMac;
+    /**
+     * Computes the SHA-1 MAC for the refund (storno) API call.
+     * Format: `alias={alias}codTrans={codTrans}importo={importo}timestamp={timestamp}{macKey}`
+     */
+    private generateRefundMac;
+    /**
+     * Verifies the SHA-1 MAC included in a Nexi POST-back response.
+     * Format: `codTrans={val}esito={val}importo={val}divisa={val}{macKey}`
+     */
+    private verifyResponseMac;
+    createPayment(request: PaymentRequest): Promise<PaymentResult>;
+    /**
+     * Validates the POST-back data from Nexi.
+     * `data` is the query/body object sent by Nexi to the returnUrl.
+     * The MAC is verified before the result is considered authoritative.
+     */
+    executePayment(paymentId: string, data?: Record<string, string>): Promise<PaymentResult>;
+    getPaymentDetails(paymentId: string): Promise<PaymentResult>;
+    refundPayment(paymentId: string, amount?: number): Promise<PaymentResult>;
+    /**
+     * Handles the POST-back from Nexi to the returnUrl.
+     * Nexi sends `esito`, `codTrans`, `importo`, `divisa`, `mac`, etc. as query/body params.
+     * The MAC is verified to ensure the response was not spoofed.
+     */
+    handleRedirect(query: Record<string, string>): Promise<PaymentResult>;
+}
+//# sourceMappingURL=nexi.provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nexi.provider.d.ts","sourceRoot":"","sources":["../../../src/providers/nexi/nexi.provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAElE,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,WAAW,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;CACxC;AAED;;;;;;;GAOG;AACH,qBAAa,YAAa,SAAQ,mBAAmB;IAMvC,OAAO,CAAC,QAAQ,CAAC,MAAM;IALnC,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;IAEpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEH,MAAM,EAAE,kBAAkB;IAQvD;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAKnB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAYnB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAiCpE;;;;OAIG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAoCxF,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA2B5D,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAkC/E;;;;OAIG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;CAG5E"}