@alpha.consultings/eloquent-orm.js 1.0.1

package/dist/core/orm/mixins/MorphableMixin.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Base interface for all morphable ORM models.
+ */
+export interface MorphableBaseModel {
+    find?(id: number | string): Promise<MorphableBaseModel | null>;
+    query?(): ORMQuery<this>;
+}
+/**
+ * Type for ORM-like query builders.
+ */
+export interface ORMQuery<T> {
+    where(field: string, value: unknown): ORMQuery<T>;
+    first(): Promise<T | null>;
+    get(): Promise<T[]>;
+}
+/** Generic constructor helper for mixins. */
+type Constructor<T = object> = abstract new (...args: any[]) => T;
+/**
+ * MorphableMixin
+ * Adds polymorphic relationship helpers:
+ * - morphTo()
+ * - morphOne()
+ * - morphMany()
+ *
+ * Auto-registers every extended model into MorphRegistry.
+ */
+export declare function MorphableMixin<TBase extends Constructor>(Base: TBase): Constructor<MorphableBaseModel> & TBase;
+export {};
+//# sourceMappingURL=MorphableMixin.d.ts.map

package/dist/core/orm/mixins/MorphableMixin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MorphableMixin.d.ts","sourceRoot":"","sources":["../../../../src/core/orm/mixins/MorphableMixin.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IAC/D,KAAK,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAClD,KAAK,IAAI,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3B,GAAG,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;CACrB;AAqCD,6CAA6C;AAC7C,KAAK,WAAW,CAAC,CAAC,GAAG,MAAM,IAAI,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAElE;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,SAAS,WAAW,EAAE,IAAI,EAAE,KAAK,GAuEpC,WAAW,CAAC,kBAAkB,CAAC,GAAG,KAAK,CACvE"}

package/dist/core/orm/mixins/MorphableMixin.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MorphableMixin = MorphableMixin;
+// src/core/orm/mixins/MorphableMixin.ts
+const MorphRegistry_1 = require("./MorphRegistry");
+function assertSafeRelationName(relationName) {
+    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(relationName)) {
+        throw new Error(`Unsafe relation name: ${relationName}`);
+    }
+}
+function resolveQueryable(RelatedModel) {
+    if (typeof RelatedModel.query === "function") {
+        return RelatedModel.query();
+    }
+    if (typeof RelatedModel.where === "function") {
+        let current = null;
+        return {
+            where(field, value) {
+                current = current ? current.where(field, value) : RelatedModel.where(field, value);
+                return this;
+            },
+            async first() {
+                return current.first();
+            },
+            async get() {
+                return current.get();
+            },
+        };
+    }
+    throw new Error(`ERROR: Model '${RelatedModel.name || "AnonymousModel"}' does not implement query()/where().`);
+}
+/**
+ * MorphableMixin
+ * Adds polymorphic relationship helpers:
+ * - morphTo()
+ * - morphOne()
+ * - morphMany()
+ *
+ * Auto-registers every extended model into MorphRegistry.
+ */
+function MorphableMixin(Base) {
+    class Morphable extends Base {
+        constructor(...args) {
+            super(...args);
+            // Auto-register this class in MorphRegistry once per subclass.
+            const ctor = this.constructor;
+            const alias = ctor.morphAlias || ctor.name;
+            if (!MorphRegistry_1.MorphRegistry.has(alias)) {
+                MorphRegistry_1.MorphRegistry.register(alias, ctor);
+            }
+        }
+        /** morphTo('commentable') */
+        async morphTo(relationName) {
+            assertSafeRelationName(relationName);
+            const record = this;
+            const type = record[`${relationName}_type`];
+            const id = record[`${relationName}_id`];
+            if (!type || id === undefined)
+                return null;
+            const ModelClass = MorphRegistry_1.MorphRegistry.resolve(type);
+            if (typeof ModelClass.prototype.find !== "function") {
+                throw new Error(`ERROR: Model '${type}' does not implement find().`);
+            }
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-call
+            const findFn = ModelClass.prototype.find;
+            return await findFn.call(new ModelClass(), id);
+        }
+        /** morphOne(RelatedModel, 'commentable') */
+        async morphOne(RelatedModel, relationName) {
+            assertSafeRelationName(relationName);
+            const self = this;
+            const modelName = typeof self.getMorphClass === "function" ? self.getMorphClass() : this.constructor.name;
+            const modelId = this.id;
+            return await resolveQueryable(RelatedModel)
+                .where(`${relationName}_type`, modelName)
+                .where(`${relationName}_id`, modelId)
+                .first();
+        }
+        /** morphMany(RelatedModel, 'commentable') */
+        async morphMany(RelatedModel, relationName) {
+            assertSafeRelationName(relationName);
+            const self = this;
+            const modelName = typeof self.getMorphClass === "function" ? self.getMorphClass() : this.constructor.name;
+            const modelId = this.id;
+            return await resolveQueryable(RelatedModel)
+                .where(`${relationName}_type`, modelName)
+                .where(`${relationName}_id`, modelId)
+                .get();
+        }
+    }
+    return Morphable;
+}
+//# sourceMappingURL=MorphableMixin.js.map

