@maxkabechani/mtn-momo-sdk 0.2.1 → 1.0.0

package/lib/cjs/index.d.ts

@@ -1,14 +1,15 @@
-export type { Payment, PaymentRequest } from "./collections";
-export type { Transfer, TransferRequest } from "./disbursements";
-export type { Withdrawal, WithdrawalRequest, Deposit, DepositRequest, Refund, RefundRequest, CashTransfer, CashTransferRequest, } from "./common";
-export * from "./errors";
-export { PartyIdType as PayerType, TransactionStatus as Status, Environment, } from "./common";
-export type { ApiUserInfo, Party as Payer, Balance, FailureReason, GlobalConfig, ProductConfig, BasicUserInfo, BcAuthorizeRequest, BcAuthorizeResponse, OAuth2TokenRequest, OAuth2TokenResponse, ConsentKycResponse, DeliveryNotification, } from "./common";
-import Collections from "./collections";
-import Disbursements from "./disbursements";
-import Remittance from "./remittance";
-import Users from "./users";
-import type { GlobalConfig, ProductConfig, SubscriptionConfig } from "./common";
+export type { Payment, PaymentRequest } from "./collections.js";
+export type { Transfer, TransferRequest } from "./disbursements.js";
+export type { Withdrawal, WithdrawalRequest, Deposit, DepositRequest, Refund, RefundRequest, CashTransfer, CashTransferRequest, } from "./common.js";
+export * from "./errors.js";
+export { generateReferenceId, type FinancialOperationOptions, } from "./security.js";
+export { PartyIdType as PayerType, TransactionStatus as Status, Environment, } from "./common.js";
+export type { ApiUserInfo, Party as Payer, Balance, FailureReason, GlobalConfig, ProductConfig, BasicUserInfo, BcAuthorizeRequest, BcAuthorizeResponse, OAuth2TokenRequest, OAuth2TokenResponse, ConsentKycResponse, DeliveryNotification, } from "./common.js";
+import Collections from "./collections.js";
+import Disbursements from "./disbursements.js";
+import Remittance from "./remittance.js";
+import Users from "./users.js";
+import type { GlobalConfig, ProductConfig, SubscriptionConfig } from "./common.js";
 export interface MomoClient {
     Collections(productConfig: ProductConfig): Collections;
     Disbursements(productConfig: ProductConfig): Disbursements;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACjE,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,OAAO,EACP,cAAc,EACd,MAAM,EACN,aAAa,EACb,YAAY,EACZ,mBAAmB,GACpB,MAAM,UAAU,CAAC;AAClB,cAAc,UAAU,CAAC;AACzB,OAAO,EACL,WAAW,IAAI,SAAS,EACxB,iBAAiB,IAAI,MAAM,EAC3B,WAAW,GACZ,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,WAAW,EACX,KAAK,IAAI,KAAK,EACd,OAAO,EACP,aAAa,EACb,YAAY,EACZ,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,UAAU,CAAC;AAIlB,OAAO,WAAW,MAAM,eAAe,CAAC;AACxC,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAC5C,OAAO,UAAU,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,SAAS,CAAC;AAgB5B,OAAO,KAAK,EAEV,YAAY,EACZ,aAAa,EACb,kBAAkB,EACnB,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,aAAa,EAAE,aAAa,GAAG,WAAW,CAAC;IACvD,aAAa,CAAC,aAAa,EAAE,aAAa,GAAG,aAAa,CAAC;IAC3D,UAAU,CAAC,aAAa,EAAE,aAAa,GAAG,UAAU,CAAC;IACrD,KAAK,CAAC,YAAY,EAAE,kBAAkB,GAAG,KAAK,CAAC;CAChD;AAOD;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,YAAY,EAAE,YAAY,GAAG,UAAU,CAoE7D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAChE,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACpE,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,OAAO,EACP,cAAc,EACd,MAAM,EACN,aAAa,EACb,YAAY,EACZ,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,cAAc,aAAa,CAAC;AAC5B,OAAO,EACL,mBAAmB,EACnB,KAAK,yBAAyB,GAC/B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,WAAW,IAAI,SAAS,EACxB,iBAAiB,IAAI,MAAM,EAC3B,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,WAAW,EACX,KAAK,IAAI,KAAK,EACd,OAAO,EACP,aAAa,EACb,YAAY,EACZ,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAIrB,OAAO,WAAW,MAAM,kBAAkB,CAAC;AAC3C,OAAO,aAAa,MAAM,oBAAoB,CAAC;AAC/C,OAAO,UAAU,MAAM,iBAAiB,CAAC;AACzC,OAAO,KAAK,MAAM,YAAY,CAAC;AAgB/B,OAAO,KAAK,EAEV,YAAY,EACZ,aAAa,EACb,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,aAAa,EAAE,aAAa,GAAG,WAAW,CAAC;IACvD,aAAa,CAAC,aAAa,EAAE,aAAa,GAAG,aAAa,CAAC;IAC3D,UAAU,CAAC,aAAa,EAAE,aAAa,GAAG,UAAU,CAAC;IACrD,KAAK,CAAC,YAAY,EAAE,kBAAkB,GAAG,KAAK,CAAC;CAChD;AAOD;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,YAAY,EAAE,YAAY,GAAG,UAAU,CAoE7D"}

package/lib/cjs/index.js

@@ -17,24 +17,26 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Environment = exports.Status = exports.PayerType = void 0;
+exports.Environment = exports.Status = exports.PayerType = exports.generateReferenceId = void 0;
 exports.create = create;
-__exportStar(require("./errors"), exports);
-var common_1 = require("./common");
-Object.defineProperty(exports, "PayerType", { enumerable: true, get: function () { return common_1.PartyIdType; } });
-Object.defineProperty(exports, "Status", { enumerable: true, get: function () { return common_1.TransactionStatus; } });
-Object.defineProperty(exports, "Environment", { enumerable: true, get: function () { return common_1.Environment; } });
-const collections_1 = __importDefault(require("./collections"));
-const disbursements_1 = __importDefault(require("./disbursements"));
-const remittance_1 = __importDefault(require("./remittance"));
-const users_1 = __importDefault(require("./users"));
-const auth_1 = require("./auth");
-const client_1 = require("./client");
-const validate_1 = require("./validate");
-const common_2 = require("./common");
+__exportStar(require("./errors.js"), exports);
+var security_js_1 = require("./security.js");
+Object.defineProperty(exports, "generateReferenceId", { enumerable: true, get: function () { return security_js_1.generateReferenceId; } });
+var common_js_1 = require("./common.js");
+Object.defineProperty(exports, "PayerType", { enumerable: true, get: function () { return common_js_1.PartyIdType; } });
+Object.defineProperty(exports, "Status", { enumerable: true, get: function () { return common_js_1.TransactionStatus; } });
+Object.defineProperty(exports, "Environment", { enumerable: true, get: function () { return common_js_1.Environment; } });
+const collections_js_1 = __importDefault(require("./collections.js"));
+const disbursements_js_1 = __importDefault(require("./disbursements.js"));
+const remittance_js_1 = __importDefault(require("./remittance.js"));
+const users_js_1 = __importDefault(require("./users.js"));
+const auth_js_1 = require("./auth.js");
+const client_js_1 = require("./client.js");
+const validate_js_1 = require("./validate.js");
+const common_js_2 = require("./common.js");
 const defaultGlobalConfig = {
     baseUrl: "https://sandbox.momodeveloper.mtn.com",
-    environment: common_2.Environment.SANDBOX,
+    environment: common_js_2.Environment.SANDBOX,
 };
 /**
  * Initialise the library
@@ -42,47 +44,47 @@ const defaultGlobalConfig = {
  * @param globalConfig Global configuration required to use any product
  */
 function create(globalConfig) {
-    (0, validate_1.validateGlobalConfig)(globalConfig);
+    (0, validate_js_1.validateGlobalConfig)(globalConfig);
     return {
         Collections(productConfig) {
-            (0, validate_1.validateProductConfig)(productConfig);
+            (0, validate_js_1.validateProductConfig)(productConfig);
             const config = {
                 ...defaultGlobalConfig,
                 ...globalConfig,
                 ...productConfig,
             };
-            const client = (0, client_1.createAuthClient)((0, auth_1.createTokenRefresher)(auth_1.authorizeCollections, config), (0, client_1.createClient)(config));
-            return new collections_1.default(client, config);
+            const client = (0, client_js_1.createAuthClient)((0, auth_js_1.createTokenRefresher)(auth_js_1.authorizeCollections, config), (0, client_js_1.createClient)(config));
+            return new collections_js_1.default(client, config);
         },
         Disbursements(productConfig) {
-            (0, validate_1.validateProductConfig)(productConfig);
+            (0, validate_js_1.validateProductConfig)(productConfig);
             const config = {
                 ...defaultGlobalConfig,
                 ...globalConfig,
                 ...productConfig,
             };
-            const client = (0, client_1.createAuthClient)((0, auth_1.createTokenRefresher)(auth_1.authorizeDisbursements, config), (0, client_1.createClient)(config));
-            return new disbursements_1.default(client, config);
+            const client = (0, client_js_1.createAuthClient)((0, auth_js_1.createTokenRefresher)(auth_js_1.authorizeDisbursements, config), (0, client_js_1.createClient)(config));
+            return new disbursements_js_1.default(client, config);
         },
         Remittance(productConfig) {
-            (0, validate_1.validateProductConfig)(productConfig);
+            (0, validate_js_1.validateProductConfig)(productConfig);
             const config = {
                 ...defaultGlobalConfig,
                 ...globalConfig,
                 ...productConfig,
             };
-            const client = (0, client_1.createAuthClient)((0, auth_1.createTokenRefresher)(auth_1.authorizeRemittance, config), (0, client_1.createClient)(config));
-            return new remittance_1.default(client, config);
+            const client = (0, client_js_1.createAuthClient)((0, auth_js_1.createTokenRefresher)(auth_js_1.authorizeRemittance, config), (0, client_js_1.createClient)(config));
+            return new remittance_js_1.default(client, config);
         },
         Users(subscriptionConfig) {
-            (0, validate_1.validateSubscriptionConfig)(subscriptionConfig);
+            (0, validate_js_1.validateSubscriptionConfig)(subscriptionConfig);
             const config = {
                 ...defaultGlobalConfig,
                 ...globalConfig,
                 ...subscriptionConfig,
             };
-            const client = (0, client_1.createClient)(config);
-            return new users_1.default(client);
+            const client = (0, client_js_1.createClient)(config);
+            return new users_js_1.default(client, config.environment ?? common_js_2.Environment.SANDBOX);
         },
     };
 }

package/lib/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AA+EA,wBAoEC;AAvID,2CAAyB;AACzB,mCAIkB;AAHhB,mGAAA,WAAW,OAAa;AACxB,gGAAA,iBAAiB,OAAU;AAC3B,qGAAA,WAAW,OAAA;AAoBb,gEAAwC;AACxC,oEAA4C;AAC5C,8DAAsC;AACtC,oDAA4B;AAE5B,iCAKgB;AAChB,qCAA0D;AAC1D,yCAIoB;AAEpB,qCAAuC;AAevC,MAAM,mBAAmB,GAAiB;IACxC,OAAO,EAAE,uCAAuC;IAChD,WAAW,EAAE,oBAAW,CAAC,OAAO;CACjC,CAAC;AAEF;;;;GAIG;AACH,SAAgB,MAAM,CAAC,YAA0B;IAC/C,IAAA,+BAAoB,EAAC,YAAY,CAAC,CAAC;IAEnC,OAAO;QACL,WAAW,CAAC,aAA4B;YACtC,IAAA,gCAAqB,EAAC,aAAa,CAAC,CAAC;YAErC,MAAM,MAAM,GAAW;gBACrB,GAAG,mBAAmB;gBACtB,GAAG,YAAY;gBACf,GAAG,aAAa;aACjB,CAAC;YAEF,MAAM,MAAM,GAAkB,IAAA,yBAAgB,EAC5C,IAAA,2BAAoB,EAAC,2BAAoB,EAAE,MAAM,CAAC,EAClD,IAAA,qBAAY,EAAC,MAAM,CAAC,CACrB,CAAC;YACF,OAAO,IAAI,qBAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC;QAED,aAAa,CAAC,aAA4B;YACxC,IAAA,gCAAqB,EAAC,aAAa,CAAC,CAAC;YAErC,MAAM,MAAM,GAAW;gBACrB,GAAG,mBAAmB;gBACtB,GAAG,YAAY;gBACf,GAAG,aAAa;aACjB,CAAC;YAEF,MAAM,MAAM,GAAkB,IAAA,yBAAgB,EAC5C,IAAA,2BAAoB,EAAC,6BAAsB,EAAE,MAAM,CAAC,EACpD,IAAA,qBAAY,EAAC,MAAM,CAAC,CACrB,CAAC;YAEF,OAAO,IAAI,uBAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3C,CAAC;QAED,UAAU,CAAC,aAA4B;YACrC,IAAA,gCAAqB,EAAC,aAAa,CAAC,CAAC;YAErC,MAAM,MAAM,GAAW;gBACrB,GAAG,mBAAmB;gBACtB,GAAG,YAAY;gBACf,GAAG,aAAa;aACjB,CAAC;YAEF,MAAM,MAAM,GAAkB,IAAA,yBAAgB,EAC5C,IAAA,2BAAoB,EAAC,0BAAmB,EAAE,MAAM,CAAC,EACjD,IAAA,qBAAY,EAAC,MAAM,CAAC,CACrB,CAAC;YAEF,OAAO,IAAI,oBAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACxC,CAAC;QAED,KAAK,CAAC,kBAAsC;YAC1C,IAAA,qCAA0B,EAAC,kBAAkB,CAAC,CAAC;YAE/C,MAAM,MAAM,GAAsC;gBAChD,GAAG,mBAAmB;gBACtB,GAAG,YAAY;gBACf,GAAG,kBAAkB;aACtB,CAAC;YAEF,MAAM,MAAM,GAAkB,IAAA,qBAAY,EAAC,MAAM,CAAC,CAAC;YAEnD,OAAO,IAAI,eAAK,CAAC,MAAM,CAAC,CAAC;QAC3B,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AAmFA,wBAoEC;AA3ID,8CAA4B;AAC5B,6CAGuB;AAFrB,kHAAA,mBAAmB,OAAA;AAGrB,yCAIqB;AAHnB,sGAAA,WAAW,OAAa;AACxB,mGAAA,iBAAiB,OAAU;AAC3B,wGAAA,WAAW,OAAA;AAoBb,sEAA2C;AAC3C,0EAA+C;AAC/C,oEAAyC;AACzC,0DAA+B;AAE/B,uCAKmB;AACnB,2CAA6D;AAC7D,+CAIuB;AAEvB,2CAA0C;AAe1C,MAAM,mBAAmB,GAAiB;IACxC,OAAO,EAAE,uCAAuC;IAChD,WAAW,EAAE,uBAAW,CAAC,OAAO;CACjC,CAAC;AAEF;;;;GAIG;AACH,SAAgB,MAAM,CAAC,YAA0B;IAC/C,IAAA,kCAAoB,EAAC,YAAY,CAAC,CAAC;IAEnC,OAAO;QACL,WAAW,CAAC,aAA4B;YACtC,IAAA,mCAAqB,EAAC,aAAa,CAAC,CAAC;YAErC,MAAM,MAAM,GAAW;gBACrB,GAAG,mBAAmB;gBACtB,GAAG,YAAY;gBACf,GAAG,aAAa;aACjB,CAAC;YAEF,MAAM,MAAM,GAAe,IAAA,4BAAgB,EACzC,IAAA,8BAAoB,EAAC,8BAAoB,EAAE,MAAM,CAAC,EAClD,IAAA,wBAAY,EAAC,MAAM,CAAC,CACrB,CAAC;YACF,OAAO,IAAI,wBAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC;QAED,aAAa,CAAC,aAA4B;YACxC,IAAA,mCAAqB,EAAC,aAAa,CAAC,CAAC;YAErC,MAAM,MAAM,GAAW;gBACrB,GAAG,mBAAmB;gBACtB,GAAG,YAAY;gBACf,GAAG,aAAa;aACjB,CAAC;YAEF,MAAM,MAAM,GAAe,IAAA,4BAAgB,EACzC,IAAA,8BAAoB,EAAC,gCAAsB,EAAE,MAAM,CAAC,EACpD,IAAA,wBAAY,EAAC,MAAM,CAAC,CACrB,CAAC;YAEF,OAAO,IAAI,0BAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3C,CAAC;QAED,UAAU,CAAC,aAA4B;YACrC,IAAA,mCAAqB,EAAC,aAAa,CAAC,CAAC;YAErC,MAAM,MAAM,GAAW;gBACrB,GAAG,mBAAmB;gBACtB,GAAG,YAAY;gBACf,GAAG,aAAa;aACjB,CAAC;YAEF,MAAM,MAAM,GAAe,IAAA,4BAAgB,EACzC,IAAA,8BAAoB,EAAC,6BAAmB,EAAE,MAAM,CAAC,EACjD,IAAA,wBAAY,EAAC,MAAM,CAAC,CACrB,CAAC;YAEF,OAAO,IAAI,uBAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACxC,CAAC;QAED,KAAK,CAAC,kBAAsC;YAC1C,IAAA,wCAA0B,EAAC,kBAAkB,CAAC,CAAC;YAE/C,MAAM,MAAM,GAAsC;gBAChD,GAAG,mBAAmB;gBACtB,GAAG,YAAY;gBACf,GAAG,kBAAkB;aACtB,CAAC;YAEF,MAAM,MAAM,GAAe,IAAA,wBAAY,EAAC,MAAM,CAAC,CAAC;YAEhD,OAAO,IAAI,kBAAK,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,IAAI,uBAAW,CAAC,OAAO,CAAC,CAAC;QACtE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/lib/cjs/remittance.d.ts

@@ -1,14 +1,14 @@
-import type { AxiosInstance } from "axios";
-import type { Balance, BasicUserInfo, BcAuthorizeRequest, BcAuthorizeResponse, CashTransfer, CashTransferRequest, ConsentKycResponse, OAuth2TokenRequest, OAuth2TokenResponse } from "./common";
-import { PartyIdType } from "./common";
-import type { Config } from "./common";
+import type { HttpClient } from "./httpClient.js";
+import type { Balance, BasicUserInfo, BcAuthorizeRequest, BcAuthorizeResponse, CashTransfer, CashTransferRequest, ConsentKycResponse, OAuth2TokenRequest, OAuth2TokenResponse } from "./common.js";
+import { PartyIdType } from "./common.js";
+import type { Config } from "./common.js";
 /**
  * Remittance product for cross-border money transfers with optional OAuth2 consent flows
  */
 export default class Remittance {
     private readonly client;
     private readonly config;
-    constructor(client: AxiosInstance, config: Config);
+    constructor(client: HttpClient, config: Config);
     /**
      * Send money across borders to a beneficiary
      * @param request - The cash transfer request details (amount, currency, beneficiary, etc.)
@@ -53,7 +53,7 @@ export default class Remittance {
      * Requires prior OAuth2 user consent/login flow to obtain authorization
      * @returns A promise that resolves to the user's information and KYC consent details
      */
-    getUserInfoWithConsent(): Promise<ConsentKycResponse>;
+    getUserInfoWithConsent(consentToken: string): Promise<ConsentKycResponse>;
     /**
      * Request Biometric Consent (BC) authorization.
      * This initiates the BC authorization flow for enhanced security.

package/lib/cjs/remittance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remittance.d.ts","sourceRoot":"","sources":["../../src/remittance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,OAAO,KAAK,EACV,OAAO,EACP,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EAGpB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAqB,WAAW,EAAE,MAAM,UAAU,CAAC;AAG1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAIvC;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,UAAU;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM;IAKjD;;;;OAIG;IACG,QAAQ,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IA6B7D;;;;OAIG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAahE;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAMpC;;;;;OAKG;IACG,aAAa,CACjB,OAAO,EAAE,MAAM,EACf,WAAW,GAAE,WAAgC,GAC5C,OAAO,CAAC,OAAO,CAAC;IAcnB;;;;;;OAMG;IACI,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAQhE;;;;;OAKG;IACI,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAM/D;;;;OAIG;IACI,sBAAsB,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAM5D;;;;;;OAMG;IACI,WAAW,CAChB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,mBAAmB,CAAC;IA2B/B;;;;;;OAMG;IACI,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IA6BlE;;;;;OAKG;IACI,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAYlE;;;;;OAKG;IACI,cAAc,CACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,mBAAmB,CAAC;CAahC"}
+{"version":3,"file":"remittance.d.ts","sourceRoot":"","sources":["../../src/remittance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,KAAK,EACV,OAAO,EACP,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAqB,MAAM,aAAa,CAAC;AAG7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAW1C;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,UAAU;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM;IAK9C;;;;OAIG;IACG,QAAQ,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IA8B7D;;;;OAIG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAahE;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAMpC;;;;;OAKG;IACG,aAAa,CACjB,OAAO,EAAE,MAAM,EACf,WAAW,GAAE,WAAgC,GAC5C,OAAO,CAAC,OAAO,CAAC;IAqBnB;;;;;;OAMG;IACI,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAShE;;;;;OAKG;IACI,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ/D;;;;OAIG;IACI,sBAAsB,CAC3B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,kBAAkB,CAAC;IAW9B;;;;;;OAMG;IACI,WAAW,CAChB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,mBAAmB,CAAC;IA2B/B;;;;;;OAMG;IACI,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IA8BlE;;;;;OAKG;IACI,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAclE;;;;;OAKG;IACI,cAAc,CACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,mBAAmB,CAAC;CAehC"}

package/lib/cjs/remittance.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const common_1 = require("./common");
-const errors_1 = require("./errors");
-const auth_1 = require("./auth");
-const uuid_1 = require("uuid");
+const common_js_1 = require("./common.js");
+const auth_js_1 = require("./auth.js");
+const errors_js_1 = require("./errors.js");
+const security_js_1 = require("./security.js");
+const validate_js_1 = require("./validate.js");
 /**
  * Remittance product for cross-border money transfers with optional OAuth2 consent flows
  */
@@ -18,7 +19,8 @@ class Remittance {
      * @returns A promise that resolves to the financial transaction ID (referenceId)
      */
     async transfer(request) {
-        const referenceId = (0, uuid_1.v4)();
+        await (0, validate_js_1.validateCashTransferRequest)(request);
+        const referenceId = (0, security_js_1.resolveReferenceId)(request.referenceId);
         await this.client.post(`/remittance/v1_0/transfer`, {
             amount: request.amount,
             currency: request.currency,
@@ -46,10 +48,10 @@ class Remittance {
      * @returns A promise that resolves to the transfer details and status
      */
     async getTransaction(referenceId) {
-        const response = await this.client.get(`/remittance/v1_0/transfer/${referenceId}`);
+        const response = await this.client.get(`/remittance/v1_0/transfer/${(0, security_js_1.pathUuid)(referenceId)}`);
         const transaction = response.data;
-        if (transaction.status === common_1.TransactionStatus.FAILED) {
-            return Promise.reject((0, errors_1.getTransactionError)(transaction));
+        if (transaction.status === common_js_1.TransactionStatus.FAILED) {
+            return Promise.reject((0, errors_js_1.getTransactionError)(transaction));
         }
         return transaction;
     }
@@ -68,13 +70,18 @@ class Remittance {
      * @param partyIdType - The type of ID (MSISDN, EMAIL, or PARTY_CODE)
      * @returns A promise that resolves to true if the beneficiary is active, false otherwise
      */
-    async isPayerActive(partyId, partyIdType = common_1.PartyIdType.MSISDN) {
+    async isPayerActive(partyId, partyIdType = common_js_1.PartyIdType.MSISDN) {
+        const safeType = (0, security_js_1.pathPartyType)(partyIdType);
+        const safeId = (0, security_js_1.pathPartyId)(safeType, partyId);
         try {
-            const response = await this.client.get(`/remittance/v1_0/accountholder/${partyIdType}/${partyId}/active`);
-            return response.status === 200;
+            const response = await this.client.get(`/remittance/v1_0/accountholder/${safeType}/${safeId}/active`);
+            return response.data?.result === true;
         }
         catch (error) {
-            if (error.response?.status === 404) {
+            if (error &&
+                typeof error === "object" &&
+                "status" in error &&
+                error.status === 404) {
                 return false;
             }
             throw error;
@@ -88,8 +95,9 @@ class Remittance {
      * @returns A promise that resolves to the basic user information
      */
     getBasicUserInfo(partyId) {
+        const safeId = (0, security_js_1.pathPartyId)(common_js_1.PartyIdType.MSISDN, partyId);
         return this.client
-            .get(`/remittance/v1_0/accountholder/MSISDN/${partyId}/basicuserinfo`)
+            .get(`/remittance/v1_0/accountholder/MSISDN/${safeId}/basicuserinfo`)
             .then((response) => response.data);
     }
     /**
@@ -100,7 +108,7 @@ class Remittance {
      */
     getBalanceInCurrency(currency) {
         return this.client
-            .get(`/remittance/v1_0/account/balance/${currency}`)
+            .get(`/remittance/v1_0/account/balance/${(0, security_js_1.pathCurrency)(currency)}`)
             .then((response) => response.data);
     }
     /**
@@ -108,9 +116,14 @@ class Remittance {
      * Requires prior OAuth2 user consent/login flow to obtain authorization
      * @returns A promise that resolves to the user's information and KYC consent details
      */
-    getUserInfoWithConsent() {
+    getUserInfoWithConsent(consentToken) {
+        (0, security_js_1.validateAccessToken)(consentToken);
         return this.client
-            .get(`/remittance/oauth2/v1_0/userinfo`)
+            .get("/remittance/oauth2/v1_0/userinfo", {
+            headers: {
+                Authorization: `Bearer ${consentToken}`,
+            },
+        })
             .then((response) => response.data);
     }
     /**
@@ -134,7 +147,7 @@ class Remittance {
         if (request.scope_instruction) {
             params.append("scope_instruction", request.scope_instruction);
         }
-        const basicAuthToken = (0, auth_1.createBasicAuthToken)(this.config);
+        const basicAuthToken = (0, auth_js_1.createBasicAuthToken)(this.config);
         return this.client
             .post("/remittance/v1_0/bc-authorize", params, {
             headers: {
@@ -152,27 +165,29 @@ class Remittance {
      * @returns A promise that resolves to the reference ID
      */
     cashTransfer(request) {
-        const referenceId = (0, uuid_1.v4)();
-        return this.client
-            .post("/remittance/v2_0/cashtransfer", {
-            amount: request.amount,
-            currency: request.currency,
-            externalId: request.externalId,
-            payee: request.payee,
-            originatingCountry: request.originatingCountry,
-            originalAmount: request.originalAmount,
-            originalCurrency: request.originalCurrency,
-            payerMessage: request.payerMessage,
-            payeeNote: request.payeeNote,
-        }, {
-            headers: {
-                "X-Reference-Id": referenceId,
-                ...(request.callbackUrl
-                    ? { "X-Callback-Url": request.callbackUrl }
-                    : {}),
-            },
-        })
-            .then(() => referenceId);
+        return (0, validate_js_1.validateCashTransferRequest)(request).then(() => {
+            const referenceId = (0, security_js_1.resolveReferenceId)(request.referenceId);
+            return this.client
+                .post("/remittance/v2_0/cashtransfer", {
+                amount: request.amount,
+                currency: request.currency,
+                externalId: request.externalId,
+                payee: request.payee,
+                originatingCountry: request.originatingCountry,
+                originalAmount: request.originalAmount,
+                originalCurrency: request.originalCurrency,
+                payerMessage: request.payerMessage,
+                payeeNote: request.payeeNote,
+            }, {
+                headers: {
+                    "X-Reference-Id": referenceId,
+                    ...(request.callbackUrl
+                        ? { "X-Callback-Url": request.callbackUrl }
+                        : {}),
+                },
+            })
+                .then(() => referenceId);
+        });
     }
     /**
      * Get the details and status of a cash transfer (V2).
@@ -182,11 +197,11 @@ class Remittance {
      */
     getCashTransfer(referenceId) {
         return this.client
-            .get(`/remittance/v2_0/cashtransfer/${referenceId}`)
+            .get(`/remittance/v2_0/cashtransfer/${(0, security_js_1.pathUuid)(referenceId)}`)
             .then((response) => response.data)
             .then((transfer) => {
-            if (transfer.status === common_1.TransactionStatus.FAILED) {
-                return Promise.reject((0, errors_1.getTransactionError)(transfer));
+            if (transfer.status === common_js_1.TransactionStatus.FAILED) {
+                return Promise.reject((0, errors_js_1.getTransactionError)(transfer));
             }
             return transfer;
         });
@@ -201,9 +216,11 @@ class Remittance {
         const params = new URLSearchParams();
         params.append("grant_type", request.grant_type);
         params.append("auth_req_id", request.auth_req_id);
+        const basicAuthToken = (0, auth_js_1.createBasicAuthToken)(this.config);
         return this.client
             .post("/remittance/oauth2/token/", params, {
             headers: {
+                Authorization: `Basic ${basicAuthToken}`,
                 "Content-Type": "application/x-www-form-urlencoded",
             },
         })

package/lib/cjs/remittance.js.map

@@ -1 +1 @@
-{"version":3,"file":"remittance.js","sourceRoot":"","sources":["../../src/remittance.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"remittance.js","sourceRoot":"","sources":["../../src/remittance.ts"],"names":[],"mappings":";;AAaA,2CAA6D;AAC7D,uCAAiD;AACjD,2CAAkD;AAElD,+CAOuB;AACvB,+CAA4D;AAE5D;;GAEG;AACH,MAAqB,UAAU;IAI7B,YAAY,MAAkB,EAAE,MAAc;QAC5C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAQ,CAAC,OAA4B;QACzC,MAAM,IAAA,yCAA2B,EAAC,OAAO,CAAC,CAAC;QAC3C,MAAM,WAAW,GAAG,IAAA,gCAAkB,EAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC5D,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACpB,2BAA2B,EAC3B;YACE,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;YAC9C,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;YAC1C,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,EACD;YACE,OAAO,EAAE;gBACP,gBAAgB,EAAE,WAAW;gBAC7B,cAAc,EAAE,kBAAkB;gBAClC,GAAG,CAAC,OAAO,CAAC,WAAW;oBACrB,CAAC,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,WAAW,EAAE;oBAC3C,CAAC,CAAC,EAAE,CAAC;aACR;SACF,CACF,CAAC;QAEF,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc,CAAC,WAAmB;QACtC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CACpC,6BAA6B,IAAA,sBAAQ,EAAC,WAAW,CAAC,EAAE,CACrD,CAAC;QAEF,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC;QAClC,IAAI,WAAW,CAAC,MAAM,KAAK,6BAAiB,CAAC,MAAM,EAAE,CAAC;YACpD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAA,+BAAmB,EAAC,WAAW,CAAC,CAAC,CAAC;QAC1D,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,MAAM;aACf,GAAG,CAAU,kCAAkC,CAAC;aAChD,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CACjB,OAAe,EACf,cAA2B,uBAAW,CAAC,MAAM;QAE7C,MAAM,QAAQ,GAAG,IAAA,2BAAa,EAAC,WAAW,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAA,yBAAW,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CACpC,kCAAkC,QAAQ,IAAI,MAAM,SAAS,CAC9D,CAAC;YACF,OAAO,QAAQ,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QACxC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IACE,KAAK;gBACL,OAAO,KAAK,KAAK,QAAQ;gBACzB,QAAQ,IAAI,KAAK;gBACjB,KAAK,CAAC,MAAM,KAAK,GAAG,EACpB,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACI,gBAAgB,CAAC,OAAe;QACrC,MAAM,MAAM,GAAG,IAAA,yBAAW,EAAC,uBAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,MAAM;aACf,GAAG,CACF,yCAAyC,MAAM,gBAAgB,CAChE;aACA,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACI,oBAAoB,CAAC,QAAgB;QAC1C,OAAO,IAAI,CAAC,MAAM;aACf,GAAG,CACF,oCAAoC,IAAA,0BAAY,EAAC,QAAQ,CAAC,EAAE,CAC7D;aACA,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACI,sBAAsB,CAC3B,YAAoB;QAEpB,IAAA,iCAAmB,EAAC,YAAY,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC,MAAM;aACf,GAAG,CAAqB,kCAAkC,EAAE;YAC3D,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,YAAY,EAAE;aACxC;SACF,CAAC;aACD,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;OAMG;IACI,WAAW,CAChB,OAA2B;QAE3B,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAClD,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAC7B,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,OAAO,CAAC,yBAAyB,EAAE,CAAC;YACtC,MAAM,CAAC,MAAM,CAAC,2BAA2B,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;QAChF,CAAC;QACD,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAC9B,MAAM,CAAC,MAAM,CAAC,mBAAmB,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,cAAc,GAAW,IAAA,8BAAoB,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEjE,OAAO,IAAI,CAAC,MAAM;aACf,IAAI,CAAsB,+BAA+B,EAAE,MAAM,EAAE;YAClE,OAAO,EAAE;gBACP,aAAa,EAAE,SAAS,cAAc,EAAE;gBACxC,cAAc,EAAE,mCAAmC;aACpD;SACF,CAAC;aACD,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;OAMG;IACI,YAAY,CAAC,OAA4B;QAC9C,OAAO,IAAA,yCAA2B,EAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;YACpD,MAAM,WAAW,GAAG,IAAA,gCAAkB,EAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YAC5D,OAAO,IAAI,CAAC,MAAM;iBACf,IAAI,CACL,+BAA+B,EAC/B;gBACE,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;gBAC9C,cAAc,EAAE,OAAO,CAAC,cAAc;gBACtC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;gBAC1C,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,SAAS,EAAE,OAAO,CAAC,SAAS;aAC7B,EACD;gBACE,OAAO,EAAE;oBACP,gBAAgB,EAAE,WAAW;oBAC7B,GAAG,CAAC,OAAO,CAAC,WAAW;wBACrB,CAAC,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,WAAW,EAAE;wBAC3C,CAAC,CAAC,EAAE,CAAC;iBACR;aACF,CACA;iBACA,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACI,eAAe,CAAC,WAAmB;QACxC,OAAO,IAAI,CAAC,MAAM;aACf,GAAG,CACF,iCAAiC,IAAA,sBAAQ,EAAC,WAAW,CAAC,EAAE,CACzD;aACA,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;aACjC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;YACjB,IAAI,QAAQ,CAAC,MAAM,KAAK,6BAAiB,CAAC,MAAM,EAAE,CAAC;gBACjD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAA,+BAAmB,EAAC,QAAQ,CAAC,CAAC,CAAC;YACvD,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;;OAKG;IACI,cAAc,CACnB,OAA2B;QAE3B,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAElD,MAAM,cAAc,GAAG,IAAA,8BAAoB,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC,MAAM;aACf,IAAI,CAAsB,2BAA2B,EAAE,MAAM,EAAE;YAC9D,OAAO,EAAE;gBACP,aAAa,EAAE,SAAS,cAAc,EAAE;gBACxC,cAAc,EAAE,mCAAmC;aACpD;SACF,CAAC;aACD,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;CACF;AA1QD,6BA0QC"}

package/lib/cjs/security.d.ts

@@ -0,0 +1,32 @@
+import { Environment, PartyIdType } from "./common.js";
+import type { GlobalConfig, Party } from "./common.js";
+export declare const DEFAULT_TIMEOUT_MS = 30000;
+export declare const DEFAULT_MAX_RESPONSE_BYTES: number;
+export declare const MAX_TIMEOUT_MS = 120000;
+export declare const MAX_RESPONSE_BYTES: number;
+export interface FinancialOperationOptions {
+    /**
+     * Stable MTN resource identifier for this logical financial operation.
+     *
+     * Production callers that may retry must generate and persist this value
+     * before the first request, then reuse it for every retry.
+     */
+    referenceId?: string;
+}
+export declare function generateReferenceId(): string;
+export declare function requireUuidV4(value: unknown, name?: string): string;
+export declare function resolveReferenceId(referenceId?: string): string;
+export declare function pathUuid(value: unknown, name?: string): string;
+export declare function pathCurrency(value: unknown): string;
+export declare function pathPartyType(value: unknown): PartyIdType;
+export declare function pathPartyId(type: PartyIdType, value: unknown): string;
+export declare function validateParty(party: Party | undefined, name: string): void;
+export declare function encodeStrictPathSegment(value: unknown, name: string): string;
+export declare function validateFinancialAmount(amount: unknown, name?: string): asserts amount is string;
+export declare function validateCurrency(currency: unknown): asserts currency is string;
+export declare function validateAccessToken(token: unknown, name?: string): asserts token is string;
+export declare function normalizeBaseUrl(baseUrl: string, environment: Environment): string;
+export declare function validateGlobalSecurityConfig(config: GlobalConfig): void;
+export declare function redactSensitiveText(value: string): string;
+export declare function redactUrl(value: string): string;
+//# sourceMappingURL=security.d.ts.map

package/lib/cjs/security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/security.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAYvD,eAAO,MAAM,kBAAkB,QAAS,CAAC;AACzC,eAAO,MAAM,0BAA0B,QAAc,CAAC;AACtD,eAAO,MAAM,cAAc,SAAU,CAAC;AACtC,eAAO,MAAM,kBAAkB,QAAmB,CAAC;AAEnD,MAAM,WAAW,yBAAyB;IACxC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,SAAgB,GAAG,MAAM,CAQ1E;AAED,wBAAgB,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAI/D;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,SAAgB,GAAG,MAAM,CAErE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQnD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CASzD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAgBrE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAY1E;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,GACX,MAAM,CAyCR;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,EACf,IAAI,SAAW,GACd,OAAO,CAAC,MAAM,IAAI,MAAM,CAU1B;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,QAAQ,IAAI,MAAM,CAE5B;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,IAAI,SAAiB,GACpB,OAAO,CAAC,KAAK,IAAI,MAAM,CASzB;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,WAAW,GACvB,MAAM,CAiCR;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAiCvE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQzD;AA6BD,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAe/C"}