@alpha.consultings/eloquent-orm.js 1.0.1

package/dist/config/dbRoleEnv.js

@@ -0,0 +1,171 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveDbExecutionRole = resolveDbExecutionRole;
+exports.resolveMysqlEnv = resolveMysqlEnv;
+exports.resolvePgEnv = resolvePgEnv;
+exports.resolveSqlitePath = resolveSqlitePath;
+exports.resolveMongoEnv = resolveMongoEnv;
+function pickFirstDefined(env, keys, fallback) {
+    for (const key of keys) {
+        const value = env[key];
+        if (value !== undefined && value !== "") {
+            return value;
+        }
+    }
+    return fallback;
+}
+function pickFirstNumber(env, keys, fallback) {
+    const raw = pickFirstDefined(env, keys, String(fallback));
+    const parsed = Number(raw);
+    return Number.isFinite(parsed) ? parsed : fallback;
+}
+function pickFirstList(env, keys) {
+    const raw = pickFirstDefined(env, keys, "");
+    if (!raw)
+        return [];
+    return raw
+        .split(",")
+        .map((value) => value.trim())
+        .filter((value) => value.length > 0);
+}
+function resolveDbExecutionRole(env = process.env) {
+    const value = String(env.ELOQUENT_DB_ROLE ?? "runtime")
+        .trim()
+        .toLowerCase();
+    return value === "migration" ? "migration" : "runtime";
+}
+function resolveMysqlEnv(env = process.env, options = {}) {
+    const role = resolveDbExecutionRole(env);
+    const isTest = !!options.test;
+    const roleKey = role === "migration" ? "MIGRATION" : "RUNTIME";
+    const prefix = isTest ? "DB_TEST" : "DB";
+    const host = pickFirstDefined(env, [
+        `${prefix}_${roleKey}_HOST`,
+        `${prefix}_HOST`,
+        `DB_${roleKey}_HOST`,
+        "DB_HOST",
+    ], "localhost");
+    const user = pickFirstDefined(env, [
+        `${prefix}_${roleKey}_USER`,
+        `${prefix}_USER`,
+        `DB_${roleKey}_USER`,
+        "DB_USER",
+    ], "root");
+    const password = pickFirstDefined(env, [
+        `${prefix}_${roleKey}_PASSWORD`,
+        `${prefix}_PASSWORD`,
+        `DB_${roleKey}_PASSWORD`,
+        "DB_PASSWORD",
+    ], "");
+    const database = pickFirstDefined(env, [
+        `${prefix}_${roleKey}_NAME`,
+        `${prefix}_${roleKey}_DB_NAME`,
+        `${prefix}_NAME`,
+        `${prefix}_DB_NAME`,
+        `DB_${roleKey}_NAME`,
+        `DB_${roleKey}_DB_NAME`,
+        "DB_NAME",
+    ], isTest ? "db_test" : "eloquentjs");
+    const port = pickFirstNumber(env, [
+        `${prefix}_${roleKey}_PORT`,
+        `${prefix}_PORT`,
+        `DB_${roleKey}_PORT`,
+        "DB_PORT",
+    ], 3306);
+    return {
+        host,
+        user,
+        password,
+        database,
+        port,
+    };
+}
+function resolvePgEnv(env = process.env, options = {}) {
+    const role = resolveDbExecutionRole(env);
+    const isTest = !!options.test;
+    const roleKey = role === "migration" ? "MIGRATION" : "RUNTIME";
+    const prefix = isTest ? "PG_TEST" : "PG";
+    const host = pickFirstDefined(env, [
+        `${prefix}_${roleKey}_HOST`,
+        `${prefix}_HOST`,
+        `PG_${roleKey}_HOST`,
+        "PG_HOST",
+    ], "localhost");
+    const user = pickFirstDefined(env, [
+        `${prefix}_${roleKey}_USER`,
+        `${prefix}_USER`,
+        `PG_${roleKey}_USER`,
+        "PG_USER",
+    ], "postgres");
+    const password = pickFirstDefined(env, [
+        `${prefix}_${roleKey}_PASSWORD`,
+        `${prefix}_PASSWORD`,
+        `PG_${roleKey}_PASSWORD`,
+        "PG_PASSWORD",
+    ], "");
+    const database = pickFirstDefined(env, [
+        `${prefix}_${roleKey}_NAME`,
+        `${prefix}_${roleKey}_DB_NAME`,
+        `${prefix}_NAME`,
+        `${prefix}_DB_NAME`,
+        `PG_${roleKey}_NAME`,
+        `PG_${roleKey}_DB_NAME`,
+        "PG_NAME",
+        "PG_DB_NAME",
+    ], isTest ? "db_test_pg" : "test_db");
+    const port = pickFirstNumber(env, [
+        `${prefix}_${roleKey}_PORT`,
+        `${prefix}_PORT`,
+        `PG_${roleKey}_PORT`,
+        "PG_PORT",
+    ], 5432);
+    return {
+        host,
+        user,
+        password,
+        database,
+        port,
+    };
+}
+function resolveSqlitePath(env = process.env, options = {}) {
+    const role = resolveDbExecutionRole(env);
+    const isTest = !!options.test;
+    const roleKey = role === "migration" ? "MIGRATION" : "RUNTIME";
+    const prefix = isTest ? "SQLITE_TEST" : "SQLITE";
+    return pickFirstDefined(env, [
+        `${prefix}_${roleKey}_PATH`,
+        `${prefix}_PATH`,
+        `SQLITE_${roleKey}_PATH`,
+        "SQLITE_PATH",
+    ], isTest ? "./data.test.sqlite" : "./data.sqlite");
+}
+function resolveMongoEnv(env = process.env, options = {}) {
+    const role = resolveDbExecutionRole(env);
+    const isTest = !!options.test;
+    const roleKey = role === "migration" ? "MIGRATION" : "RUNTIME";
+    const prefix = isTest ? "MONGO_TEST" : "MONGO";
+    const uri = pickFirstDefined(env, [
+        `${prefix}_${roleKey}_URI`,
+        `${prefix}_URI`,
+        `MONGO_${roleKey}_URI`,
+        "MONGO_URI",
+    ], "mongodb://localhost:27017");
+    const database = pickFirstDefined(env, [
+        `${prefix}_${roleKey}_DB`,
+        `${prefix}_${roleKey}_DATABASE`,
+        `${prefix}_DB`,
+        `${prefix}_DATABASE`,
+        `MONGO_${roleKey}_DB`,
+        `MONGO_${roleKey}_DATABASE`,
+        "MONGO_DB",
+        "MONGO_DATABASE",
+    ], isTest ? "eloquentjs_db_test" : "eloquentjs_db");
+    const dnsServers = pickFirstList(env, [
+        `${prefix}_${roleKey}_DNS_SERVERS`,
+        `${prefix}_DNS_SERVERS`,
+        `MONGO_${roleKey}_DNS_SERVERS`,
+        "MONGO_DNS_SERVERS",
+    ]);
+    return { uri, database, dnsServers };
+}
+//# sourceMappingURL=dbRoleEnv.js.map

