import translationKeys from './data/translationKeys' import l33tTableDefault from './data/l33tTable' import { REGEXEN } from './data/const' import { DictionaryReturn } from './matcher/dictionary/scoring' import Matching from './Matching' import { PasswordChanges } from './matcher/dictionary/variants/matching/unmunger/getCleanPasswords' export type TranslationKeys = typeof translationKeys export type L33tTableDefault = typeof l33tTableDefault export interface LooseObject { [key: string]: any } export type Pattern = | 'dictionary' | 'spatial' | 'repeat' | 'sequence' | 'regex' | 'date' | 'bruteforce' | 'separator' | string export type DictionaryNames = | 'passwords' | 'commonWords' | 'firstnames' | 'lastnames' | 'wikipedia' | 'userInputs' export interface Match { /** * @description The name of the matcher */ pattern: Pattern /** * @description The start index of the token found in the password */ i: number /** @description The end index of the token found in the password */ j: number /** * @description The token found in the password */ token: string [key: string]: any } export interface DictionaryMatch extends Match { pattern: 'dictionary' matchedWord: string rank: number dictionaryName: DictionaryNames reversed: boolean l33t: boolean } export interface L33tMatch extends DictionaryMatch { subs: PasswordChanges[] subDisplay: string } export interface SpatialMatch extends Match { pattern: 'spatial' graph: string turns: number shiftedCount: number } export interface RepeatMatch extends Match { pattern: 'repeat' baseToken: string | string[] baseGuesses: number repeatCount: number } export interface SequenceMatch extends Match { pattern: 'sequence' sequenceName: string sequenceSpace: number ascending: boolean } export interface RegexMatch extends Match { pattern: 'regex' regexName: keyof typeof REGEXEN regexMatch: string[] } export interface DateMatch extends Match { pattern: 'date' separator: string year: number month: number day: number } export interface BruteForceMatch extends Match { pattern: 'bruteforce' } export interface SeparatorMatch extends Match { pattern: 'separator' } export type MatchExtended = | DictionaryMatch | L33tMatch | SpatialMatch | RepeatMatch | SequenceMatch | RegexMatch | DateMatch | BruteForceMatch | SeparatorMatch | Match export interface Estimate { guesses: number guessesLog10: number baseGuesses?: number uppercaseVariations?: number l33tVariations?: number } export type MatchEstimated = MatchExtended & Estimate export interface Optimal { m: Match pi: Match g: Match } export interface CrackTimesSeconds { onlineThrottling100PerHour: number onlineNoThrottling10PerSecond: number offlineSlowHashing1e4PerSecond: number offlineFastHashing1e10PerSecond: number } export interface CrackTimesDisplay { onlineThrottling100PerHour: string onlineNoThrottling10PerSecond: string offlineSlowHashing1e4PerSecond: string offlineFastHashing1e10PerSecond: string } export interface FeedbackType { warning: string | null suggestions: string[] } export type OptionsL33tTable = | L33tTableDefault | { [key: string]: string[] } export type OptionsDictionary = { [key: string]: (string | number)[] } export interface OptionsGraphEntry { [key: string]: (string | null)[] } export interface OptionsGraph { [key: string]: OptionsGraphEntry } export interface OptionsType { /** * @description Defines an object with a key value match to translate the feedback given by this library. The default values are plain keys so that you can use your own i18n library. Already implemented language can be found with something like @zxcvbn-ts/language-en. */ translations?: TranslationKeys /** * @description Defines keyboard layouts as an object which are used to find sequences. Already implemented layouts can be found in @zxcvbn-ts/language-common */ graphs?: OptionsGraph /** * @description Define an object with l33t substitutions. For example that an "a" can be exchanged with a "4" or a "@". */ l33tTable?: OptionsL33tTable /** * @description Define dictionary that should be used to check against. The matcher will search the dictionaries for similar password with l33t speak and reversed words. The recommended sets are found in @zxcvbn-ts/language-common and @zxcvbn-ts/language-en. */ dictionary?: OptionsDictionary /** * @description Defines if the levenshtein algorithm should be used. This will be only used on the complete password and not on parts of it. This will decrease the calcTime a bit but will significantly improve the password check. The recommended sets are found in @zxcvbn-ts/language-common and @zxcvbn-ts/language-en. * @default false */ useLevenshteinDistance?: boolean /** * @description Defines how many characters can be different to match a dictionary word with the levenshtein algorithm. * @default 2 */ levenshteinThreshold?: number /** * @description The l33t matcher will check how many characters can be exchanged with the l33t table. If they are to many it will decrease the calcTime significantly. So we cap it at a reasonable value by default which will probably already seems like a strong password anyway. * @default 100 */ l33tMaxSubstitutions?: number /** * @description Defines how many character of the password are checked. A password longer than the default are considered strong anyway, but it can be increased as pleased. Be aware that this could open some attack vectors. * @default 256 */ maxLength?: number } export interface RankedDictionary { [key: string]: number } export interface RankedDictionaries { [key: string]: RankedDictionary } export type DefaultFeedbackFunction = ( match: MatchEstimated, isSoleMatch?: boolean, ) => FeedbackType | null export type DefaultScoringFunction = ( match: MatchExtended | MatchEstimated, ) => number | DictionaryReturn export interface MatchOptions { password: string /** * @description This is the original Matcher so that one can use other matchers to define a baseGuess. An usage example is the repeat matcher */ omniMatch: Matching } export type MatchingType = new () => { match({ password, omniMatch, }: MatchOptions): MatchExtended[] | Promise } export interface Matcher { feedback: DefaultFeedbackFunction scoring: DefaultScoringFunction Matching: MatchingType } export interface Matchers { [key: string]: Matcher } export type Score = 0 | 1 | 2 | 3 | 4 export interface ZxcvbnResult { feedback: FeedbackType crackTimesSeconds: CrackTimesSeconds crackTimesDisplay: CrackTimesDisplay score: Score password: string guesses: number guessesLog10: number sequence: MatchExtended[] calcTime: number }