@arraypress/seed

Random data generators for seed scripts and test fixtures. Realistic names, emails, dates, IPs, countries, and user agents.

Zero dependencies. Works in any JS runtime.

Installation

npm install @arraypress/seed

Usage

import {
  randomName, randomEmail, randomDate, randomIP,
  randomCountry, pick, randInt, escapeSQL, generate, uniqueFrom,
} from '@arraypress/seed';

// Generate 50 test customers
const customers = generate(50, (i) => ({
  id: i + 1,
  name: randomName(),            // 'Emma Johnson'
  email: randomEmail(),           // '[email protected]'
  country: randomCountry(),       // 'DE'
  created_at: randomDate(400),    // '2025-08-14 09:23:41'
}));

// Build SQL
for (const c of customers) {
  console.log(`INSERT INTO customers (name, email, country, created_at)
    VALUES (${escapeSQL(c.name)}, ${escapeSQL(c.email)}, ${escapeSQL(c.country)}, ${escapeSQL(c.created_at)});`);
}

API

Core Utilities

pick(['usd', 'usd', 'gbp', 'eur'])     // weighted random pick
randInt(500, 9900)                       // random integer
uniqueFrom(randomEmail, 50)             // 50 unique emails
generate(100, (i) => ({ id: i + 1 }))   // batch generate

Generators

randomFirstName()     // 'Emma'
randomLastName()      // 'Johnson'
randomName()          // 'Emma Johnson'
randomEmail()         // '[email protected]'
randomDate(365)       // '2025-08-14 09:23:41' (past year)
randomDateBetween('2025-01-01', '2025-12-31')  // within range
randomIP()            // '142.58.201.33'
randomUserAgent()     // 'Mozilla/5.0 (Windows...) Chrome/120...'
randomCountry()       // 'DE'

SQL Helper

escapeSQL("O'Brien")     // "'O''Brien'"
escapeSQL(null)          // 'NULL'
escapeSQL(42)            // '42'
escapeSQL(true)          // '1'

Real-World Example

import { generate, randomName, randomEmail, randomCountry, randomDate, randomIP,
         pick, randInt, uniqueFrom, escapeSQL } from '@arraypress/seed';

// Unique product names
const productNames = uniqueFrom(
  () => `${pick(adjectives)} ${pick(nouns)} Vol. ${randInt(1, 50)}`,
  100
);

// Customers
const customers = generate(50, () => ({
  name: randomName(),
  email: randomEmail(),
  country: randomCountry(),
  created_at: randomDate(400),
}));

// Orders with weighted status
const statuses = ['completed', 'completed', 'completed', 'completed',
                  'partially_refunded', 'refunded'];

const orders = generate(1000, (i) => ({
  id: `pi_test_${String(i + 1).padStart(5, '0')}`,
  email: pick(customers).email,
  status: pick(statuses),
  amount: randInt(5, 99) * 100,
  currency: pick(['usd', 'usd', 'usd', 'gbp', 'eur']),
  country: randomCountry(),
  ip: randomIP(),
  created_at: randomDate(365),
}));

TypeScript

Full type definitions included.

import { generate, randomName, pick } from '@arraypress/seed';

interface Customer {
  name: string;
  email: string;
}

const customers: Customer[] = generate(50, () => ({
  name: randomName(),
  email: randomEmail(),
}));

License

MIT