@neogroup/neorm 0.0.1

package/dist/entities/decorators.d.ts

@@ -0,0 +1,50 @@
+import { DataSource } from '../data-source';
+import { CastType } from './entity';
+export interface ColumnOptions {
+    /** Automatic type coercion when reading from the database. */
+    cast?: CastType;
+    /** Mark this column as the primary key. */
+    primaryKey?: boolean;
+    /** Column value is generated by the database (e.g. AUTOINCREMENT). Excluded from INSERT/UPDATE. */
+    autoGenerated?: boolean;
+}
+/** Map a class property to a database column. */
+export declare function Column(options?: ColumnOptions): PropertyDecorator;
+/** One-to-one: this model's primary key appears as foreignKey on the related model. */
+export declare function HasOne(related: () => any, foreignKey: string, localKey?: string): PropertyDecorator;
+/** One-to-many: this model's primary key appears as foreignKey on the related model. */
+export declare function HasMany(related: () => any, foreignKey: string, localKey?: string): PropertyDecorator;
+/** Inverse of HasOne/HasMany: this model holds foreignKey that points to the related model. */
+export declare function BelongsTo(related: () => any, foreignKey: string, localKey?: string): PropertyDecorator;
+/** Has-one through an intermediate model. */
+export declare function HasOneThrough(related: () => any, through: () => any, foreignKey: string, throughForeignKey: string, localKey?: string, throughLocalKey?: string): PropertyDecorator;
+/** Has-many through an intermediate model. */
+export declare function HasManyThrough(related: () => any, through: () => any, foreignKey: string, throughForeignKey: string, localKey?: string, throughLocalKey?: string): PropertyDecorator;
+export interface EntityOptions {
+    /** Database table name. Defaults to lowercase class name + 's'. */
+    table?: string;
+    /** Primary key column name. Defaults to 'id'. */
+    primaryKey?: string;
+    /** DataSource to use. Defaults to DB.getActiveSource(). */
+    source?: DataSource | null;
+}
+/**
+ * Marks a class as an Active Record entity.
+ * Injects static query methods (find, where, get, with, …) — no base class required.
+ * Use saveEntity() and deleteEntity() for persistence.
+ */
+export declare function Entity(options?: EntityOptions): <T extends new (...args: any[]) => {}>(BaseClass: T) => T;
+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/decorators.js

