@tasenor/common-plugins 1.9.16

package/src/NordnetImport/backend/rules.json

@@ -0,0 +1,271 @@
+{
+  "rules": [
+    {
+      "name": "Stock Buy",
+      "filter": "Tapahtumatyyppi == 'OSTO'",
+      "result": [
+        {
+          "data": {
+            "text": "Tapahtumateksti"
+          },
+          "type": "'currency'",
+          "asset": "Valuutta",
+          "amount": "Summa",
+          "reason": "'trade'"
+        },
+        {
+          "data": {
+            "text": "Tapahtumateksti"
+          },
+          "type": "'stock'",
+          "asset": "Arvopaperi",
+          "amount": "Määrä",
+          "reason": "'trade'"
+        },
+        {
+          "if": "Kokonaiskulut",
+          "data": {
+            "text": "Tapahtumateksti"
+          },
+          "type": "'currency'",
+          "asset": "$('Kokonaiskulut Valuutta')",
+          "amount": "Kokonaiskulut",
+          "reason": "'fee'"
+        }
+      ]
+    },
+    {
+      "name": "Stock Sell",
+      "filter": "Tapahtumatyyppi == 'MYYNTI'",
+      "result": [
+        {
+          "data": {
+            "text": "Tapahtumateksti"
+          },
+          "type": "'currency'",
+          "asset": "Valuutta",
+          "amount": "Summa",
+          "reason": "'trade'"
+        },
+        {
+          "data": {
+            "text": "Tapahtumateksti"
+          },
+          "type": "'stock'",
+          "asset": "Arvopaperi",
+          "amount": "-Määrä",
+          "reason": "'trade'"
+        },
+        {
+          "if": "Kokonaiskulut",
+          "data": {
+            "text": "Tapahtumateksti"
+          },
+          "type": "'currency'",
+          "asset": "$('Kokonaiskulut Valuutta')",
+          "amount": "Kokonaiskulut",
+          "reason": "'fee'"
+        }
+      ]
+    },
+    {
+      "name": "Monthly Saving Fee",
+      "filter": "Tapahtumatyyppi == 'ETF_KK SÄÄSTÖN PALVELUMAKSU'",
+      "result": [
+        {
+          "data": {
+            "text": "Tapahtumateksti"
+          },
+          "type": "'currency'",
+          "asset": "Valuutta",
+          "amount": "Summa",
+          "reason": "'expense'"
+        },
+        {
+          "data": {
+            "text": "Tapahtumateksti"
+          },
+          "type": "'statement'",
+          "asset": "'STOCK_BROKER_SERVICE_FEE'",
+          "amount": "-Summa",
+          "reason": "'expense'"
+        }
+      ]
+    },
+    {
+      "name": "Forex Sell",
+      "filter": "Tapahtumatyyppi == 'VALUUTAN MYYNTI'",
+      "result": [
+        {
+          "data": {
+            "text": "Tapahtumateksti",
+            "rates": "rates(Valuutta, Vaihtokurssi)"
+          },
+          "type": "'currency'",
+          "asset": "Valuutta",
+          "amount": "Summa",
+          "reason": "'forex'"
+        }
+      ]
+    },
+    {
+      "name": "Deposit",
+      "filter": "Tapahtumatyyppi == 'TALLETUS'",
+      "result": [
+        {
+          "data": {
+            "text": "Tapahtumateksti"
+          },
+          "type": "'currency'",
+          "asset": "Valuutta",
+          "amount": "Summa",
+          "reason": "'deposit'"
+        },
+        {
+          "data": {
+            "text": "Tapahtumateksti"
+          },
+          "type": "'external'",
+          "asset": "Valuutta",
+          "amount": "-Summa",
+          "reason": "'deposit'"
+        }
+      ]
+    },
+    {
+      "name": "Withdrawal",
+      "filter": "Tapahtumatyyppi == 'NOSTO'",
+      "result": [
+        {
+          "data": {
+            "text": "Tapahtumateksti"
+          },
+          "type": "'currency'",
+          "asset": "Valuutta",
+          "amount": "Summa",
+          "reason": "'withdrawal'"
+        },
+        {
+          "data": {
+            "text": "Tapahtumateksti"
+          },
+          "type": "'external'",
+          "asset": "Valuutta",
+          "amount": "-Summa",
+          "reason": "'withdrawal'"
+        }
+      ]
+    },
+    {
+      "name": "Dividend",
+      "filter": "Tapahtumatyyppi == 'OSINKO'",
+      "result": [
+        {
+          "data": {
+            "text": "Tapahtumateksti",
+            "asset": "Arvopaperi",
+            "notes": [
+              "times(Määrä, Kurssi)"
+            ],
+            "currency": "Valuutta"
+          },
+          "type": "'currency'",
+          "asset": "Valuutta",
+          "amount": "Summa",
+          "reason": "'dividend'"
+        },
+        {
+          "data": {
+            "text": "Tapahtumateksti",
+            "notes": [
+              "times(Määrä, Kurssi)"
+            ]
+          },
+          "type": "'statement'",
+          "asset": "'LISTED_DIVIDEND'",
+          "amount": "null",
+          "reason": "'income'"
+        }
+      ]
+    },
+    {
+      "name": "Withholding Tax",
+      "filter": "Tapahtumatyyppi == 'ENNAKKOPIDÄTYS'",
+      "result": [
+        {
+          "data": {
+            "text": "Tapahtumateksti",
+            "currency": "Valuutta",
+            "currencyValue": "-Summa * 100"
+          },
+          "type": "'statement'",
+          "asset": "'WITHHOLDING_TAX'",
+          "reason": "'tax'"
+        }
+      ]
+    },
+    {
+      "name": "Forex Buy",
+      "filter": "Tapahtumatyyppi == 'VALUUTAN OSTO'",
+      "result": [
+        {
+          "data": {
+            "text": "Tapahtumateksti"
+          },
+          "type": "'currency'",
+          "asset": "Valuutta",
+          "amount": "Summa",
+          "reason": "'forex'"
+        }
+      ]
+    },
+    {
+      "name": "Interest Expenses",
+      "filter": "Tapahtumatyyppi == 'LAINAKORKO'",
+      "result": [
+        {
+          "data": {
+            "text": "Tapahtumateksti"
+          },
+          "type": "'currency'",
+          "asset": "Valuutta",
+          "amount": "Summa",
+          "reason": "'expense'"
+        },
+        {
+          "data": {
+            "text": "Tapahtumateksti"
+          },
+          "type": "'statement'",
+          "asset": "'INTEREST_EXPENSE'",
+          "amount": "-Summa",
+          "reason": "'expense'"
+        }
+      ]
+    },
+    {
+      "name": "Tapahtumatyyppi contains 'PÄÄOMIT YLIT.KORKO'",
+      "filter": "Tapahtumatyyppi == 'PÄÄOMIT YLIT.KORKO'",
+      "result": [
+        {
+          "data": {
+            "text": "Tapahtumateksti"
+          },
+          "type": "'currency'",
+          "asset": "Valuutta",
+          "amount": "Summa",
+          "reason": "'expense'"
+        },
+        {
+          "data": {
+            "text": "Tapahtumateksti"
+          },
+          "type": "'statement'",
+          "asset": "'INTEREST_EXPENSE'",
+          "amount": "-Summa",
+          "reason": "'expense'"
+        }
+      ]
+    }
+  ]
+}

