README

Tinder Access Token Generator

An npm package for use in Node that generates access tokens for the Tinder API using Facebook credentials.

This library does the following

Uses puppeteer to effectively go through the login flow via headless browser
Goes through Tinder confirmation flow - intercepts authentication response and parses access token
Using the Facebook access token, makes a request to Tinder's authentication endpoint to return an API access token and a refresh token

API

`generateToken`

Generate access and refresh tokens given a Facebook email address and Facebook password.

This access token can be used to make Tinder API requests, while the refresh token can be used later to generate updated access and refresh tokens.

import { generateToken } from 'tinder-access-token-generator';

const {
  apiToken,
  refreshToken,
} = await generateToken({
  facebookEmailAddress: 'myfacebookemail@address.com',
  facebookPassword: 'myfacebookpassword',
});

`refreshCredentials`

Refresh an access token and refresh token given a previous access token and refresh token.

Given a single session (across both web and mobile clients) this method will return the existing access token and refresh token pair.

However, given multiple sessions, when a single session signs out, all access tokens are invalidated and must be refreshed.

Use this method to refresh the credentials for existing sessions.

However, this method will not work when a single session exists (and is subsequently logged out of). In such a case, you'll need to call generateToken.

import { generateToken, refreshCredentials } from 'tinder-access-token-generator';

// Generate credentials
const {
  apiToken,
  refreshToken,
} = await generateToken({
  facebookEmailAddress: 'myfacebookemail@address.com',
  facebookPassword: 'myfacebookpassword',
});

// Some time passes...

// Generate updated credentials
const {
  apiToken: updatedApiToken,
  refreshToken: updatedRefreshToken,
} = await refreshCredentials({ apiToken, refreshToken });

Local Development

After cloning the repository, use nvm / npm to install dependencies.

To run all tests, execute npm run test.

To only run integration tests, execute npm run integration-test.

In order to execute local integration tests successfully, you'll need to specify FACEBOOK_EMAIL_ADDRESS, and FACEBOOK_PASSWORD environment variables in a .env file

To build the production bundle, execute npm run build.

Git Hooks

This project uses husky to maintain git hooks.

pre-commit - run eslint
commit-msg - run commit message linting

Commit Linting

This project uses semantic-release and commitlint (specifically the Angular commit convention) to automatically enforce semantic versioning.

Usage no npm install needed!