@neogroup/neorm 0.0.1 → 0.0.3

package/README.md

@@ -702,22 +702,22 @@ try {
 
 ## Entities (Active Record)
 
-Entities are Eloquent-style Active Record models that map a plain class to a database table using TypeScript decorators. They sit on top of `DataTable` and add hydration, casts, relationships, and standalone persistence functions — no base class required.
+Entities are Eloquent-style Active Record models that map a class to a database table. Every entity extends the abstract **`BaseEntity`** class and is annotated with TypeScript decorators. `BaseEntity` provides all the static query methods (`find`, `where`, `with`, …) — fully typed — plus the `save()` and `delete()` instance methods.
 
 > Enable `"experimentalDecorators": true` and `"useDefineForClassFields": false` in your `tsconfig.json`.
 
 ### Defining an Entity
 
-Annotate any class with `@Entity` and mark its columns with `@Column`. All static query methods are injected at runtime; use `saveEntity()` and `deleteEntity()` for persistence.
+Extend `BaseEntity`, annotate the class with `@Entity` and mark its columns with `@Column`. The decorators register the table metadata; `BaseEntity` supplies querying and persistence.
 
 ```typescript
 import {
-  Entity, Column, Entities,
+  BaseEntity, Entity, Column,
   HasOne, HasMany, BelongsTo, HasOneThrough, HasManyThrough
 } from '@neogroup/neorm'
 
 @Entity()                          // table name defaults to lowercase class name + 's' → 'users'
-class User {
+class User extends BaseEntity {
   @Column({ primaryKey: true, autoGenerated: true })
   id!: number
 
@@ -746,7 +746,7 @@ class User {
 }
 
 @Entity()
-class Order {
+class Order extends BaseEntity {
   @Column({ primaryKey: true, autoGenerated: true })
   id!: number
 
@@ -765,6 +765,7 @@ class Order {
 
 | Option          | Type       | Description |
 |-----------------|------------|-------------|
+| `columnName`    | `string`   | Database column name. Defaults to the property name. |
 | `cast`          | `CastType` | Coerce the value when reading from the DB (see [Casts](#casts)). |
 | `primaryKey`    | `boolean`  | Marks this column as the primary key. |
 | `autoGenerated` | `boolean`  | Column is DB-managed (e.g. `AUTOINCREMENT`). Excluded from INSERT/UPDATE; the generated value is written back to the instance after INSERT. |
@@ -773,18 +774,20 @@ When a custom table name or primary key column name is needed, pass options to `
 
 ```typescript
 @Entity({ table: 'shipping_addresses' })
-class ShippingAddress {
+class ShippingAddress extends BaseEntity {
   @Column({ primaryKey: true, autoGenerated: true })
   id!: number
   // ...
 }
 ```
 
-To target a specific data source instead of the active one:
+To target a specific registered data source (by name) instead of the active one:
 
 ```typescript
-@Entity({ source: DB.source('archive') })
-class ArchiveUser {
+DB.register('archive', archiveSource)
+
+@Entity({ source: 'archive' })   // the entity operates on DB.source('archive')
+class ArchiveUser extends BaseEntity {
   // ...
 }
 ```
@@ -793,22 +796,20 @@ class ArchiveUser {
 
 ### Querying
 
-All `DataTable` query methods are available as static methods on every Entity, returning a chainable `EntityQuery<T>`:
+All `DataTable` query methods are available as static methods inherited from `BaseEntity`, returning a chainable `EntityQuery<T>`. They are fully typed — `User.get()` returns `Promise<User[]>` with no casts needed:
 
 ```typescript
-const UserModel = User as any  // cast needed — TypeScript doesn't see injected statics
-
 // Fetch all
-const users = await UserModel.get()
+const users = await User.get()          // User[]
 
 // Find by primary key
-const user = await UserModel.find(1)   // User | null
+const user = await User.find(1)         // User | null
 
 // First match
-const admin = await UserModel.where('role', 'admin').first()
+const admin = await User.where('role', 'admin').first()
 
 // Chained conditions
-const adults = await UserModel.where('active', 1)
+const adults = await User.where('active', 1)
   .whereNotNull('email')
   .orderBy('name')
   .limit(20)
@@ -821,26 +822,26 @@ The full `where*` / `orWhere*` API, `select()`, `orderBy()`, `limit()`, `offset(
 
 ### Saving & deleting
 
+Every entity inherits the `save()` and `delete()` instance methods from `BaseEntity`:
+
 ```typescript
 // INSERT — autoGenerated PK is written back after insert
-const user = new User() as any
-user.name  = 'Alice'
-user.email = 'alice@example.com'
-user.age   = 30
-user.active = 1
-await Entities.save(user)
+const user = new User()
+user.name   = 'Alice'
+user.email  = 'alice@example.com'
+user.age    = 30
+user.active = true
+await user.save()
 console.log(user.id)  // populated from lastInsertId
 
 // UPDATE — detected by the presence of a primary key value
 user.age = 31
-await Entities.save(user)
+await user.save()
 
-// DELETE
-await Entities.delete(user)
+// DELETE — throws if the primary key is not set
+await user.delete()
 ```
 
-`Entities.save` and `Entities.delete` read the entity metadata from its constructor at runtime — no coupling between the call site and the `@Entity` definition.
-
 ---
 
 ### Casts
@@ -871,7 +872,7 @@ Use relationship decorators to declare associations between entities:
 // HasManyThrough(related, through, foreignKey, throughForeignKey, localKey, throughLocalKey)
 
 @Entity({ table: 'countries' })
-class Country {
+class Country extends BaseEntity {
   @Column({ primaryKey: true, autoGenerated: true })
   id!: number
 
@@ -894,22 +895,22 @@ Pass relation names to `with()` to load related entities in a single extra query
 
 ```typescript
 // Preload orders for each user
-const users = await UserModel.with('orders').get()
+const users = await User.with('orders').get()
 users.forEach(u => console.log(u.orders))  // Order[] attached
 
 // Multiple relations
-const users = await UserModel.with('orders', 'profile').get()
+const users = await User.with('orders', 'profile').get()
 
 // Dot-notation for nested eager loading
 // Loads orders → users → countries in 3 total queries
-const orders = await OrderModel.with('user.country').get()
+const orders = await Order.with('user.country').get()
 orders.forEach(o => console.log(o.user.country))
 ```
 
 `with()` is chainable after any `where*` or ordering method:
 
 ```typescript
-const users = await UserModel.where('active', 1).with('orders').orderBy('name').get()
+const users = await User.where('active', 1).with('orders').orderBy('name').get()
 ```
 
 ---
@@ -920,19 +921,19 @@ Use `joinRelationship` / `innerJoinRelationship` / `leftJoinRelationship` to add
 
 ```typescript
 // INNER JOIN orders ON users.id = orders.userId
-const users = await UserModel.innerJoinRelationship('orders')
+const users = await User.innerJoinRelationship('orders')
   .select('users.*', 'COUNT(orders.id) AS orderCount')
   .groupBy('users.id')
   .get()
 
 // LEFT JOIN
-const users = await UserModel.leftJoinRelationship('profile').get()
+const users = await User.leftJoinRelationship('profile').get()
 ```
 
 These are available as static methods on every Entity and also on `EntityQuery`:
 
 ```typescript
-const query = UserModel.where('active', 1).leftJoinRelationship('profile')
+const query = User.where('active', 1).leftJoinRelationship('profile')
 ```
 
 ---

package/dist/database/Connection.d.ts

@@ -0,0 +1,10 @@
+import { DataSet } from './DataSet';
+export interface Connection {
+    query(sql: string, bindings?: Array<any>): Promise<Array<DataSet>>;
+    execute(sql: string, bindings?: Array<any>): Promise<number>;
+    lastInsertId(): Promise<number>;
+    beginTransaction(): Promise<void>;
+    rollbackTransaction(): Promise<void>;
+    commitTransaction(): Promise<void>;
+    close(): Promise<void>;
+}

package/dist/database/Connection.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Connection.js.map

package/dist/database/Connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Connection.js","sourceRoot":"","sources":["../../src/database/Connection.ts"],"names":[],"mappings":""}

package/dist/database/DB.d.ts

@@ -0,0 +1,63 @@
+import { DataConnection } from './DataConnection';
+import { DataSet } from './DataSet';
+import { DataSource } from './DataSource';
+import { DataTable } from './DataTable';
+import { ConditionGroup, DeleteQuery, InsertQuery, Query, QueryTable, SelectQuery, UpdateQuery } from './query';
+export declare abstract class DB {
+    private static get _sources();
+    private static get _activeSourceName();
+    private static set _activeSourceName(value);
+    static register(source: DataSource): void;
+    static register(sourceName: string, source: DataSource): void;
+    static setActiveSource(sourceName: string): void;
+    static source(sourceName: string): DataSource;
+    /**
+     * Reads environment variables and registers the corresponding data sources.
+     * Called automatically the first time a source is needed if none have been
+     * registered manually.
+     *
+     * Supported variables:
+     *
+     *   Default source:
+     *     DB_DRIVER     sqlite | postgres | mysql   (required)
+     *     DB_FILE       path to SQLite file          (sqlite only, default: :memory:)
+     *     DB_HOST       database host                (postgres / mysql)
+     *     DB_PORT       database port                (postgres / mysql)
+     *     DB_NAME       database name                (postgres / mysql)
+     *     DB_USERNAME   login username               (postgres / mysql)
+     *     DB_PASSWORD   login password               (postgres / mysql)
+     *     DB_DEBUG      enable debug mode            (true/false, 1/0, yes/no, on/off)
+     *     DB_READONLY   readonly mode                (true/false, 1/0, yes/no, on/off)
+     *
+     *   Named source  (replace <NAME> with the desired source name in upper-case):
+     *     DB_<NAME>_DRIVER, DB_<NAME>_HOST, DB_<NAME>_PORT, DB_<NAME>_NAME,
+     *     DB_<NAME>_USERNAME, DB_<NAME>_PASSWORD, DB_<NAME>_FILE,
+     *     DB_<NAME>_DEBUG, DB_<NAME>_READONLY
+     *
+     * Example:
+     *   DB_DRIVER=postgres DB_HOST=localhost DB_NAME=app DB_USERNAME=user DB_PASSWORD=pass
+     *   DB_REPORTING_DRIVER=sqlite DB_REPORTING_FILE=./reporting.db
+     */
+    private static configure;
+    private static _buildSourceFromEnv;
+    private static _parseEnvBoolean;
+    private static _buildDriverSource;
+    private static _ensureConfigured;
+    static table(tableName: string): DataTable;
+    static conditionGroup(): ConditionGroup;
+    static selectQuery(table?: QueryTable): SelectQuery;
+    static updateQuery(table?: QueryTable): UpdateQuery;
+    static deleteQuery(table?: QueryTable): DeleteQuery;
+    static insertQuery(table?: QueryTable): InsertQuery;
+    static connection(): Promise<DataConnection>;
+    static query(sql: string, bindings?: Array<any>): Promise<Array<DataSet>>;
+    static query(query: Query): Promise<Array<DataSet>>;
+    static execute(sql: string, bindings?: Array<any>): Promise<number>;
+    static execute(query: Query): Promise<number>;
+    static beginTransaction(): Promise<void>;
+    static commitTransaction(): Promise<void>;
+    static rollbackTransaction(): Promise<void>;
+    static executeTransaction(callback: (connection: DataConnection) => Promise<void>): Promise<void>;
+    static getActiveSource(): DataSource;
+    private static get _activeSource();
+}

package/dist/database/DB.js

@@ -0,0 +1,247 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DB = void 0;
+const query_1 = require("./query");
+function getGlobalState() {
+    const g = globalThis;
+    if (!g.__neorm) {
+        g.__neorm = { sources: new Map() };
+    }
+    return g.__neorm;
+}
+// ── DB ────────────────────────────────────────────────────────────────────────
+class DB {
+    static get _sources() {
+        return getGlobalState().sources;
+    }
+    static get _activeSourceName() {
+        return getGlobalState().activeSourceName;
+    }
+    static set _activeSourceName(value) {
+        getGlobalState().activeSourceName = value;
+    }
+    static register(sourceOrName, source) {
+        const sourceName = source ? sourceOrName : 'source' + (this._sources.size + 1);
+        const sourceToRegister = source !== null && source !== void 0 ? source : sourceOrName;
+        this._sources.set(sourceName, sourceToRegister);
+        if (!this._activeSourceName) {
+            this._activeSourceName = sourceName;
+        }
+    }
+    static setActiveSource(sourceName) {
+        if (!this._sources.has(sourceName)) {
+            throw new Error(`No DataSource registered with the name "${sourceName}"`);
+        }
+        this._activeSourceName = sourceName;
+    }
+    static source(sourceName) {
+        this._ensureConfigured();
+        const source = this._sources.get(sourceName);
+        if (!source) {
+            throw new Error(`No DataSource registered with the name "${sourceName}"`);
+        }
+        return source;
+    }
+    // ── Environment-variable configuration ──────────────────────────────────────
+    /**
+     * Reads environment variables and registers the corresponding data sources.
+     * Called automatically the first time a source is needed if none have been
+     * registered manually.
+     *
+     * Supported variables:
+     *
+     *   Default source:
+     *     DB_DRIVER     sqlite | postgres | mysql   (required)
+     *     DB_FILE       path to SQLite file          (sqlite only, default: :memory:)
+     *     DB_HOST       database host                (postgres / mysql)
+     *     DB_PORT       database port                (postgres / mysql)
+     *     DB_NAME       database name                (postgres / mysql)
+     *     DB_USERNAME   login username               (postgres / mysql)
+     *     DB_PASSWORD   login password               (postgres / mysql)
+     *     DB_DEBUG      enable debug mode            (true/false, 1/0, yes/no, on/off)
+     *     DB_READONLY   readonly mode                (true/false, 1/0, yes/no, on/off)
+     *
+     *   Named source  (replace <NAME> with the desired source name in upper-case):
+     *     DB_<NAME>_DRIVER, DB_<NAME>_HOST, DB_<NAME>_PORT, DB_<NAME>_NAME,
+     *     DB_<NAME>_USERNAME, DB_<NAME>_PASSWORD, DB_<NAME>_FILE,
+     *     DB_<NAME>_DEBUG, DB_<NAME>_READONLY
+     *
+     * Example:
+     *   DB_DRIVER=postgres DB_HOST=localhost DB_NAME=app DB_USERNAME=user DB_PASSWORD=pass
+     *   DB_REPORTING_DRIVER=sqlite DB_REPORTING_FILE=./reporting.db
+     */
+    static configure() {
+        if (this._sources.size > 0) {
+            return; // already configured — manual register() takes precedence
+        }
+        const env = process.env;
+        // 1. Default (unnamed) source — registered first so it becomes active
+        const defaultDriver = env['DB_DRIVER'];
+        if (defaultDriver) {
+            const get = (key) => env[`DB_${key}`];
+            this.register(this._buildSourceFromEnv(defaultDriver, get));
+        }
+        // 2. Named sources — DB_<NAME>_DRIVER pattern
+        for (const key of Object.keys(env).sort()) {
+            const match = key.match(/^DB_([A-Z][A-Z0-9_]*)_DRIVER$/);
+            if (!match) {
+                continue;
+            }
+            const name = match[1].toLowerCase();
+            const prefix = `DB_${match[1]}_`;
+            const get = (k) => env[prefix + k];
+            this.register(name, this._buildSourceFromEnv(env[key], get));
+        }
+        if (this._sources.size === 0) {
+            throw new Error('No data source configured. ' +
+                'Call DB.register() or set the DB_DRIVER environment variable ' +
+                '(e.g. DB_DRIVER=sqlite, DB_DRIVER=postgres, DB_DRIVER=mysql).');
+        }
+    }
+    static _buildSourceFromEnv(driver, get) {
+        const source = this._buildDriverSource(driver, get);
+        const debug = get('DEBUG');
+        const readonly = get('READONLY');
+        if (debug !== undefined) {
+            source.setDebugEnabled(this._parseEnvBoolean(debug));
+        }
+        if (readonly !== undefined) {
+            source.setReadonly(this._parseEnvBoolean(readonly));
+        }
+        return source;
+    }
+    static _parseEnvBoolean(value) {
+        return ['true', '1', 'yes', 'on'].includes(value.trim().toLowerCase());
+    }
+    static _buildDriverSource(driver, get) {
+        var _a, _b, _c, _d, _e, _f;
+        switch (driver.toLowerCase()) {
+            case 'sqlite': {
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const { SqliteDataSource } = require('./sources/sqlite');
+                const s = new SqliteDataSource();
+                const file = get('FILE');
+                if (file) {
+                    s.setFilename(file);
+                }
+                return s;
+            }
+            case 'postgres':
+            case 'postgresql': {
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const { PostgresDataSource } = require('./sources/postgres');
+                const s = new PostgresDataSource();
+                const host = get('HOST');
+                const port = get('PORT');
+                const name = (_a = get('NAME')) !== null && _a !== void 0 ? _a : get('DATABASE');
+                const username = (_b = get('USERNAME')) !== null && _b !== void 0 ? _b : get('USER');
+                const password = (_c = get('PASSWORD')) !== null && _c !== void 0 ? _c : get('PASS');
+                if (host) {
+                    s.setHost(host);
+                }
+                if (port) {
+                    s.setPort(Number(port));
+                }
+                if (name) {
+                    s.setDatabaseName(name);
+                }
+                if (username) {
+                    s.setUsername(username);
+                }
+                if (password) {
+                    s.setPassword(password);
+                }
+                return s;
+            }
+            case 'mysql': {
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const { MysqlDataSource } = require('./sources/mysql');
+                const s = new MysqlDataSource();
+                const host = get('HOST');
+                const port = get('PORT');
+                const name = (_d = get('NAME')) !== null && _d !== void 0 ? _d : get('DATABASE');
+                const username = (_e = get('USERNAME')) !== null && _e !== void 0 ? _e : get('USER');
+                const password = (_f = get('PASSWORD')) !== null && _f !== void 0 ? _f : get('PASS');
+                if (host) {
+                    s.setHost(host);
+                }
+                if (port) {
+                    s.setPort(Number(port));
+                }
+                if (name) {
+                    s.setDatabaseName(name);
+                }
+                if (username) {
+                    s.setUsername(username);
+                }
+                if (password) {
+                    s.setPassword(password);
+                }
+                return s;
+            }
+            default:
+                throw new Error(`Unknown DB driver "${driver}". Supported drivers: sqlite, postgres, mysql.`);
+        }
+    }
+    static _ensureConfigured() {
+        if (this._sources.size === 0) {
+            this.configure();
+        }
+    }
+    // ── Query builder helpers ────────────────────────────────────────────────────
+    static table(tableName) {
+        return this._activeSource.table(tableName);
+    }
+    static conditionGroup() {
+        return new query_1.ConditionGroup();
+    }
+    static selectQuery(table) {
+        return new query_1.SelectQuery(table);
+    }
+    static updateQuery(table) {
+        return new query_1.UpdateQuery(table);
+    }
+    static deleteQuery(table) {
+        return new query_1.DeleteQuery(table);
+    }
+    static insertQuery(table) {
+        return new query_1.InsertQuery(table);
+    }
+    // ── Connection ──────────────────────────────────────────────────────────────
+    static connection() {
+        return this._activeSource.getConnection();
+    }
+    static async query() {
+        const conn = await this.connection();
+        // @ts-ignore
+        return conn.query(...arguments);
+    }
+    static async execute() {
+        const conn = await this.connection();
+        // @ts-ignore
+        return conn.execute(...arguments);
+    }
+    // ── Transactions ────────────────────────────────────────────────────────────
+    static async beginTransaction() {
+        return (await this.connection()).beginTransaction();
+    }
+    static async commitTransaction() {
+        return (await this.connection()).commitTransaction();
+    }
+    static async rollbackTransaction() {
+        return (await this.connection()).rollbackTransaction();
+    }
+    static async executeTransaction(callback) {
+        return (await this.connection()).executeTransaction(callback);
+    }
+    // ── Private helpers ─────────────────────────────────────────────────────────
+    static getActiveSource() {
+        return this._activeSource;
+    }
+    static get _activeSource() {
+        this._ensureConfigured();
+        return this._sources.get(this._activeSourceName);
+    }
+}
+exports.DB = DB;
+//# sourceMappingURL=DB.js.map

package/dist/database/DB.js.map

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

package/dist/database/DataConnection.d.ts

@@ -0,0 +1,24 @@
+import { Connection } from './Connection';
+import { DataSet } from './DataSet';
+import { Query, QueryBuilder } from './query';
+export declare class DataConnection {
+    private connection;
+    private queryBuilder;
+    private debug;
+    private readonly;
+    constructor(connection: Connection, queryBuilder: QueryBuilder);
+    setDebugEnabled(debug: boolean): void;
+    isDebugEnabled(): boolean;
+    setReadonly(readonly: boolean): void;
+    isReadonly(): boolean;
+    beginTransaction(): Promise<void>;
+    rollbackTransaction(): Promise<void>;
+    commitTransaction(): Promise<void>;
+    lastInsertId(): Promise<number>;
+    close(): Promise<void>;
+    query(sql: string, bindings?: Array<any>): Promise<Array<DataSet>>;
+    query(query: Query): Promise<Array<DataSet>>;
+    execute(sql: string, bindings?: Array<any>): Promise<number>;
+    execute(query: Query): Promise<number>;
+    executeTransaction(transaction: (connection: DataConnection) => Promise<void>): Promise<void>;
+}

package/dist/database/DataConnection.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataConnection = void 0;
+const utilities_1 = require("../utilities");
+const query_1 = require("./query");
+class DataConnection {
+    constructor(connection, queryBuilder) {
+        this.debug = false;
+        this.readonly = false;
+        this.connection = connection;
+        this.queryBuilder = queryBuilder;
+    }
+    setDebugEnabled(debug) {
+        this.debug = debug;
+    }
+    isDebugEnabled() {
+        return this.debug;
+    }
+    setReadonly(readonly) {
+        this.readonly = readonly;
+    }
+    isReadonly() {
+        return this.readonly;
+    }
+    async beginTransaction() {
+        if (this.debug) {
+            (0, utilities_1.debugLog)('[BEGIN TRANSACTION]');
+        }
+        if (!this.readonly) {
+            await this.connection.beginTransaction();
+        }
+    }
+    async rollbackTransaction() {
+        if (this.debug) {
+            (0, utilities_1.debugLog)('[ROLLBACK TRANSACTION]');
+        }
+        if (!this.readonly) {
+            await this.connection.rollbackTransaction();
+        }
+    }
+    async commitTransaction() {
+        if (this.debug) {
+            (0, utilities_1.debugLog)('[COMMIT TRANSACTION]');
+        }
+        if (!this.readonly) {
+            await this.connection.commitTransaction();
+        }
+    }
+    async lastInsertId() {
+        return this.connection.lastInsertId();
+    }
+    async close() {
+        await this.connection.close();
+    }
+    async query(sqlOrQuery, bindings) {
+        if (sqlOrQuery instanceof query_1.Query) {
+            const statement = this.queryBuilder.buildQuery(sqlOrQuery);
+            sqlOrQuery = statement.sql;
+            bindings = statement.bindings;
+        }
+        if (this.debug) {
+            (0, utilities_1.debugLog)('SQL: ' +
+                sqlOrQuery +
+                ';' +
+                (bindings
+                    ? '   [' + bindings.map((value) => (typeof value === 'string' ? '"' + value + '"' : value)).join(', ') + ']'
+                    : ''));
+        }
+        return await this.connection.query(sqlOrQuery, bindings);
+    }
+    async execute(sqlOrQuery, bindings) {
+        if (sqlOrQuery instanceof query_1.Query) {
+            const statement = this.queryBuilder.buildQuery(sqlOrQuery);
+            sqlOrQuery = statement.sql;
+            bindings = statement.bindings;
+        }
+        if (this.debug) {
+            (0, utilities_1.debugLog)('SQL: ' +
+                sqlOrQuery +
+                ';' +
+                (bindings
+                    ? '   [' + bindings.map((value) => (typeof value === 'string' ? '"' + value + '"' : value)).join(', ') + ']'
+                    : ''));
+        }
+        return this.readonly ? 0 : await this.connection.execute(sqlOrQuery, bindings);
+    }
+    async executeTransaction(transaction) {
+        await this.beginTransaction();
+        try {
+            await transaction(this);
+            await this.commitTransaction();
+        }
+        catch (e) {
+            await this.rollbackTransaction();
+        }
+    }
+}
+exports.DataConnection = DataConnection;
+//# sourceMappingURL=DataConnection.js.map