package/dist/core/orm/mixins/MorphableMixin.js.map

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

package/dist/core/orm/mixins/PivotHelperMixin.d.ts

@@ -0,0 +1,26 @@
+/**
+ * ًں”— PivotHelperMixin
+ * Adds helpers for managing many-to-many pivot tables (attach, detach, sync)
+ * ✅ Type-safe, constructor-compliant, and works with SQL & Mongo drivers
+ */
+export interface DatabaseConnection {
+    collection?(name: string): {
+        insertMany(docs: Record<string, unknown>[]): Promise<void>;
+        deleteMany(filter: Record<string, unknown>): Promise<void>;
+    };
+}
+export interface PivotCapableModel {
+    tableName: string;
+    connectionName: string;
+    getDB(): Promise<unknown>;
+}
+/** Constructor helper */
+type Constructor<T = object> = abstract new (...args: any[]) => T;
+/**
+ * ✅ Updated PivotHelperMixin
+ * - Adds a type stub for getDB() so TS is satisfied
+ * - Properly casts dynamic `this` when accessing DB
+ */
+export declare function PivotHelperMixin<TBase extends Constructor>(Base: TBase): TBase & (abstract new (...args: any[]) => PivotCapableModel);
+export {};
+//# sourceMappingURL=PivotHelperMixin.d.ts.map

package/dist/core/orm/mixins/PivotHelperMixin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PivotHelperMixin.d.ts","sourceRoot":"","sources":["../../../../src/core/orm/mixins/PivotHelperMixin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG;QACzB,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3D,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC5D,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3B;AAED,yBAAyB;AACzB,KAAK,WAAW,CAAC,CAAC,GAAG,MAAM,IAAI,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAElE;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,SAAS,WAAW,EAAE,IAAI,EAAE,KAAK,GAwHpC,KAAK,GAAG,CAAC,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,iBAAiB,CAAC,CAC9F"}