package/dist/config/dbRoleEnv.js.map

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

package/dist/core/cache/CacheAnalytics.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 🧠 CacheAnalytics
+ * Tracks cache hit/miss counts and dynamically tunes TTLs per model.
+ * Minimal overhead — O(1) map updates.
+ */
+export declare class CacheAnalytics {
+    private static stats;
+    private static adjustInterval;
+    private static minTTL;
+    private static maxTTL;
+    private static counter;
+    /**
+     * Record a cache hit.
+     */
+    static hit(model: string, currentTTL: number): void;
+    /**
+     * Record a cache miss.
+     */
+    static miss(model: string, currentTTL: number): void;
+    /**
+     * Initialize model stats if missing.
+     */
+    private static ensureModel;
+    /**
+     * Check if it's time to adjust TTLs (every N operations).
+     */
+    private static checkAdjust;
+    /**
+     * Core logic: tune TTL based on hit/miss ratio.
+     */
+    private static adjustTTL;
+    /**
+     * Optional: expose stats for monitoring.
+     */
+    static getStats(): {
+        model: string;
+        hits: number;
+        misses: number;
+        ttl: number;
+        lastAdjust: string;
+    }[];
+    /**
+     * Reset all collected cache analytics counters.
+     */
+    static reset(): void;
+}
+//# sourceMappingURL=CacheAnalytics.d.ts.map

