flashorm 2.4.0 → 2.4.5

package/README.md

@@ -4,16 +4,17 @@ A powerful, database-agnostic migration CLI tool built in Go with multi-database
 
 ## ✨ Features
 
-- 🎨 **FlashORM Studio**: Visual database editor with React-based schema visualization
-- 🗃️ **Multi-Database Support**: PostgreSQL, MySQL, SQLite
-- 🔄 **Migration Management**: Create, apply, and track migrations
+- 🗃️ **Multi-Database Support**: PostgreSQL, MySQL, SQLite, ScyllaDB / Cassandra, ClickHouse
+- 🔄 **Migration Management**: Create, apply, rollback, and track migrations
+- 🌿 **Schema Branching**: Git-like branching for database schemas
+- 🌱 **Database Seeding**: Generate realistic fake data for development
 - 🔒 **Safe Migration System**: Transaction-based execution with automatic rollback
 - 📤 **Smart Export System**: Multiple formats (JSON, CSV, SQLite)
 - 🔧 **Type-Safe Code Generation**: Generate fully typed JavaScript/TypeScript code
-- ⚡ **Blazing Fast**: 2.5x faster than Drizzle, 10x faster than Prisma
+- ⚡ **Blazing Fast**: 2.8x faster than Drizzle, 11.9x faster than Prisma
 - 💻 **Raw SQL Execution**: Execute SQL files or inline queries
 - 🎯 **Prisma-like Commands**: Familiar CLI interface
-- 🎨 **Enum Support**: Full PostgreSQL ENUM support
+- 🎨 **Enum Support**: Full PostgreSQL ENUM support with generated union types
 
 ## 📊 Performance
 
@@ -52,14 +53,14 @@ flash --version
 ### 1. Initialize Project
 
 ```bash
-flash init --postgresql  # or --mysql, --sqlite
+flash init --postgresql  # or --mysql, --sqlite, --scylla, --clickhouse
 ```
 
 This creates:
 
 ```
 your-project/
-├── flash.config.json
+├── flash.toml
 ├── .env
 └── db/
     ├── schema/
@@ -222,14 +223,15 @@ main().catch((err) => {
 ### Visual Database Editor
 
 ```bash
-# Launch FlashORM Studio (web-based database editor)
+# Launch FlashORM Studio (web-based database editor for PostgreSQL, MySQL, SQLite,
+# ScyllaDB, ClickHouse, MongoDB, and Redis)
 flash studio
 
 # Launch on custom port
 flash studio --port 3000
 
 # Connect to any database directly
-flash studio --db "postgresql://user:pass@localhost:5432/mydb"
+flash studio "postgresql://user:pass@localhost:5432/mydb"
 
 # Launch without opening browser
 flash studio --browser=false
@@ -251,6 +253,8 @@ flash studio --browser=false
 flash init --postgresql
 flash init --mysql
 flash init --sqlite
+flash init --scylla
+flash init --clickhouse
 ```
 
 ### Migrations
@@ -306,6 +310,39 @@ flash export --csv
 flash export --sqlite
 ```
 
+### Database Seeding
+
+```bash
+# Seed all tables with default count
+flash seed
+
+# Seed with custom count
+flash seed --count 100
+
+# Seed specific tables with different counts
+flash seed users:100 posts:500
+
+# Truncate before seeding
+flash seed --truncate --force
+```
+
+### Schema Branching
+
+```bash
+# Create a feature branch
+flash branch create feature/new-schema
+
+# Switch between branches
+flash checkout feature/new-schema
+flash checkout main
+
+# List branches
+flash branch list
+
+# Merge branches
+flash branch merge feature/new-schema
+```
+
 ### Database Operations
 
 ```bash
@@ -344,25 +381,21 @@ flash <command> --help
 
 ## ⚙️ Configuration
 
-**flash.config.json**
+**flash.toml**
 
-```json
-{
-  "version": "2",
-  "schema_path": "db/schema/schema.sql",
-  "queries": "db/queries/",
-  "migrations_path": "db/migrations",
-  "export_path": "db/export",
-  "database": {
-    "provider": "postgresql",
-    "url_env": "DATABASE_URL"
-  },
-  "gen": {
-    "js": {
-      "enabled": true
-    }
-  }
-}
+```toml
+version = "2"
+schema_dir = "db/schema"
+queries = "db/queries/"
+migrations_path = "db/migrations"
+export_path = "db/export"
+
+[database]
+provider = "postgresql"
+url_env = "DATABASE_URL"
+
+[gen.js]
+enabled = true
 ```
 
 ## 🎨 PostgreSQL ENUM Support