package/dist/core/orm/mixins/PivotHelperMixin.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * ًں”— PivotHelperMixin
+ * Adds helpers for managing many-to-many pivot tables (attach, detach, sync)
+ * ✅ Type-safe, constructor-compliant, and works with SQL & Mongo drivers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PivotHelperMixin = PivotHelperMixin;
+const database_1 = require("../../../config/database");
+/**
+ * ✅ Updated PivotHelperMixin
+ * - Adds a type stub for getDB() so TS is satisfied
+ * - Properly casts dynamic `this` when accessing DB
+ */
+function PivotHelperMixin(Base) {
+    class PivotHelper extends Base {
+        constructor(...args) {
+            super(...args);
+        }
+        /**
+         * â‍• Attach related records to a pivot table
+         */
+        async attach(pivotTable, foreignKey, relatedKey, id, relatedIds) {
+            const db = await this.getDB();
+            const rows = relatedIds.map((rid) => ({ [foreignKey]: id, [relatedKey]: rid }));
+            if (rows.length === 0)
+                return;
+            const conn = this.connectionName;
+            const key = conn;
+            const driver = database_1.dbConfig.connections[key]?.driver ?? conn;
+            switch (driver) {
+                case "sqlite":
+                case "mysql":
+                case "pg": {
+                    const adapter = db;
+                    const keys = Object.keys(rows[0]);
+                    const table = adapter.wrapId(pivotTable);
+                    const columns = keys.map((key) => adapter.wrapId(key)).join(", ");
+                    const sql = `INSERT INTO ${table} (${columns}) VALUES (${adapter.placeholders(keys.length)})`;
+                    for (const row of rows) {
+                        const values = keys.map((key) => row[key]);
+                        await adapter.execute(sql, values);
+                    }
+                    break;
+                }
+                case "mongo": {
+                    const mongo = db;
+                    if (typeof mongo.collection !== "function") {
+                        throw new Error("â‌Œ MongoDB driver not available for pivot operations.");
+                    }
+                    await mongo.collection(pivotTable).insertMany(rows);
+                    break;
+                }
+                default:
+                    throw new Error(`â‌Œ Unsupported connection type: ${driver}`);
+            }
+        }
+        /**
+         * â‍– Detach related records from a pivot table
+         */
+        async detach(pivotTable, foreignKey, id) {
+            const db = await this.getDB();
+            const conn = this.connectionName;
+            const key = conn;
+            const driver = database_1.dbConfig.connections[key]?.driver ?? conn;
+            switch (driver) {
+                case "sqlite":
+                case "mysql":
+                case "pg": {
+                    const adapter = db;
+                    const table = adapter.wrapId(pivotTable);
+                    const fk = adapter.wrapId(foreignKey);
+                    const sql = `DELETE FROM ${table} WHERE ${fk} = ${adapter.placeholder(1)}`;
+                    await adapter.execute(sql, [id]);
+                    break;
+                }
+                case "mongo": {
+                    const mongo = db;
+                    if (typeof mongo.collection !== "function") {
+                        throw new Error("â‌Œ MongoDB driver not available for pivot operations.");
+                    }
+                    await mongo.collection(pivotTable).deleteMany({ [foreignKey]: id });
+                    break;
+                }
+                default:
+                    throw new Error(`â‌Œ Unsupported connection type: ${driver}`);
+            }
+        }
+        /**
+         * ًں”„ Sync related records — clears old ones and attaches the new set
+         */
+        async sync(pivotTable, foreignKey, relatedKey, id, relatedIds) {
+            await this.detach(pivotTable, foreignKey, id);
+            if (relatedIds.length > 0) {
+                await this.attach(pivotTable, foreignKey, relatedKey, id, relatedIds);
+            }
+        }
+    }
+    // ًں‘‡ Important: cast ensures TS knows result = Base + PivotCapableModel
+    return PivotHelper;
+}
+//# sourceMappingURL=PivotHelperMixin.js.map

package/dist/core/orm/mixins/PivotHelperMixin.js.map

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

package/dist/core/orm/mixins/QueryCacheMixin.d.ts

@@ -0,0 +1,23 @@
+export type CacheOptions = {
+    enabled: boolean;
+    ttl: number;
+};
+export interface CacheInterface {
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T, ttl?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    clear(): Promise<void>;
+}
+export interface CacheableModel {
+    invalidateModelCache(): Promise<void>;
+    invalidateCacheGroup(group: string): Promise<void>;
+}
+export interface CacheableConstructor {
+    defaultCacheTTL?: number;
+    cacheTTL?: Record<string, number>;
+    cacheStrategy?: (payload: unknown, group?: string) => number;
+}
+type Constructor<T = object> = abstract new (...args: any[]) => T;
+export declare function QueryCacheMixin<TBase extends Constructor>(Base: TBase): TBase & (abstract new (...args: any[]) => CacheableModel) & CacheableConstructor;
+export {};
+//# sourceMappingURL=QueryCacheMixin.d.ts.map

