bankson-js-mb 1.0.6

package/.eslintrc.cjs

@@ -0,0 +1,27 @@
+module.exports = {
+  plugins: [
+    'simple-import-sort',
+    'unicorn'
+  ],
+  extends: [
+    'madbooster-node-app'
+  ],
+  rules: {
+    'n/no-missing-import': 2,
+    'n/no-extraneous-import': 2,
+    'n/file-extension-in-import': 2,
+
+    'import/no-unresolved': 2,
+    'import/no-useless-path-segments': 2,
+    'import/no-extraneous-dependencies': 2,
+    'import/no-commonjs': [2, { allowRequire: true }],
+    'import/extensions': [2, 'ignorePackages'],
+    'simple-import-sort/imports': 2,
+    'sort-imports': 0, // import sort plugin needs this
+    'import/order': 0,
+    'import/newline-after-import': 2,
+    'unicorn/prefer-module': 2,
+    'unicorn/prefer-node-protocol': 2,
+    'lodash/prefer-lodash-typecheck': 0
+  }
+}

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 banksonfi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,49 @@
+# Bankson.fi Node.JS client
+
+API documentation: [Official bankson.fi documentation](http://docs.bankson.fi)
+
+## Installation
+
+```
+npm install --save bankson-js
+```
+
+## Usage
+
+```js
+import Client from 'bankson-js';
+var client = new Client({
+  bearerToken: bearerTokenObtainedWithOAuth2
+});
+
+client.me().then(resp => {
+  console.log('Current user', resp.user);
+});
+
+```
+
+## Dynamic bearer token
+
+Because of the expiring nature of bearer tokens you can validate and refresh them before every request by providing a `beforeRequest` function that returns
+a promise:
+
+```js
+import Client from 'bankson-js';
+var client = new Client({
+  beforeRequest: () => {
+    return refreshMyToken().then(token => {
+      return {
+        bearerToken: token
+      };
+    });
+  }
+});
+```
+
+## Test mode
+
+To support API requests in test mode, you can either specify `test: true` in the constructor options or return `test: true` in the promised value in `beforeRequest`.
+
+## License
+
+MIT License

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "bankson-js-mb",
+  "version": "1.0.6",
+  "description": "Bankson.fi Node client, Mad Booster fork",
+  "main": "src/index.js",
+  "type": "module",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "babel src --out-dir lib",
+    "dev": "babel -w src --out-dir lib",
+    "lint": "eslint src"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MadBooster/bankson-js.git"
+  },
+  "keywords": [
+    "bankson",
+    "camt",
+    "pain",
+    "corporatefileservice"
+  ],
+  "author": "Bankson authors",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/MadBooster/bankson-js/issues"
+  },
+  "homepage": "https://github.com/MadBooster/bankson-js#readme",
+  "devDependencies": {
+    "eslint": "^8.57.1",
+    "eslint-config-madbooster-node-app": "^11.0.0",
+    "eslint-plugin-simple-import-sort": "^12.1.0"
+  },
+  "dependencies": {
+    "form-data": "^4.0.2",
+    "node-rsa": "^1.1.1",
+    "qs": "^6.14.0"
+  },
+  "overrides": {
+    "eslint-plugin-n": "^17.7.0",
+    "eslint-plugin-promise": "^7.1.0"
+  }
+}

package/src/client.js