@@ -621,8 +654,8 @@ flash studio --port 3000
 - **Visual Database Editor**: Manage your database visually with FlashORM Studio
 - **Raw SQL Support**: Execute SQL files or queries directly from CLI
 - **Type-Safe**: Full TypeScript support with generated types
-- **Fast**: 2.5x-10x faster than popular ORMs
-- **Multi-DB**: PostgreSQL, MySQL, and SQLite support
+- **Fast**: 2.8x-11.9x faster than popular ORMs
+- **Multi-DB**: PostgreSQL, MySQL, SQLite, ScyllaDB, Cassandra, ClickHouse
 - **Zero Config**: Works out of the box with sensible defaults
 
 ## 📄 License

package/bin/flash.js

@@ -1,52 +1,52 @@
-#!/usr/bin/env node
-
-const { spawn } = require('child_process');
-const path = require('path');
-const fs = require('fs');
-
-const platform = process.platform;
-const binaryName = platform === 'win32' ? 'flash.exe' : 'flash';
-const binaryPath = path.join(__dirname, binaryName);
-
-// If binary doesn't exist, try to download it
-if (!fs.existsSync(binaryPath)) {
-  console.log('📥 Binary not found. Downloading...');
-  
-  // Import and wait for download
-  const downloadPromise = require('../scripts/download.js');
-  
-  downloadPromise
-    .then(() => {
-      if (!fs.existsSync(binaryPath)) {
-        console.error('❌ Download completed but binary not found. Please try: npm install flashorm --force');
-        process.exit(1);
-      }
-      executeBinary();
-    })
-    .catch((err) => {
-      console.error('❌ Failed to download flash binary');
-      console.error('Error:', err.message);
-      console.error('');
-      console.error('Please try: npm install flashorm --force');
-      process.exit(1);
-    });
-} else {
-  // Binary exists, execute it
-  executeBinary();
-}
-
-function executeBinary() {
-  const child = spawn(binaryPath, process.argv.slice(2), {
-    stdio: 'inherit',
-    windowsHide: true
-  });
-
-  child.on('exit', (code) => {
-    process.exit(code || 0);
-  });
-
-  child.on('error', (err) => {
-    console.error('❌ Failed to start flash:', err);
-    process.exit(1);
-  });
-}
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const platform = process.platform;
+const binaryName = platform === 'win32' ? 'flash.exe' : 'flash';
+const binaryPath = path.join(__dirname, binaryName);
+
+// If binary doesn't exist, try to download it
+if (!fs.existsSync(binaryPath)) {
+  console.log('📥 Binary not found. Downloading...');
+  
+  // Import and wait for download
+  const downloadPromise = require('../scripts/download.js');
+  
+  downloadPromise
+    .then(() => {
+      if (!fs.existsSync(binaryPath)) {
+        console.error('❌ Download completed but binary not found. Please try: npm install flashorm --force');
+        process.exit(1);
+      }
+      executeBinary();
+    })
+    .catch((err) => {
+      console.error('❌ Failed to download flash binary');
+      console.error('Error:', err.message);
+      console.error('');
+      console.error('Please try: npm install flashorm --force');
+      process.exit(1);
+    });
+} else {
+  // Binary exists, execute it
+  executeBinary();
+}
+
+function executeBinary() {
+  const child = spawn(binaryPath, process.argv.slice(2), {
+    stdio: 'inherit',
+    windowsHide: true
+  });
+
+  child.on('exit', (code) => {
+    process.exit(code || 0);
+  });
+
+  child.on('error', (err) => {
+    console.error('❌ Failed to start flash:', err);
+    process.exit(1);
+  });
+}

package/index.js

