tranzak-node/compat/api/payment/collection/simple/index.js

TRANZAK API client for Nodejs

"use strict";

Object.defineProperty(exports, "__esModule", {
  value: true
});
exports.default = void 0;
var _section = _interopRequireWildcard(require("../../../../lib/section.js"));
var _transaction = _interopRequireDefault(require("./transaction.js"));
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
/**
 * Copyright 2023 HolyCorn Software
 * The tranzak-node library
 * This section (simple) of the library, deals with simple collections where all money goes to a single destination once
 */

class SimpleCollectionSection extends _section.default {
  /**
   * This method creates a charge in order to receive money via Mobile Money.
   * @param {tranzak_node.payment.collection.simple.MobileMoneyChargeParams} data 
   * 
   */
  async chargeMobileMoney(data) {
    return new _transaction.default(await this[_section.transport].request({
      path: 'request/create-mobile-wallet-charge',
      body: data,
      method: 'POST'
    }), this[_section.transport]);
  }

  /**
   * This method creates a web redirect transaction.
   * @param {tranzak_node.payment.collection.simple.WebRedirectChargeParams} data 
   * 
   */
  async chargeByWebRedirect(data) {
    return new _transaction.default(await this[_section.transport].request({
      path: 'request/create',
      body: data,
      method: 'POST'
    }), this[_section.transport]);
  }

  /**
   * Creates a direct charge using QR Code obtained from Tranzak mobile app. 
   * 
   * The request will be pushed directly to the user for authorization. 
   * 
   * ### To prevent abuse, access to this service will be **disabled** after 10 failed attempts.
   * @param {tranzak_node.payment.collection.simple.QRChargeParams} data 
   * 
   */
  async chargeByQR(data) {
    return new _transaction.default(await this[_section.transport].request({
      path: 'request/create-in-store-charge',
      body: data,
      method: 'POST'
    }), this[_section.transport]);
  }

  /**
   * This function returns the previous transactions, as an Async Iterable.
   * 
   * 
   * This means, you're **NOT** expecting a flat array, but an object that can be consumed in a **for loop**, or with the **spread operator**.
   * ***
   * For Example,
   * 
   * ```js
   * const myApiClient = new TRANZAK(...blablabla)
   * const transactions = await myApiClient.payment.collection.simple.history()
   * for await (const item of transactions){
   *      console.log(`A transaction `, item.data)
   *  }
   * 
   * ```
   * ***
   * 
   * To better familiarize yourself with the concept of the AsyncGenerator, you can lookup the [documentation](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/AsyncGenerator).
   * 
   */
  async history() {
    return await this[_section.transport].paginatedRequest({
      path: `request/history`,
      /**
       * 
       * @param {tranzak_node.payment.collection.simple.Transaction} data 
       */
      transform: data => new _transaction.default(data, this[_section.transport])
    });
  }

  /**
   * This method retrieves a single transaction
   * @param {tranzak_node.payment.collection.simple.TransactionSearch} search 
   * @returns {Promise<SimpleCollectionTransaction>}
   */
  async find(search) {
    const transaction = await new _transaction.default(search, this[_section.transport]);
    await transaction.refresh();
    return transaction;
  }
}
exports.default = SimpleCollectionSection;