1.0.9

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mojoio/tink",
-  "version": "1.0.2",
+  "version": "1.0.9",
   "private": false,
   "description": "an unofficial api abstraction for tink.com",
   "main": "dist_ts/index.js",
@@ -14,13 +14,16 @@
   "devDependencies": {
     "@gitzone/tsbuild": "^2.1.25",
     "@gitzone/tsbundle": "^1.0.78",
-    "@gitzone/tstest": "^1.0.44",
+    "@gitzone/tstest": "^1.0.64",
-    "@pushrocks/tapbundle": "^3.2.9",
+    "@pushrocks/qenv": "^4.0.10",
-    "@types/node": "^14.11.2",
+    "@pushrocks/tapbundle": "^4.0.7",
+    "@types/node": "^17.0.18",
     "tslint": "^6.1.3",
     "tslint-config-prettier": "^1.15.0"
   },
-  "dependencies": {},
+  "dependencies": {
+    "@pushrocks/smartrequest": "^1.1.56"
+  },
   "browserslist": [
     "last 1 chrome versions"
   ],

qenv.yml

@@ -0,0 +1,3 @@
+required:
+  - TINK_CLIENT_ID
+  - TINK_CLIENT_SECRET

test/test.nonci.ts

@@ -0,0 +1,35 @@
+import { expect, expectAsync, tap } from '@pushrocks/tapbundle';
+import * as qenv from '@pushrocks/qenv';
+
+const testQenv = new qenv.Qenv('./', './.nogit/');
+
+import * as tink from '../ts/index';
+
+let tinkTestAccount: tink.TinkAccount;
+
+tap.test('should create a valid tink account', async () => {
+  tinkTestAccount = new tink.TinkAccount(
+    testQenv.getEnvVarOnDemand('TINK_CLIENT_ID'),
+    testQenv.getEnvVarOnDemand('TINK_CLIENT_SECRET')
+  );
+  expect(tinkTestAccount).toBeInstanceOf(tink.TinkAccount);
+});
+
+tap.test('should report tink as healthy', async () => {
+  await expectAsync(tinkTestAccount.getTinkHealthyBoolean()).toBeTrue();
+});
+
+tap.test('should create a valid request', async (toolsArg) => {
+  const tinkuser = await tinkTestAccount.createTinkUser("user_1234_abc");
+  console.log(await tinkuser.getTinkLink());
+  process.exit(0);
+  await toolsArg.delayFor(10000);
+})
+
+tap.test('should delete existing users', async () => {
+  expect(tinkTestAccount).toBeInstanceOf(tink.TinkAccount);
+  const tinkUser = new tink.TinkUser(tinkTestAccount, null, 'user_1234_abc');
+  await tinkUser.delete();
+})
+
+tap.start();

test/test.ts

@@ -1,8 +0,0 @@
-import { expect, tap } from '@pushrocks/tapbundle';
-import * as tink from '../ts/index';
-
-tap.test('first test', async () => {
-  console.log(tink.standardExport);
-});
-
-tap.start();

ts/index.ts

@@ -1,3 +1,2 @@
-import * as plugins from './tink.plugins';
+export * from './tink.classes.tinkaccount';
-
+export * from './tink.classes.tinkuser';
-export let standardExport = 'Hi there! :) This is an exported string';

ts/tink.classes.tinkaccount.ts