@@ -1,28 +1,28 @@
-const { execSync } = require('child_process');
-const path = require('path');
-const fs = require('fs');
-
-function getBinaryPath() {
-  const platform = process.platform;
-  const binaryName = platform === 'win32' ? 'flash.exe' : 'flash';
-  const binaryPath = path.join(__dirname, 'bin', binaryName);
-  
-  if (!fs.existsSync(binaryPath)) {
-    throw new Error('flash binary not found. Please reinstall: npm install -g flashorm');
-  }
-  
-  return binaryPath;
-}
-
-function exec(command, options = {}) {
-  const binaryPath = getBinaryPath();
-  return execSync(`"${binaryPath}" ${command}`, {
-    encoding: 'utf8',
-    ...options
-  });
-}
-
-module.exports = {
-  getBinaryPath,
-  exec
-};
+const { execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+function getBinaryPath() {
+  const platform = process.platform;
+  const binaryName = platform === 'win32' ? 'flash.exe' : 'flash';
+  const binaryPath = path.join(__dirname, 'bin', binaryName);
+  
+  if (!fs.existsSync(binaryPath)) {
+    throw new Error('flash binary not found. Please reinstall: npm install -g flashorm');
+  }
+  
+  return binaryPath;
+}
+
+function exec(command, options = {}) {
+  const binaryPath = getBinaryPath();
+  return execSync(`"${binaryPath}" ${command}`, {
+    encoding: 'utf8',
+    ...options
+  });
+}
+
+module.exports = {
+  getBinaryPath,
+  exec
+};

package/package.json

@@ -1,52 +1,52 @@
-{
-  "name": "flashorm",
-  "version": "2.4.0",
-  "description": "A powerful, database-agnostic ORM with plugin-based architecture - Base CLI only",
-  "main": "index.js",
-  "bin": {
-    "flash": "./bin/flash.js"
-  },
-  "keywords": [
-    "orm",
-    "database",
-    "migration",
-    "sqlc",
-    "postgresql",
-    "mysql",
-    "sqlite",
-    "cli",
-    "typescript",
-    "javascript",
-    "type-safe",
-    "plugins"
-  ],
-  "author": "Rana718",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/Lumos-Labs-HQ/flash.git"
-  },
-  "homepage": "https://github.com/Lumos-Labs-HQ/flash#readme",
-  "bugs": {
-    "url": "https://github.com/Lumos-Labs-HQ/flash/issues"
-  },
-  "engines": {
-    "node": ">=14.0.0"
-  },
-  "os": [
-    "darwin",
-    "linux",
-    "win32"
-  ],
-  "cpu": [
-    "x64",
-    "arm64"
-  ],
-  "files": [
-    "bin/",
-    "scripts/download.js",
-    "index.js",
-    "README.md"
-  ],
-  "optionalDependencies": {}
-}
+{
+  "name": "flashorm",
+  "version": "2.4.5",
+  "description": "A powerful, database-agnostic ORM with plugin-based architecture - Base CLI only",
+  "main": "index.js",
+  "bin": {
+    "flash": "./bin/flash.js"
+  },
+  "keywords": [
+    "orm",
+    "database",
+    "migration",
+    "sqlc",
+    "postgresql",
+    "mysql",
+    "sqlite",
+    "cli",
+    "typescript",
+    "javascript",
+    "type-safe",
+    "plugins"
+  ],
+  "author": "Rana718",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Lumos-Labs-HQ/flash.git"
+  },
+  "homepage": "https://github.com/Lumos-Labs-HQ/flash#readme",
+  "bugs": {
+    "url": "https://github.com/Lumos-Labs-HQ/flash/issues"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "files": [
+    "bin/",
+    "scripts/download.js",
+    "index.js",
+    "README.md"
+  ],
+  "optionalDependencies": {}
+}

package/scripts/download.js

