@maxkabechani/mtn-momo-sdk 0.2.2 → 1.0.0

package/MIGRATION.md

@@ -0,0 +1,79 @@
+# Migrating to 1.0.0
+
+## Financial references
+
+Generate and persist a UUIDv4 before every new financial operation:
+
+```ts
+const referenceId = generateReferenceId();
+await persist(referenceId);
+
+await collections.requestToPay({
+  referenceId,
+  amount: "10.00",
+  currency: "EUR",
+  payer,
+});
+```
+
+Reuse that exact `referenceId` after a timeout, connection reset, or other
+ambiguous failure. Do not reuse it for a genuinely new operation.
+
+The optional field is available on request-to-pay, withdrawals, transfers,
+deposits, refunds, and remittance cash transfers.
+
+## Production configuration
+
+Production now requires an explicit HTTPS base URL:
+
+```ts
+create({
+  callbackHost: "payments.example.com",
+  environment: Environment.PRODUCTION,
+  baseUrl: "https://approved-mtn-host.example",
+});
+```
+
+Embedded URL credentials, HTTP, unsupported protocols, queries, and fragments
+are rejected.
+
+## Consent APIs
+
+Pass the returned consent access token explicitly:
+
+```ts
+const token = await collections.getOAuth2Token(request);
+const user = await collections.getUserInfoWithConsent(token.access_token);
+```
+
+Consent tokens are not cached globally or shared between customers.
+
+## Errors
+
+Public request errors no longer contain raw request headers or payloads.
+`error.config` is now only:
+
+```ts
+{
+  method: string;
+  url: string;      // redacted
+  timeout: number;
+}
+```
+
+Stop reading `error.config.headers`, `Authorization`, or subscription keys.
+
+## Runtime validation
+
+- Amounts must be positive decimal strings.
+- Amount strings are preserved exactly; currency-specific precision and scale
+  remain subject to the applicable MTN product contract.
+- MTN references and API-user IDs must be UUIDv4.
+- Currency path parameters must be uppercase three-letter codes.
+- Party identifiers and types are validated and safely encoded.
+- Production sandbox-user provisioning is rejected.
+
+## Runtime support
+
+Node.js 20.19+ and Bun are supported. Both ESM import and CommonJS require are
+verified against the packed artifact.

package/README.md

@@ -11,7 +11,9 @@ This SDK provides a type-safe, developer-friendly interface for integrating MTN
 - **V1 & V2 Coexistence**: Use stable V1 endpoints by default or opt-in to V2 features (`depositV2`, `refundV2`, `requestToWithdrawV2`, `cashTransfer`).
 - **Comprehensive Coverage**: Request-to-pay, transfers, deposits, refunds, withdrawals, BC Authorize, OAuth2 consent, delivery notifications, and more.
 - **TypeScript First**: Full type definitions for all requests, responses, and errors.
-- **Bun & Node.js**: Works with modern runtimes.
+- **Bun & Node.js**: Supports Node.js 20.19+ and Bun.
+- **Retry-safe references**: Callers can generate and persist MTN reference IDs before dispatch.
+- **Secure transport and errors**: Production requires HTTPS and public errors never expose request credentials.
 
 ---
 
@@ -35,9 +37,13 @@ import { create, Environment } from "@maxkabechani/mtn-momo-sdk";
 const momo = create({
   callbackHost: "yourdomain.com",
   environment: Environment.SANDBOX, // or Environment.PRODUCTION
+  timeoutMs: 30_000,                // optional
+  maxResponseBytes: 1024 * 1024,    // optional
 });
 ```
 
+Production additionally requires an explicit HTTPS `baseUrl`. HTTP is rejected.
+
 ### 2. Provision Sandbox Credentials
 
 Use the `Users` client to create sandbox API users, or use the CLI tool:
@@ -65,6 +71,28 @@ const collections = momo.Collections({
 });
 ```
 
+### 4. Persist references before financial requests
+
+Production applications must generate and persist the MTN reference before the
+first attempt. Reuse the same value after timeouts or ambiguous network errors.
+
+```ts
+import { generateReferenceId } from "@maxkabechani/mtn-momo-sdk";
+
+const referenceId = generateReferenceId();
+await saveReferenceForRetry(referenceId);
+
+await collections.requestToPay({
+  referenceId,
+  amount: "500",
+  currency: "EUR",
+  payer: { partyIdType: "MSISDN", partyId: "46733123454" },
+});
+```
+
+If `referenceId` is omitted, the SDK still generates one for compatibility.
+That fallback must not be used by applications that retry financial operations.
+
 ---
 
 ## API Reference
