seed-wizard 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Saurabh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,102 @@
+# 🧙‍♂️ Seed Wizard
+
+> **Stop writing insert statements by hand.** Seed Wizard is a powerful, stretchable CLI tool for generating realistic dummy data for SQL and NoSQL databases — in seconds.
+
+
+---
+
+## ✨ Features
+
+| Feature | Description |
+|---|---|
+| 🗄️ Multi-Database | Generate `.sql` for PostgreSQL/MySQL or `.json` for MongoDB/Firebase |
+| 🇮🇳 Indian Locale | Built-in support for **+91 phone formats**, Indian cities, and addresses |
+| 📊 Beautiful UX | Real-time **progress bars** and a colored dashboard in your terminal |
+| 🧠 Type Smart | Auto-detects numbers vs. strings; handles SQL escaping (`O'Connor` → `'O''Connor'`) |
+| 🔧 Stretchable Schema | Pass exactly the columns you need as CLI arguments — no config files |
+
+---
+
+## 📦 Installation
+
+```bash
+npm install -g seed-wizard-cli
+```
+
+---
+
+## 🛠️ Usage
+
+### Show Help & Dashboard
+
+```bash
+seed-wizard --help
+```
+
+### Generate SQL (PostgreSQL / MySQL)
+
+```bash
+seed-wizard sql <table> "<columns>" <count>
+```
+
+**Example:**
+
+```bash
+seed-wizard sql users "name, age, phone, balance, city" 100
+```
+
+### Generate JSON (MongoDB / Firebase)
+
+```bash
+seed-wizard json <collection> "<columns>" <count>
+```
+
+**Example:**
+
+```bash
+seed-wizard json products "product, price, description, date" 50
+```
+
+---
+
+## 🔑 Available Data Keywords
+
+| Category | Keywords |
+|---|---|
+| 👤 Personal | `name`, `email`, `phone` *(+91)*, `age`, `gender`, `avatar` |
+| 📍 Location | `city`, `address`, `country`, `zip` |
+| 💼 Business | `balance`, `company`, `job`, `price`, `product` |
+| ⚙️ System | `id`, `date`, `password`, `description`, `boolean` |
+
+---
+
+## 💡 Examples
+
+**Banking / Fintech:**
+```bash
+seed-wizard sql customers "name, balance, age, phone" 500
+```
+
+**E-commerce Inventory:**
+```bash
+seed-wizard json inventory "product, price, description" 20
+```
+
+**User Profiles:**
+```bash
+seed-wizard sql profiles "name, email, age, city, gender, avatar" 200
+```
+
+---
+
+## 🗂️ Output
+
+- **SQL mode** → generates a `.sql` file with ready-to-run `INSERT` statements
+- **JSON mode** → generates a `.json` file importable into MongoDB, Firebase, or any document store
+
+---
+
+## 📄 License
+
+MIT © [Saurabh Jadhav](https://github.com/saurabhj2k3)
+

package/bin/cli.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+const { generateSQL, generateJSON } = require('../index.js');
+const chalk = require('chalk');
+
+const args = process.argv.slice(2);
+
+// Dashboard / Help Menu Function
+function showHelp() {
+    console.log(chalk.bold.magenta('\n' + '═'.repeat(60)));
+    console.log(chalk.bold.white('  🧙‍♂️ SEED WIZARD - THE ULTIMATE DATA GENERATOR'));
+    console.log(chalk.bold.magenta('═'.repeat(60)));
+    
+    console.log(chalk.bold.cyan('\n🚀 QUICK START:'));
+    console.log(chalk.white('  seed-wizard <format> <filename> <columns> <count>'));
+    
+    console.log(chalk.yellow('\n📂 SUPPORTED FORMATS:'));
+    console.log(chalk.white('  sql  ') + chalk.gray('➜ Perfect for PostgreSQL, MySQL, Supabase'));
+    console.log(chalk.white('  json ') + chalk.gray('➜ Perfect for MongoDB, Firebase, Frontend Mocks'));
+
+    console.log(chalk.yellow('\n✨ AVAILABLE DATA KEYWORDS:'));
+    console.log(chalk.white('  👤 ') + chalk.bold('Personal: ') + chalk.white('name, email, phone, age, gender, avatar'));
+    console.log(chalk.white('  📍 ') + chalk.bold('Location: ') + chalk.white('city, address, country, zip'));
+    console.log(chalk.white('  💰 ') + chalk.bold('Business: ') + chalk.white('balance, company, job, price, product'));
+    console.log(chalk.white('  ⚙️  ') + chalk.bold('System:   ') + chalk.white('id, date, password, description'));
+
+    console.log(chalk.bold.cyan('\n📝 REAL-WORLD EXAMPLES:'));
+    console.log(chalk.white('  1. Create 50 Bank Customers (SQL):'));
+    console.log(chalk.green('     seed-wizard sql customers "name, balance, city, phone" 50'));
+    
+    console.log(chalk.white('\n  2. Create 20 E-commerce Products (JSON):'));
+    console.log(chalk.green('     seed-wizard json products "product, price, description" 20'));
+
+    console.log(chalk.white('\n  3. Create Social Media Profiles (JSON):'));
+    console.log(chalk.green('     seed-wizard json profiles "name, avatar, age, gender" 100'));
+
+    console.log(chalk.bold.magenta('\n' + '═'.repeat(60) + '\n'));
+    process.exit(0);
+}
+
+// Logic to handle commands
+if (args.includes('--help') || args.includes('-h') || args.length < 3) {
+    showHelp();
+}
+
+const [format, name, columns, count] = args;
+const columnsArray = columns.split(/[ ,]+/).filter(Boolean);
+const totalRecords = count ? parseInt(count) : 10;
+
+if (format.toLowerCase() === 'sql') {
+    generateSQL(name, columnsArray, totalRecords);
+} else if (format.toLowerCase() === 'json') {
+    generateJSON(name, columnsArray, totalRecords);
+} else {
+    console.log(chalk.bold.red('\n❌ Error: Unknown format "' + format + '"'));
+    showHelp();
+}

package/index.js

@@ -0,0 +1,118 @@
+const { faker } = require('@faker-js/faker');
+const fs = require('fs');
+const chalk = require('chalk');
+const cliProgress = require('cli-progress');
+
+/**
+ * Data Library: The "Stretchable" Core
+ * Add any new keywords here to expand the wizard's knowledge.
+ */
+function getFakerData(type) {
+    const map = {
+        // Personal Info
+        name: () => faker.person.fullName(),
+        email: () => faker.internet.email(),
+        phone: () => faker.helpers.fromRegExp('+91 [6-9][0-9]{9}'), // Indian Mobile Format
+        age: () => faker.number.int({ min: 18, max: 75 }),
+        gender: () => faker.person.sex(),
+        avatar: () => faker.image.avatar(),
+        
+        // Location
+        city: () => faker.location.city(),
+        address: () => faker.location.streetAddress(),
+        country: () => faker.location.country(),
+        zip: () => faker.location.zipCode(),
+        
+        // Business & Finance
+        balance: () => faker.finance.amount(),
+        company: () => faker.company.name(),
+        job: () => faker.person.jobTitle(),
+        price: () => faker.commerce.price(),
+        product: () => faker.commerce.productName(),
+        
+        // Tech & System
+        id: () => faker.string.uuid(),
+        date: () => faker.date.recent().toISOString(),
+        description: () => faker.commerce.productDescription(),
+        password: () => faker.internet.password(),
+        boolean: () => faker.datatype.boolean()
+    };
+    
+    // Fallback: If type isn't found, return a random word
+    return map[type] ? map[type]() : faker.word.sample();
+}
+
+/**
+ * SQL Generator with Progress Bar and Type Safety
+ */
+function generateSQL(tableName, columnsArray, count) {
+    const bar = new cliProgress.SingleBar({
+        format: chalk.magenta('SQL Generation') + ' |' + chalk.magenta('{bar}') + '| {percentage}% || {value}/{total} Rows',
+        barCompleteChar: '\u2588',
+        barIncompleteChar: '\u2591',
+        hideCursor: true
+    });
+
+    bar.start(count, 0);
+    let sql = `-- Seed data generated for table: ${tableName}\n`;
+    
+    for (let i = 0; i < count; i++) {
+        const columns = columnsArray.join(', ');
+        const values = columnsArray.map(col => {
+            let data = getFakerData(col);
+            
+            // Handle SQL Data Types
+            // Numbers (age, balance, price) should NOT have quotes
+            const isNumber = !isNaN(data) && typeof data !== 'boolean' && col !== 'phone';
+            
+            if (typeof data === 'string') {
+                data = data.replace(/'/g, "''"); // Escape single quotes for SQL
+                return isNumber ? data : `'${data}'`;
+            }
+            return data;
+        }).join(', ');
+        
+        sql += `INSERT INTO ${tableName} (${columns}) VALUES (${values});\n`;
+        bar.update(i + 1);
+    }
+
+    bar.stop();
+    fs.writeFileSync(`${tableName}.sql`, sql);
+    console.log(chalk.green(`\n✔ Success! File "${tableName}.sql" created with ${count} records.`));
+}
+
+/**
+ * JSON Generator with Progress Bar
+ */
+function generateJSON(collectionName, columnsArray, count) {
+    const bar = new cliProgress.SingleBar({
+        format: chalk.cyan('JSON Generation') + ' |' + chalk.cyan('{bar}') + '| {percentage}% || {value}/{total} Objects',
+        barCompleteChar: '\u2588',
+        barIncompleteChar: '\u2591',
+        hideCursor: true
+    });
+
+    bar.start(count, 0);
+    const data = [];
+
+    for (let i = 0; i < count; i++) {
+        const doc = {};
+        columnsArray.forEach(col => {
+            let val = getFakerData(col);
+            
+            // Clean numeric strings for JSON objects
+            if (['balance', 'price', 'age'].includes(col)) {
+                val = parseFloat(val);
+            }
+            doc[col] = val;
+        });
+        data.push(doc);
+        bar.update(i + 1);
+    }
+
+    bar.stop();
+    fs.writeFileSync(`${collectionName}.json`, JSON.stringify(data, null, 2));
+    console.log(chalk.blue(`\n✔ Success! File "${collectionName}.json" created with ${count} objects.`));
+}
+
+module.exports = { generateSQL, generateJSON };

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "seed-wizard",
+  "version": "1.0.0",
+  "description": "A dynamic CLI tool to generate realistic SQL and JSON seed data with progress bars.",
+  "main": "index.js",
+  "bin": {
+    "seed-wizard": "bin/cli.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "start": "node bin/cli.js"
+  },
+  "keywords": [
+    "seed",
+    "faker",
+    "sql",
+    "mongodb",
+    "cli",
+    "data-generator"
+  ],
+  "author": "Saurabh Jadhav",
+  "license": "MIT",
+  "dependencies": {
+    "@faker-js/faker": "^9.9.0",
+    "chalk": "^4.1.2",
+    "cli-progress": "^3.12.0"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/your-username/seed-wizard.git"
+  }
+}