@libredb/studio 0.9.7 → 0.9.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@libredb/studio",
-  "version": "0.9.7",
+  "version": "0.9.12",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -9,12 +9,64 @@
     "type": "git",
     "url": "https://github.com/libredb/libredb-studio"
   },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/exports/index.ts",
-    "./components": "./src/exports/components.ts",
-    "./providers": "./src/exports/providers.ts",
-    "./types": "./src/exports/types.ts"
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./providers": {
+      "import": {
+        "types": "./dist/providers.d.mts",
+        "default": "./dist/providers.mjs"
+      },
+      "require": {
+        "types": "./dist/providers.d.ts",
+        "default": "./dist/providers.js"
+      }
+    },
+    "./types": {
+      "import": {
+        "types": "./dist/types.d.mts",
+        "default": "./dist/types.mjs"
+      },
+      "require": {
+        "types": "./dist/types.d.ts",
+        "default": "./dist/types.js"
+      }
+    },
+    "./components": {
+      "import": {
+        "types": "./dist/components.d.mts",
+        "default": "./dist/components.mjs"
+      },
+      "require": {
+        "types": "./dist/components.d.ts",
+        "default": "./dist/components.js"
+      }
+    },
+    "./workspace": {
+      "import": {
+        "types": "./dist/workspace.d.mts",
+        "default": "./dist/workspace.mjs"
+      },
+      "require": {
+        "types": "./dist/workspace.d.ts",
+        "default": "./dist/workspace.js"
+      }
+    }
   },
