@alpha.consultings/eloquent-orm.js 1.0.1

package/dist/core/cache/CacheRegistry.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheRegistry = void 0;
+// src/core/cache/CacheRegistry.ts
+const CacheManager_1 = require("./CacheManager");
+/**
+ * 🧩 CacheRegistry
+ * Keeps track of cache keys grouped by model and group name.
+ *
+ * Example:
+ * CacheRegistry.addKey('User', 'findMany', 'User:abcd1234');
+ * CacheRegistry.getKeys('User') => ['User:abcd1234', ...]
+ */
+class CacheRegistry {
+    /**
+     * Return aggregated registry stats for CLI/monitoring.
+     */
+    static getStats() {
+        const perModel = new Map();
+        let keys = 0;
+        for (const [registryKey, set] of Array.from(this.registry.entries())) {
+            const [model] = registryKey.split(":");
+            const entry = perModel.get(model) ?? { groups: 0, keys: 0 };
+            entry.groups += 1;
+            entry.keys += set.size;
+            perModel.set(model, entry);
+            keys += set.size;
+        }
+        return {
+            models: perModel.size,
+            groups: this.registry.size,
+            keys,
+            groupsByModel: Array.from(perModel.entries()).map(([model, info]) => ({
+                model,
+                groups: info.groups,
+                keys: info.keys,
+            })),
+        };
+    }
+    /**
+     * Register a cache key for a given model and group.
+     */
+    static addKey(modelName, group, key) {
+        const registryKey = `${modelName}:${group}`;
+        if (!this.registry.has(registryKey)) {
+            this.registry.set(registryKey, new Set());
+        }
+        const set = this.registry.get(registryKey);
+        set.add(key);
+    }
+    /**
+     * Return all cache keys for a model or model+group.
+     */
+    static getKeys(modelName, group) {
+        if (group) {
+            const registryKey = `${modelName}:${group}`;
+            return Array.from(this.registry.get(registryKey) || []);
+        }
+        const allKeys = [];
+        // ✅ Use Array.from() to make iteration safe for older targets
+        for (const [key, set] of Array.from(this.registry.entries())) {
+            if (key.startsWith(modelName + ":")) {
+                allKeys.push(...Array.from(set));
+            }
+        }
+        return allKeys;
+    }
+    /**
+     * Remove a specific key from the registry.
+     */
+    static removeKey(modelName, group, key) {
+        const registryKey = `${modelName}:${group}`;
+        const set = this.registry.get(registryKey);
+        if (set) {
+            set.delete(key);
+            if (set.size === 0) {
+                this.registry.delete(registryKey);
+            }
+        }
+    }
+    /**
+     * Clear all keys for a model (invalidate model cache).
+     */
+    static async clearModel(modelName) {
+        for (const [key, set] of Array.from(this.registry.entries())) {
+            if (key.startsWith(modelName + ":")) {
+                for (const cacheKey of Array.from(set)) {
+                    await CacheManager_1.CacheManager.delete(cacheKey);
+                }
+                this.registry.delete(key);
+            }
+        }
+    }
+    /**
+     * Clear a specific group within a model (e.g., "findMany" or "where").
+     */
+    static async clearGroup(modelName, group) {
+        const registryKey = `${modelName}:${group}`;
+        const set = this.registry.get(registryKey);
+        if (!set)
+            return;
+        for (const cacheKey of Array.from(set)) {
+            await CacheManager_1.CacheManager.delete(cacheKey);
+        }
+        this.registry.delete(registryKey);
+    }
+    /**
+     * Clear the entire registry (dangerous: wipes all caches).
+     */
+    static async clearAll() {
+        await CacheManager_1.CacheManager.clear();
+        this.registry.clear();
+    }
+}
+exports.CacheRegistry = CacheRegistry;
+CacheRegistry.registry = new Map();
+//# sourceMappingURL=CacheRegistry.js.map

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

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

package/dist/core/cache/drivers/FileCacheDriver.d.ts

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

