pec-payment-sdk 1.1.1

package/dist/cjs/PecClient.js

@@ -0,0 +1,218 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PecClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+const constants_js_1 = require("./constants.js");
+const errors_js_1 = require("./errors.js");
+const soapClient_js_1 = require("./soapClient.js");
+const utils_js_1 = require("./utils.js");
+class PecClient {
+    constructor(options) {
+        if (!options?.loginAccount?.trim()) {
+            throw new errors_js_1.PecValidationError('loginAccount is required');
+        }
+        this.loginAccount = options.loginAccount;
+        this.defaultCallbackUrl = options.callbackUrl;
+    }
+    /** Starts a standard sale payment and returns a token plus redirect URL. */
+    async requestPayment(input) {
+        const callbackUrl = this.resolveCallbackUrl(input.callbackUrl);
+        const currency = input.currency ?? 'toman';
+        const result = await (0, soapClient_js_1.callSoapMethod)(constants_js_1.WSDL.SALE, 'SalePaymentRequestAsync', {
+            requestData: {
+                LoginAccount: this.loginAccount,
+                Amount: (0, utils_js_1.toRials)(input.amount, currency),
+                OrderId: input.orderId,
+                CallBackUrl: callbackUrl,
+                AdditionalData: input.additionalData ?? '',
+                Originator: input.originator ?? '',
+            },
+        });
+        const payload = result?.SalePaymentRequestResult ?? {};
+        return (0, utils_js_1.buildPaymentTokenResult)(payload.Status, payload.Token, payload.Message);
+    }
+    /** Starts an online multiplexed sale (تسهیم آنلاین). */
+    async requestMultiplexedPayment(input) {
+        const callbackUrl = this.resolveCallbackUrl(input.callbackUrl);
+        const currency = input.currency ?? 'toman';
+        const result = await (0, soapClient_js_1.callSoapMethod)(constants_js_1.WSDL.MULTIPLEXED_SALE, 'MultiplexedSaleWithIBANPaymentRequestAsync', {
+            requestData: {
+                LoginAccount: this.loginAccount,
+                Amount: (0, utils_js_1.toRials)(input.amount, currency),
+                OrderId: input.orderId,
+                CallBackUrl: callbackUrl,
+                AdditionalData: '',
+                Originator: input.originator ?? '',
+                MultiplexedAccounts: {
+                    MultiplexedAccount: (0, utils_js_1.mapMultiplexedAccounts)(input.accounts, currency),
+                },
+            },
+        });
+        const payload = result?.MultiplexedSaleWithIBANPaymentRequestResult ?? {};
+        return (0, utils_js_1.buildPaymentTokenResult)(payload.Status, payload.Token, payload.Message);
+    }
+    /** Starts a government-ID sale (شناسه حساب دولتی). */
+    async requestGovernmentPayment(input) {
+        const callbackUrl = this.resolveCallbackUrl(input.callbackUrl);
+        const currency = input.currency ?? 'toman';
+        const result = await (0, soapClient_js_1.callSoapMethod)(constants_js_1.WSDL.GOVERNMENT_SALE, 'SalePaymentRequestAsync', {
+            requestData: {
+                LoginAccount: this.loginAccount,
+                Amount: (0, utils_js_1.toRials)(input.amount, currency),
+                OrderId: input.orderId,
+                CallBackUrl: callbackUrl,
+                AdditionalData: `GOVId=${input.govId}`,
+                Originator: input.originator ?? '',
+            },
+        });
+        const payload = result?.SalePaymentRequestResult ?? {};
+        return (0, utils_js_1.buildPaymentTokenResult)(payload.Status, payload.Token, payload.Message);
+    }
+    /** Starts a government sale with multiplexed IBAN accounts. */
+    async requestGovernmentMultiplexedPayment(input) {
+        const callbackUrl = this.resolveCallbackUrl(input.callbackUrl);
+        const currency = input.currency ?? 'toman';
+        const result = await (0, soapClient_js_1.callSoapMethod)(constants_js_1.WSDL.GOVERNMENT_SALE, 'GovSaleWithMultiIbanPaymentRequestSW2Async', {
+            requestData: {
+                LoginAccount: this.loginAccount,
+                Amount: (0, utils_js_1.toRials)(input.amount, currency),
+                OrderId: input.orderId,
+                CallBackUrl: callbackUrl,
+                AdditionalData: `GOVId=${input.govId}`,
+                Originator: input.originator ?? '',
+                MultiplexedAccounts: {
+                    MultiplexedAccount: (0, utils_js_1.mapMultiplexedAccounts)(input.accounts, currency),
+                },
+            },
+        });
+        const payload = result?.GovSaleWithMultiIbanPaymentRequestSW2Result ?? {};
+        return (0, utils_js_1.buildPaymentTokenResult)(payload.Status, payload.Token, payload.Message);
+    }
+    /** Starts a bill payment request. */
+    async requestBillPayment(input) {
+        const callbackUrl = this.resolveCallbackUrl(input.callbackUrl);
+        const result = await (0, soapClient_js_1.callSoapMethod)(constants_js_1.WSDL.BILL, 'BillPaymentRequestAsync', {
+            requestData: {
+                LoginAccount: this.loginAccount,
+                BillId: input.billId,
+                PayId: input.payId,
+                OrderId: input.orderId,
+                Amount: '',
+                CallBackUrl: callbackUrl,
+                AdditionalData: input.additionalData ?? '',
+                Originator: input.originator ?? '',
+            },
+        });
+        const payload = result?.BillPaymentRequestResult ?? {};
+        return (0, utils_js_1.buildPaymentTokenResult)(payload.Status, payload.Token, payload.Message);
+    }
+    /** Retrieves bill details before payment. */
+    async getBillInfo(input) {
+        if (!input.billId?.trim() || !input.payId?.trim()) {
+            throw new errors_js_1.PecValidationError('billId and payId are required');
+        }
+        const result = await (0, soapClient_js_1.callSoapMethod)(constants_js_1.WSDL.BILL, 'GetBillInfoAsync', {
+            billId: input.billId,
+            payId: input.payId,
+        });
+        const payload = result?.GetBillInfoResult ?? {};
+        return (0, utils_js_1.normalizeBillInfoResult)(payload);
+    }
+    /** Starts a mobile top-up/charge request. */
+    async requestMobileTopup(input) {
+        const callbackUrl = this.resolveCallbackUrl(input.callbackUrl);
+        const currency = input.currency ?? 'toman';
+        const result = await (0, soapClient_js_1.callSoapMethod)(constants_js_1.WSDL.MOBILE_TOPUP, 'TopupChargeRequestAsync', {
+            requestData: {
+                LoginAccount: this.loginAccount,
+                OrderId: input.orderId,
+                ChargeMobileNumber: input.chargeMobileNumber,
+                RequesterMobileNumber: input.requesterMobileNumber,
+                TopupType: input.topupType,
+                Amount: (0, utils_js_1.toRials)(input.amount, currency),
+                CallBackUrl: callbackUrl,
+                AdditionalData: input.additionalData ?? '',
+                Originator: input.originator ?? '',
+            },
+        });
+        const payload = result?.TopupChargeRequestResult ?? {};
+        return (0, utils_js_1.buildPaymentTokenResult)(payload.Status, payload.Token, payload.Message);
+    }
+    /** Confirms/settles a successful payment using its token. */
+    async confirmPayment(input) {
+        if (input.token === undefined || input.token === null || input.token === '') {
+            throw new errors_js_1.PecValidationError('token is required');
+        }
+        const result = await (0, soapClient_js_1.callSoapMethod)(constants_js_1.WSDL.CONFIRM, 'ConfirmPaymentAsync', {
+            requestData: {
+                LoginAccount: this.loginAccount,
+                Token: input.token,
+            },
+        });
+        const payload = result?.ConfirmPaymentResult ?? {};
+        return {
+            status: (0, utils_js_1.normalizeSoapNumber)(payload.Status),
+            token: (0, utils_js_1.normalizeSoapField)(payload.Token),
+            cardNumberMasked: (0, utils_js_1.normalizeSoapField)(payload.CardNumberMasked),
+            rrn: (0, utils_js_1.normalizeSoapField)(payload.RRN),
+        };
+    }
+    /** Reverses a payment. Works only within the bank's allowed time window. */
+    async reversePayment(input) {
+        if (input.token === undefined || input.token === null || input.token === '') {
+            throw new errors_js_1.PecValidationError('token is required');
+        }
+        const result = await (0, soapClient_js_1.callSoapMethod)(constants_js_1.WSDL.REVERSAL, 'ReversalRequestAsync', {
+            requestData: {
+                LoginAccount: this.loginAccount,
+                Token: input.token,
+            },
+        });
+        const payload = result?.ReversalRequestResult ?? {};
+        return {
+            status: (0, utils_js_1.normalizeSoapNumber)(payload.Status),
+            token: (0, utils_js_1.normalizeSoapField)(payload.Token),
+            message: (0, utils_js_1.normalizeSoapField)(payload.Message),
+        };
+    }
+    /** Fetches sale transactions from PEC reporting REST API. */
+    async getSaleReport(input) {
+        if (!input.username?.trim() || !input.password?.trim()) {
+            throw new errors_js_1.PecValidationError('username and password are required');
+        }
+        (0, utils_js_1.validateSaleReportDateRange)(input.fromDate, input.toDate);
+        const authToken = Buffer.from(`${input.username}|${input.password}`).toString('base64');
+        try {
+            const response = await axios_1.default.post(constants_js_1.REPORT_API_URL, {
+                FromDate: input.fromDate,
+                ToDate: input.toDate,
+                RRN: input.rrn ?? '',
+                OrderId: input.orderId ?? '',
+                Token: input.token ?? '',
+            }, {
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Basic ${authToken}`,
+                },
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw new errors_js_1.PecTransportError('Failed to fetch sale report', error);
+        }
+    }
+    resolveCallbackUrl(callbackUrl) {
+        const resolved = callbackUrl ?? this.defaultCallbackUrl;
+        if (!resolved) {
+            throw new errors_js_1.PecValidationError('callbackUrl is required');
+        }
+        if (!(0, utils_js_1.isValidUrl)(resolved)) {
+            throw new errors_js_1.PecValidationError('callbackUrl must be a valid HTTP or HTTPS URL');
+        }
+        return resolved;
+    }
+}
+exports.PecClient = PecClient;

package/dist/cjs/constants.d.ts

@@ -0,0 +1,13 @@
+export declare const WSDL: {
+    readonly SALE: "https://pec.shaparak.ir/NewIPGServices/Sale/SaleService.asmx?WSDL";
+    readonly CONFIRM: "https://pec.shaparak.ir/NewIPGServices/Confirm/ConfirmService.asmx?WSDL";
+    readonly REVERSAL: "https://pec.shaparak.ir/NewIPGServices/Reverse/ReversalService.asmx?WSDL";
+    readonly MULTIPLEXED_SALE: "https://pec.shaparak.ir/NewIPGServices/MultiplexedSale/OnlineMultiplexedSalePaymentService.asmx?WSDL";
+    readonly GOVERNMENT_SALE: "https://pec.shaparak.ir/NewIPGServices/Sale/GovermentIdSaleServiceSW2.asmx?WSDL";
+    readonly BILL: "https://pec.shaparak.ir/NewIPGServices/Bill/BillService.asmx?WSDL";
+    readonly MOBILE_TOPUP: "https://pec.shaparak.ir/NewIPGServices/SimCharge/TopupChargeService.asmx?WSDL";
+};
+export declare const PAYMENT_PAGE_BASE = "https://pec.shaparak.ir/NewIPG/?Token=";
+export declare const REPORT_API_URL = "https://pgwservices.pec.ir/api/PGWReport/GetSaleReport";
+export declare const PEC_SUCCESS_STATUS = 0;
+//# sourceMappingURL=constants.d.ts.map

package/dist/cjs/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI;;;;;;;;CAUP,CAAC;AAEX,eAAO,MAAM,iBAAiB,2CAA2C,CAAC;AAE1E,eAAO,MAAM,cAAc,2DAA2D,CAAC;AAEvF,eAAO,MAAM,kBAAkB,IAAI,CAAC"}

package/dist/cjs/constants.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PEC_SUCCESS_STATUS = exports.REPORT_API_URL = exports.PAYMENT_PAGE_BASE = exports.WSDL = void 0;
+exports.WSDL = {
+    SALE: 'https://pec.shaparak.ir/NewIPGServices/Sale/SaleService.asmx?WSDL',
+    CONFIRM: 'https://pec.shaparak.ir/NewIPGServices/Confirm/ConfirmService.asmx?WSDL',
+    REVERSAL: 'https://pec.shaparak.ir/NewIPGServices/Reverse/ReversalService.asmx?WSDL',
+    MULTIPLEXED_SALE: 'https://pec.shaparak.ir/NewIPGServices/MultiplexedSale/OnlineMultiplexedSalePaymentService.asmx?WSDL',
+    GOVERNMENT_SALE: 'https://pec.shaparak.ir/NewIPGServices/Sale/GovermentIdSaleServiceSW2.asmx?WSDL',
+    BILL: 'https://pec.shaparak.ir/NewIPGServices/Bill/BillService.asmx?WSDL',
+    MOBILE_TOPUP: 'https://pec.shaparak.ir/NewIPGServices/SimCharge/TopupChargeService.asmx?WSDL',
+};
+exports.PAYMENT_PAGE_BASE = 'https://pec.shaparak.ir/NewIPG/?Token=';
+exports.REPORT_API_URL = 'https://pgwservices.pec.ir/api/PGWReport/GetSaleReport';
+exports.PEC_SUCCESS_STATUS = 0;

package/dist/cjs/errors.d.ts

@@ -0,0 +1,14 @@
+export declare class PecError extends Error {
+    readonly status: number;
+    readonly pecMessage?: string;
+    readonly cause?: unknown;
+    constructor(message: string, status: number, pecMessage?: string, cause?: unknown);
+}
+export declare class PecValidationError extends Error {
+    constructor(message: string);
+}
+export declare class PecTransportError extends Error {
+    readonly cause?: unknown;
+    constructor(message: string, cause?: unknown);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEb,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAOlF;AAED,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEb,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAK7C"}

package/dist/cjs/errors.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PecTransportError = exports.PecValidationError = exports.PecError = void 0;
+class PecError extends Error {
+    constructor(message, status, pecMessage, cause) {
+        super(message);
+        this.name = 'PecError';
+        this.status = status;
+        this.pecMessage = pecMessage;
+        this.cause = cause;
+    }
+}
+exports.PecError = PecError;
+class PecValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PecValidationError';
+    }
+}
+exports.PecValidationError = PecValidationError;
+class PecTransportError extends Error {
+    constructor(message, cause) {
+        super(message);
+        this.name = 'PecTransportError';
+        this.cause = cause;
+    }
+}
+exports.PecTransportError = PecTransportError;

package/dist/cjs/index.d.ts

@@ -0,0 +1,6 @@
+export { PecClient } from './PecClient.js';
+export { PecError, PecTransportError, PecValidationError } from './errors.js';
+export { PAYMENT_PAGE_BASE, PEC_SUCCESS_STATUS, REPORT_API_URL, WSDL } from './constants.js';
+export { generateOrderId, getPaymentPageUrl, isSuccessStatus, isValidHttpsUrl, isValidUrl, mapMultiplexedAccounts, normalizeBillInfoResult, normalizeSoapField, normalizeSoapNumber, parseCallback, shouldConfirmPayment, toRials, validateAmount, validateMultiplexedAccounts, validateSaleReportDateRange, } from './utils.js';
+export type { BillInfoResult, CallbackPayload, ConfirmPaymentInput, ConfirmPaymentResult, Currency, GetBillInfoInput, GetSaleReportInput, GetSaleReportResult, MultiplexedAccount, OrderId, PaymentTokenResult, PecClientOptions, RequestBillPaymentInput, RequestGovernmentMultiplexedPaymentInput, RequestGovernmentPaymentInput, RequestMobileTopupInput, RequestMultiplexedPaymentInput, RequestPaymentInput, ReversePaymentInput, ReversePaymentResult, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,UAAU,EACV,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,OAAO,EACP,cAAc,EACd,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,QAAQ,EACR,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,OAAO,EACP,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,EACvB,wCAAwC,EACxC,6BAA6B,EAC7B,uBAAuB,EACvB,8BAA8B,EAC9B,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateSaleReportDateRange = exports.validateMultiplexedAccounts = exports.validateAmount = exports.toRials = exports.shouldConfirmPayment = exports.parseCallback = exports.normalizeSoapNumber = exports.normalizeSoapField = exports.normalizeBillInfoResult = exports.mapMultiplexedAccounts = exports.isValidUrl = exports.isValidHttpsUrl = exports.isSuccessStatus = exports.getPaymentPageUrl = exports.generateOrderId = exports.WSDL = exports.REPORT_API_URL = exports.PEC_SUCCESS_STATUS = exports.PAYMENT_PAGE_BASE = exports.PecValidationError = exports.PecTransportError = exports.PecError = exports.PecClient = void 0;
+var PecClient_js_1 = require("./PecClient.js");
+Object.defineProperty(exports, "PecClient", { enumerable: true, get: function () { return PecClient_js_1.PecClient; } });
+var errors_js_1 = require("./errors.js");
+Object.defineProperty(exports, "PecError", { enumerable: true, get: function () { return errors_js_1.PecError; } });
+Object.defineProperty(exports, "PecTransportError", { enumerable: true, get: function () { return errors_js_1.PecTransportError; } });
+Object.defineProperty(exports, "PecValidationError", { enumerable: true, get: function () { return errors_js_1.PecValidationError; } });
+var constants_js_1 = require("./constants.js");
+Object.defineProperty(exports, "PAYMENT_PAGE_BASE", { enumerable: true, get: function () { return constants_js_1.PAYMENT_PAGE_BASE; } });
+Object.defineProperty(exports, "PEC_SUCCESS_STATUS", { enumerable: true, get: function () { return constants_js_1.PEC_SUCCESS_STATUS; } });
+Object.defineProperty(exports, "REPORT_API_URL", { enumerable: true, get: function () { return constants_js_1.REPORT_API_URL; } });
+Object.defineProperty(exports, "WSDL", { enumerable: true, get: function () { return constants_js_1.WSDL; } });
+var utils_js_1 = require("./utils.js");
+Object.defineProperty(exports, "generateOrderId", { enumerable: true, get: function () { return utils_js_1.generateOrderId; } });
+Object.defineProperty(exports, "getPaymentPageUrl", { enumerable: true, get: function () { return utils_js_1.getPaymentPageUrl; } });
+Object.defineProperty(exports, "isSuccessStatus", { enumerable: true, get: function () { return utils_js_1.isSuccessStatus; } });
+Object.defineProperty(exports, "isValidHttpsUrl", { enumerable: true, get: function () { return utils_js_1.isValidHttpsUrl; } });
+Object.defineProperty(exports, "isValidUrl", { enumerable: true, get: function () { return utils_js_1.isValidUrl; } });
+Object.defineProperty(exports, "mapMultiplexedAccounts", { enumerable: true, get: function () { return utils_js_1.mapMultiplexedAccounts; } });
+Object.defineProperty(exports, "normalizeBillInfoResult", { enumerable: true, get: function () { return utils_js_1.normalizeBillInfoResult; } });
+Object.defineProperty(exports, "normalizeSoapField", { enumerable: true, get: function () { return utils_js_1.normalizeSoapField; } });
+Object.defineProperty(exports, "normalizeSoapNumber", { enumerable: true, get: function () { return utils_js_1.normalizeSoapNumber; } });
+Object.defineProperty(exports, "parseCallback", { enumerable: true, get: function () { return utils_js_1.parseCallback; } });
+Object.defineProperty(exports, "shouldConfirmPayment", { enumerable: true, get: function () { return utils_js_1.shouldConfirmPayment; } });
+Object.defineProperty(exports, "toRials", { enumerable: true, get: function () { return utils_js_1.toRials; } });
+Object.defineProperty(exports, "validateAmount", { enumerable: true, get: function () { return utils_js_1.validateAmount; } });
+Object.defineProperty(exports, "validateMultiplexedAccounts", { enumerable: true, get: function () { return utils_js_1.validateMultiplexedAccounts; } });
+Object.defineProperty(exports, "validateSaleReportDateRange", { enumerable: true, get: function () { return utils_js_1.validateSaleReportDateRange; } });

package/dist/cjs/soapClient.d.ts

@@ -0,0 +1,6 @@
+import soap from 'soap';
+export declare function getSoapClient(wsdlUrl: string): Promise<soap.Client>;
+export declare function callSoapMethod<T>(wsdlUrl: string, methodName: string, args: Record<string, unknown>): Promise<T>;
+/** Clears cached SOAP clients (useful in tests). */
+export declare function clearSoapClientCache(): void;
+//# sourceMappingURL=soapClient.d.ts.map

package/dist/cjs/soapClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"soapClient.d.ts","sourceRoot":"","sources":["../../src/soapClient.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAKxB,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAWzE;AAED,wBAAsB,cAAc,CAAC,CAAC,EACpC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,CAAC,CAAC,CAqBZ;AAED,oDAAoD;AACpD,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}

package/dist/cjs/soapClient.js

@@ -0,0 +1,44 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSoapClient = getSoapClient;
+exports.callSoapMethod = callSoapMethod;
+exports.clearSoapClientCache = clearSoapClientCache;
+const soap_1 = __importDefault(require("soap"));
+const errors_js_1 = require("./errors.js");
+const clientCache = new Map();
+async function getSoapClient(wsdlUrl) {
+    let cached = clientCache.get(wsdlUrl);
+    if (!cached) {
+        cached = soap_1.default.createClientAsync(wsdlUrl).catch((error) => {
+            clientCache.delete(wsdlUrl);
+            throw new errors_js_1.PecTransportError(`Failed to create SOAP client for ${wsdlUrl}`, error);
+        });
+        clientCache.set(wsdlUrl, cached);
+    }
+    return cached;
+}
+async function callSoapMethod(wsdlUrl, methodName, args) {
+    try {
+        const client = await getSoapClient(wsdlUrl);
+        const method = client[methodName];
+        if (typeof method !== 'function') {
+            throw new errors_js_1.PecTransportError(`SOAP method "${methodName}" was not found in ${wsdlUrl}`);
+        }
+        const asyncMethod = method;
+        const [result] = await asyncMethod.call(client, args);
+        return result;
+    }
+    catch (error) {
+        if (error instanceof errors_js_1.PecTransportError) {
+            throw error;
+        }
+        throw new errors_js_1.PecTransportError(`SOAP call "${methodName}" failed`, error);
+    }
+}
+/** Clears cached SOAP clients (useful in tests). */
+function clearSoapClientCache() {
+    clientCache.clear();
+}

package/dist/cjs/types.d.ts

@@ -0,0 +1,122 @@
+export type Currency = 'rial' | 'toman';
+export type OrderId = string | number;
+export interface PecClientOptions {
+    /** Merchant terminal PIN (`LoginAccount` in PEC SOAP requests). */
+    loginAccount: string;
+    /** Default callback URL when not provided per request. */
+    callbackUrl?: string;
+}
+export interface RequestPaymentInput {
+    /** Amount in the unit specified by `currency`. Converted to Rials before sending to PEC. */
+    amount: number;
+    orderId: OrderId;
+    currency?: Currency;
+    callbackUrl?: string;
+    additionalData?: string;
+    originator?: string;
+}
+export interface PaymentTokenResult {
+    status: number;
+    message: string;
+    token: string;
+    paymentUrl?: string;
+}
+export interface ConfirmPaymentInput {
+    token: string | number;
+}
+export interface ConfirmPaymentResult {
+    status: number;
+    token: string;
+    cardNumberMasked: string;
+    rrn: string;
+}
+export interface ReversePaymentInput {
+    token: string | number;
+}
+export interface ReversePaymentResult {
+    status: number;
+    message: string;
+    token: string;
+}
+export interface MultiplexedAccount {
+    amount: number;
+    iban: string;
+    payId: string;
+}
+export interface RequestMultiplexedPaymentInput {
+    amount: number;
+    orderId: OrderId;
+    accounts: MultiplexedAccount[];
+    currency?: Currency;
+    callbackUrl?: string;
+    originator?: string;
+}
+export interface RequestGovernmentPaymentInput {
+    amount: number;
+    orderId: OrderId;
+    govId: string;
+    currency?: Currency;
+    callbackUrl?: string;
+    originator?: string;
+}
+export interface RequestGovernmentMultiplexedPaymentInput {
+    amount: number;
+    orderId: OrderId;
+    govId: string;
+    accounts: MultiplexedAccount[];
+    currency?: Currency;
+    callbackUrl?: string;
+    originator?: string;
+}
+export interface RequestBillPaymentInput {
+    orderId: OrderId;
+    billId: string;
+    payId: string;
+    callbackUrl?: string;
+    additionalData?: string;
+    originator?: string;
+}
+export interface GetBillInfoInput {
+    billId: string;
+    payId: string;
+}
+export interface BillInfoResult {
+    status: number;
+    message: string;
+    amount: string;
+    billId: string;
+    payId: string;
+}
+export interface RequestMobileTopupInput {
+    orderId: OrderId;
+    chargeMobileNumber: string;
+    requesterMobileNumber: string;
+    topupType: string | number;
+    amount: number;
+    currency?: Currency;
+    callbackUrl?: string;
+    additionalData?: string;
+    originator?: string;
+}
+export interface GetSaleReportInput {
+    username: string;
+    password: string;
+    fromDate: string;
+    toDate: string;
+    rrn?: string;
+    orderId?: OrderId;
+    token?: string | number;
+}
+export interface GetSaleReportResult {
+    [key: string]: unknown;
+}
+/** Fields POSTed by PEC to the merchant callback URL after payment. */
+export interface CallbackPayload {
+    token: string;
+    status: number;
+    orderId: string;
+    terminalNo: string;
+    amount: string;
+    rrn: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/types.d.ts.map

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

package/dist/cjs/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/utils.d.ts

@@ -0,0 +1,43 @@
+import type { CallbackPayload, Currency, MultiplexedAccount } from './types.js';
+/** Converts an amount to Rials for PEC API requests. */
+export declare function toRials(amount: number, currency?: Currency): number;
+/** Ensures amount is a positive finite number. */
+export declare function validateAmount(amount: number): void;
+export declare function getPaymentPageUrl(token: string | number): string;
+export declare function isSuccessStatus(status: number | string): boolean;
+/** Returns true when the bank callback indicates a successful payment worth confirming. */
+export declare function shouldConfirmPayment(callback: CallbackPayload): boolean;
+export declare function generateOrderId(): string;
+/** Validates callback URLs (HTTP for local dev, HTTPS for production). */
+export declare function isValidUrl(url: string): boolean;
+/** @deprecated Use {@link isValidUrl} instead. */
+export declare function isValidHttpsUrl(url: string): boolean;
+/**
+ * Parses the bank callback payload (PEC POSTs to your callback URL).
+ * Pass `req.body` for POST callbacks; merge `req.query` if your route uses GET.
+ */
+export declare function parseCallback(body: Record<string, unknown>): CallbackPayload;
+export declare function normalizeSoapField(value: unknown): string;
+export declare function normalizeSoapNumber(value: unknown): number;
+export declare function buildPaymentTokenResult(status: unknown, token: unknown, message: unknown): {
+    status: number;
+    token: string;
+    message: string;
+    paymentUrl?: string;
+};
+export declare function mapMultiplexedAccounts(accounts: MultiplexedAccount[], currency?: Currency): Array<{
+    Amount: number;
+    IBAN: string;
+    PayId: string;
+}>;
+export declare function validateMultiplexedAccounts(accounts: MultiplexedAccount[]): void;
+/** Validates sale report date range (max 30 days, end after start). */
+export declare function validateSaleReportDateRange(fromDate: string, toDate: string): void;
+export declare function normalizeBillInfoResult(payload: Record<string, unknown>): {
+    status: number;
+    message: string;
+    amount: string;
+    billId: string;
+    payId: string;
+};
+//# sourceMappingURL=utils.d.ts.map

package/dist/cjs/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAMhF,wDAAwD;AACxD,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,QAAkB,GAAG,MAAM,CAG5E;AAED,kDAAkD;AAClD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAInD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAEhE;AAED,2FAA2F;AAC3F,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAEvE;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAU/C;AAED,kDAAkD;AAClD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEpD;AAoBD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAS5E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQzD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE1D;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,GACf;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAgBzE;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,kBAAkB,EAAE,EAC9B,QAAQ,GAAE,QAAkB,GAC3B,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAQxD;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAchF;AAED,uEAAuE;AACvE,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAelF;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAQA"}