@neogroup/neorm 0.0.1 → 0.0.3

package/dist/entities/BaseEntity.js

@@ -0,0 +1,208 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseEntity = void 0;
+const DB_1 = require("../database/DB");
+const query_1 = require("../database/query");
+const casts_1 = require("./decorators/casts");
+const EntityQuery_1 = require("./EntityQuery");
+/**
+ * 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.
+ */
+class BaseEntity {
+    // ── Internals ────────────────────────────────────────────────────────────────
+    static getSource() {
+        return this.source ? DB_1.DB.source(this.source) : DB_1.DB.getActiveSource();
+    }
+    /** Creates a new EntityQuery for this entity. */
+    static query() {
+        return new EntityQuery_1.EntityQuery(this, this.getSource().table(this.table));
+    }
+    /** Hydrates a database row into an entity instance (applying casts). */
+    static fromRow(row) {
+        var _a, _b, _c, _d;
+        const instance = new this();
+        const fieldNames = (_a = this.fields) !== null && _a !== void 0 ? _a : [];
+        const columnsMap = (_b = this.columnsMap) !== null && _b !== void 0 ? _b : {};
+        const castsMap = (_c = this.casts) !== null && _c !== void 0 ? _c : {};
+        const cols = fieldNames.length > 0 ? fieldNames : Object.keys(row);
+        for (const prop of cols) {
+            const col = (_d = columnsMap[prop]) !== null && _d !== void 0 ? _d : prop;
+            if (!(col in row)) {
+                continue;
+            }
+            const cast = castsMap[prop];
+            instance[prop] = cast ? (0, casts_1.applyCast)(row[col], cast) : row[col];
+        }
+        return instance;
+    }
+    // ── Static query methods ─────────────────────────────────────────────────────
+    static async find(id) {
+        return this.query().find(id);
+    }
+    static async get() {
+        return this.query().get();
+    }
+    static async first() {
+        return this.query().first();
+    }
+    static where(...args) {
+        return this.query().where(...args);
+    }
+    static whereIn(field, values) {
+        return this.query().whereIn(field, values);
+    }
+    static whereNotIn(field, values) {
+        return this.query().whereNotIn(field, values);
+    }
+    static whereBetween(field, range) {
+        return this.query().whereBetween(field, range);
+    }
+    static whereNotBetween(field, range) {
+        return this.query().whereNotBetween(field, range);
+    }
+    static whereNull(field) {
+        return this.query().whereNull(field);
+    }
+    static whereNotNull(field) {
+        return this.query().whereNotNull(field);
+    }
+    static whereLike(field, pattern) {
+        return this.query().whereLike(field, pattern);
+    }
+    static whereNotLike(field, pattern) {
+        return this.query().whereNotLike(field, pattern);
+    }
+    static whereColumn(...args) {
+        return this.query().whereColumn(...args);
+    }
+    static orderBy(field, direction) {
+        return this.query().orderBy(field, direction);
+    }
+    static limit(value) {
+        return this.query().limit(value);
+    }
+    static offset(value) {
+        return this.query().offset(value);
+    }
+    static select(...fields) {
+        return this.query().select(...fields);
+    }
+    static with(relations, ...rest) {
+        return this.query().with(relations, ...rest);
+    }
+    static joinRelationship(relationName) {
+        return this.query().joinRelationship(relationName);
+    }
+    static innerJoinRelationship(relationName) {
+        return this.query().innerJoinRelationship(relationName);
+    }
+    static leftJoinRelationship(relationName) {
+        return this.query().leftJoinRelationship(relationName);
+    }
+    // ── Persistence ──────────────────────────────────────────────────────────────
+    /**
+     * 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).
+     */
+    async save() {
+        var _a, _b, _c, _d, _e, _f;
+        const cls = this.constructor;
+        const pk = cls.primaryKey;
+        const fieldNames = (_a = cls.fields) !== null && _a !== void 0 ? _a : [];
+        const autoGeneratedFields = (_b = cls.autoGeneratedFields) !== null && _b !== void 0 ? _b : [];
+        const castsMap = (_c = cls.casts) !== null && _c !== void 0 ? _c : {};
+        const columnsMap = (_d = cls.columnsMap) !== null && _d !== void 0 ? _d : {};
+        const pkProp = (_e = Object.keys(columnsMap).find((p) => columnsMap[p] === pk)) !== null && _e !== void 0 ? _e : pk;
+        const source = cls.getSource();
+        // Build the row, skipping auto-generated columns (DB manages their values)
+        const row = {};
+        const cols = fieldNames.length > 0
+            ? fieldNames
+            : Object.keys(this).filter((k) => typeof this[k] !== 'function');
+        for (const col of cols) {
+            if (autoGeneratedFields.includes(col)) {
+                continue;
+            }
+            const value = this[col];
+            if (value === undefined) {
+                continue;
+            }
+            const cast = castsMap[col];
+            row[(_f = columnsMap[col]) !== null && _f !== void 0 ? _f : col] = cast ? (0, casts_1.applyCastForStorage)(value, cast) : value;
+        }
+        if (this[pkProp] != null) {
+            // UPDATE — also exclude PK from SET clause
+            const updateRow = Object.assign({}, row);
+            delete updateRow[pk];
+            await source
+                .table(cls.table)
+                .where(pk, this[pkProp])
+                .update(updateRow);
+        }
+        else {
+            // INSERT — get connection to read back the generated ID
+            const conn = await source.getConnection();
+            try {
+                await conn.execute(new query_1.InsertQuery().setTable(cls.table).setFields(row));
+                if (autoGeneratedFields.includes(pkProp)) {
+                    ;
+                    this[pkProp] = await conn.lastInsertId();
+                }
+            }
+            finally {
+                await conn.close();
+            }
+        }
+    }
+    /**
+     * Deletes the entity from the database by its primary key.
+     * Throws if the primary key is not set.
+     */
+    async delete() {
+        var _a, _b;
+        const cls = this.constructor;
+        const pk = cls.primaryKey;
+        const columnsMap = (_a = cls.columnsMap) !== null && _a !== void 0 ? _a : {};
+        const pkProp = (_b = Object.keys(columnsMap).find((p) => columnsMap[p] === pk)) !== null && _b !== void 0 ? _b : pk;
+        const pkValue = this[pkProp];
+        if (pkValue == null) {
+            throw new Error('Cannot delete an entity without a primary key value.');
+        }
+        await cls.getSource().table(cls.table).where(pk, pkValue).delete();
+    }
+    // ── Serialization ────────────────────────────────────────────────────────────
+    toJSON() {
+        const result = {};
+        // Own enumerable properties — column values set by fromRow
+        for (const key of Object.keys(this)) {
+            result[key] = this[key];
+        }
+        // Getters defined on the entity's prototype chain (computed attributes)
+        let proto = Object.getPrototypeOf(this);
+        while (proto && proto !== BaseEntity.prototype && proto !== Object.prototype) {
+            for (const key of Object.getOwnPropertyNames(proto)) {
+                if (key === 'constructor' || key in result) {
+                    continue;
+                }
+                const descriptor = Object.getOwnPropertyDescriptor(proto, key);
+                if (descriptor && typeof descriptor.get === 'function') {
+                    try {
+                        result[key] = this[key];
+                    }
+                    catch (_a) {
+                        // skip getters that throw (e.g. unloaded relationships)
+                    }
+                }
+            }
+            proto = Object.getPrototypeOf(proto);
+        }
+        return result;
+    }
+}
+exports.BaseEntity = BaseEntity;
+//# sourceMappingURL=BaseEntity.js.map