@@ -213,7 +241,9 @@ Requests a payment from a consumer (payer).
 - **Errors**: Validation errors for missing/invalid fields
 
 ```ts
-const referenceId = await collections.requestToPay({
+const referenceId = generateReferenceId();
+await collections.requestToPay({
+  referenceId,
   amount: "500",
   currency: "EUR",
   externalId: "order-123",
@@ -340,10 +370,11 @@ const authResult = await collections.bcAuthorize({
 });
 ```
 
-#### `getUserInfoWithConsent(): Promise<ConsentKycResponse>`
+#### `getUserInfoWithConsent(consentToken: string): Promise<ConsentKycResponse>`
 
 Retrieves user information with KYC consent (requires prior OAuth2 authorization).
 
+- **Arguments**: `consentToken` — the access token returned by `getOAuth2Token`
 - **Returns**: User info including `sub`, `name`, `phone_number`, `status`
 
 #### `getOAuth2Token(request: OAuth2TokenRequest): Promise<OAuth2TokenResponse>`
@@ -358,6 +389,8 @@ const token = await collections.getOAuth2Token({
   grant_type: "urn:openid:params:grant-type:ciba",
   auth_req_id: authResult.auth_req_id,
 });
+
+const userInfo = await collections.getUserInfoWithConsent(token.access_token);
 ```
 
 ---
@@ -660,12 +693,34 @@ try {
    const momo = create({
      callbackHost: "production-api.yoursite.com",
      environment: Environment.PRODUCTION,
+     baseUrl: "https://your-approved-mtn-production-host.example",
    });
    ```
 
 2. **Use production credentials** from the [MTN MoMo Developer Portal](https://momodeveloper.mtn.com/).
 
-3. **Endpoints**: The SDK handles the URL switch automatically.
+3. **Transport**: Production URLs must be valid HTTPS URLs without embedded credentials, queries, or fragments.
+
+4. **Provisioning**: `Users` is sandbox-only and rejects production use before network dispatch.
+
+---
+
+## Version 1 migration
+
+Version 1 contains security-related behavior changes:
+
+- Every financial request accepts `referenceId?: string`. Generate and persist it before the first attempt and reuse it on retries.
+- `getUserInfoWithConsent` now requires an explicit consent token.
+- Production requires an explicit HTTPS `baseUrl`.
+- Dynamic status, currency, party, and user identifiers are runtime-validated.
+- Financial amounts must be complete positive decimal strings.
+- The SDK preserves decimal strings exactly. Confirm currency-specific provider
+  precision and scale limits with MTN before production use.
+- Public network errors expose only a redacted request summary; do not inspect raw `error.config.headers`.
+- Requests reject redirects, default to a 30-second timeout, and limit responses to 1 MiB unless configured otherwise.
+- Node.js 20.19 or newer is required.
+
+See [`MIGRATION.md`](./MIGRATION.md) for a compact adapter migration checklist.
 
 ---
 
@@ -706,12 +761,20 @@ const collections = momo.Collections({
 
 ```bash
 bun install
-bun run test         # Run all tests (unit + integration)
+bun run test         # Run all tests; live sandbox tests skip without keys
+bun run test:security # Run the security regression suite
+bun run test:integration # Run deterministic public-factory integration tests
+bun run test:integration:live # Run credential-gated MTN sandbox tests
 bun run test:coverage # Run tests with coverage
 bun run typecheck    # Type check
+bun run lint         # Static project checks
 bun run build        # Build for production (ESM + CJS)
+bun run test:package # Packed Node ESM/CJS, Bun, and declarations
 ```
 
+Releases are published from version tags through npm Trusted Publishing. See
+[`RELEASING.md`](./RELEASING.md) for the release procedure.
+
 ## License
 
 ISC

package/lib/cjs/auth.d.ts

@@ -1,5 +1,5 @@
-import type { HttpClient } from "./httpClient";
-import type { AccessToken, Config, UserConfig } from "./common";
+import type { HttpClient } from "./httpClient.js";
+import type { AccessToken, Config, UserConfig } from "./common.js";
 export type TokenRefresher = () => Promise<string>;
 export interface AuthorizerOptions {
     grant_type?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEhE,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;AAEnD,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,UAAU,GAAG,CACvB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,iBAAiB,EAC3B,MAAM,CAAC,EAAE,UAAU,KAChB,OAAO,CAAC,WAAW,GAAG;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,wBAAwB,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAS1F,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,UAAU,EACrB,MAAM,EAAE,MAAM,GACb,cAAc,CAmChB;AASD,eAAO,MAAM,oBAAoB,EAAE,UAalC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,UAapC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,UAajC,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAI/D"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAIlD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGnE,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;AAEnD,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,UAAU,GAAG,CACvB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,iBAAiB,EAC3B,MAAM,CAAC,EAAE,UAAU,KAChB,OAAO,CAAC,WAAW,GAAG;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,wBAAwB,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAS1F,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,UAAU,EACrB,MAAM,EAAE,MAAM,GACb,cAAc,CA8DhB;AASD,eAAO,MAAM,oBAAoB,EAAE,UAalC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,UAapC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,UAajC,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAI/D"}

package/lib/cjs/auth.js

@@ -3,22 +3,38 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.authorizeRemittance = exports.authorizeDisbursements = exports.authorizeCollections = void 0;
 exports.createTokenRefresher = createTokenRefresher;
 exports.createBasicAuthToken = createBasicAuthToken;
-const client_1 = require("./client");
+const client_js_1 = require("./client.js");
+const security_js_1 = require("./security.js");
 function createTokenRefresher(authorize, config) {
     let credentials;
-    return () => {
+    let inFlight;
+    return async () => {
+        if (!isExpired(credentials)) {
+            return credentials.accessToken;
+        }
+        if (inFlight) {
+            return inFlight;
+        }
         if (isExpired(credentials)) {
             const isRefreshTokenValid = credentials?.refreshToken && !isRefreshExpired(credentials);
             const options = isRefreshTokenValid
-                ? { grant_type: 'refresh_token', refresh_token: credentials.refreshToken }
-                : { grant_type: 'client_credentials' };
-            return authorize(config, options)
+                ? {
+                    grant_type: "refresh_token",
+                    refresh_token: credentials.refreshToken,
+                }
+                : { grant_type: "client_credentials" };
+            inFlight = authorize(config, options)
                 .then((tokenData) => {
-                const { access_token, expires_in, refresh_token, refresh_token_expired_in } = tokenData;
+                const { access_token, expires_in, refresh_token, refresh_token_expired_in, } = tokenData;
+                (0, security_js_1.validateAccessToken)(access_token, "access_token");
+                if (!Number.isFinite(expires_in)) {
+                    throw new TypeError("expires_in must be a finite number");
+                }
                 const expires = Date.now() + expires_in * 1000 - 60000;
                 let refreshExpires;
                 if (refresh_token_expired_in) {
-                    refreshExpires = Date.now() + refresh_token_expired_in * 1000 - 60000;
+                    refreshExpires =
+                        Date.now() + refresh_token_expired_in * 1000 - 60000;
                 }
                 return {
                     accessToken: access_token,
@@ -30,9 +46,13 @@ function createTokenRefresher(authorize, config) {
                 .then((freshCredentials) => {
                 credentials = freshCredentials;
                 return credentials.accessToken;
+            })
+                .finally(() => {
+                inFlight = undefined;
             });
+            return inFlight;
         }
-        return Promise.resolve(credentials.accessToken);
+        return credentials.accessToken;
     };
 }
 function isRefreshExpired(credentials) {
@@ -41,7 +61,7 @@ function isRefreshExpired(credentials) {
     }
     return Date.now() > credentials.refreshExpires;
 }
-const authorizeCollections = function (config, options, client = (0, client_1.createClient)(config)) {
+const authorizeCollections = function (config, options, client = (0, client_js_1.createClient)(config)) {
     const basicAuthToken = createBasicAuthToken(config);
     return client
         .post("/collection/token/", null, {
@@ -52,7 +72,7 @@ const authorizeCollections = function (config, options, client = (0, client_1.cr
         .then((response) => response.data);
 };
 exports.authorizeCollections = authorizeCollections;
-const authorizeDisbursements = function (config, options, client = (0, client_1.createClient)(config)) {
+const authorizeDisbursements = function (config, options, client = (0, client_js_1.createClient)(config)) {
     const basicAuthToken = createBasicAuthToken(config);
     return client
         .post("/disbursement/token/", null, {
@@ -63,7 +83,7 @@ const authorizeDisbursements = function (config, options, client = (0, client_1.
         .then((response) => response.data);
 };
 exports.authorizeDisbursements = authorizeDisbursements;
-const authorizeRemittance = function (config, options, client = (0, client_1.createClient)(config)) {
+const authorizeRemittance = function (config, options, client = (0, client_js_1.createClient)(config)) {
     const basicAuthToken = createBasicAuthToken(config);
     return client
         .post("/remittance/token/", null, {

package/lib/cjs/auth.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/auth.ts"],"names":[],"mappings":";;;AA0BA,oDAsCC;AAsDD,oDAIC;AAxHD,qCAAwC;AAwBxC,SAAgB,oBAAoB,CAClC,SAAqB,EACrB,MAAc;IAEd,IAAI,WAA6B,CAAC;IAClC,OAAO,GAAG,EAAE;QACV,IAAI,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;YAC3B,MAAM,mBAAmB,GAAG,WAAW,EAAE,YAAY,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;YAExF,MAAM,OAAO,GAAsB,mBAAmB;gBACpD,CAAC,CAAC,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,WAAW,CAAC,YAAY,EAAE;gBAC1E,CAAC,CAAC,EAAE,UAAU,EAAE,oBAAoB,EAAE,CAAC;YAEzC,OAAO,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC;iBAC9B,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE;gBAClB,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,wBAAwB,EAAE,GAAG,SAAS,CAAC;gBACxF,MAAM,OAAO,GAAW,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,GAAG,IAAI,GAAG,KAAK,CAAC;gBAE/D,IAAI,cAAkC,CAAC;gBACvC,IAAI,wBAAwB,EAAE,CAAC;oBAC7B,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,wBAAwB,GAAG,IAAI,GAAG,KAAK,CAAC;gBACxE,CAAC;gBAED,OAAO;oBACL,WAAW,EAAE,YAAY;oBACzB,OAAO;oBACP,YAAY,EAAE,aAAa;oBAC3B,cAAc;iBACf,CAAC;YACJ,CAAC,CAAC;iBACD,IAAI,CAAC,CAAC,gBAAgB,EAAE,EAAE;gBACzB,WAAW,GAAG,gBAAgB,CAAC;gBAC/B,OAAO,WAAW,CAAC,WAAW,CAAC;YACjC,CAAC,CAAC,CAAC;QACP,CAAC;QAED,OAAO,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,WAA6B;IACrD,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC,cAAc,CAAC;AACjD,CAAC;AAEM,MAAM,oBAAoB,GAAe,UAC9C,MAAc,EACd,OAA2B,EAC3B,SAAqB,IAAA,qBAAY,EAAC,MAAM,CAAC;IAEzC,MAAM,cAAc,GAAW,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC5D,OAAO,MAAM;SACV,IAAI,CAAC,oBAAoB,EAAE,IAAI,EAAE;QAChC,OAAO,EAAE;YACP,aAAa,EAAE,SAAS,cAAc,EAAE;SACzC;KACF,CAAC;SACD,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC,CAAC;AAbW,QAAA,oBAAoB,wBAa/B;AAEK,MAAM,sBAAsB,GAAe,UAChD,MAAc,EACd,OAA2B,EAC3B,SAAqB,IAAA,qBAAY,EAAC,MAAM,CAAC;IAEzC,MAAM,cAAc,GAAW,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC5D,OAAO,MAAM;SACV,IAAI,CAAC,sBAAsB,EAAE,IAAI,EAAE;QAClC,OAAO,EAAE;YACP,aAAa,EAAE,SAAS,cAAc,EAAE;SACzC;KACF,CAAC;SACD,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC,CAAC;AAbW,QAAA,sBAAsB,0BAajC;AAEK,MAAM,mBAAmB,GAAe,UAC7C,MAAc,EACd,OAA2B,EAC3B,SAAqB,IAAA,qBAAY,EAAC,MAAM,CAAC;IAEzC,MAAM,cAAc,GAAW,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC5D,OAAO,MAAM;SACV,IAAI,CAAC,oBAAoB,EAAE,IAAI,EAAE;QAChC,OAAO,EAAE;YACP,aAAa,EAAE,SAAS,cAAc,EAAE;SACzC;KACF,CAAC;SACD,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC,CAAC;AAbW,QAAA,mBAAmB,uBAa9B;AAEF,SAAgB,oBAAoB,CAAC,MAAkB;IACrD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAClE,QAAQ,CACT,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,WAA6B;IAC9C,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/auth.ts"],"names":[],"mappings":"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"}

package/lib/cjs/cli.js

@@ -35,7 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
-const momo = __importStar(require("./index"));
+const momo = __importStar(require("./index.js"));
 const version = process.env.npm_package_version || "0.0.0";
 commander_1.program
     .version(version)
@@ -61,6 +61,9 @@ users
     });
 })
     .catch((error) => {
-    console.log(error);
+    const name = error instanceof Error ? error.name : "Error";
+    const message = error instanceof Error ? error.message : "Request failed";
+    console.error(`${name}: ${message}`);
+    process.exitCode = 1;
 });
 //# sourceMappingURL=cli.js.map

package/lib/cjs/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,yCAAoC;AAEpC,8CAAgC;AAIhC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO,CAAC;AAE3D,mBAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,4BAA4B,CAAC;KACzC,MAAM,CAAC,gBAAgB,EAAE,mBAAmB,CAAC;KAC7C,MAAM,CAAC,uBAAuB,EAAE,aAAa,CAAC;KAC9C,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAEvB,MAAM,OAAO,GAAG,mBAAO,CAAC,IAAI,EAA0C,CAAC;AAEvE,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;IACzC,mBAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,SAAS,GAAG,CAAC,GAAoB,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAEzE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;AAE9D,MAAM,KAAK,GAAG,KAAK,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;AAExD,KAAK;KACF,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;KACpB,IAAI,CAAC,CAAC,MAAc,EAAE,EAAE;IACvB,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,WAAwB,EAAE,EAAE;QAC3D,OAAO,CAAC,GAAG,CACT,0BAA0B,EAC1B,SAAS,CAAC;YACR,UAAU,EAAE,WAAW,CAAC,MAAM;YAC9B,MAAM;SACP,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;KACD,KAAK,CAAC,CAAC,KAAmB,EAAE,EAAE;IAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACrB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,yCAAoC;AAEpC,iDAAmC;AAGnC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO,CAAC;AAE3D,mBAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,4BAA4B,CAAC;KACzC,MAAM,CAAC,gBAAgB,EAAE,mBAAmB,CAAC;KAC7C,MAAM,CAAC,uBAAuB,EAAE,aAAa,CAAC;KAC9C,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAEvB,MAAM,OAAO,GAAG,mBAAO,CAAC,IAAI,EAA0C,CAAC;AAEvE,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;IACzC,mBAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,SAAS,GAAG,CAAC,GAAoB,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAEzE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;AAE9D,MAAM,KAAK,GAAG,KAAK,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;AAExD,KAAK;KACF,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;KACpB,IAAI,CAAC,CAAC,MAAc,EAAE,EAAE;IACvB,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,WAAwB,EAAE,EAAE;QAC3D,OAAO,CAAC,GAAG,CACT,0BAA0B,EAC1B,SAAS,CAAC;YACR,UAAU,EAAE,WAAW,CAAC,MAAM;YAC9B,MAAM;SACP,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;KACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACxB,MAAM,IAAI,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;IAC3D,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC;IAC1E,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;IACrC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/lib/cjs/client.d.ts

@@ -1,6 +1,6 @@
-import { HttpClient } from "./httpClient";
-import type { TokenRefresher } from "./auth";
-import type { GlobalConfig, SubscriptionConfig } from "./common";
+import { HttpClient } from "./httpClient.js";
+import type { TokenRefresher } from "./auth.js";
+import { type GlobalConfig, type SubscriptionConfig } from "./common.js";
 export declare function createClient(config: SubscriptionConfig & GlobalConfig, client?: HttpClient): HttpClient;
 export declare function createAuthClient(refresh: TokenRefresher, client: HttpClient): HttpClient;
 export declare function withErrorHandling(client: HttpClient): HttpClient;

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAoB,MAAM,cAAc,CAAC;AAK5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEjE,wBAAgB,YAAY,CAC1B,MAAM,EAAE,kBAAkB,GAAG,YAAY,EACzC,MAAM,GAAE,UAA+B,GACtC,UAAU,CAUZ;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,UAAU,GACjB,UAAU,CAYZ;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAOhE"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAoB,MAAM,iBAAiB,CAAC;AAK/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AAOrB,wBAAgB,YAAY,CAC1B,MAAM,EAAE,kBAAkB,GAAG,YAAY,EACzC,MAAM,GAAE,UAA+B,GACtC,UAAU,CAgBZ;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,UAAU,GACjB,UAAU,CAiBZ;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAYhE"}

package/lib/cjs/client.js

@@ -3,12 +3,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createClient = createClient;
 exports.createAuthClient = createAuthClient;
 exports.withErrorHandling = withErrorHandling;
-const httpClient_1 = require("./httpClient");
-const errors_1 = require("./errors");
-function createClient(config, client = (0, httpClient_1.createHttpClient)()) {
+const httpClient_js_1 = require("./httpClient.js");
+const errors_js_1 = require("./errors.js");
+const common_js_1 = require("./common.js");
+const security_js_1 = require("./security.js");
+function createClient(config, client = (0, httpClient_js_1.createHttpClient)()) {
     if (config.baseUrl) {
-        client.defaults.baseURL = config.baseUrl;
+        client.defaults.baseURL = (0, security_js_1.normalizeBaseUrl)(config.baseUrl, config.environment ?? common_js_1.Environment.SANDBOX);
     }
+    client.defaults.timeout = config.timeoutMs ?? security_js_1.DEFAULT_TIMEOUT_MS;
+    client.defaults.maxResponseBytes =
+        config.maxResponseBytes ?? security_js_1.DEFAULT_MAX_RESPONSE_BYTES;
     client.defaults.headers.common["Ocp-Apim-Subscription-Key"] =
         config.primaryKey;
     client.defaults.headers.common["X-Target-Environment"] =
@@ -17,15 +22,18 @@ function createClient(config, client = (0, httpClient_1.createHttpClient)()) {
 }
 function createAuthClient(refresh, client) {
     client.interceptors.request.use(async (request) => {
-        const accessToken = await refresh();
         request.headers = request.headers || {};
-        request.headers["Authorization"] = `Bearer ${accessToken}`;
+        const hasExplicitAuthorization = Object.keys(request.headers).some((name) => name.toLowerCase() === "authorization");
+        if (!hasExplicitAuthorization) {
+            const accessToken = await refresh();
+            request.headers["Authorization"] = `Bearer ${accessToken}`;
+        }
         return request;
     });
     return client;
 }
 function withErrorHandling(client) {
-    client.interceptors.response.use((response) => response, (error) => Promise.reject((0, errors_1.handleError)(error)));
+    client.interceptors.response.use((response) => response, (error) => Promise.reject((0, errors_js_1.handleError)(error instanceof Error ? error : new Error(String(error)))));
     return client;
 }
 //# sourceMappingURL=client.js.map

package/lib/cjs/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":";;AAQA,oCAaC;AAED,4CAeC;AAED,8CAOC;AA/CD,6CAA4D;AAG5D,qCAAuC;AAKvC,SAAgB,YAAY,CAC1B,MAAyC,EACzC,SAAqB,IAAA,6BAAgB,GAAE;IAEvC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,CAAC,QAAQ,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC3C,CAAC;IACD,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC;QACzD,MAAM,CAAC,UAAU,CAAC;IACpB,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,sBAAsB,CAAC;QACpD,MAAM,CAAC,WAAW,IAAI,SAAS,CAAC;IAElC,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC;AAED,SAAgB,gBAAgB,CAC9B,OAAuB,EACvB,MAAkB;IAElB,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAC7B,KAAK,EAAE,OAA8B,EAAE,EAAE;QACvC,MAAM,WAAW,GAAG,MAAM,OAAO,EAAE,CAAC;QACpC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QACxC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,WAAW,EAAE,CAAC;QAE3D,OAAO,OAAO,CAAC;IACjB,CAAC,CACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,iBAAiB,CAAC,MAAkB;IAClD,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAC9B,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,EACtB,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,oBAAW,EAAC,KAAK,CAAC,CAAC,CAC9C,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":";;AAiBA,oCAmBC;AAED,4CAoBC;AAED,8CAYC;AAxED,mDAA+D;AAG/D,2CAA0C;AAG1C,2CAIqB;AACrB,+CAIuB;AAEvB,SAAgB,YAAY,CAC1B,MAAyC,EACzC,SAAqB,IAAA,gCAAgB,GAAE;IAEvC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,CAAC,QAAQ,CAAC,OAAO,GAAG,IAAA,8BAAgB,EACxC,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,WAAW,IAAI,uBAAW,CAAC,OAAO,CAC1C,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,QAAQ,CAAC,OAAO,GAAG,MAAM,CAAC,SAAS,IAAI,gCAAkB,CAAC;IACjE,MAAM,CAAC,QAAQ,CAAC,gBAAgB;QAC9B,MAAM,CAAC,gBAAgB,IAAI,wCAA0B,CAAC;IACxD,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC;QACzD,MAAM,CAAC,UAAU,CAAC;IACpB,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,sBAAsB,CAAC;QACpD,MAAM,CAAC,WAAW,IAAI,SAAS,CAAC;IAElC,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC;AAED,SAAgB,gBAAgB,CAC9B,OAAuB,EACvB,MAAkB;IAElB,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAC7B,KAAK,EAAE,OAA8B,EAAE,EAAE;QACvC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QACxC,MAAM,wBAAwB,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAChE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,eAAe,CACjD,CAAC;QACF,IAAI,CAAC,wBAAwB,EAAE,CAAC;YAC9B,MAAM,WAAW,GAAG,MAAM,OAAO,EAAE,CAAC;YACpC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,WAAW,EAAE,CAAC;QAC7D,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC,CACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,iBAAiB,CAAC,MAAkB;IAClD,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAC9B,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,EACtB,CAAC,KAAK,EAAE,EAAE,CACR,OAAO,CAAC,MAAM,CACZ,IAAA,uBAAW,EACT,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAC1D,CACF,CACJ,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/lib/cjs/collections.d.ts

@@ -1,6 +1,7 @@
-import type { HttpClient } from "./httpClient";
-import { type Balance, type BasicUserInfo, type BcAuthorizeRequest, type BcAuthorizeResponse, type Config, type ConsentKycResponse, type DeliveryNotification, FailureReason, type OAuth2TokenRequest, type OAuth2TokenResponse, type Party, PartyIdType, TransactionStatus, type Withdrawal, type WithdrawalRequest } from "./common";
-export interface PaymentRequest {
+import type { HttpClient } from "./httpClient.js";
+import { type Balance, type BasicUserInfo, type BcAuthorizeRequest, type BcAuthorizeResponse, type Config, type ConsentKycResponse, type DeliveryNotification, FailureReason, type OAuth2TokenRequest, type OAuth2TokenResponse, type Party, PartyIdType, TransactionStatus, type Withdrawal, type WithdrawalRequest } from "./common.js";
+import { type FinancialOperationOptions } from "./security.js";
+export interface PaymentRequest extends FinancialOperationOptions {
     /**
      * Amount that will be debited from the payer account
      */
@@ -90,7 +91,7 @@ export default class Collections {
      *
      * @param paymentRequest
      */
-    requestToPay({ callbackUrl, ...paymentRequest }: PaymentRequest): Promise<string>;
+    requestToPay(request: PaymentRequest): Promise<string>;
     /**
      * This method is used to retrieve transaction information. You can invoke it
      * at intervals until your transaction fails or succeeds.
@@ -178,7 +179,7 @@ export default class Collections {
      *
      * @returns A promise that resolves to the user's information and KYC consent details
      */
-    getUserInfoWithConsent(): Promise<ConsentKycResponse>;
+    getUserInfoWithConsent(consentToken: string): Promise<ConsentKycResponse>;
     /**
      * Create an OAuth2 token for consent-based access.
      *

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

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