package/dist/core/orm/mixins/QueryCacheMixin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryCacheMixin.d.ts","sourceRoot":"","sources":["../../../../src/core/orm/mixins/QueryCacheMixin.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,YAAY,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACvC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,oBAAoB;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CAC9D;AAED,KAAK,WAAW,CAAC,CAAC,GAAG,MAAM,IAAI,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAIlE,wBAAgB,eAAe,CAAC,KAAK,SAAS,WAAW,EAAE,IAAI,EAAE,KAAK,GAwJnC,KAAK,GACpC,CAAC,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,cAAc,CAAC,GACjD,oBAAoB,CACvB"}

package/dist/core/orm/mixins/QueryCacheMixin.js

@@ -0,0 +1,172 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueryCacheMixin = QueryCacheMixin;
+const crypto = __importStar(require("crypto"));
+const CacheManager_1 = require("../../cache/CacheManager");
+const CacheRegistry_1 = require("../../cache/CacheRegistry");
+const CacheFallbackManager_1 = require("../../cache/CacheFallbackManager");
+const CacheAnalytics_1 = require("../../cache/CacheAnalytics");
+const HookStore_1 = require("./utils/HookStore");
+const ModelRegistry_1 = require("./utils/ModelRegistry");
+const CACHE_INVALIDATION_EVENTS = ["created", "updated", "deleted"];
+function QueryCacheMixin(Base) {
+    const cacheHooksRegistered = new WeakSet();
+    class CachedModel extends Base {
+        constructor(...args) {
+            super(...args);
+            this.__cache = { enabled: false, ttl: 60 };
+            try {
+                this.ensureCacheInvalidationHooks();
+            }
+            catch (err) {
+                console.warn("[QueryCacheMixin] Failed to register cache invalidation hooks:", err);
+            }
+        }
+        ensureCacheInvalidationHooks() {
+            const modelCtor = this.constructor;
+            if (!ModelRegistry_1.ModelRegistry.isGranted(modelCtor) && ModelRegistry_1.ModelRegistry.isStrictMode()) {
+                return;
+            }
+            if (cacheHooksRegistered.has(modelCtor)) {
+                return;
+            }
+            const modelName = this.constructor.name || "Model";
+            const clearModelCache = async () => {
+                await CacheRegistry_1.CacheRegistry.clearModel(modelName);
+            };
+            for (const event of CACHE_INVALIDATION_EVENTS) {
+                HookStore_1.HookStore.add(modelCtor, event, clearModelCache);
+            }
+            cacheHooksRegistered.add(modelCtor);
+        }
+        cache(ttl = 60) {
+            this.__cache = { enabled: true, ttl };
+            return this;
+        }
+        withoutCache() {
+            this.__cache = { enabled: false, ttl: 0 };
+            return this;
+        }
+        generateCacheKey(payload) {
+            const normalized = JSON.stringify(payload, (_key, value) => {
+                if (value instanceof Date)
+                    return value.toISOString();
+                if (typeof value === "function")
+                    return undefined;
+                return value;
+            });
+            return crypto.createHash("sha256").update(normalized).digest("hex");
+        }
+        get cacheAPI() {
+            try {
+                const fallbackActive = typeof CacheFallbackManager_1.CacheFallbackManager?.getActiveDriver === "function" &&
+                    CacheFallbackManager_1.CacheFallbackManager.getActiveDriver();
+                return fallbackActive
+                    ? CacheFallbackManager_1.CacheFallbackManager
+                    : CacheManager_1.CacheManager;
+            }
+            catch {
+                return CacheManager_1.CacheManager;
+            }
+        }
+        resolveTTL(payload, group) {
+            const cls = this.constructor;
+            if (this.__cache.enabled && this.__cache.ttl > 0)
+                return this.__cache.ttl;
+            if (typeof cls.cacheStrategy === "function") {
+                try {
+                    const dynamic = cls.cacheStrategy(payload, group);
+                    if (typeof dynamic === "number" && dynamic >= 0)
+                        return dynamic;
+                }
+                catch (err) {
+                    console.warn("[QueryCacheMixin] cacheStrategy() failed:", err);
+                }
+            }
+            if (cls.cacheTTL && typeof cls.cacheTTL[group] === "number")
+                return cls.cacheTTL[group];
+            if (typeof cls.defaultCacheTTL === "number")
+                return cls.defaultCacheTTL;
+            return 60;
+        }
+        async runWithCache(payload, executeFn, group = "default") {
+            const cls = this.constructor;
+            const hasModelDefaults = typeof cls.defaultCacheTTL === "number" ||
+                typeof cls.cacheStrategy === "function" ||
+                (cls.cacheTTL && Object.keys(cls.cacheTTL).length > 0);
+            if (!this.__cache.enabled && !hasModelDefaults)
+                return executeFn();
+            const modelName = cls.name || this.constructor?.name || "Model";
+            const hashKey = this.generateCacheKey(payload);
+            const key = `${modelName}:${group}:${hashKey}`;
+            const ttl = this.resolveTTL(payload, group);
+            try {
+                const cached = await this.cacheAPI.get(key);
+                if (cached !== null && typeof cached !== "undefined") {
+                    try {
+                        CacheAnalytics_1.CacheAnalytics.hit(modelName, ttl);
+                    }
+                    catch { }
+                    return cached;
+                }
+                CacheAnalytics_1.CacheAnalytics.miss(modelName, ttl);
+            }
+            catch (err) {
+                console.warn(`[Cache] Read failed for ${key}:`, err);
+                CacheAnalytics_1.CacheAnalytics.miss(modelName, ttl);
+            }
+            const result = await executeFn();
+            try {
+                await this.cacheAPI.set(key, result, ttl);
+                await CacheRegistry_1.CacheRegistry.addKey(modelName, group, key);
+            }
+            catch (err) {
+                console.warn(`[Cache] Write failed for ${key}:`, err);
+            }
+            return result;
+        }
+        async invalidateModelCache() {
+            const modelName = this.constructor.name || "Model";
+            await CacheRegistry_1.CacheRegistry.clearModel(modelName);
+        }
+        async invalidateCacheGroup(group) {
+            const modelName = this.constructor.name || "Model";
+            await CacheRegistry_1.CacheRegistry.clearGroup(modelName, group);
+        }
+    }
+    return CachedModel;
+}
+//# sourceMappingURL=QueryCacheMixin.js.map