@@ -0,0 +1,128 @@
+import NodeRSA from 'node-rsa'
+
+import ApiKeys from './ext/apikeys.js'
+import Applications from './ext/applications.js'
+import BankAccountStatements from './ext/bank-account-statements.js'
+import BankAccounts from './ext/bank-accounts.js'
+import Certificates from './ext/bank-certificates.js'
+import Calls from './ext/calls.js'
+import InboundPayments from './ext/inbound-payments.js'
+import Payments from './ext/outbound-payments.js'
+import Webhooks from './ext/webhooks.js'
+
+export default class Client {
+  constructor(opts = {}) {
+    this.applications = new Applications(this)
+    this.webhooks = new Webhooks(this)
+    this.certificates = new Certificates(this)
+    this.calls = new Calls(this)
+    this.bankAccounts = new BankAccounts(this)
+    this.bankAccountStatements = new BankAccountStatements(this)
+    this.outboundPayments = new Payments(this)
+    this.apikeys = new ApiKeys(this)
+    this.inboundPayments = new InboundPayments(this)
+    this.beforeRequest = opts.beforeRequest || (() => Promise.resolve())
+    this.bearerToken = opts.bearerToken || '-'
+    this.baseUrl = opts.baseUrl || 'https://api.bankson.fi'
+    this.testMode = typeof opts.test !== 'undefined' ? opts.test : false
+    if(opts.privateKey && opts.apiKey) {
+      // ApiKey authentication
+      this.bearerToken = false
+      this.privateKey = new NodeRSA()
+      this.privateKey.importKey(opts.privateKey, 'private')
+      if(!this.privateKey.isPrivate()) throw new Error('Invalid private key')
+      this.apiKey = opts.apiKey
+    }
+  }
+
+  me() {
+    return this.get('/me')
+  }
+
+  meV2() {
+    return this.get('/v2/me')
+  }
+
+  authorizationHeader(bearerToken) {
+    if(this.bearerToken) return 'Bearer ' + bearerToken
+    const timestamp = Date.now()
+    const str = this.apiKey + timestamp
+    const signature = this.privateKey.sign(str, 'base64')
+    return 'BanksonRSA ' + [
+      'ApiKey=' + this.apiKey,
+      'Timestamp=' + timestamp,
+      'Signature=' + signature
+    ].join(', ')
+  }
+
+  headers(additionalHeaders = {}) {
+    return this.beforeRequest().then(result => {
+      const bearerToken = result?.bearerToken || this.bearerToken
+      const banksonTest = result && typeof result.test !== 'undefined' ? result.test : this.testMode
+      const headers = new Headers()
+      headers.append('Accept', additionalHeaders.Accept || 'application/json')
+      headers.append('Authorization', this.authorizationHeader(bearerToken))
+      if(banksonTest) headers.append('X-Bankson-Environment', 'Test')
+      return headers
+    })
+  }
+
+  get(path, options = {}) {
+    return this.headers(options.headers).then(headers => fetch(`${this.baseUrl}${path}`, { headers }).then(resp => this.handleResponse(resp, options)))
+  }
+
+  post(path, data) {
+    return this.request('POST', path, data)
+  }
+
+  put(path, data) {
+    return this.request('PUT', path, data)
+  }
+
+  request(method, path, data) {
+    return this.headers().then(headers => {
+      const isFormData = data instanceof FormData
+      if(!isFormData) {
+        headers.append('Content-Type', 'application/json')
+      }
+      return fetch(`${this.baseUrl}${path}`, {
+        method,
+        body: isFormData ? data : JSON.stringify(data),
+        headers
+      }).then(this.handleResponse)
+    })
+  }
+
+  delete(path) {
+    return this.headers().then(headers => fetch(`${this.baseUrl}${path}`, {
+      method: 'DELETE',
+      headers
+    })).then(this.handleResponse)
+  }
+
+  handleResponse(resp, options = {}) {
+    if(!resp.ok) {
+      if(resp.status >= 500 || resp.status < 400) {
+        const err = new Error(`Internal error (${resp.status}): ${resp.statusText}`)
+        err.status = resp.status
+        err.statusText = resp.statusText
+        throw err
+      }
+      return getBody(resp).then(json => {
+        const err = new Error('Request unsuccessfull')
+        err.status = resp.status
+        err.body = json
+        throw err
+      })
+    }
+    return getBody(resp)
+
+    function getBody(resp) {
+      if(!/application\/json/.test(resp.headers.get('Content-Type'))) {
+        if(options.responseType === 'arraybuffer') return resp.arrayBuffer()
+        return resp.text()
+      }
+      return resp.json()
+    }
+  }
+}

package/src/ext/apikeys.js

