@openfn/language-monnify 1.0.0

package/configuration-schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "properties": {
+    "baseUrl": {
+      "title": "Base URL",
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "The base URL",
+      "format": "uri",
+      "minLength": 1,
+      "examples": ["https://sandbox.monnify.com"]
+    },
+    "apiKey": {
+      "title": "API Key",
+      "type": "string",
+      "description": "This is required together with your secret key to generate your bearer token",
+      "examples": ["MK_TEST_YRP3AJ7RQ2"]
+    },
+    "secretKey": {
+      "title": "Secret key",
+      "type": "string",
+      "description": "The secret key is used to authorize all your API calls on Monnify.",
+      "writeOnly": true,
+      "examples": ["JKML52W7XQ43L02VRFDNQ8KLAU459W8B"]
+    }
+  },
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["baseUrl","apiKey", "secretKey"]
+}

package/dist/index.cjs

@@ -0,0 +1,242 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.js
+var src_exports = {};
+__export(src_exports, {
+  as: () => import_language_common2.as,
+  combine: () => import_language_common2.combine,
+  cursor: () => import_language_common2.cursor,
+  dataPath: () => import_language_common2.dataPath,
+  dataValue: () => import_language_common2.dataValue,
+  dateFns: () => import_language_common2.dateFns,
+  default: () => src_default,
+  each: () => import_language_common2.each,
+  field: () => import_language_common2.field,
+  fields: () => import_language_common2.fields,
+  fn: () => import_language_common2.fn,
+  fnIf: () => import_language_common2.fnIf,
+  get: () => get,
+  group: () => import_language_common2.group,
+  lastReferenceValue: () => import_language_common2.lastReferenceValue,
+  list: () => list,
+  map: () => import_language_common2.map,
+  merge: () => import_language_common2.merge,
+  post: () => post,
+  request: () => request2,
+  scrubEmojis: () => import_language_common2.scrubEmojis,
+  sourceValue: () => import_language_common2.sourceValue,
+  util: () => import_language_common2.util
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/Adaptor.js
+var Adaptor_exports = {};
+__export(Adaptor_exports, {
+  as: () => import_language_common2.as,
+  combine: () => import_language_common2.combine,
+  cursor: () => import_language_common2.cursor,
+  dataPath: () => import_language_common2.dataPath,
+  dataValue: () => import_language_common2.dataValue,
+  dateFns: () => import_language_common2.dateFns,
+  each: () => import_language_common2.each,
+  field: () => import_language_common2.field,
+  fields: () => import_language_common2.fields,
+  fn: () => import_language_common2.fn,
+  fnIf: () => import_language_common2.fnIf,
+  get: () => get,
+  group: () => import_language_common2.group,
+  lastReferenceValue: () => import_language_common2.lastReferenceValue,
+  list: () => list,
+  map: () => import_language_common2.map,
+  merge: () => import_language_common2.merge,
+  post: () => post,
+  request: () => request2,
+  scrubEmojis: () => import_language_common2.scrubEmojis,
+  sourceValue: () => import_language_common2.sourceValue,
+  util: () => import_language_common2.util
+});
+var import_util2 = require("@openfn/language-common/util");
+
+// src/Utils.js
+var import_language_common = require("@openfn/language-common");
+var import_util = require("@openfn/language-common/util");
+var import_node_path = __toESM(require("path"), 1);
+var prepareNextState = (state, response) => {
+  const { body, ...responseWithoutBody } = response;
+  if (!state.references) {
+    state.references = [];
+  }
+  return {
+    ...(0, import_language_common.composeNextState)(state, body),
+    response: responseWithoutBody
+  };
+};
+var getAccessToken = async (configuration, headers) => {
+  const { apiKey, secretKey, baseUrl } = configuration;
+  const { body } = await (0, import_util.request)("POST", "api/v1/auth/login", {
+    headers: {
+      ...headers,
+      ...(0, import_util.makeBasicAuthHeader)(apiKey, secretKey)
+    },
+    baseUrl,
+    parseAs: "json"
+  });
+  return { ...configuration, access_token: body.responseBody.accessToken };
+};
+var requestWithPagination = async (configuration = {}, method, path, options = {}) => {
+  var _a;
+  const { query = {} } = options;
+  let { pageSize, pageNo } = query;
+  const hasPagination = pageSize !== void 0 || pageNo !== void 0;
+  if (pageSize && pageSize > 1e3) {
+    console.log("Warning: PageSize cannot exceed 1000, reducing to 1000");
+    pageSize = 1e3;
+  }
+  const allContent = [];
+  let currentPage = pageNo !== void 0 ? pageNo : 0;
+  let isLastPage = false;
+  do {
+    const response = await request(configuration, method, path, {
+      ...options,
+      query: { ...query, pageSize: pageSize || 100, pageNo: currentPage }
+    });
+    const { body: { responseBody } } = response;
+    if (hasPagination)
+      return { body: responseBody.content };
+    if ((_a = responseBody.content) == null ? void 0 : _a.length) {
+      allContent.push(...responseBody.content);
+    }
+    isLastPage = responseBody.last === true;
+    currentPage++;
+  } while (!isLastPage);
+  return {
+    body: allContent
+  };
+};
+var request = async (configuration = {}, method, path, options) => {
+  let config = configuration;
+  const { baseUrl, access_token } = config;
+  if (!access_token)
+    config = await getAccessToken(config, options.headers);
+  const { query = {}, body = {} } = options;
+  const opts = {
+    parseAs: "json",
+    baseUrl,
+    headers: {
+      "content-type": "application/json",
+      Authorization: `Bearer ${config.access_token}`,
+      ...options.headers
+    },
+    body,
+    query,
+    ...options
+  };
+  const safePath = import_node_path.default.join(path);
+  return (0, import_util.request)(method, safePath, opts).then(import_util.logResponse);
+};
+
+// src/Adaptor.js
+var import_language_common2 = require("@openfn/language-common");
+function get(path, options = {}) {
+  return async (state) => {
+    const [resolvedPath, resolvedoptions] = (0, import_util2.expandReferences)(state, path, options);
+    const response = await request(
+      state.configuration,
+      "GET",
+      resolvedPath,
+      resolvedoptions
+    );
+    return prepareNextState(state, response);
+  };
+}
+function list(path, query = {}) {
+  return async (state) => {
+    const [resolvedPath, resolvedQuery] = (0, import_util2.expandReferences)(state, path, query);
+    const response = await requestWithPagination(
+      state.configuration,
+      "GET",
+      resolvedPath,
+      {
+        query: resolvedQuery
+      }
+    );
+    return prepareNextState(state, response);
+  };
+}
+function post(path, body, options = {}) {
+  return async (state) => {
+    const [resolvedPath, resolvedBody, resolvedOptions] = (0, import_util2.expandReferences)(state, path, body, options);
+    const response = await request(
+      state.configuration,
+      "POST",
+      resolvedPath,
+      {
+        body: resolvedBody,
+        ...resolvedOptions
+      }
+    );
+    return prepareNextState(state, response);
+  };
+}
+function request2(method, path, options = {}) {
+  return async (state) => {
+    const [resolvedMethod, resolvedPath, resolvedoptions] = (0, import_util2.expandReferences)(state, method, path, options);
+    const response = await request(
+      state.configuration,
+      resolvedMethod,
+      resolvedPath,
+      resolvedoptions
+    );
+    return prepareNextState(state, response);
+  };
+}
+
+// src/index.js
+var src_default = Adaptor_exports;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  as,
+  combine,
+  cursor,
+  dataPath,
+  dataValue,
+  dateFns,
+  each,
+  field,
+  fields,
+  fn,
+  fnIf,
+  get,
+  group,
+  lastReferenceValue,
+  list,
+  map,
+  merge,
+  post,
+  request,
+  scrubEmojis,
+  sourceValue,
+  util
+});

