@neogroup/neorm 0.0.1 → 0.0.3

package/dist/database/sources/mysql/MysqlDataSource.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MysqlDataSource = void 0;
+const DataSource_1 = require("../../DataSource");
+const MysqlConnection_1 = require("./MysqlConnection");
+const MysqlQueryBuilder_1 = require("./MysqlQueryBuilder");
+class MysqlDataSource extends DataSource_1.DataSource {
+    constructor() {
+        super(new MysqlQueryBuilder_1.MysqlQueryBuilder());
+        try {
+            this.lib = require('mysql2/promise');
+        }
+        catch (e) {
+            throw new Error('MySQL module not found. Please install it via "npm install -S mysql2"');
+        }
+        this.host = '';
+        this.port = 3306;
+        this.databaseName = '';
+        this.username = '';
+        this.password = '';
+    }
+    setHost(host) {
+        this.host = host;
+    }
+    getHost() {
+        return this.host;
+    }
+    setPort(port) {
+        this.port = port;
+    }
+    getPort() {
+        return this.port;
+    }
+    setDatabaseName(databaseName) {
+        this.databaseName = databaseName;
+    }
+    getDatabaseName() {
+        return this.databaseName;
+    }
+    setUsername(username) {
+        this.username = username;
+    }
+    getUsername() {
+        return this.username;
+    }
+    setPassword(password) {
+        this.password = password;
+    }
+    getPassword() {
+        return this.password;
+    }
+    async close() {
+        if (this.pool) {
+            await this.pool.end();
+            this.pool = null;
+        }
+    }
+    async requestConnection() {
+        if (!this.pool) {
+            this.pool = this.lib.createPool({
+                host: this.getHost(),
+                port: this.getPort(),
+                database: this.getDatabaseName(),
+                user: this.getUsername(),
+                password: this.getPassword()
+            });
+        }
+        return new MysqlConnection_1.MysqlConnection(await this.pool.getConnection());
+    }
+}
+exports.MysqlDataSource = MysqlDataSource;
+//# sourceMappingURL=MysqlDataSource.js.map

package/dist/database/sources/mysql/MysqlDataSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MysqlDataSource.js","sourceRoot":"","sources":["../../../../src/database/sources/mysql/MysqlDataSource.ts"],"names":[],"mappings":";;;AACA,iDAA6C;AAC7C,uDAAmD;AACnD,2DAAuD;AAEvD,MAAa,eAAgB,SAAQ,uBAAU;IAS7C;QACE,KAAK,CAAC,IAAI,qCAAiB,EAAE,CAAC,CAAA;QAE9B,IAAI,CAAC;YACH,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;QACtC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAA;QAC1F,CAAC;QAED,IAAI,CAAC,IAAI,GAAG,EAAE,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,YAAY,GAAG,EAAE,CAAA;QACtB,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAA;QAClB,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAA;IACpB,CAAC;IAEM,OAAO,CAAC,IAAY;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAEM,OAAO;QACZ,OAAO,IAAI,CAAC,IAAI,CAAA;IAClB,CAAC;IAEM,OAAO,CAAC,IAAY;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAEM,OAAO;QACZ,OAAO,IAAI,CAAC,IAAI,CAAA;IAClB,CAAC;IAEM,eAAe,CAAC,YAAoB;QACzC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;IAClC,CAAC;IAEM,eAAe;QACpB,OAAO,IAAI,CAAC,YAAY,CAAA;IAC1B,CAAC;IAEM,WAAW,CAAC,QAAgB;QACjC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAC1B,CAAC;IAEM,WAAW;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAEM,WAAW,CAAC,QAAgB;QACjC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAC1B,CAAC;IAEM,WAAW;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAA;YACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAClB,CAAC;IACH,CAAC;IAES,KAAK,CAAC,iBAAiB;QAC/B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC;gBAC9B,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE;gBACpB,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE;gBACpB,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE;gBAChC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE;gBACxB,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE;aAC7B,CAAC,CAAA;QACJ,CAAC;QAED,OAAO,IAAI,iCAAe,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAA;IAC7D,CAAC;CACF;AArFD,0CAqFC"}

package/dist/database/sources/mysql/MysqlQueryBuilder.d.ts