package/dist/core/cache/CacheAnalytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheAnalytics.d.ts","sourceRoot":"","sources":["../../../src/core/cache/CacheAnalytics.ts"],"names":[],"mappings":"AACA;;;;GAIG;AASH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAsC;IAC1D,OAAO,CAAC,MAAM,CAAC,cAAc,CAAO;IACpC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAM;IAC3B,OAAO,CAAC,MAAM,CAAC,MAAM,CAAQ;IAC7B,OAAO,CAAC,MAAM,CAAC,OAAO,CAAK;IAE3B;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAM5C;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAM7C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAW1B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAO1B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IA2CxB;;OAEG;IACH,MAAM,CAAC,QAAQ;;;;;;;IAUf;;OAEG;IACH,MAAM,CAAC,KAAK,IAAI,IAAI;CAIrB"}

package/dist/core/cache/CacheAnalytics.js

@@ -0,0 +1,113 @@
+"use strict";
+// src/core/cache/CacheAnalytics.ts
+/**
+ * 🧠 CacheAnalytics
+ * Tracks cache hit/miss counts and dynamically tunes TTLs per model.
+ * Minimal overhead — O(1) map updates.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheAnalytics = void 0;
+class CacheAnalytics {
+    /**
+     * Record a cache hit.
+     */
+    static hit(model, currentTTL) {
+        this.ensureModel(model, currentTTL);
+        this.stats.get(model).hits++;
+        this.checkAdjust(model);
+    }
+    /**
+     * Record a cache miss.
+     */
+    static miss(model, currentTTL) {
+        this.ensureModel(model, currentTTL);
+        this.stats.get(model).misses++;
+        this.checkAdjust(model);
+    }
+    /**
+     * Initialize model stats if missing.
+     */
+    static ensureModel(model, ttl) {
+        if (!this.stats.has(model)) {
+            this.stats.set(model, {
+                hits: 0,
+                misses: 0,
+                currentTTL: ttl,
+                lastAdjust: Date.now(),
+            });
+        }
+    }
+    /**
+     * Check if it's time to adjust TTLs (every N operations).
+     */
+    static checkAdjust(model) {
+        this.counter++;
+        if (this.counter % this.adjustInterval === 0) {
+            this.adjustTTL(model);
+        }
+    }
+    /**
+     * Core logic: tune TTL based on hit/miss ratio.
+     */
+    static adjustTTL(model) {
+        const stat = this.stats.get(model);
+        if (!stat)
+            return;
+        const total = stat.hits + stat.misses;
+        if (total === 0)
+            return;
+        const hitRate = stat.hits / total;
+        let newTTL = stat.currentTTL;
+        // 🧮 Adjust TTL by hit rate thresholds
+        if (hitRate > 0.8)
+            newTTL *= 1.25; // increase by 25%
+        else if (hitRate < 0.4)
+            newTTL *= 0.75; // decrease by 25%
+        // Clamp to safe bounds
+        newTTL = Math.min(this.maxTTL, Math.max(this.minTTL, Math.round(newTTL)));
+        if (newTTL !== stat.currentTTL) {
+            console.log(`[CacheAnalytics] ${model} hitRate=${(hitRate * 100).toFixed(1)}% → TTL ${stat.currentTTL}s → ${newTTL}s`);
+            stat.currentTTL = newTTL;
+            stat.lastAdjust = Date.now();
+            // Try updating model’s default TTL (if class loaded)
+            try {
+                const ModelClass = global.EloquentModels?.[model];
+                if (ModelClass) {
+                    ModelClass.defaultCacheTTL = newTTL;
+                }
+            }
+            catch {
+                // ignore
+            }
+        }
+        // Reset counters for next cycle
+        stat.hits = 0;
+        stat.misses = 0;
+    }
+    /**
+     * Optional: expose stats for monitoring.
+     */
+    static getStats() {
+        return Array.from(this.stats.entries()).map(([model, s]) => ({
+            model,
+            hits: s.hits,
+            misses: s.misses,
+            ttl: s.currentTTL,
+            lastAdjust: new Date(s.lastAdjust).toISOString(),
+        }));
+    }
+    /**
+     * Reset all collected cache analytics counters.
+     */
+    static reset() {
+        this.stats.clear();
+        this.counter = 0;
+    }
+}
+exports.CacheAnalytics = CacheAnalytics;
+CacheAnalytics.stats = new Map();
+CacheAnalytics.adjustInterval = 100; // adjust every 100 cache ops
+CacheAnalytics.minTTL = 30; // seconds
+CacheAnalytics.maxTTL = 3600; // seconds
+CacheAnalytics.counter = 0;
+//# sourceMappingURL=CacheAnalytics.js.map

