@gl-life/gl-life-database 1.1.0 → 1.1.1

package/API.md

@@ -1,6 +1,6 @@
 # @gl-life/gl-life-database API Reference
 
-**Version**: 1.1.0
+**Version**: 1.1.1
 **Package**: `@gl-life/gl-life-database`
 **License**: Apache-2.0
 **Homepage**: https://gl.life
@@ -9,11 +9,13 @@
 
 - [Core Types](#core-types)
 - [Connection Management](#connection-management)
+- [Enterprise Database Support](#enterprise-database-support)
 - [Query Builder](#query-builder)
 - [Transactions](#transactions)
 - [Multi-Tenancy](#multi-tenancy)
 - [Caching](#caching)
 - [Migrations](#migrations)
+- [Flex Table System](#flex-table-system)
 - [CloudForge Adapters](#cloudforge-adapters)
 - [Error Handling](#error-handling)
 - [Usage Patterns](#usage-patterns)
@@ -137,6 +139,205 @@ Returns an available connection from the pool.
 
 ---
 
+## Enterprise Database Support
+
+Full support for enterprise databases with bring-your-own-database (BYOD) deployments.
+
+### Supported Databases
+
+#### SQL Server (Microsoft)
+
+```typescript
+interface SQLServerConfig {
+  type: 'sqlserver';
+  host: string;
+  port?: number;              // Default: 1433
+  database: string;
+  username: string;
+  password: string;
+  options?: {
+    encrypt?: boolean;        // Required for Azure SQL
+    trustServerCertificate?: boolean;
+    connectionTimeout?: number;
+    requestTimeout?: number;
+    pool?: {
+      max?: number;
+      min?: number;
+      idleTimeoutMillis?: number;
+    };
+  };
+}
+```
+
+**Example**:
+```typescript
+const connection = await manager.connect({
+  type: 'sqlserver',
+  host: 'sql-server.database.windows.net',
+  port: 1433,
+  database: 'production',
+  username: 'admin',
+  password: process.env.DB_PASSWORD,
+  options: {
+    encrypt: true,
+    trustServerCertificate: false,
+    connectionTimeout: 30000,
+    pool: {
+      max: 20,
+      min: 5,
+      idleTimeoutMillis: 30000
+    }
+  }
+});
+```
+
+#### PostgreSQL
+
+```typescript
+interface PostgreSQLConfig {
+  type: 'postgres';
+  host: string;
+  port?: number;              // Default: 5432
+  database: string;
+  username: string;
+  password: string;
+  options?: {
+    ssl?: boolean | object;
+    poolSize?: number;
+    idleTimeoutMillis?: number;
+    connectionTimeoutMillis?: number;
+    schema?: string;
+  };
+}
+```
+
+**Example**:
+```typescript
+const connection = await manager.connect({
+  type: 'postgres',
+  host: 'postgres-cluster.company.com',
+  port: 5432,
+  database: 'production',
+  username: 'dbuser',
+  password: process.env.DB_PASSWORD,
+  options: {
+    ssl: { rejectUnauthorized: false },
+    poolSize: 20,
+    schema: 'public'
+  }
+});
+```
+
+#### MySQL / MariaDB
+
+```typescript
+interface MySQLConfig {
+  type: 'mysql';
+  host: string;
+  port?: number;              // Default: 3306
+  database: string;
+  username: string;
+  password: string;
+  options?: {
+    connectionLimit?: number;
+    charset?: string;
+    timezone?: string;
+    ssl?: boolean | object;
+  };
+}
+```
+
+**Example**:
+```typescript
+const connection = await manager.connect({
+  type: 'mysql',
+  host: 'mysql-primary.internal.com',
+  port: 3306,
+  database: 'production',
+  username: 'app_user',
+  password: process.env.DB_PASSWORD,
+  options: {
+    connectionLimit: 10,
+    charset: 'utf8mb4',
+    timezone: 'Z'
+  }
+});
+```
+
+#### Oracle Database
+
+```typescript
+interface OracleConfig {
+  type: 'oracle';
+  host: string;
+  port?: number;              // Default: 1521
+  database: string;           // Service name
+  username: string;
+  password: string;
+  options?: {
+    poolMax?: number;
+    poolMin?: number;
+    poolIncrement?: number;
+    poolTimeout?: number;
+  };
+}
+```
+
+**Example**:
+```typescript
+const connection = await manager.connect({
+  type: 'oracle',
+  host: 'oracle-db.company.com',
+  port: 1521,
+  database: 'ORCL',
+  username: 'system',
+  password: process.env.DB_PASSWORD,
+  options: {
+    poolMax: 10,
+    poolMin: 2,
+    poolIncrement: 1
+  }
+});
+```
+
+### Enterprise Features
+
+All features work identically across all database engines:
+
+- ✅ **Flex Table System** - Dynamic schemas work on any database
+- ✅ **Multi-Tenancy** - Row-Level Security on all engines
+- ✅ **Caching** - Cache layer independent of database type
+- ✅ **Migrations** - Version control for any database
+- ✅ **Transactions** - ACID compliance on all supported databases
+- ✅ **Connection Pooling** - Automatic connection management
+
+### Hybrid Deployments
+
+Mix cloud and on-premise databases in the same application:
+
+```typescript
+// Cloud database for non-sensitive data
+const cloudConn = await manager.connect({
+  type: 'd1',
+  binding: env.DB
+});
+
+// Enterprise database for sensitive data
+const enterpriseConn = await manager.connect({
+  type: 'sqlserver',
+  host: 'on-premise-sql.company.local',
+  database: 'customer_data',
+  username: 'app_user',
+  password: process.env.DB_PASSWORD
+});
+
+// Use both in same application
+const products = await cloudConn.execute('SELECT * FROM products');
+const customers = await enterpriseConn.execute('SELECT * FROM customers WHERE tenant_id = ?', [tenantId]);
+```
+
+---
+
 ## Query Builder
 
 ### TypeSafeQueryBuilder

package/README.md

@@ -4,16 +4,17 @@ Enhanced gl-life-data wrapper with CloudForge features - Type-safe database abst
 
 ## About
 
-`@gl-life/gl-life-database` is a comprehensive database abstraction layer that extends gl-life-data with enterprise features for multi-tenant SaaS applications running on Cloudflare Workers. Built with TypeScript and designed for type safety, it provides a robust foundation for building scalable database-driven applications.
+`@gl-life/gl-life-database` is a comprehensive database abstraction layer that extends gl-life-data with enterprise features for multi-tenant SaaS applications. Built with TypeScript and designed for type safety, it supports both cloud-native deployments (Cloudflare Workers) and enterprise bring-your-own-database (BYOD) scenarios with SQL Server, MySQL, PostgreSQL, Oracle, and more. Perfect for pro users who want to leverage their existing infrastructure while gaining powerful features like Flex tables, multi-tenancy, and intelligent caching.
 
 ### Key Features
 
 - 🗄️ **Type-Safe Query Builder** - Fluent API with full TypeScript support extending gl-life-data
 - 🔀 **Flex Table System** - Dynamic schema without ALTER TABLE, metadata-driven field mapping
+- 🏢 **Enterprise Database Support** - Full support for SQL Server, MySQL, PostgreSQL, Oracle, and more
 - 👥 **Multi-Tenancy** - Built-in tenant isolation with Row-Level Security (RLS)
-- ⚡ **Caching Layer** - High-performance query result caching with memory and Cloudflare KV backends
+- ⚡ **Flexible Caching** - Memory cache, Redis, or Cloudflare KV backends
 - 🔄 **Migrations** - Version-controlled database migrations with rollback support
-- ☁️ **CloudForge Integration** - Native support for D1, Durable Objects, Workers KV, and R2
+- ☁️ **Cloud + On-Premise** - Deploy on Cloudflare Workers OR bring your own infrastructure
 - 🔒 **SQL Injection Protection** - Parameterized queries with automatic sanitization
 - 🧪 **Well-Tested** - >95% test coverage with comprehensive security tests
 - 📊 **Performance Optimized** - Query building overhead <1ms (P95)
@@ -181,6 +182,108 @@ export default {
 };
 ```
 
+### Enterprise Database Support (BYOD - Bring Your Own Database)
+
+Pro users can connect to their existing enterprise databases instead of using Cloudflare Workers. Full support for:
+
+#### SQL Server (Microsoft)
+
+```typescript
+import { ConnectionManager, Logger } from '@gl-life/gl-life-database';
+
+const logger = new Logger({ level: 'info' });
+const manager = new ConnectionManager(logger);
+
+const connection = await manager.connect({
+  type: 'sqlserver',
+  host: 'your-sql-server.database.windows.net',
+  port: 1433,
+  database: 'production_db',
+  username: 'admin',
+  password: process.env.DB_PASSWORD,
+  options: {
+    encrypt: true,                    // Azure SQL requires encryption
+    trustServerCertificate: false,
+    connectionTimeout: 30000
+  }
+});
+
+// All features work identically: Flex tables, multi-tenancy, caching, migrations
+const builder = new TypeSafeQueryBuilder('users', metaDataService, logger);
+// ... same as any other database
+```
+
+#### PostgreSQL
+
+```typescript
+const connection = await manager.connect({
+  type: 'postgres',
+  host: 'your-postgres-instance.com',
+  port: 5432,
+  database: 'production_db',
+  username: 'dbuser',
+  password: process.env.DB_PASSWORD,
+  options: {
+    ssl: { rejectUnauthorized: false },
+    poolSize: 20,
+    idleTimeoutMillis: 30000
+  }
+});
+```
+
+#### MySQL / MariaDB
+
+```typescript
+const connection = await manager.connect({
+  type: 'mysql',
+  host: 'mysql-cluster.internal.com',
+  port: 3306,
+  database: 'production_db',
+  username: 'dbuser',
+  password: process.env.DB_PASSWORD,
+  options: {
+    connectionLimit: 10,
+    charset: 'utf8mb4',
+    timezone: 'Z'
+  }
+});
+```
+
+#### Oracle Database
+
+```typescript
+const connection = await manager.connect({
+  type: 'oracle',
+  host: 'oracle-enterprise.company.com',
+  port: 1521,
+  database: 'ORCL',              // Service name
+  username: 'system',
+  password: process.env.DB_PASSWORD,
+  options: {
+    poolMax: 10,
+    poolMin: 2,
+    poolIncrement: 1
+  }
+});
+```
+
+#### SQLite (Development/Testing)
+
+```typescript
+const connection = await manager.connect({
+  type: 'sqlite',
+  filename: './dev.db'            // Or ':memory:' for in-memory
+});
+```
+
+**Key Benefits for Enterprise Users:**
+- ✅ **Use Existing Infrastructure** - No migration required, connect to your current databases
+- ✅ **All Features Work** - Flex tables, multi-tenancy, caching, migrations work on any database
+- ✅ **Security Compliant** - Keep data on-premise, meet regulatory requirements
+- ✅ **Cost Control** - Use your existing database licenses and hardware
+- ✅ **Hybrid Deployments** - Mix cloud (D1) and on-premise databases in same application
+- ✅ **Connection Pooling** - Built-in connection management for all enterprise databases
+
 ### Flex Table System
 
 The Flex Table System is a powerful feature from gl-life-data that provides dynamic schema capabilities without ALTER TABLE operations. Perfect for multi-tenant SaaS applications where each tenant needs custom fields.

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for @gl-life/gl-life-database v1.1.0
+// Type definitions for @gl-life/gl-life-database v1.1.1
 // Manual declarations due to tsup build limitations with Result type
 
 // Re-export from gl-life-core

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gl-life/gl-life-database",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Enhanced gl-life-data wrapper with CloudForge features - Type-safe database abstraction layer with multi-tenancy, caching, migrations, and Cloudflare Workers support",
   "type": "module",
   "main": "./dist/index.js",