cmi-node 1.0.0

package/dist/core/CallbackHandler.mjs

@@ -0,0 +1,90 @@
+export class CallbackHandler {
+    constructor(gateway, options) {
+        this.gateway = gateway;
+        this.options = {
+            autoRespond: options?.autoRespond ?? true,
+            successResponse: options?.successResponse ?? "",
+            failureResponse: options?.failureResponse ?? "FAILURE",
+            onSuccess: options?.onSuccess ?? (() => { }),
+            onFailure: options?.onFailure ?? (() => { }),
+            supportGetMethod: options?.supportGetMethod ?? true,
+        };
+    }
+    middleware() {
+        return async (req, res, next) => {
+            try {
+                const params = this.extractParams(req);
+                const result = this.gateway.verifyCallback(params);
+                if (result.success) {
+                    await Promise.resolve(this.options.onSuccess(result));
+                }
+                else {
+                    await Promise.resolve(this.options.onFailure(result));
+                }
+                if (this.options.autoRespond) {
+                    this.sendResponse(res, result);
+                }
+                else if (next) {
+                    req.paymentResult = result;
+                    next();
+                }
+            }
+            catch (error) {
+                if (this.options.autoRespond) {
+                    res.status(500).send("FAILURE");
+                }
+                else if (next) {
+                    next(error);
+                }
+            }
+        };
+    }
+    extractParams(req) {
+        const method = (req.method || "POST").toUpperCase();
+        if (method === "POST") {
+            return req.body || {};
+        }
+        if (this.options.supportGetMethod) {
+            return req.query || req.body || {};
+        }
+        return req.body || {};
+    }
+    sendResponse(res, result) {
+        try {
+            if (result.success) {
+                const response = this.options.successResponse || result.status;
+                res.status(200).send(response);
+            }
+            else {
+                const response = this.options.failureResponse;
+                res.status(200).send(response);
+            }
+        }
+        catch {
+            res.status(500).send("ERROR");
+        }
+    }
+    async handle(params) {
+        const result = this.gateway.verifyCallback(params);
+        if (result.success) {
+            await Promise.resolve(this.options.onSuccess(result));
+        }
+        else {
+            await Promise.resolve(this.options.onFailure(result));
+        }
+        return result;
+    }
+    getResponse(result) {
+        if (result.success) {
+            return {
+                status: 200,
+                body: this.options.successResponse || result.status,
+            };
+        }
+        return {
+            status: 200,
+            body: this.options.failureResponse,
+        };
+    }
+}
+//# sourceMappingURL=CallbackHandler.js.map

package/dist/core/CallbackVerifier.cjs

