node-flinks

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.