pec-payment-sdk 1.1.1

package/dist/cjs/utils.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toRials = toRials;
+exports.validateAmount = validateAmount;
+exports.getPaymentPageUrl = getPaymentPageUrl;
+exports.isSuccessStatus = isSuccessStatus;
+exports.shouldConfirmPayment = shouldConfirmPayment;
+exports.generateOrderId = generateOrderId;
+exports.isValidUrl = isValidUrl;
+exports.isValidHttpsUrl = isValidHttpsUrl;
+exports.parseCallback = parseCallback;
+exports.normalizeSoapField = normalizeSoapField;
+exports.normalizeSoapNumber = normalizeSoapNumber;
+exports.buildPaymentTokenResult = buildPaymentTokenResult;
+exports.mapMultiplexedAccounts = mapMultiplexedAccounts;
+exports.validateMultiplexedAccounts = validateMultiplexedAccounts;
+exports.validateSaleReportDateRange = validateSaleReportDateRange;
+exports.normalizeBillInfoResult = normalizeBillInfoResult;
+const crypto_1 = require("crypto");
+const constants_js_1 = require("./constants.js");
+const errors_js_1 = require("./errors.js");
+const MAX_SALE_REPORT_RANGE_MS = 30 * 24 * 60 * 60 * 1000;
+/** Converts an amount to Rials for PEC API requests. */
+function toRials(amount, currency = 'toman') {
+    validateAmount(amount);
+    return currency === 'toman' ? amount * 10 : amount;
+}
+/** Ensures amount is a positive finite number. */
+function validateAmount(amount) {
+    if (!Number.isFinite(amount) || amount <= 0) {
+        throw new errors_js_1.PecValidationError('amount must be a positive number');
+    }
+}
+function getPaymentPageUrl(token) {
+    return `${constants_js_1.PAYMENT_PAGE_BASE}${token}`;
+}
+function isSuccessStatus(status) {
+    return Number(status) === constants_js_1.PEC_SUCCESS_STATUS;
+}
+/** Returns true when the bank callback indicates a successful payment worth confirming. */
+function shouldConfirmPayment(callback) {
+    return callback.status === constants_js_1.PEC_SUCCESS_STATUS && Number(callback.rrn) > 0;
+}
+function generateOrderId() {
+    return (0, crypto_1.randomBytes)(20).toString('hex');
+}
+/** Validates callback URLs (HTTP for local dev, HTTPS for production). */
+function isValidUrl(url) {
+    try {
+        const parsed = new URL(url);
+        return ((parsed.protocol === 'https:' || parsed.protocol === 'http:') &&
+            parsed.hostname.length > 0);
+    }
+    catch {
+        return false;
+    }
+}
+/** @deprecated Use {@link isValidUrl} instead. */
+function isValidHttpsUrl(url) {
+    return isValidUrl(url) && url.startsWith('https:');
+}
+function readField(body, keys) {
+    for (const key of keys) {
+        const value = body[key];
+        if (value !== undefined && value !== null && value !== '') {
+            return String(value);
+        }
+    }
+    return '';
+}
+function parseCallbackStatus(body) {
+    const raw = readField(body, ['status', 'Status']);
+    if (raw === '') {
+        return NaN;
+    }
+    return Number(raw);
+}
+/**
+ * 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.
+ */
+function parseCallback(body) {
+    return {
+        token: readField(body, ['Token', 'token']),
+        status: parseCallbackStatus(body),
+        orderId: readField(body, ['OrderId', 'orderId']),
+        terminalNo: readField(body, ['TerminalNo', 'terminalNo']),
+        amount: readField(body, ['Amount', 'amount']),
+        rrn: readField(body, ['RRN', 'rrn']),
+    };
+}
+function normalizeSoapField(value) {
+    if (value === undefined || value === null) {
+        return '';
+    }
+    if (Array.isArray(value)) {
+        return normalizeSoapField(value[0]);
+    }
+    return String(value);
+}
+function normalizeSoapNumber(value) {
+    return Number(normalizeSoapField(value));
+}
+function buildPaymentTokenResult(status, token, message) {
+    const normalizedStatus = normalizeSoapNumber(status);
+    const normalizedToken = normalizeSoapField(token);
+    const normalizedMessage = normalizeSoapField(message);
+    const result = {
+        status: normalizedStatus,
+        token: normalizedToken,
+        message: normalizedMessage,
+    };
+    if (isSuccessStatus(normalizedStatus) && normalizedToken.length > 0) {
+        return { ...result, paymentUrl: getPaymentPageUrl(normalizedToken) };
+    }
+    return result;
+}
+function mapMultiplexedAccounts(accounts, currency = 'toman') {
+    validateMultiplexedAccounts(accounts);
+    return accounts.map((account) => ({
+        Amount: toRials(account.amount, currency),
+        IBAN: account.iban,
+        PayId: account.payId,
+    }));
+}
+function validateMultiplexedAccounts(accounts) {
+    if (!Array.isArray(accounts) || accounts.length === 0) {
+        throw new errors_js_1.PecValidationError('accounts must be a non-empty array');
+    }
+    for (const account of accounts) {
+        validateAmount(account.amount);
+        if (!account.iban?.trim()) {
+            throw new errors_js_1.PecValidationError('each account must include a valid iban');
+        }
+        if (!account.payId?.trim()) {
+            throw new errors_js_1.PecValidationError('each account must include a valid payId');
+        }
+    }
+}
+/** Validates sale report date range (max 30 days, end after start). */
+function validateSaleReportDateRange(fromDate, toDate) {
+    const from = new Date(fromDate);
+    const to = new Date(toDate);
+    if (Number.isNaN(from.getTime()) || Number.isNaN(to.getTime())) {
+        throw new errors_js_1.PecValidationError('fromDate and toDate must be valid date strings');
+    }
+    if (to.getTime() < from.getTime()) {
+        throw new errors_js_1.PecValidationError('toDate must be on or after fromDate');
+    }
+    if (to.getTime() - from.getTime() > MAX_SALE_REPORT_RANGE_MS) {
+        throw new errors_js_1.PecValidationError('date range must not exceed 30 days');
+    }
+}
+function normalizeBillInfoResult(payload) {
+    return {
+        status: normalizeSoapNumber(payload.Status),
+        message: normalizeSoapField(payload.Message),
+        amount: normalizeSoapField(payload.Amount),
+        billId: normalizeSoapField(payload.BillId),
+        payId: normalizeSoapField(payload.PayId),
+    };
+}

