@yosle/tropipayjs 0.1.8 → 0.1.10

package/package.json

@@ -1,43 +1,43 @@
-{
-  "name": "@yosle/tropipayjs",
-  "version": "0.1.8",
-  "description": "Javascript / Typescript SDK for the Tropipay API",
-  "main": "index.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
-    "_clear": "rimraf src/dist/*",
-    "_tsc": "tsc",
-    "_make-bundle": "rollup --config",
-    "build": "yarn _clear && yarn _tsc && yarn _make-bundle"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/yosle/tropipayjs"
-  },
-  "keywords": [
-    "Javascript",
-    "Typescript",
-    "Tropipay",
-    "payments",
-    "gateway",
-    "API"
-  ],
-  "author": "Yosleivy Baez Acosta <yosle007@gmail.com>",
-  "license": "MIT",
-  "dependencies": {
-    "axios": "^0.27.2",
-    "tslib": "^2.4.0"
-  },
-  "devDependencies": {
-    "@rollup/plugin-typescript": "^8.5.0",
-    "rimraf": "^3.0.2",
-    "rollup": "^2.79.1",
-    "rollup-plugin-dts": "^4.2.2",
-    "run-s": "^0.0.0",
-    "typescript": "^5.0.4"
-  },
-  "funding": {
-    "type": "individual",
-    "url": "https://tppay.me/l94qaa3h"
-  }
-}
+{
+  "name": "@yosle/tropipayjs",
+  "version": "0.1.10",
+  "description": "Javascript / Typescript SDK for the Tropipay API",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "_clear": "rimraf src/dist/*",
+    "_tsc": "tsc",
+    "_make-bundle": "rollup --config",
+    "build": "yarn _clear && yarn _tsc && yarn _make-bundle"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yosle/tropipayjs"
+  },
+  "keywords": [
+    "Javascript",
+    "Typescript",
+    "Tropipay",
+    "payments",
+    "gateway",
+    "API"
+  ],
+  "author": "Yosleivy Baez Acosta <yosle007@gmail.com>",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^0.27.2",
+    "tslib": "^2.4.0"
+  },
+  "devDependencies": {
+    "@rollup/plugin-typescript": "^8.5.0",
+    "rimraf": "^3.0.2",
+    "rollup": "^2.79.1",
+    "rollup-plugin-dts": "^4.2.2",
+    "run-s": "^0.0.0",
+    "typescript": "^5.0.4"
+  },
+  "funding": {
+    "type": "individual",
+    "url": "https://tppay.me/l94qaa3h"
+  }
+}

package/rollup.config.js

@@ -1,23 +1,24 @@
-// Contents of the file /rollup.config.js
-import typescript from '@rollup/plugin-typescript';
-import dts from "rollup-plugin-dts";
-const config = [
-    {
-        input: 'dist/index.js',
-        output: {
-            file: 'index.js',
-            format: 'cjs',
-            sourcemap: true,
-        },
-        external: ['axios'],
-        plugins: [typescript()]
-    }, {
-        input: 'dist/index.d.ts',
-        output: {
-            file: 'index.d.ts',
-            format: 'es'
-        },
-        plugins: [dts()]
-    }
-];
-export default config;
+// Contents of the file /rollup.config.js
+import typescript from "@rollup/plugin-typescript";
+import dts from "rollup-plugin-dts";
+const config = [
+  {
+    input: "dist/index.js",
+    output: {
+      file: "index.js",
+      format: "cjs",
+      sourcemap: true,
+    },
+    external: ["axios", "crypto"],
+    plugins: [typescript()],
+  },
+  {
+    input: "dist/index.d.ts",
+    output: {
+      file: "index.d.ts",
+      format: "es",
+    },
+    plugins: [dts()],
+  },
+];
+export default config;

package/src/api/TropipayAPI.ts