package/src/Rand/ui/index.tsx

@@ -0,0 +1,27 @@
+import { CurrencyPlugin } from '@dataplug/tasenor-common-ui'
+
+class Rand extends CurrencyPlugin {
+
+  static code = 'Rand'
+  static title = 'Currency Rand'
+  static version = '1.0.10'
+  static icon = '<svg xmlns="http://www.w3.org/2000/svg" height="24px" viewBox="0 0 24 24" width="24px" fill="#000000"><path d="M0 0h24v24H0V0z" fill="none"/><path d="M15 16h3c.55 0 1-.45 1-1V9c0-.55-.45-1-1-1h-3c-.55 0-1 .45-1 1v6c0 .55.45 1 1 1zm1-6h1v4h-1v-4zm-7 6h3c.55 0 1-.45 1-1V9c0-.55-.45-1-1-1H9c-.55 0-1 .45-1 1v6c0 .55.45 1 1 1zm1-6h1v4h-1v-4zM5 8h2v8H5zM2 4v16h20V4H2zm18 14H4V6h16v12z"/></svg>'
+  static releaseDate = '2022-03-11'
+  static use = 'ui'
+  static type = 'currency'
+  static description = 'Support for rand currency.'
+
+  getCurrencySymbol() {
+    return 'R'
+  }
+
+  getCurrencyCode() {
+    return 'ZAR'
+  }
+
+  money2str(cents) {
+    return this.makeMoney(cents, 100, 2, 'R ', ',', '.', '')
+  }
+}
+
+export default Rand