+  "files": [
+    "dist"
+  ],
   "peerDependencies": {
     "react": "^19",
     "react-dom": "^19"
@@ -22,6 +74,8 @@
   "scripts": {
     "dev": "next dev",
     "build": "next build",
+    "build:lib": "tsup",
+    "prepublishOnly": "tsup",
     "start": "next start",
     "lint": "eslint .",
     "typecheck": "tsc --noEmit",
@@ -124,6 +178,7 @@
     "eslint-config-next": "^16.1.6",
     "happy-dom": "^20.6.1",
     "tailwindcss": "^4",
+    "tsup": "^8.5.1",
     "tw-animate-css": "^1.4.0",
     "typescript": "^5"
   }

package/.claude/settings.local.json

@@ -1,127 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(grep:*)",
-      "Bash(find:*)",
-      "Bash(xargs:*)",
-      "Bash(bun run lint:*)",
-      "Bash(npx tsc:*)",
-      "Bash(bun run build:*)",
-      "Bash(bun add:*)",
-      "Bash(bun create:*)",
-      "Bash(bun remove:*)",
-      "Bash(ls:*)",
-      "Bash(bun pm ls:*)",
-      "Bash(npm ls:*)",
-      "Bash(npm audit:*)",
-      "Bash(docker network:*)",
-      "Bash(docker ps:*)",
-      "Bash(docker build:*)",
-      "Bash(.)",
-      "Bash(docker rm:*)",
-      "Bash(docker run:*)",
-      "Bash(libredb-studio:test)",
-      "Bash(curl:*)",
-      "WebFetch(domain:ui.shadcn.com)",
-      "WebFetch(domain:www.shadcnblocks.com)",
-      "Bash(PGPASSWORD='npg_qMrKIcQ0X6hn' psql:*)",
-      "Bash(PGPASSWORD='readonly_secure_pass_2024' psql:*)",
-      "Bash(docker logs:*)",
-      "Bash(docker stop:*)",
-      "Bash(libredb-test:*)",
-      "Bash(PGPASSWORD='npg_qMrKIcQ0X6hn' psql -h ep-falling-morning-ag8brons-pooler.c-2.eu-central-1.aws.neon.tech -U neondb_owner -d employees -c \"\nSELECT table_name\nFROM information_schema.tables\nWHERE table_schema = ''employees''\nORDER BY table_name;\n\")",
-      "mcp__ide__getDiagnostics",
-      "Bash(lsof:*)",
-      "WebFetch(domain:github.com)",
-      "Bash(claude mcp add:*)",
-      "mcp__playwright",
-      "WebSearch",
-      "Bash(wc:*)",
-      "Bash(fuser:*)",
-      "Bash(pkill:*)",
-      "Bash(npm run build:*)",
-      "Bash(source:*)",
-      "Bash(echo $ADMIN_PASSWORD)",
-      "Bash(echo $USER_PASSWORD)",
-      "Bash(mysql:*)",
-      "Bash(bun dev)",
-      "Bash(echo:*)",
-      "Bash(git -C /home/cevheri/projects/cevheribozoglan/libredb-studio status)",
-      "Bash(git -C /home/cevheri/projects/cevheribozoglan/libredb-studio diff --stat)",
-      "Bash(git -C /home/cevheri/projects/cevheribozoglan/libredb-studio log --oneline -5)",
-      "Bash(git -C /home/cevheri/projects/cevheribozoglan/libredb-studio diff src/components/Studio.tsx src/components/monitoring/MonitoringDashboard.tsx src/lib/db/providers/sql/mysql.ts src/lib/storage.ts)",
-      "Bash(docker exec:*)",
-      "Bash(docker compose:*)",
-      "Bash(PGPASSWORD=postgres psql:*)",
-      "Bash(bun --version:*)",
-      "Bash(bun test:*)",
-      "Bash(bun -e:*)",
-      "Bash(node:*)",
-      "Bash(while read f)",
-      "Bash(do)",
-      "Bash(if ! grep -q 'cleanup' \"$f\")",
-      "Bash(then)",
-      "Bash(fi)",
-      "Bash(done)",
-      "Bash(/home/cevheri/projects/cevheribozoglan/libredb-studio/tests/_debug-screen.test.tsx:*)",
-      "Bash(__NEW_LINE_b497933af27a2c60__ bun test tests/_debug-screen.test.tsx)",
-      "Bash(# Test::*)",
-      "Bash(git stash:*)",
-      "Bash(tests/_debug_tabs.test.tsx:*)",
-      "Bash(bun run test:*)",
-      "Bash(bun run:*)",
-      "Bash(bunx playwright install:*)",
-      "Bash(bunx playwright test:*)",
-      "Bash(npx eslint:*)",
-      "Bash(bunx eslint:*)",
-      "Bash(chmod:*)",
-      "Bash(bash tests/run-components.sh)",
-      "Bash(gh run list:*)",
-      "Bash(bash)",
-      "Bash(~/.bun/bin/bun:*)",
-      "Bash(tar:*)",
-      "Bash(/tmp/gh_2.65.0_linux_amd64/bin/gh:*)",
-      "Bash(cat:*)",
-      "Bash(for i in 1 2 3)",
-      "Bash(do echo \"=== Run $i ===\")",
-      "Bash(genhtml:*)",
-      "Bash(/tmp/debug-schema-diff.tsx:*)",
-      "Bash(python3:*)",
-      "Bash(/tmp/test-login-debug.tsx:*)",
-      "Bash(/home/cevheri/projects/cevheribozoglan/libredb-studio/tests/_debug_login.tsx:*)",
-      "Bash(/tmp/bad-test.test.ts:*)",
-      "Bash(bunx tsc:*)",
-      "WebFetch(domain:registry.npmjs.org)",
-      "WebFetch(domain:libredb.eu.auth0.com)",
-      "Bash(psql:*)",
-      "WebFetch(domain:railway.com)",
-      "WebFetch(domain:render.com)",
-      "WebFetch(domain:fly.io)",
-      "WebFetch(domain:coolify.io)",
-      "WebFetch(domain:northflank.com)",
-      "WebFetch(domain:www.koyeb.com)",
-      "WebFetch(domain:zeabur.com)",
-      "WebFetch(domain:www.porter.run)",
-      "WebFetch(domain:www.digitalocean.com)",
-      "WebFetch(domain:aws.amazon.com)",
-      "WebFetch(domain:sliplane.io)",
-      "WebFetch(domain:neon.com)",
-      "WebFetch(domain:supabase.com)",
-      "WebFetch(domain:xata.io)",
-      "WebFetch(domain:www.tembo.io)",
-      "WebFetch(domain:docs.digitalocean.com)",
-      "WebFetch(domain:planetscale.com)",
-      "WebFetch(domain:azure.microsoft.com)",
-      "WebFetch(domain:developers.cloudflare.com)",
-      "WebFetch(domain:www.analyticsvidhya.com)",
-      "Bash(unzip:*)",
-      "WebFetch(domain:helm.sh)",
-      "WebFetch(domain:artifacthub.io)",
-      "WebFetch(domain:libredb.org)"
-    ]
-  },
-  "enableAllProjectMcpServers": true,
-  "enabledMcpjsonServers": [
-    "playwright"
-  ]
-}

