@zintrust/core 0.1.21 → 0.1.23

package/src/orm/ConnectionManager.d.ts

@@ -1,10 +1,12 @@
 /**
- * Persistent Connection Manager for Zintrust Framework
+ * Persistent Connection Manager for ZinTrust Framework
  * Handles database connections across different runtime environments
  * Supports: PostgreSQL, MySQL, SQL Server with connection pooling for Lambda
  */
+import type { SupportedDriver } from '../migrations/enum';
+import type { IDatabaseAdapter } from './DatabaseAdapter';
 export interface ConnectionConfig {
-    adapter: 'postgresql' | 'mysql' | 'sqlite' | 'sqlserver' | 'd1' | 'aurora-data-api';
+    adapter: SupportedDriver;
     host?: string;
     port?: number;
     database: string;
@@ -31,7 +33,7 @@ export interface ConnectionPool {
     queued: number;
 }
 interface ConnectionManagerInstance {
-    getConnection(id?: string): Promise<unknown>;
+    getConnection(id?: string): Promise<IDatabaseAdapter>;
     releaseConnection(connectionId?: string): Promise<void>;
     closeAll(): Promise<void>;
     getPoolStats(): ConnectionPool;
@@ -58,7 +60,7 @@ export declare const ConnectionManager: Readonly<{
     /**
      * Get or create database connection
      */
-    getConnection(id?: string): Promise<unknown>;
+    getConnection(id?: string): Promise<IDatabaseAdapter>;
     /**
      * Release connection back to pool (but keep persistent)
      */
@@ -97,7 +99,7 @@ export interface AuroraQueryResult {
 /**
  * Get database credentials from AWS Secrets Manager
  */
-export declare function getDatabaseSecret(_secretName: string): Promise<DatabaseSecret>;
+export declare function getDatabaseSecret(secretName: string): Promise<DatabaseSecret>;
 /**
  * Get database credentials from environment variables
  */

package/src/orm/ConnectionManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConnectionManager.d.ts","sourceRoot":"","sources":["../../../src/orm/ConnectionManager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ConnectionManager.d.ts","sourceRoot":"","sources":["../../../src/orm/ConnectionManager.ts"],"names":[],"mappings":"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"}

package/src/orm/ConnectionManager.js

@@ -1,48 +1,43 @@
 /* eslint-disable no-await-in-loop */
 /* eslint-disable @typescript-eslint/require-await */
 /**
- * Persistent Connection Manager for Zintrust Framework
+ * Persistent Connection Manager for ZinTrust Framework
  * Handles database connections across different runtime environments
  * Supports: PostgreSQL, MySQL, SQL Server with connection pooling for Lambda
  */
 import { Env } from '../config/env.js';
 import { Logger } from '../config/logger.js';
 import { ErrorFactory } from '../exceptions/ZintrustError.js';
+import { D1Adapter } from './adapters/D1Adapter.js';
+import { D1RemoteAdapter } from './adapters/D1RemoteAdapter.js';
+import { MySQLAdapter } from './adapters/MySQLAdapter.js';
+import { PostgreSQLAdapter } from './adapters/PostgreSQLAdapter.js';
+import { SQLiteAdapter } from './adapters/SQLiteAdapter.js';
+import { SQLServerAdapter } from './adapters/SQLServerAdapter.js';
+import { DatabaseAdapterRegistry } from './DatabaseAdapterRegistry.js';
 let instance;
 /**
  * Close a specific connection
  */
 const closeConnection = async (conn) => {
-    if (conn !== undefined &&
-        conn !== null &&
-        typeof conn === 'object' &&
-        'close' in conn &&
-        typeof conn.close === 'function') {
-        await conn.close();
+    if (isDatabaseAdapter(conn)) {
+        await conn.disconnect();
     }
 };
 /**
  * Test if connection is still alive
  */
-const testConnection = async (config, _conn) => {
+const testConnection = async (_config, conn) => {
+    if (!isDatabaseAdapter(conn))
+        return false;
+    if (!conn.isConnected())
+        return false;
     try {
-        if (config.adapter === 'postgresql' || config.adapter === 'mysql') {
-            // SELECT 1 for PostgreSQL/MySQL
-            await new Promise((resolve, reject) => {
-                const timeout = globalThis.setTimeout(() => reject(ErrorFactory.createConnectionError('Connection test timeout')), 5000);
-                try {
-                    // In real implementation, query the connection
-                    resolve(true);
-                }
-                finally {
-                    clearTimeout(timeout);
-                }
-            });
-        }
+        await conn.ping();
         return true;
     }
     catch (error) {
-        ErrorFactory.createConnectionError('Connection test failed:', error);
+        Logger.warn('Connection health check failed', error);
         return false;
     }
 };
@@ -50,45 +45,141 @@ const testConnection = async (config, _conn) => {
  * Update connection usage metrics
  */
 const updateConnectionUsage = (connectionPool, id) => {
-    const entry = connectionPool.find((c) => c.id === id);
+    const entry = connectionPool.get(id); // O(1) lookup instead of O(n) find
     if (entry !== undefined) {
         entry.lastUsedAt = Date.now();
         entry.queryCount++;
         entry.isActive = true;
     }
 };
+const isDatabaseAdapter = (value) => {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const candidate = value;
+    return (typeof candidate.connect === 'function' &&
+        typeof candidate.disconnect === 'function' &&
+        typeof candidate.ping === 'function' &&
+        typeof candidate.isConnected === 'function');
+};
+const createAdapterFromConfig = (config) => {
+    if (config.adapter === 'aurora-data-api') {
+        throw ErrorFactory.createConfigError('Aurora Data API connections should be created via getAuroraDataApiConnection()');
+    }
+    const driver = config.adapter;
+    const adapterConfig = {
+        driver,
+        database: config.database,
+        host: config.host,
+        port: config.port,
+        username: config.username,
+        password: config.password,
+    };
+    const registered = DatabaseAdapterRegistry.get(driver);
+    if (registered !== undefined) {
+        return registered(adapterConfig);
+    }
+    switch (driver) {
+        case 'postgresql':
+            return PostgreSQLAdapter.create(adapterConfig);
+        case 'mysql':
+            return MySQLAdapter.create(adapterConfig);
+        case 'sqlserver':
+            return SQLServerAdapter.create(adapterConfig);
+        case 'd1':
+            return D1Adapter.create(adapterConfig);
+        case 'd1-remote':
+            return D1RemoteAdapter.create(adapterConfig);
+        case 'sqlite':
+        default:
+            return SQLiteAdapter.create(adapterConfig);
+    }
+};
 /**
  * Create new database connection
  */
 const createConnection = async (config, id) => {
     Logger.info(`Creating ${config.adapter} connection (${id}) to ${config.host}:${config.port}`);
-    // Connection creation would be adapter-specific
-    // This is a placeholder for the actual implementation
-    return {
-        id,
-        adapter: config.adapter,
-        query: async (_sql, _params) => {
-            throw ErrorFactory.createDatabaseError(`Query execution not implemented for ${config.adapter}`);
-        },
-        close: async () => {
-            Logger.info(`Connection ${id} closed`);
-        },
-    };
+    if (config.adapter === 'aurora-data-api') {
+        throw ErrorFactory.createConfigError('Aurora Data API connections should be created via getAuroraDataApiConnection()');
+    }
+    const adapter = createAdapterFromConfig(config);
+    await adapter.connect();
+    return adapter;
 };
 /**
  * Create Aurora Data API connection
  */
-const createAuroraDataApiConnection = () => ({
-    execute: async (_sql, _params) => {
-        // Call Aurora Data API via AWS SDK
-        // Requires proper IAM permissions
-        throw ErrorFactory.createConfigError('Aurora Data API not implemented yet');
-    },
-    batch: async (_statements) => {
-        // Execute batch statements
-        throw ErrorFactory.createConfigError('Aurora Data API batch not implemented yet');
-    },
-});
+function isMissingEsmPackage(error, packageName) {
+    if (typeof error !== 'object' || error === null)
+        return false;
+    const maybe = error;
+    const code = typeof maybe.code === 'string' ? maybe.code : '';
+    const message = typeof maybe.message === 'string' ? maybe.message : '';
+    if (code === 'ERR_MODULE_NOT_FOUND' && message.length === 0)
+        return true;
+    if (code === 'ERR_MODULE_NOT_FOUND' && message.includes(`'${packageName}'`))
+        return true;
+    if (message.includes(`Cannot find package '${packageName}'`))
+        return true;
+    return false;
+}
+async function importOptionalModule(modulePath) {
+    return import(modulePath);
+}
+const loadClientRdsDataModule = async () => {
+    try {
+        return (await importOptionalModule('@zintrust/client-rds-data'));
+    }
+    catch (error) {
+        if (isMissingEsmPackage(error, '@zintrust/client-rds-data')) {
+            throw ErrorFactory.createConfigError("Aurora Data API requires '@zintrust/client-rds-data' (install the package to enable AWS Data API support).");
+        }
+        throw ErrorFactory.createTryCatchError('Failed to load @zintrust/client-rds-data', {
+            cause: error,
+        });
+    }
+};
+const createAuroraDataApiConnection = () => {
+    const getClient = async () => {
+        const mod = await loadClientRdsDataModule();
+        return mod.getRdsDataClient(Env.AWS_REGION);
+    };
+    const resourceArn = Env.get('AURORA_RESOURCE_ARN');
+    const secretArn = Env.get('AURORA_SECRET_ARN');
+    const database = Env.get('AURORA_DATABASE', Env.DB_DATABASE);
+    const assertConfig = () => {
+        if (resourceArn.length === 0 || secretArn.length === 0) {
+            throw ErrorFactory.createConfigError('Aurora Data API requires AURORA_RESOURCE_ARN and AURORA_SECRET_ARN env vars');
+        }
+    };
+    const executeStatement = async (sql, params) => {
+        assertConfig();
+        const client = await getClient();
+        const input = {
+            resourceArn,
+            secretArn,
+            database,
+            sql,
+            parameters: (params ?? []).map((value) => ({ value: { stringValue: String(value) } })),
+        };
+        const response = (await client.executeStatement(input));
+        return {
+            numberOfRecordsUpdated: response.numberOfRecordsUpdated ?? 0,
+            records: response.records ?? [],
+        };
+    };
+    return {
+        execute: executeStatement,
+        batch: async (statements) => {
+            const results = [];
+            for (const statement of statements) {
+                const result = await executeStatement(statement.sql, statement.params);
+                results.push(result);
+            }
+            return results;
+        },
+    };
+};
 /**
  * Get healthy existing connection if available
  */
@@ -101,60 +192,62 @@ const getHealthyExistingConnection = async (config, state, id) => {
         return conn;
     }
     state.connections.delete(id);
-    state.connectionPool = state.connectionPool.filter((c) => c.id !== id);
+    state.connectionPool.delete(id); // O(1) instead of O(n) filter
     return null;
 };
 /**
  * Find an idle connection in the pool
  */
 const findIdleConnection = (state) => {
-    const idleConnections = state.connectionPool.filter((c) => !c.isActive);
-    if (idleConnections.length === 0)
+    let lruEntry = null;
+    let lruTime = Date.now();
+    // Iterate through Map values to find least recently used idle connection
+    for (const poolEntry of state.connectionPool.values()) {
+        if (!poolEntry.isActive && poolEntry.lastUsedAt < lruTime) {
+            lruTime = poolEntry.lastUsedAt;
+            lruEntry = poolEntry;
+        }
+    }
+    if (lruEntry === null)
         return null;
-    const lru = idleConnections.reduce((prev, current) => (prev.lastUsedAt < current.lastUsedAt ? prev : current), idleConnections[0]);
-    updateConnectionUsage(state.connectionPool, lru.id);
-    return state.connections.get(lru.id);
+    updateConnectionUsage(state.connectionPool, lruEntry.id);
+    const conn = state.connections.get(lruEntry.id);
+    return conn ?? null;
 };
 /**
  * Wait for a connection to become available
  */
 const waitForIdleConnection = async (state) => {
     return new Promise((resolve, reject) => {
-        let settled = false;
         let timeoutId;
-        const checkInterval = setInterval(() => {
-            const idle = state.connectionPool.find((c) => !c.isActive);
-            if (idle !== undefined) {
-                if (settled)
-                    return;
-                settled = true;
-                cleanup();
-                updateConnectionUsage(state.connectionPool, idle.id);
-                resolve(state.connections.get(idle.id));
-            }
-        }, 100);
         const cleanup = () => {
-            clearInterval(checkInterval);
             if (timeoutId !== undefined) {
-                clearTimeout(timeoutId);
+                globalThis.clearTimeout(timeoutId);
                 timeoutId = undefined;
             }
         };
-        // Node: allow process to exit; other runtimes may not support unref()
-        if (isUnrefableTimer(checkInterval)) {
-            checkInterval.unref();
-        }
-        // eslint-disable-next-line no-restricted-syntax
-        timeoutId = setTimeout(() => {
-            if (settled)
-                return;
-            settled = true;
+        const waiter = {
+            resolve: (conn) => {
+                cleanup();
+                resolve(conn);
+            },
+            reject: (err) => {
+                cleanup();
+                reject(err);
+            },
+            timeoutId,
+            cleanup,
+        };
+        timeoutId = globalThis.setTimeout(() => {
+            state.waiters = state.waiters.filter((entry) => entry !== waiter);
             cleanup();
             reject(ErrorFactory.createConnectionError('Connection pool exhausted - timeout waiting for available connection'));
         }, 30000);
+        waiter.timeoutId = timeoutId;
         if (isUnrefableTimer(timeoutId)) {
             timeoutId.unref();
         }
+        state.waiters.push(waiter);
     });
 };
 function isUnrefableTimer(value) {
@@ -181,19 +274,22 @@ const startIdleConnectionCleanup = (state, idleTimeout) => {
     state.cleanupInterval = setInterval(() => {
         const now = Date.now();
         const toRemove = [];
-        for (const poolEntry of state.connectionPool) {
+        for (const [id, poolEntry] of state.connectionPool.entries()) {
             if (!poolEntry.isActive && now - poolEntry.lastUsedAt > idleTimeout) {
-                toRemove.push(poolEntry.id);
+                toRemove.push(id);
             }
         }
         for (const id of toRemove) {
             const conn = state.connections.get(id);
             closeConnection(conn).catch((err) => Logger.error(`Failed to close idle connection ${id}:`, err));
             state.connections.delete(id);
-            state.connectionPool = state.connectionPool.filter((c) => c.id !== id);
+            state.connectionPool.delete(id); // O(1) instead of O(n) filter
             Logger.info(`Removed idle connection: ${id}`);
         }
     }, 300000); // Every 5 minutes
+    if (isUnrefableTimer(state.cleanupInterval)) {
+        state.cleanupInterval.unref();
+    }
 };
 /**
  * Create and register a new connection
@@ -201,7 +297,8 @@ const startIdleConnectionCleanup = (state, idleTimeout) => {
 const createNewConnection = async (config, state, id) => {
     const connection = await createConnection(config, id);
     state.connections.set(id, connection);
-    state.connectionPool.push({
+    state.connectionPool.set(id, {
+        // O(1) instead of O(n) push
         id,
         adapter: config.adapter,
         createdAt: Date.now(),
@@ -219,6 +316,15 @@ const closeAllConnections = async (state) => {
         clearInterval(state.cleanupInterval);
         state.cleanupInterval = undefined;
     }
+    if (state.waiters.length > 0) {
+        const err = ErrorFactory.createConnectionError('Connection manager shutting down');
+        for (const waiter of state.waiters) {
+            if (waiter.timeoutId !== undefined)
+                clearTimeout(waiter.timeoutId);
+            waiter.reject(err);
+        }
+        state.waiters = [];
+    }
     for (const [id, conn] of state.connections.entries()) {
         try {
             await closeConnection(conn);
@@ -228,19 +334,28 @@ const closeAllConnections = async (state) => {
         }
     }
     state.connections.clear();
-    state.connectionPool = [];
+    state.connectionPool.clear(); // Use Map.clear() instead of array reset
 };
 /**
  * Get connection pool statistics
  */
 const getPoolStatistics = (state) => {
-    const active = state.connectionPool.filter((c) => c.isActive).length;
-    const idle = state.connectionPool.filter((c) => !c.isActive).length;
+    let active = 0;
+    let idle = 0;
+    // Iterate through Map values instead of filtering array
+    for (const poolEntry of state.connectionPool.values()) {
+        if (poolEntry.isActive) {
+            active++;
+        }
+        else {
+            idle++;
+        }
+    }
     return {
-        total: state.connectionPool.length,
+        total: state.connectionPool.size, // Use Map.size instead of array length
         active,
         idle,
-        queued: 0,
+        queued: state.waiters.length,
     };
 };
 /**
@@ -254,7 +369,8 @@ const ConnectionManagerImpl = {
     create(config) {
         const state = {
             connections: new Map(),
-            connectionPool: [],
+            connectionPool: new Map(), // Changed from Array to Map
+            waiters: [],
         };
         const maxConnections = config.maxConnections ?? 10;
         const idleTimeout = config.idleTimeout ?? 900000; // 15 minutes
@@ -268,7 +384,8 @@ const ConnectionManagerImpl = {
                 const existing = await getHealthyExistingConnection(config, state, id);
                 if (existing !== null)
                     return existing;
-                if (state.connectionPool.length < maxConnections) {
+                if (state.connectionPool.size < maxConnections) {
+                    // Use Map.size instead of array length
                     return createNewConnection(config, state, id);
                 }
                 return getOrReuseConnection(state);
@@ -277,11 +394,24 @@ const ConnectionManagerImpl = {
              * Release connection back to pool (but keep persistent)
              */
             async releaseConnection(connectionId = 'default') {
-                const poolEntry = state.connectionPool.find((c) => c.id === connectionId);
-                if (poolEntry !== undefined) {
-                    poolEntry.isActive = false;
-                    poolEntry.lastUsedAt = Date.now();
+                const poolEntry = state.connectionPool.get(connectionId); // O(1) instead of O(n) find
+                if (poolEntry === undefined)
+                    return;
+                poolEntry.isActive = false;
+                poolEntry.lastUsedAt = Date.now();
+                if (state.waiters.length === 0)
+                    return;
+                const waiter = state.waiters.shift();
+                if (waiter === undefined)
+                    return;
+                waiter.cleanup();
+                const conn = state.connections.get(connectionId);
+                if (conn === undefined) {
+                    waiter.reject(ErrorFactory.createConnectionError('Released connection not found'));
+                    return;
                 }
+                updateConnectionUsage(state.connectionPool, connectionId);
+                waiter.resolve(conn);
             },
             /**
              * Close all connections (graceful shutdown)
@@ -341,6 +471,7 @@ export const ConnectionManager = Object.freeze({
         if (instance !== undefined) {
             try {
                 await instance.closeAll();
+                instance = undefined;
             }
             catch (err) {
                 Logger.error('Error while shutting down ConnectionManager:', err);
@@ -387,9 +518,34 @@ export const ConnectionManager = Object.freeze({
 /**
  * Get database credentials from AWS Secrets Manager
  */
-export async function getDatabaseSecret(_secretName) {
-    // Would use AWS SDK to fetch from Secrets Manager
-    throw ErrorFactory.createConfigError('Secrets Manager integration not implemented');
+export async function getDatabaseSecret(secretName) {
+    try {
+        const mod = await loadClientRdsDataModule();
+        const client = await mod.getSecretsManagerClient(Env.AWS_REGION);
+        const response = await client.getSecretValue(secretName);
+        const secretString = response.SecretString;
+        if (secretString === undefined || secretString === null || secretString.trim().length === 0) {
+            throw ErrorFactory.createConfigError('Secrets Manager returned an empty secret');
+        }
+        const parsed = JSON.parse(secretString);
+        if (parsed.username === undefined ||
+            parsed.password === undefined ||
+            parsed.host === undefined ||
+            parsed.port === undefined ||
+            parsed.database === undefined) {
+            throw ErrorFactory.createConfigError('Secrets Manager secret is missing required fields');
+        }
+        return {
+            username: parsed.username,
+            password: parsed.password,
+            host: parsed.host,
+            port: Number(parsed.port),
+            database: parsed.database,
+        };
+    }
+    catch (error) {
+        throw ErrorFactory.createTryCatchError('Failed to fetch database secret', { cause: error });
+    }
 }
 /**
  * Get database credentials from environment variables

package/src/orm/Database.d.ts

@@ -2,6 +2,7 @@
  * Database Manager
  * Central database connection management and query execution
  */
+import type { SupportedDriver } from '../migrations/enum';
 import type { DatabaseConfig, IDatabaseAdapter, QueryResult } from './DatabaseAdapter';
 import type { IQueryBuilder } from './QueryBuilder';
 export interface IDatabase {
@@ -18,7 +19,7 @@ export interface IDatabase {
     offBeforeQuery(handler: (query: string, params: unknown[]) => void): void;
     offAfterQuery(handler: (query: string, params: unknown[], duration: number) => void): void;
     getAdapterInstance(isRead?: boolean): IDatabaseAdapter;
-    getType(): string;
+    getType(): SupportedDriver;
     getConfig(): DatabaseConfig;
     dispose(): void;
 }

package/src/orm/Database.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Database.d.ts","sourceRoot":"","sources":["../../../src/orm/Database.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE1F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD,MAAM,WAAW,SAAS;IACxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,WAAW,IAAI,OAAO,CAAC;IACvB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACjF,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClF,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACrF,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACpE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC;IACnC,aAAa,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IACzE,YAAY,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC1F,cAAc,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAC1E,aAAa,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC3F,kBAAkB,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;IACvD,OAAO,IAAI,MAAM,CAAC;IAClB,SAAS,IAAI,cAAc,CAAC;IAC5B,OAAO,IAAI,IAAI,CAAC;CACjB;AA0YD,eAAO,MAAM,QAAQ;IACnB;;OAEG;oBACa,cAAc,GAAG,SAAS;EAI1C,CAAC;AAIH,eAAO,MAAM,oBAAoB,GAC/B,kBAAkB,EAClB,uBAA0B,KACzB,OAAO,CAAC,UAAU,CAAC,OAAO,WAAW,CAAC,CAMxC,CAAC;AAEF,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,UAAU,SAAY,GAAG,SAAS,CAgBtF;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAWnD"}
+{"version":3,"file":"Database.d.ts","sourceRoot":"","sources":["../../../src/orm/Database.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAQxD,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE1F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD,MAAM,WAAW,SAAS;IACxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,WAAW,IAAI,OAAO,CAAC;IACvB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACjF,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClF,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACrF,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACpE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC;IACnC,aAAa,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IACzE,YAAY,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC1F,cAAc,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAC1E,aAAa,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC3F,kBAAkB,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;IACvD,OAAO,IAAI,eAAe,CAAC;IAC3B,SAAS,IAAI,cAAc,CAAC;IAC5B,OAAO,IAAI,IAAI,CAAC;CACjB;AA0YD,eAAO,MAAM,QAAQ;IACnB;;OAEG;oBACa,cAAc,GAAG,SAAS;EAI1C,CAAC;AAIH,eAAO,MAAM,oBAAoB,GAC/B,kBAAkB,EAClB,uBAA0B,KACzB,OAAO,CAAC,UAAU,CAAC,OAAO,WAAW,CAAC,CAMxC,CAAC;AAEF,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,UAAU,SAAY,GAAG,SAAS,CAgBtF;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAWnD"}

package/src/orm/DatabaseAdapter.d.ts

@@ -2,6 +2,7 @@
  * Database Adapter Interface
  * Defines contract for different database implementations
  */
+import type { SupportedDriver } from '../migrations/enum';
 /**
  * Minimal D1 Database interface for type safety
  */
@@ -23,7 +24,7 @@ export interface ID1Database {
 }
 export interface DatabaseConfig {
     d1?: ID1Database;
-    driver: 'sqlite' | 'postgresql' | 'mysql' | 'sqlserver' | 'd1' | 'd1-remote';
+    driver: SupportedDriver;
     database?: string;
     host?: string;
     port?: number;
@@ -86,7 +87,7 @@ export interface IDatabaseAdapter {
     /**
      * Get database type
      */
-    getType(): string;
+    getType(): SupportedDriver;
     /**
      * Check connection status
      */

package/src/orm/DatabaseAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DatabaseAdapter.d.ts","sourceRoot":"","sources":["../../../src/orm/DatabaseAdapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"DatabaseAdapter.d.ts","sourceRoot":"","sources":["../../../src/orm/DatabaseAdapter.ts"],"names":[],"mappings":"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"}

package/src/orm/DatabaseAdapter.js

@@ -20,9 +20,26 @@ export const BaseAdapter = Object.freeze({
         if (typeof value === 'boolean') {
             return value ? '1' : '0';
         }
+        // Support BigInt explicitly to avoid JSON.stringify errors and driver issues
+        if (typeof value === 'bigint') {
+            return String(value);
+        }
+        // Dates should be passed as ISO strings
+        if (value instanceof Date) {
+            return `'${value.toISOString()}'`;
+        }
         if (typeof value === 'number') {
             return String(value);
         }
+        // Buffer / Uint8Array -> base64 string
+        // Some DB adapters expect binary types; returning base64-encoded string is a safe default
+        // and prevents JSON.stringify(BigInt) errors when objects include BigInt.
+        if (typeof Buffer !== 'undefined' && Buffer.isBuffer(value)) {
+            return `'${value.toString('base64')}'`;
+        }
+        if (value instanceof Uint8Array) {
+            return `'${Buffer.from(value).toString('base64')}'`;
+        }
         // For objects, convert to JSON string representation
         return `'${JSON.stringify(value).replaceAll("'", "''")}'`;
     },