package/dist/core/cache/CacheAnalytics.js.map

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

package/dist/core/cache/CacheDriver.d.ts

@@ -0,0 +1,19 @@
+export declare abstract class CacheDriver {
+    /**
+     * Return parsed value or null if not found.
+     */
+    abstract get<T = any>(key: string): Promise<T | null>;
+    /**
+     * Store value for `ttl` seconds. ttl === 0 => no expiration.
+     */
+    abstract set<T = any>(key: string, value: T, ttl?: number): Promise<void>;
+    /**
+     * Delete a key.
+     */
+    abstract delete(key: string): Promise<void>;
+    /**
+     * Clear all keys (use carefully).
+     */
+    abstract clear(): Promise<void>;
+}
+//# sourceMappingURL=CacheDriver.d.ts.map

package/dist/core/cache/CacheDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheDriver.d.ts","sourceRoot":"","sources":["../../../src/core/cache/CacheDriver.ts"],"names":[],"mappings":"AACA,8BAAsB,WAAW;IAC/B;;OAEG;IACH,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAErD;;OAEG;IACH,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAEzE;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAE3C;;OAEG;IACH,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAChC"}

package/dist/core/cache/CacheDriver.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheDriver = void 0;
+// src/core/cache/CacheDriver.ts
+class CacheDriver {
+}
+exports.CacheDriver = CacheDriver;
+//# sourceMappingURL=CacheDriver.js.map

package/dist/core/cache/CacheDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheDriver.js","sourceRoot":"","sources":["../../../src/core/cache/CacheDriver.ts"],"names":[],"mappings":";;;AAAA,gCAAgC;AAChC,MAAsB,WAAW;CAoBhC;AApBD,kCAoBC"}

package/dist/core/cache/CacheFallbackManager.d.ts

@@ -0,0 +1,35 @@
+import { CacheDriver } from "./CacheDriver";
+export declare class CacheFallbackManager {
+    private static drivers;
+    private static active;
+    private static readonly opTimeoutMs;
+    /**
+     * Register fallback chain: first = primary, last = backup
+     */
+    static useChain(drivers: CacheDriver[]): void;
+    static getActiveDriver(): CacheDriver | null;
+    static getDrivers(): CacheDriver[];
+    private static runWithTimeout;
+    /**
+     * Try an operation on each driver in order until success.
+     */
+    private static tryChain;
+    static get<T>(key: string): Promise<T | null>;
+    static set<T>(key: string, value: T, ttl?: number): Promise<void>;
+    static delete(key: string): Promise<void>;
+    static clear(): Promise<void>;
+    /**
+     * Clear every driver in the fallback chain (not only active/first-success).
+     */
+    static clearAllDrivers(): Promise<Array<{
+        driver: string;
+        ok: boolean;
+        error?: string;
+    }>>;
+    static shutdownDrivers(): Promise<Array<{
+        driver: string;
+        closed: boolean;
+        error?: string;
+    }>>;
+}
+//# sourceMappingURL=CacheFallbackManager.d.ts.map

package/dist/core/cache/CacheFallbackManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheFallbackManager.d.ts","sourceRoot":"","sources":["../../../src/core/cache/CacheFallbackManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAC,OAAO,CAAqB;IAC3C,OAAO,CAAC,MAAM,CAAC,MAAM,CAA4B;IACjD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAQ;IAE3C;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE;IAKtC,MAAM,CAAC,eAAe,IAAI,WAAW,GAAG,IAAI;IAI5C,MAAM,CAAC,UAAU,IAAI,WAAW,EAAE;mBAIb,cAAc;IAgBnC;;OAEG;mBACkB,QAAQ;WAmBhB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;WAItC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC;WAItD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;WAIlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC;;OAEG;WACU,eAAe,IAAI,OAAO,CACrC,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CACvD;WA8BY,eAAe,IAAI,OAAO,CACrC,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAC3D;CA8BF"}

