user-data-for-fraud-prevention

Description

This is an npm library to detect some browser or device details of the user such as Timezone, screen sizes, browser configuration etc. Such details are often required to be sent by software providers to the tax authority in their country to prevent fraud.

Eg: The Tax Authority in the UK (HMRC) requires software providers using some of their APIs to provide consistent headers known as Fraud Prevention headers. This node module collects such information for you in the format required.

Each top level folder in src/js has its own README with more specific information around the use case. E.g. HMRC README

How to use

Usage instructions can be found here

How to test

Instructions for testing the changes can be found here

Contributing

We do not allow contributors to claim issues. If you find something interesting you can contribute to the repo, feel free to raise a PR. We do not require you to let us know in advance.

1. Fork the repo
2. Install dependencies locally by running yarn
3. Make your changes
4. Make sure it builds using yarn build
5. Run the tests (you added tests, right?) with yarn test
6. Test your changes in your consuming code or using our demo project: Run yarn link
7. Ensure the code coverage is the same or higher than before your changes
8. Ensure commit message is properly formatted: type(subject): input. Eg: chore(prettier): update prettier to 2.x
9. Create a PR to the master branch
10. Codeowners will automatically be requested to review, so no need to tag on your PR

Expected Project Structure

The structure shown here is how your code should be organised in the repository

implementation folder should be renamed according to the problem you are solving for eg. the code for HMRC in UK is in the folder named hmrc.

Project
└──src
     └──js
        └──common                // Common and non specific code shoud be put in this folder
        └──implementation       // Implementation specific code for solving problem should be in this folder

How contributors get added to the README

There are two ways to add yourself as a contributor to this repo:

1. Call @all-contributors bot by adding this following comment in a PR: @all-contributors please add [username] for [contributions]. Please refer to the docs for more info.
2. Use the all-contributors-cli by running npx all-contributors add [username] [contributions]. Please refer to the docs for more info.

All parameters are required. See the Emoji Key (Contribution Types Reference) for a list of valid contribution types.

License

License

Changelog

Please see our CHANGELOG

Other Languages

README in other languages:

1. Simplified Chinese
2. Traditional Chinese
3. Spanish
4. German
5. Hindi

Contributors