@@ -0,0 +1,305 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Entities = exports.Entity = exports.HasManyThrough = exports.HasOneThrough = exports.BelongsTo = exports.HasMany = exports.HasOne = exports.Column = void 0;
+const db_1 = require("../db");
+const query_1 = require("../query");
+const entity_query_1 = require("./entity-query");
+const relationship_1 = require("./relationship");
+const registry = new WeakMap();
+function getOrCreate(proto) {
+    if (!registry.has(proto)) {
+        registry.set(proto, { columns: [], relationships: [] });
+    }
+    return registry.get(proto);
+}
+// ── Cast helpers ──────────────────────────────────────────────────────────────
+function applyCast(value, type) {
+    if (value == null) {
+        return null;
+    }
+    switch (type) {
+        case 'number':
+            return Number(value);
+        case 'boolean':
+            return value === true || value === 1 || value === '1' || value === 'true';
+        case 'string':
+            return String(value);
+        case 'json':
+            return typeof value === 'string' ? JSON.parse(value) : value;
+        case 'date':
+            return value instanceof Date ? value : new Date(value);
+    }
+}
+function applyCastForStorage(value, type) {
+    if (value == null) {
+        return null;
+    }
+    switch (type) {
+        case 'boolean':
+            return value ? 1 : 0;
+        case 'json':
+            return typeof value === 'string' ? value : JSON.stringify(value);
+        case 'date':
+            return value instanceof Date ? value.toISOString() : value;
+        default:
+            return value;
+    }
+}
+/** Map a class property to a database column. */
+function Column(options) {
+    return (target, propertyKey) => {
+        const m = getOrCreate(target);
+        m.columns.push(Object.assign({ name: String(propertyKey) }, options));
+    };
+}
+exports.Column = Column;
+/** One-to-one: this model's primary key appears as foreignKey on the related model. */
+function HasOne(related, foreignKey, localKey = 'id') {
+    return (target, propertyKey) => {
+        const m = getOrCreate(target);
+        m.relationships.push({ name: String(propertyKey), relationship: (0, relationship_1.hasOne)(related, foreignKey, localKey) });
+    };
+}
+exports.HasOne = HasOne;
+/** One-to-many: this model's primary key appears as foreignKey on the related model. */
+function HasMany(related, foreignKey, localKey = 'id') {
+    return (target, propertyKey) => {
+        const m = getOrCreate(target);
+        m.relationships.push({ name: String(propertyKey), relationship: (0, relationship_1.hasMany)(related, foreignKey, localKey) });
+    };
+}
+exports.HasMany = HasMany;
+/** Inverse of HasOne/HasMany: this model holds foreignKey that points to the related model. */
+function BelongsTo(related, foreignKey, localKey = 'id') {
+    return (target, propertyKey) => {
+        const m = getOrCreate(target);
+        m.relationships.push({ name: String(propertyKey), relationship: (0, relationship_1.belongsTo)(related, foreignKey, localKey) });
+    };
+}
+exports.BelongsTo = BelongsTo;
+/** Has-one through an intermediate model. */
+function HasOneThrough(related, through, foreignKey, throughForeignKey, localKey = 'id', throughLocalKey = 'id') {
+    return (target, propertyKey) => {
+        const m = getOrCreate(target);
+        m.relationships.push({
+            name: String(propertyKey),
+            relationship: (0, relationship_1.hasOneThrough)(related, through, foreignKey, throughForeignKey, localKey, throughLocalKey)
+        });
+    };
+}
+exports.HasOneThrough = HasOneThrough;
+/** Has-many through an intermediate model. */
+function HasManyThrough(related, through, foreignKey, throughForeignKey, localKey = 'id', throughLocalKey = 'id') {
+    return (target, propertyKey) => {
+        const m = getOrCreate(target);
+        m.relationships.push({
+            name: String(propertyKey),
+            relationship: (0, relationship_1.hasManyThrough)(related, through, foreignKey, throughForeignKey, localKey, throughLocalKey)
+        });
+    };
+}
+exports.HasManyThrough = HasManyThrough;
+/**
+ * Marks a class as an Active Record entity.
+ * Injects static query methods (find, where, get, with, …) — no base class required.
+ * Use saveEntity() and deleteEntity() for persistence.
+ */
+function Entity(options) {
+    return function (BaseClass) {
+        var _a, _b, _c, _d, _e, _f;
+        // Read metadata accumulated by property decorators on BaseClass.prototype.
+        const originalName = BaseClass.name;
+        const meta = (_a = registry.get(BaseClass.prototype)) !== null && _a !== void 0 ? _a : { columns: [], relationships: [] };
+        const tableName = (_b = options === null || options === void 0 ? void 0 : options.table) !== null && _b !== void 0 ? _b : originalName.toLowerCase() + 's';
+        const primaryKeyCol = (_e = (_d = (_c = meta.columns.find((c) => c.primaryKey)) === null || _c === void 0 ? void 0 : _c.name) !== null && _d !== void 0 ? _d : options === null || options === void 0 ? void 0 : options.primaryKey) !== null && _e !== void 0 ? _e : 'id';
+        const fieldNames = meta.columns.map((c) => c.name);
+        const autoGeneratedFields = meta.columns.filter((c) => c.autoGenerated).map((c) => c.name);
+        const castsMap = {};
+        meta.columns.forEach((c) => {
+            if (c.cast) {
+                castsMap[c.name] = c.cast;
+            }
+        });
+        const relsMap = {};
+        meta.relationships.forEach((r) => {
+            relsMap[r.name] = r.relationship;
+        });
+        const configuredSource = (_f = options === null || options === void 0 ? void 0 : options.source) !== null && _f !== void 0 ? _f : null;
+        // ── Closures shared by static methods ────────────────────────────────
+        function resolveSource() {
+            return configuredSource !== null && configuredSource !== void 0 ? configuredSource : db_1.DB.getActiveSource();
+        }
+        function hydrateRow(row) {
+            const instance = new Enhanced();
+            const cols = fieldNames.length > 0 ? fieldNames : Object.keys(row);
+            for (const col of cols) {
+                if (!(col in row)) {
+                    continue;
+                }
+                const cast = castsMap[col];
+                instance[col] = cast ? applyCast(row[col], cast) : row[col];
+            }
+            return instance;
+        }
+        function buildQuery() {
+            return new entity_query_1.EntityQuery(Enhanced, resolveSource().table(tableName));
+        }
+        // ── Enhanced class — wraps BaseClass and injects all methods ──────────
+        class Enhanced extends BaseClass {
+            static fromRow(row) {
+                return hydrateRow(row);
+            }
+            // ── Static query methods ───────────────────────────────────────────
+            static async find(id) {
+                return buildQuery().find(id);
+            }
+            static async get() {
+                return buildQuery().get();
+            }
+            static async first() {
+                return buildQuery().first();
+            }
+            static where(...args) {
+                return buildQuery().where(...args);
+            }
+            static whereIn(field, values) {
+                return buildQuery().whereIn(field, values);
+            }
+            static whereNotIn(field, values) {
+                return buildQuery().whereNotIn(field, values);
+            }
+            static whereBetween(field, range) {
+                return buildQuery().whereBetween(field, range);
+            }
+            static whereNotBetween(field, range) {
+                return buildQuery().whereNotBetween(field, range);
+            }
+            static whereNull(field) {
+                return buildQuery().whereNull(field);
+            }
+            static whereNotNull(field) {
+                return buildQuery().whereNotNull(field);
+            }
+            static whereLike(field, pattern) {
+                return buildQuery().whereLike(field, pattern);
+            }
+            static whereNotLike(field, pattern) {
+                return buildQuery().whereNotLike(field, pattern);
+            }
+            static whereColumn(...args) {
+                return buildQuery().whereColumn(...args);
+            }
+            static orderBy(field, direction) {
+                return buildQuery().orderBy(field, direction);
+            }
+            static limit(value) {
+                return buildQuery().limit(value);
+            }
+            static offset(value) {
+                return buildQuery().offset(value);
+            }
+            static select(...args) {
+                return buildQuery().select(...args);
+            }
+            static with(relations, ...rest) {
+                return buildQuery().with(relations, ...rest);
+            }
+            static joinRelationship(name) {
+                return buildQuery().joinRelationship(name);
+            }
+            static innerJoinRelationship(name) {
+                return buildQuery().innerJoinRelationship(name);
+            }
+            static leftJoinRelationship(name) {
+                return buildQuery().leftJoinRelationship(name);
+            }
+        }
+        // Static metadata (also used by EntityQuery internals)
+        Enhanced.table = tableName;
+        Enhanced.primaryKey = primaryKeyCol;
+        Enhanced.fields = fieldNames;
+        Enhanced.autoGeneratedFields = autoGeneratedFields;
+        Enhanced.casts = castsMap;
+        Enhanced.relationships = relsMap;
+        Enhanced.source = configuredSource;
+        // Preserve the original class name so default table names and stack traces stay clean.
+        Object.defineProperty(Enhanced, 'name', { value: originalName });
+        return Enhanced;
+    };
+}
+exports.Entity = Entity;
+// ── 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;
+        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 source = (_d = cls.source) !== null && _d !== void 0 ? _d : 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[col] = cast ? applyCastForStorage(value, cast) : value;
+        }
+        if (entity[pk] != null) {
+            // UPDATE — also exclude PK from SET clause
+            const updateRow = Object.assign({}, row);
+            delete updateRow[pk];
+            await source
+                .table(tableName)
+                .where(pk, entity[pk])
+                .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(pk)) {
+                    ;
+                    entity[pk] = 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;
+        const cls = entity.constructor;
+        const pk = cls.primaryKey;
+        const pkValue = entity[pk];
+        if (pkValue == null) {
+            throw new Error('Cannot delete an entity without a primary key value.');
+        }
+        const source = (_a = cls.source) !== null && _a !== void 0 ? _a : db_1.DB.getActiveSource();
+        await source.table(cls.table).where(pk, pkValue).delete();
+    }
+}
+exports.Entities = Entities;
+//# sourceMappingURL=decorators.js.map

