@apolitical/sdk 0.0.1

package/.gitlab-ci.yml

@@ -0,0 +1,25 @@
+# External jobs
+include:
+  - project: 'apolitical/templates/gitlab-pipelines'
+    ref: master
+    file: 'Node-Testing.gitlab-ci.yml'
+
+stages:
+  - cache
+  - test
+  - publish
+
+# Publish jobs
+
+publish-module:
+  stage: publish
+  image: node:12.20.1-alpine3.11
+  extends: .yarn-install
+  only:
+    - tags
+    - /^v\d+\.\d+\.\d+$/
+  before_script:
+    - yarn build
+  script:
+    - echo '//registry.npmjs.org/:_authToken=${NPM_TOKEN}' > ~/.npmrc
+    - yarn publish --access=public

package/.husky/pre-commit

@@ -0,0 +1,8 @@
+#!/bin/sh
+. "$(dirname "$0")/_/husky.sh"
+
+yarn lint-format 
+
+yarn build
+
+yarn test

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.0.1] - 2021-01-18
+### Added
+- Initial setup

package/README.md

@@ -0,0 +1,48 @@
+# Apolitical SDK
+
+Browser library to interact with Apolitical's APIs
+
+## Requirements
+
+Requires the following to run:
+
+- [node.js][node] 12.20.1+
+- [yarn][yarn]
+
+[node]: https://nodejs.org/en/download/
+[yarn]: https://classic.yarnpkg.com/en/docs/install
+
+## Installation
+
+Install with `yarn`:
+
+```sh
+yarn add @apolitical/sdk
+```
+
+## Available Scripts
+
+In the project directory, you can run:
+### `yarn run test`
+
+Runs the test (and the interactive mode can be enabled with `--watchAll`).
+
+### `yarn build`
+
+Builds the library for production to the `build` folder.
+It correctly bundles the code on production mode and optimizes the build for the best performance.
+
+### `yarn publish`
+
+Publishes the library to NPM.
+
+## Usage
+
+The recommended way to use `@apolitical/sdk` is to use the provided functionality:
+
+```js
+const { ping } = require('@apolitical/sdk');
+
+const result = ping();
+console.log(result);
+```

package/build/index.js

@@ -0,0 +1 @@
+!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t(require("axios")):"function"==typeof define&&define.amd?define(["axios"],t):"object"==typeof exports?exports.ApoliticalSDK=t(require("axios")):e.ApoliticalSDK=t(e.axios)}(this,(function(e){return function(){"use strict";var t={300:function(t){t.exports=e}},o={};function n(e){var r=o[e];if(void 0!==r)return r.exports;var u=o[e]={exports:{}};return t[e](u,u.exports,n),u.exports}n.n=function(e){var t=e&&e.__esModule?function(){return e.default}:function(){return e};return n.d(t,{a:t}),t},n.d=function(e,t){for(var o in t)n.o(t,o)&&!n.o(e,o)&&Object.defineProperty(e,o,{enumerable:!0,get:t[o]})},n.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},n.r=function(e){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})};var r={};return function(){n.r(r),n.d(r,{default:function(){return a}});var e=n(300),t=n.n(e);const{APIS:{BACKEND_TEMPLATE:{BASE_URL:o,ENDPOINTS:{DUMMY:u}}}}={APIS:{BACKEND_TEMPLATE:{BASE_URL:"/api/backend-template",ENDPOINTS:{DUMMY:"/dummy"}}}};var a={template:{ping:async()=>{let e=null;try{e=await t().get(`${o}${u}`)}catch(e){(e=>{e.response?console.warn(e.response.data,e.response.status,e.response.headers):e.request?console.warn(e.request):console.warn(e.message)})(e)}return e}}}}(),r}()}));

package/lib/apis/template.js

@@ -0,0 +1,27 @@
+import axios from 'axios';
+
+import config from '../config';
+import { handleError } from '../helpers/errors';
+
+const {
+  APIS: {
+    BACKEND_TEMPLATE: {
+      BASE_URL,
+      ENDPOINTS: { DUMMY },
+    },
+  },
+} = config;
+
+/*
+ * Returns a random number after calling the Backend Template
+ * @return {Object} payload - random number generated by the API
+ */
+export const ping = async () => {
+  let payload = null;
+  try {
+    payload = await axios.get(`${BASE_URL}${DUMMY}`);
+  } catch (error) {
+    handleError(error);
+  }
+  return payload;
+};

package/lib/config.js

@@ -0,0 +1,12 @@
+const config = {
+  APIS: {
+    BACKEND_TEMPLATE: {
+      BASE_URL: '/api/backend-template',
+      ENDPOINTS: {
+        DUMMY: '/dummy',
+      },
+    },
+  },
+};
+
+export default config;

package/lib/context.js

@@ -0,0 +1,13 @@
+// TODO: Define context when external configurations are required for the SDK to work
+
+// let context = {
+//   token: null,
+// };
+
+// export const setContext = ({ token }) => {
+//   context.token = token;
+// };
+
+// export const getContext = () => {
+//   return context;
+// };

package/lib/helpers/errors.js

@@ -0,0 +1,12 @@
+export const handleError = (error) => {
+  if (error.response) {
+    // The request was made and the server responded with a status code that falls out of the range of 2xx
+    console.warn(error.response.data, error.response.status, error.response.headers);
+  } else if (error.request) {
+    // The request was made but no response was received
+    console.warn(error.request);
+  } else {
+    // Something happened in setting up the request that triggered an error
+    console.warn(error.message);
+  }
+};

