@neogroup/neorm 0.0.1 → 0.0.3

package/dist/entities/EntityQuery.js

@@ -0,0 +1,305 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntityQuery = void 0;
+const HasJoins_1 = require("../database/query/features/HasJoins");
+/**
+ * Chainable query builder for Entities. Wraps DataTable and hydrates rows
+ * into typed Entity instances when a terminal method is called.
+ */
+class EntityQuery {
+    constructor(entityClass, table) {
+        this._withs = [];
+        this._entityClass = entityClass;
+        this._table = table;
+    }
+    // ── Eager loading ────────────────────────────────────────────────────────────
+    with(relations, ...rest) {
+        const toAdd = Array.isArray(relations) ? relations : [relations, ...rest];
+        this._withs.push(...toAdd);
+        return this;
+    }
+    // ── Join relationships ───────────────────────────────────────────────────────
+    joinRelationship(relationName) {
+        return this._applyJoin(HasJoins_1.JoinType.INNER_JOIN, relationName);
+    }
+    innerJoinRelationship(relationName) {
+        return this._applyJoin(HasJoins_1.JoinType.INNER_JOIN, relationName);
+    }
+    leftJoinRelationship(relationName) {
+        return this._applyJoin(HasJoins_1.JoinType.LEFT_JOIN, relationName);
+    }
+    _applyJoin(joinType, relationName) {
+        const rel = this._entityClass.relationships[relationName];
+        if (!rel) {
+            throw new Error(`Relationship "${relationName}" is not defined on ${this._entityClass.name}`);
+        }
+        const RelatedClass = rel.related();
+        const relatedTable = RelatedClass.table;
+        if (rel.type === 'hasOne' || rel.type === 'hasMany') {
+            // local table.localKey = related table.foreignKey
+            const sourceField = `${this._entityClass.table}.${rel.localKey}`;
+            const remoteField = `${relatedTable}.${rel.foreignKey}`;
+            this._table.join(joinType, relatedTable, sourceField, remoteField);
+        }
+        else if (rel.type === 'belongsTo') {
+            // local table.foreignKey = related table.localKey
+            const sourceField = `${this._entityClass.table}.${rel.foreignKey}`;
+            const remoteField = `${relatedTable}.${rel.localKey}`;
+            this._table.join(joinType, relatedTable, sourceField, remoteField);
+        }
+        else if (rel.type === 'hasOneThrough' || rel.type === 'hasManyThrough') {
+            // local → through → related
+            const ThroughClass = rel.through();
+            const throughTable = ThroughClass.table;
+            this._table.join(joinType, throughTable, `${this._entityClass.table}.${rel.localKey}`, `${throughTable}.${rel.throughForeignKey}`);
+            this._table.join(joinType, relatedTable, `${throughTable}.${rel.throughLocalKey}`, `${relatedTable}.${rel.foreignKey}`);
+        }
+        return this;
+    }
+    // ── Terminal methods ─────────────────────────────────────────────────────────
+    async get() {
+        const rows = await this._table.get();
+        const entities = rows.map((row) => this._entityClass.fromRow(row));
+        if (this._withs.length > 0) {
+            await this._loadRelations(entities, this._withs, this._entityClass);
+        }
+        return entities;
+    }
+    async first() {
+        const row = await this._table.first();
+        if (!row) {
+            return null;
+        }
+        const entity = this._entityClass.fromRow(row);
+        if (this._withs.length > 0) {
+            await this._loadRelations([entity], this._withs, this._entityClass);
+        }
+        return entity;
+    }
+    async find(id) {
+        const row = await this._table.where(this._entityClass.primaryKey, id).first();
+        if (!row) {
+            return null;
+        }
+        const entity = this._entityClass.fromRow(row);
+        if (this._withs.length > 0) {
+            await this._loadRelations([entity], this._withs, this._entityClass);
+        }
+        return entity;
+    }
+    // ── Eager-load implementation ────────────────────────────────────────────────
+    async _loadRelations(entities, relations, ParentClass) {
+        // Group by top-level relation name; accumulate nested paths
+        const groups = new Map();
+        for (const path of relations) {
+            const dot = path.indexOf('.');
+            const head = dot === -1 ? path : path.substring(0, dot);
+            const tail = dot === -1 ? null : path.substring(dot + 1);
+            if (!groups.has(head)) {
+                groups.set(head, []);
+            }
+            if (tail) {
+                groups.get(head).push(tail);
+            }
+        }
+        for (const [head, nested] of groups) {
+            const rel = ParentClass.relationships[head];
+            if (!rel) {
+                continue;
+            }
+            const RelatedClass = rel.related();
+            let relatedItems = [];
+            if (rel.type === 'hasOne' || rel.type === 'hasMany') {
+                const keys = [...new Set(entities.map((r) => r[rel.localKey]).filter((v) => v != null))];
+                if (keys.length === 0) {
+                    continue;
+                }
+                relatedItems = await RelatedClass.whereIn(rel.foreignKey, keys).get();
+                // Build lookup: foreignKeyValue → items[]
+                const lookup = new Map();
+                relatedItems.forEach((item) => {
+                    const k = item[rel.foreignKey];
+                    if (!lookup.has(k)) {
+                        lookup.set(k, []);
+                    }
+                    lookup.get(k).push(item);
+                });
+                entities.forEach((r) => {
+                    var _a, _b;
+                    const matched = (_a = lookup.get(r[rel.localKey])) !== null && _a !== void 0 ? _a : [];
+                    r[head] = rel.type === 'hasOne' ? (_b = matched[0]) !== null && _b !== void 0 ? _b : null : matched;
+                });
+            }
+            else if (rel.type === 'belongsTo') {
+                const keys = [...new Set(entities.map((r) => r[rel.foreignKey]).filter((v) => v != null))];
+                if (keys.length === 0) {
+                    continue;
+                }
+                relatedItems = await RelatedClass.whereIn(rel.localKey, keys).get();
+                // Build lookup: localKeyValue → item
+                const lookup = new Map();
+                relatedItems.forEach((item) => lookup.set(item[rel.localKey], item));
+                entities.forEach((r) => {
+                    var _a;
+                    r[head] = (_a = lookup.get(r[rel.foreignKey])) !== null && _a !== void 0 ? _a : null;
+                });
+            }
+            else if (rel.type === 'hasOneThrough' || rel.type === 'hasManyThrough') {
+                const ThroughClass = rel.through();
+                const localKeys = [...new Set(entities.map((r) => r[rel.localKey]).filter((v) => v != null))];
+                if (localKeys.length === 0) {
+                    continue;
+                }
+                // Load through intermediates
+                const throughItems = await ThroughClass.whereIn(rel.throughForeignKey, localKeys).get();
+                const throughKeys = [
+                    ...new Set(throughItems.map((t) => t[rel.throughLocalKey]).filter((v) => v != null))
+                ];
+                if (throughKeys.length === 0) {
+                    continue;
+                }
+                // Map parent localKey → through items
+                const throughByParent = new Map();
+                throughItems.forEach((t) => {
+                    const k = t[rel.throughForeignKey];
+                    if (!throughByParent.has(k)) {
+                        throughByParent.set(k, []);
+                    }
+                    throughByParent.get(k).push(t);
+                });
+                relatedItems = await RelatedClass.whereIn(rel.foreignKey, throughKeys).get();
+                // Map through localKey → related items
+                const relatedByThrough = new Map();
+                relatedItems.forEach((item) => {
+                    const k = item[rel.foreignKey];
+                    if (!relatedByThrough.has(k)) {
+                        relatedByThrough.set(k, []);
+                    }
+                    relatedByThrough.get(k).push(item);
+                });
+                entities.forEach((r) => {
+                    var _a, _b;
+                    const throughs = (_a = throughByParent.get(r[rel.localKey])) !== null && _a !== void 0 ? _a : [];
+                    const matched = [];
+                    throughs.forEach((t) => {
+                        var _a;
+                        const items = (_a = relatedByThrough.get(t[rel.throughLocalKey])) !== null && _a !== void 0 ? _a : [];
+                        matched.push(...items);
+                    });
+                    r[head] = rel.type === 'hasOneThrough' ? (_b = matched[0]) !== null && _b !== void 0 ? _b : null : matched;
+                });
+            }
+            // Recurse for nested dot-notation paths
+            if (nested.length > 0 && relatedItems.length > 0) {
+                await this._loadRelations(relatedItems, nested, RelatedClass);
+            }
+        }
+    }
+    where(...args) {
+        ;
+        this._table.where(...args);
+        return this;
+    }
+    whereIn(field, values) {
+        this._table.whereIn(field, values);
+        return this;
+    }
+    whereNotIn(field, values) {
+        this._table.whereNotIn(field, values);
+        return this;
+    }
+    whereBetween(field, range) {
+        this._table.whereBetween(field, range);
+        return this;
+    }
+    whereNotBetween(field, range) {
+        this._table.whereNotBetween(field, range);
+        return this;
+    }
+    whereNull(field) {
+        this._table.whereNull(field);
+        return this;
+    }
+    whereNotNull(field) {
+        this._table.whereNotNull(field);
+        return this;
+    }
+    whereLike(field, pattern) {
+        this._table.whereLike(field, pattern);
+        return this;
+    }
+    whereNotLike(field, pattern) {
+        this._table.whereNotLike(field, pattern);
+        return this;
+    }
+    whereColumn(...args) {
+        ;
+        this._table.whereColumn(...args);
+        return this;
+    }
+    orWhere(...args) {
+        ;
+        this._table.orWhere(...args);
+        return this;
+    }
+    orWhereIn(field, values) {
+        this._table.orWhereIn(field, values);
+        return this;
+    }
+    orWhereNotIn(field, values) {
+        this._table.orWhereNotIn(field, values);
+        return this;
+    }
+    orWhereBetween(field, range) {
+        this._table.orWhereBetween(field, range);
+        return this;
+    }
+    orWhereNotBetween(field, range) {
+        this._table.orWhereNotBetween(field, range);
+        return this;
+    }
+    orWhereNull(field) {
+        this._table.orWhereNull(field);
+        return this;
+    }
+    orWhereNotNull(field) {
+        this._table.orWhereNotNull(field);
+        return this;
+    }
+    orWhereLike(field, pattern) {
+        this._table.orWhereLike(field, pattern);
+        return this;
+    }
+    orWhereNotLike(field, pattern) {
+        this._table.orWhereNotLike(field, pattern);
+        return this;
+    }
+    select(...fields) {
+        ;
+        this._table.select(...fields);
+        return this;
+    }
+    orderBy(field, direction) {
+        this._table.orderBy(field, direction);
+        return this;
+    }
+    groupBy(...fields) {
+        ;
+        this._table.groupBy(...fields);
+        return this;
+    }
+    limit(value) {
+        this._table.setLimit(value);
+        return this;
+    }
+    offset(value) {
+        this._table.setOffset(value);
+        return this;
+    }
+    distinct() {
+        this._table.setDistinct(true);
+        return this;
+    }
+}
+exports.EntityQuery = EntityQuery;
+//# sourceMappingURL=EntityQuery.js.map

