@libredb/studio 0.9.7

package/docs/releases/RELEASE.V0.3.0.md

@@ -0,0 +1,22 @@
+# Release V0.3.0 - Modern SQL Console & Database Maintenance
+
+## Improvements
+
+### 1. Modern SQL Query Console
+- **Run Selected:** Added the ability to execute only the selected text in the Monaco Editor.
+- **Smart Statement Detection:** If no text is selected, the editor automatically detects and executes the SQL statement under the cursor (delimited by semicolons).
+- **Visual Feedback:** Executed statements are briefly highlighted in the editor for clear feedback.
+- **Keyboard Shortcuts:** Added `Ctrl+Enter` to run queries and `Alt+Shift+F` for formatting.
+- **Context Menu:** Integrated SQL actions into the editor's right-click menu.
+
+### 2. Advanced SQL Formatting
+- **Tabular Layout:** Improved SQL formatting with a professional tabular layout for better readability.
+- **Keyword Standardizing:** Automatic conversion of keywords and data types to uppercase.
+- **Improved Logic Layout:** Logical operators (AND, OR) are now placed at the start of lines for clearer complex queries.
+
+### 3. Database Exploration & Maintenance
+- **Schema Exploration:** Enhanced tools for exploring database tables, columns, and relationships.
+- **Maintenance Tasks:** Added initial support for database maintenance operations via backend API.
+
+---
+Date: 2025-12-23

package/docs/releases/RELEASE.V0.4.0.md

