Add ascii-printable character set

index.d.ts

@@ -1,4 +1,4 @@
-import {MergeExclusive} from 'type-fest';
+import { MergeExclusive } from 'type-fest';
 
 interface BaseOptions {
 	/**
@@ -35,7 +35,7 @@ interface TypeOption {
 	//=> 'CDEHKM'
 	```
 	*/
-	type?: 'hex' | 'base64' | 'url-safe' | 'numeric' | 'distinguishable';
+	type?: 'hex' | 'base64' | 'url-safe' | 'numeric' | 'distinguishable' | 'ascii-printable';
 }
 
 interface CharactersOption {

index.js

@@ -4,6 +4,7 @@ const crypto = require('crypto');
 const urlSafeCharacters = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-._~'.split('');
 const numericCharacters = '0123456789'.split('');
 const distinguishableCharacters = 'CDEHKMPRTUWXY012458'.split('');
+const asciiPrintableCharacters = ' !"#$%&\'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`abcdefghijklmnopqrstuvwxyz{|}~'.split('');
 
 const generateForCustomCharacters = (length, characters) => {
 	// Generating entropy is faster than complex math operations, so we use the simplest way
@@ -38,7 +39,8 @@ const allowedTypes = [
 	'base64',
 	'url-safe',
 	'numeric',
-	'distinguishable'
+	'distinguishable',
+	'ascii-printable'
 ];
 
 module.exports = ({length, type, characters}) => {
@@ -82,6 +84,10 @@ module.exports = ({length, type, characters}) => {
 		return generateForCustomCharacters(length, distinguishableCharacters);
 	}
 
+	if (type === 'ascii-printable') {
+		return generateForCustomCharacters(length, asciiPrintableCharacters);
+	}
+
 	if (characters.length === 0) {
 		throw new TypeError('Expected `characters` string length to be greater than or equal to 1');
 	}

readme.md

@@ -55,14 +55,16 @@ Length of the returned string.
 
 Type: `string`\
 Default: `'hex'`\
-Values: `'hex' | 'base64' | 'url-safe' | 'numeric' | 'distinguishable'`
+Values: `'hex' | 'base64' | 'url-safe' | 'numeric' | 'distinguishable' | 'ascii-printable'`
 
 Use only characters from a predefined set of allowed characters.
 
 Cannot be set at the same time as the `characters` option.
 
 The `distinguishable` set contains only uppercase characters that are not easily confused: `CDEHKMPRTUWXY012458`. It can be useful if you need to print out a short string that you'd like users to read and type back in with minimal errors. For example, reading a code off of a screen that needs to be typed into a phone to connect two devices.
 
+The `ascii-printable` set contains all [printable ascii characters](https://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters): `` !"#$%&\'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`abcdefghijklmnopqrstuvwxyz{|}~``
+
 ##### characters
 
 Type: `string`\

test.js

@@ -62,6 +62,13 @@ test('distinquishable', t => {
 	t.is(generatedCharacterSetSize({type: 'distinguishable'}, 19), 19);
 });
 
+test('ascii-printable', t => {
+	t.is(cryptoRandomString({length: 0, type: 'ascii-printable'}).length, 0);
+	t.is(cryptoRandomString({length: 10, type: 'ascii-printable'}).length, 10);
+	t.is(cryptoRandomString({length: 100, type: 'ascii-printable'}).length, 100);
+	t.regex(cryptoRandomString({length: 100, type: 'ascii-printable'}), /^[ !"#$%&'()*+,-./\d:;<=>?@A-Z[\\\]^_`a-z{|}~]*$/); // Sanity check, probabilistic
+});
+
 test('characters', t => {
 	t.is(cryptoRandomString({length: 0, characters: '1234'}).length, 0);
 	t.is(cryptoRandomString({length: 10, characters: '1234'}).length, 10);