@@ -1,152 +1,152 @@
-#!/usr/bin/env node
-
-const https = require('https');
-const fs = require('fs');
-const path = require('path');
-
-const VERSION = '2.4.0';
-const REPO = 'Lumos-Labs-HQ/flash';
-
-const platform = process.platform;
-const arch = process.arch;
-
-const platformMap = {
-    'darwin': 'darwin',
-    'linux': 'linux',
-    'win32': 'windows'
-};
-
-const archMap = {
-    'x64': 'amd64',
-    'arm64': 'arm64'
-};
-
-const mappedPlatform = platformMap[platform];
-const mappedArch = archMap[arch];
-
-if (!mappedPlatform || !mappedArch) {
-    console.error(`❌ Unsupported platform: ${platform}-${arch}`);
-    process.exit(1);
-}
-
-const binaryName = platform === 'win32' ? 'flash.exe' : 'flash';
-const downloadName = `flash-${mappedPlatform}-${mappedArch}${platform === 'win32' ? '.exe' : ''}`;
-const downloadUrl = `https://github.com/${REPO}/releases/download/v${VERSION}/${downloadName}`;
-
-const binDir = path.join(__dirname, '..', 'bin');
-const binaryPath = path.join(binDir, binaryName);
-
-// Clean up binaries for other platforms
-function cleanupOtherBinaries() {
-    try {
-        const files = fs.readdirSync(binDir);
-        files.forEach(file => {
-            const filePath = path.join(binDir, file);
-            if (file.startsWith('flash') && file !== 'flash.js' && file !== binaryName) {
-                try {
-                    fs.unlinkSync(filePath);
-                    console.log(`🧹 Removed unused binary: ${file}`);
-                } catch (err) {
-                    // Ignore cleanup errors
-                }
-            }
-        });
-    } catch (err) {
-        // Ignore if bin dir doesn't exist
-    }
-}
-
-// Skip if binary already exists for this platform
-if (fs.existsSync(binaryPath)) {
-    console.log(`✅ Binary already exists for ${platform}-${arch}`);
-    cleanupOtherBinaries();
-    process.exit(0);
-}
-
-console.log(`📦 Installing FlashORM v${VERSION} for ${platform}-${arch}...`);
-console.log(`📥 Downloading from: ${downloadUrl}`);
-
-if (!fs.existsSync(binDir)) {
-    fs.mkdirSync(binDir, { recursive: true });
-}
-
-function downloadBinary(url) {
-    return new Promise((resolve, reject) => {
-        const file = fs.createWriteStream(binaryPath);
-
-        https.get(url, (response) => {
-            if (response.statusCode === 302 || response.statusCode === 301) {
-                // Follow redirect
-                file.close();
-                fs.unlinkSync(binaryPath);
-                downloadBinary(response.headers.location).then(resolve).catch(reject);
-                return;
-            }
-
-            if (response.statusCode !== 200) {
-                file.close();
-                fs.unlinkSync(binaryPath);
-                reject(new Error(`Download failed with status ${response.statusCode}`));
-                return;
-            }
-
-            response.pipe(file);
-
-            file.on('finish', () => {
-                file.close(() => {
-                    try {
-                        fs.chmodSync(binaryPath, 0o755);
-                        cleanupOtherBinaries();
-                        resolve();
-                    } catch (err) {
-                        reject(err);
-                    }
-                });
-            });
-
-            file.on('error', (err) => {
-                fs.unlink(binaryPath, () => { });
-                reject(err);
-            });
-        }).on('error', (err) => {
-            fs.unlink(binaryPath, () => { });
-            reject(err);
-        });
-    });
-}
-
-// Main execution
-if (require.main === module) {
-    downloadBinary(downloadUrl)
-        .then(() => {
-            console.log(`✅ FlashORM installed successfully!`);
-            console.log('');
-            console.log('📦 Plugin System');
-            console.log('   FlashORM uses a plugin-based architecture.');
-            console.log('   The base CLI includes essential commands:');
-            console.log('     • flash --version    (show version)');
-            console.log('     • flash plugins      (list plugins)');
-            console.log('     • flash add-plug     (install plugins)');
-            console.log('     • flash rm-plug      (remove plugins)');
-            console.log('');
-            console.log('   Install plugins for ORM functionality:');
-            console.log('');
-            console.log('   flash add-plug core    # ORM features (migrations, codegen, export)');
-            console.log('   flash add-plug studio  # Visual database editor');
-            console.log('   flash add-plug all     # Everything (core + studio)');
-            console.log('');
-            console.log(`🚀 Run 'flash --help' to get started!`);
-        })
-        .catch((err) => {
-            console.error('❌ Download failed:', err.message);
-            console.error('');
-            console.error('Please try:');
-            console.error('  1. Check your internet connection');
-            console.error('  2. Verify the release exists on GitHub');
-            console.error(`  3. Manual install: ${downloadUrl}`);
-            process.exit(1);
-        });
-} else {
-    // Being required as a module
-    module.exports = downloadBinary(downloadUrl);
-}
+#!/usr/bin/env node
+
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+
+const VERSION = '2.4.5';
+const REPO = 'Lumos-Labs-HQ/flash';
+
+const platform = process.platform;
+const arch = process.arch;
+
+const platformMap = {
+    'darwin': 'darwin',
+    'linux': 'linux',
+    'win32': 'windows'
+};
+
+const archMap = {
+    'x64': 'amd64',
+    'arm64': 'arm64'
+};
+
+const mappedPlatform = platformMap[platform];
+const mappedArch = archMap[arch];
+
+if (!mappedPlatform || !mappedArch) {
+    console.error(`❌ Unsupported platform: ${platform}-${arch}`);
+    process.exit(1);
+}
+
+const binaryName = platform === 'win32' ? 'flash.exe' : 'flash';
+const downloadName = `flash-${mappedPlatform}-${mappedArch}${platform === 'win32' ? '.exe' : ''}`;
+const downloadUrl = `https://github.com/${REPO}/releases/download/v${VERSION}/${downloadName}`;
+
+const binDir = path.join(__dirname, '..', 'bin');
+const binaryPath = path.join(binDir, binaryName);
+
+// Clean up binaries for other platforms
+function cleanupOtherBinaries() {
+    try {
+        const files = fs.readdirSync(binDir);
+        files.forEach(file => {
+            const filePath = path.join(binDir, file);
+            if (file.startsWith('flash') && file !== 'flash.js' && file !== binaryName) {
+                try {
+                    fs.unlinkSync(filePath);
+                    console.log(`🧹 Removed unused binary: ${file}`);
+                } catch (err) {
+                    // Ignore cleanup errors
+                }
+            }
+        });
+    } catch (err) {
+        // Ignore if bin dir doesn't exist
+    }
+}
+
+// Skip if binary already exists for this platform
+if (fs.existsSync(binaryPath)) {
+    console.log(`✅ Binary already exists for ${platform}-${arch}`);
+    cleanupOtherBinaries();
+    process.exit(0);
+}
+
+console.log(`📦 Installing FlashORM v${VERSION} for ${platform}-${arch}...`);
+console.log(`📥 Downloading from: ${downloadUrl}`);
+
+if (!fs.existsSync(binDir)) {
+    fs.mkdirSync(binDir, { recursive: true });
+}
+
+function downloadBinary(url) {
+    return new Promise((resolve, reject) => {
+        const file = fs.createWriteStream(binaryPath);
+
+        https.get(url, (response) => {
+            if (response.statusCode === 302 || response.statusCode === 301) {
+                // Follow redirect
+                file.close();
+                fs.unlinkSync(binaryPath);
+                downloadBinary(response.headers.location).then(resolve).catch(reject);
+                return;
+            }
+
+            if (response.statusCode !== 200) {
+                file.close();
+                fs.unlinkSync(binaryPath);
+                reject(new Error(`Download failed with status ${response.statusCode}`));
+                return;
+            }
+
+            response.pipe(file);
+
+            file.on('finish', () => {
+                file.close(() => {
+                    try {
+                        fs.chmodSync(binaryPath, 0o755);
+                        cleanupOtherBinaries();
+                        resolve();
+                    } catch (err) {
+                        reject(err);
+                    }
+                });
+            });
+
+            file.on('error', (err) => {
+                fs.unlink(binaryPath, () => { });
+                reject(err);
+            });
+        }).on('error', (err) => {
+            fs.unlink(binaryPath, () => { });
+            reject(err);
+        });
+    });
+}
+
+// Main execution
+if (require.main === module) {
+    downloadBinary(downloadUrl)
+        .then(() => {
+            console.log(`✅ FlashORM installed successfully!`);
+            console.log('');
+            console.log('📦 Plugin System');
+            console.log('   FlashORM uses a plugin-based architecture.');
+            console.log('   The base CLI includes essential commands:');
+            console.log('     • flash --version    (show version)');
+            console.log('     • flash plugins      (list plugins)');
+            console.log('     • flash add-plug     (install plugins)');
+            console.log('     • flash rm-plug      (remove plugins)');
+            console.log('');
+            console.log('   Install plugins for ORM functionality:');
+            console.log('');
+            console.log('   flash add-plug core    # ORM features (migrations, codegen, export)');
+            console.log('   flash add-plug studio  # Visual database editor');
+            console.log('   flash add-plug all     # Everything (core + studio)');
+            console.log('');
+            console.log(`🚀 Run 'flash --help' to get started!`);
+        })
+        .catch((err) => {
+            console.error('❌ Download failed:', err.message);
+            console.error('');
+            console.error('Please try:');
+            console.error('  1. Check your internet connection');
+            console.error('  2. Verify the release exists on GitHub');
+            console.error(`  3. Manual install: ${downloadUrl}`);
+            process.exit(1);
+        });
+} else {
+    // Being required as a module
+    module.exports = downloadBinary(downloadUrl);
+}