package/.cursorrules

@@ -1,426 +0,0 @@
-# LibreDB Studio - Cursor Rules
-
-This file provides comprehensive guidance for AI assistants and developers working on LibreDB Studio. Follow these rules to maintain code quality, consistency, and architectural integrity.
-
-## Project Overview
-
-LibreDB Studio is a modern, AI-powered, open-source SQL IDE for cloud-native teams. It provides a web-based interface for managing PostgreSQL, MySQL, SQLite, and MongoDB databases with features like AI-assisted query generation, visual schema exploration, and real-time monitoring.
-
-**Key Characteristics:**
-- Mobile-first, professional-always design philosophy
-- Zero-install browser-based solution
-- Multi-database support via Strategy Pattern
-- AI-native with multi-model LLM support (Gemini, OpenAI, Ollama, Custom)
-- Enterprise-grade with RBAC, query auditing, and health monitoring
-
-## Tech Stack
-
-### Core Framework
-- **Next.js 15** (App Router) with React 19
-- **TypeScript** (strict mode enabled)
-- **Bun** (preferred runtime) or Node.js 20+
-- **Tailwind CSS 4** with `@theme inline` theming
-- **shadcn/ui** components (Radix UI primitives)
-
-### Key Libraries
-- **Monaco Editor** - SQL editor (VS Code engine)
-- **TanStack Table & Virtual** - Virtualized data grids
-- **Framer Motion** - Animations
-- **Jose** - JWT authentication
-- **Zod** - Runtime type validation
-- **React Hook Form** - Form management
-
-### Database Drivers
-- PostgreSQL: `pg`
-- MySQL: `mysql2`
-- SQLite: `better-sqlite3` (via dynamic import)
-- MongoDB: `mongodb`
-
-## Code Style & Conventions
-
-### TypeScript
-
-- **Always use TypeScript** - No JavaScript files unless absolutely necessary
-- **Strict mode** - TypeScript strict mode is enabled, respect it
-- **Avoid `any`** - Use `unknown` or proper types instead. If `any` is unavoidable, add a comment explaining why
-- **Explicit types** - Prefer explicit return types for functions, especially public APIs
-- **Type imports** - Use `import type` for type-only imports
-- **Interfaces over types** - Prefer `interface` for object shapes, use `type` for unions, intersections, and aliases
-
-```typescript
-// ✅ Good
-interface DatabaseConnection {
-  id: string;
-  name: string;
-  type: DatabaseType;
-}
-
-type DatabaseType = 'postgres' | 'mysql' | 'sqlite' | 'mongodb' | 'redis' | 'oracle' | 'mssql';
-
-// ❌ Bad
-type DatabaseConnection = {
-  id: string;
-  name: string;
-}
-```
-
-### Naming Conventions
-
-- **Files**: kebab-case for components (`query-editor.tsx`), PascalCase for components (`QueryEditor.tsx`)
-- **Components**: PascalCase (`QueryEditor`, `Dashboard`)
-- **Functions/Variables**: camelCase (`fetchUser`, `activeConnection`)
-- **Constants**: UPPER_SNAKE_CASE (`DEFAULT_TIMEOUT`, `MAX_POOL_SIZE`)
-- **Types/Interfaces**: PascalCase (`DatabaseConnection`, `QueryResult`)
-- **Hooks**: camelCase starting with `use` (`useToast`, `useMonitoringData`)
-- **API Routes**: kebab-case (`/api/db/query`, `/api/auth/login`)
-
-### React Patterns
-
-- **Functional components only** - No class components
-- **Hooks over HOCs** - Prefer custom hooks for shared logic
-- **Server Components by default** - Use `"use client"` only when necessary (interactivity, hooks, browser APIs)
-- **Component organization**:
-  ```typescript
-  // 1. Imports (external, then internal)
-  // 2. Types/Interfaces
-  // 3. Component
-  // 4. Exports
-  ```
-- **Props destructuring** - Destructure props in function signature
-- **Memoization** - Use `useMemo`/`useCallback` sparingly, only for expensive computations or stable references
-
-```typescript
-// ✅ Good
-export default function QueryEditor({ query, onChange }: QueryEditorProps) {
-  const handleChange = useCallback((value: string) => {
-    onChange(value);
-  }, [onChange]);
-  
-  return <MonacoEditor value={query} onChange={handleChange} />;
-}
-
-// ❌ Bad
-export default function QueryEditor(props: QueryEditorProps) {
-  return <MonacoEditor value={props.query} onChange={props.onChange} />;
-}
-```
-
-### File Organization
-
-```
-src/
-├── app/                    # Next.js App Router
-│   ├── api/               # API routes (REST endpoints)
-│   ├── (pages)/           # Page components
-│   └── layout.tsx         # Root layout
-├── components/            # React components
-│   ├── ui/               # shadcn/ui primitives
-│   └── [Feature].tsx     # Feature components
-├── hooks/                 # Custom React hooks
-├── lib/                   # Utilities and business logic
-│   ├── db/               # Database providers (Strategy Pattern)
-│   ├── llm/              # LLM providers (Strategy Pattern)
-│   └── utils.ts          # General utilities
-└── types.ts              # Shared TypeScript types
-```
-
-### Import Order
-
-1. External dependencies (React, Next.js, third-party)
-2. Internal absolute imports (`@/components`, `@/lib`)
-3. Relative imports (`./types`, `../utils`)
-4. Type-only imports last (if separate)
-
-```typescript
-// ✅ Good
-import { useState } from 'react';
-import { NextRequest, NextResponse } from 'next/server';
-import { Button } from '@/components/ui/button';
-import { cn } from '@/lib/utils';
-import type { DatabaseConnection } from '@/lib/types';
-```
-
-## Architecture Patterns
-
-### Strategy Pattern for Providers
-
-Both database and LLM providers use the Strategy Pattern:
-
-```typescript
-// Base interface
-interface DatabaseProvider {
-  connect(): Promise<void>;
-  query(sql: string): Promise<QueryResult>;
-  disconnect(): Promise<void>;
-}
-
-// Implementation
-class PostgresProvider extends SQLBaseProvider implements DatabaseProvider {
-  // Implementation
-}
-
-// Factory
-export async function createDatabaseProvider(
-  connection: DatabaseConnection
-): Promise<DatabaseProvider> {
-  switch (connection.type) {
-    case 'postgres':
-      const { PostgresProvider } = await import('./providers/sql/postgres');
-      return new PostgresProvider(connection);
-    // ...
-  }
-}
-```
-
-**Key Points:**
-- Use dynamic imports for providers to reduce initial bundle size
-- All providers implement the same interface
-- Factory function handles provider creation
-- Cache providers for connection reuse
-
-### API Routes
-
-- **Error handling** - Always use try-catch, return appropriate HTTP status codes
-- **Type safety** - Validate request bodies with Zod when needed
-- **Authentication** - Check JWT via middleware or `getUserFromRequest()`
-- **Response format** - Consistent JSON structure: `{ data?, error?, code? }`
-
-```typescript
-// ✅ Good
-export async function POST(req: NextRequest) {
-  try {
-    const { connection, sql } = await req.json();
-    
-    if (!connection || !sql) {
-      return NextResponse.json(
-        { error: 'Connection and SQL query are required' },
-        { status: 400 }
-      );
-    }
-
-    const provider = await getOrCreateProvider(connection);
-    const result = await provider.query(sql);
-    
-    return NextResponse.json(result);
-  } catch (error) {
-    if (error instanceof QueryError) {
-      return NextResponse.json(
-        { error: error.message, code: error.code },
-        { status: 400 }
-      );
-    }
-    return NextResponse.json(
-      { error: 'Internal server error' },
-      { status: 500 }
-    );
-  }
-}
-```
-
-### Error Handling
-
-- **Custom error classes** - Use project-specific error types (`DatabaseError`, `QueryError`, `TimeoutError`)
-- **Error boundaries** - Use React error boundaries for component-level errors
-- **User-friendly messages** - Never expose internal errors to users
-- **Logging** - Log errors with context: `console.error('[API:query] Error:', error)`
-
-```typescript
-// ✅ Good
-try {
-  await provider.query(sql);
-} catch (error) {
-  if (error instanceof QueryError) {
-    // Handle query-specific error
-  } else if (isDatabaseError(error)) {
-    // Handle database error
-  } else {
-    // Handle unknown error
-  }
-}
-```
-
-## Component Guidelines
-
-### shadcn/ui Components
-
-- **Use existing components** - Check `src/components/ui/` before creating new ones
-- **Composition over configuration** - Prefer component composition
-- **Accessibility** - All components should be keyboard navigable and screen-reader friendly
-- **Theming** - Use CSS variables for theming, defined in `globals.css`
-
-### Custom Components
-
-- **Single responsibility** - One component, one purpose
-- **Props interface** - Always define explicit props interface
-- **Default exports** - Use default export for main component, named exports for sub-components
-- **Documentation** - Add JSDoc comments for complex components
-
-```typescript
-/**
- * QueryEditor component - Monaco-based SQL editor
- * 
- * @param query - Current SQL query text
- * @param onChange - Callback when query changes
- * @param onExecute - Callback when execute is triggered
- */
-export interface QueryEditorProps {
-  query: string;
-  onChange: (query: string) => void;
-  onExecute?: () => void;
-}
-
-export default function QueryEditor({ query, onChange, onExecute }: QueryEditorProps) {
-  // Implementation
-}
-```
-
-## Database Provider Development
-
-### Adding a New Database Provider
-
-1. **Create provider class** in `src/lib/db/providers/[category]/[name].ts`
-2. **Extend base class** - `SQLBaseProvider` for SQL databases, `BaseDatabaseProvider` for others
-3. **Implement required methods** - `connect()`, `query()`, `disconnect()`, `getSchema()`
-4. **Add to factory** - Update `src/lib/db/factory.ts` with new case
-5. **Add types** - Update `DatabaseType` union in `src/lib/types.ts`
-6. **Handle errors** - Use appropriate error classes from `src/lib/db/errors.ts`
-
-### Connection Pooling
-
-- **Use connection pools** - For SQL databases, always use connection pooling
-- **Pool configuration** - Use `DEFAULT_POOL_CONFIG` or provide custom config
-- **Cleanup** - Always disconnect and clear pools on errors or shutdown
-
-## LLM Provider Development
-
-### Adding a New LLM Provider
-
-1. **Create provider class** in `src/lib/llm/providers/[name].ts`
-2. **Extend `BaseLLMProvider`** - Implement `generate()` and `stream()` methods
-3. **Add to factory** - Update `src/lib/llm/factory.ts`
-4. **Add environment variables** - Document required env vars in README
-5. **Handle rate limits** - Implement retry logic with exponential backoff
-
-## Styling Guidelines
-
-### Tailwind CSS 4
-
-- **Use utility classes** - Prefer Tailwind utilities over custom CSS
-- **Theme variables** - Use CSS variables for colors: `bg-background`, `text-foreground`
-- **Responsive design** - Mobile-first approach: `md:`, `lg:`, `xl:` breakpoints
-- **Dark mode** - All components must support dark mode via theme variables
-- **Custom utilities** - Use `@apply` sparingly, prefer component composition
-
-### Component Styling
-
-```typescript
-// ✅ Good - Tailwind utilities
-<Button className="bg-primary text-primary-foreground hover:bg-primary/90">
-  Submit
-</Button>
-
-// ✅ Good - Conditional classes with cn()
-<div className={cn(
-  "base-classes",
-  isActive && "active-classes",
-  variant === "primary" && "primary-classes"
-)}>
-```
-
-## Testing & Quality
-
-### Code Quality
-
-- **ESLint** - Follow ESLint rules, run `bun lint` before committing
-- **Type checking** - Ensure `tsc --noEmit` passes
-- **No console.log in production** - Use `console.error` for errors, remove debug logs
-
-### Performance
-
-- **Code splitting** - Use dynamic imports for heavy dependencies
-- **Virtualization** - Use TanStack Virtual for large lists
-- **Memoization** - Memoize expensive computations
-- **Image optimization** - Use Next.js Image component for images
-
-## Git & Commit Messages
-
-### Commit Message Format
-
-Follow conventional commits:
-
-```
-type(scope): subject
-
-body (optional)
-
-footer (optional)
-```
-
-**Types:**
-- `feat`: New feature
-- `fix`: Bug fix
-- `docs`: Documentation changes
-- `style`: Code style changes (formatting, no logic change)
-- `refactor`: Code refactoring
-- `perf`: Performance improvements
-- `test`: Adding or updating tests
-- `chore`: Maintenance tasks
-
-**Examples:**
-```
-feat(db): add SQLite provider support
-fix(api): handle connection timeout errors
-docs(readme): update installation instructions
-refactor(components): extract query editor logic to hook
-```
-
-## Environment Variables
-
-### Required
-- `ADMIN_PASSWORD` - Admin user password
-- `USER_PASSWORD` - Regular user password
-- `JWT_SECRET` - JWT signing secret (min 32 characters)
-
-### Optional
-- `LLM_PROVIDER` - AI provider: `gemini`, `openai`, `ollama`, `custom`
-- `LLM_API_KEY` - API key for LLM provider
-- `LLM_MODEL` - Model name (e.g., `gemini-2.5-flash`)
-- `LLM_API_URL` - Custom API URL (for local LLMs)
-
-## Common Pitfalls to Avoid
-
-1. **Don't use `any`** - Always type your code properly
-2. **Don't ignore errors** - Always handle errors appropriately
-3. **Don't commit secrets** - Never commit `.env.local` or API keys
-4. **Don't break the Strategy Pattern** - Keep provider interfaces consistent
-5. **Don't mix server and client code** - Be explicit about `"use client"`
-6. **Don't forget accessibility** - All interactive elements must be keyboard accessible
-7. **Don't skip error boundaries** - Protect the app from component errors
-8. **Don't use inline styles** - Use Tailwind classes or CSS variables
-
-## AI Assistant Guidelines
-
-When working on this codebase:
-
-1. **Understand the architecture** - Read `docs/ARCHITECTURE.md` before making changes
-2. **Follow patterns** - Match existing code patterns and conventions
-3. **Ask for clarification** - If unsure about approach, ask before implementing
-4. **Test thoroughly** - Ensure changes work across different database types
-5. **Update documentation** - Keep README and docs up to date
-6. **Consider mobile** - All features must work on mobile browsers
-7. **Respect RBAC** - Admin-only features must check user role
-8. **Performance first** - Optimize for large datasets and slow connections
-
-## Resources
-
-- **Architecture**: `docs/ARCHITECTURE.md`
-- **API Documentation**: `docs/API_DOCS.md`
-- **Theming Guide**: `docs/THEMING.md`
-- **Contributing**: `CONTRIBUTING.md`
-- **Claude Guide**: `CLAUDE.md`
-
----
-
-**Last Updated**: 2025-01-XX
-**Project Version**: 0.6.1
-