How Secure Is My Password?

These modules are written using PureScript and then transpiled into JavaScript. You do not need to know PureScript to use the built versions of the code as it functions as a standard JS library.

Usage

Using ES6 modules:

// import the hsimp-purescript module
import setup from "hsimp-purescript";

import language from "hsimp-purescript/language/english";
import characterSets from "hsimp-purescript/data/character-sets";
import common from "hsimp-purescript/data/common/top10k";
import patterns from "hsimp-purescript/data/patterns";

// create the hsimp function
// if passed valid config, setup will return a function
const hsimp = setup({
    // the number of calculations per second a computer can do
    calculationsPerSecond: 40e9,

    // whether to display named numbers
    namedNumbers: true,

    // a language file
    language,

    // different checks
    checks: {
        // character sets to check
        characterSets,

        // common passwords to check
        common,

        // patterns to check
        patterns,
    }
});

// to run
const result = hsimp("HowSecureIsMyPassword?");

You will get back an object with the following structure:

{
    // how long it would take to crack the password as a human readable string
    time: "42 minutes",

    // the highest level of check (e.g. insecure, warning, notice - see below)
    level: "notice",

    // the checks - in level of importance
    checks: [
        {
            name: "Character Variety: No Symbols",
            message: "Your password only contains numbers and letters. Adding a symbol can make your password more secure. Don\'t forget you can often use spaces in passwords.",
            level: "notice",
        },
        // ...and so on
    ]
}

See dist/test.js for a fully working version of the code in Node.

Levels

There are five levels:

• insecure: a really bad password, probably very common
• warning: might be ok, but things to be aware of
• easter-egg: they've found something silly
• notice: nothing major
• achievement: something to be proud of

Building

To build the code you'll require spago. Then just run make. However, the latest build should always be available in the dist directory.