package/dist/entities/EntityQuery.js.map

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

package/dist/entities/RelationshipType.d.ts

@@ -0,0 +1 @@
+export type RelationshipType = 'hasOne' | 'hasMany' | 'belongsTo' | 'hasOneThrough' | 'hasManyThrough';

package/dist/entities/RelationshipType.js

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

package/dist/entities/RelationshipType.js.map

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

package/dist/entities/decorators/BelongsTo.d.ts

@@ -0,0 +1,2 @@
+/** 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;

package/dist/entities/decorators/BelongsTo.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BelongsTo = BelongsTo;
+const metadata_1 = require("./metadata");
+/** 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 = (0, metadata_1.getOrCreate)(target);
+        m.relationships.push({
+            name: String(propertyKey),
+            relationship: { type: 'belongsTo', related, foreignKey, localKey }
+        });
+    };
+}
+//# sourceMappingURL=BelongsTo.js.map

package/dist/entities/decorators/BelongsTo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BelongsTo.js","sourceRoot":"","sources":["../../../src/entities/decorators/BelongsTo.ts"],"names":[],"mappings":";;AAGA,8BASC;AAZD,yCAAwC;AAExC,+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,IAAA,sBAAW,EAAC,MAAgB,CAAC,CAAA;QAEvC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC;YACnB,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC;YACzB,YAAY,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE;SACnE,CAAC,CAAA;IACJ,CAAC,CAAA;AACH,CAAC"}

package/dist/entities/decorators/Column.d.ts

@@ -0,0 +1,13 @@
+import { CastType } from '../CastType';
+export interface ColumnOptions {
+    /** Database column name. Defaults to the property name. */
+    columnName?: string;
+    /** 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;

package/dist/entities/decorators/Column.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Column = Column;
+const metadata_1 = require("./metadata");
+/** Map a class property to a database column. */
+function Column(options) {
+    return (target, propertyKey) => {
+        const m = (0, metadata_1.getOrCreate)(target);
+        m.columns.push(Object.assign({ name: String(propertyKey) }, options));
+    };
+}
+//# sourceMappingURL=Column.js.map