@@ -0,0 +1,319 @@
+/**
+ * Tropipayjs is a Typescript/Javascript library for the Tropipay API.
+ *
+ * @author Yosleivy Baez Acosta
+ *
+ */
+
+import axios, { Axios } from "axios";
+import {
+  TropipayConfig,
+  AccountBalance,
+  Country,
+  PaymentLinkPayload,
+  PaymentLink,
+  mediationPaymentCardConfig,
+  LoginResponse,
+  AccountDeposits,
+} from "../interfaces";
+type ServerMode = "Development" | "Production";
+import { TropipayHooks } from "../hooks/TropipayHooks";
+export class Tropipay {
+  readonly clientId: string;
+  readonly clientSecret: string;
+  public request: Axios;
+  public static accessToken: string | undefined;
+  public static refreshToken: string | undefined;
+  public serverMode: ServerMode;
+  public hooks: TropipayHooks;
+
+  constructor(config: TropipayConfig) {
+    this.clientId = config.clientId;
+    this.clientSecret = config.clientSecret;
+    this.serverMode = config.serverMode || "Development";
+    this.request = axios.create({
+      baseURL:
+        this.serverMode === "Production"
+          ? "https://www.tropipay.com"
+          : "https://tropipay-dev.herokuapp.com",
+      headers: {
+        "Content-Type": "application/json",
+        Accept: "application/json",
+        Authorization: `Bearer ${Tropipay.accessToken}`,
+      },
+    });
+    this.hooks = new TropipayHooks(this);
+  }
+
+  public async login() {
+    try {
+      const { data } = await this.request.post<LoginResponse>(
+        "/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",
+        },
+        {
+          headers: {
+            "Content-Type": "application/json",
+            Accept: "application/json",
+          },
+        }
+      );
+
+      Tropipay.accessToken = data.access_token;
+      Tropipay.refreshToken = data.refresh_token;
+      return data;
+    } catch (error) {
+      if (axios.isAxiosError(error)) {
+        throw new Error(
+          `Could not obtain the access token from credentials  ${error}`
+        );
+      }
+      throw new Error(
+        `Could not obtain the access token from credentials  ${error}`
+      );
+    }
+  }
+
+  /**
+   * Create a paymentLink with the specified options.
+   * @param payload PaymentLinkPayload Object.
+   * @returns Promise<PaymentLink> or throws an Exception.
+   * @see https://tpp.stoplight.io/docs/tropipay-api-doc/b3A6ODgyNTM3OQ-create-a-new-pay-link-charge
+   */
+  async createPaymentCard(payload: PaymentLinkPayload): Promise<PaymentLink> {
+    if (!Tropipay.accessToken) {
+      await this.login();
+    }
+    try {
+      const paylink = await this.request.post("/api/v2/paymentcards", payload, {
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${Tropipay.accessToken}`,
+          Accept: "application/json",
+        },
+      });
+      return paylink.data as PaymentLink;
+    } catch (error) {
+      throw new Error(
+        `Could not obtain the access token with the given credentials.`
+      );
+    }
+  }
+
+  /**
+   * Get all deposits in this account.
+   * @returns A Promise of an Array of AccountDeposits or throws an Exception
+   * @see https://tpp.stoplight.io/docs/tropipay-api-doc/b3A6OTgyOTQ1Mg-get-deposit-accounts-list
+   */
+  async getDepositAccounts(): Promise<AccountDeposits[] | Error> {
+    if (!Tropipay.accessToken) {
+      await this.login();
+    }
+    try {
+      const deposits = await this.request.get("/api/v2/deposit_accounts", {
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${Tropipay.accessToken}`,
+          Accept: "application/json",
+        },
+      });
+      return deposits.data;
+    } catch (error) {
+      throw new Error(`Could not retrieve the account deposits ${error}`);
+    }
+  }
+
+  /**
+   * Get the list of all supported countries by Tropipay.
+   * @returns Array of Countries Data
+   * @see https://tpp.stoplight.io/docs/tropipay-api-doc/bfac21259e2ff-getting-users-countries-list
+   */
+  async countries(): Promise<Country[]> {
+    try {
+      const countries = await this.request.get("/api/v2/countries");
+      return countries.data;
+    } catch (error) {
+      throw new Error(`Could not retrieve the countries list`);
+    }
+  }
+  /**
+   * Get user balance
+   * @returns balance Object { balance: number, pendingIn: number, pendingOut: number }
+   */
+  async getBalance(): Promise<AccountBalance> {
+    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`
+      );
+    }
+  }
+
+  /**
+   * Get the list of all detination countries supported by Tropipay.
+   * Obtaining the list of valid countries to send funds to. Useful
+   * when adding new beneficiaries to some user.
+   *
+   * @returns Array of Country Objects
+   * @see https://tpp.stoplight.io/docs/tropipay-api-doc/3cfe5504f0524-getting-list-of-beneficiary-countries
+   */
+  async destinations(): Promise<Country[]> {
+    try {
+      const countries = await this.request.get(
+        "/api/v2/countries/destinations"
+      );
+      return countries.data;
+    } catch (error) {
+      throw new Error(`Could not retrieve the destination countries list`);
+    }
+  }
+
+  /**
+   * Get list of all the favorites payment links.
+   * @returns Array of account Object or throws an error
+   */
+  async favorites() {
+    if (!Tropipay.accessToken) {
+      await this.login();
+    }
+    try {
+      const favoritesList = await this.request.get(
+        "/api/v2/paymentcards/favorites",
+        {
+          headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${Tropipay.accessToken}`,
+            Accept: "application/json",
+          },
+        }
+      );
+      return favoritesList?.data?.rows;
+    } catch (error) {
+      throw new Error(`Could not retrieve favorites list ${error}`);
+    }
+  }
+
+  /**
+   * List all account movements. You can optionaly specify
+   * offset and limit params for pagination.
+   * @returns
+   */
+  async movements(offset = 0, limit = 10) {
+    if (!Tropipay.accessToken) await this.login();
+
+    try {
+      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}`,
+        },
+      });
+      return movements.data;
+    } catch (error) {
+      throw new Error(`Could not retrieve movements list ${error}`);
+    }
+  }
+
+  /**
+   * Return profile data for this account.
+   * @returns
+   */
+  async profile() {
+    if (!Tropipay.accessToken) await this.login();
+    try {
+      const profile = await this.request.get("/api/users/profile");
+      return profile.data;
+    } catch (error) {
+      throw new Error(`Could not retrieve movements list ${error}`);
+    }
+  }
+
+  /**
+   * Obtain current Tropipay conversion rate. For example USD to EUR
+   * targetCurrency must be 'EUR'
+   * @param originCurrency Target currency code supported by Tropipay.
+   * @param targetCurrency Must be 'EUR'? (not documented by Tropipay)
+   * @returns Conversion rate (number)
+   * @see https://tpp.stoplight.io/docs/tropipay-api-doc/85163f6f28b23-get-rate
+   */
+  async rates(
+    originCurrency: string,
+    targetCurrency: string = "EUR"
+  ): Promise<number | Error> {
+    if (!Tropipay.accessToken) {
+      await this.login();
+    }
+    try {
+      const rates = await this.request.post(
+        "/api/v2/movements/get_rate",
+        {
+          currencyFrom: originCurrency,
+          currencyTo: targetCurrency,
+        },
+        {
+          headers: {
+            "Content-Type": "application/json",
+            Accept: "application/json",
+            Authorization: `Bearer ${Tropipay.accessToken}`,
+          },
+        }
+      );
+      return rates.data.rate;
+    } catch (error) {
+      throw new Error(`Could not retrieve rates ${error}`);
+    }
+  }
+
+  /**
+   * (ONLY in Bussiness Accounts)
+   * An escrow payment link. This allows a payment to be made to persons
+   * belonging or not to the TropiPay platform with the particularity
+   * that the payment will be held in custody or retained until it is
+   * released with the approval of the payer.
+   * @see https://tpp.stoplight.io/docs/tropipay-api-doc/12a128ff971e4-creating-a-mediation-payment-card
+   * @param config Payload with the payment details
+   */
+  async createMediationPaymentCard(
+    config: mediationPaymentCardConfig
+  ): Promise<PaymentLink> {
+    if (!Tropipay.accessToken) await this.login();
+    try {
+      const mediation = await this.request.post(
+        "/api/v2/paymentcards/mediation",
+        config,
+        {
+          headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${Tropipay.accessToken}`,
+            Accept: "application/json",
+          },
+        }
+      );
+      return mediation.data as PaymentLink;
+    } catch (error) {
+      throw new Error(`Could not generate mediation paymentCard ${error}`);
+    }
+  }
+}
+
+export class ClientSideUtils {
+  constructor(tropipayInstance: Tropipay) {}
+}