package/src/RapidAPI/backend/index.ts

@@ -0,0 +1,133 @@
+import { ServicePlugin } from '@dataplug/tasenor-common-node'
+import { PluginCode, Version, TasenorElement } from '@dataplug/tasenor-common'
+
+/**
+ * Service: historical-currency-rate
+ *
+ * Query:
+ * - *from* A currency code to convert from.
+ * - *to* A currency code to convert to.
+ * - *date* A date for the closing value wanted.
+ *
+ * Response:
+ * {
+ *   status: 200,
+ *   rate: 0.88123123
+ * }
+ */
+class RapidAPI extends ServicePlugin {
+
+  constructor() {
+    super('historical-currency-rate')
+
+    this.code = 'RapidAPI' as PluginCode
+    this.title = 'Rapid API Service'
+    this.version = '1.0.14' as Version
+    this.icon = '<svg xmlns="http://www.w3.org/2000/svg" enable-background="new 0 0 24 24" height="24px" viewBox="0 0 24 24" width="24px" fill="#000000"><g><rect fill="none" height="24" width="24"/></g><g><path d="M12.89,11.1c-1.78-0.59-2.64-0.96-2.64-1.9c0-1.02,1.11-1.39,1.81-1.39c1.31,0,1.79,0.99,1.9,1.34l1.58-0.67 C15.39,8.03,14.72,6.56,13,6.24V5h-2v1.26C8.52,6.82,8.51,9.12,8.51,9.22c0,2.27,2.25,2.91,3.35,3.31 c1.58,0.56,2.28,1.07,2.28,2.03c0,1.13-1.05,1.61-1.98,1.61c-1.82,0-2.34-1.87-2.4-2.09L8.1,14.75c0.63,2.19,2.28,2.78,2.9,2.96V19 h2v-1.24c0.4-0.09,2.9-0.59,2.9-3.22C15.9,13.15,15.29,11.93,12.89,11.1z M3,21H1v-6h6v2l-2.48,0c1.61,2.41,4.36,4,7.48,4 c4.97,0,9-4.03,9-9h2c0,6.08-4.92,11-11,11c-3.72,0-7.01-1.85-9-4.67L3,21z M1,12C1,5.92,5.92,1,12,1c3.72,0,7.01,1.85,9,4.67L21,3 h2v6h-6V7l2.48,0C17.87,4.59,15.12,3,12,3c-4.97,0-9,4.03-9,9H1z"/></g></svg>'
+    this.releaseDate = '2022-05-13'
+    this.use = 'backend'
+    this.type = 'service'
+    this.description = 'This service provides services from https://rapidapi.com/. Currently it has a service `historical-currency-rate`, which can be used to fetch historical currency rates.'
+
+    this.languages = {
+      en: {
+        'label-apiKey': 'Your Rapid API key to use',
+        'label-apiHost': 'Your Rapid API host to use'
+      },
+      fi: {
+        'label-apiKey': 'Rapid API key eli avain',
+        'label-apiHost': 'Rapid API host eli palvelin',
+        'Rapid API Service': 'Rapid API palvelu',
+        General: 'Yleiset'
+      }
+    }
+  }
+
+  async query(db, settings, service, query) {
+    const host = settings.apiHost
+    if (!host) {
+      return {
+        status: 400,
+        message: 'Setting apiHost is not set.'
+      }
+    }
+    const apiKey = settings.apiKey
+    if (!apiKey) {
+      return {
+        status: 400,
+        message: 'Setting apiKey is not set.'
+      }
+    }
+    if (!query.date) {
+      return {
+        status: 400,
+        message: 'Query parameter `date` is not set.'
+      }
+    }
+    if (!query.from) {
+      return {
+        status: 400,
+        message: 'Query parameter `from` is not set.'
+      }
+    }
+    if (!query.to) {
+      return {
+        status: 400,
+        message: 'Query parameter `to` is not set.'
+      }
+    }
+
+    const date = `${query.date}`.substr(0, 10)
+    const res = await this.cachedRequest(
+      db,
+      service,
+      'GET', `https://${host}/currency/historical/${date}`,
+      {
+        from: query.from,
+        amount: '1',
+        format: 'json',
+        to: query.to
+      }, {
+        'X-RapidAPI-Key': apiKey,
+        'X-RapidAPI-Host': host
+      }, {
+        rateLimitDelay: settings.freePlan ? 1500 : 0
+      }
+    )
+
+    return res.status === 200 ? { status: 200, rate: res.data.rates[query.to.toUpperCase()].rate } : res
+  }
+
+  getSettings(): TasenorElement {
+    return {
+      type: 'flat',
+      elements: [
+        {
+          type: 'boolean',
+          name: 'freePlan',
+          label: 'Are we using free plan, i.e. need to limit access rate accordingly?',
+          actions: {}
+        },
+        {
+          type: 'text',
+          name: 'apiKey',
+          actions: {}
+        },
+        {
+          type: 'text',
+          name: 'apiHost',
+          actions: {}
+        },
+        {
+          type: 'button',
+          label: 'Save',
+          actions: {
+            onClick: { type: 'saveSettings', backend: true, plugin: 'RapidAPI' as PluginCode }
+          }
+        }
+      ]
+    }
+  }
+}
+
+export default RapidAPI