@@ -0,0 +1,29 @@
+export default class ApiKeys {
+  constructor(base) {
+    this.base = base
+  }
+
+  fetch() {
+    return this.base.get('/apikeys')
+  }
+
+  create(data) {
+    return this.base.post('/apikeys', data)
+  }
+
+  remove(id) {
+    return this.base.delete(`/apikeys/${id}`)
+  }
+
+  fetchV2() {
+    return this.base.get('/v2/apikeys')
+  }
+
+  createV2(data) {
+    return this.base.post('/v2/apikeys', data)
+  }
+
+  removeV2(id) {
+    return this.base.delete(`/v2/apikeys/${id}`)
+  }
+}

package/src/ext/applications.js

@@ -0,0 +1,21 @@
+export default class Applications {
+  constructor(base) {
+    this.base = base
+  }
+
+  fetch() {
+    return this.base.get('/applications')
+  }
+
+  create(data) {
+    return this.base.post('/applications', data)
+  }
+
+  fetchV2() {
+    return this.base.get('/v2/applications')
+  }
+
+  createV2(data) {
+    return this.base.post('/v2/applications', data)
+  }
+}

package/src/ext/bank-account-statements.js

@@ -0,0 +1,77 @@
+export default class BankAccountStatements {
+  constructor(base) {
+    this.base = base
+  }
+
+  fetch() {
+    return this.base.get('/bankaccountstatements')
+  }
+
+  statementHtml(id) {
+    return this.base.get(`/bankaccountstatements/${id}`, {
+      headers: {
+        Accept: 'text/html'
+      },
+      responseType: 'arraybuffer'
+    })
+  }
+
+  statementXml(id) {
+    return this.base.get(`/bankaccountstatements/${id}`, {
+      headers: {
+        Accept: 'application/xml'
+      },
+      responseType: 'arraybuffer'
+    })
+  }
+
+  statementText(id) {
+    return this.base.get(`/bankaccountstatements/${id}`, {
+      headers: {
+        Accept: 'text/plain'
+      },
+      responseType: 'arraybuffer'
+    })
+  }
+
+  refresh(id) {
+    return this.base.post('/bankaccountstatements', {
+      certificate_id: id
+    })
+  }
+
+  fetchV2() {
+    return this.base.get('/v2/bankaccountstatements')
+  }
+
+  statementHtmlV2(id) {
+    return this.base.get(`/v2/bankaccountstatements/${id}`, {
+      headers: {
+        Accept: 'text/html'
+      },
+      responseType: 'arraybuffer'
+    })
+  }
+
+  statementXmlV2(id) {
+    return this.base.get(`/v2/bankaccountstatements/${id}`, {
+      headers: {
+        Accept: 'application/xml'
+      },
+      responseType: 'arraybuffer'
+    })
+  }
+
+  statementTextV2(id) {
+    return this.base.get(`/v2/bankaccountstatements/${id}`, {
+      headers: {
+        Accept: 'text/plain'
+      },
+      responseType: 'arraybuffer'
+    })
+  }
+
+  refreshV2(id) {
+    throw new Error('Not implemented')
+  }
+}

package/src/ext/bank-accounts.js

@@ -0,0 +1,27 @@
+import Qs from 'qs'
+
+export default class BankAccounts {
+  constructor(base) {
+    this.base = base
+  }
+
+  fetch() {
+    return this.base.get('/bankaccounts')
+  }
+
+  create(data) {
+    return this.base.post('/bankaccounts', data)
+  }
+
+  fetchV2(opts) {
+    return this.base.get('/v2/bank-accounts?' + Qs.stringify(opts))
+  }
+
+  createV2(data) {
+    return this.base.post('/v2/bank-accounts', data)
+  }
+
+  updateV2(id, data) {
+    return this.base.put(`/v2/bank-accounts/${id}`, data)
+  }
+}

package/src/ext/bank-certificates.js