@@ -0,0 +1,6 @@
+import { DefaultQueryBuilder, QueryTable, Statement } from '../../query';
+export declare class MysqlQueryBuilder extends DefaultQueryBuilder {
+    private static readonly BACKTICK;
+    protected buildTable(table: QueryTable, statement: Statement): void;
+    protected buildFieldName(name: string, statement: Statement): void;
+}

package/dist/database/sources/mysql/MysqlQueryBuilder.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MysqlQueryBuilder = void 0;
+const query_1 = require("../../query");
+class MysqlQueryBuilder extends query_1.DefaultQueryBuilder {
+    // MySQL usa backticks para escapar identifiers (tablas, campos)
+    // evitando colisiones con palabras reservadas.
+    // buildTable y buildFieldName son suficientes — buildRawFieldString los invoca
+    // automáticamente al parsear notaciones 'tabla.campo' y 'FUNC(tabla.campo)'.
+    buildTable(table, statement) {
+        if (typeof table === 'string' || table instanceof String) {
+            statement.sql += MysqlQueryBuilder.BACKTICK + table + MysqlQueryBuilder.BACKTICK;
+        }
+        else {
+            if (table.schema) {
+                statement.sql += MysqlQueryBuilder.BACKTICK + table.schema + MysqlQueryBuilder.BACKTICK;
+                statement.sql += query_1.DefaultQueryBuilder.POINT;
+            }
+            statement.sql += MysqlQueryBuilder.BACKTICK + table.name + MysqlQueryBuilder.BACKTICK;
+        }
+    }
+    buildFieldName(name, statement) {
+        statement.sql += MysqlQueryBuilder.BACKTICK + name + MysqlQueryBuilder.BACKTICK;
+    }
+}
+exports.MysqlQueryBuilder = MysqlQueryBuilder;
+MysqlQueryBuilder.BACKTICK = '`';
+//# sourceMappingURL=MysqlQueryBuilder.js.map

package/dist/database/sources/mysql/MysqlQueryBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MysqlQueryBuilder.js","sourceRoot":"","sources":["../../../../src/database/sources/mysql/MysqlQueryBuilder.ts"],"names":[],"mappings":";;;AAAA,uCAAwE;AAExE,MAAa,iBAAkB,SAAQ,2BAAmB;IAGxD,gEAAgE;IAChE,+CAA+C;IAC/C,+EAA+E;IAC/E,6EAA6E;IAEnE,UAAU,CAAC,KAAiB,EAAE,SAAoB;QAC1D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,YAAY,MAAM,EAAE,CAAC;YACzD,SAAS,CAAC,GAAG,IAAI,iBAAiB,CAAC,QAAQ,GAAG,KAAK,GAAG,iBAAiB,CAAC,QAAQ,CAAA;QAClF,CAAC;aAAM,CAAC;YACN,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjB,SAAS,CAAC,GAAG,IAAI,iBAAiB,CAAC,QAAQ,GAAG,KAAK,CAAC,MAAM,GAAG,iBAAiB,CAAC,QAAQ,CAAA;gBACvF,SAAS,CAAC,GAAG,IAAI,2BAAmB,CAAC,KAAK,CAAA;YAC5C,CAAC;YAED,SAAS,CAAC,GAAG,IAAI,iBAAiB,CAAC,QAAQ,GAAG,KAAK,CAAC,IAAI,GAAG,iBAAiB,CAAC,QAAQ,CAAA;QACvF,CAAC;IACH,CAAC;IAES,cAAc,CAAC,IAAY,EAAE,SAAoB;QACzD,SAAS,CAAC,GAAG,IAAI,iBAAiB,CAAC,QAAQ,GAAG,IAAI,GAAG,iBAAiB,CAAC,QAAQ,CAAA;IACjF,CAAC;;AAvBH,8CAwBC;AAvByB,0BAAQ,GAAG,GAAG,CAAA"}

package/dist/database/sources/mysql/index.d.ts

@@ -0,0 +1,3 @@
+export * from './MysqlConnection';
+export * from './MysqlDataSource';
+export * from './MysqlQueryBuilder';

package/dist/database/sources/mysql/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./MysqlConnection"), exports);
+__exportStar(require("./MysqlDataSource"), exports);
+__exportStar(require("./MysqlQueryBuilder"), exports);
+//# sourceMappingURL=index.js.map