package/dist/entities/decorators/Column.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Column.js","sourceRoot":"","sources":["../../../src/entities/decorators/Column.ts"],"names":[],"mappings":";;AAeA,wBAMC;AApBD,yCAAwC;AAaxC,iDAAiD;AACjD,SAAgB,MAAM,CAAC,OAAuB;IAC5C,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;QAC7B,MAAM,CAAC,GAAG,IAAA,sBAAW,EAAC,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"}

package/dist/entities/decorators/Entity.d.ts

@@ -0,0 +1,20 @@
+export interface EntityOptions {
+    /** Database table name. Defaults to lowercase class name + 's'. */
+    table?: string;
+    /** Primary key column name. Defaults to 'id'. */
+    primaryKey?: string;
+    /**
+     * Registered DataSource name. When set, the entity operates on
+     * DB.source(sourceName); otherwise it operates directly on DB.
+     */
+    source?: string | null;
+}
+/**
+ * Marks a class as an Active Record entity.
+ * The class must extend BaseEntity; this decorator reads the metadata
+ * accumulated by the property decorators (@Column, @HasMany, …) and assigns
+ * it to the static fields BaseEntity expects (table, primaryKey, fields, …).
+ */
+export declare function Entity(options?: EntityOptions): <T extends {
+    new (...args: any[]): {};
+}>(EntityClass: T) => T;