package/src/TITOImport/backend/TITOHandler.ts

@@ -0,0 +1,268 @@
+import { NO_SEGMENT, SegmentId, TextFileLine } from '@dataplug/tasenor-common'
+import { InvalidFile, NotImplemented, ProcessFile, TransactionImportHandler } from '@dataplug/tasenor-common-node'
+
+// Store the latest transactoin ID
+let ref: string | undefined
+
+/**
+ * Import implementation for TITO format.
+ *
+ * Based on https://www.nordea.fi/Images/146-84478/xml_tiliote.pdf
+ */
+export class TITOHandler extends TransactionImportHandler {
+
+  constructor() {
+    super('TITOImport')
+
+    this.importOptions = {
+      parser: 'custom',
+      numericFields: ['Tapahtuman rahamäärä', 'Tietuetunnus', 'Panot Summa', 'Otot Summa', 'Panot Kappalemäärä', 'Otot Kappalemäärä', 'Tiliotteen tietueiden lukumäärä', 'Tilin limiitti'],
+      requiredFields: ['Tietuetunnus', 'Viite', 'Seliteteksti'],
+      insignificantFields: ['Tietuetunnus', 'Tapahtuman numero', 'Tapahtumatunnus', 'Koodi', 'Kuittikoodi', 'Välitystapa', 'Nimen lähde', 'Tili muuttunut -tieto', 'Lomakkeen numero', 'Tasotunnus'],
+      sharedFields: ['Toimeksiantajan tieto-1', 'Toimeksiantajan tieto-2'],
+      textField: 'Seliteteksti',
+      totalAmountField: 'Tapahtuman rahamäärä',
+      custom: {
+        splitToLines: (s: string): string[] => {
+
+          const ret: string[] = []
+
+          for (let i = 0; i < s.length;) {
+            if (s[i] !== 'T') {
+              throw new InvalidFile('Parsing a file failed. Missing "T" in the beginning of the record.')
+            }
+
+            const len = parseInt(s.substring(i + 3, i + 6))
+            const text = s.substring(i, i + len)
+              .replace(/\]/g, 'Å')
+              .replace(/\[/g, 'Ä')
+              .replace(/\\/g, 'Ö')
+              .replace(/\}/g, 'å')
+              .replace(/\{/g, 'ä')
+              .replace(/\|/g, 'ö')
+            ret.push(text)
+
+            i += len
+            while (s.charCodeAt(i) === 10 || s.charCodeAt(i) === 13) {
+              i++
+            }
+          }
+
+          return ret
+        },
+
+        splitToColumns: (s: string): Record<string, string> => {
+          if (s[0] !== 'T') {
+            throw new InvalidFile('Parsing a line failed. Missing "T" in the beginning of the line.')
+          }
+
+          const code = s.substring(1, 3)
+          let columns
+          let extras
+
+          switch (code) {
+
+            // Header line.
+            case '00':
+              ref = undefined
+              return {
+                Tietuetunnus: code,
+                ...this.parseFixedLength(s.substring(6), {
+                  Versionumero: 3,
+                  Tilinumero: 14,
+                  'Tiliotteen numero': 3,
+                  Tiliotekausi: 12,
+                  Muodostumisaika: 10,
+                  Asiakastunnus: 17,
+                  'Alkusaldon pvm': 6,
+                  'Tiliotteen alkusaldo': 19,
+                  'Tiliotteen tietueiden lukumäärä': 6,
+                  'Tilin valuutan tunnus': 3,
+                  'Tilin nimi': 30,
+                  'Tilin limiitti': 18,
+                  'Tilin omistajan nimi': 35,
+                  'Yhteydenottotieto-1': 40,
+                  'Yhteydenottotieto-2': 40,
+                  'Pankkikohtaista tietoa-1': 30,
+                  'Pankkikohtaista tietoa-2': 30,
+                }, {
+                  Tiliotekausi: (s) => `20${s.substring(0, 2)}-${s.substring(2, 4)}-${s.substring(4, 6)} 20${s.substring(6, 8)}-${s.substring(8, 10)}-${s.substring(10, 12)}`,
+                  Muodostumisaika: (s) => `20${s.substring(0, 2)}-${s.substring(2, 4)}-${s.substring(4, 6)} ${s.substring(6, 8)}:${s.substring(8, 10)}:00`,
+                  'Alkusaldon pvm': (s) => `20${s.substring(0, 2)}-${s.substring(2, 4)}-${s.substring(4, 6)}`,
+                  'Tiliotteen alkusaldo': (s) => `${parseInt(s) / 100}`,
+                  'Tiliotteen tietueiden lukumäärä': (s) => `${parseInt(s)}`,
+                  'Tilin limiitti': (s) => `${parseInt(s) / 100}`,
+                })
+              }
+
+            // Basic transaction
+            case '10':
+              columns = {
+                Tietuetunnus: code,
+                ...this.parseFixedLength(s.substring(6), {
+                  'Tapahtuman numero': 6,
+                  Arkistointitunnus: 18,
+                  Kirjauspäivä: 6,
+                  Arvopäivä: 6,
+                  Maksupäivä: 6,
+                  Tapahtumatunnus: 1,
+                  Koodi: 3,
+                  Seliteteksti: 35,
+                  'Tapahtuman rahamäärä': 19,
+                  Kuittikoodi: 1,
+                  Välitystapa: 1,
+                  'Saaja/Maksaja': 35,
+                  'Nimen lähde': 1,
+                  'Saajan tili': 14,
+                  'Tili muuttunut -tieto': 1,
+                  Viite: 20,
+                  'Lomakkeen numero': 8,
+                  Tasotunnus: 1,
+                }, {
+                  Kirjauspäivä: (s) => `20${s.substring(0, 2)}-${s.substring(2, 4)}-${s.substring(4, 6)}`,
+                  Arvopäivä: (s) => `20${s.substring(0, 2)}-${s.substring(2, 4)}-${s.substring(4, 6)}`,
+                  Maksupäivä: (s) => `20${s.substring(0, 2)}-${s.substring(2, 4)}-${s.substring(4, 6)}`,
+                  Viite: (s) => s.replace(/^0+/, ''),
+                  'Tapahtuman rahamäärä': (s) => `${parseInt(s) / 100}`,
+                })
+              }
+              ref = columns.Arkistointitunnus
+              return columns
+
+            // Additional information.
+            case '11':
+              columns = {
+                Tietuetunnus: code,
+                ...this.parseFixedLength(s.substring(6), {
+                  'Lisätiedon tyyppi': 2,
+                  Lisätieto: 999999
+                }, {
+                })
+              }
+              if (ref) {
+                columns['Edellinen Arkistointitunnus'] = ref
+              }
+              extras = columns['Lisätieto']
+              switch (columns['Lisätiedon tyyppi']) {
+                case '00':
+                  Object.assign(columns, {
+                    ...this.parseFixedLength(extras, {
+                      'Viesti-1': 35,
+                      'Viesti-2': 35,
+                      'Viesti-3': 35,
+                      'Viesti-4': 35,
+                      'Viesti-5': 35,
+                      'Viesti-6': 35,
+                      'Viesti-7': 35,
+                      'Viesti-8': 35,
+                      'Viesti-9': 35,
+                      'Viesti-10': 35,
+                      'Viesti-11': 35,
+                      'Viesti-12': 35,
+                    }, {})
+                  })
+                  break
+
+                case '03':
+                  Object.assign(columns, {
+                    ...this.parseFixedLength(extras, {
+                      'Kortin numero': 19,
+                      Tyhjää: 1,
+                      'Kaupan arkistoviite': 14,
+                    }, {})
+                  })
+                  break
+
+                case '06':
+                  Object.assign(columns, {
+                    ...this.parseFixedLength(extras, {
+                      'Toimeksiantajan tieto-1': 35,
+                      'Toimeksiantajan tieto-2': 35,
+                    }, {
+                      'Toimeksiantajan tieto-1': (s) => s.replace(/^0+/, ''),
+                      'Toimeksiantajan tieto-2': (s) => s.replace(/^0+/, ''),
+                    })
+                  })
+                  break
+
+                case '11':
+                  Object.assign(columns, {
+                    ...this.parseFixedLength(extras, {
+                      'Maksajan viite': 35,
+                    }, {})
+                  })
+                  break
+
+                default:
+                  throw new NotImplemented(`Parsing a record of subtype '${columns['Lisätiedon tyyppi']}' is not implemented for record type 'T11'.`)
+              }
+              return columns
+
+            // Balance record.
+            case '40':
+              return {
+                Tietuetunnus: code,
+                ...this.parseFixedLength(s.substring(6), {
+                  Kirjauspäivä: 6,
+                  'Kirjauspäivän loppusaldo': 19,
+                  'Käytettävissä oleva saldo': 19,
+                }, {
+                  Kirjauspäivä: (s) => `20${s.substring(0, 2)}-${s.substring(2, 4)}-${s.substring(4, 6)}`,
+                  'Kirjauspäivän loppusaldo': (s) => `${parseInt(s) / 100}`,
+                  'Käytettävissä oleva saldo': (s) => `${parseInt(s) / 100}`,
+                })
+              }
+
+            // Balance record.
+            case '50':
+              return {
+                Tietuetunnus: code,
+                ...this.parseFixedLength(s.substring(6), {
+                  'Jakson tunnus': 1,
+                  Jaksopäivä: 6,
+                  'Panot Kappalemäärä': 8,
+                  'Panot Summa': 19,
+                  'Otot Kappalemäärä': 8,
+                  'Otot Summa': 19,
+                }, {
+                  Jaksopäivä: (s) => `20${s.substring(0, 2)}-${s.substring(2, 4)}-${s.substring(4, 6)}`,
+                  'Panot Summa': (s) => `${parseInt(s) / 100}`,
+                  'Panot Kappalemäärä': (s) => `${parseInt(s)}`,
+                  'Otot Summa': (s) => `${parseInt(s) / 100}`,
+                  'Otot Kappalemäärä': (s) => `${parseInt(s)}`,
+                })
+              }
+
+            // Notification record.
+            case '70':
+              return {
+                Tietuetunnus: code,
+                ...this.parseFixedLength(s.substring(6), {
+                  'Pankkiryhmän tunnus': 3,
+                  Tiedote: 80 * 6,
+                }, {
+                })
+              }
+
+            default:
+              throw new NotImplemented(`Parsing a record of type 'T${code}' is not implemented.`)
+          }
+          return {}
+        }
+      }
+    }
+  }
+
+  canHandle(file: ProcessFile): boolean {
+    return file.startsWith('T00322100')
+  }
+
+  time(line: TextFileLine): Date | undefined {
+    const date = line.columns['Kirjauspäivä'] || line.columns['Jaksopäivä'] || undefined
+    return date ? new Date(date) : undefined
+  }
+
+  segmentId(line: TextFileLine): SegmentId | typeof NO_SEGMENT {
+    return line.columns.Arkistointitunnus || line.columns['Edellinen Arkistointitunnus'] || NO_SEGMENT
+  }
+}