@engr-lukman/random-string-generator NPM

Random String Generator

A lightweight, TypeScript-compatible utility for generating random strings.

Installation

npm install @engr-lukman/random-string-generator
# or
yarn add @engr-lukman/random-string-generator
# or
pnpm add @engr-lukman/random-string-generator

Demo

Check out the interactive Storybook demo to see the component in action.

Features

Generate random alphanumeric strings of any length
Customize the character set used for generation
Optional timestamp prefix for ensuring uniqueness
Full TypeScript support with type definitions
Zero dependencies
ES6 module compatible
Built for Node.js 20 LTS or higher and modern browsers

Usage

Basic Usage

import { generateRandomString } from '@engr-lukman/random-string-generator';

// Generate a random string with default length (32 characters)
const randomStr = generateRandomString();
console.log(randomStr); // e.g., "8FKP2JH7SQ9RT5VZ3WX1CV6BN4ML0AD"

// Generate a random string with custom length
const shortRandomStr = generateRandomString(8);
console.log(shortRandomStr); // e.g., "7DH9XP3S"

// Generate a unique random string with timestamp prefix
const uniqueStr = generateRandomString(32, { useTimestampPrefix: true });
console.log(uniqueStr); // e.g., "10EFRG2WCV6BN4ML0ADFKP2JH7SQ9RT"

Custom Character Set

import { generateRandomStringWithCharset } from '@engr-lukman/random-string-generator';

// Generate a random string using only numbers
const randomNumbers = generateRandomStringWithCharset(6, '0123456789');
console.log(randomNumbers); // e.g., "847295"

// Generate a random hexadecimal string
const hexString = generateRandomStringWithCharset(16, '0123456789ABCDEF');
console.log(hexString); // e.g., "9A7C3F5D8E2B1064"