@@ -0,0 +1,92 @@
+const { HashUtil } = require("../utils/index.cjs");
+const { timingSafeCompare } = require("../utils/crypto/index.cjs");
+class CallbackVerifier {
+    constructor(config) {
+        this.config = config;
+    }
+    verify(callbackParams) {
+        console.log('[Callback] Received parameters:', callbackParams);
+        try {
+            const receivedHash = callbackParams.HASH || callbackParams.hash;
+            if (!receivedHash) {
+                return {
+                    success: false,
+                    status: 'FAILURE',
+                    message: 'Hash not found in callback',
+                };
+            }
+            const paramsForHash = { ...callbackParams };
+            delete paramsForHash.HASH;
+            delete paramsForHash.hash;
+            delete paramsForHash.encoding;
+            const calculatedHash = HashUtil.generate(paramsForHash, this.config.storeKey);
+            console.log('[Callback] Hash verification:');
+            console.log('  Received:', receivedHash.substring(0, 20) + '...');
+            console.log('  Calculated:', calculatedHash.substring(0, 20) + '...');
+            if (!timingSafeCompare(receivedHash, calculatedHash)) {
+                console.log('[Callback] ❌ Hash mismatch - possible tampering detected!');
+                return {
+                    success: false,
+                    status: 'FAILURE',
+                    message: 'Hash verification failed - possible tampering',
+                };
+            }
+            console.log('[Callback] ✅ Hash verified successfully');
+            const returnCode = String(callbackParams.ProcReturnCode || callbackParams.ReturnCode || '');
+            if (returnCode === '00') {
+                console.log('[Callback] ✅ Payment successful');
+                const response = this.getConfirmationResponse();
+                return {
+                    success: true,
+                    status: response,
+                    message: 'Payment successful',
+                    orderData: {
+                        orderId: callbackParams.oid,
+                        amount: parseFloat(callbackParams.amount),
+                        currency: callbackParams.currency,
+                        transactionId: callbackParams.TransId ||
+                            callbackParams.transId ||
+                            callbackParams.oid,
+                    },
+                };
+            }
+            else {
+                console.log(`[Callback] ❌ Payment failed with code: ${returnCode}`);
+                return {
+                    success: false,
+                    status: 'FAILURE',
+                    message: `Payment failed with return code: ${returnCode}`,
+                    errorCode: returnCode,
+                    errorMessage: callbackParams.ErrMsg || callbackParams.errMsg,
+                    orderData: {
+                        orderId: callbackParams.oid,
+                        amount: parseFloat(callbackParams.amount),
+                        currency: callbackParams.currency,
+                        transactionId: callbackParams.TransId ||
+                            callbackParams.transId ||
+                            callbackParams.oid,
+                    },
+                };
+            }
+        }
+        catch (error) {
+            console.error('[Callback] Error verifying callback:', error);
+            return {
+                success: false,
+                status: 'FAILURE',
+                message: `Error verifying callback: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+    getConfirmationResponse() {
+        if (this.config.confirmationMode === 'auto') {
+            return 'ACTION=POSTAUTH';
+        }
+        else {
+            return 'APPROVED';
+        }
+    }
+}
+//# sourceMappingURL=CallbackVerifier.js.map
+
+module.exports.CallbackVerifier = CallbackVerifier;

package/dist/core/CallbackVerifier.d.ts

@@ -0,0 +1,12 @@
+import { CallbackResult, ConfirmationMode } from '../types/index.js';
+export interface CallbackVerifierConfig {
+    storeKey: string;
+    confirmationMode: ConfirmationMode;
+}
+export declare class CallbackVerifier {
+    private readonly config;
+    constructor(config: CallbackVerifierConfig);
+    verify(callbackParams: Record<string, any>): CallbackResult;
+    private getConfirmationResponse;
+}
+//# sourceMappingURL=CallbackVerifier.d.ts.map

package/dist/core/CallbackVerifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CallbackVerifier.d.ts","sourceRoot":"","sources":["../../src/core/CallbackVerifier.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAI1D,MAAM,WAAW,sBAAsB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,gBAAgB,CAAC;CACtC;AAKD,qBAAa,gBAAgB;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;gBAEpC,MAAM,EAAE,sBAAsB;IAY1C,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,cAAc;IAmG3D,OAAO,CAAC,uBAAuB;CASlC"}

package/dist/core/CallbackVerifier.js.map

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

package/dist/core/CallbackVerifier.mjs

@@ -0,0 +1,90 @@
+import { HashUtil } from '../utils/index.mjs';
+import { timingSafeCompare } from '../utils/crypto/index.mjs';
+export class CallbackVerifier {
+    constructor(config) {
+        this.config = config;
+    }
+    verify(callbackParams) {
+        console.log('[Callback] Received parameters:', callbackParams);
+        try {
+            const receivedHash = callbackParams.HASH || callbackParams.hash;
+            if (!receivedHash) {
+                return {
+                    success: false,
+                    status: 'FAILURE',
+                    message: 'Hash not found in callback',
+                };
+            }
+            const paramsForHash = { ...callbackParams };
+            delete paramsForHash.HASH;
+            delete paramsForHash.hash;
+            delete paramsForHash.encoding;
+            const calculatedHash = HashUtil.generate(paramsForHash, this.config.storeKey);
+            console.log('[Callback] Hash verification:');
+            console.log('  Received:', receivedHash.substring(0, 20) + '...');
+            console.log('  Calculated:', calculatedHash.substring(0, 20) + '...');
+            if (!timingSafeCompare(receivedHash, calculatedHash)) {
+                console.log('[Callback] ❌ Hash mismatch - possible tampering detected!');
+                return {
+                    success: false,
+                    status: 'FAILURE',
+                    message: 'Hash verification failed - possible tampering',
+                };
+            }
+            console.log('[Callback] ✅ Hash verified successfully');
+            const returnCode = String(callbackParams.ProcReturnCode || callbackParams.ReturnCode || '');
+            if (returnCode === '00') {
+                console.log('[Callback] ✅ Payment successful');
+                const response = this.getConfirmationResponse();
+                return {
+                    success: true,
+                    status: response,
+                    message: 'Payment successful',
+                    orderData: {
+                        orderId: callbackParams.oid,
+                        amount: parseFloat(callbackParams.amount),
+                        currency: callbackParams.currency,
+                        transactionId: callbackParams.TransId ||
+                            callbackParams.transId ||
+                            callbackParams.oid,
+                    },
+                };
+            }
+            else {
+                console.log(`[Callback] ❌ Payment failed with code: ${returnCode}`);
+                return {
+                    success: false,
+                    status: 'FAILURE',
+                    message: `Payment failed with return code: ${returnCode}`,
+                    errorCode: returnCode,
+                    errorMessage: callbackParams.ErrMsg || callbackParams.errMsg,
+                    orderData: {
+                        orderId: callbackParams.oid,
+                        amount: parseFloat(callbackParams.amount),
+                        currency: callbackParams.currency,
+                        transactionId: callbackParams.TransId ||
+                            callbackParams.transId ||
+                            callbackParams.oid,
+                    },
+                };
+            }
+        }
+        catch (error) {
+            console.error('[Callback] Error verifying callback:', error);
+            return {
+                success: false,
+                status: 'FAILURE',
+                message: `Error verifying callback: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+    getConfirmationResponse() {
+        if (this.config.confirmationMode === 'auto') {
+            return 'ACTION=POSTAUTH';
+        }
+        else {
+            return 'APPROVED';
+        }
+    }
+}
+//# sourceMappingURL=CallbackVerifier.js.map

package/dist/core/FormGenerator.cjs

@@ -0,0 +1,44 @@
+const { SanitizationUtil } = require("../utils/index.cjs");
+class FormGenerator {
+    constructor(gatewayUrl) {
+        this.gatewayUrl = gatewayUrl;
+    }
+    generate(params) {
+        const escapedGatewayUrl = SanitizationUtil.escapeHtml(this.gatewayUrl);
+        const formInputs = Object.entries(params)
+            .map(([key, value]) => {
+            const escapedKey = SanitizationUtil.escapeHtml(key);
+            const escapedValue = SanitizationUtil.escapeHtml(String(value));
+            return `<input type="hidden" name="${escapedKey}" value="${escapedValue}" />`;
+        })
+            .join('\n');
+        console.log('Generated payment form HTML. \n', formInputs);
+        return `
+      <!DOCTYPE html>
+      <html>
+        <head>
+          <meta charset="UTF-8">
+          <title>Payment Redirect</title>
+        </head>
+        <body onload="document.paymentForm.submit();">
+          <form method="POST" action="${escapedGatewayUrl}" name="paymentForm">
+            ${formInputs}
+            <noscript>
+              <input type="submit" value="Click here to complete payment" />
+            </noscript>
+          </form>
+        </body>
+      </html>
+      `.trim();
+    }
+    generateInputs(params) {
+        return Object.entries(params).map(([key, value]) => {
+            const escapedKey = SanitizationUtil.escapeHtml(key);
+            const escapedValue = SanitizationUtil.escapeHtml(String(value));
+            return `<input type="hidden" name="${escapedKey}" value="${escapedValue}" />`;
+        });
+    }
+}
+//# sourceMappingURL=FormGenerator.js.map
+
+module.exports.FormGenerator = FormGenerator;

package/dist/core/FormGenerator.d.ts

@@ -0,0 +1,7 @@
+export declare class FormGenerator {
+    private readonly gatewayUrl;
+    constructor(gatewayUrl: string);
+    generate(params: Record<string, any>): string;
+    generateInputs(params: Record<string, any>): string[];
+}
+//# sourceMappingURL=FormGenerator.d.ts.map

package/dist/core/FormGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormGenerator.d.ts","sourceRoot":"","sources":["../../src/core/FormGenerator.ts"],"names":[],"mappings":"AAYA,qBAAa,aAAa;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,UAAU,EAAE,MAAM;IAU9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM;IAwC7C,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE;CAOxD"}

package/dist/core/FormGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormGenerator.js","sourceRoot":"","sources":["../../src/core/FormGenerator.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAK1C,MAAM,OAAO,aAAa;IAGtB,YAAY,UAAkB;QAC1B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IACjC,CAAC;IAQD,QAAQ,CAAC,MAA2B;QAChC,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAIvE,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;aACpC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YAClB,MAAM,UAAU,GAAG,gBAAgB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YACpD,MAAM,YAAY,GAAG,gBAAgB,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAChE,OAAO,8BAA8B,UAAU,YAAY,YAAY,MAAM,CAAC;QAClF,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAC;QAEhB,OAAO,CAAC,GAAG,CAAC,iCAAiC,EAAE,UAAU,CAAC,CAAC;QAE3D,OAAO;;;;;;;;wCAQyB,iBAAiB;cAC3C,UAAU;;;;;;;OAOjB,CAAC,IAAI,EAAE,CAAC;IACX,CAAC;IAQD,cAAc,CAAC,MAA2B;QACtC,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YAC/C,MAAM,UAAU,GAAG,gBAAgB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YACpD,MAAM,YAAY,GAAG,gBAAgB,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAChE,OAAO,8BAA8B,UAAU,YAAY,YAAY,MAAM,CAAC;QAClF,CAAC,CAAC,CAAC;IACP,CAAC;CACJ"}

package/dist/core/FormGenerator.mjs

@@ -0,0 +1,42 @@
+import { SanitizationUtil } from '../utils/index.mjs';
+export class FormGenerator {
+    constructor(gatewayUrl) {
+        this.gatewayUrl = gatewayUrl;
+    }
+    generate(params) {
+        const escapedGatewayUrl = SanitizationUtil.escapeHtml(this.gatewayUrl);
+        const formInputs = Object.entries(params)
+            .map(([key, value]) => {
+            const escapedKey = SanitizationUtil.escapeHtml(key);
+            const escapedValue = SanitizationUtil.escapeHtml(String(value));
+            return `<input type="hidden" name="${escapedKey}" value="${escapedValue}" />`;
+        })
+            .join('\n');
+        console.log('Generated payment form HTML. \n', formInputs);
+        return `
+      <!DOCTYPE html>
+      <html>
+        <head>
+          <meta charset="UTF-8">
+          <title>Payment Redirect</title>
+        </head>
+        <body onload="document.paymentForm.submit();">
+          <form method="POST" action="${escapedGatewayUrl}" name="paymentForm">
+            ${formInputs}
+            <noscript>
+              <input type="submit" value="Click here to complete payment" />
+            </noscript>
+          </form>
+        </body>
+      </html>
+      `.trim();
+    }
+    generateInputs(params) {
+        return Object.entries(params).map(([key, value]) => {
+            const escapedKey = SanitizationUtil.escapeHtml(key);
+            const escapedValue = SanitizationUtil.escapeHtml(String(value));
+            return `<input type="hidden" name="${escapedKey}" value="${escapedValue}" />`;
+        });
+    }
+}
+//# sourceMappingURL=FormGenerator.js.map

package/dist/core/PaymentBuilder.cjs

@@ -0,0 +1,63 @@
+const { PaymentValidator } = require("../validators/index.cjs");
+const { HashUtil, SanitizationUtil, FormatterUtil, GeneratorUtil } = require("../utils/index.cjs");
+const { normalizeLanguage } = require("../constants/index.cjs");
+const { OPTIONAL_PAYMENT_FIELDS, STANDARD_PAYMENT_FIELDS } = require("../constants/fields.cjs");
+class PaymentBuilder {
+    constructor(config) {
+        this.config = config;
+    }
+    build(paymentRequest) {
+        PaymentValidator.validate(paymentRequest);
+        const oid = paymentRequest.oid || GeneratorUtil.generateOrderId();
+        const rnd = paymentRequest.rnd || GeneratorUtil.generateRandom();
+        const params = {
+            clientid: this.config.clientId,
+            amount: FormatterUtil.formatAmount(paymentRequest.amount),
+            currency: FormatterUtil.formatCurrencyNumeric(String(paymentRequest.currency)),
+            oid,
+            rnd,
+            email: SanitizationUtil.sanitizeEmail(paymentRequest.email),
+            BillToName: SanitizationUtil.sanitizeString(paymentRequest.BillToName, 50),
+            okUrl: paymentRequest.okUrl,
+            failUrl: paymentRequest.failUrl,
+            storetype: FormatterUtil.formatStoreType(this.config.storetype),
+            trantype: this.config.trantype,
+            lang: normalizeLanguage(paymentRequest.lang || 'fr'),
+            shopurl: this.config.shopUrl,
+        };
+        params.hashAlgorithm = paymentRequest.hashAlgorithm ?? 'ver3';
+        params.encoding = paymentRequest.encoding ?? 'UTF-8';
+        if (this.config.callbackUrl) {
+            params.callbackURL = this.config.callbackUrl;
+        }
+        this.addOptionalFields(params, paymentRequest);
+        params.AutoRedirect = FormatterUtil.formatAutoRedirect(paymentRequest.AutoRedirect ?? false);
+        if (paymentRequest.amountCur !== undefined && paymentRequest.amountCur > 0) {
+            params.amountCur = FormatterUtil.formatAmount(paymentRequest.amountCur);
+        }
+        if (paymentRequest.symbolCur !== undefined) {
+            params.symbolCur = FormatterUtil.formatCurrencyCode(paymentRequest.symbolCur);
+        }
+        this.addCustomFields(params, paymentRequest);
+        params.hash = HashUtil.generate(params, this.config.storeKey);
+        return params;
+    }
+    addOptionalFields(params, paymentRequest) {
+        for (const field of OPTIONAL_PAYMENT_FIELDS) {
+            if (paymentRequest[field]) {
+                params[field] = SanitizationUtil.sanitizeString(String(paymentRequest[field]), 100);
+            }
+        }
+    }
+    addCustomFields(params, paymentRequest) {
+        const standardFields = new Set(STANDARD_PAYMENT_FIELDS);
+        for (const [key, value] of Object.entries(paymentRequest)) {
+            if (!standardFields.has(key) && !(key in params) && value !== undefined && value !== null) {
+                params[key] = String(value);
+            }
+        }
+    }
+}
+//# sourceMappingURL=PaymentBuilder.js.map
+
+module.exports.PaymentBuilder = PaymentBuilder;

package/dist/core/PaymentBuilder.d.ts

@@ -0,0 +1,17 @@
+import { PaymentRequest } from '../types/index.js';
+export interface PaymentBuilderConfig {
+    clientId: string;
+    storeKey: string;
+    storetype: string;
+    trantype: string;
+    shopUrl: string;
+    callbackUrl?: string;
+}
+export declare class PaymentBuilder {
+    private readonly config;
+    constructor(config: PaymentBuilderConfig);
+    build(paymentRequest: PaymentRequest): Record<string, any>;
+    private addOptionalFields;
+    private addCustomFields;
+}
+//# sourceMappingURL=PaymentBuilder.d.ts.map

package/dist/core/PaymentBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PaymentBuilder.d.ts","sourceRoot":"","sources":["../../src/core/PaymentBuilder.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAMxC,MAAM,WAAW,oBAAoB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAKD,qBAAa,cAAc;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;gBAElC,MAAM,EAAE,oBAAoB;IAUxC,KAAK,CAAC,cAAc,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAkE1D,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,eAAe;CAa1B"}

package/dist/core/PaymentBuilder.js.map

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

package/dist/core/PaymentBuilder.mjs

@@ -0,0 +1,61 @@
+import { PaymentValidator } from '../validators/index.mjs';
+import { HashUtil, SanitizationUtil, FormatterUtil, GeneratorUtil } from '../utils/index.mjs';
+import { normalizeLanguage } from '../constants/index.mjs';
+import { OPTIONAL_PAYMENT_FIELDS, STANDARD_PAYMENT_FIELDS } from '../constants/fields.mjs';
+export class PaymentBuilder {
+    constructor(config) {
+        this.config = config;
+    }
+    build(paymentRequest) {
+        PaymentValidator.validate(paymentRequest);
+        const oid = paymentRequest.oid || GeneratorUtil.generateOrderId();
+        const rnd = paymentRequest.rnd || GeneratorUtil.generateRandom();
+        const params = {
+            clientid: this.config.clientId,
+            amount: FormatterUtil.formatAmount(paymentRequest.amount),
+            currency: FormatterUtil.formatCurrencyNumeric(String(paymentRequest.currency)),
+            oid,
+            rnd,
+            email: SanitizationUtil.sanitizeEmail(paymentRequest.email),
+            BillToName: SanitizationUtil.sanitizeString(paymentRequest.BillToName, 50),
+            okUrl: paymentRequest.okUrl,
+            failUrl: paymentRequest.failUrl,
+            storetype: FormatterUtil.formatStoreType(this.config.storetype),
+            trantype: this.config.trantype,
+            lang: normalizeLanguage(paymentRequest.lang || 'fr'),
+            shopurl: this.config.shopUrl,
+        };
+        params.hashAlgorithm = paymentRequest.hashAlgorithm ?? 'ver3';
+        params.encoding = paymentRequest.encoding ?? 'UTF-8';
+        if (this.config.callbackUrl) {
+            params.callbackURL = this.config.callbackUrl;
+        }
+        this.addOptionalFields(params, paymentRequest);
+        params.AutoRedirect = FormatterUtil.formatAutoRedirect(paymentRequest.AutoRedirect ?? false);
+        if (paymentRequest.amountCur !== undefined && paymentRequest.amountCur > 0) {
+            params.amountCur = FormatterUtil.formatAmount(paymentRequest.amountCur);
+        }
+        if (paymentRequest.symbolCur !== undefined) {
+            params.symbolCur = FormatterUtil.formatCurrencyCode(paymentRequest.symbolCur);
+        }
+        this.addCustomFields(params, paymentRequest);
+        params.hash = HashUtil.generate(params, this.config.storeKey);
+        return params;
+    }
+    addOptionalFields(params, paymentRequest) {
+        for (const field of OPTIONAL_PAYMENT_FIELDS) {
+            if (paymentRequest[field]) {
+                params[field] = SanitizationUtil.sanitizeString(String(paymentRequest[field]), 100);
+            }
+        }
+    }
+    addCustomFields(params, paymentRequest) {
+        const standardFields = new Set(STANDARD_PAYMENT_FIELDS);
+        for (const [key, value] of Object.entries(paymentRequest)) {
+            if (!standardFields.has(key) && !(key in params) && value !== undefined && value !== null) {
+                params[key] = String(value);
+            }
+        }
+    }
+}
+//# sourceMappingURL=PaymentBuilder.js.map

package/dist/core/index.cjs

@@ -0,0 +1,12 @@
+ from './CMIPaymentGateway.js';
+ from './CallbackHandler.js';
+ from './PaymentBuilder.js';
+ from './FormGenerator.js';
+ from './CallbackVerifier.js';
+//# sourceMappingURL=index.js.map
+
+module.exports.CMIPaymentGateway = CMIPaymentGateway;
+module.exports.CallbackHandler = CallbackHandler;
+module.exports.PaymentBuilder = PaymentBuilder;
+module.exports.FormGenerator = FormGenerator;
+module.exports.CallbackVerifier = CallbackVerifier;

package/dist/core/index.d.ts

@@ -0,0 +1,7 @@
+export { CMIPaymentGateway } from './CMIPaymentGateway.js';
+export { CallbackHandler } from './CallbackHandler.js';
+export { PaymentBuilder } from './PaymentBuilder.js';
+export { FormGenerator } from './FormGenerator.js';
+export { CallbackVerifier } from './CallbackVerifier.js';
+export type { ConfirmationMode, CallbackMiddleware, CMIPaymentGatewayOptions, } from '../types/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,QAAQ,CAAC"}

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/core/index.mjs

@@ -0,0 +1,6 @@
+export { CMIPaymentGateway } from './CMIPaymentGateway.mjs';
+export { CallbackHandler } from './CallbackHandler.mjs';
+export { PaymentBuilder } from './PaymentBuilder.mjs';
+export { FormGenerator } from './FormGenerator.mjs';
+export { CallbackVerifier } from './CallbackVerifier.mjs';
+//# sourceMappingURL=index.js.map

package/dist/index.cjs

@@ -0,0 +1,44 @@
+ from './core/index.js';
+ from './constants/index.js';
+ from './validators/index.js';
+ from './utils/crypto/index.js';
+ from './logger/index.js';
+ from './middleware/index.js';
+ from './middleware/index.js';
+ from './middleware/index.js';
+ from './middleware/index.js';
+ from './middleware/index.js';
+//# sourceMappingURL=index.js.map
+
+module.exports.CMIPaymentGateway = CMIPaymentGateway;
+module.exports.CallbackHandler = CallbackHandler;
+module.exports.PaymentBuilder = PaymentBuilder;
+module.exports.FormGenerator = FormGenerator;
+module.exports.CallbackVerifier = CallbackVerifier;
+module.exports. = ;
+module.exports.SUPPORTED_CURRENCIES = SUPPORTED_CURRENCIES;
+module.exports.SUPPORTED_LANGUAGES = SUPPORTED_LANGUAGES;
+module.exports.SUPPORTED_STORE_TYPES = SUPPORTED_STORE_TYPES;
+module.exports.BILLING_FIELDS = BILLING_FIELDS;
+module.exports.OPTIONAL_PAYMENT_FIELDS = OPTIONAL_PAYMENT_FIELDS;
+module.exports.STANDARD_PAYMENT_FIELDS = STANDARD_PAYMENT_FIELDS;
+module.exports.HASH_SANITIZE_FIELDS = HASH_SANITIZE_FIELDS;
+module.exports. = ;
+module.exports.ConfigValidator = ConfigValidator;
+module.exports.PaymentValidator = PaymentValidator;
+module.exports.timingSafeCompare = timingSafeCompare;
+module.exports.sha512Base64 = sha512Base64;
+module.exports.logger = logger;
+module.exports.configureLogger = configureLogger;
+module.exports.resetLogger = resetLogger;
+module.exports.createExpressMiddleware = createExpressMiddleware;
+module.exports.createCallbackHandler = createCallbackHandler;
+module.exports. = ;
+module.exports.createNextJsHandler = createNextJsHandler;
+module.exports.handleNextJsCallback = handleNextJsCallback;
+module.exports.createFastifyHandler = createFastifyHandler;
+module.exports.registerFastifyCallback = registerFastifyCallback;
+module.exports.createHonoHandler = createHonoHandler;
+module.exports.registerHonoCallback = registerHonoCallback;
+module.exports.NestJSCallbackHandler = NestJSCallbackHandler;
+module.exports.createNestJSHandler = createNestJSHandler;

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { CMIPaymentGateway, CallbackHandler, PaymentBuilder, FormGenerator, CallbackVerifier, } from './core/index.js';
+export type { PaymentConfig, PaymentRequest, CallbackResult, CallbackHandlerOptions, CallbackRequest, CallbackResponse, ConfirmationMode, CallbackMiddleware, CMIPaymentGatewayOptions } from './types/index.js';
+export { SUPPORTED_CURRENCIES, SUPPORTED_LANGUAGES, SUPPORTED_STORE_TYPES, BILLING_FIELDS, OPTIONAL_PAYMENT_FIELDS, STANDARD_PAYMENT_FIELDS, HASH_SANITIZE_FIELDS, } from './constants/index.js';
+export { ConfigValidator, PaymentValidator } from './validators/index.js';
+export { timingSafeCompare, sha512Base64 } from './utils/crypto/index.js';
+export { logger, configureLogger, resetLogger } from './logger/index.js';
+export { createExpressMiddleware, createCallbackHandler, } from './middleware/index.js';
+export { createNextJsHandler, handleNextJsCallback } from './middleware/index.js';
+export { createFastifyHandler, registerFastifyCallback } from './middleware/index.js';
+export { createHonoHandler, registerHonoCallback } from './middleware/index.js';
+export { NestJSCallbackHandler, createNestJSHandler } from './middleware/index.js';
+//# sourceMappingURL=index.d.ts.map