package/dist/esm/PecClient.d.ts

@@ -0,0 +1,28 @@
+import type { BillInfoResult, ConfirmPaymentInput, ConfirmPaymentResult, GetBillInfoInput, GetSaleReportInput, GetSaleReportResult, PaymentTokenResult, PecClientOptions, RequestBillPaymentInput, RequestGovernmentMultiplexedPaymentInput, RequestGovernmentPaymentInput, RequestMobileTopupInput, RequestMultiplexedPaymentInput, RequestPaymentInput, ReversePaymentInput, ReversePaymentResult } from './types.js';
+export declare class PecClient {
+    private readonly loginAccount;
+    private readonly defaultCallbackUrl?;
+    constructor(options: PecClientOptions);
+    /** Starts a standard sale payment and returns a token plus redirect URL. */
+    requestPayment(input: RequestPaymentInput): Promise<PaymentTokenResult>;
+    /** Starts an online multiplexed sale (تسهیم آنلاین). */
+    requestMultiplexedPayment(input: RequestMultiplexedPaymentInput): Promise<PaymentTokenResult>;
+    /** Starts a government-ID sale (شناسه حساب دولتی). */
+    requestGovernmentPayment(input: RequestGovernmentPaymentInput): Promise<PaymentTokenResult>;
+    /** Starts a government sale with multiplexed IBAN accounts. */
+    requestGovernmentMultiplexedPayment(input: RequestGovernmentMultiplexedPaymentInput): Promise<PaymentTokenResult>;
+    /** Starts a bill payment request. */
+    requestBillPayment(input: RequestBillPaymentInput): Promise<PaymentTokenResult>;
+    /** Retrieves bill details before payment. */
+    getBillInfo(input: GetBillInfoInput): Promise<BillInfoResult>;
+    /** Starts a mobile top-up/charge request. */
+    requestMobileTopup(input: RequestMobileTopupInput): Promise<PaymentTokenResult>;
+    /** Confirms/settles a successful payment using its token. */
+    confirmPayment(input: ConfirmPaymentInput): Promise<ConfirmPaymentResult>;
+    /** Reverses a payment. Works only within the bank's allowed time window. */
+    reversePayment(input: ReversePaymentInput): Promise<ReversePaymentResult>;
+    /** Fetches sale transactions from PEC reporting REST API. */
+    getSaleReport(input: GetSaleReportInput): Promise<GetSaleReportResult>;
+    private resolveCallbackUrl;
+}
+//# sourceMappingURL=PecClient.d.ts.map