package/dist/core/cache/drivers/FileCacheDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileCacheDriver.d.ts","sourceRoot":"","sources":["../../../../src/core/cache/drivers/FileCacheDriver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAM7C,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,OAAO,CAAC,GAAG,CAAS;gBAER,GAAG,SAAW;IAO1B,OAAO,CAAC,QAAQ;IAMV,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAe5C,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}

package/dist/core/cache/drivers/FileCacheDriver.js

@@ -0,0 +1,54 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileCacheDriver = void 0;
+// src/core/cache/drivers/FileCacheDriver.ts
+const CacheDriver_1 = require("../CacheDriver");
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+class FileCacheDriver extends CacheDriver_1.CacheDriver {
+    constructor(dir = ".cache") {
+        super();
+        this.dir = dir;
+        // create dir synchronously-safe at startup; callers should handle errors
+        promises_1.default.mkdir(this.dir, { recursive: true }).catch(() => { });
+    }
+    filePath(key) {
+        // sanitize key-ish (hash the key in production). Here we keep simple.
+        const safe = encodeURIComponent(key);
+        return path_1.default.join(this.dir, `${safe}.json`);
+    }
+    async get(key) {
+        const file = this.filePath(key);
+        try {
+            const raw = await promises_1.default.readFile(file, "utf8");
+            const e = JSON.parse(raw);
+            if (e.expiresAt && Date.now() > e.expiresAt) {
+                await promises_1.default.unlink(file).catch(() => { });
+                return null;
+            }
+            return e.value;
+        }
+        catch (err) {
+            return null;
+        }
+    }
+    async set(key, value, ttl = 60) {
+        const file = this.filePath(key);
+        const expiresAt = ttl > 0 ? Date.now() + ttl * 1000 : null;
+        const data = { value, expiresAt };
+        await promises_1.default.writeFile(file, JSON.stringify(data), "utf8");
+    }
+    async delete(key) {
+        const file = this.filePath(key);
+        await promises_1.default.unlink(file).catch(() => { });
+    }
+    async clear() {
+        const files = await promises_1.default.readdir(this.dir).catch(() => []);
+        await Promise.all(files.map(f => promises_1.default.unlink(path_1.default.join(this.dir, f)).catch(() => { })));
+    }
+}
+exports.FileCacheDriver = FileCacheDriver;
+//# sourceMappingURL=FileCacheDriver.js.map

package/dist/core/cache/drivers/FileCacheDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileCacheDriver.js","sourceRoot":"","sources":["../../../../src/core/cache/drivers/FileCacheDriver.ts"],"names":[],"mappings":";;;;;;AAAA,4CAA4C;AAC5C,gDAA6C;AAC7C,2DAA6B;AAC7B,gDAAwB;AAIxB,MAAa,eAAgB,SAAQ,yBAAW;IAG9C,YAAY,GAAG,GAAG,QAAQ;QACxB,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,yEAAyE;QACzE,kBAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;IAEO,QAAQ,CAAC,GAAW;QAC1B,sEAAsE;QACtE,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACrC,OAAO,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,GAAG,CAAU,GAAW;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC5C,MAAM,CAAC,GAAc,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACrC,IAAI,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC;gBAC5C,MAAM,kBAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBACtC,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO,CAAC,CAAC,KAAU,CAAC;QACtB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAU,GAAW,EAAE,KAAQ,EAAE,GAAG,GAAG,EAAE;QAChD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,SAAS,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3D,MAAM,IAAI,GAAc,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAC7C,MAAM,kBAAE,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,kBAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,KAAK,GAAG,MAAM,kBAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QACzD,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,kBAAE,CAAC,MAAM,CAAC,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACvF,CAAC;CACF;AA/CD,0CA+CC"}

package/dist/core/cache/drivers/MemcachedCacheDriver.d.ts

