dummy-data-factory 🚀

A powerful TypeScript library for generating realistic dummy data for various entities including users, products, addresses, companies, and financial data.

🌟 Features

• Generate dummy users, products, addresses, companies, and financial data
• Fully typed with TypeScript
• Easy to use and customize
• Lightweight and dependency-free
• Supports bulk data generation

🛠 Installation

Install the package using npm:

npm install dummy-data-factory

📋 Quick Start Guide

1. Import Generators

import { 
  UserGenerator, 
  ProductGenerator, 
  AddressGenerator, 
  CompanyGenerator,
  FinancialDataGenerator 
} from 'dummy-data-factory';

2. Generate Dummy Data

Generate Single Entities

// User Generator
const userFactory = UserGenerator.generateUser();

// Company Generator
const companyFactory = CompanyGenerator.generateCompany();

// Address Generator
const addressFactory = AddressGenerator.generateAddress();

// Product Generator
const productFactory = ProductGenerator.generateProduct();

// Financial Data Generators
const financialGenerator = new FinancialDataGenerator();

// Generate single financial entities
const creditCard = financialGenerator.generateCreditCard();
const bankAccount = financialGenerator.generateBankAccount();
const transaction = financialGenerator.generateTransaction();
const cryptoWallet = financialGenerator.generateCryptocurrencyWallet();
const investment = financialGenerator.generateInvestment();

console.log(creditCard);
// Output: 
// {
//   id: 'unique-id-string',
//   cardNumber: '1234567890123456',
//   cardType: 'Visa',
//   expirationMonth: 8,
//   expirationYear: 2030,
//   cvv: '456',
//   limit: 25000
// }

Generate Multiple Entities

// Generate multiple entities
const userFactories = UserGenerator.generateUsers(20);
const companyFactories = CompanyGenerator.generateCompanies(20);
const addressFactories = AddressGenerator.generateAddresses(20);
const productFactories = ProductGenerator.generateProducts(20);

// Financial Data Bulk Generation
const financialGenerator = new FinancialDataGenerator();

// Generate multiple financial entities
const creditCards = financialGenerator.generateMultiple(
  () => financialGenerator.generateCreditCard(), 
  5
);
const bankAccounts = financialGenerator.generateMultiple(
  () => financialGenerator.generateBankAccount(), 
  5
);
const transactions = financialGenerator.generateMultiple(
  () => financialGenerator.generateTransaction(), 
  10
);

// Generate a complete financial profile
const financialProfile = financialGenerator.generateFinancialProfile();

💰 Financial Data Types

The library supports generating the following financial data types:

• Credit Cards
• Bank Accounts
• Transactions
• Cryptocurrency Wallets
• Investments
• Comprehensive Financial Profiles

Financial Data Features

• Realistic data generation
• Supports multiple card types, bank account types, and cryptocurrencies
• Random balance and limit generation
• Unique ID and number generation
• Date ranges for transactions and investments

🎨 Customization

Each generator uses predefined lists of names, categories, etc. You can extend or modify these in your own code if needed.

🚀 Performance

• Generates data quickly
• Low memory footprint
• No external dependencies

🤝 Contributing

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a new Pull Request

📜 License

MIT License

🐛 Issues

Report issues on the GitHub repository's issue tracker.

📞 Support

For support, email: [email protected] or open an issue on GitHub.