@@ -0,0 +1,154 @@
+# Release V0.4.0 - Mobile-First UX & AI Query Assistant
+
+**Release Date:** 2025-12-23
+
+This release focuses on delivering a premium mobile experience and integrating AI-powered query assistance with multi-provider LLM support.
+
+---
+
+## Highlights
+
+- **Complete Mobile Redesign** - Touch-optimized UI with bottom navigation
+- **AI Query Assistant** - Natural language to SQL with Gemini, OpenAI, Ollama support
+- **Hybrid Results View** - Card & table views with smart column detection
+
+---
+
+## New Features
+
+### 1. Mobile-First Navigation System
+
+#### Bottom Navigation Bar
+- Added fixed bottom navigation with three tabs: **DB**, **Schema**, **SQL**
+- Smooth tab transitions with visual active state indicators
+- Touch-friendly 16px safe area for gesture navigation
+
+#### Compact Two-Row Header
+- **Row 1:** Database dropdown selector, connection status, health toggle, user menu
+- **Row 2:** AI assistant button, quick actions menu, RUN button
+- Eliminated redundant toolbars for maximum screen real estate
+
+#### Database Quick Switcher
+- Dropdown selector for instant database switching
+- Visual indicator for active connection
+- Add new connection directly from dropdown
+
+### 2. AI Query Assistant (Multi-Provider)
+
+#### Supported Providers
+| Provider | Model | Use Case |
+|----------|-------|----------|
+| **Gemini** | gemini-2.5-flash | Cloud - Fast & accurate |
+| **OpenAI** | gpt-4o | Cloud - Advanced reasoning |
+| **Ollama** | llama3, codellama | Local - Privacy-first |
+| **Custom** | Any OpenAI-compatible | Self-hosted LLMs |
+
+#### Features
+- **Natural Language to SQL** - Describe what you need, get executable SQL
+- **Schema-Aware Prompting** - AI knows your tables and columns
+- **Streaming Responses** - Real-time token streaming
+- **Floating Input** - Non-intrusive collapsible interface
+- **One-Click Apply** - Insert generated SQL directly into editor
+
+#### Configuration
+```env
+LLM_PROVIDER=gemini          # gemini | openai | ollama | custom
+LLM_API_KEY=your_api_key     # Required for cloud providers
+LLM_MODEL=gemini-2.5-flash   # Model name
+LLM_API_URL=                 # Required for ollama/custom
+```
+
+### 3. Mobile Results View
+
+#### Card View (Default)
+- Each row displayed as a touch-friendly card
+- **Smart Primary Column Detection** - Automatically identifies name/title/email fields
+- Preview of first 4 fields with full data on tap
+- Virtualized scrolling for performance with large datasets
+
+#### Table View (Toggle)
+- **Sticky First Column** - ID/primary column stays visible while scrolling
+- Horizontal scroll with shadow indicator
+- Minimum 120px column width for readability
+- Tap row to view full details
+
+#### Row Detail Bottom Sheet
+- Full-screen sheet (85vh) with all row data
+- Field-by-field copy buttons
+- **Copy as JSON** - Export entire row
+- Smooth gesture-based dismiss
+
+### 4. Mobile Quick Actions
+
+Consolidated toolbar actions into a single dropdown menu:
+- **Format SQL** - Auto-format with Shift+Alt+F
+- **Copy Query** - Copy current query to clipboard
+- **Clear** - Reset editor content
+- **Save Query** - Save to local storage
+
+---
+
+## Improvements
+
+### UI/UX Enhancements
+- Hidden desktop-only toolbars on mobile for cleaner interface
+- Query tabs hidden on mobile (single-tab focus)
+- Responsive stats bar with execution time on desktop only
+- Type-aware cell coloring (numbers: amber, booleans: green/red, null: gray)
+
+### Performance
+- Virtualized card list for thousands of rows
+- Optimized re-renders with proper memoization
+- Lazy loading for mobile views
+
+---
+
+## Technical Details
+
+### New Components
+- `MobileNav` - Bottom navigation component
+- `ResultCard` - Card view for result rows
+- `RowDetailSheet` - Bottom sheet for row details
+
+### Modified Components
+- `Studio.tsx` - Mobile header, DB selector, tab routing
+- `ResultsGrid.tsx` - Hybrid card/table view with toggle
+- `QueryEditor.tsx` - Hidden toolbar on mobile
+
+### New Dependencies
+- No new dependencies added
+
+---
+
+## Migration Notes
+
+### Environment Variables
+Add the following to `.env.local` for AI features:
+```env
+LLM_PROVIDER=gemini
+LLM_API_KEY=your_gemini_api_key
+LLM_MODEL=gemini-2.5-flash
+```
+
+### Breaking Changes
+- None. Fully backward compatible.
+
+---
+
+## What's Next (V0.5.0)
+
+- [ ] AI-powered query error fixing
+- [ ] Query explanation with AI
+- [ ] Offline mode with local storage sync
+- [ ] PWA support for mobile installation
+- [ ] Swipe gestures for card actions
+
+---
+
+## Contributors
+
+- Mobile UX redesign and AI integration by the LibreDB team
+
+---
+
+**Full Changelog:** [V0.3.0...V0.4.0](https://github.com/your-repo/compare/v0.3.0...v0.4.0)

package/docs/releases/RELEASE.V0.5.0.md

@@ -0,0 +1,252 @@
+# Release v0.5.0 - Database Provider Architecture & MongoDB Support
+
+**Release Date:** December 2024
+
+This release introduces a major architectural refactoring of the database provider system using the Strategy Pattern, along with full MongoDB support.
+
+---
+
+## Highlights
+
+- **New Architecture:** Modular, extensible database provider system
+- **MongoDB Support:** Full document database support with JSON-based queries
+- **SQLBaseProvider:** Shared utilities for SQL databases
+- **Improved Maintainability:** Clear separation of concerns by database category
+
+---
+
+## New Features
+
+### MongoDB Support
+
+Full MongoDB integration with the official `mongodb` driver:
+
+```typescript
+const connection = {
+  id: 'my-mongo',
+  name: 'MongoDB Atlas',
+  type: 'mongodb',
+  connectionString: 'mongodb+srv://user:pass@cluster.mongodb.net/mydb',
+  createdAt: new Date(),
+};
+
+const provider = await getOrCreateProvider(connection);
+const result = await provider.query(JSON.stringify({
+  collection: 'users',
+  operation: 'find',
+  filter: { status: 'active' },
+  options: { limit: 50 }
+}));
+```
+
+**Supported Operations:**
+- `find`, `findOne` - Query documents
+- `aggregate` - Aggregation pipelines
+- `count`, `distinct` - Count and distinct queries
+- `insertOne`, `insertMany` - Insert documents
+- `updateOne`, `updateMany` - Update documents
+- `deleteOne`, `deleteMany` - Delete documents
+
+**MongoDB Features:**
+- Connection pooling
+- Automatic schema inference from documents
+- Index listing
+- Health monitoring with profiler integration
+- Maintenance operations (compact, validate, reIndex)
+
+---
+
+## Architecture Changes
+
+### New Directory Structure
+
+```
+src/lib/db/
+├── index.ts                    # Public exports
+├── types.ts                    # Interfaces & Types
+├── errors.ts                   # Custom error classes
+├── factory.ts                  # Provider Factory
+├── base-provider.ts            # Abstract base class
+├── providers/
+│   ├── sql/                    # SQL Database Providers
+│   │   ├── index.ts
+│   │   ├── sql-base.ts         # SQL-specific base class (NEW)
+│   │   ├── postgres.ts
+│   │   ├── mysql.ts
+│   │   └── sqlite.ts
+│   ├── document/               # Document Database Providers (NEW)
+│   │   ├── index.ts
+│   │   └── mongodb.ts          # MongoDB Provider (NEW)
+│   └── demo.ts
+└── utils/
+    └── pool-manager.ts
+```
+
+### Provider Hierarchy
+
+```
+BaseDatabaseProvider (abstract)
+├── SQLBaseProvider (abstract) ─────────────┐
+│   ├── PostgresProvider                    │ SQL Databases
+│   ├── MySQLProvider                       │ (shared utilities)
+│   └── SQLiteProvider                      │
+├── MongoDBProvider ────────────────────────┤ Document Databases
+└── DemoProvider ───────────────────────────┘ Mock/Testing
+```
+
+### SQLBaseProvider
+
+New abstract class with SQL-specific shared utilities:
+
+```typescript
+abstract class SQLBaseProvider extends BaseDatabaseProvider {
+  // SQL-specific utilities
+  protected escapeIdentifier(identifier: string): string;
+  protected escapeString(value: string): string;
+  protected buildLimitClause(limit: number, offset?: number): string;
+  protected getPlaceholder(index: number): string;
+  protected shouldEnableSSL(): boolean;
+  protected isReadOnlyQuery(sql: string): boolean;
+  protected isSchemaModifyingQuery(sql: string): boolean;
+}
+```
+
+---
+
+## Supported Databases
+
+| Category | Database   | Status | Driver           | Pooling |
+|----------|------------|--------|------------------|---------|
+| SQL      | PostgreSQL | Full   | `pg`             | Yes     |
+| SQL      | MySQL      | Full   | `mysql2`         | Yes     |
+| SQL      | SQLite     | Full   | `better-sqlite3` | No      |
+| Document | MongoDB    | Full   | `mongodb`        | Yes     |
+| Other    | Demo       | Full   | Mock data        | N/A     |
+
+---
+
+## Breaking Changes
+
+None. All existing APIs remain compatible.
+
+---
+
+## Bug Fixes
+
+- Fixed `idx.columns.join is not a function` error in SchemaExplorer when PostgreSQL returns null for empty index columns
+- Fixed `col.primaryKey` property name to `col.isPrimary` in SchemaDiagram component
+
+---
+
+## Dependencies
+
+### Added
+- `mongodb@7.0.0` - Official MongoDB driver
+
+### Existing
+- `pg` - PostgreSQL driver
+- `mysql2` - MySQL driver
+- `better-sqlite3` - SQLite driver
+
+---
+
+## Documentation
+
+- Updated `docs/DATABASE_PROVIDERS.md` with:
+  - New architecture diagram
+  - MongoDB query format and examples
+  - Guide for adding new providers
+  - Provider-specific features
+
+---
+
+## Migration Guide
+
+### For Users
+
+No migration required. Existing connections continue to work.
+
+### For Developers
+
+If you have custom code extending database providers:
+
+```typescript
+// Before (v0.4.x)
+import { PostgresProvider } from '@/lib/db/providers/postgres';
+
+// After (v0.5.0)
+import { PostgresProvider } from '@/lib/db/providers/sql/postgres';
+// or
+import { PostgresProvider } from '@/lib/db';
+```
+
+---
+
+## Adding New Providers
+
+### SQL Database (e.g., Oracle)
+
+```typescript
+// src/lib/db/providers/sql/oracle.ts
+import { SQLBaseProvider } from './sql-base';
+
+export class OracleProvider extends SQLBaseProvider {
+  // Inherit SQL utilities, implement abstract methods
+}
+```
+
+### Document Database (e.g., Couchbase)
+
+```typescript
+// src/lib/db/providers/document/couchbase.ts
+import { BaseDatabaseProvider } from '../../base-provider';
+
+export class CouchbaseProvider extends BaseDatabaseProvider {
+  // Implement all abstract methods
+}
+```
+
+---
+
+## What's Next
+
+### v0.6.0 (Planned)
+- MongoDB UI improvements (JSON editor, collection explorer)
+- Redis support (Key-Value category)
+- Query builder for MongoDB
+
+---
+
+## Contributors
+
+- Database architecture refactoring
+- MongoDB provider implementation
+- Documentation updates
+
+---
+
+## Full Changelog
+
+### Added
+- `SQLBaseProvider` abstract class for SQL databases
+- `MongoDBProvider` for document database support
+- `providers/sql/` directory for SQL providers
+- `providers/document/` directory for document providers
+- MongoDB query parsing and execution
+- MongoDB schema inference from documents
+- MongoDB health monitoring
+- MongoDB maintenance operations
+
+### Changed
+- Moved PostgreSQL provider to `providers/sql/postgres.ts`
+- Moved MySQL provider to `providers/sql/mysql.ts`
+- Moved SQLite provider to `providers/sql/sqlite.ts`
+- Updated factory to use new provider locations
+- Updated index exports for new structure
+
+### Fixed
+- `idx.columns.join is not a function` in SchemaExplorer
+- `col.primaryKey` → `col.isPrimary` in SchemaDiagram
+
+### Removed
+- Old provider files from `providers/` root (moved to `providers/sql/`)

package/docs/releases/RELEASE_v0.5.6.md

@@ -0,0 +1,145 @@
+# LibreDB Studio v0.5.6 - Initial Stable Release
+
+We are excited to announce the first public release of **LibreDB Studio** — a modern, blazing-fast SQL IDE for the cloud era.
+
+---
+
+## What is LibreDB Studio?
+
+LibreDB Studio is an open-source, web-based SQL editor designed for cloud-native teams. It bridges the gap between heavyweight desktop applications and minimal CLI tools, offering a professional database management experience accessible from any browser.
+
+**Live Demo:** [app.libredb.org](https://app.libredb.org)
+
+---
+
+## Core Features
+
+### Mobile-First, Professional-Always
+- Fully responsive design optimized for phones, tablets, and desktops
+- Run SQL queries from your phone while on-call or away from your desk
+- Touch-friendly interface with native-like experience on mobile browsers
+- No app installation required — just open your browser and connect
+
+### All-in-One Architecture
+- Single Docker image contains everything: frontend, backend, and API
+- No separate services to configure or maintain
+- Deploy once, connect to any database in your private network
+- Zero external dependencies — runs completely self-contained
+
+### Cloud-Native Deployment
+- Docker-ready with optimized multi-stage builds
+- Kubernetes compatible with health check endpoints
+- Horizontal scaling support via stateless JWT architecture
+- Perfect for private network database management
+
+### Multi-Database Support
+- **PostgreSQL** — Full support including maintenance operations
+- **MySQL** — Query execution and schema exploration
+- **SQLite** — Lightweight database support
+- **MongoDB** — Document database with JSON query interface
+- **Demo Mode** — Try the IDE without a real database
+
+### Professional SQL Editor
+- Monaco Editor (VS Code engine) with syntax highlighting
+- Schema-aware autocomplete for tables, columns, and keywords
+- Multi-tab workspace with independent execution states
+- Query formatting and keyboard shortcuts
+
+### AI-Powered Query Assistant
+- Natural language to SQL generation
+- Multi-provider support: Gemini, OpenAI, Ollama, or custom endpoints
+- Schema-aware context for accurate query suggestions
+- Streaming responses for real-time feedback
+
+### High-Performance Data Grid
+- Virtualized rendering for large datasets (TanStack)
+- Inline cell editing with instant updates
+- One-click export to CSV and JSON
+- Column sorting and resizing
+
+### DBA Maintenance Toolkit
+- Live connection monitoring and session management
+- One-click VACUUM, ANALYZE, and REINDEX operations
+- Query history with full audit trail
+- Database health metrics and statistics
+
+### Enterprise Ready
+- JWT-based authentication with role-based access control
+- Admin and User roles with granular permissions
+- Secure HTTP-only cookie session management
+- Built-in query auditing and history tracking
+
+---
+
+## Tech Stack
+
+| Layer | Technology |
+|-------|------------|
+| Frontend | Next.js 15, React 19, TypeScript |
+| Styling | Tailwind CSS 4, Shadcn/UI, Radix UI |
+| Editor | Monaco Editor |
+| Data Grid | TanStack Table + React Virtual |
+| AI | Multi-model (Gemini, OpenAI, Ollama) |
+| Auth | JWT with HTTP-only cookies |
+
+---
+
+## Quick Start
+
+```bash
+# Clone the repository
+git clone https://github.com/libredb/libredb-studio.git
+cd libredb-studio
+
+# Install dependencies
+bun install
+
+# Configure environment
+cp .env.example .env.local
+# Edit .env.local with your settings
+
+# Start development server
+bun dev
+```
+
+Open [http://localhost:3000](http://localhost:3000) and connect to your database.
+
+---
+
+## Deployment
+
+### Docker
+```bash
+docker-compose up -d
+```
+
+### Render (One-Click)
+[![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://render.com/deploy?repo=https://github.com/libredb/libredb-studio)
+
+---
+
+## Documentation
+
+- [API Documentation](./API_DOCS.md)
+- [Contributing Guide](../CONTRIBUTING.md)
+
+---
+
+## What's Next
+
+- Interactive ER Diagrams
+- Advanced Mobile SQL Keyboard
+- SSO Integration (OIDC/SAML)
+- Query result visualization charts
+
+---
+
+## Links
+
+- **Repository:** [github.com/libredb/libredb-studio](https://github.com/libredb/libredb-studio)
+- **Live Demo:** [app.libredb.org](https://app.libredb.org)
+- **License:** MIT
+
+---
+
+Thank you for trying LibreDB Studio. We welcome contributions and feedback from the community.