@mostajs/orm 1.0.0 → 1.2.0

package/dist/bridge/jdbc-registry.d.ts

@@ -0,0 +1,31 @@
+import type { DialectType } from '../core/types.js';
+export interface JdbcDriverInfo {
+    /** Glob prefix to find the JAR in jar_files/ (e.g. 'hsqldb' matches hsqldb*.jar) */
+    jarPrefix: string;
+    /** JDBC URL template — {host}, {port}, {db} are replaced at runtime */
+    jdbcUrlTemplate: string;
+    /** Default SGBD port */
+    defaultPort: number;
+    /** Default JDBC user */
+    defaultUser: string;
+    /** Default JDBC password */
+    defaultPassword: string;
+    /** JDBC driver class name (for logging) */
+    driverClass: string;
+    /** Human-readable label */
+    label: string;
+}
+/**
+ * Registry of JDBC-bridge-eligible dialects.
+ * Only dialects that benefit from the JDBC bridge are listed here.
+ * Dialects with good npm drivers (pg, mysql2, mongoose...) are NOT listed.
+ */
+export declare const JDBC_REGISTRY: Partial<Record<DialectType, JdbcDriverInfo>>;
+/**
+ * Check if a dialect has a JDBC bridge entry.
+ */
+export declare function hasJdbcDriver(dialect: DialectType): boolean;
+/**
+ * Get JDBC driver info for a dialect. Returns undefined if not bridge-eligible.
+ */
+export declare function getJdbcDriverInfo(dialect: DialectType): JdbcDriverInfo | undefined;

package/dist/bridge/jdbc-registry.js

@@ -0,0 +1,67 @@
+// JDBC Driver Registry — maps dialect → JAR pattern → JDBC URL template
+// Used by JdbcNormalizer to auto-detect JARs and compose JDBC URLs
+// Author: Dr Hamid MADANI drmdh@msn.com
+/**
+ * Registry of JDBC-bridge-eligible dialects.
+ * Only dialects that benefit from the JDBC bridge are listed here.
+ * Dialects with good npm drivers (pg, mysql2, mongoose...) are NOT listed.
+ */
+export const JDBC_REGISTRY = {
+    hsqldb: {
+        jarPrefix: 'hsqldb',
+        jdbcUrlTemplate: 'jdbc:hsqldb:hsql://{host}:{port}/{db}',
+        defaultPort: 9001,
+        defaultUser: 'SA',
+        defaultPassword: '',
+        driverClass: 'org.hsqldb.jdbc.JDBCDriver',
+        label: 'HyperSQL (HSQLDB)',
+    },
+    oracle: {
+        jarPrefix: 'ojdbc',
+        jdbcUrlTemplate: 'jdbc:oracle:thin:@//{host}:{port}/{db}',
+        defaultPort: 1521,
+        defaultUser: 'system',
+        defaultPassword: 'oracle',
+        driverClass: 'oracle.jdbc.OracleDriver',
+        label: 'Oracle Database',
+    },
+    db2: {
+        jarPrefix: 'db2jcc',
+        jdbcUrlTemplate: 'jdbc:db2://{host}:{port}/{db}',
+        defaultPort: 50000,
+        defaultUser: 'db2inst1',
+        defaultPassword: 'db2inst1',
+        driverClass: 'com.ibm.db2.jcc.DB2Driver',
+        label: 'IBM DB2',
+    },
+    sybase: {
+        jarPrefix: 'jconn',
+        jdbcUrlTemplate: 'jdbc:sybase:Tds:{host}:{port}/{db}',
+        defaultPort: 5000,
+        defaultUser: 'sa',
+        defaultPassword: '',
+        driverClass: 'com.sybase.jdbc4.jdbc.SybDriver',
+        label: 'Sybase ASE',
+    },
+    hana: {
+        jarPrefix: 'ngdbc',
+        jdbcUrlTemplate: 'jdbc:sap://{host}:{port}',
+        defaultPort: 30015,
+        defaultUser: 'SYSTEM',
+        defaultPassword: 'manager',
+        driverClass: 'com.sap.db.jdbc.Driver',
+        label: 'SAP HANA',
+    },
+};
+/**
+ * Check if a dialect has a JDBC bridge entry.
+ */
+export function hasJdbcDriver(dialect) {
+    return dialect in JDBC_REGISTRY;
+}
+/**
+ * Get JDBC driver info for a dialect. Returns undefined if not bridge-eligible.
+ */
+export function getJdbcDriverInfo(dialect) {
+    return JDBC_REGISTRY[dialect];
+}