package/dist/core/orm/mixins/QueryCacheMixin.js.map

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

package/dist/core/orm/mixins/ScopeMixin.d.ts

@@ -0,0 +1,20 @@
+/**
+ * ًںŒچ ScopeMixin
+ * Adds support for global model scopes (auto-filters)
+ * ✅ Type-safe, chain-compatible, and compliant with all previous mixins
+ */
+export interface ScopableModel<TRecord extends Record<string, unknown> = Record<string, unknown>> {
+    all(): Promise<TRecord[]>;
+    find(id: number | string, pk?: string): Promise<TRecord | null>;
+}
+/**
+ * ًں§© A single global scope callback
+ */
+export type ScopeCallback<TRecord> = (records: TRecord[]) => TRecord[] | void;
+/**
+ * ًں§  Constructor helper for mixins
+ */
+type Constructor<T = object> = abstract new (...args: any[]) => T;
+export declare function ScopeMixin<TBase extends Constructor, TRecord extends Record<string, unknown> = Record<string, unknown>>(Base: TBase): TBase & (abstract new (...args: any[]) => ScopableModel<TRecord>);
+export {};
+//# sourceMappingURL=ScopeMixin.d.ts.map

package/dist/core/orm/mixins/ScopeMixin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScopeMixin.d.ts","sourceRoot":"","sources":["../../../../src/core/orm/mixins/ScopeMixin.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,MAAM,WAAW,aAAa,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC9F,GAAG,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1B,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,GAAG,IAAI,CAAC;AAE9E;;GAEG;AACH,KAAK,WAAW,CAAC,CAAC,GAAG,MAAM,IAAI,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAElE,wBAAgB,UAAU,CACxB,KAAK,SAAS,WAAW,EACzB,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,IAAI,EAAE,KAAK,GAmFsB,KAAK,GAAG,CAAC,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,aAAa,CAAC,OAAO,CAAC,CAAC,CACnG"}

