Overview
A library for generating IDs that are shared verbally or via printed media.
Use cases
- Order IDs on documents that are printed, e.g. in transportation
- Onine game IDs that are shared via text or verbally in a group, e.g. Among Us game codes
- One-time invite codes
Features
- Does not use ambiguous symbols
- Auto-correct common mistakes (mistype or misheard)
For ID being printed and read
Does not use characters that can be misread as numbers
Letter | Number |
---|---|
T | 7 |
O | 0 |
B | 8 |
I | 1 |
For ID being shared verbally
Does not use Q or W, since they are easy to be misheard
Error-correction
Fix function will replace not used chars with their probable origins
Char | Replaced with |
---|---|
T | 7 |
O | 0 |
B | 8 |
I | 1 |
Q | 0 |
Usage
const hfid = require('hfid');
// Generate a random ID
var id = hfid.random(6);
// Fixing user input
var fixedId = hfid.fix('ARTBI'); // returns 'AR781'