package/dist/entities/BaseEntity.js.map

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

package/dist/entities/CastType.d.ts

@@ -0,0 +1 @@
+export type CastType = 'number' | 'boolean' | 'string' | 'json' | 'date';

package/dist/entities/CastType.js

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

package/dist/entities/CastType.js.map

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

package/dist/entities/Entities.d.ts

@@ -0,0 +1,14 @@
+export declare class Entities {
+    /**
+     * Persists an entity instance 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).
+     */
+    static save(entity: object): Promise<void>;
+    /**
+     * Deletes an entity instance from the database by its primary key.
+     * Throws if the primary key is not set.
+     */
+    static delete(entity: object): Promise<void>;
+}

package/dist/entities/Entities.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Entities = void 0;
+const DB_1 = require("../database/DB");
+const query_1 = require("../query");
+const casts_1 = require("./decorators/casts");
+// ── Entities namespace ────────────────────────────────────────────────────────
+class Entities {
+    /**
+     * Persists an entity instance 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).
+     */
+    static async save(entity) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        const cls = entity.constructor;
+        const pk = cls.primaryKey;
+        const tableName = cls.table;
+        const fieldNames = (_a = cls.fields) !== null && _a !== void 0 ? _a : [];
+        const autoGeneratedFields = (_b = cls.autoGeneratedFields) !== null && _b !== void 0 ? _b : [];
+        const castsMap = (_c = cls.casts) !== null && _c !== void 0 ? _c : {};
+        const columnsMap = (_d = cls.columnsMap) !== null && _d !== void 0 ? _d : {};
+        const pkProp = (_e = Object.keys(columnsMap).find((p) => columnsMap[p] === pk)) !== null && _e !== void 0 ? _e : pk;
+        const source = (_f = cls.source) !== null && _f !== void 0 ? _f : DB_1.DB.getActiveSource();
+        // Build the row, skipping auto-generated columns (DB manages their values)
+        const row = {};
+        const cols = fieldNames.length > 0
+            ? fieldNames
+            : Object.keys(entity).filter((k) => typeof entity[k] !== 'function');
+        for (const col of cols) {
+            if (autoGeneratedFields.includes(col)) {
+                continue;
+            }
+            const value = entity[col];
+            if (value === undefined) {
+                continue;
+            }
+            const cast = castsMap[col];
+            row[(_g = columnsMap[col]) !== null && _g !== void 0 ? _g : col] = cast ? (0, casts_1.applyCastForStorage)(value, cast) : value;
+        }
+        if (entity[pkProp] != null) {
+            // UPDATE — also exclude PK from SET clause
+            const updateRow = Object.assign({}, row);
+            delete updateRow[pk];
+            await source
+                .table(tableName)
+                .where(pk, entity[pkProp])
+                .update(updateRow);
+        }
+        else {
+            // INSERT — get connection to read back the generated ID
+            const conn = await source.getConnection();
+            try {
+                await conn.execute(new query_1.InsertQuery().setTable(tableName).setFields(row));
+                if (autoGeneratedFields.includes(pkProp)) {
+                    ;
+                    entity[pkProp] = await conn.lastInsertId();
+                }
+            }
+            finally {
+                await conn.close();
+            }
+        }
+    }
+    /**
+     * Deletes an entity instance from the database by its primary key.
+     * Throws if the primary key is not set.
+     */
+    static async delete(entity) {
+        var _a, _b, _c;
+        const cls = entity.constructor;
+        const pk = cls.primaryKey;
+        const columnsMap = (_a = cls.columnsMap) !== null && _a !== void 0 ? _a : {};
+        const pkProp = (_b = Object.keys(columnsMap).find((p) => columnsMap[p] === pk)) !== null && _b !== void 0 ? _b : pk;
+        const pkValue = entity[pkProp];
+        if (pkValue == null) {
+            throw new Error('Cannot delete an entity without a primary key value.');
+        }
+        const source = (_c = cls.source) !== null && _c !== void 0 ? _c : DB_1.DB.getActiveSource();
+        await source.table(cls.table).where(pk, pkValue).delete();
+    }
+}
+exports.Entities = Entities;
+//# sourceMappingURL=Entities.js.map

