@libredb/studio 0.9.7 → 0.9.13

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

@@ -1,22 +0,0 @@
-# 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

@@ -1,154 +0,0 @@
-# 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

@@ -1,252 +0,0 @@
-# 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

@@ -1,145 +0,0 @@
-# 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.