🎉 Initial Commit

Author: max-programming

.gitignore

@@ -0,0 +1,36 @@
+# dependencies (bun install)
+node_modules
+
+# output
+out
+dist
+*.tgz
+
+# code coverage
+coverage
+*.lcov
+
+# logs
+logs
+_.log
+report.[0-9]_.[0-9]_.[0-9]_.[0-9]_.json
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# caches
+.eslintcache
+.cache
+*.tsbuildinfo
+
+# IntelliJ based IDEs
+.idea
+
+# Finder (MacOS) folder config
+.DS_Store
+
+dist

README.md

@@ -0,0 +1,167 @@
+# 🎨 drizzle-query-logger
+
+A beautiful, enhanced logger for Drizzle ORM that transforms your SQL queries into visually appealing, color-coded output with syntax highlighting, icons, and detailed formatting.
+
+## ✨ Features
+
+- 🎨 **Beautiful formatting** with box-drawing characters and colors
+- 🔍 **SQL syntax highlighting** with keyword colorization
+- 📊 **Query type detection** with specific colors and icons
+- 🏷️ **Table name extraction** and highlighting
+- 📝 **Parameter formatting** with type-specific colors
+- ⏰ **Timestamps** for each query
+- 🔢 **Query numbering** to track execution order
+- ⚙️ **Configurable** logging output
+
+## 📦 Installation
+
+```bash
+npm install drizzle-query-logger
+```
+
+```bash
+yarn add drizzle-query-logger
+```
+
+```bash
+pnpm add drizzle-query-logger
+```
+
+```bash
+bun add drizzle-query-logger
+```
+
+## 🚀 Usage
+
+### Basic Usage
+
+```typescript
+import Database from 'better-sqlite3';
+import { drizzle } from 'drizzle-orm/better-sqlite3';
+import { EnhancedQueryLogger } from 'drizzle-query-logger';
+
+const client = new Database(':memory:');
+export const db = drizzle(client, {
+  logger: new EnhancedQueryLogger(),
+});
+
+// Your queries will now be beautifully logged!
+const users = await db.select().from(usersTable);
+```
+
+### With Custom Logger Function
+
+```typescript
+import { EnhancedQueryLogger } from 'drizzle-query-logger';
+
+const logger = new EnhancedQueryLogger({
+  log: (message) => {
+    // Send to your preferred logging service
+    console.log(message);
+    // or use your custom logger
+    // winston.info(message);
+    // pino.info(message);
+  }
+});
+
+export const db = drizzle(client, { logger });
+```
+
+### Example Output
+
+When you run queries, you'll see beautifully formatted output like this:
+
+```
+╭─ Database Query #1
+│  Time: 14:32:15
+│  🔍 SELECT on users
+│  SQL: SELECT id, name, email FROM users WHERE age > 18
+   ├─ Parameters: $1: 18
+╰──────────────────────────────────────────────────────
+```
+
+## 🎯 Query Types & Icons
+
+The logger automatically detects and styles different query types:
+
+| Query Type | Icon | Color  |
+|------------|------|--------|
+| SELECT     | 🔍   | Green  |
+| INSERT     | 📝   | Blue   |
+| UPDATE     | ✏️   | Yellow |
+| DELETE     | 🗑️   | Red    |
+| CREATE     | 🏗️   | Magenta|
+| DROP       | 💥   | Red    |
+| ALTER      | 🔧   | Cyan   |
+| OTHER      | ⚡   | White  |
+
+## 🛠️ Configuration
+
+### Constructor Options
+
+```typescript
+interface LoggerOptions {
+  log?: (message: string) => void;
+}
+```
+
+- **`log`**: Custom logging function (default: `console.log`)
+
+### Example with Custom Configuration
+
+```typescript
+const logger = new EnhancedQueryLogger({
+  log: (message) => {
+    // Custom logging logic
+    if (process.env.NODE_ENV === 'development') {
+      console.log(message);
+    } else {
+      // Send to logging service in production
+      yourLoggingService.debug(message);
+    }
+  }
+});
+```
+
+## 🎨 Color Scheme
+
+The logger uses a carefully chosen color scheme for optimal readability:
+
+- **Keywords**: Blue (SELECT, FROM, WHERE, etc.)
+- **Strings**: Green
+- **Numbers**: Cyan
+- **Booleans**: Yellow
+- **Objects**: Magenta
+- **Null values**: Dimmed
+- **Table names**: Yellow
+- **Framework elements**: Gray with cyan accents
+
+## 🔧 TypeScript Support
+
+This package is written in TypeScript and provides full type definitions. It implements Drizzle's `Logger` interface:
+
+```typescript
+import type { Logger } from 'drizzle-orm/logger';
+
+export class EnhancedQueryLogger implements Logger {
+  logQuery(query: string, params: unknown[]): void;
+}
+```
+
+## 📋 Requirements
+
+- **Node.js**: 16+ 
+- **TypeScript**: 5+ (peer dependency)
+- **Drizzle ORM**: Compatible with all recent versions
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## 📄 License
+
+MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+Built for the [Drizzle ORM](https://orm.drizzle.team/) ecosystem.