package/dist/entities/Entities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Entities.js","sourceRoot":"","sources":["../../src/entities/Entities.ts"],"names":[],"mappings":";;;AAEA,uCAAmC;AACnC,oCAAsC;AAEtC,8CAAwD;AAExD,iFAAiF;AAEjF,MAAa,QAAQ;IACnB;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAc;;QAC9B,MAAM,GAAG,GAAG,MAAM,CAAC,WAAkB,CAAA;QACrC,MAAM,EAAE,GAAW,GAAG,CAAC,UAAU,CAAA;QACjC,MAAM,SAAS,GAAW,GAAG,CAAC,KAAK,CAAA;QACnC,MAAM,UAAU,GAAa,MAAA,GAAG,CAAC,MAAM,mCAAI,EAAE,CAAA;QAC7C,MAAM,mBAAmB,GAAa,MAAA,GAAG,CAAC,mBAAmB,mCAAI,EAAE,CAAA;QACnE,MAAM,QAAQ,GAA6B,MAAA,GAAG,CAAC,KAAK,mCAAI,EAAE,CAAA;QAC1D,MAAM,UAAU,GAA2B,MAAA,GAAG,CAAC,UAAU,mCAAI,EAAE,CAAA;QAC/D,MAAM,MAAM,GAAG,MAAA,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,mCAAI,EAAE,CAAA;QAC9E,MAAM,MAAM,GAAe,MAAA,GAAG,CAAC,MAAM,mCAAI,OAAE,CAAC,eAAe,EAAE,CAAA;QAC7D,2EAA2E;QAC3E,MAAM,GAAG,GAAY,EAAE,CAAA;QACvB,MAAM,IAAI,GACR,UAAU,CAAC,MAAM,GAAG,CAAC;YACnB,CAAC,CAAC,UAAU;YACZ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAa,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAQ,MAAc,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAA;QAExF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE;YACtB,IAAI,mBAAmB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;gBACrC,SAAQ;aACT;YAED,MAAM,KAAK,GAAI,MAAc,CAAC,GAAG,CAAC,CAAA;YAElC,IAAI,KAAK,KAAK,SAAS,EAAE;gBACvB,SAAQ;aACT;YAED,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAA;YAE1B,GAAG,CAAC,MAAA,UAAU,CAAC,GAAG,CAAC,mCAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAA,2BAAmB,EAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;SAC9E;QAED,IAAK,MAAc,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE;YACnC,2CAA2C;YAC3C,MAAM,SAAS,qBAAQ,GAAG,CAAE,CAAA;YAE5B,OAAO,SAAS,CAAC,EAAE,CAAC,CAAA;YACpB,MAAM,MAAM;iBACT,KAAK,CAAC,SAAS,CAAC;iBAChB,KAAK,CAAC,EAAE,EAAG,MAAc,CAAC,MAAM,CAAC,CAAC;iBAClC,MAAM,CAAC,SAAS,CAAC,CAAA;SACrB;aAAM;YACL,wDAAwD;YACxD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,aAAa,EAAE,CAAA;YAEzC,IAAI;gBACF,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,mBAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAA;gBAExE,IAAI,mBAAmB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;oBACxC,CAAC;oBAAC,MAAc,CAAC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAA;iBACrD;aACF;oBAAS;gBACR,MAAM,IAAI,CAAC,KAAK,EAAE,CAAA;aACnB;SACF;IACH,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAc;;QAChC,MAAM,GAAG,GAAG,MAAM,CAAC,WAAkB,CAAA;QACrC,MAAM,EAAE,GAAW,GAAG,CAAC,UAAU,CAAA;QACjC,MAAM,UAAU,GAA2B,MAAA,GAAG,CAAC,UAAU,mCAAI,EAAE,CAAA;QAC/D,MAAM,MAAM,GAAG,MAAA,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,mCAAI,EAAE,CAAA;QAC9E,MAAM,OAAO,GAAI,MAAc,CAAC,MAAM,CAAC,CAAA;QAEvC,IAAI,OAAO,IAAI,IAAI,EAAE;YACnB,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAA;SACxE;QAED,MAAM,MAAM,GAAe,MAAA,GAAG,CAAC,MAAM,mCAAI,OAAE,CAAC,eAAe,EAAE,CAAA;QAE7D,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,MAAM,EAAE,CAAA;IAC3D,CAAC;CACF;AApFD,4BAoFC"}

