@yosle/tropipayjs 0.1.8 → 0.1.10

package/index.d.ts

@@ -1,5 +1,41 @@
 import { Axios } from 'axios';
 
+type ServerMode$1 = "Development" | "Production";
+
+type AccountBalance = {
+    balance: number;
+    pendingIn: number;
+    pendingOut: number;
+};
+interface TropipayConfig {
+    clientId: string;
+    clientSecret: string;
+    serverMode?: ServerMode$1;
+}
+type TropipayCredentials = {
+    clientId: string;
+    clientSecret: string;
+};
+type HookEventType = "transaction_completed" | "transaction_charged" | "transaction_guarded";
+type HookTargetType = "web" | "email";
+interface UserHook {
+    event: HookEventType;
+    target: string;
+    value: string;
+}
+interface UserHook {
+    event: HookEventType;
+    target: string;
+    value: string;
+}
+interface UserHookSubscribed extends UserHook {
+    createdAt: string;
+    updatedAt: string;
+}
+interface UserHookSubscribed extends UserHook {
+    createdAt: string;
+    updatedAt: string;
+}
 interface PaymentLinkPayload {
     reference: string;
     concept: string;
@@ -36,10 +72,6 @@ interface PaymentLink extends PaymentLinkPayload {
     shortUrl: string;
     paymentUrl: string;
 }
-
-/**
- *
- */
 interface mediationPaymentCardConfig {
     amount: number;
     currency: "EUR" | "USD";
@@ -59,6 +91,91 @@ interface mediationPaymentCardConfig {
     feeFixed?: number;
     sendMail: boolean;
 }
+type LoginResponse = {
+    access_token: string;
+    refresh_token: string;
+    token_type: "Bearer";
+    expires_in: number;
+    scope: string;
+};
+type LoginError = {
+    error: string;
+};
+type Country = {
+    id: number;
+    name: string;
+    sepaZone: boolean;
+    state: number;
+    slug: string;
+    slugn: number;
+    callingCode: number;
+    isDestination: boolean;
+    isRisky: boolean;
+    currentCurrency: string | null;
+    createdAt: string;
+    updatedAt: string;
+    isFavorite: boolean;
+    position: any;
+};
+type Deposit = {
+    id: number;
+    accountNumber: string;
+    alias: string;
+    swift: string;
+    type: number;
+    country: number | null;
+    firstName: string;
+    default: null;
+    state: number;
+    userId: string;
+    countryDestinationId: number;
+    lastName: string;
+    documentNumber: number;
+    userRelationTypeId: number;
+    city: string;
+    postalCode: string;
+    address: string;
+    phone: string;
+    checked: boolean;
+    province: string;
+    beneficiaryType: number;
+    relatedUserId: null | string;
+    currency: string;
+    correspondent?: any;
+    location: any;
+    office: any;
+    officeValue: any;
+    paymentType: number;
+    paymentEntityBeneficiaryId: number;
+    paymentEntityAccountId: number;
+    verified: any;
+    paymentEntityInfo: any;
+    documentTypeId: any;
+    documentExpirationDate: Date;
+    createdAt: Date;
+    updatedAt: Date;
+    countryDestination: Country;
+};
+type AccountDeposits = {
+    count: number;
+    rows: Deposit[];
+};
+
+declare class TropipayHooks {
+    private tropipay;
+    constructor(tropipayInstance: Tropipay);
+    static subscribeHook(eventType: HookEventType, target: string, value: string): Promise<void>;
+    /**
+     * Get hook the sucbcribed hook info by his eventType.
+     * If no eventType is passed it will return
+     * all subscribed hooks or empty Array if none hooks exist.
+     * @param eventType or no params for retrieving all hooks
+     * @returns
+     */
+    getSubscribedHook(eventType?: HookEventType): Promise<UserHookSubscribed[]>;
+    updateSubscribedHook(eventType?: string): Promise<void>;
+    deleteSubscribedHook(eventType?: string): Promise<void>;
+}
 
 /**
  * Tropipayjs is a Typescript/Javascript library for the Tropipay API.
@@ -67,19 +184,16 @@ interface mediationPaymentCardConfig {
  *
  */
 
-type ServerMode = 'Development' | 'Production';
-interface TropipayConfig {
-    clientId: string;
-    clientSecret: string;
-    serverMode?: ServerMode;
-}
+type ServerMode = "Development" | "Production";
+
 declare class Tropipay {
-    protected clientId: string;
-    protected clientSecret: string;
-    protected request: Axios;
-    protected static accessToken: string | undefined;
-    protected static refreshToken: string | undefined;
-    protected serverMode: ServerMode;
+    readonly clientId: string;
+    readonly clientSecret: string;
+    request: Axios;
+    static accessToken: string | undefined;
+    static refreshToken: string | undefined;
+    serverMode: ServerMode;
+    hooks: TropipayHooks;
     constructor(config: TropipayConfig);
     login(): Promise<LoginResponse>;
     /**
@@ -101,6 +215,11 @@ declare class Tropipay {
      * @see https://tpp.stoplight.io/docs/tropipay-api-doc/bfac21259e2ff-getting-users-countries-list
      */
     countries(): Promise<Country[]>;
+    /**
+     * Get user balance
+     * @returns balance Object { balance: number, pendingIn: number, pendingOut: number }
+     */
+    getBalance(): Promise<AccountBalance>;
     /**
      * Get the list of all detination countries supported by Tropipay.
      * Obtaining the list of valid countries to send funds to. Useful
@@ -146,5 +265,27 @@ declare class Tropipay {
      */
     createMediationPaymentCard(config: mediationPaymentCardConfig): Promise<PaymentLink>;
 }
+declare class ClientSideUtils {
+    constructor(tropipayInstance: Tropipay);
+}
+
+declare class ServerSideUtils {
+    private tropipay;
+    constructor(tropipayInstance: Tropipay);
+    /**
+     * Verify Topipay's signature on webhooks.
+     * @param credentials Credential object or Tropipay instance
+     * @param {String} originalCurrencyAmount
+     * @param bankOrderCode
+     * @param signature
+     * @returns {Boolean}
+     */
+    static verifySignature(credentials: {
+        clientId: string;
+        clientSecret: string;
+    } | Tropipay, originalCurrencyAmount: string, bankOrderCode: string, signature: string): boolean;
+}
+
+declare const SERVER_MODE: ServerMode$1;
 
-export { Tropipay };
+export { AccountBalance, AccountDeposits, ClientSideUtils, Country, Deposit, HookEventType, HookTargetType, LoginError, LoginResponse, PaymentLink, PaymentLinkPayload, SERVER_MODE, ServerMode$1 as ServerMode, ServerSideUtils, Tropipay, TropipayConfig, TropipayCredentials, TropipayHooks, UserHook, UserHookSubscribed, mediationPaymentCardConfig };

package/index.js

@@ -3,10 +3,72 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var axios = require('axios');
+var crypto = require('crypto');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
+function _interopNamespace(e) {
+    if (e && e.__esModule) return e;
+    var n = Object.create(null);
+    if (e) {
+        Object.keys(e).forEach(function (k) {
+            if (k !== 'default') {
+                var d = Object.getOwnPropertyDescriptor(e, k);
+                Object.defineProperty(n, k, d.get ? d : {
+                    enumerable: true,
+                    get: function () { return e[k]; }
+                });
+            }
+        });
+    }
+    n["default"] = e;
+    return Object.freeze(n);
+}
+
 var axios__default = /*#__PURE__*/_interopDefaultLegacy(axios);
+var crypto__namespace = /*#__PURE__*/_interopNamespace(crypto);
+
+class TropipayHooks {
+    tropipay;
+    // ... hook-related functionality ...
+    constructor(tropipayInstance) {
+        this.tropipay = tropipayInstance;
+    }
+    static async subscribeHook(eventType, target, value) { }
+    /**
+     * Get hook the sucbcribed hook info by his eventType.
+     * If no eventType is passed it will return
+     * all subscribed hooks or empty Array if none hooks exist.
+     * @param eventType or no params for retrieving all hooks
+     * @returns
+     */
+    async getSubscribedHook(eventType) {
+        if (!Tropipay.accessToken) {
+            await this.tropipay.login();
+        }
+        try {
+            const hooks = await this.tropipay.request.get(`/api/v2/hooks/${eventType || ""}`, {
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${Tropipay.accessToken}`,
+                    Accept: "application/json",
+                },
+            });
+            return hooks.data;
+        }
+        catch (error) {
+            throw new Error(`Could not get subscribed hooks ${error}`);
+        }
+    }
+    async updateSubscribedHook(eventType) {
+        //TODO
+        throw new Error("Not implementet yet");
+    }
+    async deleteSubscribedHook(eventType) {
+        //TODO
+        throw new Error("Not implementet yet");
+    }
+}
 
 /**
  * Tropipayjs is a Typescript/Javascript library for the Tropipay API.
@@ -21,33 +83,35 @@ class Tropipay {
     static accessToken;
     static refreshToken;
     serverMode;
+    hooks;
     constructor(config) {
         this.clientId = config.clientId;
         this.clientSecret = config.clientSecret;
-        this.serverMode = config.serverMode || 'Development';
+        this.serverMode = config.serverMode || "Development";
         this.request = axios__default["default"].create({
-            baseURL: this.serverMode === 'Production'
-                ? 'https://www.tropipay.com'
-                : 'https://tropipay-dev.herokuapp.com',
+            baseURL: this.serverMode === "Production"
+                ? "https://www.tropipay.com"
+                : "https://tropipay-dev.herokuapp.com",
             headers: {
-                'Content-Type': 'application/json',
-                Accept: 'application/json',
+                "Content-Type": "application/json",
+                Accept: "application/json",
                 Authorization: `Bearer ${Tropipay.accessToken}`,
-            }
+            },
         });
+        this.hooks = new TropipayHooks(this);
     }
     async login() {
         try {
-            const { data } = await this.request.post('/api/v2/access/token', {
+            const { data } = await this.request.post("/api/v2/access/token", {
                 client_id: this.clientId,
                 client_secret: this.clientSecret,
                 grant_type: "client_credentials",
-                scope: "ALLOW_GET_PROFILE_DATA ALLOW_PAYMENT_IN ALLOW_EXTERNAL_CHARGE KYC3_FULL_ALLOW ALLOW_PAYMENT_OUT ALLOW_MARKET_PURCHASES ALLOW_GET_BALANCE ALLOW_GET_MOVEMENT_LIST ALLOW_GET_CREDENTIAL"
+                scope: "ALLOW_GET_PROFILE_DATA ALLOW_PAYMENT_IN ALLOW_EXTERNAL_CHARGE KYC3_FULL_ALLOW ALLOW_PAYMENT_OUT ALLOW_MARKET_PURCHASES ALLOW_GET_BALANCE ALLOW_GET_MOVEMENT_LIST ALLOW_GET_CREDENTIAL",
             }, {
                 headers: {
-                    'Content-Type': 'application/json',
-                    Accept: 'application/json',
-                }
+                    "Content-Type": "application/json",
+                    Accept: "application/json",
+                },
             });
             Tropipay.accessToken = data.access_token;
             Tropipay.refreshToken = data.refresh_token;
@@ -71,12 +135,12 @@ class Tropipay {
             await this.login();
         }
         try {
-            const paylink = await this.request.post('/api/v2/paymentcards', payload, {
+            const paylink = await this.request.post("/api/v2/paymentcards", payload, {
                 headers: {
-                    'Content-Type': 'application/json',
+                    "Content-Type": "application/json",
                     Authorization: `Bearer ${Tropipay.accessToken}`,
-                    Accept: 'application/json'
-                }
+                    Accept: "application/json",
+                },
             });
             return paylink.data;
         }
@@ -94,12 +158,12 @@ class Tropipay {
             await this.login();
         }
         try {
-            const deposits = await this.request.get('/api/v2/deposit_accounts', {
+            const deposits = await this.request.get("/api/v2/deposit_accounts", {
                 headers: {
-                    'Content-Type': 'application/json',
+                    "Content-Type": "application/json",
                     Authorization: `Bearer ${Tropipay.accessToken}`,
-                    Accept: 'application/json'
-                }
+                    Accept: "application/json",
+                },
             });
             return deposits.data;
         }
@@ -114,11 +178,33 @@ class Tropipay {
      */
     async countries() {
         try {
-            const countries = await this.request.get('/api/v2/countries');
+            const countries = await this.request.get("/api/v2/countries");
             return countries.data;
         }
         catch (error) {
-            throw new Error(`TropipayJS Error - Could not retrieve the countries list`);
+            throw new Error(`Could not retrieve the countries list`);
+        }
+    }
+    /**
+     * Get user balance
+     * @returns balance Object { balance: number, pendingIn: number, pendingOut: number }
+     */
+    async getBalance() {
+        if (!Tropipay.accessToken) {
+            await this.login();
+        }
+        try {
+            const balance = await this.request.get("/api/v2/users/balance", {
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${Tropipay.accessToken}`,
+                    Accept: "application/json",
+                },
+            });
+            return balance.data;
+        }
+        catch (error) {
+            throw new Error(`TropipayJS Error - Could not retrieve the user's balance`);
         }
     }
     /**
@@ -131,7 +217,7 @@ class Tropipay {
      */
     async destinations() {
         try {
-            const countries = await this.request.get('/api/v2/countries/destinations');
+            const countries = await this.request.get("/api/v2/countries/destinations");
             return countries.data;
         }
         catch (error) {
@@ -147,12 +233,12 @@ class Tropipay {
             await this.login();
         }
         try {
-            const favoritesList = await this.request.get('/api/v2/paymentcards/favorites', {
+            const favoritesList = await this.request.get("/api/v2/paymentcards/favorites", {
                 headers: {
-                    'Content-Type': 'application/json',
+                    "Content-Type": "application/json",
                     Authorization: `Bearer ${Tropipay.accessToken}`,
-                    Accept: 'application/json'
-                }
+                    Accept: "application/json",
+                },
             });
             return favoritesList?.data?.rows;
         }
@@ -169,13 +255,13 @@ class Tropipay {
         if (!Tropipay.accessToken)
             await this.login();
         try {
-            const movements = await this.request.get('/api/v2/movements', {
+            const movements = await this.request.get("/api/v2/movements", {
                 params: { limit: limit, offset: offset },
                 headers: {
-                    'Content-Type': 'application/json',
-                    Accept: 'application/json',
-                    Authorization: `Bearer ${Tropipay.accessToken}`
-                }
+                    "Content-Type": "application/json",
+                    Accept: "application/json",
+                    Authorization: `Bearer ${Tropipay.accessToken}`,
+                },
             });
             return movements.data;
         }
@@ -191,7 +277,7 @@ class Tropipay {
         if (!Tropipay.accessToken)
             await this.login();
         try {
-            const profile = await this.request.get('/api/users/profile');
+            const profile = await this.request.get("/api/users/profile");
             return profile.data;
         }
         catch (error) {
@@ -206,20 +292,20 @@ class Tropipay {
      * @returns Conversion rate (number)
      * @see https://tpp.stoplight.io/docs/tropipay-api-doc/85163f6f28b23-get-rate
      */
-    async rates(originCurrency, targetCurrency = 'EUR') {
+    async rates(originCurrency, targetCurrency = "EUR") {
         if (!Tropipay.accessToken) {
             await this.login();
         }
         try {
-            const rates = await this.request.post('/api/v2/movements/get_rate', {
+            const rates = await this.request.post("/api/v2/movements/get_rate", {
                 currencyFrom: originCurrency,
-                currencyTo: targetCurrency
+                currencyTo: targetCurrency,
             }, {
                 headers: {
-                    'Content-Type': 'application/json',
-                    Accept: 'application/json',
+                    "Content-Type": "application/json",
+                    Accept: "application/json",
                     Authorization: `Bearer ${Tropipay.accessToken}`,
-                }
+                },
             });
             return rates.data.rate;
         }
@@ -240,12 +326,12 @@ class Tropipay {
         if (!Tropipay.accessToken)
             await this.login();
         try {
-            const mediation = await this.request.post('/api/v2/paymentcards/mediation', config, {
+            const mediation = await this.request.post("/api/v2/paymentcards/mediation", config, {
                 headers: {
-                    'Content-Type': 'application/json',
+                    "Content-Type": "application/json",
                     Authorization: `Bearer ${Tropipay.accessToken}`,
-                    Accept: 'application/json'
-                }
+                    Accept: "application/json",
+                },
             });
             return mediation.data;
         }
@@ -254,6 +340,43 @@ class Tropipay {
         }
     }
 }
+class ClientSideUtils {
+    constructor(tropipayInstance) { }
+}
+
+class ServerSideUtils {
+    tropipay;
+    constructor(tropipayInstance) {
+        this.tropipay = tropipayInstance;
+    }
+    /**
+     * Verify Topipay's signature on webhooks.
+     * @param credentials Credential object or Tropipay instance
+     * @param {String} originalCurrencyAmount
+     * @param bankOrderCode
+     * @param signature
+     * @returns {Boolean}
+     */
+    static verifySignature(credentials, originalCurrencyAmount, bankOrderCode, signature) {
+        const localSignature = crypto__namespace
+            .createHash("sha256")
+            .update(bankOrderCode +
+            credentials.clientId +
+            crypto__namespace
+                .createHash("sha1")
+                .update(credentials.clientSecret)
+                .digest("hex") +
+            originalCurrencyAmount)
+            .digest("hex");
+        return localSignature === signature;
+    }
+}
+
+const SERVER_MODE = "Development"; // Move the constant here
 
+exports.ClientSideUtils = ClientSideUtils;
+exports.SERVER_MODE = SERVER_MODE;
+exports.ServerSideUtils = ServerSideUtils;
 exports.Tropipay = Tropipay;
+exports.TropipayHooks = TropipayHooks;
 //# sourceMappingURL=index.js.map

package/interfaces/index.d.ts

@@ -1,2 +1,159 @@
-import * as countries from './countries';
-export { countries };
+import { ServerMode } from "../constants/TropipayConstants";
+export type AccountBalance = {
+    balance: number;
+    pendingIn: number;
+    pendingOut: number;
+};
+export interface TropipayConfig {
+    clientId: string;
+    clientSecret: string;
+    serverMode?: ServerMode;
+}
+export type TropipayCredentials = {
+    clientId: string;
+    clientSecret: string;
+};
+export type HookEventType = "transaction_completed" | "transaction_charged" | "transaction_guarded";
+export type HookTargetType = "web" | "email";
+export interface UserHook {
+    event: HookEventType;
+    target: string;
+    value: string;
+}
+export interface UserHookSubscribed extends UserHook {
+    createdAt: string;
+    updatedAt: string;
+}
+export interface UserHook {
+    event: HookEventType;
+    target: string;
+    value: string;
+}
+export interface UserHookSubscribed extends UserHook {
+    createdAt: string;
+    updatedAt: string;
+}
+export interface PaymentLinkPayload {
+    reference: string;
+    concept: string;
+    favorite: boolean;
+    amount: number;
+    currency: string;
+    description: string;
+    singleUse: boolean;
+    reasonId: number;
+    expirationDays: number;
+    lang: string;
+    urlSuccess: string;
+    urlFailed: string;
+    urlNotification: string;
+    serviceDate: string;
+    client: {
+        name: string;
+        lastName: string;
+        address: string;
+        phone: string;
+        email: string;
+        countryId: number;
+        termsAndConditions: boolean;
+    };
+    directPayment: boolean;
+    paymentMethods?: string[];
+}
+export interface PaymentLink extends PaymentLinkPayload {
+    expirationDate: string;
+    hasClient: boolean;
+    updatedAt: string;
+    createdAt: string;
+    qrImage: string;
+    shortUrl: string;
+    paymentUrl: string;
+}
+export interface mediationPaymentCardConfig {
+    amount: number;
+    currency: "EUR" | "USD";
+    concept: string;
+    description: string;
+    reference: string;
+    singleUse: boolean;
+    lang: string;
+    productUrl?: string;
+    buyer: null | any;
+    seller: {
+        sellerId?: number;
+        type?: number;
+        email?: string;
+    };
+    feePercent?: number;
+    feeFixed?: number;
+    sendMail: boolean;
+}
+export type LoginResponse = {
+    access_token: string;
+    refresh_token: string;
+    token_type: "Bearer";
+    expires_in: number;
+    scope: string;
+};
+export type LoginError = {
+    error: string;
+};
+export type Country = {
+    id: number;
+    name: string;
+    sepaZone: boolean;
+    state: number;
+    slug: string;
+    slugn: number;
+    callingCode: number;
+    isDestination: boolean;
+    isRisky: boolean;
+    currentCurrency: string | null;
+    createdAt: string;
+    updatedAt: string;
+    isFavorite: boolean;
+    position: any;
+};
+export type Deposit = {
+    id: number;
+    accountNumber: string;
+    alias: string;
+    swift: string;
+    type: number;
+    country: number | null;
+    firstName: string;
+    default: null;
+    state: number;
+    userId: string;
+    countryDestinationId: number;
+    lastName: string;
+    documentNumber: number;
+    userRelationTypeId: number;
+    city: string;
+    postalCode: string;
+    address: string;
+    phone: string;
+    checked: boolean;
+    province: string;
+    beneficiaryType: number;
+    relatedUserId: null | string;
+    currency: string;
+    correspondent?: any;
+    location: any;
+    office: any;
+    officeValue: any;
+    paymentType: number;
+    paymentEntityBeneficiaryId: number;
+    paymentEntityAccountId: number;
+    verified: any;
+    paymentEntityInfo: any;
+    documentTypeId: any;
+    documentExpirationDate: Date;
+    createdAt: Date;
+    updatedAt: Date;
+    countryDestination: Country;
+};
+export type AccountDeposits = {
+    count: number;
+    rows: Deposit[];
+};