package/dist/index.js

@@ -0,0 +1,218 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/Adaptor.js
+var Adaptor_exports = {};
+__export(Adaptor_exports, {
+  as: () => as,
+  combine: () => combine,
+  cursor: () => cursor,
+  dataPath: () => dataPath,
+  dataValue: () => dataValue,
+  dateFns: () => dateFns,
+  each: () => each,
+  field: () => field,
+  fields: () => fields,
+  fn: () => fn,
+  fnIf: () => fnIf,
+  get: () => get,
+  group: () => group,
+  lastReferenceValue: () => lastReferenceValue,
+  list: () => list,
+  map: () => map,
+  merge: () => merge,
+  post: () => post,
+  request: () => request2,
+  scrubEmojis: () => scrubEmojis,
+  sourceValue: () => sourceValue,
+  util: () => util
+});
+import { expandReferences } from "@openfn/language-common/util";
+
+// src/Utils.js
+import { composeNextState } from "@openfn/language-common";
+import {
+  request as commonRequest,
+  logResponse,
+  makeBasicAuthHeader
+} from "@openfn/language-common/util";
+import nodepath from "path";
+var prepareNextState = (state, response) => {
+  const { body, ...responseWithoutBody } = response;
+  if (!state.references) {
+    state.references = [];
+  }
+  return {
+    ...composeNextState(state, body),
+    response: responseWithoutBody
+  };
+};
+var getAccessToken = async (configuration, headers) => {
+  const { apiKey, secretKey, baseUrl } = configuration;
+  const { body } = await commonRequest("POST", "api/v1/auth/login", {
+    headers: {
+      ...headers,
+      ...makeBasicAuthHeader(apiKey, secretKey)
+    },
+    baseUrl,
+    parseAs: "json"
+  });
+  return { ...configuration, access_token: body.responseBody.accessToken };
+};
+var requestWithPagination = async (configuration = {}, method, path, options = {}) => {
+  var _a;
+  const { query = {} } = options;
+  let { pageSize, pageNo } = query;
+  const hasPagination = pageSize !== void 0 || pageNo !== void 0;
+  if (pageSize && pageSize > 1e3) {
+    console.log("Warning: PageSize cannot exceed 1000, reducing to 1000");
+    pageSize = 1e3;
+  }
+  const allContent = [];
+  let currentPage = pageNo !== void 0 ? pageNo : 0;
+  let isLastPage = false;
+  do {
+    const response = await request(configuration, method, path, {
+      ...options,
+      query: { ...query, pageSize: pageSize || 100, pageNo: currentPage }
+    });
+    const { body: { responseBody } } = response;
+    if (hasPagination)
+      return { body: responseBody.content };
+    if ((_a = responseBody.content) == null ? void 0 : _a.length) {
+      allContent.push(...responseBody.content);
+    }
+    isLastPage = responseBody.last === true;
+    currentPage++;
+  } while (!isLastPage);
+  return {
+    body: allContent
+  };
+};
+var request = async (configuration = {}, method, path, options) => {
+  let config = configuration;
+  const { baseUrl, access_token } = config;
+  if (!access_token)
+    config = await getAccessToken(config, options.headers);
+  const { query = {}, body = {} } = options;
+  const opts = {
+    parseAs: "json",
+    baseUrl,
+    headers: {
+      "content-type": "application/json",
+      Authorization: `Bearer ${config.access_token}`,
+      ...options.headers
+    },
+    body,
+    query,
+    ...options
+  };
+  const safePath = nodepath.join(path);
+  return commonRequest(method, safePath, opts).then(logResponse);
+};
+
+// src/Adaptor.js
+import {
+  as,
+  combine,
+  cursor,
+  dataPath,
+  dataValue,
+  dateFns,
+  each,
+  field,
+  fields,
+  fn,
+  fnIf,
+  group,
+  lastReferenceValue,
+  map,
+  merge,
+  scrubEmojis,
+  sourceValue,
+  util
+} from "@openfn/language-common";
+function get(path, options = {}) {
+  return async (state) => {
+    const [resolvedPath, resolvedoptions] = expandReferences(state, path, options);
+    const response = await request(
+      state.configuration,
+      "GET",
+      resolvedPath,
+      resolvedoptions
+    );
+    return prepareNextState(state, response);
+  };
+}
+function list(path, query = {}) {
+  return async (state) => {
+    const [resolvedPath, resolvedQuery] = expandReferences(state, path, query);
+    const response = await requestWithPagination(
+      state.configuration,
+      "GET",
+      resolvedPath,
+      {
+        query: resolvedQuery
+      }
+    );
+    return prepareNextState(state, response);
+  };
+}
+function post(path, body, options = {}) {
+  return async (state) => {
+    const [resolvedPath, resolvedBody, resolvedOptions] = expandReferences(state, path, body, options);
+    const response = await request(
+      state.configuration,
+      "POST",
+      resolvedPath,
+      {
+        body: resolvedBody,
+        ...resolvedOptions
+      }
+    );
+    return prepareNextState(state, response);
+  };
+}
+function request2(method, path, options = {}) {
+  return async (state) => {
+    const [resolvedMethod, resolvedPath, resolvedoptions] = expandReferences(state, method, path, options);
+    const response = await request(
+      state.configuration,
+      resolvedMethod,
+      resolvedPath,
+      resolvedoptions
+    );
+    return prepareNextState(state, response);
+  };
+}
+
+// src/index.js
+var src_default = Adaptor_exports;
+export {
+  as,
+  combine,
+  cursor,
+  dataPath,
+  dataValue,
+  dateFns,
+  src_default as default,
+  each,
+  field,
+  fields,
+  fn,
+  fnIf,
+  get,
+  group,
+  lastReferenceValue,
+  list,
+  map,
+  merge,
+  post,
+  request2 as request,
+  scrubEmojis,
+  sourceValue,
+  util
+};

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@openfn/language-monnify",
+  "version": "1.0.0",
+  "description": "OpenFn monnify adaptor",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./types/index.d.ts",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "author": "Open Function Group",
+  "license": "LGPLv3",
+  "files": [
+    "dist/",
+    "types/",
+    "ast.json",
+    "configuration-schema.json"
+  ],
+  "dependencies": {
+    "@openfn/language-common": "3.2.1"
+  },
+  "devDependencies": {
+    "assertion-error": "2.0.0",
+    "chai": "4.3.6",
+    "deep-eql": "4.1.1",
+    "mocha": "^10.7.3",
+    "rimraf": "3.0.2",
+    "undici": "^5.22.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/openfn/adaptors.git"
+  },
+  "types": "types/index.d.ts",
+  "main": "dist/index.cjs",
+  "scripts": {
+    "build": "pnpm clean && build-adaptor monnify",
+    "test": "mocha --experimental-specifier-resolution=node --no-warnings",
+    "test:watch": "mocha -w --experimental-specifier-resolution=node --no-warnings",
+    "clean": "rimraf dist types docs",
+    "pack": "pnpm pack --pack-destination ../../dist",
+    "lint": "eslint src"
+  }
+}

