Simple Password Rules

Have you ever needed to implement password policies for your codebase? This module attempts to simplify that.

import{password,min,max,hasDigit,hasSpecial}from'simple-password-rules'constcheck=password(min(8),max(16),hasDigit(1),hasSpecial(1))consterrors=check('password1')if(errors){thrownewError(errors)// The password provided does not contain enough "special" characters. Needs 1 more. }

---

password

A function to create a password policy.

Parameters

• rules...Array<function (str: string): (string | undefined)>

Returns function (str: any): string A string if there is an error, undefined otherwise.

min

Parameters

• numnumber

Returns function (str: any): string A string if there is an error, undefined otherwise.

max

Parameters

• numnumber

Returns function (str: any): string A string if there is an error, undefined otherwise.

has

Parameters

• charSetstring The characters to check for.
• numnumber? The minimum characters required.
• namestring?

Returns function (str: any): string A string if there is an error, undefined otherwise.

hasLowerCase

Parameters

• numnumber? The minimum characters required.

Returns function (str: any): string A string if there is an error, undefined otherwise.

hasUpperCase

Parameters

• numnumber? The minimum characters required.

Returns function (str: any): string A string if there is an error, undefined otherwise.

hasSpecial

Parameters

• numnumber? The minimum characters required.

Returns function (str: any): string A string if there is an error, undefined otherwise.

hasDigit

Parameters

• numnumber? The minimum characters required.

Returns function (str: any): string A string if there is an error, undefined otherwise.

includes

Parameters

• requiredText(string | Array<string>)

Returns function (str: any): string A string if there is an error, undefined otherwise.

notIncludes

Parameters

• requiredText(string | Array<string>)
• substitute(string | boolean | function (text: string): string)?

Returns function (str: any): string A string if there is an error, undefined otherwise.

some

Checks if some of the rules were followed, if a number is included at the end, it will check if at least that many rules were followed.

Parameters

• rules...Array<(number | function (str: string): (string | undefined))>

Returns function (str: any): string A string if there is an error, undefined otherwise.

not

Inverts the result of a rule, allowing you to specify text.

Parameters

• rulefunction (str: string): string
• errorstring

Returns function (str: any): string A string if there is an error, undefined otherwise.

template

Parses the string template to make it simple to create templates. "$" is the magic symbol that lets you reference the argument. Only works with template functions with less than 10 arguments, and doesn't let you traverse (input to the function should be strings).

Parameters

• stringTemplatestring

Returns function (...args: Array<string>): string