package/dist/entities/EntityQuery.d.ts

@@ -0,0 +1,60 @@
+import { DataTable } from '../database/DataTable';
+import { Field } from '../database/query';
+import { Condition, ConditionGroup } from '../database/query/conditions';
+import { OrderByDirection } from '../database/query/features/HasOrderByFields';
+import { Relationship } from './Relationship';
+type EntityClass<T> = (new () => T) & {
+    table: string;
+    primaryKey: string;
+    relationships: Record<string, Relationship>;
+    fromRow(row: Record<string, any>): T;
+};
+/**
+ * Chainable query builder for Entities. Wraps DataTable and hydrates rows
+ * into typed Entity instances when a terminal method is called.
+ */
+export declare class EntityQuery<T> {
+    private _entityClass;
+    private _table;
+    private _withs;
+    constructor(entityClass: EntityClass<T>, table: DataTable);
+    with(relations: string | string[], ...rest: string[]): this;
+    joinRelationship(relationName: string): this;
+    innerJoinRelationship(relationName: string): this;
+    leftJoinRelationship(relationName: string): this;
+    private _applyJoin;
+    get(): Promise<T[]>;
+    first(): Promise<T | null>;
+    find(id: any): Promise<T | null>;
+    private _loadRelations;
+    where(callback: (group: ConditionGroup) => void): this;
+    where(condition: Condition): this;
+    where(field: Field, value: any): this;
+    where(field: Field, operator: string, value: any): this;
+    whereIn(field: Field, values: any[]): this;
+    whereNotIn(field: Field, values: any[]): this;
+    whereBetween(field: Field, range: [any, any]): this;
+    whereNotBetween(field: Field, range: [any, any]): this;
+    whereNull(field: Field): this;
+    whereNotNull(field: Field): this;
+    whereLike(field: Field, pattern: string): this;
+    whereNotLike(field: Field, pattern: string): this;
+    whereColumn(field: Field, column: Field): this;
+    whereColumn(field: Field, operator: string, column: Field): this;
+    orWhere(...args: any[]): this;
+    orWhereIn(field: Field, values: any[]): this;
+    orWhereNotIn(field: Field, values: any[]): this;
+    orWhereBetween(field: Field, range: [any, any]): this;
+    orWhereNotBetween(field: Field, range: [any, any]): this;
+    orWhereNull(field: Field): this;
+    orWhereNotNull(field: Field): this;
+    orWhereLike(field: Field, pattern: string): this;
+    orWhereNotLike(field: Field, pattern: string): this;
+    select(...fields: (Field | Field[])[]): this;
+    orderBy(field: Field, direction?: OrderByDirection): this;
+    groupBy(...fields: Field[]): this;
+    limit(value: number): this;
+    offset(value: number): this;
+    distinct(): this;
+}
+export {};