@@ -0,0 +1,53 @@
+import FormData from 'form-data'
+
+export default class Certificates {
+  constructor(base) {
+    this.base = base
+  }
+
+  fetch() {
+    return this.base.get('/certificates')
+  }
+
+  upload(file, params) {
+    const data = new FormData()
+    Object.keys(params).forEach(k => data.append(k, params[k]))
+    data.append('certificate', file)
+    return this.base.post('/certificates/upload', data)
+  }
+
+  request(data) {
+    return this.base.post('/certificates/request', data)
+  }
+
+  remove(id) {
+    return this.base.delete(`/certificates/${id}`)
+  }
+
+  renew(id, data = {}) {
+    return this.base.post(`/certificates/${id}/renew`, data)
+  }
+
+  fetchV2() {
+    return this.base.get('/v2/bank-certificates')
+  }
+
+  uploadV2(file, params) {
+    const data = new FormData()
+    Object.keys(params).forEach(k => data.append(k, params[k]))
+    data.append('certificate', file)
+    return this.base.post('/v2/bank-certificates/upload', data)
+  }
+
+  requestV2(data) {
+    return this.base.post('/v2/bank-certificates/request', data)
+  }
+
+  removeV2(id) {
+    return this.base.delete(`/v2/bank-certificates/${id}`)
+  }
+
+  renewV2(id, data = {}) {
+    return this.base.post(`/v2/bank-certificates/${id}/renew`, data)
+  }
+}

package/src/ext/calls.js

@@ -0,0 +1,13 @@
+export default class Calls {
+  constructor(base) {
+    this.base = base
+  }
+
+  fetch() {
+    return this.base.get('/calls')
+  }
+
+  fetchV2() {
+    return this.base.get('/v2/calls')
+  }
+}

package/src/ext/inbound-payments.js

@@ -0,0 +1,40 @@
+import Qs from 'qs'
+
+export default class InboundPayments {
+  constructor(base) {
+    this.base = base
+  }
+
+  fetch(opts) {
+    return this.base.get('/inboundpayments?' + Qs.stringify(opts))
+  }
+
+  refresh(certificateId) {
+    return this.base.post('/inboundpayments', { certificate_id: certificateId })
+  }
+
+  batch(batchId, type = 'json') {
+    let opts
+    if(type !== 'json') {
+      opts = {
+        headers: {
+          Accept: type === 'xml' ? 'application/xml' : 'text/plain'
+        },
+        responseType: 'arraybuffer'
+      }
+    }
+    return this.base.get(`/inboundpayments/batches/${batchId}`, opts)
+  }
+
+  fetchV2(opts) {
+    return this.base.get('/v2/inbound-payments?' + Qs.stringify(opts))
+  }
+
+  refreshV2(certificateId) {
+    throw new Error('Not implemented')
+  }
+
+  batchV2(batchId, type = 'json') {
+    throw new Error('Not implemented')
+  }
+}

package/src/ext/outbound-payments.js

@@ -0,0 +1,31 @@
+import Qs from 'qs'
+
+export default class Payments {
+  constructor(base) {
+    this.base = base
+  }
+
+  fetch() {
+    return this.base.get('/payments')
+  }
+
+  fetchFeedback() {
+    return this.base.post('/payments/feedback', {})
+  }
+
+  fetchV2(opts) {
+    return this.base.get('/v2/outbound-payments?' + Qs.stringify(opts))
+  }
+
+  addV2(data) {
+    return this.base.post('/v2/outbound-payments', data)
+  }
+
+  removeV2(id) {
+    return this.base.delete(`/v2/outbound-payments/${id}`)
+  }
+
+  fetchFeedbackV2() {
+    throw new Error('Not implemented')
+  }
+}

package/src/ext/webhooks.js

@@ -0,0 +1,25 @@
+export default class Webhooks {
+  constructor(base) {
+    this.base = base
+  }
+
+  fetch() {
+    return this.base.get('/webhooks')
+  }
+
+  create(data) {
+    return this.base.post('/webhooks', data)
+  }
+
+  fetchV2() {
+    return this.base.get('/v2/webhooks')
+  }
+
+  createV2(data) {
+    return this.base.post('/v2/webhooks', data)
+  }
+
+  updateV2(id, data) {
+    return this.base.put(`/v2/webhooks/${id}`, data)
+  }
+}

package/src/index.js

@@ -0,0 +1,4 @@
+import Client from './client.js'
+
+// Export for commonjs modules
+export default Client