package/src/config/TropipayConfig.ts

@@ -0,0 +1,2 @@
+import { ServerMode } from "../constants/TropipayConstants";
+export const SERVER_MODE: ServerMode = "Development"; // Move the constant here

package/src/constants/TropipayConstants.ts

@@ -0,0 +1 @@
+export type ServerMode = "Development" | "Production";

package/src/hooks/TropipayHooks.ts

@@ -0,0 +1,52 @@
+import { HookEventType, UserHookSubscribed } from "../interfaces";
+import { Tropipay } from "../api/TropipayAPI";
+export class TropipayHooks {
+  private tropipay: Tropipay;
+  // ... hook-related functionality ...
+  constructor(tropipayInstance: Tropipay) {
+    this.tropipay = tropipayInstance;
+  }
+
+  public static async subscribeHook(
+    eventType: HookEventType,
+    target: string,
+    value: string
+  ) {}
+  /**
+   * 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
+   */
+  public async getSubscribedHook(
+    eventType?: HookEventType
+  ): Promise<UserHookSubscribed[]> {
+    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}`);
+    }
+  }
+  public async updateSubscribedHook(eventType?: string) {
+    //TODO
+    throw new Error("Not implementet yet");
+  }
+  async deleteSubscribedHook(eventType?: string) {
+    //TODO
+    throw new Error("Not implementet yet");
+  }
+}