package/dist/core/orm/mixins/ScopeMixin.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScopeMixin = ScopeMixin;
+const BaseMethodResolver_1 = require("./utils/BaseMethodResolver");
+function ScopeMixin(Base) {
+    const resolveBaseMethod = (0, BaseMethodResolver_1.createBaseMethodResolver)(Base);
+    class ScopedModel extends Base {
+        constructor(...args) {
+            super(...args);
+        }
+        /**
+         * â‍• Add a global scope to the model.
+         * Example:
+         *   User.addGlobalScope("active", records => records.filter(r => r.active))
+         */
+        static addGlobalScope(name, callback) {
+            this.globalScopes[name] = callback;
+        }
+        /**
+         * ًںڑ« Remove a global scope by name.
+         */
+        static removeGlobalScope(name) {
+            delete this.globalScopes[name];
+        }
+        /**
+         * ًں§  Apply all global scopes to a result set.
+         */
+        applyScopes(records) {
+            const cls = this.constructor;
+            const scopes = cls.globalScopes;
+            let filtered = records;
+            for (const scopeFn of Object.values(scopes)) {
+                if (typeof scopeFn === "function") {
+                    const res = scopeFn(filtered);
+                    if (Array.isArray(res))
+                        filtered = res;
+                }
+            }
+            return filtered;
+        }
+        /**
+         * ًں“‹ Override all() to apply global scopes automatically.
+         */
+        async all() {
+            const baseAll = resolveBaseMethod(this, "all");
+            if (typeof baseAll !== "function") {
+                throw new Error("Base 'all' method not found in ScopeMixin chain.");
+            }
+            const records = await baseAll();
+            return this.applyScopes(records);
+        }
+        /**
+         * ًں”چ Override find() to apply scopes to single record results.
+         */
+        async find(id, pk = "id") {
+            const baseFind = resolveBaseMethod(this, "find");
+            if (typeof baseFind !== "function") {
+                throw new Error("Base 'find' method not found in ScopeMixin chain.");
+            }
+            const record = await baseFind(id, pk);
+            if (!record)
+                return null;
+            const filtered = this.applyScopes([record]);
+            return filtered.length > 0 ? filtered[0] : null;
+        }
+    }
+    /** ًں§± Static global scope registry */
+    ScopedModel.globalScopes = {};
+    // ✅ Return merged type for correct inference
+    return ScopedModel;
+}
+//# sourceMappingURL=ScopeMixin.js.map