package/dist/core/cache/CacheFallbackManager.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheFallbackManager = void 0;
+class CacheFallbackManager {
+    /**
+     * Register fallback chain: first = primary, last = backup
+     */
+    static useChain(drivers) {
+        this.drivers = drivers;
+        this.active = drivers[0];
+    }
+    static getActiveDriver() {
+        return this.active;
+    }
+    static getDrivers() {
+        return [...this.drivers];
+    }
+    static async runWithTimeout(task, timeoutMs = this.opTimeoutMs) {
+        const timedTask = task
+            .then(() => ({ timedOut: false }))
+            .catch((error) => ({ timedOut: false, error }));
+        const timeoutTask = new Promise((resolve) => {
+            setTimeout(() => resolve({ timedOut: true }), timeoutMs);
+        });
+        const result = await Promise.race([timedTask, timeoutTask]);
+        return result;
+    }
+    /**
+     * Try an operation on each driver in order until success.
+     */
+    static async tryChain(fn, onFailure) {
+        for (const driver of this.drivers) {
+            try {
+                const result = await fn(driver);
+                this.active = driver;
+                return result;
+            }
+            catch (err) {
+                onFailure?.(err, driver);
+                // try next
+            }
+        }
+        throw new Error("All cache drivers failed in fallback chain.");
+    }
+    // ----------- Public unified API -----------
+    static async get(key) {
+        return this.tryChain(async (d) => await d.get(key));
+    }
+    static async set(key, value, ttl = 60) {
+        await this.tryChain(async (d) => await d.set(key, value, ttl));
+    }
+    static async delete(key) {
+        await this.tryChain(async (d) => await d.delete(key));
+    }
+    static async clear() {
+        await this.tryChain(async (d) => await d.clear());
+    }
+    /**
+     * Clear every driver in the fallback chain (not only active/first-success).
+     */
+    static async clearAllDrivers() {
+        const results = [];
+        for (const driver of this.drivers) {
+            const outcome = await this.runWithTimeout(driver.clear());
+            if (outcome.timedOut) {
+                results.push({
+                    driver: driver.constructor.name,
+                    ok: false,
+                    error: `timeout after ${this.opTimeoutMs}ms`,
+                });
+                continue;
+            }
+            if (outcome.error) {
+                results.push({
+                    driver: driver.constructor.name,
+                    ok: false,
+                    error: outcome.error instanceof Error
+                        ? outcome.error.message
+                        : String(outcome.error),
+                });
+                continue;
+            }
+            results.push({ driver: driver.constructor.name, ok: true });
+        }
+        return results;
+    }
+    static async shutdownDrivers() {
+        const results = [];
+        for (const driver of this.drivers) {
+            const closable = driver;
+            try {
+                if (typeof closable.close === "function") {
+                    await closable.close();
+                }
+                else if (typeof closable.disconnect === "function") {
+                    await closable.disconnect();
+                }
+                else if (typeof closable.end === "function") {
+                    closable.end();
+                }
+                results.push({ driver: driver.constructor.name, closed: true });
+            }
+            catch (err) {
+                results.push({
+                    driver: driver.constructor.name,
+                    closed: false,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+        return results;
+    }
+}
+exports.CacheFallbackManager = CacheFallbackManager;
+CacheFallbackManager.drivers = [];
+CacheFallbackManager.active = null;
+CacheFallbackManager.opTimeoutMs = 3000;
+//# sourceMappingURL=CacheFallbackManager.js.map

package/dist/core/cache/CacheFallbackManager.js.map

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

package/dist/core/cache/CacheManager.d.ts

@@ -0,0 +1,11 @@
+import { CacheDriver } from "./CacheDriver";
+export declare class CacheManager {
+    private static driver;
+    static use(driver: CacheDriver): void;
+    static getDriver(): CacheDriver;
+    static get<T = any>(key: string): Promise<T | null>;
+    static set<T = any>(key: string, value: T, ttl?: number): Promise<void>;
+    static delete(key: string): Promise<void>;
+    static clear(): Promise<void>;
+}
+//# sourceMappingURL=CacheManager.d.ts.map

package/dist/core/cache/CacheManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheManager.d.ts","sourceRoot":"","sources":["../../../src/core/cache/CacheManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAwC;IAE7D,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW;IAI9B,MAAM,CAAC,SAAS,IAAI,WAAW;WAIlB,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;WAI5C,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC;WAI5D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;WAIlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAGpC"}

package/dist/core/cache/CacheManager.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheManager = void 0;
+const MemoryCacheDriver_1 = require("./drivers/MemoryCacheDriver");
+class CacheManager {
+    static use(driver) {
+        this.driver = driver;
+    }
+    static getDriver() {
+        return this.driver;
+    }
+    static async get(key) {
+        return this.driver.get(key);
+    }
+    static async set(key, value, ttl = 60) {
+        return this.driver.set(key, value, ttl);
+    }
+    static async delete(key) {
+        return this.driver.delete(key);
+    }
+    static async clear() {
+        return this.driver.clear();
+    }
+}
+exports.CacheManager = CacheManager;
+CacheManager.driver = new MemoryCacheDriver_1.MemoryCacheDriver();
+//# sourceMappingURL=CacheManager.js.map

package/dist/core/cache/CacheManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheManager.js","sourceRoot":"","sources":["../../../src/core/cache/CacheManager.ts"],"names":[],"mappings":";;;AAEA,mEAAgE;AAEhE,MAAa,YAAY;IAGvB,MAAM,CAAC,GAAG,CAAC,MAAmB;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,SAAS;QACd,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,GAAG,CAAU,GAAW;QACnC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAI,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,GAAG,CAAU,GAAW,EAAE,KAAQ,EAAE,GAAG,GAAG,EAAE;QACvD,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAI,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAW;QAC7B,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,KAAK;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;;AAzBH,oCA0BC;AAzBgB,mBAAM,GAAgB,IAAI,qCAAiB,EAAE,CAAC"}

package/dist/core/cache/CacheRegistry.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 🧩 CacheRegistry
+ * Keeps track of cache keys grouped by model and group name.
+ *
+ * Example:
+ * CacheRegistry.addKey('User', 'findMany', 'User:abcd1234');
+ * CacheRegistry.getKeys('User') => ['User:abcd1234', ...]
+ */
+export declare class CacheRegistry {
+    private static registry;
+    /**
+     * Return aggregated registry stats for CLI/monitoring.
+     */
+    static getStats(): {
+        models: number;
+        groups: number;
+        keys: number;
+        groupsByModel: Array<{
+            model: string;
+            groups: number;
+            keys: number;
+        }>;
+    };
+    /**
+     * Register a cache key for a given model and group.
+     */
+    static addKey(modelName: string, group: string, key: string): void;
+    /**
+     * Return all cache keys for a model or model+group.
+     */
+    static getKeys(modelName: string, group?: string): string[];
+    /**
+     * Remove a specific key from the registry.
+     */
+    static removeKey(modelName: string, group: string, key: string): void;
+    /**
+     * Clear all keys for a model (invalidate model cache).
+     */
+    static clearModel(modelName: string): Promise<void>;
+    /**
+     * Clear a specific group within a model (e.g., "findMany" or "where").
+     */
+    static clearGroup(modelName: string, group: string): Promise<void>;
+    /**
+     * Clear the entire registry (dangerous: wipes all caches).
+     */
+    static clearAll(): Promise<void>;
+}
+//# sourceMappingURL=CacheRegistry.d.ts.map

package/dist/core/cache/CacheRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheRegistry.d.ts","sourceRoot":"","sources":["../../../src/core/cache/CacheRegistry.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuC;IAE9D;;OAEG;IACH,MAAM,CAAC,QAAQ,IAAI;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACvE;IAyBD;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAWlE;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAkB3D;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAYrE;;OAEG;WACU,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWzD;;OAEG;WACU,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYxE;;OAEG;WACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAIvC"}