package/lib/index.js

@@ -0,0 +1,9 @@
+import { ping } from './apis/template';
+
+const sdk = {
+  template: {
+    ping,
+  },
+};
+
+export default sdk;

package/package.json

@@ -0,0 +1,108 @@
+{
+  "name": "@apolitical/sdk",
+  "version": "0.0.1",
+  "description": "Browser library to interact with Apolitical's APIs",
+  "author": "Apolitical Group Limited <engineering@apolitical.co>",
+  "contributors": [
+    "Anouska Hopkins <anouska.hopkins@apolitical.co>",
+    "Antonio Cordasco <antonio.cordasco@apolitical.co>",
+    "Dorothy Yau <dorothy.yau@apolitical.co>",
+    "Laura Hanna-White <laura.hanna-white@apolitical.co>",
+    "Fatimat Gbajabiamila <fatimat.gbajabiamila@apolitical.co>",
+    "Renzo Rozza <renzo.rozza@apolitical.co>",
+    "Rihards Jukna <rihards.jukna@apolitical.co>"
+  ],
+  "license": "MIT",
+  "main": "build/index.js",
+  "scripts": {
+    "test": "jest --runInBand",
+    "unit-test": "jest test/unit/* --bail --runInBand --passWithNoTests",
+    "integration-test": "jest test/integration/* --bail --runInBand --passWithNoTests",
+    "build": "webpack --config webpack.config.js",
+    "lint": "eslint --ext .js ./lib",
+    "format": "prettier --write 'lib/**/*.+(js|json)'",
+    "lint-format": "lint-staged",
+    "prepare": "husky install"
+  },
+  "keywords": [
+    "JavaScript",
+    "Browser",
+    "SDK"
+  ],
+  "dependencies": {
+    "axios": "0.24.0"
+  },
+  "peerDependencies": {
+    "axios": "0.24.0"
+  },
+  "devDependencies": {
+    "@apolitical/eslint-config": "0.0.1",
+    "@babel/core": "7.16.7",
+    "babel-eslint": "10.1.0",
+    "babel-loader": "8.2.3",
+    "babel-preset-react-app": "10.0.1",
+    "husky": "7.0.4",
+    "jest": "27.4.7",
+    "jest-junit": "13.0.0",
+    "lint-staged": "12.1.5",
+    "webpack": "5.65.0",
+    "webpack-cli": "4.9.1"
+  },
+  "eslintConfig": {
+    "extends": [
+      "eslint:recommended",
+      "plugin:prettier/recommended",
+      "plugin:jest/recommended"
+    ],
+    "env": {
+      "browser": true,
+      "node": true,
+      "es6": true,
+      "jest": true
+    },
+    "plugins": [
+      "jest"
+    ],
+    "parser": "babel-eslint"
+  },
+  "prettier": "@apolitical/eslint-config/prettier.config",
+  "browserslist": {
+    "production": [
+      ">0.2%",
+      "not dead",
+      "not op_mini all",
+      "ie 11"
+    ]
+  },
+  "jest": {
+    "bail": true,
+    "clearMocks": true,
+    "collectCoverage": true,
+    "collectCoverageFrom": [
+      "<rootDir>/lib/**/*.js"
+    ],
+    "coveragePathIgnorePatterns": [
+      "<rootDir>/node_modules/"
+    ],
+    "setupFiles": [
+      "./test/setupTests.js"
+    ],
+    "reporters": [
+      "default",
+      "jest-junit"
+    ],
+    "testResultsProcessor": "jest-junit"
+  },
+  "babel": {
+    "presets": [
+      "react-app"
+    ]
+  },
+  "engines": {
+    "node": ">=12.20.1"
+  },
+  "lint-staged": {
+    "*.js": "eslint --cache --fix --ignore-path .gitignore",
+    "*.+(js|json)": "prettier --write --ignore-path .gitignore"
+  }
+}

package/test/setupTests.js

@@ -0,0 +1,4 @@
+// Overrides console error & warn when testing
+// Importnat: Comment out this line to check errors when testing
+console.error = jest.fn();
+console.warn = jest.fn();

package/test/template.spec.js

@@ -0,0 +1,27 @@
+import axios from 'axios';
+
+import sdk from '../lib';
+
+const {
+  template: { ping },
+} = sdk;
+
+jest.mock('axios');
+
+describe('Apolitical SDK', () => {
+  describe('Backend Template', () => {
+    describe('Ping (Dummy)', () => {
+      test('should return a number', async () => {
+        axios.get.mockResolvedValueOnce({ result: 123 });
+        const { result } = await ping();
+        expect(result).toEqual(expect.any(Number));
+      });
+
+      test('should catch unexpected errors', async () => {
+        axios.get.mockRejectedValueOnce(new Error('Something went wrong'));
+        const result = await ping();
+        expect(result).toStrictEqual(null);
+      });
+    });
+  });
+});

package/webpack.config.js

@@ -0,0 +1,28 @@
+'use strict';
+
+const path = require('path');
+
+module.exports = {
+  mode: 'production',
+  entry: {
+    index: path.resolve(__dirname, 'lib', 'index.js'),
+  },
+  output: {
+    path: path.resolve(__dirname, 'build'),
+    filename: 'index.js',
+    library: {
+      name: 'ApoliticalSDK',
+      type: 'umd',
+    },
+    globalObject: 'this',
+  },
+  externals: {
+    axios: 'axios',
+  },
+  optimization: {
+    splitChunks: {
+      chunks: 'all',
+    },
+    minimize: true,
+  },
+};