package/dist/entities/decorators/Entity.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Entity = Entity;
+const metadata_1 = require("./metadata");
+/**
+ * Marks a class as an Active Record entity.
+ * The class must extend BaseEntity; this decorator reads the metadata
+ * accumulated by the property decorators (@Column, @HasMany, …) and assigns
+ * it to the static fields BaseEntity expects (table, primaryKey, fields, …).
+ */
+function Entity(options) {
+    return function (EntityClass) {
+        var _a, _b, _c, _d, _e, _f;
+        // Read metadata accumulated by property decorators on the class prototype.
+        const meta = (_a = metadata_1.registry.get(EntityClass.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 : EntityClass.name.toLowerCase() + 's';
+        const primaryKeyMeta = meta.columns.find((c) => c.primaryKey);
+        const primaryKeyCol = (_e = (_d = (primaryKeyMeta && ((_c = primaryKeyMeta.columnName) !== null && _c !== void 0 ? _c : primaryKeyMeta.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);
+        // Property name → database column name (defaults to the property name)
+        const columnsMap = {};
+        meta.columns.forEach((c) => {
+            var _a;
+            columnsMap[c.name] = (_a = c.columnName) !== null && _a !== void 0 ? _a : 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;
+        });
+        // Assign the static metadata consumed by BaseEntity / EntityQuery.
+        const cls = EntityClass;
+        cls.table = tableName;
+        cls.primaryKey = primaryKeyCol;
+        cls.fields = fieldNames;
+        cls.columnsMap = columnsMap;
+        cls.autoGeneratedFields = autoGeneratedFields;
+        cls.casts = castsMap;
+        cls.relationships = relsMap;
+        cls.source = (_f = options === null || options === void 0 ? void 0 : options.source) !== null && _f !== void 0 ? _f : null;
+        return EntityClass;
+    };
+}
+//# sourceMappingURL=Entity.js.map

package/dist/entities/decorators/Entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Entity.js","sourceRoot":"","sources":["../../../src/entities/decorators/Entity.ts"],"names":[],"mappings":";;AAsBA,wBA2CC;AA/DD,yCAAqC;AAcrC;;;;;GAKG;AACH,SAAgB,MAAM,CAAC,OAAuB;IAC5C,OAAO,UAAkD,WAAc;;QACrE,2EAA2E;QAC3E,MAAM,IAAI,GAAG,MAAA,mBAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,SAAS,CAAC,mCAAI,EAAE,OAAO,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,CAAA;QACtF,MAAM,SAAS,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,mCAAI,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,GAAG,CAAA;QACxE,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;QAC7D,MAAM,aAAa,GACjB,MAAA,MAAA,CAAC,cAAc,IAAI,CAAC,MAAA,cAAc,CAAC,UAAU,mCAAI,cAAc,CAAC,IAAI,CAAC,CAAC,mCAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,UAAU,mCAAI,IAAI,CAAA;QACvG,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QAClD,uEAAuE;QACvE,MAAM,UAAU,GAA2B,EAAE,CAAA;QAE7C,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;;YACzB,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,MAAA,CAAC,CAAC,UAAU,mCAAI,CAAC,CAAC,IAAI,CAAA;QAC7C,CAAC,CAAC,CAAA;QACF,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,CAAC;gBACX,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAA;YAC3B,CAAC;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;QAEF,mEAAmE;QACnE,MAAM,GAAG,GAAG,WAAkB,CAAA;QAE9B,GAAG,CAAC,KAAK,GAAG,SAAS,CAAA;QACrB,GAAG,CAAC,UAAU,GAAG,aAAa,CAAA;QAC9B,GAAG,CAAC,MAAM,GAAG,UAAU,CAAA;QACvB,GAAG,CAAC,UAAU,GAAG,UAAU,CAAA;QAC3B,GAAG,CAAC,mBAAmB,GAAG,mBAAmB,CAAA;QAC7C,GAAG,CAAC,KAAK,GAAG,QAAQ,CAAA;QACpB,GAAG,CAAC,aAAa,GAAG,OAAO,CAAA;QAC3B,GAAG,CAAC,MAAM,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM,mCAAI,IAAI,CAAA;QAEpC,OAAO,WAAW,CAAA;IACpB,CAAC,CAAA;AACH,CAAC"}

package/dist/entities/decorators/HasMany.d.ts

@@ -0,0 +1,2 @@
+/** 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;

package/dist/entities/decorators/HasMany.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HasMany = HasMany;
+const metadata_1 = require("./metadata");
+/** 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 = (0, metadata_1.getOrCreate)(target);
+        m.relationships.push({
+            name: String(propertyKey),
+            relationship: { type: 'hasMany', related, foreignKey, localKey }
+        });
+    };
+}
+//# sourceMappingURL=HasMany.js.map

package/dist/entities/decorators/HasMany.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HasMany.js","sourceRoot":"","sources":["../../../src/entities/decorators/HasMany.ts"],"names":[],"mappings":";;AAGA,0BASC;AAZD,yCAAwC;AAExC,wFAAwF;AACxF,SAAgB,OAAO,CAAC,OAAkB,EAAE,UAAkB,EAAE,QAAQ,GAAG,IAAI;IAC7E,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;QAC7B,MAAM,CAAC,GAAG,IAAA,sBAAW,EAAC,MAAgB,CAAC,CAAA;QAEvC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC;YACnB,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC;YACzB,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE;SACjE,CAAC,CAAA;IACJ,CAAC,CAAA;AACH,CAAC"}

package/dist/entities/decorators/HasManyThrough.d.ts

@@ -0,0 +1,2 @@
+/** Has-many through an intermediate model. */
+export declare function HasManyThrough(related: () => any, through: () => any, foreignKey: string, throughForeignKey: string, localKey?: string, throughLocalKey?: string): PropertyDecorator;

package/dist/entities/decorators/HasManyThrough.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HasManyThrough = HasManyThrough;
+const metadata_1 = require("./metadata");
+/** Has-many through an intermediate model. */
+function HasManyThrough(related, through, foreignKey, throughForeignKey, localKey = 'id', throughLocalKey = 'id') {
+    return (target, propertyKey) => {
+        const m = (0, metadata_1.getOrCreate)(target);
+        m.relationships.push({
+            name: String(propertyKey),
+            relationship: {
+                type: 'hasManyThrough',
+                related,
+                through,
+                foreignKey,
+                throughForeignKey,
+                localKey,
+                throughLocalKey
+            }
+        });
+    };
+}
+//# sourceMappingURL=HasManyThrough.js.map

package/dist/entities/decorators/HasManyThrough.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HasManyThrough.js","sourceRoot":"","sources":["../../../src/entities/decorators/HasManyThrough.ts"],"names":[],"mappings":";;AAGA,wCAwBC;AA3BD,yCAAwC;AAExC,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,IAAA,sBAAW,EAAC,MAAgB,CAAC,CAAA;QAEvC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC;YACnB,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC;YACzB,YAAY,EAAE;gBACZ,IAAI,EAAE,gBAAgB;gBACtB,OAAO;gBACP,OAAO;gBACP,UAAU;gBACV,iBAAiB;gBACjB,QAAQ;gBACR,eAAe;aAChB;SACF,CAAC,CAAA;IACJ,CAAC,CAAA;AACH,CAAC"}

package/dist/entities/decorators/HasOne.d.ts

@@ -0,0 +1,2 @@
+/** 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;

package/dist/entities/decorators/HasOne.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HasOne = HasOne;
+const metadata_1 = require("./metadata");
+/** 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 = (0, metadata_1.getOrCreate)(target);
+        m.relationships.push({ name: String(propertyKey), relationship: { type: 'hasOne', related, foreignKey, localKey } });
+    };
+}
+//# sourceMappingURL=HasOne.js.map

package/dist/entities/decorators/HasOne.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HasOne.js","sourceRoot":"","sources":["../../../src/entities/decorators/HasOne.ts"],"names":[],"mappings":";;AAGA,wBAMC;AATD,yCAAwC;AAExC,uFAAuF;AACvF,SAAgB,MAAM,CAAC,OAAkB,EAAE,UAAkB,EAAE,QAAQ,GAAG,IAAI;IAC5E,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;QAC7B,MAAM,CAAC,GAAG,IAAA,sBAAW,EAAC,MAAgB,CAAC,CAAA;QAEvC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAA;IACtH,CAAC,CAAA;AACH,CAAC"}

package/dist/entities/decorators/HasOneThrough.d.ts

@@ -0,0 +1,2 @@
+/** Has-one through an intermediate model. */
+export declare function HasOneThrough(related: () => any, through: () => any, foreignKey: string, throughForeignKey: string, localKey?: string, throughLocalKey?: string): PropertyDecorator;

package/dist/entities/decorators/HasOneThrough.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HasOneThrough = HasOneThrough;
+const metadata_1 = require("./metadata");
+/** Has-one through an intermediate model. */
+function HasOneThrough(related, through, foreignKey, throughForeignKey, localKey = 'id', throughLocalKey = 'id') {
+    return (target, propertyKey) => {
+        const m = (0, metadata_1.getOrCreate)(target);
+        m.relationships.push({
+            name: String(propertyKey),
+            relationship: {
+                type: 'hasOneThrough',
+                related,
+                through,
+                foreignKey,
+                throughForeignKey,
+                localKey,
+                throughLocalKey
+            }
+        });
+    };
+}
+//# sourceMappingURL=HasOneThrough.js.map

package/dist/entities/decorators/HasOneThrough.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HasOneThrough.js","sourceRoot":"","sources":["../../../src/entities/decorators/HasOneThrough.ts"],"names":[],"mappings":";;AAGA,sCAwBC;AA3BD,yCAAwC;AAExC,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,IAAA,sBAAW,EAAC,MAAgB,CAAC,CAAA;QAEvC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC;YACnB,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC;YACzB,YAAY,EAAE;gBACZ,IAAI,EAAE,eAAe;gBACrB,OAAO;gBACP,OAAO;gBACP,UAAU;gBACV,iBAAiB;gBACjB,QAAQ;gBACR,eAAe;aAChB;SACF,CAAC,CAAA;IACJ,CAAC,CAAA;AACH,CAAC"}

package/dist/entities/decorators/casts.d.ts

@@ -0,0 +1,3 @@
+import { CastType } from '../CastType';
+export declare function applyCast(value: any, type: CastType): any;
+export declare function applyCastForStorage(value: any, type: CastType): any;

package/dist/entities/decorators/casts.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyCast = applyCast;
+exports.applyCastForStorage = applyCastForStorage;
+// ── 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;
+    }
+}
+//# sourceMappingURL=casts.js.map

package/dist/entities/decorators/casts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"casts.js","sourceRoot":"","sources":["../../../src/entities/decorators/casts.ts"],"names":[],"mappings":";;AAIA,8BAiBC;AAED,kDAeC;AApCD,iFAAiF;AAEjF,SAAgB,SAAS,CAAC,KAAU,EAAE,IAAc;IAClD,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,QAAQ,IAAI,EAAE,CAAC;QACb,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;IAC1D,CAAC;AACH,CAAC;AAED,SAAgB,mBAAmB,CAAC,KAAU,EAAE,IAAc;IAC5D,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,QAAQ,IAAI,EAAE,CAAC;QACb,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;IAChB,CAAC;AACH,CAAC"}

package/dist/entities/decorators/index.d.ts

@@ -0,0 +1,7 @@
+export * from './BelongsTo';
+export * from './Column';
+export * from './Entity';
+export * from './HasMany';
+export * from './HasManyThrough';
+export * from './HasOne';
+export * from './HasOneThrough';