package/types/Adaptor.d.ts

@@ -0,0 +1,132 @@
+/**
+ * State object
+ * @typedef {Object} HttpState
+ * @property data - the parsed response body
+ * @property response - the response from the HTTP server, including headers, statusCode, body, etc
+ * @property references - an array of all previous data objects used in the Job
+ **/
+/**
+ * Query option for the `list` helper function
+ * @typedef {Object} ListQueryOptions
+ * @property {Number} pageNo - The page number. Please note that Monnify pagination starts at 0 not 1. (Default: 0)
+ * @property {Number} pageSize - The page size. (Default: 100)
+ * @property {Record<string, any>} [otherOptions] - Additional options.
+ **/
+/**
+ * Options provided to the HTTP request
+ * @typedef {Object} RequestOptions
+ * @public
+ * @property {object|string} body - body data to append to the request. JSON will be converted to a string (but a content-type header will not be attached to the request).
+ * @property {object} query - An object of query parameters to be encoded into the URL.
+ */
+/**
+ * Make a GET request
+ * @example <caption>Get all transactions</caption>
+ * get('/api/v1/transactions/search');
+ * @function
+ * @public
+ * @param {string} path - Path to resource
+ * @param {RequestOptions} options - Optional request options
+ * @returns {Operation}
+ * @state {HttpState}
+ */
+export function get(path: string, options?: RequestOptions): Operation;
+/**
+ * Fetch a list of items.
+ * @example <caption>Get all transactions</caption>
+ * list('/api/v2/disbursements/search-transactions', {
+ *     sourceAccountNumber: 4864192954
+ * });
+ *
+ * @example <caption>Get all transactions for a specific page and page number.</caption>
+ * list('/api/v2/disbursements/search-transactions', {
+ *     sourceAccountNumber: 4864192954,
+ *     pageNo: 0,
+ *     pageSize: 10
+ * });
+ * @function
+ * @public
+ * @param {string} path - Path to resource
+ * @param {ListQueryOptions} query - Query options.
+ * @returns {Operation}
+ * @state {HttpState}
+ */
+export function list(path: string, query?: ListQueryOptions): Operation;
+/**
+ * Make a POST request
+ * @example <caption>Resend all failed notifications over a time period</caption>
+ * post("/api/v1/transaction-notification/resend-failed-notifications", {
+    "startDate": "2021-01-16T13:56:39.492",
+    "endDate": "2021-10-16T13:56:39.492"
+});
+ * @function
+ * @public
+ * @param {string} path - Path to resource
+ * @param {object} body - The Post request body
+ * @param {RequestOptions} options - Optional request options
+ * @returns {Operation}
+ * @state {HttpState}
+ */
+export function post(path: string, body: object, options?: RequestOptions): Operation;
+/**
+ * Make a generic request
+ * @example <caption>Get disbursements from a wallet</caption>
+ * request(
+ *  'GET',
+ *  '/api/v2/disbursements/search-transactions',
+ *  {
+ *    query: {
+ *      sourceAccountNumber: 4864192954,
+ *      pageNo: 0,
+ *      pageSize: 10
+ *      }
+ *   }
+ * );
+ * @function
+ * @public
+ * @param {string} method - HTTP method to use
+ * @param {string} path - Path to resource
+ * @param {RequestOptions} options - Optional request options
+ * @returns {Operation}
+ * @state {HttpState}
+ */
+export function request(method: string, path: string, options?: RequestOptions): Operation;
+/**
+ * State object
+ */
+export type HttpState = {
+    /**
+     * - the parsed response body
+     */
+    data: any;
+    /**
+     * - the response from the HTTP server, including headers, statusCode, body, etc
+     */
+    response: any;
+    /**
+     * - an array of all previous data objects used in the Job
+     */
+    references: any;
+};
+/**
+ * Query option for the `list` helper function
+ */
+export type ListQueryOptions = {
+    /**
+     * - The page number. Please note that Monnify pagination starts at 0 not 1. (Default: 0)
+     */
+    pageNo: number;
+    /**
+     * - The page size. (Default: 100)
+     */
+    pageSize: number;
+    /**
+     * - Additional options.
+     */
+    otherOptions?: Record<string, any>;
+};
+/**
+ * Options provided to the HTTP request
+ */
+export type RequestOptions = any;
+export { as, combine, cursor, dataPath, dataValue, dateFns, each, field, fields, fn, fnIf, group, lastReferenceValue, map, merge, scrubEmojis, sourceValue, util } from "@openfn/language-common";

package/types/Utils.d.ts

@@ -0,0 +1,4 @@
+export function prepareNextState(state: any, response: any): any;
+export function getAccessToken(configuration: any, headers: any): Promise<any>;
+export function requestWithPagination(configuration: {}, method: any, path: any, options?: {}): Promise<any>;
+export function request(configuration: {}, method: any, path: any, options: any): Promise<any>;

package/types/index.d.ts

@@ -0,0 +1,3 @@
+export default Adaptor;
+export * from "./Adaptor";
+import * as Adaptor from "./Adaptor";