package/dist/database/sources/mysql/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/database/sources/mysql/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAiC;AACjC,oDAAiC;AACjC,sDAAmC"}

package/dist/database/sources/postgres/PostgresConnection.d.ts

@@ -0,0 +1,13 @@
+import { Connection } from '../../Connection';
+import { DataSet } from '../../DataSet';
+export declare class PostgresConnection implements Connection {
+    private client;
+    constructor(client: any);
+    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/sources/postgres/PostgresConnection.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresConnection = void 0;
+class PostgresConnection {
+    constructor(client) {
+        this.client = client;
+    }
+    async query(sql, bindings) {
+        const response = await this.client.query(sql, bindings);
+        return response.rows;
+    }
+    async execute(sql, bindings) {
+        const response = await this.client.query(sql, bindings);
+        return response.rowCount;
+    }
+    async lastInsertId() {
+        var _a, _b;
+        try {
+            const result = await this.client.query('SELECT lastval() AS id');
+            return Number((_b = (_a = result.rows[0]) === null || _a === void 0 ? void 0 : _a.id) !== null && _b !== void 0 ? _b : 0);
+        }
+        catch (_c) {
+            return 0;
+        }
+    }
+    async beginTransaction() {
+        await this.client.query('BEGIN');
+    }
+    async rollbackTransaction() {
+        await this.client.query('ROLLBACK');
+    }
+    async commitTransaction() {
+        await this.client.query('COMMIT');
+    }
+    async close() {
+        await this.client.release();
+    }
+}
+exports.PostgresConnection = PostgresConnection;
+//# sourceMappingURL=PostgresConnection.js.map

package/dist/database/sources/postgres/PostgresConnection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresConnection.js","sourceRoot":"","sources":["../../../../src/database/sources/postgres/PostgresConnection.ts"],"names":[],"mappings":";;;AAGA,MAAa,kBAAkB;IAG7B,YAAY,MAAW;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,GAAW,EAAE,QAAqB;QACnD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;QAEvD,OAAO,QAAQ,CAAC,IAAI,CAAA;IACtB,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,QAAqB;QACrD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;QAEvD,OAAO,QAAQ,CAAC,QAAQ,CAAA;IAC1B,CAAC;IAEM,KAAK,CAAC,YAAY;;QACvB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAA;YAEhE,OAAO,MAAM,CAAC,MAAA,MAAA,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,0CAAE,EAAE,mCAAI,CAAC,CAAC,CAAA;QACxC,CAAC;QAAC,WAAM,CAAC;YACP,OAAO,CAAC,CAAA;QACV,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,gBAAgB;QAC3B,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAClC,CAAC;IAEM,KAAK,CAAC,mBAAmB;QAC9B,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;IACrC,CAAC;IAEM,KAAK,CAAC,iBAAiB;QAC5B,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IACnC,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAA;IAC7B,CAAC;CACF;AA5CD,gDA4CC"}

package/dist/database/sources/postgres/PostgresDataSource.d.ts

@@ -0,0 +1,24 @@
+import { Connection } from '../../Connection';
+import { DataSource } from '../../DataSource';
+export declare class PostgresDataSource extends DataSource {
+    private lib;
+    private pool;
+    private host;
+    private port;
+    private databaseName;
+    private username;
+    private password;
+    constructor();
+    setHost(host: string): void;
+    getHost(): string;
+    setPort(port: number): void;
+    getPort(): number;
+    setDatabaseName(databaseName: string): void;
+    getDatabaseName(): string;
+    setUsername(username: string): void;
+    getUsername(): string;
+    setPassword(password: string): void;
+    getPassword(): string;
+    close(): Promise<void>;
+    protected requestConnection(): Promise<Connection>;
+}

package/dist/database/sources/postgres/PostgresDataSource.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresDataSource = void 0;
+const DataSource_1 = require("../../DataSource");
+const PostgresConnection_1 = require("./PostgresConnection");
+const PostgresQueryBuilder_1 = require("./PostgresQueryBuilder");
+class PostgresDataSource extends DataSource_1.DataSource {
+    constructor() {
+        super(new PostgresQueryBuilder_1.PostgresQueryBuilder());
+        try {
+            this.lib = require('pg');
+        }
+        catch (e) {
+            throw new Error('PostgreSQL module not found. Please install it via "npm install -S pg"');
+        }
+        this.host = '';
+        this.port = 5432;
+        this.databaseName = '';
+        this.username = '';
+        this.password = '';
+    }
+    setHost(host) {
+        this.host = host;
+    }
+    getHost() {
+        return this.host;
+    }
+    setPort(port) {
+        this.port = port;
+    }
+    getPort() {
+        return this.port;
+    }
+    setDatabaseName(databaseName) {
+        this.databaseName = databaseName;
+    }
+    getDatabaseName() {
+        return this.databaseName;
+    }
+    setUsername(username) {
+        this.username = username;
+    }
+    getUsername() {
+        return this.username;
+    }
+    setPassword(password) {
+        this.password = password;
+    }
+    getPassword() {
+        return this.password;
+    }
+    async close() {
+        if (this.pool) {
+            await this.pool.end();
+            this.pool = null;
+        }
+    }
+    async requestConnection() {
+        if (!this.pool) {
+            const config = {
+                host: this.getHost(),
+                port: this.getPort(),
+                database: this.getDatabaseName(),
+                user: this.getUsername(),
+                password: this.getPassword()
+            };
+            this.pool = new this.lib.Pool(config);
+        }
+        return new PostgresConnection_1.PostgresConnection(await this.pool.connect());
+    }
+}
+exports.PostgresDataSource = PostgresDataSource;
+//# sourceMappingURL=PostgresDataSource.js.map

package/dist/database/sources/postgres/PostgresDataSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresDataSource.js","sourceRoot":"","sources":["../../../../src/database/sources/postgres/PostgresDataSource.ts"],"names":[],"mappings":";;;AACA,iDAA6C;AAC7C,6DAAyD;AACzD,iEAA6D;AAE7D,MAAa,kBAAmB,SAAQ,uBAAU;IAShD;QACE,KAAK,CAAC,IAAI,2CAAoB,EAAE,CAAC,CAAA;QAEjC,IAAI,CAAC;YACH,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;QAC1B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAA;QAC3F,CAAC;QAED,IAAI,CAAC,IAAI,GAAG,EAAE,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,YAAY,GAAG,EAAE,CAAA;QACtB,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAA;QAClB,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAA;IACpB,CAAC;IAEM,OAAO,CAAC,IAAY;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAEM,OAAO;QACZ,OAAO,IAAI,CAAC,IAAI,CAAA;IAClB,CAAC;IAEM,OAAO,CAAC,IAAY;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAEM,OAAO;QACZ,OAAO,IAAI,CAAC,IAAI,CAAA;IAClB,CAAC;IAEM,eAAe,CAAC,YAAoB;QACzC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;IAClC,CAAC;IAEM,eAAe;QACpB,OAAO,IAAI,CAAC,YAAY,CAAA;IAC1B,CAAC;IAEM,WAAW,CAAC,QAAgB;QACjC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAC1B,CAAC;IAEM,WAAW;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAEM,WAAW,CAAC,QAAgB;QACjC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAC1B,CAAC;IAEM,WAAW;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAA;YACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAClB,CAAC;IACH,CAAC;IAES,KAAK,CAAC,iBAAiB;QAC/B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,MAAM,GAAQ;gBAClB,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE;gBACpB,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE;gBACpB,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE;gBAChC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE;gBACxB,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE;aAC7B,CAAA;YAED,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACvC,CAAC;QAED,OAAO,IAAI,uCAAkB,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;IAC1D,CAAC;CACF;AAvFD,gDAuFC"}

package/dist/database/sources/postgres/PostgresQueryBuilder.d.ts

@@ -0,0 +1,5 @@
+import { DefaultQueryBuilder, Statement } from '../../query';
+export declare class PostgresQueryBuilder extends DefaultQueryBuilder {
+    private static readonly CURRENCY;
+    protected buildSingleValue(value: any, statement: Statement): void;
+}

package/dist/database/sources/postgres/PostgresQueryBuilder.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresQueryBuilder = void 0;
+const query_1 = require("../../query");
+class PostgresQueryBuilder extends query_1.DefaultQueryBuilder {
+    buildSingleValue(value, statement) {
+        statement.sql += PostgresQueryBuilder.CURRENCY + (statement.bindings.length + 1);
+        statement.bindings.push(value);
+    }
+}
+exports.PostgresQueryBuilder = PostgresQueryBuilder;
+PostgresQueryBuilder.CURRENCY = '$';
+//# sourceMappingURL=PostgresQueryBuilder.js.map

package/dist/database/sources/postgres/PostgresQueryBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresQueryBuilder.js","sourceRoot":"","sources":["../../../../src/database/sources/postgres/PostgresQueryBuilder.ts"],"names":[],"mappings":";;;AAAA,uCAA4D;AAE5D,MAAa,oBAAqB,SAAQ,2BAAmB;IAGjD,gBAAgB,CAAC,KAAU,EAAE,SAAoB;QACzD,SAAS,CAAC,GAAG,IAAI,oBAAoB,CAAC,QAAQ,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QAChF,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAChC,CAAC;;AANH,oDAOC;AANyB,6BAAQ,GAAG,GAAG,CAAA"}

package/dist/database/sources/postgres/index.d.ts

@@ -0,0 +1,2 @@
+export * from './PostgresConnection';
+export * from './PostgresDataSource';

package/dist/database/sources/postgres/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./PostgresConnection"), exports);
+__exportStar(require("./PostgresDataSource"), exports);
+//# sourceMappingURL=index.js.map

package/dist/database/sources/postgres/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/database/sources/postgres/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAoC;AACpC,uDAAoC"}

package/dist/database/sources/sqlite/SqliteConnection.d.ts

@@ -0,0 +1,14 @@
+import { Connection } from '../../Connection';
+import { DataSet } from '../../DataSet';
+export declare class SqliteConnection implements Connection {
+    private db;
+    private _lastInsertId;
+    constructor(db: any);
+    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/sources/sqlite/SqliteConnection.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SqliteConnection = void 0;
+class SqliteConnection {
+    constructor(db) {
+        this._lastInsertId = 0;
+        this.db = db;
+    }
+    async query(sql, bindings) {
+        const stmt = this.db.prepare(sql);
+        return stmt.all(...(bindings !== null && bindings !== void 0 ? bindings : []));
+    }
+    async execute(sql, bindings) {
+        var _a, _b;
+        const stmt = this.db.prepare(sql);
+        const result = stmt.run(...(bindings !== null && bindings !== void 0 ? bindings : []));
+        this._lastInsertId = Number((_a = result.lastInsertRowid) !== null && _a !== void 0 ? _a : 0);
+        return (_b = result.changes) !== null && _b !== void 0 ? _b : 0;
+    }
+    async lastInsertId() {
+        return this._lastInsertId;
+    }
+    async beginTransaction() {
+        this.db.prepare('BEGIN').run();
+    }
+    async rollbackTransaction() {
+        this.db.prepare('ROLLBACK').run();
+    }
+    async commitTransaction() {
+        this.db.prepare('COMMIT').run();
+    }
+    async close() {
+        // La instancia db es compartida; el cierre lo maneja SqliteDataSource
+    }
+}
+exports.SqliteConnection = SqliteConnection;
+//# sourceMappingURL=SqliteConnection.js.map

package/dist/database/sources/sqlite/SqliteConnection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteConnection.js","sourceRoot":"","sources":["../../../../src/database/sources/sqlite/SqliteConnection.ts"],"names":[],"mappings":";;;AAGA,MAAa,gBAAgB;IAI3B,YAAY,EAAO;QAFX,kBAAa,GAAW,CAAC,CAAA;QAG/B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAA;IACd,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,GAAW,EAAE,QAAqB;QACnD,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAEjC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,EAAE,CAAC,CAAC,CAAA;IACtC,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,QAAqB;;QACrD,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,EAAE,CAAC,CAAC,CAAA;QAE5C,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,MAAA,MAAM,CAAC,eAAe,mCAAI,CAAC,CAAC,CAAA;QAExD,OAAO,MAAA,MAAM,CAAC,OAAO,mCAAI,CAAC,CAAA;IAC5B,CAAC;IAEM,KAAK,CAAC,YAAY;QACvB,OAAO,IAAI,CAAC,aAAa,CAAA;IAC3B,CAAC;IAEM,KAAK,CAAC,gBAAgB;QAC3B,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAA;IAChC,CAAC;IAEM,KAAK,CAAC,mBAAmB;QAC9B,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,EAAE,CAAA;IACnC,CAAC;IAEM,KAAK,CAAC,iBAAiB;QAC5B,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,EAAE,CAAA;IACjC,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,sEAAsE;IACxE,CAAC;CACF;AA1CD,4CA0CC"}

package/dist/database/sources/sqlite/SqliteDataSource.d.ts

@@ -0,0 +1,11 @@
+import { Connection } from '../../Connection';
+import { DataSource } from '../../DataSource';
+export declare class SqliteDataSource extends DataSource {
+    private db;
+    private filename;
+    constructor();
+    setFilename(filename: string): void;
+    getFilename(): string;
+    close(): Promise<void>;
+    protected requestConnection(): Promise<Connection>;
+}

package/dist/database/sources/sqlite/SqliteDataSource.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SqliteDataSource = void 0;
+const DataSource_1 = require("../../DataSource");
+const SqliteConnection_1 = require("./SqliteConnection");
+const SqliteQueryBuilder_1 = require("./SqliteQueryBuilder");
+class SqliteDataSource extends DataSource_1.DataSource {
+    constructor() {
+        super(new SqliteQueryBuilder_1.SqliteQueryBuilder());
+        this.filename = ':memory:';
+    }
+    setFilename(filename) {
+        this.filename = filename;
+    }
+    getFilename() {
+        return this.filename;
+    }
+    async close() {
+        if (this.db) {
+            this.db.close();
+            this.db = null;
+        }
+    }
+    async requestConnection() {
+        if (!this.db) {
+            // node:sqlite viene incorporado en Node.js >= 22.5 — sin dependencias externas
+            const { DatabaseSync } = require('node:sqlite');
+            this.db = new DatabaseSync(this.filename);
+        }
+        return new SqliteConnection_1.SqliteConnection(this.db);
+    }
+}
+exports.SqliteDataSource = SqliteDataSource;
+//# sourceMappingURL=SqliteDataSource.js.map

package/dist/database/sources/sqlite/SqliteDataSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteDataSource.js","sourceRoot":"","sources":["../../../../src/database/sources/sqlite/SqliteDataSource.ts"],"names":[],"mappings":";;;AACA,iDAA6C;AAC7C,yDAAqD;AACrD,6DAAyD;AAEzD,MAAa,gBAAiB,SAAQ,uBAAU;IAI9C;QACE,KAAK,CAAC,IAAI,uCAAkB,EAAE,CAAC,CAAA;QAC/B,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAA;IAC5B,CAAC;IAEM,WAAW,CAAC,QAAgB;QACjC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAC1B,CAAC;IAEM,WAAW;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAA;YACf,IAAI,CAAC,EAAE,GAAG,IAAI,CAAA;QAChB,CAAC;IACH,CAAC;IAES,KAAK,CAAC,iBAAiB;QAC/B,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,+EAA+E;YAC/E,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;YAE/C,IAAI,CAAC,EAAE,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC3C,CAAC;QAED,OAAO,IAAI,mCAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACtC,CAAC;CACF;AAlCD,4CAkCC"}

package/dist/database/sources/sqlite/SqliteQueryBuilder.d.ts

@@ -0,0 +1,6 @@
+import { DefaultQueryBuilder } from '../../query/builders/DefaultQueryBuilder';
+import { SelectQuery } from '../../query/SelectQuery';
+import { Statement } from '../../query/Statement';
+export declare class SqliteQueryBuilder extends DefaultQueryBuilder {
+    protected buildLimitOffset(query: SelectQuery, statement: Statement): void;
+}

package/dist/database/sources/sqlite/SqliteQueryBuilder.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SqliteQueryBuilder = void 0;
+const DefaultQueryBuilder_1 = require("../../query/builders/DefaultQueryBuilder");
+class SqliteQueryBuilder extends DefaultQueryBuilder_1.DefaultQueryBuilder {
+    buildLimitOffset(query, statement) {
+        // SQLite requiere LIMIT cuando se usa OFFSET; LIMIT -1 significa sin límite
+        if (query.getLimit() >= 0 || query.getOffset() >= 0) {
+            statement.sql += DefaultQueryBuilder_1.DefaultQueryBuilder.SPACE;
+            statement.sql += DefaultQueryBuilder_1.DefaultQueryBuilder.LIMIT;
+            statement.sql += DefaultQueryBuilder_1.DefaultQueryBuilder.SPACE;
+            statement.sql += query.getLimit() >= 0 ? query.getLimit() : -1;
+        }
+        if (query.getOffset() >= 0) {
+            statement.sql += DefaultQueryBuilder_1.DefaultQueryBuilder.SPACE;
+            statement.sql += DefaultQueryBuilder_1.DefaultQueryBuilder.OFFSET;
+            statement.sql += DefaultQueryBuilder_1.DefaultQueryBuilder.SPACE;
+            statement.sql += query.getOffset();
+        }
+    }
+}
+exports.SqliteQueryBuilder = SqliteQueryBuilder;
+//# sourceMappingURL=SqliteQueryBuilder.js.map

package/dist/database/sources/sqlite/SqliteQueryBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteQueryBuilder.js","sourceRoot":"","sources":["../../../../src/database/sources/sqlite/SqliteQueryBuilder.ts"],"names":[],"mappings":";;;AAAA,kFAA8E;AAI9E,MAAa,kBAAmB,SAAQ,yCAAmB;IAC/C,gBAAgB,CAAC,KAAkB,EAAE,SAAoB;QACjE,4EAA4E;QAC5E,IAAI,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC;YACpD,SAAS,CAAC,GAAG,IAAI,yCAAmB,CAAC,KAAK,CAAA;YAC1C,SAAS,CAAC,GAAG,IAAI,yCAAmB,CAAC,KAAK,CAAA;YAC1C,SAAS,CAAC,GAAG,IAAI,yCAAmB,CAAC,KAAK,CAAA;YAC1C,SAAS,CAAC,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAChE,CAAC;QAED,IAAI,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC;YAC3B,SAAS,CAAC,GAAG,IAAI,yCAAmB,CAAC,KAAK,CAAA;YAC1C,SAAS,CAAC,GAAG,IAAI,yCAAmB,CAAC,MAAM,CAAA;YAC3C,SAAS,CAAC,GAAG,IAAI,yCAAmB,CAAC,KAAK,CAAA;YAC1C,SAAS,CAAC,GAAG,IAAI,KAAK,CAAC,SAAS,EAAE,CAAA;QACpC,CAAC;IACH,CAAC;CACF;AAjBD,gDAiBC"}

package/dist/database/sources/sqlite/index.d.ts

@@ -0,0 +1,3 @@
+export * from './SqliteConnection';
+export * from './SqliteDataSource';
+export * from './SqliteQueryBuilder';

package/dist/database/sources/sqlite/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./SqliteConnection"), exports);
+__exportStar(require("./SqliteDataSource"), exports);
+__exportStar(require("./SqliteQueryBuilder"), exports);
+//# sourceMappingURL=index.js.map

package/dist/database/sources/sqlite/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/database/sources/sqlite/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAkC;AAClC,qDAAkC;AAClC,uDAAoC"}

package/dist/entities/BaseEntity.d.ts

@@ -0,0 +1,76 @@
+import { DataSource } from '../database/DataSource';
+import { Field } from '../database/query';
+import { Condition, ConditionGroup } from '../database/query/conditions';
+import { OrderByDirection } from '../database/query/features/HasOrderByFields';
+import { CastType } from './CastType';
+import { EntityQuery } from './EntityQuery';
+import { Relationship } from './Relationship';
+/** A concrete entity class: constructible and carrying the BaseEntity statics. */
+export type EntityClass<T extends BaseEntity = BaseEntity> = typeof BaseEntity & (new () => T);
+/**
+ * Abstract Active Record base class. Entities extend BaseEntity and are
+ * decorated with @Entity/@Column — the decorators fill in the static metadata,
+ * and BaseEntity provides every static query method (find, where, with, …)
+ * plus the save() and delete() instance methods.
+ */
+export declare abstract class BaseEntity {
+    /** Database table name. */
+    static table: string;
+    /** Primary key column name. */
+    static primaryKey: string;
+    /** Entity property names registered with @Column. */
+    static fields: string[];
+    /** Property name → database column name. */
+    static columnsMap: Record<string, string>;
+    /** Properties whose values are generated by the database. */
+    static autoGeneratedFields: string[];
+    /** Property name → cast type. */
+    static casts: Record<string, CastType>;
+    /** Relationship name → relationship definition. */
+    static relationships: Record<string, Relationship>;
+    /** Registered DataSource name. When null, the entity operates directly on DB. */
+    static source: string | null;
+    static getSource(): DataSource;
+    /** Creates a new EntityQuery for this entity. */
+    static query<T extends BaseEntity>(this: EntityClass<T>): EntityQuery<T>;
+    /** Hydrates a database row into an entity instance (applying casts). */
+    static fromRow<T extends BaseEntity>(this: EntityClass<T>, row: Record<string, any>): T;
+    static find<T extends BaseEntity>(this: EntityClass<T>, id: any): Promise<T | null>;
+    static get<T extends BaseEntity>(this: EntityClass<T>): Promise<T[]>;
+    static first<T extends BaseEntity>(this: EntityClass<T>): Promise<T | null>;
+    static where<T extends BaseEntity>(this: EntityClass<T>, callback: (group: ConditionGroup) => void): EntityQuery<T>;
+    static where<T extends BaseEntity>(this: EntityClass<T>, condition: Condition): EntityQuery<T>;
+    static where<T extends BaseEntity>(this: EntityClass<T>, field: Field, value: any): EntityQuery<T>;
+    static where<T extends BaseEntity>(this: EntityClass<T>, field: Field, operator: string, value: any): EntityQuery<T>;
+    static whereIn<T extends BaseEntity>(this: EntityClass<T>, field: Field, values: any[]): EntityQuery<T>;
+    static whereNotIn<T extends BaseEntity>(this: EntityClass<T>, field: Field, values: any[]): EntityQuery<T>;
+    static whereBetween<T extends BaseEntity>(this: EntityClass<T>, field: Field, range: [any, any]): EntityQuery<T>;
+    static whereNotBetween<T extends BaseEntity>(this: EntityClass<T>, field: Field, range: [any, any]): EntityQuery<T>;
+    static whereNull<T extends BaseEntity>(this: EntityClass<T>, field: Field): EntityQuery<T>;
+    static whereNotNull<T extends BaseEntity>(this: EntityClass<T>, field: Field): EntityQuery<T>;
+    static whereLike<T extends BaseEntity>(this: EntityClass<T>, field: Field, pattern: string): EntityQuery<T>;
+    static whereNotLike<T extends BaseEntity>(this: EntityClass<T>, field: Field, pattern: string): EntityQuery<T>;
+    static whereColumn<T extends BaseEntity>(this: EntityClass<T>, field: Field, column: Field): EntityQuery<T>;
+    static whereColumn<T extends BaseEntity>(this: EntityClass<T>, field: Field, operator: string, column: Field): EntityQuery<T>;
+    static orderBy<T extends BaseEntity>(this: EntityClass<T>, field: Field, direction?: OrderByDirection): EntityQuery<T>;
+    static limit<T extends BaseEntity>(this: EntityClass<T>, value: number): EntityQuery<T>;
+    static offset<T extends BaseEntity>(this: EntityClass<T>, value: number): EntityQuery<T>;
+    static select<T extends BaseEntity>(this: EntityClass<T>, ...fields: (Field | Field[])[]): EntityQuery<T>;
+    static with<T extends BaseEntity>(this: EntityClass<T>, relations: string | string[], ...rest: string[]): EntityQuery<T>;
+    static joinRelationship<T extends BaseEntity>(this: EntityClass<T>, relationName: string): EntityQuery<T>;
+    static innerJoinRelationship<T extends BaseEntity>(this: EntityClass<T>, relationName: string): EntityQuery<T>;
+    static leftJoinRelationship<T extends BaseEntity>(this: EntityClass<T>, relationName: string): EntityQuery<T>;
+    /**
+     * Persists the entity to the database.
+     * - If the primary key is set → UPDATE (auto-generated columns are excluded from SET).
+     * - If the primary key is null/undefined → INSERT (auto-generated columns are excluded;
+     *   the generated PK is written back to the instance).
+     */
+    save(): Promise<void>;
+    /**
+     * Deletes the entity from the database by its primary key.
+     * Throws if the primary key is not set.
+     */
+    delete(): Promise<void>;
+    toJSON(): Record<string, any>;
+}