package/dist/core/orm/mixins/ScopeMixin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScopeMixin.js","sourceRoot":"","sources":["../../../../src/core/orm/mixins/ScopeMixin.ts"],"names":[],"mappings":";;AAuBA,gCAuFC;AA9GD,mEAAsE;AAuBtE,SAAgB,UAAU,CAGxB,IAAW;IACX,MAAM,iBAAiB,GAAG,IAAA,6CAAwB,EAAC,IAAI,CAAC,CAAC;IAEzD,MAAe,WAAY,SAAQ,IAAI;QAIrC,YAAY,GAAG,IAAW;YACxB,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QACjB,CAAC;QAED;;;;WAIG;QACH,MAAM,CAAC,cAAc,CAEnB,IAAY,EACZ,QAA6B;YAE7B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC;QACrC,CAAC;QAED;;WAEG;QACH,MAAM,CAAC,iBAAiB,CAEtB,IAAY;YAEZ,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QAED;;WAEG;QACO,WAAW,CAAC,OAAkB;YACtC,MAAM,GAAG,GAAG,IAAI,CAAC,WAAiC,CAAC;YACnD,MAAM,MAAM,GAAG,GAAG,CAAC,YAAsD,CAAC;YAC1E,IAAI,QAAQ,GAAG,OAAO,CAAC;YAEvB,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5C,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;oBAClC,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;oBAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;wBAAE,QAAQ,GAAG,GAAG,CAAC;gBACzC,CAAC;YACH,CAAC;YAED,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED;;WAEG;QACH,KAAK,CAAC,GAAG;YACP,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC/C,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;YACtE,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,OAAO,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,WAAW,CAAC,OAAoB,CAAC,CAAC;QAChD,CAAC;QAED;;WAEG;QACH,KAAK,CAAC,IAAI,CAAC,EAAmB,EAAE,KAAa,IAAI;YAC/C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACjD,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;YACvE,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YACtC,IAAI,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAC;YAEzB,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,MAAiB,CAAC,CAAC,CAAC;YACvD,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAClD,CAAC;;IA3ED,wCAAwC;IACjC,wBAAY,GAAuC,EAAE,CAAC;IA6E/D,+CAA+C;IAC/C,OAAO,WAA2F,CAAC;AACrG,CAAC"}

package/dist/core/orm/mixins/SerializeMixin.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 🧩 SerializeMixin
+ * Adds toJSON() and toObject() serialization logic.
+ * ✅ Type-safe, mixin-compliant, and compatible with nested models and arrays.
+ */
+export interface SerializableModel {
+    all(): Promise<unknown[]>;
+    find(id: number | string, pk?: string): Promise<unknown | null>;
+    toObject?(): Record<string, unknown>;
+    toJSON?(): string;
+}
+/** Generic abstract constructor used by all mixins */
+type Constructor<T = object> = abstract new (...args: any[]) => T;
+export declare function SerializeMixin<TBase extends Constructor<SerializableModel>>(Base: TBase): (abstract new (...args: any[]) => {
+    /**
+     * 🕵️‍♂️ Attributes to hide during serialization
+     * Example: ['password', 'api_token']
+     */
+    hidden: string[];
+    /**
+     * 🌟 Computed attributes to append to output
+     * Example: ['full_name', 'profile_url']
+     */
+    appends: string[];
+    /**
+     * 🚀 Convert model instance into a plain JS object
+     * - Removes hidden/private fields
+     * - Appends computed attributes
+     * - Recursively serializes nested models/arrays
+     */
+    toObject(): Record<string, unknown>;
+    /**
+     * 🧠 Convert model to JSON string
+     */
+    toJSON(): string;
+    /**
+     * ♻️ Recursively serialize nested models, arrays, or plain objects
+     */
+    serializeValue(value: unknown): unknown;
+    all(): Promise<unknown[]>;
+    find(id: number | string, pk?: string): Promise<unknown | null>;
+}) & TBase;
+export {};
+//# sourceMappingURL=SerializeMixin.d.ts.map

package/dist/core/orm/mixins/SerializeMixin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SerializeMixin.d.ts","sourceRoot":"","sources":["../../../../src/core/orm/mixins/SerializeMixin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,iBAAiB;IAChC,GAAG,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1B,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAChE,QAAQ,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,MAAM,CAAC,IAAI,MAAM,CAAC;CACnB;AAED,sDAAsD;AACtD,KAAK,WAAW,CAAC,CAAC,GAAG,MAAM,IAAI,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAGlE,wBAAgB,cAAc,CAAC,KAAK,SAAS,WAAW,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,KAAK,2BAc/D,GAAG,EAAE;IAZ1B;;;OAGG;YACY,MAAM,EAAE;IAEvB;;;OAGG;aACa,MAAM,EAAE;IAMxB;;;;;OAKG;gBACS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAuBnC;;OAEG;cACO,MAAM;IAIhB;;OAEG;0BAC0B,OAAO,GAAG,OAAO;WAnEzC,OAAO,CAAC,OAAO,EAAE,CAAC;aAChB,MAAM,GAAG,MAAM,OAAO,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;WAyFhE"}