@@ -0,0 +1,15 @@
+import { CacheDriver } from "../CacheDriver";
+export declare class MemcachedCacheDriver extends CacheDriver {
+    private client;
+    private defaultTtl;
+    /**
+     * servers: string or array (e.g. "127.0.0.1:11211" or ["a:11211","b:11211"])
+     */
+    constructor(servers?: string | string[], defaultTtl?: number);
+    get<T = any>(key: string): Promise<T | null>;
+    set<T = any>(key: string, value: T, ttl?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    clear(): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=MemcachedCacheDriver.d.ts.map

package/dist/core/cache/drivers/MemcachedCacheDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemcachedCacheDriver.d.ts","sourceRoot":"","sources":["../../../../src/core/cache/drivers/MemcachedCacheDriver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,qBAAa,oBAAqB,SAAQ,WAAW;IACnD,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,UAAU,CAAS;IAE3B;;OAEG;gBACS,OAAO,GAAE,MAAM,GAAG,MAAM,EAAsB,EAAE,UAAU,SAAK;IAMrE,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAc5C,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,SAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAUzE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/core/cache/drivers/MemcachedCacheDriver.js

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemcachedCacheDriver = void 0;
+// src/core/cache/drivers/MemcachedCacheDriver.ts
+const CacheDriver_1 = require("../CacheDriver");
+const memcached_1 = __importDefault(require("memcached"));
+class MemcachedCacheDriver extends CacheDriver_1.CacheDriver {
+    /**
+     * servers: string or array (e.g. "127.0.0.1:11211" or ["a:11211","b:11211"])
+     */
+    constructor(servers = "127.0.0.1:11211", defaultTtl = 60) {
+        super();
+        this.client = new memcached_1.default(servers);
+        this.defaultTtl = defaultTtl;
+    }
+    async get(key) {
+        return new Promise((resolve) => {
+            this.client.get(key, (err, data) => {
+                if (err || typeof data === "undefined" || data === null)
+                    return resolve(null);
+                try {
+                    resolve(JSON.parse(data));
+                }
+                catch {
+                    // in case stored as raw
+                    resolve(data);
+                }
+            });
+        });
+    }
+    async set(key, value, ttl = this.defaultTtl) {
+        return new Promise((resolve, reject) => {
+            const payload = JSON.stringify(value);
+            this.client.set(key, payload, ttl, (err) => {
+                if (err)
+                    return reject(err);
+                resolve();
+            });
+        });
+    }
+    async delete(key) {
+        return new Promise((resolve) => {
+            this.client.del(key, () => resolve());
+        });
+    }
+    async clear() {
+        // Memcached has 'flush' command
+        return new Promise((resolve, reject) => {
+            this.client.flush((err) => (err ? reject(err) : resolve()));
+        });
+    }
+    async close() {
+        this.client.end();
+    }
+}
+exports.MemcachedCacheDriver = MemcachedCacheDriver;
+//# sourceMappingURL=MemcachedCacheDriver.js.map

package/dist/core/cache/drivers/MemcachedCacheDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemcachedCacheDriver.js","sourceRoot":"","sources":["../../../../src/core/cache/drivers/MemcachedCacheDriver.ts"],"names":[],"mappings":";;;;;;AAAA,iDAAiD;AACjD,gDAA6C;AAC7C,0DAAkC;AAElC,MAAa,oBAAqB,SAAQ,yBAAW;IAInD;;OAEG;IACH,YAAY,UAA6B,iBAAiB,EAAE,UAAU,GAAG,EAAE;QACzE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,IAAI,mBAAS,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,GAAG,CAAU,GAAW;QAC5B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;gBACjC,IAAI,GAAG,IAAI,OAAO,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,IAAI;oBAAE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;gBAC9E,IAAI,CAAC;oBACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC,CAAC;gBACjC,CAAC;gBAAC,MAAM,CAAC;oBACP,wBAAwB;oBACxB,OAAO,CAAC,IAAS,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,GAAG,CAAU,GAAW,EAAE,KAAQ,EAAE,GAAG,GAAG,IAAI,CAAC,UAAU;QAC7D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACtC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE;gBACzC,IAAI,GAAG;oBAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC5B,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK;QACT,gCAAgC;QAChC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;IACpB,CAAC;CACF;AArDD,oDAqDC"}

package/dist/core/cache/drivers/MemoryCacheDriver.d.ts

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

package/dist/core/cache/drivers/MemoryCacheDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryCacheDriver.d.ts","sourceRoot":"","sources":["../../../../src/core/cache/drivers/MemoryCacheDriver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAO7C,qBAAa,iBAAkB,SAAQ,WAAW;IAChD,OAAO,CAAC,KAAK,CAA4B;IAEnC,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAU5C,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/core/cache/drivers/MemoryCacheDriver.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryCacheDriver = void 0;
+// src/core/cache/drivers/MemoryCacheDriver.ts
+const CacheDriver_1 = require("../CacheDriver");
+class MemoryCacheDriver extends CacheDriver_1.CacheDriver {
+    constructor() {
+        super(...arguments);
+        this.store = new Map();
+    }
+    async get(key) {
+        const e = this.store.get(key);
+        if (!e)
+            return null;
+        if (e.expiresAt && Date.now() > e.expiresAt) {
+            this.store.delete(key);
+            return null;
+        }
+        return e.value;
+    }
+    async set(key, value, ttl = 60) {
+        const expiresAt = ttl > 0 ? Date.now() + ttl * 1000 : null;
+        this.store.set(key, { value, expiresAt });
+    }
+    async delete(key) {
+        this.store.delete(key);
+    }
+    async clear() {
+        this.store.clear();
+    }
+}
+exports.MemoryCacheDriver = MemoryCacheDriver;
+//# sourceMappingURL=MemoryCacheDriver.js.map

package/dist/core/cache/drivers/MemoryCacheDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryCacheDriver.js","sourceRoot":"","sources":["../../../../src/core/cache/drivers/MemoryCacheDriver.ts"],"names":[],"mappings":";;;AAAA,8CAA8C;AAC9C,gDAA6C;AAO7C,MAAa,iBAAkB,SAAQ,yBAAW;IAAlD;;QACU,UAAK,GAAG,IAAI,GAAG,EAAiB,CAAC;IAwB3C,CAAC;IAtBC,KAAK,CAAC,GAAG,CAAU,GAAW;QAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QACpB,IAAI,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC;YAC5C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,CAAC,CAAC,KAAU,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,GAAG,CAAU,GAAW,EAAE,KAAQ,EAAE,GAAG,GAAG,EAAE;QAChD,MAAM,SAAS,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF;AAzBD,8CAyBC"}

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

@@ -0,0 +1,2 @@
+export declare function setupCache(): void;
+//# sourceMappingURL=setupCache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setupCache.d.ts","sourceRoot":"","sources":["../../../src/core/cache/setupCache.ts"],"names":[],"mappings":"AAOA,wBAAgB,UAAU,SAiCzB"}

package/dist/core/cache/setupCache.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupCache = setupCache;
+// src/core/cache/setupCache.ts
+const CacheFallbackManager_1 = require("./CacheFallbackManager");
+const MemoryCacheDriver_1 = require("./drivers/MemoryCacheDriver");
+const FileCacheDriver_1 = require("./drivers/FileCacheDriver");
+const MemcachedCacheDriver_1 = require("./drivers/MemcachedCacheDriver");
+const CacheManager_1 = require("./CacheManager"); // still used for simple modes
+function setupCache() {
+    const env = process.env.APP_ENV || process.env.NODE_ENV || "development";
+    console.log(`[CacheManager] Initializing cache for environment: ${env}`);
+    switch (env) {
+        case "development":
+            CacheManager_1.CacheManager.use(new MemoryCacheDriver_1.MemoryCacheDriver());
+            console.log("→ Using MemoryCacheDriver (Development)");
+            break;
+        case "staging":
+            CacheManager_1.CacheManager.use(new FileCacheDriver_1.FileCacheDriver(process.env.CACHE_DIR || ".cache"));
+            console.log("→ Using FileCacheDriver (Staging)");
+            break;
+        case "production":
+            const host = process.env.MEMCACHED_HOST || "127.0.0.1";
+            const port = process.env.MEMCACHED_PORT || "11211";
+            const memcachedUrl = `${host}:${port}`;
+            const memDriver = new MemcachedCacheDriver_1.MemcachedCacheDriver(memcachedUrl, 120);
+            const fileDriver = new FileCacheDriver_1.FileCacheDriver(process.env.CACHE_DIR || ".cache");
+            const memLocal = new MemoryCacheDriver_1.MemoryCacheDriver();
+            // 🧩 Setup fallback chain
+            CacheFallbackManager_1.CacheFallbackManager.useChain([memDriver, fileDriver, memLocal]);
+            console.log(`→ Using Fallback chain (Production): Memcached → File → Memory`);
+            break;
+        default:
+            CacheManager_1.CacheManager.use(new MemoryCacheDriver_1.MemoryCacheDriver());
+            console.log("→ Using MemoryCacheDriver (Default fallback)");
+    }
+}
+//# sourceMappingURL=setupCache.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setupCache.js","sourceRoot":"","sources":["../../../src/core/cache/setupCache.ts"],"names":[],"mappings":";;AAOA,gCAiCC;AAxCD,+BAA+B;AAC/B,iEAA8D;AAC9D,mEAAgE;AAChE,+DAA4D;AAC5D,yEAAsE;AACtE,iDAA8C,CAAC,8BAA8B;AAE7E,SAAgB,UAAU;IACxB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,aAAa,CAAC;IACzE,OAAO,CAAC,GAAG,CAAC,sDAAsD,GAAG,EAAE,CAAC,CAAC;IAEzE,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,aAAa;YAChB,2BAAY,CAAC,GAAG,CAAC,IAAI,qCAAiB,EAAE,CAAC,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;YACvD,MAAM;QAER,KAAK,SAAS;YACZ,2BAAY,CAAC,GAAG,CAAC,IAAI,iCAAe,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,QAAQ,CAAC,CAAC,CAAC;YACzE,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;YACjD,MAAM;QAER,KAAK,YAAY;YACf,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,WAAW,CAAC;YACvD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,OAAO,CAAC;YACnD,MAAM,YAAY,GAAG,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;YAEvC,MAAM,SAAS,GAAG,IAAI,2CAAoB,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;YAC9D,MAAM,UAAU,GAAG,IAAI,iCAAe,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,QAAQ,CAAC,CAAC;YAC1E,MAAM,QAAQ,GAAG,IAAI,qCAAiB,EAAE,CAAC;YAEzC,0BAA0B;YAC1B,2CAAoB,CAAC,QAAQ,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;YACjE,OAAO,CAAC,GAAG,CAAC,gEAAgE,CAAC,CAAC;YAC9E,MAAM;QAER;YACE,2BAAY,CAAC,GAAG,CAAC,IAAI,qCAAiB,EAAE,CAAC,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;IAChE,CAAC;AACH,CAAC"}

package/dist/core/connection/BetterSqliteConnection.d.ts

@@ -0,0 +1,23 @@
+export interface SQLiteConnectionLike {
+    all<T = unknown>(sql: string, params?: unknown[]): Promise<T[]>;
+    get<T = unknown>(sql: string, params?: unknown[]): Promise<T | undefined>;
+    run(sql: string, params?: unknown[]): Promise<{
+        lastID?: number | bigint;
+        changes?: number | bigint;
+    }>;
+    exec(sql: string): Promise<void>;
+    close(): Promise<void>;
+}
+export declare class BetterSqliteConnection implements SQLiteConnectionLike {
+    private readonly db;
+    constructor(filename: string);
+    all<T = unknown>(sql: string, params?: unknown[]): Promise<T[]>;
+    get<T = unknown>(sql: string, params?: unknown[]): Promise<T | undefined>;
+    run(sql: string, params?: unknown[]): Promise<{
+        lastID?: number | bigint;
+        changes?: number | bigint;
+    }>;
+    exec(sql: string): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=BetterSqliteConnection.d.ts.map

package/dist/core/connection/BetterSqliteConnection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BetterSqliteConnection.d.ts","sourceRoot":"","sources":["../../../src/core/connection/BetterSqliteConnection.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAChE,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC1E,GAAG,CACD,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;IACpE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAMD,qBAAa,sBAAuB,YAAW,oBAAoB;IACjE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAuB;gBAE9B,QAAQ,EAAE,MAAM;IAItB,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAInE,GAAG,CAAC,CAAC,GAAG,OAAO,EACnB,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,OAAO,EAAO,GACrB,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAInB,GAAG,CACP,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,OAAO,EAAO,GACrB,OAAO,CAAC;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAQ7D,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/core/connection/BetterSqliteConnection.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BetterSqliteConnection = void 0;
+const BetterSqlite3 = require("better-sqlite3");
+function normalizeParams(params) {
+    return Array.isArray(params) ? params : [params];
+}
+class BetterSqliteConnection {
+    constructor(filename) {
+        this.db = new BetterSqlite3(filename);
+    }
+    async all(sql, params = []) {
+        return this.db.prepare(sql).all(...normalizeParams(params));
+    }
+    async get(sql, params = []) {
+        return this.db.prepare(sql).get(...normalizeParams(params));
+    }
+    async run(sql, params = []) {
+        const result = this.db.prepare(sql).run(...normalizeParams(params));
+        return {
+            lastID: result.lastInsertRowid,
+            changes: result.changes,
+        };
+    }
+    async exec(sql) {
+        this.db.exec(sql);
+    }
+    async close() {
+        this.db.close();
+    }
+}
+exports.BetterSqliteConnection = BetterSqliteConnection;
+//# sourceMappingURL=BetterSqliteConnection.js.map

package/dist/core/connection/BetterSqliteConnection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BetterSqliteConnection.js","sourceRoot":"","sources":["../../../src/core/connection/BetterSqliteConnection.ts"],"names":[],"mappings":";;;AAmBA,MAAM,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAA4B,CAAC;AAa3E,SAAS,eAAe,CAAC,MAA2B;IAClD,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AACnD,CAAC;AAED,MAAa,sBAAsB;IAGjC,YAAY,QAAgB;QAC1B,IAAI,CAAC,EAAE,GAAG,IAAI,aAAa,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,GAAG,CAAc,GAAW,EAAE,SAAoB,EAAE;QACxD,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,MAAM,CAAC,CAAQ,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,GAAG,CACP,GAAW,EACX,SAAoB,EAAE;QAEtB,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,MAAM,CAAC,CAAkB,CAAC;IAC/E,CAAC;IAED,KAAK,CAAC,GAAG,CACP,GAAW,EACX,SAAoB,EAAE;QAEtB,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;QACpE,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,eAAe;YAC9B,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAW;QACpB,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF;AApCD,wDAoCC"}

package/dist/core/connection/ConnectionFactory.d.ts

@@ -0,0 +1,18 @@
+import { ConnectionName } from "./DatabaseConnection";
+import type { DriverAdapter } from "./DriverAdapter";
+export type { ConnectionName };
+type ConnectionInstance = any;
+/**
+ * Get or create a connection from the factory.
+ * Lazily initializes and caches the connection.
+ */
+export declare function getConnection(name: ConnectionName): Promise<ConnectionInstance>;
+/**
+ * Get or create a driver adapter for SQL connections.
+ */
+export declare function getAdapter(name: ConnectionName): Promise<DriverAdapter>;
+/**
+ * Gracefully close all cached DB connections.
+ */
+export declare function closeAllConnections(): Promise<void>;
+//# sourceMappingURL=ConnectionFactory.d.ts.map

package/dist/core/connection/ConnectionFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectionFactory.d.ts","sourceRoot":"","sources":["../../../src/core/connection/ConnectionFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,cAAc,EACf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIrD,YAAY,EAAE,cAAc,EAAE,CAAC;AAM/B,KAAK,kBAAkB,GAAG,GAAG,CAAC;AAE9B;;;GAGG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAqBrF;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAqB7E;AAED;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CA2DzD"}

package/dist/core/connection/ConnectionFactory.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConnection = getConnection;
+exports.getAdapter = getAdapter;
+exports.closeAllConnections = closeAllConnections;
+const DatabaseConnection_1 = require("./DatabaseConnection");
+const DriverAdapter_1 = require("./DriverAdapter");
+const database_1 = require("../../config/database");
+const SecretRedactor_1 = require("../security/SecretRedactor");
+const connectionCache = {};
+const adapterCache = {};
+const connectionInitCache = {};
+const adapterInitCache = {};
+/**
+ * Get or create a connection from the factory.
+ * Lazily initializes and caches the connection.
+ */
+async function getConnection(name) {
+    if (connectionCache[name]) {
+        return connectionCache[name];
+    }
+    if (connectionInitCache[name]) {
+        return await connectionInitCache[name];
+    }
+    console.log(`Creating new ${name} connection...`);
+    const initPromise = (0, DatabaseConnection_1.connectDB)(name)
+        .then((connection) => {
+        connectionCache[name] = connection;
+        return connection;
+    })
+        .finally(() => {
+        delete connectionInitCache[name];
+    });
+    connectionInitCache[name] = initPromise;
+    return await initPromise;
+}
+/**
+ * Get or create a driver adapter for SQL connections.
+ */
+async function getAdapter(name) {
+    if (adapterCache[name]) {
+        return adapterCache[name];
+    }
+    if (adapterInitCache[name]) {
+        return await adapterInitCache[name];
+    }
+    const initPromise = getConnection(name)
+        .then((conn) => {
+        const adapter = (0, DriverAdapter_1.createAdapter)(name, conn);
+        adapterCache[name] = adapter;
+        return adapter;
+    })
+        .finally(() => {
+        delete adapterInitCache[name];
+    });
+    adapterInitCache[name] = initPromise;
+    return await initPromise;
+}
+/**
+ * Gracefully close all cached DB connections.
+ */
+async function closeAllConnections() {
+    const inFlightConnections = Object.values(connectionInitCache).filter((promise) => Boolean(promise));
+    const inFlightAdapters = Object.values(adapterInitCache).filter((promise) => Boolean(promise));
+    if (inFlightConnections.length > 0 || inFlightAdapters.length > 0) {
+        await Promise.allSettled([...inFlightConnections, ...inFlightAdapters]);
+    }
+    for (const [name, conn] of Object.entries(connectionCache)) {
+        if (!conn)
+            continue;
+        const connectionName = name;
+        const driver = database_1.dbConfig.connections[connectionName]?.driver;
+        try {
+            switch (driver) {
+                case "mysql":
+                case "pg":
+                    if (typeof conn.end === "function") {
+                        await conn.end();
+                    }
+                    break;
+                case "sqlite":
+                    if (typeof conn.close === "function") {
+                        await conn.close();
+                    }
+                    break;
+                case "mongo": {
+                    const closedByTracker = await (0, DatabaseConnection_1.closeMongoClient)(conn);
+                    if (!closedByTracker) {
+                        const maybeClose = conn;
+                        if (typeof maybeClose.close === "function") {
+                            await maybeClose.close();
+                        }
+                    }
+                    break;
+                }
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (!message.includes("closed state")) {
+                console.error(`Error closing ${connectionName}:`, (0, SecretRedactor_1.redactSecretsInValue)(err));
+            }
+        }
+        delete connectionCache[connectionName];
+        delete adapterCache[connectionName];
+        delete connectionInitCache[connectionName];
+        delete adapterInitCache[connectionName];
+        console.log(`Closed ${connectionName} connection.`);
+    }
+}
+//# sourceMappingURL=ConnectionFactory.js.map

package/dist/core/connection/ConnectionFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectionFactory.js","sourceRoot":"","sources":["../../../src/core/connection/ConnectionFactory.ts"],"names":[],"mappings":";;AAsBA,sCAqBC;AAKD,gCAqBC;AAKD,kDA2DC;AArID,6DAI8B;AAC9B,mDAAgD;AAEhD,oDAAiD;AACjD,+DAAkE;AAIlE,MAAM,eAAe,GAAwD,EAAE,CAAC;AAChF,MAAM,YAAY,GAAmD,EAAE,CAAC;AACxE,MAAM,mBAAmB,GAAiE,EAAE,CAAC;AAC7F,MAAM,gBAAgB,GAA4D,EAAE,CAAC;AAGrF;;;GAGG;AACI,KAAK,UAAU,aAAa,CAAC,IAAoB;IACtD,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,OAAO,eAAe,CAAC,IAAI,CAAuB,CAAC;IACrD,CAAC;IAED,IAAI,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,OAAO,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,gBAAgB,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,IAAA,8BAAS,EAAC,IAAI,CAAC;SAChC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE;QACnB,eAAe,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC;QACnC,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;SACD,OAAO,CAAC,GAAG,EAAE;QACZ,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEL,mBAAmB,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC;IACxC,OAAO,MAAM,WAAW,CAAC;AAC3B,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,UAAU,CAAC,IAAoB;IACnD,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,YAAY,CAAC,IAAI,CAAkB,CAAC;IAC7C,CAAC;IAED,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,CAAC;SACpC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QACb,MAAM,OAAO,GAAG,IAAA,6BAAa,EAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1C,YAAY,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;QAC7B,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;SACD,OAAO,CAAC,GAAG,EAAE;QACZ,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEL,gBAAgB,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC;IACrC,OAAO,MAAM,WAAW,CAAC;AAC3B,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,mBAAmB;IACvC,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,MAAM,CACnE,CAAC,OAAO,EAA0C,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CACtE,CAAC;IACF,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAC7D,CAAC,OAAO,EAAqC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CACjE,CAAC;IACF,IAAI,mBAAmB,CAAC,MAAM,GAAG,CAAC,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,mBAAmB,EAAE,GAAG,gBAAgB,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;QAC3D,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,MAAM,cAAc,GAAG,IAAsB,CAAC;QAC9C,MAAM,MAAM,GAAG,mBAAQ,CAAC,WAAW,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QAE5D,IAAI,CAAC;YACH,QAAQ,MAAM,EAAE,CAAC;gBACf,KAAK,OAAO,CAAC;gBACb,KAAK,IAAI;oBACP,IAAI,OAAQ,IAA6C,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;wBAC7E,MAAO,IAA4C,CAAC,GAAG,EAAE,CAAC;oBAC5D,CAAC;oBACD,MAAM;gBAER,KAAK,QAAQ;oBACX,IAAI,OAAQ,IAA+C,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;wBACjF,MAAO,IAA8C,CAAC,KAAK,EAAE,CAAC;oBAChE,CAAC;oBACD,MAAM;gBAER,KAAK,OAAO,CAAC,CAAC,CAAC;oBACb,MAAM,eAAe,GAAG,MAAM,IAAA,qCAAgB,EAAC,IAA0B,CAAC,CAAC;oBAC3E,IAAI,CAAC,eAAe,EAAE,CAAC;wBACrB,MAAM,UAAU,GAAG,IAA8C,CAAC;wBAClE,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;4BAC3C,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC;wBAC3B,CAAC;oBACH,CAAC;oBACD,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;gBACtC,OAAO,CAAC,KAAK,CACX,iBAAiB,cAAc,GAAG,EAClC,IAAA,qCAAoB,EAAC,GAAG,CAAC,CAC1B,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,eAAe,CAAC,cAAc,CAAC,CAAC;QACvC,OAAO,YAAY,CAAC,cAAc,CAAC,CAAC;QACpC,OAAO,mBAAmB,CAAC,cAAc,CAAC,CAAC;QAC3C,OAAO,gBAAgB,CAAC,cAAc,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,UAAU,cAAc,cAAc,CAAC,CAAC;IACtD,CAAC;AACH,CAAC"}