Node Flinks

A Flinks API wrapper for Node.js

Usage

Installation

npm install node-flinks

Creating a client

import FlinksClient from 'node-flinks';

const instanceName = 'toolbox'; // Flinks sandbox instance
const clientId = '43387ca6-0391-4c82-857d-70d95f087ecb'; // Flinks sandbox clientId

const flinks = new FlinksClient(instanceName, clientId);

Creating a token

When using OAuth with Flinks you must first make a token request where you exchange a clientId, and secret for a response that contains an accessToken.

const flinksTokenResponse = await flinks.token( clientId: '<your clientId>', secret: '<your secret>');

Making an authorize request

After creating a token or if not using OAuth you need make an authorize request where you exchange a loginId for a requestId.

const requestId = await flinks.authorize({ loginId: '<your loginId>' });

Requesting accounts detail

Once you have a requestId you can request the user's accounts detail.

const accountsDetail = await flinks.getAccountsDetail({ requestId: '<your requestId from earlier' });

Debugging

This library uses the debug library. To print debug messages for node-flinks set DEBUG=node-flinks:*.

API

The API of this library mostly follows the Flinks API as specified in the REST API docs. The main difference is that the Flinks API uses PascalCase for object keys and this library uses camelCase.

Here is a list of all the Flinks API endpoints along with the corresponding library method. We have not yet implemented all the endpoints in the Flinks REST API. If an endpoint you need is missing please consider submitting a pull request.

| Endpoint | Client Method | Reference | | ---------------------------- | ------------------------- | --------------------------------------------------------------------------------------------- | | /AnswerMFAQuestions | Not implemented | Docs | | /Attributes | Not implemented | Docs | | /Authorize | authorize | Docs | | /DeleteCard | Not implemented | Docs | | /GenerateAuthorizeToken | Not implemented | Docs | | /GetAccountsDetail | getAccountsDetail | Docs | | /GetAccountsDetailAsync | getAccountsDetailAsync | Docs | | /GetAccountsSummary | getAccountsSummary | Docs | | /GetAccountsSummaryAsync | getAccountsSummaryAsync | Docs | | /GetAllAttributes | Not implemented | Docs | | /GetCreditRiskAttributes | Not implemented | Docs | | /GetIncomeAttributes | Not implemented | Docs | | /GetMFAQuestions | Not implemented | Docs | | /GetStatements | getStatements | Docs | | /GetUserAnalysisAttributes | Not implemented | Docs | | /Investments | Not implemented | Docs | | /SetScheduledRefresh | Not implemented | Docs | | /Token | token | Docs |

Contributing

Development

1. Clone this repo
2. npm install
3. npm link
4. In the package you want to test in run npm link node-flinks
5. Build package with npm run build or turn on watch mode with npm run watch

Testing

npm test

Building

npm run build

If you need to clear the build cache run npm run clean

Publishing

1. Update the version in package.json
2. Add a CHANGELOG entry
3. Commit your changes
4. Run npm pack --dry-run to see what will be published
5. Run npm publish
6. Create a release on GitHub. Use the version as the tag and release name. For example for version 1.0.0 the tag and release name would be v1.0.0.