package/dist/esm/PecClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PecClient.d.ts","sourceRoot":"","sources":["../../src/PecClient.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,EACvB,wCAAwC,EACxC,6BAA6B,EAC7B,uBAAuB,EACvB,8BAA8B,EAC9B,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAapB,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAS;gBAEjC,OAAO,EAAE,gBAAgB;IASrC,4EAA4E;IACtE,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAqB7E,wDAAwD;IAClD,yBAAyB,CAC7B,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,kBAAkB,CAAC;IAwB9B,sDAAsD;IAChD,wBAAwB,CAC5B,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,kBAAkB,CAAC;IAqB9B,+DAA+D;IACzD,mCAAmC,CACvC,KAAK,EAAE,wCAAwC,GAC9C,OAAO,CAAC,kBAAkB,CAAC;IAwB9B,qCAAqC;IAC/B,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAsBrF,6CAA6C;IACvC,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC;IAgBnE,6CAA6C;IACvC,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAwBrF,6DAA6D;IACvD,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAuB/E,4EAA4E;IACtE,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAsB/E,6DAA6D;IACvD,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAiC5E,OAAO,CAAC,kBAAkB;CAa3B"}

package/dist/esm/PecClient.js

@@ -0,0 +1,211 @@
+import axios from 'axios';
+import { REPORT_API_URL, WSDL } from './constants.js';
+import { PecTransportError, PecValidationError } from './errors.js';
+import { callSoapMethod } from './soapClient.js';
+import { buildPaymentTokenResult, isValidUrl, mapMultiplexedAccounts, normalizeBillInfoResult, normalizeSoapField, normalizeSoapNumber, toRials, validateSaleReportDateRange, } from './utils.js';
+export class PecClient {
+    constructor(options) {
+        if (!options?.loginAccount?.trim()) {
+            throw new 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 callSoapMethod(WSDL.SALE, 'SalePaymentRequestAsync', {
+            requestData: {
+                LoginAccount: this.loginAccount,
+                Amount: toRials(input.amount, currency),
+                OrderId: input.orderId,
+                CallBackUrl: callbackUrl,
+                AdditionalData: input.additionalData ?? '',
+                Originator: input.originator ?? '',
+            },
+        });
+        const payload = result?.SalePaymentRequestResult ?? {};
+        return 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 callSoapMethod(WSDL.MULTIPLEXED_SALE, 'MultiplexedSaleWithIBANPaymentRequestAsync', {
+            requestData: {
+                LoginAccount: this.loginAccount,
+                Amount: toRials(input.amount, currency),
+                OrderId: input.orderId,
+                CallBackUrl: callbackUrl,
+                AdditionalData: '',
+                Originator: input.originator ?? '',
+                MultiplexedAccounts: {
+                    MultiplexedAccount: mapMultiplexedAccounts(input.accounts, currency),
+                },
+            },
+        });
+        const payload = result?.MultiplexedSaleWithIBANPaymentRequestResult ?? {};
+        return 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 callSoapMethod(WSDL.GOVERNMENT_SALE, 'SalePaymentRequestAsync', {
+            requestData: {
+                LoginAccount: this.loginAccount,
+                Amount: toRials(input.amount, currency),
+                OrderId: input.orderId,
+                CallBackUrl: callbackUrl,
+                AdditionalData: `GOVId=${input.govId}`,
+                Originator: input.originator ?? '',
+            },
+        });
+        const payload = result?.SalePaymentRequestResult ?? {};
+        return 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 callSoapMethod(WSDL.GOVERNMENT_SALE, 'GovSaleWithMultiIbanPaymentRequestSW2Async', {
+            requestData: {
+                LoginAccount: this.loginAccount,
+                Amount: toRials(input.amount, currency),
+                OrderId: input.orderId,
+                CallBackUrl: callbackUrl,
+                AdditionalData: `GOVId=${input.govId}`,
+                Originator: input.originator ?? '',
+                MultiplexedAccounts: {
+                    MultiplexedAccount: mapMultiplexedAccounts(input.accounts, currency),
+                },
+            },
+        });
+        const payload = result?.GovSaleWithMultiIbanPaymentRequestSW2Result ?? {};
+        return buildPaymentTokenResult(payload.Status, payload.Token, payload.Message);
+    }
+    /** Starts a bill payment request. */
+    async requestBillPayment(input) {
+        const callbackUrl = this.resolveCallbackUrl(input.callbackUrl);
+        const result = await callSoapMethod(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 buildPaymentTokenResult(payload.Status, payload.Token, payload.Message);
+    }
+    /** Retrieves bill details before payment. */
+    async getBillInfo(input) {
+        if (!input.billId?.trim() || !input.payId?.trim()) {
+            throw new PecValidationError('billId and payId are required');
+        }
+        const result = await callSoapMethod(WSDL.BILL, 'GetBillInfoAsync', {
+            billId: input.billId,
+            payId: input.payId,
+        });
+        const payload = result?.GetBillInfoResult ?? {};
+        return 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 callSoapMethod(WSDL.MOBILE_TOPUP, 'TopupChargeRequestAsync', {
+            requestData: {
+                LoginAccount: this.loginAccount,
+                OrderId: input.orderId,
+                ChargeMobileNumber: input.chargeMobileNumber,
+                RequesterMobileNumber: input.requesterMobileNumber,
+                TopupType: input.topupType,
+                Amount: toRials(input.amount, currency),
+                CallBackUrl: callbackUrl,
+                AdditionalData: input.additionalData ?? '',
+                Originator: input.originator ?? '',
+            },
+        });
+        const payload = result?.TopupChargeRequestResult ?? {};
+        return 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 PecValidationError('token is required');
+        }
+        const result = await callSoapMethod(WSDL.CONFIRM, 'ConfirmPaymentAsync', {
+            requestData: {
+                LoginAccount: this.loginAccount,
+                Token: input.token,
+            },
+        });
+        const payload = result?.ConfirmPaymentResult ?? {};
+        return {
+            status: normalizeSoapNumber(payload.Status),
+            token: normalizeSoapField(payload.Token),
+            cardNumberMasked: normalizeSoapField(payload.CardNumberMasked),
+            rrn: 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 PecValidationError('token is required');
+        }
+        const result = await callSoapMethod(WSDL.REVERSAL, 'ReversalRequestAsync', {
+            requestData: {
+                LoginAccount: this.loginAccount,
+                Token: input.token,
+            },
+        });
+        const payload = result?.ReversalRequestResult ?? {};
+        return {
+            status: normalizeSoapNumber(payload.Status),
+            token: normalizeSoapField(payload.Token),
+            message: normalizeSoapField(payload.Message),
+        };
+    }
+    /** Fetches sale transactions from PEC reporting REST API. */
+    async getSaleReport(input) {
+        if (!input.username?.trim() || !input.password?.trim()) {
+            throw new PecValidationError('username and password are required');
+        }
+        validateSaleReportDateRange(input.fromDate, input.toDate);
+        const authToken = Buffer.from(`${input.username}|${input.password}`).toString('base64');
+        try {
+            const response = await axios.post(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 PecTransportError('Failed to fetch sale report', error);
+        }
+    }
+    resolveCallbackUrl(callbackUrl) {
+        const resolved = callbackUrl ?? this.defaultCallbackUrl;
+        if (!resolved) {
+            throw new PecValidationError('callbackUrl is required');
+        }
+        if (!isValidUrl(resolved)) {
+            throw new PecValidationError('callbackUrl must be a valid HTTP or HTTPS URL');
+        }
+        return resolved;
+    }
+}

package/dist/esm/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/esm/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/esm/constants.js

@@ -0,0 +1,12 @@
+export const 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',
+};
+export const PAYMENT_PAGE_BASE = 'https://pec.shaparak.ir/NewIPG/?Token=';
+export const REPORT_API_URL = 'https://pgwservices.pec.ir/api/PGWReport/GetSaleReport';
+export const PEC_SUCCESS_STATUS = 0;

package/dist/esm/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/esm/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/esm/errors.js

@@ -0,0 +1,22 @@
+export class PecError extends Error {
+    constructor(message, status, pecMessage, cause) {
+        super(message);
+        this.name = 'PecError';
+        this.status = status;
+        this.pecMessage = pecMessage;
+        this.cause = cause;
+    }
+}
+export class PecValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PecValidationError';
+    }
+}
+export class PecTransportError extends Error {
+    constructor(message, cause) {
+        super(message);
+        this.name = 'PecTransportError';
+        this.cause = cause;
+    }
+}

package/dist/esm/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/esm/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/esm/index.js

@@ -0,0 +1,4 @@
+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';

package/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/dist/esm/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/esm/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/esm/soapClient.js

@@ -0,0 +1,36 @@
+import soap from 'soap';
+import { PecTransportError } from './errors.js';
+const clientCache = new Map();
+export async function getSoapClient(wsdlUrl) {
+    let cached = clientCache.get(wsdlUrl);
+    if (!cached) {
+        cached = soap.createClientAsync(wsdlUrl).catch((error) => {
+            clientCache.delete(wsdlUrl);
+            throw new PecTransportError(`Failed to create SOAP client for ${wsdlUrl}`, error);
+        });
+        clientCache.set(wsdlUrl, cached);
+    }
+    return cached;
+}
+export async function callSoapMethod(wsdlUrl, methodName, args) {
+    try {
+        const client = await getSoapClient(wsdlUrl);
+        const method = client[methodName];
+        if (typeof method !== 'function') {
+            throw new 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 PecTransportError) {
+            throw error;
+        }
+        throw new PecTransportError(`SOAP call "${methodName}" failed`, error);
+    }
+}
+/** Clears cached SOAP clients (useful in tests). */
+export function clearSoapClientCache() {
+    clientCache.clear();
+}