package/dist/dialects/abstract-sql.dialect.d.ts

@@ -13,10 +13,16 @@ export declare abstract class AbstractSqlDialect implements IDialect {
     abstract fieldToSqlType(field: FieldDef): string;
     /** Get the SQL column type for the primary key (id) column */
     abstract getIdColumnType(): string;
-    /** Execute a SELECT query, return rows */
-    abstract executeQuery<T>(sql: string, params: unknown[]): Promise<T[]>;
-    /** Execute a non-SELECT statement (INSERT/UPDATE/DELETE), return changes count */
-    abstract executeRun(sql: string, params: unknown[]): Promise<{
+    /** Execute a SELECT query via the dialect's native driver (npm) */
+    abstract doExecuteQuery<T>(sql: string, params: unknown[]): Promise<T[]>;
+    /** Execute a non-SELECT statement via the dialect's native driver (npm) */
+    abstract doExecuteRun(sql: string, params: unknown[]): Promise<{
+        changes: number;
+    }>;
+    /** Execute a SELECT query — routes to JDBC bridge or native driver */
+    executeQuery<T>(sql: string, params: unknown[]): Promise<T[]>;
+    /** Execute a non-SELECT statement — routes to JDBC bridge or native driver */
+    executeRun(sql: string, params: unknown[]): Promise<{
         changes: number;
     }>;
     /** Establish the actual database connection */
@@ -32,6 +38,8 @@ export declare abstract class AbstractSqlDialect implements IDialect {
     protected showSql: boolean;
     protected formatSql: boolean;
     private paramCounter;
+    private bridgeInstance;
+    private jdbcBridgeActive;
     /** Whether this dialect supports CREATE TABLE IF NOT EXISTS */
     protected supportsIfNotExists(): boolean;
     /** Whether this dialect supports RETURNING clause on INSERT */
@@ -85,6 +93,20 @@ export declare abstract class AbstractSqlDialect implements IDialect {
     connect(config: ConnectionConfig): Promise<void>;
     disconnect(): Promise<void>;
     testConnection(): Promise<boolean>;
+    /**
+     * Execute a SELECT query via the JDBC bridge.
+     * Called transparently when jdbcBridgeActive is true.
+     */
+    protected bridgeExecuteQuery<T>(sql: string, params: unknown[]): Promise<T[]>;
+    /**
+     * Execute a non-SELECT statement via the JDBC bridge.
+     * Called transparently when jdbcBridgeActive is true.
+     */
+    protected bridgeExecuteRun(sql: string, params: unknown[]): Promise<{
+        changes: number;
+    }>;
+    /** Whether the JDBC bridge is active for this dialect instance */
+    protected get isJdbcBridgeActive(): boolean;
     initSchema(schemas: EntitySchema[]): Promise<void>;
     find<T>(schema: EntitySchema, filter: DALFilter, options?: QueryOptions): Promise<T[]>;
     findOne<T>(schema: EntitySchema, filter: DALFilter, options?: QueryOptions): Promise<T | null>;

package/dist/dialects/abstract-sql.dialect.js

@@ -1,8 +1,12 @@
 // Abstract SQL Dialect — base class for all SQL dialects
 // Inspired by org.hibernate.dialect.Dialect (Hibernate ORM 6.4)
 // Extracts ~80% of shared SQL logic from sqlite.dialect.ts
+// Includes JDBC bridge support via JdbcNormalizer (transparent interception)
 // Author: Dr Hamid MADANI drmdh@msn.com
 import { randomUUID } from 'crypto';
+import { JdbcNormalizer } from '../bridge/JdbcNormalizer.js';
+import { hasJdbcDriver } from '../bridge/jdbc-registry.js';
+import { BridgeManager } from '../bridge/BridgeManager.js';
 // ============================================================
 // SQL Logging — inspired by hibernate.show_sql / hibernate.format_sql
 // ============================================================
@@ -57,12 +61,28 @@ function regexToLike(regex) {
 // AbstractSqlDialect — base for all SQL dialects
 // ============================================================
 export class AbstractSqlDialect {
+    // --- Concrete query methods with JDBC bridge interception ---
+    /** Execute a SELECT query — routes to JDBC bridge or native driver */
+    async executeQuery(sql, params) {
+        if (this.jdbcBridgeActive)
+            return this.bridgeExecuteQuery(sql, params);
+        return this.doExecuteQuery(sql, params);
+    }
+    /** Execute a non-SELECT statement — routes to JDBC bridge or native driver */
+    async executeRun(sql, params) {
+        if (this.jdbcBridgeActive)
+            return this.bridgeExecuteRun(sql, params);
+        return this.doExecuteRun(sql, params);
+    }
     // --- Protected state ---
     config = null;
     schemas = [];
     showSql = false;
     formatSql = false;
     paramCounter = 0;
+    // --- JDBC Bridge state (transparent interception) ---
+    bridgeInstance = null;
+    jdbcBridgeActive = false;
     // --- Hooks (overridable by subclasses) ---
     /** Whether this dialect supports CREATE TABLE IF NOT EXISTS */
     supportsIfNotExists() { return true; }
@@ -523,8 +543,25 @@ export class AbstractSqlDialect {
         this.config = config;
         this.showSql = config.showSql ?? false;
         this.formatSql = config.formatSql ?? false;
-        await this.doConnect(config);
-        this.log('CONNECT', config.uri);
+        // --- JDBC Bridge interception via BridgeManager ---
+        // If a JDBC JAR is available for this dialect, use the bridge
+        // instead of calling the dialect's doConnect() (npm driver).
+        // BridgeManager handles multi-bridge, port management, PID files, autostart.
+        const jarDir = config.options?.jarDir;
+        if (hasJdbcDriver(this.dialectType) && JdbcNormalizer.isAvailable(this.dialectType, jarDir)) {
+            const manager = BridgeManager.getInstance();
+            this.bridgeInstance = await manager.getOrCreate(this.dialectType, config.uri, {
+                jarDir,
+                bridgeJavaFile: config.options?.bridgeJavaFile,
+            });
+            this.jdbcBridgeActive = true;
+            this.log('CONNECT', `${config.uri} [via JDBC bridge on port ${this.bridgeInstance.port}]`);
+        }
+        else {
+            // No JAR found — use the dialect's native npm driver
+            await this.doConnect(config);
+            this.log('CONNECT', config.uri);
+        }
         if (config.schemaStrategy === 'create') {
             this.log('SCHEMA', 'create — dropping existing tables');
             await this.dropAllTables();
@@ -535,19 +572,56 @@ export class AbstractSqlDialect {
             this.log('SCHEMA', 'create-drop — dropping all tables on shutdown');
             await this.dropAllTables();
         }
-        await this.doDisconnect();
+        if (this.jdbcBridgeActive && this.bridgeInstance) {
+            // Do NOT stop the bridge — BridgeManager manages its lifecycle.
+            // Other dialect instances may reuse the same bridge.
+            // Bridges are stopped by BridgeManager.stopAll() on app exit.
+            this.bridgeInstance = null;
+            this.jdbcBridgeActive = false;
+        }
+        else {
+            await this.doDisconnect();
+        }
         this.config = null;
         this.schemas = [];
         this.log('DISCONNECT', '');
     }
     async testConnection() {
         try {
+            if (this.jdbcBridgeActive && this.bridgeInstance) {
+                const result = await this.bridgeInstance.normalizer.query('SELECT 1', []);
+                return Array.isArray(result);
+            }
             return await this.doTestConnection();
         }
         catch {
             return false;
         }
     }
+    // --- JDBC Bridge query methods (used by executeQuery/executeRun interception) ---
+    /**
+     * Execute a SELECT query via the JDBC bridge.
+     * Called transparently when jdbcBridgeActive is true.
+     */
+    async bridgeExecuteQuery(sql, params) {
+        if (!this.bridgeInstance)
+            throw new Error('JDBC bridge not initialized');
+        return this.bridgeInstance.normalizer.query(sql, params);
+    }
+    /**
+     * Execute a non-SELECT statement via the JDBC bridge.
+     * Called transparently when jdbcBridgeActive is true.
+     */
+    async bridgeExecuteRun(sql, params) {
+        if (!this.bridgeInstance)
+            throw new Error('JDBC bridge not initialized');
+        const result = await this.bridgeInstance.normalizer.query(sql, params);
+        return { changes: result?.changes ?? 0 };
+    }
+    /** Whether the JDBC bridge is active for this dialect instance */
+    get isJdbcBridgeActive() {
+        return this.jdbcBridgeActive;
+    }
     // --- Schema management (hibernate.hbm2ddl.auto) ---
     async initSchema(schemas) {
         this.schemas = schemas;

package/dist/dialects/db2.dialect.js

@@ -97,7 +97,7 @@ class DB2Dialect extends AbstractSqlDialect {
         return Array.isArray(rows);
     }
     // --- Query execution ---
-    async executeQuery(sql, params) {
+    async doExecuteQuery(sql, params) {
         if (!this.conn)
             throw new Error('DB2 not connected. Call connect() first.');
         return new Promise((resolve, reject) => {
@@ -109,7 +109,7 @@ class DB2Dialect extends AbstractSqlDialect {
             });
         });
     }
-    async executeRun(sql, params) {
+    async doExecuteRun(sql, params) {
         if (!this.conn)
             throw new Error('DB2 not connected. Call connect() first.');
         return new Promise((resolve, reject) => {

package/dist/dialects/hana.dialect.js

@@ -92,7 +92,7 @@ class HANADialect extends AbstractSqlDialect {
         return Array.isArray(rows);
     }
     // --- Query execution ---
-    async executeQuery(sql, params) {
+    async doExecuteQuery(sql, params) {
         if (!this.conn)
             throw new Error('HANA not connected. Call connect() first.');
         return new Promise((resolve, reject) => {
@@ -104,7 +104,7 @@ class HANADialect extends AbstractSqlDialect {
             });
         });
     }
-    async executeRun(sql, params) {
+    async doExecuteRun(sql, params) {
         if (!this.conn)
             throw new Error('HANA not connected. Call connect() first.');
         return new Promise((resolve, reject) => {

package/dist/dialects/hsqldb.dialect.js

@@ -1,7 +1,7 @@
 // HyperSQL (HSQLDB) Dialect — extends AbstractSqlDialect
 // Equivalent to org.hibernate.dialect.HSQLDialect (Hibernate ORM 6.4)
-// HSQLDB is a Java database — accessed via HTTP/JDBC bridge or REST API
-// Driver: HTTP fetch (no npm driver — uses Java HTTP API bridge)
+// Driver: JDBC bridge (no npm driver — Java database)
+// Connection handled transparently by AbstractSqlDialect JDBC bridge interception
 // Author: Dr Hamid MADANI drmdh@msn.com
 import { AbstractSqlDialect } from './abstract-sql.dialect.js';
 // ============================================================
@@ -16,13 +16,12 @@ const HSQL_TYPE_MAP = {
     array: 'CLOB',
 };
 // ============================================================
-// HSQLDialect
+// HSQLDialect — SQL definition only (like Hibernate HSQLDialect)
+// Connection is handled by AbstractSqlDialect via JDBC bridge
 // ============================================================
 class HSQLDialect extends AbstractSqlDialect {
     dialectType = 'hsqldb';
-    baseUrl = '';
-    connected = false;
-    // --- Abstract implementations ---
+    // --- Abstract implementations (SQL definition) ---
     quoteIdentifier(name) {
         return `"${name}"`;
     }
@@ -47,62 +46,29 @@ class HSQLDialect extends AbstractSqlDialect {
     }
     // HSQLDB supports LIMIT/OFFSET natively
     // (default buildLimitOffset from AbstractSqlDialect works)
-    // --- Connection (HTTP bridge to HSQLDB server) ---
-    async doConnect(config) {
-        // URI format: http://host:port/dbname or hsqldb://host:port/dbname
-        this.baseUrl = config.uri
-            .replace(/^hsqldb:\/\//, 'http://')
-            .replace(/\/$/, '');
-        // Test connectivity
-        try {
-            await this.httpPost('SELECT 1 FROM INFORMATION_SCHEMA.SYSTEM_USERS', []);
-            this.connected = true;
-        }
-        catch (e) {
-            throw new Error(`HSQLDB HTTP bridge not reachable at ${this.baseUrl}.\n` +
-                `Ensure the HSQLDB server is running with HTTP API enabled.\n` +
-                `Original error: ${e instanceof Error ? e.message : String(e)}`);
-        }
+    // --- Connection (native driver fallback) ---
+    // HSQLDB is a Java database — no npm driver exists.
+    // Normal path: AbstractSqlDialect detects hsqldb*.jar and uses JDBC bridge.
+    // These methods are only called if no JAR is found (fallback impossible).
+    async doConnect(_config) {
+        throw new Error('HSQLDB requires a JDBC bridge.\n' +
+            'Place hsqldb*.jar in the jar_files/ directory.\n' +
+            'No npm driver exists for HSQLDB.');
     }
     async doDisconnect() {
-        this.connected = false;
-        this.baseUrl = '';
+        // Nothing to clean up — bridge is managed by AbstractSqlDialect
     }
     async doTestConnection() {
-        if (!this.connected)
-            return false;
-        try {
-            await this.httpPost('SELECT 1 FROM INFORMATION_SCHEMA.SYSTEM_USERS', []);
-            return true;
-        }
-        catch {
-            return false;
-        }
+        // Bridge test is handled by AbstractSqlDialect.testConnection()
+        return false;
     }
-    // --- Query execution via HTTP bridge ---
-    async executeQuery(sql, params) {
-        if (!this.connected)
-            throw new Error('HSQLDB not connected. Call connect() first.');
-        return this.httpPost(sql, params);
+    // --- Query execution (native driver fallback) ---
+    // Only called when JDBC bridge is NOT active (impossible for HSQLDB).
+    async doExecuteQuery(_sql, _params) {
+        throw new Error('HSQLDB requires a JDBC bridge. Place hsqldb*.jar in jar_files/.');
     }
-    async executeRun(sql, params) {
-        if (!this.connected)
-            throw new Error('HSQLDB not connected. Call connect() first.');
-        const result = await this.httpPost(sql, params);
-        return { changes: result?.changes ?? 0 };
-    }
-    /** Send SQL to HSQLDB HTTP bridge */
-    async httpPost(sql, params) {
-        const response = await fetch(`${this.baseUrl}/query`, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({ sql, params }),
-        });
-        if (!response.ok) {
-            const text = await response.text();
-            throw new Error(`HSQLDB query failed (${response.status}): ${text}`);
-        }
-        return response.json();
+    async doExecuteRun(_sql, _params) {
+        throw new Error('HSQLDB requires a JDBC bridge. Place hsqldb*.jar in jar_files/.');
     }
     getDialectLabel() { return 'HSQLDB'; }
 }

package/dist/dialects/mariadb.dialect.js

@@ -34,7 +34,7 @@ class MariaDBDialect extends MySQLDialect {
         }
     }
     // Override executeQuery to handle mariadb driver's different API
-    async executeQuery(sql, params) {
+    async doExecuteQuery(sql, params) {
         if (!this.pool)
             throw new Error('MariaDB not connected. Call connect() first.');
         try {
@@ -50,7 +50,7 @@ class MariaDBDialect extends MySQLDialect {
             return super.executeQuery(sql, params);
         }
     }
-    async executeRun(sql, params) {
+    async doExecuteRun(sql, params) {
         if (!this.pool)
             throw new Error('MariaDB not connected. Call connect() first.');
         try {

package/dist/dialects/mssql.dialect.d.ts

@@ -18,8 +18,8 @@ export declare class MSSQLDialect extends AbstractSqlDialect {
     doConnect(config: ConnectionConfig): Promise<void>;
     doDisconnect(): Promise<void>;
     doTestConnection(): Promise<boolean>;
-    executeQuery<T>(sql: string, params: unknown[]): Promise<T[]>;
-    executeRun(sql: string, params: unknown[]): Promise<{
+    doExecuteQuery<T>(sql: string, params: unknown[]): Promise<T[]>;
+    doExecuteRun(sql: string, params: unknown[]): Promise<{
         changes: number;
     }>;
     protected getDialectLabel(): string;

package/dist/dialects/mssql.dialect.js

@@ -96,7 +96,7 @@ export class MSSQLDialect extends AbstractSqlDialect {
         return true;
     }
     // --- Query execution ---
-    async executeQuery(sql, params) {
+    async doExecuteQuery(sql, params) {
         if (!this.pool)
             throw new Error('SQL Server not connected. Call connect() first.');
         const request = this.pool.request();
@@ -107,7 +107,7 @@ export class MSSQLDialect extends AbstractSqlDialect {
         const result = await request.query(sql);
         return result.recordset;
     }
-    async executeRun(sql, params) {
+    async doExecuteRun(sql, params) {
         if (!this.pool)
             throw new Error('SQL Server not connected. Call connect() first.');
         const request = this.pool.request();

package/dist/dialects/mysql.dialect.d.ts

@@ -15,8 +15,8 @@ export declare class MySQLDialect extends AbstractSqlDialect {
     doConnect(config: ConnectionConfig): Promise<void>;
     doDisconnect(): Promise<void>;
     doTestConnection(): Promise<boolean>;
-    executeQuery<T>(sql: string, params: unknown[]): Promise<T[]>;
-    executeRun(sql: string, params: unknown[]): Promise<{
+    doExecuteQuery<T>(sql: string, params: unknown[]): Promise<T[]>;
+    doExecuteRun(sql: string, params: unknown[]): Promise<{
         changes: number;
     }>;
     protected getDialectLabel(): string;

package/dist/dialects/mysql.dialect.js

@@ -79,13 +79,13 @@ export class MySQLDialect extends AbstractSqlDialect {
         }
     }
     // --- Query execution ---
-    async executeQuery(sql, params) {
+    async doExecuteQuery(sql, params) {
         if (!this.pool)
             throw new Error('MySQL not connected. Call connect() first.');
         const [rows] = await this.pool.execute(sql, params);
         return rows;
     }
-    async executeRun(sql, params) {
+    async doExecuteRun(sql, params) {
         if (!this.pool)
             throw new Error('MySQL not connected. Call connect() first.');
         const [result] = await this.pool.execute(sql, params);

package/dist/dialects/oracle.dialect.js

@@ -111,7 +111,7 @@ class OracleDialect extends AbstractSqlDialect {
         }
     }
     // --- Query execution ---
-    async executeQuery(sql, params) {
+    async doExecuteQuery(sql, params) {
         if (!this.pool)
             throw new Error('Oracle not connected. Call connect() first.');
         const conn = await this.pool.getConnection();
@@ -123,7 +123,7 @@ class OracleDialect extends AbstractSqlDialect {
             await conn.close();
         }
     }
-    async executeRun(sql, params) {
+    async doExecuteRun(sql, params) {
         if (!this.pool)
             throw new Error('Oracle not connected. Call connect() first.');
         const conn = await this.pool.getConnection();

package/dist/dialects/postgres.dialect.d.ts

@@ -17,8 +17,8 @@ export declare class PostgresDialect extends AbstractSqlDialect {
     doConnect(config: ConnectionConfig): Promise<void>;
     doDisconnect(): Promise<void>;
     doTestConnection(): Promise<boolean>;
-    executeQuery<T>(sql: string, params: unknown[]): Promise<T[]>;
-    executeRun(sql: string, params: unknown[]): Promise<{
+    doExecuteQuery<T>(sql: string, params: unknown[]): Promise<T[]>;
+    doExecuteRun(sql: string, params: unknown[]): Promise<{
         changes: number;
     }>;
     protected getDialectLabel(): string;

package/dist/dialects/postgres.dialect.js

@@ -83,13 +83,13 @@ export class PostgresDialect extends AbstractSqlDialect {
         }
     }
     // --- Query execution ---
-    async executeQuery(sql, params) {
+    async doExecuteQuery(sql, params) {
         if (!this.pool)
             throw new Error('PostgreSQL not connected. Call connect() first.');
         const result = await this.pool.query(sql, params);
         return result.rows;
     }
-    async executeRun(sql, params) {
+    async doExecuteRun(sql, params) {
         if (!this.pool)
             throw new Error('PostgreSQL not connected. Call connect() first.');
         const result = await this.pool.query(sql, params);

package/dist/dialects/spanner.dialect.js

@@ -135,7 +135,7 @@ class SpannerDialect extends AbstractSqlDialect {
         }
     }
     // --- Query execution ---
-    async executeQuery(sql, params) {
+    async doExecuteQuery(sql, params) {
         if (!this.database)
             throw new Error('Spanner not connected. Call connect() first.');
         // Build named params object: { p1: val1, p2: val2, ... }
@@ -152,7 +152,7 @@ class SpannerDialect extends AbstractSqlDialect {
             return row;
         });
     }
-    async executeRun(sql, params) {
+    async doExecuteRun(sql, params) {
         if (!this.database)
             throw new Error('Spanner not connected. Call connect() first.');
         // For DML operations, Spanner requires using transactions

package/dist/dialects/sybase.dialect.js

@@ -67,7 +67,7 @@ class SybaseDialect extends MSSQLDialect {
         await this.pool.query('SELECT 1');
         return true;
     }
-    async executeQuery(sql, params) {
+    async doExecuteQuery(sql, params) {
         if (!this.pool)
             throw new Error('Sybase not connected. Call connect() first.');
         // Sybase driver doesn't support named params — replace @pN with values
@@ -75,7 +75,7 @@ class SybaseDialect extends MSSQLDialect {
         const result = await this.pool.query(resolvedSql);
         return Array.isArray(result) ? result : [];
     }
-    async executeRun(sql, params) {
+    async doExecuteRun(sql, params) {
         if (!this.pool)
             throw new Error('Sybase not connected. Call connect() first.');
         const resolvedSql = this.resolveParams(sql, params);

package/dist/index.d.ts

@@ -5,4 +5,10 @@ export { registerSchema, registerSchemas, getSchema, getSchemaByCollection, getA
 export { getDialect, getConfigFromEnv, getCurrentDialectType, disconnectDialect, testConnection, createConnection, } from './core/factory.js';
 export { BaseRepository } from './core/base-repository.js';
 export { normalizeDoc, normalizeDocs } from './core/normalizer.js';
+export { JdbcNormalizer, parseUri } from './bridge/JdbcNormalizer.js';
+export { JDBC_REGISTRY, hasJdbcDriver, getJdbcDriverInfo } from './bridge/jdbc-registry.js';
+export { BridgeManager } from './bridge/BridgeManager.js';
+export type { BridgeInstance } from './bridge/BridgeManager.js';
+export type { JdbcDriverInfo } from './bridge/jdbc-registry.js';
+export type { JdbcBridgeConfig } from './bridge/JdbcNormalizer.js';
 export { MostaORMError, EntityNotFoundError, ConnectionError, ValidationError, DialectNotFoundError, } from './core/errors.js';

package/dist/index.js

@@ -21,6 +21,12 @@ export { BaseRepository } from './core/base-repository.js';
 // ============================================================
 export { normalizeDoc, normalizeDocs } from './core/normalizer.js';
 // ============================================================
+// JDBC Bridge
+// ============================================================
+export { JdbcNormalizer, parseUri } from './bridge/JdbcNormalizer.js';
+export { JDBC_REGISTRY, hasJdbcDriver, getJdbcDriverInfo } from './bridge/jdbc-registry.js';
+export { BridgeManager } from './bridge/BridgeManager.js';
+// ============================================================
 // Errors
 // ============================================================
 export { MostaORMError, EntityNotFoundError, ConnectionError, ValidationError, DialectNotFoundError, } from './core/errors.js';