@maxkabechani/mtn-momo-sdk 0.2.1 → 1.0.0

package/lib/esm/remittance.js

@@ -1,7 +1,8 @@
-import { TransactionStatus, PartyIdType } from "./common";
-import { getTransactionError, MtnMoMoError } from "./errors";
-import { createBasicAuthToken } from "./auth";
-import { v4 as uuid } from "uuid";
+import { PartyIdType, TransactionStatus } from "./common.js";
+import { createBasicAuthToken } from "./auth.js";
+import { getTransactionError } from "./errors.js";
+import { pathCurrency, pathPartyId, pathPartyType, pathUuid, resolveReferenceId, validateAccessToken, } from "./security.js";
+import { validateCashTransferRequest } from "./validate.js";
 /**
  * Remittance product for cross-border money transfers with optional OAuth2 consent flows
  */
@@ -16,7 +17,8 @@ export default class Remittance {
      * @returns A promise that resolves to the financial transaction ID (referenceId)
      */
     async transfer(request) {
-        const referenceId = uuid();
+        await validateCashTransferRequest(request);
+        const referenceId = resolveReferenceId(request.referenceId);
         await this.client.post(`/remittance/v1_0/transfer`, {
             amount: request.amount,
             currency: request.currency,
@@ -44,7 +46,7 @@ export default 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/${pathUuid(referenceId)}`);
         const transaction = response.data;
         if (transaction.status === TransactionStatus.FAILED) {
             return Promise.reject(getTransactionError(transaction));
@@ -67,12 +69,17 @@ export default class Remittance {
      * @returns A promise that resolves to true if the beneficiary is active, false otherwise
      */
     async isPayerActive(partyId, partyIdType = PartyIdType.MSISDN) {
+        const safeType = pathPartyType(partyIdType);
+        const safeId = 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;
@@ -86,8 +93,9 @@ export default class Remittance {
      * @returns A promise that resolves to the basic user information
      */
     getBasicUserInfo(partyId) {
+        const safeId = pathPartyId(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);
     }
     /**
@@ -98,7 +106,7 @@ export default class Remittance {
      */
     getBalanceInCurrency(currency) {
         return this.client
-            .get(`/remittance/v1_0/account/balance/${currency}`)
+            .get(`/remittance/v1_0/account/balance/${pathCurrency(currency)}`)
             .then((response) => response.data);
     }
     /**
@@ -106,9 +114,14 @@ 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() {
+    getUserInfoWithConsent(consentToken) {
+        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);
     }
     /**
@@ -150,27 +163,29 @@ export default class Remittance {
      * @returns A promise that resolves to the reference ID
      */
     cashTransfer(request) {
-        const referenceId = uuid();
-        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 validateCashTransferRequest(request).then(() => {
+            const referenceId = 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).
@@ -180,7 +195,7 @@ export default class Remittance {
      */
     getCashTransfer(referenceId) {
         return this.client
-            .get(`/remittance/v2_0/cashtransfer/${referenceId}`)
+            .get(`/remittance/v2_0/cashtransfer/${pathUuid(referenceId)}`)
             .then((response) => response.data)
             .then((transfer) => {
             if (transfer.status === TransactionStatus.FAILED) {
@@ -199,9 +214,11 @@ export default class Remittance {
         const params = new URLSearchParams();
         params.append("grant_type", request.grant_type);
         params.append("auth_req_id", request.auth_req_id);
+        const basicAuthToken = createBasicAuthToken(this.config);
         return this.client
             .post("/remittance/oauth2/token/", params, {
             headers: {
+                Authorization: `Basic ${basicAuthToken}`,
                 "Content-Type": "application/x-www-form-urlencoded",
             },
         })

package/lib/esm/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":"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"}

package/lib/esm/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/esm/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"}

package/lib/esm/security.js

@@ -0,0 +1,234 @@
+import { v4 as uuid } from "uuid";
+import { Environment, PartyIdType } from "./common.js";
+const UUID_V4 = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+const POSITIVE_DECIMAL = /^(?:0|[1-9]\d*)(?:\.\d+)?$/;
+const CURRENCY = /^[A-Z]{3}$/;
+const MSISDN = /^\+?[0-9]{5,15}$/;
+const EMAIL = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+const CONTROL_CHARACTER = /[\u0000-\u001f\u007f]/;
+const FORBIDDEN_PATH_CHARACTER = /[\/\\?#]/;
+const ENCODED_PATH_SEPARATOR = /%(?:2f|5c)/i;
+export const DEFAULT_TIMEOUT_MS = 30000;
+export const DEFAULT_MAX_RESPONSE_BYTES = 1024 * 1024;
+export const MAX_TIMEOUT_MS = 120000;
+export const MAX_RESPONSE_BYTES = 10 * 1024 * 1024;
+export function generateReferenceId() {
+    return uuid();
+}
+export function requireUuidV4(value, name = "referenceId") {
+    if (typeof value !== "string" || value.length === 0) {
+        throw new TypeError(`${name} is required`);
+    }
+    if (!UUID_V4.test(value)) {
+        throw new TypeError(`${name} must be a valid uuid v4`);
+    }
+    return value;
+}
+export function resolveReferenceId(referenceId) {
+    return referenceId === undefined
+        ? generateReferenceId()
+        : requireUuidV4(referenceId);
+}
+export function pathUuid(value, name = "referenceId") {
+    return encodeURIComponent(requireUuidV4(value, name));
+}
+export function pathCurrency(value) {
+    if (typeof value !== "string" || value.length === 0) {
+        throw new TypeError("currency is required");
+    }
+    if (!CURRENCY.test(value)) {
+        throw new TypeError("currency must be a 3-letter uppercase ISO 4217 code");
+    }
+    return value;
+}
+export function pathPartyType(value) {
+    if (value !== PartyIdType.MSISDN &&
+        value !== PartyIdType.EMAIL &&
+        value !== PartyIdType.PARTY_CODE) {
+        throw new TypeError("partyIdType must be MSISDN, EMAIL, or PARTY_CODE");
+    }
+    return value;
+}
+export function pathPartyId(type, value) {
+    if (typeof value !== "string" || value.length === 0) {
+        throw new TypeError("partyId is required");
+    }
+    if (type === PartyIdType.MSISDN && !MSISDN.test(value)) {
+        throw new TypeError("MSISDN partyId must contain 5 to 15 digits");
+    }
+    if (type === PartyIdType.EMAIL && !EMAIL.test(value)) {
+        throw new TypeError("EMAIL partyId must be a valid email address");
+    }
+    if (type === PartyIdType.PARTY_CODE) {
+        requireUuidV4(value, "PARTY_CODE partyId");
+    }
+    return encodeStrictPathSegment(value, "partyId");
+}
+export function validateParty(party, name) {
+    if (!party) {
+        throw new TypeError(`${name} is required`);
+    }
+    if (typeof party.partyId !== "string" || party.partyId.length === 0) {
+        throw new TypeError(`${name}.partyId is required`);
+    }
+    if (!party.partyIdType) {
+        throw new TypeError(`${name}.partyIdType is required`);
+    }
+    const type = pathPartyType(party.partyIdType);
+    pathPartyId(type, party.partyId);
+}
+export function encodeStrictPathSegment(value, name) {
+    if (typeof value !== "string" &&
+        typeof value !== "number" &&
+        typeof value !== "bigint") {
+        throw new TypeError(`${name} must be a supported primitive`);
+    }
+    const segment = String(value);
+    if (!segment) {
+        throw new TypeError(`${name} is required`);
+    }
+    if (CONTROL_CHARACTER.test(segment)) {
+        throw new TypeError(`${name} contains control characters`);
+    }
+    if (segment === "." ||
+        segment === ".." ||
+        FORBIDDEN_PATH_CHARACTER.test(segment) ||
+        ENCODED_PATH_SEPARATOR.test(segment)) {
+        throw new TypeError(`${name} contains unsafe path characters`);
+    }
+    let decoded = segment;
+    try {
+        decoded = decodeURIComponent(segment);
+    }
+    catch {
+        throw new TypeError(`${name} contains invalid percent encoding`);
+    }
+    if (decoded === "." ||
+        decoded === ".." ||
+        FORBIDDEN_PATH_CHARACTER.test(decoded) ||
+        CONTROL_CHARACTER.test(decoded)) {
+        throw new TypeError(`${name} contains unsafe path characters`);
+    }
+    return encodeURIComponent(segment);
+}
+export function validateFinancialAmount(amount, name = "amount") {
+    if (typeof amount !== "string" || amount.length === 0) {
+        throw new TypeError(`${name} is required`);
+    }
+    if (!POSITIVE_DECIMAL.test(amount)) {
+        throw new TypeError(`${name} must be a number`);
+    }
+    if (/^0+(?:\.0+)?$/.test(amount)) {
+        throw new TypeError(`${name} must be greater than zero`);
+    }
+}
+export function validateCurrency(currency) {
+    pathCurrency(currency);
+}
+export function validateAccessToken(token, name = "consentToken") {
+    if (typeof token !== "string" ||
+        token.length === 0 ||
+        /\s/.test(token) ||
+        CONTROL_CHARACTER.test(token)) {
+        throw new TypeError(`${name} must be a non-empty bearer token`);
+    }
+}
+export function normalizeBaseUrl(baseUrl, environment) {
+    let url;
+    try {
+        url = new URL(baseUrl);
+    }
+    catch {
+        throw new TypeError("baseUrl must be a valid absolute URL");
+    }
+    if (url.username || url.password) {
+        throw new TypeError("baseUrl must not contain embedded credentials");
+    }
+    if (url.search || url.hash) {
+        throw new TypeError("baseUrl must not contain a query string or fragment");
+    }
+    const loopback = url.hostname === "127.0.0.1" ||
+        url.hostname === "localhost" ||
+        url.hostname === "::1" ||
+        url.hostname === "[::1]";
+    const testLoopback = environment === Environment.SANDBOX &&
+        process.env.NODE_ENV === "test" &&
+        loopback &&
+        url.protocol === "http:";
+    if (url.protocol !== "https:" && !testLoopback) {
+        const scope = environment === Environment.PRODUCTION ? "production " : "";
+        throw new TypeError(`${scope}baseUrl must use https`);
+    }
+    return url.toString().replace(/\/+$/, "");
+}
+export function validateGlobalSecurityConfig(config) {
+    const environment = config.environment ?? Environment.SANDBOX;
+    if (environment !== Environment.SANDBOX &&
+        environment !== Environment.PRODUCTION) {
+        throw new TypeError("environment must be sandbox or production");
+    }
+    const baseUrl = config.baseUrl ?? "https://sandbox.momodeveloper.mtn.com";
+    normalizeBaseUrl(baseUrl, environment);
+    if (config.timeoutMs !== undefined &&
+        (!Number.isInteger(config.timeoutMs) ||
+            config.timeoutMs <= 0 ||
+            config.timeoutMs > MAX_TIMEOUT_MS)) {
+        throw new TypeError(`timeoutMs must be an integer between 1 and ${MAX_TIMEOUT_MS}`);
+    }
+    if (config.maxResponseBytes !== undefined &&
+        (!Number.isInteger(config.maxResponseBytes) ||
+            config.maxResponseBytes < 1024 ||
+            config.maxResponseBytes > MAX_RESPONSE_BYTES)) {
+        throw new TypeError(`maxResponseBytes must be an integer between 1024 and ${MAX_RESPONSE_BYTES}`);
+    }
+}
+export function redactSensitiveText(value) {
+    return value
+        .replace(/\b(Basic|Bearer)\s+\S+/gi, "$1 [redacted]")
+        .replace(/\b[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\b/gi, "[redacted]")
+        .replace(/\+?\d{7,15}/g, "[redacted]");
+}
+const SAFE_PATH_PARTS = new Set([
+    "",
+    "collection",
+    "disbursement",
+    "remittance",
+    "v1_0",
+    "v2_0",
+    "oauth2",
+    "token",
+    "requesttopay",
+    "requesttowithdraw",
+    "transfer",
+    "cashtransfer",
+    "deposit",
+    "refund",
+    "account",
+    "balance",
+    "accountholder",
+    "active",
+    "basicuserinfo",
+    "userinfo",
+    "bc-authorize",
+    "deliverynotification",
+    "apiuser",
+    "apikey",
+]);
+export function redactUrl(value) {
+    try {
+        const url = new URL(value);
+        url.username = "";
+        url.password = "";
+        url.search = "";
+        url.hash = "";
+        url.pathname = url.pathname
+            .split("/")
+            .map((part) => (SAFE_PATH_PARTS.has(part) ? part : "[redacted]"))
+            .join("/");
+        return url.toString();
+    }
+    catch {
+        return "[invalid-url]";
+    }
+}
+//# sourceMappingURL=security.js.map

package/lib/esm/security.js.map

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

package/lib/esm/users.d.ts

@@ -1,8 +1,9 @@
-import type { AxiosInstance } from "axios";
-import type { ApiUserInfo, Credentials } from "./common";
+import type { HttpClient } from "./httpClient.js";
+import { Environment, type ApiUserInfo, type Credentials } from "./common.js";
 export default class Users {
     private client;
-    constructor(client: AxiosInstance);
+    private environment;
+    constructor(client: HttpClient, environment?: Environment);
     /**
      * Used to create an API user in the sandbox target environment
      * @param host The provider callback host
@@ -18,5 +19,6 @@ export default class Users {
      * @param referenceId API user reference id (X-Reference-Id used at creation)
      */
     getApiUser(referenceId: string): Promise<ApiUserInfo>;
+    private assertSandbox;
 }
 //# sourceMappingURL=users.d.ts.map

package/lib/esm/users.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/users.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAG3C,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEzD,MAAM,CAAC,OAAO,OAAO,KAAK;IACxB,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,aAAa;IAIjC;;;OAGG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAe5C;;;OAGG;IACI,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAMlD;;;OAGG;IACI,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAK7D"}
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/users.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAO9E,MAAM,CAAC,OAAO,OAAO,KAAK;IACxB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,WAAW,CAAc;gBAG/B,MAAM,EAAE,UAAU,EAClB,WAAW,GAAE,WAAiC;IAMhD;;;OAGG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiB5C;;;OAGG;IACI,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAOlD;;;OAGG;IACI,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAO5D,OAAO,CAAC,aAAa;CAKtB"}

package/lib/esm/users.js

@@ -1,16 +1,20 @@
-import { v4 as uuid } from "uuid";
+import { Environment } from "./common.js";
+import { encodeStrictPathSegment, generateReferenceId, pathUuid, } from "./security.js";
 export default class Users {
-    constructor(client) {
+    constructor(client, environment = Environment.SANDBOX) {
         this.client = client;
+        this.environment = environment;
     }
     /**
      * Used to create an API user in the sandbox target environment
      * @param host The provider callback host
      */
     create(host) {
-        const userId = uuid();
+        this.assertSandbox();
+        const safeHost = encodeStrictPathSegment(host, "host");
+        const userId = generateReferenceId();
         return this.client
-            .post("/v1_0/apiuser", { providerCallbackHost: host }, {
+            .post("/v1_0/apiuser", { providerCallbackHost: decodeURIComponent(safeHost) }, {
             headers: {
                 "X-Reference-Id": userId,
             },
@@ -22,8 +26,9 @@ export default class Users {
      * @param userId
      */
     login(userId) {
+        this.assertSandbox();
         return this.client
-            .post(`/v1_0/apiuser/${userId}/apikey`)
+            .post(`/v1_0/apiuser/${pathUuid(userId, "userId")}/apikey`)
             .then((response) => response.data);
     }
     /**
@@ -31,9 +36,15 @@ export default class Users {
      * @param referenceId API user reference id (X-Reference-Id used at creation)
      */
     getApiUser(referenceId) {
+        this.assertSandbox();
         return this.client
-            .get(`/v1_0/apiuser/${referenceId}`)
+            .get(`/v1_0/apiuser/${pathUuid(referenceId)}`)
             .then((response) => response.data);
     }
+    assertSandbox() {
+        if (this.environment !== Environment.SANDBOX) {
+            throw new Error("API user provisioning is only available in sandbox");
+        }
+    }
 }
 //# sourceMappingURL=users.js.map

package/lib/esm/users.js.map

@@ -1 +1 @@
-{"version":3,"file":"users.js","sourceRoot":"","sources":["../../src/users.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,MAAM,MAAM,CAAC;AAIlC,MAAM,CAAC,OAAO,OAAO,KAAK;IAGxB,YAAY,MAAqB;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,IAAY;QACxB,MAAM,MAAM,GAAW,IAAI,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,MAAM;aACf,IAAI,CACH,eAAe,EACf,EAAE,oBAAoB,EAAE,IAAI,EAAE,EAC9B;YACE,OAAO,EAAE;gBACP,gBAAgB,EAAE,MAAM;aACzB;SACF,CACF;aACA,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,MAAc;QACzB,OAAO,IAAI,CAAC,MAAM;aACf,IAAI,CAAc,iBAAiB,MAAM,SAAS,CAAC;aACnD,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED;;;OAGG;IACI,UAAU,CAAC,WAAmB;QACnC,OAAO,IAAI,CAAC,MAAM;aACf,GAAG,CAAc,iBAAiB,WAAW,EAAE,CAAC;aAChD,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;CACF"}
+{"version":3,"file":"users.js","sourceRoot":"","sources":["../../src/users.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAsC,MAAM,aAAa,CAAC;AAC9E,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,QAAQ,GACT,MAAM,eAAe,CAAC;AAEvB,MAAM,CAAC,OAAO,OAAO,KAAK;IAIxB,YACE,MAAkB,EAClB,cAA2B,WAAW,CAAC,OAAO;QAE9C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,IAAY;QACxB,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,MAAM,QAAQ,GAAG,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,mBAAmB,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC,MAAM;aACf,IAAI,CACH,eAAe,EACf,EAAE,oBAAoB,EAAE,kBAAkB,CAAC,QAAQ,CAAC,EAAE,EACtD;YACE,OAAO,EAAE;gBACP,gBAAgB,EAAE,MAAM;aACzB;SACF,CACF;aACA,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,MAAc;QACzB,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC,MAAM;aACf,IAAI,CAAc,iBAAiB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC;aACvE,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED;;;OAGG;IACI,UAAU,CAAC,WAAmB;QACnC,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC,MAAM;aACf,GAAG,CAAc,iBAAiB,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;aAC1D,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAEO,aAAa;QACnB,IAAI,IAAI,CAAC,WAAW,KAAK,WAAW,CAAC,OAAO,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;CACF"}

package/lib/esm/validate.d.ts

@@ -1,14 +1,14 @@
-import type { PaymentRequest } from "./collections";
-import type { WithdrawalRequest, DepositRequest, RefundRequest } from "./common";
-import type { GlobalConfig, ProductConfig, SubscriptionConfig, UserConfig } from "./common";
-import type { TransferRequest } from "./disbursements";
-export declare function validateRequestToPay(paymentRequest: PaymentRequest): Promise<void>;
+import type { PaymentRequest } from "./collections.js";
+import { type CashTransferRequest, type DepositRequest, type GlobalConfig, type ProductConfig, type RefundRequest, type SubscriptionConfig, type UserConfig, type WithdrawalRequest } from "./common.js";
+import type { TransferRequest } from "./disbursements.js";
+export declare function validateRequestToPay(request: PaymentRequest): Promise<void>;
 export declare function validateWithdrawalRequest(request: WithdrawalRequest): Promise<void>;
 export declare function validateDepositRequest(request: DepositRequest): Promise<void>;
 export declare function validateRefundRequest(request: RefundRequest): Promise<void>;
-export declare function validateTransfer(payoutRequest: TransferRequest): Promise<void>;
+export declare function validateTransfer(request: TransferRequest): Promise<void>;
+export declare function validateCashTransferRequest(request: CashTransferRequest): Promise<void>;
 export declare function validateGlobalConfig(config: GlobalConfig): void;
 export declare function validateProductConfig(config: ProductConfig): void;
 export declare function validateSubscriptionConfig(config: SubscriptionConfig): void;
-export declare function validateUserConfig({ userId, userSecret }: UserConfig): void;
+export declare function validateUserConfig(config: UserConfig): void;
 //# sourceMappingURL=validate.d.ts.map

package/lib/esm/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/validate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEjF,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,UAAU,EACX,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,IAAI,CAAC,CAef;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAWnF;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAW7E;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAU3E;AAED,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,eAAe,GAC7B,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAY/D;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAGjE;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAI3E;AAED,wBAAgB,kBAAkB,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,UAAU,GAAG,IAAI,CAQ3E"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAgB1D,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9E;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAW/D;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAGjE;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAE3E;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAI3D"}