@@ -0,0 +1,163 @@
+import * as plugins from './tink.plugins';
+
+import { TinkUser } from './tink.classes.tinkuser';
+
+export class TinkAccount {
+  public clientId: string;
+  private clientSecret: string;
+
+  private apiBaseUrl: string = 'https://api.tink.com';
+
+  constructor(clientIdArg: string, clientSecretArg: string) {
+    this.clientId = clientIdArg;
+    this.clientSecret = clientSecretArg;
+  }
+
+  public async getTinkHealthyBoolean(): Promise<boolean> {
+    const response = await plugins.smartrequest.request(
+      'https://api.tink.com/api/v1/monitoring/healthy',
+      {}
+    );
+    return response.body === 'ok';
+  }
+
+  public async getClientAccessTokenForScope(scopeArg: string): Promise<string> {
+    // lets get an accessToken for the request
+    const response = await plugins.smartrequest.postFormDataUrlEncoded(
+      `${this.apiBaseUrl}/api/v1/oauth/token`,
+      {},
+      [
+        {
+          key: 'client_id',
+          content: this.clientId,
+        },
+        {
+          key: 'client_secret',
+          content: this.clientSecret,
+        },
+        {
+          key: 'grant_type',
+          content: 'client_credentials',
+        },
+        {
+          key: 'scope',
+          content: scopeArg,
+        },
+      ]
+    );
+    if (response.statusCode !== 200) {
+      throw new Error('there was an error aquiring an access token.');
+    }
+    const clientAccessToken = response.body.access_token;
+    return clientAccessToken;
+  }
+
+  public async getUserAuthorizationCode(
+    externalUserIdArg: string,
+    actorCLientIdArg: string,
+    scopeArg: string
+  ) {
+    const accessToken = await this.getClientAccessTokenForScope('authorization:grant');
+    const response = await plugins.smartrequest.postFormDataUrlEncoded(
+      `${this.apiBaseUrl}/api/v1/oauth/authorization-grant/delegate`,
+      {
+        headers: {
+          Authorization: `Bearer ${accessToken}`,
+        },
+      },
+      [
+        {
+          key: 'response_type',
+          content: 'code',
+        },
+        {
+          key: 'actor_client_id',
+          content: actorCLientIdArg,
+        },
+        {
+          key: 'external_user_id',
+          content: externalUserIdArg,
+        },
+        {
+          key: 'id_hint',
+          content: 'Hello there',
+        },
+        {
+          key: 'scope',
+          content: scopeArg,
+        },
+      ]
+    );
+
+    if (response.statusCode !== 200) {
+      console.log(response.body);
+      throw new Error('there was an error aquiring an access token.');
+    }
+    const userAuthorizationCode = response.body.code;
+    return userAuthorizationCode;
+  }
+
+  public async getUserAccessToken(authorizationCode: string): Promise<string> {
+    const accessToken = await this.getClientAccessTokenForScope('authorization:grant');
+    const response = await plugins.smartrequest.postFormDataUrlEncoded(
+      `${this.apiBaseUrl}/api/v1/oauth/token`,
+      {},
+      [
+        {
+          key: 'code',
+          content: authorizationCode,
+        },
+        {
+          key: 'client_id',
+          content: this.clientId,
+        },
+        {
+          key: 'client_secret',
+          content: this.clientSecret,
+        },
+        {
+          key: 'grant_type',
+          content: 'authorization_code',
+        },
+      ]
+    );
+
+    if (response.statusCode !== 200) {
+      console.log(response.body);
+      throw new Error('there was an error aquiring an access token.');
+    }
+    const userAccessToken = response.body.access_token;
+    return userAccessToken;
+  }
+
+  // the request method for tink respecting platform specific stuff
+  // e.g. certain headers if needed
+  public async request(optionsArg: {
+    urlArg: string;
+    methodArg: 'POST' | 'GET';
+    accessToken: string;
+    payloadArg: any;
+  }) {
+    // check health
+    if (!(await this.getTinkHealthyBoolean())) {
+      throw new Error('TINK is not healthy right now. Please try again later.');
+    } else {
+      console.log('tink is healthy, continuing...');
+    }
+    const response = await plugins.smartrequest.request(`${this.apiBaseUrl}${optionsArg.urlArg}`, {
+      headers: {
+        Authorization: `Bearer ${optionsArg.accessToken}`,
+        'Content-Type': 'application/json',
+      },
+      method: optionsArg.methodArg,
+      requestBody: JSON.stringify(optionsArg.payloadArg),
+    });
+    console.log(response.statusCode);
+    return response.body;
+  }
+
+  public async createTinkUser(externalUserIdArg: string) {
+    const tinkuser = await TinkUser.createNewTinkUser(this, externalUserIdArg);
+    return tinkuser;
+  }
+}

ts/tink.classes.tinkuser.ts

@@ -0,0 +1,65 @@
+import * as plugins from './tink.plugins';
+
+import { TinkAccount } from './tink.classes.tinkaccount';
+
+export class TinkUser {
+  // STATIC
+  public static async createNewTinkUser(tinkaccountArg: TinkAccount, externalUserIdArg: string) {
+    const accessToken = await tinkaccountArg.getClientAccessTokenForScope('user:create');
+    const response = await tinkaccountArg.request({
+      urlArg: '/api/v1/user/create',
+      accessToken,
+      methodArg: 'POST',
+      payloadArg: {
+        external_user_id: externalUserIdArg,
+        market: 'DE',
+        locale: 'en_US',
+      },
+    });
+
+    const newTinkUser = new TinkUser(tinkaccountArg, response.user_id, response.external_user_id);
+    return newTinkUser;
+  }
+
+  // INSTANCE
+  public tinkAccountRef: TinkAccount;
+  public tinkUserId: string;
+  public externalUserIdArg: string;
+
+  public authorizationToken: string;
+
+  constructor(tinkAccountrefArg: TinkAccount, tinkUserIdArg: string, externalUserIdArg: string) {
+    this.tinkAccountRef = tinkAccountrefArg;
+    this.tinkUserId = tinkUserIdArg;
+    this.externalUserIdArg = externalUserIdArg;
+  }
+
+  /**
+   * deletes the user
+   */
+  public async delete() {
+    const authorizationCode = await this.tinkAccountRef.getUserAuthorizationCode(
+      this.externalUserIdArg,
+      this.tinkAccountRef.clientId,
+      'user:delete'
+    );
+    const accessToken = await this.tinkAccountRef.getUserAccessToken(authorizationCode);
+    const response = await this.tinkAccountRef.request({
+      methodArg: 'POST',
+      accessToken,
+      payloadArg: {},
+      urlArg: '/api/v1/user/delete',
+    });
+    console.log(`successfully deleted user with externalId ${this.externalUserIdArg}`);
+  }
+
+  public async getTinkLink(): Promise<string> {
+    const authorizationCode = await this.tinkAccountRef.getUserAuthorizationCode(
+      this.externalUserIdArg,
+      'df05e4b379934cd09963197cc855bfe9', // this is a hardcoded app id for tink link, as recommended by tink.com
+      'authorization:read,authorization:grant,credentials:refresh,credentials:read,credentials:write,providers:read,user:read'
+    );
+    const tinkLinkUrl = `https://link.tink.com/1.0/business-transactions/connect-accounts?client_id=${'teststate'}&redirect_uri=https://console.tink.com/callback&authorization_code=${authorizationCode}&market=DE`;
+    return tinkLinkUrl;
+  }
+}

ts/tink.plugins.ts

@@ -1,2 +1,6 @@
-const removeme = {};
+// @pushrocks scope
-export { removeme };
+import * as smartrequest from '@pushrocks/smartrequest';
+
+export {
+  smartrequest
+}