package/dist/entities/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../src/entities/decorators.ts"],"names":[],"mappings":";;;AAEA,8BAA0B;AAC1B,oCAA6C;AAI7C,iDAA4C;AAC5C,iDAOuB;AAuBvB,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAyB,CAAA;AAErD,SAAS,WAAW,CAAC,KAAa;IAChC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;QACxB,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,CAAA;KACxD;IAED,OAAO,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAE,CAAA;AAC7B,CAAC;AAED,iFAAiF;AAEjF,SAAS,SAAS,CAAC,KAAU,EAAE,IAAc;IAC3C,IAAI,KAAK,IAAI,IAAI,EAAE;QACjB,OAAO,IAAI,CAAA;KACZ;IAED,QAAQ,IAAI,EAAE;QACZ,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;QACtB,KAAK,SAAS;YACZ,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,MAAM,CAAA;QAC3E,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;QACtB,KAAK,MAAM;YACT,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;QAC9D,KAAK,MAAM;YACT,OAAO,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAA;KACzD;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAU,EAAE,IAAc;IACrD,IAAI,KAAK,IAAI,IAAI,EAAE;QACjB,OAAO,IAAI,CAAA;KACZ;IAED,QAAQ,IAAI,EAAE;QACZ,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACtB,KAAK,MAAM;YACT,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;QAClE,KAAK,MAAM;YACT,OAAO,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,CAAA;QAC5D;YACE,OAAO,KAAK,CAAA;KACf;AACH,CAAC;AAaD,iDAAiD;AACjD,SAAgB,MAAM,CAAC,OAAuB;IAC5C,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;QAC7B,MAAM,CAAC,GAAG,WAAW,CAAC,MAAgB,CAAC,CAAA;QAEvC,CAAC,CAAC,OAAO,CAAC,IAAI,iBAAG,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,IAAK,OAAO,EAAG,CAAA;IAC3D,CAAC,CAAA;AACH,CAAC;AAND,wBAMC;AAED,uFAAuF;AACvF,SAAgB,MAAM,CAAC,OAAkB,EAAE,UAAkB,EAAE,QAAQ,GAAG,IAAI;IAC5E,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;QAC7B,MAAM,CAAC,GAAG,WAAW,CAAC,MAAgB,CAAC,CAAA;QAEvC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,YAAY,EAAE,IAAA,qBAAO,EAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAA;IAC3G,CAAC,CAAA;AACH,CAAC;AAND,wBAMC;AAED,wFAAwF;AACxF,SAAgB,OAAO,CAAC,OAAkB,EAAE,UAAkB,EAAE,QAAQ,GAAG,IAAI;IAC7E,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;QAC7B,MAAM,CAAC,GAAG,WAAW,CAAC,MAAgB,CAAC,CAAA;QAEvC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,YAAY,EAAE,IAAA,sBAAQ,EAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAA;IAC5G,CAAC,CAAA;AACH,CAAC;AAND,0BAMC;AAED,+FAA+F;AAC/F,SAAgB,SAAS,CAAC,OAAkB,EAAE,UAAkB,EAAE,QAAQ,GAAG,IAAI;IAC/E,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;QAC7B,MAAM,CAAC,GAAG,WAAW,CAAC,MAAgB,CAAC,CAAA;QAEvC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,YAAY,EAAE,IAAA,wBAAU,EAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAA;IAC9G,CAAC,CAAA;AACH,CAAC;AAND,8BAMC;AAED,6CAA6C;AAC7C,SAAgB,aAAa,CAC3B,OAAkB,EAClB,OAAkB,EAClB,UAAkB,EAClB,iBAAyB,EACzB,QAAQ,GAAG,IAAI,EACf,eAAe,GAAG,IAAI;IAEtB,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;QAC7B,MAAM,CAAC,GAAG,WAAW,CAAC,MAAgB,CAAC,CAAA;QAEvC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC;YACnB,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC;YACzB,YAAY,EAAE,IAAA,4BAAc,EAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,QAAQ,EAAE,eAAe,CAAC;SACzG,CAAC,CAAA;IACJ,CAAC,CAAA;AACH,CAAC;AAhBD,sCAgBC;AAED,8CAA8C;AAC9C,SAAgB,cAAc,CAC5B,OAAkB,EAClB,OAAkB,EAClB,UAAkB,EAClB,iBAAyB,EACzB,QAAQ,GAAG,IAAI,EACf,eAAe,GAAG,IAAI;IAEtB,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;QAC7B,MAAM,CAAC,GAAG,WAAW,CAAC,MAAgB,CAAC,CAAA;QAEvC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC;YACnB,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC;YACzB,YAAY,EAAE,IAAA,6BAAe,EAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,QAAQ,EAAE,eAAe,CAAC;SAC1G,CAAC,CAAA;IACJ,CAAC,CAAA;AACH,CAAC;AAhBD,wCAgBC;AAaD;;;;GAIG;AACH,SAAgB,MAAM,CAAC,OAAuB;IAC5C,OAAO,UAAkD,SAAY;;QACnE,2EAA2E;QAC3E,MAAM,YAAY,GAAG,SAAS,CAAC,IAAI,CAAA;QACnC,MAAM,IAAI,GAAG,MAAA,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,mCAAI,EAAE,OAAO,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,CAAA;QACpF,MAAM,SAAS,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,mCAAI,YAAY,CAAC,WAAW,EAAE,GAAG,GAAG,CAAA;QACpE,MAAM,aAAa,GAAG,MAAA,MAAA,MAAA,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,0CAAE,IAAI,mCAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,UAAU,mCAAI,IAAI,CAAA;QACjG,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QAClD,MAAM,mBAAmB,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QAC1F,MAAM,QAAQ,GAA6B,EAAE,CAAA;QAE7C,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YACzB,IAAI,CAAC,CAAC,IAAI,EAAE;gBACV,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAA;aAC1B;QACH,CAAC,CAAC,CAAA;QACF,MAAM,OAAO,GAAiC,EAAE,CAAA;QAEhD,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YAC/B,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,YAAY,CAAA;QAClC,CAAC,CAAC,CAAA;QACF,MAAM,gBAAgB,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM,mCAAI,IAAI,CAAA;QAEhD,wEAAwE;QAExE,SAAS,aAAa;YACpB,OAAO,gBAAgB,aAAhB,gBAAgB,cAAhB,gBAAgB,GAAI,OAAE,CAAC,eAAe,EAAE,CAAA;QACjD,CAAC;QAED,SAAS,UAAU,CAAC,GAAwB;YAC1C,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAS,CAAA;YACtC,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAElE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE;gBACtB,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE;oBACjB,SAAQ;iBACT;gBAED,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAA;gBAE1B,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;aAC5D;YAED,OAAO,QAAQ,CAAA;QACjB,CAAC;QAED,SAAS,UAAU;YACjB,OAAO,IAAI,0BAAW,CAAM,QAAe,EAAE,aAAa,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAA;QAChF,CAAC;QAED,yEAAyE;QAEzE,MAAM,QAAS,SAAQ,SAAS;YAU9B,MAAM,CAAC,OAAO,CAAC,GAAwB;gBACrC,OAAO,UAAU,CAAC,GAAG,CAAC,CAAA;YACxB,CAAC;YAED,sEAAsE;YAEtE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAO;gBACvB,OAAO,UAAU,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAC9B,CAAC;YAED,MAAM,CAAC,KAAK,CAAC,GAAG;gBACd,OAAO,UAAU,EAAE,CAAC,GAAG,EAAE,CAAA;YAC3B,CAAC;YAED,MAAM,CAAC,KAAK,CAAC,KAAK;gBAChB,OAAO,UAAU,EAAE,CAAC,KAAK,EAAE,CAAA;YAC7B,CAAC;YAMD,MAAM,CAAC,KAAK,CAAC,GAAG,IAAW;gBACzB,OAAQ,UAAU,EAAU,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAA;YAC7C,CAAC;YAED,MAAM,CAAC,OAAO,CAAC,KAAY,EAAE,MAAa;gBACxC,OAAO,UAAU,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;YAC5C,CAAC;YAED,MAAM,CAAC,UAAU,CAAC,KAAY,EAAE,MAAa;gBAC3C,OAAO,UAAU,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;YAC/C,CAAC;YAED,MAAM,CAAC,YAAY,CAAC,KAAY,EAAE,KAAiB;gBACjD,OAAO,UAAU,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;YAChD,CAAC;YAED,MAAM,CAAC,eAAe,CAAC,KAAY,EAAE,KAAiB;gBACpD,OAAO,UAAU,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;YACnD,CAAC;YAED,MAAM,CAAC,SAAS,CAAC,KAAY;gBAC3B,OAAO,UAAU,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;YACtC,CAAC;YAED,MAAM,CAAC,YAAY,CAAC,KAAY;gBAC9B,OAAO,UAAU,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;YACzC,CAAC;YAED,MAAM,CAAC,SAAS,CAAC,KAAY,EAAE,OAAe;gBAC5C,OAAO,UAAU,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;YAC/C,CAAC;YAED,MAAM,CAAC,YAAY,CAAC,KAAY,EAAE,OAAe;gBAC/C,OAAO,UAAU,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;YAClD,CAAC;YAID,MAAM,CAAC,WAAW,CAAC,GAAG,IAAW;gBAC/B,OAAQ,UAAU,EAAU,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,CAAA;YACnD,CAAC;YAED,MAAM,CAAC,OAAO,CAAC,KAAY,EAAE,SAA4B;gBACvD,OAAO,UAAU,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;YAC/C,CAAC;YAED,MAAM,CAAC,KAAK,CAAC,KAAa;gBACxB,OAAO,UAAU,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YAClC,CAAC;YAED,MAAM,CAAC,MAAM,CAAC,KAAa;gBACzB,OAAO,UAAU,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACnC,CAAC;YAED,MAAM,CAAC,MAAM,CAAC,GAAG,IAAyB;gBACxC,OAAQ,UAAU,EAAU,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAA;YAC9C,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,SAA4B,EAAE,GAAG,IAAc;gBACzD,OAAO,UAAU,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,CAAA;YAC9C,CAAC;YAED,MAAM,CAAC,gBAAgB,CAAC,IAAY;gBAClC,OAAO,UAAU,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAA;YAC5C,CAAC;YAED,MAAM,CAAC,qBAAqB,CAAC,IAAY;gBACvC,OAAO,UAAU,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAA;YACjD,CAAC;YAED,MAAM,CAAC,oBAAoB,CAAC,IAAY;gBACtC,OAAO,UAAU,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAA;YAChD,CAAC;;QAvGD,uDAAuD;QACvC,cAAK,GAAG,SAAS,CAAA;QACjB,mBAAU,GAAG,aAAa,CAAA;QAC1B,eAAM,GAAG,UAAU,CAAA;QACnB,4BAAmB,GAAG,mBAAmB,CAAA;QACzC,cAAK,GAAG,QAAQ,CAAA;QAChB,sBAAa,GAAG,OAAO,CAAA;QACvB,eAAM,GAAG,gBAAgB,CAAA;QAmG3C,uFAAuF;QACvF,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAA;QAEhE,OAAO,QAAwB,CAAA;IACjC,CAAC,CAAA;AACH,CAAC;AApKD,wBAoKC;AAED,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,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,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;SAC3D;QAED,IAAK,MAAc,CAAC,EAAE,CAAC,IAAI,IAAI,EAAE;YAC/B,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,EAAE,CAAC,CAAC;iBAC9B,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,EAAE,CAAC,EAAE;oBACpC,CAAC;oBAAC,MAAc,CAAC,EAAE,CAAC,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAA;iBACjD;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,OAAO,GAAI,MAAc,CAAC,EAAE,CAAC,CAAA;QAEnC,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;AAhFD,4BAgFC"}

package/dist/entities/entity-query.d.ts

@@ -0,0 +1,60 @@
+import { DataTable } from '../data-table';
+import { Field } from '../query';
+import { Condition, ConditionGroup } from '../query/conditions';
+import { OrderByDirection } from '../query/features/has-order-by-fields';
+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 {};