@nodezor/dev-seed

Deterministic PRNG seed data generator for development databases and automated testing.

The Problem

Generating schema-compliant, realistic seed data for development databases or automated testing is tedious and prone to staleness. Writing manual mock data files leads to missing edge cases, broken foreign key constraints, and unrealistic data distributions during local testing and QA cycles.

Features

• 🎲 Deterministic PRNG Generation: Uses seedable pseudo-random algorithm for reproducible test snapshots.
• 🛠️ Built-in Mock Primitives: Supports id, name, email, number, boolean, url, date.
• ⚡ Zero External Dependencies: Pure TypeScript native generator.

Installation

# pnpm
pnpm add @nodezor/dev-seed

# npm
npm install @nodezor/dev-seed

# yarn
yarn add @nodezor/dev-seed

Quick Start / Usage Example

import { generateSeedRecords } from '@nodezor/dev-seed';

interface User {
  id: string;
  name: string;
  email: string;
  age: number;
  active: boolean;
}

// Generate 5 deterministic user records
const users = generateSeedRecords<User>(
  {
    id: 'id',
    name: 'name',
    email: 'email',
    age: { kind: 'number', min: 21, max: 65 },
    active: 'boolean',
  },
  { count: 5, seed: 42 }
);

console.log(users);

API Reference

generateSeedRecords<T>(schema: SeedSchema, options?: SeedOptions): T[]

Generates mock data records according to schema definition.

SeedOptions

| Option | Type | Default | Description | | :--- | :--- | :--- | :--- | | count | number | 5 | Number of records to generate | | seed | number | 12345 | PRNG seed number for deterministic output |

License

MIT © PRX2112